summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-07-04 21:26:44 +0000
committerKarl Berry <karl@freefriends.org>2018-07-04 21:26:44 +0000
commit217bd854a745eab9aa3fd3d4c55f72e215e44afd (patch)
tree1a104c8962ce32c31e2139a815c1b7045632dbb9
parentf21cb173e4a42219a48195c2a268320d358c5894 (diff)
latex2e-help-texinfo (4jul18)
git-svn-id: svn://tug.org/texlive/trunk@48135 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/info/latex2e.info13771
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/ChangeLog600
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/Makefile4
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/NEWS20
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/aspell.en.pws189
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/common.texi4
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/graphics/README10
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/graphics/asy/list.asy2
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.eps1302
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.pdfbin10128 -> 10128 bytes
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.pngbin74651 -> 74651 bytes
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk10834
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.html15164
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.pdfbin976231 -> 1074707 bytes
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.texi11582
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.txt13801
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.xml15335
17 files changed, 58163 insertions, 24455 deletions
diff --git a/Master/texmf-dist/doc/info/latex2e.info b/Master/texmf-dist/doc/info/latex2e.info
index c41980e2072..36a89bb59e9 100644
--- a/Master/texmf-dist/doc/info/latex2e.info
+++ b/Master/texmf-dist/doc/info/latex2e.info
@@ -2,7 +2,7 @@ This is latex2e.info, produced by makeinfo version 6.5 from
latex2e.texi.
This document is an unofficial reference manual for LaTeX, a document
-preparation system, version of March 2018.
+preparation system, version of July 2018.
This manual was originally translated from 'LATEX.HLP' v1.0a in the
VMS Help Library. The pre-translation version was written by George D.
@@ -42,7 +42,7 @@ File: latex2e.info, Node: Top, Next: About this document, Up: (dir)
LaTeX2e: An unofficial reference manual
***************************************
-This document is an unofficial reference manual (version of March 2018)
+This document is an unofficial reference manual (version of July 2018)
for LaTeX2e, a document preparation system.
* Menu:
@@ -52,7 +52,7 @@ for LaTeX2e, a document preparation system.
* Document classes:: Some of the various classes available.
* Fonts:: Italic, bold, typewriter, etc.
* Layout:: Controlling the page layout.
-* Sectioning:: How to section properly.
+* Sectioning:: Parts, Chapters, Sections, etc.
* Cross references:: Automatic referencing.
* Environments:: Such as enumerate & itemize.
* Line breaking:: Influencing line breaks.
@@ -76,8 +76,7 @@ for LaTeX2e, a document preparation system.
* Terminal input/output:: User interaction.
* Command line:: System-independent command-line behavior.
* Document templates:: Starter templates for various document classes.
-* Concept Index:: General index.
-* Command Index:: Alphabetical list of LaTeX commands.
+* Index:: General index.

File: latex2e.info, Node: About this document, Next: Overview, Prev: Top, Up: Top
@@ -88,9 +87,9 @@ File: latex2e.info, Node: About this document, Next: Overview, Prev: Top, Up
This is an unofficial reference manual for the LaTeX2e document
preparation system, which is a macro package for the TeX typesetting
program (*note Overview::). This document's home page is
-<http://puszcza.gnu.org.ua/software/latexrefman/>. That page has links
-to the current output in various formats, sources, mailing list archives
-and subscriptions, and other infrastructure.
+<puszcza.gnu.org.ua/software/latexrefman>. That page has links to the
+current output in various formats, sources, mailing list archives and
+subscriptions, and other infrastructure.
In this document, we will mostly just use 'LaTeX' rather than
'LaTeX2e', since the previous version of LaTeX (2.09) was frozen decades
@@ -156,10 +155,11 @@ plain text, write it as 'LaTeX'.
* Menu:
-* Starting and ending:: The standard beginning and end of a document.
-* Output files:: Files produced.
+* Starting and ending:: The standard beginning and end of a document.
+* Output files:: Files produced.
* TeX engines:: Programs that can compile TeX and LaTeX.
* LaTeX command syntax:: General syntax of LaTeX commands.
+* CTAN:: Our repository.

File: latex2e.info, Node: Starting and ending, Next: Output files, Up: Overview
@@ -168,26 +168,30 @@ File: latex2e.info, Node: Starting and ending, Next: Output files, Up: Overvi
=======================
LaTeX files have a simple global structure, with a standard beginning
-and ending. Here is a "hello, world" example:
+and ending. This is a small example.
\documentclass{article}
\begin{document}
Hello, \LaTeX\ world.
\end{document}
-Here, the 'article' is the so-called "document class", implemented in a
-file 'article.cls'. Any document class can be used. A few document
-classes are defined by LaTeX itself, and vast array of others are widely
-available. *Note Document classes::.
+Every LaTeX document has a '\begin{document}' line and an
+'\end{document}' line.
+
+Here, the 'article' is the "document class". It is implemented in a
+file 'article.cls'. You can use any document class on your system. A
+few document classes are defined by LaTeX itself, and vast array of
+others are widely available. *Note Document classes::.
You can include other LaTeX commands between the '\documentclass' and
the '\begin{document}' commands. This area is called the "preamble".
- The '\begin{document} ... \end{document}' is a so-called
+ The '\begin{document}', '\end{document}' pair defines an
"environment"; the 'document' environment (and no others) is required in
-all LaTeX documents (*note document::). LaTeX provides many
-environments itself, and many more are defined separately. *Note
-Environments::.
+all LaTeX documents (*note document::). LaTeX make available to you
+many environments that are documented here (*note Environments::). Many
+more are available to you from external packages, most importantly those
+available at CTAN (*note CTAN::).
The following sections discuss how to produce PDF or other output
from a LaTeX input file.
@@ -198,7 +202,7 @@ File: latex2e.info, Node: Output files, Next: TeX engines, Prev: Starting and
2.2 Output files
================
-LaTeX produces a main output file and at least two accessory files. The
+LaTeX produces a main output file and at least two auxiliary files. The
main output file's name ends in either '.dvi' or '.pdf'.
'.dvi'
@@ -238,8 +242,8 @@ main output file's name ends in either '.dvi' or '.pdf'.
LaTeX may produce yet more files, characterized by the filename
ending. These include a '.lof' file that is used to make a list of
figures, a '.lot' file used to make a list of tables, and a '.toc' file
-used to make a table of contents. A particular class may create others;
-the list is open-ended.
+used to make a table of contents (*note Table of contents etc.::). A
+particular class may create others; the list is open-ended.

File: latex2e.info, Node: TeX engines, Next: LaTeX command syntax, Prev: Output files, Up: Overview
@@ -249,7 +253,7 @@ File: latex2e.info, Node: TeX engines, Next: LaTeX command syntax, Prev: Outp
LaTeX is defined to be a set of commands that are run by a TeX
implementation (*note Overview::). This section gives a terse overview
-of the main programs.
+of the main programs (see also *note Command line::).
'latex'
'pdflatex'
@@ -296,7 +300,7 @@ support for Japanese and other languages ([u]pTeX,
<http://ctan.org/pkg/ptex>, <http://ctan.org/pkg/uptex>).

-File: latex2e.info, Node: LaTeX command syntax, Prev: TeX engines, Up: Overview
+File: latex2e.info, Node: LaTeX command syntax, Next: CTAN, Prev: TeX engines, Up: Overview
2.4 LaTeX command syntax
========================
@@ -334,7 +338,7 @@ commands it covers (barring unintentional omissions, a.k.a. bugs).
* Environment:: Area of the source with distinct behavior.
* Declaration:: Change the value or meaning of a command.
-* \makeatletter and \makeatother:: Change the status of the at-sign character.
+* \makeatletter & \makeatother:: Change the status of the at-sign character.

File: latex2e.info, Node: Environment, Next: Declaration, Up: LaTeX command syntax
@@ -357,7 +361,7 @@ behavior. For instance, for poetry in LaTeX put the lines between
...
\end{verse}
- See *note Environments:: for a list of environments.
+ *Note Environments:: for a list of environments.
The ENVIRONMENT NAME at the beginning must exactly match that at the
end. This includes the case where ENVIRONMENT NAME ends in a
@@ -373,7 +377,7 @@ required (it specifies the formatting of columns).
\end{tabular}

-File: latex2e.info, Node: Declaration, Next: \makeatletter and \makeatother, Prev: Environment, Up: LaTeX command syntax
+File: latex2e.info, Node: Declaration, Next: \makeatletter & \makeatother, Prev: Environment, Up: LaTeX command syntax
2.4.2 Command declarations
--------------------------
@@ -383,10 +387,10 @@ command or parameter. For instance, the '\mainmatter' command changes
the setting of page numbers from roman numerals to arabic.

-File: latex2e.info, Node: \makeatletter and \makeatother, Prev: Declaration, Up: LaTeX command syntax
+File: latex2e.info, Node: \makeatletter & \makeatother, Prev: Declaration, Up: LaTeX command syntax
-2.4.3 '\makeatletter' and '\makeatother'
-----------------------------------------
+2.4.3 '\makeatletter' & '\makeatother'
+--------------------------------------
Synopsis:
@@ -423,10 +427,9 @@ a letter.
<http://ctan.org/pkg/macros2e>. These macros are mainly intended to
package or class authors.
- The example below is typical. In the user's class file is a command
-'\thesis@universityname'. The user wants to change the definition.
-These three lines should go in the preamble, before the
-'\begin{document}'.
+ In this example the class file has a command '\thesis@universityname'
+that the user wants to change. These three lines should go in the
+preamble, before the '\begin{document}'.
\makeatletter
\renewcommand{\thesis@universityname}{Saint Michael's College}
@@ -437,7 +440,7 @@ These three lines should go in the preamble, before the
* \@ifstar:: Define your own commands with *-variants.

-File: latex2e.info, Node: \@ifstar, Up: \makeatletter and \makeatother
+File: latex2e.info, Node: \@ifstar, Up: \makeatletter & \makeatother
2.4.3.1 '\@ifstar'
..................
@@ -445,8 +448,8 @@ File: latex2e.info, Node: \@ifstar, Up: \makeatletter and \makeatother
Synopsis:
\newcommand{\mycmd}{\@ifstar{\mycmd@star}{\mycmd@nostar}}
- \newcommand{\mycmd@nostar}[NON-STARRED COMMAND NUMBER OF ARGS]{BODY OF NON-STARRED COMMAND}
- \newcommand{\mycmd@star}[STARRED COMMAND NUMBER OF ARGS]{BODY OF STARRED COMMAND}
+ \newcommand{\mycmd@nostar}[NOSTAR-NUM-ARGS]{NOSTAR-BODY}
+ \newcommand{\mycmd@star}[STAR-NUM-ARGS]{STAR-BODY}
Many standard LaTeX environments or commands have a variant with the
same name but ending with a star character '*', an asterisk. Examples
@@ -465,7 +468,7 @@ the synopsis these two are '\mycmd@nostar' and '\mycmd@star'. They
could take the same number of arguments or a different number, or no
arguments at all. As always, in a LaTeX document a command using
at-sign '@' must be enclosed inside a '\makeatletter ... \makeatother'
-block (*note \makeatletter and \makeatother::).
+block (*note \makeatletter & \makeatother::).
This example of '\@ifstar' defines the command '\ciel' and a variant
'\ciel*'. Both have one required argument. A call to '\ciel{night}'
@@ -477,14 +480,15 @@ not blue sky".
\newcommand*{\ciel}{\@ifstar{\ciel@starred}{\ciel@unstarred}}
In the next example, the starred variant takes a different number of
-arguments than does the unstarred one. With this definition, Agent
-007's '``My name is \agentsecret*{Bond}, \agentsecret{James}{Bond}.'''
-is equivalent to '``My name is \textsc{Bond}, \textit{James}
-textsc{Bond}.'''
+arguments than the unstarred one. With this definition, Agent 007's
+'``My name is \agentsecret*{Bond}, \agentsecret{James}{Bond}.''' is
+equivalent to entering the commands '``My name is \textsc{Bond},
+\textit{James} textsc{Bond}.'''
\newcommand*{\agentsecret@unstarred}[2]{\textit{#1} \textsc{#2}}
\newcommand*{\agentsecret@starred}[1]{\textsc{#1}}
- \newcommand*{\agentsecret}{\@ifstar{\agentsecret@starred}{\agentsecret@unstarred}}
+ \newcommand*{\agentsecret}{%
+ \@ifstar{\agentsecret@starred}{\agentsecret@unstarred}}
There are two sometimes more convenient ways to accomplish the work
of '\@ifstar'. The 'suffix' package allows the construct
@@ -498,6 +502,35 @@ the 'xparse' package that allows this code.
}

+File: latex2e.info, Node: CTAN, Prev: LaTeX command syntax, Up: Overview
+
+2.5 CTAN: Comprehensive TeX Archive Network
+===========================================
+
+The Comprehensive TeX Archive Network, CTAN, is the TeX and LaTeX
+community's repository of free material. It is a set of Internet sites
+around the world that offer material related to LaTeX for download.
+Visit CTAN on the web at <https://ctan.org>.
+
+ This material is organized into packages, discrete bundles that
+typically offer some coherent functionality and are maintained by one
+person or a small number of people. For instance, many publishers have
+a package that allows authors to format papers to that publisher's
+specifications.
+
+ In addition to the massive holdings, the web site offers features
+such as search by name or by functionality.
+
+ CTAN is not a single site, but instead is a set of sites. One of the
+sites is the core. This site actively manages the material, for
+instance, by accepting uploads of new or updated packages. It is hosted
+by the German TeX group DANTE e.V. Other sites around the world help out
+by mirroring, that is, automatically syncing their collections with the
+core site and then in turn making their copies publicly available. This
+gives users close to their location better access and relieves the load
+on the core site. The list of mirrors is at <https://ctan.org/mirrors>.
+
+
File: latex2e.info, Node: Document classes, Next: Fonts, Prev: Overview, Up: Top
3 Document classes
@@ -546,9 +579,9 @@ File: latex2e.info, Node: Document class options, Next: Additional packages,
3.1 Document class options
==========================
-You can specify so-called "global options" or "class options" to the
+You can specify "global options" or "class options" to the
'\documentclass' command by enclosing them in square brackets. To
-specify more than one OPTION, separate them with a comma, as in:
+specify more than one OPTION, separate them with a comma.
\documentclass[OPTION1,OPTION2,...]{CLASS}
@@ -681,11 +714,11 @@ SMC Math Department' is for a class.
Inside of a class or package file you can use the at-sign '@' as a
character in command names without having to surround the code
containing that command with '\makeatletter' and '\makeatother'. *Note
-\makeatletter and \makeatother::. This allow you to create commands
-that users will not accidentally redefine. Another technique is to
-preface class- or package-specific commands with some string to prevent
-your class or package from interfering with others. For instance, the
-class 'smcmemo' might have commands '\smc@tolist', '\smc@fromlist', etc.
+\makeatletter & \makeatother::. This allow you to create commands that
+users will not accidentally redefine. Another technique is to preface
+class- or package-specific commands with some string to prevent your
+class or package from interfering with others. For instance, the class
+'smcmemo' might have commands '\smc@tolist', '\smc@fromlist', etc.
* Menu:
@@ -729,7 +762,7 @@ file.
\ProcessOptions\relax
\LoadClass{article}
- It identifies itself, handles the class options via the default of
+It identifies itself, handles the class options via the default of
passing them all to the 'article' class, and then loads the 'article'
class to provide the basis for this class's code.
@@ -805,11 +838,11 @@ These are the commands designed to help writers of classes or packages.
'\DeclareOption{OPTION}{CODE}'
'\DeclareOption*{CODE}'
- Make an option available to a user, for invoking in their
+ Make an option available to a user to invoke in their
'\documentclass' command. For example, the 'smcmemo' class could
- have an option allowing users to put the institutional logo on the
- first page with '\documentclass[logo]{smcmemo}'. The class file
- must contain '\DeclareOption{logo}{CODE}' (and later,
+ have an option '\documentclass[logo]{smcmemo}' allowing users to
+ put the institutional logo on the first page. The class file must
+ contain '\DeclareOption{logo}{CODE}' (and later,
'\ProcessOptions').
If you request an option that has not been declared, by default
@@ -849,10 +882,11 @@ These are the commands designed to help writers of classes or packages.
and the command is used within a moving argument, use
'\newcommand'.
- The 'etoolbox' package offers commands '\newrobustcmd',
- '\newrobustcmd*', '\renewrobustcmd', '\renewrobustcmd*',
- '\providerobustcmd', and '\providerobustcmd*' which are similar to
- '\newcommand', '\newcommand*', '\renewcommand', '\renewcommand*',
+ The 'etoolbox' package offers the commands '\newrobustcmd',
+ '\newrobustcmd*', as well as the commands '\renewrobustcmd',
+ '\renewrobustcmd*', and the commands '\providerobustcmd', and
+ '\providerobustcmd*'. These are similar to '\newcommand',
+ '\newcommand*', '\renewcommand', '\renewcommand*',
'\providecommand', and '\providecommand*', but define a robust CMD
with two advantages as compared to '\DeclareRobustCommand':
1. They use the low-level e-TeX protection mechanism rather than
@@ -866,12 +900,15 @@ These are the commands designed to help writers of classes or packages.
'\IfFileExists{FILE NAME}{TRUE CODE}{FALSE CODE}'
'\InputIfFileExists{FILE NAME}{TRUE CODE}{FALSE CODE}'
- Execute TRUE CODE if LaTeX can find the file 'FILE NAME' and FALSE
- CODE otherwise. In the second case it inputs the file immediately
- after executing TRUE CODE. Thus
- '\IfFileExists{img.pdf}{\includegraphics{img.pdf}}{\typeout{WARNING:
- img.pdf not found}}' will include the graphic 'img.pdf' if it is
- found but otherwise just give a warning.
+ Execute TRUE CODE if LaTeX finds the file 'FILE NAME' or FALSE CODE
+ otherwise. In the first case it executing TRUE CODE and then
+ inputs the file. Thus the command
+
+ \IfFileExists{img.pdf}{%
+ \includegraphics{img.pdf}}{\typeout{!! img.pdf not found}
+
+ will include the graphic 'img.pdf' if it is found and otherwise
+ give a warning.
This command looks for the file in all search paths that LaTeX
uses, not only in the current directory. To look only in the
@@ -893,9 +930,11 @@ These are the commands designed to help writers of classes or packages.
If you request a RELEASE DATE and the date of the package installed
on your system is earlier, then you get a warning on the screen and
- in the log like 'You have requested, on input line 4, version
- `2038/01/19' of document class article, but only version
- `2014/09/29 v1.4h Standard LaTeX document class' is available.'
+ in the log like this.
+
+ You have requested, on input line 4, version `2038/01/19' of
+ document class article, but only version `2014/09/29 v1.4h
+ Standard LaTeX document class' is available.
The command version '\LoadClassWithOptions' uses the list of
options for the current class. This means it ignores any options
@@ -927,8 +966,10 @@ These are the commands designed to help writers of classes or packages.
features, include the optional FORMAT DATE on which those features
were implemented. If present it must be in the form 'YYYY/MM/DD'.
If the format version installed on your system is earlier than
- FORMAT DATE then you get a warning like 'You have requested release
- `2038/01/20' of LaTeX, but only release `2016/02/01' is available.'
+ FORMAT DATE then you get a warning like this.
+
+ You have requested release `2038/01/20' of LaTeX, but only
+ release `2016/02/01' is available.
'\OptionNotUsed'
Adds the current option to the list of unused options. Can only be
@@ -950,17 +991,20 @@ These are the commands designed to help writers of classes or packages.
If your own code is bringing in a package twice then you can
collapse that to once, for example replacing the two
- '\RequirePackage[landscape]{geometry}\RequirePackage[margins=1in]{geometry}'
- with the single '\RequirePackage[landscape,margins=1in]{geometry}'.
- But if you are loading a package that in turn loads another package
- then you need to queue up the options you desire for this other
- package. For instance, suppose the package 'foo' loads the package
- 'geometry'. Instead of
- '\RequirePackage{foo}\RequirePackage[draft]{graphics}' you must
- write '\PassOptionsToPackage{draft}{graphics}
- \RequirePackage{foo}'. (If 'foo.sty' loads an option in conflict
- with what you want then you may have to look into altering its
- source.)
+ '\RequirePackage[landscape]{geometry}' and
+ '\RequirePackage[margins=1in]{geometry}' with the single command
+ '\RequirePackage[landscape,margins=1in]{geometry}'.
+
+ However, imagine that you are loading 'firstpkg' and inside that
+ package it loads 'secondpkg', and you need the second package to be
+ loaded with option 'draft'. Then before doing the first package
+ you must queue up the options for the second package, like this.
+
+ \PassOptionsToPackage{draft}{secondpkg}
+ \RequirePackage{firstpkg}
+
+ (If 'firstpkg.sty' loads an option in conflict with what you want
+ then you may have to alter its source.)
These commands are useful for general users as well as class and
package writers. For instance, suppose a user wants to load the
@@ -1012,31 +1056,33 @@ These are the commands designed to help writers of classes or packages.
Identifies the class or package, printing a message to the screen
and the log file.
- When a user writes '\documentclass{smcmemo}' then LaTeX loads the
- file 'smcmemo.cls'. Similarly, a user writing '\usepackage{test}'
- prompts LaTeX to load the file 'test.sty'. If the name of the file
- does not match the declared class or package name then you get a
- warning. Thus, if you invoke '\documentclass{smcmemo}', and the
- file 'smcmemo.cls' has the statement '\ProvidesClass{xxx}' then you
- get a warning like 'You have requested document class `smcmemo',
- but the document class provides 'xxx'.' This warning does not
- prevent LaTeX from processing the rest of the class file normally.
-
- If you include the optional argument, then you must include the
- date, before the first space if any, and it must have the form
- 'YYYY/MM/DD'. The rest of the optional argument is free-form,
- although it traditionally identifies the class, and is written to
- the screen during compilation and to the log file. Thus, if your
- file 'smcmemo.cls' contains the line
- '\ProvidesClass{smcmemo}[2008/06/01 v1.0 SMC memo class]' and your
- document's first line is '\documentclass{smcmemo}' then you will
- see 'Document Class: smcmemo 2008/06/01 v1.0 SMC memo class'.
+ When you load a class or package, for example with
+ '\documentclass{smcmemo}' or '\usepackage{test}', LaTeX inputs a
+ file. If the name of the file does not match the class or package
+ name declared in it then you get a warning. Thus, if you invoke
+ '\documentclass{smcmemo}', and the file 'smcmemo.cls' has the
+ statement '\ProvidesClass{xxx}' then you get a warning like 'You
+ have requested document class `smcmemo', but the document class
+ provides 'xxx'.' This warning does not prevent LaTeX from
+ processing the rest of the class file normally.
+
+ If you include the optional argument then you must include a date,
+ before any spaces, of the form 'YYYY/MM/DD'. The rest of the
+ optional argument is free-form, although it traditionally
+ identifies the class, and is written to the screen during
+ compilation and to the log file. Thus, if your file 'smcmemo.cls'
+ contains the line '\ProvidesClass{smcmemo}[2008/06/01 v1.0 SMC memo
+ class]' and your document's first line is '\documentclass{smcmemo}'
+ then you will see 'Document Class: smcmemo 2008/06/01 v1.0 SMC memo
+ class'.
The date in the optional argument allows class and package users to
- ask to be warned if the version of the class or package installed
- on their system is earlier than RELEASE DATE, by using the optional
- arguments such as '\documentclass{smcmemo}[2018/10/12]' or
- '\usepackage{foo}[[2017/07/07]]'. (Note that package users only
+ ask to be warned if the version of the class or package is earlier
+ than RELEASE DATE. For instance, a user could enter
+ '\documentclass{smcmemo}[2018/10/12]' or
+ '\usepackage{foo}[[2017/07/07]]' to require a class or package with
+ certain features by specifying that it must be released no earlier
+ than the given date. (Although, in practice package users only
rarely include a date, and class users almost never do.)
'\ProvidesFile{FILE NAME}[ADDITIONAL INFORMATION]'
@@ -1049,11 +1095,10 @@ These are the commands designed to help writers of classes or packages.
'\RequirePackage[OPTION LIST]{PACKAGE NAME}[RELEASE DATE]'
'\RequirePackageWithOptions{PACKAGE NAME}[RELEASE DATE]'
- Load a package, like the document author command '\usepackage'.
- *Note Additional packages::. An example is
- '\RequirePackage[landscape,margin=1in]{geometry}'. Note that the
- LaTeX development team strongly recommends use of these commands
- over Plain TeX's '\input'; see the Class Guide.
+ Load a package, like the command '\usepackage' (*note Additional
+ packages::). The LaTeX development team strongly recommends use of
+ these commands over Plain TeX's '\input'; see the Class Guide. An
+ example is '\RequirePackage[landscape,margin=1in]{geometry}'.
The OPTION LIST, if present, is a comma-separated list. The
RELEASE DATE, if present, must have the form YYYY/MM/DD. If the
@@ -1098,26 +1143,26 @@ File: latex2e.info, Node: Font styles, Next: Font sizes, Up: Fonts
The following type style commands are supported by LaTeX.
- This first group of commands is typically used with an argument, as
-in '\textit{TEXT}'. In the table below, the corresponding command in
-parenthesis is the "declaration form", which takes no arguments, as in
-'{\itshape TEXT}'. The scope of the declaration form lasts until the
-next type style command or the end of the current group.
+ In the table below the listed commands, the '\text...' commands, is
+used with an argument, as in '\textit{TEXT}'. This is the preferred
+form. But shown after it, in parenthesis, is the corresponding
+declaration form, which is sometimes useful. This form takes no
+arguments, as in '{\itshape TEXT}'. The scope of the declaration form
+lasts until the next type style command or the end of the current group.
+In addition, each has an environment form such as
+'\begin{itshape}...\end{itshape}'.
These commands, in both the argument form and the declaration form,
-are cumulative; e.g., you can say either '\sffamily\bfseries' or
-'\bfseries\sffamily' to get bold sans serif.
-
- You can alternatively use an environment form of the declarations;
-for instance, '\begin{ttfamily}...\end{ttfamily}'.
+are cumulative; for instance you can get bold sans serif by saying
+either of '\sffamily\bfseries' or '\bfseries\sffamily'.
- These font-switching commands automatically insert italic corrections
-if needed. (*Note \/::, for the details of italic corrections.)
-Specifically, they insert the italic correction unless the following
-character is in the list '\nocorrlist', which by default consists of a
-period and a comma. To suppress the automatic insertion of italic
-correction, use '\nocorr' at the start or end of the command argument,
-such as '\textit{\nocorr text}' or '\textsc{text \nocorr}'.
+ One advantage of these commands is that they automatically insert
+italic corrections if needed (*note \/::). Specifically, they insert
+the italic correction unless the following character is in the list
+'\nocorrlist', which by default consists of a period and a comma. To
+suppress the automatic insertion of italic correction, use '\nocorr' at
+the start or end of the command argument, such as '\textit{\nocorr
+text}' or '\textsc{text \nocorr}'.
'\textrm (\rmfamily)'
Roman.
@@ -1156,9 +1201,13 @@ TEXT} END TEXT}' will result in the START TEXT and END TEXT in italics,
but MIDDLE TEXT will be in roman.
LaTeX also provides the following commands, which unconditionally
-switch to the given style, that is, are _not_ cumulative. Also, they
-are used differently than the above commands: '{\CMD...}' instead of
-'\CMD{...}'. These are two unrelated constructs.
+switch to the given style, that is, are _not_ cumulative. They are used
+as declarations: '{\CMD...}' instead of '\CMD{...}'.
+
+ (The unconditional commands below are an older version of font
+switching. The earlier commands are an improvement in most
+circumstances. But sometimes an unconditional font switch is precisely
+what you want.)
'\bf'
Switch to bold face.
@@ -1186,12 +1235,6 @@ are used differently than the above commands: '{\CMD...}' instead of
The '\em' command is the unconditional version of '\emph'.
- (Some people consider the unconditional font-switching commands, such
-as '\tt', obsolete and that only the cumulative commands ('\texttt')
-should be used. Others think that both sets of commands have their
-place and sometimes an unconditional font switch is precisely what you
-want; for one example, *note 'description': description.)
-
The following commands are for use in math mode. They are not
cumulative, so '\mathbf{\mathit{SYMBOL}}' does not create a boldface and
italic SYMBOL; instead, it will just be in italics. This is because
@@ -1246,23 +1289,32 @@ table shows the command name and the corresponding actual font size used
(in points) with the '10pt', '11pt', and '12pt' document size options,
respectively (*note Document class options::).
-Command '10pt' '11pt' '12pt'
---------------------------------------------------
-'\tiny' 5 6 6
-'\scriptsize' 7 8 8
-'\footnotesize' 8 9 10
-'\small' 9 10 10.95
-'\normalsize' (default) 10 10.95 12
-'\large' 12 12 14.4
-'\Large' 14.4 14.4 17.28
-'\LARGE' 17.28 17.28 20.74
-'\huge' 20.74 20.74 24.88
-'\Huge' 24.88 24.88 24.88
-
- The commands as listed here are "declaration forms". The scope of
-the declaration form lasts until the next type style command or the end
-of the current group. You can also use the environment form of these
-commands; for instance, '\begin{tiny}...\end{tiny}'.
+Command '10pt' '11pt' '12pt'
+--------------------------------------------------------
+'\tiny' 5 6 6
+'\scriptsize' 7 8 8
+'\footnotesize' 8 9 10
+'\small' 9 10 10.95
+'\normalsize' (default) 10 10.95 12
+'\large' 12 12 14.4
+'\Large' 14.4 14.4 17.28
+'\LARGE' 17.28 17.28 20.74
+'\huge' 20.74 20.74 24.88
+'\Huge' 24.88 24.88 24.88
+
+ The commands are listed here in declaration forms. You use them by
+declaring them, as with this example.
+
+ \begin{quotation} \small
+ The Tao that can be named is not the eternal Tao.
+ \end{quotation}
+
+The scope of the '\small' lasts until the end of the 'quotation'
+environment. It would also end at the next type style command or the
+end of the current group, so you could enclose it in extra curly braces
+'{\small We are here, we are here, we are here!}'. You can instead use
+the environment form of these commands; for instance,
+'\begin{tiny}...\end{tiny}'.

File: latex2e.info, Node: Low-level font commands, Prev: Font sizes, Up: Fonts
@@ -1288,7 +1340,7 @@ ones.
Select the font family. The web page
<http://www.tug.dk/FontCatalogue/> provides one way to browse
through many of the fonts easily used with LaTeX. Here are
- examples of some common families:
+ examples of some common families.
'pag' Avant Garde
'fvs' Bitstream Vera Sans
@@ -1432,11 +1484,14 @@ File: latex2e.info, Node: \onecolumn, Next: \twocolumn, Up: Layout
5.1 '\onecolumn'
================
-Start a new page and produce single-column output. If the document is
-given the class option 'onecolumn' then this is the default behavior
-(*note Document class options::).
+Synopsis:
+
+ \onecolumn
- This command is fragile (*note \protect::).
+ Start a new page and produce single-column output. If the document
+is given the class option 'onecolumn' then this is the default behavior
+(*note Document class options::). This command is fragile (*note
+\protect::).

File: latex2e.info, Node: \twocolumn, Next: \flushbottom, Prev: \onecolumn, Up: Layout
@@ -1451,13 +1506,11 @@ Synopses:
Start a new page and produce two-column output. If the document is
given the class option 'twocolumn' then this is the default (*note
-Document class options::).
+Document class options::). This command is fragile (*note \protect::).
If the optional PRELIM ONE COLUMN TEXT argument is present, it is
typeset in one-column mode before the two-column typesetting starts.
- This command is fragile (*note \protect::).
-
These parameters control typesetting in two-column output:
'\columnsep'
@@ -1504,8 +1557,7 @@ following parameters control float behavior of two-column output.
* Increase the value of '\dbltopfraction' to a suitably large
number, to avoid going to float pages so soon.
- You can redefine it, for instance with
- '\renewcommand{\dbltopfraction}{0.9}'.
+ You can redefine it, as with '\renewcommand{\dbltopfraction}{0.9}'.
'\dblfloatpagefraction'
For a float page of two-column wide floats, this is the minimum
@@ -1670,13 +1722,13 @@ File: latex2e.info, Node: Page layout parameters, Next: Floats, Prev: \ragged
'\paperheight'
The height of the paper, as distinct from the height of the print
- area. It is normally set with a document class option, as in
+ area. Normally set with a document class option, as in
'\documentclass[a4paper]{article}' (*note Document class
options::).
'\paperwidth'
The width of the paper, as distinct from the width of the print
- area. It is normally set with a document class option, as in
+ area. Normally set with a document class option, as in
'\documentclass[a4paper]{article}' (*note Document class
options::).
@@ -1708,6 +1760,7 @@ File: latex2e.info, Node: Page layout parameters, Next: Floats, Prev: \ragged
specified width, and revert to their normal values at the end of
the 'minipage' or '\parbox'.
+'\hsize'
This entry is included for completeness: '\hsize' is the TeX
primitive parameter used when text is broken into lines. It should
not be used in normal LaTeX documents.
@@ -1836,7 +1889,7 @@ BETWEEN 0 AND 1}'):
floats; default '.7'.
Parameters relating to vertical space around floats (change them with
-'\setlength{PARAMETER}{LENGTH EXPRESSION}'):
+a command of the form '\setlength{PARAMETER}{LENGTH EXPRESSION}'):
'\floatsep'
Space between floats at the top or bottom of a page; default '12pt
@@ -1852,7 +1905,7 @@ BETWEEN 0 AND 1}'):
default '20pt plus2pt minus4pt'.
Counters relating to the number of floats on a page (change them with
-'\setcounter{CTRNAME}{NATURAL NUMBER}'):
+a command of the form '\setcounter{CTRNAME}{NATURAL NUMBER}'):
'bottomnumber'
Maximum number of floats that can appear at the bottom of a text
@@ -1883,64 +1936,533 @@ File: latex2e.info, Node: Sectioning, Next: Cross references, Prev: Layout,
6 Sectioning
************
-Sectioning commands provide the means to structure your text into units:
+Structure your text into divisions: parts, chapters, sections, etc. All
+sectioning commands have the same form, one of:
+
+ SECTIONING-COMMAND{TITLE}
+ SECTIONING-COMMAND*{TITLE}
+ SECTIONING-COMMAND[TOC-TITLE]{TITLE}
+
+For instance, declare the start of a subsection as with
+'\subsection{Motivation}'.
+
+ The table has each SECTIONING-COMMAND in LaTeX. All are available in
+all of LaTeX's standard document classes 'book', 'report',
+and 'article', except that '\chapter' is not available in 'article'.
+
+Sectioning unit Command Level
+--------------------------------------------------------------------
+Part '\part' -1 ('book', 'report'), 0
+ ('article')
+Chapter '\chapter' 0
+Section '\section' 1
+Subsection '\subsection' 2
+Subsubsection '\subsubsection' 3
+Paragraph '\paragraph' 4
+Subparagraph '\subparagraph' 5
+
+ All these commands have a '*'-form that prints TITLE as usual but is
+not numbered and does not make an entry in the table of contents. An
+example of using this is for an appendix in an 'article' . The input
+'\appendix\section{Appendix}' gives the output 'A Appendix' (*note
+\appendix::). You can lose the numbering 'A' by instead entering
+'\section*{Appendix}' (articles often omit a table of contents and have
+simple page headers so the other differences from the '\section' command
+may not matter).
+
+ The section title TITLE provides the heading in the main text, but it
+may also appear in the table of contents and in the running head or foot
+(*note Page styles::). You may not want the same text in these places
+as in the main text. All of these commands have an optional argument
+TOC-TITLE for these other places.
+
+ The level number in the table above determines which sectional units
+are numbered, and which appear in the table of contents. If the
+sectioning command's LEVEL is less than or equal to the value of the
+counter 'secnumdepth' then the titles for this sectioning command will
+be numbered (*note Sectioning/secnumdepth::). And, if LEVEL is less
+than or equal to the value of the counter 'tocdepth' then the table of
+contents will have an entry for this sectioning unit (*note
+Sectioning/tocdepth::).
+
+ LaTeX expects that before you have a '\subsection' you will have a
+'\section' and, in a book, that before a '\section' you will have a
+'\chapter'. Otherwise you can get a something like a subsection
+numbered '3.0.1'.
+
+ Two counters relate to the appearance of sectioning commands.
+
+'secnumdepth'
+ Controls which sectioning commands are numbered. Suppress
+ numbering of sectioning at any depth greater than LEVEL
+ '\setcounter{secnumdepth}{LEVEL}' (*note \setcounter::). See the
+ above table for the level numbers. For instance, if the
+ 'secnumdepth' is 1 in an 'article' then a '\section{Introduction}'
+ command will produce output like '1 Introduction' while
+ '\subsection{Discussion}' will produce output like 'Discussion',
+ without the number. LaTeX's default 'secnumdepth' is 3 in
+ 'article' class and 2 in the 'book' and 'report' classes.
+
+'tocdepth'
+ Controls which sectioning units are listed in the table of
+ contents. The setting '\setcounter{tocdepth}{LEVEL}' makes the
+ sectioning units at LEVEL be the smallest ones listed (*note
+ \setcounter::). See the above table for the level numbers. For
+ instance, if 'tocdepth' is 1 then the table of contents will list
+ sections but not subsections. LaTeX's default 'secnumdepth' is 3
+ in 'article' class and 2 in the 'book' and 'report' classes.
+
+* Menu:
+
+* \part:: Start a part.
+* \chapter:: Start a chapter.
+* \section:: Start a section.
+* \subsection:: Start a subsection.
+* \subsubsection & \paragraph & \subparagraph:: Lower divisions.
+* \appendix:: Start appendices.
+* \frontmatter & \mainmatter & \backmatter:: The three parts of a book.
+* \@startsection:: Layout of sectional units.
-'\part'
-'\chapter'
- ('report' and 'book' class only)
-'\section'
-'\subsection'
-'\subsubsection'
-'\paragraph'
-'\subparagraph'
+
+File: latex2e.info, Node: \part, Next: \chapter, Up: Sectioning
- All sectioning commands take the same general form, e.g.,
+6.1 '\part'
+===========
- \chapter[TOCTITLE]{TITLE}
+Synopsis, one of:
- In addition to providing the heading TITLE in the main text, the
-section title can appear in two other places:
+ \part{TITLE}
+ \part*{TITLE}
+ \part[TOC-TITLE]{TITLE}
+
+ Start a document part. The standard LaTeX classes 'book', 'report',
+and 'article', all have this command.
+
+ This produces a document part, in a book.
+
+ \part{VOLUME I \\
+ PERSONAL MEMOIRS OF U.\ S.\ GRANT}
+ \chapter{ANCESTRY--BIRTH--BOYHOOD.}
+ My family is American, and has been for generations,
+ in all its branches, direct and collateral.
+
+ In each standard class the '\part' command outputs a part number such
+as 'Part I', alone on its line, in boldface, and in large type. Then
+LaTeX outputs TITLE, also alone on its line, in bold and in even larger
+type. In class 'book', the LaTeX default puts each part alone on its
+own page. If the book is two-sided then LaTeX will skip a page if
+needed to have the new part on an odd-numbered page. In 'report' it is
+again alone on a page, but LaTeX won't force it onto an odd-numbered
+page. In an 'article' LaTeX does not put it on a fresh page, but
+instead outputs the part number and part title onto the main document
+page.
- 1. The table of contents.
- 2. The running head at the top of the page.
+ The '*' form shows TITLE but it does not show the part number, does
+not increment the 'part' counter, and produces no table of contents
+entry.
- You may not want the same text in these places as in the main text.
-To handle this, the sectioning commands have an optional argument
-TOCTITLE that, when given, specifies the text for these other places.
+ The optional argument TOC-TITLE will appear as the part title in the
+table of contents (*note Table of contents etc.::) and in running
+headers (*note Page styles::). If it is not present then TITLE will be
+there. This example puts a line break in TITLE but leaves out the break
+in the table of contents.
- Also, all sectioning commands have '*'-forms that print TITLE as
-usual, but do not include a number and do not make an entry in the table
-of contents. For instance:
+ \part[Up from the bottom; my life]{Up from the bottom\\ my life}
- \section*{Preamble}
+ For determining which sectional units are numbered and which appear
+in the table of contents, the level number of a part is -1 (*note
+Sectioning/secnumdepth:: and *note Sectioning/tocdepth::).
- The '\appendix' command changes the way following sectional units are
-numbered. The '\appendix' command itself generates no text and does not
-affect the numbering of parts. The normal use of this command is
-something like
+ In the class 'article', if a paragraph immediately follows the part
+title then it is not indented. To get an indent you can use the package
+'indentfirst'.
+
+ One package to change the behavior of '\part' is 'titlesec'. See its
+documentation on CTAN.
+
+
+File: latex2e.info, Node: \chapter, Next: \section, Prev: \part, Up: Sectioning
+
+6.2 '\chapter'
+==============
+
+Synopsis, one of:
+
+ \chapter{TITLE}
+ \chapter*{TITLE}
+ \chapter[TOC-TITLE]{TITLE}
+
+ Start a chapter. The standard LaTeX classes 'book' and 'report' have
+this command but 'article' does not.
+
+ This produces a chapter.
+
+ \chapter{Loomings}
+ Call me Ishmael.
+ Some years ago---never mind how long precisely---having little or no
+ money in my purse, and nothing particular to interest me on shore, I
+ thought I would sail about a little and see the watery part of
+ the world.
+
+ The LaTeX default starts each chapter on a fresh page, an
+odd-numbered page if the document is two-sided. It produces a chapter
+number such as 'Chapter 1' in large boldface type (the size is '\huge').
+It then puts TITLE on a fresh line, in boldface type that is still
+larger (size '\Huge'). It also increments the 'chapter' counter, adds
+an entry to the table of contents (*note Table of contents etc.::), and
+sets the running header information (*note Page styles::).
+
+ The '*' form shows TITLE on a fresh line, in boldface. But it does
+not show the chapter number, does not increment the 'chapter' counter,
+produces no table of contents entry, and does not affect the running
+header. (If you use the page style 'headings' in a two-sided document
+then the header will be from the prior chapter.) This example
+illustrates.
+
+ \chapter*{Preamble}
+
+ The optional argument TOC-TITLE will appear as the chapter title in
+the table of contents (*note Table of contents etc.::) and in running
+headers (*note Page styles::). If it is not present then TITLE will be
+there. This shows the full name in the chapter title,
+
+ \chapter[Weyl]{Hermann Klaus Hugo (Peter) Weyl (1885--1955)}
+
+but only 'Weyl' on the contents page. This puts a line break in the
+title but that doesn't work well with running headers so it omits the
+break in the contents
+
+ \chapter[Given it all\\ my story]{Given it all\\ my story}
+
+ For determining which sectional units are numbered and which appear
+in the table of contents, the level number of a chapter is 0 (*note
+Sectioning/secnumdepth:: and *note Sectioning/tocdepth::).
+
+ The paragraph that follows the chapter title is not indented, as is a
+standard typographical practice. To get an indent use the package
+'indentfirst'.
+
+ You can change what is shown for the chapter number. To change it to
+something like 'Lecture 1', put in the preamble either
+'\renewcommand{\chaptername}{Lecture}' or this (*note \makeatletter &
+\makeatother::).
+
+ \makeatletter
+ \renewcommand{\@chapapp}{Lecture}
+ \makeatother
+
+To make this change because of the primary language for the document,
+see the package 'babel'.
+
+ In a two-sided document LaTeX puts a chapter on odd-numbered page, if
+necessary leaving an even-numbered page that is blank except for any
+running headers. To make that page completely blank, see *note
+\clearpage & \cleardoublepage::.
+
+ To change the behavior of the '\chapter' command, you can copy its
+definition from the LaTeX format file and make adjustments. But there
+are also many packages on CTAN that address this. One is 'titlesec'.
+See its documentation, but the example below gives a sense of what it
+can do.
+
+ \usepackage{titlesec} % in preamble
+ \titleformat{\chapter}
+ {\Huge\bfseries} % format of title
+ {} % label, such as 1.2 for a subsection
+ {0pt} % length of separation between label and title
+ {} % before-code hook
+
+This omits the chapter number 'Chapter 1' from the page but unlike
+'\chapter*' it keeps the chapter in the table of contents and the
+running headers.
+
+
+File: latex2e.info, Node: \section, Next: \subsection, Prev: \chapter, Up: Sectioning
+
+6.3 '\section'
+==============
+
+Synopsis, one of:
+
+ \section{TITLE}
+ \section*{TITLE}
+ \section[TOC-TITLE]{TITLE}
+
+ Start a section. The standard LaTeX classes 'article', 'book', and
+'report' all have this command.
+
+ This produces a section.
+
+ In this Part we tend to be more interested in the function,
+ in the input-output behavior,
+ than in the details of implementing that behavior.
+
+ \section{Turing machines}
+ Despite this desire to downplay implementation,
+ we follow the approach of A~Turing that the
+ first step toward defining the set of computable functions
+ is to reflect on the details of what mechanisms can do.
+
+ For the standard LaTeX classes 'book' and 'report' the default output
+is like '1.2 TITLE' (for chapter 1, section 2), alone on its line and
+flush left, in boldface and a larger type (the type size is '\Large').
+The same holds in 'article' except that there are no chapters in that
+class so it looks like '2 TITLE'.
+
+ The '*' form shows TITLE. But it does not show the section number,
+does not increment the 'section' counter, produces no table of contents
+entry, and does not affect the running header. (If you use the page
+style 'headings' in a two-sided document then the header will be from
+the prior section.)
+
+ The optional argument TOC-TITLE will appear as the section title in
+the table of contents (*note Table of contents etc.::) and in running
+headers (*note Page styles::). If it is not present then TITLE will be
+there. This shows the full name in the title of the section,
+
+ \section[Elizabeth~II]{Elizabeth the Second,
+ by the Grace of God of the United Kingdom,
+ Canada and Her other Realms and Territories Queen,
+ Head of the Commonwealth, Defender of the Faith.}
+
+but only 'Elizabeth II' on the contents page and in the headers. This
+has a line break in TITLE but that does not work with headers so it is
+omitted from the contents and headers.
+
+ \section[Truth is, I cheated; my life story]{Truth is,
+ I cheated\\my life story}
+
+ For determining which sectional units are numbered and which appear
+in the table of contents, the level number of a section is 1 (*note
+Sectioning/secnumdepth:: and *note Sectioning/tocdepth::).
+
+ The paragraph that follows the section title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package 'indentfirst'.
+
+ In general, to change the behavior of the '\section' command, there
+are a number of options. One is the '\@startsection' command (*note
+\@startsection::). There are also many packages on CTAN that address
+this, including 'titlesec'. See the documentation but the example below
+gives a sense of what they can do.
+
+ \usepackage{titlesec} % in preamble
+ \titleformat{\section}
+ {\normalfont\Large\bfseries} % format of title
+ {\makebox[1pc][r]{\thesection\hspace{1pc}}} % label
+ {0pt} % length of separation between label and title
+ {} % before-code hook
+ \titlespacing*{\section}
+ {-1pc}{18pt}{10pt}[10pc]
+
+That puts the section number in the margin.
+
+
+File: latex2e.info, Node: \subsection, Next: \subsubsection & \paragraph & \subparagraph, Prev: \section, Up: Sectioning
+
+6.4 '\subsection'
+=================
+
+Synopsis, one of:
+
+ \subsection{TITLE}
+ \subsection*{TITLE}
+ \subsection[TOC-TITLE]{TITLE}
+
+ Start a subsection. The standard LaTeX classes 'article', 'book',
+and 'report' all have this command.
+
+ This produces a subsection.
+
+ We will show that there are more functions than Turing machines and that
+ therefore some functions have no associated machine.
+
+ \subsection{Cardinality} We will begin with two paradoxes that
+ dramatize the challenge to our intuition posed by comparing the sizes of
+ infinite sets.
+
+ For the standard LaTeX classes 'book' and 'report' the default output
+is like '1.2.3 TITLE' (for chapter 1, section 2, subsection 3), alone on
+its line and flush left, in boldface and a larger type (the type size is
+'\large'). The same holds in 'article' except that there are no
+chapters in that class so it looks like '2.3 TITLE'.
+
+ The '*' form shows TITLE. But it does not show the section number,
+does not increment the 'section' counter, and produces no table of
+contents entry.
+
+ The optional argument TOC-TITLE will appear as the section title in
+the table of contents (*note Table of contents etc.::). If it is not
+present then TITLE will be there. This shows the full name in the title
+of the section,
+
+ \subsection[$\alpha,\beta,\gamma$ paper]{\textit{The Origin of
+ Chemical Elements} by R.A.~Alpher, H.~Bethe, and G.~Gamow}
+
+but only 'U+03B1,U+03B2,U+03B3 paper' on the contents page.
+
+ For determining which sectional units are numbered and which appear
+in the table of contents, the level number of a subsection is 2 (*note
+Sectioning/secnumdepth:: and *note Sectioning/tocdepth::).
+
+ The paragraph that follows the subsection title is not indented, as
+is a standard typographical practice. One way to get an indent is to
+use the package 'indentfirst'.
+
+ There are a number of ways to change the behavior of the
+'\subsection' command. One is the '\@startsection' command (*note
+\@startsection::). There are also many packages on CTAN that address
+this, including 'titlesec'. See the documentation but the example below
+gives a sense of what they can do.
+
+ \usepackage{titlesec} % in preamble
+ \titleformat{\subsection}[runin]
+ {\normalfont\normalsize\bfseries} % format of the title
+ {\thesubsection} % label
+ {0.6em} % space between label and title
+ {} % before-code hook
+
+That puts the subsection number and TITLE in the first line of text.
+
+
+File: latex2e.info, Node: \subsubsection & \paragraph & \subparagraph, Next: \appendix, Prev: \subsection, Up: Sectioning
+
+6.5 '\subsubsection', '\paragraph', '\subparagraph'
+===================================================
+
+Synopsis, one of:
+
+ \subsubsection{TITLE}
+ \subsubsection*{TITLE}
+ \subsubsection[TOC-TITLE]{TITLE}
+
+or one of:
+
+ \paragraph{TITLE}
+ \paragraph*{TITLE}
+ \paragraph[TOC-TITLE]{TITLE}
+
+or one of:
+
+ \subparagraph{TITLE}
+ \subparagraph*{TITLE}
+ \subparagraph[TOC-TITLE]{TITLE}
+
+ Start a subsubsection, paragraph, or subparagraph. The standard
+LaTeX classes 'article', 'book', and 'report' all have these commands,
+although they are not commonly used.
+
+ This produces a subsubsection.
+
+ \subsubsection{Piston ring compressors: structural performance}
+ Provide exterior/interior wall cladding assemblies
+ capable of withstanding the effects of load and stresses from
+ consumer-grade gasoline engine piston rings.
+
+ The default output of each of the three does not change over the
+standard LaTeX classes 'article', 'book', and 'report'. For
+'\subsubsection' the TITLE is alone on its line, in boldface and normal
+size type. For '\paragraph' the TITLE is inline with the text, not
+indented, in boldface and normal size type. For '\subparagraph' the
+TITLE is inline with the text, with a paragraph indent, in boldface and
+normal size type (Because an 'article' has no chapters its
+subsubsections are numbered and so it looks like '1.2.3 TITLE', for
+section 1, subsection 2, and subsubsection 3. The other two divisions
+are not numbered.)
+
+ The '*' form shows TITLE. But it does not increment the associated
+counter and produces no table of contents entry (and does not show the
+number for '\subsubsection').
+
+ The optional argument TOC-TITLE will appear as the division title in
+the table of contents (*note Table of contents etc.::). If it is not
+present then TITLE will be there.
+
+ For determining which sectional units are numbered and which appear
+in the table of contents, the level number of a subsubsection is 3, of a
+paragraph is 4, and of a subparagraph is 5 (*note
+Sectioning/secnumdepth:: and *note Sectioning/tocdepth::).
+
+ The paragraph that follows the subsubsection title is not indented,
+as is a standard typographical practice. One way to get an indent is to
+use the package 'indentfirst'.
+
+ There are a number of ways to change the behavior of the these
+commands. One is the '\@startsection' command (*note \@startsection::).
+There are also many packages on CTAN that address this, including
+'titlesec'. See the documentation on CTAN.
+
+
+File: latex2e.info, Node: \appendix, Next: \frontmatter & \mainmatter & \backmatter, Prev: \subsubsection & \paragraph & \subparagraph, Up: Sectioning
+
+6.6 '\appendix'
+===============
+
+Synopsis:
- \chapter{A Chapter}
- ...
\appendix
- \chapter{The First Appendix}
- The 'secnumdepth' counter controls printing of section numbers. The
-setting
+ This does not directly produce any output. But in a book or report
+it declares that subsequent '\chapter' commands start an appendix. In
+an article it does the same, for '\section' commands. It also resets
+the 'chapter' and 'section' counters to 0 in a book or report, and in an
+article resets the 'section' and 'subsection' counters.
+
+ In this book
+
+ \chapter{One} ...
+ \chapter{Two} ...
+ ...
+ \appendix
+ \chapter{Three} ...
+ \chapter{Four} ...
- \setcounter{secnumdepth}{LEVEL}
+the first two will generate output numbered 'Chapter 1' and 'Chapter 2'.
+After the '\appendix' the numbering will be 'Appendix A' and 'Appendix
+B'. *Note Larger book template:: for another example.
-suppresses heading numbers at any depth > LEVEL, where 'chapter' is
-level zero. The default 'secnumdepth' is 3 in LaTeX's 'article' class
-and 2 in the 'book' and 'report' classes. (*Note \setcounter::.)
+ The 'appendix' package adds the command '\appendixpage' to put a
+separate 'Appendices' in the document body before the first appendix,
+and the command '\addappheadtotoc' to do the same in the table of
+contents. You can reset the name 'Appendix' with a command like
+'\renewcommand{\appendixname}{Specification}', as well as a number of
+other features. See the documentation on CTAN.
-* Menu:
+
+File: latex2e.info, Node: \frontmatter & \mainmatter & \backmatter, Next: \@startsection, Prev: \appendix, Up: Sectioning
+
+6.7 '\frontmatter', '\mainmatter', '\backmatter'
+================================================
+
+Synopsis, one of:
-* \@startsection:: Redefine layout of start of sections, subsections, etc.
+ \frontmatter
+ \mainmatter
+ \backmatter
+
+ Format a 'book' class document differently according to which part of
+the document is being produced. All three commands are optional.
+
+ Traditionally, a book's front matter contains such things as the
+title page, an abstract, a table of contents, a preface, a list of
+notations, a list of figures, and a list of tables. (Some of these
+front matter pages, such as the title page, are traditionally not
+numbered.) The back matter may contain such things as a glossary,
+notes, a bibliography, and an index.
+
+ The '\frontmatter' declaration makes the pages numbered in lowercase
+roman, and makes chapters not numbered, although each chapter's title
+appears in the table of contents; if you use other sectioning commands
+here, use the '*'-version (*note Sectioning::). The '\mainmatter'
+changes the behavior back to the expected version, and resets the page
+number. The '\backmatter' leaves the page numbering alone but switches
+the chapters back to being not numbered. *Note Larger book template::
+for an example using the three.

-File: latex2e.info, Node: \@startsection, Up: Sectioning
+File: latex2e.info, Node: \@startsection, Prev: \frontmatter & \mainmatter & \backmatter, Up: Sectioning
-6.1 '\@startsection'
+6.8 '\@startsection'
====================
Synopsis:
@@ -1958,9 +2480,23 @@ standard LaTeX 'book' and 'report' classes the commands '\chapter' and
may want to use the '\secdef' command.
Technically, '\@startsection' has the form
- \@startsection{NAME}{LEVEL}{INDENT}{BEFORESKIP}{AFTERSKIP}{STYLE}*[TOCTITLE]{TITLE}
-(the star '*' is optional), so that issuing
- \renewcommand{\section}{\@startsection{NAME}{LEVEL}{INDENT}{BEFORESKIP}{AFTERSKIP}{STYLE}}
+
+ \@startsection{NAME}
+ {LEVEL}
+ {INDENT}
+ {BEFORESKIP}
+ {AFTERSKIP}
+ {STYLE}*[TOCTITLE]{TITLE}
+
+so that issuing
+
+ \renewcommand{\section}{\@startsection{NAME}
+ {LEVEL}
+ {INDENT}
+ {BEFORESKIP}
+ {AFTERSKIP}
+ {STYLE}}
+
redefines '\section' to have the form '\section*[TOCTITLE]{TITLE}' (here
too, the star '*' is optional). *Note Sectioning::. This implies that
when you write a command like '\renewcommand{section}{...}', the
@@ -1970,33 +2506,30 @@ examples below.
NAME
Name of the counter used to number the sectioning header. This
counter must be defined separately. Most commonly this is either
- 'section', 'subsection', or 'paragraph'. Although in those three
- cases the counter name is the same as the sectioning command
- itself, using the same name is not required.
+ 'section', 'subsection', or 'paragraph'. Although in those cases
+ the counter name is the same as the sectioning command itself, you
+ don't have to use the same name.
Then '\the'NAME displays the title number and '\'NAME'mark' is for
the page headers. See the third example below.
LEVEL
- An integer giving the depth of the sectioning command: 0 for
- 'chapter' (only applies to the standard 'book' and 'report'
- classes), 1 for 'section', 2 for 'subsection', 3 for
- 'subsubsection', 4 for 'paragraph', and 5 for 'subparagraph'. In
- the 'book' and 'report' classes 'part' has level -1, while in the
- 'article' class 'part' has level 0.
-
- If LEVEL is less than or equal to the value of 'secnumdepth' then
- the titles for this sectioning command will be numbered. For
- instance, in an 'article', if 'secnumdepth' is 1 then a
- '\section{Introduction}' command will produce output like "1
- Introduction" while '\subsection{Discussion}' will produce output
- like "Discussion", without the number prefix. *Note
- Sectioning/secnumdepth::.
-
- If LEVEL is less than or equal to the value of TOCDEPTH then the
- table of contents will have an entry for this sectioning unit. For
- instance, in an 'article', if TOCDEPTH is 1 then the table of
- contents will list sections but not subsections.
+ An integer giving the depth of the sectioning command. *Note
+ Sectioning:: for the list of standard level numbers.
+
+ If LEVEL is less than or equal to the value of the counter
+ 'secnumdepth' then titles for this sectioning command will be
+ numbered (*note Sectioning/secnumdepth::). For instance, if
+ 'secnumdepth' is 1 in an 'article' then the command
+ '\section{Introduction}' will produce output like "1 Introduction"
+ while '\subsection{Discussion}' will produce output like
+ "Discussion", without the number prefix.
+
+ If LEVEL is less than or equal to the value of the counter TOCDEPTH
+ then the table of contents will have an entry for this sectioning
+ unit (*note Sectioning/tocdepth::). For instance, in an 'article',
+ if TOCDEPTH is 1 then the table of contents will list sections but
+ not subsections.
INDENT
A length giving the indentation of all of the title lines with
@@ -2059,31 +2592,29 @@ STYLE
Controls the styling of the title. See the examples below.
Typical commands to use here are '\centering', '\raggedright',
'\normalfont', '\hrule', or '\newpage'. The last command in STYLE
- may be one such as '\MakeUppercase' or '\fbox' that takes one
- argument. The section title will be supplied as the argument to
- this command. For instance, setting STYLE to
- '\bfseries\MakeUppercase' would produce titles that are bold and
- upper case.
+ may be one that takes one argument, such as '\MakeUppercase' or
+ '\fbox' that takes one argument. The section title will be
+ supplied as the argument to this command. For instance, setting
+ STYLE to '\bfseries\MakeUppercase' would produce titles that are
+ bold and uppercase.
These are LaTeX's defaults for the first three sectioning units that
are defined with '\@startsection', for the 'article', 'book', and
-'report' classes.
-
- 'section' 'subsection' 'subsubsection'
------------------------------------------------------------------------------
-*note NAME: \@startsection/name.sectionsubsection subsubsection
-*note LEVEL: \@startsection/level.12 3
-*note INDENT: \@startsection/indent.'0pt''0pt' '0pt'
-*note BEFORESKIP: \@startsection/beforeskip.'-3.5ex plus -1ex'-3.25ex plus -1ex'-3.25ex plus -1ex
- minus -0.2ex' minus -0.2ex' minus -0.2ex'
-*note AFTERSKIP: \@startsection/afterskip.'2.3ex plus 0.2ex''1.5ex plus 0.2ex''1.5ex plus 0.2ex'
-*note STYLE: \@startsection/style.'\normalfont\Large\bfseries''\normalfont\large\bfseries''\normalfont\normalsize\bfseries'
+'report' classes. For section, the LEVEL is 1, the INDENT is 0pt, the
+BEFORESKIP is '-3.5ex plus -1ex minus -0.2ex', the AFTERSKIP is '2.3ex
+plus 0.2ex', and the STYLE is '\normalfont\Large\bfseries'. For
+subsection, the LEVEL is 2, the INDENT is 0pt, the BEFORESKIP is
+'-3.25ex plus -1ex minus -0.2ex', the AFTERSKIP is '1.5ex plus 0.2ex',
+and the STYLE is '\normalfont\large\bfseries'. For subsubsection, the
+LEVEL is 3, the INDENT is 0pt, the BEFORESKIP is '-3.25ex plus -1ex
+minus -0.2ex', the AFTERSKIP is '1.5ex plus 0.2ex', and the STYLE is
+'\normalfont\normalsize\bfseries'.
Here are examples. They go either in a package or class file or in
the preamble of a LaTeX document. If you put them in the preamble they
must go between a '\makeatletter' command and a '\makeatother'.
(Probably the error message 'You can't use `\spacefactor' in vertical
-mode.' means that you forgot this.) *Note \makeatletter and
+mode.' means that you forgot this.) *Note \makeatletter &
\makeatother::.
This will put section titles in large boldface type, centered. It
@@ -2136,33 +2667,42 @@ File: latex2e.info, Node: Cross references, Next: Environments, Prev: Section
7 Cross references
******************
-One reason for numbering things such as figures and equations is to
-refer the reader to them, as in "See Figure~3 for more details."
-
- Including the figure number in the source is poor practice since if
-that number changes as the document evolves then you must remember to
-update this reference by hand. Instead, LaTeX has you write a "label"
-like '\label{eq:GreensThm}' and refer to it with 'See
-equation~\ref{eq:GreensThm}'.
-
- LaTeX writes the information from the labels to a file with the same
-name as the file containing the '\label{...}' but with an '.aux'
-extension. (The information has the format
-'\newlabel{LABEL}{{CURRENTLABEL}{PAGENUMBER}}' where CURRENTLABEL is the
-current value of the macro '\@currentlabel' that is usually updated
-whenever you call '\refstepcounter{COUNTER}'.)
-
- The most common side effect of the prior paragraph happens when your
-document has a "forward reference", a '\ref{KEY}' that appears earlier
-than the associated '\label{KEY}'; see the example in the
-'\pageref{...}' description. LaTeX gets the information for references
-from the '.aux' file. If this is the first time you are compiling the
-document then you will get a message 'LaTeX Warning: Label(s) may have
-changed. Rerun to get cross references right.' and in the output the
-reference will appear as two question marks '??', in boldface. Or, if
-you change some things so the references change then you get the same
-warning and the output contains the old reference information. The
-solution in either case is just to compile the document a second time.
+We often want something like 'See Theorem~31'. But by-hand typing the
+31 is poor practice. Instead you should write a "label" such as
+'\label{eq:GreensThm}' and then "reference" it, as with 'See
+equation~\ref{eq:GreensThm}'. LaTeX will automatically work out the
+number, put it into the output, and will change that number later if
+needed.
+
+ We will see this with Theorem~\ref{th:GreensThm}. % forward reference
+ ...
+ \begin{theorem} \label{th:GreensThm}
+ ...
+ \end{theorem}
+ ...
+ See Theorem~\ref{th:GreensThm} on page~\pageref{th:GreensThm}.
+
+ LaTeX tracks cross reference information in a file having the
+extension '.aux' and with the same base name as the file containing the
+'\label'. So if '\label' is in 'calculus.tex' then the information is
+in 'calculus.aux'. LaTeX puts the information in that file every time
+it runs across a '\label'.
+
+ The behavior described in the prior paragraph results in a quirk that
+happens when your document has a "forward reference", a '\ref' that
+appears before the associated '\label'. If this is the first time that
+you are compiling the document then you will get 'LaTeX Warning:
+Label(s) may have changed. Rerun to get cross references right' and in
+the output the forward reference will appear as two question marks '??',
+in boldface. A similar thing happens if you change some things so the
+references changes; you get the same warning and the output contains the
+old reference information. In both cases, resolve this by compiling the
+document a second time.
+
+ The 'cleveref' package enhances LaTeX's cross referencing features.
+You can arrange that if you enter
+'\begin{thm}\label{th:Nerode}...\end{thm}' then '\cref{th:Nerode}' will
+output 'Theorem 3.21', without you having to enter the "Theorem."
* Menu:
@@ -2191,28 +2731,35 @@ punctuation characters. Upper and lowercase letters are distinguished,
as usual.
A common convention is to use labels consisting of a prefix and a
-suffix separated by a colon or period. This helps to avoid accidentally
-creating two labels with the same name, and makes your source more
-readable. Some commonly-used prefixes:
+suffix separated by a colon or period. Thus, '\label{fig:Post}' is a
+label for a figure with a portrait of Emil Post. This helps to avoid
+accidentally creating two labels with the same name, and makes your
+source more readable. Some commonly-used prefixes:
'ch'
for chapters
+
'sec'
+'subsec'
for lower-level sectioning commands
+
'fig'
for figures
+
'tab'
for tables
+
'eq'
for equations
- Thus, '\label{fig:Euler}' is a label for a figure with a portrait of
-the great man.
+ In the auxiliary file the reference information is kept as the text
+of a command of the form '\newlabel{LABEL}{{CURRENTLABEL}{PAGENUMBER}}'.
+Here CURRENTLABEL is the current value of the macro '\@currentlabel'
+that is usually updated whenever you call '\refstepcounter{COUNTER}'.
- In this example below the key 'sec:test' will get the number of the
-current section and the key 'fig:test' will get the number of the
-figure. (Incidentally, put labels after captions in figures and
-tables.)
+ Below, the key 'sec:test' will get the number of the current section
+and the key 'fig:test' will get the number of the figure.
+(Incidentally, put labels after captions in figures and tables.)
\section{section name}
\label{sec:test}
@@ -2227,8 +2774,8 @@ tables.)

File: latex2e.info, Node: \pageref, Next: \ref, Prev: \label, Up: Cross references
-7.2 '\pageref{KEY}'
-===================
+7.2 '\pageref'
+==============
Synopsis:
@@ -2237,10 +2784,13 @@ Synopsis:
Produce the page number of the place in the text where the
corresponding '\label'{KEY} command appears.
- In this example the '\label{eq:main}' is used both for the formula
-number and for the page number. (Note that the two references are
-forward references, so this document would need to be compiled twice to
-resolve those.)
+ If there is no '\label{KEY}' then you get something like 'LaTeX
+Warning: Reference `th:GrensThm' on page 1 undefined on input line 11.'
+
+ Below, the '\label{eq:main}' is used both for the formula number and
+for the page number. (Note that the two references are forward
+references so this document would need to be compiled twice to resolve
+those.)
The main result is formula~\ref{eq:main} on page~\pageref{eq:main}.
...
@@ -2251,8 +2801,8 @@ resolve those.)

File: latex2e.info, Node: \ref, Prev: \pageref, Up: Cross references
-7.3 '\ref{KEY}'
-===============
+7.3 '\ref'
+==========
Synopsis:
@@ -2263,8 +2813,12 @@ figure, ..., of the corresponding '\label' command (*note \label::). It
does not produce any text, such as the word 'Section' or 'Figure', just
the bare number itself.
- In this example, the '\ref{popular}' produces '2'. Note that it is a
-forward reference since it comes before '\label{popular}'.
+ If there is no '\label{KEY}' then you get something like 'LaTeX
+Warning: Reference `th:GrensThm' on page 1 undefined on input line 11.'
+
+ In this example the '\ref{popular}' produces '2'. Note that it is a
+forward reference since it comes before '\label{popular}' so this
+document would have to be compiled twice.
The most widely-used format is item number~\ref{popular}.
\begin{enumerate}
@@ -2273,6 +2827,9 @@ forward reference since it comes before '\label{popular}'.
\item Con\TeX t
\end{enumerate}
+ The 'cleveref' package includes text such as 'Theorem' in the
+reference. See the documentation on CTAN.
+

File: latex2e.info, Node: Environments, Next: Line breaking, Prev: Cross references, Up: Top
@@ -2314,11 +2871,11 @@ an error like: '! LaTeX Error: \begin{table*} on input line 5 ended by
* math:: In-line math.
* minipage:: Miniature page.
* picture:: Picture with text, arrows, lines and circles.
-* quotation and quote:: Include a quotation.
+* quotation & quote:: Include a quotation.
* tabbing:: Align text arbitrarily.
* table:: Floating tables.
* tabular:: Align text in columns.
-* thebibliography:: Bibliography or reference list.
+* thebibliography:: Bibliography or reference list.
* theorem:: Theorems, lemmas, etc.
* titlepage:: For hand crafted title pages.
* verbatim:: Simulating typed input.
@@ -2386,7 +2943,7 @@ Synopsis:
...
\end{array}
- or
+or:
\begin{array}[POS]{COLS}
COLUMN 1 ENTRY &COLUMN 2 ENTRY ... &COLUMN N ENTRY \\
@@ -2395,22 +2952,38 @@ Synopsis:
Produce a mathematical array. This environment can only be used in
math mode, and normally appears within a displayed mathematics
-environment such as 'equation' (*note equation::). Column entries are
-separated by an ampersand ('&'). Rows are terminated with
-double-backslashes (*note \\::).
+environment such as 'equation' (*note equation::). Inside of each row
+the column entries are separated by an ampersand, ('&'). Rows are
+terminated with double-backslashes (*note \\::).
+
+ This example shows a three by three array.
+
+ \begin{equation*}
+ \chi(x) =
+ \left| % vertical bar fence
+ \begin{array}{ccc}
+ x-a &-b &-c \\
+ -d &x-e &-f \\
+ -g &-h &x-i
+ \end{array}
+ \right|
+ \end{equation*}
The required argument COLS describes the number of columns, their
-alignment, and the formatting of the intercolumn regions. See *note
-tabular:: for the complete description of COLS, and of the other common
+alignment, and the formatting of the intercolumn regions. For instance,
+'\begin{array}{rcl}...\end{array}' gives three columns: the first flush
+right, the second centered, and the third flush left. See *note
+tabular:: for the complete description of COLS and of the other common
features of the two environments, including the optional POS argument.
There are two ways that 'array' diverges from 'tabular'. The first
-is that 'array' entries are typeset in math mode, in textstyle (except
-if the COLS definition specifies the column with 'p{...}', which causes
-the entry to be typeset in text mode). The second is that, instead of
-'tabular''s parameter '\tabcolsep', LaTeX's intercolumn space in an
-'array' is governed by '\arraycolsep', which gives half the width
-between columns. The default for this is '5pt'.
+is that 'array' entries are typeset in math mode, in textstyle (*note
+Modes::) except if the COLS definition specifies the column with
+'p{...}', which causes the entry to be typeset in text mode. The second
+is that, instead of 'tabular''s parameter '\tabcolsep', LaTeX's
+intercolumn space in an 'array' is governed by '\arraycolsep', which
+gives half the width between columns. The default for this is '5pt' so
+that between two columns comes 10pt of space.
To obtain arrays with braces the standard is to use the 'amsmath'
package. It comes with environments 'pmatrix' for an array surrounded
@@ -2420,24 +2993,22 @@ braces '{...}', 'vmatrix' for an array surrounded by vertical
bars '|...|', and 'Vmatrix' for an array surrounded by double vertical
bars '||...||', along with a number of other array constructs.
- Here is an example of an array:
-
- \begin{equation}
- \begin{array}{cr}
- \sqrt{y} &12.3 \\
- x^2 &3.4
- \end{array}
- \end{equation}
+ The next example uses the 'amsmath' package.
- The next example works if '\usepackage{amsmath}' is in the preamble:
+ \usepackage{amsmath} % in preamble
\begin{equation}
- \begin{vmatrix}{cc}
+ \begin{vmatrix}{cc} % array with vert lines
a &b \\
c &d
\end{vmatrix}=ad-bc
\end{equation}
+ There are many packages concerning arrays. The 'array' package has
+many useful extensions, including more column types. The 'dcolumn'
+package adds a column type to center on a decimal point. For both see
+the documentation on CTAN.
+

File: latex2e.info, Node: center, Next: description, Prev: array, Up: Environments
@@ -2447,15 +3018,16 @@ File: latex2e.info, Node: center, Next: description, Prev: array, Up: Enviro
Synopsis:
\begin{center}
- ... text ...
+ LINE1 \\
+ LINE2 \\
+ ...
\end{center}
Create a new paragraph consisting of a sequence of lines that are
-centered within the left and right margins on the current page. Use
-double-backslash to get a line break at a particular spot (*note \\::).
-If some text environment body is too long to fit on a line, LaTeX will
-insert line breaks that avoid hyphenation and avoid stretching or
-shrinking any interword space.
+centered within the left and right margins. Use double-backslash, '\\',
+to get a line break (*note \\::). If some text is too long to fit on a
+line then LaTeX will insert line breaks that avoid hyphenation and avoid
+stretching or shrinking any interword space.
This environment inserts space above and below the text body. See
*note \centering:: to avoid such space, for example inside a 'figure'
@@ -2482,7 +3054,11 @@ ending.
I grew up in that belief. --Richard Burton
\end{center}
- A double backslash after the final line is optional.
+ A double backslash after the final line is optional. If present it
+doesn't add any vertical space.
+
+ In a two-column document the text is centered in a column, not in the
+entire page.
* Menu:
@@ -2494,12 +3070,33 @@ File: latex2e.info, Node: \centering, Up: center
8.3.1 '\centering'
------------------
-A declaration that causes material in its scope to be centered. It is
-most often used inside an environment such as 'figure', or in a
-'parbox'.
+Synopsis:
+
+ {\centering ... }
+
+or
+
+ \begin{group}
+ \centering ...
+ \end{group}
+
+ Center the material in its scope. It is most often used inside an
+environment such as 'figure', or in a 'parbox'.
+
+ This example's '\centering' declaration causes the graphic to be
+horizontally centered.
+
+ \begin{figure}
+ \centering
+ \includegraphics[width=0.6\textwidth]{ctan_lion.png}
+ \caption{CTAN Lion} \label{fig:CTANLion}
+ \end{figure}
+
+The scope of this '\centering' ends with the '\end{figure}'.
Unlike the 'center' environment, the '\centering' command does not
-add vertical space above and below the text.
+add vertical space above and below the text. That's its advantage in
+the above example; there is not an excess of space.
It also does not start a new paragraph; it simply changes how LaTeX
formats paragraph units. If 'ww {\centering xx \\ yy} zz' is surrounded
@@ -2510,18 +3107,7 @@ blank line or the '\end' command of an environment such as 'figure' or
'table' that ends the paragraph unit. Thus, if '{\centering xx \\
yy\par} zz' is surrounded by blank lines then it makes a new paragraph
with two centered lines 'xx' and 'yy', followed by a new paragraph with
-'zz' that is formatted as usual. See also the following example.
-
- This example's '\centering' causes the graphic to be horizontally
-centered.
-
- \begin{figure}
- \centering
- \includegraphics[width=0.6\textwidth]{ctan_lion.png}
- \caption{CTAN Lion} \label{fig:CTANLion}
- \end{figure}
-
- The scope of the '\centering' ends with the '\end{figure}'.
+'zz' that is formatted as usual.

File: latex2e.info, Node: description, Next: displaymath, Prev: center, Up: Environments
@@ -2532,26 +3118,28 @@ File: latex2e.info, Node: description, Next: displaymath, Prev: center, Up:
Synopsis:
\begin{description}
- \item[LABEL OF FIRST ITEM] text of first item
- \item[LABEL OF SECOND ITEM] text of second item
- ...
+ \item[LABEL OF FIRST ITEM] TEXT OF FIRST ITEM
+ \item[LABEL OF SECOND ITEM] TEXT OF SECOND ITEM
+ ...
\end{description}
- Environment to make a labeled list of items. Each item's LABEL is
-typeset in bold, and is flush left so that long labels continue into the
+ Environment to make a list of labeled items. Each item's LABEL is
+typeset in bold and is flush left, so that long labels continue into the
first line of the item text. There must be at least one item; having
none causes the LaTeX error 'Something's wrong--perhaps a missing
\item'.
This example shows the environment used for a sequence of
-definitions. The labels 'lama' and 'llama' come out in boldface with
-their left edges aligned on the left margin.
+definitions.
\begin{definition}
\item[lama] A priest.
\item[llama] A beast.
\end{definition}
+The labels 'lama' and 'llama' are output in boldface, with the left edge
+on the left margin.
+
Start list items with the '\item' command (*note \item::). Use the
optional labels, as in '\item[Main point]', because there is no sensible
default. Following the '\item' is optional text, which may contain
@@ -2561,9 +3149,10 @@ multiple paragraphs.
font change given in argument style (see *note Font styles::) then it
will come out bold. For instance, if the label text calls for
typewriter with '\item[\texttt{label text}]' then it will appear in bold
-typewriter, if that is available. The simplest way to get non-bold
-typewriter is to use declarative style: '\item[{\tt label text}]'.
-Similarly, get the standard roman font with '\item[{\rm label text}]'.
+typewriter, if that is available. The simplest way around this, in this
+example to get non-bold typewriter, is to use declarative style:
+'\item[{\tt label text}]'. Similarly, get the standard roman font with
+'\item[{\rm label text}]'.
For other major LaTeX labelled list environments, see *note itemize::
and *note enumerate::. Unlike those environments, nesting 'description'
@@ -2588,7 +3177,7 @@ File: latex2e.info, Node: displaymath, Next: document, Prev: description, Up
Synopsis:
\begin{displaymath}
- MATH TEXT
+ MATHEMATICAL TEXT
\end{displaymath}
Environment to typeset the math text on its own line, in display
@@ -2618,11 +3207,13 @@ vertical spacing, and because the 'displaymath' environment honors the
'fleqn' option.)
The output from this example is centered and alone on its line.
+
\begin{displaymath}
\int_1^2 x^2\,dx=7/3
\end{displaymath}
- Also, the integral sign is larger than the inline version '\(
-\int_1^2 x^2\,dx=7/3 \)' produces.
+
+Also, the integral sign is larger than the inline version '\( \int_1^2
+x^2\,dx=7/3 \)' produces.

File: latex2e.info, Node: document, Next: enumerate, Prev: displaymath, Up: Environments
@@ -2685,9 +3276,9 @@ File: latex2e.info, Node: enumerate, Next: eqnarray, Prev: document, Up: Env
Synopsis:
\begin{enumerate}
- \item[OPTIONAL LABEL OF FIRST ITEM] text of first item
- \item[OPTIONAL LABEL OF SECOND ITEM] text of second item
- ...
+ \item[OPTIONAL LABEL OF FIRST ITEM] TEXT OF FIRST ITEM
+ \item[OPTIONAL LABEL OF SECOND ITEM] TEXT OF SECOND ITEM
+ ...
\end{enumerate}
Environment to produce a numbered list of items. The format of the
@@ -2719,9 +3310,9 @@ format at each nesting level, where 1 is the top level, the outermost
level.
1. arabic number followed by a period: '1.', '2.', ...
- 2. lower case letter inside parentheses: '(a)', '(b)' ...
- 3. lower case roman numeral followed by a period: 'i.', 'ii.', ...
- 4. upper case letter followed by a period: 'A.', 'B.', ...
+ 2. lowercase letter inside parentheses: '(a)', '(b)' ...
+ 3. lowercase roman numeral followed by a period: 'i.', 'ii.', ...
+ 4. uppercase letter followed by a period: 'A.', 'B.', ...
The 'enumerate' environment uses the counters '\enumi' through
'\enumiv' (*note Counters::).
@@ -2752,23 +3343,23 @@ File: latex2e.info, Node: eqnarray, Next: equation, Prev: enumerate, Up: Env
8.8 'eqnarray'
==============
-First, a caveat: the 'eqnarray' environment is depreciated. It has
-infelicities that cannot be overcome, including spacing that is
-inconsistent with other mathematics elements (see the article "Avoid
-eqnarray!" by Lars Madsen
+The 'eqnarray' environment is obsolete. It has infelicities, including
+spacing that is inconsistent with other mathematics elements. (See
+"Avoid eqnarray!" by Lars Madsen
<http://tug.org/TUGboat/tb33-1/tb103madsen.pdf>). New documents should
include the 'amsmath' package and use the displayed mathematics
-environments provided there, such as the 'align' environment.
+environments provided there, such as the 'align' environment. We
+include a description only for completeness and for working with old
+documents.
- Nevertheless, for completeness and for a reference when working with
-old documents, a synopsis:
+ Synopsis:
\begin{eqnarray}
FIRST FORMULA LEFT &FIRST FORMULA MIDDLE &FIRST FORMULA RIGHT \\
...
\end{eqnarray}
- or
+or
\begin{eqnarray*}
FIRST FORMULA LEFT &FIRST FORMULA MIDDLE &FIRST FORMULA RIGHT \\
@@ -2812,21 +3403,19 @@ File: latex2e.info, Node: equation, Next: figure, Prev: eqnarray, Up: Enviro
Synopsis:
\begin{equation}
- math text
+ MATHEMATICAL TEXT
\end{equation}
- Make a 'displaymath' environment (*note displaymath::) with an
-equation number in the right margin.
-
- The equation number is generated using the 'equation' counter.
+ The same as a 'displaymath' environment (*note displaymath::) except
+that LaTeX puts an equation number flush to the right margin. The
+equation number is generated using the 'equation' counter.
You should have no blank lines between '\begin{equation}' and
'\begin{equation}', or LaTeX will tell you that there is a missing
-dollar sign, $'$'.
+dollar sign.
- Note that the 'amsmath' package has extensive displayed equation
-facilities. Those facilities are the best approach for such output in
-new documents.
+ The package 'amsmath' package has extensive displayed equation
+facilities. New documents should include this package.

File: latex2e.info, Node: figure, Next: filecontents, Prev: equation, Up: Environments
@@ -2837,26 +3426,33 @@ File: latex2e.info, Node: figure, Next: filecontents, Prev: equation, Up: En
Synopsis:
\begin{figure}[PLACEMENT]
- figure body
- \caption[LOFTITLE]{TITLE}
- \label{LABEL}
+ FIGURE BODY
+ \caption[LOFTITLE]{TITLE} % optional
+ \label{LABEL} % optional
\end{figure}
- or
+or:
\begin{figure*}[PLACEMENT]
- figure body
- \caption[LOFTITLE]{TITLE}
- \label{LABEL}
+ FIGURE BODY
+ \caption[LOFTITLE]{TITLE} % optional
+ \label{LABEL} % optional
\end{figure*}
- A class of floats (*note Floats::). Because they cannot be split
-across pages, they are not typeset in sequence with the normal text but
-instead are "floated" to a convenient place, such as the top of a
-following page.
+ Figures are for material that is not part of the normal text. An
+example is material that you cannot have split between two pages, such
+as a graphic. Because of this, LaTeX does not typeset figures in
+sequence with normal text but instead "floats" them to a convenient
+place, such as the top of a following page (*note Floats::).
- For the possible values of PLACEMENT and their effect on the float
-placement algorithm, see *note Floats::.
+ The FIGURE BODY can consist of imported graphics (*note Graphics::),
+or text, LaTeX commands, etc. It is typeset in a 'parbox' of width
+'\textwidth'.
+
+ The possible values of PLACEMENT are 'h' for 'here', 't' for 'top',
+'b' for 'bottom', and 'p' for 'on a separate page of floats'. For the
+effect of these options on the float placement algorithm, see *note
+Floats::.
The starred form 'figure*' is used when a document is in
double-column mode (*note \twocolumn::). It produces a figure that
@@ -2864,20 +3460,18 @@ spans both columns, at the top of the page. To add the possibility of
placing at a page bottom see the discussion of PLACEMENT 'b' in *note
Floats::.
- The figure body is typeset in a 'parbox' of width '\textwidth' and so
-it can contain text, commands, etc.
-
The label is optional; it is used for cross references (*note Cross
references::). The optional '\caption' command specifies caption text
for the figure. By default it is numbered. If LOFTITLE is present, it
-is used in the list of figures instead of TITLE (*note Tables of
-contents::).
+is used in the list of figures instead of TITLE (*note Table of contents
+etc.::).
- This example makes a figure out of a graphic. It requires one of the
-packages 'graphics' or 'graphicx'. The graphic, with its caption, will
-be placed at the top of a page or, if it is pushed to the end of the
-document, on a page of floats.
+ This example makes a figure out of a graphic. LaTeX will place that
+graphic and its caption at the top of a page or, if it is pushed to the
+end of the document, on a page of floats.
+ \usepackage{graphicx} % in preamble
+ ...
\begin{figure}[t]
\centering
\includegraphics[width=0.5\textwidth]{CTANlion.png}
@@ -2896,7 +3490,7 @@ Synopsis:
TEXT
\end{filecontents}
- or
+or
\begin{filecontents*}{FILENAME}
TEXT
@@ -2930,7 +3524,7 @@ nothing in that case, it will overwrite the existing file.
Article by \myname.
\end{document}
- produces this file 'JH.sty'.
+produces this file 'JH.sty'.
%% LaTeX2e file `JH.sty'
%% generated by the `filecontents' environment
@@ -2944,15 +3538,30 @@ File: latex2e.info, Node: flushleft, Next: flushright, Prev: filecontents, U
8.12 'flushleft'
================
+Synopsis:
+
\begin{flushleft}
- LINE1 \\
- LINE2 \\
- ...
+ LINE1 \\
+ LINE2 \\
+ ...
\end{flushleft}
- The 'flushleft' environment allows you to create a paragraph
-consisting of lines that are flush to the left-hand margin and ragged
-right. Each line must be terminated with the string '\\'.
+ An environment that creates a paragraph whose lines are flush to the
+left-hand margin, and ragged right. If you have lines that are too long
+then LaTeX will linebreak them in a way that avoids hyphenation and
+stretching or shrinking spaces. To force a new line use a double
+backslash, '\\'. For the declaration form see *note \raggedright::.
+
+ This creates a box of text that is at most 3 inches wide, with the
+text flush left and ragged right.
+
+ \noindent\begin{minipage}{3in}
+ \begin{flushleft}
+ A long sentence that will be broken by \LaTeX{}
+ at a convenient spot. \\
+ And, a fresh line forced by the double backslash.
+ \end{flushleft}
+ \end{minipage}
* Menu:
@@ -2964,9 +3573,19 @@ File: latex2e.info, Node: \raggedright, Up: flushleft
8.12.1 '\raggedright'
---------------------
-The '\raggedright' declaration corresponds to the 'flushleft'
-environment. This declaration can be used inside an environment such as
-'quote' or in a 'parbox'.
+Synopses:
+
+ {\raggedright ... }
+
+or
+
+ \begin{ENVIRONMENT} \raggedright
+ ...
+ \end{ENVIRONMENT}
+
+ A declaration which causes lines to be flush to the left margin and
+ragged right. It can be used inside an environment such as 'quote' or
+in a 'parbox'. For the environment form see *note flushleft::.
Unlike the 'flushleft' environment, the '\raggedright' command does
not start a new paragraph; it only changes how LaTeX formats paragraph
@@ -2974,6 +3593,16 @@ units. To affect a paragraph unit's format, the scope of the
declaration must contain the blank line or '\end' command that ends the
paragraph unit.
+ Here '\raggedright' in each second column keeps LaTeX from doing very
+awkward typesetting to fit the text into the narrow column. Note that
+'\raggedright' is inside the curly braces '{...}' to delimit its effect.
+
+ \begin{tabular}{rp{2in}}
+ Team alpha &{\raggedright This team does all the real work.} \\
+ Team beta &{\raggedright This team ensures that the water
+ cooler is never empty.} \\
+ \end{tabular}
+

File: latex2e.info, Node: flushright, Next: itemize, Prev: flushleft, Up: Environments
@@ -2981,14 +3610,19 @@ File: latex2e.info, Node: flushright, Next: itemize, Prev: flushleft, Up: En
=================
\begin{flushright}
- LINE1 \\
- LINE2 \\
- ...
+ LINE1 \\
+ LINE2 \\
+ ...
\end{flushright}
- The 'flushright' environment allows you to create a paragraph
-consisting of lines that are flush to the right-hand margin and ragged
-left. Each line must be terminated with the control sequence '\\'.
+ An environment that creates a paragraph whose lines are flush to the
+right-hand margin and ragged left. If you have lines that are too long
+to fit the margins then LaTeX will linebreak them in a way that avoids
+hyphenation and stretching or shrinking spaces. To force a new line use
+a double backslash, '\\'. For the declaration form see *note
+\raggedleft::.
+
+ For an example related to this environment, see *note flushleft::.
* Menu:
@@ -3000,9 +3634,19 @@ File: latex2e.info, Node: \raggedleft, Up: flushright
8.13.1 '\raggedleft'
--------------------
-The '\raggedleft' declaration corresponds to the 'flushright'
-environment. This declaration can be used inside an environment such as
-'quote' or in a 'parbox'.
+Synopses:
+
+ {\raggedleft ... }
+
+or
+
+ \begin{ENVIRONMENT} \raggedleft
+ ...
+ \end{ENVIRONMENT}
+
+ A declaration which causes lines to be flush to the right margin and
+ragged left. It can be used inside an environment such as 'quote' or in
+a 'parbox'. For the environment form see *note flushright::.
Unlike the 'flushright' environment, the '\raggedleft' command does
not start a new paragraph; it only changes how LaTeX formats paragraph
@@ -3010,6 +3654,8 @@ units. To affect a paragraph unit's format, the scope of the
declaration must contain the blank line or '\end' command that ends the
paragraph unit.
+ For an example related to this environment, see *note \raggedright::.
+

File: latex2e.info, Node: itemize, Next: letter, Prev: flushright, Up: Environments
@@ -3019,25 +3665,25 @@ File: latex2e.info, Node: itemize, Next: letter, Prev: flushright, Up: Envir
Synopsis:
\begin{itemize}
- \item[OPTIONAL LABEL OF FIRST ITEM] text of first item
- \item[OPTIONAL LABEL OF SECOND ITEM] text of second item
- ...
+ \item[OPTIONAL LABEL OF FIRST ITEM] TEXT OF FIRST ITEM
+ \item[OPTIONAL LABEL OF SECOND ITEM] TEXT OF SECOND ITEM
+ ...
\end{itemize}
- The 'itemize' environment produces an "unordered", "bulleted" list.
-The format of the label numbering depends on the nesting level of this
-environment; see below. Each 'itemize' list environment must have at
-least one item; having none causes the LaTeX error 'Something's
-wrong--perhaps a missing \item'.
+ Produce a list that is unordered, sometimes called a bullet list.
+The environment must have at least one '\item'; having none causes the
+LaTeX error 'Something's wrong--perhaps a missing \item'.
- This example gives a two-item list. As a top-level list each label
-would come out as a bullet, *.
+ This gives a two-item list.
\begin{itemize}
\item Pencil and watercolor sketch by Cassandra
\item Rice portrait
\end{itemize}
+As a top-level list each label would come out as a bullet, *. The
+format of the labeling depends on the nesting level; see below.
+
Start list items with the '\item' command (*note \item::). If you
give '\item' an optional argument by following it with square brackets,
as in '\item[Optional label]', then by default it will appear in bold
@@ -3049,7 +3695,7 @@ the '\item' is optional text, which may contain multiple paragraphs.
deep. They can also be nested within other paragraph-making
environments, such as 'enumerate' (*note enumerate::). The 'itemize'
environment uses the commands '\labelitemi' through '\labelitemiv' to
-produce the default label (this also uses the convention of lower case
+produce the default label (this also uses the convention of lowercase
roman numerals at the end of the command names that signify the nesting
level). These are the default marks at each level.
@@ -3067,7 +3713,7 @@ first level use diamonds.
The distance between the left margin of the enclosing environment and
the left margin of the 'itemize' list is determined by the parameters
'\leftmargini' through '\leftmarginvi'. (Note the convention of using
-lower case roman numerals a the end of the command name to denote the
+lowercase roman numerals a the end of the command name to denote the
nesting level.) The defaults are: '2.5em' in level 1 ('2em' in
two-column mode), '2.2em' in level 2, '1.87em' in level 3, and '1.7em'
in level 4, with smaller values for more deeply nested levels.
@@ -3086,8 +3732,8 @@ lists.
Especially for lists with short items, it may be desirable to elide
space between items. Here is an example defining an 'itemize*'
environment with no extra spacing between items, or between paragraphs
-within a single item ('\parskip' is not list-specific, *note
-\parskip::):
+within a single item ('\parskip' is not list-specific, *note \parindent
+& \parskip::):
\newenvironment{itemize*}%
{\begin{itemize}%
@@ -3113,31 +3759,31 @@ File: latex2e.info, Node: list, Next: math, Prev: letter, Up: Environments
Synopsis:
\begin{list}{LABELING}{SPACING}
- \item[OPTIONAL LABEL OF FIRST ITEM] text of first item
- \item[OPTIONAL LABEL OF SECOND ITEM] text of second item
- ...
+ \item[OPTIONAL LABEL OF FIRST ITEM] TEXT OF FIRST ITEM
+ \item[OPTIONAL LABEL OF SECOND ITEM] TEXT OF SECOND ITEM
+ ...
\end{list}
- The 'list' environment is a generic environment for constructing more
-specialized lists. It is most often used to create lists via the
-'description', 'enumerate', and 'itemize' environments (*note
-description::, *note enumerate::, and *note itemize::).
+ An environment for constructing lists.
- Also, many standard LaTeX environments that are not visually lists
-are constructed using 'list', including 'quotation', 'quote', 'center',
-'verbatim', and plenty more (*note quotation and quote::, *note
-center::, *note flushright::).
+ Note that this environment does not typically appear in the document
+body. Most lists created by LaTeX authors are the ones that come
+standard: the 'description', 'enumerate', and 'itemize' environments
+(*note description::, *note enumerate::, and *note itemize::).
- The third-party package 'enumitem' is useful for customizing lists.
-Here, we describe the 'list' environment by defining a new custom
-environment.
+ Instead, the 'list' environment is most often used in macros. For
+example, many standard LaTeX environments that do not immediately appear
+to be lists are in fact constructed using 'list', including 'quotation',
+'quote', and 'center' (*note quotation & quote::, *note center::).
+
+ This uses the 'list' environment to define a new custom environment.
\newcounter{namedlistcounter} % number the items
\newenvironment{named}
{\begin{list}
- {Item~\Roman{namedlistcounter}.} % labeling argument
- {\usecounter{namedlistcounter} % spacing argument
- \setlength{\leftmargin}{3.5em}} % still spacing arg
+ {Item~\Roman{namedlistcounter}.} % labeling
+ {\usecounter{namedlistcounter} % set counter
+ \setlength{\leftmargin}{3.5em}} % set spacing
}
{\end{list}}
@@ -3147,42 +3793,45 @@ environment.
\item Shows as ``Item~II.''
\end{named}
- The 'list' environment's mandatory first argument, LABELING,
-specifies the default labeling of list items. It can contain text and
-LaTeX commands, as above where it contains both 'Item' and
-'\Roman{...}'. LaTeX forms the label by putting the LABELING argument
-in a box of width '\labelwidth'. If the label is wider than that, the
-additional material extends to the right. When making an instance of a
-list you can override the default labeling by giving '\item' an optional
-argument by including square braces and the text, as in the above
-'\item[Special label.]'; *note \item::.
-
- The label box is constructed by the command '\makelabel'. By default
-it positions the contents flush right. It takes one argument, the
-label. It typesets the contents in LR mode. An example of changing its
-definition is that to the above example before the definition of the
-'named' environment add '\newcommand{\namedmakelabel}[1]{\textsc{#1}}',
-and between the '\setlength' command and the parenthesis that closes the
-SPACING argument also add '\let\makelabel\namedmakelabel'. Then the
-items will be typeset in small caps. Similarly, changing the second
-code line to '\let\makelabel\fbox' puts the labels inside a framed box.
-Another example is at the bottom of this entry.
-
- The mandatory second argument SPACING can have a list of commands to
-redefine the spacing parameters for the list, such as
-'\setlength{\labelwidth}{2em}'. If this argument is empty, i.e., '{}',
-then the list will have the default spacing given below. To number the
-items using a counter, put '\usecounter{COUNTERNAME}' in this argument
-(*note \usecounter::).
-
- Below are the spacing parameters for list formatting. See also the
-figure below. Each is a length (*note Lengths::). The vertical spaces
-are normally rubber lengths, with 'plus' and 'minus' components, to give
-TeX flexibility in setting the page. Change each with a command such as
+ The mandatory first argument LABELING specifies the default labeling
+of list items. It can contain text and LaTeX commands, as above where
+it contains both 'Item' and '\Roman{...}'. LaTeX forms the label by
+putting the LABELING argument in a box of width '\labelwidth'. If the
+label is wider than that, the additional material extends to the right.
+When making an instance of a list you can override the default labeling
+by giving '\item' an optional argument by including square braces and
+the text, as in the above '\item[Special label.]'; *note \item::.
+
+ The mandatory second argument SPACING has a list of commands. This
+list can be empty. A command that can go in here is
+'\usecounter{COUNTERNAME}' (*note \usecounter::). Use this to tell
+LaTeX to number the items using the given counter. The counter will be
+reset to zero each time LaTeX enters the environment, and the counter is
+incremented by one each time LaTeX encounters an '\item' that does not
+have an optional argument.
+
+ Another command that can go in SPACING is '\makelabel', which
+constructs the label box. By default it puts the contents flush right.
+Its only argument is the label, which it typesets in LR mode (*note
+Modes::). One example of changing its definition is that to the above
+'named' example, before the definition of the environment add
+'\newcommand{\namedmakelabel}[1]{\textsc{#1}}', and between the
+'\setlength' command and the parenthesis that closes the SPACING
+argument also add '\let\makelabel\namedmakelabel'. Then the items will
+be typeset in small caps. Similarly, changing the second code line to
+'\let\makelabel\fbox' puts the labels inside a framed box. Another
+example of the '\makelabel' command is below, in the definition of the
+'redlabel' environment.
+
+ Also often in SPACING are commands to redefine the spacing for the
+list. Below are the spacing parameters with their default values.
+(Default values for derived environments such as 'itemize' can be
+different than the values shown here.) See also the figure that follows
+the list. Each is a length (*note Lengths::). The vertical spaces are
+normally rubber lengths, with 'plus' and 'minus' components, to give TeX
+flexibility in setting the page. Change each with a command such as
'\setlength{itemsep}{2pt plus1pt minus1pt}'. For some effects these
-lengths should be zero or negative. Default values for derived
-environments such as 'itemize' can be changed from the values shown here
-for the basic 'list'.
+lengths should be zero or negative.
'\itemindent'
Extra horizontal space indentation, beyond 'leftmargin', of the
@@ -3279,13 +3928,14 @@ for the basic 'list'.
'\topsep'
Vertical space added to both the top and bottom of the list, in
- addition to '\parskip' (*note \parskip::). The defaults for the
- first three levels in LaTeX's 'article', 'book', and 'report'
- classes at 10 point size are: '8pt plus2pt minus4pt', '4pt plus2pt
- minus1pt', and '2pt plus1pt minus1pt'. The defaults at 11 point
- are: '9pt plus3pt minus5pt', '4.5pt plus2pt minus1pt', and '2pt
- plus1pt minus1pt'. The defaults at 12 point are: '10pt plus4pt
- minus6pt', '5pt plus2.5pt minus1pt', and '2.5pt plus1pt minus1pt'.
+ addition to '\parskip' (*note \parindent & \parskip::). The
+ defaults for the first three levels in LaTeX's 'article', 'book',
+ and 'report' classes at 10 point size are: '8pt plus2pt minus4pt',
+ '4pt plus2pt minus1pt', and '2pt plus1pt minus1pt'. The defaults
+ at 11 point are: '9pt plus3pt minus5pt', '4.5pt plus2pt minus1pt',
+ and '2pt plus1pt minus1pt'. The defaults at 12 point are: '10pt
+ plus4pt minus6pt', '5pt plus2.5pt minus1pt', and '2.5pt plus1pt
+ minus1pt'.
This shows the horizontal and vertical distances.
@@ -3327,6 +3977,9 @@ V3
appears in the source above the environment; whether a blank line
appears in the source below the environment does not matter.)
+H0
+ '\labelwidth'
+
H1
'\labelsep'
@@ -3368,8 +4021,11 @@ of 10000 prohibits a page break.
The page breaking penalty for breaking after a list (default
'-51').
+ The package 'enumitem' is useful for customizing lists.
+
This example has the labels in red. They are numbered, and the left
-edge of the label lines up with the left edge of the item text.
+edge of the label lines up with the left edge of the item text. *Note
+\usecounter::.
\usepackage{color}
\newcounter{cnt}
@@ -3402,7 +4058,8 @@ Synopsis:
\item text of item
- or
+or
+
\item[OPTIONAL-LABEL] text of item
An entry in a list. The entries are prefixed by a label, whose
@@ -3493,20 +4150,107 @@ File: latex2e.info, Node: minipage, Next: picture, Prev: math, Up: Environme
8.18 'minipage'
===============
+Synopses:
+
+ \begin{minipage}{WIDTH}
+ CONTENTS
+ \end{minipage}
+
+or
+
\begin{minipage}[POSITION][HEIGHT][INNER-POS]{WIDTH}
- TEXT
+ CONTENTS
+ \end{minipage}
+
+ Put CONTENTS into a box that is WIDTH wide. This is like a small
+version of a page; it can contain its own footnotes, itemized lists,
+etc. (There are some restrictions, including that it cannot have
+floats.) This box will not be broken across pages. So 'minipage' is
+similar to '\parbox' (*note \parbox::) but here you can have paragraphs.
+
+ This example will be 3 inches wide, and has two paragraphs.
+
+ \begin{minipage}{3in}
+ Stephen Kleene was a founder of the Theory of Computation.
+
+ He was a student of Church, wrote three influential texts,
+ was President of the Association for Symbolic Logic,
+ and won the National Medal of Science.
\end{minipage}
- The 'minipage' environment typesets its body TEXT in a block that
-will not be broken across pages. This is similar to the '\parbox'
-command (*note \parbox::), but unlike '\parbox', other paragraph-making
-environments can be used inside a minipage.
+See below for a discussion of the paragraph indent inside a 'minipage'.
- The arguments are the same as for '\parbox' (*note \parbox::).
+ The required argument WIDTH is a rigid length (*note Lengths::). It
+gives the width of the box into which CONTENTS are typeset.
- By default, paragraphs are not indented in the 'minipage'
-environment. You can restore indentation with a command such as
-'\setlength{\parindent}{1pc}' command.
+ There are three optional arguments, POSITION, HEIGHT, and INNER-POS.
+You need not include all three. For example, get the default POSITION
+and set the HEIGHT with '\begin{minipage}[c][2.54cm] CONTENTS
+\end{minipage}'. (Get the natural height with an empty argument, '[]'.)
+
+ The optional argument POSITION governs how the 'minipage' vertically
+aligns with the surrounding material.
+
+'c'
+ (synonym 'm') Default. Positions the 'minipage' so its vertical
+ center lines up with the center of the adjacent text line (what
+ Plain TeX calls '\vcenter').
+
+'t'
+ Match the top line in the 'minipage' with the baseline of the
+ surrounding text (Plain TeX's '\vtop'.
+
+'b'
+ Match the bottom line in the 'minipage' with the baseline of the
+ surrounding text (Plain TeX's '\vbox'.
+
+ To see the effects of these, contrast running this
+
+ ---\begin{minipage}[c]{0.25in}
+ first\\ second\\ third
+ \end{minipage}
+
+with the results of changing 'c' to 'b' or 't'.
+
+ The optional argument HEIGHT is a rigid length (*note Lengths::). It
+sets the height of the 'minipage'. You can enter any value larger than,
+or equal to, or smaller than the 'minipage''s natural height and LaTeX
+will not give an error or warning. You can also set it to a height of
+zero or a negative value.
+
+ The final optional argument INNER-POS controls the placement of
+CONTENT inside the box. These are the possible values are (the default
+is the value of POSITION).
+
+'t'
+ Place CONTENT at the top of the box.
+
+'c'
+ Place it in the vertical center.
+
+'b'
+ Place it at the box bottom.
+
+'s'
+ Stretch CONTENTS out vertically; it must contain vertically
+ stretchable space.
+
+ The INNER-POS argument makes sense when the HEIGHT options is set to
+a value larger than the 'minipage''s natural height. To see the effect
+of the options, run this example with the various choices in place of
+'b'.
+
+ Text before
+ \begin{center}
+ ---\begin{minipage}[c][3in][b]{0.25\textwidth}
+ first\\ second\\ third
+ \end{minipage}
+ \end{center}
+ Text after
+
+ By default paragraphs are not indented in a 'minipage'. Change that
+with a command such as '\setlength{\parindent}{1pc}' at the start of
+CONTENTS.
Footnotes in a 'minipage' environment are handled in a way that is
particularly useful for putting footnotes in figures or tables. A
@@ -3515,384 +4259,681 @@ of the minipage instead of at the bottom of the page, and it uses the
'\mpfootnote' counter instead of the ordinary 'footnote' counter (*note
Counters::).
- However, don't put one minipage inside another if you are using
-footnotes; they may wind up at the bottom of the wrong minipage.
+ This puts the footnote at the bottom of the table, not the bottom of
+the page.
+
+ \begin{center} % center the minipage on the line
+ \begin{minipage}{2.5in}
+ \begin{center} % center the table inside the minipage
+ \begin{tabular}{ll}
+ \textsc{Monarch} &\textsc{Reign} \\ \hline
+ Elizabeth II &63 years\footnote{to date} \\
+ Victoria &63 years \\
+ George III &59 years
+ \end{tabular}
+ \end{center}
+ \end{minipage}
+ \end{center}
+
+ If you nest minipages then there is an oddness when using footnotes.
+Footnotes appear at the bottom of the text ended by the next
+'\end{minipage}' which may not be their logical place.
+
+ This puts a table containing data side by side with a map graphic.
+They are vertically centered.
+
+ \newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
+ ...
+ \begin{center}
+ \vcenteredhbox{\includegraphics[width=0.3\textwidth]{nyc.png}}
+ \hspace{0.1\textwidth}
+ \begin{minipage}{0.5\textwidth}
+ \begin{tabular}{r|l}
+ \multicolumn{1}{r}{Borough} &Pop (million) \\ \hline
+ The Bronx &$1.5$ \\
+ Brooklyn &$2.6$ \\
+ Manhattan &$1.6$ \\
+ Queens &$2.3$ \\
+ Staten Island &$0.5$
+ \end{tabular}
+ \end{minipage}
+ \end{center}

-File: latex2e.info, Node: picture, Next: quotation and quote, Prev: minipage, Up: Environments
+File: latex2e.info, Node: picture, Next: quotation & quote, Prev: minipage, Up: Environments
8.19 'picture'
==============
+Synopses:
+ \begin{picture}(WIDTH,HEIGHT)
+ PICTURE COMMANDS
+ \end{picture}
+
+or
+
\begin{picture}(WIDTH,HEIGHT)(XOFFSET,YOFFSET)
- ... PICTURE COMMANDS ...
+ PICTURE COMMANDS
+ \end{picture}
+
+ An environment to create simple pictures containing lines, arrows,
+boxes, circles, and text. Note that while this environment is not
+obsolete, new documents typically use much more powerful graphics
+creation systems, such as 'TikZ', 'PSTricks', 'MetaPost', or
+'Asymptote'. These are not covered in this document; see CTAN.
+
+ This shows the parallelogram law for adding vectors.
+
+ \setlength{\unitlength}{1cm}
+ \begin{picture}(6,6) % picture box will be 6cm wide by 6cm tall
+ \put(0,0){\vector(2,1){4}} % for every 2 over this vector goes 1 up
+ \put(2,1){\makebox(0,0)[l]{\ first leg}}
+ \put(4,2){\vector(1,2){2}}
+ \put(5,4){\makebox(0,0)[l]{\ second leg}}
+ \put(0,0){\line(1,1){6}}
+ \put(3,3){\makebox(0,0)[r]{sum\ }}
\end{picture}
- The 'picture' environment allows you to create just about any kind of
-picture you want containing text, lines, arrows and circles. You tell
-LaTeX where to put things in the picture by specifying their
-coordinates. A coordinate is a number that may have a decimal point and
-a minus sign--a number like '5', '0.3' or '-3.1416'. A coordinate
-specifies a length in multiples of the unit length '\unitlength', so if
-'\unitlength' has been set to '1cm', then the coordinate 2.54 specifies
-a length of 2.54 centimeters.
-
- You should only change the value of '\unitlength', using the
-'\setlength' command, outside of a 'picture' environment. The default
-value is '1pt'.
-
- The 'picture' package redefine the 'picture' environment so that
-everywhere a number is used in a PICTURE COMMANDS to specify a
-coordinate, one can use alternatively a length. Be aware however that
-this will prevent scaling those lengths by changing '\unitlength'.
-
- A "position" is a pair of coordinates, such as '(2.4,-5)', specifying
-the point with x-coordinate '2.4' and y-coordinate '-5'. Coordinates
-are specified in the usual way with respect to an origin, which is
-normally at the lower-left corner of the picture. Note that when a
-position appears as an argument, it is not enclosed in braces; the
-parentheses serve to delimit the argument.
-
- The 'picture' environment has one mandatory argument which is a
-position (WIDTH,HEIGHT), which specifies the size of the picture. The
-environment produces a rectangular box with these WIDTH and HEIGHT.
-
- The 'picture' environment also has an optional position argument
-(XOFFSET,YOFFSET), following the size argument, that can change the
-origin. (Unlike ordinary optional arguments, this argument is not
-contained in square brackets.) The optional argument gives the
-coordinates of the point at the lower-left corner of the picture
-(thereby determining the origin). For example, if '\unitlength' has
-been set to '1mm', the command
+ You can also use this environment to place arbitrary material at an
+exact location.
+
+ \usepackage{color,graphicx} % in preamble
+ ...
+ \begin{center}
+ \setlength{\unitlength}{\textwidth}
+ \begin{picture}(1,1) % leave space, \textwidth wide and tall
+ \put(0,0){\includegraphics[width=\textwidth]{desertedisland.jpg}}
+ \put(0.25,0.35){\textcolor{red}{X Treasure here}}
+ \end{picture}
+ \end{center}
+
+The red X will be precisely a quarter of the '\linewidth' from the left
+margin, and '0.35\linewidth' up from the bottom. Another example of
+this usage is to put similar code in the page header to get repeat
+material on each of a document's pages.
+
+ The 'picture' environment has one required argument, a pair of
+numbers (WIDTH,HEIGHT). Multiply these by the value '\unitlength' to
+get the nominal size of the output, the space that LaTeX reserves on the
+output page. This nominal size need not be how large the picture really
+is; LaTeX will draw things from the picture outside the picture's box.
+
+ This environment also has an optional argument (XOFFSET,YOFFSET). It
+is used to shift the origin. Unlike most optional arguments, this one
+is not contained in square brackets. As with the required argument, it
+consists of two real numbers. Multiply these by '\unitlength' to get
+the point at the lower-left corner of the picture.
+
+ For example, if '\unitlength' has been set to '1mm', the command
\begin{picture}(100,200)(10,20)
-produces a picture of width 100 millimeters and height 200 millimeters,
-whose lower-left corner is the point (10,20) and whose upper-right
-corner is therefore the point (110,220). When you first draw a picture,
-you typically omit the optional argument, leaving the origin at the
-lower-left corner. If you then want to modify your picture by shifting
-everything, you can just add the appropriate optional argument.
+produces a box of width 100 millimeters and height 200 millimeters. The
+picture's origin is the point (10mm,20mm) and so the lower-left corner
+is there, and the upper-right corner is at (110mm,220mm). When you
+first draw a picture you typically omit the optional argument, leaving
+the origin at the lower-left corner. If you then want to modify your
+picture by shifting everything, you can just add the appropriate
+optional argument.
+
+ Each PICTURE COMMAND tells LaTeX where to put something by naming its
+position. A "position" is a pair such as '(2.4,-5)' giving the x- and
+y-coordinates. A "coordinate" is a not a length, it is a real number
+(it may have a decimal point or a minus sign). It specifies a length in
+multiples of the unit length '\unitlength', so if '\unitlength' has been
+set to '1cm', then the coordinate 2.54 specifies a length of 2.54
+centimeters.
+
+ LaTeX's default for '\unitlength' is '1pt'. it is a rigid length
+(*note Lengths::). Change it with the '\setlength' command (*note
+\setlength::). Make this change only outside of a 'picture'
+environment.
- The environment's mandatory argument determines the nominal size of
-the picture. This need bear no relation to how large the picture really
-is; LaTeX will happily allow you to put things outside the picture, or
-even off the page. The picture's nominal size is used by LaTeX in
-determining how much room to leave for it.
+ Coordinates are given with respect to an origin, which is normally at
+the lower-left corner of the picture. Note that when a position appears
+as an argument, as with '\put(1,2){...}', it is not enclosed in braces
+since the parentheses serve to delimit the argument. Also, unlike in
+some computer graphics systems, larger y-coordinates are further up the
+page.
- Everything that appears in a picture is drawn by the '\put' command.
-The command
+ There are four ways to put things in a picture: '\put', '\multiput',
+'\qbezier', and '\graphpaper'. The most often used is '\put'. This
- \put (11.3,-.3){...}
+ \put(11.3,-0.3){...}
-puts the object specified by '...' in the picture, with its reference
-point at coordinates (11.3,-.3). The reference points for various
-objects will be described below.
+places the object with its reference point at coordinates (11.3,-0.3).
+The reference points for various objects will be described below. The
+'\put' command creates an "LR box" (*note Modes::). Anything that can
+go in an '\mbox' (*note \mbox & \makebox::) can go in the text argument
+of the '\put' command. The reference point will be the lower left
+corner of the box. In this picture
- The '\put' command creates an "LR box". You can put anything that
-can go in an '\mbox' (*note \mbox::) in the text argument of the '\put'
-command. When you do this, the reference point will be the lower left
-corner of the box.
+ \setlength{\unitlength}{1cm}
+ ...\begin{picture}(1,1)
+ \put(0,0){\line(1,0){1}}
+ \put(0,0){\line(1,1){1}}
+ \end{picture}
- The 'picture' commands are described in the following sections.
+the three dots are just slightly left of the point of the angle formed
+by the two lines. (Also, '\line(1,1){1}' does not call for a line of
+length one; rather the line has a change in the x coordinate of 1.)
+
+ The '\multiput', 'qbezier', and 'graphpaper' commands are described
+below.
+
+ This draws a rectangle with a wavy top, using '\qbezier' for that
+curve.
+
+ \begin{picture}(3,1.5)
+ \put(0,0){\vector(1,0){8}} % x axis
+ \put(0,0){\vector(0,1){4}} % y axis
+ \put(2,0){\line(0,1){3}} % left side rectangle
+ \put(4,0){\line(0,1){3.5}} % right side
+ \qbezier(2,3)(2.5,2.9)(3,3.25)
+ \qbezier(3,3.25)(3.5,3.6)(4,3.5)
+ \thicklines % below here, lines are twice as thick
+ \put(2,3){\line(4,1){2}}
+ \put(4.5,2.5){\framebox{Trapezoidal Rule}}
+ \end{picture}
* Menu:
+* \put:: Place an object at a specified place.
+* \multiput:: Draw multiple instances of an object.
+* \qbezier:: Draw a quadratic Bezier curve.
+* \graphpaper:: Draw graph paper.
+* \line:: Draw a straight line.
+* \linethickness:: Set thickness of horizontal and vertical lines.
+* \thinlines:: The default line thickness.
+* \thicklines:: A heavier line thickness.
* \circle:: Draw a circle.
+* \oval:: Draw an oval.
+* \shortstack:: Make a stack of objects.
+* \vector:: Draw a line with an arrow.
* \makebox (picture):: Draw a box of the specified size.
* \framebox (picture):: Draw a box with a frame around it.
-* \dashbox:: Draw a dashed box.
* \frame:: Draw a frame around an object.
-* \line:: Draw a straight line.
-* \linethickness:: Set the line thickness.
-* \thicklines:: A heavier line thickness.
-* \thinlines:: The default line thickness.
-* \multiput:: Draw multiple instances of an object.
-* \oval:: Draw an ellipse.
-* \put:: Place an object at a specified place.
-* \shortstack:: Make a pile of objects.
-* \vector:: Draw a line with an arrow.
+* \dashbox:: Draw a dashed box.

-File: latex2e.info, Node: \circle, Next: \makebox (picture), Up: picture
+File: latex2e.info, Node: \put, Next: \multiput, Up: picture
-8.19.1 '\circle'
-----------------
+8.19.1 '\put'
+-------------
Synopsis:
- \circle[*]{DIAMETER}
+ \put(XCOORD,YCOORD){CONTENT}
- The '\circle' command produces a circle with a diameter as close to
-the specified one as possible. The '*'-form of the command draws a
-solid circle.
+ Place CONTENT at the coordinate (XCOORD,YCOORD). See the discussion
+of coordinates and '\unitlength' in *note picture::. The CONTENT is
+processed in LR mode (*note Modes::) so it cannot contain line breaks.
- Circles up to 40pt can be drawn.
+ This includes the text into the 'picture'.
+
+ \put(4.5,2.5){Apply the \textit{unpoke} move}
+
+ The reference point, the location (4.5,2.5), is the lower left of the
+text, at the bottom left of the 'A'.

-File: latex2e.info, Node: \makebox (picture), Next: \framebox (picture), Prev: \circle, Up: picture
+File: latex2e.info, Node: \multiput, Next: \qbezier, Prev: \put, Up: picture
-8.19.2 '\makebox'
------------------
+8.19.2 '\multiput'
+------------------
Synopsis:
- \makebox(WIDTH,HEIGHT)[POSITION]{TEXT}
-
- The '\makebox' command for the picture environment is similar to the
-normal '\makebox' command except that you must specify a WIDTH and
-HEIGHT in multiples of '\unitlength'.
+ \multiput(X,Y)(DELTA_X,DELTA_Y){NUM-COPIES}{OBJ}
- The optional argument, '[POSITION]', specifies the quadrant that your
-TEXT appears in. You may select up to two of the following:
+ Copy OBJ a total of NUM-COPIES times, with an increment of
+DELTA_X,DELTA_Y. The OBJ first appears at position (x,y), then at
+(x+\delta_x,y+\delta_y), and so on.
-'t'
- Moves the item to the top of the rectangle.
+ This draws a simple grid with every fifth line in bold (see also
+*note \graphpaper::).
-'b'
- Moves the item to the bottom.
+ \begin{picture}(10,10)
+ \linethickness{0.05mm}
+ \multiput(0,0)(1,0){10}{\line(0,1){10}}
+ \multiput(0,0)(0,1){10}{\line(1,0){10}}
+ \linethickness{0.5mm}
+ \multiput(0,0)(5,0){3}{\line(0,1){10}}
+ \multiput(0,0)(0,5){3}{\line(1,0){10}}
+ \end{picture}
-'l'
- Moves the item to the left.
+
+File: latex2e.info, Node: \qbezier, Next: \graphpaper, Prev: \multiput, Up: picture
-'r'
- Moves the item to the right.
+8.19.3 '\qbezier'
+-----------------
- *Note \makebox::.
+Synopsis:
-
-File: latex2e.info, Node: \framebox (picture), Next: \dashbox, Prev: \makebox (picture), Up: picture
+ \qbezier(X1,Y1)(X2,Y2)(X3,Y3)
+ \qbezier[NUM](X1,Y1)(X2,Y2)(X3,Y3)
-8.19.3 '\framebox'
-------------------
+ Draw a quadratic Bezier curve whose control points are given by the
+three required arguments '(X1,Y1)', '(X2,Y2)', and '(X3,Y3)'. That is,
+the curve runs from (X1,Y1) to (X3,Y3), is quadratic, and is such that
+the tangent line at (X1,Y1) passes through (X2,Y2), as does the tangent
+line at (X3,Y3).
-Synopsis:
+ This draws a curve from the coordinate (1,1) to (1,0).
- \framebox(WIDTH,HEIGHT)[POS]{...}
+ \qbezier(1,1)(1.25,0.75)(1,0)
- The '\framebox' command is like '\makebox' (see previous section),
-except that it puts a frame around the outside of the box that it
-creates.
+The curve's tangent line at (1,1) contains (1.25,0.75), as does the
+curve's tangent line at (1,0).
- The '\framebox' command produces a rule of thickness '\fboxrule', and
-leaves a space '\fboxsep' between the rule and the contents of the box.
+ The optional argument NUM gives the number of calculated intermediate
+points. The default is to draw a smooth curve whose maximum number of
+points is '\qbeziermax' (change this value with '\renewcommand').

-File: latex2e.info, Node: \dashbox, Next: \frame, Prev: \framebox (picture), Up: picture
+File: latex2e.info, Node: \graphpaper, Next: \line, Prev: \qbezier, Up: picture
-8.19.4 '\dashbox'
------------------
+8.19.4 '\graphpaper'
+--------------------
-Draws a box with a dashed line. Synopsis:
+Synopsis:
+
+ \graphpaper(X_INIT,Y_INIT)(X_DIMEN,Y_DIMEN)
+ \graphpaper[SPACING](X_INIT,Y_INIT)(X_DIMEN,Y_DIMEN)
+
+ Draw a coordinate grid. Requires the 'graphpap' package. The grid's
+origin is '(X_INIT,Y_INIT)'. Grid lines come every SPACING units (the
+default is 10). The grid extends X_DIMEN units to the right and Y_DIMEN
+units up. All arguments must be positive integers.
- \dashbox{DLEN}(RWIDTH,RHEIGHT)[POS]{TEXT}
+ This make a grid with seven vertical lines and eleven horizontal
+lines.
- '\dashbox' creates a dashed rectangle around TEXT in a 'picture'
-environment. Dashes are DLEN units long, and the rectangle has overall
-width RWIDTH and height RHEIGHT. The TEXT is positioned at optional
-POS.
+ \usepackage{graphpap} % in preamble
+ ...
+ \begin{picture}(6,20) % in document body
+ \graphpaper[2](0,0)(12,20)
+ \end{picture}
- A dashed box looks best when the RWIDTH and RHEIGHT are multiples of
-the DLEN.
+The lines are numbered every ten units.

-File: latex2e.info, Node: \frame, Next: \line, Prev: \dashbox, Up: picture
+File: latex2e.info, Node: \line, Next: \linethickness, Prev: \graphpaper, Up: picture
-8.19.5 '\frame'
----------------
+8.19.5 '\line'
+--------------
Synopsis:
- \frame{TEXT}
+ \line(X_RUN,Y_RISE){TRAVEL}
- The '\frame' command puts a rectangular frame around TEXT. The
-reference point is the bottom left corner of the frame. No extra space
-is put between the frame and the object.
+ Draw a line. It slopes such that it vertically rises Y_RISE for
+every horizontal X_RUN. The TRAVEL is the total horizontal change -- it
+is not the length of the vector, it is the change in x. In the special
+case of vertical lines, where (X_RUN,Y_RISE)=(0,1), the TRAVEL gives the
+change in y.
-
-File: latex2e.info, Node: \line, Next: \linethickness, Prev: \frame, Up: picture
+ This draws a line starting at coordinates (1,3).
-8.19.6 '\line'
---------------
+ \put(1,3){\line(2,5){4}}
-Synopsis:
+For every over 2, this line will go up 5. Because TRAVEL specifies that
+this goes over 4, it must go up 10. Thus its endpoint is
+(1,3)+(4,10)=(5,13). In particular, note that TRAVEL=4 is not the
+length of the line, it is the change in x.
- \line(XSLOPE,YSLOPE){LENGTH}
+ The arguments X_RUN and Y_RISE are integers that can be positive,
+negative, or zero. (If both are 0 then LaTeX treats the second as 1.)
+With '\put(X_INIT,Y_INIT){\line(X_RUN,Y_RISE){TRAVEL}}', if X_RUN is
+negative then the line's ending point has a first coordinate that is
+less than X_INIT. If Y_RISE is negative then the line's ending point
+has a second coordinate that is less than Y_INIT.
- The '\line' command draws a line with the given LENGTH and slope
-XSLOPE/YSLOPE.
+ If TRAVEL is negative then you get 'LaTeX Error: Bad \line or \vector
+argument.'
- Standard LaTeX can only draw lines with SLOPE = x/y, where x and y
-have integer values from -6 through 6. For lines of any slope, and
-plenty of other shapes, see 'pict2e' and many other packages on CTAN.
+ Standard LaTeX can only draw lines with a limited range of slopes
+because these lines are made by putting together line segments from
+pre-made fonts. The two numbers X_RUN and Y_RISE must have integer
+values from -6 through 6. Also, they must be relatively prime, so that
+(X_RUN,Y_RISE) can be (2,1) but not (4,2) (if you choose the latter then
+instead of lines you get sequences of arrowheads; the solution is to
+switch to the former). To get lines of arbitrary slope and plenty of
+other shapes in a system like 'picture', see the package 'pict2e' on
+CTAN. Another solution is to use a full-featured graphics system such as
+'TikZ', or 'PSTricks', or 'MetaPost', or 'Asymptote'

-File: latex2e.info, Node: \linethickness, Next: \thicklines, Prev: \line, Up: picture
+File: latex2e.info, Node: \linethickness, Next: \thinlines, Prev: \line, Up: picture
-8.19.7 '\linethickness'
+8.19.6 '\linethickness'
-----------------------
-The '\linethickness{DIM}' command declares the thickness of horizontal
-and vertical lines in a picture environment to be DIM, which must be a
-positive length.
+Synopsis:
+
+ \linethickness{DIM}
- '\linethickness' does not affect the thickness of slanted lines,
-circles, or the quarter circles drawn by '\oval'.
+ Declares the thickness of subsequent horizontal and vertical lines in
+a picture to be DIM, which must be a positive length (*note Lengths::).
+It differs from '\thinlines' and '\thicklines' in that it does not
+affect the thickness of slanted lines, circles, or ovals.

-File: latex2e.info, Node: \thicklines, Next: \thinlines, Prev: \linethickness, Up: picture
+File: latex2e.info, Node: \thinlines, Next: \thicklines, Prev: \linethickness, Up: picture
-8.19.8 '\thicklines'
---------------------
+8.19.7 '\thinlines'
+-------------------
-The '\thicklines' command is an alternate line thickness for horizontal
-and vertical lines in a picture environment; cf. *note \linethickness::
-and *note \thinlines::.
+Declaration to set the thickness of subsequent lines, circles, and ovals
+in a picture environment to be 0.4pt. This is the default thickness, so
+this command is unnecessary unless the thickness has been changed with
+either *note \linethickness:: or *note \thicklines::.

-File: latex2e.info, Node: \thinlines, Next: \multiput, Prev: \thicklines, Up: picture
+File: latex2e.info, Node: \thicklines, Next: \circle, Prev: \thinlines, Up: picture
-8.19.9 '\thinlines'
--------------------
+8.19.8 '\thicklines'
+--------------------
-The '\thinlines' command is the default line thickness for horizontal
-and vertical lines in a picture environment; cf. *note \linethickness::
-and *note \thicklines::.
+Declaration to set the thickness of subsequent lines, circles, and ovals
+in a picture environment to be 0.8pt. See also *note \linethickness::
+and *note \thinlines::. This command is illustrated in the Trapezoidal
+Rule example of *note picture::.

-File: latex2e.info, Node: \multiput, Next: \oval, Prev: \thinlines, Up: picture
+File: latex2e.info, Node: \circle, Next: \oval, Prev: \thicklines, Up: picture
-8.19.10 '\multiput'
--------------------
+8.19.9 '\circle'
+----------------
Synopsis:
- \multiput(X,Y)(DELTA_X,DELTA_Y){N}{OBJ}
+ \circle{DIAMETER}
+ \circle*{DIAMETER}
+
+ Produces a circle with a diameter as close as possible to the
+specified one. The '*' form produces a filled-in circle.
- The '\multiput' command copies the object OBJ in a regular pattern
-across a picture. OBJ is first placed at position (x,y), then at
-(x+\delta x,y+\delta y), and so on, N times.
+ This draws a circle of radius 6, centered at '(5,7)'.
+
+ \put(5,7){\circle{6}}
+
+ The available radii for 'circle' are, in points, the even numbers
+from 2 to 20, inclusive. For 'circle*' they are all the integers from 1
+to 15.

-File: latex2e.info, Node: \oval, Next: \put, Prev: \multiput, Up: picture
+File: latex2e.info, Node: \oval, Next: \shortstack, Prev: \circle, Up: picture
-8.19.11 '\oval'
+8.19.10 '\oval'
---------------
Synopsis:
+ \oval(WIDTH,HEIGHT)
\oval(WIDTH,HEIGHT)[PORTION]
- The '\oval' command produces a rectangle with rounded corners. The
-optional argument PORTION allows you to produce only half of the oval
-via the following:
+ Produce a rectangle with rounded corners. The optional argument
+PORTION allows you to produce only half or a quarter of the oval. For
+half an oval take PORTION to be one of these.
't'
- selects the top half;
+ top half
'b'
- selects the bottom half;
+ bottom half
'r'
- selects the right half;
+ right half
'l'
- selects the left half.
+ left half
+
+ Produce only one quarter of the oval by setting PORTION to 'tr',
+'br', 'bl', or 'tl'.
- It is also possible to produce only one quarter of the oval by
-setting PORTION to 'tr', 'br', 'bl', or 'tl'.
+ This draws the top half of an oval that is 3 wide and 7 tall.
- The "corners" of the oval are made with quarter circles with a
-maximum radius of 20pt, so large "ovals" will look more like boxes with
-rounded corners.
+ \put(5,7){\oval(3,7)[t]}
+
+The (5,7) is the center of the entire oval, not just the center of the
+top half.
+
+ These shapes are not ellipses. They are rectangles whose corners are
+made with quarter circles. These circles have a maximum radius of 20pt
+(*note \circle:: for the sizes). Thus large ovals are just boxes with a
+small amount of corner rounding.

-File: latex2e.info, Node: \put, Next: \shortstack, Prev: \oval, Up: picture
+File: latex2e.info, Node: \shortstack, Next: \vector, Prev: \oval, Up: picture
-8.19.12 '\put'
---------------
+8.19.11 '\shortstack'
+---------------------
Synopsis:
- \put(XCOORD,YCOORD){ ... }
+ \shortstack[POSITION]{LINE 1 \\ ... }
+
+ Produce a vertical stack of objects.
+
+ This labels the y axis.
- The '\put' command places the material specified by the (mandatory)
-argument in braces at the given coordinate, (XCOORD,YCOORD).
+ \put(0,0){\vector(1,0){4}} % x axis
+ \put(0,0){\vector(0,1){2}} % y
+ \put(-0.25,2){\makebox[0][r]{\shortstack[r]{$y$\\ axis}}}
+
+For a short stack, the reference point is the lower left of the stack.
+In the above example the *note \mbox & \makebox:: puts the stack flush
+right in a zero width box so in total the short stack sits slightly to
+the left of the y axis.
+
+ The valid positions are:
+
+'r'
+ Make objects flush right
+'l'
+ Make objects flush left
+'c'
+ Center objects (default)
+
+ Separate objects into lines with '\\'. These stacks are short in
+that, unlike in a 'tabular' or 'array' environment, here the rows are
+not spaced out to be of even heights. Thus, in
+'\shortstack{X\\o\\o\\X}' the first and last rows are taller than the
+middle two. You can adjust row heights either by putting in the usual
+interline spacing with '\shortstack{X\\ \strut o\\o\\X}', or by hand,
+via an explicit zero-width box '\shortstack{X \\ \rule{0pt}{12pt}
+o\\o\\X}' or by using '\\''s optional argument '\shortstack{X\\[2pt]
+o\\o\\X}'.
+
+ The '\shortstack' command is also available outside the 'picture'
+environment.

-File: latex2e.info, Node: \shortstack, Next: \vector, Prev: \put, Up: picture
+File: latex2e.info, Node: \vector, Next: \makebox (picture), Prev: \shortstack, Up: picture
-8.19.13 '\shortstack'
----------------------
+8.19.12 '\vector'
+-----------------
Synopsis:
- \shortstack[POSITION]{...\\...\\...}
+ \vector(X_RUN,Y_RISE){TRAVEL}
- The '\shortstack' command produces a stack of objects. The valid
-positions are:
+ Draw a line ending in an arrow. The slope of that line is: it
+vertically rises Y_RISE for every horizontal X_RUN. The TRAVEL is the
+total horizontal change -- it is not the length of the vector, it is the
+change in x. In the special case of vertical vectors, if
+(X_RUN,Y_RISE)=(0,1), then TRAVEL gives the change in y.
+
+ For an example see *note picture::.
+
+ For elaboration on X_RUN and Y_RISE see *note \line::. As there, the
+values of X_RUN and Y_RISE are limited. For '\vector' you must chooses
+integers between -4 and 4, inclusive. Also, the two you choose must be
+relatively prime. Thus, '\vector(2,1){4}' is acceptable but
+'\vector(4,2){4}' is not (if you use the latter then you get a sequence
+of arrowheads).
+
+
+File: latex2e.info, Node: \makebox (picture), Next: \framebox (picture), Prev: \vector, Up: picture
+
+8.19.13 '\makebox' (picture)
+----------------------------
+
+Synopsis:
+
+ \makebox(REC-WIDTH,REC-HEIGHT){TEXT}
+ \makebox(REC-WIDTH,REC-HEIGHT)[POSITION]{TEXT}
+
+ Make a box to hold TEXT. This command fits with the 'picture'
+environment, although you can use it outside of there, because REC-WIDTH
+and REC-HEIGHT are numbers specifying distances in terms of the
+'\unitlength' (*note picture::). This command is similar to the normal
+'\makebox' command (*note \mbox & \makebox::) except here that you must
+specify the width and height. This command is fragile (*note
+\protect::).
+
+ This makes a box of length 3.5 times '\unitlength' and height 4 times
+'\unitlength'.
+
+ \put(1,2){\makebox(3.5,4){...}}
+
+ The optional argument 'POSITION' specifies where in the box the TEXT
+appears. The default is to center it, both horizontally and vertically.
+To place it somewhere else, use a string with one or two of these
+letters.
+
+'t'
+ Puts TEXT the top of the box.
+
+'b'
+ Put TEXT at the bottom.
-'r'
- Move the objects to the right of the stack.
'l'
- Move the objects to the left of the stack
-'c'
- Move the objects to the centre of the stack (default)
+ Put TEXT on the left.
- Objects are separated with '\\'.
+'r'
+ Put TEXT on the right.

-File: latex2e.info, Node: \vector, Prev: \shortstack, Up: picture
+File: latex2e.info, Node: \framebox (picture), Next: \frame, Prev: \makebox (picture), Up: picture
-8.19.14 '\vector'
------------------
+8.19.14 '\framebox' (picture)
+-----------------------------
Synopsis:
- \vector(XSLOPE,YSLOPE){LENGTH}
+ \framebox(REC-WIDTH,REC-HEIGHT){TEXT}
+ \framebox(REC-WIDTH,REC-HEIGHT)[POSITION]{TEXT}
+
+ This is the same as *note \makebox (picture):: except that it puts a
+frame around the outside of the box that it creates. The reference
+point is the bottom left corner of the frame. This command fits with
+the 'picture' environment, although you can use it outside of there,
+because lengths are numbers specifying the distance in terms of the
+'\unitlength' (*note picture::). This command is fragile (*note
+\protect::).
+
+ This example creates a frame 2.5 inches by 3 inches and puts the text
+in the center.
+
+ \setlength{\unitlength}{1in}
+ \framebox(2.5,3){test text}
+
+ The required arguments are that the rectangle has overall width
+RECT-WIDTH units and height RECT-HEIGHT units.
+
+ The optional argument POSITION specifies the position of TEXT; see
+*note \makebox (picture):: for the values that it can take.
- The '\vector' command draws a line with an arrow of the specified
-length and slope. The XSLOPE and YSLOPE values must lie between -4 and
-+4, inclusive.
+ The rule has thickness '\fboxrule' and there is a blank space
+'\fboxsep' between the frame and the contents of the box.
+
+ For this command, you must specify the WIDTH and HEIGHT. If you want
+to just put a frame around some contents whose dimension is determined
+in some other way then either use '\fbox' (*note \fbox & \framebox::) or
+'\frame' (*note \frame::).

-File: latex2e.info, Node: quotation and quote, Next: tabbing, Prev: picture, Up: Environments
+File: latex2e.info, Node: \frame, Next: \dashbox, Prev: \framebox (picture), Up: picture
-8.20 'quotation' and 'quote'
-============================
+8.19.15 '\frame'
+----------------
+
+Synopsis:
+
+ \frame{CONTENTS}
+
+ Puts a rectangular frame around CONTENTS. The reference point is the
+bottom left corner of the frame. In contrast to '\framebox' (*note
+\framebox (picture)::), this command puts no extra space is put between
+the frame and the object. It is fragile (*note \protect::).
+
+
+File: latex2e.info, Node: \dashbox, Prev: \frame, Up: picture
+
+8.19.16 '\dashbox'
+------------------
+
+Synopsis:
+
+ \dashbox{DASH-LEN}(RECT-WIDTH,RECT-HEIGHT){TEXT}
+ \dashbox{DASH-LEN}(RECT-WIDTH,RECT-HEIGHT)[POSITION]{TEXT}
+
+ Create a dashed rectangle around TEXT. This command fits with the
+'picture' environment, although you can use it outside of there, because
+lengths are numbers specifying the distance in terms of the
+'\unitlength' (*note picture::).
+
+ The required arguments are: dashes are DASH-LEN units long, with the
+same length gap, and the rectangle has overall width RECT-WIDTH units
+and height RECT-HEIGHT units.
+
+ The optional argument POSITION specifies the position of TEXT; see
+*note \makebox (picture):: for the values that it can take.
+
+ This shows that you can use non-integer value for DASH-LEN.
+
+ \put(0,0){\dashbox{0.1}(5,0.5){My hovercraft is full of eels.}}
+
+Each dash will be '0.1\unitlength' long, the box's width is
+'5\unitlength' and its height is '0.5\unitlength'.
+
+ As in that example, a dashed box looks best when RECT-WIDTH and
+RECT-HEIGHT are multiples of the DASH-LEN.
+
+
+File: latex2e.info, Node: quotation & quote, Next: tabbing, Prev: picture, Up: Environments
+
+8.20 'quotation' & 'quote'
+==========================
Synopsis:
\begin{quotation}
- TEXT
+ TEXT
\end{quotation}
- or
+or
\begin{quote}
- TEXT
+ TEXT
\end{quote}
- Include a quotation.
-
- In both environments, margins are indented on both sides by
-'\leftmargin' and the text is justified at both. As with the main text,
-leaving a blank line produces a new paragraph.
+ Include a quotation. Both environments indent margins on both sides
+by '\leftmargin' and the text is right-justified.
- To compare the two: in the 'quotation' environment, paragraphs are
-indented by 1.5em and the space between paragraphs is small, '0pt plus
-1pt'. In the 'quote' environment, paragraphs are not indented and there
-is vertical space between paragraphs (it is the rubber length
-'\parsep'). Thus, the 'quotation' environment may be more suitable for
-documents where new paragraphs are marked by an indent rather than by a
-vertical separation. In addition, 'quote' may be more suitable for a
-short quotation or a sequence of short quotations.
+ They differ in how they treat paragraphs. In the 'quotation'
+environment, paragraphs are indented by 1.5em and the space between
+paragraphs is small, '0pt plus 1pt'. In the 'quote' environment,
+paragraphs are not indented and there is vertical space between
+paragraphs (it is the rubber length '\parsep').
- \begin{quotation}
- \it Four score and seven years ago
+ \begin{quotation} \small\it
+ Four score and seven years ago
... shall not perish from the earth.
- \hspace{1em plus 1fill}---Abraham Lincoln
+ \hspace{1em plus 1fill}---Abraham Lincoln
\end{quotation}

-File: latex2e.info, Node: tabbing, Next: table, Prev: quotation and quote, Up: Environments
+File: latex2e.info, Node: tabbing, Next: table, Prev: quotation & quote, Up: Environments
8.21 'tabbing'
==============
@@ -3905,10 +4946,11 @@ Synopsis:
...
\end{tabbing}
- The 'tabbing' environment aligns text in columns. It works by
-setting tab stops and tabbing to them much as was done on a typewriter.
-It is best suited for cases where the width of each column is constant
-and known in advance.
+ Align text in columns, by setting tab stops and tabbing to them much
+as was done on a typewriter. This is less often used than the
+environments 'tabular' (*note tabular::) or 'array' (*note array::)
+because in those the width of each column need not be constant and need
+not be known in advance.
This example has a first line where the tab stops are set to explicit
widths, ended by a '\kill' command (which is described below):
@@ -4026,7 +5068,8 @@ They are all fragile (*note \protect::).
end;\\
\end{tabbing}
- The output looks like this:
+The output looks like this.
+
function fact(n : integer) : integer;
begin
if n > 1 then
@@ -4035,11 +5078,11 @@ They are all fragile (*note \protect::).
fact := 1;
end;
- (The above example is just for illustration of the environment. To
-actually typeset computer code in typewriter like this, a verbatim
-environment (*note verbatim::) would normally suffice. For
-pretty-printed code, there are quite a few packages, including
-'algorithm2e', 'fancyvrb', 'listings', and 'minted'.)
+This example is just for illustration of the environment. To actually
+typeset computer code in typewriter like this, a verbatim environment
+(*note verbatim::) would normally be best. For pretty-printed code,
+there are quite a few packages, including 'algorithm2e', 'fancyvrb',
+'listings', and 'minted'.

File: latex2e.info, Node: table, Next: tabular, Prev: tabbing, Up: Environments
@@ -4050,27 +5093,45 @@ File: latex2e.info, Node: table, Next: tabular, Prev: tabbing, Up: Environme
Synopsis:
\begin{table}[PLACEMENT]
- table body
- \caption[LOFTITLE]{TITLE}
- \label{LABEL}
+ TABLE BODY
+ \caption[LOFTITLE]{TITLE} % optional
+ \label{LABEL} % also optional
\end{table}
- A class of floats (*note Floats::). Because they cannot be split
-across pages, they are not typeset in sequence with the normal text but
-instead are "floated" to a convenient place, such as the top of a
+ A class of floats (*note Floats::). They cannot be split across
+pages and so they are not typeset in sequence with the normal text but
+instead are floated to a convenient place, such as the top of a
following page.
+ This example 'table' environment contains a 'tabular'
+
+ \begin{table}
+ \centering\small
+ \begin{tabular}{ll}
+ \multicolumn{1}{c}{\textit{Author}}
+ &\multicolumn{1}{c}{\textit{Piece}} \\ \hline
+ Bach &Cello Suite Number 1 \\
+ Beethoven &Cello Sonata Number 3 \\
+ Brahms &Cello Sonata Number 1
+ \end{tabular}
+ \caption{Top cello pieces}
+ \label{tab:cello}
+ \end{table}
+
+but you can put many different kinds of content in a 'table', including
+text, LaTeX commands, etc.
+
For the possible values of PLACEMENT and their effect on the float
placement algorithm, see *note Floats::.
- The table body is typeset in a 'parbox' of width '\textwidth' and so
-it can contain text, commands, etc.
+ The table body is typeset in a 'parbox' of width '\textwidth'. It
+can contain text, commands, graphics, etc.
The label is optional; it is used for cross references (*note Cross
-references::). The optional '\caption' command specifies caption text
-for the table. By default it is numbered. If LOTTITLE is present, it
-is used in the list of tables instead of TITLE (*note Tables of
-contents::).
+references::). The '\caption' command is also optional. It specifies
+caption text for the table. By default it is numbered. If its optional
+LOTTITLE is present then that text is used in the list of tables instead
+of TITLE (*note Table of contents etc.::).
In this example the table and caption will float to the bottom of a
page, unless it is pushed to a float page at the end.
@@ -4095,20 +5156,20 @@ File: latex2e.info, Node: tabular, Next: thebibliography, Prev: table, Up: E
Synopsis:
\begin{tabular}[POS]{COLS}
- column 1 entry &column 2 entry ... &column n entry \\
+ COLUMN 1 ENTRY &COLUMN 2 ENTRY ... &COLUMN N ENTRY \\
...
\end{tabular}
or
\begin{tabular*}{WIDTH}[POS]{COLS}
- column 1 entry &column 2 entry ... &column n entry \\
+ COLUMN 1 ENTRY &COLUMN 2 ENTRY ... &COLUMN N ENTRY \\
...
\end{tabular*}
- These environments produce a table, a box consisting of a sequence of
-horizontal rows. Each row consists of items that are aligned vertically
-in columns. This illustrates many of the features.
+ Produce a table, a box consisting of a sequence of horizontal rows.
+Each row consists of items that are aligned vertically in columns. This
+illustrates many of the features.
\begin{tabular}{l|l}
\textit{Player name} &\textit{Career home runs} \\
@@ -4117,23 +5178,16 @@ in columns. This illustrates many of the features.
Babe Ruth &714
\end{tabular}
- The vertical format of two left-aligned columns, with a vertical bar
-between them, is specified in 'tabular''s argument '{l|l}'. Columns are
-separated with an ampersand '&'. A horizontal rule between two rows is
-created with '\hline'. The end of each row is marked with a double
-backslash '\\'. This '\\' is optional after the last row unless an
-'\hline' command follows, to put a rule below the table.
+The output will have two left-aligned columns with a vertical bar
+between them. This is specified in 'tabular''s argument '{l|l}'. Put
+the entries into different columns by separating them with an ampersand,
+'&'. The end of each row is marked with a double backslash, '\\'. Put
+a horizontal rule below a row, after a double backslash, with '\hline'.
+This '\\' is optional after the last row unless an '\hline' command
+follows, to put a rule below the table.
The required and optional arguments to 'tabular' consist of:
-WIDTH
- Required for 'tabular*', not allowed for 'tabular'. Specifies the
- width of the 'tabular*' environment. The space between columns
- should be rubber, as with '@{\extracolsep{\fill}}', to allow the
- table to stretch or shrink to make the specified width, or else you
- are likely to get the 'Underfull \hbox (badness 10000) in alignment
- ...' warning.
-
POS
Optional. Specifies the table's vertical position. The default is
to align the table so its vertical center matches the baseline of
@@ -4163,27 +5217,29 @@ COLS
A vertical line the full height and depth of the environment.
'@{TEXT OR SPACE}'
- This inserts TEXT OR SPACE at this location in every row. The
- TEXT OR SPACE material is typeset in LR mode. This text is
- fragile (*note \protect::).
+ Insert TEXT OR SPACE at this location in every row. The TEXT
+ OR SPACE material is typeset in LR mode. This text is fragile
+ (*note \protect::).
- This specifier is optional: with no @-expression, LaTeX's
+ If between two columns there is no @-expression then LaTeX's
'book', 'article', and 'report' classes will put on either
side of each column a space of length '\tabcolsep', which by
- default is '6pt'. That is, by default adjacent columns are
- separated by 12pt (so '\tabcolsep' is misleadingly-named since
- it is not the separation between tabular columns). By
- implication, a space of 6pt also comes before the first column
+ default is 6pt. That is, by default adjacent columns are
+ separated by 12pt (so '\tabcolsep' is misleadingly named since
+ it is only half of the separation between tabular columns).
+ In addition, a space of 6pt also comes before the first column
and after the final column, unless you put a '@{...}' or '|'
there.
- If you override the default and use an @-expression then you
- must insert any desired space yourself, as in
- '@{\hspace{1em}}'.
+ If you override the default and use an @-expression then LaTeX
+ does not insert '\tabcolsep' so you must insert any desired
+ space yourself, as in '@{\hspace{1em}}'.
- An empty expression '@{}' will eliminate the space, including
- the space at the start or end, as in the example below where
- the tabular lines need to lie on the left margin.
+ An empty expression '@{}' will eliminate the space. In
+ particular, sometimes you want to eliminate the the space
+ before the first column or after the last one, as in the
+ example below where the tabular lines need to lie on the left
+ margin.
\begin{flushleft}
\begin{tabular}{@{}l}
@@ -4191,9 +5247,9 @@ COLS
\end{tabular}
\end{flushleft}
- This example shows text, a decimal point, between the columns,
- arranged so the numbers in the table are aligned on that
- decimal point.
+ The next example shows text, a decimal point between the
+ columns, arranged so the numbers in the table are aligned on
+ it.
\begin{tabular}{r@{$.$}l}
$3$ &$14$ \\
@@ -4203,42 +5259,50 @@ COLS
An '\extracolsep{WD}' command in an @-expression causes an
extra space of width WD to appear to the left of all
subsequent columns, until countermanded by another
- '\extracolsep' command. Unlike ordinary intercolumn space,
- this extra space is not suppressed by an @-expression. An
- '\extracolsep' command can be used only in an @-expression in
- the 'cols' argument. Below, LaTeX inserts the right amount of
+ '\extracolsep'. Unlike ordinary intercolumn space, this extra
+ space is not suppressed by an @-expression. An '\extracolsep'
+ command can be used only in an @-expression in the 'cols'
+ argument. Below, LaTeX inserts the right amount of
intercolumn space to make the entire table 4 inches wide.
- \begin{center}
- \begin{tabular*}{4in}{l@{\ \ldots\extracolsep{\fill}}l}
- Seven times down, eight times up
- &such is life!
- \end{tabular*}
- \end{center}
+ \begin{tabular*}{4in}{l@{\extracolsep{\fill}}l}
+ Seven times down, eight times up \ldots
+ &such is life!
+ \end{tabular*}
To insert commands that are automatically executed before a
given column, load the 'array' package and use the '>{...}'
specifier.
'p{WD}'
- Each item in the column is typeset in a parbox of width WD.
-
- Note that a line break double backslash '\\' may not appear in
- the item, except inside an environment like 'minipage',
- 'array', or 'tabular', or inside an explicit '\parbox', or in
- the scope of a '\centering', '\raggedright', or '\raggedleft'
- declaration (when used in a 'p'-column element these
- declarations must appear inside braces, as with '{\centering
- .. \\ ..}'). Otherwise LaTeX will misinterpret the double
- backslash as ending the row.
+ Each item in the column is typeset in a parbox of width WD, as
+ if it were the argument of a '\parbox[t]{wd}{...}' command.
+
+ A line break double backslash '\\' may not appear in the item,
+ except inside an environment like 'minipage', 'array', or
+ 'tabular', or inside an explicit '\parbox', or in the scope of
+ a '\centering', '\raggedright', or '\raggedleft' declaration
+ (when used in a 'p'-column element these declarations must
+ appear inside braces, as with '{\centering .. \\ ..}').
+ Otherwise LaTeX will misinterpret the double backslash as
+ ending the row. Instead, to get a line break in there use
+ '\newline' (*note \newline::).
'*{NUM}{COLS}'
Equivalent to NUM copies of COLS, where NUM is a positive
- integer and COLS is a list of specifiers. Thus
- '\begin{tabular}{|*{3}{l|r}|}' is equivalent to
+ integer and COLS is a list of specifiers. Thus the specifier
+ '\begin{tabular}{|*{3}{l|r}|}' is equivalent to the specifier
'\begin{tabular}{|l|rl|rl|r|}'. Note that COLS may contain
another '*'-expression.
+WIDTH
+ Required for 'tabular*', not allowed for 'tabular'. Specifies the
+ width of the 'tabular*' environment. The space between columns
+ should be rubber, as with '@{\extracolsep{\fill}}', to allow the
+ table to stretch or shrink to make the specified width, or else you
+ are likely to get the 'Underfull \hbox (badness 10000) in alignment
+ ...' warning.
+
Parameters that control formatting:
'\arrayrulewidth'
@@ -4291,8 +5355,9 @@ argument TEXT gives the contents of that entry.
spanned by the single heading 'Name'.
\begin{tabular}{lccl}
- \textit{ID} &\multicolumn{2}{c}{\textit{Name}} &\textit{Age} \\ \hline % row one
- 978-0-393-03701-2 &O'Brian &Patrick &55 \\ % row two
+ \textit{ID} &\multicolumn{2}{c}{\textit{Name}} &\textit{Age} \\
+ \hline
+ 978-0-393-03701-2 &O'Brian &Patrick &55 \\
...
\end{tabular}
@@ -4317,12 +5382,12 @@ details the exact behavior.
&z % entry four
\end{tabular}
- Before the first entry the output will not have a vertical rule
-because the '\multicolumn' has the COLS specifier 'r' with no initial
-vertical bar. Between entry one and entry two there will be a vertical
-rule; although the first COLS does not have an ending vertical bar, the
-second COLS does have a starting one. Between entry two and entry three
-there is a single vertical rule; despite that the COLS in both of the
+Before the first entry the output will not have a vertical rule because
+the '\multicolumn' has the COLS specifier 'r' with no initial vertical
+bar. Between entry one and entry two there will be a vertical rule;
+although the first COLS does not have an ending vertical bar, the second
+COLS does have a starting one. Between entry two and entry three there
+is a single vertical rule; despite that the COLS in both of the
surrounding 'multicolumn''s call for a vertical rule, you only get one
rule. Between entry three and entry four there is no vertical rule; the
default calls for one but the COLS in the entry three '\multicolumn'
@@ -4350,7 +5415,7 @@ center those two columns on the page range en-dash.
Impressionistic &1875 &1925
\end{tabular}
- Note that although the 'tabular' specification by default puts a
+Note that although the 'tabular' specification by default puts a
vertical rule between the first and second columns, because there is no
vertical bar in the COLS of either of the first row's '\multicolumn'
commands, no rule appears in the first row.
@@ -4366,22 +5431,22 @@ full height and depth of an entry's row. Can also be used in an
@-expression, although its synonym vertical bar '|' is more common.
This command is rarely used in the body of a table; typically a table's
vertical lines are specified in 'tabular''s COLS argument and overridden
-as needed with '\multicolumn'.
+as needed with '\multicolumn' (*note tabular::).
- This example illustrates some pitfalls. In the first line's second
-entry the '\hfill' moves the '\vline' to the left edge of the cell. But
-that is different than putting it halfway between the two columns, so in
-that row between the first and second columns there are two vertical
+ The example below illustrates some pitfalls. In the first row's
+second entry the '\hfill' moves the '\vline' to the left edge of the
+cell. But that is different than putting it halfway between the two
+columns, so between the first and second columns there are two vertical
rules, with the one from the '{c|cc}' specifier coming before the one
-produced by the '\vline\hfill'. In contrast, the first line's third
+produced by the '\vline\hfill'. In contrast, the first row's third
entry shows the usual way to put a vertical bar between two columns. In
-the second line, the 'ghi' is the widest entry in its column so in the
+the second row, the 'ghi' is the widest entry in its column so in the
'\vline\hfill' the '\hfill' has no effect and the vertical line in that
entry appears immediately next to the 'g', with no whitespace.
\begin{tabular}{c|cc}
- x &\vline\hfill y &\multicolumn{1}{|r}{z} \\
- abc &def &\vline\hfill ghi
+ x &\vline\hfill y &\multicolumn{1}{|r}{z} \\ % row 1
+ abc &def &\vline\hfill ghi % row 2
\end{tabular}

@@ -4394,10 +5459,10 @@ Synopsis:
\cline{I-J}
- Draw a horizontal rule in an 'array' or 'tabular' environment
-beginning in column I and ending in column J. The dash '-' must appear
-in the mandatory argument. To span a single column use the number
-twice.
+ In an 'array' or 'tabular' environment, draw a horizontal rule
+beginning in column I and ending in column J. The dash, '-', must
+appear in the mandatory argument. To span a single column use the
+number twice, as with '\cline{2-2}'.
This example puts two horizontal lines between the first and second
rows, one line in the first column only, and the other spanning the
@@ -4415,7 +5480,7 @@ File: latex2e.info, Node: \hline, Prev: \cline, Up: tabular
8.23.4 '\hline'
---------------
-Draws a horizontal line the width of the enclosing 'tabular' or 'array'
+Draw a horizontal line the width of the enclosing 'tabular' or 'array'
environment. It's most commonly used to draw a line at the top, bottom,
and between the rows of a table.
@@ -4438,34 +5503,52 @@ File: latex2e.info, Node: thebibliography, Next: theorem, Prev: tabular, Up:
Synopsis:
\begin{thebibliography}{WIDEST-LABEL}
- \bibitem[LABEL]{CITE_KEY}
- ...
+ \bibitem[LABEL]{CITE_KEY}
+ ...
\end{thebibliography}
- The 'thebibliography' environment produces a bibliography or
-reference list.
-
- In the 'article' class, this reference list is labelled 'References'
-and the label is stored in macro '\refname'; in the 'report' class, it
-is labelled 'Bibliography' and the label is stored in macro '\bibname'.
+ Produce a bibliography or reference list. There are two ways to
+produce bibliographic lists. This environment is suitable when you have
+only a few references and can maintain the list by hand. *Note Using
+BibTeX:: for a more sophisticated approach.
- You can change the label by redefining the command '\refname' or
-'\bibname', whichever is applicable depending on the class:
+ This shows the environment with two entries.
- * For standard classes whose top level sectioning is '\chapter' (such
- as 'book' and 'report'), the label is in the macro '\bibname';
-
- * For standard classes whose the top level sectioning is '\section'
- (such as 'article'), the label is in macro '\refname'.
+ This work is based on \cite{latexdps}.
+ Together they are \cite{latexdps, texbook}.
+ ...
+ \begin{thebibliography}{9}
+ \bibitem{latexdps}
+ Leslie Lamport.
+ \textit{\LaTeX{}: a document preparation system}.
+ Addison-Wesley, Reading, Massachusetts, 1993.
+ \bibitem{texbook}
+ Donald Ervin Knuth.
+ \textit{The \TeX book}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+ \end{thebibliography}
- Typically it is neither necessary nor desirable to directly redefine
-'\refname' or '\bibname'; language support packages like 'babel' do
-this.
+This styles the first reference as '[1] Leslie ...', and so that
+'\cite{latexdps}' produces the matching '... based on [1]'. The second
+'\cite' produces '[1, 2]'. You must compile the document twice to
+resolve these references.
+
+ The mandatory argument WIDEST-LABEL is text that, when typeset, is as
+wide as the widest item label produced by the '\bibitem' commands. The
+tradition is to use '9' for bibliographies with less than 10 references,
+'99' for ones with less than 100, etc.
+
+ The bibliographic list is headed by a title such as 'Bibliography'.
+To change it there are two cases. In the 'book' and 'report' classes,
+where the top level sectioning is '\chapter' and the default title is
+'Bibliography', that title is in the macro '\bibname'. For 'article',
+where the class's top level sectioning is '\section' and the default is
+'References', the title is in macro '\refname'. Change it by redefining
+the command, as with '\renewcommand{\refname}{Cited references}' after
+'\begin{document}'.
- The mandatory WIDEST-LABEL argument is text that, when typeset, is as
-wide as the widest item label produced by the '\bibitem' commands. It
-is typically given as '9' for bibliographies with less than 10
-references, '99' for ones with less than 100, etc.
+ Language support packages such as 'babel' will automatically redefine
+'\refname' or '\bibname' to fit the selected language.
* Menu:
@@ -4482,19 +5565,59 @@ File: latex2e.info, Node: \bibitem, Next: \cite, Up: thebibliography
Synopsis:
+ \bibitem{CITE_KEY}
+
+or
+
\bibitem[LABEL]{CITE_KEY}
- The '\bibitem' command generates an entry labelled by LABEL. If the
-LABEL argument is missing, a number is automatically generated using the
-'enumi' counter. The CITE_KEY is a "citation key" consisting in any
-sequence of letters, numbers, and punctuation symbols not containing a
-comma.
+ Generate an entry labeled by LABEL. The default is for LaTeX to
+generates a number using the 'enumi' counter. The "citation key"
+CITE_KEY is a string of letters, numbers, and punctuation symbols (but
+not comma).
+
+ *Note thebibliography:: for an example.
+
+ The optional LABEL changes the default label from an integer to the
+given string. With this
+
+ \begin{thebibliography}
+ \bibitem[Lamport 1993]{latexdps}
+ Leslie Lamport.
+ \textit{\LaTeX{}: a document preparation system}.
+ Addison-Wesley, Reading, Massachusetts, 1993.
+ \bibitem{texbook}
+ Donald Ervin Knuth.
+ \textit{The \TeX book}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+ \end{thebibliography}
- This command writes an entry to the '.aux' file containing the item's
-CITE_KEY and LABEL. When the '.aux' file is read by the
-'\begin{document}' command, the item's LABEL is associated with
-'cite_key', causing references to CITE_KEY with a '\cite' command (*note
-\cite::) to produce the associated LABEL.
+the first entry will be styled as '[Lamport 1993] Leslie ...' (The
+amount of horizontal space that LaTeX leaves for the label depends on
+the WIDEST-LABEL argument of the 'thebibliography' environment; see
+*note thebibliography::.) Similarly, '... based on \cite{latexdps}'
+will produce '... based on [Lamport 1994]'.
+
+ If you mix '\bibitem' entries having a LABEL with those that do not
+then LaTeX will number the unlabelled ones sequentially. In the example
+above the 'texbook' entry will appear as '[1] Donald ...', despite that
+it is the second entry.
+
+ If you use the same CITE_KEY twice then you get 'LaTeX Warning: There
+were multiply-defined labels'.
+
+ Under the hood, LaTeX remembers the CITE_KEY and LABEL information
+because '\bibitem' writes it to the auxiliary file 'FILENAME.aux'. For
+instance, the above example causes '\bibcite{latexdps}{Lamport, 1993}'
+and '\bibcite{texbook}{1}' to appear in that file. The '.aux' file is
+read by the '\begin{document}' command and then the information is
+available for '\cite' commands. This explains why you need to run LaTeX
+twice to resolve references: once to write it out and once to read it
+in.
+
+ Because of this two-pass algorithm, when you add a '\bibitem' or
+change its CITE_KEY you may get 'LaTeX Warning: Label(s) may have
+changed. Rerun to get cross-references right'. Fix it by recompiling.

File: latex2e.info, Node: \cite, Next: \nocite, Prev: \bibitem, Up: thebibliography
@@ -4504,15 +5627,47 @@ File: latex2e.info, Node: \cite, Next: \nocite, Prev: \bibitem, Up: thebibli
Synopsis:
+ \cite{KEYS}
+
+or
+
\cite[SUBCITE]{KEYS}
- The KEYS argument is a list of one or more citation keys (*note
-\bibitem::), separated by commas. This command generates an in-text
-citation to the references associated with KEYS by entries in the '.aux'
-file.
+ Generate as output a citation to the references associated with KEYS.
+The mandatory KEYS is a citation key, or a comma-separated list of
+citation keys (*note \bibitem::).
- The text of the optional SUBCITE argument appears after the citation.
-For example, '\cite[p.~314]{knuth}' might produce '[Knuth, p. 314]'.
+ This
+
+ The ultimate source is \cite{texbook}.
+ ...
+ \begin{thebibliography}
+ \bibitem{texbook}
+ Donald Ervin Knuth.
+ \textit{The \TeX book}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+ \end{thebibliography}
+
+produces the output '... source is [1]'.
+
+ The optional argument SUBCITE is appended to the citation. For
+example, 'See 14.3 in \cite[p.~314]{texbook}' might produce 'See 14.3 in
+[1, p. 314]'.
+
+ If KEYS is not in your bibliography information then you get 'LaTeX
+Warning: There were undefined references', and in the output the
+citation shows as a boldface question mark between square brackets.
+There are two possible causes. If you have mistyped something, as in
+'\cite{texbok}' then you need to correct the spelling. On the other
+hand, if you have just added or modified the bibliographic information
+and so changed the '.aux' file (*note \bibitem::) then the fix may be to
+just run LaTeX again.
+
+ In addition to what appears in the output, '\cite' writes information
+to the auxiliary file 'FILENAME.aux'. For instance, '\cite{latexdps}'
+writes '\citation{latexdps}' to that file. This information is used by
+BibTeX to include in your reference list only those works that you have
+actually cited; see *note \nocite:: also.

File: latex2e.info, Node: \nocite, Next: Using BibTeX, Prev: \cite, Up: thebibliography
@@ -4524,8 +5679,13 @@ Synopsis:
\nocite{KEYS}
- The '\nocite' command produces no text, but writes KEYS, which is a
-list of one or more citation keys, to the '.aux' file.
+ Produces no output but writes KEYS to the auxiliary file
+'DOC-FILENAME.aux'.
+
+ The mandatory argument KEYS is a comma-separated list of one or more
+citation keys (*note \bibitem::). This information is used by BibTeX to
+include these works in your reference list even though you have not
+cited them (*note \cite::).

File: latex2e.info, Node: Using BibTeX, Prev: \nocite, Up: thebibliography
@@ -4533,39 +5693,60 @@ File: latex2e.info, Node: Using BibTeX, Prev: \nocite, Up: thebibliography
8.24.4 Using BibTeX
-------------------
-If you use the BibTeX program by Oren Patashnik (highly recommended if
-you need a bibliography of more than a couple of titles) to maintain
-your bibliography, you don't use the 'thebibliography' environment
-(*note thebibliography::). Instead, you include the lines
+As described in 'thebibliography' (*note thebibliography::), a
+sophisticated approach to managing bibliographies is provided by the
+BibTeX program. This is only an introduction; see the full
+documentation on CTAN.
+
+ With BibTeX, you don't use 'thebibliography' (*note
+thebibliography::). Instead, include these lines.
\bibliographystyle{BIBSTYLE}
- \bibliography{BIBFILE1,BIBFILE2}
+ \bibliography{BIBFILE1, BIBFILE2, ...}
- The '\bibliographystyle' command does not produce any output of its
-own. Rather, it defines the style in which the bibliography will be
-produced: BIBSTYLE refers to a file BIBSTYLE'.bst', which defines how
-your citations will look. The standard BIBSTYLE names distributed with
-BibTeX are:
+The BIBSTYLE refers to a file 'BIBSTYLE.bst', which defines how your
+citations will look. The standard BIBSTYLE's distributed with BibTeX
+are:
'alpha'
- Sorted alphabetically. Labels are formed from name of author and
- year of publication.
+ Labels are formed from name of author and year of publication. The
+ bibliographic items are sorted alphabetically.
'plain'
- Sorted alphabetically. Labels are numeric.
+ Labels are integers. Sort the bibliographic items alphabetically.
'unsrt'
Like 'plain', but entries are in order of citation.
'abbrv'
Like 'plain', but more compact labels.
- In addition, numerous other BibTeX style files exist tailored to the
-demands of various publications. See
+Many, many other BibTeX style files exist, tailored to the demands of
+various publications. See CTAN's listing
<http://mirror.ctan.org/biblio/bibtex/contrib>.
The '\bibliography' command is what actually produces the
-bibliography. The argument to '\bibliography' refers to files named
-'BIBFILE1.bib', 'BIBFILE2.bib', ..., which should contain your database
-in BibTeX format. Only the entries referred to via '\cite' and
-'\nocite' will be listed in the bibliography.
+bibliography. Its argument is a comma-separated list, referring to
+files named 'BIBFILE1.bib', 'BIBFILE2.bib', ... These contain your
+database in BibTeX format. This shows a typical couple of entries in
+that format.
+
+ @book{texbook,
+ title = {The {{\TeX}}book},
+ author = {D.E. Knuth},
+ isbn = {0201134489},
+ series = {Computers \& typesetting},
+ year = {1983},
+ publisher = {Addison-Wesley}
+ }
+ @book{sexbook,
+ author = {W.H. Masters and V.E. Johnson},
+ title = {Human Sexual Response},
+ year = {1966},
+ publisher = {Bantam Books}
+ }
+
+ Only the bibliographic entries referred to via '\cite' and '\nocite'
+will be listed in the document's bibliography. Thus you can keep all
+your sources together in one file, or a small number of files, and rely
+on BibTeX to include in this document only those that you used.

File: latex2e.info, Node: theorem, Next: titlepage, Prev: thebibliography, Up: Environments
@@ -4576,12 +5757,29 @@ File: latex2e.info, Node: theorem, Next: titlepage, Prev: thebibliography, U
Synopsis:
\begin{theorem}
- THEOREM-TEXT
+ THEOREM BODY
\end{theorem}
- The 'theorem' environment produces "Theorem N" in boldface followed
-by THEOREM-TEXT, where the numbering possibilities for N are described
-under '\newtheorem' (*note \newtheorem::).
+ Produces 'Theorem N' in boldface followed by THEOREM BODY in italics.
+The numbering possibilities for N are described under '\newtheorem'
+(*note \newtheorem::).
+
+ \newtheorem{lem}{Lemma} % in preamble
+ \newtheorem{thm}{Theorem}
+ ...
+ \begin{lem} % in document body
+ text of lemma
+ \end{lem}
+
+ The next result follows immediately.
+ \begin{thm}[Gauss] % put `Gauss' in parens after theorem head
+ text of theorem
+ \end{thm}
+
+ Most new documents use the packages 'amsthm' and 'amsmath' from the
+American Mathematical Society. Among other things these packages
+include a large number of options for theorem environments, such as
+styling options.

File: latex2e.info, Node: titlepage, Next: verbatim, Prev: theorem, Up: Environments
@@ -4595,14 +5793,11 @@ Synopsis:
... text and spacing ...
\end{titlepage}
- Create a title page, a page with no printed page number or heading.
-The following page will be numbered page one.
+ Create a title page, a page with no printed page number or heading
+and with succeeding pages numbered starting with page one.
- To instead produce a standard title page without a 'titlepage'
-environment you can use '\maketitle' (*note \maketitle::).
-
- Notice in this example that all formatting, including vertical
-spacing, is left to the author.
+ In this example all formatting, including vertical spacing, is left
+to the author.
\begin{titlepage}
\vspace*{\stretch{1}}
@@ -4625,6 +5820,9 @@ spacing, is left to the author.
\vspace{\stretch{2}}
\end{titlepage}
+ To instead produce a standard title page without a 'titlepage'
+environment, use '\maketitle' (*note \maketitle::).
+

File: latex2e.info, Node: verbatim, Next: verse, Prev: titlepage, Up: Environments
@@ -4637,14 +5835,34 @@ Synopsis:
LITERAL-TEXT
\end{verbatim}
- The 'verbatim' environment is a paragraph-making environment in which
-LaTeX produces exactly what you type in; for instance the '\' character
-produces a printed '\'. It turns LaTeX into a typewriter with carriage
-returns and blanks having the same effect that they would on a
-typewriter.
+ A paragraph-making environment in which LaTeX produces as output
+exactly what you type as input. For instance inside LITERAL-TEXT the
+backslash '\' character does not start commands, it produces a printed
+'\', and carriage returns and blanks are taken literally. The output
+appears in a monospaced typewriter-like font ('\tt').
+
+ \begin{verbatim}
+ Symbol swearing: %&$#?!.
+ \end{verbatim}
- The 'verbatim' environment uses a monospaced typewriter-like font
-('\tt').
+ The only restriction on 'literal-text' is that it cannot include the
+string '\end{verbatim}'.
+
+ You cannot use the verbatim environment in the argument to macros,
+for instance in the argument to a '\section'. This is not the same as
+commands being fragile (*note \protect::), instead it just cannot appear
+there. (But the 'cprotect' package can help with this.)
+
+ One common use of verbatim input is to typeset computer code. There
+are packages that are an improvement the 'verbatim' environment. For
+instance, one improvement is to allow the verbatim inclusion of external
+files, or parts of those files. Such packages include 'listings', and
+'minted'.
+
+ A package that provides many more options for verbatim environments
+is 'fancyvrb'. Another is 'verbatimbox'.
+
+ For a list of all the relevant packages, see CTAN.
* Menu:
@@ -4658,17 +5876,47 @@ File: latex2e.info, Node: \verb, Up: verbatim
Synopsis:
- \verbCHARLITERAL-TEXTCHAR
- \verb*CHARLITERAL-TEXTCHAR
+ \verb CHAR LITERAL-TEXT CHAR
+ \verb* CHAR LITERAL-TEXT CHAR
+
+ Typeset LITERAL-TEXT as it is input, including special characters and
+spaces, using the typewriter ('\tt') font.
+
+ This example shows two different invocations of '\verb'.
+
+ This is \verb!literally! the biggest pumpkin ever.
+ And this is the best squash, \verb+literally!+
+
+The first '\verb' has its LITERAL-TEXT surrounded with exclamation
+point, '!'. The second instead uses plus, '+', because the exclamation
+point is part of 'literal-text'.
+
+ The single-character delimiter CHAR surrounds LITERAL-TEXT -- it must
+be the same character before and after. No spaces come between '\verb'
+or '\verb*' and CHAR, or between CHAR and LITERAL-TEXT, or between
+LITERAL-TEXT and the second occurrence of CHAR (the synopsis shows a
+space only to distinguish one component from the other). The delimiter
+must not appear in LITERAL-TEXT. The LITERAL-TEXT cannot include a line
+break.
+
+ The '*'-form differs only in that spaces are printed with a visible
+space character.
+
+ The output from this will include a character showing the spaces.
+
+ The commands's first argument is \verb*!filename with extension! and ...
- The '\verb' command typesets LITERAL-TEXT as it is input, including
-special characters and spaces, using the typewriter ('\tt') font. No
-spaces are allowed between '\verb' or '\verb*' and the delimiter CHAR,
-which begins and ends the verbatim text. The delimiter must not appear
-in LITERAL-TEXT.
+ For typesetting Internet addresses, urls, the package 'url' provides
+an option that is better than the '\verb' command, since it allows line
+breaks.
- The '*'-form differs only in that spaces are printed with a "visible
-space" character.
+ For computer code there are many packages with advantages over
+'\verb'. One is 'listings', another is 'minted'.
+
+ You cannot use '\verb' in the argument to a macro, for instance in
+the argument to a '\section'. It is not a question of '\verb' being
+fragile (*note \protect::), instead it just cannot appear there. (But
+the 'cprotect' package can help with this.)

File: latex2e.info, Node: verse, Prev: verbatim, Up: Environments
@@ -4679,18 +5927,35 @@ File: latex2e.info, Node: verse, Prev: verbatim, Up: Environments
Synopsis:
\begin{verse}
- LINE1 \\
- LINE2 \\
- ...
+ LINE1 \\
+ LINE2 \\
+ ...
\end{verse}
- The 'verse' environment is designed for poetry, though you may find
-other uses for it.
+ An environment for poetry.
+
+ Here are two lines from Shakespeare's Romeo and Juliet.
+
+ Then plainly know my heart's dear love is set \\
+ On the fair daughter of rich Capulet.
+
+ Separate the lines of each stanza with '\\', and use one or more
+blank lines to separate the stanzas.
- The margins are indented on the left and the right, paragraphs are
-not indented, and the text is not justified. Separate the lines of each
-stanza with '\\', and use one or more blank lines to separate the
-stanzas.
+ \begin{verse}
+ \makebox[\linewidth][c]{\textit{Shut Not Your Doors} ---Walt Whitman}
+ \\[1\baselineskip]
+ Shut not your doors to me proud libraries, \\
+ For that which was lacking on all your well-fill'd shelves, \\
+ \qquad yet needed most, I bring, \\
+ Forth from the war emerging, a book I have made, \\
+ The words of my book nothing, the drift of it every thing, \\
+ A book separate, not link'd with the rest nor felt by the intellect, \\
+ But you ye untold latencies will thrill to every page.
+ \end{verse}
+
+The output has margins indented on the left and the right, paragraphs
+are not indented, and the text is not right-justified.

File: latex2e.info, Node: Line breaking, Next: Page breaking, Prev: Environments, Up: Top
@@ -4706,15 +5971,20 @@ lines must be broken into pages).
LaTeX usually does the line (and page) breaking in the text body for
you but in some environments you manually force line breaks.
+ A common workflow is to get a final version of the document content
+before taking a final pass through and considering line breaks (and page
+breaks). This differs from word processing, where you are formatting
+text as you input it. Putting these off until the end prevents a lot of
+fiddling with breaks that will change anyway.
+
* Menu:
* \\:: Start a new line.
* \obeycr & \restorecr:: Make each input line start a new output line.
* \newline:: Break the line
* \- (hyphenation):: Insert explicit hyphenation.
-* \discretionary:: Insert explicit hyphenation with control of hyphen character.
-* \fussy:: Be fussy about line breaking.
-* \sloppy:: Be sloppy about line breaking.
+* \discretionary:: Explicit control of the hyphen character.
+* \fussy & \sloppy:: Be more or less particular with line breaking.
* \hyphenation:: Tell LaTeX how to hyphenate a word.
* \linebreak & \nolinebreak:: Forcing & avoiding line breaks.
@@ -4724,35 +5994,65 @@ File: latex2e.info, Node: \\, Next: \obeycr & \restorecr, Up: Line breaking
9.1 '\\'
========
-Synopsis:
+Synopsis, one of:
+ \\
\\[MORESPACE]
- or
+or one of:
+ \\*
\\*[MORESPACE]
- Start a new line. The optional argument MORESPACE specifies extra
-vertical space to be insert before the next line. This can be a
-negative length. The text before the break is set at its normal length,
-that is, it is not stretched to fill out the line width.
-
- Explicit line breaks in the text body are unusual in LaTeX. In
-particular, to start a new paragraph instead leave a blank line. This
-command is mostly used outside of the main flow of text such as in a
-'tabular' or 'array' environment.
-
- Under ordinary circumstances (e.g., outside of a 'p{...}' column in a
-'tabular' environment) the '\newline' command is a synonym for '\\'
-(*note \newline::).
+ End the current line. The optional argument MORESPACE specifies
+extra vertical space to be inserted before the next line. This is a
+rubber length (*note Lengths::) and can be negative. The text before
+the line break is set at its normal length, that is, it is not stretched
+to fill out the line width. This command is fragile (*note \protect::).
- In addition to starting a new line, the starred form '\\*' tells
-LaTeX not to start a new page between the two lines, by issuing a
-'\nobreak'.
+ The starred form, '\\*', tells LaTeX not to start a new page between
+the two lines, by issuing a '\nobreak'.
\title{My story: \\[0.25in]
a tale of woe}
+ Explicit line breaks in the main text body are unusual in LaTeX. In
+particular, don't start new paragraphs with '\\'. Instead leave a blank
+line between the two paragraphs. And don't put in a sequence of '\\''s
+to make vertical space. Instead use '\vspace{LENGTH}', or
+'\leavevmode\vspace{LENGTH}', or '\vspace*{LENGTH}' if you want the
+space to not be thrown out at the top of a new page (*note \vspace::).
+
+ The '\\' command is mostly used outside of the main flow of text such
+as in a 'tabular' or 'array' environment or in an equation environment.
+
+ The '\\' command is a synonym for '\newline' (*note \newline::) under
+ordinary circumstances (an example of an exception is the 'p{...}'
+column in a 'tabular' environment; *note tabular::).
+
+ The '\\' command is a macro, and its definition changes by context so
+that its definition in normal text, a 'center' environment, a
+'flushleft' environment, and a 'tabular' are all different. In normal
+text when it forces a linebreak it is essentially a shorthand for
+'\newline'. It does not end horizontal mode or end the paragraph, it
+just inserts some glue and penalties so that when the paragraph does end
+a linebreak will occur at that point, with the short line padded with
+white space.
+
+ You get 'LaTeX Error: There's no line here to end' if you use '\\' to
+ask for a new line, rather than to end the current line. An example is
+if you have '\begin{document}\\' or, more likely, something like this.
+
+ \begin{center}
+ \begin{minipage}{0.5\textwidth}
+ \\
+ In that vertical space put your mark.
+ \end{minipage}
+ \end{center}
+
+Fix it by replacing the double backslash with something like
+'\vspace{\baselineskip}'.
+

File: latex2e.info, Node: \obeycr & \restorecr, Next: \newline, Prev: \\, Up: Line breaking
@@ -4760,10 +6060,41 @@ File: latex2e.info, Node: \obeycr & \restorecr, Next: \newline, Prev: \\, Up
============================
The '\obeycr' command makes a return in the input file ('^^M',
-internally) the same as '\\' (followed by '\relax'). So each new line
-in the input will also be a new line in the output.
+internally) the same as '\\', followed by '\relax'. So each new line in
+the input will also be a new line in the output. The '\restorecr'
+command restores normal line-breaking behavior.
+
+ This is not the way to show verbatim text or computer code. *Note
+verbatim:: instead.
+
+ With LaTeX's usual defaults, this
+
+ aaa
+ bbb
- '\restorecr' restores normal line-breaking behavior.
+ \obeycr
+ ccc
+ ddd
+ eee
+
+ \restorecr
+ fff
+ ggg
+
+ hhh
+ iii
+
+produces output like this.
+
+ aaa bbb
+ ccc
+ ddd
+ eee
+
+ fff ggg
+ hhh iii
+
+The indents are paragraph indents.

File: latex2e.info, Node: \newline, Next: \- (hyphenation), Prev: \obeycr & \restorecr, Up: Line breaking
@@ -4771,14 +6102,17 @@ File: latex2e.info, Node: \newline, Next: \- (hyphenation), Prev: \obeycr & \
9.3 '\newline'
==============
-In ordinary text this is equivalent to double-backslash (*note \\::); it
-breaks a line, with no stretching of the text before it.
+In ordinary text, this ends a line in a way that does not right-justify
+the line, so the prior text is not stretched. That is, in paragraph
+mode (*note Modes::), the '\newline' command is equivalent to
+double-backslash (*note \\::). This command is fragile (*note
+\protect::).
- Inside a 'tabular' or 'array' environment, in a column with a
-specifier producing a paragraph box, like typically 'p{...}', '\newline'
-will insert a line break inside of the column, that is, it does not
-break the entire row. To break the entire row use '\\' or its
-equivalent '\tabularnewline'.
+ However, the two commands are different inside a 'tabular' or 'array'
+environment. In a column with a specifier producing a paragraph box
+such as typically 'p{...}', '\newline' will insert a line end inside of
+the column; that is, it does not break the entire tabular row. To break
+the entire row use '\\' or its equivalent '\tabularnewline'.
This will print 'Name:' and 'Address:' as two lines in a single cell
of the table.
@@ -4787,7 +6121,7 @@ of the table.
Name: \newline Address: &Date: \\ \hline
\end{tabular}
- The 'Date:' will be baseline-aligned with 'Name:'.
+The 'Date:' will be baseline-aligned with 'Name:'.

File: latex2e.info, Node: \- (hyphenation), Next: \discretionary, Prev: \newline, Up: Line breaking
@@ -4795,87 +6129,169 @@ File: latex2e.info, Node: \- (hyphenation), Next: \discretionary, Prev: \newl
9.4 '\-' (discretionary hyphen)
===============================
-The '\-' command tells LaTeX that it may hyphenate the word at that
-point. LaTeX is pretty good at hyphenating, and usually finds most of
-the correct hyphenation points, while almost never using an incorrect
-one. The '\-' command is used for the exceptional cases.
+Tell LaTeX that it may hyphenate the word at that point. When you
+insert '\-' commands in a word, the word will only be hyphenated at
+those points and not at any of the hyphenation points that LaTeX might
+otherwise have chosen. This command is robust (*note \protect::).
+
+ LaTeX is good at hyphenating and usually finds most of the correct
+hyphenation points, while almost never using an incorrect one. The '\-'
+command is for exceptional cases.
+
+ For example, LaTeX does not ordinarily hyphenate words containing a
+hyphen. Below, the long and hyphenated word means LaTeX has to put in
+unacceptably large spaces to set the narrow column.
+
+ \begin{tabular}{rp{1.75in}}
+ Isaac Asimov &The strain of
+ anti-intellectualism
+ % an\-ti-in\-tel\-lec\-tu\-al\-ism
+ has been a constant thread winding its way through our
+ political and cultural life, nurtured by
+ the false notion that democracy means that
+ `my ignorance is just as good as your knowledge'.
+ \end{tabular}
+
+Commenting out the third line and uncommenting the fourth makes a much
+better fit.
- When you insert '\-' commands in a word, the word will only be
-hyphenated at those points and not at any of the hyphenation points that
-LaTeX might otherwise have chosen.
+ The '\-' command only allows LaTeX to break there, it does not
+require that it break there. You can insist on a split with something
+like 'Hef-\linebreak feron'. Of course, if you later change the text
+then this forced break may look very odd, so this approach requires
+care.

-File: latex2e.info, Node: \discretionary, Next: \fussy, Prev: \- (hyphenation), Up: Line breaking
+File: latex2e.info, Node: \discretionary, Next: \fussy & \sloppy, Prev: \- (hyphenation), Up: Line breaking
9.5 '\discretionary' (generalized hyphenation point)
====================================================
Synopsis:
- \discretionary{PRE-BREAK-TEXT}{POST-BREAK-TEXT}{NO-BREAK-TEXT}
+ \discretionary{PRE-BREAK}{POST-BREAK}{NO-BREAK}
+
+ Handle word changes around hyphens. This command is not often used
+in LaTeX documents.
+
+ If a line break occurs at the point where '\discretionary' appears
+then TeX puts PRE-BREAK at the end of the current line and puts
+POST-BREAK at the start of the next line. If there is no line break
+here then TeX puts NO-BREAK
+
+ In 'difficult' the three letters 'ffi' form a ligature. But TeX can
+nonetheless break between the two f's with this.
+
+ di\discretionary{f-}{fi}{ffi}cult
+
+ Note that users do not have to do this. It is typically handled
+automatically by TeX's hyphenation algorithm.

-File: latex2e.info, Node: \fussy, Next: \sloppy, Prev: \discretionary, Up: Line breaking
+File: latex2e.info, Node: \fussy & \sloppy, Next: \hyphenation, Prev: \discretionary, Up: Line breaking
-9.6 '\fussy'
-============
+9.6 '\fussy' & '\sloppy'
+========================
-The declaration '\fussy' (which is the default) makes TeX picky about
-line breaking. This usually avoids too much space between words, at the
-cost of an occasional overfull box.
+Declarations to make TeX more picky or less picky about line breaking.
+Declaring '\fussy' usually avoids too much space between words, at the
+cost of an occasional overfull box. Conversely, '\sloppy' avoids
+overfull boxes while suffering loose interword spacing.
+
+ The default is '\fussy'. Line breaking in a paragraph is controlled
+by whichever declaration is current at the blank line, or '\par', or
+displayed equation ending that paragraph. So to affect the line breaks,
+include that paragraph-ending material in the scope of the command.
+
+* Menu:
- This command cancels the effect of a previous '\sloppy' command
-(*note \sloppy::).
+* sloppypar:: Environment version of \sloppy command.

-File: latex2e.info, Node: \sloppy, Next: \hyphenation, Prev: \fussy, Up: Line breaking
+File: latex2e.info, Node: sloppypar, Up: \fussy & \sloppy
-9.7 '\sloppy'
-=============
+9.6.1 'sloppypar'
+-----------------
-The declaration '\sloppy' makes TeX less fussy about line breaking.
-This will avoid overfull boxes, at the cost of loose interword spacing.
+Synopsis:
- Lasts until a '\fussy' command is issued (*note \fussy::).
+ \begin{sloppypar}
+ ... paragraphs ...
+ \end{sloppypar}
+
+ Typeset the paragraphs with '\sloppy' in effect (*note \fussy &
+\sloppy::). Use this to locally adjust line breaking, to avoid
+'Overfull box' or 'Underfull box' errors.
+
+ The example is simple.
+
+ \begin{sloppypar}
+ Her plan for the morning thus settled, she sat quietly down to her
+ book after breakfast, resolving to remain in the same place and the
+ same employment till the clock struck one; and from habitude very
+ little incommoded by the remarks and ejaculations of Mrs.\ Allen,
+ whose vacancy of mind and incapacity for thinking were such, that
+ as she never talked a great deal, so she could never be entirely
+ silent; and, therefore, while she sat at her work, if she lost her
+ needle or broke her thread, if she heard a carriage in the street,
+ or saw a speck upon her gown, she must observe it aloud, whether
+ there were anyone at leisure to answer her or not.
+ \end{sloppypar}

-File: latex2e.info, Node: \hyphenation, Next: \linebreak & \nolinebreak, Prev: \sloppy, Up: Line breaking
+File: latex2e.info, Node: \hyphenation, Next: \linebreak & \nolinebreak, Prev: \fussy & \sloppy, Up: Line breaking
-9.8 '\hyphenation'
+9.7 '\hyphenation'
==================
Synopsis:
- \hyphenation{WORD-ONE WORD-TWO}
+ \hyphenation{WORD1 ...}
- The '\hyphenation' command declares allowed hyphenation points with a
-'-' character in the given words. The words are separated by spaces.
-TeX will only hyphenate if the word matches exactly, no inflections are
-tried. Multiple '\hyphenation' commands accumulate. Some examples (the
-default TeX hyphenation patterns misses the hyphenations in these
-words):
+ Declares allowed hyphenation points within the words in the list.
+The words in that list are separated by spaces. Show permitted points
+for hyphenation with a dash character, '-'.
- \hyphenation{ap-pen-dix col-umns data-base data-bases}
+ Here is an example:
+
+ \hyphenation{hat-er il-lit-e-ra-ti tru-th-i-ness}
+
+ Use lowercase letters. TeX will only hyphenate if the word matches
+exactly. Multiple '\hyphenation' commands accumulate.

File: latex2e.info, Node: \linebreak & \nolinebreak, Prev: \hyphenation, Up: Line breaking
-9.9 '\linebreak' & '\nolinebreak'
+9.8 '\linebreak' & '\nolinebreak'
=================================
-Synopses:
+Synopses, one of:
- \linebreak[PRIORITY]
- \nolinebreak[PRIORITY]
+ \linebreak
+ \linebreak[ZERO-TO-FOUR]
- By default, the '\linebreak' ('\nolinebreak') command forces
-(prevents) a line break at the current position. For '\linebreak', the
-spaces in the line are stretched out so that it extends to the right
-margin as usual.
+or one of these.
- With the optional argument PRIORITY, you can convert the command from
-a demand to a request. The PRIORITY must be a number from 0 to 4. The
-higher the number, the more insistent the request.
+ \nolinebreak
+ \nolinebreak[ZERO-TO-FOUR]
+
+ Encourage or discourage a line break. The optional ZERO-TO-FOUR is
+an integer that allows you to soften the instruction. The default is 4,
+so that without the optional argument these commands entirely force or
+prevent the break. But for instance, '\nolinebreak[1]' is a suggestion
+that another place may be better. The higher the number, the more
+insistent the request. Both commands are fragile (*note \protect::).
+
+ Here we tell LaTeX that a good place to put a linebreak is after the
+standard legal text.
+
+ \boilerplatelegal{} \linebreak[2]
+ We especially encourage applications from members of traditionally
+ underrepresented groups.
+
+ When you issue '\linebreak', the spaces in the line are stretched out
+so that it extends to the right margin. *Note \\:: and *note \newline::
+to have the spaces not stretched out.

File: latex2e.info, Node: Page breaking, Next: Footnotes, Prev: Line breaking, Up: Top
@@ -4883,86 +6299,192 @@ File: latex2e.info, Node: Page breaking, Next: Footnotes, Prev: Line breaking
10 Page breaking
****************
-LaTeX starts new pages asynchronously, when enough material has
-accumulated to fill up a page. Usually this happens automatically, but
-sometimes you may want to influence the breaks.
+Ordinarily LaTeX automatically takes care of breaking output into pages
+with its usual aplomb. But if you are writing commands, or tweaking the
+final version of a document, then you may need to understand how to
+influence its actions.
+
+ LaTeX's algorithm for splitting a document into pages is more complex
+than just waiting until there is enough material to fill a page and
+outputting the result. Instead, LaTeX typesets more material than would
+fit on the page and then chooses a break that is optimal in some way (it
+has the smallest badness). An example of the advantage of this approach
+is that if the page has some vertical space that can be stretched or
+shrunk, such as with rubber lengths between paragraphs, then LaTeX can
+use that to avoid widow lines (where a new page starts with the last
+line of a paragraph; LaTeX can squeeze the extra line onto the first
+page) and orphans (where the first line of paragraph is at the end of a
+page; LaTeX can stretch the material of the first page so the extra line
+falls on the second page). Another example is where LaTeX uses
+available vertical shrinkage to fit on a page not just the header for a
+new section but also the first two lines of that section.
+
+ But LaTeX does not optimize over the entire document's set of page
+breaks. So it can happen that the first page break is great but the
+second one is lousy; to break the current page LaTeX doesn't look as far
+ahead as the next page break. So occasionally you may want to influence
+page breaks while preparing a final version of a document.
+
+ *Note Layout:: for more material that is relevant to page breaking.
* Menu:
-* \cleardoublepage:: Start a new right-hand page.
-* \clearpage:: Start a new page.
-* \newpage:: Start a new page.
-* \enlargethispage:: Enlarge the current page a bit.
-* \pagebreak & \nopagebreak:: Forcing & avoiding page breaks.
+* \clearpage & \cleardoublepage:: Start a new page; eject floats.
+* \newpage:: Start a new page.
+* \enlargethispage:: Enlarge the current page a bit.
+* \pagebreak & \nopagebreak:: Forcing & avoiding page breaks.

-File: latex2e.info, Node: \cleardoublepage, Next: \clearpage, Up: Page breaking
+File: latex2e.info, Node: \clearpage & \cleardoublepage, Next: \newpage, Up: Page breaking
-10.1 '\cleardoublepage'
-=======================
+10.1 '\clearpage' & '\cleardoublepage'
+======================================
-The '\cleardoublepage' command ends the current page and causes all the
-pending floating figures and tables that have so far appeared in the
-input to be printed. In a two-sided printing style, it also makes the
-next page a right-hand (odd-numbered) page, producing a blank page if
-necessary.
+Synopsis:
-
-File: latex2e.info, Node: \clearpage, Next: \newpage, Prev: \cleardoublepage, Up: Page breaking
+ \clearpage
-10.2 '\clearpage'
-=================
+or
+
+ \cleardoublepage
+
+ End the current page and output all of the pending floating figures
+and tables (*note Floats::). If there are too many floats to fit on the
+page then LaTeX will put in extra pages containing only floats. In
+two-sided printing, '\cleardoublepage' also makes the next page of
+content a right-hand page, an odd-numbered page, if necessary inserting
+a blank page. The '\clearpage' command is robust while
+'\cleardoublepage' is fragile (*note \protect::).
-The '\clearpage' command ends the current page and causes all the
-pending floating figures and tables that have so far appeared in the
-input to be printed.
+ LaTeX's page breaks are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+
+ The '\cleardoublepage' command will put in a blank page, but it will
+have the running headers and footers. To get a really blank page, use
+this command.
+
+ \let\origdoublepage\cleardoublepage
+ \newcommand{\clearemptydoublepage}{%
+ \clearpage
+ {\pagestyle{empty}\origdoublepage}%
+ }
+
+If you want LaTeX's standard '\chapter' command to do this then add the
+line '\let\cleardoublepage\clearemptydoublepage'.
+
+ The command '\newpage' (*note \newpage::) also ends the current page,
+but without clearing pending floats. And, if LaTeX is in two-column
+mode then '\newpage' ends the current column while '\clearpage' and
+'\cleardoublepage' end the current page.

-File: latex2e.info, Node: \newpage, Next: \enlargethispage, Prev: \clearpage, Up: Page breaking
+File: latex2e.info, Node: \newpage, Next: \enlargethispage, Prev: \clearpage & \cleardoublepage, Up: Page breaking
-10.3 '\newpage'
+10.2 '\newpage'
===============
-The '\newpage' command ends the current page, but does not clear floats
-(*note \clearpage::).
+Synopsis:
+
+ \newpage
+
+ End the current page. This command is robust (*note \protect::).
+
+ LaTeX's page breaks are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+
+ While the commands '\clearpage' and '\cleardoublepage' also end the
+current page, in addition they clear pending floats (*note \clearpage &
+\cleardoublepage::). And, if LaTeX is in two-column mode then
+'\clearpage' and '\cleardoublepage' end the current page, possibly
+leaving an empty column, while '\newpage' only ends the current column.
+
+ In contrast with '\pagebreak' (*note \pagebreak & \nopagebreak::),
+the '\newpage' command will cause the new page to start right where
+requested. This
+
+ Four score and seven years ago our fathers brought forth on this
+ continent,
+ \newpage
+ \noindent a new nation, conceived in Liberty, and dedicated to the
+ proposition that all men are created equal.
+
+makes a new page start after 'continent,' and the cut-off line is not
+right justified. In addition, '\newpage' does not vertically stretch
+out the page, as '\pagebreak' does.

File: latex2e.info, Node: \enlargethispage, Next: \pagebreak & \nopagebreak, Prev: \newpage, Up: Page breaking
-10.4 '\enlargethispage'
+10.3 '\enlargethispage'
=======================
-'\enlargethispage{size}'
+Synopsis, one of:
+
+ \enlargethispage{size}
+ \enlargethispage*{size}
+
+ Enlarge the '\textheight' for the current page. The required
+argument SIZE must be a rigid length (*note Lengths::). It may be
+positive or negative. This command is fragile (*note \protect::).
+
+ A common strategy is to wait until you have the final text of a
+document, and then pass through it tweaking line and page breaks. This
+command allows you some page size leeway.
- '\enlargethispage*{size}'
+ This will allow one extra line on the current page.
- Enlarge the '\textheight' for the current page by the specified
-amount; e.g., '\enlargethispage{\baselineskip}' will allow one
-additional line.
+ \enlargethispage{\baselineskip}
- The starred form tries to squeeze the material together on the page
-as much as possible. This is normally used together with an explicit
-'\pagebreak'.
+ The starred form '\enlargesthispage*' tries to squeeze the material
+together on the page as much as possible, for the common use case of
+getting one more line on the page. This is often used together with an
+explicit '\pagebreak'.

File: latex2e.info, Node: \pagebreak & \nopagebreak, Prev: \enlargethispage, Up: Page breaking
-10.5 '\pagebreak' & '\nopagebreak'
+10.4 '\pagebreak' & '\nopagebreak'
==================================
Synopses:
- \pagebreak[PRIORITY]
- \nopagebreak[PRIORITY]
+ \pagebreak
+ \pagebreak[ZERO-TO-FOUR]
+
+or
+
+ \nopagebreak
+ \nopagebreak[ZERO-TO-FOUR]
+
+ Encourage or discourage a page break. The optional ZERO-TO-FOUR is
+an integer that allows you to soften the request. The default is 4, so
+that without the optional argument these commands entirely force or
+prevent the break. But for instance '\nopagebreak[1]' suggests to LaTeX
+that another spot might be preferable. The higher the number, the more
+insistent the request. Both commands are fragile (*note \protect::).
+
+ LaTeX's page endings are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
- By default, the '\pagebreak' ('\nopagebreak') command forces
-(prevents) a page break at the current position. With '\pagebreak', the
-vertical space on the page is stretched out where possible so that it
-extends to the normal bottom margin.
+ If you use these inside a paragraph, they apply to the point
+following the line in which they appear. So this
- With the optional argument PRIORITY, you can convert the '\pagebreak'
-command from a demand to a request. The number must be a number from 0
-to 4. The higher the number, the more insistent the request is.
+ Four score and seven years ago our fathers brought forth on this
+ continent,
+ \pagebreak
+ a new nation, conceived in Liberty, and dedicated to the proposition
+ that all men are created equal.
+
+does not give a page break at 'continent,' but instead at 'nation,'
+since that is where LaTeX breaks that line. In addition, with
+'\pagebreak' the vertical space on the page is stretched out where
+possible so that it extends to the normal bottom margin. This can look
+strange, and if '\flushbottom' is in effect this can cause you to get
+'Underfull \vbox (badness 10000) has occurred while \output is active'.
+*Note \newpage:: for a command that does not have these effects.

File: latex2e.info, Node: Footnotes, Next: Definitions, Prev: Page breaking, Up: Top
@@ -4970,31 +6492,30 @@ File: latex2e.info, Node: Footnotes, Next: Definitions, Prev: Page breaking,
11 Footnotes
************
-Place a numbered footnote at the bottom of the current page, as here.
+Place a footnote at the bottom of the current page, as here.
Noe"l Coward quipped that having to read a footnote is like having
to go downstairs to answer the door, while in the midst of making
- love.\footnote{I wouldn't know, I don't read footnotes.}
+ love.\footnote{%
+ I wouldn't know, I don't read footnotes.}
- You can place multiple footnotes on a page. If the text becomes too
-long it will flow to the next page.
+ You can put multiple footnotes on a page. If the footnote text
+becomes too long then it will flow to the next page.
You can also produce footnotes by combining the '\footnotemark' and
the '\footnotetext' commands, which is useful in special circumstances.
To make bibliographic references come out as footnotes you need to
-include a bibliographic style with that behavior.
+include a bibliographic style with that behavior (*note Using BibTeX::).
* Menu:
* \footnote:: Insert a footnote.
* \footnotemark:: Insert footnote mark only.
* \footnotetext:: Insert footnote text only.
-* Footnotes in a table:: Table footnotes.
* Footnotes in section headings:: Chapter or section titles.
+* Footnotes in a table:: Table footnotes.
* Footnotes of footnotes:: Multiple classes of footnotes.
-* Multiple reference to footnotes:: Referring to a footnote more than once.
-* Footnote parameters:: Parameters for footnote formatting.

File: latex2e.info, Node: \footnote, Next: \footnotemark, Up: Footnotes
@@ -5002,40 +6523,68 @@ File: latex2e.info, Node: \footnote, Next: \footnotemark, Up: Footnotes
11.1 '\footnote'
================
-Synopsis:
+Synopsis, one of:
+ \footnote{TEXT}
\footnote[NUMBER]{TEXT}
- Place a numbered footnote TEXT at the bottom of the current page.
+ Place a footnote TEXT at the bottom of the current page.
There are over a thousand footnotes in Gibbon's
- \textit{Decline and Fall of the Roman Empire}.\footnote{After
- reading an early version with endnotes David Hume complained,
- ``One is also plagued with his Notes, according to the present Method
- of printing the Book'' and suggested that they ``only to be printed
- at the Margin or the Bottom of the Page.''}
-
- The optional argument NUMBER allows you to specify the footnote
-number. If you use this option then the footnote number counter is not
-incremented, and if you do not use it then the counter is incremented.
+ \textit{Decline and Fall of the Roman Empire}.\footnote{%
+ After reading an early version with endnotes David Hume complained,
+ ``One is also plagued with his Notes, according to the present Method
+ of printing the Book'' and suggested that they ``only to be printed
+ at the Margin or the Bottom of the Page.''}
+
+ The optional argument NUMBER allows you to specify the number of the
+footnote. If you use this then LaTeX does not increment the 'footnote'
+counter.
- Change how LaTeX shows the footnote counter with something like
+ By default, LaTeX uses arabic numbers as footnote markers. Change
+this with something like
'\renewcommand{\thefootnote}{\fnsymbol{footnote}}', which uses a
sequence of symbols (*note \alph \Alph \arabic \roman \Roman
\fnsymbol::). To make this change global put that in the preamble. If
you make the change local then you may want to reset the counter with
-'\setcounter{footnote}{0}'. By default LaTeX uses arabic numbers.
+'\setcounter{footnote}{0}'.
+
+ LaTeX determines the spacing of footnotes with two parameters.
+
+'\footnoterule'
+ Produces the rule separating the main text on a page from the
+ page's footnotes. Default dimensions in the standard document
+ classes (except 'slides', where it does not appear) is: vertical
+ thickness of '0.4pt', and horizontal size of '0.4\columnwidth'
+ long. Change the rule with something like this.
+
+ \renewcommand{\footnoterule}{% Kerns avoid vertical space
+ \kern -3pt % This -3 is negative
+ \hrule width \textwidth height 1pt % of the sum of this 1
+ \kern 2pt} % and this 2
+
+'\footnotesep'
+ The height of the strut placed at the beginning of the footnote
+ (*note \strut::). By default, this is set to the normal strut for
+ '\footnotesize' fonts (*note Font sizes::), therefore there is no
+ extra space between footnotes. This is '6.65pt' for '10pt',
+ '7.7pt' for '11pt', and '8.4pt' for '12pt'. Change it as with
+ '\setlength{\footnotesep}{11pt}'.
+
+ The '\footnote' command is fragile (*note \protect::).
LaTeX's default puts many restrictions on where you can use a
'\footnote'; for instance, you cannot use it in an argument to a
sectioning command such as '\chapter' (it can only be used in outer
-paragraph mode). There are some workarounds; see following sections.
+paragraph mode; *note Modes::). There are some workarounds; see
+following sections.
In a 'minipage' environment the '\footnote' command uses the
'mpfootnote' counter instead of the 'footnote' counter, so they are
numbered independently. They are shown at the bottom of the
environment, not at the bottom of the page. And by default they are
-shown alphabetically. *Note minipage::.
+shown alphabetically. *Note minipage:: and *note Footnotes in a
+table::.

File: latex2e.info, Node: \footnotemark, Next: \footnotetext, Prev: \footnote, Up: Footnotes
@@ -5048,13 +6597,24 @@ Synopsis, one of:
\footnotemark
\footnotemark[NUMBER]
- Put the current footnote number in the text. (See *note
-\footnotetext:: for giving the text of the footnote separately.) The
-version with the optional argument NUMBER uses that number to determine
-the mark printed. This command can be used in inner paragraph mode.
+ Put the current footnote mark in the text. To specify associated
+text for the footnote see *note \footnotetext::. The optional argument
+NUMBER causes the command to use that number to determine the footnote
+mark. This command can be used in inner paragraph mode (*note Modes::).
+
+ If you use '\footnotemark' without the optional argument then it
+increments the footnote counter but if you use the optional NUMBER then
+it does not. The next example produces several consecutive footnote
+markers referring to the same footnote.
+
+ The first theorem\footnote{Due to Gauss.}
+ and the second theorem\footnotemark[\value{footnote}]
+ and the third theorem.\footnotemark[\value{footnote}]
- This example gives the same institutional affiliation to both the
-first and third authors ('\thanks' is a version of 'footnote').
+ If there are intervening footnotes then you must remember the value
+of the common mark. This example gives the same institutional
+affiliation to both the first and third authors ('\thanks' is a version
+of 'footnote'), by-hand giving the number of the footnote.
\title{A Treatise on the Binomial Theorem}
\author{J Moriarty\thanks{University of Leeds}
@@ -5063,17 +6623,30 @@ first and third authors ('\thanks' is a version of 'footnote').
\begin{document}
\maketitle
- If you use '\footnotemark' without the optional argument then it
-increments the footnote counter but if you use the optional NUMBER then
-it does not. This produces several consecutive footnote markers
-referring to the same footnote.
+ This uses a counter to remember the footnote number. The third
+sentence is followed by the same footnote marker as the first.
- The first theorem\footnote{Due to Gauss.}
- and the second theorem\footnotemark[\value{footnote}]
- and the third theorem.\footnotemark[\value{footnote}]
+ \newcounter{footnoteValueSaver}
+ All babies are illogical.\footnote{%
+ Lewis Carroll.}\setcounter{footnoteValueSaver}{\value{footnote}}
+ Nobody is despised who can manage a crocodile.\footnote{%
+ Captain Hook.}
+ Illogical persons are despised.\footnotemark[\value{footnoteValueSaver}]
+ Therefore, anyone who can manage a crocodile is not a baby.
+
+ This example accomplishes the same by using the package 'cleveref'.
+
+ \usepackage{cleveref}[2012/02/15] % in preamble
+ \crefformat{footnote}{#2\footnotemark[#1]#3}
+ ...
+ The theorem is from Evers.\footnote{\label{fn:TE}Tinker, Evers, 1994.}
+ The corollary is from Chance.\footnote{Evers, Chance, 1990.}
+ But the key lemma is from Tinker.\cref{fn:TE}
+
+ It will work with the package 'hyperref'.

-File: latex2e.info, Node: \footnotetext, Next: Footnotes in a table, Prev: \footnotemark, Up: Footnotes
+File: latex2e.info, Node: \footnotetext, Next: Footnotes in section headings, Prev: \footnotemark, Up: Footnotes
11.3 '\footnotetext'
====================
@@ -5083,87 +6656,111 @@ Synopsis, one of:
\footnotetext{TEXT}
\footnotetext[NUMBER]{TEXT}
- Place TEXT at the bottom of the page as a footnote. This command can
-come anywhere after the '\footnotemark' command. The optional argument
-NUMBER changes the displayed footnote number. The '\footnotetext'
-command must appear in outer paragraph mode.
+ Place TEXT at the bottom of the page as a footnote. It pairs with
+'\footnotemark' (*note \footnotemark::) and can come anywhere after that
+command, but must appear in outer paragraph mode (*note Modes::). The
+optional argument NUMBER changes the number of the footnote mark.
+
+ *Note \footnotemark:: and *note Footnotes in a table:: for usage
+examples.
+
+
+File: latex2e.info, Node: Footnotes in section headings, Next: Footnotes in a table, Prev: \footnotetext, Up: Footnotes
+
+11.4 Footnotes in section headings
+==================================
+
+Putting a footnote in a section heading, as in:
+
+ \section{Full sets\protect\footnote{This material due to ...}}
+
+causes the footnote to appear at the bottom of the page where the
+section starts, as usual, but also at the bottom of the table of
+contents, where it is not likely to be desired. The simplest way to
+have it not appear on the table of contents is to use the optional
+argument to '\section'
+
+ \section[Please]{Please\footnote{%
+ Don't footnote in chapter and section headers!}}
+
+No '\protect' is needed in front of '\footnote' here because what gets
+moved to the table of contents is the optional argument.

-File: latex2e.info, Node: Footnotes in a table, Next: Footnotes in section headings, Prev: \footnotetext, Up: Footnotes
+File: latex2e.info, Node: Footnotes in a table, Next: Footnotes of footnotes, Prev: Footnotes in section headings, Up: Footnotes
-11.4 Footnotes in a table
+11.5 Footnotes in a table
=========================
-Inside a 'table' environment the '\footnote' command does not work. For
-instance, if the code below appears on its own then the footnote simply
-disappears; there is a footnote mark in the table cell but nothing is
-set at the bottom of the page.
+Inside a 'tabular' or 'array' environment the '\footnote' command does
+not work; there is a footnote mark in the table cell but the footnote
+text does not appear. The solution is to use a 'minipage' environment
+as here (*note minipage::).
\begin{center}
+ \begin{minipage}{\textwidth} \centering
\begin{tabular}{l|l}
- \textsc{Ship} &\textsc{Book} \\ \hline
- \textit{HMS Sophie} &Master and Commander \\
- \textit{HMS Polychrest} &Post Captain \\
- \textit{HMS Lively} &Post Captain \\
- \textit{HMS Surprise} &A number of books\footnote{Starting with
- HMS Surprise.}
+ \textsc{Ship} &\textsc{Book} \\ \hline
+ \textit{HMS Sophie} &Master and Commander \\
+ \textit{HMS Polychrest} &Post Captain \\
+ \textit{HMS Lively} &Post Captain \\
+ \textit{HMS Surprise} &A number of books\footnote{%
+ Starting with HMS Surprise.}
\end{tabular}
+ \end{minipage}
\end{center}
- The solution is to surround the 'tabular' environment with a
-'minipage' environment, as here (*note minipage::).
+ Inside a 'minipage', footnote marks are lowercase letters. Change
+that with something like
+'\renewcommand{\thempfootnote}{\arabic{mpfootnote}}' (*note \alph \Alph
+\arabic \roman \Roman \fnsymbol::).
+
+ The footnotes in the prior example appear at the bottom of the
+'minipage'. To have them appear at the bottom of the main page, as part
+of the regular footnote sequence, use the '\footnotemark' and
+'\footnotetext' pair and make a new counter.
+ \newcounter{mpFootnoteValueSaver}
\begin{center}
- \begin{minipage}{.5\textwidth}
- ... tabular material ...
- \end{minipage}
+ \begin{minipage}{\textwidth}
+ \setcounter{mpFootnoteValueSaver}{\value{footnote}} \centering
+ \begin{tabular}{l|l}
+ \textsc{Woman} &\textsc{Relationship} \\ \hline
+ Mona &Attached\footnotemark \\
+ Diana Villiers &Eventual wife \\
+ Christine Hatherleigh Wood &Fiance\footnotemark
+ \end{tabular}
+ \end{minipage}% percent sign keeps footnote text close to minipage
+ \stepcounter{mpFootnoteValueSaver}%
+ \footnotetext[\value{mpFootnoteValueSaver}]{%
+ Little is known other than her death.}%
+ \stepcounter{mpFootnoteValueSaver}%
+ \footnotetext[\value{mpFootnoteValueSaver}]{%
+ Relationship is unresolved in XXI.}
\end{center}
- The same technique will work inside a floating 'table' environment
-(*note table::). To get the footnote at the bottom of the page use the
-'tablefootnote' package, as illustrated in this example. If you put
-'\usepackage{tablefootnote}' in the preamble and use the code shown then
-the footnote appears at the bottom and is numbered in sequence with
-other footnotes.
+ For a floating 'table' environment (*note table::), use the
+'tablefootnote' package.
+ \usepackage{tablefootnote} % in preamble
+ ...
\begin{table}
\centering
\begin{tabular}{l|l}
\textsc{Date} &\textsc{Campaign} \\ \hline
1862 &Fort Donelson \\
1863 &Vicksburg \\
- 1865 &Army of Northern Virginia\footnote{Ending the war.}
+ 1865 &Army of Northern Virginia\tablefootnote{%
+ Ending the war.}
\end{tabular}
\caption{Forces captured by US Grant}
\end{table}
-
-File: latex2e.info, Node: Footnotes in section headings, Next: Footnotes of footnotes, Prev: Footnotes in a table, Up: Footnotes
-
-11.5 Footnotes in section headings
-==================================
-
-Putting a footnote in a section heading, as in:
-
- \section{Full sets\protect\footnote{This material due to ...}}
-
-causes the footnote to appear at the bottom of the page where the
-section starts, as usual, but also at the bottom of the table of
-contents, where it is not likely to be desired. To have it not appear
-on the table of contents use the package 'footmisc' with the 'stable'
-option.
-
- \usepackage[stable]{footmisc}
- ...
- \begin{document}
- ...
- \section{Full sets\footnote{This material due to ...}}
-
- Note that the '\protect' is gone; including it would cause the
-footnote to reappear on the table of contents.
+The footnote appears at the page bottom and is numbered in sequence with
+other footnotes.

-File: latex2e.info, Node: Footnotes of footnotes, Next: Multiple reference to footnotes, Prev: Footnotes in section headings, Up: Footnotes
+File: latex2e.info, Node: Footnotes of footnotes, Prev: Footnotes in a table, Up: Footnotes
11.6 Footnotes of footnotes
===========================
@@ -5173,57 +6770,13 @@ footnotes, including having footnotes of footnotes. The package
'bigfoot' extends LaTeX's default footnote mechanism in many ways,
including allow these two, as in this example.
- \usepackage{bigfoot}
+ \usepackage{bigfoot} % in preamble
\DeclareNewFootnote{Default}
\DeclareNewFootnote{from}[alph] % create class \footnotefrom{}
...
- \begin{document}
- ...
The third theorem is a partial converse of the
- second.\footnotefrom{First noted in Wilson.\footnote{Second edition only.}}
- ...
-
-
-File: latex2e.info, Node: Multiple reference to footnotes, Next: Footnote parameters, Prev: Footnotes of footnotes, Up: Footnotes
-
-11.7 Multiple references to footnotes
-=====================================
-
-You can refer to a single footnote more than once. This example uses
-the package 'cleverref'.
-
- \usepackage{cleveref}[2012/02/15] % this version of package or later
- \crefformat{footnote}{#2\footnotemark[#1]#3}
- ...
- \begin{document}
- ...
- The theorem is from Evers.\footnote{\label{fn:TE}Tinker and Evers, 1994.}
- The corollary is from Chance.\footnote{Evers and Chance, 1990.}
- But the key lemma is from Tinker.\cref{fn:TE}
- ...
-
- This solution will work with the package 'hyperref'. See *note
-\footnotemark:: for a simpler solution in the common case of multiple
-authors with the same affiliation.
-
-
-File: latex2e.info, Node: Footnote parameters, Prev: Multiple reference to footnotes, Up: Footnotes
-
-11.8 Footnote parameters
-========================
-
-'\footnoterule'
- Produces the rule separating the main text on a page from the
- page's footnotes. Default dimensions: '0.4pt' thick (or wide), and
- '0.4\columnwidth' long in the standard document classes (except
- 'slides', where it does not appear).
-
-'\footnotesep'
- The height of the strut placed at the beginning of the footnote.
- By default, this is set to the normal strut for '\footnotesize'
- fonts (*note Font sizes::), therefore there is no extra space
- between footnotes. This is '6.65pt' for '10pt', '7.7pt' for
- '11pt', and '8.4pt' for '12pt'.
+ second.\footnotefrom{%
+ First noted in Wilson.\footnote{Second edition only.}}

File: latex2e.info, Node: Definitions, Next: Counters, Prev: Footnotes, Up: Top
@@ -5252,93 +6805,127 @@ File: latex2e.info, Node: \newcommand & \renewcommand, Next: \providecommand,
12.1 '\newcommand' & '\renewcommand'
====================================
-'\newcommand' and '\renewcommand' define and redefine a command,
-respectively. Synopses:
+Synopses, one of:
- \newcommand{\CMD}[NARGS][OPTARGDEFAULT]{DEFN}
- \newcommand*{\CMD}[NARGS][OPTARGDEFAULT]{DEFN}
+ \newcommand{\CMD}{DEFN}
+ \newcommand{\CMD}[NARGS]{DEFN}
+ \newcommand{\CMD}[NARGS][OPTARGDEFAULT]{DEFN}
+ \newcommand*{\CMD}{DEFN}
+ \newcommand*{\CMD}[NARGS]{DEFN}
+ \newcommand*{\CMD}[NARGS][OPTARGDEFAULT]{DEFN}
+
+or one of these.
+
+ \renewcommand{\CMD}[NARGS]{DEFN}
+ \renewcommand{\CMD}[NARGS]{DEFN}
\renewcommand{\CMD}[NARGS][OPTARGDEFAULT]{DEFN}
+ \renewcommand*{\CMD}{DEFN}
+ \renewcommand*{\CMD}[NARGS]{DEFN}
\renewcommand*{\CMD}[NARGS][OPTARGDEFAULT]{DEFN}
- The starred form of these two commands requires that the arguments
-not contain multiple paragraphs of text (not '\long', in plain TeX
-terms).
+ Define or redefine a command. See also the discussion of
+'\DeclareRobustCommand' in *note Class and package commands::. The
+starred form of these two requires that the arguments not contain
+multiple paragraphs of text (in plain TeX terms that it not be '\long').
+
+ These are the parameters:
CMD
- Required; '\CMD' is the command name. For '\newcommand', it must
- not be already defined and must not begin with '\end'. For
- '\renewcommand', it must already be defined.
+
+ Required; the command name. It must begin with a backslash, '\',
+ and must not begin with the four letter string '\end'. For
+ '\newcommand', it must not be already defined. For
+ '\renewcommand', this name must already be defined.
NARGS
Optional; an integer from 0 to 9, specifying the number of
- arguments that the command can take, including any optional
- argument. If this argument is not present, the default is for the
- command to have no arguments. When redefining a command, the new
+ arguments that the command takes, including any optional argument.
+ Omitting this argument is the same as specifying 0, meaning that
+ the command has no arguments. If you redefine a command, the new
version can have a different number of arguments than the old
version.
OPTARGDEFAULT
Optional; if this argument is present then the first argument of
- defined command '\CMD' is optional, with default value
- OPTARGDEFAULT (which may be the empty string). If this argument is
- not present then '\CMD' does not take an optional argument.
-
- That is, if '\CMD' is used with square brackets following, as in
- '\CMD[MYVAL]', then within DEFN the first "positional parameter"
- '#1' expands MYVAL. On the other hand, if '\CMD' is called without
- square brackets following, then within DEFN the positional
- parameter '#1' expands to the default OPTARGDEFAULT. In either
- case, any required arguments will be referred to starting with
- '#2'.
-
- Omitting '[MYVAL]' in a call is different from having the square
- brackets with no contents, as in '[]'. The former results in '#1'
- expanding to OPTARGDEFAULT; the latter results in '#1' expanding to
- the empty string.
+ '\CMD' is optional, with default value OPTARGDEFAULT (which may be
+ the empty string). If this argument is not present then '\CMD'
+ does not take an optional argument.
+
+ That is, if '\CMD' is used with square brackets, as in
+ '\CMD[OPTVAL]{...}...', then within DEFN the parameter '#1' is set
+ to the value of OPTVAL. On the other hand, if '\CMD' is called
+ without the square brackets then within DEFN the parameter '#1' is
+ set to the value of OPTARGDEFAULT. In either case, the required
+ arguments start with '#2'.
+
+ Omitting '[OPTARGDEFAULT]' is different from having the square
+ brackets with no contents, as in '[]'. The former sets '#1' to the
+ value of OPTARGDEFAULT; the latter sets '#1' to the empty string.
DEFN
- The text to be substituted for every occurrence of '\CMD'; the
- positional parameter '#N' in DEFN is replaced by the text of the
- Nth argument.
+ Required; the text to be substituted for every occurrence of
+ '\CMD'. The parameters '#1', '#2', ... '#NARGS' are replaced by
+ the values that you supply when you call the command (or by the
+ default value if there is an optional argument and you don't
+ exercise the option).
TeX ignores spaces in the source following an alphabetic control
sequence, as in '\cmd '. If you actually want a space there, one
-solution is to type '{}' after the command ('\cmd{} '; another solution
-is to use an explicit control space ('\cmd\ ').
+solution is to type '{}' after the command ('\cmd{} ', and another
+solution is to use an explicit control space ('\cmd\ ').
A simple example of defining a new command: '\newcommand{\RS}{Robin
-Smith}' results in '\RS' being replaced by the longer text.
+Smith}' results in '\RS' being replaced by the longer text. Redefining
+an existing command is similar: '\renewcommand{\qedsymbol}{{\small
+QED}}'.
- Redefining an existing command is similar:
-'\renewcommand{\qedsymbol}{{\small QED}}'.
+ If you try to define a command and the name has already been used
+then you get something like 'LaTeX Error: Command \fred already defined.
+Or name \end... illegal, see p.192 of the manual'. If you try to
+redefine a command and the name has not yet been used then you get
+something like 'LaTeX Error: \hank undefined'.
- Here's a command definition with one required argument:
+ Here the first command definition has no arguments, and the second
+has one required argument.
+ \newcommand{\student}{Ms~O'Leary}
\newcommand{\defref}[1]{Definition~\ref{#1}}
-Then, '\defref{def:basis}' expands to 'Definition~\ref{def:basis}',
-which will ultimately expand to something like 'Definition~3.14'.
+Use the first as in 'I highly recommend \student{} to you'. The second
+has a variable, so that '\defref{def:basis}' expands to
+'Definition~\ref{def:basis}', which ultimately expands to something like
+'Definition~3.14'.
- An example with two required arguments: '\newcommand{\nbym}[2]{$#1
-\times #2$}' is invoked as '\nbym{2}{k}'.
+ Similarly, but with two required arguments:
+'\newcommand{\nbym}[2]{$#1 \times #2$}' is invoked as '\nbym{2}{k}'.
- An example with an optional argument:
+ This example has an optional argument.
\newcommand{\salutation}[1][Sir or Madam]{Dear #1:}
-Then, '\salutation' gives 'Dear Sir or Madam:' while '\salutation[John]'
+Then '\salutation' gives 'Dear Sir or Madam:' while '\salutation[John]'
gives 'Dear John:'. And '\salutation[]' gives 'Dear :'.
+ This example has an optional argument and two required arguments.
+
+ \newcommand{\lawyers}[3][company]{#2, #3, and~#1}
+ I employ \lawyers[Howe]{Dewey}{Cheatem}.
+
+The output is 'I employ Dewey, Cheatem, and Howe'. The optional
+argument, the 'Howe', is associated with '#1', while 'Dewey' and
+'Cheatem' are associated with '#2' and '#3'. Because of the optional
+argument, '\lawyers{Dewey}{Cheatem}' will give the output 'I employ
+Dewey, Cheatem, and company'.
+
The braces around DEFN do not define a group, that is, they do not
-delimit the scope of the result of expanding DEFN. So
-'\newcommand{\shipname}[1]{\it #1}' is problematic; in this sentence,
+delimit the scope of the result of expanding DEFN. For example, with
+'\newcommand{\shipname}[1]{\it #1}', in this sentence,
The \shipname{Monitor} met the \shipname{Merrimac}.
-the words 'met the' would incorrectly be in italics. Another pair of
-braces in the definition is needed, like this:
-'\newcommand{\shipname}[1]{{\it #1}}'. Those braces are part of the
-definition and thus do define a group.
+the words 'met the' would incorrectly be in italics. The solution is to
+put another pair of braces inside the definition:
+'\newcommand{\shipname}[1]{{\it #1}}'.

File: latex2e.info, Node: \providecommand, Next: \newcounter, Prev: \newcommand & \renewcommand, Up: Definitions
@@ -5346,17 +6933,30 @@ File: latex2e.info, Node: \providecommand, Next: \newcounter, Prev: \newcomma
12.2 '\providecommand'
======================
-Defines a command, as long as no command of this name already exists.
-Synopses:
+Synopses, one of:
+ \providecommand{CMD}{DEFN}
+ \providecommand{CMD}[NARGS]{DEFN}
\providecommand{CMD}[NARGS][OPTARGDEFAULT]{DEFN}
+ \providecommand*{CMD}{DEFN}
+ \providecommand*{CMD}[NARGS]{DEFN}
\providecommand*{CMD}[NARGS][OPTARGDEFAULT]{DEFN}
- If no command of this name already exists then this has the same
-effect as '\newcommand' (*note \newcommand & \renewcommand::). If a
-command of this name already exists then this definition does nothing.
-This is particularly useful in a style file, or other file that may be
-loaded more than once.
+ Defines a command, as long as no command of this name already exists.
+If no command of this name already exists then this has the same effect
+as '\newcommand'. If a command of this name already exists then this
+definition does nothing. This is particularly useful in a file that may
+be loaded more than once, such as a style file. *Note \newcommand &
+\renewcommand:: for the description of the arguments.
+
+ This example
+
+ \providecommand{\myaffiliation}{Saint Michael's College}
+ \providecommand{\myaffiliation}{Saint Michael's College}
+ From \myaffiliation.
+
+outputs 'From Saint Michael's College'. Unlike '\newcommand', the
+repeated use of '\providecommand' does not give an error.

File: latex2e.info, Node: \newcounter, Next: \newlength, Prev: \providecommand, Up: Definitions
@@ -5369,57 +6969,93 @@ Synopsis, one of:
\newcounter{COUNTERNAME}
\newcounter{COUNTERNAME}[SUPERCOUNTER]
- Globally defines a new counter named COUNTERNAME and initialize the
-new counter to zero.
+ Globally defines a new counter named COUNTERNAME and initialize it to
+zero (*note Counters::).
- The name COUNTERNAME must consists of letters only, and does not
-begin with a backslash. This name must not already be in use by another
+ The name COUNTERNAME must consist of letters only. It does not begin
+with a backslash. This name must not already be in use by another
counter.
- When you use the optional argument '[SUPERCOUNTER]' then COUNTERNAME
-will be numbered within, or subsidiary to, the existing counter
-SUPERCOUNTER. For example, ordinarily 'subsection' is numbered within
-'section' so that any time SUPERCOUNTER is incremented with
-'\stepcounter' (*note \stepcounter::) or '\refstepcounter' (*note
-\refstepcounter::) then COUNTERNAME is reset to zero.
+ When you use the optional argument '[SUPERCOUNTER]' then the counter
+COUNTERNAME will be reset to zero whenever SUPERCOUNTER is incremented.
+For example, ordinarily 'subsection' is numbered within 'section' so
+that any time you increment SECTION, either with '\stepcounter' (*note
+\stepcounter::) or '\refstepcounter' (*note \refstepcounter::), then
+LaTeX will reset SUBSECTION to zero.
+
+ This example
+
+ \newcounter{asuper} \setcounter{asuper}{1}
+ \newcounter{asub}[asuper] \setcounter{asub}{3} % Note `asuper'
+ The value of asuper is \arabic{asuper} and of asub is \arabic{asub}.
+ \stepcounter{asuper}
+ Now asuper is \arabic{asuper} while asub is \arabic{asub}.
- *Note Counters::, for more information about counters.
+ produces 'The value of asuper is 1 and that of asub is 3' and 'Now
+asuper is 2 while asub is 0'.
+
+ If the counter already exists, for instance by entering 'asuper'
+twice, then you get something like 'LaTeX Error: Command \c@asuper
+already defined. Or name \end... illegal, see p.192 of the manual.'.
+
+ If you use the optional argument then the super counter must already
+exist. Entering '\newcounter{jh}[lh]' when 'lh' is not a defined
+counter will get you 'LaTeX Error: No counter 'lh' defined.'

File: latex2e.info, Node: \newlength, Next: \newsavebox, Prev: \newcounter, Up: Definitions
-12.4 '\newlength': Allocating a length
-======================================
+12.4 '\newlength'
+=================
+
+Synopsis:
-Allocate a new "length" register. Synopsis:
+ \newlength{ARG}
- \newlength{\ARG}
+ Allocate a new length register (*note Lengths::). The required
+argument ARG must begin with a backslash, '\'. The new register holds
+rubber lengths such as '72.27pt' or '1in plus.2in minus.1in' (a LaTeX
+length register is what plain TeX calls a 'skip' register). The initial
+value is zero. The control sequence '\ARG' must not be already defined.
- This command takes one required argument, which must begin with a
-backslash ('\'). It creates a new length register named '\ARG', which
-is a place to hold (rubber) lengths such as '1in plus.2in minus.1in'
-(what plain TeX calls a 'skip' register). The register gets an initial
-value of zero. The control sequence '\ARG' must not already be defined.
+ An example:
- *Note Lengths::, for more about lengths.
+ \newlength{\graphichgt}
+
+ If you forget the backslash then you get 'Missing control sequence
+inserted'. If the command sequence already exists then you get
+something like 'LaTeX Error: Command \graphichgt already defined. Or
+name \end... illegal, see p.192 of the manual'.

File: latex2e.info, Node: \newsavebox, Next: \newenvironment & \renewenvironment, Prev: \newlength, Up: Definitions
-12.5 '\newsavebox': Allocating a box
-====================================
+12.5 '\newsavebox'
+==================
-Allocate a "bin" for holding a box. Synopsis:
+Synopsis:
- \newsavebox{\CMD}
+ \newsavebox{CMD}
- Defines '\CMD' to refer to a new bin for storing boxes. Such a box
-is for holding typeset material, to use multiple times (*note Boxes::)
-or to measure or manipulate. The name '\CMD' must start with a
-backslash ('\'), and must not be already defined.
+ Define '\CMD' to refer to a new "bin" for storing boxes. Such a box
+is for holding typeset material, to use multiple times or to measure or
+manipulate (*note Boxes::). The required bin name 'CMD' must start with
+a backslash, '\', and must not already be defined. This command is
+fragile (*note \protect::).
- The allocation of a box is global. This command is fragile (*note
-\protect::).
+ The first line here sets you up to save the material for later use.
+
+ \newsavebox{\logobox}
+ \savebox{\logobox}{LoGo}
+ Our logo is \usebox{\logobox}.
+
+The output is 'Our logo is LoGo'.
+
+ If there is an already defined bin then you get something like 'LaTeX
+Error: Command \logobox already defined. Or name \end... illegal, see
+p.192 of the manual'.
+
+ The allocation of a box is global.

File: latex2e.info, Node: \newenvironment & \renewenvironment, Next: \newtheorem, Prev: \newsavebox, Up: Definitions
@@ -5427,21 +7063,34 @@ File: latex2e.info, Node: \newenvironment & \renewenvironment, Next: \newtheor
12.6 '\newenvironment' & '\renewenvironment'
============================================
-These commands define or redefine an environment ENV, that is,
-'\begin{ENV} BODY \end{ENV}'. Synopses:
+Synopses, one of:
- \newenvironment{ENV}[NARGS][OPTARGDEFAULT]{BEGDEFN}{ENDDEFN}
- \newenvironment*{ENV}[NARGS][OPTARGDEFAULT]{BEGDEFN}{ENDDEFN}
- \renewenvironment{ENV}[NARGS][OPTARGDEFAULT]{BEGDEFN}{ENDDEFN}
- \renewenvironment*{ENV}[NARGS][OPTARGDEFAULT]{BEGDEFN}{ENDDEFN}
+ \newenvironment{ENV}{BEGDEF}{ENDDEF}
+ \newenvironment{ENV}[NARGS]{BEGDEF}{ENDDEF}
+ \newenvironment{ENV}[NARGS][OPTARGDEFAULT]{BEGDEF}{ENDDEF}
+ \newenvironment*{ENV}{BEGDEF}{ENDDEF}
+ \newenvironment*{ENV}[NARGS]{BEGDEF}{ENDDEF}
+ \newenvironment*{ENV}[NARGS][OPTARGDEFAULT]{BEGDEF}{ENDDEF}
+
+or one of these.
+
+ \renewenvironment{ENV}{BEGDEF}{ENDDEF}
+ \renewenvironment{ENV}[NARGS]{BEGDEF}{ENDDEF}
+ \renewenvironment{ENV}[NARGS][OPTARGDEFAULT]{BEGDEF}{ENDDEF}
+ \renewenvironment*{ENV}{BEGDEF}{ENDDEF}
+ \renewenvironment*{ENV}[NARGS]{BEGDEF}{ENDDEF}
+ \renewenvironment*{ENV}[NARGS][OPTARGDEFAULT]{BEGDEF}{ENDDEF}
+
+ Define or redefine the environment ENV, that is, create the construct
+'\begin{ENV} ... BODY ... \end{ENV}'.
The starred form of these commands requires that the arguments not
-contain multiple paragraphs of text. The body of these environments can
-still contain multiple paragraphs.
+contain multiple paragraphs of text. However, the body of these
+environments can contain multiple paragraphs.
ENV
Required; the environment name. It consists only of letters or the
- '*' character, and thus does not begin with backslash ('\'). It
+ '*' character, and thus does not begin with backslash, '\'. It
must not begin with the string 'end'. For '\newenvironment', the
name ENV must not be the name of an already existing environment,
and also the command '\ENV' must be undefined. For
@@ -5450,51 +7099,57 @@ ENV
NARGS
Optional; an integer from 0 to 9 denoting the number of arguments
- of that the environment will take. When the environment is used
- these arguments appear after the '\begin', as in
- '\begin{ENV}{ARG1}...{ARGN}'. If this argument is not present then
- the default is for the environment to have no arguments. When
- redefining an environment, the new version can have a different
- number of arguments than the old version.
+ of that the environment takes. When you use the environment these
+ arguments appear after the '\begin', as in '\begin{ENV}{ARG1} ...
+ {ARGN}'. Omitting this is equivalent to setting it to 0; the
+ environment will have no arguments. When redefining an
+ environment, the new version can have a different number of
+ arguments than the old version.
OPTARGDEFAULT
- Optional; if this argument is present then the first argument of
- the defined environment is optional, with default value
- OPTARGDEFAULT (which may be the empty string). If this argument is
- not present then the environment does not take an optional
- argument.
-
- That is, when '[OPTARGDEFAULT]' is present in the environment
- definition, if '\begin{ENV}' is used with square brackets
- following, as in '\begin{ENV}[MYVAL]', then, within BEGDEFN, the
- positional parameter '#1' expands to MYVAL. If '\begin{ENV}' is
- called without square brackets following, then, within within
- BEGDEFN, the positional parameter '#1' expands to the default
- OPTARGDEFAULT. In either case, any required arguments will be
- referred to starting with '#2'.
-
- Omitting '[MYVAL]' in the call is different from having the square
+ Optional; if this is present then the first argument of the defined
+ environment is optional, with default value OPTARGDEFAULT (which
+ may be the empty string). If this is not in the definition then
+ the environment does not take an optional argument.
+
+ That is, when OPTARGDEFAULT is present in the definition of the
+ environment then you can start the environment with square
+ brackets, as in '\begin{ENV}[OPTVAL]{...} ... \end{ENV}'. In this
+ case, within BEGDEFN the parameter '#1' is set to the value of
+ OPTVAL. If you call '\begin{ENV}' without square brackets, then
+ within BEGDEFN the parameter '#1' is set to the value of the
+ default OPTARGDEFAULT. In either case, any required arguments
+ start with '#2'.
+
+ Omitting '[MYVAL]' in the call is different than having the square
brackets with no contents, as in '[]'. The former results in '#1'
expanding to OPTARGDEFAULT; the latter results in '#1' expanding to
the empty string.
-BEGDEFN
+BEGDEF
Required; the text expanded at every occurrence of '\begin{ENV}'.
- Within BEGDEF, the Nth positional parameter (i.e., '#N') is
- replaced by the text of the Nth argument.
+ Within BEGDEF, the parameters '#1', '#2', ... '#NARGS', are
+ replaced by the values that you supply when you call the
+ environment; see the examples below.
-ENDDEFN
+ENDDEF
Required; the text expanded at every occurrence of '\end{ENV}'.
- This may not contain any positional parameters, so '#N' cannot be
- used here (but see the final example below).
+ This may not contain any parameters, that is, you cannot use '#1',
+ '#2', etc., here (but see the final example below).
- All environments, that is to say the BEGDEFN code, the environment
-body and the ENDDEFN code, are processed within a group. Thus, in the
+ All environments, that is to say the BEGDEF code, the environment
+body, and the ENDDEF code, are processed within a group. Thus, in the
first example below, the effect of the '\small' is limited to the quote
and does not extend to material following the environment.
+ If you try to define an environment and the name has already been
+used then you get something like 'LaTeX Error: Command \fred already
+defined. Or name \end... illegal, see p.192 of the manual'. If you try
+to redefine an environment and the name has not yet been used then you
+get something like 'LaTeX Error: Environment hank undefined.'.
+
This example gives an environment like LaTeX's 'quotation' except
-that it will be set in smaller type:
+that it will be set in smaller type.
\newenvironment{smallquote}{%
\small\begin{quotation}
@@ -5502,8 +7157,16 @@ that it will be set in smaller type:
\end{quotation}
}
- This one shows the use of arguments; it gives a quotation environment
-that cites the author:
+ This has an argument, which is set in boldface at the start of a
+paragraph.
+
+ \newenvironment{point}[1]{%
+ \noindent\textbf{#1}
+ }{%
+ }
+
+ This one shows the use of a optional argument; it gives a quotation
+environment that cites the author.
\newenvironment{citequote}[1][Shakespeare]{%
\begin{quotation}
@@ -5513,14 +7176,14 @@ that cites the author:
}
The author's name is optional, and defaults to 'Shakespeare'. In the
-document, use the environment like this:
+document, use the environment like this.
\begin{citequote}[Lincoln]
...
\end{citequote}
The final example shows how to save the value of an argument to use
-in ENDDEFN, in this case in a box (*note \sbox::):
+in ENDDEF, in this case in a box (*note \sbox & \savebox::).
\newsavebox{\quoteauthor}
\newenvironment{citequote}[1][Shakespeare]{%
@@ -5537,28 +7200,27 @@ File: latex2e.info, Node: \newtheorem, Next: \newfont, Prev: \newenvironment
12.7 '\newtheorem'
==================
-Define a new theorem-like environment. Synopses:
+Synopses:
\newtheorem{NAME}{TITLE}
\newtheorem{NAME}{TITLE}[NUMBERED_WITHIN]
\newtheorem{NAME}[NUMBERED_LIKE]{TITLE}
- Using the first form, '\newtheorem{NAME}{TITLE}' creates an
-environment that will be labelled with TITLE. See the first example
-below.
+ Define a new theorem-like environment. You can specify one of
+NUMBERED_WITHIN and NUMBERED_LIKE, or neither, but not both.
+
+ The first form, '\newtheorem{NAME}{TITLE}', creates an environment
+that will be labelled with TITLE; see the first example below.
- The second form '\newtheorem{NAME}{TITLE}[NUMBERED_WITHIN]' creates
+ The second form, '\newtheorem{NAME}{TITLE}[NUMBERED_WITHIN]', creates
an environment whose counter is subordinate to the existing counter
-NUMBERED_WITHIN (its counter will be reset when NUMBERED_WITHIN is
-reset).
+NUMBERED_WITHIN, so this counter will be reset when NUMBERED_WITHIN is
+reset. See the second example below.
The third form '\newtheorem{NAME}[NUMBERED_LIKE]{TITLE}', with
-optional argument between the two required arguments, will create an
+optional argument between the two required arguments, creates an
environment whose counter will share the previously defined counter
-NUMBERED_LIKE.
-
- You can specify one of NUMBERED_WITHIN and NUMBERED_LIKE, or neither,
-but not both.
+NUMBERED_LIKE. See the third example.
This command creates a counter named NAME. In addition, unless the
optional argument NUMBERED_LIKE is used, inside of the theorem-like
@@ -5570,13 +7232,14 @@ environment the current '\ref' value will be that of
Arguments:
NAME
- The name of the environment. It must not begin with a backslash
- ('\'). It must not be the name of an existing environment; indeed,
- the command name '\NAME' must not already be defined as anything.
+ The name of the environment. It is a string of letters. It must
+ not begin with a backslash, '\'. It must not be the name of an
+ existing environment, and the command name '\NAME' must not already
+ be defined.
TITLE
- The text printed at the beginning of the environment, before the
- number. For example, 'Theorem'.
+ The text to be printed at the beginning of the environment, before
+ the number. For example, 'Theorem'.
NUMBERED_WITHIN
Optional; the name of an already defined counter, usually a
@@ -5608,9 +7271,9 @@ results in 'Definition 1' and 'Definition 2' in the output.
Second def
\end{defn}
- Because the next example specifies the optional argument
-NUMBERED_WITHIN to '\newtheorem' as 'section', the example, with the
-same document body, gives 'Definition 1.1' and 'Definition 2.1'.
+ This example has the same document body as the prior one. But here
+'\newtheorem''s optional argument NUMBERED_WITHIN is given as 'section',
+so the output is like 'Definition 1.1' and 'Definition 2.1'.
\newtheorem{defn}{Definition}[section]
\begin{document}
@@ -5649,35 +7312,32 @@ and 'Definition 2.2'.

File: latex2e.info, Node: \newfont, Next: \protect, Prev: \newtheorem, Up: Definitions
-12.8 '\newfont': Define a new font (obsolete)
-=============================================
+12.8 '\newfont'
+===============
-'\newfont', now obsolete, defines a command that will switch fonts.
-Synopsis:
+This command is obsolete. This description is here only to help with
+old documents. New documents should define fonts in families through
+the New Font Selection Scheme which allows you to, for example,
+associate a boldface with a roman (*note Fonts::).
- \newfont{\CMD}{FONT DESCRIPTION}
+ Synopsis:
- This defines a control sequence '\CMD' that will change the current
-font. LaTeX will look on your system for a file named 'FONTNAME.tfm'.
-The control sequence must must not already be defined. It must begin
-with a backslash ('\').
+ \newfont{\CMD}{FONT DESCRIPTION}
- This command is obsolete. It is a low-level command for setting up
-an individual font. Today fonts are almost always defined in families
-(which allows you to, for example, associate a boldface with a roman)
-through the so-called "New Font Selection Scheme", either by using '.fd'
-files or through the use of an engine that can access system fonts such
-as XeLaTeX (*note TeX engines::).
+ Define a command '\CMD' that will change the current font. The
+control sequence must must not already be defined. It must begin with a
+backslash, '\'.
- But since it is part of LaTeX, here is an explanation: the FONT
-DESCRIPTION consists of a FONTNAME and an optional "at clause"; this can
-have the form either 'at DIMEN' or 'scaled FACTOR', where a FACTOR of
-'1000' means no scaling. For LaTeX's purposes, all this does is scale
-all the character and other font dimensions relative to the font's
-design size, which is a value defined in the '.tfm' file.
+ The FONT DESCRIPTION consists of a FONTNAME and an optional "at
+clause". LaTeX will look on your system for a file named
+'FONTNAME.tfm'. The at clause can have the form either 'at DIMEN' or
+'scaled FACTOR', where a FACTOR of '1000' means no scaling. For LaTeX's
+purposes, all this does is scale all the character and other font
+dimensions relative to the font's design size, which is a value defined
+in the '.tfm' file.
- This example defines two equivalent fonts and typesets a few
-characters in each:
+ This defines two equivalent fonts and typesets a few characters in
+each.
\newfont{\testfontat}{cmb10 at 11pt}
\newfont{\testfontscaled}{cmb10 scaled 1100}
@@ -5749,7 +7409,7 @@ Synopsis:
\ignorespaces
- or
+or
\ignorespacesafterend
@@ -5767,11 +7427,13 @@ the question text.
\newcommand{\points}[1]{\makebox[0pt]{\makebox[10em][l]{#1~pts}}
\begin{enumerate}
\item\points{10}no extra space output here
- \item\points{15} extra space output between the number and the word `extra'
+ \item\points{15} extra space between the number and the `extra'
\end{enumerate}
- The solution is to change to
-'\newcommand{\points}[1]{\makebox[0pt]{\makebox[10em][l]{#1~pts}}\ignorespaces}'.
+The solution is to change to this.
+
+ \newcommand{\points}[1]{%
+ \makebox[0pt]{\makebox[10em][l]{#1~pts}}\ignorespaces}
A second example shows spaces being removed from the front of text.
The commands below allow a user to uniformly attach a title to names.
@@ -5780,14 +7442,14 @@ But, as given, if a title accidentally starts with a space then
\makeatletter
\newcommand{\honorific}[1]{\def\@honorific{#1}} % remember title
- \newcommand{\fullname}[1]{\@honorific~#1} % recall title; put before name
+ \newcommand{\fullname}[1]{\@honorific~#1} % put title before name
\makeatother
\begin{tabular}{|l|}
\honorific{Mr/Ms} \fullname{Jones} \\ % no extra space here
\honorific{ Mr/Ms} \fullname{Jones} % extra space before title
\end{tabular}
- To fix this, change to
+To fix this, change to
'\newcommand{\fullname}[1]{\ignorespaces\@honorific~#1}'.
The '\ignorespaces' is also often used in a '\newenvironment' at the
@@ -5841,18 +7503,20 @@ a minipage (*note minipage::). The counters 'enumi' through 'enumiv'
are used in the 'enumerate' environment, for up to four levels of
nesting (*note enumerate::).
+ Counters can have any integer value but they are typically positive.
+
New counters are created with '\newcounter'. *Note \newcounter::.
* Menu:
* \alph \Alph \arabic \roman \Roman \fnsymbol:: Print value of a counter.
-* \usecounter:: Use a specified counter in a list environment.
-* \value:: Use the value of a counter in an expression.
-* \setcounter:: Set the value of a counter.
-* \addtocounter:: Add a quantity to a counter.
-* \refstepcounter:: Add to a counter.
-* \stepcounter:: Add to a counter, resetting subsidiary counters.
-* \day \month \year:: Numeric date values.
+* \usecounter:: Use a specified counter in a list environment.
+* \value:: Use the value of a counter in an expression.
+* \setcounter:: Set the value of a counter.
+* \addtocounter:: Add a quantity to a counter.
+* \refstepcounter:: Add to a counter.
+* \stepcounter:: Add to a counter, resetting subsidiary counters.
+* \day & \month & \year:: Numeric date values.

File: latex2e.info, Node: \alph \Alph \arabic \roman \Roman \fnsymbol, Next: \usecounter, Up: Counters
@@ -5862,67 +7526,76 @@ File: latex2e.info, Node: \alph \Alph \arabic \roman \Roman \fnsymbol, Next: \
Print the value of a counter, in a specified style. For instance, if
the counter COUNTER has the value 1 then a '\alph{COUNTER}' in your
-source will result in a lower case letter a appearing in the output.
+source will result in a lowercase letter a appearing in the output.
All of these commands take a single counter as an argument, for
instance, '\alph{enumi}'. Note that the counter name does not start
with a backslash.
'\alph{COUNTER}'
- Print the value of COUNTER in lowercase letters: 'a', 'b', ...
+ Print the value of COUNTER in lowercase letters: 'a', 'b', ... If
+ the counter's value is less than 1 or more than 26 then you get
+ 'LaTeX Error: Counter too large.'
'\Alph{COUNTER}'
- Print in uppercase letters: 'A', 'B', ...
+ Print in uppercase letters: 'A', 'B', ... If the counter's value
+ is less than 1 or more than 26 then you get 'LaTeX Error: Counter
+ too large.'
'\arabic{COUNTER}'
- Print in Arabic numbers: '1', '2', ...
+ Print in Arabic numbers such as '5' or '-2'.
'\roman{COUNTER}'
- Print in lowercase roman numerals: 'i', 'ii', ...
+ Print in lowercase roman numerals: 'i', 'ii', ... If the counter's
+ value is less than 1 then you get no warning or error but LaTeX
+ does not print anything in the output.
'\Roman{COUNTER}'
- Print in uppercase roman numerals: 'I', 'II', ...
+ Print in uppercase roman numerals: 'I', 'II', ... If the counter's
+ value is less than 1 then you get no warning or error but LaTeX
+ does not print anything in the output.
'\fnsymbol{COUNTER}'
- Prints the value of COUNTER in a specific sequence of nine symbols
- (conventionally used for labeling footnotes). The value of COUNTER
- must be between 1 and 9, inclusive.
+ Prints the value of COUNTER using a sequence of nine symbols that
+ are traditionally used for labeling footnotes. The value of
+ COUNTER should be between 1 and 9, inclusive. If the counter's
+ value is less than 0 or more than 9 then you get 'LaTeX Error:
+ Counter too large', while if it is 0 then you get no error or
+ warning but LaTeX does not output anything.
Here are the symbols:
- Name Command Equivalent Unicode
- symbol and/or numeric
- code point
- ---------------------------------------------------------------------------
- asterisk '\ast' *
- dagger '\dagger' U+2020
- ddagger '\ddagger' U+2021
- section-sign '\S' U+00A7
- paragraph-sign '\P' U+00B6
- double-vert '\parallel' U+2016
- double-asterisk '\ast\ast' **
- double-dagger '\dagger\dagger' U+2020U+2020
- double-ddagger '\ddagger\ddagger' U+2021U+2021
+ Number Name Command Symbol
+ -----------------------------------------------------------------------------
+ 1 asterisk '\ast' *
+ 2 dagger '\dagger' U+2020
+ 3 ddagger '\ddagger' U+2021
+ 4 section-sign '\S' U+00A7
+ 5 paragraph-sign '\P' U+00B6
+ 6 double-vert '\parallel' U+2016
+ 7 double-asterisk '\ast\ast' **
+ 8 double-dagger '\dagger\dagger' U+2020U+2020
+ 9 double-ddagger '\ddagger\ddagger' U+2021U+2021

File: latex2e.info, Node: \usecounter, Next: \value, Prev: \alph \Alph \arabic \roman \Roman \fnsymbol, Up: Counters
-13.2 '\usecounter{COUNTER}'
-===========================
+13.2 '\usecounter'
+==================
Synopsis:
\usecounter{COUNTER}
- In the 'list' environment, when used in the second argument, this
-command sets up COUNTER to number the list items. It initializes
-COUNTER to zero, and arranges that when '\item' is called without its
-optional argument then COUNTER is incremented by '\refstepcounter',
-making its value be the current 'ref' value. This command is fragile
-(*note \protect::).
+ Used in the second argument of the 'list' environment (*note list::),
+this declares that list items will be numbered by COUNTER. It
+initializes COUNTER to zero, and arranges that when '\item' is called
+without its optional argument then COUNTER is incremented by
+'\refstepcounter', making its value be the current 'ref' value (*note
+\ref::). This command is fragile (*note \protect::).
- Put in the preamble, this makes a new list environment enumerated
-with TESTCOUNTER:
+ Put in the document preamble, this example makes a new list
+environment enumerated with TESTCOUNTER:
\newcounter{testcounter}
\newenvironment{test}{%
@@ -5936,20 +7609,15 @@ with TESTCOUNTER:

File: latex2e.info, Node: \value, Next: \setcounter, Prev: \usecounter, Up: Counters
-13.3 '\value{COUNTER}'
-======================
+13.3 '\value'
+=============
Synopsis:
\value{COUNTER}
- This command expands to the value of COUNTER. It is often used in
-'\setcounter' or '\addtocounter', but '\value' can be used anywhere that
-LaTeX expects a number. It must not be preceded by '\protect' (*note
-\protect::).
-
- The '\value' command is not used for typesetting the value of the
-counter. *Note \alph \Alph \arabic \roman \Roman \fnsymbol::.
+ Expands to the value of the counter COUNTER. (Note that the name of
+a counter does not begin with a backslash.)
This example outputs 'Test counter is 6. Other counter is 5.'.
@@ -5960,6 +7628,15 @@ counter. *Note \alph \Alph \arabic \roman \Roman \fnsymbol::.
Test counter is \arabic{test}.
Other counter is \arabic{other}.
+ The '\value' command is not used for typesetting the value of the
+counter. For that, see *note \alph \Alph \arabic \roman \Roman
+\fnsymbol::.
+
+ It is often used in '\setcounter' or '\addtocounter' but '\value' can
+be used anywhere that LaTeX expects a number, such as in
+'\hspace{\value{foo}\parindent}'. It must not be preceded by '\protect'
+(*note \protect::).
+
This example inserts '\hspace{4\parindent}'.
\setcounter{myctr}{3} \addtocounter{myctr}{1}
@@ -5968,30 +7645,36 @@ counter. *Note \alph \Alph \arabic \roman \Roman \fnsymbol::.

File: latex2e.info, Node: \setcounter, Next: \addtocounter, Prev: \value, Up: Counters
-13.4 '\setcounter{COUNTER}{VALUE}'
-==================================
+13.4 '\setcounter'
+==================
Synopsis:
\setcounter{COUNTER}{VALUE}
- The '\setcounter' command globally sets the value of COUNTER to the
-VALUE argument. Note that the counter name does not start with a
-backslash.
+ Globally set the counter COUNTER to have the value of the VALUE
+argument, which must be an integer. Thus, you can set a counter's value
+as '\setcounter{section}{5}'. Note that the counter name does not start
+with a backslash.
- In this example the section value appears as 'V'.
+ In this example if the counter 'theorem' has value 12 then the second
+line will print 'XII'.
- \setcounter{section}{5}
- Here it is in Roman: \Roman{section}.
+ \setcounter{exercise}{\value{theorem}}
+ Here it is in Roman: \Roman{exercise}.

File: latex2e.info, Node: \addtocounter, Next: \refstepcounter, Prev: \setcounter, Up: Counters
-13.5 '\addtocounter{COUNTER}{VALUE}'
-====================================
+13.5 '\addtocounter'
+====================
+
+Synopsis:
+
+ \addtocounter{COUNTER}{VALUE
-The '\addtocounter' command globally increments COUNTER by the amount
-specified by the VALUE argument, which may be negative.
+ Globally increment COUNTER by the amount specified by the VALUE
+argument, which may be negative.
In this example the section value appears as 'VII'.
@@ -6002,12 +7685,16 @@ specified by the VALUE argument, which may be negative.

File: latex2e.info, Node: \refstepcounter, Next: \stepcounter, Prev: \addtocounter, Up: Counters
-13.6 '\refstepcounter{COUNTER}'
-===============================
+13.6 '\refstepcounter'
+======================
+
+Synopsis:
-The '\refstepcounter' command works in the same way as '\stepcounter'
-(*note \stepcounter::): it globally increments the value of COUNTER by
-one and resets the value of any counter numbered within it. (For the
+ \refstepcounter{COUNTER}
+
+ Globally increments the value of COUNTER by one, as does
+'\stepcounter' (*note \stepcounter::). The difference is that this
+command resets the value of any counter numbered within it. (For the
definition of "counters numbered within", *note \newcounter::.)
In addition, this command also defines the current '\ref' value to be
@@ -6017,28 +7704,44 @@ the result of '\thecounter'.
locally, i.e., inside the current group.

-File: latex2e.info, Node: \stepcounter, Next: \day \month \year, Prev: \refstepcounter, Up: Counters
+File: latex2e.info, Node: \stepcounter, Next: \day & \month & \year, Prev: \refstepcounter, Up: Counters
-13.7 '\stepcounter{COUNTER}'
-============================
+13.7 '\stepcounter'
+===================
+
+Synopsis:
+
+ \stepcounter{COUNTER}
-The '\stepcounter' command globally adds one to COUNTER and resets all
-counters numbered within it. (For the definition of "counters numbered
-within", *note \newcounter::.)
+ Globally adds one to COUNTER and resets all counters numbered within
+it. (For the definition of "counters numbered within", *note
+\newcounter::.)
+
+ This command differs from '\refstepcounter' in that this one does not
+influence references -- it does not define the current '\ref' value to
+be the result of '\thecounter' (*note \refstepcounter::).

-File: latex2e.info, Node: \day \month \year, Prev: \stepcounter, Up: Counters
+File: latex2e.info, Node: \day & \month & \year, Prev: \stepcounter, Up: Counters
-13.8 '\day \month \year': Predefined counters
-=============================================
+13.8 '\day' & '\month' & '\year'
+================================
+
+LaTeX defines the counter '\day' for the day of the month (nominally
+with value between 1 and 31), '\month' for the month of the year
+(nominally with value between 1 and 12), and year '\year'. When TeX
+starts up, they are set from the current values on the system. The
+related command '\today' produces a string representing the current day
+(*note \today::).
-LaTeX defines counters for the day of the month ('\day', 1-31), month of
-the year ('\month', 1-12), and year ('\year', Common Era). When TeX
-starts up, they are set to the current values on the system where TeX is
-running. They are not updated as the job progresses.
+ They counters are not updated as the job progresses so in principle
+they could be incorrect by the end. In addition, TeX does no sanity
+check:
- The related command '\today' produces a string representing the
-current day (*note \today::).
+ \day=-2 \month=13 \year=-4 \today
+
+gives no error or warning and results in the output '-2, -4' (the bogus
+month value produces no output).

File: latex2e.info, Node: Lengths, Next: Making paragraphs, Prev: Counters, Up: Top
@@ -6049,25 +7752,89 @@ File: latex2e.info, Node: Lengths, Next: Making paragraphs, Prev: Counters,
A "length" is a measure of distance. Many LaTeX commands take a length
as an argument.
+ This shows a box of the given length.
+
+ \newcommand{\blackbar}[1]{\rule{#1}{10pt}} % make a bar
+ \newcommand{\showhbox}[2]{\fboxsep=0pt\fbox{\hbox to #1{#2}}} % box it
+ XXX\showhbox{100pt}{\blackbar{100pt}}YYY
+
+It produces a black bar 100 points long between 'XXX' and 'YYY'.
+
Lengths come in two types. A "rigid length" (what Plain TeX calls a
-"dimen") such as '10pt' cannot contain a 'plus' or 'minus' component. A
-"rubber length" (what Plain TeX calls a "skip") can contain those, as
-with '1cm plus0.05cm minus0.01cm'. These give the ability to stretch or
-shrink; the length in the prior sentence could appear in the output as
-long as 1.05 cm or as short as 0.99 cm, depending on what TeX's
-typesetting algorithm finds optimum.
+"dimen") such as '10pt' does not contain a 'plus' or 'minus' component.
+The above example shows a rigid length. A "rubber length" (what Plain
+TeX calls a "skip") can contain those components, as with '1cm
+plus0.05cm minus0.01cm'. Here the '1cm' is the "natural length" while
+the other two, the 'plus' and 'minus' components, allow the length to
+stretch or shrink.
+
+ Shrinking is simpler: with '1cm minus 0.05cm', the natural length is
+1cm but if smaller is needed then TeX can shrink it down as far as
+0.95cm. Beyond that, TeX refuses to shrink any more. Thus, below the
+first one works fine, producing a space of 98 points between the two
+bars.
+
+ XXX\showhbox{300pt}{%
+ \blackbar{101pt}\hspace{100pt minus 2pt}\blackbar{101pt}}YYY
+
+ XXX\showhbox{300pt}{%
+ \blackbar{105pt}\hspace{100pt minus 1pt}\blackbar{105pt}}YYY
+
+But the second one gets a warning like 'Overfull \hbox (1.0pt too wide)
+detected at line 17'. In the output the first 'Y' is overwritten by the
+end of the black bar, because the box's material is wider than the 300pt
+allocated, as TeX has refused to shrink the total to less than
+309 points.
+
+ Stretching is like shrinking except that if TeX is asked to stretch
+beyond the given amount, it won't refuse. Here the first line is fine,
+producing a space of 110 points between the bars.
+
+ XXX\showhbox{300pt}{%
+ \blackbar{95pt}\hspace{100pt plus 10pt}\blackbar{95pt}}YYY
+
+ XXX\showhbox{300pt}{%
+ \blackbar{95pt}\hspace{100pt plus 1pt}\blackbar{95pt}}YYY
+
+In the second line TeX needs a stretch of 10 points and only 1 point was
+specified. In this situation, TeX stretches the space to the required
+length, but it complains with a warning like 'Underfull \hbox (badness
+10000) detected at line 22'. (We won't discuss badness; the point is
+that the system was not given as much stretch as needed.)
+
+ You can put both stretch and shrink in the same length, as in '1ex
+plus 0.05ex minus 0.02ex'.
+
+ If TeX is setting two or more rubber lengths then it allocates the
+stretch or shrink in proportion.
+
+ XXX\showhbox{300pt}{\blackbar{100pt}% left
+ \hspace{0pt plus 50pt}\blackbar{80pt}\hspace{0pt plus 10pt}% middle
+ \blackbar{100pt}}YYY % right
+
+The outside bars take up 100 points, so the middle needs another 100.
+In the middle the bar takes up 80 points, so the two '\hspace''s must
+stretch 20 points. Because the two say 'plus 50pt' and 'plus 10pt', TeX
+gets 5/6 of the stretch from the first space and 1/6 from the second.
The 'plus' or 'minus' component of a rubber length can contain a
"fill" component, as in '1in plus2fill'. This gives the length infinite
-stretchability or shrinkability, so that the length in the prior
-sentence can be set by TeX to any distance greater than or equal to
-1 inch. TeX actually provides three infinite glue components 'fil',
-'fill', and 'filll', such that the later ones overcome the earlier ones,
-but only the middle value is ordinarily used. *Note \hfill::, *Note
-\vfill::.
-
- Multiplying an entire rubber length by a number turns it into a rigid
-length, so that after '\setlength{\ylength}{1in plus 0.2in}' and
+stretchability or shrinkability so that TeX could set it to any
+distance. Here the two figures will be equal-spaced across the page.
+
+ \begin{minipage}{\linewidth}
+ \hspace{0pt plus 1fill}\includegraphics{godel.png}%
+ \hspace{0pt plus 1fill}\includegraphics{einstein.png}%
+ \hspace{0pt plus 1fill}
+ \end{minipage}
+
+ TeX actually has three infinite glue components 'fil', 'fill', and
+'filll'. The later ones are more infinite than the earlier ones.
+Ordinarily document authors only use the middle one (*note \hfill:: and
+*note \vfill::).
+
+ Multiplying a rubber length by a number turns it into a rigid length,
+so that after '\setlength{\ylength}{1in plus 0.2in}' and
'\setlength{\zlength}{3\ylength}' then the value of '\zlength' is '3in'.
* Menu:
@@ -6078,7 +7845,6 @@ length, so that after '\setlength{\ylength}{1in plus 0.2in}' and
* \settodepth:: Set a length to the depth of something.
* \settoheight:: Set a length to the height of something.
* \settowidth:: Set a length to the width of something.
-* Predefined lengths:: Lengths that are, like, predefined.

File: latex2e.info, Node: Units of length, Next: \setlength, Up: Lengths
@@ -6120,7 +7886,7 @@ mode.
Two other lengths that are often used are values set by the designer
of the font. The x-height of the current font "ex", traditionally the
-height of the lower case letter x, is often used for vertical lengths.
+height of the lowercase letter x, is often used for vertical lengths.
Similarly "em", traditionally the width of the capital letter M, is
often used for horizontal lengths (there is also '\enspace', which is
'0.5em'). Use of these can help make a definition work better across
@@ -6141,12 +7907,23 @@ File: latex2e.info, Node: \setlength, Next: \addtolength, Prev: Units of leng
Synopsis:
- \setlength{\LEN}{AMOUNT}
+ \setlength{LEN}{AMOUNT}
+
+ Set the length LEN to AMOUNT. The length name LEN must begin with a
+backslash, '\'. The 'amount' can be a rubber length (*note Lengths::).
+It can be positive, negative or zero, and can be in any units that LaTeX
+understands (*note Units of length::).
- The '\setlength' sets the value of "length command" '\LEN' to the
-VALUE argument which can be expressed in any units that LaTeX
-understands, i.e., inches ('in'), millimeters ('mm'), points ('pt'), big
-points ('bp'), etc.
+ Below, with LaTeX's defaults the first paragraph will be indented
+while the second will not.
+
+ I told the doctor I broke my leg in two places.
+
+ \setlength{\parindent}{0em}
+ He said stop going to those places.
+
+ If there is no such length LEN then you get something like 'Undefined
+control sequence. <argument> \praindent'.

File: latex2e.info, Node: \addtolength, Next: \settodepth, Prev: \setlength, Up: Lengths
@@ -6156,10 +7933,27 @@ File: latex2e.info, Node: \addtolength, Next: \settodepth, Prev: \setlength,
Synopsis:
- \addtolength{\LEN}{AMOUNT}
+ \addtolength{LEN}{AMOUNT}
+
+ Increment the length LEN by AMOUNT. The length name LEN begins with
+a backslash, '\'. The 'amount' is a rubber length (*note Lengths::).
+It can be positive, negative or zero, and can be in any units that LaTeX
+understands (*note Units of length::).
+
+ Below, if '\parskip' starts with the value '0pt plus 1pt'
+
+ \addtolength{\parskip}{1pt}
+ Doctor: how is the boy who swallowed the silver dollar?
- The '\addtolength' command increments a length command '\LEN' by the
-amount specified in the AMOUNT argument, which may be negative.
+ Nurse: no change.
+
+then it has the value '1pt plus 1pt' for the second paragraph.
+
+ If there is no such length LEN then you get something like 'Undefined
+control sequence. <argument> \praindent'. If you leave off the
+backslash at the start of LEN, as in '\addtolength{parindent}{1pt}',
+then you get something like 'You can't use `the letter p' after
+\advance'.

File: latex2e.info, Node: \settodepth, Next: \settoheight, Prev: \addtolength, Up: Lengths
@@ -6169,10 +7963,23 @@ File: latex2e.info, Node: \settodepth, Next: \settoheight, Prev: \addtolength
Synopsis:
- \settodepth{\LEN}{TEXT}
+ \settodepth{LEN}{TEXT}
+
+ Set the length LEN to the depth of box that LaTeX gets on typesetting
+the TEXT argument. The length name LEN must begin with a backslash,
+'\'.
- The '\settodepth' command sets the value of a length command '\LEN'
-equal to the depth of the TEXT argument.
+ This will show how low the character descenders go.
+
+ \newlength{\alphabetdepth}
+ \settodepth{\alphabetdepth}{abcdefghijklmnopqrstuvwxyz}
+ \the\alphabetdepth
+
+ If there is no such length LEN then you get something like 'Undefined
+control sequence. <argument> \alphabetdepth'. If you leave the
+backslash out of LEN, as in '\settodepth{alphabetdepth}{...}' then you
+get something like 'Missing number, treated as zero. <to be read again>
+\setbox'.

File: latex2e.info, Node: \settoheight, Next: \settowidth, Prev: \settodepth, Up: Lengths
@@ -6182,45 +7989,49 @@ File: latex2e.info, Node: \settoheight, Next: \settowidth, Prev: \settodepth,
Synopsis:
- \settoheight{\LEN}{text}
+ \settoheight{LEN}{text}
- The '\settoheight' command sets the value of a length command '\LEN'
-equal to the height of the 'text' argument.
+ Sets the length LEN to the height of box that LaTeX gets on
+typesetting the 'text' argument. The length name LEN must begin with a
+backslash, '\'.
-
-File: latex2e.info, Node: \settowidth, Next: Predefined lengths, Prev: \settoheight, Up: Lengths
+ This will show how high the characters go.
-14.6 '\settowidth{\LEN}{TEXT}'
-==============================
-
-Synopsis:
+ \newlength{\alphabetheight}
+ \settoheight{\alphabetheight}{abcdefghijklmnopqrstuvwxyz}
+ \the\alphabetheight
- \settowidth{\LEN}{TEXT}
-
- The '\settowidth' command sets the value of the command \LEN to the
-width of the TEXT argument.
+ If there is no such length LEN then you get something like 'Undefined
+control sequence. <argument> \alphabetheight'. If you leave the
+backslash out of LEN, as in '\settoheight{alphabetheight}{...}' then you
+get something like 'Missing number, treated as zero. <to be read again>
+\setbox'.

-File: latex2e.info, Node: Predefined lengths, Prev: \settowidth, Up: Lengths
+File: latex2e.info, Node: \settowidth, Prev: \settoheight, Up: Lengths
-14.7 Predefined lengths
-=======================
+14.6 '\settowidth'
+==================
-'\width'
+Synopsis:
- '\height'
+ \settowidth{LEN}{TEXT}
- '\depth'
+ Set the length LEN to the width of the box that LaTeX gets on
+typesetting the TEXT argument. The length name LEN must begin with a
+backslash, '\'.
- '\totalheight'
+ This measures the width of the lowercase ASCII alphabet.
- These length parameters can be used in the arguments of the
-box-making commands (*note Boxes::). They specify the natural width,
-etc., of the text in the box. '\totalheight' equals '\height' +
-'\depth'. To make a box with the text stretched to double the natural
-size, e.g., say
+ \newlength{\alphabetwidth}
+ \settowidth{\alphabetwidth}{abcdefghijklmnopqrstuvwxyz}
+ \the\alphabetwidth
- \makebox[2\width]{Get a stretcher}
+ If there is no such length LEN then you get something like 'Undefined
+control sequence. <argument> \alphabetwidth'. If you leave the
+backslash out of LEN, as in '\settoheight{alphabetwidth}{...}' then you
+get something like 'Missing number, treated as zero. <to be read again>
+\setbox'.

File: latex2e.info, Node: Making paragraphs, Next: Math formulas, Prev: Lengths, Up: Top
@@ -6228,92 +8039,217 @@ File: latex2e.info, Node: Making paragraphs, Next: Math formulas, Prev: Lengt
15 Making paragraphs
********************
-A paragraph is ended by one or more completely blank lines--lines not
-containing even a '%'. A blank line should not appear where a new
-paragraph cannot be started, such as in math mode or in the argument of
-a sectioning command.
+Once LaTeX has all of a paragraph's contents it divides it into lines,
+in a way that is optimized over the entire paragraph (*note Line
+breaking::). To end the current paragraph, put an empty line.
+
+ It is a truth universally acknowledged, that a single man in possession
+ of a good fortune, must be in want of a wife.
+
+ However little known the feelings or views of such a man may be on his
+ first entering a neighbourhood, this truth is so well fixed in the minds
+ of the surrounding families, that he is considered the rightful property
+ of some one or other of their daughters.
+
+ ``My dear Mr. Bennet,'' said his lady to him one day,
+ ``have you heard that Netherfield Park is let at last?''
+
+ The separator lines must be empty, including not containing a comment
+character, '%'.
+
+ There are places where a new paragraph is not permitted. Don't put a
+blank line in math mode (*note Modes::); here the line before the
+'\end{equation}'
+
+ \begin{equation}
+ 2^{|S|} > |S|
+
+ \end{equation}
+
+will get you the error 'Missing $ inserted'. Similarly, the blank line
+in this 'section' argument
+
+ \section{aaa
+
+ bbb}
+
+gets 'Runaway argument? {aaa ! Paragraph ended before \@sect was
+complete'.
* Menu:
-* \indent:: Indent this paragraph.
-* \noindent:: Do not indent this paragraph.
-* \parskip:: Space added before paragraphs.
-* Marginal notes:: Putting remarks in the margin.
+* \par:: End the current paragraph.
+* \indent & \noindent:: Go into horizontal mode, possibly with an indent.
+* \parindent & \parskip:: Space added before paragraphs.
+* Marginal notes:: Put remarks in the margin.

-File: latex2e.info, Node: \indent, Next: \noindent, Up: Making paragraphs
+File: latex2e.info, Node: \par, Next: \indent & \noindent, Up: Making paragraphs
-15.1 '\indent'
-==============
+15.1 '\par'
+===========
+
+Synopsis (note that while reading the input TeX, converts two
+consecutive newlines to a '\par'):
-'\indent' produces a horizontal space whose width equals to the
-'\parindent' length, the normal paragraph indentation. It is used to
-add paragraph indentation where it would otherwise be suppressed.
+ \par
- The default value for '\parindent' is '1em' in two-column mode,
-otherwise '15pt' for '10pt' documents, '17pt' for '11pt', and '1.5em'
-for '12pt'.
+ End the current paragraph. The usual way to separate paragraphs is
+with a blank line but the '\par' command is entirely equivalent. This
+command is robust (*note \protect::).
+
+ This example uses '\par' rather than a blank line simply for
+readability.
+
+ \newcommand{\syllabusLegalese}{%
+ \whatCheatingIs\par\whatHappensWhenICatchYou}
+
+ The '\par' command does nothing in LR mode or a vertical mode but it
+terminates paragraph mode, bringing LaTeX to vertical mode (*note
+Modes::).
+
+ You cannot use the '\par' command in math mode or in the argument of
+many commands, such as the '\section' command (*note Making paragraphs::
+and *note \newcommand & \renewcommand::).
+
+ The '\par' command differs from the '\paragraph' command in that the
+latter is, like '\section' or '\subsection', a sectioning unit used by
+the standard LaTeX documents.
+
+ The '\par' command differs from '\newline' and the line break double
+backslash, '\\', in that \par ends the paragraph not just the line. It
+also triggers the addition of the between-paragraph vertical space
+'\parskip' (*note \parindent & \parskip::).
+
+ The output from this example
+
+ xyz
+
+ \setlength{\parindent}{3in}
+ \setlength{\parskip}{5in}
+ \noindent test\indent test1\par test2
+
+is: after 'xyz' there is a vertical skip of 5 inches and then 'test'
+appears, aligned with the left margin. On the same line, there is an
+empty horizontal space of 3 inches and then 'test1' appears. Finally.
+there is a vertical space of 5 inches, followed by a fresh paragraph
+with a paragraph indent of 3 inches, and then LaTeX puts the text
+'test2'.

-File: latex2e.info, Node: \noindent, Next: \parskip, Prev: \indent, Up: Making paragraphs
+File: latex2e.info, Node: \indent & \noindent, Next: \parindent & \parskip, Prev: \par, Up: Making paragraphs
-15.2 '\noindent'
-================
+15.2 '\indent' & '\noindent'
+============================
-When used at the beginning of the paragraph, this command suppresses any
-paragraph indentation, as in this example.
+Synopsis:
+
+ \indent
+
+or
+
+ \noindent
+
+ Go into horizontal mode (*note Modes::). The '\indent' command first
+outputs an empty box whose width is '\parindent'. These commands are
+robust (*note \protect::).
+
+ Ordinarily you create a new paragraph by putting in a blank line.
+*Note \par:: for the difference between this command and '\par'. To
+start a paragraph without an indent, or to continue an interrupted
+paragraph, use '\noindent'.
+
+ In the middle of a paragraph the '\noindent' command has no effect,
+because LaTeX is already in horizontal mode there. The '\indent'
+command's only effect is to output a space.
+
+ This example starts a fresh paragraph.
... end of the prior paragraph.
\noindent This paragraph is not indented.
- It has no effect when used in the middle of a paragraph.
+and this continues an interrupted paragraph.
+
+ The data
+
+ \begin{center}
+ \begin{tabular}{rl} ... \end{tabular}
+ \end{center}
- To eliminate paragraph indentation in an entire document, put
-'\setlength{\parindent}{0pt}' in the preamble.
+ \noindent shows this clearly.
+
+ To omit indentation in the entire document put
+'\setlength{\parindent}{0pt}' in the preamble. If you do that, you may
+want to also set the length of spaces between paragraphs, '\parskip'
+(*note \parindent & \parskip::).
+
+ Default LaTeX styles have the first paragraph after a section that is
+not indented, as is traditional typesetting in English. To change that,
+look on CTAN for the package 'indentfirst'.

-File: latex2e.info, Node: \parskip, Next: Marginal notes, Prev: \noindent, Up: Making paragraphs
+File: latex2e.info, Node: \parindent & \parskip, Next: Marginal notes, Prev: \indent & \noindent, Up: Making paragraphs
-15.3 '\parskip'
-===============
+15.3 '\parindent' & '\parskip'
+==============================
+
+Synopsis:
-'\parskip' is a rubber length defining extra vertical space added before
-each paragraph. The default is '0pt plus1pt'.
+ \setlength{\parskip}{HORIZONTAL LEN}
+ \setlength{\parinden}{VERTICAL LEN}
+
+ Both are a rubber lengths (*note Lengths::). They give the
+indentation of ordinary paragraphs, not paragraphs inside minipages
+(*note minipage::), and the vertical space between paragraphs.
+
+ This, put in the preamble,
+
+ \setlength{\parindent}{0em}
+ \setlength{\parskip}{1ex}
+
+arranges that the document will have paragraphs that are not indented,
+but instead are vertically separated by about the height of a lowercase
+'x'.
+
+ In standard LaTeX documents, the default value for '\parindent' in
+one-column documents is '15pt' when the default text size is '10pt' ,
+'17pt' for '11pt', and '1.5em' for '12pt'. In two-column documents it
+is '1em'. The default value for '\parskip' in LaTeX's standard document
+styles is '0pt plus1pt'.

-File: latex2e.info, Node: Marginal notes, Prev: \parskip, Up: Making paragraphs
+File: latex2e.info, Node: Marginal notes, Prev: \parindent & \parskip, Up: Making paragraphs
15.4 Marginal notes
===================
-Synopsis:
+Synopsis, one of:
+ \marginpar{RIGHT}
\marginpar[LEFT]{RIGHT}
- The '\marginpar' command creates a note in the margin. The first
-line of the note will have the same baseline as the line in the text
-where the '\marginpar' occurs.
-
- When you only specify the mandatory argument RIGHT, the text will be
-placed
+ Create a note in the margin. The first line of the note will have
+the same baseline as the line in the text where the '\marginpar' occurs.
- * in the right margin for one-sided layout (option 'oneside', see
- *note Document class options::);
- * in the outside margin for two-sided layout (option 'twoside', see
- *note Document class options::);
- * in the nearest margin for two-column layout (option 'twocolumn',
- see *note Document class options::).
+ The margin that LaTeX uses for the note depends on the current layout
+(*note Document class options::) and also on '\reversemarginpar' (see
+below). If you are using one-sided layout (document option 'oneside')
+then it goes in the right margin. If you are using two-sided layout
+(document option 'twoside') then it goes in the outside margin. If you
+are in two-column layout (document option 'twocolumn') then it goes in
+the nearest margin.
- The command '\reversemarginpar' places subsequent marginal notes in
-the opposite (inside) margin. '\normalmarginpar' places them in the
-default position.
+ If you declare '\reversemarginpar' then LaTeX will place subsequent
+marginal notes in the opposite margin to that given in the prior
+paragraph. Revert that to the default position with '\normalmarginpar'.
- When you specify both arguments, LEFT is used for the left margin,
-and RIGHT is used for the right margin.
+ When you specify the optional argument LEFT then it is used for a
+note in the left margin, while the mandatory argument RIGHT is used for
+a note in the the right margin.
- The first word will normally not be hyphenated; you can enable
-hyphenation there by beginning the node with '\hspace{0pt}'.
+ Normally, a note's first word will not be hyphenated. You can enable
+hyphenation there by beginning LEFT or RIGHT with '\hspace{0pt}'.
These parameters affect the formatting of the note:
@@ -6340,39 +8276,93 @@ File: latex2e.info, Node: Math formulas, Next: Modes, Prev: Making paragraphs
16 Math formulas
****************
-There are three environments that put LaTeX in math mode:
+Produce mathematical text by putting LaTeX into math mode or display
+math mode (*note Modes::). This example shows both.
+
+ The wave equation for \( u \) is
+ \begin{displaymath}
+ \frac{\partial^2u}{\partial t^2} = c^2\nabla^2u
+ \end{displaymath}
+ where \( \nabla^2 \) is the spatial Laplacian and \( c \) is constant.
+
+Math mode is for inline mathematics. In the above example it is invoked
+by the starting '\(' and finished by the matching ending '\)'. Display
+math mode is for displayed equations and here is invoked by the
+'displaymath' environment. Note that any mathematical text whatever,
+including mathematical text consisting of just one character, is handled
+in math mode.
+
+ When in math mode or display math mode, LaTeX handles many aspects of
+your input text differently than in other text modes. For example,
+
+ contrast x+y with \( x+y \)
+
+in math mode the letters are in italics and the spacing around the plus
+sign is different.
+
+ There are three ways to make inline formulas, to put LaTeX in math
+mode.
+
+ \( MATHEMATICAL MATERIAL \)
+ $ MATHEMATICAL MATERIAL $
+ \begin{math} MATHEMATICAL MATERIAL \end{math}
-'math'
- For formulas that appear right in the text.
-'displaymath'
- For formulas that appear on their own line.
-'equation'
- The same as the displaymath environment except that it adds an
- equation number in the right margin.
+The first form is preferred and the second is quite common, but the
+third form is rarely used. You can sometimes use one and sometimes
+another, as in '\(x\) and $y$'. You can use these in paragraph mode or
+in LR mode (*note Modes::).
- The 'math' environment can be used in both paragraph and LR mode, but
-the 'displaymath' and 'equation' environments can be used only in
-paragraph mode. The 'math' and 'displaymath' environments are used so
-often that they have the following short forms:
+ To make displayed formulas, put LaTeX into display math mode with
+either:
- \(...\) instead of \begin{math}...\end{math}
- \[...\] instead of \begin{displaymath}...\end{displaymath}
+ \begin{displaymath}
+ MATHEMATICAL MATERIAL
+ \end{displaymath}
- In fact, the 'math' environment is so common that it has an even
-shorter form:
+or
- $ ... $ instead of \(...\)
+ \begin{equation}
+ MATHEMATICAL MATERIAL
+ \end{equation}
- The '\boldmath' command changes math letters and symbols to be in a
-bold font. It is used _outside_ of math mode. Conversely, the
-'\unboldmath' command changes math glyphs to be in a normal font; it too
-is used _outside_ of math mode.
+(*note displaymath::, *note equation::). The only difference is that
+with the 'equation' environment, LaTeX puts a formula number alongside
+the formula. The construct '\[ MATH \]' is equivalent to
+'\begin{displaymath} MATH \end{displaymath}'. These environments can
+only be used in paragraph mode (*note Modes::).
+
+ The two mathematics modes are similar, but there are some
+differences. One involves the placement of subscripts and superscripts;
+in display math mode they are further apart and in inline math mode they
+are closer together.
+
+ Sometimes you want the display math typographical treatment to happen
+in the inline math mode. For this, the '\displaystyle' declaration
+forces the size and style of the formula to be that of 'displaymath'.
+Thus '\(\displaystyle \sum_{n=0}^\infty x_n\)' will have the limits
+above and below the summation sign, not next to it. Another example is
+that
+
+ \begin{tabular}{r|cc}
+ \textsc{Name} &\textsc{Series} &\textsc{Sum} \\ \hline
+ Arithmetic &\( a+(a+b)+(a+2b)+\cdots+(a+(n-1)b) \)
+ &\( na+(n-1)n\cdot\frac{b}{2}\) \\
+ Geometric &\( a+ab+ab^2+\cdots+ab^{n-1} \)
+ &\(\displaystyle a\cdot\frac{1-b^n}{1-b}\) \\
+ \end{tabular}
- The '\displaystyle' declaration forces the size and style of the
-formula to be that of 'displaymath', e.g., with limits above and below
-summations. For example:
+because it has no '\displaystyle', the 'Arithmetic' line's fraction will
+be scrunched. But, because of its '\displaystyle', the 'Geometric'
+line's fraction will be easy to read, with characters the same size as
+in the rest of the line.
- $\displaystyle \sum_{n=0}^\infty x_n $
+ The American Mathematical Society has made freely available a set of
+packages that greatly expand your options for writing mathematics,
+'amsmath' and 'amssymb' (also be aware of the 'mathtools' package that
+is an extension to, and loads, 'amsmath'). New documents that will have
+mathematical text should use these packages. Descriptions of these
+packages is outside the scope of this document; see their documentation
+on CTAN.
* Menu:
@@ -6380,7 +8370,8 @@ summations. For example:
* Math symbols:: Various mathematical squiggles.
* Math functions:: Math function names like sin and exp.
* Math accents:: Accents in math.
-* Spacing in math mode:: Thick, medium, thin and negative spaces.
+* Over- and Underlining:: Things over or under formulas.
+* Spacing in math mode:: Thick, medium, thin, and negative spaces.
* Math miscellany:: Stuff that doesn't fit anywhere else.

@@ -6389,35 +8380,65 @@ File: latex2e.info, Node: Subscripts & superscripts, Next: Math symbols, Up:
16.1 Subscripts & superscripts
==============================
-In math mode, use the caret character '^' to make the EXP appear as a
-superscript: '^{EXP}'. Similarly, in math mode, underscore '_{EXP}'
-makes a subscript out of EXP.
+Synopsis (in math mode or display math mode), one of:
- In this example the '0' and '1' appear as subscripts while the '2' is
-a superscript.
+ BASE^EXP
+ BASE^{EXP}
- \( (x_0+x_1)^2 \)
+or, one of:
- To have more than one character in EXP use curly braces as in
-'e^{-2x}'.
+ BASE_EXP
+ BASE_{EXP}
- LaTeX handles superscripts on superscripts, and all of that stuff, in
-the natural way, so expressions such as 'e^{x^2}' and 'x_{a_0}' will
-look right. It also does the right thing when something has both a
-subscript and a superscript. In this example the '0' appears at the
-bottom of the integral sign while the '10' appears at the top.
+ Make EXP appear as a superscript of BASE (with the caret
+character, '^') or a subscript (with underscore, '_').
- \int_0^{10} x^2 \,dx
+ In this example the '0''s and '1''s are subscripts while the '2''s
+are superscripts.
- You can put a superscript or subscript before a symbol with a
-construct such as '{}_t K^2' in math mode (the initial '{}' prevents the
-prefixed subscript from being attached to any prior symbols in the
-expression).
+ \( (x_0+x_1)^2 \leq (x_0)^2+(x_1)^2 \)
- Outside of math mode, a construct like 'A
-test$_\textnormal{subscript}$' will produce a subscript typeset in text
-mode, not math mode. Note that there are packages specialized for
-writing Chemical formulas such as 'mhchem'.
+ To have the subscript or superscript contain more than one character,
+surround the expression with curly braces, as in 'e^{-2x}'. This
+example's fourth line shows curly braces used to group an expression for
+the exponent.
+
+ \begin{displaymath}
+ (3^3)^3=27^3=19\,683
+ \qquad
+ 3^{(3^3)}=3^{27}=7\,625\,597\,484\,987
+ \end{displaymath}
+
+ LaTeX knows how to handle a superscript on a superscript, or a
+subscript on a subscript, or supers on subs, or subs on supers. So,
+expressions such as 'e^{x^2}' and 'x_{i_0}' give correct output. Note
+the use in those expressions of curly braces to give the BASE a
+determined EXP. If you enter '\(3^3^3\)' then you get 'Double
+superscript'.
+
+ LaTeX does the right thing when something has both a subscript and a
+superscript. In this example the integral has both. They come out in
+the correct place without any author intervention.
+
+ \begin{displaymath}
+ \int_{x=a}^b f'(x)\,dx = f(b)-f(a)
+ \end{displaymath}
+
+Note the parentheses around 'x=a' to make the entire expression a
+subscript.
+
+ To put a superscript or subscript before a symbol, use a construct
+like '{}_t K^2'. The empty curly braces '{}' give the subscript
+something to attach to and keeps it from accidentally attaching to a
+prior symbols.
+
+ Using the subscript or superscript command outside of math mode or
+display math mode, as in 'the expression x^2', will get you the error
+'Missing $ inserted'.
+
+ A common reason to want subscripts outside of a mathematics mode is
+to typeset chemical formulas. There are packages for that such as
+'mhchem'; see CTAN.

File: latex2e.info, Node: Math symbols, Next: Math functions, Prev: Subscripts & superscripts, Up: Math formulas
@@ -6425,18 +8446,17 @@ File: latex2e.info, Node: Math symbols, Next: Math functions, Prev: Subscript
16.2 Math symbols
=================
-LaTeX provides almost any mathematical symbol you're likely to need.
-For example, if you include '$\pi$' in your source, you will get the pi
-symbol U+03C0.
+LaTeX provides almost any mathematical or technical symbol that anyone
+uses. For example, if you include '$\pi$' in your source, you will get
+the pi symbol U+03C0. See the 'Comprehensive LaTeX Symbol List' at
+<https://ctan.org/tex-archive/info/symbols/comprehensive/>.
- Below is a list of commonly-available symbols. It is by no means an
-exhaustive list. Each symbol here is described with a short phrase, and
-its symbol class (which determines the spacing around it) is given in
+ Here is a list of commonly-used symbols. It is by no means
+exhaustive. Each symbol is described with a short phrase, and its
+symbol class, which determines the spacing around it, is given in
parenthesis. Unless said otherwise, the commands for these symbols can
-be used only in math mode.
-
- To redefine a command so that it can be used whatever the current
-mode, see *note \ensuremath::.
+be used only in math mode. To redefine a command so that it can be used
+whatever the current mode, see *note \ensuremath::.
'\|'
U+2225 Parallel (relation). Synonym: '\parallel'.
@@ -6445,7 +8465,7 @@ mode, see *note \ensuremath::.
U+2135 Aleph, transfinite cardinal (ordinary).
'\alpha'
- U+03B1 Lower case Greek letter alpha (ordinary).
+ U+03B1 Lowercase Greek letter alpha (ordinary).
'\amalg'
U+2A3F Disjoint union (binary)
@@ -6472,7 +8492,7 @@ mode, see *note \ensuremath::.
'\textbackslash' for backslash outside of math mode.
'\beta'
- U+03B2 Lower case Greek letter beta (ordinary).
+ U+03B2 Lowercase Greek letter beta (ordinary).
'\bigcap'
U+22C2 Variable-sized, or n-ary, intersection (operator). Similar:
@@ -6539,7 +8559,7 @@ mode, see *note \ensuremath::.
U+22C5 Multiplication (binary). Similar: Bullet dot '\bullet'.
'\chi'
- U+03C7 Lower case Greek chi (ordinary).
+ U+03C7 Lowercase Greek chi (ordinary).
'\circ'
U+2218 Function composition, ring operator (binary). Similar:
@@ -6575,18 +8595,18 @@ mode, see *note \ensuremath::.
U+2021 Double dagger relation (binary).
'\Delta'
- U+0394 Greek upper case delta, used for increment (ordinary).
+ U+0394 Greek uppercase delta, used for increment (ordinary).
'\delta'
- U+03B4 Greek lower case delta (ordinary).
+ U+03B4 Greek lowercase delta (ordinary).
'\Diamond'
U+25C7 Large diamond operator (ordinary). Not available in plain
TeX. In LaTeX you need to load the 'amssymb' package.
'\diamond'
- U+22C4 Diamond operator, or diamond bullet (binary). Similar:
- large diamond '\Diamond', circle bullet '\bullet'.
+ U+22C4 Diamond operator (binary). Similar: large
+ diamond '\Diamond', circle bullet '\bullet'.
'\diamondsuit'
U+2662 Diamond card suit (ordinary).
@@ -6599,12 +8619,12 @@ mode, see *note \ensuremath::.
equal to '\Doteq'.
'\downarrow'
- U+2193 Down arrow, converges (relation). Similar: double line down
- arrow '\Downarrow'.
+ U+2193 Down arrow, converges (relation). Similar: '\Downarrow'
+ double line down arrow.
'\Downarrow'
- U+21D3 Double line down arrow (relation). Similar: single line
- down arrow '\downarrow'.
+ U+21D3 Double line down arrow (relation). Similar: '\downarrow'
+ single line down arrow.
'\ell'
U+2113 Lowercase cursive letter l (ordinary).
@@ -6614,7 +8634,7 @@ mode, see *note \ensuremath::.
'\varnothing'.
'\epsilon'
- U+03F5 Lower case lunate epsilon (ordinary). Similar to Greek text
+ U+03F5 Lowercase lunate epsilon (ordinary). Similar to Greek text
letter. More widely used in mathematics is the script small letter
epsilon '\varepsilon' U+03B5. Related: the set membership relation
'\in' U+2208.
@@ -6623,7 +8643,7 @@ mode, see *note \ensuremath::.
U+2261 Equivalence (relation).
'\eta'
- U+03B7 Lower case Greek letter (ordinary).
+ U+03B7 Lowercase Greek letter (ordinary).
'\exists'
U+2203 Existential quantifier (ordinary).
@@ -6638,10 +8658,10 @@ mode, see *note \ensuremath::.
U+2322 Downward curving arc (ordinary).
'\Gamma'
- U+0393 Upper case Greek letter (ordinary).
+ U+0393 uppercase Greek letter (ordinary).
'\gamma'
- U+03B3 Lower case Greek letter (ordinary).
+ U+03B3 Lowercase Greek letter (ordinary).
'\ge'
U+2265 Greater than or equal to (relation). This is a synonym
@@ -6677,8 +8697,12 @@ mode, see *note \ensuremath::.
'\Im'
U+2111 Imaginary part (ordinary). See: real part '\Re'.
+'\imath'
+ Dotless i; used when you are putting an accent on an i (*note Math
+ accents::).
+
'\in'
- U+2208 Set element (relation). See also: lower case lunate
+ U+2208 Set element (relation). See also: lowercase lunate
epsilon '\epsilon'U+03F5 and small letter script
epsilon '\varepsilon'.
@@ -6689,20 +8713,24 @@ mode, see *note \ensuremath::.
U+222B Integral (operator).
'\iota'
- U+03B9 Lower case Greek letter (ordinary).
+ U+03B9 Lowercase Greek letter (ordinary).
'\Join'
U+2A1D Condensed bowtie symbol (relation). Not available in Plain
TeX.
+'\jmath'
+ Dotless j; used when you are putting an accent on a j (*note Math
+ accents::).
+
'\kappa'
- U+03BA Lower case Greek letter (ordinary).
+ U+03BA Lowercase Greek letter (ordinary).
'\Lambda'
- U+039B Upper case Greek letter (ordinary).
+ U+039B uppercase Greek letter (ordinary).
'\lambda'
- U+03BB Lower case Greek letter (ordinary).
+ U+03BB Lowercase Greek letter (ordinary).
'\land'
U+2227 Logical and (binary). This is a synonym for '\wedge'. See
@@ -6824,7 +8852,7 @@ mode, see *note \ensuremath::.
U+2213 Minus or plus (relation).
'\mu'
- U+03BC Lower case Greek letter (ordinary).
+ U+03BC Lowercase Greek letter (ordinary).
'\nabla'
U+2207 Hamilton's del, or differential, operator (ordinary).
@@ -6850,19 +8878,19 @@ mode, see *note \ensuremath::.
Synonym: '\owns'. Similar: is a member of '\in'.
'\not'
- U+0020U+00A0U+0338 Long solidus, or slash, used to overstrike a
- following operator (relation).
+ U+0020 Long solidus, or slash, used to overstrike a following
+ operator (relation).
- Many negated operators that don't require '\not' are available,
+ Many negated operators are available that don't require '\not',
particularly with the 'amssymb' package. For example, '\notin' is
- probably typographically preferable to '\not\in'.
+ typographically preferable to '\not\in'.
'\notin'
U+2209 Not an element of (relation). Similar: not subset
of '\nsubseteq'.
'\nu'
- U+03BD Lower case Greek letter (ordinary).
+ U+03BD Lowercase Greek letter (ordinary).
'\nwarrow'
U+2196 North-west arrow (relation).
@@ -6876,10 +8904,10 @@ mode, see *note \ensuremath::.
(operator).
'\Omega'
- U+03A9 Upper case Greek letter (ordinary).
+ U+03A9 uppercase Greek letter (ordinary).
'\omega'
- U+03C9 Lower case Greek letter (ordinary).
+ U+03C9 Lowercase Greek letter (ordinary).
'\ominus'
U+2296 Minus sign, or dash, inside a circle (binary).
@@ -6911,14 +8939,14 @@ mode, see *note \ensuremath::.
ordinary.
'\phi'
- U+03D5 Lower case Greek letter (ordinary). The variant form is
+ U+03D5 Lowercase Greek letter (ordinary). The variant form is
'\varphi' U+03C6.
'\Pi'
- U+03A0 Upper case Greek letter (ordinary).
+ U+03A0 uppercase Greek letter (ordinary).
'\pi'
- U+03C0 Lower case Greek letter (ordinary). The variant form is
+ U+03C0 Lowercase Greek letter (ordinary). The variant form is
'\varpi' U+03D6.
'\pm'
@@ -6947,10 +8975,10 @@ mode, see *note \ensuremath::.
U+221D Is proportional to (relation)
'\Psi'
- U+03A8 Upper case Greek letter (ordinary).
+ U+03A8 uppercase Greek letter (ordinary).
'\psi'
- U+03C8 Lower case Greek letter (ordinary).
+ U+03C8 Lowercase Greek letter (ordinary).
'\rangle'
U+27E9 Right angle, or sequence, bracket (closing). Similar:
@@ -6973,9 +9001,9 @@ mode, see *note \ensuremath::.
this, load the 'amsfonts' package.
'\restriction'
- U+21BE Restriction of a function (relation).
- Synonym: '\upharpoonright'. Not available in plain TeX. In LaTeX
- you need to load the 'amssymb' package.
+ U+21BE Restriction of a function (relation). Synonym:
+ '\upharpoonright'. Not available in plain TeX. In LaTeX you need
+ to load the 'amssymb' package.
'\revemptyset'
U+29B0 Reversed empty set symbol (ordinary). Related:
@@ -6994,7 +9022,7 @@ mode, see *note \ensuremath::.
gives better spacing).
'\rho'
- U+03C1 Lower case Greek letter (ordinary). The variant form is
+ U+03C1 Lowercase Greek letter (ordinary). The variant form is
'\varrho' U+03F1.
'\Rightarrow'
@@ -7018,18 +9046,18 @@ mode, see *note \ensuremath::.
U+2198 Arrow pointing southeast (relation).
'\setminus'
- U+29F5 Set difference, reverse solidus or slash, like \ (binary).
- Similar: backslash '\backslash' and also '\textbackslash' outside
- of math mode.
+ U+29F5 Set difference, reverse solidus or reverse slash, like \
+ (binary). Similar: backslash '\backslash' and also
+ '\textbackslash' outside of math mode.
'\sharp'
U+266F Musical sharp (ordinary).
'\Sigma'
- U+03A3 Upper case Greek letter (ordinary).
+ U+03A3 uppercase Greek letter (ordinary).
'\sigma'
- U+03C3 Lower case Greek letter (ordinary). The variant form is
+ U+03C3 Lowercase Greek letter (ordinary). The variant form is
'\varsigma' U+03C2.
'\sim'
@@ -7114,10 +9142,10 @@ mode, see *note \ensuremath::.
U+2199 Southwest-pointing arrow (relation).
'\tau'
- U+03C4 Lower case Greek letter (ordinary).
+ U+03C4 Lowercase Greek letter (ordinary).
'\theta'
- U+03B8 Lower case Greek letter (ordinary). The variant form is
+ U+03B8 Lowercase Greek letter (ordinary). The variant form is
'\vartheta' U+03D1.
'\times'
@@ -7190,10 +9218,10 @@ mode, see *note \ensuremath::.
operator '\biguplus'.
'\Upsilon'
- U+03A5 Upper case Greek letter (ordinary).
+ U+03A5 uppercase Greek letter (ordinary).
'\upsilon'
- U+03C5 Lower case Greek letter (ordinary).
+ U+03C5 Lowercase Greek letter (ordinary).
'\varepsilon'
U+03B5 Small letter script epsilon (ordinary). This is more widely
@@ -7206,23 +9234,23 @@ mode, see *note \ensuremath::.
load the 'amssymb' package.
'\varphi'
- U+03C6 Variant on the lower case Greek letter (ordinary). The
+ U+03C6 Variant on the lowercase Greek letter (ordinary). The
non-variant form is '\phi' U+03D5.
'\varpi'
- U+03D6 Variant on the lower case Greek letter (ordinary). The
+ U+03D6 Variant on the lowercase Greek letter (ordinary). The
non-variant form is '\pi' U+03C0.
'\varrho'
- U+03F1 Variant on the lower case Greek letter (ordinary). The
+ U+03F1 Variant on the lowercase Greek letter (ordinary). The
non-variant form is '\rho' U+03C1.
'\varsigma'
- U+03C2 Variant on the lower case Greek letter (ordinary). The
+ U+03C2 Variant on the lowercase Greek letter (ordinary). The
non-variant form is '\sigma' U+03C3.
'\vartheta'
- U+03D1 Variant on the lower case Greek letter (ordinary). The
+ U+03D1 Variant on the lowercase Greek letter (ordinary). The
non-variant form is '\theta' U+03B8.
'\vdash'
@@ -7237,10 +9265,10 @@ mode, see *note \ensuremath::.
U+2016 Vertical double bar (ordinary). Similar: vertical single
bar '\vert'.
- For a norm symbol, you can use the 'mathtools' package and add
- '\DeclarePairedDelimiter\norm{\lVert}{\rVert}' to your preamble.
- This gives you three command variants for double-line vertical bars
- that are correctly horizontally spaced: if in the document body you
+ For a norm symbol, you can use the 'mathtools' package and put in
+ your preamble '\DeclarePairedDelimiter\norm{\lVert}{\rVert}'. This
+ gives you three command variants for double-line vertical bars that
+ are correctly horizontally spaced: if in the document body you
write the starred version '$\norm*{M^\perp}$' then the height of
the vertical bars will match the height of the argument, whereas
with '\norm{M^\perp}' the bars do not grow with the height of the
@@ -7253,10 +9281,10 @@ mode, see *note \ensuremath::.
vertical bar '\Vert'. For such that, as in the definition of a
set, use '\mid' because it is a relation.
- For absolute value you can use the 'mathtools' package and add
- '\DeclarePairedDelimiter\abs{\lvert}{\rvert}' to your preamble.
- This gives you three command variants for single-line vertical bars
- that are correctly horizontally spaced: if in the document body you
+ For absolute value you can use the 'mathtools' package and in your
+ preamble put '\DeclarePairedDelimiter\abs{\lvert}{\rvert}'. This
+ gives you three command variants for single-line vertical bars that
+ are correctly horizontally spaced: if in the document body you
write the starred version '$\abs*{\frac{22}{7}}$' then the height
of the vertical bars will match the height of the argument, whereas
with '\abs{\frac{22}{7}}' the bars do not grow with the height of
@@ -7275,13 +9303,189 @@ mode, see *note \ensuremath::.
U+2240 Wreath product (binary).
'\Xi'
- U+039E Upper case Greek letter (ordinary).
+ U+039E uppercase Greek letter (ordinary).
'\xi'
- U+03BE Lower case Greek letter (ordinary).
+ U+03BE Lowercase Greek letter (ordinary).
'\zeta'
- U+03B6 Lower case Greek letter (ordinary).
+ U+03B6 Lowercase Greek letter (ordinary).
+
+ The following symbols are most often used in plain text but LaTeX
+provides versions to use in mathematical text.
+
+'\mathdollar'
+ Dollar sign in math mode: $.
+
+'\mathparagraph'
+ Paragraph sign (pilcrow) in math mode, U+00B6.
+
+'\mathsection'
+ Section sign in math mode U+00A7.
+
+'\mathsterling'
+ Sterling sign in math mode: #.
+
+'\mathunderscore'
+ Underscore in math mode: _.
+
+* Menu:
+
+* Blackboard bold:: Doublestruck characters.
+* Calligraphic:: Cursive characters.
+* \boldmath & \unboldmath:: Symbols in boldface.
+* Dots:: Ellipses, etc.
+
+
+File: latex2e.info, Node: Blackboard bold, Next: Calligraphic, Up: Math symbols
+
+16.2.1 Blackboard bold
+----------------------
+
+Synopsis:
+
+ \usepackage{amssymb} % in preamble
+ ...
+ \mathbb{UPPERCASE-LETTER}
+
+ Provide blackboard bold symbols, sometimes also known as doublestruck
+letters, used to denote number sets such as the natural numbers, the
+integers, etc.
+
+ Here
+
+ \( \forall n \in \mathbb{N}, n^2 \geq 0 \)
+
+the '\mathbb{N}' gives blackboard bold symbol U+2115 representing the
+natural numbers.
+
+ If you use other than an uppercase letter then you do not get an
+error but you get strange results, including unexpected characters.
+
+ There are packages that give access to symbols other than just the
+capital letters; look on CTAN.
+
+
+File: latex2e.info, Node: Calligraphic, Next: \boldmath & \unboldmath, Prev: Blackboard bold, Up: Math symbols
+
+16.2.2 Calligraphic
+-------------------
+
+Synopsis:
+
+ \mathcal{UPPERCASE-LETTERS}
+
+ Use a script-like font.
+
+ In this example the graph identifier is output in a cursive font.
+
+ Let the graph be \( \mathcal{G} \).
+
+ If you use something other than an uppercase letter then you do not
+get an error. Instead you get unexpected output. For instance,
+'\mathcal{g}' outputs a close curly brace symbol, while '\mathcal{+}'
+outputs a plus sign.
+
+
+File: latex2e.info, Node: \boldmath & \unboldmath, Next: Dots, Prev: Calligraphic, Up: Math symbols
+
+16.2.3 '\boldmath' & '\unboldmath'
+----------------------------------
+
+Synopsis (used in paragraph mode or LR mode):
+
+ \boldmath \( MATH \)
+
+or
+
+ \unboldmath \( MATH \)
+
+ Declarations to change the letters and symbols in MATH to be in a
+bold font, or to countermand that and bring back the regular (non-bold)
+default. They must be used when not in math mode or display math mode
+(*note Modes::). Both commands are fragile (*note \protect::).
+
+ In this example each '\boldmath' command takes place inside an
+'\mbox',
+
+ we have $\mbox{\boldmath \( v \)} = 5\cdot\mbox{\boldmath \( u \)$}$
+
+which means '\boldmath' is only called in a text mode, here LR mode, and
+explains why LaTeX must switch to math mode to set 'v' and 'u'.
+
+ If you use either command inside math mode, as with 'Trouble: \(
+\boldmath x \)', then you get something like 'LaTeX Font Warning:
+Command \boldmath invalid in math mode on input line 11' and 'LaTeX Font
+Warning: Command \mathversion invalid in math mode on input line 11'.
+
+ There are many issues with '\boldmath'. New documents should use the
+'bm' package provided by the LaTeX Project team. A complete description
+is outside the scope of this document (see the full documentation on
+CTAN) but even this small example
+
+ \usepackage{bm} % in preamble
+ ...
+ we have $\bm{v} = 5\cdot\bm{u}$
+
+shows that it is an improvement over '\boldmath'.
+
+
+File: latex2e.info, Node: Dots, Prev: \boldmath & \unboldmath, Up: Math symbols
+
+16.2.4 Dots, horizontal or vertical
+-----------------------------------
+
+Ellipses are the three dots (usually three) indicating that a pattern
+continues.
+
+ \begin{array}{cccc}
+ a_{0,0} &a_{0,1} &a_{0,2} &\ldots \\
+ a_{1,0} &\ddots \\
+ \vdots
+ \end{array}
+
+ LaTeX provides these.
+
+'\cdots'
+ Horizontal ellipsis with the dots raised to the center of the line,
+ as in U+22EF. Used as: '\( a_0\cdot a_1\cdots a_{n-1} \)'.
+
+'\ddots'
+ Diagonal ellipsis, U+22F1. See the above array example for a
+ usage.
+
+'\ldots'
+ Ellipsis on the baseline, U+2026. Used as: '\( x_0,\ldots x_{n-1}
+ \)'. Another example is the above array example. A synonym is
+ '\mathellipsis'. A synonym from the 'amsmath' package is '\hdots'.
+
+ You can also use this command outside of mathematical text, as in
+ 'The gears, brakes, \ldots{} are all broken'. (In a paragraph mode
+ or LR mode a synonym for '\ldots' is '\dots'.)
+
+'\vdots'
+ Vertical ellipsis, U+22EE. See the above array example for a usage.
+
+ The 'amsmath' package has the command '\dots' to semantically mark up
+ellipses. This example produces two different-looking outputs for the
+first two uses of the '\dots' command.
+
+ \usepackage{amsmath} % in preamble
+ ...
+ Suppose that \( p_0, p_1, \dots, p_{n-1} \) lists all of the primes.
+ Observe that \( p_0\cdot p_1 \dots \cdot p_{n-1} +1 \) is not a
+ multiple of any \( p_i \).
+ Conclusion: there are infinitely many primes \( p_0, p_1, \dotsc \).
+
+In the first line LaTeX looks to the comma following '\dots' to
+determine that it should output an ellipsis on the baseline. The second
+line has a '\cdot' following '\dots' so LaTeX outputs an ellipsis that
+is on the math axis, vertically centered. However, the third usage has
+no follow-on character so you have to tell LaTeX what to do. You can
+use one of the commands: '\dotsc' if you need the ellipsis appropriate
+for a comma following, '\dotsb' if you need the ellipses that fits when
+the dots are followed by a binary operator or relation symbol, '\dotsi'
+for dots with integrals, or '\dotso' for others.

File: latex2e.info, Node: Math functions, Next: Math accents, Prev: Math symbols, Up: Math formulas
@@ -7293,109 +9497,117 @@ These commands produce roman function names in math mode with proper
spacing.
'\arccos'
- \arccos
+ Inverse cosine
'\arcsin'
- \arcsin
+ Inverse sine
'\arctan'
- \arctan
+ Inverse tangent
'\arg'
- \arg
+ Angle between the real axis and a point in the complex plane
'\bmod'
- Binary modulo operator (x \bmod y)
+ Binary modulo operator, used as in '\( 5\bmod 3=2 \)'
'\cos'
- \cos
+ Cosine
'\cosh'
- \cosh
+ Hyperbolic cosine
'\cot'
- \cot
+ Cotangent
'\coth'
- \coth
+ Hyperbolic cotangent
'\csc'
- \csc
+ Cosecant
'\deg'
- \deg
+ Degrees
'\det'
- \det
+ Determinant
'\dim'
- \dim
+ Dimension
'\exp'
- \exp
+ Exponential
'\gcd'
- \gcd
+ Greatest common divisor
'\hom'
- \hom
+ Homomorphism
'\inf'
- \inf
+ Infinum
'\ker'
- \ker
+ Kernel
'\lg'
- \lg
+ Base 2 logarithm
'\lim'
- \lim
+ Limit
'\liminf'
- \liminf
+ Limit inferior
'\limsup'
- \limsup
+ Limit superior
'\ln'
- \ln
+ Natural logarithm
'\log'
- \log
+ Logarithm
'\max'
- \max
+ Maximum
'\min'
- \min
+ Minimum
'\pmod'
- parenthesized modulus, as in (\pmod 2^n - 1)
+ Parenthesized modulus, as used in '\( 5\equiv 2\pmod 3 \)'
'\Pr'
- \Pr
+ Probability
'\sec'
- \sec
+ Secant
'\sin'
- \sin
+ Sine
'\sinh'
- \sinh
+ Hyperbolic sine
'\sup'
- \sup
+ sup
'\tan'
- \tan
+ Tangent
'\tanh'
- \tanh
+ Hyperbolic tangent
+
+ The 'amsmath' package adds improvements on some of these, and also
+allows you to define your own. The full documentation is on CTAN, but
+briefly, you can define an identity operator with
+'\DeclareMathOperator{\identity}{id}' that is like the ones above but
+prints as 'id'. The starred form '\DeclareMathOperator*{\op}{op}' sets
+any limits above and below, as is traditional with '\lim', '\sup', or
+'\max'.

-File: latex2e.info, Node: Math accents, Next: Spacing in math mode, Prev: Math functions, Up: Math formulas
+File: latex2e.info, Node: Math accents, Next: Over- and Underlining, Prev: Math functions, Up: Math formulas
16.4 Math accents
=================
@@ -7405,80 +9617,143 @@ math. These are different from accents in normal text (*note
Accents::).
'\acute'
- Math acute accent: \acute{x}.
+ Math acute accent
'\bar'
- Math bar-over accent: \bar{x}.
+ Math bar-over accent
'\breve'
- Math breve accent: \breve{x}.
+ Math breve accent
'\check'
- Math ha'c<ek (check) accent: \check{x}.
+ Math ha'c<ek (check) accent
'\ddot'
- Math dieresis accent: \ddot{x}.
+ Math dieresis accent
'\dot'
- Math dot accent: \dot{x}.
+ Math dot accent
'\grave'
- Math grave accent: \grave{x}.
+ Math grave accent
'\hat'
- Math hat (circumflex) accent: \hat{x}.
-
-'\imath'
- Math dotless i.
-
-'\jmath'
- Math dotless j.
+ Math hat (circumflex) accent
'\mathring'
- Math ring accent: x*.
+ Math ring accent
'\tilde'
- Math tilde accent: \tilde{x}.
+ Math tilde accent
'\vec'
- Math vector symbol: \vec{x}.
+ Math vector symbol
'\widehat'
- Math wide hat accent: \widehat{x+y}.
+ Math wide hat accent
'\widetilde'
- Math wide tilde accent: \widetilde{x+y}.
+ Math wide tilde accent
+
+ When you are putting an accent on an i or a j, the tradition is to
+use one without a dot, '\imath' or 'jmath' (*note Math symbols::).

-File: latex2e.info, Node: Spacing in math mode, Next: Math miscellany, Prev: Math accents, Up: Math formulas
+File: latex2e.info, Node: Over- and Underlining, Next: Spacing in math mode, Prev: Math accents, Up: Math formulas
-16.5 Spacing in math mode
+16.5 Over- and Underlining
+==========================
+
+LaTeX provides commands for making overlines or underlines, or putting
+braces over or under some material.
+
+'\underline{TEXT}'
+ Underline TEXT. Works inside math mode, and outside. The line is
+ always completely below the text, taking account of descenders, so
+ in '\(\underline{y}\)' the line is lower than in
+ '\(\underline{x}\)'. This command is fragile (*note \protect::).
+
+ Note that the package 'ulem' does text mode underlining and allows
+ line breaking as well as a number of other features. See the
+ documentation on CTAN. See also *note \hrulefill & \dotfill:: for
+ producing a line, for such things as a signature.
+
+'\overline{TEXT}'
+ Put a horizontal line over TEXT. Works inside math mode, and
+ outside. For example, '\overline{x+y}'. Note that this differs
+ from the command '\bar' (*note Math accents::).
+
+'\underbrace{MATH}'
+ Put a brace under MATH. For example, this
+ '(1-\underbrace{1/2)+(1/2}-1/3)' emphasizes the telescoping part.
+ Attach text to the brace by using subscript, '_', or superscript,
+ '^', as here.
+
+ \begin{displaymath}
+ 1+1/2+\underbrace{1/3+1/4}_{>1/2}+
+ \underbrace{1/5+1/6+1/7+1/8}_{>1/2}+\cdots
+ \end{displaymath}
+
+ The superscript appears on top of the expression, and so can look
+ unconnected to the underbrace.
+
+'\overbrace{MATH}'
+ Put a brace over MATH, as with
+ '\overbrace{x+x+\cdots+x}^{\mbox{\(k\) times}}'. See also
+ '\underbrace'.
+
+ The package 'mathtools' adds an over- and underbrace, as well as some
+improvements on the braces. See the documentation on CTAN.
+
+
+File: latex2e.info, Node: Spacing in math mode, Next: Math miscellany, Prev: Over- and Underlining, Up: Math formulas
+
+16.6 Spacing in math mode
=========================
-In a 'math' environment, LaTeX ignores the spaces that you use in the
-source, and instead puts in the spacing according to the normal rules
-for mathematics texts.
+When typesetting mathematics, LaTeX puts in spacing according to the
+normal rules for mathematics texts. If you enter 'y=m x' then LaTeX
+ignores the space and in the output the m is next to the x, as y=mx.
- Many math mode spacing definitions are expressed in terms of the math
-unit "mu" given by 1 em = 18 mu, where the em is taken from the current
-math symbols family (*note Units of length::). LaTeX provides the
-following commands for use in math mode:
+ But LaTeX's rules sometimes need tweaking. For example, in an
+integral the tradition is to put a small extra space between the 'f(x)'
+and the 'dx', here done with the '\,' command.
+
+ \int_0^1 f(x)\,dx
+
+ LaTeX provides the commands that follow for use in math mode. Many
+of these spacing definitions are expressed in terms of the math unit
+"mu". It is defined as 1/18em, where the em is taken from the current
+math symbols family (*note Units of length::). Thus, a '\thickspace' is
+something like 5/18 times the width of a 'M'.
'\;'
- Normally '5.0mu plus 5.0mu'. The longer name is '\thickspace'.
- Math mode only.
+ Synonym: '\thickspace'. Normally '5.0mu plus 5.0mu'. Math mode
+ only.
'\:'
'\>'
- Normally '4.0mu plus 2.0mu minus 4.0mu'. The longer name is
- '\medspace'. Math mode only.
+ Synonym: '\medspace'. Normally '4.0mu plus 2.0mu minus 4.0mu'.
+ Math mode only.
'\,'
- Normally '3mu'. The longer name is '\thinspace'. This can be used
- in both math mode and text mode. *Note \thinspace::.
+ Synonym: '\thinspace'. Normally '3mu', which is 1/6em. Can be
+ used in both math mode and text mode (*note \thinspace &
+ \negthinspace::).
+
+ This space is widely used, for instance between the function and
+ the infinitesimal in an integral '\int f(x)\,dx' and, if an author
+ does this, before punctuation in a displayed equation.
+
+ The antiderivative is
+ \begin{equation}
+ 3x^{-1/2}+3^{1/2}\,.
+ \end{equation}
'\!'
- A negative thin space. Normally '-3mu'. Math mode only.
+ A negative thin space. Normally '-3mu'. The '\!' command is math
+ mode only but the '\negthinspace' command is available for text
+ mode (*note \thinspace & \negthinspace::).
'\quad'
This is 18mu, that is, 1em. This is often used for space
@@ -7490,139 +9765,203 @@ following commands for use in math mode:
A length of 2 quads, that is, 36mu = 2em. It is available in both
text and math mode.
- In this example a thinspace separates the function from the
-infinitesimal.
-
- \int_0^1 f(x)\,dx
-

File: latex2e.info, Node: Math miscellany, Prev: Spacing in math mode, Up: Math formulas
-16.6 Math miscellany
+16.7 Math miscellany
====================
-'\*'
- A "discretionary" multiplication symbol, at which a line break is
- allowed. Without the break multiplication is implicitly indicated
- by a space, while in the case of a break a U+00D7 symbol is printed
- immediately before the break. So
+LaTeX contains a wide variety of mathematics facilities. Here are some
+that don't fit into other categories.
- \documentclass{article}
- \begin{document}
- Now \(A_3 = 0\), hence the product of all terms \(A_1\)
- through \(A_4\), that is \(A_1\* A_2\* A_3 \* A_4\), is
- equal to zero.
- \end{document}
+* Menu:
- will make that sort of output (the ellipsis '[...]' is here to show
- the line break at the same place as in a TeX output):
+* Colon character & \colon:: Colon.
+* \*:: Discretionary multiplication.
+* \frac:: Fraction.
+* \left & \right:: Paired delimiters.
+* \sqrt:: Radicals.
+* \stackrel:: Text over a relation.
- Now A_3 = 0, [...] A_1 through A_4, that is A_1 A_2 \times
- A_3 A_4, is equal to zero.
+
+File: latex2e.info, Node: Colon character & \colon, Next: \*, Up: Math miscellany
-'\cdots'
- A horizontal ellipsis with the dots raised to the center of the
- line.
+16.7.1 Colon character ':' & '\colon'
+-------------------------------------
-'\ddots'
- A diagonal ellipsis: \ddots.
+Synopsis, one of:
-'\frac{NUM}{DEN}'
- Produces the fraction NUM divided by DEN.
+ :
+ \colon
-'\left DELIM1 ... \right DELIM2'
- The two delimiters need not match; '.' acts as a "null delimiter",
- producing no output. The delimiters are sized according to the
- math in between. Example: '\left( \sum_{i=1}^{10} a_i \right]'.
+ In mathematics, the colon character, ':', is a relation.
-'\mathdollar'
- Dollar sign in math mode: $.
+ With side ratios \( 3:4 \) and \( 4:5 \), the triangle is right.
-'\mathellipsis'
- Ellipsis (spaced for text) in math mode: ....
+Ordinary LaTeX defines '\colon' to produce the colon character with the
+spacing appropriate for punctuation, as in set-builder notation
+'\{x\colon 0\leq x<1\}'.
-'\mathparagraph'
- Paragraph sign (pilcrow) in math mode: U+00B6.
+ But the widely-used 'amsmath' package defines '\colon' for use in the
+definition of functions 'f\colon D\to C'. So if you want the colon
+character as a punctuation then use '\mathpunct{:}'.
-'\mathsection'
- Section sign in math mode.
+
+File: latex2e.info, Node: \*, Next: \frac, Prev: Colon character & \colon, Up: Math miscellany
-'\mathsterling'
- Sterling sign in math mode: #.
+16.7.2 '\*'
+-----------
-'\mathunderscore'
- Underscore in math mode: _.
+Synopsis:
-'\overbrace{MATH}'
- Generates a brace over MATH. For example,
- '\overbrace{x+\cdots+x}^{k \;\textrm{times}}'.
+ \*
-'\overline{TEXT}'
- Generates a horizontal line over TEX. For example,
- '\overline{x+y}'.
+ A multiplication symbol that allows a line break. If there is a
+break then LaTeX puts a '\times' symbol, U+00D7, before that break.
-'\sqrt[ROOT]{ARG}'
- Produces the representation of the square root of ARG. The
- optional argument ROOT determines what root to produce. For
- example, the cube root of 'x+y' would be typed as '\sqrt[3]{x+y}'.
+ In '\( A_1\* A_2\* A_3\* A_4 \)', if there is no line break then
+LaTeX outputs it as though it were '\( A_1 A_2 A_3 A_4 \)'. If a line
+break does happen, for example between the two middle ones, then LaTeX
+sets it like '\( A_1 A_2 \times \)', followed by the break, followed by
+'\( A_3 A_4 \)'.
-'\stackrel{TEXT}{RELATION}'
- Puts TEXT above RELATION. For example,
- '\stackrel{f}{\longrightarrow}'.
+
+File: latex2e.info, Node: \frac, Next: \left & \right, Prev: \*, Up: Math miscellany
-'\underbrace{MATH}'
- Generates MATH with a brace underneath. For example,
- '\underbrace{x+y+z}_{>\,0}'
+16.7.3 '\frac'
+--------------
-'\underline{TEXT}'
- Causes TEXT, which may be either math mode or not, to be
- underlined. The line is always below the text, taking account of
- descenders.
+Synopsis:
-'\vdots'
- Produces a vertical ellipsis.
+ \frac{NUMERATOR}{DENOMINATOR}
+
+ Produces the fraction. Used as: '\begin{displaymath}
+\frac{1}{\sqrt{2\pi\sigma}} \end{displaymath}'. In inline math mode it
+comes out small; see the discussion of '\displaystyle' (*note Math
+formulas::).

-File: latex2e.info, Node: Modes, Next: Page styles, Prev: Math formulas, Up: Top
+File: latex2e.info, Node: \left & \right, Next: \sqrt, Prev: \frac, Up: Math miscellany
-17 Modes
-********
+16.7.4 '\left' & '\right'
+-------------------------
-When LaTeX is processing your input text, it is always in one of three
-modes:
+Synopsis:
- * Paragraph mode
- * Math mode
- * Left-to-right mode, called LR mode for short
+ \left DELIMITER1 ... \right DELIMITER2
- Mode changes occur only when entering or leaving an environment, or
-when LaTeX is processing the argument of certain text-producing
-commands.
+ Make matching parentheses, braces, or other delimiters. The
+delimiters are sized according to the math they enclose. This makes a
+unit vector surrounded by appropriate-height parentheses.
+
+ \begin{equation}
+ \left(\begin{array}{c}
+ 1 \\
+ 0 \\
+ \end{array}\right)
+
+ Every '\left' must have a matching '\right'. Leaving out the
+'\left(' in the above gets 'Extra \right'. Leaving off the '\right)'
+gets 'You can't use `\eqno' in math mode'.
+
+ However, the two delimiters DELIMITER1 and DELIMITER2 need not match.
+A common case is that you want an unmatched brace, as below. Use a
+period, '.', as a null delimiter.
+
+ \begin{equation}
+ f(n)=\left\{\begin{array}{ll}
+ 1 &\mbox{--if \(n=0\)} \\
+ f(n-1)+3n^2 &\mbox{--else}
+ \end{array}\right.
+ \end{equation}
+
+Note that to get a curly brace as a delimiter you must prefix it with a
+backslash, '\{'.
+
+
+File: latex2e.info, Node: \sqrt, Next: \stackrel, Prev: \left & \right, Up: Math miscellany
+
+16.7.5 '\sqrt'
+--------------
+
+Synopsis, one of:
+
+ \sqrt{ARG}
+ \sqrt[ROOT-NUMBER]{ARG}
+
+ The square root, or optionally other roots, of ARG. The optional
+argument ROOT-NUMBER gives the root, i.e., enter the cube root of 'x+y'
+as '\sqrt[3]{x+y}'. The radical grows with the size of ARG (as the
+height of the radical grows, the angle on the leftmost part gets
+steeper, until for a large enough 'arg', it is vertical).
+
+ LaTeX has a separate '\surd' character (*note Math symbols::).
+
+
+File: latex2e.info, Node: \stackrel, Prev: \sqrt, Up: Math miscellany
+
+16.7.6 '\stackrel'
+------------------
+
+Synopsis, one of:
+
+ \stackrel{TEXT}{RELATION}
+
+ Put TEXT above RELATION. To put a function name above an arrow enter
+'\stackrel{f}{\longrightarrow}'.
+
+
+File: latex2e.info, Node: Modes, Next: Page styles, Prev: Math formulas, Up: Top
- "Paragraph mode" is the most common; it's the one LaTeX is in when
-processing ordinary text. In this mode, LaTeX breaks the input text
-into lines and breaks the lines into pages.
-
- LaTeX is in "math mode" when it's generating a mathematical formula,
-either displayed math or within a line.
-
- In "LR mode", as in paragraph mode, LaTeX considers the output that
-it produces to be a string of words with spaces between them. However,
-unlike paragraph mode, LaTeX keeps going from left to right; it never
-starts a new line in LR mode. Even if you put a hundred words into an
-'\mbox', LaTeX would keep typesetting them from left to right inside a
-single box (and then most likely complain because the resulting box was
-too wide to fit on the line). LaTeX is in LR mode when it starts making
-a box with an '\mbox' command. You can get it to enter a different mode
-inside the box--for example, you can make it enter math mode to put a
-formula in the box.
-
- There are also several text-producing commands and environments for
-making a box that put LaTeX into paragraph mode. The box made by one of
-these commands or environments will be called a 'parbox'. When LaTeX is
-in paragraph mode while making a box, it is said to be in "inner
-paragraph mode" (no page breaks). Its normal paragraph mode, which it
-starts out in, is called "outer paragraph mode".
+17 Modes
+********
+
+As LaTeX processes your document, at any point it is in one of six
+modes. They fall into three categories of two each, the horizontal
+modes, the math modes, and the vertical modes. Some commands only work
+in one mode or another (in particular, many commands only work in one of
+the math modes), and error messages will refer to these.
+
+ * "Paragraph mode" is what LaTeX is in when processing ordinary text.
+ It breaks the input text into lines and breaks the lines into
+ pages. This is the mode LaTeX is in most of the time.
+
+ "LR mode" (for left-to-right mode; in plain TeX this is called
+ "restricted horizontal mode") is in effect when LaTeX starts making
+ a box with an '\mbox' command. As in paragraph mode, LaTeX's
+ output is a string of words with spaces between them. Unlike in
+ paragraph mode, in LR mode LaTeX never starts a new line, it just
+ keeps going from left to right. (Although LaTeX will not complain
+ that the LR box is too long, when it is finished and next tries to
+ put that box into a line, it could very well complain that the
+ finished LR box won't fit there.)
+
+ * "Math mode" is when LaTeX is generating an inline mathematical
+ formula.
+
+ "Display math mode" is when LaTeX is generating a displayed
+ mathematical formula. (Displayed formulas differ somewhat from
+ inline ones. One example is that the placement of the subscript on
+ '\int' differs in the two situations.)
+
+ * "Vertical mode" is when LaTeX is building the list of lines and
+ other material making the output page. This is the mode LaTeX is
+ in when it starts a document.
+
+ "Internal vertical mode" is in effect when LaTeX starts making a
+ '\vbox'. This is the vertical analogue of LR mode.
+
+For instance, if you begin a LaTeX article with 'Let \( x \) be ...'
+then these are the modes: first LaTeX starts every document in vertical
+mode, then it reads the 'L' and switches to paragraph mode, then the
+next switch happens at the '\(' where LaTeX changes to math mode, and
+then when it leaves the formula it pops back to paragraph mode.
+
+ Paragraph mode has two subcases. If you use a '\parbox' command or
+or a 'minipage' then LaTeX is put into paragraph mode. But it will not
+put a page break here. Inside one of these boxes, called a "parbox",
+LaTeX is in "inner paragraph mode". Its more usual situation, where it
+can put page breaks, is "outer paragraph mode" (*note Page breaking::).
* Menu:
@@ -7638,29 +9977,22 @@ Synopsis:
\ensuremath{FORMULA}
- The '\ensuremath' command ensures that FORMULA is typeset in math
-mode whatever the current mode in which the command is used.
+ Ensure that FORMULA is typeset in math mode.
- For instance:
+ For instance, you can redefine commands that ordinarily can be used
+only in math mode, so that they can be used both in math and in plain
+text.
- \documentclass{report}
- \newcommand{\ab}{\ensuremath{(\delta, \varepsilon)}}
- \begin{document}
- Now, the \ab\ pair is equal to \(\ab = (\frac{1}{\pi}, 0)\), ...
- \end{document}
+ \newcommand{\dx}{\ensuremath{dx}}
+ In $\int f(x)\, \dx$, the \dx{} is an infinitesimal.
- One can redefine commands that can be used only in math mode so that
-they ca be used in any mode like in the following example given for
-'\leadsto':
+ Caution: the '\ensuremath' command is useful but not a panacea.
- \documentclass{report}
- \usepackage{amssymb}
- \newcommand{\originalMeaningOfLeadsTo}{}
- \let\originalMeaningOfLeadsTo\leadsto
- \renewcommand\leadsto{\ensuremath{\originalMeaningOfLeadsTo}}
- \begin{document}
- All roads \leadsto\ Rome.
- \end{document}
+ \newcommand{\alf}{\ensuremath{\alpha}}
+ You get an alpha in text mode: \alf.
+ But compare the correct spacing in $\alf+\alf$ with that in \alf+\alf.
+
+Best is to typeset math things in a math mode.

File: latex2e.info, Node: Page styles, Next: Spaces, Prev: Modes, Up: Top
@@ -7668,8 +10000,14 @@ File: latex2e.info, Node: Page styles, Next: Spaces, Prev: Modes, Up: Top
18 Page styles
**************
-The '\documentclass' command determines the size and position of the
-page's head and foot. The page style determines what goes in them.
+The style of a page determines where LaTeX places the components of that
+page, such as headers and footers, and the text body. This includes
+pages in the main part of the document but also includes special pages
+such as the title page of a book, a page from an index, or the first
+page of an article.
+
+ The package 'fancyhdr' is very helpful for constructing page styles.
+See its documentation on CTAN.
* Menu:
@@ -7684,28 +10022,73 @@ File: latex2e.info, Node: \maketitle, Next: \pagenumbering, Up: Page styles
18.1 '\maketitle'
=================
-The '\maketitle' command generates a title on a separate title
-page--except in the 'article' class, where the title is placed at the
-top of the first page. Information used to produce the title is
-obtained from the following declarations:
+Synopsis:
+
+ \maketitle
+
+ Generate a title. In the standard classes the title appears on a
+separate page, except in the 'article' class where it is at the top of
+the first page. (*Note Document class options:: for information about
+the 'titlepage' document class option.)
-'\author{NAME \and NAME2}'
- The '\author' command declares the document author(s), where the
- argument is a list of authors separated by '\and' commands. Use
- '\\' to separate lines within a single author's entry--for example,
- to give the author's institution or address.
+ This example shows '\maketitle' appearing in its usual place,
+immediately after '\begin{document}'.
+
+ \documentclass{article}
+ \title{Constructing a Nuclear Reactor Using Only Coconuts}
+ \author{Jonas Grumby\thanks{%
+ With the support of a Ginger Grant from the Roy Hinkley Society.} \\
+ Skipper, \textit{Minnow}
+ \and
+ Willy Gilligan\thanks{%
+ Thanks to the Mary Ann Summers foundation
+ and to Thurston and Lovey Howell.} \\
+ Mate, \textit{Minnow}
+ }
+ \date{1964-Sep-26}
+ \begin{document}
+ \maketitle
+ Just sit right back and you'll hear a tale, a tale of a fateful trip.
+ That started from this tropic port, aboard this tiny ship. The mate was
+ a mighty sailin' man, the Skipper brave and sure. Five passengers set
+ sail that day for a three hour tour. A three hour tour.
+ ...
+
+ You tell LaTeX the information used to produce the title by making
+the following declarations. These must come before the '\maketitle',
+either in the preamble or in the document body.
+
+'\author{NAME1 \and NAME2 \and ...}'
+ Required. Declare the document author or authors. The argument is
+ a list of authors separated by '\and' commands. To separate lines
+ within a single author's entry, for instance to give the author's
+ institution or address, use a double backslash, '\\'. If you omit
+ the '\author' declaration then you get 'LaTeX Warning: No \author
+ given'.
'\date{TEXT}'
- The '\date' command declares TEXT to be the document's date. With
- no '\date' command, the current date (*note \today::) is used.
+ Optional. Declare TEXT to be the document's date. The TEXT
+ doesn't need to be in a date format; it can be any text at all. If
+ you omit '\date' then LaTeX uses the current date (*note \today::).
+ To have no date, instead use '\date{}'.
'\thanks{TEXT}'
- The '\thanks' command produces a '\footnote' to the title, usually
- used for credit acknowledgements.
+ Optional. Produce a footnote. You can use it in the author
+ information for acknowledgements, as illustrated below, but you can
+ also use it in the title, or any place a footnote makes sense. It
+ can be any text so you can use it to print an email address, or for
+ any purpose.
'\title{TEXT}'
- The '\title' command declares TEXT to be the title of the document.
- Use '\\' to force a line break, as usual.
+ Required. Declare TEXT to be the title of the document. Get line
+ breaks inside TEXT with a double backslash, '\\'. If you omit the
+ '\title' declaration then you get 'LaTeX Error: No \title given'.
+
+ Many publishers will provide a class to use in place of 'article' in
+that example, that formats the title according to their house
+requirements. To make your own, see *note titlepage::. You can either
+create this as a one-off or you can include it as part of a renewed
+'\maketitle' command.

File: latex2e.info, Node: \pagenumbering, Next: \pagestyle, Prev: \maketitle, Up: Page styles
@@ -7715,25 +10098,57 @@ File: latex2e.info, Node: \pagenumbering, Next: \pagestyle, Prev: \maketitle,
Synopsis:
- \pagenumbering{STYLE}
+ \pagenumbering{NUMBER-STYLE}
- Specifies the style of page numbers, according to STYLE; also resets
-the page number to 1. The STYLE argument is one of the following:
+ Specifies the style of page numbers, and resets the page number. The
+numbering style is reflected on the page, and also in the table of
+contents and other page references. This declaration has global scope
+so its effect is not delimited by braces or environments.
+
+ In this example, before the Main section the pages are numbered 'a',
+etc. Starting on the page containing that section, the pages are
+numbered '1', etc.
+
+ \begin{document}\pagenumbering{alph}
+ ...
+ \section{Main}\pagenumbering{arabic}
+ ...
+
+ The argument NUMBER-STYLE is one of the following (see also *note
+\alph \Alph \arabic \roman \Roman \fnsymbol::).
'arabic'
- arabic numerals
+ arabic numerals: 1, 2, ...
'roman'
- lowercase Roman numerals
+ lowercase Roman numerals: i, ii, ...
'Roman'
- uppercase Roman numerals
+ uppercase Roman numerals: I, II, ...
'alph'
- lowercase letters
+ lowercase letters: a, b, ... If you have more than 26 pages then
+ you get 'LaTeX Error: Counter too large'.
'Alph'
- uppercase letters
+ uppercase letters: A, B, ... If you have more than 26 pages then
+ you get 'LaTeX Error: Counter too large'.
+
+'gobble'
+ LaTeX does not output a page number, although it does get reset.
+ References to that page also are blank. (This does not work with
+ the popular package 'hyperref' so to have the page number not
+ appear you may want to instead use '\pagestyle{empty}' or
+ '\thispagestyle{empty}'.)
+
+ Traditionally, if a document has front matter--preface, table of
+contents, etc.--then it is numbered with lowercase Roman numerals. The
+main matter of a document uses arabic. *Note \frontmatter & \mainmatter
+& \backmatter::.
+
+ If you want to address where the page number appears on the page,
+see *note \pagestyle::. If you want to change the value of page number
+then you will manipulate the 'page' counter (*note Counters::).

File: latex2e.info, Node: \pagestyle, Next: \thispagestyle, Prev: \pagenumbering, Up: Page styles
@@ -7745,44 +10160,113 @@ Synopsis:
\pagestyle{STYLE}
- The '\pagestyle' command specifies how the headers and footers are
-typeset from the current page onwards. Values for STYLE:
+ Declaration that specifies how the page headers and footers are
+typeset, from the current page onwards.
+
+ A discussion with an example is below. Note first that the package
+'fancyhdr' is now the standard way to manipulate headers and footers.
+New documents that need to do anything other than one of the standard
+options below should use this package. See its documentation on CTAN.
+
+ Values for STYLE:
'plain'
- Just a plain page number.
+ The header is empty. The footer contains only a page number,
+ centered.
'empty'
- Empty headers and footers, e.g., no page numbers.
+ The header and footer is empty.
'headings'
- Put running headers on each page. The document style specifies
- what goes in the headers.
+ Put running headers and footers on each page. The document style
+ specifies what goes in there; see the discussion below.
'myheadings'
Custom headers, specified via the '\markboth' or the '\markright'
commands.
+ Some discussion of the motivation for LaTeX's mechanism will help you
+work with the options 'headings' or 'myheadings'. The document source
+below produces an article, two-sided, with the pagestyle 'headings'. On
+this document's left hand pages, LaTeX wants (in addition to the page
+number) the title of the current section. On its right hand pages LaTeX
+wants the title of the current subsection. When it makes up a page,
+LaTeX gets this information from the commands '\leftmark' and
+'\rightmark'. So it is up to '\section' and '\subsection' to store that
+information there.
+
+ \documentclass[twoside]{article}
+ \pagestyle{headings}
+ \begin{document}
+ ... \section{Section 1} ... \subsection{Subsection 1.1} ...
+ \section{Section 2}
+ ...
+ \subsection{Subsection 2.1}
+ ...
+ \subsection{Subsection 2.2}
+ ...
+
+Suppose that the second section falls on a left page. Although when the
+page starts it is in the first section, LaTeX will put 'Section 2' in
+the left page header. As to the right header, if no subsection starts
+before the end of the right page then LaTeX blanks the right hand
+header. If a subsection does appear before the right page finishes then
+there are two cases. If at least one subsection starts on the right
+hand page then LaTeX will put in the right header the title of the first
+subsection starting on that right page. If at least one of 2.1, 2.2,
+..., starts on the left page but none starts on the right then LaTeX
+puts in the right hand header the title of the last subsection to start,
+that is, the one in effect during the right hand page.
+
+ To accomplish this, in a two-sided article, LaTeX has '\section'
+issue a command '\markboth', setting '\leftmark' to 'Section 2' and
+setting '\rightmark' to blank. And, LaTeX has '\subsection' issue a
+command '\markright', setting '\rightmark' to 'Subsection 2.1', etc.
+
Here are the descriptions of '\markboth' and '\markright':
-'\markboth{LEFT}{RIGHT}'
- Sets both the left and the right heading. A "left-hand heading"
- (LEFT) is generated by the last '\markboth' command before the end
- of the page, while a "right-hand heading" (RIGHT) is generated by
- the first '\markboth' or '\markright' that comes on the page if
- there is one, otherwise by the last one before the page.
+'\markboth{LEFT-HEAD}{RIGHT-HEAD}'
+ Sets both the right hand and left hand heading information for
+ either a page style of 'headings' or 'myheadings'. A left hand
+ page heading LEFT-HEAD is generated by the last '\markboth' command
+ before the end of the page. A right hand page heading RIGHT-HEAD
+ is generated by the first '\markboth' or '\markright' that comes on
+ the page if there is one, otherwise by the last one that came
+ before that page.
'\markright{RIGHT}'
- Sets the right heading, leaving the left heading unchanged.
+ Sets the right hand page heading, leaving the left unchanged.

File: latex2e.info, Node: \thispagestyle, Prev: \pagestyle, Up: Page styles
-18.4 '\thispagestyle{STYLE}'
-============================
+18.4 '\thispagestyle'
+=====================
+
+Synopsis:
+
+ \thispagestyle{STYLE}
+
+ Works in the same way as the '\pagestyle' (*note \pagestyle::),
+except that it changes to STYLE for the current page only. This
+declaration has global scope, so its effect is not delimited by braces
+or environments.
+
+ Often the first page of a chapter or section has a different style.
+For example, this LaTeX book document has the first page of the first
+chapter in in 'plain' style, as is the default (*note Page styles::).
+
+ \documentclass{book}
+ \pagestyle{headings}
+ \begin{document}
+ \chapter{First chapter}
+ ...
+ \chapter{Second chapter}\thispagestyle{empty}
+ ...
-The '\thispagestyle' command works in the same manner as the
-'\pagestyle' command (see previous section) except that it changes to
-STYLE for the current page only.
+The 'plain' style has a page number on it, centered in the footer. To
+make the page entirely empty, the command '\thispagestyle{empty}'
+immediately follows the second '\chapter'.

File: latex2e.info, Node: Spaces, Next: Boxes, Prev: Page styles, Up: Top
@@ -7790,96 +10274,205 @@ File: latex2e.info, Node: Spaces, Next: Boxes, Prev: Page styles, Up: Top
19 Spaces
*********
-LaTeX has many ways to produce white (or filled) space.
+LaTeX has many ways to produce white (or filled) space. Some of these
+are best suited to mathematical text; see *note Spacing in math mode::.
+Some spacing commands are suitable for both regular text and
+mathematical text; versions of some of these commands are in this
+chapter.
* Menu:
Horizontal space
-* \hspace:: Fixed horizontal space.
-* \hfill:: Stretchable horizontal space.
-* \spacefactor:: Stretchability of following space
-* \(SPACE) after control sequence:: Space (gobbling) after a control sequence.
-* \thinspace:: One-sixth of an em.
-* \/:: Insert italic correction.
-* \hrulefill \dotfill:: Stretchable horizontal rule or dots.
+* \enspace & \quad & \qquad:: Traditional horizontal spaces.
+* \hspace:: Any horizontal space.
+* \hfill:: Stretchable horizontal space.
+* \hss:: Infinitely stretchable/shrinkable horizontal space.
+* \spacefactor:: Stretchability of following space
+* \(SPACE):: Backslash-space; and explicit space.
+* ~:: Tie, an unbreakable space.
+* \thinspace & \negthinspace:: One-sixth of an em, and negative one-sixth.
+* \/:: Italic correction.
+* \hrulefill & \dotfill:: Stretchable horizontal rule or dots.
Vertical space
-* \addvspace:: Add arbitrary vertical space if needed.
-* \bigskip \medskip \smallskip:: Fixed vertical spaces.
-* \vfill:: Infinitely stretchable vertical space.
-* \vspace:: Add arbitrary vertical space.
+* \bigskip & \medskip & \smallskip:: Inter-paragraph vertical spaces.
+* \bigbreak & \medbreak & \smallbreak:: Inter-paragraph space and page breaks.
+* \strut:: Ensure height of a line.
+* \vspace:: Vertical space.
+* \vfill:: Stretchable vertical space.
+* \addvspace:: Add arbitrary vertical space if needed.

-File: latex2e.info, Node: \hspace, Next: \hfill, Up: Spaces
+File: latex2e.info, Node: \enspace & \quad & \qquad, Next: \hspace, Up: Spaces
-19.1 '\hspace'
+19.1 '\enspace' & '\quad' & '\qquad'
+====================================
+
+Synopsis, one of:
+
+ \enspace
+ \quad
+ \qquad
+
+ Insert a horizontal space of 1/2em, 1em, or 2em. The em is a length
+defined by a font designer, often thought of as being the width of a
+capital M. One advantage of describing space in ems is that it can be
+more portable across documents than an absolute measurement such as
+points (*note Lengths/em::).
+
+ This puts a suitable gap between two graphics.
+
+ \begin{center}
+ \includegraphics{womensmile.png}%
+ \qquad\includegraphics{mensmile.png}
+ \end{center}
+
+*Note Spacing in math mode:: for '\quad' and '\qquad'. These are
+lengths from centuries of typesetting and so may be a better choice in
+many circumstances than arbitrary lengths, such as you get with
+'\hspace'.
+
+
+File: latex2e.info, Node: \hspace, Next: \hfill, Prev: \enspace & \quad & \qquad, Up: Spaces
+
+19.2 '\hspace'
==============
-Synopsis:
+Synopsis, one of:
\hspace{LENGTH}
\hspace*{LENGTH}
- Add the horizontal space given by LENGTH. The LENGTH is a rubber
-length, that is, it may contain a 'plus' or 'minus' component, in any
-unit that LaTeX understands (*note Lengths::).
+ Insert the horizontal space LENGTH. The LENGTH can be positive,
+negative, or zero; adding negative space is like backspacing. It is a
+rubber length, that is, it may contain a 'plus' or 'minus' component, or
+both (*note Lengths::). Because the space is stretchable and
+shrinkable, it is sometimes called "glue".
+
+ This makes a line with 'Name:' an inch from the right margin.
+
+ \noindent\makebox[\linewidth][r]{Name:\hspace{1in}}
+
+ The '*'-version inserts horizontal space that non-discardable. More
+precisely, when TeX breaks a paragraph into lines any white space--glues
+and kerns--that come at a line break are discarded. The '*'-version
+avoids that (technically, it adds a non-discardable invisible item in
+front of the space).
+
+ In this example
- This command can add both positive and negative space; adding
-negative space is like backspacing.
+ \parbox{0.8\linewidth}{%
+ Fill in each blank: Four \hspace*{1in} and seven years ago our
+ fathers brought forth on this continent, a new \hspace*{1in},
+ conceived in \hspace*{1in}, and dedicated to the proposition
+ that all men are created \hspace*{1in}.}
- Normally when TeX breaks a paragraph into lines it discards white
-space (glues and kerns) that would come at the start of a line, so you
-get an inter-word space or a line break between words but not both.
-This command's starred version '\hspace*{...}' puts a non-discardable
-invisible item in front of the space, so the space appears in the
-output.
+the 1 inch blank following 'conceived in' falls at the start of a line.
+If you erase the '*' then LaTeX discards the blank.
- This example make a one-line paragraph that puts 'Name:' an inch from
-the right margin.
+ Here, the '\hspace' separates the three graphics.
- \noindent\makebox[\linewidth]{\hspace{\fill}Name:\hspace{1in}}
+ \begin{center}
+ \includegraphics{lion.png}% comment keeps out extra space
+ \hspace{1cm minus 0.25cm}\includegraphics{tiger.png}%
+ \hspace{1cm minus 0.25cm}\includegraphics{bear.png}
+ \end{center}
+
+Because the argument to each '\hspace' has 'minus 0.25cm', each can
+shrink a little if the three figures are too wide. But each space won't
+shrink more than 0.25cm (*note Lengths::).

-File: latex2e.info, Node: \hfill, Next: \spacefactor, Prev: \hspace, Up: Spaces
+File: latex2e.info, Node: \hfill, Next: \hss, Prev: \hspace, Up: Spaces
-19.2 '\hfill'
+19.3 '\hfill'
=============
-Produce a rubber length which has no natural space but can stretch
-horizontally as far as needed (*note Lengths::).
+Synopsis:
+
+ \hfill
+
+ Produce a rubber length which has no natural space but that can
+stretch horizontally as far as needed (*note Lengths::).
- The command '\hfill' is equivalent to '\hspace{\fill}'. For space
-that does not disappear at line breaks use '\hspace*{\fill}' instead
-(*note \hspace::).
+ This creates a one-line paragraph with 'Name:' on the left side of
+the page and 'Quiz One' on the right.
+
+ \noindent Name:\hfill Quiz One
+
+ The '\hfill' command is equivalent to '\hspace{\fill}' and so the
+space can be discarded at line breaks. To avoid that instead use
+'\hspace*{\fill}' (*note \hspace::).
+
+ Here the graphs are evenly spaced in the middle of the figure.
+
+ \newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
+ ...
+ \begin{figure}
+ \hspace*{\fill}%
+ \vcenteredhbox{\includegraphics{graph0.png}}%
+ \hfill\vcenteredhbox{\includegraphics{graph1.png}}%
+ \hspace*{\fill}%
+ \caption{Comparison of two graphs} \label{fig:twographs}
+ \end{figure}
+
+Note the '\hspace*''s where the space could otherwise be dropped.
+
+
+File: latex2e.info, Node: \hss, Next: \spacefactor, Prev: \hfill, Up: Spaces
+
+19.4 '\hss'
+===========
+
+Synopsis:
+
+ \hss
+
+ Produce a horizontal space that is infinitely shrinkable as well as
+infinitely stretchable (this command is a TeX primitive). LaTeX authors
+should reach first for the '\makebox' command to get the effects of
+'\hss' (*note \mbox & \makebox::).
+
+ Here, the first line's '\hss' makes the Z stick out to the right,
+overwriting the Y. In the second line the Z sticks out to the left,
+overwriting the X.
+
+ X\hbox to 0pt{Z\hss}Y
+ X\hbox to 0pt{\hss Z}Y
+
+Without the '\hss' you get something like 'Overfull \hbox (6.11111pt too
+wide) detected at line 20'.

-File: latex2e.info, Node: \spacefactor, Next: \(SPACE) after control sequence, Prev: \hfill, Up: Spaces
+File: latex2e.info, Node: \spacefactor, Next: \(SPACE), Prev: \hss, Up: Spaces
-19.3 '\spacefactor'
+19.5 '\spacefactor'
===================
Synopsis:
\spacefactor=INTEGER
- While LaTeX is making the page, to give the lines the best appearance
-it may stretch or shrink the gaps between words. The '\spacefactor'
-command (from Plain TeX) allows you to change the LaTeX's default
-behavior.
+ Influence LaTeX's glue stretch and shrink behavior. Most user-level
+documents do not use this command.
+
+ While LaTeX is laying out the material, it may stretch or shrink the
+gaps between words. (This space is not a character; it is called the
+"interword glue"; *note \hspace::). The '\spacefactor' command (from
+Plain TeX) allows you to, for instance, have the space after a period
+stretch more than the space after a word-ending letter.
After LaTeX places each character, or rule or other box, it sets a
parameter called the "space factor". If the next thing in the input is
-a space then this parameter affects how much of a horizontal gap LaTeX
-will have it span. (This gap is not a character; it is called
-"interword glue".) A larger space factor means that the glue gap can
-stretch more and shrink less.
-
- Normally, the space factor is 1000; this value is in effect following
-most characters, and any non-character box or math formula. But it is
-3000 after a period, exclamation mark, or question mark, it is 2000
-after a colon, 1500 after a semicolon, 1250 after a comma, and 0 after a
-right parenthesis or bracket, or closing double quote or single quote.
-Finally, it is 999 after a capital letter.
+a space then this parameter affects how much stretching or shrinking can
+happen. A space factor that is larger than the normal value means that
+the glue can stretch more and shrink less. Normally, the space factor
+is 1000. This value is in effect following most characters, and any
+non-character box or math formula. But it is 3000 after a period,
+exclamation mark, or question mark, it is 2000 after a colon, 1500 after
+a semicolon, 1250 after a comma, and 0 after a right parenthesis or
+bracket, or closing double quote or single quote. Finally, it is 999
+after a capital letter.
If the space factor F is 1000 then the glue gap will be the font's
normal space value (for Computer Modern Roman 10 point this is
@@ -7888,271 +10481,556 @@ then TeX adds the font's extra space value (for Computer Modern Roman 10
point this is 1.11111 points), and then the font's normal stretch value
is multiplied by f /1000 and the normal shrink value is multiplied by
1000/f (for Computer Modern Roman 10 point these are 1.66666 and
-1.11111 points). In short, compared to a normal space, such as the
-space following a word ending in a lowercase letter, inter-sentence
-spacing has a fixed extra space added and then the space can stretch 3
-times as much and shrink 1/3 as much.
-
- The rules for how TeX uses space factors are even more complex
-because they play two more roles. In practice, there are two
-consequences. First, if a period or other punctuation is followed by a
-close parenthesis or close double quote then its effect is still in
-place, that is, the following glue will have increased stretch and
-shrink. Second, conversely, if punctuation comes after a capital letter
-then its effect is not in place so you get an ordinary space. For how
-to adjust to this second case, for instance if an abbreviation does not
-end in a capital letter, *note \(SPACE) and \@::.
+1.11111 points).
+
+ For example, consider the period ending 'A man's best friend is his
+dog.' After it, TeX puts in a fixed extra space, and also allows the
+glue to stretch 3 times as much and shrink 1/3 as much, as the glue
+after 'friend', which does not end in a period.
+
+ The rules for space factors are even more complex because they play
+additional roles. In practice, there are two consequences. First, if a
+period or other punctuation is followed by a right parenthesis or
+bracket, or right single or double quote then the spacing effect of that
+period carries through those characters (that is, the following glue
+will have increased stretch and shrink). Second, if punctuation comes
+after a capital letter then its effect is not in place so you get an
+ordinary space. This second case also affects abbreviations that do not
+end in a capital letter (*note \@::).
+
+ You can only use '\spacefactor' in paragraph mode or LR mode (*note
+Modes::). You can see the current value with '\the\spacefactor' or
+'\showthe\spacefactor'.
+
+ (Comment, not really related to '\spacefactor': if you get errors
+like 'You can't use `\spacefactor' in vertical mode', or 'You can't use
+`\spacefactor' in math mode.', or 'Improper \spacefactor' then you have
+probably tried to redefine an internal command. *Note \makeatletter &
+\makeatother::.)
* Menu:
-* \(SPACE) and \@:: Space after a period.
-* \frenchspacing:: Equal interword and inter-sentence space.
-* \normalsfcodes:: Restore space factor settings to the default.
+* \@:: Distinguish sentence-ending periods from abbreviations.
+* \frenchspacing:: Equal interword and inter-sentence space.
+* \normalsfcodes:: Restore space factor settings to the default.

-File: latex2e.info, Node: \(SPACE) and \@, Next: \frenchspacing, Up: \spacefactor
+File: latex2e.info, Node: \@, Next: \frenchspacing, Up: \spacefactor
-19.3.1 '\(SPACE)' and '\@'
---------------------------
+19.5.1 '\@'
+-----------
+
+Synopsis:
+
+ CAPITAL-LETTER\@.
-Here, '\(SPACE)' means a backslash followed by a space. These commands
-mark a punctuation character, typically a period, as either ending a
-sentence or as ending an abbreviation.
+ Treat a period as sentence-ending, where LaTeX would otherwise think
+it is part of an abbreviation. LaTeX thinks that a period ends an
+abbreviation if the period comes after a capital letter, and otherwise
+thinks the period ends the sentence. By default, in justifying a line
+LaTeX adjusts the space after a sentence-ending period (or a question
+mark, exclamation point, comma, or colon) more than it adjusts the space
+between words (*note \spacefactor::).
- By default, in justifying a line LaTeX adjusts the space after a
-sentence-ending period (or a question mark, exclamation point, comma, or
-colon) more than the space between words. *Note \spacefactor::. As
-described there, LaTeX assumes that the period ends a sentence unless it
-is preceded by a capital letter, in which case it takes that period for
-part of an abbreviation. Note that if a sentence-ending period is
-immediately followed by a right parenthesis or bracket, or right single
-or double quote, then the space effect of that period follows through
-that parenthesis or quote.
+ This example shows the two cases to remember.
- So: if you have a period ending an abbreviation whose last letter is
-not a capital letter, and that abbreviation is not the last word in the
-sentence, then follow that period with a backslash-space ('\ ') or a tie
-('~') or a '\@'. Examples are 'Nat.\ Acad.\ Science', and 'Mr.~Bean',
-and '(manure, etc.\@) for sale' (note that in the last the '\@' comes
-before the closing parenthesis).
+ The songs \textit{Red Guitar}, etc.\ are by Loudon Wainwright~III\@.
- In the opposite situation, if you have a capital letter followed by a
-period that does end the sentence, then put '\@' before the period. For
-example, 'book by the MAA\@.' will have correct inter-sentence spacing
-after the period.
+The second period ends the sentence, despite that it is preceded by a
+capital. We tell LaTeX that it ends the sentence by putting '\@' before
+it. The first period ends the abbreviation 'etc.' but not the sentence.
+The backslash-space, '\ ', produces a mid-sentence space.
- For another use of '\(SPACE)', *note \(SPACE) after control
-sequence::.
+ So: if you have a capital letter followed by a period that ends the
+sentence, then put '\@' before the period. This holds even if there is
+an intervening right parenthesis or bracket, or right single or double
+quote, because the spacing effect of that period carries through those
+characters. For example, this
+
+ Use the \textit{Instructional Practices Guide},
+ (a book by the MAA)\@.
+
+will have correct inter-sentence spacing after the period.
+
+ The '\@' command is only for a text mode. If you use it outside of a
+text mode then you get 'You can't use `\spacefactor' in vertical mode'
+(*note Modes::).
+
+ Comment: the converse case is a period ending an abbreviation whose
+last letter is not a capital letter, and that abbreviation is not the
+last word in the sentence. For that case follow the period with a
+backslash-space, ('\ '), or a tie, ('~'), or '\@'. Examples are 'Nat.\
+Acad.\ Science', and 'Mr.~Bean', and '(manure, etc.\@) for sale' (note
+in the last one that the '\@' comes before the closing parenthesis).

-File: latex2e.info, Node: \frenchspacing, Next: \normalsfcodes, Prev: \(SPACE) and \@, Up: \spacefactor
+File: latex2e.info, Node: \frenchspacing, Next: \normalsfcodes, Prev: \@, Up: \spacefactor
-19.3.2 '\frenchspacing'
+19.5.2 '\frenchspacing'
-----------------------
-This declaration (from Plain TeX) causes LaTeX to treat inter-sentence
-spacing in the same way as interword spacing.
+Synopsis, one of:
+
+ \frenchspacing
+ \nonfrenchspacing
- In justifying the text in a line, some typographic traditions,
-including English, prefer to adjust the space between sentences (or
-after other punctuation marks) more than the space between words.
-Following this declaration, all spaces are instead treated equally.
+ The first declaration causes LaTeX to treat spacing between sentences
+in the same way as spacing between words in the middle of a sentence.
+The second causes spacing between sentences to stretch or shrink more
+(*note \spacefactor::); this is the default.
- Revert to the default behavior by declaring '\nonfrenchspacing'.
+ Some typographic traditions, including English, prefer to adjust the
+space between sentences (or spaces following a question mark,
+exclamation point, comma, or colon) more than the space between words
+that are in the middle of a sentence. Declaring '\frenchspacing' (the
+command is from Plain TeX) switches to the tradition that all spaces are
+treated equally.

File: latex2e.info, Node: \normalsfcodes, Prev: \frenchspacing, Up: \spacefactor
-19.3.3 '\normalsfcodes'
+19.5.3 '\normalsfcodes'
-----------------------
-Reset the LaTeX space factor values to the default.
+Synopsis:
+
+ \normalsfcodes
+
+ Reset the LaTeX space factor values to the default (*note
+\spacefactor::).

-File: latex2e.info, Node: \(SPACE) after control sequence, Next: \thinspace, Prev: \spacefactor, Up: Spaces
+File: latex2e.info, Node: \(SPACE), Next: ~, Prev: \spacefactor, Up: Spaces
-19.4 '\ ' after control sequence
-================================
+19.6 Backslash-space, '\ '
+==========================
+
+This section refers to the command consisting of two characters, a
+backslash followed by a space. Synopsis:
-The '\ ' command is often used after control sequences to keep them from
-gobbling the space that follows, as in '\TeX\ is nice'. And, under
-normal circumstances, '\'<tab> and '\'<newline> are equivalent to '\ '.
-For another use of '\ ', see also *note \(SPACE) and \@::.
+ \
- Some people prefer to use '{}' for the same purpose, as in '\TeX{} is
-nice'. This has the advantage that you can always write it the same
-way, namely '\TeX{}', whether it is followed by a space or by a
-punctuation mark. Compare:
+ Produce a space. By default it produces white space of length
+3.33333pt plus 1.66666pt minus 1.11111pt.
- \TeX\ is a nice system. \TeX, a nice system.
+ A blank is not a space. When you type a blank between words, LaTeX
+produces white space. That's different from an explicit space. This
+illustrates.
- \TeX{} is a nice system. \TeX{}, a nice system.
+ \begin{tabular}{l}
+ Three blanks: in a row \\
+ Three spaces:\ \ \ in a row \\
+ \end{tabular}
- Some individual commands, notably those defined with the 'xspace',
-package do not follow the standard behavior.
+On the first line LaTeX collapses the three blanks to output one
+whitespace (it would be the same with a single blank or, for instance,
+with a blank and an tab and a blank, or a blank and a newline and a
+blank). But the second line asks for three spaces so the white area is
+wider. Thus, the backslash-space command will create some horizontal
+space. (But the best way to create horizontal space is with '\hspace';
+*Note \hspace::.)
+
+ The backslash-space command has two main uses. First, it is often
+used after control sequences to keep them from gobbling the space that
+follows, as in '\TeX\ is nice'. (But the approach of using curly
+parentheses, as in '\TeX{} is nice', has the advantage of still working
+if the next character is a period.)
+
+ The second common use is that it mark a period as ending an
+abbreviation instead of ending a sentence, as in 'So says Prof.\ Smith'
+(*note \@::).
+
+ Under normal circumstances, '\'<tab> and '\'<newline> are equivalent
+to backslash-space, '\ '.

-File: latex2e.info, Node: \thinspace, Next: \/, Prev: \(SPACE) after control sequence, Up: Spaces
+File: latex2e.info, Node: ~, Next: \thinspace & \negthinspace, Prev: \(SPACE), Up: Spaces
-19.5 '\thinspace': Insert 1/6em
-===============================
+19.7 '~'
+========
+
+Synopsis:
+
+ BEFORE~AFTER
+
+ The tie character, '~', produces a space between BEFORE and AFTER at
+which the line will not be broken. By default the white space has
+length 3.33333pt plus 1.66666pt minus 1.11111pt (*note Lengths::).
+
+ Here LaTeX will not break the line between the final two words.
+
+ Thanks to Prof.~Lerman.
+
+In addition, despite the period, LaTeX does not use the end-of-sentence
+spacing (*note \@::).
-'\thinspace' produces an unbreakable and unstretchable space that is 1/6
-of an em. This is the proper space to use between nested quotes, as in
-'".
+ Ties prevent the end of line separation of things where that could
+cause confusion. But they also reduce LaTeX's options when it breaks
+lines into paragraphs, so you can use too many. They are also matters
+of taste, sometimes alarmingly dogmatic taste, among readers.
+Nevertheless, here are some usage models, many of them from the TeXbook.
+
+ * Between an enumerator and its item, such as in references:
+ 'Chapter~12', or 'Theorem~\ref{th:Wilsons}', or
+ 'Figure~\ref{fig:KGraph}'. When cases are enumerated inline:
+ '(b)~Show that $f(x)$ is (1)~continuous, and (2)~bounded'.
+
+ * Between a number and its unit: '$745.7.8$~watts' (the 'siunitx'
+ package has a special facility for this) or '144~eggs'. This
+ includes between a month and a date: 'October~12' or '12~Oct'. In
+ general, in any expressions where numbers and abbreviations or
+ symbols are separated by a space: 'AD~565', or '2:50~pm', or
+ 'Boeing~747', or '268~Plains Road', or '\$$1.4$~billion'.
+
+ * When mathematical phrases are rendered in words: 'equals~$n$', or
+ 'less than~$\epsilon$', or 'given~$X$', or 'modulo~$p^e$ for all
+ large~$n$' (but compare 'is~$15$' with 'is $15$~times the height').
+ Between mathematical symbols in apposition with nouns:
+ 'dimension~$d$' or 'function~$f(x)$' (but compare 'with length
+ $l$~or more'). When a symbol is a tightly bound object of a
+ preposition: 'of~$x$', or 'from $0$ to~$1$', or 'in common
+ with~$m$'.
+
+ * Between symbols in series: '$1$,~$2$, or~$3$' or '$1$,~$2$,
+ \ldots,~$n$'.
+
+ * Between a person's forenames and between multiple surnames:
+ 'Donald~E. Knuth', or 'Luis~I. Trabb~Pardo', or 'Charles~XII' (but
+ you must give TeX places to break the line so you may do 'Charles
+ Louis Xavier~Joseph de~la Vall\'ee~Poussin').
+
+ * Before a dash: 'pages 12~--14' or 'it is~--- it must be said~---
+ plausible'.

-File: latex2e.info, Node: \/, Next: \hrulefill \dotfill, Prev: \thinspace, Up: Spaces
+File: latex2e.info, Node: \thinspace & \negthinspace, Next: \/, Prev: ~, Up: Spaces
-19.6 '\/': Insert italic correction
+19.8 '\thinspace' & '\negthinspace'
===================================
-The '\/' command produces an "italic correction". This is a small space
-defined by the font designer for a given character, to avoid the
-character colliding with whatever follows. The italic f character
-typically has a large italic correction value.
+Synopsis, one of:
+
+ \thinspace
+ \negthinspace
+
+ Produce an unbreakable and unstretchable space of 1/6em and -1/6em.
+These are the text mode equivalents of '\,' and '\!' (*note Spacing in
+math mode/\thinspace::). You can use '\,' as a synonym for '\thinspace'
+in text mode.
+
+ The '\negthinspace' command is used in text mode mostly for fiddling
+with spaces. One common use of '\thinspace' is as the space between
+nested quotes.
+
+ Killick replied, ``I heard the Captain say, `Ahoy there.'\thinspace''
+
+Another use is that some style guides call for a '\thinspace' between an
+ellipsis and a sentence ending period (other style guides, though, think
+the three dots are quite enough already). Still another use is between
+initials, as in 'D.\thinspace E.\ Knuth'.
- If the following character is a period or comma, it's not necessary
-to insert an italic correction, since those punctuation symbols have a
-very small height. However, with semicolons or colons, as well as
-normal letters, it can help. Compare f: f; (in the TeX output, the 'f's
-are nicely separated) with f: f;.
+
+File: latex2e.info, Node: \/, Next: \hrulefill & \dotfill, Prev: \thinspace & \negthinspace, Up: Spaces
+
+19.9 '\/'
+=========
+
+Synopsis:
+
+ BEFORE-CHARACTER\/AFTER-CHARACTER
+
+ Insert an "italic correction", a small space defined by the font
+designer for each character, to avoid the character colliding with
+whatever follows. When you use '\/', LaTeX takes the correction from
+the font metric file, scales it by any scaling that has been applied to
+the font, and then inserts that much horizontal space.
- When changing fonts with commands such as '\textit{italic text}' or
-'{\itshape italic text}', LaTeX will automatically insert an italic
-correction if appropriate (*note Font styles::).
+ Here, were it not for the '\/', the BEFORE-CHARACTER italic f would
+hit the AFTER-CHARACTER roman H
- Despite the name, roman characters can also have an italic
-correction. Compare pdfTeX (in the TeX output, there is a small space
-after the 'f') with pdfTeX.
+ \newcommand{\companylogo}{{\it f}\/H}
+
+because the italic letter leans far to the right.
+
+ If AFTER-CHARACTER is a period or comma then don't insert an italic
+correction since those punctuation symbols have a very small height.
+However, with semicolons or colons as well as with normal letters, the
+italic correction can help.
+
+ When you use commands such as '\textit' or '\itshape' to change
+fonts, LaTeX will automatically insert any needed italic correction
+(*note Font styles::).
+
+ Roman characters can also have an italic correction. An example is
+in the name 'pdf\/\TeX'.
There is no concept of italic correction in math mode; spacing is
done in a different way.

-File: latex2e.info, Node: \hrulefill \dotfill, Next: \addvspace, Prev: \/, Up: Spaces
+File: latex2e.info, Node: \hrulefill & \dotfill, Next: \bigskip & \medskip & \smallskip, Prev: \/, Up: Spaces
-19.7 '\hrulefill \dotfill'
-==========================
+19.10 '\hrulefill' & '\dotfill'
+===============================
-Produce an infinite rubber length (*note Lengths::) filled with a
-horizontal rule (that is, a line) or with dots, instead of just white
+Synopsis, one of:
+
+ \hrulefill
+ \dotfill
+
+ Produce an infinite horizontal rubber length (*note Lengths::) that
+LaTeX fills with a rule (that is, a line) or with dots, instead of white
space.
- When placed between blank lines this example creates a paragraph that
-is left and right justified, where the space in the middle is filled
-with evenly spaced dots.
+ This outputs a line 2 inches long.
+
+ Name:~\makebox[2in]{\hrulefill}
- \noindent Jack Aubrey\dotfill Melbury Lodge
+This example, when placed between blank lines, creates a paragraph that
+is left and right justified and where the middle is filled with evenly
+spaced dots.
+
+ \noindent John Aubrey, RN \dotfill{} Melbury Lodge
To make the rule or dots go to the line's end use '\null' at the
start or end.
To change the rule's thickness, copy the definition and adjust it, as
-with '\renewcommand{\hrulefill}{\leavevmode\leaders\hrule height
-1pt\hfill\kern\z@}', which changes the default thickness of 0.4pt to
-1pt. Similarly, adjust the dot spacing as with
-'\renewcommand{\dotfill}{\leavevmode\cleaders\hb@xt@ 1.00em{\hss .\hss
-}\hfill\kern\z@}', which changes the default length of 0.33em to 1.00em.
+here
-
-File: latex2e.info, Node: \addvspace, Next: \bigskip \medskip \smallskip, Prev: \hrulefill \dotfill, Up: Spaces
+ \renewcommand{\hrulefill}{%
+ \leavevmode\leaders\hrule height 1pt\hfill\kern\z@}
-19.8 '\addvspace'
-=================
+which changes the default thickness of 0.4pt to 1pt. Similarly, adjust
+the dot spacing as with
-'\addvspace{LENGTH}'
+ \renewcommand{\dotfill}{%
+ \leavevmode\cleaders\hb@xt@1.00em{\hss .\hss }\hfill\kern\z@}
- Add a vertical space of height LENGTH, which is a rubber length
-(*note Lengths::). However, if vertical space has already been added to
-the same point in the output by a previous '\addvspace' command then
-this command will not add more space than what is needed to make the
-natural length of the total vertical space equal to LENGTH.
+which changes the default length of 0.33em to 1.00em.
- Use this command to adjust the vertical space above or below an
-environment that starts a new paragraph. For instance, a Theorem
-environment is defined to begin and end with '\addvspace{...}' so that
-two consecutive Theorem's are separated by one vertical space, not two.
+ This example produces a line for a signature.
- This command is fragile (*note \protect::).
+ \begin{minipage}{4cm}
+ \centering
+ \hrulefill\\
+ Signed
+ \end{minipage}
- The error 'Something's wrong--perhaps a missing \item' means that you
-were not in vertical mode when you invoked this command; one way to
-change that is to precede this command with a '\par' command.
+The line is 4cm long.

-File: latex2e.info, Node: \bigskip \medskip \smallskip, Next: \vfill, Prev: \addvspace, Up: Spaces
+File: latex2e.info, Node: \bigskip & \medskip & \smallskip, Next: \bigbreak & \medbreak & \smallbreak, Prev: \hrulefill & \dotfill, Up: Spaces
-19.9 '\bigskip \medskip \smallskip'
-===================================
+19.11 '\bigskip' & '\medskip' & '\smallskip'
+============================================
+
+Synopsis, one of:
-These commands produce a given amount of space, specified by the
-document class.
+ \bigskip
+ \medskip
+ \smallskip
+
+ Produce an amount of vertical space, large or medium-sized or small.
+These commands are fragile (*note \protect::).
+
+ Here the skip suggests the passage of time (from The Golden Ocean by
+O'Brian).
+
+ Mr Saumarez would have something rude to say to him, no doubt: he
+ was at home again, and it was delightful.
+
+ \bigskip
+ ``A hundred and fifty-seven miles and one third, in twenty-four hours,''
+ said Peter.
+
+ Each command is associated with a length defined in the document
+class file.
'\bigskip'
The same as '\vspace{\bigskipamount}', ordinarily about one line
- space, with stretch and shrink (the default for the 'book' and
- 'article' classes is '12pt plus 4pt minus 4pt').
+ space, with stretch and shrink. The default for the 'book' and
+ 'article' classes is '12pt plus 4pt minus 4pt'.
'\medskip'
The same as '\vspace{\medskipamount}', ordinarily about half of a
- line space, with stretch and shrink (the default for the 'book' and
- 'article' classes is '6pt plus 2pt minus 2pt').
+ line space, with stretch and shrink. The default for the 'book'
+ and 'article' classes is '6pt plus 2pt minus 2pt'.
'\smallskip'
The same as '\vspace{\smallskipamount}', ordinarily about a quarter
- of a line space, with stretch and shrink (the default for the
- 'book' and 'article' classes is '3pt plus 1pt minus 1pt').
+ of a line space, with stretch and shrink. The default for the
+ 'book' and 'article' classes is '3pt plus 1pt minus 1pt'.
+
+ Because each command is a '\vspace', if you use on in mid-paragraph
+then it will insert its vertical space between the line in which you use
+it and the next line, not necessarily at the place that you use it. So
+these are best between paragraphs.
+
+ The commands '\bigbreak', '\medbreak', and '\smallbreak' are similar
+but also suggest to LaTeX that this is a good place to put a page break
+(*note \bigbreak & \medbreak & \smallbreak::.

-File: latex2e.info, Node: \vfill, Next: \vspace, Prev: \bigskip \medskip \smallskip, Up: Spaces
+File: latex2e.info, Node: \bigbreak & \medbreak & \smallbreak, Next: \strut, Prev: \bigskip & \medskip & \smallskip, Up: Spaces
+
+19.12 '\bigbreak' & '\medbreak' & '\smallbreak'
+===============================================
+
+Synopsis, one of:
+
+ \bigbreak
+ \medbreak
+ \smallbreak
+
+ Produce a vertical space that is big or medium-sized or small, and
+suggest to LaTeX that this is a good place to break the page. (The
+associated penalties are -200, -100, and -50.)
-19.10 '\vfill'
+ *Note \bigskip & \medskip & \smallskip::, for more. These commands
+produce the same vertical space but differ in that they also remove a
+preceding vertical space if it is less than what they would insert (as
+with '\addvspace'). In addition, they terminate a paragraph where they
+are used: this example
+
+ abc\bigbreak def ghi
+
+ jkl mno pqr
+
+will output three paragraphs, the first ending in 'abc' and the second
+starting, after an extra vertical space and a paragraph indent, with
+'def'.
+
+
+File: latex2e.info, Node: \strut, Next: \vspace, Prev: \bigbreak & \medbreak & \smallbreak, Up: Spaces
+
+19.13 '\strut'
==============
-End the current paragraph and insert a vertical rubber length (*note
-Lengths::) that is infinite, so it can stretch or shrink as far as
-needed.
+Synopsis:
- It is often used in the same way as '\vspace{\fill}', except that
-'\vfill' ends the current paragraph, whereas '\vspace{\fill}' adds the
-infinite vertical space below its line irrespective of the paragraph
-structure. In both cases that space will disappear at a page boundary;
-to circumvent this see *note \vspace::.
+ \strut
- In this example the page is filled, so the top and bottom lines
-contain the text 'Lost Dog!' and the third 'Lost Dog!' is exactly
-halfway between them.
+ Ensure that the current line has height at least '0.7\baselineskip'
+and depth at least '0.3\baselineskip'. Essentially, LaTeX inserts into
+the line a rectangle having zero width,
+'\rule[-0.3\baselineskip]{0pt}{\baselineskip}' (*note \rule::). The
+'\baselineskip' changes with the current font and fontsize.
- \begin{document}
- Lost Dog!
- \vfill
- Lost Dog!
- \vfill
- Lost Dog!
- \end{document}
+ In this example the '\strut' keeps the box inside the frame from
+having zero height.
+
+ \setlength{\fboxsep}{0pt}\framebox[2in]{\strut}
+
+ This example has four lists. In the first there is a much bigger gap
+between items 2 and 3 than there is between items 1 and 2. The second
+list fixes that with a '\strut' at the end of its first item's second
+line.
+
+ \setlength{\fboxsep}{0pt}
+ \noindent\begin{minipage}[t]{0.2\linewidth}
+ \begin{enumerate}
+ \item \parbox[t]{15pt}{test \\ test}
+ \item test
+ \item test
+ \end{enumerate}
+ \end{minipage}%
+ \begin{minipage}[t]{0.2\linewidth}
+ \begin{enumerate}
+ \item \parbox[t]{15pt}{test \\ test\strut}
+ \item test
+ \item test
+ \end{enumerate}
+ \end{minipage}%
+ \begin{minipage}[t]{0.2\linewidth}
+ \begin{enumerate}
+ \item \fbox{\parbox[t]{15pt}{test \\ test}}
+ \item \fbox{test}
+ \item \fbox{test}
+ \end{enumerate}
+ \end{minipage}%
+ \begin{minipage}[t]{0.2\linewidth}
+ \begin{enumerate}
+ \item \fbox{\parbox[t]{15pt}{test \\ test\strut}}
+ \item \fbox{test}
+ \item \fbox{test}
+ \end{enumerate}
+ \end{minipage}%
+
+The final two lists use 'fbox' to show what's happening. The third
+list's '\parbox' goes only to the bottom of its second 'test', which
+happens not have any characters that descend below the baseline. The
+fourth list adds the strut that gives the needed extra below-baseline
+space.
+
+ The '\strut' command is often useful in graphics, such as in 'TikZ'
+or 'Asymptote'. For instance, you may have a command such as
+'\graphnode{NODE-NAME}' that fits a circle around NODE-NAME. However,
+unless you are careful the NODE-NAME's 'x' and 'y' will produce
+different-diameter circles because the characters are different sizes.
+A careful '\graphnode' might insert a '\strut', then NODE-NAME, and then
+draw the circle.
+
+ The general approach of using a zero width '\rule' is useful in many
+circumstances. In this table, the zero-width rule keeps the top of the
+first integral from hitting the '\hline'. Similarly, the second rule
+keeps the second integral from hitting the first.
+
+ \begin{tabular}{rl}
+ \textsc{Integral} &\textsc{Value} \\
+ \hline
+ $\int_0^x t\, dt$ &$x^2/2$ \rule{0em}{2.5ex} \\
+ $\int_0^x t^2\, dt$ &$x^3/3$ \rule{0em}{2.5ex}
+ \end{tabular}
+
+(Although the line-ending double backslash command has an available
+optional argument to put in more vertical room, that won't work here.
+Changing the first double backslash to something like '\\[2.5ex]' will
+put the room between the header line and the '\hline', and the integral
+would still hit the line.)

-File: latex2e.info, Node: \vspace, Prev: \vfill, Up: Spaces
+File: latex2e.info, Node: \vspace, Next: \vfill, Prev: \strut, Up: Spaces
-19.11 '\vspace{LENGTH}'
-=======================
+19.14 '\vspace'
+===============
-Synopsis, one of these two:
+Synopsis, one of:
\vspace{LENGTH}
\vspace*{LENGTH}
- Add the vertical space LENGTH. This can be negative or positive, and
-is a rubber length (*note Lengths::).
+ Add the vertical space LENGTH. The LENGTH can be positive, negative,
+or zero. It is a rubber length--it may contain a 'plus' or 'minus'
+component (*note Lengths::).
+
+ This puts space between the two paragraphs.
+
+ And I slept.
+
+ \vspace{1ex plus 0.5ex}
+ The new day dawned cold.
+
+(*Note \bigskip & \medskip & \smallskip:: for common inter-paragraph
+spaces.)
- LaTeX removes the vertical space from '\vspace' at a page break, that
-is, at the top or bottom of a page. The starred version '\vspace*{...}'
-causes the space to stay.
+ The '*'-version inserts vertical space that non-discardable. More
+precisely, LaTeX discards vertical space at a page break and the
+'*'-version causes the space to stay. This example leaves space between
+the two questions.
- If '\vspace' is used in the middle of a paragraph (i.e., in
-horizontal mode), the space is inserted _after_ the line with the
-'\vspace' command. A new paragraph is not started.
+ Question: Find the integral of \( 5x^4+5 \).
+
+ \vspace*{2cm plus 0.5cm}
+ Question: Find the derivative of \( x^5+5x+9 \).
+
+That space will be present even if the page break happens to fall
+between the questions.
+
+ If you use '\vspace' in the middle of a paragraph (i.e., in
+horizontal mode) then the space is inserted after the line containing
+the '\vspace' command; it does not start a new paragraph at the
+'\vspace' command.
In this example the two questions will be evenly spaced vertically on
the page, with at least one inch of space below each.
@@ -8166,213 +11044,500 @@ the page, with at least one inch of space below each.
\end{document}

-File: latex2e.info, Node: Boxes, Next: Color, Prev: Spaces, Up: Top
+File: latex2e.info, Node: \vfill, Next: \addvspace, Prev: \vspace, Up: Spaces
-20 Boxes
-********
+19.15 '\vfill'
+==============
-All the predefined length parameters (*note Predefined lengths::) can be
-used in the arguments of the box-making commands.
+Synopsis:
-* Menu:
+ \vfill
-* \mbox:: Horizontal boxes.
-* \fbox and \framebox:: Put a frame around a box.
-* lrbox:: An environment like '\sbox'.
-* \makebox:: Box, adjustable position.
-* \parbox:: Box with text in paragraph mode.
-* \raisebox:: Raise or lower text.
-* \savebox:: Like '\makebox', but save the text for later use.
-* \sbox:: Like '\mbox', but save the text for later use.
-* \usebox:: Print saved text.
+ End the current paragraph and insert a vertical rubber length that is
+infinite, so it can stretch or shrink as far as needed (*note
+Lengths::).
-
-File: latex2e.info, Node: \mbox, Next: \fbox and \framebox, Up: Boxes
+ It is often used in the same way as '\vspace{\fill}', except that
+'\vfill' ends the current paragraph whereas '\vspace{\fill}' adds the
+infinite vertical space below its line, irrespective of the paragraph
+structure. In both cases that space will disappear at a page boundary;
+to circumvent this see the starred option in *note \vspace::.
-20.1 '\mbox{TEXT}'
-==================
+ In this example the page is filled, so the top and bottom lines
+contain the text 'Lost Dog!' and the second 'Lost Dog!' is exactly
+halfway between them.
-The '\mbox' command creates a box just wide enough to hold the text
-created by its argument. The TEXT is not broken into lines, so it can
-be used to prevent hyphenation.
+ \begin{document}
+ Lost Dog!
+ \vfill
+ Lost Dog! % perfectly in the middle
+ \vfill
+ Lost Dog!
+ \end{document}

-File: latex2e.info, Node: \fbox and \framebox, Next: lrbox, Prev: \mbox, Up: Boxes
+File: latex2e.info, Node: \addvspace, Prev: \vfill, Up: Spaces
-20.2 '\fbox' and '\framebox'
-============================
+19.16 '\addvspace'
+==================
-Synopses:
+Synopsis:
- \fbox{TEXT}
- \framebox[WIDTH][POSITION]{TEXT}
+ \addvspace{VERT-LENGTH}
+
+ Add a vertical space of VERT-LENGTH. However, if there are two or
+more '\addvspace''s in a sequence then together they only add the space
+needed to make the natural length equal to the maximum of the
+VERT-LENGTH's in that sequence. This command is fragile (*note
+\protect::). The VERT-LENGTH is a rubber length (*note Lengths::).
- The '\fbox' and '\framebox' commands are like '\mbox', except that
-they put a frame around the outside of the box being created.
+ This example illustrates. The 'picture' draws a scale. In a
+standard LaTeX article the length '\baselineskip' is 12pt. The two
+rules here are 22pt apart: the sum of the '\baselineskip' and the 10pt
+from the first 'addvspace'.
+
+ \documentclass{article}
+ \usepackage{color}
+ \begin{document}
+ \setlength{\unitlength}{2pt}%
+ \noindent\begin{picture}(0,0)%
+ \multiput(0,0)(0,-1){25}{{\color{blue}\line(1,0){1}}}
+ \multiput(0,0)(0,-5){6}{{\color{red}\line(1,0){2}}}
+ \end{picture}%
+ \rule{0.25\linewidth}{0.1pt}%
+ \par\addvspace{10pt}% \addvspace{20pt}%
+ \par\noindent\rule{0.25\linewidth}{0.1pt}%
+ \end{document}
- In addition, the '\framebox' command allows for explicit
-specification of the box width with the optional WIDTH argument (a
-dimension), and positioning with the optional POSITION argument.
+Now uncomment the second '\addvspace'. It does not make the gap 20pt
+longer; instead the gap is the sum of '\baselineskip' and 20pt. So
+'\addvspace' in a sense does the opposite of its name -- it makes sure
+that multiple vertical spaces do not accumulate, but instead that only
+the largest one is used.
- Both commands produce a rule of thickness '\fboxrule' (default
-'0.4pt'), and leave a space of '\fboxsep' (default '3pt') between the
-rule and the contents of the box.
+ LaTeX uses this command to adjust the vertical space above or below
+an environment that starts a new paragraph. For instance, a 'theorem'
+environment begins and ends with '\addvspace' so that two consecutive
+'theorem''s are separated by one vertical space, not two.
- *Note \framebox (picture)::, for the '\framebox' command in the
-'picture' environment.
+ A error 'Something's wrong--perhaps a missing \item' pointing to an
+'\addvspace' means that you were not in vertical mode when you hit this
+command. One way to change that is to precede '\addvspace' with a
+'\par' command (*note \par::), as in the above example.

-File: latex2e.info, Node: lrbox, Next: \makebox, Prev: \fbox and \framebox, Up: Boxes
+File: latex2e.info, Node: Boxes, Next: Color, Prev: Spaces, Up: Top
-20.3 'lrbox'
-============
+20 Boxes
+********
-Synopsis:
+At its core, LaTeX puts things in boxes and then puts the boxes on a
+page. So these commands are central.
- \begin{lrbox}{\CMD}
- TEXT
- \end{lrbox}
+ There are many packages on CTAN that are useful for manipulating
+boxes. One useful adjunct to the commands here is 'adjustbox'.
- This is the environment form of *note '\sbox': \sbox.
+* Menu:
- The TEXT inside the environment is saved in the box '\CMD', which
-must have been declared with '\newsavebox'.
+* \mbox & \makebox:: Horizontal boxes.
+* \fbox & \framebox:: Put a frame around a box.
+* \parbox:: Box with text in paragraph mode.
+* \raisebox:: Raise or lower text.
+* \sbox & \savebox:: Like '\makebox' but save the text for later.
+* lrbox:: Environment version of '\sbox'.
+* \usebox:: Print saved text.

-File: latex2e.info, Node: \makebox, Next: \parbox, Prev: lrbox, Up: Boxes
+File: latex2e.info, Node: \mbox & \makebox, Next: \fbox & \framebox, Up: Boxes
-20.4 '\makebox'
-===============
+20.1 '\mbox' & '\makebox'
+=========================
-Synopsis:
+Synopsis, one of:
+ \mbox{TEXT}
+ \makebox{TEXT}
+ \makebox[WIDTH]{TEXT}
\makebox[WIDTH][POSITION]{TEXT}
- The '\makebox' command creates a box just wide enough to contain the
-TEXT specified. The width of the box can be overridden by the optional
-WIDTH argument. The position of the text within the box is determined
-by the optional POSITION argument, which may take the following values:
+ Create a box, a container for material. The TEXT is is typeset in LR
+mode (*note Modes::) so it is not broken into lines. The '\mbox'
+command is robust, while '\makebox' is fragile (*note \protect::).
+
+ Because 'text' is not broken into lines, you can use '\mbox' to
+prevent hyphenation. In this example, LaTeX will not hyphenate the
+table name, 'T-4'.
+
+ See Table~\mbox{T-4}
+
+ The first two command versions, '\mbox' and '\makebox', are roughly
+equivalent. They create a box just wide enough to contain the TEXT.
+(They are like plain TeX's '\hbox'.)
+
+ In the third version the optional argument WIDTH specifies the width
+of the box. Note that the space occupied by the text need not equal the
+width of the box. For one thing, TEXT can be too small; this creates a
+full-line box
+
+ \makebox[\linewidth]{Chapter Exam}
+
+with 'Chapter Exam' centered. But TEXT can also be too wide for WIDTH.
+See the example below of zero-width boxes.
+
+ In the WIDTH argument you can use the following lengths that refer to
+the dimension of the box that LaTeX gets on typesetting TEXT: '\depth',
+'\height', '\width', '\totalheight' (this is the box's height plus its
+depth). For example, to make a box with the text stretched to double
+the natural size you can say this.
+
+ \makebox[2\width]{Get a stretcher}
+
+ For the fourth command version the optional argument POSITION gives
+position of the text within the box. It may take the following values:
'c'
- Centered (default).
+ The TEXT is centered (default).
+
'l'
- Flush left.
+ The TEXT is flush left.
+
'r'
Flush right.
+
's'
- Stretch (justify) across entire WIDTH; TEXT must contain
- stretchable space for this to work.
+ Stretch the interword space in TEXT across the entire WIDTH. The
+ TEXT must contain stretchable space for this to work. For
+ instance, this could head a press release:
+ '\noindent\makebox[\textwidth][s]{\large\hfil IMMEDIATE\hfil
+ RELEASE\hfil}'
+
+ A common use of '\makebox' is to make zero-width text boxes. This
+puts the value of the quiz questions to the left of those questions.
+
+ \newcommand{\pts}[1]{\makebox[0em][r]{#1 points\hspace*{1em}}}
+ \pts{10}What is the air-speed velocity of an unladen swallow?
+
+ \pts{90}An African or European swallow?
+
+
+ The right edge of the output '10 points ' (note the ending space)
+will be just before the 'What' (note the space after 'points'). You can
+use '\makebox' similarly when making graphics, such as in 'TikZ' or
+'Asymptote', where you put the edge of the text at a known location,
+regardless of the length of that text.
+
+ For boxes with frames see *note \fbox & \framebox::. For colors
+see *note Colored boxes::.
+
+ There is a related version of '\makebox' that is used within the
+'picture' environment, where the length is given in terms of
+'\unitlength' (*note \makebox (picture)::).
+
+ If you put a double-backslash into TEXT then LaTeX will not give you
+a new line; for instance '\makebox{abc def \\ ghi}' outputs 'abc defghi'
+while '\makebox{abc def \par ghi}' outputs 'abc def ghi', but neither go
+to a second line. To get multiple lines see *note \parbox:: and *note
+minipage::.
+
+
+File: latex2e.info, Node: \fbox & \framebox, Next: \parbox, Prev: \mbox & \makebox, Up: Boxes
+
+20.2 '\fbox' & '\framebox'
+==========================
+
+Synopses, one of:
+
+ \fbox{TEXT}
+ \framebox{TEXT}
+ \framebox[WIDTH]{TEXT}
+ \framebox[WIDTH][POSITION]{TEXT}
+
+ Create a box with an enclosing frame, four lines surrounding the
+space. These commands are the same as '\mbox' and '\makebox' except for
+the frame (*note \mbox & \makebox::). The '\fbox' command is robust,
+the '\framebox' command is fragile (*note \protect::).
+
+ \fbox{Warning! No work shown, no credit given.}
+
+LaTeX puts the text into a box that cannot be split or hyphenated.
+Around that box, separated from it by a small gap, are four lines making
+a frame.
+
+ The first two command invocations, '\fbox{...}' and '\framebox{...}',
+are roughly the same. As to the third and fourth invocations, the
+optional arguments allow you to specify the box width as WIDTH and the
+position of the text inside that box as POSITION. *Note \mbox &
+\makebox:: for the full description but here is an example creating an
+empty box that is 1/4in wide.
+
+ \setlength{\fboxsep}{0pt}\framebox[0.25in]{\strut}}
+
+The '\strut' inserts a vertical height of '\baselineskip' (*note
+\strut::).
+
+ These parameters determine the frame layout.
+
+'\fboxrule'
+ The thickness of the lines around the enclosed box. The default is
+ 0.2pt. Change it with a command such as
+ '\setlength{\fboxrule}{0.8pt}' (*note \setlength::).
+
+'\fboxsep'
+ The distance from the frame to the enclosed box. The default is
+ 3pt. Change it with a command such as '\setlength{\fboxsep}{0pt}'
+ (*note \setlength::). Setting it to 0pt is useful sometimes: this
+ will put a frame around the picture with no white border.
+
+ {\setlength{\fboxsep}{0pt}
+ \framebox{%
+ \includegraphics[width=0.5\textwidth]{prudence.jpg}}}
+
+ The extra curly braces keep the effect of the '\setlength' local.
- '\makebox' is also used within the 'picture' environment *note
-\makebox (picture)::.
+ As with '\mbox' and '\makebox', LaTeX will not break lines in TEXT.
+But this example has LaTeX break lines to make a paragraph, and then
+frame the result.
+
+ \framebox{%
+ \begin{minipage}{0.6\linewidth}
+ My dear, here we must run as fast as we can, just to stay in place.
+ And if you wish to go anywhere you must run twice as fast as that.
+ \end{minipage}}
+
+ *Note Colored boxes:: for colors other than black and white.
+
+ The 'picture' environment has a version of this command where the
+units depend on 'picture''s '\unitlength' (*note \framebox (picture)::).

-File: latex2e.info, Node: \parbox, Next: \raisebox, Prev: \makebox, Up: Boxes
+File: latex2e.info, Node: \parbox, Next: \raisebox, Prev: \fbox & \framebox, Up: Boxes
-20.5 '\parbox'
+20.3 '\parbox'
==============
-Synopsis:
+Synopses, one of:
- \parbox[POSITION][HEIGHT][INNER-POS]{WIDTH}{TEXT}
+ \parbox{WIDTH}{CONTENTS}
+ \parbox[POSITION]{WIDTH}{CONTENTS}
+ \parbox[POSITION][HEIGHT]{WIDTH}{CONTENTS}
+ \parbox[POSITION][HEIGHT][INNER-POS]{WIDTH}{CONTENTS}
- The '\parbox' command produces a box whose contents are created in
-"paragraph mode". It should be used to make a box small pieces of text,
-with nothing fancy inside. In particular, you shouldn't use any
-paragraph-making environments inside a '\parbox' argument. For larger
-pieces of text, including ones containing a paragraph-making
-environment, you should use a 'minipage' environment (*note minipage::).
+ Produce a box of text that is WIDTH wide. Use this command to make a
+box of small pieces of text, of a single paragraph. This command is
+fragile (*note \protect::).
- '\parbox' has two mandatory arguments:
+ \begin{picture}(0,0)
+ ...
+ \put(1,2){\parbox{1.75in}{\raggedright Because the graph is a line on
+ this semilog paper, the relationship is
+ exponential.}}
+ \end{picture}
-WIDTH
- the width of the parbox;
-TEXT
- the text that goes inside the parbox.
+ The CONTENTS are processed in a text mode (*note Modes::) so LaTeX
+will break lines to make a paragraph. But it won't make multiple
+paragraphs; for that, use a 'minipage' environment (*note minipage::).
- By default LaTeX will position vertically a parbox so its center
-lines up with the center of the surrounding text line. When the
-optional POSITION argument is present and equal either to 't' or 'b',
-this allows you respectively to align either the top or bottom line in
-the parbox with the baseline of the surrounding text. You may also
-specify 'm' for POSITION to get the default behaviour.
+ The options for '\parbox' (except for CONTENTS) are the same as those
+for 'minipage'. For convenience a summary of the options is here but
+see *note minipage:: for a complete description.
- The optional HEIGHT argument overrides the natural height of the box.
+ There are two required arguments. The WIDTH is a rigid length (*note
+Lengths::). It sets the width of the box into which LaTeX typesets
+CONTENTS. The CONTENTS is the text that is placed in that box. It
+should not have any paragraph-making components.
- The INNER-POS argument controls the placement of the text inside the
-box, as follows; if it is not specified, POSITION is used.
+ There are three optional arguments, POSITION, HEIGHT, and INNER-POS.
+The POSITION gives the vertical alignment of the 'parbox' with respect
+to the surrounding material. The possible values are 'c' or 'm' to make
+the vertical center of the 'parbox' lines up with the center of the
+adjacent line (this is the default), or 't' to match the top line of the
+'parbox' with the baseline of the surrounding material, or 'b' to match
+the bottom line.
-'t'
- text is placed at the top of the box.
-'c'
- text is centered in the box.
-'b'
- text is placed at the bottom of the box.
-'s'
- stretch vertically; the text must contain vertically stretchable
- space for this to work.
+ The optional argument HEIGHT overrides the natural height of the box.
+
+ The optional argument INNER-POS controls the placement of CONTENT
+inside the 'parbox'. Its default is the value of POSITION. Its
+possible values are: 't' to put the CONTENT at the top of the box, 'c'
+to put it in the vertical center, 'b' to put it at the bottom of the
+box, and 's' to stretch it out vertically (for this, the text must
+contain vertically stretchable space).

-File: latex2e.info, Node: \raisebox, Next: \savebox, Prev: \parbox, Up: Boxes
+File: latex2e.info, Node: \raisebox, Next: \sbox & \savebox, Prev: \parbox, Up: Boxes
-20.6 '\raisebox'
+20.4 '\raisebox'
================
-Synopsis:
+Synopsis, one of:
+ \raisebox{DISTANCE}{TEXT}
+ \raisebox{DISTANCE}[HEIGHT]{TEXT}
\raisebox{DISTANCE}[HEIGHT][DEPTH]{TEXT}
- The '\raisebox' command raises or lowers TEXT. The first mandatory
-argument specifies how high TEXT is to be raised (or lowered if it is a
-negative amount). TEXT itself is processed in LR mode.
+ Raise or lower TEXT. This command is fragile (*note \protect::).
+
+ This example makes a command for the restriction of a function by
+lowering the vertical bar symbol.
+
+ \newcommand\restricted[1]{\raisebox{-.5ex}{$|$}_{#1}}
+ $f\restricted{A}$
+
+ The first mandatory argument DISTANCE specifies how far to raise the
+second mandatory argument TEXT. This is a rigid length (*note
+Lengths::). If it is negative then it lowers TEXT. The TEXT is
+processed in LR mode so it cannot contain line breaks (*note Modes::).
The optional arguments HEIGHT and DEPTH are dimensions. If they are
-specified, LaTeX treats TEXT as extending a certain distance above the
-baseline (HEIGHT) or below (DEPTH), ignoring its natural height and
-depth.
+specified, they override the natural height and depth of the box LaTeX
+gets by typesetting TEXT.
+
+ In the arguments DISTANCE, HEIGHT, and DEPTH you can use the
+following lengths that refer to the dimension of the box that LaTeX gets
+on typesetting TEXT: '\depth', '\height', '\width', '\totalheight' (this
+is the box's height plus its depth).
+
+ This will align two graphics on their top (*note Graphics::).
+
+ \usepackage{graphicx} \usepackage{calc} % in preamble
+ ...
+ \begin{center}
+ \raisebox{1ex-\height}{%
+ \includegraphics[width=0.4\linewidth]{lion.png}}
+ \qquad
+ \raisebox{1ex-\height}{%
+ \includegraphics[width=0.4\linewidth]{meta.png}}
+ \end{center}
+
+The first '\height' is the height of 'lion.png' while the second is the
+height of 'meta.png'.

-File: latex2e.info, Node: \savebox, Next: \sbox, Prev: \raisebox, Up: Boxes
+File: latex2e.info, Node: \sbox & \savebox, Next: lrbox, Prev: \raisebox, Up: Boxes
-20.7 '\savebox'
-===============
+20.5 '\sbox' & '\savebox'
+=========================
-Synopsis:
+Synopsis, one of:
+
+ \sbox{BOX-CMD}{TEXT}
+ \savebox{BOX-CMD}{TEXT}
+ \savebox{BOX-CMD}[WIDTH]{TEXT}
+ \savebox{BOX-CMD}[WIDTH][POS]{TEXT}
+
+ Typeset TEXT just as with '\makebox' (*note \mbox & \makebox::)
+except that LaTeX does not output it but instead saves it in a storage
+bin named BOX-CMD. The bin name BOX-CMD begins with a backslash, '\'.
+You must have previously allocated the bin BOX-CMD with '\newsavebox'
+(*note \newsavebox::).The '\sbox' command is robust while '\savebox' is
+fragile (*note \protect::).
+
+ This creates and uses a bin.
+
+ \newsavebox{\fullname}
+ \sbox{\fullname}{John Jacob Jingleheimer Schmidt}
+ ...
+ \usebox{\fullname}! His name is my name, too!
+ Whenever we go out, the people always shout!
+ There goes \\usebox{\fullname}! Ya da da da da da da.
+
+One advantage of using and reusing a bin over a '\newcommand' is
+efficiency, that LaTeX need not repeatedly retypeset the contents. See
+the example below.
+
+ The first two command invocations, '\sbox{BOX-CMD}{TEXT}' and
+'\savebox{BOX-CMD}{TEXT}', are roughly equivalent. As to the third and
+fourth, the optional arguments allow you to specify the box width as
+WIDTH, and the position of the text inside that box as POSITION. *Note
+\mbox & \makebox:: for the full description.
+
+ In the '\sbox' and '\savebox' commands the TEXT is typeset in LR mode
+so it does not have line breaks (*note Modes::). If you use these then
+LaTeX doesn't give you an error but it ignores what you want: if you
+enter '\sbox{\newbin}{test \\ test}' and '\usebox{\newbin}' then you get
+'testtest', while if you enter '\sbox{\newbin}{test \par test}' and
+'\usebox{\newbin}' then you get 'test test', but no error or warning.
+To fix this use a '\parbox' or 'minipage' as here.
+
+ \savebox{\abin}{%
+ \begin{minipage}{\linewidth}
+ \begin{enumerate}
+ \item First item
+ \item Second item
+ \end{enumerate}
+ \end{minipage}}
+ ...
+ \usebox{\abin}
+
+ As an example of the efficiency of reusing a bin's contents, this
+puts the same picture on each page of the document by putting it in the
+header. LaTeX only typesets it once.
+
+ \usepackage{graphicx} % all this in the preamble
+ \newsavebox{\sealbin}
+ \savebox{\sealbin}{%
+ \setlength{\unitlength}{1in}%
+ \begin{picture}(0,0)%
+ \put(1.5,-2.5){%
+ \begin{tabular}{c}
+ \includegraphics[height=2in]{companylogo.png} \\
+ Office of the President
+ \end{tabular}}
+ \end{picture}%
+ }
+ \markright{\usebox{\sealbin}}
+ \pagestyle{headings}
- \savebox{\BOXCMD}[WIDTH][POS]{TEXT}
+The 'picture' environment is good for fine-tuning the placement.
- This command typeset TEXT in a box just as with '\makebox' (*note
-\makebox::), except that instead of printing the resulting box, it saves
-it in the box labeled \BOXCMD, which must have been declared with
-'\newsavebox' (*note \newsavebox::).
+ If the bin has not already been defined then you get something like
+'Undefined control sequence. <argument> \nobin'.

-File: latex2e.info, Node: \sbox, Next: \usebox, Prev: \savebox, Up: Boxes
+File: latex2e.info, Node: lrbox, Next: \usebox, Prev: \sbox & \savebox, Up: Boxes
-20.8 '\sbox{\BOXCMD}{TEXT}'
-===========================
+20.6 'lrbox'
+============
Synopsis:
- \sbox{\BOXCMD}{TEXT}
+ \begin{lrbox}{BOX-CMD}
+ TEXT
+ \end{lrbox}
- '\sbox' types TEXT in a box just as with '\mbox' (*note \mbox::)
-except that instead of the resulting box being included in the normal
-output, it is saved in the box labeled \BOXCMD. \BOXCMD must have been
-previously declared with '\newsavebox' (*note \newsavebox::).
+ The TEXT inside the environment is saved in the bin 'BOX-CMD'. The
+BOX-CMD must begin with a backslash. You must create this bin in
+advance with '\newsavebox' (*note \newsavebox::). This is the
+environment form of the '\sbox' and '\savebox' commands, and is
+equivalent to them. *Note \sbox & \savebox:: for the full information.
+
+ In this example the environment is convenient for entering the
+'tabular'.
+
+ \newsavebox{\jhbin}
+ \begin{lrbox}{\jhbin}
+ \begin{tabular}{c}
+ \includegraphics[height=1in]{jh.png} \\
+ Jim Hef{}feron
+ \end{tabular}
+ \end{lrbox}
+ ...
+ \usebox{\jhbin}

-File: latex2e.info, Node: \usebox, Prev: \sbox, Up: Boxes
+File: latex2e.info, Node: \usebox, Prev: lrbox, Up: Boxes
-20.9 '\usebox{\BOXCMD}'
-=======================
+20.7 '\usebox'
+==============
Synopsis:
- \usebox{\BOXCMD}
+ \usebox{BOX-CMD}
- '\usebox' produces the box most recently saved in the bin \BOXCMD by
-a '\savebox' command (*note \savebox::).
+ Produce the box most recently saved in the bin BOX-CMD by the
+commands '\sbox' or '\savebox', or the 'lrbox' environment. *Note \sbox
+& \savebox:: for more information and examples. (Note that BOX-CMD
+starts with a backslash.) This command is robust (*note \protect::).

File: latex2e.info, Node: Color, Next: Graphics, Prev: Boxes, Up: Top
@@ -8401,8 +11566,8 @@ significantly extends the capabilities described here, including adding

File: latex2e.info, Node: Color package options, Next: Color models, Up: Color
-21.1 Color package options
-==========================
+21.1 'color' package options
+============================
Synopsis (must be in the document preamble):
@@ -8514,9 +11679,11 @@ Synopsis:
\definecolor{NAME}{MODEL}{SPECIFICATION}
- Give the name NAME to the color. For example, after
-'\definecolor{silver}{rgb}{0.75,0.75,0.74}' you can use that color name
-with 'Hi ho, \textcolor{silver}{Silver}!'.
+ Give the name NAME to the color. For example, after this
+
+ \definecolor{silver}{rgb}{0.75,0.75,0.74}
+
+you can use that color name with 'Hi ho, \textcolor{silver}{Silver}!'.
This example gives the color a more abstract name, so it could change
and not be misleading.
@@ -8538,17 +11705,18 @@ Synopses:
\textcolor{NAME}{...}
\textcolor[COLOR MODEL]{COLOR SPECIFICATION}{...}
- or
+or
\color{NAME}
\color[COLOR MODEL]{SPECIFICATION}
The affected text gets the color. This line
- \textcolor{magenta}{My name is Ozymandias, king of kings:} Look on my works, ye Mighty, and despair!
+ \textcolor{magenta}{My name is Ozymandias, king of kings:}
+ Look on my works, ye Mighty, and despair!
- causes the first half to be in magenta while the rest is in black.
-You can use a color declared with '\definecolor' in exactly the same way
+causes the first half to be in magenta while the rest is in black. You
+can use a color declared with '\definecolor' in exactly the same way
that we just used the builtin color 'magenta'.
\definecolor{MidlifeCrisisRed}{rgb}{1.0,0.11,0.0}
@@ -8570,9 +11738,12 @@ the vertical and horizontal lines.
\end{tabular}
\end{center}
- You can use color in equations. A document might have
-'\definecolor{highlightcolor}{RGB}{225,15,0}' in the preamble, and then
-contain this equation.
+ You can use color in equations. A document might have this
+definition in the preamble
+
+ \definecolor{highlightcolor}{RGB}{225,15,0}
+
+and then contain this equation.
\begin{equation}
\int_a^b \textcolor{highlightcolor}{f'(x)}\,dx=f(b)-f(a)
@@ -8582,7 +11753,8 @@ contain this equation.
style but sometimes you want a one-off. Those are the second forms in
the synopses.
- Colors of \textcolor[rgb]{0.33,0.14,0.47}{Purple} and {\color[rgb]{0.72,0.60,0.37} Gold} for the team
+ Colors of \textcolor[rgb]{0.33,0.14,0.47}{Purple} and
+ {\color[rgb]{0.72,0.60,0.37} Gold} for the team.
The format of COLOR SPECIFICATION depends on the color model (*note
Color models::). For instance, while 'rgb' takes three numbers, 'gray'
@@ -8594,7 +11766,7 @@ takes only one.
\textcolor{green}{kind of \textcolor{blue}{blue}}
- has a final word that is blue, not a combination of blue and green.
+has a final word that is blue, not a combination of blue and green.

File: latex2e.info, Node: Colored boxes, Next: Colored pages, Prev: Colored text, Up: Commands for color
@@ -8605,19 +11777,19 @@ File: latex2e.info, Node: Colored boxes, Next: Colored pages, Prev: Colored t
Synopses:
\colorbox{NAME}{...}
- \colorbox[MODEL NAME]{BOX BACKGROUND COLOR SPECIFICATION}{...}
+ \colorbox[MODEL NAME]{BOX BACKGROUND COLOR}{...}
- or
+or
\fcolorbox{FRAME COLOR}{BOX BACKGROUND COLOR}{...}
- \fcolorbox[MODEL NAME]{FRAME COLOR SPECIFICATION}{BOX BACKGROUND COLOR SPECIFICATION}{...}
+ \fcolorbox[MODEL NAME]{FRAME COLOR}{BOX BACKGROUND COLOR}{...}
Make a box with the stated background color. The '\fcolorbox'
command puts a frame around the box. For instance this
Name:~\colorbox{cyan}{\makebox[5cm][l]{\strut}}
- makes a cyan-colored box that is five centimeters long and gets its
+makes a cyan-colored box that is five centimeters long and gets its
depth and height from the '\strut' (so the depth is '-.3\baselineskip'
and the height is '\baselineskip'). This puts white text on a blue
background.
@@ -8625,7 +11797,7 @@ background.
\colorbox{blue}{\textcolor{white}{Welcome to the machine.}}
The '\fcolorbox' commands use the same parameters as '\fbox' (*note
-\fbox and \framebox::), '\fboxrule' and '\fboxsep', to set the thickness
+\fbox & \framebox::), '\fboxrule' and '\fboxsep', to set the thickness
of the rule and the boundary between the box interior and the
surrounding rule. LaTeX's defaults are '0.4pt' and '3pt', respectively.
@@ -8698,7 +11870,7 @@ external to LaTeX, that generate a graphic that you include using the
commands of this chapter. Two that use a programming language are
Asymptote and MetaPost. One that uses a graphical interface is Xfig.
Full description of these systems is outside the scope of this document;
-see their documentation.
+see their documentation on CTAN.
* Menu:
@@ -8709,14 +11881,14 @@ see their documentation.

File: latex2e.info, Node: Graphics package options, Next: Graphics package configuration, Up: Graphics
-22.1 Graphics package options
-=============================
+22.1 'graphics' package options
+===============================
Synopsis (must be in the document preamble):
\usepackage[COMMA-SEPARATED OPTION LIST]{graphics}
- or
+or
\usepackage[COMMA-SEPARATED OPTION LIST]{graphicx}
@@ -8776,21 +11948,21 @@ with a '.def' extension, such as 'pdftex.def'.

File: latex2e.info, Node: Graphics package configuration, Next: Commands for graphics, Prev: Graphics package options, Up: Graphics
-22.2 Graphics package configuration
-===================================
+22.2 'graphics' package configuration
+=====================================
These commands configure the way LaTeX searches the file system for the
graphic.
The behavior of file system search code is necessarily platform
-dependent. In this document we cover Linux, Macintosh, and Windows, as
-those systems are typically configured. For other situations consult
+dependent. In this document we cover GNU/Linux, Macintosh, and Windows,
+as those systems are typically configured. For other situations consult
the documentation in 'grfguide.pdf', or the LaTeX source, or your TeX
distribution's documentation.
* Menu:
-* \graphicspath:: Directories to search.
+* \graphicspath:: Directories to search.
* \DeclareGraphicsExtensions:: File types, such as JPG or EPS.
* \DeclareGraphicsRule:: How to handle file types.
@@ -8837,9 +12009,9 @@ the current directory,
...
\usepackage{lion.png}
- for each of the listed directories, LaTeX concatenates it with the
-file name and searches for the result, checking for 'pix/lion.png' and
-then '../pix/lion.png'. This algorithm means that the '\graphicspath'
+for each of the listed directories, LaTeX concatenates it with the file
+name and searches for the result, checking for 'pix/lion.png' and then
+'../pix/lion.png'. This algorithm means that the '\graphicspath'
command does not recursively search subdirectories: if you issue
'\graphicspath{{a/}}' and the graphic is in 'a/b/lion.png' then LaTeX
will not find it. It also means that you can use absolute paths such as
@@ -8849,8 +12021,8 @@ means that the document is not portable. (You could preserve
portability by adjusting your TeX system settings configuration file
parameter 'TEXINPUTS'; see the documentation of your system.)
- You can use '\graphicspath' in the preamble or in the document body.
-You can use it more than once. For debugging, show its value with
+ You can use '\graphicspath' anywhere in the document. You can use it
+more than once. Show its value with
'\makeatletter\typeout{\Ginput@path}\makeatother'.
The directories are taken with respect to the base file. That is,
@@ -8881,24 +12053,25 @@ files.
...
\includegraphics{lion} % will find lion.png before lion.pdf
- Because the file name 'lion' does not have a period, LaTeX uses the
+Because the file name 'lion' does not have a period, LaTeX uses the
extension list. For each directory in the graphics path (*note
\graphicspath::), LaTeX will try the extensions in the order given. If
it does not find such a file after trying all the directories and
extensions then it reports '! LaTeX Error: File `'lion'' not found'.
Note that you must include the periods at the start of the extensions.
- Because Linux and Macintosh filenames are case sensitive, the list of
-file extensions is case sensitive on those platforms. The Windows
-platform is not case sensitive.
+ Because GNU/Linux and Macintosh filenames are case sensitive, the
+list of file extensions is case sensitive on those platforms. The
+Windows platform is not case sensitive.
You are not required to include '\DeclareGraphicsExtensions' in your
document; the printer driver has a sensible default. For example, the
-most recent 'pdftex.def' has the extension list
-''.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2''.
+most recent 'pdftex.def' has this extension list.
+
+ .png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2
- You can use this command in the preamble or in the document body.
-You can use it more than once. For debugging, show its value with
+ You can use this command anywhere in the document. You can use it
+more than once. Show its value with
'\makeatletter\typeout{\Gin@extensions}\makeatother'.

@@ -8924,7 +12097,7 @@ input the file.
\DeclareGraphicsRule{*}{mps}{*}{}
- tells LaTeX that it should handle as MetaPost output any file with an
+tells LaTeX that it should handle as MetaPost output any file with an
extension not covered by another rule, so it covers 'filename.1',
'filename.2', etc.
@@ -9028,13 +12201,13 @@ over-print the surrounding area.
\includegraphics{plot.pdf}
\end{center}
- will incorporate into the document the graphic in 'plot.pdf',
-centered and at its nominal size. You can also give a path to the file,
-as with '\includegraphics{graphics/plot.pdf}'. To specify a list of
-locations to search for the file, *note \graphicspath::.
+will incorporate into the document the graphic in 'plot.pdf', centered
+and at its nominal size. You can also give a path to the file, as with
+'\includegraphics{graphics/plot.pdf}'. To specify a list of locations
+to search for the file, *note \graphicspath::.
- If your filename includes spaces then put it in double quotes, as
-with '\includegraphics{"sister picture.jpg"}'.
+ If your filename includes spaces then put it in double quotes. An
+example is '\includegraphics{"sister picture.jpg"}'.
The '\includegraphics{FILENAME}' command decides on the type of
graphic by splitting FILENAME on the first dot. You can use FILENAME
@@ -9068,14 +12241,13 @@ caption.
...
\begin{center}
\includegraphics{pix/nix.png}
- \captionof{figure}{The spirit of the night} \label{pix:nix} % if you want a caption
+ \captionof{figure}{The spirit of the night} \label{pix:nix} % optional
\end{center}
This example puts a box with a graphic side by side with one having
text, with the two vertically centered.
- \newcommand*{\vcenteredhbox}[1]{\begingroup
- \setbox0=\hbox{#1}\parbox{\wd0}{\box0}\endgroup}
+ \newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
...
\begin{center}
\vcenteredhbox{\includegraphics[width=0.4\textwidth]{plot}}
@@ -9108,10 +12280,10 @@ a key-value form, as here.
\includegraphics[angle=90,width=1in]{lion}
\end{center}
- The options are read left-to-right. So the first graphic above is
-made one inch wide and then rotated, while the second is rotated and
-then made one inch wide. Thus, unless the graphic is perfectly square,
-the two will end with different widths and heights.
+The options are read left-to-right. So the first graphic above is made
+one inch wide and then rotated, while the second is rotated and then
+made one inch wide. Thus, unless the graphic is perfectly square, the
+two will end with different widths and heights.
There are many options. The primary ones are listed first.
@@ -9136,9 +12308,9 @@ graphic.
The graphic will be shown so its bounding box is this height. You
can use the standard TeX dimensions (*note Units of length::), and
also convenient are '\pageheight' and '\textheight' (*note Page
- layout parameters::). For instance,
+ layout parameters::). For instance, the command
'\includegraphics[height=0.25\textheight]{godel}' will make the
- graphic be a quarter of the height of the text area.
+ graphic a quarter of the height of the text area.
'totalheight'
The graphic will be shown so its bounding box has this height plus
@@ -9147,22 +12319,24 @@ graphic.
height but a large depth.
'keepaspectratio'
- If set to 'true', or just specified as with
- '\includegraphics[...,keepaspectratio,...]{...}' and you give as
- options both 'width' and 'height' (or 'totalheight'), then LaTeX
- will make the graphic is as large as possible without distortion.
- That is, LaTeX will ensure that neither is the graphic wider than
- 'width' nor taller than 'height' (or 'totalheight').
+ If set to 'true', or just specified as here
+
+ \includegraphics[...,keepaspectratio,...]{...}
+
+ and you give as options both 'width' and 'height' (or
+ 'totalheight'), then LaTeX will make the graphic is as large as
+ possible without distortion. That is, LaTeX will ensure that
+ neither is the graphic wider than 'width' nor taller than 'height'
+ (or 'totalheight').
'scale'
- Factor by which to scale the graphic. Specifying
- '\includegraphics[scale=2.0]{...}' makes the graphic twice its
- nominal size. This number may be any value; a number between 1
- and 0 will shrink the graphic and a negative number will reflect
- it.
+ Factor by which to scale the graphic. To make a graphic twice its
+ nominal size, enter '\includegraphics[scale=2.0]{...}'. This
+ number may be any value; a number between 1 and 0 will shrink the
+ graphic and a negative number will reflect it.
'angle'
- Rotate the picture. The angle is taken in degrees and
+ Rotate the graphic. The angle is taken in degrees and
counterclockwise. The graphic is rotated about its 'origin'; see
that option. For a complete description of how rotated material is
typeset, *note \rotatebox::.
@@ -9171,9 +12345,9 @@ graphic.
The point of the graphic about which the rotation happens.
Possible values are any string containing one or two of: 'l' for
left, 'r' for right, 'b' for bottom, 'c' for center, 't' for top,
- and 'B' for baseline. Thus,
+ and 'B' for baseline. Thus, entering the command
'\includegraphics[angle=180,origin=c]{moon}' will turn the picture
- upside down from the center, while
+ upside down about that picture's center, while the command
'\includegraphics[angle=180,origin=lB]{LeBateau}' will turn its
picture upside down about its left baseline. (The character 'c'
gives the horizontal center in 'bc' or 'tc', but gives the vertical
@@ -9201,10 +12375,13 @@ graphic.
also the 'viewport' option.
'clip'
- If set to 'true', or just specified as with
- '\includegraphics[...,clip,...]{...}', then the graphic is cropped
- to the bounding box. You can get this effect by instead using the
- starred form of the command, as '\includegraphics*[...]{...}'.
+ If set to 'true', or just specified as here
+
+ \includegraphics[...,clip,...]{...}
+
+ then the graphic is cropped to the bounding box. This is the same
+ as using the starred form of the command,
+ '\includegraphics*[...]{...}'.
'page'
Give the page number of a multi-page PDF file. The default is
@@ -9227,8 +12404,9 @@ graphic.
'interpolate'
Enable or disable interpolation of raster images by the viewer.
- Can be set with 'interpolate=true' or just specified as with
- '\includegraphics[...,interpolate,...]{...}'.
+ Can be set with 'interpolate=true' or just specified as here.
+
+ \includegraphics[...,interpolate,...]{...}
'quiet'
Do not write information to the log. You can set it with
@@ -9236,11 +12414,13 @@ graphic.
'\includegraphics[...,quite,...]{...}',
'draft'
- If you set it with 'draft=true' or just specified it with
- '\includegraphics[...,draft,...]{...}', then the graphic will not
- appear in the document, possibly saving color printer ink.
- Instead, LaTeX will put an empty box of the correct size with the
- filename printed in it.
+ If you set it with 'draft=true' or just specify it with
+
+ \includegraphics[...,draft,...]{...}
+
+ then the graphic will not appear in the document, possibly saving
+ color printer ink. Instead, LaTeX will put an empty box of the
+ correct size with the filename printed in it.
These options address the bounding box for Encapsulated PostScript
graphic files, which have a size specified with a line '%%BoundingBox'
@@ -9265,17 +12445,21 @@ points, 1/72 inch. For example, if an '.eps' file has the line
'natwidth, natheight'
An alternative for 'bb'. Setting
- '\includegraphics[...,natwidth=1in,natheight=0.618in,...]{...}' is
- the same as setting 'bb=0 0 1in 0.618in'.
+
+ \includegraphics[...,natwidth=1in,natheight=0.618in,...]{...}
+
+ is the same as setting 'bb=0 0 1in 0.618in'.
'hiresbb'
If set to 'true', or just specified as with
- '\includegraphics[...,hiresbb,...]{...}', then LaTeX will look for
- '%%HiResBoundingBox' lines instead of '%%BoundingBox' lines. (The
- 'BoundingBox' lines use only natural numbers while the
- 'HiResBoundingBox' lines use decimals; both use units equivalent to
- TeX's big points, 1/72 inch.) To override a prior setting of
- 'true', you can set it to 'false'.
+
+ \includegraphics[...,hiresbb,...]{...}
+
+ then LaTeX will look for '%%HiResBoundingBox' lines instead of
+ '%%BoundingBox' lines. (The 'BoundingBox' lines use only natural
+ numbers while the 'HiResBoundingBox' lines use decimals; both use
+ units equivalent to TeX's big points, 1/72 inch.) To override a
+ prior setting of 'true', you can set it to 'false'.
These following options allow a user to override LaTeX's method of
choosing the graphic type based on the filename extension. An example
@@ -9296,7 +12480,9 @@ the file 'lion.xxx' as though it were 'lion.png'. For more on these,
'command'
Specify a command to be applied to this file. Only use this in
- conjunction with the option 'type'.
+ conjunction with the option 'type'. *Note Command line options::
+ for a discussion of enabling the '\write18' functionality to run
+ external commands.

File: latex2e.info, Node: \rotatebox, Next: \scalebox, Prev: \includegraphics, Up: Commands for graphics
@@ -9345,15 +12531,17 @@ you can get the same effect without needing this package, except for the
'origin'
The point of the MATERIAL's box about which the rotation happens.
- Possible values are any string containing one or two of: 'l' for
+ Possible value is any string containing one or two of: 'l' for
left, 'r' for right, 'b' for bottom, 'c' for center, 't' for top,
- and 'B' for baseline. Thus,
- '\includegraphics[angle=180,origin=c]{moon}' will turn the picture
- upside down from the center, while
- '\includegraphics[angle=180,origin=lB]{LeBateau}' will turn its
- picture upside down about its left baseline. (The character 'c'
- gives the horizontal center in 'bc' or 'tc' but gives the vertical
- center in 'lc' or 'rc'.) The default is 'lB'.
+ and 'B' for baseline. Thus, the first line here
+
+ \includegraphics[angle=180,origin=c]{moon}
+ \includegraphics[angle=180,origin=lB]{LeBateau}
+
+ will turn the picture upside down from the center while the second
+ will turn its picture upside down about its left baseline. (The
+ character 'c' gives the horizontal center in 'bc' or 'tc' but gives
+ the vertical center in 'lc' or 'rc'.) The default is 'lB'.
'x, y'
Specify an arbitrary point of rotation with '\rotatebox[x=TeX
@@ -9388,10 +12576,13 @@ the first text and doubles the size of the second.
If you do not specify the optional VERTICAL FACTOR then it defaults
to the same value as the HORIZONTAL FACTOR.
- You can use this command to resize a graphic, as with
-'\scalebox{0.5}{\includegraphics{lion}}'. If you use the 'graphicx'
-package then you can accomplish the same thing with optional arguments
-to '\includegraphics' (*note \includegraphics::).
+ You can use this command to resize a graphic, as here.
+
+ \scalebox{0.5}{\includegraphics{lion}}
+
+If you use the 'graphicx' package then you can accomplish the same thing
+with optional arguments to '\includegraphics' (*note
+\includegraphics::).
The '\reflectbox' command abbreviates '\scalebox{-1}[1]{MATERIAL}'.
Thus, 'Able was I\reflectbox{Able was I}' will show the phrase 'Able was
@@ -9445,7 +12636,7 @@ meaning do not correspond to simple characters you can type.
* Symbols by font position:: Inserting font symbols by number.
* Text symbols:: Inserting other non-letter symbols in text.
* Accents:: Inserting accents.
-* Additional Latin letters:: Inserting other non-English characters.
+* Additional Latin letters:: Inserting other non-English characters.
* \rule:: Inserting lines and rectangles.
* \today:: Inserting today's date.
@@ -9455,34 +12646,31 @@ File: latex2e.info, Node: Reserved characters, Next: Upper and lower case, Up
23.1 Reserved characters
========================
-LaTeX sets aside the following characters for special purposes (for
-example, the percent sign '%' is for comments) so they are called
+LaTeX sets aside the following characters for special purposes. For
+example, the percent sign '%' is for comments. They are called
"reserved characters" or "special characters".
# $ % & { } _ ~ ^ \
If you want a reserved character to be printed as itself, in the text
body font, for all but the final three characters in that list simply
-put a backslash '\' in front of the character. Thus, '\$1.23' will
-produce '$1.23' in your output.
+put a backslash '\' in front of the character. Thus, typing '\$1.23'
+will produce '$1.23' in your output.
As to the last three characters, to get a tilde in the text body font
use '\~{}' (omitting the curly braces would result in the next character
receiving a tilde accent). Similarly, to get a get a text body font
-circumflex use '\^{}'. A text body font backslash results from
-'\textbackslash{}'.
+circumflex use '\^{}'. To get a backslash in the font of the text body,
+enter '\textbackslash{}'.
- To produce the reserved characters in a typewriter font use
-'\verb!!', as below.
+ To produce the reserved characters in a typewriter font use '\verb!!'
+as below (the double backslash '\\' is only there to split the lines).
\begin{center}
\# \$ \% \& \{ \} \_ \~{} \^{} \textbackslash \\
\verb!# $ % & { } _ ~ ^ \!
\end{center}
- In that example the double backslash '\\' is only there to split the
-lines.
-

File: latex2e.info, Node: Upper and lower case, Next: Symbols by font position, Prev: Reserved characters, Up: Special insertions
@@ -9553,17 +12741,18 @@ File: latex2e.info, Node: Text symbols, Next: Accents, Prev: Symbols by font
LaTeX provides commands to generate a number of non-letter symbols in
running text. Some of these, especially the more obscure ones, are not
-available in OT1; you may need to load the 'textcomp' package.
+available in OT1. Unless you are using XeLaTeX or LuaLaTeX then you may
+need to load the 'textcomp' package.
'\copyright'
'\textcopyright'
- The copyright symbol, (C).
+ (C) The copyright symbol.
'\dag'
- The dagger symbol (in text).
+ U+2020 The dagger symbol (in text).
'\ddag'
- The double dagger symbol (in text).
+ U+2021 The double dagger symbol (in text).
'\LaTeX'
The LaTeX logo.
@@ -9575,158 +12764,166 @@ available in OT1; you may need to load the 'textcomp' package.
'\guillemotright (>>)'
'\guilsinglleft (<)'
'\guilsinglright (>)'
- Double and single angle quotation marks, commonly used in French:
- <<, >>, <, >.
+ <<, >>, <, > Double and single angle quotation marks, commonly used
+ in French.
'\ldots'
'\dots'
'\textellipsis'
- An ellipsis (three dots at the baseline): '...'. '\ldots' and
- '\dots' also work in math mode.
+ ... An ellipsis (three dots at the baseline): '\ldots' and '\dots'
+ also work in math mode.
'\lq'
- Left (opening) quote: '.
+ ' Left (opening) quote.
'\P'
'\textparagraph'
- Paragraph sign (pilcrow): U+00B6.
+ U+00B6 Paragraph sign (pilcrow).
'\pounds'
'\textsterling'
- English pounds sterling: #.
+ # English pounds sterling.
'\quotedblbase (,,)'
'\quotesinglbase (,)'
- Double and single quotation marks on the baseline: ,, and ,.
+ ,, and , Double and single quotation marks on the baseline.
'\rq'
- Right (closing) quote: '.
+ ' Right (closing) quote.
'\S'
- \itemx \textsection Section sign: U+00A7.
+'\textsection'
+ U+00A7 Section sign.
'\TeX'
The TeX logo.
'\textasciicircum'
- ASCII circumflex: ^.
+ ^ ASCII circumflex.
'\textasciitilde'
- ASCII tilde: ~.
+ ~ ASCII tilde.
'\textasteriskcentered'
- Centered asterisk: *.
+ * Centered asterisk.
'\textbackslash'
- Backslash: \.
+ \ Backslash.
'\textbar'
- Vertical bar: |.
+ | Vertical bar.
'\textbardbl'
- Double vertical bar.
+ U+23F8 Double vertical bar.
'\textbigcircle'
- Big circle symbol.
+ U+25EF Big circle symbol.
'\textbraceleft'
- Left brace: {.
+ { Left brace.
'\textbraceright'
- Right brace: }.
+ } Right brace.
'\textbullet'
- Bullet: *.
+ * Bullet.
'\textcircled{LETTER}'
- LETTER in a circle, as in (R).
+ U+24B6 Circle around LETTER.
'\textcompwordmark'
'\textcapitalcompwordmark'
'\textascendercompwordmark'
- Composite word mark (invisible). The '\textcapital...' form has
- the cap height of the font, while the '\textascender...' form has
- the ascender height.
+ Used to separate letters that would normally ligature. For
+ example, 'f\textcompwordmark i' produces 'fi' without a ligature.
+ This is most useful in non-English languages. The
+ '\textcapitalcompwordmark' form has the cap height of the font
+ while the '\textascendercompwordmark' form has the ascender height.
'\textdagger'
- Dagger: \dag.
+ U+2020 Dagger.
'\textdaggerdbl'
- Double dagger: \ddag.
+ U+2021 Double dagger.
'\textdollar (or '\$')'
- Dollar sign: $.
+ $ Dollar sign.
'\textemdash (or '---')'
- Em-dash: -- (for punctuation).
+ -- Em-dash (used for punctuation, as in 'The playoffs --- if you
+ are fortunate enough to make the playoffs --- is more like a
+ sprint.').
'\textendash (or '--')'
- En-dash: - (for ranges).
+ - En-dash (used for ranges, as in 'See pages 12--14').
'\texteuro'
- The Euro symbol: Euro.
+
+ The Euro symbol: Euro. For an alternative glyph design, try the
+ 'eurosym' package; also, most fonts nowadays come with their own
+ Euro symbol (Unicode U+20AC).
'\textexclamdown (or '!`')'
- Upside down exclamation point: !.
+ ! Upside down exclamation point.
'\textgreater'
- Greater than: >.
+ > Greater than symbol.
'\textless'
- Less than: <.
+ < Less than symbol.
'\textleftarrow'
- Left arrow.
+ U+2190 Left arrow.
'\textordfeminine'
'\textordmasculine'
- Feminine and masculine ordinal symbols: a, o.
+ a, o Feminine and masculine ordinal symbols.
'\textperiodcentered'
- Centered period: U+00B7.
+ U+00B7 Centered period.
'\textquestiondown (or '?`')'
- Upside down question mark: ?.
+ ? Upside down question mark.
'\textquotedblleft (or '``')'
- Double left quote: ".
+ " Double left quote.
'\textquotedblright (or '''')'
- Double right quote: ".
+ " Double right quote.
'\textquoteleft (or '`')'
- Single left quote: '.
+ ' Single left quote.
'\textquoteright (or ''')'
- Single right quote: '.
+ ' Single right quote.
'\textquotesingle'
- Straight single quote. (From TS1 encoding.)
+ U+0027 Straight single quote. (From TS1 encoding.)
'\textquotestraightbase'
'\textquotestraightdblbase'
Single and double straight quotes on the baseline.
'\textregistered'
- Registered symbol: (R).
+ (R) Registered symbol.
'\textrightarrow'
- Right arrow.
+ U+2192 Right arrow.
'\textthreequartersemdash'
- "Three-quarters" em-dash, between en-dash and em-dash.
+ U+FE58 "Three-quarters" em-dash, between en-dash and em-dash.
'\texttrademark'
- Trademark symbol: U+2122.
+ U+2122 Trademark symbol.
'\texttwelveudash'
- "Two-thirds" em-dash, between en-dash and em-dash.
+ U+FE58 "Two-thirds" em-dash, between en-dash and em-dash.
'\textunderscore'
- Underscore: _.
+ _ Underscore.
'\textvisiblespace'
- Visible space symbol.
+ U+2423 Visible space symbol.

File: latex2e.info, Node: Accents, Next: Additional Latin letters, Prev: Text symbols, Up: Special insertions
@@ -9735,97 +12932,89 @@ File: latex2e.info, Node: Accents, Next: Additional Latin letters, Prev: Text
============
LaTeX has wide support for many of the world's scripts and languages,
-through the 'babel' package and related support. This section does not
-attempt to cover all that support. It merely lists the core LaTeX
-commands for creating accented characters.
+through the 'babel' package and related support if you are using
+pdfLaTeX, or 'polyglossia' if you are using XeLaTeX or LuaLaTeX. This
+section does not cover that support. It only lists the core LaTeX
+commands for creating accented characters. The '\capital...' commands
+shown here produce alternative forms for use with capital letters.
+These are not available with OT1.
+
+ Below, to make them easier to find, the accents are all illustrated
+with lowercase 'o'.
- The '\capital...' commands produce alternative forms for use with
-capital letters. These are not available with OT1.
+ Note that '\i' produces a dotless i, and '\j' produces a dotless j.
+These are often used in place of their dotted counterparts when they are
+accented.
'\"'
'\capitaldieresis'
- Produces an umlaut (dieresis), as in o".
+ o" Umlaut (dieresis).
'\''
'\capitalacute'
- Produces an acute accent, as in o'. In the 'tabbing' environment,
- pushes current column to the right of the previous column (*note
- tabbing::).
+ o' Acute accent.
'\.'
- Produces a dot accent over the following, as in o..
+ o. Dot accent.
'\='
'\capitalmacron'
- Produces a macron (overbar) accent over the following, as in o=.
+ o= Macron (overbar) accent.
'\^'
'\capitalcircumflex'
- Produces a circumflex (hat) accent over the following, as in o^.
+ o^ Circumflex (hat) accent.
'\`'
'\capitalgrave'
- Produces a grave accent over the following, as in o`. In the
- 'tabbing' environment, move following text to the right margin
- (*note tabbing::).
+ o` Grave accent.
'\~'
'\capitaltilde'
- Produces a tilde accent over the following, as in n~.
+ n~ Tilde accent.
'\b'
- Produces a bar accent under the following, as in o_. See also
- '\underbar' hereinafter.
+ o_ Bar accent underneath.
+
+ Related to this, '\underbar{TEXT}' produces a bar under TEXT. The
+ argument is always processed in LR mode (*note Modes::). The bar
+ is always a fixed position under the baseline, thus crossing
+ through descenders. See also '\underline' in *note Math
+ miscellany::.
'\c'
'\capitalcedilla'
- Produces a cedilla accent under the following, as in c,.
+ c, Cedilla accent underneath.
'\d'
'\capitaldotaccent'
- Produces a dot accent under the following, as in .o.
+ .o Dot accent underneath.
'\H'
'\capitalhungarumlaut'
- Produces a long Hungarian umlaut accent over the following, as in
- o''.
-
-'\i'
- Produces a dotless i, as in 'i'.
-
-'\j'
- Produces a dotless j, as in 'j'.
+ o'' Long Hungarian umlaut accent.
'\k'
'\capitalogonek'
- Produces a letter with ogonek, as in 'o;'. Not available in the
- OT1 encoding.
+ o; Ogonek. Not available in the OT1 encoding.
'\r'
'\capitalring'
- Produces a ring accent, as in 'o*'.
+ o* Ring accent.
'\t'
'\capitaltie'
'\newtie'
'\capitalnewtie'
- Produces a tie-after accent, as in 'oo['. The '\newtie' form is
- centered in its box.
+ oo[ Tie-after accent. The '\newtie' form is centered in its box.
'\u'
'\capitalbreve'
- Produces a breve accent, as in 'o('.
-
-'\underbar'
- Not exactly an accent, this produces a bar under the argument text.
- The argument is always processed in horizontal mode. The bar is
- always a fixed position under the baseline, thus crossing through
- descenders. See also '\underline' in *note Math miscellany::. See
- also '\b' above.
+ o( Breve accent.
'\v'
'\capitalcaron'
- Produces a ha'c<ek (check, caron) accent, as in 'o<'.
+ o< Ha'c<ek (check, caron) accent.

File: latex2e.info, Node: Additional Latin letters, Next: \rule, Prev: Accents, Up: Special insertions
@@ -9833,8 +13022,8 @@ File: latex2e.info, Node: Additional Latin letters, Next: \rule, Prev: Accent
23.6 Additional Latin letters
=============================
-Here are the basic LaTeX commands for inserting letters (beyond A-Z)
-extending the Latin alphabet, used primarily in languages other than
+Here are the basic LaTeX commands for inserting letters beyond A-Z that
+extend the Latin alphabet, used primarily in languages other than
English.
'\aa'
@@ -9893,21 +13082,37 @@ File: latex2e.info, Node: \rule, Next: \today, Prev: Additional Latin letters
23.7 '\rule'
============
-Synopsis:
+Synopsis, one of:
+ \rule{WIDTH}{THICKNESS}
\rule[RAISE]{WIDTH}{THICKNESS}
- The '\rule' command produces "rules", that is, lines or rectangles.
-The arguments are:
+ Produce a "rule", a filled-in rectangle.
-RAISE
- How high to raise the rule (optional).
+ This produces a rectangular blob, sometimes called a Halmos symbol,
+often used to mark the end of a proof.
-WIDTH
- The length of the rule (mandatory).
+ \newcommand{\qedsymbol}{\rule{0.4em}{2ex}}
-THICKNESS
- The thickness of the rule (mandatory).
+The 'amsthm' package includes this command, with a somewhat
+different-looking symbol.
+
+ The mandatory arguments give the horizontal WIDTH and vertical
+THICKNESS of the rectangle. They are rigid lengths (*note Lengths::).
+The optional argument RAISE is also a rigid length, and tells LaTeX how
+much to raise the rule above the baseline, or lower it if the length is
+negative.
+
+ This produces a line, a rectangle that is wide but not tall.
+
+ \noindent\rule{\textwidth}{0.4pt}
+
+The line is the width of the page and 0.4 points tall. This line
+thickness is common in LaTeX.
+
+ A rule that has zero width, or zero thickness, will not show up in
+the output, but can cause LaTeX to change the output around it. *Note
+\strut:: for examples.

File: latex2e.info, Node: \today, Prev: \rule, Up: Special insertions
@@ -9915,14 +13120,16 @@ File: latex2e.info, Node: \today, Prev: \rule, Up: Special insertions
23.8 '\today'
=============
-The '\today' command produces today's date, in the format 'MONTH DD,
-YYYY'; for example, 'July 4, 1976'. It uses the predefined counters
-'\day', '\month', and '\year' (*note \day \month \year::) to do this.
-It is not updated as the program runs.
+Synopsis:
+
+ \today
+
+ Produce today's date in the format 'MONTH DD, YYYY'. An example of a
+date in that format is 'July 4, 1976'.
- Multilingual packages like 'babel' or classes like 'lettre', among
-others, will localize '\today'. For example, the following will output
-'4 juillet 1976':
+ Multilingual packages such as 'babel' or 'polyglossia', or classes
+such as 'lettre', will localize '\today'. For example, the following
+will output '4 juillet 1976':
\year=1976 \month=7 \day=4
\documentclass{minimal}
@@ -9931,8 +13138,15 @@ others, will localize '\today'. For example, the following will output
\today
\end{document}
- The 'datetime' package, among others, can produce a wide variety of
-other date formats.
+'\today' uses the counters '\day', '\month', and '\year' (*note \day &
+\month & \year::).
+
+ A number of package on CTAN work with dates. One is 'datetime'
+package which can produce a wide variety of date formats, including ISO
+standards.
+
+ The date is not updated as the LaTeX process runs, so in principle
+the date could be incorrect by the time the program finishes.

File: latex2e.info, Node: Splitting the input, Next: Front/back matter, Prev: Special insertions, Up: Top
@@ -9940,77 +13154,243 @@ File: latex2e.info, Node: Splitting the input, Next: Front/back matter, Prev:
24 Splitting the input
**********************
-A large document requires a lot of input. Rather than putting the whole
-input in a single large file, it's more efficient to split it into
-several smaller ones. Regardless of how many separate files you use,
-there is one that is the "root file"; it is the one whose name you type
-when you run LaTeX.
+LaTeX lets you split a large document into several smaller ones. This
+can simplify editing or allow multiple authors to work on the document.
+It can also speed processing.
+
+ Regardless of how many separate files you use, there is always one
+"root file", on which LaTeX compilation starts. This shows such a file
+with five included files.
+
+ \documentclass{book}
+ \includeonly{ % comment out lines below to omit compiling
+ pref,
+ chap1,
+ chap2,
+ append,
+ bib
+ }
+ \begin{document}
+ \frontmatter
+ \include{pref}
+ \mainmatter
+ \include{chap1}
+ \include{chap2}
+ \appendix
+ \include{append}
+ \backmatter
+ \include{bib}
+ \end{document}
- *Note filecontents::, for an environment that allows bundling an
-external file to be created with the main document.
+This will bring in material from 'pref.tex', 'chap1.tex', 'chap2.tex',
+'append.tex', and 'bib.tex'. If you compile this file, and then comment
+out all of the lines inside '\includeonly{...}' except for 'chap1,' and
+compile again, then LaTeX will only process the material in the first
+chapter. Thus, your output will appear more quickly and be shorter to
+print. However, the advantage of the '\includeonly' command is that
+LaTeX will retain the page numbers and all of the cross reference
+information from the other parts of the document so these will appear in
+your output correctly.
+
+ *Note Larger book template:: for another example of '\includeonly'.
* Menu:
-* \include:: Conditionally include a file.
-* \includeonly:: Determine which files are included.
-* \input:: Unconditionally include a file.
+* \endinput:: Stop including material from a file.
+* \include & \includeonly:: Conditionally include files.
+* \input:: Unconditionally include a file.

-File: latex2e.info, Node: \include, Next: \includeonly, Up: Splitting the input
+File: latex2e.info, Node: \endinput, Next: \include & \includeonly, Up: Splitting the input
-24.1 '\include'
-===============
+24.1 '\endinput'
+================
Synopsis:
- \include{FILE}
+ \endinput
- If no '\includeonly' command is present, the '\include' command
-executes '\clearpage' to start a new page (*note \clearpage::), then
-reads FILE, then does another '\clearpage'.
+ When you '\include{filename}', inside 'filename.tex' the material
+after '\endinput' will not be included. This command is optional; if
+'filename.tex' has no '\endinput' then LaTeX will read all of the file.
- Given an '\includeonly' command, the '\include' actions are only run
-if FILE is listed as an argument to '\includeonly'. See *note
-\includeonly::.
+ For example, suppose that a document's root file has '\input{chap1}'
+and this is 'chap1.tex'.
- The '\include' command may not appear in the preamble or in a file
-read by another '\include' command.
+ \chapter{One}
+ This material will appear in the document.
+ \endinput
+ This will not appear.
+
+ This can be useful for putting documentation or comments at the end
+of a file, or for avoiding junk characters that can be added during
+mailing. It is also useful for debugging: one strategy to localize
+errors is to put '\endinput' halfway through the included file and see
+if the error disappears. Now, knowing which half contains the error,
+moving '\endinput' to halfway through that area further narrows down the
+location. This process rapidly finds the offending line.
+
+ After reading '\endinput', LaTeX continues to read to the end of the
+line, so something can follow this command and be read nonetheless.
+This allows you, for instance, to close an '\if...' with a '\fi'.

-File: latex2e.info, Node: \includeonly, Next: \input, Prev: \include, Up: Splitting the input
+File: latex2e.info, Node: \include & \includeonly, Next: \input, Prev: \endinput, Up: Splitting the input
-24.2 '\includeonly'
-===================
+24.2 '\include' & '\includeonly'
+================================
Synopsis:
- \includeonly{FILE1,FILE2,...}
+ \includeonly{ % in document preamble
+ ...
+ FILENAME,
+ ...
+ }
+ ...
+ \include{FILENAME} % in document body
+
+ Bring material from the external file 'FILENAME.tex' into a LaTeX
+document.
+
+ The '\include' command does three things: it executes '\clearpage'
+(*note \clearpage & \cleardoublepage::), then it inputs the material
+from 'FILENAME.tex' into the document, and then it does another
+'\clearpage'. This command can only appear in the document body. The
+'\includeonly' command controls which files will be read by LaTeX under
+subsequent '\include' commands. Its list of filenames is
+comma-separated, and it can only appear in the preamble.
+
+ This example root document, 'constitution.tex', brings in three
+files, 'preamble.tex', 'articles.tex', and 'amendments.tex'.
+
+ \documentclass{book}
+ \includeonly{
+ preamble,
+ articles,
+ amendments
+ }
+ \begin{document}
+ \include{preamble}
+ \include{articles}
+ \include{amendments}
+ \end{document}
+
+The file 'preamble.tex' contains no special code; you have just
+excerpted the chapter from 'consitution.tex' and put it in a separate
+file just for editing convenience.
+
+ \chapter{Preamble}
+ We the People of the United States,
+ in Order to form a more perfect Union, ...
+
+Running LaTeX on 'constitution.tex' makes the material from the three
+files appear in the document but also generates the auxiliary files
+'preamble.aux', 'articles.aux', and 'amendments.tex'. These contain
+information such as page numbers and cross-references (*note Cross
+references::). If you now comment out '\includeonly''s lines with
+'preamble' and 'amendments' and run LaTeX again then the resulting
+document shows only the material from 'articles.tex', not the material
+from 'preamble.tex' or 'amendments.tex'. Nonetheless, all of the
+auxiliary information from the omitted files is still there, including
+the starting page number of the chapter.
+
+ If the document preamble does not have '\includeonly' then LaTeX will
+include all the files you call for with '\include' commands.
+
+ The '\include' command makes a new page. To avoid that, see *note
+\input:: (which, however, does not retain the auxiliary information).
+
+ *Note Larger book template:: for another example using '\include' and
+'\includeonly'. That example also uses '\input' for some material that
+will not necessarily start on a new page.
+
+ File names can involve paths.
- The '\includeonly' command controls which files will be read by
-subsequent '\include' commands. The list of filenames is
-comma-separated. Each element FILE1, FILE2, ... must exactly match a
-filename specified in a '\include' command for the selection to be
-effective.
+ \documentclass{book}
+ \includeonly{
+ chapters/chap1,
+ }
+ \begin{document}
+ \include{chapters/chap1}
+ \end{document}
+
+ To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores. Nevertheless, for the name 'amo amas amat', this
+works under TeX Live on GNU/Linux:
+
+ \documentclass{book}
+ \includeonly{
+ "amo\space amas\space amat"
+ }
+ \begin{document}
+ \include{"amo\space amas\space amat"}
+ \end{document}
+
+ and this works under MiKTeX on Windows:
+
+ \documentclass{book}
+ \includeonly{
+ {"amo amas amat"}
+ }
+ \begin{document}
+ \include{{"amo amas amat"}}
+ \end{document}
- This command can only appear in the preamble.
+ You cannot use '\include' inside a file that is being included or you
+get 'LaTeX Error: \include cannot be nested.' The '\include' command
+cannot appear in the document preamble; you will get 'LaTeX Error:
+Missing \begin{document}'.
+
+ If a file that you '\include' does not exist, for instance if you
+'\include{athiesm}' but you meant '\include{atheism}', then LaTeX does
+not give you an error but will warn you 'No file athiesm.tex.' (It will
+also create 'athiesm.aux'.)
+
+ If you '\include' the root file in itself then you first get 'LaTeX
+Error: Can be used only in preamble.' Later runs get 'TeX capacity
+exceeded, sorry [text input levels=15]'. To fix this, you must remove
+the inclusion '\include{root}' but also delete the file 'ROOT.aux' and
+rerun LaTeX.

-File: latex2e.info, Node: \input, Prev: \includeonly, Up: Splitting the input
+File: latex2e.info, Node: \input, Prev: \include & \includeonly, Up: Splitting the input
24.3 '\input'
=============
Synopsis:
- \input{FILE}
+ \input{FILENAME}
+
+ LaTeX processes the file as if its contents were inserted in the
+current file. For a more sophisticated inclusion mechanism see *note
+\include & \includeonly::.
+
+ If FILENAME does not end in '.tex' then LaTeX first tries the
+filename with that extension; this is the usual case. If FILENAME ends
+with '.tex' then LaTeX looks for the filename as it is.
+
+ For example, this
+
+ \input{macros}
- The '\input' command causes the specified FILE to be read and
-processed, as if its contents had been inserted in the current file at
-that point.
+will cause LaTeX to first look for 'macros.tex'. If it finds that file
+then it processes its contents as thought they had been copy-pasted in.
+If there is no file of the name 'macros.tex' then LaTeX tries the name
+'macros', without an extension. (This may vary by distribution.)
- If FILE does not end in '.tex' (e.g., 'foo' or 'foo.bar'), it is
-first tried with that extension ('foo.tex' or 'foo.bar.tex'). If that
-is not found, the original FILE is tried ('foo' or 'foo.bar').
+ To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores. Nevertheless, for the name 'amo amas amat', this
+works under TeX Live on GNU/Linux:
+
+ \input{"amo\space amas\space amat"}
+
+ and this works under MiKTeX on Windows:
+
+ \input{{"amo amas amat"}}

File: latex2e.info, Node: Front/back matter, Next: Letters, Prev: Splitting the input, Up: Top
@@ -10020,41 +13400,114 @@ File: latex2e.info, Node: Front/back matter, Next: Letters, Prev: Splitting t
* Menu:
-* Tables of contents::
-* Glossaries::
-* Indexes::
+* Table of contents etc.:: Table of contents, list of figures, list of tables.
+* Indexes:: Generate an index.
+* Glossaries:: Generate a glossary.

-File: latex2e.info, Node: Tables of contents, Next: Glossaries, Up: Front/back matter
+File: latex2e.info, Node: Table of contents etc., Next: Indexes, Up: Front/back matter
-25.1 Tables of contents
-=======================
+25.1 Table of contents etc.
+===========================
-A table of contents is produced with the '\tableofcontents' command.
-You put the command right where you want the table of contents to go;
-LaTeX does the rest for you. A previous run must have generated a
-'.toc' file.
+Synopsis, one of:
- The '\tableofcontents' command produces a heading, but it does not
-automatically start a new page. If you want a new page after the table
-of contents, write a '\newpage' command after the '\tableofcontents'
-command.
+ \tableofcontents
+ \listoffigures
+ \listoftables
- The analogous commands '\listoffigures' and '\listoftables' produce a
-list of figures and a list of tables (from '.lof' and '.lot' files),
-respectively. Everything works exactly the same as for the table of
-contents.
+ Produce a table of contents, or list of figures, or list of tables.
+Put the command in the input file where you want the table or list to
+go. You do not type the entries; for example, typically the table of
+contents entries are automatically generated from the sectioning
+commands '\chapter', etc.
+
+ This example illustrates the first command, '\tableofcontents'.
+LaTeX will produce a table of contents on the book's first page.
+
+ \documentclass{book}
+ % \setcounter{tocdepth}{1}
+ \begin{document}
+ \tableofcontents\newpage
+ ...
+ \chapter{...}
+ ...
+ \section{...}
+ ...
+ \subsection{...}
+ ...
+ \end{document}
+
+Uncommenting the second line would cause that table to contain chapter
+and section listings but not subsection listings, because the '\section'
+command has level 1. *Note Sectioning:: for level numbers of the
+sectioning units. For more on the 'tocdepth' *note
+Sectioning/tocdepth::.
+
+ Another example of the use of '\tableofcontents' is in *note Larger
+book template::.
+
+ If you want a page break after the table of contents, write a
+'\newpage' command after the '\tableofcontents' command, as above.
+
+ To make the table of contents LaTeX stores the information in an
+auxiliary file named 'ROOT-FILE.toc' (*note Splitting the input::). For
+example, this LaTeX file 'test.tex'
+
+ \documentclass{article}
+ \begin{document}
+ \tableofcontents\newpage
+ \section{First section}
+ \subsection{First subsection}
+ ...
+
+writes the following line to 'test.toc'.
+
+ \contentsline {section}{\numberline {1}First section}{2}
+ \contentsline {subsection}{\numberline {1.1}First subsection}{2}
+
+The 'section' or 'subsection' is the sectioning unit. The hook
+'\numberline' lets you to change how the information appears in the
+table of contents. Of its two arguments, '1' or '1.1' is the sectioning
+unit number and 'First section' or 'First subsection' is the title.
+Finally, '2' is the page number on which the sectioning units start.
+
+ One consequence of this auxiliary file storage strategy is that to
+get the contents page correct you must run LaTeX twice, once to store
+the information and once to get it. In particular, the first time that
+you run LaTeX on a new document, the table of contents page will be
+empty except for its 'Contents' header. Just run it again.
- The command '\nofiles' overrides these commands, and _prevents_ any
-of these lists from being generated.
+ The commands '\listoffigures' and '\listoftables' produce a list of
+figures and a list of tables. They work the same way as the contents
+commands; for instance, these work with information stored in '.lof' and
+'.lot' files.
+
+ To change the header for the table of contents page do something like
+the first line here.
+
+ \renewcommand{\contentsname}{Table of contents}
+ \renewcommand{\listfigurename}{Plots}
+ \renewcommand{\listtablename}{Tables}
+
+Similarly, the other two lines will do the other two.
+Internationalization packages such as 'babel' or 'polyglossia' will
+change the headers depending on the chosen base language.
+
+ CTAN has many packages for the table of contents and lists of figures
+and tables. One convenient one for adjusting some aspects of the
+default, such as spacing, is 'tocloft'. And, 'tocbibbind' will
+automatically add the bibliography, index, etc. to the table of
+contents.
* Menu:
* \addcontentsline:: Add an entry to table of contents, etc.
* \addtocontents:: Add text directly to table of contents file, etc.
+* \nofiles:: Prevent writing to auxiliary files.

-File: latex2e.info, Node: \addcontentsline, Next: \addtocontents, Up: Tables of contents
+File: latex2e.info, Node: \addcontentsline, Next: \addtocontents, Up: Table of contents etc.
25.1.1 '\addcontentsline'
-------------------------
@@ -10063,111 +13516,635 @@ Synopsis:
\addcontentsline{EXT}{UNIT}{TEXT}
- The '\addcontentsline' command adds an entry to the specified list or
-table where:
+ Add an entry to the file specified by EXT. Usually EXT is one of
+'toc' for the table of contents, 'lof' for the list of figures, or 'lot'
+for the list of tables.
+
+ The following will result in an 'Appendices' line in the table of
+contents.
+
+ \addcontentsline{toc}{section}{\protect\textbf{Appendices}}
+
+It will appear at the same indentation level as the sections, will be in
+boldface, and will be assigned the page number associated with the point
+where it appears in the input file.
+
+ The '\addcontentsline' command writes information to the file
+'ROOT-NAME.EXT'. It writes that information as the text of the command
+'\contentsline{UNIT}{TEXT}{NUM}', where 'NUM' is the current value of
+counter 'UNIT'. The most common case is the table of contents and there
+NUM is the page number of the first page of UNIT.
+
+ This command is invoked by the sectioning commands '\chapter', etc.,
+and also by '\caption' inside a float environment. But it is also used
+by authors. For example, in a book to have the preface unnumbered, you
+may use the starred '\chapter*'. But that does not put in table of
+contents information, so you can enter it manually, as here.
+
+ \chapter*{Preface}
+ \addcontentsline{toc}{chapter}{\protect\numberline{}Preface}
+
+In the '.toc' file LaTeX will put the line '\contentsline
+{chapter}{\numberline {}Preface}{3}'; note the page number '3'.
+
+ All of the arguments for '\addcontentsline' are required.
EXT
- The filename extension of the file on which information is to be
- written, typically one of: 'toc' (table of contents), 'lof' (list
- of figures), or 'lot' (list of tables).
+ Typically one of the strings 'toc' for the table of contents, 'lof'
+ for the list of figures, or 'lot' for the list of tables. The
+ filename extension of the information file.
UNIT
- The name of the sectional unit being added, typically one of the
- following, matching the value of the EXT argument:
+ A string that depends on the value of the EXT argument:
'toc'
- The name of the sectional unit: 'part', 'chapter', 'section',
- 'subsection', 'subsubsection'.
+ For the table of contents, this is the name of a sectional
+ unit: 'part', 'chapter', 'section', 'subsection', etc.
+
'lof'
For the list of figures: 'figure'.
+
'lot'
For the list of tables: 'table'.
TEXT
- The text of the entry.
+ The text of the entry. You must '\protect' any commands that are
+ fragile (*note \protect::).
- What is written to the '.EXT' file is the command
-'\contentsline{UNIT}{TEXT}{NUM}', where 'NUM' is the current value of
-counter 'UNIT'.
+ The '\addcontentsline' command has an interaction with '\include'
+(*note \include & \includeonly::). If you use them at the same level,
+as with '\addcontentsline{...}{...}{...}\include{...}' then lines in the
+table of contents can come out in the wrong order. The solution is to
+move '\addcontentsline' into the file being included.
+
+ If you use a UNIT that LaTeX does not recognize, as here
+
+ \addcontentsline{toc}{setcion}{\protect\textbf{Appendices}}
+
+then you don't get an error but the formatting in the table of contents
+will not make sense.

-File: latex2e.info, Node: \addtocontents, Prev: \addcontentsline, Up: Tables of contents
+File: latex2e.info, Node: \addtocontents, Next: \nofiles, Prev: \addcontentsline, Up: Table of contents etc.
25.1.2 '\addtocontents'
-----------------------
-The '\addtocontents'{EXT}{TEXT} command adds text (or formatting
-commands) directly to the '.EXT' file that generates the table of
-contents or lists of figures or tables.
+Synopsis:
+
+ \addtocontents{EXT}{TEXT}
+
+ Add TEXT, which may be text or formatting commands, directly to the
+auxiliary file with extension EXT. This is most commonly used for the
+table of contents so that is the discussion here, but this also applies
+to the list of figures and list of tables.
+
+ This will put some vertical space in the table of contents after the
+'Contents' header.
+
+ \tableofcontents\newpage
+ \addtocontents{toc}{\protect\vspace*{3ex}}
+
+ The '\addtocontents' command has two arguments. Both are required.
EXT
- The extension of the file on which information is to be written,
- typically one of: 'toc' (table of contents), 'lof' (list of
- figures), or 'lot' (list of tables).
+ Typically one of: 'toc' for the table of contents, 'lof' for the
+ list of figures, or 'lot' for the list of tables. The extension of
+ the file holding the information.
TEXT
- The text to be written.
+ The text, and possibly commands, to be written.
+
+ The sectioning commands such as '\chapter' use the '\addcontentsline'
+command to store information. This command creates lines in the '.toc'
+auxiliary file containing the '\contentsline' command (*note
+\addcontentsline::). In contrast, the command '\addtocontents' puts
+material directly in that file.
+
+ The '\addtocontents' command has an interaction with '\include'
+(*note \include & \includeonly::). If you use them at the same level,
+as with '\addtocontents{...}{...}\include{...}' then lines in the table
+of contents can come out in the wrong order. The solution is to move
+'\addtocontents' into the file being included.

-File: latex2e.info, Node: Glossaries, Next: Indexes, Prev: Tables of contents, Up: Front/back matter
+File: latex2e.info, Node: \nofiles, Prev: \addtocontents, Up: Table of contents etc.
-25.2 Glossaries
-===============
+25.1.3 '\nofiles'
+-----------------
-The command '\makeglossary' enables creating glossaries.
+Synopsis:
- The command '\glossary{TEXT}' writes a glossary entry for TEXT to an
-auxiliary file with the '.glo' extension.
+ \nofiles
- Specifically, what gets written is the command
-'\glossaryentry{TEXT}{PAGENO}', where PAGENO is the current '\thepage'
-value.
+ Prevent LaTeX from writing any auxiliary files. The only output will
+be the '.log' and '.pdf' (or '.dvi') files. This command must go in the
+preamble.
+
+ Because of the '\nofiles' command this example will not produce a
+'.toc' file.
+
+ \documentclass{book}
+ \nofiles
+ \begin{document}
+ \tableofcontents\newpage
+ \chapter{...}
+ ...
- The 'glossary' package on CTAN provides support for fancier
-glossaries.
+LaTeX will not erase any existing auxiliary files, so if you insert the
+'\nofiles' command after you have run the file and gotten a '.toc' then
+the table of contents page will continue to show the old information.

-File: latex2e.info, Node: Indexes, Prev: Glossaries, Up: Front/back matter
+File: latex2e.info, Node: Indexes, Next: Glossaries, Prev: Table of contents etc., Up: Front/back matter
-25.3 Indexes
+25.2 Indexes
============
-The command '\makeindex' enables creating indexes. Put this in the
-preamble.
+This document has an index.
- The command '\index{TEXT}' writes an index entry for TEXT to an
-auxiliary file named with the '.idx' extension.
+ \documentclass{article}
+ \usepackage{makeidx} \makeindex
+ ...
+ \begin{document}
+ ...
+ Recall Wilson's Theorem: \index{Wilson's Theorem}
+ a number \( n>1 \) is prime if and only if the factorial of \( n-1 \)
+ is congruent to \( -1 \) modulo~\( n \).
+ ...
+ \printindex
+ ...
- Specifically, what gets written is the command
-'\indexentry{TEXT}{PAGENO}', where PAGENO is the current '\thepage'
-value.
+The '\usepackage{makeidx}' and '\makeindex' in the preamble bring in the
+relevant commands.
+
+ Producing an index is a three stage process. First, in the document
+body you declare index entries with the '\index' command (*note
+\index::). When you run LaTeX, the '\index' writes its information to
+an auxiliary file 'ROOT-NAME.idx'. Next, to alphabetize and to do other
+manipulations you run an external command, typically 'makeindex' or
+'xindy' (*note makeindex::). These output a file 'ROOT-NAME.ind'.
+Finally, you bring the information back into your document and typeset
+it with the '\printindex' command (*note \printindex::).
+
+ There are many packages that apply to indexing commands. The
+'showidx' package causes each index entries to be shown in the margin on
+the page where the entry appears. This can help in preparing the index.
+The 'multind' package supports multiple indexes. See also the TeX FAQ
+entry on this topic,
+<http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind>.
- To generate a index entry for 'bar' that says 'See foo', use a
-vertical bar: '\index{bar|see{foo}}'. Use 'seealso' instead of 'see' to
-make a 'See also' entry.
+* Menu:
- The text 'See' is defined by the macro '\seename', and 'See also' by
-the macro '\alsoname'. These can be redefined for other languages.
+* \index:: Declare an index entry.
+* makeindex:: Alphabetize index entries.
+* \printindex:: Put the index here.
- The generated '.idx' file is then sorted with an external command,
-usually either 'makeindex' (<http://mirror.ctan.org/indexing/makeindex>)
-or (the multi-lingual) 'xindy' (<http://xindy.sourceforge.net>). This
-results in a '.ind' file, which can then be read to typeset the index.
+
+File: latex2e.info, Node: \index, Next: makeindex, Up: Indexes
- The index is usually generated with the '\printindex' command. This
-is defined in the 'makeidx' package, so '\usepackage{makeidx}' needs to
-be in the preamble.
+25.2.1 '\index'
+---------------
- The rubber length '\indexspace' is inserted before each new letter in
-the printed index; its default value is '10pt plus5pt minus3pt'.
+Synopsis:
- The 'showidx' package causes each index entries to be shown in the
-margin on the page where the entry appears. This can help in preparing
-the index.
+ \index{INDEX-ENTRY-STRING}
- The 'multind' package supports multiple indexes. See also the TeX
-FAQ entry on this topic,
-<http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind>.
+ Declare an entry in the index. This command is fragile (*note
+\protect::).
+
+ For example, as described in *note Indexes::, one way to get an index
+from what's below is to compile the document with 'pdflatex test', then
+process the index entries with 'makeindex test', and then compile again
+with 'pdflatex test'.
+
+ W~Ackermann (1896--1962).\index{Ackermann}
+ ...
+ Ackermann function\index{Ackermann!function}
+ ...
+ rate of growth\index{Ackermann!function!growth rate}
+
+All three index entries will get a page number, such as 'Ackermann, 22'.
+LaTeX will format the second as a subitem of the first, on the line
+below it and indented, and the third as a subitem of the second. Three
+levels deep is as far as you can nest subentries. (If you add
+'\index{Ackermann!function!growth rate!comparison}' then 'makeindex'
+says 'Scanning input file test.idx....done (4 entries accepted, 1
+rejected)' and nothing appears in the index).
+
+ If you enter a second '\index' with the same INDEX-ENTRY-STRING then
+you will get a single index entry with two page numbers (unless they
+happen to fall on the same page). Thus, adding 'as for
+Ackermann.\index{Ackermann}' later in the same document as above will
+give an index entry like 'Ackermann, 22, 151'. Also, you can enter the
+index entries in any order, so for instance '\index{Ackermann!function}'
+could come before '\index{Ackermann}'.
+
+ Get a page range in the output, like 'Hilbert, 23--27', as here.
+
+ W~Ackermann (1896--1962).\index{Ackermann}
+ ...
+ D~Hilbert (1862--1943)\index{Ackermann!Hilbert\(}
+ ...
+ disapproved of his marriage.\index{Ackermann!Hilbert\)}
+
+If the beginning and ending of the page range are equal then the system
+just gives a single page entry, not a range.
+
+ If you index subentries but not a main entry, as with
+'\index{Jones!program}' and '\index{Jones!results}', then the output is
+the item 'Jones' with no comma or page number, followed by two subitems,
+like 'program, 50' and 'results, 51'.
+
+ Generate a index entry that says 'See' by using a vertical bar
+character: '\index{Ackermann!function|see{P\'eter's function}}'. You
+can instead get 'See also' with 'seealso'. (The text 'See' is defined
+by '\seename', and 'See also' by '\alsoname'. You can redefine these
+either by using an internationalization package such as 'babel' or
+'polyglossia', or directly as with '\renewcommand{\alsoname}[1]{Also see
+#1}'.)
+
+ The 'See' feature is part of a more general functionality. After the
+vertical bar you can put the name of a one-input command, as in
+'\index{group|textit}' (note the missing backslash on the '\textit'
+command) and the system will apply that command to the page number, here
+giving something like '\textit{7}'. You can define your own one-input
+commands, such as '\newcommand{\definedpage}[1]{{\color{blue}#1}}' and
+then '\index{Ackermann!function|definedpage}' will give a blue page
+number (*note Color::). Another, less practical, example is this,
+
+ \newcommand\indexownpage[1]{#1, \thepage}
+ ... Epimenides.\index{self-reference|indexownpage}
+
+which creates an entry citing the page number of its own index listing.
+
+ The two functions just described combine, as here
+
+ \index{Ackermann!function|(definedpage}
+ ...
+ \index{Ackermann!function|)}
+
+which outputs an index entry like 'function, 23--27' where the page
+number range is in blue.
+
+ Consider an index entry such as 'U+03B1-ring'. Entering it as
+'$\alpha$-ring' will cause it to be alphabetized according to the dollar
+sign. You can instead enter it using an at-sign, as
+'\index{alpha-ring@$\alpha$-ring}'. If you specify an entry with an
+at-sign separating two strings, 'POS@TEXT', then POS gives the
+alphabetical position of the entry while TEXT produces the text of the
+entry. Another example is that '\index{Saint Michael's College@SMC}'
+produces an index entry 'SMC' alphabetized into a different location
+than its spelling would naturally give it.
+
+ To put a '!', or '@', or '|' character in an index entry, preceding
+it with a double quote, '"'. (The double quote gets deleted before
+alphabetization.)
+
+ A number of packages on CTAN have additional functionality beyond
+that provided by 'makeidx'. One is 'index', which allows for multiple
+indices and contains a command '\index*{INDEX-ENTRY-STRING}' that prints
+the INDEX-ENTRY-STRING as well as indexing it.
+
+ The '\index' command writes the indexing information to the file
+'ROOT-NAME.idx' file. Specifically, it writes text of the command
+'\indexentry{INDEX-ENTRY-STRING}{PAGE-NUM}', where where PAGE-NUM is the
+value of the '\thepage' counter. On occasion, when the '\printindex'
+command is confused, you have to delete this file to start with a fresh
+slate.
+
+ If you omit the closing brace of an '\index' command then you get a
+message like this.
+
+ Runaway argument? {Ackermann!function
+ ! Paragraph ended before \@wrindex was complete.
+
+
+File: latex2e.info, Node: makeindex, Next: \printindex, Prev: \index, Up: Indexes
+
+25.2.2 'makeindex'
+------------------
+
+Synopsis, one of:
+
+ makeindex FILENAME
+ makeindex -s STYLE-FILE FILENAME
+ makeindex OPTIONS FILENAME0 ...
+
+ Sort, and otherwise process, the index information in the auxiliary
+file FILENAME. This is a command line program. It takes one or more
+raw index files, 'FILENAME.idx' files, and produces the actual index
+file, the 'FILENAME.ind' file that is input by '\printindex' (*note
+\printindex::).
+
+ The first form of the command suffices for many uses. The second
+allows you to format the index by using an "index style file", a '.isty'
+file. The third form is the most general; see the full documentation on
+CTAN.
+
+ This is a simple '.isty' file.
+
+ % book.isty
+ % $ makeindex -s book.isty -p odd book.idx
+ % creates the index as book.ind, starting on an odd page.
+ preamble
+ "\\pagestyle{empty}
+ \\small
+ \\begin{theindex}
+ \\thispagestyle{empty}"
+
+ postamble
+ "\n
+ \\end{theindex}"
+
+ The description here covers only some of the index formatting
+possibilities in STYLE-FILE. For a full list see the documentation on
+CTAN.
+
+ A style file consists of a list of pairs: SPECIFIER and ATTRIBUTE.
+These can appear in the file in any order. All of the ATTRIBUTES are
+strings, except where noted. Strings are surrounded with double quotes,
+'"', and the maximum length of a string is 144 characters. The '\n' is
+for a newline and '\t' is for a tab. Backslashes are escaped with
+another backslash, '\\'. If a line begins with a percent sign, '%',
+then it is a comment.
+
+'preamble'
+ Preamble of the output file. Defines the context in which the
+ index is formatted. Default: '"\\begin{theindex}\n"'.
+
+'postamble'
+ Postamble of the output file. Default: '"\n\n\\end{theindex}\n"'.
+
+'group_skip'
+ Traditionally index items are broken into groups, typically a group
+ for entries starting with 'a', etc. This specifier gives what is
+ inserted when a new group begins. Default: '"\n\n \\indexspace\n"'
+ ('\indexspace' is a rubber length with default value '10pt plus5pt
+ minus3pt').
+
+'lethead_flag'
+ An integer. It governs what is inserted for a new group or letter.
+ If it is 0 (which is the default) then other than 'group_skip'
+ nothing will be inserted before the group. If it is is positive
+ then at a new letter the 'lethead_prefix' and 'lethead_suffix' will
+ be inserted, with that letter in uppercase between them. If it is
+ negative then what will be inserted is the letter in lowercase.
+ The default is 0.
+
+'lethead_prefix'
+ If a new group begins with a different letter then this is the
+ prefix inserted before the new letter header. Default: '""'
+
+'lethead_suffix'
+ If a group begins with a different letter then this is the suffix
+ inserted after the new letter header. Default: '""'.
+
+'item_0'
+ What is put between two level 0 items. Default: '"\n \\item "'.
+
+'item_1'
+ Put between two level 1 items. Default: '"\n \\subitem "'.
+
+'item_2'
+ put between two level 2 items. Default: '"\n \\subsubitem "'.
+
+'item_01'
+ What is put between a level 0 item and a level 1 item. Default:
+ '"\n \\subitem "'.
+
+'item_x1'
+ What is put between a level 0 item and a level 1 item in the case
+ that the level 0 item doesn't have any page numbers (as in
+ '\index{aaa|see{bbb}}'). Default: '"\n \\subitem "'.
+
+'item_12'
+ What is put between a level 1 item and a level 2 item. Default:
+ '"\n \\subsubitem "'.
+
+'item_x2'
+ What is put between a level 1 item and a level 2 item, if the
+ level 1 item doesn't have page numbers. Default: '"\n \\subsubitem
+ "'.
+
+'delim_0'
+ Delimiter put between a level 0 key and its first page number.
+ Default: a comma followed by a blank, '", "'.
+
+'delim_1'
+ Delimiter put between a level 1 key and its first page number.
+ Default: a comma followed by a blank, '", "'.
+
+'delim_2'
+ Delimiter between a level 2 key and its first page number.
+ Default: a comma followed by a blank, '", "'.
+
+'delim_n'
+ Delimiter between two page numbers for the same key (at any level).
+ Default: a comma followed by a blank, '", "'.
+
+'delim_r'
+ What is put between the starting and ending page numbers of a
+ range. Default: '"--"'.
+
+'line_max'
+ An integer. Maximum length of an index entry's line in the output,
+ beyond which the line wraps. Default: '72'.
+
+'indent_space'
+ What is inserted at the start of a wrapped line. Default:
+ '"\t\t"'.
+
+'indent_length'
+ A number. The length of the wrapped line indentation. The default
+ 'indent_space' is two tabs and each tab is eight spaces so the
+ default here is '16'.
+
+'page_precedence'
+ A document may have pages numbered in different ways. For example,
+ a book may have front matter pages numbered in lowercase roman
+ while main matter pages are in arabic. This string specifies the
+ order in which they will appear in the index. The 'makeindex'
+ command supports five different types of numerals: lowercase roman
+ 'r', and numeric or arabic 'n', and lowercase alphabetic 'a', and
+ uppercase roman 'R', and uppercase alphabetic 'A'. Default:
+ '"rnaRA"'.
+
+ There are a number of other programs that do the job 'makeindex'
+does. One is 'xindy', which does internationalization and can process
+indexes for documents marked up using LaTeX and a number of other
+languages. It is is highly configurable, both in markup terms and in
+terms of the collating order of the text. See the documentation on
+CTAN.
+
+
+File: latex2e.info, Node: \printindex, Prev: makeindex, Up: Indexes
+
+25.2.3 '\printindex'
+--------------------
+
+Synopsis:
+
+ \printindex
+
+ Place the index into the output.
+
+ To get an index you must first include
+'\usepackage{makeidx}\makeindex' in the document preamble and compile
+the document, then run the system command 'makeindex', and then compile
+the document again. *Note Indexes:: for further discussion and an
+example of the use of '\printindex'.
+
+
+File: latex2e.info, Node: Glossaries, Prev: Indexes, Up: Front/back matter
+
+25.3 Glossaries
+===============
+
+Synopsis:
+
+ \usepackage{glossaries} \makeglossaries
+ ...
+ \newglossaryentry{LABEL}{SETTINGS}
+ ...
+ \gls{LABEL}.
+ ...
+ \printglossaries
+
+ The 'glossaries' package allows you to make glossaries, including
+multiple glossaries, as well as lists of acronyms.
+
+ To get the output from this example, compile the document (for
+instance with 'pdflatex filename'), then run the command line command
+'makeglossaries filename', and then compile the document again.
+
+ \documentclass{...}
+ \usepackage{glossaries} \makeglossaries
+ \newglossaryentry{tm}{%
+ name={Turing machine},
+ description={A model of a machine that computes. The model is simple
+ but can compute anything any existing device can compute.
+ It is the standard model used in Computer Science.},
+ }
+ \begin{document}
+ Everything begins with the definition of a \gls{tm}.
+ ...
+ \printglossaries
+ \end{document}
+
+That gives two things. In the main text it outputs '... definition of a
+Turing machine'. In addition, in a separate sectional unit headed
+'Glossary' there appears a description list. In boldface it says
+'Turing machine' and the rest of the item says in normal type 'A model
+of a machine ... Computer Science'.
+
+ The command '\makeglossary' opens the file that will contain the
+entry information, 'ROOT-FILE.glo'. Put the '\printglossaries' command
+where you want the glossaries to appear in your document.
+
+ The 'glossaries' package is very powerful. For instance, besides the
+commands '\newglossaryentry' and '\gls', there are similar commands for
+a list of acronyms. See the package documentations on CTAN.
+
+* Menu:
+
+* \newglossaryentry:: Declare the content of a glossary entry.
+* \gls:: Give a page reference for a glossary entry.
+
+
+File: latex2e.info, Node: \newglossaryentry, Next: \gls, Up: Glossaries
+
+25.3.1 '\newglossaryentry'
+--------------------------
+
+Synopsis, one of:
+
+ \newglossaryentry{LABEL}
+ {
+ name={NAME},
+ description={DESCRIPTION},
+ OTHER OPTIONS, ...
+ }
+
+ or
+
+ \longnewglossaryentry{LABEL}
+ {
+ name={NAME},
+ OTHER OPTIONS ...,
+ }
+ {DESCRIPTION}
+
+ Declare a new entry for a glossary. The LABEL must be unique for the
+document. The settings associated with the label are pairs:
+'KEY=VALUE'.
+
+ This puts the blackboard bold symbol for the real numbers U+211D in
+the glossary.
+
+ \newglossaryentry{R}
+ {
+ name={\ensuremath{\mathbb{R}}},
+ description={the real numbers},
+ }
+
+ Use the second command form if the DESCRIPTION spans more than one
+paragraph.
+
+ For a full list of KEYs see the package documentation on CTAN but
+here are a few.
+
+'name'
+ (Required.) The word, phrase, or symbol that you are defining.
+
+'description'
+ (Required.) The description that will appear in the glossary. If
+ this has more than one paragraph then you must use the second
+ command form given in the synopsis.
+
+'plural'
+ The plural form of NAME. Refer to the plural form using '\glspl'
+ or '\Glspl' (*note \gls::).
+
+'sort'
+ How to place this entry in the list of entries that the glossary
+ holds.
+
+'symbol'
+ A symbol, such as a mathematical symbol, besides the name.
+
+
+File: latex2e.info, Node: \gls, Prev: \newglossaryentry, Up: Glossaries
+
+25.3.2 '\gls'
+-------------
+
+Synopsis, one of:
+
+ \gls{LABEL}
+ \glspl{LABEL}
+ \Gls{LABEL}
+ \Glspl{LABEL}
+
+ Refer to a glossary entry. The entries are declared with
+'\newglossaryentry' (*note \newglossaryentry::).
+
+ This
+
+ \newglossaryentry{N}{%
+ name={the natural numbers},
+ description={The numbers $0$, $1$, $2$, $\ldots$\@},
+ symbol={\ensuremath{\mathbb{N}}},
+ }
+ ...
+ Consider \gls{N}.
+
+gives the output 'Consider the natural numbers'.
+
+ The second command form '\glspl{LABEL}' produces the plural of NAME
+(by default it tries adding an 's'). The third form capitalizes the
+first letter of NAME, as does the fourth form, which also takes the
+plural.

File: latex2e.info, Node: Letters, Next: Terminal input/output, Prev: Front/back matter, Up: Top
@@ -10178,7 +14155,7 @@ File: latex2e.info, Node: Letters, Next: Terminal input/output, Prev: Front/b
Synopsis:
\documentclass{letter}
- \address{SENDER ADDRESS}
+ \address{SENDERS ADDRESS} % return address
\signature{SENDER NAME}
\begin{document}
\begin{letter}{RECIPIENT ADDRESS}
@@ -10186,18 +14163,17 @@ Synopsis:
LETTER BODY
\closing{CLOSING TEXT}
\end{letter}
- ... more letters ...
+ ...
\end{document}
Produce one or more letters.
Each letter is in a separate 'letter' environment, whose argument
RECIPIENT ADDRESS often contains multiple lines separated with a double
-backslash ('\\'). For example, you might have:
+backslash, ('\\'). For example, you might have:
- \begin{letter}{Mr. Joe Smith \\
- 2345 Princess St. \\
- Edinburgh, EH1 1AA}
+ \begin{letter}{Ninon de l'Enclos \\
+ l'h\^otel Sagonne}
...
\end{letter}
@@ -10209,7 +14185,7 @@ whether there is one or more, so these are best put in the preamble. As
with the recipient address, often SENDER ADDRESS contains multiple lines
separated by a double backslash ('\\'). LaTeX will put the SENDER NAME
under the closing, after a vertical space for the traditional
-hand-written signature; it also can contain multiple lines.
+hand-written signature.
Each 'letter' environment body begins with a required '\opening'
command such as '\opening{Dear Madam or Sir:}'. The LETTER BODY text is
@@ -10223,13 +14199,13 @@ is receiving a copy of the letter with a command like '\cc{the Boss \\
the Boss's Boss}'. There's a similar '\encl' command for a list of
enclosures. And, you can add a postscript with '\ps'.
- LaTeX's default is to indent the signature and the '\closing' above
-it by a length of '\longindentation'. By default this is
-'0.5\textwidth'. To make them flush left, put
-'\setlength{\longindentation}{0em}' in your preamble.
+ LaTeX's default is to indent the sender name and the closing above it
+by a length of '\longindentation'. By default this is '0.5\textwidth'.
+To make them flush left, put '\setlength{\longindentation}{0em}' in your
+preamble.
To set a fixed date use something like
-'\renewcommand{\today}{2015-Oct-12}'. If put in your preamble then it
+'\renewcommand{\today}{1958-Oct-12}'. If put in your preamble then it
will apply to all the letters.
This example shows only one 'letter' environment. The three lines
@@ -10275,19 +14251,18 @@ Synopsis:
\address{SENDERS ADDRESS}
- Specifies the return address as it appears on the letter and on the
+ Specify the return address, as it appears on the letter and on the
envelope. Separate multiple lines in SENDERS ADDRESS with a double
-backslash '\\'.
+backslash, '\\'.
Because it can apply to multiple letters this declaration is often
put in the preamble. However, it can go anywhere, including inside an
individual 'letter' environment.
- This command is optional: without the '\address' declaration the
-letter is formatted with some blank space on top, for copying onto
-pre-printed letterhead paper. (*Note Overview::, for details on your
-local implementation.) With the '\address' declaration, it is formatted
-as a personal letter.
+ This command is optional: if you do not use it then the letter is
+formatted with some blank space on top, for copying onto pre-printed
+letterhead paper. If you do use the '\address' declaration then it is
+formatted as a personal letter.
Here is an example.
@@ -10302,13 +14277,13 @@ File: latex2e.info, Node: \cc, Next: \closing, Prev: \address, Up: Letters
Synopsis:
- \cc{FIRST NAME \\
+ \cc{NAME0 \\
... }
Produce a list of names to which copies of the letter were sent.
This command is optional. If it appears then typically it comes after
-'\closing'. Separate multiple lines with a double backslash '\\', as
-in:
+'\closing'. Put the names on different lines by separating them with a
+double backslash, '\\', as in:
\cc{President \\
Vice President}
@@ -10323,8 +14298,9 @@ Synopsis:
\closing{TEXT}
- Usually at the end of a letter, above the handwritten signature,
-there is a '\closing' (although this command is optional). For example,
+ Produce the letter's closing. This is optional, but usual. It
+appears at the end of a letter, above a handwritten signature. For
+example:
\closing{Regards,}
@@ -10341,10 +14317,10 @@ Synopsis:
Produce a list of things included with the letter. This command is
optional; when it is used, it typically is put after '\closing'.
-Separate multiple lines with a double backslash '\\'.
+Separate multiple lines with a double backslash, '\\'.
\encl{License \\
- Passport }
+ Passport}

File: latex2e.info, Node: \location, Next: \makelabels, Prev: \encl, Up: Letters
@@ -10356,8 +14332,8 @@ Synopsis:
\location{TEXT}
- The TEXT appears centered at the bottom of the each page. It only
-appears if the page style is 'firstpage'.
+ The TEXT appears centered at the bottom of the page. It only appears
+if the page style is 'firstpage'.

File: latex2e.info, Node: \makelabels, Next: \name, Prev: \location, Up: Letters
@@ -10367,22 +14343,57 @@ File: latex2e.info, Node: \makelabels, Next: \name, Prev: \location, Up: Let
Synopsis:
- \makelabels
+ \makelabels % in preamble
- Create a sheet of address labels from the recipient addresses, one
-for each letter. This sheet will be output before the letters, with the
-idea that you can copy it to a sheet of peel-off labels. This command
-goes in the preamble.
+ Optional, for a document that contains 'letter' environments. If you
+just put '\makelabels' in the preamble then at the end of the document
+you will get a sheet with labels for all the recipients, one for each
+letter environment, that you can copy to a sheet of peel-off address
+labels.
Customize the labels by redefining the commands '\startlabels',
-'\mlabel', and '\returnaddress' in the preamble. The command
-'\startlabels' sets the width, height, number of columns, etc., of the
-page onto which the labels are printed. The command '\mlabel{SENDER
-ADDRESS}{RECIPIENT ADDRESS}' produces the two labels (or one, if you
-choose to ignore the SENDER ADDRESS). The SENDER ADDRESS is the value
-returned by the macro '\returnaddress' while RECIPIENT ADDRESS is the
-value passed in the argument to the 'letter' environment. By default
-'\mlabel' ignores the first argument, the SENDER ADDRESS.
+'\mlabel', and '\returnaddress' (and perhaps '\name') in the preamble.
+The command '\startlabels' sets the width, height, number of columns,
+etc., of the page onto which the labels are printed. The command
+'\mlabel{RETURN ADDRESS}{RECIPIENT ADDRESS}' produces the two labels (or
+one, if you choose to ignore the RETURN ADDRESS) for each letter
+environment. The first argument, RETURN ADDRESS, is the value returned
+by the macro '\returnaddress'. The second argument, RECIPIENT ADDRESS,
+is the value passed in the argument to the 'letter' environment. By
+default '\mlabel' ignores the first argument, the RETURN ADDRESS,
+causing the default behavior described in the prior paragraph.
+
+ This illustrates customization. Its output includes a page with two
+columns having two labels each.
+
+ \documentclass{letter}
+ \renewcommand*{\returnaddress}{Fred McGuilicuddy \\
+ Oshkosh, Mineola 12305}
+ \newcommand*\originalMlabel{}
+ \let\originalMlabel\mlabel
+ \def\mlabel#1#2{\originalMlabel{}{#1}\originalMlabel{}{#2}}
+ \makelabels
+ ...
+ \begin{document}
+ \begin{letter}{A Einstein \\
+ 112 Mercer Street \\
+ Princeton, New Jersey, USA 08540}
+ ...
+ \end{letter}
+ \begin{letter}{K G\"odel \\
+ 145 Linden Lane \\
+ Princeton, New Jersey, USA 08540}
+ ...
+ \end{letter}
+ \end{document}
+
+The first column contains the return address twice. The second column
+contains the address for each recipient.
+
+ The package 'envlab' makes formatting the labels easier, with
+standard sizes already provided. The preamble lines
+'\usepackage[personalenvelope]{envlab}' and '\makelabels' are all that
+you need to print envelopes.

File: latex2e.info, Node: \name, Next: \opening, Prev: \makelabels, Up: Letters
@@ -10394,8 +14405,8 @@ Synopsis:
\name{NAME}
- Sender's name, used for printing on the envelope together with the
-return address.
+ Optional. Sender's name, used for printing on the envelope together
+with the return address.

File: latex2e.info, Node: \opening, Next: \ps, Prev: \name, Up: Letters
@@ -10405,11 +14416,10 @@ File: latex2e.info, Node: \opening, Next: \ps, Prev: \name, Up: Letters
Synopsis:
- \opening{TEXT}
+ \opening{SALUTATION}
- This command is required. It starts a letter, following the
-'\begin{letter}{...}'. The mandatory argument TEXT is the text that
-starts your letter. For instance:
+ Required. Follows the '\begin{letter}{...}'. The argument
+SALUTATION is mandatory. For instance:
\opening{Dear John:}
@@ -10442,23 +14452,29 @@ Synopsis:
The sender's name. This command is optional, although its inclusion
is usual.
- The argument text appears at the end of the letter, after the closing
-and after a vertical space for the traditional hand-written signature.
-Separate multiple lines with a double backslash '\\'. For example:
+ The argument text appears at the end of the letter, after the
+closing. LaTeX leaves some vertical space for a handwritten signature.
+Separate multiple lines with a double backslash, '\\'. For example:
\signature{J Fred Muggs \\
White House}
LaTeX's default for the vertical space from the '\closing' text down
-to the '\signature' text is '6\medskipamount', which is six times 0.7em.
+to the '\signature' text is '6\medskipamount', which is six times
+'\medskipamount' (where '\medskipamount' is equal to a '\parskip', which
+in turn is defined by default here to 0.7em).
This command is usually in the preamble, to apply to all the letters
in the document. To have it apply to one letter only, put it inside a
'letter' environment and before the '\closing'.
- You can include a graphic in the signature, for instance with
-'\signature{\vspace{-6\medskipamount}\includegraphics{sig.png}\\ My
-name}' (this requires writing '\usepackage{graphicx}' in the preamble).
+ You can include a graphic in the signature as here.
+
+ \signature{\vspace{-6\medskipamount}\includegraphics{sig.png}\\
+ My name}
+
+For this you must put '\usepackage{graphicx}' in the preamble (*note
+Graphics::).

File: latex2e.info, Node: \telephone, Prev: \signature, Up: Letters
@@ -10489,38 +14505,86 @@ File: latex2e.info, Node: Terminal input/output, Next: Command line, Prev: Le

File: latex2e.info, Node: \typein, Next: \typeout, Up: Terminal input/output
-27.1 '\typein[CMD]{MSG}'
-========================
+27.1 '\typein'
+==============
-Synopsis:
+Synopsis, one of:
+
+ \typein{PROMPT-MSG}
+ \typein[CMD]{PROMPT-MSG}
+
+ Print PROMPT-MSG on the terminal and cause LaTeX to stop and wait for
+you to type a line of input. This line of input ends when you hit the
+return key.
+
+ For example, this
+
+ As long as I live I shall never forget \typein{Enter student name:}
+
+coupled with this command line interaction
+
+ Enter student name:
+
+ \@typein=Aphra Behn
+
+gives the output '... never forget Aphra Behn'.
+
+ The first command version, '\typein{PROMPT-MSG}', causes the input
+you typed to be processed as if it had been included in the input file
+in place of the '\typein' command.
+
+ In the second command version the optional argument 'CMD' argument
+must be a command name -- it must begin with a backslash, \. This
+command name is then defined or redefined to be the input that you
+typed. For example, this
- \typein[\CMD]{MSG}
+ \typein[\student]{Enter student name:}
+ \typeout{Recommendation for \student .}
- '\typein' prints MSG on the terminal and causes LaTeX to stop and
-wait for you to type a line of input, ending with return. If the
-optional '\CMD' argument is omitted, the typed input is processed as if
-it had been included in the input file in place of the '\typein'
-command. If the '\CMD' argument is present, it must be a command name.
-This command name is then defined or redefined to be the typed input.
+gives this output on the command line,
+
+ Enter student name:
+
+ \student=John Dee
+ Recommendation for John Dee.
+
+where the user has entered 'John Dee.'

File: latex2e.info, Node: \typeout, Prev: \typein, Up: Terminal input/output
-27.2 '\typeout{MSG}'
-====================
+27.2 '\typeout'
+===============
Synopsis:
\typeout{MSG}
- Prints 'msg' on the terminal and in the 'log' file. Commands in
-'msg' that are defined with '\newcommand' or '\renewcommand' (among
-others) are replaced by their definitions before being printed.
+ Print 'msg' on the terminal and in the 'log' file.
+
+ This
+
+ \newcommand{\student}{John Dee}
+ \typeout{Recommendation for \student .}
+
+outputs 'Recommendation for John Dee'. Like what happens here with
+'\student', commands that are defined with '\newcommand' or
+'\renewcommand' (among others) are replaced by their definitions before
+being printed.
LaTeX's usual rules for treating multiple spaces as a single space
-and ignoring spaces after a command name apply to 'msg'. A '\space'
-command in 'msg' causes a single space to be printed, independent of
-surrounding spaces. A '^^J' in 'msg' prints a newline.
+and ignoring spaces after a command name apply to 'msg'. As above, use
+the command '\space' to get a single space, independent of surrounding
+spaces. Use '^^J' to get a newline. Get a percent character with
+'\csname @percentchar\endcsname'.
+
+ This command can be useful for simple debugging, as here:
+
+ \newlength{\jhlength}
+ \setlength{\jhlength}{5pt}
+ \typeout{The length is \the\jhlength.}
+
+produces on the command line 'The length is 5.0pt'.

File: latex2e.info, Node: Command line, Next: Document templates, Prev: Terminal input/output, Up: Top
@@ -10528,26 +14592,228 @@ File: latex2e.info, Node: Command line, Next: Document templates, Prev: Termi
28 Command line
***************
-The input file specification indicates the file to be formatted; TeX
-uses '.tex' as a default file extension. If you omit the input file
-entirely, TeX accepts input from the terminal. You can also specify
-arbitrary LaTeX input by starting with a backslash. For example, this
-processes 'foo.tex' without pausing after every error:
+Synopsis (from a terminal command line):
- latex '\nonstopmode\input foo.tex'
+ pdflatex OPTIONS ARGUMENT
- With many, but not all, implementations, command-line options can
-also be specified in the usual Unix way, starting with '-' or '--'. For
-a list of those options, try 'latex --help'.
+ Run LaTeX on ARGUMENT. In place of 'pdflatex' you can also use
+'xelatex', or 'lualatex', or 'dviluatex', or 'latex'.
- If LaTeX stops in the middle of the document and gives you a '*'
-prompt, it is waiting for input. You can type '\stop' (and return) and
-it will prematurely end the document.
+ For example, this will run LaTeX on the file 'thesis.tex', creating
+the output 'thesis.pdf'.
- *Note TeX engines::, for other system commands invoking LaTeX.
+ pdflatex thesis
+
+Note that '.tex' is the default file extension.
+
+ pdfTeX is a development of the original TeX program, as are XeTeX and
+LuaTeX (*note TeX engines::). They are completely backward compatible.
+But the original program had a custom output format, DVI, while the
+newer ones can output directly to PDF. This allows them to take
+advantage of the extra features in PDF such as hyperlinks, support for
+modern image formats such as JPG and PNG, and ubiquitous viewing
+programs. In short, if you run 'pdflatex' or 'xelatex' or 'lualatex'
+then you will by default get PDF and have access to all its modern
+features. If you run 'latex', or 'dvilualatex', then you will get DVI.
+The description here assumes pdfLaTeX.
+
+ *Note Command line options::, for a selection of the most useful
+command line options. As to ARGUMENT, the usual case is that it does
+not begin with a backslash, so the system takes it to be the name of a
+file and it compiles that file. If ARGUMENT begins with a backslash
+then the system will interpret it as a line of LaTeX input, which can be
+used for special effects (*note Command line input::).
+
+ If you gave no arguments or options then 'pdflatex' prompts for input
+from the terminal. You can escape from this by entering '<control>-D'.
+
+ If LaTeX finds an error in your document then by default it stops and
+asks you about it. *Note Recovering from errors:: for an outline of
+what to do.
+
+* Menu:
+
+* Command line options:: Read text from the terminal.
+* Command line input:: Write text to the terminal.
+* Recovering from errors:: When something goes wrong.

-File: latex2e.info, Node: Document templates, Next: Concept Index, Prev: Command line, Up: Top
+File: latex2e.info, Node: Command line options, Next: Command line input, Up: Command line
+
+28.1 Command line options
+=========================
+
+These are the command-line options relevant to ordinary document
+authoring. For a full list, try running 'latex --help' from the command
+line.
+
+ With many implementations you can specify command line options by
+prefixing them with '-' or '--'. This is the case for both TeX Live
+(and MacTeX) and MiKTeX. We will use both conventions interchangeably.
+
+'-version'
+ Show the current version, like 'pdfTeX 3.14159265-2.6-1.40.16 (TeX
+ Live 2015/Debian)' along with a small amount of additional
+ information, and exit.
+
+'-help'
+ Give a brief usage message that is useful as a prompt and exit.
+
+'-interaction=MODE'
+ TeX compiles a document in one of four interaction modes:
+ 'batchmode', 'nonstopmode', 'scrollmode', 'errorstopmode'. In
+ "errorstop mode" (the default), TeX stops at each error and asks
+ for user intervention. In "batch mode" it prints nothing on the
+ terminal, errors are scrolled as if the user hit '<return>' at
+ every error, and missing files cause the job to abort. In "nonstop
+ mode", diagnostic message appear on the terminal but as in batch
+ mode there is no user interaction. In "scroll mode", TeX only
+ stops for missing files or keyboard input.
+
+ For instance, starting LaTeX with this command line
+
+ pdflatex -interaction=batchmode FILENAME
+
+ eliminates most terminal output.
+
+'-jobname=STRING'
+ Set the value of TeX's 'jobname' to the string. The log file and
+ output file will then be named 'STRING.log' and 'STRING.pdf'.
+
+ When you run 'pdflatex OPTIONS ARGUMENT', if ARGUMENT does not
+ start with a backslash then TeX considers it the name of a file to
+ input. Otherwise it waits for the first '\input' instruction and
+ the name of the input file will be the job name. This is used to
+ name the log file the output file. This option overrides that
+ process and directly specifies the name. *Note Command line
+ input:: for an example of its use.
+
+'-output-directory=DIRECTORY'
+ Write files in the directory DIRECTORY. It must already exist.
+
+'shell-escape'
+'no-shell-escape'
+'enable-write18'
+'disable-write18'
+ Enable or disable '\write18{SHELL COMMAND}'. The first two options
+ are for with TeX Live or MacTeX while the second two are for
+ MiKTeX.
+
+ Sometimes you want to run external system commands from inside a
+ LaTeX file. For instance the package 'sagetex' allows you to have
+ the mathematics software system Sage do calculations or draw graphs
+ and then incorporate that output in your document. For this TeX
+ provides the '\write18' command.
+
+ But with this functionality enabled, security issues could happen
+ if you compiled a LaTeX file from the Internet. By default
+ '\write18' is disabled. (More precisely, by default TeX Live,
+ MacTeX, and MiKTeX only allow the execution of a limited number of
+ TeX-related programs, which they distribute.)
+
+ If you invoke LaTeX with the option 'no-shell-escape', and in your
+ document you call '\write18{ls -l}', then you do not get an error
+ but the log file says 'runsystem(ls -l)...disabled'.
+
+'-halt-on-error'
+ Stop processing at the first error.
+
+'-file-line-error'
+'-no-file-line-error'
+ Enable or disable 'FILENAME:LINENO:ERROR'-style error messages.
+ These are only available with TeX Live or MacTeX.
+
+
+File: latex2e.info, Node: Command line input, Next: Recovering from errors, Prev: Command line options, Up: Command line
+
+28.2 Command line input
+=======================
+
+As part of the command line invocation 'pdflatex OPTIONS ARGUMENT' you
+can specify arbitrary LaTeX input by starting ARGUMENT with a backslash.
+This allows you to do some special effects.
+
+ For example, this file (which uses the 'hyperref' package for
+hyperlinks) can produce two kinds of output, one for paper and one for a
+PDF.
+
+ \ifdefined\paperversion % in preamble
+ \newcommand{\urlcolor}{black}
+ \else
+ \newcommand{\urlcolor}{blue}
+ \fi
+ \usepackage[colorlinks=true,urlcolor=\urlcolor]{hyperref}
+ ...
+ \href{https://www.ctan.org}{CTAN} % in body
+ ...
+
+Compiling this document 'book.tex' with the command line 'pdflatex test'
+will give the 'CTAN' link in blue. But compiling it with 'pdflatex
+"\def\paperversion{}\input test.tex"' has the link in black. (Note the
+use of double quotes to prevent interpretation of the symbols by the
+command line shell; your system may do this differently.)
+
+ In a similar way, from the single file 'main.tex' you can compile two
+different versions.
+
+ pdflatex -jobname=students "\def\student{}\input{main}"
+ pdflatex -jobname=teachers "\def\teachers{}\input{main}"
+
+The 'jobname' option is there because otherwise both files would be
+called 'main.pdf' and the second would overwrite the first.
+
+ A final example. This loads the package 'graphicx' with the option
+'draft'
+
+ pdflatex -jobname=aa "\RequirePackage[draft]{graphicx}\input{aa.tex}"
+
+so the graphic files are read for their size information but not
+incorporated into the PDF. (The 'jobname' option is needed because
+otherwise the output file would be 'graphicx.pdf', as '\RequirePackage'
+does an '\input' of its own.)
+
+
+File: latex2e.info, Node: Recovering from errors, Prev: Command line input, Up: Command line
+
+28.3 Recovering from errors
+===========================
+
+If LaTeX finds an error in your document then it gives you an error
+message and prompts you with a question mark, '?'. For instance,
+running LaTeX on this file
+
+ \newcommand{\NP}{\ensuremath{\textbf{NP}}}
+ The \PN{} problem is a million dollar one.
+
+causes it show this, and wait for input.
+
+ ! Undefined control sequence.
+ l.5 The \PN
+ {} problem is a million dollar one.
+ ?
+
+The simplest thing is to enter 'x' and '<return>' and fix the typo. You
+could instead enter '?' and '<return>' to see other options.
+
+ There are two other error scenarios. The first is that you forgot to
+include the '\end{document}' or misspelled it. In this case LaTeX gives
+you a '*' prompt. You can get back to the command line by typing
+'\stop' and '<return>'.
+
+ The last scenario is that you mistyped the file name. For instance,
+instead of 'pdflatex test' you might type 'pdflatex tste'.
+
+ ! I can't find file `tste'.
+ <*> tste
+
+ (Press Enter to retry, or Control-D to exit)
+ Please type another input file name:
+
+The simplest thing is to enter '<Contol>' and 'd' (holding them down at
+the same time), and just fix the command line.
+
+
+File: latex2e.info, Node: Document templates, Next: Index, Prev: Command line, Up: Top
Appendix A Document templates
*****************************
@@ -10559,11 +14825,13 @@ be useful. Additional template resources are listed at
* Menu:
* beamer template::
+* article template::
* book template::
+* Larger book template::
* tugboat template::

-File: latex2e.info, Node: beamer template, Next: book template, Up: Document templates
+File: latex2e.info, Node: beamer template, Next: article template, Up: Document templates
A.1 'beamer' template
=====================
@@ -10597,11 +14865,37 @@ features, but here is a basic template:
<http://robjhyndman.com/hyndsight/beamer/>.

-File: latex2e.info, Node: book template, Next: tugboat template, Prev: beamer template, Up: Document templates
+File: latex2e.info, Node: article template, Next: book template, Prev: beamer template, Up: Document templates
+
+A.2 'article' template
+======================
+
+\documentclass{article}
+\title{Article Class Template}
+\author{Alex Author}
+
+\begin{document}
+\maketitle
+
+\section{First section}
+Some text.
+
+\subsection{First section, first subsection}
+Additional text.
+
+\section{Second section}
+Some more text.
+\end{document}
+
+
+File: latex2e.info, Node: book template, Next: Larger book template, Prev: article template, Up: Document templates
-A.2 'book' template
+A.3 'book' template
===================
+This is a straightforward template for a book. See *Note Larger book
+template:: for a more elaborate one.
+
\documentclass{book}
\title{Book Class Template}
\author{Alex Author}
@@ -10620,9 +14914,62 @@ The end.
\end{document}

-File: latex2e.info, Node: tugboat template, Prev: book template, Up: Document templates
+File: latex2e.info, Node: Larger book template, Next: tugboat template, Prev: book template, Up: Document templates
+
+A.4 Larger 'book' template
+==========================
+
+This is a more elaborate template for a book. It has '\frontmatter',
+'\mainmatter', and '\backmatter' to control the typography of the three
+main areas of a book (*note \frontmatter & \mainmatter & \backmatter::).
+The book has a bibliography and an index.
+
+ Notable is that it uses '\include' and '\includeonly' (*note
+Splitting the input::). While you are working on a chapter you can
+comment out all the other chapter entries from the argument to
+'\includeonly'. That will speed up compilation without losing any
+information such as cross-references. (Material that does not need to
+come on a new page is brought in with '\input' instead of '\include'.
+You don't get the cross-reference benefit this way.)
+
+\documentclass[titlepage]{book}
+\usepackage{makeidx}\makeindex
+
+\title{Book Class Template}
+\author{Alex Author}
+
+\includeonly{%
+ frontcover,
+ preface,
+ chap1,
+ ...
+ }
+\begin{document}
+\frontmatter
+\include{frontcover}
+ % maybe comment out while drafting:
+\maketitle \input{dedication} \input{copyright}
+\tableofcontents
+\include{preface}
+\mainmatter
+\include{chap1}
+...
+\appendix
+\include{appena}
+...
+\backmatter
+\bibliographystyle{apalike}
+\addcontentsline{toc}{chapter}{Bibliography}
+\bibliography
+\addcontentsline{toc}{chapter}{Index}
+\printindex
+\include{backcover}
+\end{document}
+
+
+File: latex2e.info, Node: tugboat template, Prev: Larger book template, Up: Document templates
-A.3 'tugboat' template
+A.5 'tugboat' template
======================
'TUGboat' is the journal of the TeX Users Group,
@@ -10709,958 +15056,118 @@ Email \verb|tugboat@tug.org| if problems or questions.
\end{document}

-File: latex2e.info, Node: Concept Index, Next: Command Index, Prev: Document templates, Up: Top
+File: latex2e.info, Node: Index, Prev: Document templates, Up: Top
-Concept Index
-*************
+Index
+*****
* Menu:
-* * prompt: Command line. (line 18)
+* &: tabular. (line 32)
+* * prompt: Recovering from errors.
+ (line 23)
* *-form of environment commands: \newenvironment & \renewenvironment.
- (line 14)
+ (line 27)
* *-form of sectioning commands: Sectioning. (line 31)
* *-form, defining new commands: \newcommand & \renewcommand.
- (line 14)
-* .glo file: Glossaries. (line 8)
-* .idx file: Indexes. (line 9)
-* .ind file: Indexes. (line 23)
-* 'see' and 'see also' index entries: Indexes. (line 16)
-* abstracts: abstract. (line 6)
-* accents: Accents. (line 6)
-* accents, mathematical: Math accents. (line 6)
-* accessing any character of a font: Symbols by font position.
- (line 6)
-* acute accent: Accents. (line 20)
-* acute accent, math: Math accents. (line 11)
-* additional packages, loading: Additional packages. (line 6)
-* ae ligature: Additional Latin letters.
- (line 16)
-* algorithm2e package: tabbing. (line 144)
-* align environment, from amsmath: eqnarray. (line 6)
-* aligning equations: eqnarray. (line 6)
-* alignment via tabbing: tabbing. (line 6)
-* amsmath package: array. (line 40)
-* amsmath package <1>: displaymath. (line 22)
-* amsmath package, replacing eqnarray: eqnarray. (line 6)
-* appendix, creating: Sectioning. (line 37)
-* aring: Additional Latin letters.
- (line 12)
-* arrays, math: array. (line 6)
-* arrow, left, in text: Text symbols. (line 131)
-* arrow, right, in text: Text symbols. (line 166)
-* ascender height: Text symbols. (line 99)
-* ASCII circumflex, in text: Text symbols. (line 64)
-* ASCII tilde, in text: Text symbols. (line 67)
-* asterisk, centered, in text: Text symbols. (line 70)
-* at clause, in font definitions: \newfont. (line 23)
-* author, for titlepage: \maketitle. (line 12)
-* auxiliary file: Output files. (line 33)
-* babel package: thebibliography. (line 29)
-* babel package <1>: Accents. (line 6)
-* background, colored: Colored pages. (line 6)
-* backslash, in text: Text symbols. (line 73)
-* bar, double vertical, in text: Text symbols. (line 79)
-* bar, vertical, in text: Text symbols. (line 76)
-* bar-over accent: Accents. (line 29)
-* bar-over accent, math: Math accents. (line 14)
-* bar-under accent: Accents. (line 46)
-* basics of LaTeX: Overview. (line 6)
-* beamer template and class: beamer template. (line 6)
-* beginning of document hook: \AtBeginDocument. (line 6)
-* bibliography format, open: Document class options.
- (line 67)
-* bibliography, creating (automatically): Using BibTeX. (line 6)
-* bibliography, creating (manually): thebibliography. (line 6)
-* bibTeX, using: Using BibTeX. (line 6)
-* big circle symbols, in text: Text symbols. (line 82)
-* Big point: Units of length. (line 20)
-* black boxes, omitting: Document class options.
- (line 53)
-* bold font: Font styles. (line 71)
-* bold math: Font styles. (line 130)
-* bold typewriter, avoiding: description. (line 34)
-* box, allocating new: \newsavebox. (line 6)
-* box, colored: Colored boxes. (line 6)
-* boxes: Boxes. (line 6)
-* brace, left, in text: Text symbols. (line 85)
-* brace, right, in text: Text symbols. (line 88)
-* breaking lines: Line breaking. (line 6)
-* breaking pages: Page breaking. (line 6)
-* breve accent: Accents. (line 86)
-* breve accent, math: Math accents. (line 17)
-* bug reporting: About this document. (line 21)
-* bullet symbol: Math symbols. (line 114)
-* bullet, in text: Text symbols. (line 91)
-* bulleted lists: itemize. (line 6)
-* calligraphic letters for math: Font styles. (line 74)
-* cap height: Text symbols. (line 99)
-* caron accent: Accents. (line 97)
-* catcode: \makeatletter and \makeatother.
- (line 18)
-* category code, character: \makeatletter and \makeatother.
- (line 18)
-* cc list, in letters: \cc. (line 6)
-* cedilla accent: Accents. (line 51)
-* centered asterisk, in text: Text symbols. (line 70)
-* centered equations: Document class options.
- (line 57)
-* centered period, in text: Text symbols. (line 138)
-* centering text, declaration for: \centering. (line 6)
-* centering text, environment for: center. (line 6)
-* Centimeter: Units of length. (line 24)
-* character category code: \makeatletter and \makeatother.
- (line 18)
-* characters, accented: Accents. (line 6)
-* characters, case: Upper and lower case.
- (line 6)
-* characters, non-English: Additional Latin letters.
- (line 6)
-* characters, reserved: Reserved characters. (line 6)
-* characters, special: Reserved characters. (line 6)
-* check accent: Accents. (line 97)
-* check accent, math: Math accents. (line 20)
-* Cicero: Units of length. (line 33)
-* circle symbol, big, in text: Text symbols. (line 82)
-* circled letter, in text: Text symbols. (line 94)
-* circumflex accent: Accents. (line 33)
-* circumflex accent, math: Math accents. (line 32)
-* circumflex, ASCII, in text: Text symbols. (line 64)
-* citation key: \bibitem. (line 12)
-* class and package commands: Class and package commands.
- (line 6)
-* class and package difference: Class and package construction.
- (line 15)
-* class and package structure: Class and package structure.
- (line 6)
-* class file example: Class and package structure.
- (line 36)
-* class file layout: Class and package structure.
- (line 6)
-* class options: Document class options.
- (line 6)
-* class options <1>: Class and package structure.
- (line 6)
-* class options <2>: Class and package commands.
- (line 66)
-* classes of documents: Document classes. (line 6)
-* closing letters: \closing. (line 6)
-* closing quote: Text symbols. (line 55)
-* code, typesetting: verbatim. (line 6)
-* color: Color. (line 6)
-* color <1>: Define colors. (line 6)
-* color <2>: Colored text. (line 6)
-* color <3>: Colored boxes. (line 6)
-* color <4>: Colored pages. (line 6)
-* color models: Color models. (line 6)
-* color package commands: Commands for color. (line 6)
-* color package options: Color package options.
- (line 6)
-* color, define: Define colors. (line 6)
-* colored boxes: Colored boxes. (line 6)
-* colored page: Colored pages. (line 6)
-* colored text: Colored text. (line 6)
-* command line: Command line. (line 6)
-* command syntax: LaTeX command syntax.
- (line 6)
-* commands, class and package: Class and package commands.
- (line 6)
-* commands, defining new ones: \newcommand & \renewcommand.
- (line 6)
-* commands, defining new ones <1>: \providecommand. (line 6)
-* commands, document class: Class and package construction.
- (line 6)
-* commands, graphics package: Commands for graphics.
- (line 6)
-* commands, ignore spaces: \ignorespaces & \ignorespacesafterend.
- (line 6)
-* commands, redefining: \newcommand & \renewcommand.
- (line 6)
-* commands, star-variants: \@ifstar. (line 6)
-* composite word mark, in text: Text symbols. (line 99)
-* computer programs, typesetting: verbatim. (line 6)
-* configuration, graphics package: Graphics package configuration.
- (line 6)
-* contents file: Output files. (line 43)
-* copyright symbol: Text symbols. (line 12)
-* counters, a list of: Counters. (line 6)
-* counters, defining new: \newcounter. (line 6)
-* counters, getting value of: \value. (line 6)
-* counters, printing: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 6)
-* counters, setting: \setcounter. (line 6)
-* creating pictures: picture. (line 6)
-* creating tables: table. (line 6)
-* credit footnote: \maketitle. (line 22)
-* cross references: Cross references. (line 6)
-* cross references, resolving: Output files. (line 33)
-* cross referencing with page number: \pageref. (line 6)
-* cross referencing, symbolic: \ref. (line 6)
-* currency, dollar: Text symbols. (line 110)
-* currency, euro: Text symbols. (line 119)
-* dagger, double, in text: Text symbols. (line 107)
-* dagger, in text: Text symbols. (line 15)
-* dagger, in text <1>: Text symbols. (line 104)
-* date, for titlepage: \maketitle. (line 18)
-* date, today's: \today. (line 6)
-* datetime package: \today. (line 22)
-* define color: Define colors. (line 6)
-* defining a new command: \newcommand & \renewcommand.
- (line 6)
-* defining a new command <1>: \providecommand. (line 6)
-* defining new environments: \newenvironment & \renewenvironment.
- (line 6)
-* defining new fonts: \newfont. (line 6)
-* defining new theorems: \newtheorem. (line 6)
-* definitions: Definitions. (line 6)
-* description lists, creating: description. (line 6)
-* design size, in font definitions: \newfont. (line 23)
-* Didot point: Units of length. (line 30)
-* dieresis accent: Accents. (line 16)
-* difference between class and package: Class and package construction.
- (line 15)
-* discretionary hyphenation: \discretionary. (line 6)
-* discretionary multiplication: Math miscellany. (line 7)
-* displaying quoted text with paragraph indentation: quotation and quote.
- (line 6)
-* displaying quoted text without paragraph indentation: quotation and quote.
- (line 6)
-* document class commands: Class and package construction.
- (line 6)
-* document class options: Document class options.
- (line 6)
-* document class, defined: Starting and ending. (line 14)
-* document classes: Document classes. (line 6)
-* document templates: Document templates. (line 6)
-* dollar sign: Text symbols. (line 110)
-* dot accent: Accents. (line 25)
-* dot over accent, math: Math accents. (line 26)
-* dot-over accent: Accents. (line 25)
-* dot-under accent: Accents. (line 55)
-* dotless i: Accents. (line 63)
-* dotless i, math: Math accents. (line 35)
-* dotless j: Accents. (line 66)
-* dotless j, math: Math accents. (line 38)
-* double angle quotation marks: Text symbols. (line 30)
-* double dagger, in text: Text symbols. (line 18)
-* double dagger, in text <1>: Text symbols. (line 107)
-* double dot accent, math: Math accents. (line 23)
-* double guillemets: Text symbols. (line 30)
-* double left quote: Text symbols. (line 144)
-* double low-9 quotation mark: Text symbols. (line 52)
-* double quote, straight base: Text symbols. (line 160)
-* double right quote: Text symbols. (line 147)
-* double spacing: Low-level font commands.
- (line 118)
-* double vertical bar, in text: Text symbols. (line 79)
-* e-dash: Text symbols. (line 116)
-* e-TeX: TeX engines. (line 12)
-* ellipsis: Text symbols. (line 36)
-* em: Units of length. (line 38)
-* em-dash: Text symbols. (line 113)
-* em-dash, three-quarters: Text symbols. (line 169)
-* em-dash, two-thirds: Text symbols. (line 175)
-* emphasis: Font styles. (line 59)
-* enclosure list: \encl. (line 6)
-* end of document hook: \AtEndDocument. (line 6)
-* ending and starting: Starting and ending. (line 6)
-* engines, TeX: TeX engines. (line 6)
-* enlarge current page: \enlargethispage. (line 6)
-* enumitem package: list. (line 24)
-* environment: Starting and ending. (line 22)
-* environment, theorem-like: \newtheorem. (line 6)
-* environments: Environments. (line 6)
-* environments, defining: \newenvironment & \renewenvironment.
- (line 6)
-* EPS files: Graphics package configuration.
- (line 6)
-* EPS files <1>: \includegraphics. (line 6)
-* equation number, cross referencing: \ref. (line 6)
-* equation numbers, left vs. right: Document class options.
- (line 63)
-* equation numbers, omitting: eqnarray. (line 41)
-* equations, aligning: eqnarray. (line 6)
-* equations, environment for: equation. (line 6)
-* equations, flush left vs. centered: Document class options.
- (line 57)
-* es-zet German letter: Additional Latin letters.
- (line 52)
-* eth, Icelandic letter: Additional Latin letters.
- (line 20)
-* etoolbox package: Class and package commands.
- (line 110)
-* euro symbol: Text symbols. (line 119)
-* ex: Units of length. (line 38)
-* exclamation point, upside-down: Text symbols. (line 122)
-* exponent: Subscripts & superscripts.
- (line 6)
-* extended Latin: Additional Latin letters.
- (line 6)
-* external files, writing: filecontents. (line 6)
-* families, of fonts: Low-level font commands.
- (line 21)
-* fancyvrb package: tabbing. (line 144)
-* feminine ordinal symbol: Text symbols. (line 135)
-* figure number, cross referencing: \ref. (line 6)
-* figures, footnotes in: minipage. (line 21)
-* figures, inserting: figure. (line 6)
-* file, root: Splitting the input. (line 9)
-* fixed-width font: Font styles. (line 92)
-* flafter package: Floats. (line 82)
-* float package: Floats. (line 52)
-* float page: Floats. (line 58)
-* flush left equations: Document class options.
- (line 57)
-* flushing floats and starting a page: \clearpage. (line 6)
-* font catalogue: Low-level font commands.
- (line 21)
-* font commands, low-level: Low-level font commands.
- (line 6)
-* font size: Low-level font commands.
- (line 101)
-* font sizes: Font sizes. (line 6)
-* font styles: Font styles. (line 6)
-* font symbols, by number: Symbols by font position.
- (line 6)
-* fonts: Fonts. (line 6)
-* fonts, new commands for: \newfont. (line 6)
-* footer style: \pagestyle. (line 6)
-* footer, parameters for: Page layout parameters.
- (line 6)
-* footmisc package: Footnotes in section headings.
- (line 10)
-* footnote number, cross referencing: \ref. (line 6)
-* footnote parameters: Footnote parameters. (line 6)
-* footnotes in figures: minipage. (line 21)
-* footnotes, creating: Footnotes. (line 6)
-* Footnotes, in a minipage: \footnote. (line 35)
-* Footnotes, in a table: Footnotes in a table.
- (line 6)
-* footnotes, in section headings: Footnotes in section headings.
- (line 6)
-* footnotes, symbols instead of numbers: \footnote. (line 23)
-* formulas, environment for: equation. (line 6)
-* formulas, math: Math formulas. (line 6)
-* forward reference: Cross references. (line 22)
-* forward references, resolving: Output files. (line 33)
-* fragile commands: \protect. (line 6)
-* French quotation marks: Text symbols. (line 30)
-* functions, math: Math functions. (line 6)
-* geometry package: Document class options.
- (line 40)
-* geometry package <1>: Document class options.
- (line 44)
-* global options: Document class options.
- (line 6)
-* global options <1>: Additional packages. (line 15)
-* glossaries: Glossaries. (line 6)
-* glossary package: Glossaries. (line 15)
-* glue register, plain TeX: \newlength. (line 6)
-* graphics: Graphics. (line 6)
-* graphics <1>: Graphics package configuration.
- (line 6)
-* graphics <2>: \includegraphics. (line 6)
-* graphics package: Graphics. (line 6)
-* graphics package <1>: Graphics package configuration.
- (line 6)
-* graphics package <2>: \includegraphics. (line 6)
-* graphics package commands: Commands for graphics.
- (line 6)
-* graphics package options: Graphics package options.
- (line 6)
-* graphics packages: \line. (line 13)
-* graphics, resizing: \scalebox. (line 6)
-* graphics, resizing <1>: \resizebox. (line 6)
-* graphics, scaling: \scalebox. (line 6)
-* graphics, scaling <1>: \resizebox. (line 6)
-* grave accent: Accents. (line 37)
-* grave accent, math: Math accents. (line 29)
-* greater than symbol, in text: Text symbols. (line 125)
-* greek letters: Math symbols. (line 6)
-* group, and environments: Environments. (line 18)
-* ha'c<ek accent, math: Math accents. (line 20)
-* hacek accent: Accents. (line 97)
-* hat accent: Accents. (line 33)
-* hat accent, math: Math accents. (line 32)
-* header style: \pagestyle. (line 6)
-* header, parameters for: Page layout parameters.
- (line 6)
-* hello, world: Starting and ending. (line 6)
-* here, putting floats: Floats. (line 52)
-* hungarian umlaut accent: Accents. (line 59)
-* hyphenation, defining: \hyphenation. (line 6)
-* hyphenation, discretionary: \discretionary. (line 6)
-* hyphenation, forcing: \- (hyphenation). (line 6)
-* hyphenation, preventing: \mbox. (line 6)
-* Icelandic eth: Additional Latin letters.
- (line 20)
-* Icelandic thorn: Additional Latin letters.
- (line 56)
-* ij letter, Dutch: Additional Latin letters.
- (line 32)
-* implementations of TeX: TeX engines. (line 6)
-* importing graphics: \includegraphics. (line 6)
-* in-line formulas: math. (line 6)
-* including graphics: \includegraphics. (line 6)
-* indent, forcing: \indent. (line 6)
-* indent, suppressing: \noindent. (line 6)
-* indentation of paragraphs, in minipage: minipage. (line 17)
-* index entries, 'see' and 'see also': Indexes. (line 16)
-* indexes: Indexes. (line 6)
-* infinite horizontal stretch: \hfill. (line 6)
-* infinite vertical stretch: \vfill. (line 6)
-* input file: Splitting the input. (line 6)
-* input/output, to terminal: Terminal input/output.
- (line 6)
-* inserting figures: figure. (line 6)
-* insertions of special characters: Special insertions. (line 6)
-* italic correction: \/. (line 6)
-* italic font: Font styles. (line 77)
-* JPEG files: Graphics package configuration.
- (line 6)
-* JPEG files <1>: \includegraphics. (line 6)
-* JPG files: Graphics package configuration.
- (line 6)
-* JPG files <1>: \includegraphics. (line 6)
-* justification, ragged left: \raggedleft. (line 6)
-* justification, ragged right: \raggedright. (line 6)
-* Knuth, Donald E.: Overview. (line 6)
-* label: Cross references. (line 9)
-* labelled lists, creating: description. (line 6)
-* Lamport TeX: Overview. (line 24)
-* Lamport, Leslie: Overview. (line 6)
-* landscape orientation: Document class options.
- (line 60)
-* LaTeX logo: Text symbols. (line 21)
-* LaTeX overview: Overview. (line 6)
-* LaTeX Project team: About this document. (line 17)
-* LaTeX vs. LaTeX2e: About this document. (line 13)
-* LaTeX2e logo: Text symbols. (line 24)
-* Latin letters, additional: Additional Latin letters.
- (line 6)
-* layout commands: Layout. (line 6)
-* layout, page parameters for: Page layout parameters.
- (line 6)
-* left angle quotation marks: Text symbols. (line 30)
-* left arrow, in text: Text symbols. (line 131)
-* left brace, in text: Text symbols. (line 85)
-* left quote: Text symbols. (line 40)
-* left quote, double: Text symbols. (line 144)
-* left quote, single: Text symbols. (line 150)
-* left-hand equation numbers: Document class options.
- (line 63)
-* left-justifying text: \raggedright. (line 6)
-* left-justifying text, environment for: flushleft. (line 6)
-* left-to-right mode: Modes. (line 6)
-* length command: \setlength. (line 10)
-* lengths, adding to: \addtolength. (line 6)
-* lengths, allocating new: \newlength. (line 6)
-* lengths, defining and using: Lengths. (line 6)
-* lengths, predefined: Predefined lengths. (line 6)
-* lengths, setting: \setlength. (line 6)
-* less than symbol, in text: Text symbols. (line 128)
-* letters, accented: Accents. (line 6)
-* letters, additional Latin: Additional Latin letters.
- (line 6)
-* letters, ending: \closing. (line 6)
-* letters, starting: \opening. (line 6)
-* letters, writing: Letters. (line 6)
-* line break, forcing: \\. (line 6)
-* line breaking: Line breaking. (line 6)
-* line breaks, forcing: \linebreak & \nolinebreak.
- (line 6)
-* line breaks, preventing: \linebreak & \nolinebreak.
- (line 6)
-* lines in tables: tabular. (line 6)
-* lining numerals: Font styles. (line 134)
-* lining text up in tables: tabular. (line 6)
-* lining text up using tab stops: tabbing. (line 6)
-* list items, specifying counter: \usecounter. (line 6)
-* list of figures file: Output files. (line 43)
-* list of tables file: Output files. (line 43)
-* listings package: tabbing. (line 144)
-* lists of items: itemize. (line 6)
-* lists of items, generic: list. (line 6)
-* lists of items, numbered: enumerate. (line 6)
-* loading additional packages: Additional packages. (line 6)
-* log file: Output files. (line 28)
-* logo, LaTeX: Text symbols. (line 21)
-* logo, LaTeX2e: Text symbols. (line 24)
-* logo, TeX: Text symbols. (line 61)
-* long command: Class and package commands.
- (line 23)
-* low-9 quotation marks, single and double: Text symbols. (line 52)
-* low-level font commands: Low-level font commands.
- (line 6)
-* Lower case: Upper and lower case.
- (line 6)
-* LR mode: Modes. (line 6)
-* ltugboat class: tugboat template. (line 6)
-* LuaTeX: TeX engines. (line 29)
-* m-width: Units of length. (line 38)
-* macro package, LaTeX as: Overview. (line 11)
-* macron accent: Accents. (line 29)
-* macron accent, math: Math accents. (line 14)
-* macros2e package: \makeatletter and \makeatother.
- (line 39)
-* Madsen, Lars: eqnarray. (line 6)
-* makeidx package: Indexes. (line 28)
-* makeindex program: Indexes. (line 23)
-* making a title page: titlepage. (line 6)
-* making paragraphs: Making paragraphs. (line 6)
-* marginal notes: Marginal notes. (line 6)
-* masculine ordinal symbol: Text symbols. (line 135)
-* math accents: Math accents. (line 6)
-* math formulas: Math formulas. (line 6)
-* math functions: Math functions. (line 6)
-* math miscellany: Math miscellany. (line 6)
-* math mode: Modes. (line 6)
-* math mode, entering: Math formulas. (line 6)
-* math mode, spacing: Spacing in math mode.
- (line 6)
-* math symbols: Math symbols. (line 6)
-* math, bold: Font styles. (line 130)
-* mfirstuc package: Upper and lower case.
- (line 45)
-* Millimeter: Units of length. (line 27)
-* minipage, creating a: minipage. (line 6)
-* minted package: tabbing. (line 144)
-* modes: Modes. (line 6)
-* monospace font: Font styles. (line 92)
-* moving arguments: \protect. (line 19)
-* mpfootnote counter: \footnote. (line 35)
-* mu, math unit: Units of length. (line 49)
-* multicolumn text: \twocolumn. (line 6)
-* multilingual support: Accents. (line 6)
-* multind package: Indexes. (line 39)
-* multiplication symbol, discretionary line break: Math miscellany.
- (line 7)
-* nested \include, not allowed: \include. (line 18)
-* new class commands: Class and package construction.
- (line 6)
-* new command, check: Class and package commands.
- (line 21)
-* new command, definition: Class and package commands.
- (line 96)
-* new commands, defining: \newcommand & \renewcommand.
- (line 6)
-* new commands, defining <1>: \providecommand. (line 6)
-* new line, output as input: \obeycr & \restorecr.
- (line 6)
-* new line, starting: \\. (line 6)
-* new line, starting (paragraph mode): \newline. (line 6)
-* new page, starting: \newpage. (line 6)
-* non-English characters: Additional Latin letters.
- (line 6)
-* notes in the margin: Marginal notes. (line 6)
-* null delimiter: Math miscellany. (line 36)
-* numbered items, specifying counter: \usecounter. (line 6)
-* numerals, old-style: Font styles. (line 134)
-* oblique font: Font styles. (line 89)
-* oe ligature: Additional Latin letters.
- (line 48)
-* ogonek: Accents. (line 70)
-* old-style numerals: Font styles. (line 134)
-* one-column output: \onecolumn. (line 6)
-* opening quote: Text symbols. (line 40)
-* OpenType fonts: TeX engines. (line 6)
-* options, class: Class and package commands.
- (line 66)
-* options, color package: Color package options.
- (line 6)
-* options, document class: Document class options.
- (line 6)
-* options, document class <1>: Class and package structure.
- (line 6)
-* options, global: Additional packages. (line 15)
-* options, graphics package: Graphics package options.
- (line 6)
-* options, package: Class and package structure.
- (line 6)
-* options, package <1>: Class and package commands.
- (line 66)
-* ordinals, feminine and masculine: Text symbols. (line 135)
-* oslash: Additional Latin letters.
- (line 44)
-* overbar accent: Accents. (line 29)
-* overdot accent, math: Math accents. (line 26)
-* overview of LaTeX: Overview. (line 6)
-* package file layout: Class and package structure.
- (line 6)
-* package options: Class and package structure.
- (line 6)
-* package options <1>: Class and package commands.
- (line 66)
-* package, algorithm2e: tabbing. (line 144)
-* package, amsmath: array. (line 40)
-* package, amsmath <1>: displaymath. (line 22)
-* package, babel: thebibliography. (line 29)
-* package, babel <1>: Accents. (line 6)
-* package, datetime: \today. (line 22)
-* package, enumitem: list. (line 24)
-* package, etoolbox: Class and package commands.
- (line 110)
-* package, fancyvrb: tabbing. (line 144)
-* package, flafter: Floats. (line 82)
-* package, float: Floats. (line 52)
-* package, footmisc: Footnotes in section headings.
- (line 10)
-* package, geometry: Document class options.
- (line 40)
-* package, geometry <1>: Document class options.
- (line 44)
-* package, listings: tabbing. (line 144)
-* package, macros2e: \makeatletter and \makeatother.
+ (line 25)
+* --disable-write18 command-line option: Command line options.
+ (line 54)
+* --enable-write18 command-line option: Command line options.
+ (line 54)
+* --file-line-error command-line option: Command line options.
+ (line 81)
+* --halt-on-error command-line option: Command line options.
+ (line 78)
+* --help command-line option: Command line options.
+ (line 19)
+* --interaction command-line option: Command line options.
+ (line 22)
+* --jobname command-line option: Command line options.
(line 39)
-* package, makeidx: Indexes. (line 28)
-* package, mfirstuc: Upper and lower case.
- (line 45)
-* package, minted: tabbing. (line 144)
-* package, multind: Indexes. (line 39)
-* package, picture: picture. (line 23)
-* package, setspace: Low-level font commands.
- (line 118)
-* package, showidx: Indexes. (line 35)
-* package, textcase: Upper and lower case.
- (line 42)
-* package, textcomp: Font styles. (line 134)
-* package, xspace: \(SPACE) after control sequence.
- (line 20)
-* packages, loading additional: Additional packages. (line 6)
-* page break, forcing: \pagebreak & \nopagebreak.
- (line 6)
-* page break, preventing: \pagebreak & \nopagebreak.
- (line 6)
-* page breaking: Page breaking. (line 6)
-* page layout parameters: Page layout parameters.
- (line 6)
-* page number, cross referencing: \pageref. (line 6)
-* page numbering style: \pagenumbering. (line 6)
-* page styles: Page styles. (line 6)
-* page, colored: Colored pages. (line 6)
-* paragraph indentation, in minipage: minipage. (line 17)
-* paragraph indentations in quoted text: quotation and quote. (line 6)
-* paragraph indentations in quoted text, omitting: quotation and quote.
- (line 6)
-* paragraph mode: Modes. (line 6)
-* paragraph mode <1>: \parbox. (line 10)
-* paragraph symbol: Text symbols. (line 44)
-* paragraphs: Making paragraphs. (line 6)
-* parameters, for footnotes: Footnote parameters. (line 6)
-* parameters, page layout: Page layout parameters.
- (line 6)
-* PDF graphic files: Graphics package configuration.
- (line 6)
-* PDF graphic files <1>: \includegraphics. (line 6)
-* pdfTeX: Output files. (line 20)
-* pdfTeX engine: TeX engines. (line 12)
-* period, centered, in text: Text symbols. (line 138)
-* pica: Units of length. (line 14)
-* pict2e package: \line. (line 13)
-* picture package: picture. (line 23)
-* pictures, creating: picture. (line 6)
-* pilcrow: Text symbols. (line 44)
-* placement of floats: Floats. (line 31)
-* PNG files: Graphics package configuration.
- (line 6)
-* PNG files <1>: \includegraphics. (line 6)
-* poetry, an environment for: verse. (line 6)
-* Point: Units of length. (line 10)
-* polish l: Additional Latin letters.
- (line 36)
-* portrait orientation: Document class options.
- (line 60)
-* position, in picture: picture. (line 28)
-* positional parameter: \newcommand & \renewcommand.
- (line 37)
-* postscript, in letters: \ps. (line 6)
-* pounds symbol: Text symbols. (line 48)
-* preamble, defined: Starting and ending. (line 19)
-* predefined lengths: Predefined lengths. (line 6)
-* prompt, *: Command line. (line 18)
-* pronunciation: Overview. (line 24)
-* quad: Spacing in math mode.
- (line 32)
-* question mark, upside-down: Text symbols. (line 141)
-* quotation marks, French: Text symbols. (line 30)
-* quote, single straight: Text symbols. (line 156)
-* quote, straight base: Text symbols. (line 160)
-* quoted text with paragraph indentation, displaying: quotation and quote.
- (line 6)
-* quoted text without paragraph indentation, displaying: quotation and quote.
- (line 6)
-* ragged left text: \raggedleft. (line 6)
-* ragged left text, environment for: flushright. (line 6)
-* ragged right text: \raggedright. (line 6)
-* ragged right text, environment for: flushleft. (line 6)
-* redefining environments: \newenvironment & \renewenvironment.
- (line 6)
-* reference, forward: Cross references. (line 22)
-* references, resolving forward: Output files. (line 33)
-* registered symbol: Text symbols. (line 163)
-* remarks in the margin: Marginal notes. (line 6)
-* reporting bugs: About this document. (line 21)
-* reserved characters: Reserved characters. (line 6)
-* resizing: \scalebox. (line 6)
-* resizing <1>: \resizebox. (line 6)
-* right angle quotation marks: Text symbols. (line 30)
-* right arrow, in text: Text symbols. (line 166)
-* right brace, in text: Text symbols. (line 88)
-* right quote: Text symbols. (line 55)
-* right quote, double: Text symbols. (line 147)
-* right quote, single: Text symbols. (line 153)
-* right-hand equation numbers: Document class options.
- (line 63)
-* right-justifying text: \raggedleft. (line 6)
-* right-justifying text, environment for: flushright. (line 6)
-* ring accent: Accents. (line 75)
-* ring accent, math: Math accents. (line 41)
-* robust commands: \protect. (line 6)
-* roman font: Font styles. (line 80)
-* root file: Splitting the input. (line 9)
-* rotating graphics: \rotatebox. (line 6)
-* rotating text: \rotatebox. (line 6)
-* rotation: \rotatebox. (line 6)
-* row, tabbing: tabbing. (line 45)
-* rubber lengths, defining new: \newlength. (line 6)
-* running header and footer: Page layout parameters.
- (line 6)
-* running header and footer style: \pagestyle. (line 6)
-* sans serif font: Font styles. (line 86)
-* Scaled point: Units of length. (line 36)
-* scaling: \scalebox. (line 6)
-* scaling <1>: \resizebox. (line 6)
-* script letters for math: Font styles. (line 74)
-* section number, cross referencing: \ref. (line 6)
-* section numbers, printing: Sectioning. (line 47)
-* section symbol: Text symbols. (line 58)
-* section, redefining: \@startsection. (line 6)
-* sectioning commands: Sectioning. (line 6)
-* series, of fonts: Low-level font commands.
- (line 48)
-* setspace package: Low-level font commands.
- (line 118)
-* setting counters: \setcounter. (line 6)
-* shapes, of fonts: Low-level font commands.
- (line 88)
-* sharp S letters: Additional Latin letters.
- (line 52)
-* showidx package: Indexes. (line 35)
-* simulating typed text: verbatim. (line 6)
-* single angle quotation marks: Text symbols. (line 30)
-* single guillemets: Text symbols. (line 30)
-* single left quote: Text symbols. (line 150)
-* single low-9 quotation mark: Text symbols. (line 52)
-* single quote, straight: Text symbols. (line 156)
-* single right quote: Text symbols. (line 153)
-* sizes of text: Font sizes. (line 6)
-* skip register, plain TeX: \newlength. (line 6)
-* slanted font: Font styles. (line 89)
-* small caps font: Font styles. (line 83)
-* space, inserting vertical: \addvspace. (line 6)
-* space, vertical: \vspace. (line 6)
-* spaces: Spaces. (line 6)
-* spaces, ignore around commands: \ignorespaces & \ignorespacesafterend.
- (line 6)
-* spacing within math mode: Spacing in math mode.
- (line 6)
-* spacing, inter-sentence: \frenchspacing. (line 6)
-* spacing, inter-sentence <1>: \normalsfcodes. (line 6)
-* Spanish ordinals, feminine and masculine: Text symbols. (line 135)
-* special characters: Reserved characters. (line 6)
-* special characters <1>: Additional Latin letters.
- (line 6)
-* special insertions: Special insertions. (line 6)
-* specifier, float placement: Floats. (line 31)
-* splitting the input file: Splitting the input. (line 6)
-* stable option to footmisc package: Footnotes in section headings.
- (line 10)
-* star-variants, commands: \@ifstar. (line 6)
-* starred form, defining new commands: \newcommand & \renewcommand.
+* --no-file-line-error command-line option: Command line options.
+ (line 81)
+* --no-shell-escape command-line option: Command line options.
+ (line 54)
+* --output-directory command-line option: Command line options.
+ (line 51)
+* --shell-escape command-line option: Command line options.
+ (line 54)
+* --version command-line option: Command line options.
(line 14)
-* starting a new page: \newpage. (line 6)
-* starting a new page and clearing floats: \clearpage. (line 6)
-* starting and ending: Starting and ending. (line 6)
-* starting on a right-hand page: \cleardoublepage. (line 6)
-* sterling symbol: Text symbols. (line 48)
-* straight double quote, base: Text symbols. (line 160)
-* straight quote, base: Text symbols. (line 160)
-* straight single quote: Text symbols. (line 156)
-* stretch, infinite horizontal: \hfill. (line 6)
-* stretch, infinite vertical: \vfill. (line 6)
-* stretch, omitting vertical: \raggedbottom. (line 6)
-* styles of text: Font styles. (line 6)
-* styles, page: Page styles. (line 6)
-* subscript: Subscripts & superscripts.
- (line 6)
-* superscript: Subscripts & superscripts.
- (line 6)
-* symbols, math: Math symbols. (line 6)
-* symbols, text: Text symbols. (line 6)
-* tab stops, using: tabbing. (line 6)
-* table of contents entry, manually adding: \addcontentsline. (line 6)
-* table of contents file: Output files. (line 43)
-* table of contents, avoiding footnotes: Footnotes in section headings.
- (line 6)
-* table of contents, creating: Tables of contents. (line 6)
-* tables, creating: table. (line 6)
-* template, beamer: beamer template. (line 6)
-* template, book: book template. (line 6)
-* template, TUGboat: tugboat template. (line 6)
-* templates, document: Document templates. (line 6)
-* terminal input/output: Terminal input/output.
- (line 6)
-* TeX logo: Text symbols. (line 61)
-* text symbols: Text symbols. (line 6)
-* text, resizing: \scalebox. (line 6)
-* text, resizing <1>: \resizebox. (line 6)
-* text, scaling: \scalebox. (line 6)
-* text, scaling <1>: \resizebox. (line 6)
-* textcase package: Upper and lower case.
- (line 42)
-* textcomp package: Font styles. (line 134)
-* thanks, for titlepage: \maketitle. (line 22)
-* theorem-like environment: \newtheorem. (line 6)
-* theorems, defining: \newtheorem. (line 6)
-* theorems, typesetting: theorem. (line 6)
-* thorn, Icelandic letter: Additional Latin letters.
- (line 56)
-* three-quarters em-dash: Text symbols. (line 169)
-* tie-after accent: Accents. (line 81)
-* tilde accent: Accents. (line 43)
-* tilde accent, math: Math accents. (line 44)
-* tilde, ASCII, in text: Text symbols. (line 67)
-* title page, separate or run-in: Document class options.
- (line 71)
-* title pages, creating: titlepage. (line 6)
-* title, for titlepage: \maketitle. (line 26)
-* titles, making: \maketitle. (line 6)
-* trademark symbol: Text symbols. (line 172)
-* transcript file: Output files. (line 28)
-* TrueType fonts: TeX engines. (line 6)
-* TUGboat template: tugboat template. (line 6)
-* two-column output: \twocolumn. (line 6)
-* two-thirds em-dash: Text symbols. (line 175)
-* type styles: Font styles. (line 6)
-* typed text, simulating: verbatim. (line 6)
-* typeface sizes: Font sizes. (line 6)
-* typefaces: Fonts. (line 6)
-* typewriter font: Font styles. (line 92)
-* typewriter labels in lists: description. (line 34)
-* umlaut accent: Accents. (line 16)
-* underbar: Accents. (line 89)
-* underscore, in text: Text symbols. (line 178)
-* Unicode input, native: TeX engines. (line 6)
-* units, of length: Units of length. (line 6)
-* unofficial nature of this manual: About this document. (line 17)
-* unordered lists: itemize. (line 6)
-* Upper case: Upper and lower case.
- (line 6)
-* using BibTeX: Using BibTeX. (line 6)
-* UTF-8: TeX engines. (line 6)
-* variables, a list of: Counters. (line 6)
-* vector symbol, math: Math accents. (line 47)
-* verbatim text: verbatim. (line 6)
-* verbatim text, inline: \verb. (line 6)
-* vertical bar, double, in text: Text symbols. (line 79)
-* vertical bar, in text: Text symbols. (line 76)
-* vertical space: \addvspace. (line 6)
-* vertical space <1>: \vspace. (line 6)
-* vertical space before paragraphs: \parskip. (line 6)
-* visible space: \verb. (line 17)
-* visible space symbol, in text: Text symbols. (line 181)
-* weights, of fonts: Low-level font commands.
- (line 58)
-* white space: Spaces. (line 6)
-* wide hat accent, math: Math accents. (line 50)
-* wide tilde accent, math: Math accents. (line 53)
-* widths, of fonts: Low-level font commands.
- (line 70)
-* writing external files: filecontents. (line 6)
-* writing letters: Letters. (line 6)
-* x-height: Units of length. (line 38)
-* XeTeX: TeX engines. (line 38)
-* xindy program: Indexes. (line 23)
-* xspace package: \(SPACE) after control sequence.
- (line 20)
-
-
-File: latex2e.info, Node: Command Index, Prev: Concept Index, Up: Top
-
-Command Index
-*************
-
-
-* Menu:
-
-* $: Math formulas. (line 24)
-* &: tabular. (line 32)
-* --help command-line option: Command line. (line 14)
* .aux file: Output files. (line 33)
* .dvi file: Output files. (line 10)
-* .fd file: \newfont. (line 16)
+* .glo file: Glossaries. (line 43)
+* .idx file: Indexes. (line 6)
+* .idx file <1>: makeindex. (line 6)
+* .ind file: makeindex. (line 6)
+* .isty file: makeindex. (line 18)
* .lof file: Output files. (line 43)
-* .lof file <1>: Tables of contents. (line 16)
+* .lof file <1>: Table of contents etc..
+ (line 6)
* .log file: Output files. (line 28)
* .lot file: Output files. (line 43)
-* .lot file <1>: Tables of contents. (line 16)
+* .lot file <1>: Table of contents etc..
+ (line 6)
* .pdf file: Output files. (line 20)
-* .tex, default extension: Command line. (line 6)
+* .tex, default extension: Command line. (line 18)
* .toc file: Output files. (line 43)
-* .toc file <1>: Tables of contents. (line 6)
-* .xdv file: TeX engines. (line 38)
+* .toc file <1>: Table of contents etc..
+ (line 6)
+* .xdv file: TeX engines. (line 39)
* 10pt option: Document class options.
(line 14)
* 11pt option: Document class options.
(line 14)
* 12pt option: Document class options.
(line 14)
+* :: Colon character & \colon.
+ (line 6)
+* : <1>: Colon character & \colon.
+ (line 6)
* [...] for optional arguments: LaTeX command syntax.
(line 6)
* \ character starting commands: LaTeX command syntax.
(line 6)
* \!: Spacing in math mode.
- (line 29)
-* \" (umlaut accent): Accents. (line 16)
+ (line 46)
+* \" (umlaut accent): Accents. (line 23)
* \#: Reserved characters. (line 13)
* \$: Reserved characters. (line 13)
* \%: Reserved characters. (line 13)
* \&: Reserved characters. (line 13)
-* \' (acute accent): Accents. (line 20)
-* \' (tabbing): tabbing. (line 86)
-* \(: Math formulas. (line 16)
-* \(SPACE): \(SPACE) and \@. (line 6)
-* \): Math formulas. (line 16)
-* \*: Math miscellany. (line 6)
-* \+: tabbing. (line 78)
+* \' (acute accent): Accents. (line 27)
+* \' (tabbing): tabbing. (line 87)
+* \*: \*. (line 6)
+* \+: tabbing. (line 79)
* \,: Spacing in math mode.
- (line 25)
-* \-: tabbing. (line 82)
+ (line 32)
+* \-: tabbing. (line 83)
* \- (hyphenation): \- (hyphenation). (line 6)
-* \. (dot-over accent): Accents. (line 25)
+* \. (dot-over accent): Accents. (line 30)
* \/: \/. (line 6)
* \:: Spacing in math mode.
- (line 21)
+ (line 28)
* \;: Spacing in math mode.
- (line 16)
-* \<: tabbing. (line 74)
-* \= (macron accent): Accents. (line 29)
-* \= (tabbing): tabbing. (line 68)
-* \>: tabbing. (line 72)
+ (line 23)
+* \<: tabbing. (line 75)
+* \= (macron accent): Accents. (line 34)
+* \= (tabbing): tabbing. (line 69)
+* \>: tabbing. (line 73)
* \> <1>: Spacing in math mode.
- (line 21)
-* \> (tabbing): tabbing. (line 71)
-* \@: \(SPACE) and \@. (line 6)
-* \@beginparpenalty: list. (line 234)
-* \@endparpenalty: list. (line 242)
-* \@fnsymbol: \footnote. (line 23)
+ (line 28)
+* \> (tabbing): tabbing. (line 72)
+* \@: \@. (line 6)
+* \@beginparpenalty: list. (line 241)
+* \@endparpenalty: list. (line 249)
+* \@fnsymbol: \footnote. (line 24)
* \@ifstar: \@ifstar. (line 6)
-* \@itempenalty: list. (line 238)
+* \@itempenalty: list. (line 245)
* \@startsection: \@startsection. (line 6)
-* \a (tabbing): tabbing. (line 101)
-* \a' (acute accent in tabbing): tabbing. (line 102)
-* \a= (macron accent in tabbing): tabbing. (line 102)
+* \a (tabbing): tabbing. (line 102)
+* \a' (acute accent in tabbing): tabbing. (line 103)
+* \a= (macron accent in tabbing): tabbing. (line 103)
* \aa (aa): Additional Latin letters.
(line 12)
* \AA (AA): Additional Latin letters.
@@ -11676,30 +15183,30 @@ Command Index
(line 16)
* \AE (AE): Additional Latin letters.
(line 16)
-* \aleph: Math symbols. (line 22)
+* \aleph: Math symbols. (line 21)
* \Alph example: enumerate. (line 61)
-* \alpha: Math symbols. (line 25)
+* \alpha: Math symbols. (line 24)
* \alph{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
(line 14)
* \Alph{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 17)
-* \alsoname: Indexes. (line 20)
-* \amalg: Math symbols. (line 28)
-* \and for \author: \maketitle. (line 12)
-* \angle: Math symbols. (line 31)
-* \appendix: Sectioning. (line 37)
-* \approx: Math symbols. (line 36)
+ (line 19)
+* \alsoname: \index. (line 56)
+* \amalg: Math symbols. (line 27)
+* \and for \author: \maketitle. (line 43)
+* \angle: Math symbols. (line 30)
+* \appendix: \appendix. (line 6)
+* \approx: Math symbols. (line 35)
* \arabic{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 20)
+ (line 24)
* \arccos: Math functions. (line 9)
* \arcsin: Math functions. (line 12)
* \arctan: Math functions. (line 15)
* \arg: Math functions. (line 18)
-* \arraycolsep: array. (line 37)
-* \arrayrulewidth: tabular. (line 156)
-* \arraystretch: tabular. (line 162)
-* \ast: Math symbols. (line 39)
-* \asymp: Math symbols. (line 48)
+* \arraycolsep: array. (line 51)
+* \arrayrulewidth: tabular. (line 158)
+* \arraystretch: tabular. (line 164)
+* \ast: Math symbols. (line 38)
+* \asymp: Math symbols. (line 47)
* \AtBeginDocument: \AtBeginDocument. (line 6)
* \AtBeginDvi: Class and package commands.
(line 9)
@@ -11708,80 +15215,85 @@ Command Index
(line 14)
* \AtEndOfPackage: Class and package commands.
(line 14)
-* \author{NAME \and NAME2}: \maketitle. (line 11)
-* \a` (grave accent in tabbing): tabbing. (line 102)
-* \b (bar-under accent): Accents. (line 46)
-* \backslash: Math symbols. (line 51)
+* \author{NAME1 \and NAME2 \and ...}: \maketitle. (line 42)
+* \a` (grave accent in tabbing): tabbing. (line 103)
+* \b (bar-under accent): Accents. (line 49)
+* \backmatter: \frontmatter & \mainmatter & \backmatter.
+ (line 6)
+* \backslash: Math symbols. (line 50)
* \bar: Math accents. (line 13)
* \baselineskip: Low-level font commands.
(line 101)
* \baselinestretch: Low-level font commands.
(line 111)
* \begin: Environments. (line 6)
-* \beta: Math symbols. (line 55)
-* \bf: Font styles. (line 70)
+* \beta: Math symbols. (line 54)
+* \bf: Font styles. (line 74)
* \bfseries: Font styles. (line 39)
* \bibitem: \bibitem. (line 6)
* \bibliography: Using BibTeX. (line 6)
* \bibliographystyle: Using BibTeX. (line 6)
-* \bibname: thebibliography. (line 23)
-* \bigcap: Math symbols. (line 58)
-* \bigcirc: Math symbols. (line 62)
-* \bigcup: Math symbols. (line 66)
-* \bigodot: Math symbols. (line 70)
-* \bigoplus: Math symbols. (line 73)
-* \bigotimes: Math symbols. (line 76)
-* \bigskip: \bigskip \medskip \smallskip.
- (line 9)
-* \bigskipamount: \bigskip \medskip \smallskip.
- (line 10)
-* \bigsqcup: Math symbols. (line 87)
-* \bigtriangledown: Math symbols. (line 79)
-* \bigtriangleup: Math symbols. (line 83)
-* \biguplus: Math symbols. (line 90)
-* \bigvee: Math symbols. (line 94)
-* \bigwedge: Math symbols. (line 97)
+* \bigcap: Math symbols. (line 57)
+* \bigcirc: Math symbols. (line 61)
+* \bigcup: Math symbols. (line 65)
+* \bigodot: Math symbols. (line 69)
+* \bigoplus: Math symbols. (line 72)
+* \bigotimes: Math symbols. (line 75)
+* \bigskip: \bigskip & \medskip & \smallskip.
+ (line 28)
+* \bigskipamount: \bigskip & \medskip & \smallskip.
+ (line 29)
+* \bigsqcup: Math symbols. (line 86)
+* \bigtriangledown: Math symbols. (line 78)
+* \bigtriangleup: Math symbols. (line 82)
+* \biguplus: Math symbols. (line 89)
+* \bigvee: Math symbols. (line 93)
+* \bigwedge: Math symbols. (line 96)
* \bmod: Math functions. (line 21)
-* \boldmath: Math formulas. (line 29)
-* \bot: Math symbols. (line 100)
+* \boldmath: \boldmath & \unboldmath.
+ (line 6)
+* \boldmath <1>: \boldmath & \unboldmath.
+ (line 14)
+* \bot: Math symbols. (line 99)
* \bottomfraction: Floats. (line 94)
* \bottomfraction <1>: Floats. (line 95)
-* \bowtie: Math symbols. (line 105)
-* \Box: Math symbols. (line 108)
+* \bowtie: Math symbols. (line 104)
+* \Box: Math symbols. (line 107)
* \breve: Math accents. (line 16)
-* \bullet: Math symbols. (line 113)
-* \c (cedilla accent): Accents. (line 51)
-* \cal: Font styles. (line 73)
-* \cap: Math symbols. (line 116)
-* \capitalacute: Accents. (line 20)
-* \capitalbreve: Accents. (line 86)
-* \capitalcaron: Accents. (line 97)
-* \capitalcedilla: Accents. (line 51)
-* \capitalcircumflex: Accents. (line 33)
-* \capitaldieresis: Accents. (line 16)
-* \capitaldotaccent: Accents. (line 55)
-* \capitalgrave: Accents. (line 37)
-* \capitalhungarumlaut: Accents. (line 59)
-* \capitalmacron: Accents. (line 29)
+* \bullet: Math symbols. (line 112)
+* \c (cedilla accent): Accents. (line 59)
+* \cal: Font styles. (line 77)
+* \cap: Math symbols. (line 115)
+* \capitalacute: Accents. (line 27)
+* \capitalbreve: Accents. (line 85)
+* \capitalcaron: Accents. (line 89)
+* \capitalcedilla: Accents. (line 59)
+* \capitalcircumflex: Accents. (line 38)
+* \capitaldieresis: Accents. (line 23)
+* \capitaldotaccent: Accents. (line 63)
+* \capitalgrave: Accents. (line 42)
+* \capitalhungarumlaut: Accents. (line 67)
+* \capitalmacron: Accents. (line 34)
* \capitalnewtie: Accents. (line 81)
-* \capitalogonek: Accents. (line 70)
+* \capitalogonek: Accents. (line 71)
* \capitalring: Accents. (line 75)
* \capitaltie: Accents. (line 81)
-* \capitaltilde: Accents. (line 43)
-* \caption: figure. (line 40)
-* \caption <1>: table. (line 26)
+* \capitaltilde: Accents. (line 46)
+* \caption: figure. (line 44)
+* \caption <1>: table. (line 44)
* \cc: \cc. (line 6)
-* \cdot: Math symbols. (line 121)
-* \cdots: Math miscellany. (line 25)
+* \cdot: Math symbols. (line 120)
+* \cdots: Dots. (line 17)
* \centering: \centering. (line 6)
-* \chapter: Sectioning. (line 9)
+* \chapter: Sectioning. (line 6)
+* \chapter <1>: \chapter. (line 6)
* \check: Math accents. (line 19)
* \CheckCommand: Class and package commands.
(line 21)
* \CheckCommand*: Class and package commands.
(line 21)
-* \chi: Math symbols. (line 124)
-* \circ: Math symbols. (line 127)
+* \chi: Math symbols. (line 123)
+* \circ: Math symbols. (line 126)
* \circle: \circle. (line 6)
* \cite: \cite. (line 6)
* \ClassError: Class and package commands.
@@ -11794,55 +15306,60 @@ Command Index
(line 41)
* \ClassWarningNoLine: Class and package commands.
(line 41)
-* \cleardoublepage: \cleardoublepage. (line 6)
-* \clearpage: \clearpage. (line 6)
+* \cleardoublepage: \clearpage & \cleardoublepage.
+ (line 6)
+* \clearpage: \clearpage & \cleardoublepage.
+ (line 6)
* \cline: \cline. (line 6)
* \closing: \closing. (line 6)
-* \clubsuit: Math symbols. (line 132)
-* \columnsep: \twocolumn. (line 22)
+* \clubsuit: Math symbols. (line 131)
+* \colon: Colon character & \colon.
+ (line 6)
+* \columnsep: \twocolumn. (line 20)
* \columnsep <1>: Page layout parameters.
(line 6)
* \columnsep <2>: Page layout parameters.
(line 9)
-* \columnseprule: \twocolumn. (line 28)
+* \columnseprule: \twocolumn. (line 26)
* \columnseprule <1>: Page layout parameters.
(line 7)
* \columnseprule <2>: Page layout parameters.
(line 9)
-* \columnwidth: \twocolumn. (line 35)
+* \columnwidth: \twocolumn. (line 33)
* \columnwidth <1>: Page layout parameters.
(line 8)
* \columnwidth <2>: Page layout parameters.
(line 9)
-* \complement: Math symbols. (line 135)
-* \cong: Math symbols. (line 141)
-* \contentsline: \addcontentsline. (line 33)
-* \coprod: Math symbols. (line 144)
-* \copyright: Text symbols. (line 10)
+* \complement: Math symbols. (line 134)
+* \cong: Math symbols. (line 140)
+* \contentsline: \addcontentsline. (line 10)
+* \coprod: Math symbols. (line 143)
+* \copyright: Text symbols. (line 11)
* \cos: Math functions. (line 24)
* \cosh: Math functions. (line 27)
* \cot: Math functions. (line 30)
* \coth: Math functions. (line 33)
* \csc: Math functions. (line 36)
-* \cup: Math symbols. (line 147)
+* \cup: Math symbols. (line 146)
* \CurrentOption: Class and package commands.
(line 60)
-* \d (dot-under accent): Accents. (line 55)
-* \dag: Text symbols. (line 14)
-* \dagger: Math symbols. (line 152)
+* \d (dot-under accent): Accents. (line 63)
+* \dag: Text symbols. (line 15)
+* \dagger: Math symbols. (line 151)
* \dashbox: \dashbox. (line 6)
-* \dashv: Math symbols. (line 155)
-* \date{TEXT}: \maketitle. (line 17)
-* \day: \day \month \year. (line 6)
-* \dblfloatpagefraction: \twocolumn. (line 69)
-* \dblfloatsep: \twocolumn. (line 75)
-* \dbltextfloatsep: \twocolumn. (line 82)
-* \dbltopfraction: \twocolumn. (line 47)
-* \dbltopnumber: \twocolumn. (line 87)
-* \ddag: Text symbols. (line 17)
-* \ddagger: Math symbols. (line 159)
+* \dashv: Math symbols. (line 154)
+* \date{TEXT}: \maketitle. (line 50)
+* \day: \day & \month & \year.
+ (line 6)
+* \dblfloatpagefraction: \twocolumn. (line 66)
+* \dblfloatsep: \twocolumn. (line 72)
+* \dbltextfloatsep: \twocolumn. (line 79)
+* \dbltopfraction: \twocolumn. (line 45)
+* \dbltopnumber: \twocolumn. (line 84)
+* \ddag: Text symbols. (line 18)
+* \ddagger: Math symbols. (line 158)
* \ddot: Math accents. (line 22)
-* \ddots: Math miscellany. (line 29)
+* \ddots: Dots. (line 21)
* \DeclareGraphicsExtensions: \DeclareGraphicsExtensions.
(line 6)
* \DeclareGraphicsRule: \DeclareGraphicsRule.
@@ -11856,45 +15373,48 @@ Command Index
* \DeclareRobustCommand*: Class and package commands.
(line 96)
* \deg: Math functions. (line 39)
-* \Delta: Math symbols. (line 162)
-* \delta: Math symbols. (line 165)
-* \depth: Predefined lengths. (line 10)
+* \Delta: Math symbols. (line 161)
+* \delta: Math symbols. (line 164)
* \det: Math functions. (line 42)
* \dh (d): Additional Latin letters.
(line 20)
* \DH (D): Additional Latin letters.
(line 20)
-* \Diamond: Math symbols. (line 168)
-* \diamond: Math symbols. (line 172)
-* \diamondsuit: Math symbols. (line 176)
+* \Diamond: Math symbols. (line 167)
+* \diamond: Math symbols. (line 171)
+* \diamondsuit: Math symbols. (line 175)
* \dim: Math functions. (line 45)
-* \displaystyle: Math formulas. (line 34)
-* \div: Math symbols. (line 179)
+* \displaystyle: Math formulas. (line 61)
+* \div: Math symbols. (line 178)
* \dj: Additional Latin letters.
(line 26)
* \DJ: Additional Latin letters.
(line 26)
* \documentclass: Document classes. (line 6)
* \dot: Math accents. (line 25)
-* \doteq: Math symbols. (line 182)
-* \dotfill: \hrulefill \dotfill. (line 6)
-* \dots: Text symbols. (line 34)
-* \doublerulesep: tabular. (line 167)
-* \downarrow: Math symbols. (line 186)
-* \Downarrow: Math symbols. (line 190)
-* \ell: Math symbols. (line 194)
+* \doteq: Math symbols. (line 181)
+* \dotfill: \hrulefill & \dotfill.
+ (line 6)
+* \dots: Text symbols. (line 35)
+* \doublerulesep: tabular. (line 169)
+* \downarrow: Math symbols. (line 185)
+* \Downarrow: Math symbols. (line 189)
+* \ell: Math symbols. (line 193)
* \emph: Font styles. (line 59)
-* \emptyset: Math symbols. (line 197)
+* \emptyset: Math symbols. (line 196)
* \encl: \encl. (line 6)
* \end: Environments. (line 6)
+* \endinput: \endinput. (line 6)
* \enlargethispage: \enlargethispage. (line 6)
+* \enspace: \enspace & \quad & \qquad.
+ (line 6)
* \enumi: enumerate. (line 47)
* \enumii: enumerate. (line 47)
* \enumiii: enumerate. (line 47)
* \enumiv: enumerate. (line 47)
-* \epsilon: Math symbols. (line 201)
-* \equiv: Math symbols. (line 207)
-* \eta: Math symbols. (line 210)
+* \epsilon: Math symbols. (line 200)
+* \equiv: Math symbols. (line 206)
+* \eta: Math symbols. (line 209)
* \evensidemargin: Document class options.
(line 84)
* \evensidemargin <1>: Page layout parameters.
@@ -11902,25 +15422,27 @@ Command Index
* \evensidemargin <2>: Page layout parameters.
(line 68)
* \ExecuteOptions: Class and package commands.
- (line 166)
-* \exists: Math symbols. (line 213)
+ (line 172)
+* \exists: Math symbols. (line 212)
* \exp: Math functions. (line 48)
-* \extracolsep: tabular. (line 115)
-* \fbox: \fbox and \framebox. (line 6)
-* \fboxrule: \framebox (picture). (line 14)
-* \fboxrule <1>: \fbox and \framebox. (line 18)
-* \fboxsep: \framebox (picture). (line 14)
-* \fboxsep <1>: \fbox and \framebox. (line 18)
-* \fill: \hfill. (line 9)
-* \flat: Math symbols. (line 216)
+* \extracolsep: tabular. (line 109)
+* \fbox: \fbox & \framebox. (line 6)
+* \fboxrule: \framebox (picture). (line 31)
+* \fboxrule <1>: \fbox & \framebox. (line 39)
+* \fboxrule <2>: \fbox & \framebox. (line 38)
+* \fboxsep: \framebox (picture). (line 31)
+* \fboxsep <1>: \fbox & \framebox. (line 44)
+* \fboxsep <2>: \fbox & \framebox. (line 43)
+* \fill: \hfill. (line 18)
+* \flat: Math symbols. (line 215)
* \floatpagefraction: Floats. (line 98)
* \floatpagefraction <1>: Floats. (line 99)
* \floatsep: Floats. (line 114)
* \floatsep <1>: Floats. (line 115)
* \flushbottom: \flushbottom. (line 6)
-* \fnsymbol, and footnotes: \footnote. (line 23)
+* \fnsymbol, and footnotes: \footnote. (line 24)
* \fnsymbol{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 29)
+ (line 37)
* \fontencoding: Low-level font commands.
(line 11)
* \fontfamily: Low-level font commands.
@@ -11933,41 +15455,42 @@ Command Index
(line 101)
* \footnote: \footnote. (line 6)
* \footnotemark: \footnotemark. (line 6)
-* \footnoterule: Footnote parameters. (line 6)
-* \footnotesep: Footnote parameters. (line 12)
+* \footnoterule: \footnote. (line 34)
+* \footnotesep: \footnote. (line 46)
* \footnotesize: Font sizes. (line 11)
* \footnotetext: \footnotetext. (line 6)
* \footskip: Page layout parameters.
(line 26)
* \footskip <1>: Page layout parameters.
(line 27)
-* \forall: Math symbols. (line 219)
-* \frac: Math miscellany. (line 33)
-* \frac{NUM}{DEN}: Math miscellany. (line 32)
+* \forall: Math symbols. (line 218)
+* \frac: \frac. (line 6)
* \frame: \frame. (line 6)
* \framebox: \framebox (picture). (line 6)
-* \framebox <1>: \fbox and \framebox. (line 6)
+* \framebox <1>: \fbox & \framebox. (line 6)
* \frenchspacing: \frenchspacing. (line 6)
-* \frown: Math symbols. (line 222)
-* \fussy: \fussy. (line 6)
-* \Gamma: Math symbols. (line 225)
-* \gamma: Math symbols. (line 228)
+* \frontmatter: \frontmatter & \mainmatter & \backmatter.
+ (line 6)
+* \frown: Math symbols. (line 221)
+* \fussy: \fussy & \sloppy. (line 6)
+* \Gamma: Math symbols. (line 224)
+* \gamma: Math symbols. (line 227)
* \gcd: Math functions. (line 51)
-* \ge: Math symbols. (line 231)
-* \geq: Math symbols. (line 235)
-* \gets: Math symbols. (line 239)
-* \gg: Math symbols. (line 242)
-* \glossary: Glossaries. (line 8)
-* \glossaryentry: Glossaries. (line 11)
+* \ge: Math symbols. (line 230)
+* \geq: Math symbols. (line 234)
+* \gets: Math symbols. (line 238)
+* \gg: Math symbols. (line 241)
+* \gls: \gls. (line 6)
* \graphicspath: \graphicspath. (line 6)
+* \graphpaper: \graphpaper. (line 6)
* \grave: Math accents. (line 28)
-* \guillemotleft (<<): Text symbols. (line 26)
-* \guillemotright (>>): Text symbols. (line 27)
-* \guilsinglleft (<): Text symbols. (line 28)
-* \guilsinglright (>): Text symbols. (line 29)
-* \H (Hungarian umlaut accent): Accents. (line 59)
+* \guillemotleft (<<): Text symbols. (line 27)
+* \guillemotright (>>): Text symbols. (line 28)
+* \guilsinglleft (<): Text symbols. (line 29)
+* \guilsinglright (>): Text symbols. (line 30)
+* \H (Hungarian umlaut accent): Accents. (line 67)
* \hat: Math accents. (line 31)
-* \hbar: Math symbols. (line 246)
+* \hbar: Math symbols. (line 245)
* \headheight: Page layout parameters.
(line 14)
* \headheight <1>: Page layout parameters.
@@ -11976,26 +15499,27 @@ Command Index
(line 19)
* \headsep <1>: Page layout parameters.
(line 20)
-* \heartsuit: Math symbols. (line 249)
-* \height: Predefined lengths. (line 8)
+* \heartsuit: Math symbols. (line 248)
* \hfill: \hfill. (line 6)
* \hline: \hline. (line 6)
* \hom: Math functions. (line 54)
-* \hookleftarrow: Math symbols. (line 252)
-* \hookrightarrow: Math symbols. (line 255)
-* \hrulefill: \hrulefill \dotfill. (line 6)
+* \hookleftarrow: Math symbols. (line 251)
+* \hookrightarrow: Math symbols. (line 254)
+* \hrulefill: \hrulefill & \dotfill.
+ (line 6)
* \hsize: Page layout parameters.
(line 119)
* \hsize <1>: Page layout parameters.
(line 119)
* \hspace: \hspace. (line 6)
+* \hss: \hss. (line 6)
* \huge: Font sizes. (line 11)
* \Huge: Font sizes. (line 11)
* \hyphenation: \hyphenation. (line 6)
-* \i (dotless i): Accents. (line 63)
-* \iff: Math symbols. (line 258)
+* \i (dotless i): Accents. (line 17)
+* \iff: Math symbols. (line 257)
* \IfFileExists: Class and package commands.
- (line 127)
+ (line 128)
* \ignorespaces: \ignorespaces & \ignorespacesafterend.
(line 6)
* \ignorespacesafterend: \ignorespaces & \ignorespacesafterend.
@@ -12004,40 +15528,43 @@ Command Index
(line 32)
* \IJ (IJ): Additional Latin letters.
(line 32)
-* \Im: Math symbols. (line 262)
-* \imath: Math accents. (line 34)
-* \in: Math symbols. (line 265)
-* \include: \include. (line 6)
+* \Im: Math symbols. (line 261)
+* \imath: Math symbols. (line 264)
+* \in: Math symbols. (line 268)
+* \include: \include & \includeonly.
+ (line 6)
* \includegraphics: \includegraphics. (line 6)
-* \includeonly: \includeonly. (line 6)
-* \indent: \indent. (line 6)
-* \index: Indexes. (line 9)
-* \indexentry: Indexes. (line 12)
-* \indexspace: Indexes. (line 32)
+* \includeonly: \include & \includeonly.
+ (line 6)
+* \indent: \indent & \noindent. (line 6)
+* \index: Indexes. (line 6)
+* \index <1>: \index. (line 6)
+* \indexentry: \index. (line 106)
+* \indexspace: makeindex. (line 58)
* \inf: Math functions. (line 57)
-* \infty: Math symbols. (line 271)
+* \infty: Math symbols. (line 273)
* \input: \input. (line 6)
* \InputIfFileExists: Class and package commands.
- (line 127)
-* \int: Math symbols. (line 274)
+ (line 128)
+* \int: Math symbols. (line 276)
* \intextsep: Floats. (line 118)
* \intextsep <1>: Floats. (line 119)
-* \iota: Math symbols. (line 277)
-* \it: Font styles. (line 76)
-* \item: description. (line 29)
+* \iota: Math symbols. (line 279)
+* \it: Font styles. (line 80)
+* \item: description. (line 31)
* \item <1>: enumerate. (line 29)
* \item <2>: itemize. (line 6)
* \item <3>: itemize. (line 28)
-* \itemindent: list. (line 80)
-* \itemsep: list. (line 84)
+* \itemindent: list. (line 83)
+* \itemsep: list. (line 87)
* \itshape: Font styles. (line 33)
-* \j (dotless j): Accents. (line 66)
-* \jmath: Math accents. (line 37)
-* \Join: Math symbols. (line 280)
-* \k (ogonek): Accents. (line 70)
-* \kappa: Math symbols. (line 284)
+* \j (dotless j): Accents. (line 17)
+* \jmath: Math symbols. (line 286)
+* \Join: Math symbols. (line 282)
+* \k (ogonek): Accents. (line 71)
+* \kappa: Math symbols. (line 290)
* \ker: Math functions. (line 60)
-* \kill: tabbing. (line 106)
+* \kill: tabbing. (line 107)
* \l (/l): Additional Latin letters.
(line 36)
* \L (/L): Additional Latin letters.
@@ -12051,43 +15578,44 @@ Command Index
* \labelitemii: itemize. (line 35)
* \labelitemiii: itemize. (line 35)
* \labelitemiv: itemize. (line 35)
-* \labelsep: list. (line 96)
-* \labelwidth: list. (line 101)
-* \Lambda: Math symbols. (line 287)
-* \lambda: Math symbols. (line 290)
-* \land: Math symbols. (line 293)
-* \langle: Math symbols. (line 298)
+* \labelsep: list. (line 99)
+* \labelwidth: list. (line 104)
+* \Lambda: Math symbols. (line 293)
+* \lambda: Math symbols. (line 296)
+* \land: Math symbols. (line 299)
+* \langle: Math symbols. (line 304)
* \large: Font sizes. (line 11)
* \Large: Font sizes. (line 11)
* \LARGE: Font sizes. (line 11)
-* \LaTeX: Text symbols. (line 20)
-* \LaTeXe: Text symbols. (line 23)
-* \lbrace: Math symbols. (line 303)
-* \lbrack: Math symbols. (line 307)
-* \lceil: Math symbols. (line 311)
-* \ldots: Text symbols. (line 33)
-* \le: Math symbols. (line 315)
-* \leadsto: Math symbols. (line 319)
-* \left DELIM1 ... \right DELIM2: Math miscellany. (line 35)
-* \Leftarrow: Math symbols. (line 326)
-* \leftarrow: Math symbols. (line 331)
+* \LaTeX: Text symbols. (line 21)
+* \LaTeXe: Text symbols. (line 24)
+* \lbrace: Math symbols. (line 309)
+* \lbrack: Math symbols. (line 313)
+* \lceil: Math symbols. (line 317)
+* \ldots: Dots. (line 25)
+* \ldots <1>: Text symbols. (line 34)
+* \le: Math symbols. (line 321)
+* \leadsto: Math symbols. (line 325)
+* \left: \left & \right. (line 6)
+* \Leftarrow: Math symbols. (line 332)
+* \leftarrow: Math symbols. (line 337)
* \lefteqn: eqnarray. (line 46)
-* \leftharpoondown: Math symbols. (line 335)
-* \leftharpoonup: Math symbols. (line 338)
+* \leftharpoondown: Math symbols. (line 341)
+* \leftharpoonup: Math symbols. (line 344)
* \leftmargin: itemize. (line 54)
-* \leftmargin <1>: list. (line 121)
+* \leftmargin <1>: list. (line 124)
* \leftmargini: itemize. (line 54)
* \leftmarginii: itemize. (line 54)
* \leftmarginiii: itemize. (line 54)
* \leftmarginiv: itemize. (line 54)
* \leftmarginv: itemize. (line 54)
* \leftmarginvi: itemize. (line 54)
-* \Leftrightarrow: Math symbols. (line 341)
-* \leftrightarrow: Math symbols. (line 346)
-* \leq: Math symbols. (line 351)
-* \lfloor: Math symbols. (line 355)
+* \Leftrightarrow: Math symbols. (line 347)
+* \leftrightarrow: Math symbols. (line 352)
+* \leq: Math symbols. (line 357)
+* \lfloor: Math symbols. (line 361)
* \lg: Math functions. (line 63)
-* \lhd: Math symbols. (line 358)
+* \lhd: Math symbols. (line 364)
* \lim: Math functions. (line 66)
* \liminf: Math functions. (line 69)
* \limsup: Math functions. (line 72)
@@ -12101,101 +15629,110 @@ Command Index
(line 33)
* \linewidth <1>: Page layout parameters.
(line 34)
-* \listoffigures: Tables of contents. (line 16)
-* \listoftables: Tables of contents. (line 16)
-* \listparindent: list. (line 138)
-* \ll: Math symbols. (line 366)
+* \listoffigures: Table of contents etc..
+ (line 6)
+* \listoftables: Table of contents etc..
+ (line 6)
+* \listparindent: list. (line 141)
+* \ll: Math symbols. (line 372)
* \ln: Math functions. (line 75)
-* \lnot: Math symbols. (line 370)
+* \lnot: Math symbols. (line 376)
* \LoadClass: Class and package commands.
- (line 144)
+ (line 148)
* \LoadClassWithOptions: Class and package commands.
- (line 144)
+ (line 148)
* \location: \location. (line 6)
* \log: Math functions. (line 78)
-* \longleftarrow: Math symbols. (line 373)
-* \longleftrightarrow: Math symbols. (line 378)
-* \longmapsto: Math symbols. (line 382)
-* \longrightarrow: Math symbols. (line 387)
-* \lor: Math symbols. (line 392)
-* \lq: Text symbols. (line 39)
-* \makebox: \makebox. (line 6)
+* \longleftarrow: Math symbols. (line 379)
+* \longleftrightarrow: Math symbols. (line 384)
+* \longmapsto: Math symbols. (line 388)
+* \longrightarrow: Math symbols. (line 393)
+* \lor: Math symbols. (line 398)
+* \lq: Text symbols. (line 40)
+* \mainmatter: \frontmatter & \mainmatter & \backmatter.
+ (line 6)
+* \makebox: \mbox & \makebox. (line 6)
* \makebox (for picture): \makebox (picture). (line 6)
* \makeglossary: Glossaries. (line 6)
+* \makeglossary <1>: Glossaries. (line 43)
* \makeindex: Indexes. (line 6)
-* \makelabel: list. (line 53)
+* \makelabel: list. (line 60)
* \makelabels: \makelabels. (line 6)
* \maketitle: \maketitle. (line 6)
-* \mapsto: Math symbols. (line 395)
+* \mapsto: Math symbols. (line 401)
* \marginpar: Marginal notes. (line 6)
* \marginparpush: Page layout parameters.
(line 40)
* \marginparpush <1>: Page layout parameters.
(line 43)
-* \marginparpush <2>: Marginal notes. (line 36)
-* \marginparsep: Marginal notes. (line 40)
+* \marginparpush <2>: Marginal notes. (line 35)
+* \marginparsep: Marginal notes. (line 39)
* \marginparwidth: Page layout parameters.
(line 42)
* \marginparwidth <1>: Page layout parameters.
(line 43)
-* \marginparwidth <2>: Marginal notes. (line 44)
+* \marginparwidth <2>: Marginal notes. (line 43)
* \marginsep: Page layout parameters.
(line 41)
* \marginsep <1>: Page layout parameters.
(line 43)
-* \markboth{LEFT}{RIGHT}: \pagestyle. (line 29)
-* \markright{RIGHT}: \pagestyle. (line 36)
-* \mathbf: Font styles. (line 112)
-* \mathcal: Font styles. (line 128)
-* \mathdollar: Math miscellany. (line 40)
-* \mathellipsis: Math miscellany. (line 43)
-* \mathnormal: Font styles. (line 125)
-* \mathparagraph: Math miscellany. (line 46)
-* \mathring: Math accents. (line 40)
-* \mathrm: Font styles. (line 109)
-* \mathsection: Math miscellany. (line 49)
-* \mathsf: Font styles. (line 115)
-* \mathsterling: Math miscellany. (line 52)
-* \mathtt: Font styles. (line 118)
-* \mathunderscore: Math miscellany. (line 55)
-* \mathversion: Font styles. (line 130)
+* \markboth{LEFT-HEAD}{RIGHT-HEAD}: \pagestyle. (line 75)
+* \markright{RIGHT}: \pagestyle. (line 84)
+* \mathbf: Font styles. (line 110)
+* \mathcal: Font styles. (line 126)
+* \mathdollar: Math symbols. (line 910)
+* \mathnormal: Font styles. (line 123)
+* \mathparagraph: Math symbols. (line 913)
+* \mathring: Math accents. (line 34)
+* \mathrm: Font styles. (line 107)
+* \mathsection: Math symbols. (line 916)
+* \mathsf: Font styles. (line 113)
+* \mathsterling: Math symbols. (line 919)
+* \mathtt: Font styles. (line 116)
+* \mathunderscore: Math symbols. (line 922)
+* \mathversion: Font styles. (line 128)
* \max: Math functions. (line 81)
-* \mbox: \mbox. (line 6)
-* \mbox, and LR mode: Modes. (line 24)
+* \mbox: \mbox & \makebox. (line 6)
* \mdseries: Font styles. (line 36)
-* \medskip: \bigskip \medskip \smallskip.
- (line 14)
-* \medskipamount: \bigskip \medskip \smallskip.
- (line 15)
+* \medskip: \bigskip & \medskip & \smallskip.
+ (line 33)
+* \medskipamount: \bigskip & \medskip & \smallskip.
+ (line 34)
* \medspace: Spacing in math mode.
- (line 21)
-* \mho: Math symbols. (line 399)
-* \mid: Math symbols. (line 404)
+ (line 28)
+* \mho: Math symbols. (line 405)
+* \mid: Math symbols. (line 410)
* \min: Math functions. (line 84)
-* \models: Math symbols. (line 414)
-* \month: \day \month \year. (line 6)
-* \mp: Math symbols. (line 419)
-* \mu: Math symbols. (line 422)
+* \models: Math symbols. (line 420)
+* \month: \day & \month & \year.
+ (line 6)
+* \mp: Math symbols. (line 425)
+* \mu: Math symbols. (line 428)
* \multicolumn: \multicolumn. (line 6)
* \multiput: \multiput. (line 6)
-* \nabla: Math symbols. (line 425)
+* \nabla: Math symbols. (line 431)
* \name: \name. (line 6)
-* \natural: Math symbols. (line 428)
-* \ne: Math symbols. (line 431)
-* \nearrow: Math symbols. (line 434)
+* \natural: Math symbols. (line 434)
+* \ne: Math symbols. (line 437)
+* \nearrow: Math symbols. (line 440)
* \NeedsTeXFormat: Class and package commands.
- (line 176)
-* \neg: Math symbols. (line 437)
-* \neq: Math symbols. (line 441)
+ (line 182)
+* \neg: Math symbols. (line 443)
+* \negthinspace: Spacing in math mode.
+ (line 46)
+* \negthinspace <1>: \thinspace & \negthinspace.
+ (line 6)
+* \neq: Math symbols. (line 447)
* \newcommand: \newcommand & \renewcommand.
(line 6)
* \newcounter: \newcounter. (line 6)
* \newenvironment: \newenvironment & \renewenvironment.
(line 6)
* \newfont: \newfont. (line 6)
+* \newglossaryentry: \newglossaryentry. (line 6)
* \newlength: \newlength. (line 6)
* \newline: \newline. (line 6)
-* \NEWLINE: \(SPACE) and \@. (line 6)
+* \NEWLINE: \(SPACE). (line 6)
* \newpage: \newpage. (line 6)
* \newsavebox: \newsavebox. (line 6)
* \newtheorem: \newtheorem. (line 6)
@@ -12204,12 +15741,12 @@ Command Index
(line 40)
* \NG: Additional Latin letters.
(line 40)
-* \ni: Math symbols. (line 444)
+* \ni: Math symbols. (line 450)
* \nocite: \nocite. (line 6)
* \nocorr: Font styles. (line 21)
* \nocorrlist: Font styles. (line 21)
-* \nofiles: Tables of contents. (line 21)
-* \noindent: \noindent. (line 6)
+* \nofiles: \nofiles. (line 6)
+* \noindent: \indent & \noindent. (line 6)
* \nolinebreak: \linebreak & \nolinebreak.
(line 6)
* \nonfrenchspacing: \frenchspacing. (line 6)
@@ -12217,13 +15754,13 @@ Command Index
* \nopagebreak: \pagebreak & \nopagebreak.
(line 6)
* \normalfont: Font styles. (line 57)
-* \normalmarginpar: Marginal notes. (line 24)
+* \normalmarginpar: Marginal notes. (line 22)
* \normalsfcodes: \normalsfcodes. (line 6)
* \normalsize: Font sizes. (line 11)
-* \not: Math symbols. (line 449)
-* \notin: Math symbols. (line 457)
-* \nu: Math symbols. (line 461)
-* \nwarrow: Math symbols. (line 464)
+* \not: Math symbols. (line 455)
+* \notin: Math symbols. (line 463)
+* \nu: Math symbols. (line 467)
+* \nwarrow: Math symbols. (line 470)
* \o (/o): Additional Latin letters.
(line 44)
* \O (/O): Additional Latin letters.
@@ -12236,28 +15773,30 @@ Command Index
(line 66)
* \oddsidemargin <2>: Page layout parameters.
(line 68)
-* \odot: Math symbols. (line 467)
+* \odot: Math symbols. (line 473)
* \oe (oe): Additional Latin letters.
(line 48)
* \OE (OE): Additional Latin letters.
(line 48)
-* \oint: Math symbols. (line 472)
-* \oldstylenums: Font styles. (line 134)
-* \Omega: Math symbols. (line 476)
-* \omega: Math symbols. (line 479)
-* \ominus: Math symbols. (line 482)
+* \oint: Math symbols. (line 478)
+* \oldstylenums: Font styles. (line 132)
+* \Omega: Math symbols. (line 482)
+* \omega: Math symbols. (line 485)
+* \ominus: Math symbols. (line 488)
* \onecolumn: \onecolumn. (line 6)
* \opening: \opening. (line 6)
-* \oplus: Math symbols. (line 485)
+* \oplus: Math symbols. (line 491)
* \OptionNotUsed: Class and package commands.
- (line 192)
-* \oslash: Math symbols. (line 489)
-* \otimes: Math symbols. (line 492)
+ (line 200)
+* \oslash: Math symbols. (line 495)
+* \otimes: Math symbols. (line 498)
* \oval: \oval. (line 6)
-* \overbrace{MATH}: Math miscellany. (line 58)
-* \overline{TEXT}: Math miscellany. (line 62)
-* \owns: Math symbols. (line 497)
-* \P: Text symbols. (line 42)
+* \overbrace{MATH}: Over- and Underlining.
+ (line 40)
+* \overline{TEXT}: Over- and Underlining.
+ (line 21)
+* \owns: Math symbols. (line 503)
+* \P: Text symbols. (line 43)
* \PackageError: Class and package commands.
(line 41)
* \PackageInfo: Class and package commands.
@@ -12281,257 +15820,281 @@ Command Index
(line 85)
* \paperwidth <1>: Page layout parameters.
(line 86)
-* \paragraph: Sectioning. (line 14)
-* \parallel: Math symbols. (line 502)
+* \par: \par. (line 6)
+* \paragraph: Sectioning. (line 6)
+* \paragraph <1>: \subsubsection & \paragraph & \subparagraph.
+ (line 6)
+* \parallel: Math symbols. (line 508)
* \parbox: \parbox. (line 6)
-* \parindent: minipage. (line 17)
-* \parindent <1>: \indent. (line 6)
-* \parsep: list. (line 144)
-* \parskip: \parskip. (line 6)
+* \parindent: minipage. (line 104)
+* \parindent <1>: \indent & \noindent. (line 6)
+* \parindent <2>: \parindent & \parskip.
+ (line 6)
+* \parsep: list. (line 147)
+* \parskip: \parindent & \parskip.
+ (line 6)
* \parskip example: itemize. (line 73)
-* \part: Sectioning. (line 8)
-* \partial: Math symbols. (line 505)
-* \partopsep: list. (line 153)
+* \part: Sectioning. (line 6)
+* \part <1>: \part. (line 6)
+* \partial: Math symbols. (line 511)
+* \partopsep: list. (line 156)
* \PassOptionsToClass: Class and package commands.
- (line 198)
+ (line 206)
* \PassOptionsToPackage: Class and package commands.
- (line 198)
+ (line 206)
* \pdfpageheight: Document class options.
(line 40)
* \pdfpagewidth: Document class options.
(line 40)
-* \perp: Math symbols. (line 508)
-* \phi: Math symbols. (line 513)
-* \Pi: Math symbols. (line 517)
-* \pi: Math symbols. (line 520)
-* \pm: Math symbols. (line 524)
+* \perp: Math symbols. (line 514)
+* \phi: Math symbols. (line 519)
+* \Pi: Math symbols. (line 523)
+* \pi: Math symbols. (line 526)
+* \pm: Math symbols. (line 530)
* \pmod: Math functions. (line 87)
-* \poptabs: tabbing. (line 112)
-* \poptabs <1>: tabbing. (line 113)
-* \pounds: Text symbols. (line 46)
+* \poptabs: tabbing. (line 113)
+* \poptabs <1>: tabbing. (line 114)
+* \pounds: Text symbols. (line 47)
* \Pr: Math functions. (line 90)
-* \prec: Math symbols. (line 527)
-* \preceq: Math symbols. (line 530)
-* \prime: Math symbols. (line 535)
-* \printindex: Indexes. (line 28)
+* \prec: Math symbols. (line 533)
+* \preceq: Math symbols. (line 536)
+* \prime: Math symbols. (line 541)
+* \printglossaries: Glossaries. (line 6)
+* \printglossaries <1>: Glossaries. (line 43)
+* \printindex: \printindex. (line 6)
+* \printindex <1>: \printindex. (line 10)
* \ProcessOptions: Class and package commands.
- (line 232)
+ (line 243)
* \ProcessOptions*: Class and package commands.
- (line 232)
-* \prod: Math symbols. (line 544)
-* \propto: Math symbols. (line 547)
+ (line 243)
+* \prod: Math symbols. (line 550)
+* \propto: Math symbols. (line 553)
* \protect: \protect. (line 6)
* \providecommand: \providecommand. (line 6)
* \ProvidesClass: Class and package commands.
- (line 270)
+ (line 281)
* \ProvidesFile: Class and package commands.
- (line 301)
+ (line 314)
* \ProvidesPackage: Class and package commands.
- (line 270)
+ (line 281)
* \ps: \ps. (line 6)
-* \Psi: Math symbols. (line 550)
-* \psi: Math symbols. (line 553)
-* \pushtabs: tabbing. (line 115)
+* \Psi: Math symbols. (line 556)
+* \psi: Math symbols. (line 559)
+* \pushtabs: tabbing. (line 116)
* \put: \put. (line 6)
+* \qbezier: \qbezier. (line 6)
* \qquad: Spacing in math mode.
- (line 38)
+ (line 57)
+* \qquad <1>: \enspace & \quad & \qquad.
+ (line 6)
* \quad: Spacing in math mode.
- (line 32)
-* \quotedblbase (,,): Text symbols. (line 50)
-* \quotesinglbase (,): Text symbols. (line 51)
+ (line 51)
+* \quad <1>: \enspace & \quad & \qquad.
+ (line 6)
+* \quotedblbase (,,): Text symbols. (line 51)
+* \quotesinglbase (,): Text symbols. (line 52)
* \r (ring accent): Accents. (line 75)
* \raggedbottom: \raggedbottom. (line 6)
* \raggedleft: \raggedleft. (line 6)
* \raggedright: \raggedright. (line 6)
* \raisebox: \raisebox. (line 6)
-* \rangle: Math symbols. (line 556)
-* \rbrace: Math symbols. (line 560)
-* \rbrack: Math symbols. (line 564)
-* \rceil: Math symbols. (line 568)
-* \Re: Math symbols. (line 571)
+* \rangle: Math symbols. (line 562)
+* \rbrace: Math symbols. (line 567)
+* \rbrack: Math symbols. (line 571)
+* \rceil: Math symbols. (line 575)
+* \Re: Math symbols. (line 578)
* \ref: \ref. (line 6)
* \reflectbox: \scalebox. (line 6)
-* \refname: thebibliography. (line 26)
* \refstepcounter: \refstepcounter. (line 6)
* \renewenvironment: \newenvironment & \renewenvironment.
(line 6)
* \RequirePackage: Class and package commands.
- (line 310)
+ (line 323)
* \RequirePackageWithOptions: Class and package commands.
- (line 310)
+ (line 323)
* \resizebox: \resizebox. (line 6)
* \restorecr: \obeycr & \restorecr.
(line 6)
-* \restriction: Math symbols. (line 576)
-* \revemptyset: Math symbols. (line 581)
-* \reversemarginpar: Marginal notes. (line 24)
-* \rfloor: Math symbols. (line 586)
-* \rhd: Math symbols. (line 590)
-* \rho: Math symbols. (line 597)
-* \right: Math miscellany. (line 36)
-* \Rightarrow: Math symbols. (line 601)
-* \rightarrow: Math symbols. (line 605)
-* \rightharpoondown: Math symbols. (line 610)
-* \rightharpoonup: Math symbols. (line 613)
-* \rightleftharpoons: Math symbols. (line 616)
-* \rightmargin: list. (line 168)
-* \rm: Font styles. (line 79)
+* \restriction: Math symbols. (line 583)
+* \revemptyset: Math symbols. (line 588)
+* \reversemarginpar: Marginal notes. (line 22)
+* \rfloor: Math symbols. (line 593)
+* \rhd: Math symbols. (line 597)
+* \rho: Math symbols. (line 604)
+* \right: \left & \right. (line 6)
+* \Rightarrow: Math symbols. (line 608)
+* \rightarrow: Math symbols. (line 613)
+* \rightharpoondown: Math symbols. (line 617)
+* \rightharpoonup: Math symbols. (line 620)
+* \rightleftharpoons: Math symbols. (line 623)
+* \rightmargin: list. (line 171)
+* \rm: Font styles. (line 83)
* \rmfamily: Font styles. (line 30)
* \roman{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 23)
+ (line 27)
* \Roman{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 26)
+ (line 32)
* \rotatebox: \rotatebox. (line 6)
-* \rq: Text symbols. (line 54)
+* \rq: Text symbols. (line 55)
* \rule: \rule. (line 6)
-* \S: Text symbols. (line 57)
-* \savebox: \savebox. (line 6)
-* \sbox: \sbox. (line 6)
-* \sc: Font styles. (line 82)
+* \S: Text symbols. (line 58)
+* \savebox: \sbox & \savebox. (line 6)
+* \sbox: \sbox & \savebox. (line 6)
+* \sc: Font styles. (line 86)
* \scalebox: \scalebox. (line 6)
* \scriptsize: Font sizes. (line 11)
* \scshape: Font styles. (line 51)
-* \searrow: Math symbols. (line 619)
+* \searrow: Math symbols. (line 626)
* \sec: Math functions. (line 93)
-* \section: Sectioning. (line 11)
-* \seename: Indexes. (line 20)
+* \section: Sectioning. (line 6)
+* \section <1>: \section. (line 6)
+* \seename: \index. (line 56)
* \selectfont: Low-level font commands.
(line 131)
* \setcounter: \setcounter. (line 6)
* \setlength: \setlength. (line 6)
-* \setminus: Math symbols. (line 622)
+* \setminus: Math symbols. (line 629)
* \settodepth: \settodepth. (line 6)
* \settoheight: \settoheight. (line 6)
* \settowidth: \settowidth. (line 6)
-* \sf: Font styles. (line 85)
+* \sf: Font styles. (line 89)
* \sffamily: Font styles. (line 48)
-* \sharp: Math symbols. (line 628)
+* \sharp: Math symbols. (line 635)
* \shortstack: \shortstack. (line 6)
-* \Sigma: Math symbols. (line 631)
-* \sigma: Math symbols. (line 634)
+* \Sigma: Math symbols. (line 638)
+* \sigma: Math symbols. (line 641)
* \signature: \signature. (line 11)
-* \sim: Math symbols. (line 638)
-* \simeq: Math symbols. (line 641)
+* \sim: Math symbols. (line 645)
+* \simeq: Math symbols. (line 648)
* \sin: Math functions. (line 96)
* \sinh: Math functions. (line 99)
-* \sl: Font styles. (line 88)
-* \sloppy: \sloppy. (line 6)
+* \sl: Font styles. (line 92)
+* \sloppy: \fussy & \sloppy. (line 6)
* \slshape: Font styles. (line 45)
* \small: Font sizes. (line 11)
-* \smallint: Math symbols. (line 644)
-* \smallskip: \bigskip \medskip \smallskip.
- (line 19)
-* \smallskipamount: \bigskip \medskip \smallskip.
- (line 20)
-* \smile: Math symbols. (line 648)
+* \smallint: Math symbols. (line 651)
+* \smallskip: \bigskip & \medskip & \smallskip.
+ (line 38)
+* \smallskipamount: \bigskip & \medskip & \smallskip.
+ (line 39)
+* \smile: Math symbols. (line 655)
+* \SPACE: \(SPACE). (line 6)
* \spacefactor: \spacefactor. (line 10)
-* \spadesuit: Math symbols. (line 651)
-* \sqcap: Math symbols. (line 654)
-* \sqcup: Math symbols. (line 658)
-* \sqrt[ROOT]{ARG}: Math miscellany. (line 66)
-* \sqsubset: Math symbols. (line 662)
-* \sqsubseteq: Math symbols. (line 667)
-* \sqsupset: Math symbols. (line 672)
-* \sqsupseteq: Math symbols. (line 677)
+* \spadesuit: Math symbols. (line 658)
+* \sqcap: Math symbols. (line 661)
+* \sqcup: Math symbols. (line 665)
+* \sqrt: \sqrt. (line 6)
+* \sqsubset: Math symbols. (line 669)
+* \sqsubseteq: Math symbols. (line 674)
+* \sqsupset: Math symbols. (line 679)
+* \sqsupseteq: Math symbols. (line 684)
* \ss (ss): Additional Latin letters.
(line 52)
* \SS (SS): Additional Latin letters.
(line 52)
-* \stackrel{TEXT}{RELATION}: Math miscellany. (line 71)
-* \star: Math symbols. (line 681)
+* \stackrel: \stackrel. (line 6)
+* \star: Math symbols. (line 689)
* \stepcounter: \stepcounter. (line 6)
-* \stop: Command line. (line 18)
-* \subparagraph: Sectioning. (line 15)
-* \subsection: Sectioning. (line 12)
-* \subset: Math symbols. (line 688)
-* \subseteq: Math symbols. (line 691)
-* \subsubsection: Sectioning. (line 13)
-* \succ: Math symbols. (line 694)
-* \succeq: Math symbols. (line 698)
-* \sum: Math symbols. (line 703)
+* \stop: Recovering from errors.
+ (line 23)
+* \strut: \strut. (line 6)
+* \subparagraph: Sectioning. (line 6)
+* \subparagraph <1>: \subsubsection & \paragraph & \subparagraph.
+ (line 6)
+* \subsection: Sectioning. (line 6)
+* \subsection <1>: \subsection. (line 6)
+* \subset: Math symbols. (line 697)
+* \subseteq: Math symbols. (line 700)
+* \subsubsection: \subsubsection & \paragraph & \subparagraph.
+ (line 6)
+* \succ: Math symbols. (line 703)
+* \succeq: Math symbols. (line 707)
+* \sum: Math symbols. (line 712)
* \sup: Math functions. (line 102)
* \suppressfloats: Floats. (line 87)
-* \supset: Math symbols. (line 707)
-* \supseteq: Math symbols. (line 710)
-* \surd: Math symbols. (line 713)
-* \swarrow: Math symbols. (line 718)
+* \supset: Math symbols. (line 716)
+* \supseteq: Math symbols. (line 719)
+* \surd: Math symbols. (line 722)
+* \swarrow: Math symbols. (line 727)
* \symbol: Symbols by font position.
(line 6)
* \t (tie-after accent): Accents. (line 81)
-* \TAB: \(SPACE) and \@. (line 6)
-* \tabbingsep: tabbing. (line 120)
-* \tabcolsep: tabular. (line 171)
-* \tableofcontents: Tables of contents. (line 6)
+* \TAB: \(SPACE). (line 6)
+* \tabbingsep: tabbing. (line 121)
+* \tabcolsep: tabular. (line 173)
+* \tableofcontents: Table of contents etc..
+ (line 6)
* \tan: Math functions. (line 105)
* \tanh: Math functions. (line 108)
-* \tau: Math symbols. (line 721)
+* \tau: Math symbols. (line 730)
* \telephone: \telephone. (line 6)
-* \TeX: Text symbols. (line 60)
-* \textascendercompwordmark: Text symbols. (line 98)
-* \textasciicircum: Text symbols. (line 63)
-* \textasciitilde: Text symbols. (line 66)
-* \textasteriskcentered: Text symbols. (line 69)
+* \TeX: Text symbols. (line 62)
+* \textascendercompwordmark: Text symbols. (line 100)
+* \textasciicircum: Text symbols. (line 65)
+* \textasciitilde: Text symbols. (line 68)
+* \textasteriskcentered: Text symbols. (line 71)
* \textbackslash: Reserved characters. (line 20)
-* \textbackslash <1>: Text symbols. (line 72)
-* \textbar: Text symbols. (line 75)
-* \textbardbl: Text symbols. (line 78)
+* \textbackslash <1>: Text symbols. (line 74)
+* \textbar: Text symbols. (line 77)
+* \textbardbl: Text symbols. (line 80)
* \textbf: Font styles. (line 39)
-* \textbigcircle: Text symbols. (line 81)
-* \textbraceleft: Text symbols. (line 84)
-* \textbraceright: Text symbols. (line 87)
-* \textbullet: Text symbols. (line 90)
-* \textcapitalcompwordmark: Text symbols. (line 97)
-* \textcircled{LETTER}: Text symbols. (line 93)
-* \textcompwordmark: Text symbols. (line 96)
-* \textcopyright: Text symbols. (line 11)
-* \textdagger: Text symbols. (line 103)
-* \textdaggerdbl: Text symbols. (line 106)
-* \textdollar (or \$): Text symbols. (line 109)
-* \textellipsis: Text symbols. (line 35)
-* \textemdash (or ---): Text symbols. (line 112)
-* \textendash (or --): Text symbols. (line 115)
-* \texteuro: Text symbols. (line 118)
-* \textexclamdown (or !`): Text symbols. (line 121)
+* \textbigcircle: Text symbols. (line 83)
+* \textbraceleft: Text symbols. (line 86)
+* \textbraceright: Text symbols. (line 89)
+* \textbullet: Text symbols. (line 92)
+* \textcapitalcompwordmark: Text symbols. (line 99)
+* \textcircled{LETTER}: Text symbols. (line 95)
+* \textcompwordmark: Text symbols. (line 98)
+* \textcopyright: Text symbols. (line 12)
+* \textdagger: Text symbols. (line 107)
+* \textdaggerdbl: Text symbols. (line 110)
+* \textdollar (or \$): Text symbols. (line 113)
+* \textellipsis: Text symbols. (line 36)
+* \textemdash (or ---): Text symbols. (line 116)
+* \textendash (or --): Text symbols. (line 121)
+* \texteuro: Text symbols. (line 124)
+* \textexclamdown (or !`): Text symbols. (line 130)
* \textfloatsep: Floats. (line 123)
* \textfloatsep <1>: Floats. (line 124)
* \textfraction: Floats. (line 102)
* \textfraction <1>: Floats. (line 103)
-* \textgreater: Text symbols. (line 124)
+* \textgreater: Text symbols. (line 133)
* \textheight: Page layout parameters.
(line 91)
* \textheight <1>: Page layout parameters.
(line 92)
* \textit: Font styles. (line 33)
-* \textleftarrow: Text symbols. (line 130)
-* \textless: Text symbols. (line 127)
+* \textleftarrow: Text symbols. (line 139)
+* \textless: Text symbols. (line 136)
* \textmd: Font styles. (line 36)
* \textnormal: Font styles. (line 57)
-* \textordfeminine: Text symbols. (line 133)
-* \textordmasculine: Text symbols. (line 134)
-* \textparagraph: Text symbols. (line 43)
-* \textperiodcentered: Text symbols. (line 137)
-* \textquestiondown (or ?`): Text symbols. (line 140)
-* \textquotedblleft (or ``): Text symbols. (line 143)
-* \textquotedblright (or ''): Text symbols. (line 146)
-* \textquoteleft (or `): Text symbols. (line 149)
-* \textquoteright (or '): Text symbols. (line 152)
-* \textquotesingle: Text symbols. (line 155)
-* \textquotestraightbase: Text symbols. (line 158)
-* \textquotestraightdblbase: Text symbols. (line 159)
-* \textregistered: Text symbols. (line 162)
-* \textrightarrow: Text symbols. (line 165)
+* \textordfeminine: Text symbols. (line 142)
+* \textordmasculine: Text symbols. (line 143)
+* \textparagraph: Text symbols. (line 44)
+* \textperiodcentered: Text symbols. (line 146)
+* \textquestiondown (or ?`): Text symbols. (line 149)
+* \textquotedblleft (or ``): Text symbols. (line 152)
+* \textquotedblright (or ''): Text symbols. (line 155)
+* \textquoteleft (or `): Text symbols. (line 158)
+* \textquoteright (or '): Text symbols. (line 161)
+* \textquotesingle: Text symbols. (line 164)
+* \textquotestraightbase: Text symbols. (line 167)
+* \textquotestraightdblbase: Text symbols. (line 168)
+* \textregistered: Text symbols. (line 171)
+* \textrightarrow: Text symbols. (line 174)
* \textrm: Font styles. (line 30)
* \textsc: Font styles. (line 51)
+* \textsection: Text symbols. (line 59)
* \textsf: Font styles. (line 48)
* \textsl: Font styles. (line 45)
-* \textsterling: Text symbols. (line 47)
-* \textthreequartersemdash: Text symbols. (line 168)
-* \texttrademark: Text symbols. (line 171)
+* \textsterling: Text symbols. (line 48)
+* \textthreequartersemdash: Text symbols. (line 177)
+* \texttrademark: Text symbols. (line 180)
* \texttt: Font styles. (line 54)
-* \texttwelveudash: Text symbols. (line 174)
-* \textunderscore: Text symbols. (line 177)
+* \texttwelveudash: Text symbols. (line 183)
+* \textunderscore: Text symbols. (line 186)
* \textup: Font styles. (line 42)
-* \textvisiblespace: Text symbols. (line 180)
+* \textvisiblespace: Text symbols. (line 189)
* \textwidth: Page layout parameters.
(line 99)
* \textwidth <1>: Page layout parameters.
@@ -12540,156 +16103,473 @@ Command Index
(line 56)
* \TH (TH): Additional Latin letters.
(line 56)
-* \thanks{TEXT}: \maketitle. (line 21)
-* \theta: Math symbols. (line 724)
+* \thanks{TEXT}: \maketitle. (line 56)
+* \theta: Math symbols. (line 733)
* \thicklines: \thicklines. (line 6)
* \thickspace: Spacing in math mode.
- (line 16)
+ (line 23)
* \thinlines: \thinlines. (line 6)
* \thinspace: Spacing in math mode.
- (line 25)
-* \thinspace <1>: \thinspace. (line 6)
+ (line 32)
+* \thinspace <1>: \thinspace & \negthinspace.
+ (line 6)
* \thispagestyle: \thispagestyle. (line 6)
-* \tilde: Math accents. (line 43)
-* \times: Math symbols. (line 728)
+* \tilde: Math accents. (line 37)
+* \times: Math symbols. (line 737)
* \tiny: Font sizes. (line 11)
-* \title{TEXT}: \maketitle. (line 25)
-* \to: Math symbols. (line 732)
+* \title{TEXT}: \maketitle. (line 63)
+* \to: Math symbols. (line 741)
* \today: \today. (line 6)
-* \top: Math symbols. (line 736)
+* \top: Math symbols. (line 745)
* \topfraction: Floats. (line 107)
* \topfraction <1>: Floats. (line 108)
* \topmargin: Page layout parameters.
- (line 123)
-* \topsep: list. (line 173)
+ (line 124)
+* \topsep: list. (line 176)
* \topskip: Page layout parameters.
- (line 130)
-* \topskip <1>: Page layout parameters.
(line 131)
-* \totalheight: Predefined lengths. (line 12)
-* \triangle: Math symbols. (line 741)
-* \triangleleft: Math symbols. (line 744)
-* \triangleright: Math symbols. (line 750)
-* \tt: Font styles. (line 91)
+* \topskip <1>: Page layout parameters.
+ (line 132)
+* \triangle: Math symbols. (line 750)
+* \triangleleft: Math symbols. (line 753)
+* \triangleright: Math symbols. (line 759)
+* \tt: Font styles. (line 95)
* \ttfamily: Font styles. (line 54)
* \twocolumn: \twocolumn. (line 6)
* \typein: \typein. (line 6)
* \typeout: \typeout. (line 6)
-* \u (breve accent): Accents. (line 86)
-* \unboldmath: Math formulas. (line 29)
-* \underbar: Accents. (line 89)
-* \underbrace{MATH}: Math miscellany. (line 75)
-* \underline{TEXT}: Math miscellany. (line 79)
-* \unitlength: picture. (line 10)
-* \unlhd: Math symbols. (line 756)
-* \unrhd: Math symbols. (line 763)
-* \Uparrow: Math symbols. (line 770)
-* \uparrow: Math symbols. (line 774)
-* \Updownarrow: Math symbols. (line 778)
-* \updownarrow: Math symbols. (line 783)
-* \upharpoonright: Math symbols. (line 788)
-* \uplus: Math symbols. (line 793)
+* \u (breve accent): Accents. (line 85)
+* \unboldmath: \boldmath & \unboldmath.
+ (line 6)
+* \unboldmath <1>: \boldmath & \unboldmath.
+ (line 14)
+* \underbar: Accents. (line 51)
+* \underbrace{MATH}: Over- and Underlining.
+ (line 26)
+* \underline{TEXT}: Over- and Underlining.
+ (line 9)
+* \unitlength: picture. (line 25)
+* \unlhd: Math symbols. (line 765)
+* \unrhd: Math symbols. (line 772)
+* \Uparrow: Math symbols. (line 779)
+* \uparrow: Math symbols. (line 783)
+* \Updownarrow: Math symbols. (line 787)
+* \updownarrow: Math symbols. (line 792)
+* \upharpoonright: Math symbols. (line 797)
+* \uplus: Math symbols. (line 802)
* \upshape: Font styles. (line 42)
-* \Upsilon: Math symbols. (line 800)
-* \upsilon: Math symbols. (line 803)
+* \Upsilon: Math symbols. (line 809)
+* \upsilon: Math symbols. (line 812)
* \usebox: \usebox. (line 6)
* \usecounter: \usecounter. (line 6)
* \usefont: Low-level font commands.
(line 139)
* \usepackage: Additional packages. (line 6)
-* \v (breve accent): Accents. (line 97)
+* \v (breve accent): Accents. (line 89)
* \value: \value. (line 6)
-* \vanothing: Math symbols. (line 811)
-* \varepsilon: Math symbols. (line 806)
-* \varphi: Math symbols. (line 816)
-* \varpi: Math symbols. (line 820)
-* \varrho: Math symbols. (line 824)
-* \varsigma: Math symbols. (line 828)
-* \vartheta: Math symbols. (line 832)
-* \vdash: Math symbols. (line 836)
-* \vdots: Math miscellany. (line 84)
-* \vec: Math accents. (line 46)
+* \vanothing: Math symbols. (line 820)
+* \varepsilon: Math symbols. (line 815)
+* \varphi: Math symbols. (line 825)
+* \varpi: Math symbols. (line 829)
+* \varrho: Math symbols. (line 833)
+* \varsigma: Math symbols. (line 837)
+* \vartheta: Math symbols. (line 841)
+* \vdash: Math symbols. (line 845)
+* \vdots: Dots. (line 34)
+* \vec: Math accents. (line 40)
* \vector: \vector. (line 6)
-* \vee: Math symbols. (line 840)
+* \vee: Math symbols. (line 849)
* \verb: \verb. (line 6)
-* \Vert: Math symbols. (line 845)
-* \vert: Math symbols. (line 861)
+* \Vert: Math symbols. (line 854)
+* \vert: Math symbols. (line 870)
* \vfill: \vfill. (line 6)
* \vline: \vline. (line 6)
* \vspace: \vspace. (line 6)
-* \wedge: Math symbols. (line 879)
-* \widehat: Math accents. (line 49)
-* \widetilde: Math accents. (line 52)
-* \width: Predefined lengths. (line 6)
-* \wp: Math symbols. (line 883)
-* \wr: Math symbols. (line 886)
-* \Xi: Math symbols. (line 889)
-* \xi: Math symbols. (line 892)
-* \year: \day \month \year. (line 6)
-* \zeta: Math symbols. (line 895)
-* \[: Math formulas. (line 16)
-* \\ (for center): center. (line 14)
+* \wedge: Math symbols. (line 888)
+* \widehat: Math accents. (line 43)
+* \widetilde: Math accents. (line 46)
+* \wp: Math symbols. (line 892)
+* \wr: Math symbols. (line 895)
+* \Xi: Math symbols. (line 898)
+* \xi: Math symbols. (line 901)
+* \year: \day & \month & \year.
+ (line 6)
+* \zeta: Math symbols. (line 904)
+* \\ (for center): center. (line 16)
* \\ (for eqnarray): eqnarray. (line 29)
* \\ (for flushright): flushright. (line 12)
-* \\ (for \shortstack objects): \shortstack. (line 20)
-* \\ (tabbing): tabbing. (line 65)
-* \\ for flushleft: flushleft. (line 12)
-* \\ for letters: Letters. (line 50)
-* \\ for tabular: tabular. (line 34)
-* \\ for verse: verse. (line 17)
-* \\ for \author: \maketitle. (line 12)
-* \\ for \title: \maketitle. (line 26)
+* \\ (for \shortstack objects): \shortstack. (line 32)
+* \\ (tabbing): tabbing. (line 66)
+* \\ for flushleft: flushleft. (line 14)
+* \\ for letters: Letters. (line 49)
+* \\ for tabular: tabular. (line 35)
+* \\ for verse: verse. (line 21)
+* \\ for \author: \maketitle. (line 43)
+* \\ for \title: \maketitle. (line 64)
* \\ force line break: \\. (line 6)
* \\* (for eqnarray): eqnarray. (line 37)
-* \]: Math formulas. (line 16)
* \^: Reserved characters. (line 20)
-* \^ (circumflex accent): Accents. (line 33)
+* \^ (circumflex accent): Accents. (line 38)
* \_: Reserved characters. (line 13)
-* \` (grave accent): Accents. (line 37)
-* \` (tabbing): tabbing. (line 92)
+* \` (grave accent): Accents. (line 42)
+* \` (tabbing): tabbing. (line 93)
* \{: Reserved characters. (line 13)
-* \|: Math symbols. (line 19)
+* \|: Math symbols. (line 18)
* \}: Reserved characters. (line 13)
* \~: Reserved characters. (line 20)
-* \~ (tilde accent): Accents. (line 43)
+* \~ (tilde accent): Accents. (line 46)
* ^: Subscripts & superscripts.
(line 6)
* _: Subscripts & superscripts.
(line 6)
+* 'see' and 'see also' index entries: \index. (line 56)
* {...} for required arguments: LaTeX command syntax.
(line 6)
+* ~: ~. (line 6)
* a4paper option: Document class options.
(line 19)
* a5paper option: Document class options.
(line 19)
* abstract environment: abstract. (line 6)
+* abstracts: abstract. (line 6)
+* accents: Accents. (line 6)
+* accents, mathematical: Math accents. (line 6)
+* accessing any character of a font: Symbols by font position.
+ (line 6)
+* acronyms, list of: Glossaries. (line 6)
+* acute accent: Accents. (line 27)
+* acute accent, math: Math accents. (line 11)
+* additional packages, loading: Additional packages. (line 6)
+* ae ligature: Additional Latin letters.
+ (line 16)
+* algorithm2e package: tabbing. (line 146)
+* align environment, from amsmath: eqnarray. (line 6)
+* aligning equations: eqnarray. (line 6)
+* alignment via tabbing: tabbing. (line 6)
+* amsfonts package: Math formulas. (line 86)
+* amsmath package: array. (line 55)
+* amsmath package <1>: array. (line 66)
+* amsmath package <2>: displaymath. (line 22)
+* amsmath package <3>: equation. (line 20)
+* amsmath package <4>: theorem. (line 28)
+* amsmath package <5>: Math formulas. (line 86)
+* amsmath package <6>: Dots. (line 37)
+* amsmath package <7>: Math functions. (line 111)
+* amsmath package <8>: Colon character & \colon.
+ (line 15)
+* amsmath package <9>: Colon character & \colon.
+ (line 19)
+* amsmath package, replacing eqnarray: eqnarray. (line 6)
+* amsthm package: theorem. (line 28)
+* amsthm package <1>: \rule. (line 18)
+* appendices: \appendix. (line 6)
+* appendix: \appendix. (line 6)
+* appendix package: \appendix. (line 29)
+* aring: Additional Latin letters.
+ (line 12)
+* array (package) package: array. (line 77)
* array environment: array. (line 6)
+* arrays, math: array. (line 6)
+* arrow, left, in text: Text symbols. (line 140)
+* arrow, right, in text: Text symbols. (line 175)
* article class: Document classes. (line 11)
+* ascender height: Text symbols. (line 101)
+* ASCII circumflex, in text: Text symbols. (line 66)
+* ASCII tilde, in text: Text symbols. (line 69)
+* asterisk, centered, in text: Text symbols. (line 72)
+* Asymptote package: \line. (line 36)
+* Asymptote package <1>: \strut. (line 62)
+* Asymptote package <2>: \mbox & \makebox. (line 73)
+* at clause, in font definitions: \newfont. (line 19)
+* at-sign: \@. (line 6)
+* author, for titlepage: \maketitle. (line 43)
+* auxiliary file: Output files. (line 33)
* b5paper option: Document class options.
(line 19)
+* babel package: \chapter. (line 71)
+* babel package <1>: thebibliography. (line 53)
+* babel package <2>: Accents. (line 6)
+* babel package <3>: \today. (line 13)
+* babel package <4>: Table of contents etc..
+ (line 80)
+* babel package <5>: \index. (line 56)
+* background, colored: Colored pages. (line 6)
+* backslash, in text: Text symbols. (line 75)
+* bar, double vertical, in text: Text symbols. (line 81)
+* bar, vertical, in text: Text symbols. (line 78)
+* bar-over accent: Accents. (line 34)
+* bar-over accent, math: Math accents. (line 14)
+* bar-under accent: Accents. (line 49)
+* basics of LaTeX: Overview. (line 6)
+* beamer template and class: beamer template. (line 6)
+* beginning of document hook: \AtBeginDocument. (line 6)
+* bibliography format, open: Document class options.
+ (line 67)
+* bibliography, creating (automatically): Using BibTeX. (line 6)
+* bibliography, creating (manually): thebibliography. (line 6)
+* bibTeX, using: Using BibTeX. (line 6)
+* big circle symbols, in text: Text symbols. (line 84)
+* Big point: Units of length. (line 20)
+* bigfoot package: Footnotes of footnotes.
+ (line 6)
+* black boxes, omitting: Document class options.
+ (line 53)
+* blackboard bold: Blackboard bold. (line 6)
+* bm package: \boldmath & \unboldmath.
+ (line 32)
+* bold font: Font styles. (line 75)
+* bold math: Font styles. (line 128)
+* bold typewriter, avoiding: description. (line 36)
+* boldface mathematics: \boldmath & \unboldmath.
+ (line 6)
* book class: Document classes. (line 11)
+* book, back matter: \frontmatter & \mainmatter & \backmatter.
+ (line 6)
+* book, end matter: \frontmatter & \mainmatter & \backmatter.
+ (line 6)
+* book, front matter: \frontmatter & \mainmatter & \backmatter.
+ (line 6)
+* book, main matter: \frontmatter & \mainmatter & \backmatter.
+ (line 6)
* bottomnumber: Floats. (line 130)
* bottomnumber <1>: Floats. (line 131)
+* box: \mbox & \makebox. (line 6)
+* box, allocating new: \newsavebox. (line 6)
+* box, colored: Colored boxes. (line 6)
+* box, save: \sbox & \savebox. (line 6)
+* box, use saved box: \usebox. (line 6)
+* boxes: Boxes. (line 6)
* bp: Units of length. (line 20)
+* brace, left, in text: Text symbols. (line 87)
+* brace, right, in text: Text symbols. (line 90)
+* breaking lines: Line breaking. (line 6)
+* breaking pages: Page breaking. (line 6)
+* breaks, multiplication discretionary: \*. (line 6)
+* breve accent: Accents. (line 85)
+* breve accent, math: Math accents. (line 17)
+* bug reporting: About this document. (line 21)
+* bullet lists: itemize. (line 6)
+* bullet symbol: Math symbols. (line 113)
+* bullet, in text: Text symbols. (line 93)
+* bulleted lists: itemize. (line 6)
+* calligraphic fonts: Calligraphic. (line 6)
+* calligraphic letters for math: Font styles. (line 78)
+* cap height: Text symbols. (line 101)
+* caron accent: Accents. (line 89)
+* catcode: \makeatletter & \makeatother.
+ (line 18)
+* category code, character: \makeatletter & \makeatother.
+ (line 18)
* cc: Units of length. (line 33)
+* cc list, in letters: \cc. (line 6)
+* cedilla accent: Accents. (line 59)
* center environment: center. (line 6)
+* centered asterisk, in text: Text symbols. (line 72)
+* centered equations: Document class options.
+ (line 57)
+* centered period, in text: Text symbols. (line 147)
+* centering text, declaration for: \centering. (line 6)
+* centering text, environment for: center. (line 6)
+* Centimeter: Units of length. (line 24)
+* chapter: Sectioning. (line 6)
+* chapter <1>: \chapter. (line 6)
+* character category code: \makeatletter & \makeatother.
+ (line 18)
+* characters, accented: Accents. (line 6)
+* characters, case of: Upper and lower case.
+ (line 6)
+* characters, non-English: Additional Latin letters.
+ (line 6)
+* characters, reserved: Reserved characters. (line 6)
+* characters, special: Reserved characters. (line 6)
+* check accent: Accents. (line 89)
+* check accent, math: Math accents. (line 20)
+* Cicero: Units of length. (line 33)
+* circle symbol, big, in text: Text symbols. (line 84)
+* circled letter, in text: Text symbols. (line 96)
+* circumflex accent: Accents. (line 38)
+* circumflex accent, math: Math accents. (line 32)
+* circumflex, ASCII, in text: Text symbols. (line 66)
+* citation key: \bibitem. (line 15)
+* class and package commands: Class and package commands.
+ (line 6)
+* class and package difference: Class and package construction.
+ (line 15)
+* class and package structure: Class and package structure.
+ (line 6)
+* class file example: Class and package structure.
+ (line 36)
+* class file layout: Class and package structure.
+ (line 6)
+* class options: Document class options.
+ (line 6)
+* class options <1>: Class and package structure.
+ (line 6)
+* class options <2>: Class and package commands.
+ (line 66)
+* classes of documents: Document classes. (line 6)
+* cleveref package: Cross references. (line 38)
+* cleveref package <1>: \ref. (line 29)
+* cleveref package <2>: \footnotemark. (line 48)
* clock option to slides class: Document class options.
(line 99)
+* closing letters: \closing. (line 6)
+* closing quote: Text symbols. (line 56)
* cm: Units of length. (line 24)
+* code, typesetting: verbatim. (line 6)
+* colon character: Colon character & \colon.
+ (line 6)
+* color: Color. (line 6)
+* color <1>: Define colors. (line 6)
+* color <2>: Colored text. (line 6)
+* color <3>: Colored boxes. (line 6)
+* color <4>: Colored pages. (line 6)
+* color models: Color models. (line 6)
+* color package commands: Commands for color. (line 6)
+* color package options: Color package options.
+ (line 6)
+* color, define: Define colors. (line 6)
+* colored boxes: Colored boxes. (line 6)
+* colored page: Colored pages. (line 6)
+* colored text: Colored text. (line 6)
+* command line: Command line. (line 6)
+* command syntax: LaTeX command syntax.
+ (line 6)
+* commands, class and package: Class and package commands.
+ (line 6)
+* commands, defining new ones: \newcommand & \renewcommand.
+ (line 6)
+* commands, defining new ones <1>: \providecommand. (line 6)
+* commands, document class: Class and package construction.
+ (line 6)
+* commands, graphics package: Commands for graphics.
+ (line 6)
+* commands, ignore spaces: \ignorespaces & \ignorespacesafterend.
+ (line 6)
+* commands, redefining: \newcommand & \renewcommand.
+ (line 6)
+* commands, star-variants: \@ifstar. (line 6)
+* composite word mark, in text: Text symbols. (line 101)
+* computer programs, typesetting: verbatim. (line 6)
+* configuration, graphics package: Graphics package configuration.
+ (line 6)
+* contents file: Output files. (line 43)
+* copyright symbol: Text symbols. (line 13)
+* counters, a list of: Counters. (line 6)
+* counters, defining new: \newcounter. (line 6)
+* counters, getting value of: \value. (line 6)
+* counters, printing: \alph \Alph \arabic \roman \Roman \fnsymbol.
+ (line 6)
+* counters, setting: \setcounter. (line 6)
+* cprotect package: verbatim. (line 26)
+* cprotect package <1>: \verb. (line 45)
+* creating pictures: picture. (line 6)
+* creating tables: table. (line 6)
+* credit footnote: \maketitle. (line 57)
+* cross references: Cross references. (line 6)
+* cross references, resolving: Output files. (line 33)
+* cross referencing with page number: \pageref. (line 6)
+* cross referencing, symbolic: \ref. (line 6)
+* CTAN: CTAN. (line 6)
+* currency, dollar: Text symbols. (line 114)
+* currency, euro: Text symbols. (line 125)
+* dagger, double, in text: Text symbols. (line 111)
+* dagger, in text: Text symbols. (line 16)
+* dagger, in text <1>: Text symbols. (line 108)
+* DANTE e.V.: CTAN. (line 20)
+* date, for titlepage: \maketitle. (line 51)
+* date, today's: \today. (line 6)
+* datetime package: \today. (line 27)
* dbltopnumber: Floats. (line 134)
* dbltopnumber <1>: Floats. (line 135)
+* dcolumn package: array. (line 77)
* dd: Units of length. (line 30)
+* define color: Define colors. (line 6)
+* defining a new command: \newcommand & \renewcommand.
+ (line 6)
+* defining a new command <1>: \providecommand. (line 6)
+* defining new environments: \newenvironment & \renewenvironment.
+ (line 6)
+* defining new fonts: \newfont. (line 6)
+* defining new theorems: \newtheorem. (line 6)
+* definitions: Definitions. (line 6)
+* delimiters, paired: \left & \right. (line 6)
+* delim_0: makeindex. (line 110)
+* delim_1: makeindex. (line 114)
+* delim_2: makeindex. (line 118)
+* delim_n: makeindex. (line 122)
+* delim_r: makeindex. (line 126)
+* description: \newglossaryentry. (line 46)
* description environment: description. (line 6)
+* description lists, creating: description. (line 6)
+* design size, in font definitions: \newfont. (line 19)
+* Didot point: Units of length. (line 30)
+* dieresis accent: Accents. (line 23)
+* difference between class and package: Class and package construction.
+ (line 15)
+* discretionary breaks, multiplication: \*. (line 6)
+* discretionary hyphenation: \discretionary. (line 6)
+* display math mode: Modes. (line 29)
+* displaying quoted text with paragraph indentation: quotation & quote.
+ (line 6)
+* displaying quoted text without paragraph indentation: quotation & quote.
+ (line 6)
* displaymath environment: displaymath. (line 6)
* displaymath environment <1>: Math formulas. (line 6)
+* document class commands: Class and package construction.
+ (line 6)
+* document class options: Document class options.
+ (line 6)
+* document class, defined: Starting and ending. (line 17)
+* document classes: Document classes. (line 6)
* document environment: document. (line 6)
+* document templates: Document templates. (line 6)
+* dollar sign: Text symbols. (line 114)
+* dot accent: Accents. (line 30)
+* dot over accent, math: Math accents. (line 26)
+* dot-over accent: Accents. (line 30)
+* dot-under accent: Accents. (line 63)
+* dotless i: Accents. (line 17)
+* dotless i, math: Math symbols. (line 265)
+* dotless j: Accents. (line 17)
+* dotless j, math: Math symbols. (line 287)
+* dots: Dots. (line 6)
+* double angle quotation marks: Text symbols. (line 31)
+* double dagger, in text: Text symbols. (line 19)
+* double dagger, in text <1>: Text symbols. (line 111)
+* double dot accent, math: Math accents. (line 23)
+* double guillemets: Text symbols. (line 31)
+* double left quote: Text symbols. (line 153)
+* double low-9 quotation mark: Text symbols. (line 53)
+* double quote, straight base: Text symbols. (line 169)
+* double right quote: Text symbols. (line 156)
+* double spacing: Low-level font commands.
+ (line 118)
+* double vertical bar, in text: Text symbols. (line 81)
+* doublestruck: Blackboard bold. (line 6)
* draft option: Document class options.
(line 49)
* dvipdfmx command: Output files. (line 10)
* dvips command: Output files. (line 10)
* dvitype command: Output files. (line 10)
+* e-dash: Text symbols. (line 122)
+* e-TeX: TeX engines. (line 13)
+* ellipses: Dots. (line 6)
+* ellipsis: Text symbols. (line 37)
* em: Units of length. (line 38)
+* em <1>: Units of length. (line 38)
+* em-dash: Text symbols. (line 117)
+* em-dash, three-quarters: Text symbols. (line 178)
+* em-dash, two-thirds: Text symbols. (line 184)
+* emphasis: Font styles. (line 59)
+* enclosure list: \encl. (line 6)
+* end of document hook: \AtEndDocument. (line 6)
+* ending and starting: Starting and ending. (line 6)
+* engines, TeX: TeX engines. (line 6)
+* enlarge current page: \enlargethispage. (line 6)
* enumerate environment: enumerate. (line 6)
+* enumitem package: list. (line 253)
+* environment: Starting and ending. (line 25)
* environment, abstract: abstract. (line 6)
* environment, array: array. (line 6)
* environment, center: center. (line 6)
@@ -12713,63 +16593,423 @@ Command Index
* environment, math <1>: Math formulas. (line 6)
* environment, minipage: minipage. (line 6)
* environment, picture: picture. (line 6)
-* environment, quotation: quotation and quote. (line 6)
-* environment, quote: quotation and quote. (line 6)
+* environment, quotation: quotation & quote. (line 6)
+* environment, quote: quotation & quote. (line 6)
* environment, tabbing: tabbing. (line 6)
* environment, table: table. (line 6)
* environment, tabular: tabular. (line 6)
* environment, thebibliography: thebibliography. (line 6)
* environment, theorem: theorem. (line 6)
+* environment, theorem-like: \newtheorem. (line 6)
* environment, titlepage: titlepage. (line 6)
* environment, verbatim: verbatim. (line 6)
* environment, verse: verse. (line 6)
+* environments: Environments. (line 6)
+* environments, defining: \newenvironment & \renewenvironment.
+ (line 6)
+* envlab package: \makelabels. (line 55)
+* EPS files: Graphics package configuration.
+ (line 6)
+* EPS files <1>: \includegraphics. (line 6)
* eqnarray environment: eqnarray. (line 6)
* equation environment: equation. (line 6)
* equation environment <1>: Math formulas. (line 6)
-* etex command: TeX engines. (line 12)
+* equation number, cross referencing: \ref. (line 6)
+* equation numbers, left vs. right: Document class options.
+ (line 63)
+* equation numbers, omitting: eqnarray. (line 41)
+* equations, aligning: eqnarray. (line 6)
+* equations, environment for: equation. (line 6)
+* equations, flush left vs. centered: Document class options.
+ (line 57)
+* es-zet German letter: Additional Latin letters.
+ (line 52)
+* etex command: TeX engines. (line 13)
+* eth, Icelandic letter: Additional Latin letters.
+ (line 20)
+* etoolbox package: Class and package commands.
+ (line 110)
+* euro symbol: Text symbols. (line 125)
+* eurosym package: Text symbols. (line 125)
* ex: Units of length. (line 38)
+* ex <1>: Units of length. (line 38)
+* exclamation point, upside-down: Text symbols. (line 131)
* executivepaper option: Document class options.
(line 19)
+* exponent: Subscripts & superscripts.
+ (line 6)
+* extended Latin: Additional Latin letters.
+ (line 6)
+* external files, writing: filecontents. (line 6)
+* families, of fonts: Low-level font commands.
+ (line 21)
+* fancyhdr package: Page styles. (line 12)
+* fancyhdr package <1>: \pagestyle. (line 13)
+* fancyvrb package: tabbing. (line 146)
+* fancyvrb package <1>: verbatim. (line 37)
+* feminine ordinal symbol: Text symbols. (line 144)
* figure environment: figure. (line 6)
+* figure number, cross referencing: \ref. (line 6)
+* figures, footnotes in: minipage. (line 108)
+* figures, inserting: figure. (line 6)
+* file, root: Splitting the input. (line 10)
* filecontents environment: filecontents. (line 6)
* filecontents* environment: filecontents. (line 6)
* final option: Document class options.
(line 49)
* first-latex-doc document: About this document. (line 33)
+* fixed-width font: Font styles. (line 96)
+* flafter package: Floats. (line 82)
* fleqn option: Document class options.
(line 49)
+* float package: Floats. (line 52)
+* float page: Floats. (line 58)
+* flush left equations: Document class options.
+ (line 57)
+* flushing floats and starting a page: \clearpage & \cleardoublepage.
+ (line 6)
* flushleft environment: flushleft. (line 6)
* flushright environment: flushright. (line 6)
-* <http://puszcza.gnu.org.ua/software/latexrefman/> home page: About this document.
+* font catalogue: Low-level font commands.
+ (line 21)
+* font commands, low-level: Low-level font commands.
+ (line 6)
+* font size: Low-level font commands.
+ (line 101)
+* font sizes: Font sizes. (line 6)
+* font styles: Font styles. (line 6)
+* font symbols, by number: Symbols by font position.
+ (line 6)
+* fonts: Fonts. (line 6)
+* fonts, new commands for: \newfont. (line 6)
+* fonts, script: Calligraphic. (line 6)
+* footer style: \pagestyle. (line 6)
+* footer, parameters for: Page layout parameters.
+ (line 6)
+* footnote number, cross referencing: \ref. (line 6)
+* footnote parameters: \footnote. (line 34)
+* footnote, in a table: Footnotes in a table.
+ (line 6)
+* footnote, in section headings: Footnotes in section headings.
+ (line 6)
+* footnote, of a footnote: Footnotes of footnotes.
+ (line 6)
+* footnotes in figures: minipage. (line 108)
+* footnotes, creating: Footnotes. (line 6)
+* Footnotes, in a minipage: \footnote. (line 62)
+* footnotes, symbols instead of numbers: \footnote. (line 24)
+* formulas, environment for: equation. (line 6)
+* formulas, math: Math formulas. (line 6)
+* forward reference: Cross references. (line 27)
+* forward references, resolving: Output files. (line 33)
+* fraction: \frac. (line 6)
+* fragile commands: \protect. (line 6)
+* frame rule width: \fbox & \framebox. (line 39)
+* frame, line width: \fbox & \framebox. (line 39)
+* frame, separation from contents: \fbox & \framebox. (line 44)
+* French quotation marks: Text symbols. (line 31)
+* functions, math: Math functions. (line 6)
+* geometry package: Document class options.
+ (line 40)
+* geometry package <1>: Document class options.
+ (line 44)
+* global options: Document class options.
+ (line 6)
+* global options <1>: Additional packages. (line 15)
+* glossaries: Glossaries. (line 6)
+* glossary: Glossaries. (line 6)
+* glossary, entries: \newglossaryentry. (line 6)
+* glossary, entry reference: \gls. (line 6)
+* glue register, plain TeX: \newlength. (line 6)
+* graphics: Graphics. (line 6)
+* graphics <1>: Graphics package configuration.
+ (line 6)
+* graphics <2>: \includegraphics. (line 6)
+* graphics package: Graphics. (line 6)
+* graphics package <1>: Graphics package configuration.
+ (line 6)
+* graphics package <2>: \includegraphics. (line 6)
+* graphics package commands: Commands for graphics.
(line 6)
+* graphics package options: Graphics package options.
+ (line 6)
+* graphics packages: \line. (line 36)
+* graphics, resizing: \scalebox. (line 6)
+* graphics, resizing <1>: \resizebox. (line 6)
+* graphics, scaling: \scalebox. (line 6)
+* graphics, scaling <1>: \resizebox. (line 6)
+* grave accent: Accents. (line 42)
+* grave accent, math: Math accents. (line 29)
+* greater than symbol, in text: Text symbols. (line 134)
+* greek letters: Math symbols. (line 6)
+* group, and environments: Environments. (line 18)
+* group_skip: makeindex. (line 57)
+* ha'c<ek accent, math: Math accents. (line 20)
+* hacek accent: Accents. (line 89)
+* Halmos symbol: \rule. (line 13)
+* hat accent: Accents. (line 38)
+* hat accent, math: Math accents. (line 32)
+* header style: \pagestyle. (line 6)
+* header, parameters for: Page layout parameters.
+ (line 6)
+* hello, world: Starting and ending. (line 6)
+* here, putting floats: Floats. (line 52)
+* home page for manual: About this document. (line 6)
+* horizontal space: \hss. (line 6)
+* horizontal space, stretchable: \hss. (line 6)
+* hungarian umlaut accent: Accents. (line 67)
+* hyperref package: \footnotemark. (line 48)
+* hyperref package <1>: \footnotemark. (line 57)
+* hyperref package <2>: \pagenumbering. (line 45)
+* hyperref package <3>: Command line input. (line 10)
+* hyphenation, defining: \hyphenation. (line 6)
+* hyphenation, discretionary: \discretionary. (line 6)
+* hyphenation, forcing: \- (hyphenation). (line 6)
+* hyphenation, preventing: \mbox & \makebox. (line 6)
+* Icelandic eth: Additional Latin letters.
+ (line 20)
+* Icelandic thorn: Additional Latin letters.
+ (line 56)
+* idx file: \index. (line 106)
+* ij letter, Dutch: Additional Latin letters.
+ (line 32)
+* implementations of TeX: TeX engines. (line 6)
+* importing graphics: \includegraphics. (line 6)
* in: Units of length. (line 17)
+* in-line formulas: math. (line 6)
* inch: Units of length. (line 17)
+* including graphics: \includegraphics. (line 6)
+* indent, forcing: \indent & \noindent. (line 6)
+* indentation of paragraphs, in minipage: minipage. (line 104)
+* indentfirst package: \part. (line 50)
+* indentfirst package <1>: \chapter. (line 58)
+* indentfirst package <2>: \section. (line 60)
+* indentfirst package <3>: \subsection. (line 48)
+* indentfirst package <4>: \subsubsection & \paragraph & \subparagraph.
+ (line 61)
+* indentfirst package <5>: \indent & \noindent. (line 48)
+* indent_length: makeindex. (line 138)
+* indent_space: makeindex. (line 134)
+* index entries, 'see' and 'see also': \index. (line 56)
+* index entry: \index. (line 6)
+* index package: \index. (line 101)
+* index, page range: \index. (line 40)
+* index, printing: \printindex. (line 6)
+* index, processing: makeindex. (line 6)
+* index, style file: makeindex. (line 18)
+* indexes: Indexes. (line 6)
+* infinite horizontal stretch: \hfill. (line 6)
+* infinite vertical stretch: \vfill. (line 6)
+* inner paragraph mode: Modes. (line 47)
+* input file: Splitting the input. (line 6)
+* input, on command line: Command line input. (line 6)
+* input/output, to terminal: Terminal input/output.
+ (line 6)
+* inserting figures: figure. (line 6)
+* insertions of special characters: Special insertions. (line 6)
+* internal vertical mode: Modes. (line 38)
+* italic correction: \/. (line 6)
+* italic font: Font styles. (line 81)
* itemize environment: itemize. (line 6)
+* item_0: makeindex. (line 81)
+* item_01: makeindex. (line 90)
+* item_1: makeindex. (line 84)
+* item_12: makeindex. (line 100)
+* item_2: makeindex. (line 87)
+* item_x1: makeindex. (line 94)
+* item_x2: makeindex. (line 104)
+* JPEG files: Graphics package configuration.
+ (line 6)
+* JPEG files <1>: \includegraphics. (line 6)
+* JPG files: Graphics package configuration.
+ (line 6)
+* JPG files <1>: \includegraphics. (line 6)
+* justification, ragged left: \raggedleft. (line 6)
+* justification, ragged right: \raggedright. (line 6)
+* Knuth, Donald E.: Overview. (line 6)
+* label: Cross references. (line 6)
+* labelled lists, creating: description. (line 6)
+* Lamport TeX: Overview. (line 24)
+* Lamport, Leslie: Overview. (line 6)
* landscape option: Document class options.
(line 49)
+* landscape orientation: Document class options.
+ (line 60)
* latex command: Output files. (line 10)
+* LaTeX logo: Text symbols. (line 22)
+* LaTeX overview: Overview. (line 6)
+* LaTeX Project team: About this document. (line 17)
+* LaTeX vs. LaTeX2e: About this document. (line 13)
* latex-doc-ptr document: About this document. (line 30)
+* LaTeX2e logo: Text symbols. (line 25)
* <latexrefman@tug.org> email address: About this document. (line 17)
+* Latin letters, additional: Additional Latin letters.
+ (line 6)
+* layout commands: Layout. (line 6)
+* layout, page parameters for: Page layout parameters.
+ (line 6)
+* left angle quotation marks: Text symbols. (line 31)
+* left arrow, in text: Text symbols. (line 140)
+* left brace, in text: Text symbols. (line 87)
+* left quote: Text symbols. (line 41)
+* left quote, double: Text symbols. (line 153)
+* left quote, single: Text symbols. (line 159)
+* left-hand equation numbers: Document class options.
+ (line 63)
+* left-justifying text: \raggedright. (line 6)
+* left-justifying text, environment for: flushleft. (line 6)
+* left-to-right mode: Modes. (line 16)
* legalpaper option: Document class options.
(line 19)
+* lengths, adding to: \addtolength. (line 6)
+* lengths, allocating new: \newlength. (line 6)
+* lengths, defining and using: Lengths. (line 6)
+* lengths, setting: \setlength. (line 6)
* leqno option: Document class options.
(line 49)
+* less than symbol, in text: Text symbols. (line 137)
+* lethead_flag: makeindex. (line 64)
+* lethead_prefix: makeindex. (line 73)
+* lethead_suffix: makeindex. (line 77)
* letter class: Document classes. (line 11)
* letter environment: letter. (line 6)
* letterpaper option: Document class options.
(line 19)
+* letters, accented: Accents. (line 6)
+* letters, additional Latin: Additional Latin letters.
+ (line 6)
+* letters, ending: \closing. (line 6)
+* letters, starting: \opening. (line 6)
+* letters, writing: Letters. (line 6)
+* line break, forcing: \\. (line 6)
+* line breaking: Line breaking. (line 6)
+* line breaks, changing: \fussy & \sloppy. (line 6)
+* line breaks, forcing: \linebreak & \nolinebreak.
+ (line 6)
+* line breaks, multiplication discretionary: \*. (line 6)
+* line breaks, preventing: \linebreak & \nolinebreak.
+ (line 6)
+* lines in tables: tabular. (line 6)
+* line_max: makeindex. (line 130)
+* lining numerals: Font styles. (line 132)
+* lining text up in tables: tabular. (line 6)
+* lining text up using tab stops: tabbing. (line 6)
* list environment: list. (line 6)
-* lR box: picture. (line 71)
+* list items, specifying counter: \usecounter. (line 6)
+* list of figures file: Output files. (line 43)
+* list of tables file: Output files. (line 43)
+* listings package: tabbing. (line 146)
+* listings package <1>: verbatim. (line 31)
+* listings package <2>: \verb. (line 42)
+* lists of items: itemize. (line 6)
+* lists of items, generic: list. (line 6)
+* lists of items, numbered: enumerate. (line 6)
+* loading additional packages: Additional packages. (line 6)
+* log file: Output files. (line 28)
+* logo, LaTeX: Text symbols. (line 22)
+* logo, LaTeX2e: Text symbols. (line 25)
+* logo, TeX: Text symbols. (line 63)
+* long command: Class and package commands.
+ (line 23)
+* low-9 quotation marks, single and double: Text symbols. (line 53)
+* low-level font commands: Low-level font commands.
+ (line 6)
+* lowercase: Upper and lower case.
+ (line 6)
+* LR box: picture. (line 103)
+* LR mode: Modes. (line 16)
* lrbox: lrbox. (line 6)
* lshort document: About this document. (line 41)
-* lualatex command: TeX engines. (line 29)
+* ltugboat class: tugboat template. (line 6)
+* lualatex command: TeX engines. (line 30)
+* LuaTeX: TeX engines. (line 30)
+* m-width: Units of length. (line 38)
+* macro package, LaTeX as: Overview. (line 11)
+* macron accent: Accents. (line 34)
+* macron accent, math: Math accents. (line 14)
+* macros2e package: \makeatletter & \makeatother.
+ (line 39)
+* Madsen, Lars: eqnarray. (line 6)
+* make a box: \mbox & \makebox. (line 6)
+* makeindex: makeindex. (line 6)
+* makeindex program: makeindex. (line 6)
+* makeindex, style file: makeindex. (line 18)
+* making a title page: titlepage. (line 6)
+* making paragraphs: Making paragraphs. (line 6)
+* marginal notes: Marginal notes. (line 6)
+* masculine ordinal symbol: Text symbols. (line 144)
+* matching brackets: \left & \right. (line 6)
+* matching parentheses: \left & \right. (line 6)
+* math accents: Math accents. (line 6)
* math environment: math. (line 6)
* math environment <1>: Math formulas. (line 6)
+* math formulas: Math formulas. (line 6)
+* math functions: Math functions. (line 6)
+* math miscellany: Math miscellany. (line 6)
+* math mode: Modes. (line 26)
+* math mode, entering: Math formulas. (line 6)
+* math mode, spacing: Spacing in math mode.
+ (line 6)
+* math symbols: Math symbols. (line 6)
+* math, bold: Font styles. (line 128)
+* mathtools package: Math formulas. (line 86)
+* mathtools package <1>: Over- and Underlining.
+ (line 45)
+* MetaPost package: \line. (line 36)
+* mfirstuc package: Upper and lower case.
+ (line 45)
+* mhchem package: Subscripts & superscripts.
+ (line 62)
+* Millimeter: Units of length. (line 27)
* minipage environment: minipage. (line 6)
+* minipage, creating a: minipage. (line 6)
+* minted package: tabbing. (line 146)
+* minted package <1>: verbatim. (line 31)
+* minted package <2>: \verb. (line 42)
+* mirrors of CTAN: CTAN. (line 20)
* mm: Units of length. (line 27)
+* modes: Modes. (line 6)
+* monospace font: Font styles. (line 96)
+* moving arguments: \protect. (line 19)
+* mpfootnote counter: \footnote. (line 62)
* mu: Units of length. (line 49)
+* mu, math unit: Units of length. (line 49)
+* multicolumn text: \twocolumn. (line 6)
+* multilingual support: Accents. (line 6)
+* multind package: Indexes. (line 32)
+* multiplication, discretionary: \*. (line 6)
+* name: \newglossaryentry. (line 43)
+* NBSP: ~. (line 6)
+* nested \include, not allowed: \include & \includeonly.
+ (line 104)
+* new class commands: Class and package construction.
+ (line 6)
+* new command, check: Class and package commands.
+ (line 21)
+* new command, definition: Class and package commands.
+ (line 96)
+* new commands, defining: \newcommand & \renewcommand.
+ (line 6)
+* new commands, defining <1>: \providecommand. (line 6)
+* new line, output as input: \obeycr & \restorecr.
+ (line 6)
+* new line, starting: \\. (line 6)
+* new line, starting (paragraph mode): \newline. (line 6)
+* new page, starting: \newpage. (line 6)
+* non-English characters: Additional Latin letters.
+ (line 6)
+* notes in the margin: Marginal notes. (line 6)
* notitlepage option: Document class options.
(line 49)
+* null delimiter: \left & \right. (line 6)
+* numbered items, specifying counter: \usecounter. (line 6)
+* numerals, old-style: Font styles. (line 132)
+* oblique font: Font styles. (line 93)
+* oe ligature: Additional Latin letters.
+ (line 48)
+* ogonek: Accents. (line 71)
+* old-style numerals: Font styles. (line 132)
+* one-column output: \onecolumn. (line 6)
* onecolumn option: Document class options.
(line 78)
* oneside option: Document class options.
@@ -12778,307 +17018,1050 @@ Command Index
(line 78)
* openbib option: Document class options.
(line 49)
+* opening quote: Text symbols. (line 41)
* openright option: Document class options.
(line 78)
+* OpenType fonts: TeX engines. (line 6)
+* options, class: Class and package commands.
+ (line 66)
+* options, color package: Color package options.
+ (line 6)
+* options, command line: Command line options.
+ (line 6)
+* options, document class: Document class options.
+ (line 6)
+* options, document class <1>: Class and package structure.
+ (line 6)
+* options, global: Additional packages. (line 15)
+* options, graphics package: Graphics package options.
+ (line 6)
+* options, package: Class and package structure.
+ (line 6)
+* options, package <1>: Class and package commands.
+ (line 66)
+* ordinals, feminine and masculine: Text symbols. (line 144)
+* oslash: Additional Latin letters.
+ (line 44)
+* outer paragraph mode: Modes. (line 47)
+* overbar accent: Accents. (line 34)
+* overdot accent, math: Math accents. (line 26)
+* overlining: Over- and Underlining.
+ (line 6)
+* overview of LaTeX: Overview. (line 6)
+* package file layout: Class and package structure.
+ (line 6)
+* package options: Class and package structure.
+ (line 6)
+* package options <1>: Class and package commands.
+ (line 66)
+* package, algorithm2e: tabbing. (line 146)
+* package, amsfonts: Math formulas. (line 86)
+* package, amsmath: array. (line 55)
+* package, amsmath <1>: array. (line 66)
+* package, amsmath <2>: displaymath. (line 22)
+* package, amsmath <3>: equation. (line 20)
+* package, amsmath <4>: theorem. (line 28)
+* package, amsmath <5>: Math formulas. (line 86)
+* package, amsmath <6>: Dots. (line 37)
+* package, amsmath <7>: Math functions. (line 111)
+* package, amsmath <8>: Colon character & \colon.
+ (line 15)
+* package, amsmath <9>: Colon character & \colon.
+ (line 19)
+* package, amsthm: theorem. (line 28)
+* package, amsthm <1>: \rule. (line 18)
+* package, appendix: \appendix. (line 29)
+* package, array (package): array. (line 77)
+* package, Asymptote: \line. (line 36)
+* package, Asymptote <1>: \strut. (line 62)
+* package, Asymptote <2>: \mbox & \makebox. (line 73)
+* package, babel: \chapter. (line 71)
+* package, babel <1>: thebibliography. (line 53)
+* package, babel <2>: Accents. (line 6)
+* package, babel <3>: \today. (line 13)
+* package, babel <4>: Table of contents etc..
+ (line 80)
+* package, babel <5>: \index. (line 56)
+* package, bigfoot: Footnotes of footnotes.
+ (line 6)
+* package, bm: \boldmath & \unboldmath.
+ (line 32)
+* package, cleveref: Cross references. (line 38)
+* package, cleveref <1>: \ref. (line 29)
+* package, cleveref <2>: \footnotemark. (line 48)
+* package, cprotect: verbatim. (line 26)
+* package, cprotect <1>: \verb. (line 45)
+* package, datetime: \today. (line 27)
+* package, dcolumn: array. (line 77)
+* package, enumitem: list. (line 253)
+* package, envlab: \makelabels. (line 55)
+* package, etoolbox: Class and package commands.
+ (line 110)
+* package, eurosym: Text symbols. (line 125)
+* package, fancyhdr: Page styles. (line 12)
+* package, fancyhdr <1>: \pagestyle. (line 13)
+* package, fancyvrb: tabbing. (line 146)
+* package, fancyvrb <1>: verbatim. (line 37)
+* package, flafter: Floats. (line 82)
+* package, float: Floats. (line 52)
+* package, geometry: Document class options.
+ (line 40)
+* package, geometry <1>: Document class options.
+ (line 44)
+* package, hyperref: \footnotemark. (line 48)
+* package, hyperref <1>: \footnotemark. (line 57)
+* package, hyperref <2>: \pagenumbering. (line 45)
+* package, hyperref <3>: Command line input. (line 10)
+* package, indentfirst: \part. (line 50)
+* package, indentfirst <1>: \chapter. (line 58)
+* package, indentfirst <2>: \section. (line 60)
+* package, indentfirst <3>: \subsection. (line 48)
+* package, indentfirst <4>: \subsubsection & \paragraph & \subparagraph.
+ (line 61)
+* package, indentfirst <5>: \indent & \noindent. (line 48)
+* package, index: \index. (line 101)
+* package, listings: tabbing. (line 146)
+* package, listings <1>: verbatim. (line 31)
+* package, listings <2>: \verb. (line 42)
+* package, macros2e: \makeatletter & \makeatother.
+ (line 39)
+* package, mathtools: Math formulas. (line 86)
+* package, mathtools <1>: Over- and Underlining.
+ (line 45)
+* package, MetaPost: \line. (line 36)
+* package, mfirstuc: Upper and lower case.
+ (line 45)
+* package, mhchem: Subscripts & superscripts.
+ (line 62)
+* package, minted: tabbing. (line 146)
+* package, minted <1>: verbatim. (line 31)
+* package, minted <2>: \verb. (line 42)
+* package, multind: Indexes. (line 32)
+* package, pict2e: \line. (line 36)
+* package, polyglossia: Accents. (line 6)
+* package, polyglossia <1>: \today. (line 13)
+* package, polyglossia <2>: Table of contents etc..
+ (line 80)
+* package, polyglossia <3>: \index. (line 56)
+* package, PSTricks: \line. (line 36)
+* package, sagetex: Command line options.
+ (line 62)
+* package, setspace: Low-level font commands.
+ (line 118)
+* package, showidx: Indexes. (line 32)
+* package, siunitx: ~. (line 32)
+* package, symbols: Math symbols. (line 6)
+* package, textcase: Upper and lower case.
+ (line 42)
+* package, textcomp: Font styles. (line 132)
+* package, TikZ: \line. (line 36)
+* package, TikZ <1>: \strut. (line 62)
+* package, TikZ <2>: \mbox & \makebox. (line 72)
+* package, titlesec: \part. (line 54)
+* package, titlesec <1>: \chapter. (line 79)
+* package, titlesec <2>: \section. (line 64)
+* package, titlesec <3>: \subsection. (line 52)
+* package, titlesec <4>: \subsubsection & \paragraph & \subparagraph.
+ (line 65)
+* package, tocbibbind: Table of contents etc..
+ (line 91)
+* package, tocloft: Table of contents etc..
+ (line 91)
+* package, ulem: Over- and Underlining.
+ (line 15)
+* package, url: \verb. (line 38)
+* package, verbatimbox: verbatim. (line 37)
+* packages, loading additional: Additional packages. (line 6)
+* page break, forcing: \pagebreak & \nopagebreak.
+ (line 6)
+* page break, preventing: \pagebreak & \nopagebreak.
+ (line 6)
+* page breaking: Page breaking. (line 6)
+* page layout parameters: Page layout parameters.
+ (line 6)
+* page number, cross referencing: \pageref. (line 6)
+* page numbering style: \pagenumbering. (line 6)
+* page style, this page: \thispagestyle. (line 6)
+* page styles: Page styles. (line 6)
+* page, colored: Colored pages. (line 6)
+* page_precedence: makeindex. (line 143)
+* paired delimiters: \left & \right. (line 6)
+* paragraph: Sectioning. (line 6)
+* paragraph <1>: \subsubsection & \paragraph & \subparagraph.
+ (line 6)
+* paragraph indentation: \parindent & \parskip.
+ (line 6)
+* paragraph indentation, in minipage: minipage. (line 104)
+* paragraph indentations in quoted text: quotation & quote. (line 6)
+* paragraph indentations in quoted text, omitting: quotation & quote.
+ (line 6)
+* paragraph mode: Modes. (line 12)
+* paragraph mode <1>: \parbox. (line 6)
+* paragraph symbol: Text symbols. (line 45)
+* paragraph, ending: \par. (line 6)
+* paragraph, in a box: \parbox. (line 6)
+* paragraphs: Making paragraphs. (line 6)
+* parameters, for footnotes: \footnote. (line 34)
+* parameters, page layout: Page layout parameters.
+ (line 6)
+* part: Sectioning. (line 6)
+* part <1>: \part. (line 6)
* pc: Units of length. (line 14)
+* PDF graphic files: Graphics package configuration.
+ (line 6)
+* PDF graphic files <1>: \includegraphics. (line 6)
* pdflatex command: Output files. (line 20)
+* pdfTeX: Output files. (line 20)
+* pdfTeX engine: TeX engines. (line 13)
+* period, abbreviation-ending: \@. (line 6)
+* period, centered, in text: Text symbols. (line 147)
+* period, sentence-ending: \@. (line 6)
+* period, spacing after: \@. (line 6)
+* pica: Units of length. (line 14)
+* pict2e package: \line. (line 36)
+* pict2e package <1>: \line. (line 36)
* picture environment: picture. (line 6)
+* pictures, creating: picture. (line 6)
+* pilcrow: Text symbols. (line 45)
+* placement of floats: Floats. (line 31)
+* plural: \newglossaryentry. (line 51)
+* PNG files: Graphics package configuration.
+ (line 6)
+* PNG files <1>: \includegraphics. (line 6)
+* poetry, an environment for: verse. (line 6)
+* Point: Units of length. (line 10)
+* polish l: Additional Latin letters.
+ (line 36)
+* polyglossia package: Accents. (line 6)
+* polyglossia package <1>: \today. (line 13)
+* polyglossia package <2>: Table of contents etc..
+ (line 80)
+* polyglossia package <3>: \index. (line 56)
+* portrait orientation: Document class options.
+ (line 60)
+* position, in picture: picture. (line 77)
+* positional parameter: \newcommand & \renewcommand.
+ (line 52)
+* postamble: makeindex. (line 54)
+* postscript, in letters: \ps. (line 6)
+* pounds symbol: Text symbols. (line 49)
+* preamble: makeindex. (line 50)
+* preamble, defined: Starting and ending. (line 22)
+* prompt, *: Recovering from errors.
+ (line 23)
+* pronunciation: Overview. (line 24)
+* PSTricks package: \line. (line 36)
* pt: Units of length. (line 10)
-* quotation environment: quotation and quote. (line 6)
-* quote environment: quotation and quote. (line 6)
+* quad: Spacing in math mode.
+ (line 51)
+* question mark, upside-down: Text symbols. (line 150)
+* quotation environment: quotation & quote. (line 6)
+* quotation marks, French: Text symbols. (line 31)
+* quote environment: quotation & quote. (line 6)
+* quote, single straight: Text symbols. (line 165)
+* quote, straight base: Text symbols. (line 169)
+* quoted text with paragraph indentation, displaying: quotation & quote.
+ (line 6)
+* quoted text without paragraph indentation, displaying: quotation & quote.
+ (line 6)
+* radical: \sqrt. (line 6)
+* ragged left text: \raggedleft. (line 6)
+* ragged left text, environment for: flushright. (line 6)
+* ragged right text: \raggedright. (line 6)
+* ragged right text, environment for: flushleft. (line 6)
+* redefining environments: \newenvironment & \renewenvironment.
+ (line 6)
+* reference, forward: Cross references. (line 27)
+* references, resolving forward: Output files. (line 33)
+* registered symbol: Text symbols. (line 172)
+* relation, text above: \stackrel. (line 6)
+* remarks in the margin: Marginal notes. (line 6)
* report class: Document classes. (line 11)
-* secnumdepth counter: Sectioning. (line 47)
+* reporting bugs: About this document. (line 21)
+* reserved characters: Reserved characters. (line 6)
+* resizing: \scalebox. (line 6)
+* resizing <1>: \resizebox. (line 6)
+* right angle quotation marks: Text symbols. (line 31)
+* right arrow, in text: Text symbols. (line 175)
+* right brace, in text: Text symbols. (line 90)
+* right quote: Text symbols. (line 56)
+* right quote, double: Text symbols. (line 156)
+* right quote, single: Text symbols. (line 162)
+* right-hand equation numbers: Document class options.
+ (line 63)
+* right-justifying text: \raggedleft. (line 6)
+* right-justifying text, environment for: flushright. (line 6)
+* ring accent: Accents. (line 75)
+* ring accent, math: Math accents. (line 35)
+* robust commands: \protect. (line 6)
+* roman font: Font styles. (line 84)
+* root file: Splitting the input. (line 10)
+* roots: \sqrt. (line 6)
+* rotating graphics: \rotatebox. (line 6)
+* rotating text: \rotatebox. (line 6)
+* rotation: \rotatebox. (line 6)
+* row, tabbing: tabbing. (line 46)
+* rubber lengths, defining new: \newlength. (line 6)
+* running header and footer: Page layout parameters.
+ (line 6)
+* running header and footer style: \pagestyle. (line 6)
+* sagetex package: Command line options.
+ (line 62)
+* sans serif font: Font styles. (line 90)
+* Scaled point: Units of length. (line 36)
+* scaling: \scalebox. (line 6)
+* scaling <1>: \resizebox. (line 6)
+* script fonts: Calligraphic. (line 6)
+* script letters for math: Font styles. (line 78)
+* secnumdepth: Sectioning. (line 62)
+* secnumdepth counter: Sectioning. (line 63)
+* section: Sectioning. (line 6)
+* section <1>: \section. (line 6)
+* section number, cross referencing: \ref. (line 6)
+* section numbers, printing: Sectioning. (line 63)
+* section symbol: Text symbols. (line 60)
+* section, redefining: \@startsection. (line 6)
+* sectioning commands: Sectioning. (line 6)
+* sectioning, part: \part. (line 6)
+* series, of fonts: Low-level font commands.
+ (line 48)
+* setspace package: Low-level font commands.
+ (line 118)
+* setting counters: \setcounter. (line 6)
+* shapes, of fonts: Low-level font commands.
+ (line 88)
+* sharp S letters: Additional Latin letters.
+ (line 52)
+* showidx package: Indexes. (line 32)
+* simulating typed text: verbatim. (line 6)
+* single angle quotation marks: Text symbols. (line 31)
+* single guillemets: Text symbols. (line 31)
+* single left quote: Text symbols. (line 159)
+* single low-9 quotation mark: Text symbols. (line 53)
+* single quote, straight: Text symbols. (line 165)
+* single right quote: Text symbols. (line 162)
+* siunitx package: ~. (line 32)
+* sizes of text: Font sizes. (line 6)
+* skip register, plain TeX: \newlength. (line 6)
+* slanted font: Font styles. (line 93)
* slides class: Document classes. (line 11)
+* sloppypar: sloppypar. (line 6)
+* sloppypar environment: sloppypar. (line 6)
+* small caps font: Font styles. (line 87)
+* sort: \newglossaryentry. (line 55)
* sp: Units of length. (line 36)
+* space, hard: ~. (line 6)
+* space, inserting horizontal: \hss. (line 6)
+* space, inserting vertical: \addvspace. (line 6)
+* space, negative thin: \thinspace & \negthinspace.
+ (line 6)
+* space, thin: \thinspace & \negthinspace.
+ (line 6)
+* space, unbreakable: ~. (line 6)
+* space, vertical: \vspace. (line 6)
+* spaces: Spaces. (line 6)
+* spaces, ignore around commands: \ignorespaces & \ignorespacesafterend.
+ (line 6)
+* spacing within math mode: Spacing in math mode.
+ (line 6)
+* spacing, inter-sentence: \frenchspacing. (line 6)
+* spacing, inter-sentence <1>: \normalsfcodes. (line 6)
+* Spanish ordinals, feminine and masculine: Text symbols. (line 144)
+* special characters: Reserved characters. (line 6)
+* special characters <1>: Additional Latin letters.
+ (line 6)
+* special insertions: Special insertions. (line 6)
+* specifier, float placement: Floats. (line 31)
+* splitting the input file: Splitting the input. (line 6)
+* square root: \sqrt. (line 6)
+* stack math: \stackrel. (line 6)
+* star-variants, commands: \@ifstar. (line 6)
+* starred form, defining new commands: \newcommand & \renewcommand.
+ (line 25)
+* starting a new page: \newpage. (line 6)
+* starting a new page and clearing floats: \clearpage & \cleardoublepage.
+ (line 6)
+* starting and ending: Starting and ending. (line 6)
+* starting on a right-hand page: \clearpage & \cleardoublepage.
+ (line 6)
+* sterling symbol: Text symbols. (line 49)
+* straight double quote, base: Text symbols. (line 169)
+* straight quote, base: Text symbols. (line 169)
+* straight single quote: Text symbols. (line 165)
+* stretch, infinite horizontal: \hfill. (line 6)
+* stretch, infinite vertical: \vfill. (line 6)
+* stretch, omitting vertical: \raggedbottom. (line 6)
+* strut: \strut. (line 6)
+* styles of text: Font styles. (line 6)
+* styles, page: Page styles. (line 6)
+* subparagraph: Sectioning. (line 6)
+* subparagraph <1>: \subsubsection & \paragraph & \subparagraph.
+ (line 6)
+* subscript: Subscripts & superscripts.
+ (line 6)
+* subsection: Sectioning. (line 6)
+* subsection <1>: \subsection. (line 6)
+* subsubsection: \subsubsection & \paragraph & \subparagraph.
+ (line 6)
+* superscript: Subscripts & superscripts.
+ (line 6)
+* symbol: \newglossaryentry. (line 59)
+* symbols package: Math symbols. (line 6)
+* symbols, boldface: \boldmath & \unboldmath.
+ (line 6)
+* symbols, math: Math symbols. (line 6)
+* symbols, text: Text symbols. (line 6)
+* tab stops, using: tabbing. (line 6)
* tabbing environment: tabbing. (line 6)
* table environment: table. (line 6)
+* table of contents entry, manually adding: \addcontentsline. (line 6)
+* table of contents file: Output files. (line 43)
+* table of contents, avoiding footnotes: Footnotes in section headings.
+ (line 6)
+* table of contents, creating: Table of contents etc..
+ (line 6)
+* table of contents, sectioning numbers printed: Sectioning. (line 74)
+* tables, creating: table. (line 6)
* tabular environment: tabular. (line 6)
-* textcomp package: Text symbols. (line 6)
+* template, article: article template. (line 6)
+* template, beamer: beamer template. (line 6)
+* template, book: book template. (line 6)
+* template, book <1>: Larger book template.
+ (line 6)
+* template, TUGboat: tugboat template. (line 6)
+* templates, document: Document templates. (line 6)
+* terminal input/output: Terminal input/output.
+ (line 6)
+* TeX logo: Text symbols. (line 63)
+* text symbols: Text symbols. (line 6)
+* text, resizing: \scalebox. (line 6)
+* text, resizing <1>: \resizebox. (line 6)
+* text, scaling: \scalebox. (line 6)
+* text, scaling <1>: \resizebox. (line 6)
+* textcase package: Upper and lower case.
+ (line 42)
+* textcomp package: Font styles. (line 132)
+* textcomp package <1>: Text symbols. (line 6)
+* thanks, for titlepage: \maketitle. (line 57)
* thebibliography environment: thebibliography. (line 6)
* theorem environment: theorem. (line 6)
+* theorem-like environment: \newtheorem. (line 6)
+* theorems, defining: \newtheorem. (line 6)
+* theorems, typesetting: theorem. (line 6)
+* thin space: Spacing in math mode.
+ (line 32)
+* thin space <1>: \thinspace & \negthinspace.
+ (line 6)
+* thin space, negative: Spacing in math mode.
+ (line 46)
+* thin space, negative <1>: \thinspace & \negthinspace.
+ (line 6)
+* thorn, Icelandic letter: Additional Latin letters.
+ (line 56)
+* three-quarters em-dash: Text symbols. (line 178)
+* tie: ~. (line 6)
+* tie-after accent: Accents. (line 81)
+* TikZ package: \line. (line 36)
+* TikZ package <1>: \strut. (line 62)
+* TikZ package <2>: \mbox & \makebox. (line 72)
+* tilde accent: Accents. (line 46)
+* tilde accent, math: Math accents. (line 38)
+* tilde, ASCII, in text: Text symbols. (line 69)
+* title page, separate or run-in: Document class options.
+ (line 71)
+* title pages, creating: titlepage. (line 6)
+* title, for titlepage: \maketitle. (line 64)
* titlepage environment: titlepage. (line 6)
* titlepage option: Document class options.
(line 49)
+* titles, making: \maketitle. (line 6)
+* titlesec package: \part. (line 54)
+* titlesec package <1>: \chapter. (line 79)
+* titlesec package <2>: \section. (line 64)
+* titlesec package <3>: \subsection. (line 52)
+* titlesec package <4>: \subsubsection & \paragraph & \subparagraph.
+ (line 65)
+* tocbibbind package: Table of contents etc..
+ (line 91)
+* tocdepth: Sectioning. (line 73)
+* tocdepth counter: Sectioning. (line 74)
+* tocloft package: Table of contents etc..
+ (line 91)
+* today's date: \today. (line 6)
+* tombstone: \rule. (line 13)
* topmargin: Page layout parameters.
- (line 124)
+ (line 125)
* topnumber: Floats. (line 138)
* topnumber <1>: Floats. (line 139)
* totalnumber: Floats. (line 142)
* totalnumber <1>: Floats. (line 143)
+* trademark symbol: Text symbols. (line 181)
+* transcript file: Output files. (line 28)
+* TrueType fonts: TeX engines. (line 6)
+* TUGboat template: tugboat template. (line 6)
+* two-column output: \twocolumn. (line 6)
+* two-thirds em-dash: Text symbols. (line 184)
* twocolumn option: Document class options.
(line 78)
* twoside option: Document class options.
(line 78)
+* type styles: Font styles. (line 6)
+* typed text, simulating: verbatim. (line 6)
+* typeface sizes: Font sizes. (line 6)
+* typefaces: Fonts. (line 6)
+* typewriter font: Font styles. (line 96)
+* typewriter labels in lists: description. (line 36)
+* ulem package: Over- and Underlining.
+ (line 15)
+* umlaut accent: Accents. (line 23)
+* underbar: Accents. (line 51)
+* underlining: Over- and Underlining.
+ (line 6)
+* underscore, in text: Text symbols. (line 187)
+* Unicode input, native: TeX engines. (line 6)
+* units, of length: Units of length. (line 6)
+* unofficial nature of this manual: About this document. (line 17)
+* unordered lists: itemize. (line 6)
+* uppercase: Upper and lower case.
+ (line 6)
+* url package: \verb. (line 38)
+* using BibTeX: Using BibTeX. (line 6)
* usrguide official documentation: About this document. (line 36)
+* UTF-8: TeX engines. (line 6)
+* variables, a list of: Counters. (line 6)
+* vector symbol, math: Math accents. (line 41)
* verbatim environment: verbatim. (line 6)
+* verbatim text: verbatim. (line 6)
+* verbatim text, inline: \verb. (line 6)
+* verbatimbox package: verbatim. (line 37)
* verse environment: verse. (line 6)
+* vertical bar, double, in text: Text symbols. (line 81)
+* vertical bar, in text: Text symbols. (line 78)
+* vertical mode: Modes. (line 34)
+* vertical space: \vspace. (line 6)
+* vertical space <1>: \addvspace. (line 6)
+* vertical space before paragraphs: \parindent & \parskip.
+ (line 6)
+* visible space: \verb. (line 31)
+* visible space symbol, in text: Text symbols. (line 190)
+* weights, of fonts: Low-level font commands.
+ (line 58)
+* white space: Spaces. (line 6)
+* wide hat accent, math: Math accents. (line 44)
+* wide tilde accent, math: Math accents. (line 47)
+* widths, of fonts: Low-level font commands.
+ (line 70)
+* writing external files: filecontents. (line 6)
+* writing letters: Letters. (line 6)
+* x-height: Units of length. (line 38)
* xdvi command: Output files. (line 10)
-* xdvipdfmx: TeX engines. (line 38)
-* xelatex command: TeX engines. (line 38)
+* xdvipdfmx: TeX engines. (line 39)
+* xelatex command: TeX engines. (line 39)
+* XeTeX: TeX engines. (line 39)
+* xindy: makeindex. (line 153)
+* xindy program: makeindex. (line 153)

Tag Table:
-Node: Top1702
-Node: About this document3580
-Node: Overview5440
-Node: Starting and ending6940
-Ref: Starting & ending7075
-Node: Output files8061
-Node: TeX engines10307
-Node: LaTeX command syntax12745
-Node: Environment14579
-Node: Declaration15652
-Node: \makeatletter and \makeatother16038
-Node: \@ifstar18231
-Node: Document classes21060
-Node: Document class options22383
-Node: Additional packages25482
-Node: Class and package construction26113
-Node: Class and package structure27565
-Node: Class and package commands29859
-Node: Fonts47384
-Ref: Typefaces47487
-Node: Font styles47815
-Node: Font sizes52243
-Node: Low-level font commands53474
-Node: Layout58581
-Node: \onecolumn59079
-Node: \twocolumn59410
-Node: \flushbottom63805
-Node: \raggedbottom64905
-Node: Page layout parameters65441
-Node: Floats71139
-Node: Sectioning77604
-Ref: Sectioning/secnumdepth78925
-Node: \@startsection79335
-Ref: \@startsection/name80607
-Ref: \@startsection/level81067
-Ref: \@startsection/indent82138
-Ref: \@startsection/beforeskip82401
-Ref: \@startsection/afterskip83922
-Ref: \@startsection/style85233
-Node: Cross references89069
-Node: \label90935
-Node: \pageref92482
-Node: \ref93152
-Node: Environments93841
-Node: abstract95844
-Node: array97433
-Node: center99691
-Node: \centering101332
-Node: description102704
-Node: displaymath104891
-Node: document106669
-Node: \AtBeginDocument107099
-Node: \AtEndDocument107723
-Node: enumerate108367
-Node: eqnarray111164
-Node: equation113218
-Node: figure113888
-Node: filecontents115700
-Node: flushleft117453
-Node: \raggedright117946
-Node: flushright118505
-Node: \raggedleft119003
-Node: itemize119560
-Node: letter123061
-Node: list123299
-Node: \item135965
-Node: trivlist137218
-Node: math138746
-Node: minipage139052
-Node: picture140244
-Node: \circle144539
-Node: \makebox (picture)144882
-Node: \framebox (picture)145588
-Node: \dashbox146078
-Node: \frame146601
-Node: \line146927
-Node: \linethickness147385
-Node: \thicklines147806
-Node: \thinlines148116
-Node: \multiput148418
-Node: \oval148785
-Node: \put149506
-Node: \shortstack149797
-Node: \vector150271
-Node: quotation and quote150585
-Node: tabbing151792
-Node: table157730
-Node: tabular159157
-Node: \multicolumn166365
-Node: \vline170250
-Node: \cline171595
-Node: \hline172279
-Node: thebibliography172962
-Node: \bibitem174576
-Node: \cite175334
-Node: \nocite175853
-Node: Using BibTeX176141
-Node: theorem177650
-Node: titlepage178036
-Node: verbatim179326
-Node: \verb179965
-Node: verse180515
-Node: Line breaking181009
-Node: \\182106
-Node: \obeycr & \restorecr183144
-Node: \newline183546
-Node: \- (hyphenation)184380
-Node: \discretionary184995
-Node: \fussy185287
-Node: \sloppy185677
-Node: \hyphenation186004
-Node: \linebreak & \nolinebreak186629
-Node: Page breaking187281
-Node: \cleardoublepage187889
-Node: \clearpage188318
-Node: \newpage188615
-Node: \enlargethispage188846
-Node: \pagebreak & \nopagebreak189373
-Node: Footnotes190067
-Node: \footnote191321
-Node: \footnotemark193117
-Node: \footnotetext194361
-Node: Footnotes in a table194851
-Node: Footnotes in section headings196708
-Node: Footnotes of footnotes197564
-Node: Multiple reference to footnotes198331
-Node: Footnote parameters199189
-Node: Definitions199939
-Node: \newcommand & \renewcommand200816
-Node: \providecommand204652
-Node: \newcounter205313
-Node: \newlength206284
-Node: \newsavebox206931
-Node: \newenvironment & \renewenvironment207542
-Node: \newtheorem211902
-Node: \newfont215391
-Node: \protect216956
-Node: \ignorespaces & \ignorespacesafterend219342
-Node: Counters222091
-Node: \alph \Alph \arabic \roman \Roman \fnsymbol223691
-Node: \usecounter225763
-Node: \value226595
-Node: \setcounter227538
-Node: \addtocounter228024
-Node: \refstepcounter228489
-Node: \stepcounter229147
-Node: \day \month \year229489
-Node: Lengths230034
-Node: Units of length231824
-Node: \setlength233318
-Node: \addtolength233722
-Node: \settodepth234040
-Node: \settoheight234331
-Node: \settowidth234628
-Node: Predefined lengths234936
-Node: Making paragraphs235451
-Node: \indent236023
-Node: \noindent236485
-Node: \parskip236994
-Node: Marginal notes237252
-Node: Math formulas239064
-Node: Subscripts & superscripts240848
-Node: Math symbols242186
-Node: Math functions267515
-Node: Math accents268458
-Node: Spacing in math mode269430
-Node: Math miscellany270897
-Node: Modes273447
-Node: \ensuremath275287
-Node: Page styles276203
-Node: \maketitle276697
-Node: \pagenumbering277767
-Node: \pagestyle278263
-Node: \thispagestyle279404
-Node: Spaces279710
-Node: \hspace280580
-Node: \hfill281535
-Node: \spacefactor281927
-Node: \(SPACE) and \@284639
-Ref: \AT284782
-Node: \frenchspacing286259
-Node: \normalsfcodes286875
-Node: \(SPACE) after control sequence287064
-Node: \thinspace287975
-Node: \/288295
-Node: \hrulefill \dotfill289477
-Node: \addvspace290470
-Node: \bigskip \medskip \smallskip291516
-Node: \vfill292408
-Node: \vspace293277
-Node: Boxes294270
-Node: \mbox294982
-Node: \fbox and \framebox295269
-Node: lrbox296073
-Node: \makebox296431
-Node: \parbox297151
-Node: \raisebox298719
-Node: \savebox299316
-Node: \sbox299731
-Node: \usebox300180
-Node: Color300441
-Node: Color package options301285
-Node: Color models302927
-Node: Commands for color305236
-Node: Define colors305651
-Node: Colored text306366
-Node: Colored boxes308741
-Node: Colored pages310180
-Node: Graphics310873
-Node: Graphics package options312992
-Node: Graphics package configuration315744
-Node: \graphicspath316531
-Node: \DeclareGraphicsExtensions319454
-Node: \DeclareGraphicsRule321247
-Node: Commands for graphics324436
-Node: \includegraphics324941
-Node: \rotatebox337967
-Node: \scalebox340762
-Node: \resizebox341814
-Node: Special insertions343006
-Node: Reserved characters343810
-Node: Upper and lower case345011
-Node: Symbols by font position346926
-Node: Text symbols347546
-Node: Accents350994
-Node: Additional Latin letters353536
-Ref: Non-English characters353707
-Node: \rule354724
-Node: \today355153
-Node: Splitting the input355907
-Node: \include356671
-Node: \includeonly357262
-Node: \input357775
-Node: Front/back matter358270
-Node: Tables of contents358475
-Node: \addcontentsline359536
-Node: \addtocontents360554
-Node: Glossaries361087
-Node: Indexes361606
-Node: Letters363239
-Node: \address366917
-Node: \cc367787
-Node: \closing368205
-Node: \encl368516
-Node: \location368931
-Node: \makelabels369200
-Node: \name370201
-Node: \opening370431
-Node: \ps370771
-Node: \signature371060
-Node: \telephone372152
-Node: Terminal input/output372517
-Node: \typein372782
-Node: \typeout373367
-Node: Command line373990
-Node: Document templates374942
-Node: beamer template375349
-Node: book template376000
-Node: tugboat template376368
-Node: Concept Index378732
-Node: Command Index441503
+Node: Top1701
+Node: About this document3519
+Node: Overview5371
+Node: Starting and ending6920
+Ref: Starting & ending7055
+Node: Output files8232
+Ref: output files dvi8511
+Ref: output files pdf9022
+Ref: output files log9345
+Ref: output files aux9542
+Node: TeX engines10511
+Ref: tex engines latex10860
+Ref: tex engines lualatex11692
+Ref: tex engines xelatex12177
+Node: LaTeX command syntax12981
+Node: Environment14824
+Node: Declaration15893
+Node: \makeatletter & \makeatother16277
+Node: \@ifstar18429
+Node: CTAN21214
+Node: Document classes22616
+Ref: document classes article23056
+Ref: document classes book23144
+Ref: document classes letter23329
+Ref: document classes report23405
+Ref: document classes slides23557
+Node: Document class options23939
+Node: Additional packages27021
+Node: Class and package construction27652
+Node: Class and package structure29102
+Node: Class and package commands31393
+Node: Fonts49007
+Ref: Typefaces49110
+Node: Font styles49438
+Node: Font sizes53703
+Node: Low-level font commands55322
+Ref: low level font commands fontencoding55606
+Ref: low level font commands fontfamily56162
+Ref: low level font commands fontseries56927
+Ref: low level font commands fontshape58079
+Ref: low level font commands fontsize58376
+Ref: low level font commands baselinestretch58901
+Ref: low level font commands linespread59610
+Ref: low level font commands selectfont59860
+Ref: low level font commands usefont60186
+Node: Layout60429
+Node: \onecolumn60927
+Node: \twocolumn61286
+Ref: twocolumn columnsep61909
+Ref: twocolumn columnseprule62158
+Ref: twocolumn columnwidth62454
+Ref: twocolumn dbltopfraction63020
+Ref: twocolumn dblfloatpagefraction63963
+Ref: twocolumn dblfloatsep64210
+Ref: twocolumn dbltextfloatsep64515
+Ref: twocolumn dbltopnumber64698
+Node: \flushbottom65663
+Node: \raggedbottom66763
+Node: Page layout parameters67299
+Ref: page layout parameters columnsep67502
+Ref: page layout parameters columnseprule67502
+Ref: page layout parameters columnwidth67502
+Ref: page layout parameters headheight67756
+Ref: page layout parameters headsep67923
+Ref: page layout parameters footskip68236
+Ref: page layout parameters linewidth68570
+Ref: page layout parameters marginparpush68923
+Ref: page layout parameters marginsep68923
+Ref: page layout parameters marginparwidth68923
+Ref: page layout parameters oddsidemargin69963
+Ref: page layout parameters evensidemargin69963
+Ref: page layout parameters paperheight70500
+Ref: page layout parameters paperwidth70726
+Ref: page layout parameters textheight70950
+Ref: page layout parameters textwidth71339
+Ref: page layout parameters hsize72268
+Ref: page layout parameters topmargin72474
+Ref: page layout parameters topskip72778
+Node: Floats72994
+Ref: floats bottomfraction77362
+Ref: floats floatpagefraction77489
+Ref: floats textfraction77600
+Ref: floats topfraction77802
+Ref: floats floatsep78054
+Ref: floats intextsep78164
+Ref: floats textfloatsep78379
+Ref: floats bottomnumber78643
+Ref: floats dbltopnumber78751
+Ref: floats topnumber78870
+Ref: floats totalnumber78974
+Node: Sectioning79503
+Ref: sectioning secnumdepth82236
+Ref: Sectioning/secnumdepth82236
+Ref: sectioning tocdepth82837
+Ref: Sectioning/tocdepth82837
+Node: \part83882
+Node: \chapter86058
+Node: \section89832
+Node: \subsection93099
+Node: \subsubsection & \paragraph & \subparagraph95813
+Node: \appendix98470
+Node: \frontmatter & \mainmatter & \backmatter99760
+Node: \@startsection101101
+Ref: startsection name102478
+Ref: \@startsection/name102478
+Ref: startsection level102932
+Ref: \@startsection/level102932
+Ref: startsection indent103812
+Ref: \@startsection/indent103812
+Ref: startsection beforeskip104075
+Ref: \@startsection/beforeskip104075
+Ref: startsection afterskip105596
+Ref: \@startsection/afterskip105596
+Ref: startsection style106907
+Ref: \@startsection/style106907
+Node: Cross references110613
+Node: \label112706
+Node: \pageref114526
+Node: \ref115316
+Node: Environments116292
+Node: abstract118294
+Node: array119883
+Node: center122775
+Node: \centering124527
+Node: description126024
+Node: displaymath128239
+Node: document130026
+Node: \AtBeginDocument130456
+Node: \AtEndDocument131080
+Node: enumerate131724
+Ref: enumerate enumi133587
+Ref: enumerate enumii133587
+Ref: enumerate enumiii133587
+Ref: enumerate enumiv133587
+Ref: enumerate labelenumi133985
+Ref: enumerate labelenumii133985
+Ref: enumerate labelenumiii133985
+Ref: enumerate labelenumiv133985
+Node: eqnarray134524
+Node: equation136519
+Node: figure137187
+Node: filecontents139341
+Node: flushleft141088
+Node: \raggedright142105
+Node: flushright143303
+Node: \raggedleft144039
+Node: itemize144829
+Ref: itemize labelitemi146051
+Ref: itemize labelitemii146051
+Ref: itemize labelitemiii146051
+Ref: itemize labelitemiv146051
+Ref: itemize leftmargin146893
+Ref: itemize leftmargini146893
+Ref: itemize leftmarginii146893
+Ref: itemize leftmarginiii146893
+Ref: itemize leftmarginiv146893
+Ref: itemize leftmarginv146893
+Ref: itemize leftmarginvi146893
+Node: letter148297
+Node: list148535
+Ref: list makelabel150980
+Ref: list itemindent152364
+Ref: list itemsep152501
+Ref: list labelsep153153
+Ref: list labelwidth153316
+Ref: list leftmargin154327
+Ref: list listparindent155180
+Ref: list parsep155411
+Ref: list partopsep155914
+Ref: list rightmargin156712
+Ref: list topsep156897
+Ref: list beginparpenalty160472
+Ref: list itempenalty160571
+Ref: list endparpenalty160675
+Node: \item161547
+Node: trivlist162798
+Node: math164326
+Node: minipage164632
+Node: picture169910
+Node: \put176379
+Node: \multiput176944
+Node: \qbezier177683
+Node: \graphpaper178608
+Node: \line179402
+Node: \linethickness181366
+Node: \thinlines181815
+Node: \thicklines182226
+Node: \circle182610
+Node: \oval183150
+Node: \shortstack184126
+Node: \vector185523
+Node: \makebox (picture)186439
+Node: \framebox (picture)187621
+Node: \frame189094
+Node: \dashbox189534
+Node: quotation & quote190669
+Node: tabbing191565
+Node: table197558
+Node: tabular199651
+Ref: tabular arrayrulewidth205995
+Ref: tabular arraystrech206235
+Ref: tabular doublerulesep206456
+Ref: tabular tabcolsep206592
+Node: \multicolumn207113
+Node: \vline210972
+Node: \cline212363
+Node: \hline213073
+Node: thebibliography213755
+Node: \bibitem216165
+Node: \cite218440
+Node: \nocite220090
+Node: Using BibTeX220574
+Node: theorem222729
+Node: titlepage223651
+Node: verbatim224934
+Node: \verb226444
+Node: verse228264
+Node: Line breaking229491
+Node: \\230857
+Node: \obeycr & \restorecr233290
+Node: \newline234084
+Node: \- (hyphenation)235113
+Node: \discretionary236751
+Node: \fussy & \sloppy237639
+Node: sloppypar238422
+Node: \hyphenation239568
+Node: \linebreak & \nolinebreak240162
+Node: Page breaking241309
+Node: \clearpage & \cleardoublepage243338
+Node: \newpage244858
+Node: \enlargethispage246156
+Node: \pagebreak & \nopagebreak247112
+Node: Footnotes248778
+Node: \footnote249924
+Ref: footnote footnoterule251192
+Ref: footnote footnotesep251803
+Node: \footnotemark252869
+Node: \footnotetext255208
+Node: Footnotes in section headings255809
+Node: Footnotes in a table256642
+Node: Footnotes of footnotes259564
+Node: Definitions260268
+Node: \newcommand & \renewcommand261145
+Node: \providecommand266375
+Node: \newcounter267521
+Node: \newlength269248
+Node: \newsavebox270070
+Node: \newenvironment & \renewenvironment270986
+Node: \newtheorem276310
+Node: \newfont279882
+Node: \protect281118
+Node: \ignorespaces & \ignorespacesafterend283504
+Node: Counters286242
+Node: \alph \Alph \arabic \roman \Roman \fnsymbol287943
+Node: \usecounter290597
+Node: \value291456
+Node: \setcounter292509
+Node: \addtocounter293105
+Node: \refstepcounter293559
+Node: \stepcounter294228
+Node: \day & \month & \year294774
+Node: Lengths295585
+Node: Units of length299938
+Ref: units of length pt300141
+Ref: units of length pc300263
+Ref: units of length in300286
+Ref: units of length bp300312
+Ref: units of length cm300443
+Ref: units of length mm300465
+Ref: units of length dd300487
+Ref: units of length cc300519
+Ref: units of length sp300544
+Ref: Lengths/em300575
+Ref: Lengths/en300575
+Ref: Lengths/ex300575
+Ref: units of length em300575
+Ref: units of length en300575
+Ref: units of length ex300575
+Node: \setlength301431
+Node: \addtolength302208
+Node: \settodepth303170
+Node: \settoheight303960
+Node: \settowidth304754
+Node: Making paragraphs305533
+Node: \par307182
+Node: \indent & \noindent309027
+Node: \parindent & \parskip310561
+Node: Marginal notes311596
+Ref: marginal notes marginparpush312996
+Ref: marginal notes marginparsep313109
+Ref: marginal notes marginparwidth313241
+Node: Math formulas313590
+Node: Subscripts & superscripts317758
+Node: Math symbols319916
+Node: Blackboard bold346083
+Node: Calligraphic346855
+Node: \boldmath & \unboldmath347427
+Node: Dots348941
+Ref: ellipses cdots349363
+Ref: ellipses ddots349510
+Ref: ellipses ldots349599
+Ref: ellipses vdots350020
+Node: Math functions351206
+Node: Math accents352850
+Node: Over- and Underlining353749
+Node: Spacing in math mode355576
+Ref: spacing in math mode thickspace356508
+Ref: spacing in math mode medspace356600
+Ref: Spacing in math mode/\thinspace356696
+Ref: spacing in math mode thinspace356696
+Ref: spacing in math mode negthinspace357177
+Ref: spacing in math mode quad357375
+Ref: spacing in math mode qquad357631
+Node: Math miscellany357729
+Node: Colon character & \colon358288
+Node: \*358981
+Node: \frac359565
+Node: \left & \right359945
+Node: \sqrt361119
+Node: \stackrel361714
+Node: Modes361987
+Ref: modes paragraph mode362437
+Ref: modes lr mode362633
+Ref: modes math mode363239
+Ref: modes vertical mode363574
+Ref: modes internal vertical mode363745
+Ref: modes inner paragraph mode364218
+Ref: modes outer paragraph mode364218
+Node: \ensuremath364634
+Node: Page styles365339
+Node: \maketitle366102
+Node: \pagenumbering369112
+Node: \pagestyle371100
+Node: \thispagestyle374602
+Node: Spaces375559
+Node: \enspace & \quad & \qquad377000
+Node: \hspace377914
+Node: \hfill379752
+Node: \hss380816
+Node: \spacefactor381510
+Node: \@384897
+Ref: \AT384997
+Node: \frenchspacing386937
+Node: \normalsfcodes387772
+Node: \(SPACE)388019
+Node: ~389654
+Node: \thinspace & \negthinspace392124
+Node: \/393067
+Node: \hrulefill & \dotfill394373
+Node: \bigskip & \medskip & \smallskip395729
+Ref: bigskip396547
+Ref: medskip396751
+Ref: smallskip396960
+Node: \bigbreak & \medbreak & \smallbreak397621
+Node: \strut398607
+Node: \vspace401801
+Node: \vfill403364
+Node: \addvspace404292
+Node: Boxes406290
+Node: \mbox & \makebox406996
+Ref: mbox makebox depth408211
+Ref: mbox makebox height408211
+Ref: mbox makebox width408211
+Ref: mbox makebox totalheight408211
+Node: \fbox & \framebox410305
+Ref: fbox framebox fboxrule411618
+Ref: fbox framebox fboxsep411808
+Node: \parbox412897
+Node: \raisebox415201
+Ref: raisebox depth416164
+Ref: raisebox height416164
+Ref: raisebox width416164
+Ref: raisebox totalheight416164
+Node: \sbox & \savebox416878
+Node: lrbox419844
+Node: \usebox420666
+Node: Color421072
+Node: Color package options421916
+Node: Color models423562
+Ref: color models cmyk424359
+Ref: color models gray424722
+Ref: color models rgb424871
+Ref: color models RGB425208
+Ref: color models named425583
+Node: Commands for color425871
+Node: Define colors426286
+Node: Colored text427011
+Node: Colored boxes429409
+Node: Colored pages430798
+Node: Graphics431491
+Node: Graphics package options433618
+Node: Graphics package configuration436371
+Node: \graphicspath437173
+Node: \DeclareGraphicsExtensions440064
+Node: \DeclareGraphicsRule441832
+Node: Commands for graphics445018
+Node: \includegraphics445523
+Ref: includegraphics width450573
+Ref: includegraphics height451104
+Ref: includegraphics totalheght451510
+Ref: includegraphics keepaspectratio451774
+Ref: includegraphics viewport453460
+Ref: includegraphics trim453830
+Ref: includegraphics clip454286
+Ref: includegraphics page454546
+Ref: includegraphics pagebox454637
+Ref: includegraphics interpolate455502
+Ref: includegraphics quiet455707
+Ref: includegraphics draft455868
+Ref: includegraphics bb456673
+Ref: includegraphics bbllx457071
+Ref: includegraphics bblly457071
+Ref: includegraphics bburx457071
+Ref: includegraphics bbury457071
+Ref: includegraphics natwidth457213
+Ref: includegraphics natheight457213
+Ref: includegraphics hiresbb457399
+Ref: includegraphics type458161
+Ref: includegraphics ext458201
+Ref: includegraphics read458304
+Ref: includegraphics command458421
+Node: \rotatebox458666
+Node: \scalebox461497
+Node: \resizebox462553
+Node: Special insertions463745
+Node: Reserved characters464547
+Node: Upper and lower case465749
+Node: Symbols by font position467664
+Node: Text symbols468284
+Node: Accents472285
+Node: Additional Latin letters474300
+Ref: Non-English characters474471
+Node: \rule475488
+Node: \today476660
+Node: Splitting the input477596
+Node: \endinput479337
+Node: \include & \includeonly480604
+Node: \input484826
+Node: Front/back matter486041
+Node: Table of contents etc.486374
+Node: \addcontentsline490110
+Node: \addtocontents492952
+Node: \nofiles494543
+Node: Indexes495275
+Node: \index496903
+Node: makeindex502018
+Ref: makeindex preamble503686
+Ref: makeindex postamble503826
+Ref: makeindex group skip503911
+Ref: makeindex letheadflag504231
+Ref: makeindex lethead prefix504695
+Ref: makeindex lethead suffix504847
+Ref: makeindex item 0504995
+Ref: makeindex item 1505075
+Ref: makeindex item 2505150
+Ref: makeindex item 01505228
+Ref: makeindex item x1505333
+Ref: makeindex item 12505538
+Ref: makeindex item x2505646
+Ref: makeindex delim 0505806
+Ref: makeindex delim 1505936
+Ref: makeindex delim 2506066
+Ref: makeindex delim n506192
+Ref: makeindex delim r506327
+Ref: makeindex line max506435
+Ref: makeindex indent space506570
+Ref: makeindex indent length506665
+Ref: makeindex page precedence506850
+Node: \printindex507724
+Node: Glossaries508196
+Node: \newglossaryentry510163
+Node: \gls511632
+Node: Letters512426
+Node: \address516053
+Node: \cc516864
+Node: \closing517306
+Node: \encl517620
+Node: \location518034
+Node: \makelabels518298
+Node: \name520615
+Node: \opening520856
+Node: \ps521137
+Node: \signature521426
+Node: \telephone522654
+Node: Terminal input/output523019
+Node: \typein523284
+Node: \typeout524533
+Node: Command line525577
+Node: Command line options527635
+Node: Command line input531177
+Node: Recovering from errors533041
+Node: Document templates534375
+Node: beamer template534820
+Node: article template535474
+Node: book template535901
+Node: Larger book template536382
+Node: tugboat template537868
+Node: Index540239
+Ref: Command Index540325

End Tag Table
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/ChangeLog b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/ChangeLog
index 49ec6a9f6de..5045fa5a6df 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/ChangeLog
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/ChangeLog
@@ -1,3 +1,313 @@
+2018-07-03 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi Do a CTAN release following the checklist in the
+ file CTAN. Zip file contents from "make dist" looks OK to me.
+
+2018-07-02 Karl Berry <karl@freefriends.org>
+
+ * latex2e.texi: typos, underfull boxes, mirror wording.
+
+2018-07-02 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi: Finished checking entries against
+ latex2e-reference. Removed that item from xx list.
+ (CTAN) Added section.
+
+2018-07-02 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi:Check entries against
+ latex2e-reference. Through "Modes".
+
+2018-07-01 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi:Check entries against
+ latex2e-reference. Through the \t's.
+
+2018-07-01 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi:Check entries against
+ latex2e-reference. Through the \m's.
+
+2018-06-30 Karl Berry <karl@freefriends.org>
+
+ * latex2e.texi (Index): Merge General Index and Concept Index.
+
+ * latex2e.texi (\bigskip & \medskip & \smallskip): one
+ anchor for each.
+
+2018-06-30 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi:Try adding anchors that have URL's that
+ are easy to figure out. Add them in a couple of places, notably
+ in lists of parameters.
+ (Predefined lengths) Delete, moving contents to \mbox & \makebox.
+
+2018-06-29 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi: Put @noindent's following
+ @end examples where they are needed in PDF.
+
+2018-06-29 Karl Berry <karl@freefriends.org>
+
+ * latex2e.texi (Command line options) <-interaction>:
+ use @var{mode} to avoid overfull box in index. Use - for printed
+ output, and no @ftable.
+ (common.texi): minimize url.
+
+2018-06-28 Karl Berry <karl@freefriends.org>
+
+ * latex2e.texi (Command line): both - and -- work in TL,
+ and, I hope, in MiKTeX.
+
+2018-06-29 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi: Under- and underfull lines in PDF
+ are gone.
+
+2018-06-29 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi: Fix over- and underfull lines in PDF.
+ Through page 100.
+
+2018-06-28 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Command line) Fix synopsis calling syntax. Added
+ examples of putting commands on the command line,
+ and of recovering from errors. This finishes latex-info; I have
+ removed it from the todo's.
+
+2018-06-27 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Terminal input/output) Added synopsis, examples.
+ (Command line) Give synopsis calling syntax. Expanded
+ into sections the command options, including a discussion of shell
+ escape. Put in stub for putting commands on the command line,
+ and for recovering from errors.
+
+2018-06-26 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Front/back matter) Expanded the entries for the
+ table of contents, for the index, and for the glossaries. Added
+ many examples, adjusted wording. Added description of options for
+ .isty files.
+
+2018-06-21 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Special insertions) Rearranged the lists so that
+ the examples come first. That eases finding things for readers, since
+ all examples are in the same place vertically. Added Unicode for
+ HTML where available.
+
+2018-06-20 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (\sbox & \savebox) Combined the two. Added examples,
+ adjusted wording
+ (lrbox) Adjust wording.
+ (\usebox) Adjust wording, add error messages.
+
+2018-06-19 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (\strut) Added.
+ (\mbox & \makebox) Add examples, cross-references, adjust wording.
+ (\fbox & \framebox) Change name, add examples, adjust wording.
+
+2018-06-18 Karl Berry <karl@freefriends.org>
+
+ * latex2e.texi: let's make "uppercase" and "lowercase" one word?
+ Break some long (>=80 chars) lines, though many remain.
+
+2018-06-17 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Spaces) Do vertical spacing commands.
+ Add subsections for \bigskip & \medskip & \smallskip, and the
+ \bigbreak, etc. Add examples, particularly tricky was \addvspace.
+
+2018-06-16 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Spaces) Did horizontal spacing commands.
+ Add subsections for \hss and for tie, ~. Change the two subsections
+ on \(SPACE) to one, giving \@ its own subsection. Add examples, adjust
+ wording, add error messages.
+ (\mbox & \makebox) Combine the two sections into one. This needs more
+ work, including examples and error messages.
+
+2018-06-12 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Sectioning) Add subsections for \appendix and for
+ \frontmatter & \mainmatter & \backmatter. List the sectioning
+ parameters secnumdepth and tocdepth. Add Larger book template in
+ part as example of frontmatter, appendix, etc. Also add article
+ template. Adjust wording of some other sections, such as Tables
+ of Contents, to fit changes. Add examples. Adjust wording of main
+ Sectioning section.
+
+2018-06-11 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Sectioning) Make subsections for \part, \chapter,
+ \section, etc. Add examples. Adjust wording of main section.
+
+2018-06-09 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Math miscellany) Move dots to separate subsection
+ under Math symbols. Move \overline, etc. to separate subsection
+ after Math accents. Move \imath and \jmath to Math symbols.
+ Change rest to a menu, with synopses and examples, and error
+ messages where appropriate. Adjust wording.
+
+2018-06-07 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (\pagestyle) Add description of mechanism,
+ with example. Modify description of \makeboth, \makeright.
+ * graphics/Makefile Add. Make the graphics.
+ (list.eps) Have it generated by Asymptote, to make it smaller
+ and vector.
+
+2018-06-07 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (\pagenumbering) Add gobble, examples, refs to
+ page styles and counters.
+ (\maketitle) Improve example to contain all four declarations.
+
+2018-06-06 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Math spacing) Adjust wording.
+ (Page styles) Add example, adjust wording.
+
+2018-06-06 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Math functions) Make the @math{...} stuff not
+ appear in the HTML. Add comment about amsmath allowing users to
+ create their own.
+ (Math accents) Make the @math{...} stuff not
+ appear in the HTML.
+
+2018-06-05 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Math formulas) Adjust wording, including a suggestion
+ that new math docs should use the AMS packages. Add subsection to
+ symbols for Caligraphic, \boldmath, and blackboard bold.
+
+2018-06-04 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Modes) Include all six modes, with the vertical ones.
+ Adjust wording.
+ (Making paragraphs) Add \par. Combine \noindent and \indent.
+ Add \parindent to \parskip.
+
+2018-06-01 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Page breaking) Next in latex-info. Adjust wording.
+ Add examples and a few error messages.
+ (\clearpage & \cleardoublepage) Combine the two into one.
+
+2018-06-01 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Line breaking) Next in latex-info (split with
+ page breaking). Adjust wording. Add examples and a few error
+ messages. Adjust wording.
+ (sloppypar) Add.
+
+2018-06-01 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Letters) Next in latex-info. Adjust wording.
+ (\mlabel) Brought text from fr on customization of label
+ printing, added example.
+
+2018-05-31 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (Lengths) Next in latex-info is Lengths.
+ Adjust entries, adding examples and error messages.
+ (Definitions) \newlength adjusted, examples added. Make
+ synopses fit pattern elsewhere, including adding case of
+ no square brackets. Adjust wording of optargdefault in both
+ \newcommand and \newenvironment.
+
+2018-05-30 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (footnote) Next in latex-info is Footnotes.
+ Fold examples together into Footnotes in Tables subsection. Move
+ Parameters subsection material to \footnote. Adjust wording.
+
+2018-05-29 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (thebibliography) Add examples. Adjust wording.
+
+2018-05-28 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (picture) Add examples. Adjust wording.
+ Add menu items, readjust menu order. Add examples for many
+ menu subjects and adjust wording.
+
+2018-05-24 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (verbatim) Expand on problems putting
+ it in argument of macros, add examples.
+ (verse) Adjust wording.
+
+2018-05-23 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi Continue going through latex-info. Through that
+ doc's Environments. Adjust wording as it arises.
+ (minipage, parbox) Expand on options, add examples.
+
+2018-05-19 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi Continue going through latex-info. Through that
+ doc's Cross References, Commands, Page Layout. Adjust wording
+ as it arises, including adding error messages.
+
+2018-05-18 Karl Berry <karl@freefriends.org>
+
+ * text: "GNU/Linux", @TeX{} Live, MiK@TeX{}, just @samp.
+
+2018-05-17 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi Going through http://ctan.org/pkg/latex-info
+ (CTAN package latex-info), making sure this doc has everything
+ the older one has. So far, Counters done. Also adjust wording
+ as it arises.
+
+2018-05-17 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * latex2e.texi (\include & \includeonly) Combine the two. Include
+ discussion of many edge cases, with examples.
+ (Splitting the input) Add typical case example.
+ (\endinput) Added.
+ (\input) Adjust wording to fit changes.
+
+2018-05-04 Vincent Belaïche <vincent.belaiche@biosency.com>
+
+ * latex2e-fr.texi (Color): Translate node Color from Jim's r609 —
+ subnodes need further translation work.
+
+2018-04-30 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * Makefile (dist) Add latex2e-es.pdf.
+ * latex2e.texi (list) Add h0 description accidentally omitted.
+ (picture) Add additional synopsis, adjust wording.
+
+2018-03-22 Vincent Belaïche <vincent.belaiche@biosency.com>
+
+ * latex2e-fr.texi (All document): Use « tapuscrit » instead or as
+ an alternartive to « machine à écrire » for tt font family.
+ (Top, Color, Graphics): Add Color and Graphics nodes and sub-nodes
+ thereof, without translation.
+ (description): Translate edits from Jim r609 2018-03-04
+
+ * latex2e.texi (description): @var{}-ify « text of first item »
+ and « text of second item »
+ (description): « labeled list of items » -> « list of labeled items »
+ (Color package options): @code{}-ify « color » in title, as it is
+ the package name.
+ (Graphics package options, Graphics package configuration):
+ @code{}-ify « graphics » in title, as it is the package name.
+
+2018-03-21 Jim Hefferon <jhefferon@smcvt.edu>
+
+ * -- Prepare upload distribution to CTAN with correct file mtimes.
+ * makedist.sh Delete. (Better to use Makefile)
+ * CTAN Create Notes on uploading a distribution.
+
2018-03-28 Karl Berry <karl@freefriends.org>
* Makefile (dist): rm zip file before remaking it;
@@ -54,7 +364,7 @@
* latex2e.texi (list environment): Move list parameters to this
entry.
-2018-01-02 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2018-01-02 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (thebibliography, Upper and lower case): Align
on Karl's r598 edits of 2017-10-29.
@@ -65,7 +375,7 @@
* latex2e.texi: typos, wording.
* aspell.en.pws: more exceptions.
-2017-10-17 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-10-17 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (document header): Uppercase title 1st
letter. Make PlainTeX a flag, not sure what the best translation
@@ -76,15 +386,15 @@
(\providecommand): Add Jim's edits of r348 2015-05-29.
(\newcommand & \renewcommand): Typo.
(\newenvironment & \renewenvironment): typo.
- (\newsavebox): Use « baquet » rather than « bac » to translate
- « bin ».
+ (\newsavebox): Use « baquet » rather than « bac » to translate
+ « bin ».
(Special insertions, Non-English characters): Rename node
- « Non-English characters » to « Additional Latin letters ». Add an
+ « Non-English characters » to « Additional Latin letters ». Add an
anchor for backward compatibility.
* latex2e.texi (Document class options): Add @PkgIndex{geometry}.
-2017-10-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-10-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi: Mark tabbing node translation from French as TODO.
(thebibliography): Fix description about \refname, as sometimes it
@@ -95,7 +405,7 @@
(thebibliography): Fix description about \refname, as sometimes it
is also \bibname.
-2017-10-06 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-10-06 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi: Make EnvIndex and PkgIndex macro usable on the
same line as text.
@@ -109,7 +419,7 @@
algorithm2e and listings packages.
(Upper and lower case): Mention textcase package.
-2017-10-04 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-10-04 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (tabbing): Partial translation of tabbing node
rewrite, and add examples.
@@ -123,7 +433,7 @@
(table): Typo.
-2017-10-03 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-10-03 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (Class and package commands): Typo.
(quotation and quote): Typoes.
@@ -133,7 +443,7 @@
* latex2e.texi,
* latex2e-fr.texi (Low-level font commands): remove width percentages.
-2017-08-22 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-08-22 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi: push iftexthenelse macro and HAS-MATH flag to common.texi
(Low-level font commands): Restore cmss & cmtt. `@dmn{}%' -> `%'.
@@ -143,7 +453,7 @@
* common.texi: push iftexthenelse macro and HAS-MATH flag to common.texi
-2017-08-22 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-08-22 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (Low-level font commands): Refer to
https://ctan.org/pkg/encguide. Use multitables to achieve Jim's
@@ -157,7 +467,7 @@
Jim's r363 edits of 2015-06-16, as well as my edits on top of them
to latex2e.texi made in this revision.
-2017-08-09 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-08-09 Vincent Belaïche <vincentb1@users.sourceforge.net>
* NEWS-fr: Typoes.
@@ -169,12 +479,12 @@
* latex2e.texi: (\@startsection) Added defaults for book, article,
and report classes.
-2017-08-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-08-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
* README-fr: Convert from latin-9 to utf-8 to comply with CTAN
requirements.
-2017-08-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-08-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
* Makefile.1: rename README-fr to README in the zipped archive.
@@ -184,13 +494,13 @@
* README-fr: Typoes. Extend the leading English part fo the French
readme to comply with CTAN requirements.
-2017-08-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-08-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
* README-fr: Port GNA! -> Puszcza. `non officiel' -> `officieux'
for consistency with manual. Mention other people translate
`moving argument' by `argument mouvant'.
-2017-08-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-08-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
* NEWS-fr: Add delivery note --- translated from Jim's, thank you
Jim!
@@ -205,7 +515,7 @@
* latex2e-fr.{dbk,.dvi,.html,.info,.pdf,.texi,.txt,.xml}: Compilation for August 2017 delivery to CTAN.
-2017-08-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-08-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi: Update version & copyright notice for August 2017 delivery to CTAN.
@@ -223,7 +533,7 @@
* latex2e.texi: copyright 2017.
-2017-08-01 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-08-01 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (Environment, Declaration, \makeatletter and \makeatother)
(\@@ifstar, \@@startsection): put a sectionning title to node.
@@ -258,7 +568,7 @@
(Sectioning): Add anchor to secnumdepth counter for reference from
\@@startsection node.
-2017-07-31 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-07-31 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (Class and package commands): Add \CheckCommand
and \DeclareRobustCommand as per Jim's r568 2017-07-30 edits + my
@@ -269,7 +579,7 @@
(Class and package commands/\DeclareRobustCommand): Improve
existing description. Add mention to etoolbox macros.
-2017-07-31 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-07-31 Vincent Belaïche <vincentb1@users.sourceforge.net>
* Makefile.1: Extend check-dw to handle other languages. Add
target help.
@@ -282,7 +592,7 @@
* latex2e.texi (document header): update version.
-2017-07-31 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-07-31 Vincent Belaïche <vincentb1@users.sourceforge.net>
* Makefile.1: Add targets <lang><format>, like enpdf, frpdf,
eninfo, etc...
@@ -294,8 +604,8 @@
`http://ctan.org/...'. Reword `non officiel' -> `officieux'.
(Overview): Take edits from Jim's r412+413 of 2015-08-21.
(Starting and ending): Typo. rewording `sections' -> `rubriques'.
- (Output files): English quotes `` '' to French quotes
- « ». Concerning .log, add @dfn{fichier journal} (the French for
+ (Output files): English quotes `` '' to French quotes
+ « ». Concerning .log, add @dfn{fichier journal} (the French for
``log file''). Typo. Translate leftover English in .lot/.lof/.toc
cindex.
(@TeX{} engines): @TeX{} -> @TeX{} de base --- ie Plain-@TeX{}. Typo.
@@ -312,7 +622,7 @@
(displaymath): Take edits from Jim's r412 2015-08-21, plus my
modifications to latex2e.texi.
(picture): `sections' -> `rubriques'.
- (\oval): English quotes `` '' to French quotes « ».
+ (\oval): English quotes `` '' to French quotes « ».
(table): Exchange order of \caption and \label in example to align
on the English version.
(Units of length): Translate to French leftover English @cindex
@@ -369,14 +679,14 @@
* latex2e.texi: (\@ifstar): Translate from the French version.
(\@startsection): Move to Sectioning.
-2017-07-27 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-07-27 Vincent Belaïche <vincentb1@users.sourceforge.net>
* Makefile.1 (compare-nodes, compare-nodes-fr, compare-nodes-es):
new targets to compare node lists between languages. compare-nodes
is made a synonym of compare-nodes-fr because the Spanish
translation does not reuse the same node names.
-2017-07-26 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-07-26 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (<header comment>): Add reference to
https://www.latex-project.org/help/books/lc2fr-apb.pdf, as far as
@@ -461,7 +771,7 @@
* latex2e.texi: added class and package commands from clsguide.pdf.
-2017-06-09 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2017-06-09 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (abstract): typo.
(\raggedleft): typo.
@@ -489,7 +799,7 @@
(tugboat template): update.
-2016-11-24 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-11-24 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-es.texi: Place the English license in the @copying
section, and push the translation to an annex.
@@ -506,7 +816,7 @@
* Makefile (txt_files): Remove license.texi from the list of files
to zip into the distributed archive.
-2016-11-23 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-11-23 Vincent Belaïche <vincentb1@users.sourceforge.net>
* license.texi: dos2unix + svn propset svn:eol-style to LF.
@@ -529,7 +839,7 @@
* Makefile.1: Add check-license-<lang> targets to check that the
license is same as in license.texi
-2016-11-21 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-11-21 Vincent Belaïche <vincentb1@users.sourceforge.net>
* ltx-help.el (latex-help-file): Make this variable a defcustom
for selecting the manuel translation.
@@ -549,11 +859,11 @@
license.texi, make it delimited by @comment's.
(\cc): Add `, as in:' before example.
-2016-11-19 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-11-19 Vincent Belaïche <vincentb1@users.sourceforge.net>
* license.texi: Ooops... add this file.
-2016-11-19 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-11-19 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.{xml,dvi,html,info,pdf,txt}: Make these files again
for the license.
@@ -571,7 +881,7 @@
* Makefile (txt_files): Add license.texi file.
-2016-11-18 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-11-18 Vincent Belaïche <vincentb1@users.sourceforge.net>
* Makefile.1: Make variable txt_tiles a macro, so that NEWS-fr and
README-fr be delivered instead of NEWS and README for target
@@ -579,7 +889,7 @@
* NEWS-fr: add news for November 2016 CTAN delivery.
-2016-11-18 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-11-18 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.{xml,dvi,html,info,pdf,txt}: Make these files.
@@ -597,7 +907,7 @@
* Makefile.1 (spell-$(1)): Take in edit by Karl (rev 546) on Makefile
-2016-11-15 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-11-15 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (Math miscellany): Use `math' instead of `text' for
the @var{...} name.
@@ -612,24 +922,24 @@
* Makefile (spell): A-Z intended in range.
-2016-09-14 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-09-14 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.{dbk,html,info,txt,xml,pdf}: Update French manuals.
-2016-09-13 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-09-13 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (\@@ifstar): New node.
* latex2e.texi (\makeatletter and \makeatother): Comment that
documenting \@ifstar is TODO.
-2016-09-13 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-09-13 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (\newcommand & \renewcommand, Spaces)
(\(SPACE) and \@@, \(SPACE) after control sequence): Complete
taking on Karl's rev497 edits.
-2016-09-13 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-09-13 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (\discretionary, Footnotes in section headings)
(\newcommand & \renewcommand, Math miscellany, \(SPACE) and \@@)
@@ -637,7 +947,7 @@
(\(SPACE) after control sequence): Rename node --- old name was
``\(SPACE) after CS'' --- as per Karl's rev497 edits.
-2016-09-12 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-09-12 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (Document class options): Remove @dmn{...} for
``inches''.
@@ -648,7 +958,7 @@
(Floats): Indicate that ``Here'' means ``Ici'', and fix left-over
non translated word ``For''.
-2016-09-09 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-09-09 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (Document class options): @dmn{...}-ize the units
in the text from Jim's rev383 changes.
@@ -667,14 +977,14 @@
@dmn{...}-ize the units.
(Math symbols): Fix typo in \uplus entry.
-2016-09-07 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-09-07 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi: Same changes as in latex2e.texi
(Document class options): Minor editorial change.
(\newenvironment & \renewenvironment): Align on Karl's rev538
- change, ie clarify that @var{débutdéf} and @var{findéf} are
- executed within a group. Rename @var{débutdéf} and @var{findéf} to
- @var{défdébut} and @var{déffin}
+ change, ie clarify that @var{débutdéf} and @var{findéf} are
+ executed within a group. Rename @var{débutdéf} and @var{findéf} to
+ @var{défdébut} and @var{déffin}
* latex2e.texi: new iftexthenelse macro.
(Footnotes in a table): Minor editorial change to avoid overfull hbox.
@@ -687,7 +997,7 @@
by ``processed'' because not only execution but also expansion
prior to it happens within a group.
-2016-09-05 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-09-05 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (\newenvironment & \renewenvironment): Add an
@findex for ``group''.
@@ -703,11 +1013,11 @@
https://mail.gna.org/listinfo/latexrefman-discuss is for archives
and subsription.
-2016-09-04 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-09-04 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi: Whole file, suppress any trailing blanks.
-2016-09-04 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-09-04 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (Top): Fix translation of sub node menu entry text.
(Overview): Fix spelling. Fix leftover English. ``paquetage de
@@ -748,7 +1058,7 @@
\mathsection \mathsterling \mathunderscore \mathunderscore.
(Text symbols): add \textsection, \textquotesingle.
-2016-04-12 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-04-12 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (Document class options): Improve wording by
reusing package variable @var{pkg} in the synopsis description.
@@ -767,11 +1077,11 @@
`\@var{cmd}'. Fix typoes.
(\newenvironment & \renewenvironment): nargs starting from 0
rather than from 1. Fix typoes. `argument positionnel' ->
- `paramètre positionnel'.
+ `paramètre positionnel'.
(Reserved characters): `\backslash' -> `\textbackslash' in the
@findex in accordance with description. Fix typoes.
-2016-04-12 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-04-12 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (top comment, Top): Make version under quotes to
avoid incorrect French ``de Avril 2016'' or ``du Avril 2016''
@@ -782,24 +1092,24 @@
notice up to 2016.
* latex2e-fr.texi (top comment): `Copyright' -> `Tous droits
- réservés ©' + add ``Vincent Belaïche'' as translator.
+ réservés ©' + add ``Vincent Belaïche'' as translator.
-2016-04-11 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-04-11 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-es.texi (top comment, Using BibTeX): Replace CTAN
central server URLs by mirror URLs, after a comment by Petra
- Rübe-Pugliese.
+ Rübe-Pugliese.
* latex2e-fr.texi (top comment, Output files, Using BibTeX):
Replace CTAN central server URLs by mirror URLs, after a comment
- by Petra Rübe-Pugliese.
+ by Petra Rübe-Pugliese.
(Output files, Using BibTeX): Typoes.
* latex2e.texi (top comment, Output files): Replace CTAN central
server URLs by mirror URLs, after a comment by Petra
- Rübe-Pugliese.
+ Rübe-Pugliese.
-2016-04-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-04-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
* NEWS: Add NEWS entry for the Apr 2016 release --- assuming
English will be released also.
@@ -807,12 +1117,12 @@
* Makefile.1 (dist-xx, dist): Fix pior check that there aren't any
uncommited changes before making the zip.
-2016-04-07 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-04-07 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.{dbk,html,info,txt,xml,pdf}: Update French manuals
for distribution 2016-04-08 to CTAN.
-2016-04-07 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-04-07 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi: Updated @set UPDATED.
@@ -863,7 +1173,7 @@
make tag TAG=foo "MESSAGE=Some message"
-2016-04-04 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-04-04 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi: Add EnvIndex macro to make indexing environments
consistent and throughout the manual. Replace any @findex of an
@@ -879,10 +1189,10 @@
* latex2e-es.texi: Same as latex2e.texi.
(filecontents): Align to latest text in latex2e{,-fr}.texi.
-2016-04-02 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-04-02 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-es.texi: Add @BES and @BESU macro definitions.
- (Símbolos de Texto): Use @BES macro rather than @math for
+ (Símbolos de Texto): Use @BES macro rather than @math for
\textperiodcentered so that the other-than-PDF is clean. `$' ->
`\$' for \textdollar.
@@ -893,21 +1203,21 @@
\@startsection example for solving the overfull hbox in the PDF
output.
* latex2e-fr.texi (Text symbols): \textquestiondown
- Typo. \textexclamdown `haut en bas' -> `culbuté'. Use @BES macro
+ Typo. \textexclamdown `haut en bas' -> `culbuté'. Use @BES macro
rather than @math for \textperiodcentered and \trademark so that
the other-than-PDF is clean. `$' -> `\$' for \textdollar. `marque
de fabrique' -> `marque de commerce' for \texttrademark.
(\@@startsection): re-indent \@startsection example for solving
the overfull hbox in the PDF output, and fix some wrong reference.
-2016-03-31 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-03-31 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.{dbk,dvi,html,info,pdf,texi,txt,xml}: make fr.
-2016-03-29 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-03-29 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (Line breaking): Improve translation of
- break/breaking, use `saut/sauter à' rather than `rupture/rompre'.
+ break/breaking, use `saut/sauter à' rather than `rupture/rompre'.
(Spaces): Typo.
(Special insertions): Typo.
(Text symbols): Fix typo adding `comp' into
@@ -923,7 +1233,7 @@
`\textcapitalcompwordmark' and `\textascendercompwordmark'
-2016-03-17 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-03-17 Vincent Belaïche <vincentb1@users.sourceforge.net>
Reword descrition of \epsilon and \varepsilon.
@@ -933,15 +1243,15 @@
``script small letter''.
* latex2e-fr.texi (Math symbols): About \varepsilon ``en forme de
- 3 retourné'' -> ``minuscule de ronde''.
+ 3 retourné'' -> ``minuscule de ronde''.
-2016-03-15 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-03-15 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (Math symbols): Fix compilation errors.
* latex2e-fr.texi (Math symbols): Fix compilation errors.
-2016-03-14 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-03-14 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi Define flags NotInPlainTeX, NeedsAMSSymb and
NeedsSTIX, in order to factorize text of `Math symbols' node.
@@ -954,7 +1264,7 @@
* latex2e-fr.texi (Math symbols): Progress translation of this
node and make same changes as for latex2e.texi.
-2016-03-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-03-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (Top): Typoe in `Modes' menu entry.
(eqnarray): `or' -> `ou'.
@@ -975,41 +1285,41 @@
(\ensuremath): new node.
(Text symbols): Add pilcrow character for \P, similar change for \S.
-2016-03-06 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-03-06 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (Math symbols): Progress translation of this node.
-2016-02-29 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-02-29 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (\circle): Use term ``disque'', in addition to
``cercle plein'' (solid circle). @dmn{...}-ify unit.
(\makebox (picture)): Typo.
(Math symbols): Progress translation of this node.
-2016-02-22 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-02-22 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (Text symbols): Fix @code{'}->@code{''} for \textquotedblright
(Splitting the input): @dfn{...}-ify `root file' and add it to concept index
(\include): Replace `See next section' -> `See @ref{\includeonly}'.
(\includeonly): `@var{file}s' -> `@var{file1}, @var{file2}, @dots{}'
- * latex2e-fr.texi (\alph \Alph \arabic \roman \Roman \fnsymbol): `croix-mortuaire' -> `obèle'
+ * latex2e-fr.texi (\alph \Alph \arabic \roman \Roman \fnsymbol): `croix-mortuaire' -> `obèle'
(Math symbols): Progress translation of this node.
(Text symbols): Start translation of this node.
- (\thinspace): `imbriqué' -> `emboîté', as per Cahier GUTenberg #49 glossary
+ (\thinspace): `imbriqué' -> `emboîté', as per Cahier GUTenberg #49 glossary
(Text symbols): Fix @code{'}->@code{''} for \textquotedblright
(Splitting the input, \include, \includeonly, \input): Translate these nodes.
(Splitting the input): @dfn{...}-ify `root file' and add it to concept index
(\include): Replace `See next section' -> `See @ref{\includeonly}'.
(\includeonly): `@var{file}s' -> `@var{file1}, @var{file2}, @dots{}'
-2016-02-15 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-02-15 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (\noindent): `..' -> `...'.
* latex2e-fr.texi (About this document, @LaTeX{} command syntax)
(Document class options, Document class options)
- (Page layout parameters, Sectioning, enumerate, \item, \line)
+ (Page layout parameters, Sectioning, enumerate, \item, \line)
(\thicklines, \thinlines, \cite, \newtheorem, \newtheorem, \newtheorem)
(\alph \Alph \arabic \roman \Roman \fnsymbol, \signature): @tie{} -> UTF-8
unbreakable space.
@@ -1020,7 +1330,7 @@
(Math symbols): Progress translation + @tie{} -> UTF-8 unbreakable
space.
-2016-02-11 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-02-11 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (abstract): @code{...}-ify words `article' &
`report' when they refer to classes.
@@ -1034,10 +1344,10 @@
(\@@startsection): `@var{indent}' -> `@var{retrait}', indent(ation) -> retrait or renfoncement.
(Document class options): Added flegn concerns display mode formula only.
(Environments): `mise en vedette' -> `en hors texte'
- (abstract): `abtracts' -> `résumé', and update translating this
+ (abstract): `abtracts' -> `résumé', and update translating this
node as per Jim's rev 486 of 2015-12-05T13:22:45+01 edit.
(Environment): Ellipsis `..' -> `...', and add
- `Voir @ref{Environments} pour une liste des environnements.' as
+ `Voir @ref{Environments} pour une liste des environnements.' as
per Jim's rev 486 of 2015-12-05T13:22:45+01 edit.
(array): Update translation ad per Jim's edits rev 391 of
2015-08-02T22:57:00+02 and with fixes from rev 469 by Karl of
@@ -1064,7 +1374,7 @@
* latex2e.texi (array): the directive is just p{...}, not @p{...}.
Noted by Vincent.
-2016-02-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-02-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (lrbox): Use Synopsis instead of in-line
@code{...}. `cmd' -> `\@var{cmd}'. @ref{...}-ify @code{\sbox}.
@@ -1093,12 +1403,12 @@
(lrbox): Translate this node.
(\raisebox): Complete translation of this node.
(Front/back matter): Typo.
- (Tables of contents): `article' -> `entrée', as per Cahier GUTenberg #49 glossary.
+ (Tables of contents): `article' -> `entrée', as per Cahier GUTenberg #49 glossary.
(\addcontentsline): Translate this node, with same edits as in latex2e.texi.
(\addtocontents): Translate this node.
(Glossaries): Translate this node.
(Indexes): Translate this node, with same edits as in latex2e.texi.
- (Letters): Typoes. `clôture' -> `salutation'. Typo. Complete
+ (Letters): Typoes. `clôture' -> `salutation'. Typo. Complete
translation with same edits as in latex2e.texi.
(\address): Translate this node.
(\cc): Translate this node.
@@ -1108,7 +1418,7 @@
(\makelabels): Typo.
(\opening): Typo.
-2016-02-05 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-02-05 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (Line breaking, \discretionary): Add node
\discreionary, need completion.
@@ -1122,7 +1432,7 @@
(Page breaking): Translate this node.
(\protect): Translate this node, with same changes as in latex2e.texi.
-2016-02-04 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-02-04 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (Spacing in math mode): Add @xref{\thinspace} to
the \thinspace entry.
@@ -1139,7 +1449,7 @@
example. Make TeX output only when compilation is with TeX and fix
some of the examples.
-2016-02-02 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-02-02 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi: Reword copyright notice from
Automatic-translation French to real French.
@@ -1180,7 +1490,7 @@
* latex2e.texi (\newcommand & \renewcommand): mention "\ "
after control sequences, as noted by Vincent.
-2016-01-27 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-01-27 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (Marginal notes): Typoes.
(Subscripts & superscripts): Typo.
@@ -1222,7 +1532,7 @@
* aspell.en.pws: add more exceptions.
* latex2e.texi: fix typos, refilling.
-2016-01-15 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2016-01-15 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (\setlength, \addtolength, \settodepth)
(\settoheight, \settowidth): Place synopsis in a Synopsis
@@ -1242,7 +1552,7 @@
(Symbols by font position): Add this node, after update made to
latex2e.texi
-2015-12-14 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2015-12-14 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (Top): section->rubrique, sectionement->rubricage
(@LaTeX{} command syntax): Add node ``\makeatletter and \makeatother''.
@@ -1315,7 +1625,7 @@
* latex2e.texi (\makeatletter and \makeatother): Adjust wording.
-2015-11-26 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2015-11-26 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (\newsavebox, \newtheorem, \newfont): Complete
translation of this node, and align on latest English version.
@@ -1335,7 +1645,7 @@
position. Distinguish between output in text body font and
output in typewriter font.
-2015-11-09 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2015-11-09 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (\newcommand & \renewcommand): Introduce the
concept of positional parameter.
@@ -1346,7 +1656,7 @@
letters and character `*'. Use the term positional parameter, and
tell that expansion is within begdefn, not within environment,
which was misleading. @samp{...}-ify `Shakespear' outside of
- @example...@end example.
+ @example...@end example.
* latex2e-fr.texi (Output files): Typo.
(tabular): Typoes.
@@ -1354,14 +1664,14 @@
(\newenvironment & \renewenvironment): Complete the translation
and make the same text improvements as in latex2e.texi.
-2015-11-06 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2015-11-06 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (\parbox): Tell that `position=m' equates the
default behaviour.
* latex2e.texi (\parbox): Same as latex2e-fr.texi.
-2015-11-05 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2015-11-05 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (\fussy): Typo.
@@ -1369,16 +1679,16 @@
(\verb): Clean-up left over English words.
(\obeycr & \restorecr, \fussy, \sloppy): Translate this node.
-2015-11-04 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2015-11-04 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (tabular): wording `@code{*-expression}' -> `@code{*}-expression'.
* latex2e-fr.texi (tabular): Complete translation of this node.
-2015-11-03 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2015-11-03 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (\parbox): Correct description of \parbox vertical
- alignment after comment from Denis Bitouzé.
+ alignment after comment from Denis Bitouzé.
* latex2e-fr.texi (\parbox): Same as for latex2e.texi.
@@ -1389,11 +1699,11 @@
* latex2e.texi (throughout): consistently use ... instead of
.. for code ellipses.
-2015-10-27 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2015-10-27 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (enumerate): Typo.
(itemize): Restore missing example.
- (thebibliography): `label' -> `étiquette', `cite_key' ->
+ (thebibliography): `label' -> `étiquette', `cite_key' ->
`clef_de_cite'. Change wording concerning `\refname' in standard classes.
(\bibitem, \cite, \nocite, Using BibTeX, theorem): Translate this node.
(\cleardoublepage, \newpage): Improve wording `page actuelle' ->
@@ -1438,7 +1748,7 @@
* latex2e.texi (Footnotes): Add remark that getting biblio
references in footnotes depends on the bibliographic style.
-2015-10-11 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2015-10-11 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (Page breaking): Translate menu entries
(\cleardoublepage, \clearpage, \newpage, \enlargethispage)
@@ -1451,7 +1761,7 @@
* latex2e.texi (\cleardoublepage, \clearpage): Clarify that only
pending floating tables & figures are cleared.
(\newpage): `see @code{\clearpage} above' -> `@pxref{\clearpage}'
- (Footnotes): Make the exact quotation of Noël Coward, and correct
+ (Footnotes): Make the exact quotation of Noël Coward, and correct
his first name spelling.
2015-10-11 Jim Hefferon <jhefferon@smcvt.edu>
@@ -1468,7 +1778,7 @@
* latex2e.texi (\makelabels): Add more on how to customize
label sizes, etc.
-2015-10-09 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2015-10-09 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi (Environments): Merge menu entries for nodes
quote & quotations after Jim's edits of 2015-09-28
@@ -1481,7 +1791,7 @@
* latex2e.texi (Footnotes in a section heading): Add node,
provide examples.
-2015-10-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2015-10-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (\makelabels): @var{...}-ify argument 'to addess',
and @code{...}-ify class name.
@@ -1544,7 +1854,7 @@
* latex2e.texi (Letters): Add synopsis, examples.
-2015-09-22 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-09-22 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e-fr.texi (filecontents): Add Jim's 2015-09-18 (r439) edits.
(\addvspace): Add Jim's 2015-09-13 (r432) edits.
@@ -1560,7 +1870,7 @@
* latex2e-{es,fr}.{dbk,html,info,txt,xml}: Compile these files
again, because of eol problem.
-2015-09-21 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-09-21 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e-{es,fr}.{dbk,dvi,html,info,pdf,txt,xml}: Compile these files
@@ -1570,7 +1880,7 @@
* latex2e.texi (filecontents): Corrections suggested by JB.
-2015-09-17 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-09-17 Vincent Belaïche <vincent.belaiche@gmail.com>
* ChangeLog: Correct typo on Jim's surname Hefferson->Hefferon.
@@ -1589,7 +1899,7 @@
* latex2e.texi (Subscripts & superscripts): Add examples.
-2015-09-15 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-09-15 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e.texi (Starting and ending): Add @cindex environment
(Spaces, \(SPACE) and \@@, \(SPACE) after CS): Move text how to
@@ -1602,7 +1912,7 @@
changes as for latex2e.texi.
(Overview): add @: after some abbrev ending periods.
(Font styles): Follow Karl's changes of
- 2015-04-26, "deux choses très différentes"->"deux constructions
+ 2015-04-26, "deux choses très différentes"->"deux constructions
sans relation l'une avec l'autre"
(Starting and ending): Follows Karl's change of 2015-04-26
(\- (hyphenation)): Translate this node.
@@ -1626,7 +1936,7 @@
* latex2e.texi (\noindent): Add example.
-2015-09-14 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-09-14 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e.texi (Spacing in math mode): Add missing @findex entries
for \thickspace, \medspace & \thinspace. Typo tht->that.
@@ -1689,7 +1999,7 @@
* latex2e.texi (Spacing in math mode): Move math mode lengths
to here and add whether they work also in text mode.
-2015-09-04 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-09-04 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e-fr.texi: Add macroes BES & BESU to support compilation of math symbols with texi2pdf.
(Symbolic footnotes): Complete translation of this node
@@ -1714,7 +2024,7 @@
(\makebox): reword is specified->can be overriden, because width is optional.
(\makebox): @code{...}-ify environment name picture.
-2015-08-29 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-08-29 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e-fr.texi (\linethickness): Typo.
(\thicklines, \thinlines, \shortstack, \/, \hrulefill)
@@ -1727,7 +2037,7 @@
(\addvspace): @var{...}-ify word `length'.
-2015-08-27 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-08-27 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e.texi (Units of length): Use `@dmn{...}' rather than
`@tie{}...' in new node added by Jim.
@@ -1736,11 +2046,11 @@
* latex2e.texi (Units of length): Add new node in Lengths.
-2015-08-25 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-08-25 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e.texi (tabular): typo : horozontal->horizontal.
-2015-08-24 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-08-24 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e.texi (picture): (width,height)(x offset,y offset)->(@var{width},@var{height})(@var{xoffset},@var{yoffset})
(picture): make position a concept index entry, and @dfn{...}-ize it.
@@ -1750,7 +2060,7 @@
(picture): Translate this node.
(\framebox (picture)): @var{width}->@var{largeur}
-2015-08-23 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-08-23 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e-fr.texi (file preamble): Add comment about glossary
resources useful for French translation
@@ -1761,7 +2071,7 @@
(\centering): typo
(flushleft, \raggedright): Improve wording.
(flushright, \raggedleft): Translate these nodes.
- (quotation, Making paragraphs): ligne blanche->ligne à blanc
+ (quotation, Making paragraphs): ligne blanche->ligne à blanc
* latex2e.texi (Floats): typo insert comma.
(Floats): figure->float
@@ -1790,7 +2100,7 @@
with issues. Shrink the figure and table nodes by the common
material.
-2015-08-20 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-08-20 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e-fr.texi (Output files, @TeX{} engines, \line)
(Glossaries): Remove @acronym on Karl's request
@@ -1807,7 +2117,7 @@
* Makefile (xref_suffixes): no auxs or tocs.
-2015-08-19 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-08-19 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e.texi (flushleft): string->control sequence.
@@ -1898,7 +2208,7 @@
* latex2e.texi (center, \centering): Add detail, including
distinguishing the two and examples.
-2015-08-05 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-08-05 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e.texi (\indent): remove "width of" concering concerning
\parindent length.
@@ -1935,7 +2245,7 @@
* latex2e.texi (vline, cline, hline): Add examples. Also describe
how columns are counted.
-2015-07-30 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-07-30 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e-fr.texi (Top): Correct menu item French translation for "Making paragraphs"
(itemize): typo, remove left-over English word "dash"
@@ -1944,7 +2254,7 @@
* latex2e.texi (Text symbols): Correct -- for --- for en-dash
-2015-07-29 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-07-29 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e-es.texi (Acentos): Make references between \underbar and \b.
@@ -1987,7 +2297,7 @@
the unicode glyph to the start of each entry to make
easier scanning for the desired symbol.
-2015-07-08 Vincent Belaïche <vincent.belaiche@gmail.com>
+2015-07-08 Vincent Belaïche <vincent.belaiche@gmail.com>
* latex2e-fr.texi (Line breaking, \savebox): Translation to French.
(Sectioning): Typo.
@@ -2294,7 +2604,7 @@
* latex2e.texi (\alph \Alph \arabic \roman \Roman \fnsymbol):
\Roman for second @item. Typo reported by Jose Atria.
-2014-11-19 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2014-11-19 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi: Progress translation to French
@@ -2304,12 +2614,12 @@
(node filecontents): Make it clear that it is about
files not documents.
-2014-10-20 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2014-10-20 Vincent Belaïche <vincentb1@users.sourceforge.net>
* Makefile: Add target `check' to compile each manual once with tex
and once with makeinfo. This is faster than using target `all'.
-2014-10-19 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2014-10-19 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (\setcounter): replace @var{\counter} by @var{counter}
@@ -2318,7 +2628,7 @@
* latex2e-fr.texi (\setcounter): Same change as latex2e.texi.
Progress Translation to French.
-2014-10-17 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2014-10-17 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-es.texi (\pagenumbering): use @backslashchar{} within
@vincentb in order to compile with tex.
@@ -2336,7 +2646,7 @@
* latex2e-es.texi (\put): @vincentb, not @vincenb.
-2014-09-25 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2014-09-25 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (\put): Make coordinates within @var{...} and add
explicit reference to them in the text.
@@ -2348,7 +2658,7 @@
* latex2e-fr.texi (nodes \put, \usebox): Same as
latex2e.texi. Progress translation to French.
-2014-09-19 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2014-09-19 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (document header): Set @documentencoding and
@documentlanguage.
@@ -2374,7 +2684,7 @@
* latex2e-fr.texi: Similar changes as latex2e.texi. Progress
translation to French.
-2014-09-10 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2014-09-10 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (\thinspace): em -> @dmn{em}.
@@ -2382,7 +2692,7 @@
* latex2e-fr.texi: Progress translation to French.
-2014-09-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2014-09-08 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-fr.texi: Progress translation to French.
@@ -2390,14 +2700,14 @@
make by' by `The box made by'.
(node Math miscellany): correct typo `for examp*l*e'.
-2014-08-30 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2014-08-30 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e-es.texi (\vector): correct bug involved by renaming
y-slop/x-slop to declivex/declivey --- as I used @vincentb macro
encapsulation to mark my change, it made \ of \vector no longer a
"other" character.
-2014-08-29 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2014-08-29 Vincent Belaïche <vincentb1@users.sourceforge.net>
* Makefile: add definition of variable all, for clean to work. Add
squeaky as a synonym of realclean. Add in comment generic line for
@@ -2408,12 +2718,12 @@
* latex2e.texi (node Page layout parameters): correct typo clase -> classes
(node array): `in that row' -> `in each row of that column
- * latex2e-es.texi (node array): `el número de elementos y deben
+ * latex2e-es.texi (node array): `el número de elementos y deben
tener el formato' -> `cual formato debe tener cada linea en esta
columna'
-2014-08-24 Vincent Belaïche <vincentb1@users.sourceforge.net>
+2014-08-24 Vincent Belaïche <vincentb1@users.sourceforge.net>
* latex2e.texi (node Boxes): add @code{...} encapsulation.
(\dashbox): replace @code{...} by @var{...} for \dashbox
@@ -2426,7 +2736,7 @@
* latex2e-es.texi (node Cajas): same as latex2e.texi.
(\dashbox): same as latex2e.texi. Rename parameter
- @var{dlargo} to @var{glargo}, with 'g' for guión (aka
+ @var{dlargo} to @var{glargo}, with 'g' for guión (aka
dash).
(nodes \line & Glossarios): same as latex2e.texi.
(\makebox of picture): same as latex2e.texi.
@@ -2439,7 +2749,7 @@
(\vector): same as latex2e.texi.
Progress further translation to French.
-2014-08-17 Vincent Belaïche <vincent.b.1@hotmail.fr>
+2014-08-17 Vincent Belaïche <vincent.b.1@hotmail.fr>
* latex2e.texi: (node Layout) Add @code{...} around \headheight
and \footskip in `Page layout parameters' menu entry
@@ -2449,7 +2759,7 @@
* latex2e-fr.texi: Same change as in latex2e.texi. Continue
progressing translation to French.
-2014-08-11 Vincent Belaïche <vincent.b.1@hotmail.fr>
+2014-08-11 Vincent Belaïche <vincent.b.1@hotmail.fr>
* latex2e.texi: Add @code{...} encapsulation in some places to
class names letter, slides, book, report, article, and to
@@ -2462,23 +2772,23 @@
translation to French.
-2014-08-10 Vincent Belaïche <vincent.b.1@hotmail.fr>
+2014-08-10 Vincent Belaïche <vincent.b.1@hotmail.fr>
* latex2e.texi: (Overview) change wording about case sensitivity.
- * latex2e-es.texi: (Descripción) same change change as for latex2e.texi about case sensitivity.
+ * latex2e-es.texi: (Descripción) same change change as for latex2e.texi about case sensitivity.
* latex2e-fr.texi: (Overview) same change change as for
latex2e.texi about case sensitivity. (Whole document) Put in place
same structure as for original and progress translation.
-2014-08-01 Vincent Belaïche <vincent.b.1@hotmail.fr>
+2014-08-01 Vincent Belaïche <vincent.b.1@hotmail.fr>
* latex2e-fr.texi: Creation --- still very approximate & preliminary...
* Makefile: Make it generic
-2014-07-20 Vincent Belaïche <vincent.b.1@hotmail.fr>
+2014-07-20 Vincent Belaïche <vincent.b.1@hotmail.fr>
* latex2e.texi (\LaTeXe),
* latex2e-es.texi (\LaTeXe): document LaTeX2e log.
@@ -2493,7 +2803,7 @@
(Font styles): mention my disagreement with the oft-stated
notion that \tt, et al., are "obsolete".
-2014-02-27 Vincent Belaïche <vincent.b.1@hotmail.fr>
+2014-02-27 Vincent Belaïche <vincent.b.1@hotmail.fr>
* latex2e.texi (filecontents): Clarify that LaTeX2e default
filecontents environment DOES NOT overwrite existing files, you
@@ -2501,12 +2811,12 @@
* latex2e-es.texi (filecontents): Align on the English version.
-2014-02-26 Vincent Belaïche <vincent.b.1@hotmail.fr>
+2014-02-26 Vincent Belaïche <vincent.b.1@hotmail.fr>
* latex2e-es.texi: Align Spanish translation with changes made by
Karl on 2014-02-23, and also some changes done before that.
-2014-02-25 Vincent Belaïche <vincent.b.1@hotmail.fr>
+2014-02-25 Vincent Belaïche <vincent.b.1@hotmail.fr>
* latex2e.texi: Correct typo, rm duplicate 2014 in copyright notice.
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/Makefile b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/Makefile
index 3fc87677a3f..9eaf220b9ce 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/Makefile
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/Makefile
@@ -1,4 +1,4 @@
-# $Id: Makefile 614 2018-03-28 22:21:21Z karl $
+# $Id: Makefile 617 2018-04-30 14:16:52Z jimhefferon $
# Public domain. Originally written 2006, Karl Berry.
# Makefile for latexrefman.
@@ -92,7 +92,7 @@ dist: en es
zip -q $(dist) \
$(addprefix latex2e-help-texinfo/, $(txt_files) \
latex2e.texi common.texi $(en_mi_output) latex2e.pdf) \
-$(addprefix latex2e-help-texinfo/spanish/, $(es_mi_output)) \
+$(addprefix latex2e-help-texinfo/spanish/, $(es_mi_output) latex2e-es.pdf) \
$(addprefix latex2e-help-texinfo/latex2e-figures/, $(figure_files)) \
$(addprefix latex2e-help-texinfo/graphics/, README $(figure_source_files))
rm -rf latex2e-help-texinfo
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/NEWS b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/NEWS
index 00ba42c167a..dc994adf263 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/NEWS
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/NEWS
@@ -4,6 +4,25 @@ Public domain. Originally written 1995, Torsten Martinsen.
Spanish translation originally from Nacho Pacheco (currently unmaintained).
French translation originally from Vincent Belaiche.
+Changes in July 2018 release:
+
+We have gone through the two documents latex-info and
+latex2e-reference and checked that any information in those documents
+is in this one.
+
+There have also been other changes, including switching to a single
+unified index, a more uniform entry format, and many more examples and
+error messages. There are a number of entirely new entries such as
+ones on \strut, caligraphic math fonts, \boldmath, and blackboard
+bold. There have also been adjustments to the organization such as
+having separate sections for \part, \chapter, etc., and some
+combinations such as that of \clearpage and \cleardoublepage.
+
+In addition, there were many bug fixes, including greatly shrinking
+the size of one of the graphics.
+
+----------------------------------------------------------------
+
Changes in April 2018 release:
There is a new chapter on color and a new chapter on graphics
@@ -12,6 +31,7 @@ there is much greater coverage of the list environment including a
diagram of the parameters, and a description of the tabbing
environment.
+
----------------------------------------------------------------
Changes in Aug 2017 release:
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/aspell.en.pws b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/aspell.en.pws
index 52d57cdf298..de3448bc46e 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/aspell.en.pws
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/aspell.en.pws
@@ -1,54 +1,176 @@
personal_ws-1.1 en 0
+AAF
+ArtBox
Avant
+BD
+BES
+BESU
Biemesderfer
+BleedBox
Botway
+CTAN's
+CropBox
+EE
+EF
EnvIndex
+FC
Garde
+Halmos
Kleene
LAH
Lappish
Martinsen
+MediaBox
+NeedsAMSSymb
+NeedsSTIX
+NotInPlainTeX
+O'Brian
Overstrike
+PkgIndex
+Supremum
+TrimBox
ae
+afterskip
arabic
aring
+arrayrulewidth
+arraystrech
ary
+baselinestretch
+bb
+bbllx
+bblly
+bburx
+bbury
+beforeskip
+beginparpenalty
+bigfoot
+bigski
+bigskip
+bigskipamount
+bm
bowtie
bp
+builtin
+cdots
cmd
+columnsep
+columnseprule
+columnwidth
coproduct
+cosecant
cp
+cprotect
+datetime
+dblfloatpagefraction
+dcolumn
+ddagger
+ddots
del
+delim
+doublerulesep
+doublestruck
dvi
dvitype
eg
ek
+endparpenalty
eng
+enumi
+enumii
+enumiii
+enumiv
env
+envlab
+errorstop
+errorstopmode
eth
+evensidemargin
executivepaper
f's
+fbox
+fboxrule
fd
fleqn
+floatpagefraction
fn
fnsymbol
+fontencoding
+fontfamily
+fontseries
+fontshape
+footmisc
+footnoterule
+footnotesep
+footskip
greek
hacek
+headheight
+headsep
+hiresbb
+homomorphism
hungarian
+idx
+ifstar
+indentfirst
indexspace
+infinum
intercolumn
+itemindent
+itempenalty
+itemsep
lR
+labelenumi
+labelenumii
+labelenumiii
+labelenumiv
+labelitemi
+labelitemii
+labelitemiii
+labelitemiv
+labelsep
+labelwidth
+ldots
leadsto
+leftmargin
+leftmargini
+leftmarginii
+leftmarginiii
+leftmarginiv
+leftmarginv
+leftmarginvi
legalpaper
+lethead
+letheadflag
letterpaper
lhd
+linespread
+listparindent
+lr
lrbox
lunate
+makeidx
+makelabel
+marginparpush
+marginparsep
+marginparwidth
+marginsep
+medskipamount
+medspace
+mfirstuc
+mhchem
mho
+mistyped
mpfootnote
+multind
multiset
+mx
+natheight
+natwidth
+negthinspace
niques
notitlepage
+oddsidemargin
oe
onecolumn
oo
@@ -56,62 +178,77 @@ openany
openbib
openright
oslash
+outdent
overbar
overdot
+overlines
+overlining
+pagebox
pagebreak
pagestyle
+paperheight
+paperwidth
+parsep
+partopsep
+pict
+pixelation
printindex
ptr
+radians
+rescale
revemptyset
rhd
+rightmargin
secnumdepth
+selectfont
+setspace
+showidx
+smallskip
+smallskipamount
sp
sqsubset
sqsupset
+startsection
+subitem
+subitems
+subregion
superscripted
+tabcolsep
teck
tecks
+texi
texinfo
+textcase
+textheight
textstyle
th
+thickspace
titlepage
+tocbibbind
+tocdepth
+tocloft
topmargin
+topsep
+topskip
+totalheght
+totalheight
twocolumn
twoside
+ulem
underbar
+underbrace
+unlabelled
unlhd
unrhd
upharpoonright
+usefont
usrguide
varnothing
+vdots
+verbatimbox
vert
xdv
xelatex
+xindy
xyz
zet
-ddagger
-footmisc
-setspace
-showidx
-makeidx
-multind
-datetime
-PkgIndex
-afterskip
-beforeskip
-ifstar
-textcase
-startsection
-mfirstuc
-texi
-outdent
-ArtBox
-BleedBox
-builtin
-CropBox
-MediaBox
-pixelation
-radians
-rescale
-subregion
-TrimBox
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/common.texi b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/common.texi
index 4f18915713e..dc17efa9d3d 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/common.texi
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/common.texi
@@ -1,4 +1,6 @@
-@set LTXREFMAN_HOME_PAGE http://puszcza.gnu.org.ua/software/latexrefman/
+@c $Id$
+@c Public domain.
+@set LTXREFMAN_HOME_PAGE puszcza.gnu.org.ua/software/latexrefman
@set LTXREFMAN_BUGS latexrefman@@tug.org
@clear HAS-MATH
@iftex
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/graphics/README b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/graphics/README
index 54e67b5b464..bff28795fe2 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/graphics/README
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/graphics/README
@@ -1,4 +1,8 @@
This directory contains the source for the graphics used in the document.
-Note that different TeXinfo output formats require different graphic
-formats. In particular, one such format is .txt. Those graphics are
-stored with their matching ones in .pdf or .png or .eps. \ No newline at end of file
+
+The asy/ directory contains the source for graphics produced with
+Asymptote.
+
+TeXinfo wants the graphics in ../latex2e-figures/. Note that
+different TeXinfo output formats require different graphic formats.
+
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/graphics/asy/list.asy b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/graphics/asy/list.asy
index c9d58d73bf8..1a6c5fdb395 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/graphics/asy/list.asy
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/graphics/asy/list.asy
@@ -1,5 +1,5 @@
import settings;
-settings.outformat="pdf";
+// settings.outformat="pdf";
unitsize(1pt);
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.eps b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.eps
new file mode 100644
index 00000000000..17cea74f45e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.eps
@@ -0,0 +1,1302 @@
+%!PS-Adobe-3.0 EPSF-3.0
+%%Creator: dvips(k) 5.995 Copyright 2015 Radical Eye Software
+%%Title: list_.dvi
+%%CreationDate: Fri Jun 8 10:35:27 2018
+%%Pages: 1
+%%PageOrder: Ascend
+%%BoundingBox: 189 310 422 481
+%%HiResBoundingBox: 189.816995 310.126502 421.183005 480.873498
+%%DocumentFonts: CMTI7 CMMI8 CMR6
+%%EndComments
+%DVIPSWebPage: (www.radicaleye.com)
+%DVIPSCommandLine: dvips -R -Pdownload35 -D600 -O61.417bp,185.327bp
+%+ -T612bp,792bp -tletterSize -q -olist_.ps list_.dvi
+%DVIPSParameters: dpi=600
+%DVIPSSource: TeX output 2018.06.08:1035
+%%BeginProcSet: tex.pro 0 0
+%!
+/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
+N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72
+mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0
+0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{
+landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize
+mul 0}ifelse TR}if Resolution VResolution vsize -72 div 1 add mul TR[
+matrix currentmatrix{A A round sub abs 0.00001 lt{round}if}forall round
+exch round exch]setmatrix}N/@landscape{/isls true N}B/@manualfeed{
+statusdict/manualfeed true put}B/@copies{/#copies X}B/FMat[1 0 0 -1 0 0]
+N/FBB[0 0 0 0]N/nn 0 N/IEn 0 N/ctr 0 N/df-tail{/nn 8 dict N nn begin
+/FontType 3 N/FontMatrix fntrx N/FontBBox FBB N string/base X array
+/BitMaps X/BuildChar{CharBuilder}N/Encoding IEn N end A{/foo setfont}2
+array copy cvx N load 0 nn put/ctr 0 N[}B/sf 0 N/df{/sf 1 N/fntrx FMat N
+df-tail}B/dfs{div/sf X/fntrx[sf 0 0 sf neg 0 0]N df-tail}B/E{pop nn A
+definefont setfont}B/Cw{Cd A length 5 sub get}B/Ch{Cd A length 4 sub get
+}B/Cx{128 Cd A length 3 sub get sub}B/Cy{Cd A length 2 sub get 127 sub}
+B/Cdx{Cd A length 1 sub get}B/Ci{Cd A type/stringtype ne{ctr get/ctr ctr
+1 add N}if}B/CharBuilder{save 3 1 roll S A/base get 2 index get S
+/BitMaps get S get/Cd X pop/ctr 0 N Cdx 0 Cx Cy Ch sub Cx Cw add Cy
+setcachedevice Cw Ch true[1 0 0 -1 -.1 Cx sub Cy .1 sub]{Ci}imagemask
+restore}B/D{/cc X A type/stringtype ne{]}if nn/base get cc ctr put nn
+/BitMaps get S ctr S sf 1 ne{A A length 1 sub A 2 index S get sf div put
+}if put/ctr ctr 1 add N}B/I{cc 1 add D}B/bop{userdict/bop-hook known{
+bop-hook}if/SI save N @rigin 0 0 moveto/V matrix currentmatrix A 1 get A
+mul exch 0 get A mul add .99 lt{/QV}{/RV}ifelse load def pop pop}N/eop{
+SI restore userdict/eop-hook known{eop-hook}if showpage}N/@start{
+userdict/start-hook known{start-hook}if pop/VResolution X/Resolution X
+1000 div/DVImag X/IEn 256 array N 2 string 0 1 255{IEn S A 360 add 36 4
+index cvrs cvn put}for pop 65781.76 div/vsize X 65781.76 div/hsize X}N
+/dir 0 def/dyy{/dir 0 def}B/dyt{/dir 1 def}B/dty{/dir 2 def}B/dtt{/dir 3
+def}B/p{dir 2 eq{-90 rotate show 90 rotate}{dir 3 eq{-90 rotate show 90
+rotate}{show}ifelse}ifelse}N/RMat[1 0 0 -1 0 0]N/BDot 260 string N/Rx 0
+N/Ry 0 N/V{}B/RV/v{/Ry X/Rx X V}B statusdict begin/product where{pop
+false[(Display)(NeXT)(LaserWriter 16/600)]{A length product length le{A
+length product exch 0 exch getinterval eq{pop true exit}if}{pop}ifelse}
+forall}{false}ifelse end{{gsave TR -.1 .1 TR 1 1 scale Rx Ry false RMat{
+BDot}imagemask grestore}}{{gsave TR -.1 .1 TR Rx Ry scale 1 1 false RMat
+{BDot}imagemask grestore}}ifelse B/QV{gsave newpath transform round exch
+round exch itransform moveto Rx 0 rlineto 0 Ry neg rlineto Rx neg 0
+rlineto fill grestore}B/a{moveto}B/delta 0 N/tail{A/delta X 0 rmoveto}B
+/M{S p delta add tail}B/b{S p tail}B/c{-4 M}B/d{-3 M}B/e{-2 M}B/f{-1 M}
+B/g{0 M}B/h{1 M}B/i{2 M}B/j{3 M}B/k{4 M}B/w{0 rmoveto}B/l{p -4 w}B/m{p
+-3 w}B/n{p -2 w}B/o{p -1 w}B/q{p 1 w}B/r{p 2 w}B/s{p 3 w}B/t{p 4 w}B/x{
+0 S rmoveto}B/y{3 2 roll p a}B/bos{/SS save N}B/eos{SS restore}B end
+
+%%EndProcSet
+%%BeginProcSet: texps.pro 0 0
+%!
+TeXDict begin/rf{findfont dup length 1 add dict begin{1 index/FID ne 2
+index/UniqueID ne and{def}{pop pop}ifelse}forall[1 index 0 6 -1 roll
+exec 0 exch 5 -1 roll VResolution Resolution div mul neg 0 0]FontType 0
+ne{/Metrics exch def dict begin Encoding{exch dup type/integertype ne{
+pop pop 1 sub dup 0 le{pop}{[}ifelse}{FontMatrix 0 get div Metrics 0 get
+div def}ifelse}forall Metrics/Metrics currentdict end def}{{1 index type
+/nametype eq{exit}if exch pop}loop}ifelse[2 index currentdict end
+definefont 3 -1 roll makefont/setfont cvx]cvx def}def/ObliqueSlant{dup
+sin S cos div neg}B/SlantFont{4 index mul add}def/ExtendFont{3 -1 roll
+mul exch}def/ReEncodeFont{CharStrings rcheck{/Encoding false def dup[
+exch{dup CharStrings exch known not{pop/.notdef/Encoding true def}if}
+forall Encoding{]exch pop}{cleartomark}ifelse}if/Encoding exch def}def
+end
+
+%%EndProcSet
+%%BeginProcSet: special.pro 0 0
+%!
+TeXDict begin/SDict 200 dict N SDict begin/@SpecialDefaults{/hs 612 N
+/vs 792 N/ho 0 N/vo 0 N/hsc 1 N/vsc 1 N/ang 0 N/CLIP 0 N/rwiSeen false N
+/rhiSeen false N/letter{}N/note{}N/a4{}N/legal{}N}B/@scaleunit 100 N
+/@hscale{@scaleunit div/hsc X}B/@vscale{@scaleunit div/vsc X}B/@hsize{
+/hs X/CLIP 1 N}B/@vsize{/vs X/CLIP 1 N}B/@clip{/CLIP 2 N}B/@hoffset{/ho
+X}B/@voffset{/vo X}B/@angle{/ang X}B/@rwi{10 div/rwi X/rwiSeen true N}B
+/@rhi{10 div/rhi X/rhiSeen true N}B/@llx{/llx X}B/@lly{/lly X}B/@urx{
+/urx X}B/@ury{/ury X}B/magscale true def end/@MacSetUp{userdict/md known
+{userdict/md get type/dicttype eq{userdict begin md length 10 add md
+maxlength ge{/md md dup length 20 add dict copy def}if end md begin
+/letter{}N/note{}N/legal{}N/od{txpose 1 0 mtx defaultmatrix dtransform S
+atan/pa X newpath clippath mark{transform{itransform moveto}}{transform{
+itransform lineto}}{6 -2 roll transform 6 -2 roll transform 6 -2 roll
+transform{itransform 6 2 roll itransform 6 2 roll itransform 6 2 roll
+curveto}}{{closepath}}pathforall newpath counttomark array astore/gc xdf
+pop ct 39 0 put 10 fz 0 fs 2 F/|______Courier fnt invertflag{PaintBlack}
+if}N/txpose{pxs pys scale ppr aload pop por{noflips{pop S neg S TR pop 1
+-1 scale}if xflip yflip and{pop S neg S TR 180 rotate 1 -1 scale ppr 3
+get ppr 1 get neg sub neg ppr 2 get ppr 0 get neg sub neg TR}if xflip
+yflip not and{pop S neg S TR pop 180 rotate ppr 3 get ppr 1 get neg sub
+neg 0 TR}if yflip xflip not and{ppr 1 get neg ppr 0 get neg TR}if}{
+noflips{TR pop pop 270 rotate 1 -1 scale}if xflip yflip and{TR pop pop
+90 rotate 1 -1 scale ppr 3 get ppr 1 get neg sub neg ppr 2 get ppr 0 get
+neg sub neg TR}if xflip yflip not and{TR pop pop 90 rotate ppr 3 get ppr
+1 get neg sub neg 0 TR}if yflip xflip not and{TR pop pop 270 rotate ppr
+2 get ppr 0 get neg sub neg 0 S TR}if}ifelse scaleby96{ppr aload pop 4
+-1 roll add 2 div 3 1 roll add 2 div 2 copy TR .96 dup scale neg S neg S
+TR}if}N/cp{pop pop showpage pm restore}N end}if}if}N/normalscale{
+Resolution 72 div VResolution 72 div neg scale magscale{DVImag dup scale
+}if 0 setgray}N/@beginspecial{SDict begin/SpecialSave save N gsave
+normalscale currentpoint TR @SpecialDefaults count/ocount X/dcount
+countdictstack N}N/@setspecial{CLIP 1 eq{newpath 0 0 moveto hs 0 rlineto
+0 vs rlineto hs neg 0 rlineto closepath clip}if ho vo TR hsc vsc scale
+ang rotate rwiSeen{rwi urx llx sub div rhiSeen{rhi ury lly sub div}{dup}
+ifelse scale llx neg lly neg TR}{rhiSeen{rhi ury lly sub div dup scale
+llx neg lly neg TR}if}ifelse CLIP 2 eq{newpath llx lly moveto urx lly
+lineto urx ury lineto llx ury lineto closepath clip}if/showpage{}N
+/erasepage{}N/setpagedevice{pop}N/copypage{}N newpath}N/@endspecial{
+count ocount sub{pop}repeat countdictstack dcount sub{end}repeat
+grestore SpecialSave restore end}N/@defspecial{SDict begin}N
+/@fedspecial{end}B/li{lineto}B/rl{rlineto}B/rc{rcurveto}B/np{/SaveX
+currentpoint/SaveY X N 1 setlinecap newpath}N/st{stroke SaveX SaveY
+moveto}N/fil{fill SaveX SaveY moveto}N/ellipse{/endangle X/startangle X
+/yrad X/xrad X/savematrix matrix currentmatrix N TR xrad yrad scale 0 0
+1 startangle endangle arc savematrix setmatrix}N end
+
+%%EndProcSet
+%%BeginProcSet: color.pro 0 0
+%!
+TeXDict begin/setcmykcolor where{pop}{/setcmykcolor{dup 10 eq{pop
+setrgbcolor}{1 sub 4 1 roll 3{3 index add neg dup 0 lt{pop 0}if 3 1 roll
+}repeat setrgbcolor pop}ifelse}B}ifelse/TeXcolorcmyk{setcmykcolor}def
+/TeXcolorrgb{setrgbcolor}def/TeXcolorgrey{setgray}def/TeXcolorgray{
+setgray}def/TeXcolorhsb{sethsbcolor}def/currentcmykcolor where{pop}{
+/currentcmykcolor{currentrgbcolor 10}B}ifelse/DC{exch dup userdict exch
+known{pop pop}{X}ifelse}B/GreenYellow{0.15 0 0.69 0 setcmykcolor}DC
+/Yellow{0 0 1 0 setcmykcolor}DC/Goldenrod{0 0.10 0.84 0 setcmykcolor}DC
+/Dandelion{0 0.29 0.84 0 setcmykcolor}DC/Apricot{0 0.32 0.52 0
+setcmykcolor}DC/Peach{0 0.50 0.70 0 setcmykcolor}DC/Melon{0 0.46 0.50 0
+setcmykcolor}DC/YellowOrange{0 0.42 1 0 setcmykcolor}DC/Orange{0 0.61
+0.87 0 setcmykcolor}DC/BurntOrange{0 0.51 1 0 setcmykcolor}DC
+/Bittersweet{0 0.75 1 0.24 setcmykcolor}DC/RedOrange{0 0.77 0.87 0
+setcmykcolor}DC/Mahogany{0 0.85 0.87 0.35 setcmykcolor}DC/Maroon{0 0.87
+0.68 0.32 setcmykcolor}DC/BrickRed{0 0.89 0.94 0.28 setcmykcolor}DC/Red{
+0 1 1 0 setcmykcolor}DC/OrangeRed{0 1 0.50 0 setcmykcolor}DC/RubineRed{
+0 1 0.13 0 setcmykcolor}DC/WildStrawberry{0 0.96 0.39 0 setcmykcolor}DC
+/Salmon{0 0.53 0.38 0 setcmykcolor}DC/CarnationPink{0 0.63 0 0
+setcmykcolor}DC/Magenta{0 1 0 0 setcmykcolor}DC/VioletRed{0 0.81 0 0
+setcmykcolor}DC/Rhodamine{0 0.82 0 0 setcmykcolor}DC/Mulberry{0.34 0.90
+0 0.02 setcmykcolor}DC/RedViolet{0.07 0.90 0 0.34 setcmykcolor}DC
+/Fuchsia{0.47 0.91 0 0.08 setcmykcolor}DC/Lavender{0 0.48 0 0
+setcmykcolor}DC/Thistle{0.12 0.59 0 0 setcmykcolor}DC/Orchid{0.32 0.64 0
+0 setcmykcolor}DC/DarkOrchid{0.40 0.80 0.20 0 setcmykcolor}DC/Purple{
+0.45 0.86 0 0 setcmykcolor}DC/Plum{0.50 1 0 0 setcmykcolor}DC/Violet{
+0.79 0.88 0 0 setcmykcolor}DC/RoyalPurple{0.75 0.90 0 0 setcmykcolor}DC
+/BlueViolet{0.86 0.91 0 0.04 setcmykcolor}DC/Periwinkle{0.57 0.55 0 0
+setcmykcolor}DC/CadetBlue{0.62 0.57 0.23 0 setcmykcolor}DC
+/CornflowerBlue{0.65 0.13 0 0 setcmykcolor}DC/MidnightBlue{0.98 0.13 0
+0.43 setcmykcolor}DC/NavyBlue{0.94 0.54 0 0 setcmykcolor}DC/RoyalBlue{1
+0.50 0 0 setcmykcolor}DC/Blue{1 1 0 0 setcmykcolor}DC/Cerulean{0.94 0.11
+0 0 setcmykcolor}DC/Cyan{1 0 0 0 setcmykcolor}DC/ProcessBlue{0.96 0 0 0
+setcmykcolor}DC/SkyBlue{0.62 0 0.12 0 setcmykcolor}DC/Turquoise{0.85 0
+0.20 0 setcmykcolor}DC/TealBlue{0.86 0 0.34 0.02 setcmykcolor}DC
+/Aquamarine{0.82 0 0.30 0 setcmykcolor}DC/BlueGreen{0.85 0 0.33 0
+setcmykcolor}DC/Emerald{1 0 0.50 0 setcmykcolor}DC/JungleGreen{0.99 0
+0.52 0 setcmykcolor}DC/SeaGreen{0.69 0 0.50 0 setcmykcolor}DC/Green{1 0
+1 0 setcmykcolor}DC/ForestGreen{0.91 0 0.88 0.12 setcmykcolor}DC
+/PineGreen{0.92 0 0.59 0.25 setcmykcolor}DC/LimeGreen{0.50 0 1 0
+setcmykcolor}DC/YellowGreen{0.44 0 0.74 0 setcmykcolor}DC/SpringGreen{
+0.26 0 0.76 0 setcmykcolor}DC/OliveGreen{0.64 0 0.95 0.40 setcmykcolor}
+DC/RawSienna{0 0.72 1 0.45 setcmykcolor}DC/Sepia{0 0.83 1 0.70
+setcmykcolor}DC/Brown{0 0.81 1 0.60 setcmykcolor}DC/Tan{0.14 0.42 0.56 0
+setcmykcolor}DC/Gray{0 0 0 0.50 setcmykcolor}DC/Black{0 0 0 1
+setcmykcolor}DC/White{0 0 0 0 setcmykcolor}DC end
+
+%%EndProcSet
+%%BeginFont: CMR6
+%!PS-AdobeFont-1.0: CMR6 003.002
+%%Title: CMR6
+%Version: 003.002
+%%CreationDate: Mon Jul 13 16:17:00 2009
+%%Creator: David M. Jones
+%Copyright: Copyright (c) 1997, 2009 American Mathematical Society
+%Copyright: (<http://www.ams.org>), with Reserved Font Name CMR6.
+% This Font Software is licensed under the SIL Open Font License, Version 1.1.
+% This license is in the accompanying file OFL.txt, and is also
+% available with a FAQ at: http://scripts.sil.org/OFL.
+%%EndComments
+FontDirectory/CMR6 known{/CMR6 findfont dup/UniqueID known{dup
+/UniqueID get 5000789 eq exch/FontType get 1 eq and}{pop false}ifelse
+{save true}{false}ifelse}{false}ifelse
+11 dict begin
+/FontType 1 def
+/FontMatrix [0.001 0 0 0.001 0 0 ]readonly def
+/FontName /CMR6 def
+/FontBBox {-20 -250 1193 750 }readonly def
+/PaintType 0 def
+/FontInfo 9 dict dup begin
+/version (003.002) readonly def
+/Notice (Copyright \050c\051 1997, 2009 American Mathematical Society \050<http://www.ams.org>\051, with Reserved Font Name CMR6.) readonly def
+/FullName (CMR6) readonly def
+/FamilyName (Computer Modern) readonly def
+/Weight (Medium) readonly def
+/ItalicAngle 0 def
+/isFixedPitch false def
+/UnderlinePosition -100 def
+/UnderlineThickness 50 def
+end readonly def
+/Encoding 256 array
+0 1 255 {1 index exch /.notdef put} for
+dup 48 /zero put
+dup 49 /one put
+dup 50 /two put
+dup 51 /three put
+dup 52 /four put
+dup 53 /five put
+readonly def
+currentdict end
+currentfile eexec
+D9D66F633B846AB284BCF8B0411B772DE5CE3DD325E55798292D7BD972BD75FA
+0E079529AF9C82DF72F64195C9C210DCE34528F540DA1FFD7BEBB9B40787BA93
+51BBFB7CFC5F9152D1E5BB0AD8D016C6CFA4EB41B3C51D091C2D5440E67CFD71
+7C56816B03B901BF4A25A07175380E50A213F877C44778B3C5AADBCC86D6E551
+E6AF364B0BFCAAD22D8D558C5C81A7D425A1629DD5182206742D1D082A12F078
+0FD4F5F6D3129FCFFF1F4A912B0A7DEC8D33A57B5AE0328EF9D57ADDAC543273
+C01924195A181D03F5054A93B71E5065F8D92FE23794D2DAE339BA29C1C6F656
+1DEF13780383DAE38A868377CC7D396B2A05F341AEE0F8BD0A0191F51AD11A4D
+2E927B848A1EF2BA15CFBE57A51E3AF07598275195C9613041F71C1AF39E61F9
+EFD5F6512FBDA76E29DE6B508F62F5CF9F73F5288DF1C7B0B82C92D3B6358BAD
+EC3CA20BDE55DAA7CC58004AA86B6CBF8C410D8287E88BF20588A39309C2B703
+CED322F030AA6069869064486CA651DA054FF3F5E56534CA358B0829A6B954D8
+9103436E6B06DAD1658BD4A95AB41343B01F5866FC87C4EDFC71F1477C98F8E1
+1DCF27EF743FF90BF918AB8C4E5AC35841E2F745480E5EDE1C1DEAFAD8D0018D
+2C1F1CFCAD9F6609859DEDFD1648A6CD23D8ABB80747F94899F17C8F3E6CA55A
+E176F19CDFDAA0D7C920B3A72051A4745560AC81978C92459EEE5AFE85AB247A
+32981139CBE352B248F4BE5F73503A084A3E91F05328EE521D9669E44E202584
+5407E7846F9FEE3D54EA18FFB144BF2D6803BF65AE402034B3CDBB40DD24217A
+3CE0E95E2717CACD603A958187C42B3558AA38D6B6390EEEDD396F96E6041FCF
+6F8888221AFA87EAD79F46E0E32CAED91E6C8500879AB6E580C581E8C8CE9B68
+2BB5EFE2604E8DCB2432D39D75EE556969F1B2FBDF6A4BC72D106AA7CF22C268
+464027898B311613E06E1584707F262F71D9F49D2149306A88E02BC60BBD6BDB
+EF41D90F19197BA9AEF32B5E63D5B9FF41B5602F9F786E76621DA54D574981AB
+87A72081EA05D6C6BA940EFEBD0904EA4E77BBCE17E20B42E1722617E0F6EF32
+F1ACDE9D758594E9C81049CCC10605A27C2A06872FBA9F159CB155609B496ADA
+4886F478E44029B5E620DE8319E257697E93E1CDFD27D560E2E4D34507020E2C
+D9FF06BFA14E056D81DF701FAC3ACE4BE6C098AE116E079F0044391EC1661F6E
+7A93B9320BD7F91E8FD2E8EB3F5CAE997D5CDD35107A1D35302260D1499B8B65
+39625B7925F97D917B66BAFEEA992873F07220714F192839948CEA080BDB9A03
+77B9DD032273DDB5629CB28B5D8797EDEFDBC601823E038384C90C79012A7D96
+8F27784DA15BACE21501C26E3AFA5DCCE81B52B0ABAF71A35D33103EA86F2415
+A39A830D559C5C6CA7423945BD3DFA942B20A06D7A8D8671F9831DBB52907AB4
+4E54776D29C6085CD9970B6DD21DD3EA8EB09C49CBEC6CDCEEB0BBB1B8827109
+3BDE64DDA024D67F098D6C1998506DDFF7907ABAADA1C39C759C850E0C6F8E89
+A392D1C9329ACFFA92D361218D75E115F70A47C53B73B356D703E9C499AAD098
+AA9C8119EE9E9708A9EA3049E976FA19AD04210D5F6092C7903FD155113F3A3F
+269B746560F70970AC9F8D09956E0E84DACE4112C4E7C7F6B3F0B63D26EFF95E
+2B2E9699D16BC8AFC4AD9113AA3A974C9E82E877288CF71E9169D2DCC61AAAA6
+C536E5604EF0716F6487292BBB677518504B52C63822BED3BD5FD14EB41EE6A8
+AD4B6CF90D39F98E12A765B645CBA3E8552FB9A986390212CE119E7C3DD675AC
+17BD006144BEC534DA2A860188619F17589008409C5A309CB83FBA70F6446B6E
+2B56991B6A03B1DE10C621591CEE45BECA27C54BC8B4F1754A9E8F660812710E
+117850E1BB6FD89BB13F8CE391C43DA89EA67E9C3E7A4697790EA26B0E4E2E80
+DCA508873A7AFFC11B8C02EF86C2316E8D8B6BCEA37F81A3A87546705F070C3B
+9D4D28C366CEBC1EE485B8E2357DBE46E86C87B9939DADA60888AA9F1B92FECC
+CC1C198DDB594BB70A8FE690ECAC21A414BAC89BF019F34D2A130F485EAE35B7
+2A10C67EA3A48A4D9734759CC93AD85C6A570500AE5AC9973FC76EFA06BF5DDC
+26E20E28D16B50957EE01AF2653F8D860817967AA5A9BF9BF7ABCDA710E9F34F
+4F0EBCC32B3C9C2971F6225D2DAA6A451366B83F32B2ACB83E746D365B2DE38D
+C1AB7447FE7B37F9630E410E5D8F0ECE74DF46C538947B3A167AD9F3E4A7EB3D
+60F5425AE75AC3A27D39311DA35696C3DC7282AF1532E7AECE63D13DDA0296A2
+01487185FDF1875AEF55A36C17D6A8DD329279D229259463A2F05CB7A874374B
+E2320E1F6CFECB9C1CE62FF468C29751ACD9754AF1EABE8E7696C2888914416E
+235B6766F20FFBEFF285277B639A51EA2F2E30D207BC891B00F0436008F980E0
+9EEE7FB375BB069B9E0BA11DA951A99D8E60B4F920A0495C247FA7DE904765AB
+DB5C3B2D634757E43EDD6FAA4DB3C67F82D6853E1170F0B2D8CE496DD4E72B0D
+28277BEF172F1402959F64527F9B640619F04416DDB9D05FB2ACD019CB9C119E
+E544D24EA6DAC5C69785394EA50E6EC9AAA9E14B904EAF29A733C6D7942B63F4
+85729686742F26DEF78DF0DA1CA7CEFBB684F4CAD99021A3B3D1FE03B9C5A4B1
+BD04CAC89BB91B11952A2B17A61789BEE0C54B46C03FE9A1AE73D17CF94BA30A
+237C29D414C3BCE8E3E2DDF83C0BD59DCB66C4D2C3DE73DA8378F3C6C8035D28
+7464399857E57651A53E9C4AA68DFCA91B2376CF98AC5290FDB9BDAD9EF1604E
+9B0A70EDDA1E564B6D2456E7BC722454ACA8C4950FDD44B6EB9AD01169A9F845
+B06A0DDB7897C847A5B1F42258AECF3807AE936C8F52C3A7A0A85D68160AE442
+FE81543DA6702D76AB6E8701F80DFC1D87C961E350D0E52AB2A298B9E5908600
+7E14D2A87309043CBF13F69AEAAB1BC239DEA88EB5176624F6046664B1D2691F
+FBB2071D3706F97DCCA355A6DCC4D09FD35DC078FBAAF672FFDECEC61050A120
+10B5A96629041303FD01ACCC7686165DED6AA712FF8E5E85DE33C4E7D877C49C
+6C469A90410BAF60BE65ECD91CDC2EE7AC0CA8BA7B53865F26092BFCAA0BCA77
+B80DC51DAD09C93C8DD8E43502B4B68F3D5918C3492196292447732BA90F5AB4
+9F5E1D634ADE1CCAAD028DE5EBA9535F6FC5908DBD2D643E0A7E059C8C386FDC
+E72659C0033F535C0D7F6B98D0335552D0BF3C6E302B672A5EAADFCEF81912E3
+8F54E6FB7EC2B325125159713D0AC50DEE3673B9B148643727E94C80971A2E73
+5E1E13237BE69C84FC039DCE02ECE2668AFD047F21A61BB94A9F498C9FE5CDEA
+B274B40728B6F6CA9B6C15BAAF92F465B0D7311B46545CBA90D874839443CCB9
+3110F052EB247B24B45A3D2FA6FBC7EB2A4BEC2A5892914B3C5EA3F4F9B9DCBF
+6F932D95700E045B49E4B1F2C9D2A42CF39CA2F5A2654E6E8E6E92473D28AACD
+5E35C6705EA728F704F5996D286BED433F976AB7E018621A577AED7C0AC0A84E
+A032FE1869F603E6F20386E3A190A30A21EA886249ECF8CDDE2C33D73BA8647A
+3DCA7A8DD9E8EC8D9A415D126BA38B6771C489DFC419303EE9C1B83FBFB3A0B8
+97D64F30E4BCBEC24DF603FF3BF541E00D5804B6B6543D3D2B661CC551D497A9
+9DFFF535AF424B2F3150BB39AAE8CDB306AAD37767BA10BADB031DC2FAB16955
+EE78342CCC0E8B5976BF98F215461A8C6F63EBE6E2F1A1104662DDE53388CB51
+8B44F3534853B8095F3B746A2459C2EF800FB1EF7F235EBAA9731E3AB3BE4369
+1D3636E3ADD5BDF0C34FA80E90D8A1DDE770943FD196E0A7C5F1FAF6970B34C6
+4673AACA6B2B5C12B9608521AE736C1F4B97209B063D991300ED5AF3D7F27E76
+68E0B858FD8BFF86581E2B9548C691E3E5D9EC4D39C9715CDE86C7D22223CCEB
+8A38C776A30AF14912390A7546DBECECD7A687D4F08646E57A12C80DCA022B7A
+33399761A50B8E0ABEFA1163EDEC3DFB5DA3248792EEEDD894872D4E6814B4C3
+548BAFCDE0CABBCDB97EC6D1BA47F2E77CC1389BF19D73661749AC33F46A618E
+A665A85776545BF9662F2179D7BFD604FA8EF4700591AF3AEC647E27B24B76F3
+133F9198DC15C1AED830E737909E43EB91C334C44BA35810007A3888E33F5DA5
+B3B2C35481C648AFE630CC3E08F77744E401B2934E407D1EC17ECE737606B076
+F8DE8EF3344F57495EF49D11580D6FB28AE0B1422521B320843B13467501CAE2
+3DB93D7BB779F73B6AA30050DA74BDBC3F8DBB30F32EAFD07734A151BB2BAED5
+C9B1F790059339B64BB4146470F30928C9A49AE88906BD6FDB7431A4B50809CE
+0F67ABA01CDCC2320B0B097187B9299E3D80CDD7BB5DD5BFA7B28D924C5633C5
+45A23CCEE097C41C3759C1FA8DBA0DD95034BCA89BD23FAC18C70093F40FF2F8
+0FAC5DD4835F2DFD40540E9A9E9FD951A8AF2CB766597DE00147B163BACFB7E6
+EFDA4DED594F1C746D8B46A1145E0E4058F5917B3F21E9BEBDE745EE72CDCA64
+FB31EF7A2E55265F32559480E2B6726D3DE26FFC97EB4E3160F117E890C4B2E5
+8DF310E6A728ABA85540F571C024F8DD58E1D7827FE97CED5EB31547EBC36415
+02B8C0E10B7E37D816F01D56A364B8552CBFAAA95BC4BDDCFDE91CE0EF005B4B
+7AB56FFB47A093AEDF0DE1EA48FC8103CA3CA1470864D2693E360006D05668A8
+AA422CCCED20DCEEBEA5CE0DA1EFB00FB93E922B18124FA11A88D0F6E0F719DA
+57603DD5DA42E1C56C2FD9E5415AA199D4F334C151C1157E75C107FBBFCEB706
+5F4EA47A29B54ED8CAEB8DDA2F53D2A703B95487619780A52DA1270011648A28
+AA64338E04AA5B92C1EDF3D8DA34FA6D227A0325EA6F22E9B38B6338C657BB21
+CD4C582DC04010330F62923F817E4EDC6E5C0E6500F2A975A8A95BAA30C4A134
+BB31B5AC45A2E7F6E9CDFC810D41344C4F606049445F8E93D74271C1E29DF7CB
+5459593BA28AECF64D903D3E4D77CF5C04B06DE44A41EE4D9FC769854503AC85
+69E4A5106E84016DE3D59865D4AB30BD6C9E45C45DCB5408421CC50CD6179C85
+34E55CC70FBD8FEFE9F1D5160664981716E3BC7F24B6F54E0323D9BC4B692971
+24419EE62D8B0BA726E2B4294A9A76F328B8101DA29E78BD5C4AC383350FE196
+4D42DB1653637D19530124858950C22F1E9CF5BC07D46B7A58CDE19CC88DCD2E
+7FE4EEFD8AA6047E919823C8CAB2EF5274F45E861E6508CC11A8AA90AED2403A
+B2BF1315C2157B3B50A3685205D93E40906EEE9DE5985405974BCE0B84BB37DB
+080A45C5237B269B93C0A7CF294A18B45464A41F604C494CBEF829A381155CFD
+71CEEA54CC39EEDB6DF58A9896246B09F95DC6BC40BA6916AAB5ED3D24F66154
+3662F8978FC63DA9280FF7ADB09EA5BA79D3B66E0C88BEC1EDD78DA93839073A
+A4D7B0E627000C4ABA76C47CCFEE92E319315333A5584A951E34C55412049C4A
+A5569FE65A006F77B416E0530AB6A8E7AD6C72340AD4CE25937158FABB2153EA
+281E1D840206F5DA38E00815E9081F81DAB9FAA8F4DAB305867AC84735DB4F52
+A36129929BD2084A8EA37BB6889695204BF7290B68D5E722540BF8A276F8BB6D
+451D582EE59D2FF03F6B97DDE05FA00C3D375D2D0AAC8FE298F85CC067B15481
+48D70B6A0354C705715B891915FE8EA45244677B9FCE81E72D66177E309F3F83
+F744B9EA9E55C3B30DEC6E5E03B3988FD526A82A5E8E1DC79127FC62B2FA7949
+B3AD3148868DE22BD4B5708E32CEAAE6ADEED1F463EAB9692411E18F8D6BF391
+126B2700B4CF3B59D02E3F8795130C96285A63FCD1E0F647ACB1D35E9C58BD01
+1DD06BABA00CA4343BEBEDBE677E053E9732B33A7495DF51782A07DA07F5646C
+770C957AD915CC70BA8E08BE7A1F4E6BA5BB9C603E38F6FB0A2578471C4D02F4
+283069856D926B9076EC73AA39CEB0A061AFF1575C7093FDAC9F89C3DC06EA45
+06F3C2A3BC9FF21128B10CB758DF0F099B459A5264A8C24C098110D2BA1A8532
+8FAE146A91BA7D033F591AB1A94B8A6FE0FFB610F698D216D58B4EF6C87B1524
+8037CBB7E23D8550A620341C6625A1A2ECE7CEE2598D66277F857231A36155E3
+984F147783E9B93975AC38A29F2FBCF704C8A04AD84C3E04A12D2321FA56811A
+5B6744813CCC187968C5C26BB8D3E6615A912FA5369C01CCF8C0DB790593B190
+1A90CFB5339B8771F325C5FC448D36C7312B11A15A8635BAB59CF3CAD176131E
+026F6E141B2619EF7F3048750CC9291397F141591EEC8B612D6656DD34DB54D6
+DBDD303CED74BE76664E7DC86FCFEEF2001C9DBA56418FB61F589566A47AF36E
+C94671C5E8939AF9F4D53C0DE7142B7B63C86AAFA65877EBBB48C64589AFB2CB
+1280AC099FC48058855CBDEB6C2D2A0D092267996591DC3B5EC8252984E9B27D
+2E9EDE8CD8303F0905DBFCAE497DE1B755B924452CDE11CF4F20893DD6FF7251
+427F520FE00580DAF1703FD968E0F8ECCDE618E1EA5820EE6CFED97C78864EF6
+26FAFEEE194A268F24249D44829AA360D731C34DC285501E966A959180718F72
+6330E4CC060588A2F65AE64A720DCAA818D49D4440F5D0B6C1F6C3A107E12445
+F1BED2D3FCBB87A9597F01C7332AA79143564056219BF87D4B907A04F77621AD
+054935E883B2B137D3D1C4BC792E8335CA08B6D83227F35736C41312A0BB077A
+60FC6488C5E02FD51A10AC113D4EF70038C649C1677B2204A77F2ECBE9B3C341
+F4126BECBCA61E3F3801F9188A3775924A62D30FB096B440286FA655EBA00A74
+9A4162904BEA07CE68EE76018346DEEE20839C9A2FF71179B58E1D4AB30856B5
+F5D97295A097174467010B15D733AAC5813CAA633746B430B1AAF9F997FDAAFD
+436844D1A56B8E25A89D2CC4BA6EE7ABD167818FD4F6C747E07B262C99EE2C35
+323F0B471586CA50F54C6381B052B15B0C58C19DEA82C0CA29F00400B727419B
+2379979CDCBFA966AD513FA903160C571C3BF1BA239540B11EF2371A3880837C
+6D6CA2F374280CFA1586427AE975A2AEC34244874E4D441DBAC6CD1828841C91
+069AA87FAE849C5DC7C9EC1B9876E59F3CCDF8BB23D939F5348D7486934BFB02
+CC5A22541ED352616830A510DE7732E5D8F7E785BBD31C2BC9D348CE5632654D
+2C1740F89D57FB2AA1FD8FA3304EA03F757BB8F498ED98E48485722E78D97B12
+A05F3A28438084D1CF90AC4C3FFCD7B3365941C45E1E02CB13CA1E99F7FA1D00
+1C9D489D5C95F019AB4CE89FA3B6604473DBD2CE8E278969E0A0FCBCE68C23F6
+9381882443D3FC16966555FC222F3FC4B1207522201AB7A15A7A6F22CDC9D392
+360BF4C95DAD35770E0AC7E5EFF015F2C74ED7391F40EC94B8D1C163B5DEE5B3
+911A20C2625AD3B24BD94D2A42405E655DA47D3F94F882CA2F479437B4E0BE71
+8AFA4482C6FB270F8D05B4599A01403DAAA90C01DF3AA7C2BC7E66AB6AA833AD
+FB6E5EE13E45CC7CE7E200FBFE639F9CFFF5D08512C02764997FD28368969BFB
+0876F236EF6189BE73AD827332DF1B2EADEAC0ED3B939CE5BC3CEC78975FC636
+44FCBC2CCF4396AC7343EC62E0E4F3DFFA2B880BF31D93ADFE201BE9CCEC8BA5
+0B9B919E05B851E0909968DA259EECC6AA0743F25247978CC09C28C4F878E29A
+5070E4023BCE95FE0ACCCC01D0EE219FA8344E8F6D7D4347563BF8AC030B9097
+41F24D4BC9494915A82EE9FD37FBB6A46BF077B728FB569B1258CEA5F51F36BE
+4F4D0F890D782E44748CA3FE8C8A515998371D9C7D2311F192B4B7E7C68FC6EE
+3F7136714C282A2570FE591F247A08319CE9EF1E43274E4E57166E31A2ECA506
+85350DA31AA4C33C9687F5210BA225EA1007C444FBFA2126769767E47A967884
+9F68589E4BAA9ED32A7A466DE35554C132810C68ABDAE536D9D884352F28EA02
+8A555D2CE11F30598F44A65E2D86B43ECCBDEED9E4E5B5B7DCDA20EAA09D9FF7
+422FC91F2201431A9E8FC624FF44D26C0100183D77BC7E6B1A6CFBD3FA8BABC1
+AE4CB0FD382E26BE0A83169B46D91429DCB746A0326243E212F802AF6A56C709
+6E70C6C7CF3FECCB1FD2D9A72599897FA4D73C59F4F6F92DFBD30E980A4FFFD4
+BCCF3638857C25472CC6221ABFBB26602F8C5D135AB07FE01241F14D1682A113
+D876FCE18651F51480956EAD45C917536EAF056883375D5EDD537A622AEFF068
+AA9843D4DB84EE629E9FF471F29791E13AAC5C9BE03A7718A3C9D9471AFFCC9F
+DC488F544302CEA37537315B50B51D8D6F1E0BEC0CBACF6768CC965B44356F09
+3B8D5E21CBDB8B8632C2EF3A0968DB6CCABD111CF636FA9F1426140E18DD9BD4
+C5D34017A12D8C3FE14305A52FCF07E05C524137918FAD1BC6520550910C4B09
+6DD603E9F8B0FB54CF49EB5D4C9BC1AD170D4968AC5A5555EAF8475807DC3997
+5B85610B2D9A35F77E288F704637F6FCA5BAB15E6B5EB62E489645CCFEB03678
+47575BAB9DA79E0B4A74DA4FD947065224628BE90D4D8FE238068EDC9878A637
+AC12A32B2D587844F40FD2CFF0CF71F0F345F5D079DB03AC9F62F515A9F82DEF
+AD6142B8FA3B7584C4248A63E8798077B2A869929F1C42A33B0F15FDD13E2984
+747975A3B2AB758385383114916F0957D8AC7CA5E883B1C02A8391167FA1AECA
+41189AD4E2DE4D013802F2D8A52B4A9CA7588D4C5727A2A8385AD70EE0711F92
+A2D824646B0178FB7C2440DF10C79CDEBD4BA5003418FF59D34990A603D05127
+6CB5C7A58634007AB3F4AEDD8ED599245E3640A7CCFF5BDB5B5C17FCB58F7802
+A50315C6D1272BA25783A3A44341C3D18DC30B08FB085A74CD2112AB78F9F7E5
+B66C0F6ABD6B864A2678B0F880D1027A1310DF443AF1AC33BCEA9B97C217A9C6
+B17DAC9C619EECD2BE5D4872299BD56670FACC102D5C86BFA2E9912365C05261
+978C8626ABE3F84CC9DC5A9D0F8124F7D37902FE16D472EE0653FCF39D977883
+BDE383BA97294A2D910278CC1F3759DCF04AAB18384AD6F54D7919DDB7C78FF9
+90ED9B7BDD7E38813234D0FA6CAF6489FB0B941D69C94750E1DDEC285AA5B23E
+3DEE1AB7DF1D5DC0378397D85EB58F61662EFBDDAF8D93CC91D3D762D40AC8B6
+6771AFE1880350F109DC37ECC8EB78BF1B0D2FB9A5467F3B0CA8390E2BC7AAF8
+F1AFC68371E4F92D3C4B73F59C29D1A283F6D94781C9092EA41359FAA70677BD
+DE9E2C55EAA5DF6C5E0EC677B9FDDCBE6D80597DEC8240E415F460780114F938
+8B94EBFA75974941C4AC925CACE0E6591100E2E4C36FE00852E85C8F33AEA3F6
+AA9B05177F4AC309156E1000FF98A2522CA26DBDCD7129F34E451E6851B3E7ED
+D0671F7B76BCBD48A930A379C8048D4566346C8B61F55BA05790128B0848A5C2
+F5AD37766A15CBCD676C8F96464DEE6A73E98F085551162E17D108421D2DDC0D
+4325AA4DD56A9B0FF23B79CF13FFAEB921D0F46DA1372F40D5720C0B198ABE91
+23B8BA7665E9178678F67DEB7F84C14A01AEE494B826A15967C3D876F79F618E
+8BC450591BB8A052315EF34776CA7DFD89018D68D93BBD84E12E9FC05620904D
+F37391CFE6F648A7F922CCEA2D36CF37BD8DE022B4774A6F684DAE841E557485
+41E00B81FB13E16EB2FBD8B4BD8D14940CE689A3F111
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+cleartomark
+{restore}if
+%%EndFont
+%%BeginFont: CMMI8
+%!PS-AdobeFont-1.0: CMMI8 003.002
+%%Title: CMMI8
+%Version: 003.002
+%%CreationDate: Mon Jul 13 16:17:00 2009
+%%Creator: David M. Jones
+%Copyright: Copyright (c) 1997, 2009 American Mathematical Society
+%Copyright: (<http://www.ams.org>), with Reserved Font Name CMMI8.
+% This Font Software is licensed under the SIL Open Font License, Version 1.1.
+% This license is in the accompanying file OFL.txt, and is also
+% available with a FAQ at: http://scripts.sil.org/OFL.
+%%EndComments
+FontDirectory/CMMI8 known{/CMMI8 findfont dup/UniqueID known{dup
+/UniqueID get 5087383 eq exch/FontType get 1 eq and}{pop false}ifelse
+{save true}{false}ifelse}{false}ifelse
+11 dict begin
+/FontType 1 def
+/FontMatrix [0.001 0 0 0.001 0 0 ]readonly def
+/FontName /CMMI8 def
+/FontBBox {-24 -250 1110 750 }readonly def
+/PaintType 0 def
+/FontInfo 10 dict dup begin
+/version (003.002) readonly def
+/Notice (Copyright \050c\051 1997, 2009 American Mathematical Society \050<http://www.ams.org>\051, with Reserved Font Name CMMI8.) readonly def
+/FullName (CMMI8) readonly def
+/FamilyName (Computer Modern) readonly def
+/Weight (Medium) readonly def
+/ItalicAngle -14.04 def
+/isFixedPitch false def
+/UnderlinePosition -100 def
+/UnderlineThickness 50 def
+/ascent 750 def
+end readonly def
+/Encoding 256 array
+0 1 255 {1 index exch /.notdef put} for
+dup 104 /h put
+dup 118 /v put
+readonly def
+currentdict end
+currentfile eexec
+D9D66F633B846AB284BCF8B0411B772DE5CE3C05EF98F858322DCEA45E0874C5
+45D25FE192539D9CDA4BAA46D9C431465E6ABF4E4271F89EDED7F37BE4B31FB4
+7934F62D1F46E8671F6290D6FFF601D4937BF71C22D60FB800A15796421E3AA7
+72C500501D8B10C0093F6467C553250F7C27B2C3D893772614A846374A85BC4E
+BEC0B0A89C4C161C3956ECE25274B962C854E535F418279FE26D8F83E38C5C89
+974E9A224B3CBEF90A9277AF10E0C7CAC8DC11C41DC18B814A7682E5F0248674
+11453BC81C443407AF41AF8A831A85A700CFC65E2181BCBFBA9B440A6DD72BF8
+97084C906B05FAD969086ED21AF0AA1471613182B26117D7494DD9F9270EF3ED
+8DA4D957225F75D060237B6DAAD5A0AE3E702B3D1C437835B93B8AF1F9E7D966
+E739CF3AD5E256F90286A34069E5BB4122F94F18F3485658D0D25B938522A879
+8215A417CA2CBD20F71C5C5FCDE21EEA7BB27876D93BA667868A419287FE59BC
+F538980597DBBA743DBBDBEBC61E3286DA7977833DC8BFC5E52FF5DF5EFD9A92
+D070EB769E31E760A50FDE012DC0057835E8B9B046FCC83F1A0C40326AFB4E3A
+0CC3BFA35FCC64E32854F32EB7DF10A19F95830136BBB8139DE1663B7FD790CE
+464EA431AC109FCA0E03F3E0D355FAE20AC8774D6B1CE233C27680C77DDA7356
+560A27C75993E8C980CD1E3B0683F7E8A05119B3AD567DAB4851B66E418687B7
+F9B21B3BEF607918D5973421B68E65DFD8B6C8DFDCF1CAFE2637D365148EBCE3
+FA4CC00052A2A522205EA3AE3461CEE02042E1A3F11467CB6C8C849B200CCE3D
+0BC188EC7B934CBBC0AE2BF5DEA228181DBF0F774119F313516E7D97FF532621
+9278F856C166CA6547504F34991D588A0631A5CD06363F3FEE9FA0772C783447
+ECD0A200929CB58EBFB6B72008E4082B5D14AA560C24915B9463A92F38237886
+C35CBB2D4DD6D0CA8C1D4EC46093041C6181C2F6586EE3E7D4E647A107B6DB23
+DAD9AB5A0C2905455FE58075EFF6B48597078BFCCDD84812B98986F34987CE49
+7EFB19814F2A58B0233A59331F6F8EB66401F04EE7B1ECAD9BC90A2BCEBE213D
+DDDB1F75C83609ED6A669A0CED58B2E269E76ECF73616D94F13CF827C9BF354A
+E82202988DCFE856786B8AE569AFF3105B55C72C58D310FFC0E10B2ABAC8DB06
+40D5F72E54770E9DED1AF4616008595B8481E3D9AF4191CC9A5BFD9DDD01C9F1
+FE7165D21E488DB40879E863D470CB31CA06E5B5F1F8C3CCE04B697CEB0F3557
+ECAA358D2EC2B370519CE06138FA702314BA01F1F33881825EAE1230098BB3C9
+59666983275CA4E8D9DB34979F86535577E79393A72F84B0F768FE8C92692907
+15E9FE9894E98A0EBEA490CBC8C7E5A9F3E43B24C2C5A4BCD71DAAD3CC0B8B82
+AC13933543E295C163F61C9FD18371CB514493F90BF7FB460C029B8DD2E2BF05
+FD66B451DF277864DE1EE42100BF29E01A50258C2758F3EDE211BB3457B8243C
+20BE72983FD6FA2581C5A953D94381E32E80D6D6095F2E93A5455C101BA71E8C
+E560D4694E4C167EFA25FB1E9D214AEA745CE34CAA5468FAEF8F6BDB6C6BE8F4
+3D58836C26A2392E4C4DECE284A90DDB3858A16D6135FED655A600929DE71605
+6CA32F6851A2A6F71A9DF3D5D657593BB729CBCA2F4B059365B7263DC08AB211
+9C547096E6427F6AA53CB2EB87DF0AFE2ABCDBD15D7EF228D3396413B83C6B4A
+79E41F9BA55A2688F62A10472675E5658F151F9FD6634EC94EC0682C17448024
+CC1633077C07A93E4DA8749D974FB8F4332B5DECF97D749C10DB60D4C90ACBFA
+E65AE928C88BAE19234690EEABDB30BEDCEF2660D7464D5071058C30C572A2BC
+7DEE5384BD7614A4BEC4C84E18CF7EC81C810256E8CE6520466C033E2A36D3D3
+5D6074B3857415011D8D9D49A474D994571CDBB89AF92BEA879BEBAF67663F5C
+17ACAE809C2231EDD0A76641BA52FA7B19A2798D54A4A9B62C42F9905851229F
+2CEE0191C8AA5AC12BB0CE9E5E3E862683AB57DBB4AAD6AC0FA8BA4F408D41E0
+755F72B82B7C18EC6B13995BF7AFD66AF4BA0EA7523DA8B75EE751744EBA9CA4
+4E8BC1FB37734503A5B24FB9F2C2D07A47CFC477F02413D55BD7DC180B0344E8
+50248801FA6BE26C97F397797F5F9DF762967E7CD92CCB8B2E587C92177619A4
+BF8046CBC72C6E69DC78B8CB6B7381A290080EF59F5B9F29C1167B261C932E9D
+010D2D14BB425D157F22BC0305770AECC5BC80000F8CCFB9930255A68F299ED9
+D3B5B83A2CC00E3305EB281E1A7054734661B175C6CA0AF168790985F173DF03
+A8693B677BAFE23C3CF833FF6463B136FC370E4F0C29E322DBEF637F62C33CD9
+B0A8338FD67EC628E3BF2FCBF7CF0347D5CBA1DBE6DE878DD670176B85F69EF2
+3C5CCA1BD2B8A385F113EF1CE522F5A6AE053B9C1E39408C9459DE3E7FE2C4ED
+77F026B0081BB80D40185458139C16333EA27F43EF1204BFBF80BC5301B2A3AD
+B10F7EFBB4F5B7E04DA1167F68BB6D4049440B0F57385FF0A95E72760C6A12F8
+1335BB31CB74081FBAA319180DC00113CF50CC5A41D2E751E055DA1429CD75BB
+0060C21CED634FDA106C49A12B356129D010E29F2919301AA7F80222AF3905ED
+672FF85C9897A70241E8DDB9A53034B6BB44E140D9E739848E7A782F24B98AC8
+00DA09EBE4532787E5CF3ED815705F659D8E52DC2C2D4949374A3BF192BEEB99
+1D9A90A4F3250BF8A1FD40D91F5B34AF2CC561FD02FED712500B24330D87DA9E
+4AA46B6E34BCB40B1F73A1DDE07E002B9478E9651D2BF85E67585B6ED812BE03
+A594874A235B1C1840C4BF4BA6D863583D8C12DB49EF7F8CC24DCBB6B21FBCA9
+378F3E2DC406291AB324571F76E0805DF8826090F0E8B50599CA58D124653D16
+16C782B01C91A6F3DA6346482E3163D28D95EA49866360147296838A3FD0CC53
+920F91D895F839CB61FFD2FBA296CA4C6304EEE579782AE5FD33D0FA652BA7E2
+CEC7C01DD0D3E0D56E6177EE5F609A396F7FC8EADABB465DBA7F384E215C4DCB
+E64F807A50A461545107F9C3F7D7CC7D33E6EBD6D9228B1DCBFEF160703E6129
+0DCED8D45DD54E2A36E698A616E7906A50901E453BDB2A363EB77144E9EA6F2B
+6BD927495EB0EBA5755165707CCFBF8759CE5856881117C7F3EF6D494EDDA7EF
+E499BCA56C86467AC573DA9C2724FCC74BEB331E736FB093DCB67DAD42296655
+415D110F2729BD1D55E5C9CCE2E724116F45FB2E66AE0F790258851A5C808762
+68B8A110BD326F8D3EC45004E7CC08DA42F6CB80A6B6E7C286F139534A275BCD
+2F812993DD9C9A1AEB5E7E4BDB4805DFF3A7030263AB060C9B74F0C25C5B9005
+965284884450CC2815DF28D5F9B0496DC7A3AA85E1E42741E1538797175C28D9
+FD904699C771FB066397FFDEE8E8DD1ABBDF67E6BFEF95BB700A7C1BA91354C5
+42EC3864F6E19B379E79A1CC3C786C0DA146C6B0B8E507ED58DBB1F12F613A98
+0E1F8967991427A22ED323901C4B83336CD343212131E8B59C2F5D232702ACC5
+7891BFD4EBA5D0FA35AEF9F3520CA82D121BF6885BBDAF15248A9E4649ADB94D
+0735CC4D14E1D7275427D00C8E709579612F7F74DB6FC218C10C278CC63E2AE2
+37EC996B10C0229D687F0DB5E38A8C4DAFB3DD8A9E7ED37186FEFC97790A1EA6
+636A88FA9FB4D282234BAAD301A1F3AD33F252C5EEC49410562FC52809CEC466
+A0F6D148E9AF19D6DA2337C8283FBFF6005C37AAEB0B7F7217A8DC6F949B9984
+72DEF163E4D5ECE4288404448C96A7FF0AC76F732D50AD63A1D286C9180E80E7
+C218B1F48E3034FCABA6BF262CEECC284AC29E9F3CA1CFC1639A681ED66C1FBA
+666F073D45C84A286E05FF809D4764FE819B6A330E73695CCF2F448B4D4EB4B3
+F63E94EC289807A2F9A1159CF328C002B467B19D6E9454CCE36FC19E0A214190
+B251818DD456EF658B0398E275514B72D9C1DA5F806EABCF1DD56BC025D69FC8
+A0C2FAAC1892B64D2AF79EA2F57F103CA623E440307600D50E783FAA998EBD40
+51D23A0CEFF8D8649B48B982DC38D613F882DCCAE5F51233A641B3CFD783F830
+D984F116DEA3ED8F0D3369AE629A006BAD4523F8E3C7C6B39A6C972508B67AE9
+32613F28CCFFC4BBC86CF31A0C25C786554F7A1F3DE97F5CFD1A941F775067A4
+784385E2D02EE1FF886701B1E87D966D3F500E15591A5012E645837FE2DBE3E6
+A3D375C6CA0ADBF96B33EC3FCFFFD888D7344B31D40427B8A8BED0FEC6FBE038
+1FB5F0714C4B5A0E607E215B5B7F76ACF0FEAA4C9790EB7E13C0E3933B7C63FE
+5B934EA34F4B741C3667BF1735C685CECA63507E6FB9EB06AA010311F12AC1AB
+4CE3FE8D1EA1EDB3C700BEBA516FC71D740B1CA1A60D4578003973CC3EE21DB1
+58FB1CF7E2EAEB2A4A6C742EBC3575EE6378531C6EFA6E6986E68B8E25CEEA67
+A59623FC1ED2ADDA9D72DBA627D179E47DC7F5551E07EA4D54ADB6CC8109D340
+7279F288E552EFD79C17DA3431E53EED66D16F24BF86468C2FE7EFF421560500
+12FB048D6CE2F370BE4E560F8B4AA12362ACFEBC839351C1D5100C625B14CFDC
+747B66082D4AD5474A63EA0054E9C3E6295AF6B133348487B0471395857F4B73
+4BF8337DCE2FE2E1A4EAD7E7BEDC822BDDCE42B79B308C11897C98E3ADE253CD
+09CEEEC0CB1DB66AB072E36E1E04911F40B535B0FD85982C21B8A587D65C38D2
+DBC5A07A0A26DFFF7460F10781069490AC1B611CF7312A14B4AA6005A4582C5D
+336BCC30EB47749193BE8D457A43F54204B070DF5AC2057B6437E23705C7FE8F
+7BB150560F7044BE3E48EFDDA539FEEFB0D2A7856CD4E405FCE0F5EB190D91AE
+578E2EDEB9ECA218573BB1A8EF116043A27DD17A4047BCCC7C5F3C563A910778
+45ABCA32C7347E6180ACC86F9D665FF025DD8AF514FC3724B5C3510F3C37E0AC
+5101D1667C6ED4E8F37F06CC2BDF66CB5A9FB7C52CAD26344FD1557571336A1E
+1E340EBA149B4EB99016D1A411FB874914AAB2A415CE3F5FDFBBF5AFD7959B9F
+CB127BDC68D2A2F3F07FF3D4FF32046C0371CD2E68A6471E46B08413FC3C7A80
+A107EEE57979DB387B2206D2810DB310B7232B2DAA385256C8A58964B512003F
+A0C24ED21809E2576229627278118107B9C32345C1EE8C0CFB452CA362379369
+31320DEB5371037AFAD093B61E8AC7A6DCF7D49C7F8EC32DC0ECEAFD7E892810
+039570D2956289B15E078C2545911BF535F72F7DAC619BBDEEFA855BBAA81704
+18F7D351B0936357085A32157AD8E27438A58B2397D69264E748B0B8D01B33F4
+D04DC59326A7DED39E247A1C1A1AE49382BDBDE9478A1CB48F88BDF14A268B40
+A40B9FBFC4C87FD3DF1EB2464C3C14E36CA41E09EE0A9B75FEB0769F9ECEB1BA
+EBF73B818427FACDBC33BB95B9654F31C59A766E931C698A8608F15290FCDBD3
+5C535D9036A19CB7B55BF54E96F9B2206DC71624E2E55FE632FDFDEC8757AEA3
+1D83D190ABED5E7A7AAE2F41FCEBC7C18626BF58F9E9F02FBAE0C8AA85E9DB21
+A3D8907522DCBAE4923C6A2A09FD2F08FE32215C544AB577B337D929E625E704
+E041C2381AFCFEA37F3133B6CA20093EFD457C772E428325E56C9CBCC447EF9A
+05A8C3F28017DD4FFACC51B38E4896C5044266EAB4EB7C13FE855E790DCF8A17
+B61B1D30DD866BC57397EF6297C4891451FD6A5C6AD6D7446F58F56A68650908
+224D9F4C31C6906FD29BB51DC947465B808438E6260325752808963C808A4AAD
+60422ADD62CAF315F6AE92FACEC55D5B682089AC0BC051CE1E2C06A3874736CF
+0DB5F7C8F178479E4F11665402781D80397C75456F5CDF0A4F382A19EC6AD64F
+71A9275264800E178F212269154DD8352167C57EBC0A38BE794AAD1601C8E541
+7E1AB8E969A76E1EB4092644958FEA2AD29635E70C4DFE2EB0D9B3E1644FAAD9
+B27AD5466EFAC724718962B62E7B8C32F412B69DFFEB792587D571FB5C591D95
+4CD441662CD1B07595E245FA537FA9EB5A20A97E5C9251EED22C9961B48B25ED
+85BB7524F635F9CBA3714C6D60A6BF920C45A64F4C366C1F9D22F53084997C9A
+EFE2D79FBE3347111F5093E271DB7E3770B35D253DAF93653F6A23FA145AD775
+AF11E188EA0428137D9A14542E3EDA6F7B2E5AA86C9F3D3649A85ED2F020C696
+01A339FE6D7E42BC548C8F92A4E3809C67A986C99418772403D16D0E8662595A
+1F37563671D6DA0F36CAC99DAA8FEA215DF7D45E61314915A30A22FCA86A50D5
+2FF2EF08E240F9FAC030D92BDFBE40F1972DF413E6B452024CD11792BFDAA2D7
+C82716528AD4B3D637BB43E748336DCC86A952BE96F1EA423E31340FCACDC1EB
+02EE932F58734AF3A5B2279361B63F1D824EE3BA9F4D2EC7B33A300A1CE8CA43
+24616444176DB8099D85AC68329B1F85E4B5B16F3B396FE2AE7774F3065D0203
+AA140DC128D6F935C44733EF585F89E8639A2096A225A2E5E49D447D8AF9FD44
+CF6C1BAD5C5E5262AECC5543EC8199B00B72BE32A0F110F64A1D0D5CCEF38FD1
+155D6198E9A343702F8ECF5052333272CAC2FE016681E12745CBE14E1065EFD5
+407DA3686080989F6F6D650A9F1EB3A813B070C30C0D3B4A1E9C206E2E4DFD51
+D8DCBE9AECF956640A2E79F1B4FD0EB8E0449AE1B8FFEBC43275743B4D7F6605
+0673B61EB3189E74F51F3780A91E6A5C6464C8CF7D563D9958D46F39B1A12087
+6BBD4898BA9ABA468AE1F24115891FD3CBC2195F75958E26DF8BF1B93F7B521A
+C12112237AB23A8E5A7B7D0DC4C53692B35F3CD813EB463C0BD3A6486B0476C6
+3B36DA71FE512E5745D097FD4AF5D056E434DEE2AF926B2EE79F7FC4FEFD4130
+BB4B4BE01E5C720325A4884507CB51CBA4FFB615B78A4182444F0ECBE4161A58
+E86FE1DA2E39C2BECBCF1F1D7B9B776A26078FC252128FA8108CB83F673CFD37
+CCDA493234FB93E1550EF8D2DC049ED95B00A8A57834B024B277D3DF062E748C
+B61F183F2D72AD075474F8165528CE75E4F40B38B0FAAE45751C1907F8D31619
+E88EAB02EEED415F3EE3BC5BECC6AF565D34E0BA2958FF337A2B06012DD1858E
+C53DE52C108BD5AAB76C882198C72CDCC958D68EA8FD26F76F04EC1A08B2AC3F
+A6D0E8724D2656555DBC0C8C42A3E22ACA7E1BC8E9F897D9AB692E0FB9EC32EC
+59E31CCA4516A3C3BFD5411BAC3DEDCE374D48681CE7D67DEAB93F5B5C5290AC
+FEB29C5EA2C98095692873D36C7DA24847B66F31E4CA4C7AE5C79D7CE4F0532B
+78620582E3731A2A6533A03E7155B33E7CD142FE79F72721862EDB24959B9783
+F834CB616FFCB2A23497BA6D99AE34DC459A2F7B3E4DA2B54BED118ADCD92178
+66C40F4E60F6E1327D5DBCA645A2A7C770807E6D7E47E1265C753F8793BD2D1E
+BDCD749CC24D4AF9315A93F01180A0F9A7F420DA1B87664DA5FD967131273271
+9DCC45C3D57EB9B8AF14771E8E751D88B98D2FFDC72F5011D402EC34FD010ACF
+D3B0660304725191D64FEE106253FCB3470F1A16EB7B45C1489D3534BF94F740
+C2781DAFA5E8A9E7B25A85BD7935DF3ADDE08C960E283D8FC3976FDB4085DBB4
+B6B35FB239C28C785B18BE4FC98F3A5F410F562DB5FCA04E8074E4E790F4265E
+F88117B3D0833AFAE6E8B8A71D7731BA6F14FD6F217EDA3F8CC687A494FC3914
+B84FDC37C8C335AB1E7E0BEC7FB6B7A595C50CF8F0080C8D461BCB8B579A5155
+F963B6587873FA31C3A6572740C63EFBE58A2EBB723B7517D2A243F6CB08A038
+54F4DF0F6692022B2EE8C6F6B73735ED3166BAC58D9216A06EA6FC7B63B20031
+D0F0F99D83D9030B413C2360DD2C553E34BD67851B743C3FDA676AD63C5BD759
+9131358C6BCDF05FCC048F4EBB9005899ACDD8E9EC9BB8C5A08E83485047D263
+0ED69B4D1869A38068FDA03524022A1D32FA2AE0BF728D2A654E52B6A6C90A3A
+725F86627D7C3EC5AF5AC512976D35FE42AACA3FECB401788D0BFFD9F4743BB2
+EC5B4E7891F216DCA5A69E917A171E0069A03FB214ED307DE947225049D46E0C
+4707503F09811A597A9113921AAC23AB1CAA9866F81A02BDF349FAB129F23E86
+E384C043053055938D42ACBF9F0EE86CEBEB011BD5BB7D5930759026189A89A9
+B624BC5B352DAD55CFCB8BE6CF6F215CCF778E33BBE1B009AF1164AEF12E6291
+751E80E442E02B6DFCAF461AD0D85D55418213AD799202BEE639539608AEAB5C
+E79FCA432371DECA10E944D61CE9FCDEA9C63660707C51C106DCAA26441CAE1E
+F97D8D39B4E98F17FDD23593A47A024666C12D287999B20A7037D99C8AE6A439
+EAAE5BCA24CFDCDF282662465DDB5F517F68E1E98E014A65A8965F181DC4F92D
+99A23967140584BB90B11BBF728D6F490D1D6E508D50E0B60DE153247ED8AD89
+B34C493DF0206D7F9A44FDEFCBCCCF8CF3091178BFDC44CCC4E34552234137B9
+807ABD0127FE86124F4B06D767EDA738561CB96E9A859FB6390F692CBB1ADCE4
+5EFA1DDDDFED75081C25CBA2D7AB7490541CAA841028DCD2AC018F14D15F13AD
+1E0C3141ECEC7DE632338200CB78BBBD75E2241F364C840813BE533FD657E769
+E7E1AA82CF50BAE74B5F96354BACF1C3B23A6F9789AC77853368BB1392ECF9B0
+EBC4DA2EBC70FC8C18603D1F321EB003F8D5DB8760026011BA197DE07BB55DFA
+91231B4F3A35628FF5F9BEC978CA8C18FB0A8D87ED476280DA7C3704F9934E1D
+B76C4C06FBBB5DE16E19AE576D7954C220FAEA25D03471F99F1A95658F0197AE
+433B5CAD501D88B5E87EE29E2E1B5F1A8CF11E35AF988A1B78618897EBE0448D
+BE398302B445924D8D9A4962BC428320D924CB0D4BE15813333C6C1771F00F67
+
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+cleartomark
+{restore}if
+%%EndFont
+%%BeginFont: CMTI7
+%!PS-AdobeFont-1.0: CMTI7 003.002
+%%Title: CMTI7
+%Version: 003.002
+%%CreationDate: Mon Jul 13 16:17:00 2009
+%%Creator: David M. Jones
+%Copyright: Copyright (c) 1997, 2009 American Mathematical Society
+%Copyright: (<http://www.ams.org>), with Reserved Font Name CMTI7.
+% This Font Software is licensed under the SIL Open Font License, Version 1.1.
+% This license is in the accompanying file OFL.txt, and is also
+% available with a FAQ at: http://scripts.sil.org/OFL.
+%%EndComments
+FontDirectory/CMTI7 known{/CMTI7 findfont dup/UniqueID known{dup
+/UniqueID get 5000825 eq exch/FontType get 1 eq and}{pop false}ifelse
+{save true}{false}ifelse}{false}ifelse
+11 dict begin
+/FontType 1 def
+/FontMatrix [0.001 0 0 0.001 0 0 ]readonly def
+/FontName /CMTI7 def
+/FontBBox {-27 -250 1268 750 }readonly def
+/PaintType 0 def
+/FontInfo 9 dict dup begin
+/version (003.002) readonly def
+/Notice (Copyright \050c\051 1997, 2009 American Mathematical Society \050<http://www.ams.org>\051, with Reserved Font Name CMTI7.) readonly def
+/FullName (CMTI7) readonly def
+/FamilyName (Computer Modern) readonly def
+/Weight (Medium) readonly def
+/ItalicAngle -14.04 def
+/isFixedPitch false def
+/UnderlinePosition -100 def
+/UnderlineThickness 50 def
+end readonly def
+/Encoding 256 array
+0 1 255 {1 index exch /.notdef put} for
+dup 44 /comma put
+dup 70 /F put
+dup 76 /L put
+dup 83 /S put
+dup 97 /a put
+dup 98 /b put
+dup 99 /c put
+dup 100 /d put
+dup 101 /e put
+dup 102 /f put
+dup 103 /g put
+dup 104 /h put
+dup 105 /i put
+dup 108 /l put
+dup 109 /m put
+dup 110 /n put
+dup 111 /o put
+dup 112 /p put
+dup 114 /r put
+dup 115 /s put
+dup 116 /t put
+dup 117 /u put
+dup 118 /v put
+dup 119 /w put
+readonly def
+currentdict end
+currentfile eexec
+D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7
+5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99
+8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716
+EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C
+02CE8D8B07183838330C0284BD419CBDAE42B141D3D4BE492473F240CEED931D
+46E9F999C5CB3235E2C6DAAA2C0169E1991BEAEA0D704BF49CEA3E98E8C2361A
+4B60D020D325E4C2450F3BCF59223103D20DB6943DE1B57C525641D2B175DB6E
+FE5425043CA62CE886B802B23F41D33FF06CB9EAB7DCFEE2AB63C1333D9B042F
+B0A32D7634E2BC65BD7B7C53695C585079EBE138B40ED4BC7D06B30C88B5E0C8
+E93FF20138D513B24866986C4A633304FC4945EA8A6C6BFFBA1FDCC8F7474BA3
+D997548C23060E15A15687E9B58A8D2E2D749776BA364A2E28FB03DA767645CF
+34BC9E787E5D3A5B05F67D169D710592108F4647A0004F71159950253FCF9A25
+028DBDB4FCDB2AB5F17E49A5DEE3C366C693E0784A4D036F92FC97F1C0A0C08D
+E3FD9FB57AA80ADCBF047193DC787C35FB3237AB63613A9244727FB93754EDFC
+323A8B936100717C26AFD2A4EC3F66C438FECC2D6EC4C2728ED313AFE51896DE
+9BB5E98049A4940FE2EC90074C0EF991AD2073AE06B7AA62C2D6A1E74E72D3D3
+739BF7461E7AD856263A57673F6C7E33C07E330A9486B20BC9FE4D2908DBAE9C
+1078C36AD01B070C267BE3A1C8D1212DEC9CB71683F464783AA3503DD646FFF8
+C0D859A4356E4995246790E5A2FFE5D46CDCE889E32516264498AE92D769897C
+A8E5FCA9C15392A3AC0BEE3573EE14EABE243E07F10E33BCFB4CDFC7AEFEAB6C
+F62C21EE29CFAA994A575D56C692C6E040FABBFBC5C0C79A23174E728658C967
+A64D87103716B3D29D724DAFFFD2DB429F9C60EA4CE589C3B5FDFC57297CE277
+80E9A72FFED79394E57C4CE22C5CD55433B3BB329F78F35B25BB3F635DD11897
+75C1BE2A808F26E0840D95A04FE7FE0A85B2513745D1FCA46A54BC1EABF596B4
+F0344BE1A8297EC0E7932E1C82051868BF9A463ABFE0C63ED8F0760A44DEB196
+4643D15E499017B5BCC3D28C576A2E0523BC3C282FC3D078B4F944B22506D29D
+8EADCD89A7E73BBA812C34E4D2728C387AFFD3BC4776236A1DD646ACF4ABD7FF
+6A09AFC5EEDFC35F3E9A3C0BE49425D85B0E1A935DD5C076062888DA3B4DBD7C
+72BD35B29BBF1042EC8A64E64AC472D3E446FFC36FE86ED8B95B65E6756EBF02
+FFB1FA08D7CDD1A5104AFDDBAB721951E5BB5D091BE3F827DE1D2667ABFF201F
+AFEFEC030C90440D358259A25A2BC111BB56B3E53E5BE0AC8E366CF112C289A5
+48442A1E48C0115DF1119349ACB1FE6983D805071DC20D576D9267AACA497EFE
+CEF2593A4AC5AF2167627B00C5EA97D125EB8A47E58CD9B213D74F2D37F8E474
+D9E3EFE626E138F6B09EC1B90E207C2DE0539CF5AAB4A5CDC331B295D8202562
+8482DA317D4BA1404A291D299E0A0F6024696EA9225E4C7B15839F733EC4BFFD
+E85B7CE1F0883A5A0B4544E534015E25DF3BF5305682C20B1625C3C6A5700087
+72969CBE2D79712C8EBB9F9776DA3D6A7A35C79C6508F8962B1E34007F4F9EB3
+E4BBED40B4C76C56974838F6296ACFE974A249F80FFD668AA8159841E46DE0D2
+6A5BA7E19B006D7DECFE918E0B792F4D0C04FA774F6B399E165F7687B4962646
+2595E5B24DAAA8BB1BF33B972776A258F3D039FFA6CAC49B3274F193070D95EF
+B96B07A2C5A413FE43C59F6D8F843795472ABE1F73107C0F5A5B9274CFF2346E
+7627355D5E7B3B3451C89DF5572F4E9BDCAF526425B34D71875B515E62DA8609
+B45B1BEA5002053BC1F0896E9FBFC00A83FC660BBC5258426108155DA6C00024
+AAF2DA69949B5DB8D9EA06A599F2B277E45DB331C6BC2F40660A33BB33FA468C
+9F8C6B65CB2E273BE3E076B0C57680E227163C6183C06A4308A0285526E98445
+8763C550EE9422B987AF5EA62E89630C007C63E4BB5FFF01BC59793A20DDD35C
+BFB5C79B5416EF06B967B572F3C58ECB0A3798C438778F42DCE24943ED290743
+6CD8F32177192AD8EF12373CA6E493DA0F045C1CFDDCD49F6E4C067324CA0A3B
+389CFF8E2C408D8A4083427D4DD8CE33ACB202800A75E581404334E3A910EE37
+9B6DBD1D296C8C164B7B9E1B744A09AAB39963E396F5EAF36D7A02FAC04A666F
+6184E9CD0BC31B6C3ECD327960336FB1F9F9EB3B63284E0BEFF29DF468916260
+15E6DC9206DDD65F43D75762520C3D6D221FBCBC530EA8ACD715995411F785DD
+212848B1DAF379667F67763E6E4AEDE090130D1632153135992A292A12541702
+3CCECE5CC690C755E8D6F4FEB9D0C1F5C7BE9E5388520CFB9F705F227E131FD2
+ECF6FAEAF05ADC9D7343FCB8CDA6CACF0A89DA6E2F0F58DD74ACD2A670F3AAAC
+51C82B11ACF98BBCD1D1DC49E6A8B9815116137E9DE4E3975D3363779165F11A
+4EE8B49058750A45DF8D3548CB628EF51A05B36FE8317A864CC5126C073A056F
+A1F3DFC27F4A5516782E58C26CDBB2C24693F66FA7BDE6430184675C5BDE38B8
+FB08777618A8057F0B8102B14A9122214037FB150322003A0B4EC789F94863C4
+7DB0F028D37EBE23863834060E0E7A557B97E9C83B3D1765C08A86A5BC59EAF9
+356A0B1A4652044F5757B3CAF077A53D09FAC644D69B3C8FF220E23AC9461FAF
+3EDCE217FC3222278BFBFAE76E8A3BE95920C58711CE421E21B3208438871E76
+468EABB998E3B8C5A914F2E6D8F3A8390A3F3802843FF261BD4629F369E1E5ED
+9A94C4B2724D31091117DBF20F6857873BFCCFEC228FDF1F42DE699A5B3F6633
+00EFE62983F273CF97E171823BD3A4B2275D0D7B4980357B1CA613F8383C90FC
+080A28C3CA09B30FB156C508C88DA67EA995A4805C0F56A0169CE2F4F165BC67
+75D9256A9A182D17804CC75DC09E4195DADA5AB7410132B32AC9FFBD8E91F0EC
+5E16F90B4845926B31240ED66CF7E7B30B09A2F0A8B5321E1D41A85C5BC9592B
+81E62AB9E1C7689F5F3DD004B32D2F2DFCFF536FA73B708EEB1EC50431F01831
+497CF6907E3E0AE42240C1F95CF761BD7C6D063805D473C94371C07CA1065F38
+B6B75779F8B4B08993CD240F4ECA804E083034BA706FC89997A900A368D1F65C
+E4D4035CA5F16EE160DA90FE84F81DFDD7B89928BBA041CE048841E96F90934B
+877CC64D608B2AEC9BEE8B80A0E5181EB32F93463F93E7A2EA94AE70A60CFB8E
+94FB7B11A47D9F8CD338296F9B8993BCE0B89AECB520FCE80452B8C5668A7BE1
+65484C4F33340EAE118D1DD35772DCA7EE26E9D3097832357431FA2EC7AB1FC9
+50E5C8CF1AC6CE26AC96066F5E1141461BC4E9B5D9E8238D6344C201FE1AB5A9
+EA45B0714D1BE5DC27C06046BA9A3715129D41065DA246AA3CA2B2C81B1AD030
+1218981023F8F5C0C500FCA63C4F745CEC91A8DA9B80BDB28DFC525950F82EC2
+E7867CA9E096DA38FF5CE0DE0DDF7033F4CD1EBE11273B1373B76168930EBBFD
+0A80E139FA67DAD2DE2F3F5A8233BBEB24354254171B18D4195F613047E63686
+90FE10D47434A7DD0C619F2514DC5A46A4075E7B8BA6677E38956368F84158A0
+CB37CF43C2E48A3856C0BA0F69BCD63F6782D8475D955566104C34C0453E01F0
+9AA0091C9BEB71FCF385D90027C0E69AD0EB7C91B61B2976E31BF9D9AAE65588
+498881E5F9AD116E6D4DEAE2182FB848DCED82868355E08D395E1AD26EDB5C24
+9B92294E3DF2D11314DA237CDF52A5689AA1FA4E49C4A82381E5C8638B9186CB
+633333610FF4112D7D02C3CA9AA6B44F5CAC4582EA66542B552A88598A759F3B
+E3DBC0443A40B25DEFC7DC0114E5465FEBC3543E82494CA44FF09613103941F4
+6BA67CE6FFA9BE0FE7A71A1BC60ED190BED3C0B3E7A7702520631D0A730231E5
+F3B53095017F80525DC287F0A8400E1630A3D92F076A13E5E3D947F9F0277FCB
+890123AF04932938C6938D7533D2429E580566681049AFD0AC057B59708BADF0
+8FC7E5DF40CBD80F49503331A81A5C56375F5BFB4C4BCA6FC94B7C6FAFAEF6DA
+93C704F907BF8558173DAAA78588CD8C7D1B13F838AE94C4E5152C29CBC171C5
+B8B3146FB0CE369F0B0CEAE5EC657E60E74321BAA347D2307CC55DCFE06E47BF
+FFDB7A813FC6D30C0FCE5BD3E77393CFC51B38EF275C84C866E69CA9C74C9AB4
+A6A6DC7D12DB626552D87856DDD69AD28AECDC9756A00A0D32257A43D6E9CDAB
+C8127E06C4FB513129926FF0395F0CC1C2D808C97635D33BA2F8C833F2F84F66
+3B05BDE41F950EEDEE73DF90F644ECD7A72CB2CFEC1FCF17A867E0B0C0F5A7AA
+59AF4501570A50EB302F85E542BD29ABA6D74332400F4C8365C3C9E988752F99
+B839B7A0F630C740BE32D1486981D8000FF636C90F694FE379FC0709EE7CC746
+F883810903E238C932073A90AC78E8F7DF9583C1152C559A6CCD3E5C7C0BCAB9
+73AF3DFA8615A7F299FCF7CE7206D5F4B9040D387CD3C52DBD08E0E9A80C9616
+5EA0EB493768C53E93FCE41BCCE064A047BE8C050266583ABAFED74E2B968BF8
+6CE1507105B9503D6FC29CE61BF07ED568B0F1497796B6CF781E7262762C1675
+F25E86F56CBD7E68B03350481DEFD02438DCFBB7EE50FF276387740E79E5CFB2
+CD7A6FA367377707DF63029ECDEC47A4EAD2C87CF75E4A9112444FB2B5BE55B6
+C25515FF648509AD54D739CDF040FCC34B6A88788E0372528E9B112FDB8C7843
+5D557151B6FCEE99F53BD5FFF13026B95ECBAC75A0EF4F856D2F150817B0CC7E
+20AB39ACEDC30E1B777C6F06D3B893DAC73FAEEDD93EFE3346C6255DEE89E26D
+E279834A7C2FF9FC63E5BB9AF74295CC5F8C6CEE33046B00DAB455A40FD74A3F
+B7D9B4251448507F2463443E9141E68D6C244EE00D1E009E7F739AA650C7A651
+4901CBF31A83D7A188F7980E74F75BE0EBBDAF01F106293F5E56FE9A440E5CF5
+89C2C6FD9026198136C5F0B51DC53C878577C932E2B2B549B3FEA7B8D12CAC8F
+B975965E6805C79A02A08779D78D582548412620F69F70908E351852CBE389B8
+A2084B98B072902E74E59ABE2E32531475866B3C5E515DD140B3BD06F77FE41F
+8D7ABAD142B5DD71CE0FB171D93C72C1C113397D5C6BCA124297997581284FDF
+3655C15DEF9EBEFB6EBA58153BAB51631CF70FF79180B28411419303B349E7B5
+CFB24E53E6383A11041562E4F938100EA504B10FE0B58D0036273D44AEA380C8
+D14901EACF5B826685E27B15D9C81F0C6E4581DFA876650C6F708A65937DBC9E
+D53DA2057F6796D4CF06F7ACDAA3858386DB21B6E14CE1A4351C9B190BE38A5D
+2A59CABDAA767FCE533243C6129DBC22634E979EDADD3B8E9B6C9407ADED11CB
+E7DE1E57DA279A804612FF97E38F78A88B9A65186D33DE5043F2681518036CB6
+05F77954E61B7231819803D8DB4FF8DB67F56A47893D2A65549AA44BB38739F9
+C34A17A00ED72D004C627212B84D5B521CE8160C0F4D6836F02F7FBDA4F7B159
+94A7A9719AFF6F28060D6798C25325F9B383F7BEFB70397BF0720C9D4DEE43CE
+5A278D83310ACE58573A5C3A8B5CBBF50727556FED673F0E6D3D362B9A406127
+A35F11282B39178A7157A0AD5E3F6B324D8C83805C6F12659EC333C89B849631
+4CBAECBD29AAB3075239D0D3840D49EE57C23AE53DEEFA123810371BA2F44EBF
+C8DC4BD214933E60B17971AFA46F64389621AE2037946772D7357164850C7EEF
+9454DC7000DBA7F66EBF61BC00C46ACFE18C346C984477181FD298E5A2EA60C8
+BDCAED5006C6DAE30796D7FE32FFB67EA010C68701A0310C07F97F04B928AA48
+7964C458ECC4EC69A47DE4035AA97F97DD83E0BB9013833154D013E84204D9B7
+FCFD0804760635839FB6CAD93935654EE8C9B7AC136DEE00EDD88D693A50FE11
+2FE74E9B91DF1B2B4CD1E0E4AB2533A56CC0AD18305753A244620CD879ECB18D
+473DABE960D6ACDFC3FC0ACB06A42DCCA04D73E18CD6E53123869411140CC9BB
+06F7B54717E6437979E88248F7364602F4117968131676F4B8B05AE44FB24B2A
+517FD4A7E3FAC0848F01788425C9497445B09F50FAA7DD10718F74DD7EAE0435
+83AA8BB6BB68247DF6862EA85923F1FB13EB660D9F361989AE7D2F6E4C720D80
+7B3D28C17D150ED27A89B5DD2C53DB1C1FCFC9DDE0AAF18FEF819FCF7EB75616
+610CA0101EBDFE9FBF4A9A2A0687071331B07DB41E666F7186E5AA42BBA3D76D
+9E2C0A1172F00DA496C9145ECB1CC5C900593C5BBFDB66C73B65A69B8E9887CB
+7E8E4D4137123E9E22D1F08CB3B7CBDBE40A36D4C51FDEAB241B7C00BD0D2B7B
+D493700B99FD83DAEBBA8E35A1B01105FEED52E133271E1F9FF215DA20CEAF59
+FFB2D74563ED4317B3C56E3F58F367FA2D285916CA08CE517EDD722E8B06CDA5
+F59F90BB13E2579B133C2D645F5DF5EEAE8A18D6115DB17DBADE038B8DEC5D71
+B71F9203ADBDAC8CDE2A75ED88219E4D32847F1D5B1C0B74D6E03B74CF27DBC2
+B4A0A1828F238B498664555F6DCB51A05ACB5F4669BFFF59D90ED267113C3CE4
+BB7AA57C660229728175C2E11D451C4F132572CA8895D3963528AB7F4B65E4B7
+F359DFC14A05E2211538FB21B4D0DC4AAB98F06AED736CCA3662CCBA0D937B3E
+DEC8B155790F5A37CEC51BF0A85A309871028A67C2C3C451FED7FA0D45FE2437
+B1C1550DBE4A512AFEA4679A30FA62B0BD33925AB97798CCC88AF9F5066ED9A0
+818B1FD2A2954709907475074CAAC88363706F7C4AF74800974BFA1F0A080B34
+8438DCD198325C68E88D3579FD298ED4F6C747E0335D2A4218BF03D95E6ECBC2
+80A094FB09A5FB86923D79197F001EB06D4640CEEC20FD2340926619393DE5CA
+EEDB2FEBE0818CE00B01ECB5834DB9395671C985FADC459805E29A7E640049C7
+E70F06036015E4C4D1F6EF105AA6D1414F6DDF186D2B751F3DAB51F03819A8BC
+1BF747716A4B3150E2FD10C1FF5009739F7FDF01980167219D33534D77945B09
+1A12A93E748613E9998276569D1D97134980ABADCE4511795EA176B1F5358235
+909E52F8512E6BDFB95AE41ABE56D672FA606B69D8361438805548ADFBB35F1E
+CCF286DD2C100E646AB14FD73A283903D0DDD8CD8DC214A665B117C9D263C716
+DA3460FC43621B9176D2E7E4920C4A068D6C13DBD4BCC1D4E7F790A8F9FFD349
+EB48FFDB1B70376756E41C75EB4956CC901C6901BDC7F3F4AE48660E59B7B3F9
+818F4D87D4D9DAAF84B4D947F0DA57CCDF44D2C03FC9BDC48B2D2311B140DA11
+3485996DEC121F96567B91F2FD7AA9B39DE9504C23A6BD69A07E00C52A5A8B80
+A42C8D10E764C3F9ACF723D221D29CF701E8CB168B50699BC434EB3793C19457
+78EBBD462218F249BC2CB3B97315EDF9A1209C817EE4BFAFEDFDA894B8808B26
+CA587CB7739FB7A91B9FFF302E727AD2EFE0BA46EF95A1F21A9C32B2B4F4FAA2
+1F7036CCAA6ACAF7440FCD1E571DA4AED838F9EF1007EF7B8248981B8B15165F
+733A0B6FB8D697B5758FF0E632246938A19BA25F3D5594C7EEE79D45A48972A6
+8F66701041F42F42563CF2C57E9E9C173C365EBB414895045085951648719AC4
+CFD520A335DE30DE06E7D13107EDEA3C4BEA82335E6063F2C47953AB23288ACA
+F9A9010EBB8BC97EF4B1A21FC6670A8DCBF67943B672F7782D3EF1BC773C95E1
+3523B5197F0E8920EDA0A2A4A857DF028AC0399DF5BB1E95642D39F8FF740370
+3C8E4E80F6E4A00CC55A13A6C722A77268F33FA16B94230CDF2109F52AC97282
+65ABE9C3BD2AA33CAFB4A4D61E38C422B2D40594991D943CE33A001A3144CAA1
+C4F19CBB5816A386B974E6EE262FAF03D89E764E46770A5E0555FA377DFA6880
+F5561CF5C10F8B6903DE178403A99C3B384FAA94F2C41CF57CC08E9DE58EB1EE
+977C88AE260A1A8FFFC3C6838AC1204F34A6A16569177D6B1C7CE73513EB6E72
+F1C7FCFA2AC432ED575511FDBE6AFB2CD1B7B1450CF9149C462D21871C2B71EA
+BAC5FA16E2FC2C82A5A8D5FE0BB2929C94EC4E0AB0128AB0E039B398A8725A85
+6FD9955EFF184CDF0D4AC4BA0F149F94780A7AF45966CE61C3C6ED17DDB168B8
+19D94661A4B9F006F5A760CA9C1E90707C6BEDB17D8085B34A1C93BAF583784C
+9025373205FAD4DC2F375E4FE3966718C3D0F2E9E4C29E7DB59AF202E7FD8EDE
+4CB4C8D5BB135922C8E7AB8F01601F79B2D6FD7DBDF3E2B37C6204E3D0E1FD3B
+82CE6284842FB976F64C98C19C8635B0769DBBC790B1E0B6FEEE1E3DF06973DB
+C08C1F72289D2F0A54A5A324FF8985B9D8C79AA99EFB7EAFCDFDAC149C3B8C46
+5362CA8E91B3C759943797C24CC83176CE2A8A97423A8BD29076BAEC3567CD7E
+AFDFADA9448F18A849D36116364F6521EB538AE28E6235227D5C3994B89E4721
+F5E6D8E78641CA4885EC4E8528B65F700014A3928640F97B6E66D0A2557B6A75
+D56EFA3BE861CC3E59BEF6214465171F3AF199BD0D0607E288476F8874C3D0D6
+FE8A7BBCDD4A16D28A01220C3342EEB5B0EDBFB492B0FA293548259A71BE986D
+C684DC85CA1FE50DC5FDEC8808060D53DB3233DF0ACB6545CF5DBDB4522F78E4
+959E4F46DE9143DE8DD9E484A4B58BA42EF184E62320BF52DA962F9F96D45D53
+8AFC9313865395952A5BE05CFD2E64CCB7910CE96D98F0401D2545E91A714011
+D4C65481568095223DD17BFF0E2A57BE9E9ABB27BC3ED3DE8BB2F0EB912E8982
+C30643888301E7CB1B58931A9B48A285A4BEC3524A9974D6BE189566C71F41B7
+DEE0CBCF56B94BF2CD3EDFBAF79771B4E47D07EA87D17B7C29511257F0F75617
+B4E9A1CC9903F77FC2001FAE85A41C4215921DCC7DC1B64C805443BE3FFFE10C
+FB8A4B6F1C139A5F06001C7E18C9E5760DB4204396F64C93EBC26226D2C5314B
+220E41CE7FF9D1EDFBC63A3D2218AAE5C298367762268EA62AB6E070CA3D4BC4
+C387C0384C0EA5631F2115665ADAB01B8A10B189A2E004EC219E5167325FC3DB
+07071BFDD132A722E8C751A92FEFA44C8B4A38DB969CF3A6D73163AE3827BE44
+B5547194E7E742003F399A3A0685D5FC0AF280F61F2C74DD2AE9F0DA14F72DBF
+839696BF65DBEEA92DB84EC2BD4A5373E902D9BEE2D0E2B0E4B6438D14E4381F
+A384E486F99D472B999F114D0907B1303F32C58628460071D2EDA0B1C22FA10C
+D75CE6121B70EF238C02844A25EE2506414C2A560C9BE1B289BB6791EB733B71
+421FDF8F047598F5B8C20C41993678D75A8FF23D6730E8F7893F60477424481C
+B073F97D6B86397F1A5A34C2BAB339C344B10CC99C555DECFC9E54573DE574D9
+4CFF68CFE61F02DCDEA27799833DB4CDA70175A79F1553B0306DA28CD88263FA
+5D068D414B265C5D6D6A9F072EC0B1D3388AC4734A64C9D645AC5A268C22F588
+F01B8B586C50269D1F14662E32118402E335266088C021835E9433259E3BE9E1
+EE2381121F704821AD58D0FFCA0C440B7D7640BF60D180AE2A7514B8F681533D
+5AFDC50961BB22A42CEF287C090E607EEF88C164262C42BF59A803ADAC9059AB
+EE59E1A2BF60F5DB2DCA7962DE2DCE2EABCF22EB1B352BB1916886DBC5F8587F
+F35F9DA3134C9B6BB2C3015D861753600E35A4972A21ABBE32DCDDF4CEC68BE4
+095C9876F17FD2ACDCB7D06127CDE6E15456FEA4D06862C63FDF9D82A7C4B3B0
+A8D7876B9D277D19A7F7B6DEFFD2BDB332BA7AF15EB64CEB36807BFACD0CE4AC
+C11931C79E284CEFD51F4C854D99717E5848573090A6EC3C1801968260D6359F
+B43B2165AC565753B609500E6AA7ED9D6362E7102C6432CC257470F4478E6D1E
+87BEC5095F3DC77EF728DA9040281C33DC25E1A30DEB6D4A863D811387950906
+63659E94661ACF6BC62250249502EB7CBD42FF4D89B53D139835B4BE7FEEC789
+405E2E8DB8AB6B30F43217012DDC857DAE74C19133AB57C8BD266F62CE0CE327
+028FF800F58AC877194C094E3594DD32CC67119D4730935C9643467E5528D7AC
+CA4BC8C0761088CA0358A926BD8ACE9649295CDC13F0C303713FB5514E2AF3EB
+CD03AA8C94DC87BB9331797889A6001118E544E8C9ED366CEBB095359DA06F48
+C3FDF479E0967D10952D66FCFC044C873C29625BE7388595671E7087A001546B
+75FF2BBC1007FF0AD68CF138213C323814F44D491515983C11F0C889890A2BAD
+C5F6F1D9FDCA4D43C1A83EA3D860557E17C9E7D83DC3D954D34F9E36248DFE20
+160B09E92B180516F5AD6684CE04E5023C89298BB85AF78E26CA8EE28B910091
+F78F703F0ECDA93E316B319D0F9C0751BE4AE67E5CB086BF1993576942D44BFA
+0717FAD45F8EE235E2C5E273C598146C3BCEF766E8398A597E560C16D5454F4B
+80907212EB05D63A559F0C4748C56DAC8C02E51F523B10227872048FB95C90CA
+5F7B7158AC0C7CDE269A6EBFD100EDB4ECA15AE3E80C78DB7A3017E3195B13E7
+804871BE399EB080295A85A353B869CDA0B7B7088B979D16F61E158E799D5061
+0BA4A3679B0AA26D6F86A2878B2E9AEDD3E67164014CCD8E0003E4D8C85622E6
+2F79E81E11A24F21E329A74FFC61668E611A81EC57E60F25398D93A96959CBF2
+B07E0DA6666F7B46A3F5653B53572A026DA739104E30F65647DB0D7C9E6D0EAB
+839A6B28ED0AE9B95D452DEAAD26C9C9DA3B31B2213C398C4F061DF5EEB1E9E7
+C3F9E00B493A693D149C5DFDBD4BA080C8FE7936460E1FD9CF53798CF1AE3E05
+C78CD1061D7C4FEB11278622DD023D8E5C05E1EA5472763418A5412AE4929047
+BF43A7FF86E08A255705A916CE0E986039CCB9F751B9232320621BB4CC41573A
+1164016DD6C83A647F315B895877A948717896300FA3C49D0D014762F84D0F9C
+42FD21111DDB9A760DBFCCD5613ED1AE782B90EA74922650D6A6B834304370E9
+7BD3183325613AC3F6EAE6186CBAA01D23212556673BEDD027AAB5D72F17E7F7
+E8654669090256A8E3709CCB3182D0984A66E3208CE1E0230926DCDF68E837EF
+909115B850CE52EE98AF204C7E2AEE5D6BBC69B59704F5D42C205D6DE4ED3B81
+5AE4228D23927B27C5ACC80B0331684D251E294BEBF15B42D672529A28AA30C3
+FDCCAFA50C99C854057A64E2ACB945130C6BDC14FBCED321834ACC049C44769C
+E1DBB2A3D6D12580D567687E249AAEA999C119B7F26F3A1FB958AA85F93F470D
+7CF59EDC898890BECFE187EB718FE926DA3DCC39A89A6247F6776FC1EF2285B3
+1678F8E1D1B278AB18F58F671A6AB5FBFBDC234A4405656461C02EEB746227DC
+6EAB29F04C72AE1A995137F69CBE9CF91B65E479804F7A413C12DBB20DDDAC1E
+C87D8CEF2F67A2733072A591CF26850DA8F8F51659BD2112211B488395A82B1E
+D1CBEBB7D672ED43E23B3877C28809828BDCE6CB235135E85240F26FAD84F58C
+747E2D995AD419110ADE37334DA16A7F998958F639A68B6C12CAC2CCE47BFF6E
+283488C2FEEEADF02140D1D52CFD0BE15577A77643EEB5EFC3BDD1DE2DCEE6ED
+DC492919ED3C337598BB530507D04A25AA0A4AD438AE9E074340F39D71B3DD70
+DAE82DC1E9257070F1574F75F87C69E1169C1571B7E4EFDAB129D252B8E7427E
+A2FB5A660DA06184A0E7BBF220A49F941F6DCBB95E69954779015B7A627E5F3B
+67931AB1281078633603A8D86E11E487296B24DA58FBB97B1C1BB1A4AC42C2DE
+EE098817A62200CBA35693EC38271E0290E772F46A12322AB3C2C369475B5FCC
+99A48569A4D53F40680172CE5D8D2F272D20BA1E42A76FC8058D6973FE3F00CC
+5C51AF070350766E29A79AD6AC46E88E67D603AA38F03E8B518E0EE97E190232
+585F78C6BFDF7C2727E3207CB49243E6FB0C584D947C689BC8BC31E7C1A822D2
+974BEAF9DD5AA91C1BFE81D6BAE6C3DB0CA94E944C0E173FEBA8C05DF0CABE65
+1DD0E4BA0E0E38953F74316D441351932ABB43FD521C0D7CEF3A775FA4BB602B
+C801A8B9875FC442DCB3D7121C4FAD9EC275B609291497E771AA9DAAF5368621
+FEDE2248B5E993C72F0B45A08CE27C557BB446465F4C88C509B1F9B25FC05D08
+A372C5018D7A48BE9FAAF616690D68FC7947558B0770AE03EF0F78647085EAC0
+1FA7F87E6028A8BD482CF71C59AA611B54611ED6AD91C0DB5A824A4C2BFAC49F
+3180FDE73DE9AD13D8D86D82C04FFC332768D0C60001521281A812AA1014CEEB
+376925AF1132AE3D59F894F19128329BF80CA775CD80AAB08B6C81164604CF42
+E855CEBA89BC54D95D29C12FE0F0FDC6591843D8CD4D6C65D64E1B0BB686C6D2
+9DFB17E9ECAC39E631888525570127DA289417F073F14A3C9BD3C9C3E4E24BC9
+4ACC185046330FD76B25394502694E5BCB2C77FC8EE7DB648B83B9430F7F6190
+C45FFF098EAD9DD6B174A887FD98C4163AD70358A0AFF3F9A61F8F1F525CFB46
+CBA845FDFED5A2126788BD491458745438C8FCA58A7458994FAAD89BC1A6EF71
+2347D5508534D4EFAE7E7C70378022BB25FBA723F2AFB85B4A4B2EECAA923146
+5566874475C1C6BA95B329C0EBE04B3FFA004DFC2E7F8998EA92A21F3E1F8AA5
+065011DCD34D54B60C31ED6B307E9CF054DD64F08A013F0A9BC2059204F5FEB9
+8D733DD9A957608F520CE15611EF52BF4315921BA9A18D24CD990C30ABA6F2A5
+5FB4608F36EE9C14B2D321F532ADBF4449145A51E7AD9B822B3E7F308DABDBE9
+C9EC1938E4A6E220E6D1D6F4C2B52259B4A549366B05519D1BA625208BAFA621
+6400CCFA4B38208BFF0A1B20E45A0613DF067E2E97451FE68D0F3593321C4E49
+F9BFE74D78E44B7B90FDF841975C69480639ED65777C7C78EF08342DFE8D74D4
+D7B75A5DCB696486F722164197DBCC72F3DE5672EFA8A5E16D8661E01643BAC4
+743424FB0E9D91CDF92CD54B76D86C83882ED85F0723A91F605B350B2353B128
+EB73CCF74A15CD213F8304BE172AD00AA49A53B962C920D94536802C64340FA0
+81C52947FAE0206E337B7FA60F06CEAE4D5895FE774E847D070053CC5D6EAD40
+038789C00E13594AD80ED101E3346FC2AC3937EEFC9FA84EE91805755D52E21B
+71BD5DD0BC9F451DC98FEC0573ADB9F4AE12C4B27D019682CDB573D98D72C9C0
+B8C12A50B0DFA3A0EFDC9956C0031D7B482B6978A4E9A974742855761FB734C3
+3CE47D2BA33A92F39716275DE92626AC17F0E4F84258E3C322BDCC6B7E534ED2
+CFFA40F34588ADD95FB7CCF4D3DF66C4ADB60B0FF8A2DA72416B0C048F2B47C7
+9743A91710E45F57FDDFEDE62063E914DA15CC2A272612BD2230C773EB19C0D2
+9B3ABBBA322DA1345BC8DD0FEE9A84A794B3FAE2FED3DB7901EE67DCD189EC42
+D4836623B19D870D342237512EC17A0CD803DE71861D698112FA4BD24E674437
+5906B47114E9EE291447EA66184B0E4AD907B4055E3FF93D1BDBBDBD11533BAE
+1B75031836C3C5725D5BC4BF62331E08DB5AEAAF3CC14261C7ECBF89164D9CEF
+A20033A3022CFD5CF6977C53550E8E2B945B9279588B79DED0FB4C3983847691
+ADC5995A4B09EA37E4446AA9E0B5C5EF24CCEB349B9AD26339917158027AAF21
+AA44D19BD87C48FF5E1806349BABDFAA86770AE6C436771AC1B2971AFEF850A8
+6F3FCD8F3B22D3460A83D1C32363E147F92C60FD9E989F4A70E580370BA46603
+20971C775917C7645DA4ADF8B2AC1FE4F486CEB10F4D5C16E42D2BB938840A3F
+D24FC54086A737343749BB8120ECCF351F73C96AFD6715969EAC495168CB5870
+BD01DD31FBE2FBFC7D560C0732E2F880BD3EE9CC2D2D574300249762DD0BF5C7
+E078944C350CA202995E52791D5B0A1367C76931883AEF6B63CF122D23B2511A
+0C661F68C9A79433831F18E7E26A218B08509A3BD28246350DEF19D9D90554DD
+CC335494BE7AC6C62962E17AF8180C87899B4F8BA4935090C615FEE7903ADEDC
+4FC1E20A83DFAE933379545F00ADEF974DACBD5538D61F35E15D82FF39830478
+BA2800CF271440B1AF17491501328690EE65A6EA8F5A8C10E7A699E38183AFFC
+A198FE4A21E4A44BF8C18AFE239615A0D38DA3769C837853F521CDE997A41CAC
+D672B6CC07A48BAF14DDF989BD68BD41986872493BEC629F3F39BC741EC1A36E
+CD67B8B73B96328B39A0DFC7A9459718F785FC7A900307FC1D747E8A46ED6BD9
+8895C307135069C7ABC1502B8B73FA95DFD90136DC46FBB4028B6E7242CADC66
+548FAD5A1121EE559C034297EBA71C3CB2FF93E329023B589616FC370F8E8BB7
+1CDBD9950DDAAE99FC86F3BD9111783D288FE27979C77417AAD010892979E24D
+01BD4D3CBA0DF88708B1BC3F8F0479B3F4949B4B4F38B468392EEDEE28571E59
+48590C7DC51098D3B4187D70904C6FEB9065E7BD77B751F8B8ADAE564C5D702C
+FAF8E28BA84953C06431F8305C41AA66EF8312FCA40E04C280FB7F72CA60F45D
+5A1D40A984E6E75ABAC7570457F7C3903D969F69C49AA6AC7C1DDBF42726684C
+C274B9462AE16187E8ABB4B263E20BFA4D592A1B792D1E5944E9F7B9368895B5
+3BDE3CBC271EB88E3665AFF22BF6EFD3C12618512CF0DA5052217FD31B3F34BE
+18294BD6F0EAC7F0C7D32C25DBA6F81A95CE61CD74727E442781FB175C99473D
+B356F69DA08F9A4A86F657B345BE5E13FC46D3A0162E09153D81FAA4BEBD3367
+3C5BA58E2BEAE5CD8A46373C3F068B0C760B522A545F63BE0097ADDF3D174174
+45324DB360E8F96384B6E88F4A611EA486A841F4B4A7F989EF12D590187642DD
+5ED0FD808A7213AD7C0B2D5C6534EA780566F656DE6DAD649CEFE37D036F03D1
+54FC3549F124F2C34CD4D9814F01D58D76187D76CC7D5C79705BE572F14A638B
+880169B5C42C9AB3F72A7DF06D23AFCB74D975A163177BF8673201EF8271775F
+BCAC4FF4FBFBE71983FF8EA4EBCDE52338AECD043C6B1BFA58E937AC0EF8B7A1
+1A49A279FAB598F99DB5FB1F34250127FC54C9193E5477F747C5915F09F38EDA
+4B16D0B0060F241E4C08F08E8BCF0AEDD41905610EB5D3F98C8BBF62098C9FEC
+487AB9C39C01FE8F5A3D1943A154C5599857809E121C477DE5F48A2E3DC5FA37
+C781A777AD5C7A999B31420CD3AAE6C9523290E299D95D273E184F90244BCA33
+8945A1E4F7A90528
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+0000000000000000000000000000000000000000000000000000000000000000
+cleartomark
+{restore}if
+%%EndFont
+TeXDict begin 40258584 52099344 1000 600 600 (list_.dvi)
+@start /Fa 202[30 30 30 30 30 30 48[{}6 49.8132 /CMR6
+rf /Fb 137[34 13[41 104[{}2 66.4176 /CMMI8 rf /Fc 136[45
+32 37 23 28 29 1[35 35 38 56 18 2[21 35 32 21 32 35 32
+32 35 13[38 6[43 5[44 25[21 44[{}24 58.1154 /CMTI7 rf
+end
+%%EndProlog
+%%BeginSetup
+%%Feature: *Resolution 600dpi
+TeXDict begin
+%%BeginPaperSize: Letter
+/setpagedevice where
+{ pop << /PageSize [612 792] >> setpagedevice }
+{ /letter where { pop letter } if }
+ifelse
+%%EndPaperSize
+ end
+%%EndSetup
+%%Page: 1 1
+TeXDict begin 1 0 bop Black Black 982 3416 a @beginspecial
+6.810139 @llx -166.761932 @lly 238.176147 @urx 3.985056
+@ury 2313 @rwi @setspecial
+%%BeginDocument: list_0.eps
+%!PS-Adobe-3.0 EPSF-3.0
+%%BoundingBox: 6 -167 239 4
+%%HiResBoundingBox: 6.81013865 -166.76194 238.176148 3.98505604
+%%Creator: Asymptote 2.372.37
+%%CreationDate: 2018.06.08 10:35:27
+%%Pages: 1
+%%Page: 1 1
+/Setlinewidth {0 exch dtransform dup abs 1 lt {pop 0}{round} ifelse
+idtransform setlinewidth pop} bind def
+newpath 7.06013865 0 moveto
+ 218.864298 0 lineto
+0.5 .setopacityalpha
+0.75 setgray
+7.97011208 Setlinewidth
+0 setlinecap
+1 setlinejoin
+10 setmiterlimit
+stroke
+newpath 7.06013865 -11.9105037 moveto
+ 218.864298 -11.9105037 lineto
+stroke
+newpath 13.0153905 -37.7165951 moveto
+ 42.7916498 -37.7165951 lineto
+stroke
+newpath 47.7543597 -37.7165951 moveto
+ 203.976169 -37.7165951 lineto
+stroke
+newpath 31.8736881 -49.6270989 moveto
+ 203.976169 -49.6270989 lineto
+stroke
+newpath 31.8736881 -61.5376026 moveto
+ 203.976169 -61.5376026 lineto
+stroke
+newpath 36.836398 -77.4182742 moveto
+ 203.976169 -77.4182742 lineto
+stroke
+newpath 13.0153905 -101.239282 moveto
+ 42.7916498 -101.239282 lineto
+stroke
+newpath 47.7543597 -101.239282 moveto
+ 203.976169 -101.239282 lineto
+stroke
+newpath 31.8736881 -113.149785 moveto
+ 203.976169 -113.149785 lineto
+stroke
+newpath 31.8736881 -125.060289 moveto
+ 203.976169 -125.060289 lineto
+stroke
+newpath 7.06013865 -150.866381 moveto
+ 218.864298 -150.866381 lineto
+stroke
+newpath 7.06013865 -162.776884 moveto
+ 218.864298 -162.776884 lineto
+stroke
+newpath 224.81955 -33.7464272 moveto
+ 221.06955 -33.7464272 lineto
+1 .setopacityalpha
+1 0 0 setrgbcolor
+0.5 Setlinewidth
+1 setlinecap
+stroke
+newpath 224.81955 -15.8806716 moveto
+ 221.06955 -15.8806716 lineto
+stroke
+newpath 224.81955 -33.7464272 moveto
+ 224.81955 -15.8806716 lineto
+stroke
+newpath 224.81955 -73.4481063 moveto
+ 221.06955 -73.4481063 lineto
+stroke
+newpath 224.81955 -65.5077705 moveto
+ 221.06955 -65.5077705 lineto
+stroke
+newpath 224.81955 -73.4481063 moveto
+ 224.81955 -65.5077705 lineto
+stroke
+newpath 224.81955 -97.2691138 moveto
+ 221.06955 -97.2691138 lineto
+stroke
+newpath 224.81955 -81.3884422 moveto
+ 221.06955 -81.3884422 lineto
+stroke
+newpath 224.81955 -97.2691138 moveto
+ 224.81955 -81.3884422 lineto
+stroke
+newpath 224.81955 -146.896213 moveto
+ 221.06955 -146.896213 lineto
+stroke
+newpath 224.81955 -129.030457 moveto
+ 221.06955 -129.030457 lineto
+stroke
+newpath 224.81955 -146.896213 moveto
+ 224.81955 -129.030457 lineto
+stroke
+newpath 42.7916498 -30.7688013 moveto
+ 42.7916498 -34.5188013 lineto
+0 0 1 setrgbcolor
+stroke
+newpath 13.0153905 -30.7688013 moveto
+ 13.0153905 -34.5188013 lineto
+stroke
+newpath 42.7916498 -30.7688013 moveto
+ 13.0153905 -30.7688013 lineto
+stroke
+newpath 47.7543597 -30.7688013 moveto
+ 47.7543597 -34.5188013 lineto
+stroke
+newpath 42.7916498 -30.7688013 moveto
+ 42.7916498 -34.5188013 lineto
+stroke
+newpath 47.7543597 -30.7688013 moveto
+ 42.7916498 -30.7688013 lineto
+stroke
+newpath 31.8736881 -84.3660681 moveto
+ 31.8736881 -80.6160681 lineto
+stroke
+newpath 36.836398 -84.3660681 moveto
+ 36.836398 -80.6160681 lineto
+stroke
+newpath 31.8736881 -84.3660681 moveto
+ 36.836398 -84.3660681 lineto
+stroke
+newpath 7.06013865 -132.008083 moveto
+ 7.06013865 -128.258083 lineto
+stroke
+newpath 31.8736881 -132.008083 moveto
+ 31.8736881 -128.258083 lineto
+stroke
+newpath 7.06013865 -132.008083 moveto
+ 31.8736881 -132.008083 lineto
+stroke
+newpath 31.8736881 -132.008083 moveto
+ 31.8736881 -128.258083 lineto
+stroke
+newpath 47.7543597 -132.008083 moveto
+ 47.7543597 -128.258083 lineto
+stroke
+newpath 31.8736881 -132.008083 moveto
+ 47.7543597 -132.008083 lineto
+stroke
+newpath 203.976169 -132.008083 moveto
+ 203.976169 -128.258083 lineto
+stroke
+newpath 218.864298 -132.008083 moveto
+ 218.864298 -128.258083 lineto
+stroke
+newpath 203.976169 -132.008083 moveto
+ 218.864298 -132.008083 lineto
+stroke
+showpage
+%%EOF
+
+%%EndDocument
+ @endspecial 0.000000 TeXcolorgray 1189 2140 a Fc(Surr)m(ounding)26
+b(envir)m(onment,)f(pr)m(e)m(c)m(e)m(ding)e(material)p
+0.000000 TeXcolorgray 1082 2360 a(L)m(ab)m(el)p 0.000000
+TeXcolorgray 244 w(First)j(item)p 0.000000 TeXcolorgray
+1480 2686 a(First)g(item,)f(se)m(c)m(ond)f(p)m(ar)m(agr)m(aph)p
+0.000000 TeXcolorgray 1082 2890 a(L)m(ab)m(el)p 0.000000
+TeXcolorgray 244 w(Se)m(c)m(ond)h(item)p 0.000000 TeXcolorgray
+1191 3298 a(Surr)m(ounding)h(envir)m(onment,)f(fol)s(lowing)i(material)
+p 1.000000 0.000000 0.000000 TeXcolorrgb 2829 2242 a
+Fb(v)2863 2251 y Fa(0)p 1.000000 0.000000 0.000000 TeXcolorrgb
+2829 2615 a Fb(v)2863 2624 y Fa(1)p 1.000000 0.000000 0.000000
+TeXcolorrgb 2829 2780 a Fb(v)2863 2789 y Fa(2)p
+1.000000 0.000000 0.000000 TeXcolorrgb 2829 3185 a Fb(v)2863
+3194 y Fa(3)p 0.000000 0.000000 1.000000 TeXcolorrgb
+1120 2243 a Fb(h)1161 2252 y Fa(0)p 0.000000 0.000000 1.000000
+TeXcolorrgb 1265 2243 a Fb(h)1306 2252 y Fa(1)p
+0.000000 0.000000 1.000000 TeXcolorrgb 1174 2805 a Fb(h)1215
+2814 y Fa(2)p 0.000000 0.000000 1.000000 TeXcolorrgb
+1050 3202 a Fb(h)1091 3211 y Fa(3)p 0.000000 0.000000 1.000000
+TeXcolorrgb 1219 3202 a Fb(h)1260 3211 y Fa(4)p
+0.000000 0.000000 1.000000 TeXcolorrgb 2649 3202 a Fb(h)2690
+3211 y Fa(5)p Black 0.000000 0.000000 1.000000 TeXcolorrgb
+eop end
+%%Trailer
+
+userdict /end-hook known{end-hook}if
+%%EOF
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.pdf b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.pdf
index 547821f3164..820030a1879 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.pdf
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.png b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.png
index 11f297ba98f..4ccda19f806 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.png
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e-figures/list.png
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk
index e19d3d75c39..bc7c6640517 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk
@@ -4,26 +4,35 @@
<!ENTITY latex "LaTeX">
]>
<book id="latex2e.dbk" lang="en">
+<!-- $Id$ -->
+<!-- Public domain. -->
-<title>&latex;2e unofficial reference manual (March 2018)</title>
+<title>&latex;2e unofficial reference manual (July 2018)</title>
<!-- %**end of header (This is for running Texinfo on a region.) -->
<!-- latex 2.09 commands should all be present now, -->
<!-- xx but latex2e stuff is missing. -->
<!-- xx random list of a few of the missing items is at the end of this file -->
<!-- -->
-<!-- xx ending a run with errors -->
<!-- xx ctan, distributions, components of TeX -->
<!-- xx classes and packages - required, additional, useful; oberdiek; fonts -->
<!-- -->
-<!-- xx merge http://ctan.org/pkg/latex-info (CTAN package latex-info) -->
-<!-- xx merge http://ctan.org/pkg/latex2e-reference -->
<!-- xx merge permuted-index -->
<!-- xx merge latex-manual from savannah -->
<!-- xx merge display style math -->
-<!-- xx vertical mode, horizontal mode -->
-<!-- xx JH Discuss restricted execution -->
+<!-- xx JH explain nfss somewhere -->
+<!-- xx JH expand BiBTeX -->
+<!-- xx JH expand theorem, AMS math -->
+<!-- xx JH something on code listings -->
+<!-- xx JH ligatures -->
+<!-- xx JH \xspace -->
+<!-- xx JH \stretch -->
+<!-- xx JH \mathstrut -->
+<!-- xx JH \phantom https://tex.stackexchange.com/questions/4519/how-do-i-create-an-invisible-character -->
+<!-- xx JH \baselineskip https://texfaq.org/FAQ-baselinepar -->
+<!-- xx JH \contentsline, \@@dottedtocline? -->
+<!-- xx JH more on \write18, beyond what's mentioned in Command line. -->
<!-- -->
<!-- xx The typeset source2e has an index with all kernel -->
<!-- xx commands, though some are internal and shouldn't be included. -->
@@ -31,7 +40,7 @@
<!-- xx See also http://ctan.org/pkg/macros2e. -->
<bookinfo><legalnotice><para>This document is an unofficial reference manual for &latex;, a
-document preparation system, version of March 2018.
+document preparation system, version of July 2018.
</para>
<para>This manual was originally translated from <filename>LATEX.HLP</filename> v1.0a in
the VMS Help Library. The pre-translation version was written by
@@ -67,10 +76,12 @@ notice identical to this one.
into another language, under the above conditions for modified versions.
<!-- end of License -->
</para></legalnotice></bookinfo>
+<!-- Merge into one index (arbitrarily chosen to be the concept index). -->
+
<para>This document is an unofficial reference manual for &latex;, a
-document preparation system, version of March 2018.
+document preparation system, version of July 2018.
</para>
<para>This manual was originally translated from <filename>LATEX.HLP</filename> v1.0a in
the VMS Help Library. The pre-translation version was written by
@@ -115,7 +126,7 @@ into another language, under the above conditions for modified versions.
<title>&latex;2e: An unofficial reference manual</title>
<para>This document is an unofficial reference manual (version of
-March 2018) for &latex;2e, a document preparation system.
+July 2018) for &latex;2e, a document preparation system.
</para>
@@ -123,11 +134,11 @@ March 2018) for &latex;2e, a document preparation system.
<chapter label="1" id="About-this-document">
<title>About this document</title>
-<indexterm role="fn"><primary><ulink url="http://puszcza.gnu.org.ua/software/latexrefman/">http://puszcza.gnu.org.ua/software/latexrefman/</ulink> home page</primary></indexterm>
+<indexterm role="cp"><primary>home page for manual</primary></indexterm>
<para>This is an unofficial reference manual for the &latex;2e document
preparation system, which is a macro package for the &tex;
typesetting program (see <link linkend="Overview">Overview</link>). This document&#8217;s home page is
-<ulink url="http://puszcza.gnu.org.ua/software/latexrefman/">http://puszcza.gnu.org.ua/software/latexrefman/</ulink>. That page has links to the
+<ulink url="puszcza.gnu.org.ua/software/latexrefman">puszcza.gnu.org.ua/software/latexrefman</ulink>. That page has links to the
current output in various formats, sources, mailing list archives and
subscriptions, and other infrastructure.
</para>
@@ -223,17 +234,20 @@ sensible, such as in plain text, write it as &#8216;<literal>LaTeX</literal>&#82
<indexterm role="cp"><primary>hello, world</primary></indexterm>
<para>&latex; files have a simple global structure, with a standard beginning
-and ending. Here is a &#8220;hello, world&#8221; example:
+and ending. This is a small example.
</para>
<screen>\documentclass{article}
\begin{document}
Hello, \LaTeX\ world.
\end{document}
</screen>
+<para>Every &latex; document has a <literal>\begin{document}</literal> line and an
+<literal>\end{document}</literal> line.
+</para>
<indexterm role="cp"><primary>document class, defined</primary></indexterm>
-<para>Here, the &#8216;<literal>article</literal>&#8217; is the so-called <firstterm>document class</firstterm>,
-implemented in a file <filename>article.cls</filename>. Any document class can be
-used. A few document classes are defined by &latex; itself, and vast
+<para>Here, the &#8216;<literal>article</literal>&#8217; is the <firstterm>document class</firstterm>. It is implemented
+in a file <filename>article.cls</filename>. You can use any document class on your
+system. A few document classes are defined by &latex; itself, and vast
array of others are widely available. See <link linkend="Document-classes">Document classes</link>.
</para>
<indexterm role="cp"><primary>preamble, defined</primary></indexterm>
@@ -241,12 +255,13 @@ array of others are widely available. See <link linkend="Document-classes">Docu
<literal>\documentclass</literal> and the <literal>\begin{document}</literal> commands.
This area is called the <firstterm>preamble</firstterm>.
</para>
-<para>The <literal>\begin{document} ... \end{document}</literal> is a so-called
+<para>The <literal>\begin{document}</literal>, <literal>\end{document}</literal> pair defines an
<indexterm role="cp"><primary>environment</primary></indexterm>
<firstterm>environment</firstterm>; the &#8216;<literal>document</literal>&#8217; environment (and no others) is
-required in all &latex; documents (see <link linkend="document">document</link>). &latex;
-provides many environments itself, and many more are defined separately.
-See <link linkend="Environments">Environments</link>.
+required in all &latex; documents (see <link linkend="document">document</link>). &latex; make
+available to you many environments that are documented here
+(see <link linkend="Environments">Environments</link>). Many more are available to you from external
+packages, most importantly those available at CTAN (see <link linkend="CTAN">CTAN</link>).
</para>
<para>The following sections discuss how to produce PDF or other output from
a &latex; input file.
@@ -256,7 +271,7 @@ a &latex; input file.
<sect1 label="2.2" id="Output-files">
<title>Output files</title>
-<para>&latex; produces a main output file and at least two accessory files.
+<para>&latex; produces a main output file and at least two auxiliary files.
The main output file&#8217;s name ends in either <filename>.dvi</filename> or <filename>.pdf</filename>.
</para>
<variablelist><varlistentry><term><literal>.dvi</literal>
@@ -266,7 +281,7 @@ The main output file&#8217;s name ends in either <filename>.dvi</filename> or <f
<indexterm role="fn"><primary>dvips command</primary></indexterm>
<indexterm role="fn"><primary>dvipdfmx command</primary></indexterm>
<indexterm role="fn"><primary>dvitype command</primary></indexterm>
-<para>If &latex; is invoked with the system command <command>latex</command> then it
+<anchor id="output-files-dvi"/><para>If &latex; is invoked with the system command <command>latex</command> then it
produces a DeVice Independent file, with extension <filename>.dvi</filename>. You
can view this file with a command such as <command>xdvi</command>, or convert
it to a PostScript <literal>.ps</literal> file with <command>dvips</command> or to a
@@ -279,7 +294,7 @@ available (<ulink url="http://mirror.ctan.org/dviware">http://mirror.ctan.org/dv
</term><listitem><indexterm role="fn"><primary>.pdf file</primary></indexterm>
<indexterm role="cp"><primary>pdf&tex;</primary></indexterm>
<indexterm role="fn"><primary>pdflatex command</primary></indexterm>
-<para>If &latex; is invoked via the system command <command>pdflatex</command>,
+<anchor id="output-files-pdf"/><para>If &latex; is invoked via the system command <command>pdflatex</command>,
among other commands (see <link linkend="TeX-engines">&tex; engines</link>), then the main output is
a Portable Document Format (PDF) file. Typically this is a
self-contained file, with all fonts and images included.
@@ -291,7 +306,7 @@ self-contained file, with all fonts and images included.
</term><listitem><indexterm role="cp"><primary>transcript file</primary></indexterm>
<indexterm role="cp"><primary>log file</primary></indexterm>
<indexterm role="fn"><primary>.log file</primary></indexterm>
-<para>This transcript file contains summary information such as a list of
+<anchor id="output-files-log"/><para>This transcript file contains summary information such as a list of
loaded packages. It also includes diagnostic messages and perhaps
additional information for any errors.
</para>
@@ -301,7 +316,7 @@ additional information for any errors.
<indexterm role="cp"><primary>cross references, resolving</primary></indexterm>
<indexterm role="cp"><primary>forward references, resolving</primary></indexterm>
<indexterm role="cp"><primary>references, resolving forward</primary></indexterm>
-<para>Auxiliary information is used by &latex; for things such as
+<anchor id="output-files-aux"/><para>Auxiliary information is used by &latex; for things such as
cross references. For example, the first time that &latex; finds a
forward reference&#8212;a cross reference to something that has not yet
appeared in the source&#8212;it will appear in the output as a doubled
@@ -321,10 +336,11 @@ location.
<indexterm role="cp"><primary>table of contents file</primary></indexterm>
<indexterm role="cp"><primary>contents file</primary></indexterm>
<para>&latex; may produce yet more files, characterized by the filename
-ending. These include a <literal>.lof</literal> file that is used to make a list
-of figures, a <literal>.lot</literal> file used to make a list of tables, and a
-<literal>.toc</literal> file used to make a table of contents. A particular class
-may create others; the list is open-ended.
+ending. These include a <literal>.lof</literal> file that is used to make a list of
+figures, a <literal>.lot</literal> file used to make a list of tables, and a
+<literal>.toc</literal> file used to make a table of contents (see <link linkend="Table-of-contents-etc_002e">Table of
+contents etc.</link>). A particular class may create others; the list is
+open-ended.
</para>
</sect1>
@@ -340,14 +356,14 @@ may create others; the list is open-ended.
<para>&latex; is defined to be a set of commands that are run by a &tex;
implementation (see <link linkend="Overview">Overview</link>). This section gives a terse
-overview of the main programs.
+overview of the main programs (see also&#160;<link linkend="Command-line">Command line</link>).
</para>
<variablelist><varlistentry><term><literal>latex</literal>
</term><term><literal>pdflatex</literal>
</term><listitem><indexterm role="cp"><primary>pdf&tex; engine</primary></indexterm>
<indexterm role="fn"><primary>etex command</primary></indexterm>
<indexterm role="cp"><primary>e-&tex;</primary></indexterm>
-<para>In &tex; Live (<ulink url="http://tug.org/texlive">http://tug.org/texlive</ulink>), if &latex; is invoked
+<anchor id="tex-engines-latex"/><para>In &tex; Live (<ulink url="http://tug.org/texlive">http://tug.org/texlive</ulink>), if &latex; is invoked
via either the system command <command>latex</command> or <command>pdflatex</command>,
then the pdf&tex; engine is run (<ulink url="http://ctan.org/pkg/pdftex">http://ctan.org/pkg/pdftex</ulink>).
When invoked as <command>latex</command>, the main output is a <filename>.dvi</filename>
@@ -367,7 +383,7 @@ assumed to be available in &latex;.
</listitem></varlistentry><varlistentry><term><literal>lualatex</literal>
</term><listitem><indexterm role="fn"><primary>lualatex command</primary></indexterm>
<indexterm role="cp"><primary>Lua&tex;</primary></indexterm>
-<para>If &latex; is invoked via the system command <command>lualatex</command>, the
+<anchor id="tex-engines-lualatex"/><para>If &latex; is invoked via the system command <command>lualatex</command>, the
Lua&tex; engine is run (<ulink url="http://ctan.org/pkg/luatex">http://ctan.org/pkg/luatex</ulink>). This
program allows code written in the scripting language Lua
(<ulink url="http://luatex.org">http://luatex.org</ulink>) to interact with &tex;&#8217;s typesetting.
@@ -381,7 +397,7 @@ but this is rarely used.
<indexterm role="cp"><primary>Xe&tex;</primary></indexterm>
<indexterm role="fn"><primary>.xdv file</primary></indexterm>
<indexterm role="fn"><primary>xdvipdfmx</primary></indexterm>
-<para>If &latex; is invoked with the system command <command>xelatex</command>, the
+<anchor id="tex-engines-xelatex"/><para>If &latex; is invoked with the system command <command>xelatex</command>, the
Xe&tex; engine is run (<ulink url="http://tug.org/xetex">http://tug.org/xetex</ulink>). Like Lua&tex;,
Xe&tex; natively supports UTF-8 Unicode and TrueType and OpenType
fonts, though the implementation is completely different, mainly using
@@ -458,7 +474,7 @@ behavior. For instance, for poetry in &latex; put the lines between
...
\end{verse}
</screen>
-<para>See&#160;<link linkend="Environments">Environments</link> for a list of environments.
+<para>See <link linkend="Environments">Environments</link> for a list of environments.
</para>
<para>The <replaceable>environment name</replaceable> at the beginning must exactly match that at
the end. This includes the case where <replaceable>environment name</replaceable> ends in a
@@ -485,8 +501,8 @@ changes the setting of page numbers from roman numerals to arabic.
</para>
</sect2>
-<sect2 label="2.4.3" id="_005cmakeatletter-and-_005cmakeatother">
-<title><literal>\makeatletter</literal> and <literal>\makeatother</literal></title>
+<sect2 label="2.4.3" id="_005cmakeatletter-_0026-_005cmakeatother">
+<title><literal>\makeatletter</literal> &amp; <literal>\makeatother</literal></title>
<para>Synopsis:
</para>
@@ -531,9 +547,9 @@ have the character code of a letter.
in their names see <ulink url="http://ctan.org/pkg/macros2e">http://ctan.org/pkg/macros2e</ulink>. These macros are
mainly intended to package or class authors.
</para>
-<para>The example below is typical. In the user&#8217;s class file is a command
-<literal>\thesis@universityname</literal>. The user wants to change the
-definition. These three lines should go in the preamble, before the
+<para>In this example the class file has a command
+<literal>\thesis@universityname</literal> that the user wants to change. These
+three lines should go in the preamble, before the
<literal>\begin{document}</literal>.
</para>
<screen>\makeatletter
@@ -552,8 +568,8 @@ definition. These three lines should go in the preamble, before the
<para>Synopsis:
</para>
<screen>\newcommand{\mycmd}{\@ifstar{\mycmd@star}{\mycmd@nostar}}
-\newcommand{\mycmd@nostar}[<replaceable>non-starred command number of args</replaceable>]{<replaceable>body of non-starred command</replaceable>}
-\newcommand{\mycmd@star}[<replaceable>starred command number of args</replaceable>]{<replaceable>body of starred command</replaceable>}
+\newcommand{\mycmd@nostar}[<replaceable>nostar-num-args</replaceable>]{<replaceable>nostar-body</replaceable>}
+\newcommand{\mycmd@star}[<replaceable>star-num-args</replaceable>]{<replaceable>star-body</replaceable>}
</screen>
<para>Many standard &latex; environments or commands have a variant with the
same name but ending with a star character&#160;<literal>*</literal>, an asterisk.
@@ -573,7 +589,7 @@ are <literal>\mycmd@nostar</literal> and <literal>\mycmd@star</literal>. They c
same number of arguments or a different number, or no arguments at all.
As always, in a &latex; document a command using at-sign&#160;<literal>@</literal>
must be enclosed inside a <literal>\makeatletter ... \makeatother</literal> block
-(see <link linkend="_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</link>).
+(see <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</link>).
</para>
<para>This example of <literal>\@ifstar</literal> defines the command <literal>\ciel</literal> and a
variant <literal>\ciel*</literal>. Both have one required argument. A call to
@@ -585,14 +601,15 @@ variant <literal>\ciel*</literal>. Both have one required argument. A call to
\newcommand*{\ciel}{\@ifstar{\ciel@starred}{\ciel@unstarred}}
</screen>
<para>In the next example, the starred variant takes a different number of
-arguments than does the unstarred one. With this definition, Agent
-007&#8217;s <literal>``My name is \agentsecret*{Bond},
-\agentsecret{James}{Bond}.''</literal> is equivalent to <literal>``My name is
-\textsc{Bond}, \textit{James} textsc{Bond}.''</literal>
+arguments than the unstarred one. With this definition, Agent 007&#8217;s
+<literal>``My name is \agentsecret*{Bond},
+\agentsecret{James}{Bond}.''</literal> is equivalent to entering the commands
+<literal>``My name is \textsc{Bond}, \textit{James} textsc{Bond}.''</literal>
</para>
<screen>\newcommand*{\agentsecret@unstarred}[2]{\textit{#1} \textsc{#2}}
\newcommand*{\agentsecret@starred}[1]{\textsc{#1}}
-\newcommand*{\agentsecret}{\@ifstar{\agentsecret@starred}{\agentsecret@unstarred}}
+\newcommand*{\agentsecret}{%
+ \@ifstar{\agentsecret@starred}{\agentsecret@unstarred}}
</screen>
<para>There are two sometimes more convenient ways to accomplish the work of
<literal>\@ifstar</literal>. The <filename>suffix</filename> package allows the construct
@@ -609,6 +626,39 @@ arguments than does the unstarred one. With this definition, Agent
</sect3>
</sect2>
</sect1>
+<sect1 label="2.5" id="CTAN">
+<title>CTAN: Comprehensive &tex; Archive Network</title>
+
+<indexterm role="cp"><primary>CTAN</primary></indexterm>
+
+<para>The Comprehensive &tex; Archive Network, CTAN, is the &tex; and
+&latex; community&#8217;s repository of free material. It is a set of
+Internet sites around the world that offer material related to &latex;
+for download. Visit CTAN on the web at <ulink url="https://ctan.org">https://ctan.org</ulink>.
+</para>
+<para>This material is organized into packages, discrete bundles that
+typically offer some coherent functionality and are maintained by one
+person or a small number of people. For instance, many publishers have
+a package that allows authors to format papers to that publisher&#8217;s
+specifications.
+</para>
+<para>In addition to the massive holdings, the web site offers features such
+as search by name or by functionality.
+</para>
+<indexterm role="cp"><primary>DANTE e.V.</primary></indexterm>
+<indexterm role="cp"><primary>mirrors of CTAN</primary></indexterm>
+<para>CTAN is not a single site, but instead is a set of sites. One of the
+sites is the core. This site actively manages the material, for
+instance, by accepting uploads of new or updated packages. It is
+hosted by the German &tex; group DANTE e.V. Other sites around the
+world help out by mirroring, that is, automatically syncing their
+collections with the core site and then in turn making their copies
+publicly available. This gives users close to their location better
+access and relieves the load on the core site. The list of mirrors is
+at <ulink url="https://ctan.org/mirrors">https://ctan.org/mirrors</ulink>.
+</para>
+
+</sect1>
</chapter>
<chapter label="3" id="Document-classes">
<title>Document classes</title>
@@ -632,23 +682,23 @@ normally the first command in a &latex; source file.
see <link linkend="Overview">Overview</link>.)
</para>
<variablelist><varlistentry><term><literal>article</literal>
-</term><listitem><para>For a journal article, a presentation, and miscellaneous general use.
+</term><listitem><anchor id="document-classes-article"/><para>For a journal article, a presentation, and miscellaneous general use.
</para>
</listitem></varlistentry><varlistentry><term><literal>book</literal>
-</term><listitem><para>Full-length books, including chapters and possibly including front
+</term><listitem><anchor id="document-classes-book"/><para>Full-length books, including chapters and possibly including front
matter, such as a preface, and back matter, such as an appendix
(see <link linkend="Front_002fback-matter">Front/back matter</link>).
</para>
</listitem></varlistentry><varlistentry><term><literal>letter</literal>
-</term><listitem><para>Mail, optionally including mailing labels
+</term><listitem><anchor id="document-classes-letter"/><para>Mail, optionally including mailing labels
(see <link linkend="Letters">Letters</link>).
</para>
</listitem></varlistentry><varlistentry><term><literal>report</literal>
-</term><listitem><para>For documents of length between an <literal>article</literal> and a <literal>book</literal>,
+</term><listitem><anchor id="document-classes-report"/><para>For documents of length between an <literal>article</literal> and a <literal>book</literal>,
such as technical reports or theses, which may contain several chapters.
</para>
</listitem></varlistentry><varlistentry><term><literal>slides</literal>
-</term><listitem><para>For slide presentations&#8212;rarely used today. In its place the
+</term><listitem><anchor id="document-classes-slides"/><para>For slide presentations&#8212;rarely used today. In its place the
<literal>beamer</literal> package is perhaps the most prevalent (see <link linkend="beamer-template">beamer
template</link>).
</para>
@@ -665,9 +715,9 @@ template</link>).
<indexterm role="cp"><primary>class options</primary></indexterm>
<indexterm role="cp"><primary>global options</primary></indexterm>
-<para>You can specify so-called <firstterm>global options</firstterm> or <firstterm>class options</firstterm> to
-the <literal>\documentclass</literal> command by enclosing them in square brackets.
-To specify more than one <replaceable>option</replaceable>, separate them with a comma, as in:
+<para>You can specify <firstterm>global options</firstterm> or <firstterm>class options</firstterm> to the
+<literal>\documentclass</literal> command by enclosing them in square brackets. To
+specify more than one <replaceable>option</replaceable>, separate them with a comma.
</para>
<screen>\documentclass[<replaceable>option1</replaceable>,<replaceable>option2</replaceable>,...]{<replaceable>class</replaceable>}
</screen>
@@ -854,7 +904,7 @@ SMC Math Department</literal> is for a class.
<para>Inside of a class or package file you can use the at-sign <literal>@</literal> as a
character in command names without having to surround the code
containing that command with <literal>\makeatletter</literal> and
-<literal>\makeatother</literal>. See <link linkend="_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</link>. This allow
+<literal>\makeatother</literal>. See <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</link>. This allow
you to create commands that users will not accidentally redefine.
Another technique is to preface class- or package-specific commands with
some string to prevent your class or package from interfering with
@@ -897,7 +947,6 @@ document font size.
most of its work: declaring new variables, commands and fonts, and
loading other files.
</para></listitem></orderedlist>
-
<para>Here is a starting class file, which should be saved as <filename>stub.cls</filename>
where &latex; can find it, for example in the same directory as the
<filename>.tex</filename> file.
@@ -919,6 +968,7 @@ Class Guide, at
of the descriptions here derive from this document), or the tutorial
<ulink url="https://www.tug.org/TUGboat/tb26-3/tb84heff.pdf">https://www.tug.org/TUGboat/tb26-3/tb84heff.pdf</ulink>.
</para>
+
</sect2>
<sect2 label="3.3.2" id="Class-and-package-commands">
<title>Class and package commands</title>
@@ -1010,10 +1060,10 @@ or <literal>\DeclareOption*</literal>.
<indexterm role="cp"><primary>package options</primary></indexterm>
<indexterm role="cp"><primary>options, class</primary></indexterm>
<indexterm role="cp"><primary>options, package</primary></indexterm>
-<para>Make an option available to a user, for invoking in their
+<para>Make an option available to a user to invoke in their
<literal>\documentclass</literal> command. For example, the <literal>smcmemo</literal> class
-could have an option allowing users to put the institutional logo on the
-first page with <literal>\documentclass[logo]{smcmemo}</literal>. The class file
+could have an option <literal>\documentclass[logo]{smcmemo}</literal> allowing
+users to put the institutional logo on the first page. The class file
must contain <literal>\DeclareOption{logo}{<replaceable>code</replaceable>}</literal> (and later,
<literal>\ProcessOptions</literal>).
</para>
@@ -1058,14 +1108,14 @@ command is used within a moving argument, use <literal>\newcommand</literal>.
</para>
<indexterm role="cp"><primary>package, <literal>etoolbox</literal></primary></indexterm>
<indexterm role="cp"><primary><literal>etoolbox</literal> package</primary></indexterm>
-
-<para>The <literal>etoolbox</literal> package offers commands <literal>\newrobustcmd</literal>,
-<literal>\newrobustcmd*</literal>, <literal>\renewrobustcmd</literal>, <literal>\renewrobustcmd*</literal>,
-<literal>\providerobustcmd</literal>, and <literal>\providerobustcmd*</literal> which are similar
-to <literal>\newcommand</literal>, <literal>\newcommand*</literal>, <literal>\renewcommand</literal>,
-<literal>\renewcommand*</literal>, <literal>\providecommand</literal>, and
-<literal>\providecommand*</literal>, but define a robust <replaceable>cmd</replaceable> with two advantages
-as compared to <literal>\DeclareRobustCommand</literal>:
+<para>The <filename>etoolbox</filename> package offers the commands
+<literal>\newrobustcmd</literal>, <literal>\newrobustcmd*</literal>, as well as the commands
+<literal>\renewrobustcmd</literal>, <literal>\renewrobustcmd*</literal>, and the commands
+<literal>\providerobustcmd</literal>, and <literal>\providerobustcmd*</literal>. These are
+similar to <literal>\newcommand</literal>, <literal>\newcommand*</literal>,
+<literal>\renewcommand</literal>, <literal>\renewcommand*</literal>, <literal>\providecommand</literal>, and
+<literal>\providecommand*</literal>, but define a robust <replaceable>cmd</replaceable> with two
+advantages as compared to <literal>\DeclareRobustCommand</literal>:
</para><orderedlist numeration="arabic"><listitem><para>They use the low-level e-&tex; protection mechanism rather than the
higher level &latex; <literal>\protect</literal> mechanism, so they do not incur
the slight loss of performance mentioned above, and
@@ -1080,12 +1130,15 @@ commands, so they do not just make a log message when you redefine
</term></varlistentry><varlistentry><term><literal>\InputIfFileExists{<replaceable>file name</replaceable>}{<replaceable>true code</replaceable>}{<replaceable>false code</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\IfFileExists</primary></indexterm>
<indexterm role="fn"><primary>\InputIfFileExists</primary></indexterm>
-<para>Execute <replaceable>true code</replaceable> if &latex; can find the file <filename><replaceable>file
-name</replaceable></filename> and <replaceable>false code</replaceable> otherwise. In the second case it inputs the
-file immediately after executing <replaceable>true code</replaceable>. Thus
-<literal>\IfFileExists{img.pdf}{\includegraphics{img.pdf}}{\typeout{WARNING:
-img.pdf not found}}</literal> will include the graphic <filename>img.pdf</filename> if it is
-found but otherwise just give a warning.
+<para>Execute <replaceable>true code</replaceable> if &latex; finds the file <filename><replaceable>file
+name</replaceable></filename> or <replaceable>false code</replaceable> otherwise. In the first case it executing
+<replaceable>true code</replaceable> and then inputs the file. Thus the command
+</para>
+<screen>\IfFileExists{img.pdf}{%
+ \includegraphics{img.pdf}}{\typeout{!! img.pdf not found}
+</screen>
+<para>will include the graphic <filename>img.pdf</filename> if it is found and otherwise
+give a warning.
</para>
<para>This command looks for the file in all search paths that &latex; uses,
not only in the current directory. To look only in the current
@@ -1110,12 +1163,14 @@ list</replaceable>]{<replaceable>class name</replaceable>}[<replaceable>release
<!-- and do some actions conditionnally on version later or not to some -->
<!-- date. -->
</para>
-<para>If you request a <replaceable>release date</replaceable> and the date of
-the package installed on your system is earlier, then you get a warning
-on the screen and in the log like <literal>You have requested, on input
-line 4, version `2038/01/19' of document class article, but only version
-`2014/09/29 v1.4h Standard LaTeX document class' is available.</literal>
+<para>If you request a <replaceable>release date</replaceable> and the date of the package
+installed on your system is earlier, then you get a warning on the
+screen and in the log like this.
</para>
+<screen>You have requested, on input line 4, version `2038/01/19' of
+document class article, but only version `2014/09/29 v1.4h
+Standard LaTeX document class' is available.
+</screen>
<para>The command version <literal>\LoadClassWithOptions</literal> uses the list of
options for the current class. This means it ignores any options passed
to it via <literal>\PassOptionsToClass</literal>. This is a convenience command
@@ -1147,10 +1202,11 @@ like &#8216;<literal>This file needs format `LaTeX2e' but this is `xxx'.</litera
features, include the optional <replaceable>format date</replaceable> on which those features
were implemented. If present it must be in the form <literal>YYYY/MM/DD</literal>.
If the format version installed on your system is earlier than
-<replaceable>format date</replaceable> then you get a warning like &#8216;<literal>You have requested
-release `2038/01/20' of LaTeX, but only release `2016/02/01' is
-available.</literal>&#8217;
+<replaceable>format date</replaceable> then you get a warning like this.
</para>
+<screen>You have requested release `2038/01/20' of LaTeX, but only
+release `2016/02/01' is available.
+</screen>
</listitem></varlistentry><varlistentry><term><literal>\OptionNotUsed</literal>
</term><listitem><indexterm role="fn"><primary>\OptionNotUsed</primary></indexterm>
<para>Adds the current option to the list of unused options. Can only be used
@@ -1180,17 +1236,20 @@ options.)
</para>
<para>If your own code is bringing in a package twice then you can collapse
that to once, for example replacing the two
-<literal>\RequirePackage[landscape]{geometry}\RequirePackage[margins=1in]{geometry}</literal>
-with the single
-<literal>\RequirePackage[landscape,margins=1in]{geometry}</literal>. But if you
-are loading a package that in turn loads another package then you need
-to queue up the options you desire for this other package. For
-instance, suppose the package <literal>foo</literal> loads the package
-<literal>geometry</literal>. Instead of
-<literal>\RequirePackage{foo}\RequirePackage[draft]{graphics}</literal> you must
-write <literal>\PassOptionsToPackage{draft}{graphics}
-\RequirePackage{foo}</literal>. (If <literal>foo.sty</literal> loads an option in conflict
-with what you want then you may have to look into altering its source.)
+<literal>\RequirePackage[landscape]{geometry}</literal> and
+<literal>\RequirePackage[margins=1in]{geometry}</literal> with the single command
+<literal>\RequirePackage[landscape,margins=1in]{geometry}</literal>.
+</para>
+<para>However, imagine that you are loading <filename>firstpkg</filename> and inside that
+package it loads <filename>secondpkg</filename>, and you need the second package to be
+loaded with option <literal>draft</literal>. Then before doing the first package
+you must queue up the options for the second package, like this.
+</para>
+<screen>\PassOptionsToPackage{draft}{secondpkg}
+\RequirePackage{firstpkg}
+</screen>
+<para>(If <literal>firstpkg.sty</literal> loads an option in conflict with what you want
+then you may have to alter its source.)
</para>
<para>These commands are useful for general users as well as class and package
writers. For instance, suppose a user wants to load the <literal>graphicx</literal>
@@ -1238,41 +1297,42 @@ options in the order specified in the calling commands, rather than in
the order of declaration in the class or package. For a package this
means that the global options are processed first.
</para>
-
</listitem></varlistentry><varlistentry><term><literal>\ProvidesClass{<replaceable>class name</replaceable>}[<replaceable>release date</replaceable> <replaceable>brief additional information</replaceable>]</literal>
</term></varlistentry><varlistentry><term><literal>\ProvidesClass{<replaceable>class name</replaceable>}[<replaceable>release date</replaceable>]</literal>
</term></varlistentry><varlistentry><term><literal>\ProvidesPackage{<replaceable>package name</replaceable>}[<replaceable>release date</replaceable> <replaceable>brief additional information</replaceable>]</literal>
</term></varlistentry><varlistentry><term><literal>\ProvidesPackage{<replaceable>package name</replaceable>}[<replaceable>release date</replaceable>]</literal>
</term><listitem><indexterm role="fn"><primary>\ProvidesClass</primary></indexterm>
<indexterm role="fn"><primary>\ProvidesPackage</primary></indexterm>
-<para>Identifies the class or package, printing a message to the screen and the log file.
+<para>Identifies the class or package, printing a message to the screen and
+the log file.
</para>
-<para>When a user writes <literal>\documentclass{smcmemo}</literal> then &latex; loads
-the file <filename>smcmemo.cls</filename>. Similarly, a user writing
-<literal>\usepackage{test}</literal> prompts &latex; to load the file
-<literal>test.sty</literal>. If the name of the file does not match the declared
-class or package name then you get a warning. Thus, if you invoke
+<para>When you load a class or package, for example with
+<literal>\documentclass{smcmemo}</literal> or <literal>\usepackage{test}</literal>, &latex;
+inputs a file. If the name of the file does not match the class or
+package name declared in it then you get a warning. Thus, if you invoke
<literal>\documentclass{smcmemo}</literal>, and the file <filename>smcmemo.cls</filename> has
the statement <literal>\ProvidesClass{xxx}</literal> then you get a warning like
<literal>You have requested document class `smcmemo', but the document
class provides 'xxx'.</literal> This warning does not prevent &latex; from
processing the rest of the class file normally.
</para>
-<para>If you include the optional argument, then you must include the date, before
-the first space if any, and it must have the form <literal>YYYY/MM/DD</literal>. The rest
-of the optional argument is free-form, although it traditionally identifies
-the class, and is written to the screen during compilation and to the
-log file. Thus, if your file <filename>smcmemo.cls</filename> contains the line
-<literal>\ProvidesClass{smcmemo}[2008/06/01 v1.0 SMC memo class]</literal> and your
-document&#8217;s first line is <literal>\documentclass{smcmemo}</literal> then you will
-see <literal>Document Class: smcmemo 2008/06/01 v1.0 SMC memo class</literal>.
+<para>If you include the optional argument then you must include a date,
+before any spaces, of the form <literal>YYYY/MM/DD</literal>. The rest of the
+optional argument is free-form, although it traditionally identifies the
+class, and is written to the screen during compilation and to the log
+file. Thus, if your file <filename>smcmemo.cls</filename> contains the line
+<literal>\ProvidesClass{smcmemo}[2008/06/01 v1.0 SMC memo class]</literal> and
+your document&#8217;s first line is <literal>\documentclass{smcmemo}</literal> then you
+will see <literal>Document Class: smcmemo 2008/06/01 v1.0 SMC memo class</literal>.
</para>
<para>The date in the optional argument allows class and package users to ask
-to be warned if the version of the class or package installed on their
-system is earlier than <replaceable>release date</replaceable>, by using the optional arguments
-such as <literal>\documentclass{smcmemo}[2018/10/12]</literal> or
-<literal>\usepackage{foo}[[2017/07/07]]</literal>. (Note that package users only
-rarely include a date, and class users almost never do.)
+to be warned if the version of the class or package is earlier than
+<replaceable>release date</replaceable>. For instance, a user could enter
+<literal>\documentclass{smcmemo}[2018/10/12]</literal> or
+<literal>\usepackage{foo}[[2017/07/07]]</literal> to require a class or package
+with certain features by specifying that it must be released no earlier
+than the given date. (Although, in practice package users only rarely
+include a date, and class users almost never do.)
</para>
</listitem></varlistentry><varlistentry><term><literal>\ProvidesFile{<replaceable>file name</replaceable>}[<replaceable>additional information</replaceable>]</literal>
</term><listitem><indexterm role="fn"><primary>\ProvidesFile</primary></indexterm>
@@ -1287,11 +1347,11 @@ file and you get in the log a string like <literal>File: test.config
</term></varlistentry><varlistentry><term><literal>\RequirePackageWithOptions{<replaceable>package name</replaceable>}[<replaceable>release date</replaceable>]</literal>
</term><listitem><indexterm role="fn"><primary>\RequirePackage</primary></indexterm>
<indexterm role="fn"><primary>\RequirePackageWithOptions</primary></indexterm>
-<para>Load a package, like the document author command <literal>\usepackage</literal>.
-See <link linkend="Additional-packages">Additional packages</link>. An example is
-<literal>\RequirePackage[landscape,margin=1in]{geometry}</literal>. Note that the
-&latex; development team strongly recommends use of these commands over
-Plain&#160;&tex;&#8217;s <literal>\input</literal>; see the Class Guide.
+<para>Load a package, like the command <literal>\usepackage</literal> (see <link linkend="Additional-packages">Additional
+packages</link>). The &latex; development team strongly recommends use of
+these commands over Plain&#160;&tex;&#8217;s <literal>\input</literal>; see the Class
+Guide. An example is
+<literal>\RequirePackage[landscape,margin=1in]{geometry}</literal>.
</para>
<para>The <replaceable>option list</replaceable>, if present, is a comma-separated list. The
<replaceable>release date</replaceable>, if present, must have the form <replaceable>YYYY/MM/DD</replaceable>. If
@@ -1338,30 +1398,28 @@ and a style. The &latex; commands for doing this are described here.
<para>The following type style commands are supported by &latex;.
</para>
-<para>This first group of commands is typically used with an argument, as in
-<literal>\textit{<replaceable>text</replaceable>}</literal>. In the table below, the corresponding
-command in parenthesis is the &#8220;declaration form&#8221;, which takes no
-arguments, as in <literal>{\itshape <replaceable>text</replaceable>}</literal>. The scope of the
-declaration form lasts until the next type style command or the end of
-the current group.
-</para>
-<para>These commands, in both the argument form and the declaration form,
-are cumulative; e.g., you can say either <literal>\sffamily\bfseries</literal> or
-<literal>\bfseries\sffamily</literal> to get bold sans serif.
+<para>In the table below the listed commands, the <literal>\text...</literal> commands,
+is used with an argument, as in <literal>\textit{<replaceable>text</replaceable>}</literal>. This is
+the preferred form. But shown after it, in parenthesis, is the
+corresponding declaration form, which is sometimes useful. This form
+takes no arguments, as in <literal>{\itshape <replaceable>text</replaceable>}</literal>. The scope of
+the declaration form lasts until the next type style command or the end
+of the current group. In addition, each has an environment form such as
+<literal>\begin{itshape}...\end{itshape}</literal>.
</para>
-<para>You can alternatively use an environment form of the declarations; for
-instance, <literal>\begin{ttfamily}...\end{ttfamily}</literal>.
+<para>These commands, in both the argument form and the declaration form, are
+cumulative; for instance you can get bold sans serif by saying either of
+<literal>\sffamily\bfseries</literal> or <literal>\bfseries\sffamily</literal>.
</para>
<indexterm role="fn"><primary>\nocorrlist</primary></indexterm>
<indexterm role="fn"><primary>\nocorr</primary></indexterm>
-<para>These font-switching commands automatically insert italic corrections
-if needed. (See <link linkend="_005c_002f">\/</link>, for the details of italic corrections.)
-Specifically, they insert the italic correction unless the following
-character is in the list <literal>\nocorrlist</literal>, which by default consists
-of a period and a comma. To suppress the automatic insertion of
-italic correction, use <literal>\nocorr</literal> at the start or end of the
-command argument, such as <literal>\textit{\nocorr text}</literal> or
-<literal>\textsc{text \nocorr}</literal>.
+<para>One advantage of these commands is that they automatically insert italic
+corrections if needed (see <link linkend="_005c_002f">\/</link>). Specifically, they insert the
+italic correction unless the following character is in the list
+<literal>\nocorrlist</literal>, which by default consists of a period and a comma.
+To suppress the automatic insertion of italic correction, use
+<literal>\nocorr</literal> at the start or end of the command argument, such as
+<literal>\textit{\nocorr text}</literal> or <literal>\textsc{text \nocorr}</literal>.
</para>
<variablelist><varlistentry><term><literal>\textrm (\rmfamily)</literal>
</term><listitem><indexterm role="fn"><primary>\textrm</primary></indexterm>
@@ -1424,10 +1482,14 @@ text</replaceable> \emph{<replaceable>middle text</replaceable>} <replaceable>en
will be in roman.
</para>
<para>&latex; also provides the following commands, which unconditionally
-switch to the given style, that is, are <emphasis>not</emphasis> cumulative. Also,
-they are used differently than the above commands:
-<literal>{\<replaceable>cmd</replaceable>...}</literal> instead of <literal>\<replaceable>cmd</replaceable>{...}</literal>. These
-are two unrelated constructs.
+switch to the given style, that is, are <emphasis>not</emphasis> cumulative. They are
+used as declarations: <literal>{\<replaceable>cmd</replaceable>...}</literal> instead of
+<literal>\<replaceable>cmd</replaceable>{...}</literal>.
+</para>
+<para>(The unconditional commands below are an older version of font
+switching. The earlier commands are an improvement in most
+circumstances. But sometimes an unconditional font switch is precisely
+what you want.)
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\bf</primary></indexterm><literal>\bf</literal>
</term><listitem><indexterm role="cp"><primary>bold font</primary></indexterm>
@@ -1468,13 +1530,6 @@ are two unrelated constructs.
</listitem></varlistentry></variablelist>
<para>The <literal>\em</literal> command is the unconditional version of <literal>\emph</literal>.
</para>
-<para>(Some people consider the unconditional font-switching commands, such
-as <literal>\tt</literal>, obsolete and that only the cumulative commands
-(<literal>\texttt</literal>) should be used. Others think that both sets of
-commands have their place and sometimes an unconditional font switch
-is precisely what you want; for one example,
-see <link linkend="description"><literal>description</literal></link>.)
-</para>
<para>The following commands are for use in math mode. They are not
cumulative, so <literal>\mathbf{\mathit{<replaceable>symbol</replaceable>}}</literal> does not
create a boldface and italic <replaceable>symbol</replaceable>; instead, it will just be in
@@ -1561,7 +1616,7 @@ options</link>).
<indexterm role="fn"><primary>\huge</primary></indexterm>
<indexterm role="fn"><primary>\Huge</primary></indexterm>
-<informaltable><tgroup cols="4"><colspec colwidth="21*"></colspec><colspec colwidth="5*"></colspec><colspec colwidth="5*"></colspec><colspec colwidth="5*"></colspec><thead><row><entry><para>Command </para></entry><entry><para><literal>10pt</literal> </para></entry><entry><para><literal>11pt</literal> </para></entry><entry><para><literal>12pt</literal>
+<informaltable><tgroup cols="4"><colspec colwidth="23*"></colspec><colspec colwidth="7*"></colspec><colspec colwidth="7*"></colspec><colspec colwidth="5*"></colspec><thead><row><entry><para>Command </para></entry><entry><para><literal>10pt</literal> </para></entry><entry><para><literal>11pt</literal> </para></entry><entry><para><literal>12pt</literal>
</para></entry></row></thead><tbody><row><entry><para><literal>\tiny</literal>
</para></entry><entry><para>5 </para></entry><entry><para>6 </para></entry><entry><para>6
</para></entry></row><row><entry><para><literal>\scriptsize</literal>
@@ -1583,10 +1638,19 @@ options</link>).
</para></entry></row><row><entry><para><literal>\Huge</literal>
</para></entry><entry><para>24.88 </para></entry><entry><para>24.88 </para></entry><entry><para>24.88
</para></entry></row></tbody></tgroup></informaltable>
-<para>The commands as listed here are &#8220;declaration forms&#8221;. The scope of
-the declaration form lasts until the next type style command or the
-end of the current group. You can also use the environment form of
-these commands; for instance, <literal>\begin{tiny}...\end{tiny}</literal>.
+<para>The commands are listed here in declaration forms. You use them by
+declaring them, as with this example.
+</para>
+<screen>\begin{quotation} \small
+ The Tao that can be named is not the eternal Tao.
+\end{quotation}
+</screen>
+<para>The scope of the <literal>\small</literal> lasts until the end of the
+<literal>quotation</literal> environment. It would also end at the next type style
+command or the end of the current group, so you could enclose it in
+extra curly braces <literal>{\small We are here, we are here, we are
+here!}</literal>. You can instead use the environment form of these commands;
+for instance, <literal>\begin{tiny}...\end{tiny}</literal>.
</para>
</sect1>
@@ -1602,7 +1666,7 @@ ones.
<!-- xx but it should be complete -->
<!-- xx something about ultimately reading ENCFAM.fd? -->
</para>
-<variablelist><varlistentry><term><literal>\fontencoding{<replaceable>encoding</replaceable>}</literal>
+<variablelist><anchor id="low-level-font-commands-fontencoding"/><varlistentry><term><literal>\fontencoding{<replaceable>encoding</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\fontencoding</primary></indexterm>
<para>Select the font encoding, the encoding of the output font. There are a
large number of valid encodings. The most common are <literal>OT1</literal>,
@@ -1613,16 +1677,16 @@ accented characters used by the most widespread European languages
hyphenate words containing accented letters. For more, see
<ulink url="https://ctan.org/pkg/encguide">https://ctan.org/pkg/encguide</ulink>.
</para>
-</listitem></varlistentry><varlistentry><term><literal>\fontfamily{<replaceable>family</replaceable>}</literal>
+<anchor id="low-level-font-commands-fontfamily"/></listitem></varlistentry><varlistentry><term><literal>\fontfamily{<replaceable>family</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\fontfamily</primary></indexterm>
<indexterm role="cp"><primary>families, of fonts</primary></indexterm>
<indexterm role="cp"><primary>font catalogue</primary></indexterm>
<para>Select the font family. The web page
<ulink url="http://www.tug.dk/FontCatalogue/">http://www.tug.dk/FontCatalogue/</ulink> provides one way to browse
through many of the fonts easily used with &latex;. Here are
-examples of some common families:
+examples of some common families.
</para>
-<informaltable><tgroup cols="2"><colspec colwidth="4*"></colspec><colspec colwidth="31*"></colspec><tbody><row><entry><para><literal>pag</literal>
+<informaltable><tgroup cols="2"><colspec colwidth="4*"></colspec><colspec colwidth="37*"></colspec><tbody><row><entry><para><literal>pag</literal>
</para></entry><entry><para>Avant Garde
</para></entry></row><row><entry><para><literal>fvs</literal>
</para></entry><entry><para>Bitstream Vera Sans
@@ -1664,7 +1728,7 @@ examples of some common families:
</para></entry><entry><para>Zapf Chancery
</para></entry></row></tbody></tgroup></informaltable>
-</listitem></varlistentry><varlistentry><term><literal>\fontseries{<replaceable>series</replaceable>}</literal>
+<anchor id="low-level-font-commands-fontseries"/></listitem></varlistentry><varlistentry><term><literal>\fontseries{<replaceable>series</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\fontseries</primary></indexterm>
<indexterm role="cp"><primary>series, of fonts</primary></indexterm>
<para>Select the font series. A <firstterm>series</firstterm> combines a <firstterm>weight</firstterm> and a
@@ -1708,7 +1772,6 @@ combinations. Some common combined series values include:
<para>The possible values for width, individually, are (the meaning and
relationship of these terms varies with individual typefaces):
</para>
-
<informaltable><tgroup cols="2"><colspec colwidth="2*"></colspec><colspec colwidth="15*"></colspec><tbody><row><entry><para><literal>uc</literal>
</para></entry><entry><para>Ultra condensed
</para></entry></row><row><entry><para><literal>ec</literal>
@@ -1728,7 +1791,6 @@ relationship of these terms varies with individual typefaces):
</para></entry></row><row><entry><para><literal>ux</literal>
</para></entry><entry><para>Ultra expanded
</para></entry></row></tbody></tgroup></informaltable>
-
<para>When forming the <replaceable>series</replaceable> string from the weight and width, drop the
<literal>m</literal> that stands for medium weight or medium width, unless both
weight and width are <literal>m</literal>, in which case use just one
@@ -1737,7 +1799,7 @@ weight and width are <literal>m</literal>, in which case use just one
</listitem></varlistentry><varlistentry><term><literal>\fontshape{<replaceable>shape</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\fontshape</primary></indexterm>
<indexterm role="cp"><primary>shapes, of fonts</primary></indexterm>
-<para>Select font shape. Valid shapes are:
+<anchor id="low-level-font-commands-fontshape"/><para>Select font shape. Valid shapes are:
</para>
<informaltable><tgroup cols="2"><colspec colwidth="2*"></colspec><colspec colwidth="19*"></colspec><tbody><row><entry><para><literal>n</literal>
</para></entry><entry><para>Upright (normal)
@@ -1752,11 +1814,10 @@ weight and width are <literal>m</literal>, in which case use just one
</para></entry></row><row><entry><para><literal>ol</literal>
</para></entry><entry><para>Outline
</para></entry></row></tbody></tgroup></informaltable>
-
<para>The two last shapes are not available for most font families, and
small caps are often missing as well.
</para>
-</listitem></varlistentry><varlistentry><term><literal>\fontsize{<replaceable>size</replaceable>}{<replaceable>skip</replaceable>}</literal>
+<anchor id="low-level-font-commands-fontsize"/></listitem></varlistentry><varlistentry><term><literal>\fontsize{<replaceable>size</replaceable>}{<replaceable>skip</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\fontsize</primary></indexterm>
<indexterm role="cp"><primary>font size</primary></indexterm>
<indexterm role="fn"><primary>\baselineskip</primary></indexterm>
@@ -1768,7 +1829,7 @@ the Computer Modern typeface is 1.2 times the <literal>\fontsize</literal>.
Changing <literal>\baselineskip</literal> directly is inadvisable since its value is
reset every time a size change happens; see <literal>\baselinestretch</literal>, next.
</para>
-</listitem></varlistentry><varlistentry><term><literal>\baselinestretch</literal>
+<anchor id="low-level-font-commands-baselinestretch"/></listitem></varlistentry><varlistentry><term><literal>\baselinestretch</literal>
</term><listitem><indexterm role="fn"><primary>\baselinestretch</primary></indexterm>
<para>&latex; multiplies the line spacing by the value of the
<literal>\baselinestretch</literal> parameter; the default factor is 1. A change
@@ -1787,7 +1848,7 @@ options, this package keeps the line spacing single-spaced in places
where that is typically desirable, such as footnotes and figure
captions. See the package documentation.
</para>
-</listitem></varlistentry><varlistentry><term><literal>\linespread{<replaceable>factor</replaceable>}</literal>
+<anchor id="low-level-font-commands-linespread"/></listitem></varlistentry><varlistentry><term><literal>\linespread{<replaceable>factor</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\linespread</primary></indexterm>
<para>Equivalent to
<literal>\renewcommand{\baselinestretch}{<replaceable>factor</replaceable>}</literal>, and
@@ -1795,7 +1856,7 @@ therefore must be followed by <literal>\selectfont</literal> to have any effect.
Best specified in the preamble, or use the <literal>setspace</literal> package, as
just described.
</para>
-</listitem></varlistentry><varlistentry><term><literal>\selectfont</literal>
+<anchor id="low-level-font-commands-selectfont"/></listitem></varlistentry><varlistentry><term><literal>\selectfont</literal>
</term><listitem><indexterm role="fn"><primary>\selectfont</primary></indexterm>
<para>The effects of the font commands described above do not happen until
<literal>\selectfont</literal> is called, as in
@@ -1806,7 +1867,7 @@ to put this in a macro:
(see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link>).
</para>
-</listitem></varlistentry><varlistentry><term><literal>\usefont{<replaceable>enc</replaceable>}{<replaceable>family</replaceable>}{<replaceable>series</replaceable>}{<replaceable>shape</replaceable>}</literal>
+<anchor id="low-level-font-commands-usefont"/></listitem></varlistentry><varlistentry><term><literal>\usefont{<replaceable>enc</replaceable>}{<replaceable>family</replaceable>}{<replaceable>series</replaceable>}{<replaceable>shape</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\usefont</primary></indexterm>
<para>The same as invoking <literal>\fontencoding</literal>, <literal>\fontfamily</literal>,
<literal>\fontseries</literal> and <literal>\fontshape</literal> with the given parameters,
@@ -1833,11 +1894,14 @@ followed by <literal>\selectfont</literal>. For example:
<indexterm role="fn"><primary>\onecolumn</primary></indexterm>
<indexterm role="cp"><primary>one-column output</primary></indexterm>
+<para>Synopsis:
+</para>
+<screen>\onecolumn
+</screen>
<para>Start a new page and produce single-column output. If the document is
given the class option <literal>onecolumn</literal> then this is the default
-behavior (see <link linkend="Document-class-options">Document class options</link>).
-</para>
-<para>This command is fragile (see <link linkend="_005cprotect">\protect</link>).
+behavior (see <link linkend="Document-class-options">Document class options</link>). This command is fragile
+(see <link linkend="_005cprotect">\protect</link>).
</para>
</sect1>
@@ -1855,31 +1919,30 @@ behavior (see <link linkend="Document-class-options">Document class options</lin
</screen>
<para>Start a new page and produce two-column output. If the document is given
the class option <literal>twocolumn</literal> then this is the default
-(see <link linkend="Document-class-options">Document class options</link>).
+(see <link linkend="Document-class-options">Document class options</link>). This command is fragile
+(see <link linkend="_005cprotect">\protect</link>).
</para>
<para>If the optional <replaceable>prelim one column text</replaceable> argument
is present, it is typeset in one-column mode before the two-column
typesetting starts.
</para>
-<para>This command is fragile (see <link linkend="_005cprotect">\protect</link>).
-</para>
<para>These parameters control typesetting in two-column output:
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\columnsep</primary></indexterm><literal>\columnsep</literal>
-</term><listitem><para>The distance between columns. The default is 35pt. Change it with a
+</term><listitem><anchor id="twocolumn-columnsep"/><para>The distance between columns. The default is 35pt. Change it with a
command such as <literal>\setlength{\columnsep}{40pt}</literal> You must change
it before the two column environment starts; in the preamble is a good
place.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\columnseprule</primary></indexterm><literal>\columnseprule</literal>
-</term><listitem><para>The width of the rule between columns. The rule appears halfway between
+</term><listitem><anchor id="twocolumn-columnseprule"/><para>The width of the rule between columns. The rule appears halfway between
the two columns. The default is 0pt, meaning that there is no rule.
Change it with a command such as
<literal>\setlength{\columnseprule}{0.4pt}</literal>, before the two-column
environment starts.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\columnwidth</primary></indexterm><literal>\columnwidth</literal>
-</term><listitem><para>The width of a single column. In one-column mode this is equal to
+</term><listitem><anchor id="twocolumn-columnwidth"/><para>The width of a single column. In one-column mode this is equal to
<literal>\textwidth</literal>. In two-column mode by default &latex; sets the
width of each of the two columns to be half of <literal>\textwidth</literal> minus
<literal>\columnsep</literal>.
@@ -1891,7 +1954,7 @@ width of each of the two columns to be half of <literal>\textwidth</literal> min
and see <link linkend="table">table</link>). &latex; places starred floats at the top of a page.
The following parameters control float behavior of two-column output.
</para>
-<variablelist><varlistentry><term><indexterm role="fn"><primary>\dbltopfraction</primary></indexterm><literal>\dbltopfraction</literal>
+<variablelist><anchor id="twocolumn-dbltopfraction"/><varlistentry><term><indexterm role="fn"><primary>\dbltopfraction</primary></indexterm><literal>\dbltopfraction</literal>
</term><listitem><para>The maximum fraction at the top of a two-column page that may be
occupied by two-column wide floats. The default is 0.7, meaning that
the height of a <literal>table*</literal> or <literal>figure*</literal> environment must not
@@ -1908,27 +1971,27 @@ the bulky float on a page by itself, as well as at the top of a page.
</listitem><listitem><para>Increase the value of <literal>\dbltopfraction</literal> to a suitably large number,
to avoid going to float pages so soon.
</para></listitem></itemizedlist>
-<para>You can redefine it, for instance with
+<para>You can redefine it, as with
<literal>\renewcommand{\dbltopfraction}{0.9}</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dblfloatpagefraction</primary></indexterm><literal>\dblfloatpagefraction</literal>
+<anchor id="twocolumn-dblfloatpagefraction"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dblfloatpagefraction</primary></indexterm><literal>\dblfloatpagefraction</literal>
</term><listitem><para>For a float page of two-column wide floats, this is the minimum fraction
that must be occupied by floats, limiting the amount of blank space.
&latex;&#8217;s default is <literal>0.5</literal>. Change it with <literal>\renewcommand</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dblfloatsep</primary></indexterm><literal>\dblfloatsep</literal>
+<anchor id="twocolumn-dblfloatsep"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dblfloatsep</primary></indexterm><literal>\dblfloatsep</literal>
</term><listitem><para>On a float page of two-column wide floats, this length is the distance
between floats, at both the top and bottom of the page. The default is
<literal>12pt plus2pt minus2pt</literal> for a document set at <literal>10pt</literal> or
<literal>11pt</literal>, and <literal>14pt plus2pt minus4pt</literal> for a document set at
<literal>12pt</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dbltextfloatsep</primary></indexterm><literal>\dbltextfloatsep</literal>
+<anchor id="twocolumn-dbltextfloatsep"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dbltextfloatsep</primary></indexterm><literal>\dbltextfloatsep</literal>
</term><listitem><para>This length is the distance between a multi-column float at the top or
bottom of a page and the main text. The default is <literal>20pt plus2pt
minus4pt</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dbltopnumber</primary></indexterm><literal>\dbltopnumber</literal>
+<anchor id="twocolumn-dbltopnumber"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dbltopnumber</primary></indexterm><literal>\dbltopnumber</literal>
</term><listitem><para>On a float page of two-column wide floats, this counter gives the
maximum number of floats allowed at the top of the page. The &latex;
default is <literal>2</literal>.
@@ -2015,20 +2078,20 @@ option (see <link linkend="Document-class-options">Document class options</link>
</term><listitem><indexterm role="fn"><primary>\columnsep</primary></indexterm>
<indexterm role="fn"><primary>\columnseprule</primary></indexterm>
<indexterm role="fn"><primary>\columnwidth</primary></indexterm>
-<para>The distance between the two columns, the width of a rule between the
+<anchor id="page-layout-parameters-columnsep"/><anchor id="page-layout-parameters-columnseprule"/><anchor id="page-layout-parameters-columnwidth"/><para>The distance between the two columns, the width of a rule between the
columns, and the width of the columns, when the document class option
<literal>twocolumn</literal> is in effect (see <link linkend="Document-class-options">Document class options</link>).
See <link linkend="_005ctwocolumn">\twocolumn</link>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\headheight</primary></indexterm><literal>\headheight</literal>
</term><listitem><indexterm role="fn"><primary>\headheight</primary></indexterm>
-<para>Height of the box that contains the running head. The default in the
+<anchor id="page-layout-parameters-headheight"/><para>Height of the box that contains the running head. The default in the
<literal>article</literal>, <literal>report</literal>, and <literal>book</literal> classes is &#8216;<literal>12pt</literal>&#8217;,
at all type sizes.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\headsep</primary></indexterm><literal>\headsep</literal>
</term><listitem><indexterm role="fn"><primary>\headsep</primary></indexterm>
-<para>Vertical distance between the bottom of the header line and the top of
+<anchor id="page-layout-parameters-headsep"/><para>Vertical distance between the bottom of the header line and the top of
the main text. The default in the <literal>article</literal> and <literal>report</literal>
classes is &#8216;<literal>25pt</literal>&#8217;. In the <literal>book</literal> class the default is: if the
document is set at 10pt then it is &#8216;<literal>0.25in</literal>&#8217;, and at 11pt and 12pt
@@ -2036,7 +2099,7 @@ it is &#8216;<literal>0.275in</literal>&#8217;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\footskip</primary></indexterm><literal>\footskip</literal>
</term><listitem><indexterm role="fn"><primary>\footskip</primary></indexterm>
-<para>Distance from the baseline of the last line of text to the baseline of
+<anchor id="page-layout-parameters-footskip"/><para>Distance from the baseline of the last line of text to the baseline of
the page footer. The default in the <literal>article</literal> and <literal>report</literal>
classes is &#8216;<literal>30pt</literal>&#8217;. In the <literal>book</literal> class the default is: when
the type size is 10pt the default is &#8216;<literal>0.35in</literal>&#8217;, while at 11pt it is
@@ -2044,7 +2107,7 @@ the type size is 10pt the default is &#8216;<literal>0.35in</literal>&#8217;, wh
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\linewidth</primary></indexterm><literal>\linewidth</literal>
</term><listitem><indexterm role="fn"><primary>\linewidth</primary></indexterm>
-<para>Width of the current line, decreased for each nested <literal>list</literal>
+<anchor id="page-layout-parameters-linewidth"/><para>Width of the current line, decreased for each nested <literal>list</literal>
(see <link linkend="list">list</link>). That is, the nominal value for <literal>\linewidth</literal> is to
equal <literal>\textwidth</literal> but for each nested list the <literal>\linewidth</literal>
is decreased by the sum of that list&#8217;s <literal>\leftmargin</literal> and
@@ -2059,7 +2122,7 @@ is decreased by the sum of that list&#8217;s <literal>\leftmargin</literal> and
</term><listitem><indexterm role="fn"><primary>\marginparpush</primary></indexterm>
<indexterm role="fn"><primary>\marginsep</primary></indexterm>
<indexterm role="fn"><primary>\marginparwidth</primary></indexterm>
-<para>The minimum vertical space between two marginal notes, the horizontal
+<anchor id="page-layout-parameters-marginparpush"/><anchor id="page-layout-parameters-marginsep"/><anchor id="page-layout-parameters-marginparwidth"/><para>The minimum vertical space between two marginal notes, the horizontal
space between the text body and the marginal notes, and the horizontal
width of the notes.
</para>
@@ -2087,7 +2150,7 @@ distance.
</term><term><indexterm role="fn"><primary>\evensidemargin</primary></indexterm><literal>\evensidemargin</literal>
</term><listitem><indexterm role="fn"><primary>\oddsidemargin</primary></indexterm>
<indexterm role="fn"><primary>\evensidemargin</primary></indexterm>
-<para>The <literal>\oddsidemargin</literal> is the extra distance between the left side of
+<anchor id="page-layout-parameters-oddsidemargin"/><anchor id="page-layout-parameters-evensidemargin"/><para>The <literal>\oddsidemargin</literal> is the extra distance between the left side of
the page and the text&#8217;s left margin, on odd-numbered pages when the
document class option <literal>twoside</literal> is chosen and on all pages when
<literal>oneside</literal> is in effect. When <literal>twoside</literal> is in effect, on
@@ -2100,21 +2163,21 @@ difference between <literal>\paperwidth</literal> and <literal>\textwidth</liter
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\paperheight</primary></indexterm><literal>\paperheight</literal>
</term><listitem><indexterm role="fn"><primary>\paperheight</primary></indexterm>
-<para>The height of the paper, as distinct from the height of the print area.
-It is normally set with a document class option, as in
+<anchor id="page-layout-parameters-paperheight"/><para>The height of the paper, as distinct from the height of the print area.
+Normally set with a document class option, as in
<literal>\documentclass[a4paper]{article}</literal> (see <link linkend="Document-class-options">Document class
options</link>).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\paperwidth</primary></indexterm><literal>\paperwidth</literal>
</term><listitem><indexterm role="fn"><primary>\paperwidth</primary></indexterm>
-<para>The width of the paper, as distinct from the width of the print area.
-It is normally set with a document class option, as in
+<anchor id="page-layout-parameters-paperwidth"/><para>The width of the paper, as distinct from the width of the print area.
+Normally set with a document class option, as in
<literal>\documentclass[a4paper]{article}</literal> (see <link linkend="Document-class-options">Document class
options</link>).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textheight</primary></indexterm><literal>\textheight</literal>
</term><listitem><indexterm role="fn"><primary>\textheight</primary></indexterm>
-<para>The normal vertical height of the page body. If the document is set at
+<anchor id="page-layout-parameters-textheight"/><para>The normal vertical height of the page body. If the document is set at
a nominal type size of 10pt then for an <literal>article</literal> or <literal>report</literal>
the default is &#8216;<literal>43\baselineskip</literal>&#8217;, while for a <literal>book</literal> it is
&#8216;<literal>41\baselineskip</literal>&#8217;. At a type size of 11pt the default is
@@ -2123,7 +2186,7 @@ the default is &#8216;<literal>43\baselineskip</literal>&#8217;, while for a <li
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textwidth</primary></indexterm><literal>\textwidth</literal>
</term><listitem><indexterm role="fn"><primary>\textwidth</primary></indexterm>
-<para>The full horizontal width of the entire page body. For an
+<anchor id="page-layout-parameters-textwidth"/><para>The full horizontal width of the entire page body. For an
<literal>article</literal> or <literal>report</literal> document, the default is &#8216;<literal>345pt</literal>&#8217;
when the chosen type size is 10pt, the default is &#8216;<literal>360pt</literal>&#8217; at 11pt,
and it is &#8216;<literal>390pt</literal>&#8217; at 12pt. For a <literal>book</literal> document, the default
@@ -2143,14 +2206,14 @@ specified width, and revert to their normal values at the end of the
<literal>minipage</literal> or <literal>\parbox</literal>.
</para>
<indexterm role="fn"><primary>\hsize</primary></indexterm>
-<indexterm role="fn"><primary>\hsize</primary></indexterm>
-<para>This entry is included for completeness: <literal>\hsize</literal> is the &tex;
+<anchor id="page-layout-parameters-hsize"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\hsize</primary></indexterm><literal>\hsize</literal>
+</term><listitem><para>This entry is included for completeness: <literal>\hsize</literal> is the &tex;
primitive parameter used when text is broken into lines. It should not
be used in normal &latex; documents.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\topmargin</primary></indexterm><literal>\topmargin</literal>
</term><listitem><indexterm role="fn"><primary>topmargin</primary></indexterm>
-<para>Space between the top of the &tex; page (one inch from the top of the
+<anchor id="page-layout-parameters-topmargin"/><para>Space between the top of the &tex; page (one inch from the top of the
paper, by default) and the top of the header. The value is computed
based on many other parameters: <literal>\paperheight &#8722; 2in &#8722;
\headheight &#8722; \headsep &#8722; \textheight &#8722; \footskip</literal>,
@@ -2158,7 +2221,7 @@ and then divided by two.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\topskip</primary></indexterm><literal>\topskip</literal>
</term><listitem><indexterm role="fn"><primary>\topskip</primary></indexterm>
-<para>Minimum distance between the top of the page body and the baseline of
+<anchor id="page-layout-parameters-topskip"/><para>Minimum distance between the top of the page body and the baseline of
the first line of text. For the standard classes, the default is the
same as the font size, e.g., &#8216;<literal>10pt</literal>&#8217; at a type size of 10pt.
</para>
@@ -2272,65 +2335,67 @@ non-float text (change them with
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\bottomfraction</primary></indexterm><literal>\bottomfraction</literal>
</term><listitem><indexterm role="fn"><primary>\bottomfraction</primary></indexterm>
-<para>The maximum fraction of the page allowed to be occupied by floats at
+<anchor id="floats-bottomfraction"/><para>The maximum fraction of the page allowed to be occupied by floats at
the bottom; default &#8216;<literal>.3</literal>&#8217;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\floatpagefraction</primary></indexterm><literal>\floatpagefraction</literal>
</term><listitem><indexterm role="fn"><primary>\floatpagefraction</primary></indexterm>
-<para>The minimum fraction of a float page that must be occupied by floats;
+<anchor id="floats-floatpagefraction"/><para>The minimum fraction of a float page that must be occupied by floats;
default &#8216;<literal>.5</literal>&#8217;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textfraction</primary></indexterm><literal>\textfraction</literal>
</term><listitem><indexterm role="fn"><primary>\textfraction</primary></indexterm>
-<para>Minimum fraction of a page that must be text; if floats take up too
+<anchor id="floats-textfraction"/><para>Minimum fraction of a page that must be text; if floats take up too
much space to preserve this much text, floats will be moved to a
different page. The default is &#8216;<literal>.2</literal>&#8217;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\topfraction</primary></indexterm><literal>\topfraction</literal>
</term><listitem><indexterm role="fn"><primary>\topfraction</primary></indexterm>
-<para>Maximum fraction at the top of a page that may be occupied before
+<anchor id="floats-topfraction"/><para>Maximum fraction at the top of a page that may be occupied before
floats; default &#8216;<literal>.7</literal>&#8217;.
</para></listitem></varlistentry></variablelist>
-<para>Parameters relating to vertical space around floats (change them with
-<literal>\setlength{<replaceable>parameter</replaceable>}{<replaceable>length expression</replaceable>}</literal>):
+<para>Parameters relating to vertical space around floats (change them with a
+command of the form <literal>\setlength{<replaceable>parameter</replaceable>}{<replaceable>length
+expression</replaceable>}</literal>):
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\floatsep</primary></indexterm><literal>\floatsep</literal>
</term><listitem><indexterm role="fn"><primary>\floatsep</primary></indexterm>
-<para>Space between floats at the top or bottom of a page; default
+<anchor id="floats-floatsep"/><para>Space between floats at the top or bottom of a page; default
&#8216;<literal>12pt plus2pt minus2pt</literal>&#8217;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\intextsep</primary></indexterm><literal>\intextsep</literal>
</term><listitem><indexterm role="fn"><primary>\intextsep</primary></indexterm>
-<para>Space above and below a float in the middle of the main text; default
+<anchor id="floats-intextsep"/><para>Space above and below a float in the middle of the main text; default
&#8216;<literal>12pt plus2pt minus2pt</literal>&#8217; for 10 point and 11 point documents,
and &#8216;<literal>14pt plus4pt minus4pt</literal>&#8217; for 12 point documents.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textfloatsep</primary></indexterm><literal>\textfloatsep</literal>
</term><listitem><indexterm role="fn"><primary>\textfloatsep</primary></indexterm>
-<para>Space between the last (first) float at the top (bottom) of a page;
+<anchor id="floats-textfloatsep"/><para>Space between the last (first) float at the top (bottom) of a page;
default &#8216;<literal>20pt plus2pt minus4pt</literal>&#8217;.
</para></listitem></varlistentry></variablelist>
-<para>Counters relating to the number of floats on a page (change them with
-<literal>\setcounter{<replaceable>ctrname</replaceable>}{<replaceable>natural number</replaceable>}</literal>):
+<para>Counters relating to the number of floats on a page (change them with a
+command of the form <literal>\setcounter{<replaceable>ctrname</replaceable>}{<replaceable>natural
+number</replaceable>}</literal>):
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>bottomnumber</primary></indexterm><literal>bottomnumber</literal>
</term><listitem><indexterm role="fn"><primary>bottomnumber</primary></indexterm>
-<para>Maximum number of floats that can appear at the bottom of a text page;
+<anchor id="floats-bottomnumber"/><para>Maximum number of floats that can appear at the bottom of a text page;
default 1.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>dbltopnumber</primary></indexterm><literal>dbltopnumber</literal>
</term><listitem><indexterm role="fn"><primary>dbltopnumber</primary></indexterm>
-<para>Maximum number of full-sized floats that can appear at the top of a
+<anchor id="floats-dbltopnumber"/><para>Maximum number of full-sized floats that can appear at the top of a
two-column page; default 2.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>topnumber</primary></indexterm><literal>topnumber</literal>
</term><listitem><indexterm role="fn"><primary>topnumber</primary></indexterm>
-<para>Maximum number of floats that can appear at the top of a text page;
+<anchor id="floats-topnumber"/><para>Maximum number of floats that can appear at the top of a text page;
default 2.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>totalnumber</primary></indexterm><literal>totalnumber</literal>
</term><listitem><indexterm role="fn"><primary>totalnumber</primary></indexterm>
-<para>Maximum number of floats that can appear on a text page; default 3.
+<anchor id="floats-totalnumber"/><para>Maximum number of floats that can appear on a text page; default 3.
</para></listitem></varlistentry></variablelist>
<para>The principal &tex;&#160;FAQ entry relating to floats
<ulink url="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=floats">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=floats</ulink> contains
@@ -2348,67 +2413,624 @@ influence the position of float environments like figure and table in
<title>Sectioning</title>
<indexterm role="cp"><primary>sectioning commands</primary></indexterm>
+<indexterm role="cp"><primary>part</primary></indexterm>
+<indexterm role="cp"><primary>chapter</primary></indexterm>
+<indexterm role="cp"><primary>section</primary></indexterm>
+<indexterm role="cp"><primary>subsection</primary></indexterm>
+<indexterm role="cp"><primary>paragraph</primary></indexterm>
+<indexterm role="cp"><primary>subparagraph</primary></indexterm>
+<indexterm role="fn"><primary>\part</primary></indexterm>
+<indexterm role="fn"><primary>\chapter</primary></indexterm>
+<indexterm role="fn"><primary>\section</primary></indexterm>
+<indexterm role="fn"><primary>\subsection</primary></indexterm>
+<indexterm role="fn"><primary>\paragraph</primary></indexterm>
+<indexterm role="fn"><primary>\subparagraph</primary></indexterm>
+
+<para>Structure your text into divisions: parts, chapters, sections, etc. All
+sectioning commands have the same form, one of:
+</para>
+<screen><replaceable>sectioning-command</replaceable>{<replaceable>title</replaceable>}
+<replaceable>sectioning-command</replaceable>*{<replaceable>title</replaceable>}
+<replaceable>sectioning-command</replaceable>[<replaceable>toc-title</replaceable>]{<replaceable>title</replaceable>}
+</screen>
+<para>For instance, declare the start of a subsection as with
+<literal>\subsection{Motivation}</literal>.
+</para>
+<para>The table has each <replaceable>sectioning-command</replaceable> in &latex;. All are
+available in all of &latex;&#8217;s standard document classes <literal>book</literal>,
+<literal>report</literal>, and&#160;<literal>article</literal>, except that <literal>\chapter</literal> is
+not available in <literal>article</literal>.
+</para>
+<informaltable><tgroup cols="3"><colspec colwidth="25*"></colspec><colspec colwidth="25*"></colspec><colspec colwidth="40*"></colspec><thead><row><entry><para>Sectioning unit </para></entry><entry><para>Command </para></entry><entry><para>Level
+</para></entry></row></thead><tbody><row><entry><para>Part
+</para></entry><entry><para><literal>\part</literal> </para></entry><entry><para>-1 (<literal>book</literal>, <literal>report</literal>), 0 (<literal>article</literal>)
+</para></entry></row><row><entry><para>Chapter
+</para></entry><entry><para><literal>\chapter</literal> </para></entry><entry><para>0
+</para></entry></row><row><entry><para>Section
+</para></entry><entry><para><literal>\section</literal> </para></entry><entry><para>1
+</para></entry></row><row><entry><para>Subsection
+</para></entry><entry><para><literal>\subsection</literal> </para></entry><entry><para>2
+</para></entry></row><row><entry><para>Subsubsection
+</para></entry><entry><para><literal>\subsubsection</literal> </para></entry><entry><para>3
+</para></entry></row><row><entry><para>Paragraph
+</para></entry><entry><para><literal>\paragraph</literal> </para></entry><entry><para>4
+</para></entry></row><row><entry><para>Subparagraph
+</para></entry><entry><para><literal>\subparagraph</literal> </para></entry><entry><para>5
+</para></entry></row></tbody></tgroup></informaltable>
+<indexterm role="cp"><primary><literal>*</literal>-form of sectioning commands</primary></indexterm>
+<para>All these commands have a <literal>*</literal>-form that prints <replaceable>title</replaceable> as usual
+but is not numbered and does not make an entry in the table of contents.
+An example of using this is for an appendix in an <literal>article</literal> . The
+input <literal>\appendix\section{Appendix}</literal> gives the output &#8216;<literal>A
+Appendix</literal>&#8217; (see <link linkend="_005cappendix">\appendix</link>). You can lose the numbering&#160;&#8216;<literal>A</literal>&#8217;
+by instead entering <literal>\section*{Appendix}</literal> (articles often omit a
+table of contents and have simple page headers so the other differences
+from the <literal>\section</literal> command may not matter).
+</para>
+<para>The section title <replaceable>title</replaceable> provides the heading in the main text, but
+it may also appear in the table of contents and in the running head or
+foot (see <link linkend="Page-styles">Page styles</link>). You may not want the same text in these
+places as in the main text. All of these commands have an optional
+argument <replaceable>toc-title</replaceable> for these other places.
+</para>
+<para>The level number in the table above determines which sectional units are
+numbered, and which appear in the table of contents. If the sectioning
+command&#8217;s <replaceable>level</replaceable> is less than or equal to the value of the counter
+<literal>secnumdepth</literal> then the titles for this sectioning command will be
+numbered (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link>). And, if <replaceable>level</replaceable> is less
+than or equal to the value of the counter <literal>tocdepth</literal> then the table
+of contents will have an entry for this sectioning unit
+(see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>).
+</para>
+<para>&latex; expects that before you have a <literal>\subsection</literal> you will have
+a <literal>\section</literal> and, in a book, that before a <literal>\section</literal> you will
+have a <literal>\chapter</literal>. Otherwise you can get a something like a
+subsection numbered &#8216;<literal>3.0.1</literal>&#8217;.
+</para>
+<para>Two counters relate to the appearance of sectioning commands.
+</para>
+<variablelist><varlistentry><term><indexterm role="fn"><primary>secnumdepth</primary></indexterm><literal>secnumdepth</literal>
+</term><listitem><indexterm role="fn"><primary>secnumdepth counter</primary></indexterm>
+<indexterm role="cp"><primary>section numbers, printing</primary></indexterm>
+<anchor id="sectioning-secnumdepth"/><anchor id="Sectioning_002fsecnumdepth"/><para>Controls which sectioning commands are
+numbered. Suppress numbering of sectioning at any depth greater than
+<replaceable>level</replaceable> <literal>\setcounter{secnumdepth}{<replaceable>level</replaceable>}</literal>
+(see <link linkend="_005csetcounter">\setcounter</link>). See the above table for the level numbers. For
+instance, if the <literal>secnumdepth</literal> is 1 in an <literal>article</literal> then a
+<literal>\section{Introduction}</literal> command will produce output like &#8216;<literal>1
+Introduction</literal>&#8217; while <literal>\subsection{Discussion}</literal> will produce output
+like &#8216;<literal>Discussion</literal>&#8217;, without the number. &latex;&#8217;s default
+<literal>secnumdepth</literal> is&#160;3 in <filename>article</filename> class and &#160;2 in the
+<filename>book</filename> and <filename>report</filename> classes.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>tocdepth</primary></indexterm><literal>tocdepth</literal>
+</term><listitem><indexterm role="fn"><primary>tocdepth counter</primary></indexterm>
+<indexterm role="cp"><primary>table of contents, sectioning numbers printed</primary></indexterm>
+<anchor id="sectioning-tocdepth"/><anchor id="Sectioning_002ftocdepth"/><para>Controls which sectioning units are listed in the table of contents.
+The setting <literal>\setcounter{tocdepth}{<replaceable>level</replaceable>}</literal> makes the
+sectioning units at <replaceable>level</replaceable> be the smallest ones listed
+(see <link linkend="_005csetcounter">\setcounter</link>). See the above table for the level numbers. For
+instance, if <literal>tocdepth</literal> is&#160;1 then the table of contents will
+list sections but not subsections. &latex;&#8217;s default
+<literal>secnumdepth</literal> is&#160;3 in <filename>article</filename> class and &#160;2 in the
+<filename>book</filename> and <filename>report</filename> classes.
+</para>
+</listitem></varlistentry></variablelist>
-<para>Sectioning commands provide the means to structure your text into units:
+
+<sect1 label="6.1" id="_005cpart">
+<title><literal>\part</literal></title>
+
+<indexterm role="fn"><primary>\part</primary></indexterm>
+<indexterm role="cp"><primary>part</primary></indexterm>
+<indexterm role="cp"><primary>sectioning, part</primary></indexterm>
+
+<para>Synopsis, one of:
</para>
-<variablelist><varlistentry><term><indexterm role="fn"><primary>\part</primary></indexterm><literal>\part</literal>
-</term></varlistentry><varlistentry><term><indexterm role="fn"><primary>\chapter</primary></indexterm><literal>\chapter</literal>
-</term><listitem><para>(<literal>report</literal> and <literal>book</literal> class only)
-</para></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\section</primary></indexterm><literal>\section</literal>
-</term></varlistentry><varlistentry><term><indexterm role="fn"><primary>\subsection</primary></indexterm><literal>\subsection</literal>
-</term></varlistentry><varlistentry><term><indexterm role="fn"><primary>\subsubsection</primary></indexterm><literal>\subsubsection</literal>
-</term></varlistentry><varlistentry><term><indexterm role="fn"><primary>\paragraph</primary></indexterm><literal>\paragraph</literal>
-</term></varlistentry><varlistentry><term><indexterm role="fn"><primary>\subparagraph</primary></indexterm><literal>\subparagraph</literal>
-</term></varlistentry></variablelist>
-<para>All sectioning commands take the same general form, e.g.,
+<screen>\part{<replaceable>title</replaceable>}
+\part*{<replaceable>title</replaceable>}
+\part[<replaceable>toc-title</replaceable>]{<replaceable>title</replaceable>}
+</screen>
+<para>Start a document part. The standard &latex; classes <literal>book</literal>,
+<literal>report</literal>, and <literal>article</literal>, all have this command.
+</para>
+<para>This produces a document part, in a book.
</para>
-<screen>\chapter[<replaceable>toctitle</replaceable>]{<replaceable>title</replaceable>}
+<screen>\part{VOLUME I \\
+ PERSONAL MEMOIRS OF U.\ S.\ GRANT}
+\chapter{ANCESTRY--BIRTH--BOYHOOD.}
+My family is American, and has been for generations,
+in all its branches, direct and collateral.
</screen>
-<para>In addition to providing the heading <replaceable>title</replaceable> in the main text, the
-section title can appear in two other places:
+<para>In each standard class the <literal>\part</literal> command outputs a part number
+such as &#8216;<literal>Part I</literal>&#8217;, alone on its line, in boldface, and in large
+type. Then &latex; outputs <replaceable>title</replaceable>, also alone on its line, in
+bold and in even larger type. In class <literal>book</literal>, the &latex;
+default puts each part alone on its own page. If the book is two-sided
+then &latex; will skip a page if needed to have the new part on an
+odd-numbered page. In <literal>report</literal> it is again alone on a page, but
+&latex; won&#8217;t force it onto an odd-numbered page. In an <literal>article</literal>
+&latex; does not put it on a fresh page, but instead outputs the part
+number and part title onto the main document page.
</para>
-<orderedlist numeration="arabic"><listitem><para>The table of contents.
-</para></listitem><listitem><para>The running head at the top of the page.
-</para></listitem></orderedlist>
-<para>You may not want the same text in these places as in the main text.
-To handle this, the sectioning commands have an optional argument
-<replaceable>toctitle</replaceable> that, when given, specifies the text for these other
-places.
+<para>The <literal>*</literal>&#160;form shows <replaceable>title</replaceable>
+but it does not show the part number, does not increment the
+<literal>part</literal> counter, and produces no table of contents entry.
</para>
-<indexterm role="cp"><primary><literal>*</literal>-form of sectioning commands</primary></indexterm>
-<para>Also, all sectioning commands have <literal>*</literal>-forms that print
-<replaceable>title</replaceable> as usual, but do not include a number and do not make an
-entry in the table of contents. For instance:
+<para>The optional argument <replaceable>toc-title</replaceable> will appear as the part title in
+the table of contents (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>) and in running
+headers (see <link linkend="Page-styles">Page styles</link>). If it is not present then <replaceable>title</replaceable>
+will be there. This example puts a line break in <replaceable>title</replaceable> but leaves
+out the break in the table of contents.
+</para>
+<screen>\part[Up from the bottom; my life]{Up from the bottom\\ my life}
+</screen>
+<para>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a part is&#160;-1
+(see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> and see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>).
+</para>
+<indexterm role="cp"><primary>package, <literal>indentfirst</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>indentfirst</literal> package</primary></indexterm>
+
+<para>In the class <literal>article</literal>, if a paragraph immediately follows the part
+title then it is not indented. To get an indent you can use the package
+<filename>indentfirst</filename>.
+</para>
+<indexterm role="cp"><primary>package, <literal>titlesec</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>titlesec</literal> package</primary></indexterm>
+
+<para>One package to change the behavior of <literal>\part</literal> is <filename>titlesec</filename>.
+See its documentation on CTAN.
+</para>
+
+</sect1>
+<sect1 label="6.2" id="_005cchapter">
+<title><literal>\chapter</literal></title>
+
+<indexterm role="fn"><primary>\chapter</primary></indexterm>
+<indexterm role="cp"><primary>chapter</primary></indexterm>
+
+<para>Synopsis, one of:
+</para>
+<screen>\chapter{<replaceable>title</replaceable>}
+\chapter*{<replaceable>title</replaceable>}
+\chapter[<replaceable>toc-title</replaceable>]{<replaceable>title</replaceable>}
+</screen>
+<para>Start a chapter. The standard &latex; classes <literal>book</literal> and
+<literal>report</literal> have this command but <literal>article</literal> does not.
+</para>
+<para>This produces a chapter.
+</para>
+<screen>\chapter{Loomings}
+Call me Ishmael.
+Some years ago---never mind how long precisely---having little or no
+money in my purse, and nothing particular to interest me on shore, I
+thought I would sail about a little and see the watery part of
+the world.
+</screen>
+<para>The &latex; default starts each chapter on a fresh page, an
+odd-numbered page if the document is two-sided. It produces a chapter
+number such as &#8216;<literal>Chapter 1</literal>&#8217; in large boldface type (the size is
+<literal>\huge</literal>). It then puts <replaceable>title</replaceable> on a fresh line, in boldface
+type that is still larger (size <literal>\Huge</literal>). It also increments the
+<literal>chapter</literal> counter, adds an entry to the table of contents
+(see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>), and sets the running header
+information (see <link linkend="Page-styles">Page styles</link>).
+</para>
+<para>The <literal>*</literal>&#160;form shows <replaceable>title</replaceable> on a fresh line, in boldface.
+But it does not show the chapter number, does not increment the
+<literal>chapter</literal> counter, produces no table of contents entry, and does
+not affect the running header. (If you use the page style
+<literal>headings</literal> in a two-sided document then the header will be from the
+prior chapter.) This example illustrates.
+</para>
+<screen>\chapter*{Preamble}
+</screen>
+<para>The optional argument <replaceable>toc-title</replaceable> will appear as the chapter title
+in the table of contents (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>) and in
+running headers (see <link linkend="Page-styles">Page styles</link>). If it is not present then
+<replaceable>title</replaceable> will be there. This shows the full name in the chapter
+title,
</para>
-<screen>\section*{Preamble}
+<screen>\chapter[Weyl]{Hermann Klaus Hugo (Peter) Weyl (1885--1955)}
</screen>
+<para>but only &#8216;<literal>Weyl</literal>&#8217; on the contents page. This puts a line break in
+the title but that doesn&#8217;t work well with running headers so it omits
+the break in the contents
+</para>
+<screen>\chapter[Given it all\\ my story]{Given it all\\ my story}
+</screen>
+<para>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a chapter is&#160;0
+(see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> and see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>).
+</para>
+<indexterm role="cp"><primary>package, <literal>indentfirst</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>indentfirst</literal> package</primary></indexterm>
+
+<para>The paragraph that follows the chapter title is not indented, as is a
+standard typographical practice. To get an indent use the package
+<filename>indentfirst</filename>.
+</para>
+<para>You can change what is shown for the chapter number. To change it to
+something like &#8216;<literal>Lecture 1</literal>&#8217;, put in the preamble either
+<literal>\renewcommand{\chaptername}{Lecture}</literal> or this
+(see <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</link>).
+</para>
+<screen>\makeatletter
+\renewcommand{\@chapapp}{Lecture}
+\makeatother
+</screen>
+<indexterm role="cp"><primary>package, <literal>babel</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>babel</literal> package</primary></indexterm>
+
+<para>To make this change because of the primary language for
+the document, see the package <filename>babel</filename>.
+</para>
+<para>In a two-sided document &latex; puts a chapter on odd-numbered page, if
+necessary leaving an even-numbered page that is blank except for any
+running headers. To make that page completely blank,
+see&#160;<link linkend="_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</link>.
+</para>
+<indexterm role="cp"><primary>package, <literal>titlesec</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>titlesec</literal> package</primary></indexterm>
+
+<para>To change the behavior of the <literal>\chapter</literal> command, you can copy its
+definition from the &latex; format file and make adjustments. But
+there are also many packages on CTAN that address this. One is
+<filename>titlesec</filename>. See its documentation, but the example below gives a
+sense of what it can do.
+</para>
+<screen>\usepackage{titlesec} % in preamble
+\titleformat{\chapter}
+ {\Huge\bfseries} % format of title
+ {} % label, such as 1.2 for a subsection
+ {0pt} % length of separation between label and title
+ {} % before-code hook
+</screen>
+<para>This omits the chapter number &#8216;<literal>Chapter 1</literal>&#8217; from the page but unlike
+<literal>\chapter*</literal> it keeps the chapter in the table of contents and the
+running headers.
+</para>
+
+</sect1>
+<sect1 label="6.3" id="_005csection">
+<title><literal>\section</literal></title>
+
+<indexterm role="fn"><primary>\section</primary></indexterm>
+<indexterm role="cp"><primary>section</primary></indexterm>
+
+<para>Synopsis, one of:
+</para>
+<screen>\section{<replaceable>title</replaceable>}
+\section*{<replaceable>title</replaceable>}
+\section[<replaceable>toc-title</replaceable>]{<replaceable>title</replaceable>}
+</screen>
+<para>Start a section. The standard &latex; classes <literal>article</literal>,
+<literal>book</literal>, and <literal>report</literal> all have this command.
+</para>
+<para>This produces a section.
+</para>
+<screen>In this Part we tend to be more interested in the function,
+in the input-output behavior,
+than in the details of implementing that behavior.
+
+\section{Turing machines}
+Despite this desire to downplay implementation,
+we follow the approach of A~Turing that the
+first step toward defining the set of computable functions
+is to reflect on the details of what mechanisms can do.
+</screen>
+<para>For the standard &latex; classes <literal>book</literal> and <literal>report</literal> the
+default output is like &#8216;<literal>1.2 <replaceable>title</replaceable></literal>&#8217; (for chapter&#160;1,
+section&#160;2), alone on its line and flush left, in boldface and a
+larger type (the type size is <literal>\Large</literal>). The same holds in
+<literal>article</literal> except that there are no chapters in that class so it
+looks like &#8216;<literal>2 <replaceable>title</replaceable></literal>&#8217;.
+</para>
+<para>The <literal>*</literal>&#160;form shows <replaceable>title</replaceable>.
+But it does not show the section number, does not increment the
+<literal>section</literal> counter, produces no table of contents entry, and does
+not affect the running header. (If you use the page style
+<literal>headings</literal> in a two-sided document then the header will be from the
+prior section.)
+</para>
+<para>The optional argument <replaceable>toc-title</replaceable> will appear as the section title
+in the table of contents (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>) and in
+running headers (see <link linkend="Page-styles">Page styles</link>). If it is not present then
+<replaceable>title</replaceable> will be there. This shows the full name in the title of the
+section,
+</para>
+<screen>\section[Elizabeth~II]{Elizabeth the Second,
+ by the Grace of God of the United Kingdom,
+ Canada and Her other Realms and Territories Queen,
+ Head of the Commonwealth, Defender of the Faith.}
+</screen>
+<para>but only &#8216;<literal>Elizabeth II</literal>&#8217; on the contents page and in the headers.
+This has a line break in <replaceable>title</replaceable> but that does not work with headers
+so it is omitted from the contents and headers.
+</para>
+<screen>\section[Truth is, I cheated; my life story]{Truth is,
+ I cheated\\my life story}
+</screen>
+<para>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a section is&#160;1
+(see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> and see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>).
+</para>
+<indexterm role="cp"><primary>package, <literal>indentfirst</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>indentfirst</literal> package</primary></indexterm>
+
+<para>The paragraph that follows the section title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package <filename>indentfirst</filename>.
+</para>
+<indexterm role="cp"><primary>package, <literal>titlesec</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>titlesec</literal> package</primary></indexterm>
+
+<para>In general, to change the behavior of the <literal>\section</literal> command, there
+are a number of options. One is the <literal>\@startsection</literal> command
+(see <link linkend="_005c_0040startsection">\@startsection</link>). There are also many packages on CTAN that
+address this, including <filename>titlesec</filename>. See the documentation but the
+example below gives a sense of what they can do.
+</para>
+<!-- credit: egreg https://groups.google.com/forum/#!topic/comp.text.tex/tvc8oM5P4y4 -->
+<screen>\usepackage{titlesec} % in preamble
+\titleformat{\section}
+ {\normalfont\Large\bfseries} % format of title
+ {\makebox[1pc][r]{\thesection\hspace{1pc}}} % label
+ {0pt} % length of separation between label and title
+ {} % before-code hook
+\titlespacing*{\section}
+ {-1pc}{18pt}{10pt}[10pc]
+</screen>
+<para>That puts the section number in the margin.
+</para>
+
+</sect1>
+<sect1 label="6.4" id="_005csubsection">
+<title><literal>\subsection</literal></title>
+
+<indexterm role="fn"><primary>\subsection</primary></indexterm>
+<indexterm role="cp"><primary>subsection</primary></indexterm>
+
+<para>Synopsis, one of:
+</para>
+<screen>\subsection{<replaceable>title</replaceable>}
+\subsection*{<replaceable>title</replaceable>}
+\subsection[<replaceable>toc-title</replaceable>]{<replaceable>title</replaceable>}
+</screen>
+<para>Start a subsection. The standard &latex; classes <literal>article</literal>,
+<literal>book</literal>, and <literal>report</literal> all have this command.
+</para>
+<para>This produces a subsection.
+</para>
+<screen>We will show that there are more functions than Turing machines and that
+therefore some functions have no associated machine.
+
+\subsection{Cardinality} We will begin with two paradoxes that
+dramatize the challenge to our intuition posed by comparing the sizes of
+infinite sets.
+</screen>
+<para>For the standard &latex; classes <literal>book</literal> and <literal>report</literal> the
+default output is like &#8216;<literal>1.2.3 <replaceable>title</replaceable></literal>&#8217; (for chapter&#160;1,
+section&#160;2, subsection&#160;3), alone on its line and flush left, in
+boldface and a larger type (the type size is <literal>\large</literal>). The same
+holds in <literal>article</literal> except that there are no chapters in that class
+so it looks like &#8216;<literal>2.3 <replaceable>title</replaceable></literal>&#8217;.
+</para>
+<para>The <literal>*</literal>&#160;form shows <replaceable>title</replaceable>.
+But it does not show the section number, does not increment the
+<literal>section</literal> counter, and produces no table of contents entry.
+</para>
+<para>The optional argument <replaceable>toc-title</replaceable> will appear as the section title
+in the table of contents (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>). If it is
+not present then <replaceable>title</replaceable> will be there. This shows the full name in
+the title of the section,
+</para>
+<screen>\subsection[$\alpha,\beta,\gamma$ paper]{\textit{The Origin of
+ Chemical Elements} by R.A.~Alpher, H.~Bethe, and G.~Gamow}
+</screen>
+<para>but only &#8216;<literal>&#x03B1;,&#x03B2;,&#x03B3;
+paper</literal>&#8217; on the contents page.
+</para>
+<para>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a subsection is&#160;2
+(see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> and see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>).
+</para>
+<indexterm role="cp"><primary>package, <literal>indentfirst</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>indentfirst</literal> package</primary></indexterm>
+
+<para>The paragraph that follows the subsection title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package <filename>indentfirst</filename>.
+</para>
+<indexterm role="cp"><primary>package, <literal>titlesec</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>titlesec</literal> package</primary></indexterm>
+
+<para>There are a number of ways to change the behavior of the
+<literal>\subsection</literal> command. One is the <literal>\@startsection</literal> command
+(see <link linkend="_005c_0040startsection">\@startsection</link>). There are also many packages on CTAN that
+address this, including <filename>titlesec</filename>. See the documentation but the
+example below gives a sense of what they can do.
+</para>
+<screen>\usepackage{titlesec} % in preamble
+\titleformat{\subsection}[runin]
+ {\normalfont\normalsize\bfseries} % format of the title
+ {\thesubsection} % label
+ {0.6em} % space between label and title
+ {} % before-code hook
+</screen>
+<para>That puts the subsection number and <replaceable>title</replaceable> in the first line of
+text.
+</para>
+
+</sect1>
+
+<sect1 label="6.5" id="_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">
+<title><literal>\subsubsection</literal>, <literal>\paragraph</literal>, <literal>\subparagraph</literal></title>
+
+<indexterm role="fn"><primary>\subsubsection</primary></indexterm>
+<indexterm role="cp"><primary>subsubsection</primary></indexterm>
+<indexterm role="fn"><primary>\paragraph</primary></indexterm>
+<indexterm role="cp"><primary>paragraph</primary></indexterm>
+<indexterm role="fn"><primary>\subparagraph</primary></indexterm>
+<indexterm role="cp"><primary>subparagraph</primary></indexterm>
+
+<para>Synopsis, one of:
+</para>
+<screen>\subsubsection{<replaceable>title</replaceable>}
+\subsubsection*{<replaceable>title</replaceable>}
+\subsubsection[<replaceable>toc-title</replaceable>]{<replaceable>title</replaceable>}
+</screen>
+<para>or one of:
+</para>
+<screen>\paragraph{<replaceable>title</replaceable>}
+\paragraph*{<replaceable>title</replaceable>}
+\paragraph[<replaceable>toc-title</replaceable>]{<replaceable>title</replaceable>}
+</screen>
+<para>or one of:
+</para>
+<screen>\subparagraph{<replaceable>title</replaceable>}
+\subparagraph*{<replaceable>title</replaceable>}
+\subparagraph[<replaceable>toc-title</replaceable>]{<replaceable>title</replaceable>}
+</screen>
+<para>Start a subsubsection, paragraph, or subparagraph. The standard
+&latex; classes <literal>article</literal>, <literal>book</literal>, and <literal>report</literal> all have
+these commands, although they are not commonly used.
+</para>
+<para>This produces a subsubsection.
+</para>
+<screen>\subsubsection{Piston ring compressors: structural performance}
+Provide exterior/interior wall cladding assemblies
+capable of withstanding the effects of load and stresses from
+consumer-grade gasoline engine piston rings.
+</screen>
+<para>The default output of each of the three does not change over the
+standard &latex; classes <literal>article</literal>, <literal>book</literal>, and
+<literal>report</literal>. For <literal>\subsubsection</literal> the <replaceable>title</replaceable> is alone on
+its line, in boldface and normal size type. For <literal>\paragraph</literal> the
+<replaceable>title</replaceable> is inline with the text, not indented, in boldface and
+normal size type. For <literal>\subparagraph</literal> the <replaceable>title</replaceable> is inline
+with the text, with a paragraph indent, in boldface and normal size type
+(Because an <literal>article</literal> has no chapters its subsubsections are
+numbered and so it looks like &#8216;<literal>1.2.3 <replaceable>title</replaceable></literal>&#8217;, for
+section&#160;1, subsection&#160;2, and subsubsection&#160;3. The other
+two divisions are not numbered.)
+</para>
+<para>The <literal>*</literal>&#160;form shows <replaceable>title</replaceable>. But it does not increment the
+associated counter and produces no table of contents entry (and does not
+show the number for <literal>\subsubsection</literal>).
+</para>
+<para>The optional argument <replaceable>toc-title</replaceable> will appear as the division title
+in the table of contents (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>). If it is
+not present then <replaceable>title</replaceable> will be there.
+</para>
+<para>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a subsubsection is&#160;3, of
+a paragraph is&#160;4, and of a subparagraph is&#160;5
+(see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> and see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>).
+</para>
+<indexterm role="cp"><primary>package, <literal>indentfirst</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>indentfirst</literal> package</primary></indexterm>
+
+<para>The paragraph that follows the subsubsection title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package <filename>indentfirst</filename>.
+</para>
+<indexterm role="cp"><primary>package, <literal>titlesec</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>titlesec</literal> package</primary></indexterm>
+
+<para>There are a number of ways to change the behavior of the these commands.
+One is the <literal>\@startsection</literal> command (see <link linkend="_005c_0040startsection">\@startsection</link>).
+There are also many packages on CTAN that address this, including
+<filename>titlesec</filename>. See the documentation on CTAN.
+</para>
+
+</sect1>
+
+<sect1 label="6.6" id="_005cappendix">
+<title><literal>\appendix</literal></title>
+
<indexterm role="fn"><primary>\appendix</primary></indexterm>
-<indexterm role="cp"><primary>appendix, creating</primary></indexterm>
-<para>The <literal>\appendix</literal> command changes the way following sectional units
-are numbered. The <literal>\appendix</literal> command itself generates no text
-and does not affect the numbering of parts. The normal use of this
-command is something like
-</para>
-<screen>\chapter{A Chapter}
-&#8230;
-\appendix
-\chapter{The First Appendix}
+<indexterm role="cp"><primary>appendix</primary></indexterm>
+<indexterm role="cp"><primary>appendices</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\appendix
</screen>
-<indexterm role="fn"><primary>secnumdepth counter</primary></indexterm>
-<indexterm role="cp"><primary>section numbers, printing</primary></indexterm>
-<anchor id="Sectioning_002fsecnumdepth"/><para>The <literal>secnumdepth</literal> counter controls printing of section numbers.
-The setting
+<para>This does not directly produce any output. But in a book or report it
+declares that subsequent <literal>\chapter</literal> commands start an appendix. In
+an article it does the same, for <literal>\section</literal> commands. It also
+resets the <literal>chapter</literal> and <literal>section</literal> counters to&#160;0 in a
+book or report, and in an article resets the <literal>section</literal> and
+<literal>subsection</literal> counters.
+</para>
+<para>In this book
</para>
-<screen>\setcounter{secnumdepth}{<replaceable>level</replaceable>}
+<screen>\chapter{One} ...
+\chapter{Two} ...
+ ...
+\appendix
+\chapter{Three} ...
+\chapter{Four} ...
</screen>
-<para>suppresses heading numbers at any depth <inlineequation><mathphrase>&gt; <replaceable>level</replaceable></mathphrase></inlineequation>, where
-<literal>chapter</literal> is level zero. The default <literal>secnumdepth</literal> is 3 in
-&latex;&#8217;s <filename>article</filename> class and 2 in the <filename>book</filename> and
-<filename>report</filename> classes. (See <link linkend="_005csetcounter">\setcounter</link>.)
+<para>the first two will generate output numbered &#8216;<literal>Chapter 1</literal>&#8217; and
+&#8216;<literal>Chapter 2</literal>&#8217;. After the <literal>\appendix</literal> the numbering will be
+&#8216;<literal>Appendix A</literal>&#8217; and &#8216;<literal>Appendix B</literal>&#8217;. See <link linkend="Larger-book-template">Larger book template</link>
+for another example.
</para>
+<indexterm role="cp"><primary>package, <literal>appendix</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>appendix</literal> package</primary></indexterm>
+<para>The <filename>appendix</filename> package adds the command
+<literal>\appendixpage</literal> to put a separate &#8216;<literal>Appendices</literal>&#8217; in the document
+body before the first appendix, and the command <literal>\addappheadtotoc</literal>
+to do the same in the table of contents. You can reset the name
+&#8216;<literal>Appendix</literal>&#8217; with a command like
+<literal>\renewcommand{\appendixname}{Specification}</literal>, as well as a
+number of other features. See the documentation on CTAN.
+</para>
+
+</sect1>
+
+<sect1 label="6.7" id="_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">
+<title><literal>\frontmatter</literal>, <literal>\mainmatter</literal>, <literal>\backmatter</literal></title>
+<indexterm role="fn"><primary>\frontmatter</primary></indexterm>
+<indexterm role="cp"><primary>book, front matter</primary></indexterm>
+<indexterm role="fn"><primary>\mainmatter</primary></indexterm>
+<indexterm role="cp"><primary>book, main matter</primary></indexterm>
+<indexterm role="fn"><primary>\backmatter</primary></indexterm>
+<indexterm role="cp"><primary>book, back matter</primary></indexterm>
+<indexterm role="cp"><primary>book, end matter</primary></indexterm>
+
+<para>Synopsis, one of:
+</para>
+<screen>\frontmatter
+\mainmatter
+\backmatter
+</screen>
+<para>Format a <literal>book</literal> class document differently according to which part
+of the document is being produced. All three commands are optional.
+</para>
+<para>Traditionally, a book&#8217;s front matter contains such things as the title
+page, an abstract, a table of contents, a preface, a list of notations,
+a list of figures, and a list of tables. (Some of these front matter
+pages, such as the title page, are traditionally not numbered.) The
+back matter may contain such things as a glossary, notes, a
+bibliography, and an index.
+</para>
+<para>The <literal>\frontmatter</literal> declaration makes the pages numbered in
+lowercase roman, and makes chapters not numbered, although each
+chapter&#8217;s title appears in the table of contents; if you use other
+sectioning commands here, use the <literal>*</literal>-version (see <link linkend="Sectioning">Sectioning</link>).
+The <literal>\mainmatter</literal> changes the behavior back to the expected
+version, and resets the page number. The <literal>\backmatter</literal> leaves the
+page numbering alone but switches the chapters back to being not
+numbered. See <link linkend="Larger-book-template">Larger book template</link> for an example using the three.
+</para>
-<sect1 label="6.1" id="_005c_0040startsection">
+</sect1>
+<sect1 label="6.8" id="_005c_0040startsection">
<title><literal>\@startsection</literal></title>
<indexterm role="fn"><primary>\@startsection</primary></indexterm>
@@ -2430,10 +3052,24 @@ make such a command you may want to use the <literal>\secdef</literal> command.
<!-- xx define, and make a cross reference to, secdef. -->
</para>
<para>Technically, <literal>\@startsection</literal> has the form
-</para><screen>\@startsection{<replaceable>name</replaceable>}{<replaceable>level</replaceable>}{<replaceable>indent</replaceable>}{<replaceable>beforeskip</replaceable>}{<replaceable>afterskip</replaceable>}{<replaceable>style</replaceable>}*[<replaceable>toctitle</replaceable>]{<replaceable>title</replaceable>}
-</screen><para>(the star&#160;<literal>*</literal> is optional), so that issuing
-</para><screen>\renewcommand{\section}{\@startsection{<replaceable>name</replaceable>}{<replaceable>level</replaceable>}{<replaceable>indent</replaceable>}{<replaceable>beforeskip</replaceable>}{<replaceable>afterskip</replaceable>}{<replaceable>style</replaceable>}}
-</screen><para>redefines <literal>\section</literal> to have the form
+</para>
+<screen>\@startsection{<replaceable>name</replaceable>}
+ {<replaceable>level</replaceable>}
+ {<replaceable>indent</replaceable>}
+ {<replaceable>beforeskip</replaceable>}
+ {<replaceable>afterskip</replaceable>}
+ {<replaceable>style</replaceable>}*[<replaceable>toctitle</replaceable>]{<replaceable>title</replaceable>}
+</screen>
+<para>so that issuing
+</para>
+<screen>\renewcommand{\section}{\@startsection{<replaceable>name</replaceable>}
+ {<replaceable>level</replaceable>}
+ {<replaceable>indent</replaceable>}
+ {<replaceable>beforeskip</replaceable>}
+ {<replaceable>afterskip</replaceable>}
+ {<replaceable>style</replaceable>}}
+</screen>
+<para>redefines <literal>\section</literal> to have the form
<literal>\section*[<replaceable>toctitle</replaceable>]{<replaceable>title</replaceable>}</literal> (here too, the
star&#160;<literal>*</literal> is optional). See <link linkend="Sectioning">Sectioning</link>. This implies that
when you write a command like <literal>\renewcommand{section}{...}</literal>,
@@ -2442,55 +3078,48 @@ the examples below.
</para>
<variablelist>
<varlistentry><term><replaceable>name</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fname"/><para>Name of the counter used to number the
-sectioning header. This counter must be defined separately. Most
-commonly this is either <literal>section</literal>, <literal>subsection</literal>, or
-<literal>paragraph</literal>. Although in those three cases the counter name is the
-same as the sectioning command itself, using the same name is not
-required.
+</term><listitem><anchor id="startsection-name"/><anchor id="_005c_0040startsection_002fname"/><para>Name of the counter used to number the sectioning header. This counter
+must be defined separately. Most commonly this is either
+<literal>section</literal>, <literal>subsection</literal>, or <literal>paragraph</literal>. Although in
+those cases the counter name is the same as the sectioning command
+itself, you don&#8217;t have to use the same name.
</para>
<para>Then <literal>\the</literal><replaceable>name</replaceable> displays the title number and
<literal>\</literal><replaceable>name</replaceable><literal>mark</literal> is for the page headers. See the third
example below.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>level</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002flevel"/><para>An integer giving the depth of the
-sectioning command: 0 for <literal>chapter</literal> (only applies to the standard
-<literal>book</literal> and <literal>report</literal> classes), 1 for <literal>section</literal>, 2 for
-<literal>subsection</literal>, 3 for <literal>subsubsection</literal>, 4 for <literal>paragraph</literal>,
-and 5 for <literal>subparagraph</literal>. In the <literal>book</literal> and <literal>report</literal>
-classes <literal>part</literal> has level -1, while in the <literal>article</literal> class
-<literal>part</literal> has level 0.
-</para>
-<para>If <replaceable>level</replaceable> is less than or equal to the value of <literal>secnumdepth</literal>
-then the titles for this sectioning command will be numbered. For
-instance, in an <literal>article</literal>, if <literal>secnumdepth</literal> is 1 then a
-<literal>\section{Introduction}</literal> command will produce output like &#8220;1
+</term><listitem><anchor id="startsection-level"/><anchor id="_005c_0040startsection_002flevel"/><para>An integer giving the depth of the sectioning command.
+See <link linkend="Sectioning">Sectioning</link> for the list of standard level numbers.
+</para>
+<para>If <replaceable>level</replaceable> is less than or equal to the value of the counter
+<literal>secnumdepth</literal> then titles for this sectioning command will be
+numbered (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link>). For instance, if
+<literal>secnumdepth</literal> is 1 in an <literal>article</literal> then the command
+<literal>\section{Introduction}</literal> will produce output like &#8220;1
Introduction&#8221; while <literal>\subsection{Discussion}</literal> will produce
output like &#8220;Discussion&#8221;, without the number prefix.
-See <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link>.
</para>
-<para>If <replaceable>level</replaceable> is less than or equal to the value of <replaceable>tocdepth</replaceable> then
-the table of contents will have an entry for this sectioning unit.
-For instance, in an <literal>article</literal>, if <replaceable>tocdepth</replaceable> is 1 then the table of
-contents will list sections but not subsections.
-<!-- xx add, and cross reference to, tocdepth -->
+<para>If <replaceable>level</replaceable> is less than or equal to the value of the counter
+<replaceable>tocdepth</replaceable> then the table of contents will have an entry for this
+sectioning unit (see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). For instance, in an
+<literal>article</literal>, if <replaceable>tocdepth</replaceable> is 1 then the table of contents will
+list sections but not subsections.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>indent</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002findent"/><para>A length giving the indentation of all
-of the title lines with respect to the left margin. To have the title
-flush with the margin use <literal>0pt</literal>. A negative indentation such as
-<literal>-\parindent</literal> will move the title into the left margin.
+</term><listitem><anchor id="startsection-indent"/><anchor id="_005c_0040startsection_002findent"/><para>A length giving the indentation of all of the title lines with respect
+to the left margin. To have the title flush with the margin use
+<literal>0pt</literal>. A negative indentation such as <literal>-\parindent</literal> will move
+the title into the left margin.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>beforeskip</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fbeforeskip"/><para>The absolute value of this length is
-the amount of vertical space that is inserted before this sectioning
-unit&#8217;s title. This space will be discarded if the sectioning unit
-happens to start at the top of a fresh page. If this number is negative
-then the first paragraph following the header is not indented, if it is
-non-negative then the first paragraph is indented. (Note that the
-negative of <literal>1pt plus 2pt minus 3pt</literal> is <literal>-1pt plus -2pt minus
--3pt</literal>.)
+</term><listitem><anchor id="startsection-beforeskip"/><anchor id="_005c_0040startsection_002fbeforeskip"/><para>The absolute value of this length is the amount of vertical space that
+is inserted before this sectioning unit&#8217;s title. This space will be
+discarded if the sectioning unit happens to start at the top of a fresh
+page. If this number is negative then the first paragraph following the
+header is not indented, if it is non-negative then the first paragraph
+is indented. (Note that the negative of <literal>1pt plus 2pt minus 3pt</literal>
+is <literal>-1pt plus -2pt minus -3pt</literal>.)
</para>
<para>For example, if <replaceable>beforeskip</replaceable> is <literal>-3.5ex plus -1ex minus -0.2ex</literal>
then to start the new sectioning unit, &latex; will add about 3.5 times
@@ -2510,14 +3139,13 @@ where &latex; would put the baseline of the first text line on that
page.)
</para>
</listitem></varlistentry><varlistentry><term><replaceable>afterskip</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fafterskip"/><para>This is a length. If <replaceable>afterskip</replaceable>
-is non-negative then this is the vertical space inserted after the
-sectioning unit&#8217;s title header. If it is negative then the title header
-becomes a run-in header, so that it becomes part of the next paragraph.
-In this case the absolute value of the length gives the horizontal space
-between the end of the title and the beginning of the following
-paragraph. (Note that the negative of <literal>1pt plus 2pt minus 3pt</literal> is
-<literal>-1pt plus -2pt minus -3pt</literal>.)
+</term><listitem><anchor id="startsection-afterskip"/><anchor id="_005c_0040startsection_002fafterskip"/><para>This is a length. If <replaceable>afterskip</replaceable> is non-negative then this is the
+vertical space inserted after the sectioning unit&#8217;s title header. If it
+is negative then the title header becomes a run-in header, so that it
+becomes part of the next paragraph. In this case the absolute value of
+the length gives the horizontal space between the end of the title and
+the beginning of the following paragraph. (Note that the negative of
+<literal>1pt plus 2pt minus 3pt</literal> is <literal>-1pt plus -2pt minus -3pt</literal>.)
</para>
<para>As with <replaceable>beforeskip</replaceable>, using a rubber length, with <literal>plus</literal> and
<literal>minus</literal> components, is good practice here since it gives &latex;
@@ -2534,45 +3162,36 @@ header&#8217;s from standalone to run-in, you cannot use a negative
<literal>afterskip</literal> to cancel part of the <literal>\parskip</literal>.)
</para>
</listitem></varlistentry><varlistentry><term><replaceable>style</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fstyle"/><para>Controls the styling of the title. See
-the examples below. Typical commands to use here are <literal>\centering</literal>,
-<literal>\raggedright</literal>, <literal>\normalfont</literal>, <literal>\hrule</literal>, or
-<literal>\newpage</literal>. The last command in <replaceable>style</replaceable> may be one such as
-<literal>\MakeUppercase</literal> or <literal>\fbox</literal> that takes one argument. The
+</term><listitem><anchor id="startsection-style"/><anchor id="_005c_0040startsection_002fstyle"/><para>Controls the styling of the title. See the examples below. Typical
+commands to use here are <literal>\centering</literal>, <literal>\raggedright</literal>,
+<literal>\normalfont</literal>, <literal>\hrule</literal>, or <literal>\newpage</literal>. The last command
+in <replaceable>style</replaceable> may be one that takes one argument, such as
+<literal>\MakeUppercase</literal> or <literal>\fbox</literal> that takes one argument. The
section title will be supplied as the argument to this command. For
instance, setting <replaceable>style</replaceable> to <literal>\bfseries\MakeUppercase</literal> would
-produce titles that are bold and upper case.
+produce titles that are bold and uppercase.
</para></listitem></varlistentry></variablelist>
<para>These are &latex;&#8217;s defaults for the first three sectioning units that
are defined with <literal>\@startsection</literal>, for the <filename>article</filename>,
-<filename>book</filename>, and <filename>report</filename> classes.
-</para>
-<informaltable><tgroup cols="4"><colspec colwidth="10*"></colspec><colspec colwidth="30*"></colspec><colspec colwidth="30*"></colspec><colspec colwidth="30*"></colspec><thead><row><entry></entry><entry><para><literal>section</literal> </para></entry><entry><para><literal>subsection</literal> </para></entry><entry><para><literal>subsubsection</literal>
-</para></entry></row></thead><tbody><row><entry><para><link linkend="_005c_0040startsection_002fname"><replaceable>name</replaceable></link>
-</para></entry><entry><para>section </para></entry><entry><para>subsection </para></entry><entry><para>subsubsection
-</para></entry></row><row><entry><para><link linkend="_005c_0040startsection_002flevel"><replaceable>level</replaceable></link>
-</para></entry><entry><para>1 </para></entry><entry><para>2 </para></entry><entry><para>3
-</para></entry></row><row><entry><para><link linkend="_005c_0040startsection_002findent"><replaceable>indent</replaceable></link>
-</para></entry><entry><para><literal>0pt</literal> </para></entry><entry><para><literal>0pt</literal> </para></entry><entry><para><literal>0pt</literal>
-</para></entry></row><row><entry><para><link linkend="_005c_0040startsection_002fbeforeskip"><replaceable>beforeskip</replaceable></link>
-</para></entry><entry><para><literal>-3.5ex plus -1ex minus -0.2ex</literal>
-</para></entry><entry><para><literal>-3.25ex plus -1ex minus -0.2ex</literal>
-</para></entry><entry><para><literal>-3.25ex plus -1ex minus -0.2ex</literal>
-</para></entry></row><row><entry><para><link linkend="_005c_0040startsection_002fafterskip"><replaceable>afterskip</replaceable></link>
-</para></entry><entry><para><literal>2.3ex plus 0.2ex</literal>
-</para></entry><entry><para><literal>1.5ex plus 0.2ex</literal>
-</para></entry><entry><para><literal>1.5ex plus 0.2ex</literal>
-</para></entry></row><row><entry><para><link linkend="_005c_0040startsection_002fstyle"><replaceable>style</replaceable></link>
-</para></entry><entry><para><literal>\normalfont\Large\bfseries</literal>
-</para></entry><entry><para><literal>\normalfont\large\bfseries</literal>
-</para></entry><entry><para><literal>\normalfont\normalsize\bfseries</literal>
-</para></entry></row></tbody></tgroup></informaltable>
+<filename>book</filename>, and <filename>report</filename> classes. For section, the <replaceable>level</replaceable> is
+1, the <replaceable>indent</replaceable> is 0pt, the <replaceable>beforeskip</replaceable> is <literal>-3.5ex
+plus -1ex minus -0.2ex</literal>, the <replaceable>afterskip</replaceable> is <literal>2.3ex plus 0.2ex</literal>,
+and the <replaceable>style</replaceable> is <literal>\normalfont\Large\bfseries</literal>. For
+subsection, the <replaceable>level</replaceable> is 2, the <replaceable>indent</replaceable> is 0pt, the
+<replaceable>beforeskip</replaceable> is <literal>-3.25ex plus -1ex minus -0.2ex</literal>, the
+<replaceable>afterskip</replaceable> is <literal>1.5ex plus 0.2ex</literal>, and the <replaceable>style</replaceable> is
+<literal>\normalfont\large\bfseries</literal>. For subsubsection, the <replaceable>level</replaceable>
+is 3, the <replaceable>indent</replaceable> is 0pt, the <replaceable>beforeskip</replaceable> is
+<literal>-3.25ex plus -1ex minus -0.2ex</literal>, the <replaceable>afterskip</replaceable> is
+<literal>1.5ex plus 0.2ex</literal>, and the <replaceable>style</replaceable> is
+<literal>\normalfont\normalsize\bfseries</literal>.
+</para>
<para>Here are examples. They go either in a package or class file or in the
preamble of a &latex; document. If you put them in the preamble they
must go between a <literal>\makeatletter</literal> command and a
<literal>\makeatother</literal>. (Probably the error message <literal>You can't use
`\spacefactor' in vertical mode.</literal> means that you forgot this.)
-See <link linkend="_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</link>.
+See <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</link>.
</para>
<para>This will put section titles in large boldface type, centered. It says
<literal>\renewcommand</literal> because &latex;&#8217;s standard classes have already
@@ -2600,7 +3219,9 @@ defined a <literal>\section</literal>. For the same reason it does not define a
{\scshape}% <link linkend="_005c_0040startsection_002fstyle"><replaceable>style</replaceable></link>
}
</screen>
-<para>The prior examples redefined existing sectional unit title commands. This defines a new one, illustrating the needed counter and macros to display that counter.
+<para>The prior examples redefined existing sectional unit title commands.
+This defines a new one, illustrating the needed counter and macros to
+display that counter.
</para>
<!-- From https://groups.google.com/forum/#!searchin/comp.text.tex/startsection%7Csort:relevance/comp.text.tex/sB-nTS-oL08/ZZeKYdG0llMJ -->
<screen>\setcounter{secnumdepth}{6}% show counters this far down
@@ -2625,38 +3246,48 @@ defined a <literal>\section</literal>. For the same reason it does not define a
<indexterm role="cp"><primary>cross references</primary></indexterm>
-<para>One reason for numbering things such as figures and equations is to
-refer the reader to them, as in &#8220;See Figure~3 for more details.&#8221;
-</para>
<indexterm role="cp"><primary>label</primary></indexterm>
-<para>Including the figure number in the source is poor practice since if that
-number changes as the document evolves then you must remember to update
-this reference by hand. Instead, &latex; has you write a <firstterm>label</firstterm>
-like <literal>\label{eq:GreensThm}</literal> and refer to it with <literal>See
-equation~\ref{eq:GreensThm}</literal>.
-</para>
-<para>&latex; writes the information from the labels to a file with the same
-name as the file containing the <literal>\label{...}</literal> but with an
-<filename>.aux</filename> extension. (The information has the format
-<literal>\newlabel{<replaceable>label</replaceable>}{{<replaceable>currentlabel</replaceable>}{<replaceable>pagenumber</replaceable>}}</literal>
-where <replaceable>currentlabel</replaceable> is the current value of the macro
-<literal>\@currentlabel</literal> that is usually updated whenever you call
-<literal>\refstepcounter{<replaceable>counter</replaceable>}</literal>.)
+<para>We often want something like &#8216;<literal>See Theorem~31</literal>&#8217;. But by-hand typing
+the 31 is poor practice. Instead you should write a <firstterm>label</firstterm> such as
+<literal>\label{eq:GreensThm}</literal> and then <firstterm>reference</firstterm> it, as with
+<literal>See equation~\ref{eq:GreensThm}</literal>. &latex; will automatically
+work out the number, put it into the output, and will change that number
+later if needed.
+</para>
+<screen>We will see this with Theorem~\ref{th:GreensThm}. % forward reference
+...
+\begin{theorem} \label{th:GreensThm}
+ ...
+\end{theorem}
+...
+See Theorem~\ref{th:GreensThm} on page~\pageref{th:GreensThm}.
+</screen>
+<para>&latex; tracks cross reference information in a file having the
+extension <filename>.aux</filename> and with the same base name as the file containing
+the <literal>\label</literal>. So if <literal>\label</literal> is in <filename>calculus.tex</filename> then
+the information is in <filename>calculus.aux</filename>. &latex; puts the
+information in that file every time it runs across a <literal>\label</literal>.
</para>
<indexterm role="cp"><primary>forward reference</primary></indexterm>
<indexterm role="cp"><primary>reference, forward</primary></indexterm>
-<para>The most common side effect of the prior paragraph happens when your
-document has a <firstterm>forward reference</firstterm>, a <literal>\ref{<replaceable>key</replaceable>}</literal> that
-appears earlier than the associated <literal>\label{<replaceable>key</replaceable>}</literal>; see the
-example in the <literal>\pageref{...}</literal> description. &latex; gets the
-information for references from the <filename>.aux</filename> file. If this is the
-first time you are compiling the document then you will get a message
-<literal>LaTeX Warning: Label(s) may have changed. Rerun to get
-cross references right.</literal> and in the output the reference will appear as
-two question marks&#160;&#8216;<literal>??</literal>&#8217;, in boldface. Or, if you change some
-things so the references change then you get the same warning and the
-output contains the old reference information. The solution in either
-case is just to compile the document a second time.
+<para>The behavior described in the prior paragraph results in a quirk that
+happens when your document has a <firstterm>forward reference</firstterm>, a <literal>\ref</literal>
+that appears before the associated <literal>\label</literal>. If this is the first
+time that you are compiling the document then you will get &#8216;<literal>LaTeX
+Warning: Label(s) may have changed. Rerun to get cross references right</literal>&#8217;
+and in the output the forward reference will appear as two question
+marks&#160;&#8216;<literal>??</literal>&#8217;, in boldface. A similar thing happens if you
+change some things so the references changes; you get the same warning
+and the output contains the old reference information. In both cases,
+resolve this by compiling the document a second time.
+</para>
+<indexterm role="cp"><primary>package, <literal>cleveref</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>cleveref</literal> package</primary></indexterm>
+<para>The <literal>cleveref</literal> package enhances &latex;&#8217;s
+cross referencing features. You can arrange that if you enter
+<literal>\begin{thm}\label{th:Nerode}...\end{thm}</literal> then
+<literal>\cref{th:Nerode}</literal> will output &#8216;<literal>Theorem 3.21</literal>&#8217;, without you
+having to enter the &#8220;Theorem.&#8221;
</para>
@@ -2682,28 +3313,37 @@ punctuation characters. Upper and lowercase letters are
distinguished, as usual.
</para>
<para>A common convention is to use labels consisting of a prefix and a suffix
-separated by a colon or period. This helps to avoid accidentally
-creating two labels with the same name, and makes your source more
-readable. Some commonly-used prefixes:
+separated by a colon or period. Thus, <literal>\label{fig:Post}</literal> is a
+label for a figure with a portrait of Emil Post. This helps to avoid
+accidentally creating two labels with the same name, and makes your
+source more readable. Some commonly-used prefixes:
</para>
<variablelist><varlistentry><term><literal>ch</literal>
</term><listitem><para>for chapters
-</para></listitem></varlistentry><varlistentry><term><literal>sec</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><literal>sec</literal>
+</term><term><literal>subsec</literal>
</term><listitem><para>for lower-level sectioning commands
-</para></listitem></varlistentry><varlistentry><term><literal>fig</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><literal>fig</literal>
</term><listitem><para>for figures
-</para></listitem></varlistentry><varlistentry><term><literal>tab</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><literal>tab</literal>
</term><listitem><para>for tables
-</para></listitem></varlistentry><varlistentry><term><literal>eq</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><literal>eq</literal>
</term><listitem><para>for equations
</para></listitem></varlistentry></variablelist>
-<para>Thus, <literal>\label{fig:Euler}</literal> is a label for a figure with a portrait
-of the great man.
+<para>In the auxiliary file the reference information is kept as the text of
+a command of the form
+<literal>\newlabel{<replaceable>label</replaceable>}{{<replaceable>currentlabel</replaceable>}{<replaceable>pagenumber</replaceable>}}</literal>.
+Here <replaceable>currentlabel</replaceable> is the current value of the macro
+<literal>\@currentlabel</literal> that is usually updated whenever you call
+<literal>\refstepcounter{<replaceable>counter</replaceable>}</literal>.
</para>
-<para>In this example below the key <literal>sec:test</literal> will get the number of the
-current section and the key <literal>fig:test</literal> will get the number of the
-figure. (Incidentally, put labels after captions in figures and
-tables.)
+<para>Below, the key <literal>sec:test</literal> will get the number of the current
+section and the key <literal>fig:test</literal> will get the number of the figure.
+(Incidentally, put labels after captions in figures and tables.)
</para>
<screen>\section{section name}
\label{sec:test}
@@ -2718,7 +3358,7 @@ See Figure~\ref{fig:test}.
</sect1>
<sect1 label="7.2" id="_005cpageref">
-<title><literal>\pageref{<replaceable>key</replaceable>}</literal></title>
+<title><literal>\pageref</literal></title>
<indexterm role="fn"><primary>\pageref</primary></indexterm>
<indexterm role="cp"><primary>cross referencing with page number</primary></indexterm>
@@ -2731,10 +3371,14 @@ See Figure~\ref{fig:test}.
<para>Produce the page number of the place in the text where the corresponding
<literal>\label</literal>{<replaceable>key</replaceable>} command appears.
</para>
-<para>In this example the <literal>\label{eq:main}</literal> is used both for the
-formula number and for the page number. (Note that the two references
-are forward references, so this document would need to be compiled twice
-to resolve those.)
+<para>If there is no <literal>\label{<replaceable>key</replaceable>}</literal> then you get something like
+&#8216;<literal>LaTeX Warning: Reference `th:GrensThm' on page 1 undefined on
+input line 11.</literal>&#8217;
+</para>
+<para>Below, the <literal>\label{eq:main}</literal> is used both for the formula number
+and for the page number. (Note that the two references are forward
+references so this document would need to be compiled twice to resolve
+those.)
</para>
<screen>The main result is formula~\ref{eq:main} on page~\pageref{eq:main}.
...
@@ -2745,7 +3389,7 @@ to resolve those.)
</sect1>
<sect1 label="7.3" id="_005cref">
-<title><literal>\ref{<replaceable>key</replaceable>}</literal></title>
+<title><literal>\ref</literal></title>
<indexterm role="fn"><primary>\ref</primary></indexterm>
<indexterm role="cp"><primary>cross referencing, symbolic</primary></indexterm>
@@ -2763,9 +3407,13 @@ equation, footnote, figure, &#8230;, of the corresponding
<literal>\label</literal> command (see <link linkend="_005clabel">\label</link>). It does not produce any text,
such as the word &#8216;Section&#8217; or &#8216;Figure&#8217;, just the bare number itself.
</para>
-<para>In this example, the <literal>\ref{popular}</literal> produces &#8216;<literal>2</literal>&#8217;. Note
-that it is a forward reference since it comes before
-<literal>\label{popular}</literal>.
+<para>If there is no <literal>\label{<replaceable>key</replaceable>}</literal> then you get something like
+&#8216;<literal>LaTeX Warning: Reference `th:GrensThm' on page 1 undefined on
+input line 11.</literal>&#8217;
+</para>
+<para>In this example the <literal>\ref{popular}</literal> produces &#8216;<literal>2</literal>&#8217;. Note that
+it is a forward reference since it comes before <literal>\label{popular}</literal>
+so this document would have to be compiled twice.
</para>
<screen>The most widely-used format is item number~\ref{popular}.
\begin{enumerate}
@@ -2774,6 +3422,12 @@ that it is a forward reference since it comes before
\item Con\TeX t
\end{enumerate}
</screen>
+<indexterm role="cp"><primary>package, <literal>cleveref</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>cleveref</literal> package</primary></indexterm>
+
+<para>The <filename>cleveref</filename> package includes text such as &#8216;<literal>Theorem</literal>&#8217; in the
+reference. See the documentation on CTAN.
+</para>
</sect1>
</chapter>
@@ -2872,7 +3526,7 @@ a more flexible solution, use the package <filename>abstract</filename>).
...
\end{array}
</screen>
-<para>or
+<para>or:
</para>
<screen>\begin{array}[<replaceable>pos</replaceable>]{<replaceable>cols</replaceable>}
<replaceable>column 1 entry</replaceable> &amp;<replaceable>column 2 entry</replaceable> ... &amp;<replaceable>column n entry</replaceable> \\
@@ -2881,26 +3535,42 @@ a more flexible solution, use the package <filename>abstract</filename>).
</screen>
<para>Produce a mathematical array. This environment can only be used in math
mode, and normally appears within a displayed mathematics environment
-such as <literal>equation</literal> (see <link linkend="equation">equation</link>). Column entries are
-separated by an ampersand&#160;(<literal>&amp;</literal>). Rows are terminated with
-double-backslashes (see <link linkend="_005c_005c">\\</link>).
-</para>
+such as <literal>equation</literal> (see <link linkend="equation">equation</link>). Inside of each row the
+column entries are separated by an ampersand, (<literal>&amp;</literal>). Rows are
+terminated with double-backslashes (see <link linkend="_005c_005c">\\</link>).
+</para>
+<para>This example shows a three by three array.
+</para>
+<screen>\begin{equation*}
+ \chi(x) =
+ \left| % vertical bar fence
+ \begin{array}{ccc}
+ x-a &amp;-b &amp;-c \\
+ -d &amp;x-e &amp;-f \\
+ -g &amp;-h &amp;x-i
+ \end{array}
+ \right|
+\end{equation*}
+</screen>
<para>The required argument <replaceable>cols</replaceable> describes the number of columns, their
-alignment, and the formatting of the intercolumn regions. See
-<link linkend="tabular">tabular</link> for the complete description of <replaceable>cols</replaceable>, and of the
+alignment, and the formatting of the intercolumn regions. For instance,
+<literal>\begin{array}{rcl}...\end{array}</literal> gives three columns: the
+first flush right, the second centered, and the third flush left. See
+<link linkend="tabular">tabular</link> for the complete description of <replaceable>cols</replaceable> and of the
other common features of the two environments, including the optional
<replaceable>pos</replaceable> argument.
</para>
<para>There are two ways that <literal>array</literal> diverges from <literal>tabular</literal>. The
first is that <literal>array</literal> entries are typeset in math mode, in
-textstyle (except if the <replaceable>cols</replaceable> definition specifies the column with
-<literal>p{...}</literal>, which causes the entry to be typeset in text mode).
-The second is that, instead of <literal>tabular</literal>&#8217;s parameter
-<literal>\tabcolsep</literal>, &latex;&#8217;s intercolumn space in an <literal>array</literal> is governed
-by
+textstyle (see <link linkend="Modes">Modes</link>) except if the <replaceable>cols</replaceable> definition specifies
+the column with <literal>p{...}</literal>, which causes the entry to be typeset in
+text mode. The second is that, instead of <literal>tabular</literal>&#8217;s parameter
+<literal>\tabcolsep</literal>, &latex;&#8217;s intercolumn space in an <literal>array</literal> is
+governed by
<indexterm role="fn"><primary>\arraycolsep</primary></indexterm>
<literal>\arraycolsep</literal>, which gives half the width between columns. The
-default for this is &#8216;<literal>5pt</literal>&#8217;.
+default for this is &#8216;<literal>5pt</literal>&#8217; so that between two columns comes
+10pt of space.
</para>
<indexterm role="cp"><primary>package, <literal>amsmath</literal></primary></indexterm>
<indexterm role="cp"><primary><literal>amsmath</literal> package</primary></indexterm>
@@ -2914,25 +3584,31 @@ an array surrounded by vertical bars&#160;<literal>|...|</literal>, and
<literal>Vmatrix</literal> for an array surrounded by double vertical
bars&#160;<literal>||...||</literal>, along with a number of other array constructs.
</para>
-<para>Here is an example of an array:
-</para>
-<screen>\begin{equation}
- \begin{array}{cr}
- \sqrt{y} &amp;12.3 \\
- x^2 &amp;3.4
- \end{array}
-\end{equation}
-</screen>
-<para>The next example works if <literal>\usepackage{amsmath}</literal> is in the
-preamble:
+<indexterm role="cp"><primary>package, <literal>amsmath</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>amsmath</literal> package</primary></indexterm>
+
+<para>The next example uses the <filename>amsmath</filename> package.
</para>
-<screen>\begin{equation}
- \begin{vmatrix}{cc}
+<screen>\usepackage{amsmath} % in preamble
+
+\begin{equation}
+ \begin{vmatrix}{cc} % array with vert lines
a &amp;b \\
c &amp;d
\end{vmatrix}=ad-bc
\end{equation}
</screen>
+<indexterm role="cp"><primary>package, <literal>array (package)</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>array (package)</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>dcolumn</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>dcolumn</literal> package</primary></indexterm>
+
+<para>There are many packages concerning arrays. The <filename>array</filename> package has
+many useful extensions, including more column types. The <filename>dcolumn</filename>
+package adds a column type to center on a decimal point. For both see
+the documentation on CTAN.
+</para>
</sect1>
<sect1 label="8.3" id="center">
@@ -2946,16 +3622,18 @@ preamble:
<para>Synopsis:
</para>
<screen>\begin{center}
- ... text ...
+ <replaceable>line1</replaceable> \\
+ <replaceable>line2</replaceable> \\
+ ...
\end{center}
</screen>
<para>Create a new paragraph consisting of a sequence of lines that are
-centered within the left and right margins on the current page. Use
-double-backslash to get a line break at a particular spot (see <link linkend="_005c_005c">\\</link>).
+centered within the left and right margins. Use
+double-backslash, <literal>\\</literal>, to get a line break (see <link linkend="_005c_005c">\\</link>).
<indexterm role="fn"><primary>\\ (for <literal>center</literal>)</primary></indexterm>
-If some text environment body is too long to fit on a line, &latex;
-will insert line breaks that avoid hyphenation and avoid stretching or
-shrinking any interword space.
+If some text is too long to fit on a line then &latex; will insert line
+breaks that avoid hyphenation and avoid stretching or shrinking any
+interword space.
</para>
<para>This environment inserts space above and below the text body. See
<link linkend="_005ccentering">\centering</link> to avoid such space, for example inside a <literal>figure</literal>
@@ -2982,7 +3660,11 @@ ending.
I grew up in that belief. --Richard Burton
\end{center}
</screen>
-<para>A double backslash after the final line is optional.
+<para>A double backslash after the final line is optional. If present it
+doesn&#8217;t add any vertical space.
+</para>
+<para>In a two-column document the text is centered in a column, not in the
+entire page.
</para>
@@ -2992,12 +3674,34 @@ ending.
<indexterm role="fn"><primary>\centering</primary></indexterm>
<indexterm role="cp"><primary>centering text, declaration for</primary></indexterm>
-<para>A declaration that causes material in its scope to be centered. It is
-most often used inside an environment such as <literal>figure</literal>, or in a
-<literal>parbox</literal>.
+
+<para>Synopsis:
+</para>
+<screen>{\centering ... }
+</screen>
+<para>or
+</para>
+<screen>\begin{group}
+ \centering ...
+\end{group}
+</screen>
+<para>Center the material in its scope. It is most often used inside an
+environment such as <literal>figure</literal>, or in a <literal>parbox</literal>.
+</para>
+<para>This example&#8217;s <literal>\centering</literal> declaration causes the graphic to be
+horizontally centered.
+</para>
+<screen>\begin{figure}
+ \centering
+ \includegraphics[width=0.6\textwidth]{ctan_lion.png}
+ \caption{CTAN Lion} \label{fig:CTANLion}
+\end{figure}
+</screen>
+<para>The scope of this <literal>\centering</literal> ends with the <literal>\end{figure}</literal>.
</para>
<para>Unlike the <literal>center</literal> environment, the <literal>\centering</literal> command does
-not add vertical space above and below the text.
+not add vertical space above and below the text. That&#8217;s its advantage
+in the above example; there is not an excess of space.
</para>
<para>It also does not start a new paragraph; it simply changes how &latex;
formats paragraph units. If <literal>ww {\centering xx \\ yy} zz</literal> is
@@ -3009,18 +3713,7 @@ environment such as <literal>figure</literal> or <literal>table</literal> that e
paragraph unit. Thus, if <literal>{\centering xx \\ yy\par} zz</literal> is
surrounded by blank lines then it makes a new paragraph with two
centered lines &#8216;<literal>xx</literal>&#8217; and &#8216;<literal>yy</literal>&#8217;, followed by a new paragraph with
-&#8216;<literal>zz</literal>&#8217; that is formatted as usual. See also the following example.
-</para>
-<para>This example&#8217;s <literal>\centering</literal> causes the graphic to be horizontally
-centered.
-</para>
-<screen>\begin{figure}
- \centering
- \includegraphics[width=0.6\textwidth]{ctan_lion.png}
- \caption{CTAN Lion} \label{fig:CTANLion}
-\end{figure}
-</screen>
-<para>The scope of the <literal>\centering</literal> ends with the <literal>\end{figure}</literal>.
+&#8216;<literal>zz</literal>&#8217; that is formatted as usual.
</para>
</sect2>
@@ -3037,26 +3730,27 @@ centered.
<para>Synopsis:
</para>
<screen>\begin{description}
-\item[<replaceable>label of first item</replaceable>] text of first item
-\item[<replaceable>label of second item</replaceable>] text of second item
- ...
+ \item[<replaceable>label of first item</replaceable>] <replaceable>text of first item</replaceable>
+ \item[<replaceable>label of second item</replaceable>] <replaceable>text of second item</replaceable>
+ ...
\end{description}
</screen>
-<para>Environment to make a labeled list of items. Each item&#8217;s <replaceable>label</replaceable> is
-typeset in bold, and is flush left so that long labels continue into the
+<para>Environment to make a list of labeled items. Each item&#8217;s <replaceable>label</replaceable> is
+typeset in bold and is flush left, so that long labels continue into the
first line of the item text. There must be at least one item; having
none causes the &latex; error &#8216;<literal>Something's wrong--perhaps a
missing \item</literal>&#8217;.
</para>
<para>This example shows the environment used for a sequence of definitions.
-The labels &#8216;<literal>lama</literal>&#8217; and &#8216;<literal>llama</literal>&#8217; come out in boldface with their
-left edges aligned on the left margin.
</para>
<screen>\begin{definition}
\item[lama] A priest.
\item[llama] A beast.
\end{definition}
</screen>
+<para>The labels &#8216;<literal>lama</literal>&#8217; and &#8216;<literal>llama</literal>&#8217; are output in boldface, with the
+left edge on the left margin.
+</para>
<indexterm role="fn"><primary>\item</primary></indexterm>
<para>Start list items with the <literal>\item</literal> command (see <link linkend="_005citem">\item</link>). Use the
optional labels, as in <literal>\item[Main point]</literal>, because there is
@@ -3069,10 +3763,10 @@ may contain multiple paragraphs.
change given in argument style (see <link linkend="Font-styles">Font styles</link>) then it will come
out bold. For instance, if the label text calls for typewriter with
<literal>\item[\texttt{label text}]</literal> then it will appear in bold
-typewriter, if that is available. The simplest way to get non-bold
-typewriter is to use declarative style: <literal>\item[{\tt label
-text}]</literal>. Similarly, get the standard roman font with <literal>\item[{\rm
-label text}]</literal>.
+typewriter, if that is available. The simplest way around this, in this
+example to get non-bold typewriter, is to use declarative style:
+<literal>\item[{\tt label text}]</literal>. Similarly, get the standard roman
+font with <literal>\item[{\rm label text}]</literal>.
</para>
<para>For other major &latex; labelled list environments, see <link linkend="itemize">itemize</link>
and <link linkend="enumerate">enumerate</link>. Unlike those environments, nesting
@@ -3102,7 +3796,7 @@ lists.
<para>Synopsis:
</para>
<screen>\begin{displaymath}
-<replaceable>math text</replaceable>
+ <replaceable>mathematical text</replaceable>
\end{displaymath}
</screen>
<para>Environment to typeset the math text on its own line, in display style
@@ -3136,10 +3830,12 @@ different vertical spacing, and because the <literal>displaymath</literal>
environment honors the <literal>fleqn</literal> option.)
</para>
<para>The output from this example is centered and alone on its line.
-</para><screen>\begin{displaymath}
+</para>
+<screen>\begin{displaymath}
\int_1^2 x^2\,dx=7/3
\end{displaymath}
-</screen><para>Also, the integral sign is larger than the inline version
+</screen>
+<para>Also, the integral sign is larger than the inline version
<literal>\( \int_1^2 x^2\,dx=7/3 \)</literal> produces.
</para>
@@ -3211,9 +3907,9 @@ will be executed in the order that you gave them.
<para>Synopsis:
</para>
<screen>\begin{enumerate}
-\item[<replaceable>optional label of first item</replaceable>] text of first item
-\item[<replaceable>optional label of second item</replaceable>] text of second item
-...
+ \item[<replaceable>optional label of first item</replaceable>] <replaceable>text of first item</replaceable>
+ \item[<replaceable>optional label of second item</replaceable>] <replaceable>text of second item</replaceable>
+ ...
\end{enumerate}
</screen>
<para>Environment to produce a numbered list of items. The format of the
@@ -3248,15 +3944,15 @@ default for the format at each nesting level, where 1 is the top level,
the outermost level.
</para>
<orderedlist numeration="arabic"><listitem><para>arabic number followed by a period: &#8216;<literal>1.</literal>&#8217;, &#8216;<literal>2.</literal>&#8217;,&#160;&#8230;
-</para></listitem><listitem><para>lower case letter inside parentheses: &#8216;<literal>(a)</literal>&#8217;, &#8216;<literal>(b)</literal>&#8217;&#160;&#8230;
-</para></listitem><listitem><para>lower case roman numeral followed by a period: &#8216;<literal>i.</literal>&#8217;, &#8216;<literal>ii.</literal>&#8217;,&#160;&#8230;
-</para></listitem><listitem><para>upper case letter followed by a period: &#8216;<literal>A.</literal>&#8217;, &#8216;<literal>B.</literal>&#8217;,&#160;&#8230;
+</para></listitem><listitem><para>lowercase letter inside parentheses: &#8216;<literal>(a)</literal>&#8217;, &#8216;<literal>(b)</literal>&#8217;&#160;&#8230;
+</para></listitem><listitem><para>lowercase roman numeral followed by a period: &#8216;<literal>i.</literal>&#8217;, &#8216;<literal>ii.</literal>&#8217;,&#160;&#8230;
+</para></listitem><listitem><para>uppercase letter followed by a period: &#8216;<literal>A.</literal>&#8217;, &#8216;<literal>B.</literal>&#8217;,&#160;&#8230;
</para></listitem></orderedlist>
<indexterm role="fn"><primary>\enumi</primary></indexterm>
<indexterm role="fn"><primary>\enumii</primary></indexterm>
<indexterm role="fn"><primary>\enumiii</primary></indexterm>
<indexterm role="fn"><primary>\enumiv</primary></indexterm>
-<para>The <literal>enumerate</literal> environment uses the counters <literal>\enumi</literal> through
+<anchor id="enumerate-enumi"/><anchor id="enumerate-enumii"/><anchor id="enumerate-enumiii"/><anchor id="enumerate-enumiv"/><para>The <literal>enumerate</literal> environment uses the counters <literal>\enumi</literal> through
<literal>\enumiv</literal> (see <link linkend="Counters">Counters</link>).
</para>
<para>For other major &latex; labeled list environments, see
@@ -3269,7 +3965,7 @@ useful for customizing lists.
<indexterm role="fn"><primary>\labelenumii</primary></indexterm>
<indexterm role="fn"><primary>\labelenumiii</primary></indexterm>
<indexterm role="fn"><primary>\labelenumiv</primary></indexterm>
-<para>To change the format of the label use <literal>\renewcommand</literal>
+<anchor id="enumerate-labelenumi"/><anchor id="enumerate-labelenumii"/><anchor id="enumerate-labelenumiii"/><anchor id="enumerate-labelenumiv"/><para>To change the format of the label use <literal>\renewcommand</literal>
(see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link>) on the commands <literal>\labelenumi</literal>
through <literal>\labelenumiv</literal>. For instance, this first level list will be
labelled with uppercase letters, in boldface, and without a trailing
@@ -3299,17 +3995,16 @@ period.
<indexterm role="cp"><primary>align environment, from <literal>amsmath</literal></primary></indexterm>
<indexterm role="cp"><primary>amsmath package, replacing <literal>eqnarray</literal></primary></indexterm>
<indexterm role="cp"><primary>Madsen, Lars</primary></indexterm>
-<para>First, a caveat: the <literal>eqnarray</literal> environment is depreciated. It has
-infelicities that cannot be overcome, including spacing that is
-inconsistent with other mathematics elements (see the article &#8220;Avoid
-eqnarray!&#8221; by Lars Madsen
+<para>The <literal>eqnarray</literal> environment is obsolete. It has infelicities,
+including spacing that is inconsistent with other mathematics elements.
+(See &#8220;Avoid eqnarray!&#8221; by Lars Madsen
<ulink url="http://tug.org/TUGboat/tb33-1/tb103madsen.pdf">http://tug.org/TUGboat/tb33-1/tb103madsen.pdf</ulink>). New documents
should include the <filename>amsmath</filename> package and use the displayed
mathematics environments provided there, such as the <literal>align</literal>
-environment.
+environment. We include a description only for completeness and for
+working with old documents.
</para>
-<para>Nevertheless, for completeness and for a reference when working with old
-documents, a synopsis:
+<para>Synopsis:
</para>
<screen>\begin{eqnarray}
<replaceable>first formula left</replaceable> &amp;<replaceable>first formula middle</replaceable> &amp;<replaceable>first formula right</replaceable> \\
@@ -3370,21 +4065,22 @@ while the third line has not entry on the left side.
<para>Synopsis:
</para>
<screen>\begin{equation}
- math text
+ <replaceable>mathematical text</replaceable>
\end{equation}
</screen>
-<para>Make a <literal>displaymath</literal> environment (see <link linkend="displaymath">displaymath</link>) with an
-equation number in the right margin.
-</para>
-<para>The equation number is generated using the <literal>equation</literal> counter.
+<para>The same as a <literal>displaymath</literal> environment (see <link linkend="displaymath">displaymath</link>)
+except that &latex; puts an equation number flush to the right margin.
+The equation number is generated using the <literal>equation</literal> counter.
</para>
<para>You should have no blank lines between <literal>\begin{equation}</literal> and
<literal>\begin{equation}</literal>, or &latex; will tell you that there is a
-missing dollar sign,&#160;$<literal>$</literal>.
+missing dollar sign.
</para>
-<para>Note that the <filename>amsmath</filename> package has extensive displayed equation
-facilities. Those facilities are the best approach for such output in
-new documents.
+<indexterm role="cp"><primary>package, <literal>amsmath</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>amsmath</literal> package</primary></indexterm>
+
+<para>The package <filename>amsmath</filename> package has extensive displayed equation
+facilities. New documents should include this package.
</para>
</sect1>
@@ -3400,26 +4096,33 @@ new documents.
<para>Synopsis:
</para>
<screen>\begin{figure}[<replaceable>placement</replaceable>]
- figure body
-\caption[<replaceable>loftitle</replaceable>]{<replaceable>title</replaceable>}
-\label{<replaceable>label}</replaceable>
+ <replaceable>figure body</replaceable>
+ \caption[<replaceable>loftitle</replaceable>]{<replaceable>title</replaceable>} % optional
+ \label{<replaceable>label}</replaceable> % optional
\end{figure}
</screen>
-<para>or
+<para>or:
</para>
<screen>\begin{figure*}[<replaceable>placement</replaceable>]
- figure body
-\caption[<replaceable>loftitle</replaceable>]{<replaceable>title</replaceable>}
-\label{<replaceable>label}</replaceable>
+ <replaceable>figure body</replaceable>
+ \caption[<replaceable>loftitle</replaceable>]{<replaceable>title</replaceable>} % optional
+ \label{<replaceable>label}</replaceable> % optional
\end{figure*}
</screen>
-<para>A class of floats (see <link linkend="Floats">Floats</link>). Because they cannot be split across
-pages, they are not typeset in sequence with the normal text but instead
-are &#8220;floated&#8221; to a convenient place, such as the top of a following
-page.
+<para>Figures are for material that is not part of the normal text. An
+example is material that you cannot have split between two pages, such
+as a graphic. Because of this, &latex; does not typeset figures in
+sequence with normal text but instead &#8220;floats&#8221; them to a convenient
+place, such as the top of a following page (see <link linkend="Floats">Floats</link>).
</para>
-<para>For the possible values of <replaceable>placement</replaceable> and their effect on the
-float placement algorithm, see <link linkend="Floats">Floats</link>.
+<para>The <replaceable>figure body</replaceable> can consist of imported graphics
+(see <link linkend="Graphics">Graphics</link>), or text, &latex; commands, etc. It is typeset in a
+<literal>parbox</literal> of width <literal>\textwidth</literal>.
+</para>
+<para>The possible values of <replaceable>placement</replaceable> are <literal>h</literal> for &#8216;<literal>here</literal>&#8217;,
+<literal>t</literal> for &#8216;<literal>top</literal>&#8217;, <literal>b</literal> for &#8216;<literal>bottom</literal>&#8217;, and <literal>p</literal> for
+&#8216;<literal>on a separate page of floats</literal>&#8217;. For the effect of these options on
+the float placement algorithm, see <link linkend="Floats">Floats</link>.
</para>
<para>The starred form <literal>figure*</literal> is used when a document is in
double-column mode (see <link linkend="_005ctwocolumn">\twocolumn</link>). It produces a figure that
@@ -3427,23 +4130,21 @@ spans both columns, at the top of the page. To add the possibility of
placing at a page bottom see the discussion of <replaceable>placement</replaceable> <literal>b</literal>
in <link linkend="Floats">Floats</link>.
</para>
-<para>The figure body is typeset in a <literal>parbox</literal> of width <literal>\textwidth</literal>
-and so it can contain text, commands, etc.
-</para>
<para>The label is optional; it is used for cross references (see <link linkend="Cross-references">Cross
references</link>).
<indexterm role="fn"><primary>\caption</primary></indexterm>
The optional <literal>\caption</literal> command specifies caption text for the
figure. By default it is numbered. If <replaceable>loftitle</replaceable> is present, it is
-used in the list of figures instead of <replaceable>title</replaceable> (see <link linkend="Tables-of-contents">Tables of
-contents</link>).
+used in the list of figures instead of <replaceable>title</replaceable> (see <link linkend="Table-of-contents-etc_002e">Table of
+contents etc.</link>).
</para>
-<para>This example makes a figure out of a graphic. It requires one of the
-packages <filename>graphics</filename> or <filename>graphicx</filename>. The graphic, with its
-caption, will be placed at the top of a page or, if it is pushed to the
+<para>This example makes a figure out of a graphic. &latex; will place that
+graphic and its caption at the top of a page or, if it is pushed to the
end of the document, on a page of floats.
</para>
-<screen>\begin{figure}[t]
+<screen>\usepackage{graphicx} % in preamble
+ ...
+\begin{figure}[t]
\centering
\includegraphics[width=0.5\textwidth]{CTANlion.png}
\caption{The CTAN lion, by Duane Bibby}
@@ -3522,17 +4223,34 @@ Article by \myname.
<indexterm role="cp"><primary>left-justifying text, environment for</primary></indexterm>
<indexterm role="cp"><primary>ragged right text, environment for</primary></indexterm>
+<para>Synopsis:
+</para>
<screen>\begin{flushleft}
-<replaceable>line1</replaceable> \\
-<replaceable>line2</replaceable> \\
-...
+ <replaceable>line1</replaceable> \\
+ <replaceable>line2</replaceable> \\
+ ...
\end{flushleft}
</screen>
<indexterm role="fn"><primary>\\ for <literal>flushleft</literal></primary></indexterm>
-<para>The <literal>flushleft</literal> environment allows you to create a paragraph
-consisting of lines that are flush to the left-hand margin and ragged
-right. Each line must be terminated with the string <literal>\\</literal>.
-</para>
+<para>An environment that creates a paragraph whose lines are flush to the
+left-hand margin, and ragged right. If you have lines that are too long
+then &latex; will linebreak them in a way that avoids hyphenation and
+stretching or shrinking spaces. To force a new line use a double
+backslash, <literal>\\</literal>. For the declaration form
+see&#160;<link linkend="_005craggedright">\raggedright</link>.
+</para>
+<para>This creates a box of text that is at most 3 inches wide, with the text
+flush left and ragged right.
+</para>
+<screen>\noindent\begin{minipage}{3in}
+\begin{flushleft}
+ A long sentence that will be broken by \LaTeX{}
+ at a convenient spot. \\
+ And, a fresh line forced by the double backslash.
+\end{flushleft}
+\end{minipage}
+</screen>
+
<sect2 label="8.12.1" id="_005craggedright">
@@ -3543,9 +4261,20 @@ right. Each line must be terminated with the string <literal>\\</literal>.
<indexterm role="cp"><primary>left-justifying text</primary></indexterm>
<indexterm role="cp"><primary>justification, ragged right</primary></indexterm>
-<para>The <literal>\raggedright</literal> declaration corresponds to the
-<literal>flushleft</literal> environment. This declaration can be used inside an
-environment such as <literal>quote</literal> or in a <literal>parbox</literal>.
+<para>Synopses:
+</para>
+<screen>{\raggedright ... }
+</screen>
+<para>or
+</para>
+<screen>\begin{<replaceable>environment</replaceable>} \raggedright
+ ...
+\end{<replaceable>environment</replaceable>}
+</screen>
+<para>A declaration which causes lines to be flush to the left margin and
+ragged right. It can be used inside an environment such as <literal>quote</literal>
+or in a <literal>parbox</literal>. For the environment form
+see&#160;<link linkend="flushleft">flushleft</link>.
</para>
<para>Unlike the <literal>flushleft</literal> environment, the <literal>\raggedright</literal>
command does not start a new paragraph; it only changes how &latex;
@@ -3553,6 +4282,17 @@ formats paragraph units. To affect a paragraph unit&#8217;s format, the
scope of the declaration must contain the blank line or <literal>\end</literal>
command that ends the paragraph unit.
</para>
+<para>Here <literal>\raggedright</literal> in each second column keeps &latex; from doing
+very awkward typesetting to fit the text into the narrow column. Note
+that <literal>\raggedright</literal> is inside the curly braces <literal>{...}</literal> to
+delimit its effect.
+</para>
+<screen>\begin{tabular}{rp{2in}}
+ Team alpha &amp;{\raggedright This team does all the real work.} \\
+ Team beta &amp;{\raggedright This team ensures that the water
+ cooler is never empty.} \\
+\end{tabular}
+</screen>
</sect2>
</sect1>
@@ -3566,15 +4306,20 @@ command that ends the paragraph unit.
<indexterm role="cp"><primary>right-justifying text, environment for</primary></indexterm>
<screen>\begin{flushright}
-<replaceable>line1</replaceable> \\
-<replaceable>line2</replaceable> \\
-...
+ <replaceable>line1</replaceable> \\
+ <replaceable>line2</replaceable> \\
+ ...
\end{flushright}
</screen>
<indexterm role="fn"><primary>\\ (for <literal>flushright</literal>)</primary></indexterm>
-<para>The <literal>flushright</literal> environment allows you to create a paragraph
-consisting of lines that are flush to the right-hand margin and ragged
-left. Each line must be terminated with the control sequence <literal>\\</literal>.
+<para>An environment that creates a paragraph whose lines are flush to the
+right-hand margin and ragged left. If you have lines that are too long
+to fit the margins then &latex; will linebreak them in a way that
+avoids hyphenation and stretching or shrinking spaces. To force a new
+line use a double backslash, <literal>\\</literal>. For the declaration form
+see&#160;<link linkend="_005craggedleft">\raggedleft</link>.
+</para>
+<para>For an example related to this environment, see&#160;<link linkend="flushleft">flushleft</link>.
</para>
@@ -3586,9 +4331,20 @@ left. Each line must be terminated with the control sequence <literal>\\</liter
<indexterm role="cp"><primary>justification, ragged left</primary></indexterm>
<indexterm role="cp"><primary>right-justifying text</primary></indexterm>
-<para>The <literal>\raggedleft</literal> declaration corresponds to the
-<literal>flushright</literal> environment. This declaration can be used inside an
-environment such as <literal>quote</literal> or in a <literal>parbox</literal>.
+<para>Synopses:
+</para>
+<screen>{\raggedleft ... }
+</screen>
+<para>or
+</para>
+<screen>\begin{<replaceable>environment</replaceable>} \raggedleft
+ ...
+\end{<replaceable>environment</replaceable>}
+</screen>
+<para>A declaration which causes lines to be flush to the right margin and
+ragged left. It can be used inside an environment such as <literal>quote</literal>
+or in a <literal>parbox</literal>. For the environment form
+see&#160;<link linkend="flushright">flushright</link>.
</para>
<para>Unlike the <literal>flushright</literal> environment, the <literal>\raggedleft</literal>
command does not start a new paragraph; it only changes how &latex;
@@ -3596,6 +4352,8 @@ formats paragraph units. To affect a paragraph unit&#8217;s format, the
scope of the declaration must contain the blank line or <literal>\end</literal>
command that ends the paragraph unit.
</para>
+<para>For an example related to this environment, see&#160;<link linkend="_005craggedright">\raggedright</link>.
+</para>
</sect2>
</sect1>
@@ -3609,29 +4367,30 @@ command that ends the paragraph unit.
<indexterm role="cp"><primary>lists of items</primary></indexterm>
<indexterm role="cp"><primary>unordered lists</primary></indexterm>
<indexterm role="cp"><primary>bulleted lists</primary></indexterm>
+<indexterm role="cp"><primary>bullet lists</primary></indexterm>
<para>Synopsis:
</para>
<screen>\begin{itemize}
-\item[<replaceable>optional label of first item</replaceable>] text of first item
-\item[<replaceable>optional label of second item</replaceable>] text of second item
-...
+ \item[<replaceable>optional label of first item</replaceable>] <replaceable>text of first item</replaceable>
+ \item[<replaceable>optional label of second item</replaceable>] <replaceable>text of second item</replaceable>
+ ...
\end{itemize}
</screen>
-<para>The <literal>itemize</literal> environment produces an &#8220;unordered&#8221;, &#8220;bulleted&#8221;
-list. The format of the label numbering depends on the nesting level of
-this environment; see below. Each <literal>itemize</literal> list environment must
-have at least one item; having none causes the &latex; error
-&#8216;<literal>Something's wrong--perhaps a missing \item</literal>&#8217;.
+<para>Produce a list that is unordered, sometimes called a bullet list. The
+environment must have at least one <literal>\item</literal>; having none causes the
+&latex; error &#8216;<literal>Something's wrong--perhaps a missing \item</literal>&#8217;.
</para>
-<para>This example gives a two-item list. As a top-level list each label
-would come out as a bullet, &#8226;.
+<para>This gives a two-item list.
</para>
<screen>\begin{itemize}
\item Pencil and watercolor sketch by Cassandra
\item Rice portrait
\end{itemize}
</screen>
+<para>As a top-level list each label would come out as a bullet, &#8226;.
+The format of the labeling depends on the nesting level; see below.
+</para>
<indexterm role="fn"><primary>\item</primary></indexterm>
<para>Start list items with the <literal>\item</literal> command (see <link linkend="_005citem">\item</link>). If you
give <literal>\item</literal> an optional argument by following it with square
@@ -3645,11 +4404,11 @@ contain multiple paragraphs.
<indexterm role="fn"><primary>\labelitemii</primary></indexterm>
<indexterm role="fn"><primary>\labelitemiii</primary></indexterm>
<indexterm role="fn"><primary>\labelitemiv</primary></indexterm>
-<para>Itemized lists can be nested within one another, up to four levels deep.
+<anchor id="itemize-labelitemi"/><anchor id="itemize-labelitemii"/><anchor id="itemize-labelitemiii"/><anchor id="itemize-labelitemiv"/><para>Itemized lists can be nested within one another, up to four levels deep.
They can also be nested within other paragraph-making environments, such
as <literal>enumerate</literal> (see <link linkend="enumerate">enumerate</link>). The <literal>itemize</literal> environment
uses the commands <literal>\labelitemi</literal> through <literal>\labelitemiv</literal> to
-produce the default label (this also uses the convention of lower case
+produce the default label (this also uses the convention of lowercase
roman numerals at the end of the command names that signify the nesting
level). These are the default marks at each level.
</para>
@@ -3670,10 +4429,10 @@ the first level use diamonds.
<indexterm role="fn"><primary>\leftmarginiv</primary></indexterm>
<indexterm role="fn"><primary>\leftmarginv</primary></indexterm>
<indexterm role="fn"><primary>\leftmarginvi</primary></indexterm>
-<para>The distance between the left margin of the enclosing environment and
+<anchor id="itemize-leftmargin"/><anchor id="itemize-leftmargini"/><anchor id="itemize-leftmarginii"/><anchor id="itemize-leftmarginiii"/><anchor id="itemize-leftmarginiv"/><anchor id="itemize-leftmarginv"/><anchor id="itemize-leftmarginvi"/><para>The distance between the left margin of the enclosing environment and
the left margin of the <literal>itemize</literal> list is determined by the
parameters <literal>\leftmargini</literal> through <literal>\leftmarginvi</literal>. (Note the
-convention of using lower case roman numerals a the end of the command
+convention of using lowercase roman numerals a the end of the command
name to denote the nesting level.) The defaults are: <literal>2.5em</literal> in
level 1 (<literal>2em</literal> in two-column mode), <literal>2.2em</literal> in level 2,
<literal>1.87em</literal> in level 3, and <literal>1.7em</literal> in level 4, with smaller
@@ -3695,7 +4454,7 @@ lists.
space between items. Here is an example defining an <literal>itemize*</literal>
environment with no extra spacing between items, or between paragraphs
within a single item (<literal>\parskip</literal> is not list-specific,
-see <link linkend="_005cparskip">\parskip</link>):
+see <link linkend="_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</link>):
</para>
<screen>\newenvironment{itemize*}%
{\begin{itemize}%
@@ -3728,34 +4487,33 @@ see <link linkend="_005cparskip">\parskip</link>):
<para>Synopsis:
</para>
<screen>\begin{list}{<replaceable>labeling</replaceable>}{<replaceable>spacing</replaceable>}
-\item[<replaceable>optional label of first item</replaceable>] text of first item
-\item[<replaceable>optional label of second item</replaceable>] text of second item
-...
+ \item[<replaceable>optional label of first item</replaceable>] <replaceable>text of first item</replaceable>
+ \item[<replaceable>optional label of second item</replaceable>] <replaceable>text of second item</replaceable>
+ ...
\end{list}
</screen>
-<para>The <literal>list</literal> environment is a generic environment for constructing
-more specialized lists. It is most often used to create lists via the
-<literal>description</literal>, <literal>enumerate</literal>, and <literal>itemize</literal> environments
-(see <link linkend="description">description</link>, <link linkend="enumerate">enumerate</link>, and <link linkend="itemize">itemize</link>).
+<para>An environment for constructing lists.
</para>
-<para>Also, many standard &latex; environments that are not visually lists
-are constructed using <literal>list</literal>, including <literal>quotation</literal>,
-<literal>quote</literal>, <literal>center</literal>, <literal>verbatim</literal>, and plenty more
-(see <link linkend="quotation-and-quote">quotation and quote</link>, see <link linkend="center">center</link>, see <link linkend="flushright">flushright</link>).
+<para>Note that this environment does not typically appear in the document
+body. Most lists created by &latex; authors are the ones that come
+standard: the <literal>description</literal>, <literal>enumerate</literal>, and <literal>itemize</literal>
+environments (see <link linkend="description">description</link>, <link linkend="enumerate">enumerate</link>, and <link linkend="itemize">itemize</link>).
</para>
-<indexterm role="cp"><primary>package, <literal>enumitem</literal></primary></indexterm>
-<indexterm role="cp"><primary><literal>enumitem</literal> package</primary></indexterm>
-
-<para>The third-party package <literal>enumitem</literal> is useful for customizing lists.
-Here, we describe the <literal>list</literal> environment by defining a new custom
+<para>Instead, the <literal>list</literal> environment is most often used in macros. For
+example, many standard &latex; environments that do not immediately
+appear to be lists are in fact constructed using <literal>list</literal>, including
+<literal>quotation</literal>, <literal>quote</literal>, and <literal>center</literal> (see <link linkend="quotation-_0026-quote">quotation &amp;
+quote</link>, see <link linkend="center">center</link>).
+</para>
+<para>This uses the <literal>list</literal> environment to define a new custom
environment.
</para>
<screen>\newcounter{namedlistcounter} % number the items
\newenvironment{named}
{\begin{list}
- {Item~\Roman{namedlistcounter}.} % labeling argument
- {\usecounter{namedlistcounter} % spacing argument
- \setlength{\leftmargin}{3.5em}} % still spacing arg
+ {Item~\Roman{namedlistcounter}.} % labeling
+ {\usecounter{namedlistcounter} % set counter
+ \setlength{\leftmargin}{3.5em}} % set spacing
}
{\end{list}}
@@ -3765,54 +4523,55 @@ environment.
\item Shows as ``Item~II.''
\end{named}
</screen>
-<para>The <literal>list</literal> environment&#8217;s mandatory first argument,
-<replaceable>labeling</replaceable>, specifies the default labeling of list items. It can
-contain text and &latex; commands, as above where it contains both
-&#8216;<literal>Item</literal>&#8217; and &#8216;<literal>\Roman{...}</literal>&#8217;. &latex; forms the label by
-putting the <replaceable>labeling</replaceable> argument in a box of width
-<literal>\labelwidth</literal>. If the label is wider than that, the additional
-material extends to the right. When making an instance of a list you
-can override the default labeling by giving <literal>\item</literal> an optional
-argument by including square braces and the text, as in the above
-<literal>\item[Special label.]</literal>; see <link linkend="_005citem">\item</link>.
+<para>The mandatory first argument <replaceable>labeling</replaceable> specifies the default
+labeling of list items. It can contain text and &latex; commands, as
+above where it contains both &#8216;<literal>Item</literal>&#8217; and &#8216;<literal>\Roman{...}</literal>&#8217;.
+&latex; forms the label by putting the <replaceable>labeling</replaceable> argument in a box
+of width <literal>\labelwidth</literal>. If the label is wider than that, the
+additional material extends to the right. When making an instance of a
+list you can override the default labeling by giving <literal>\item</literal> an
+optional argument by including square braces and the text, as in the
+above <literal>\item[Special label.]</literal>; see <link linkend="_005citem">\item</link>.
+</para>
+<para>The mandatory second argument <replaceable>spacing</replaceable> has a list of commands.
+This list can be empty. A command that can go in here is
+<literal>\usecounter{<replaceable>countername</replaceable>}</literal> (see <link linkend="_005cusecounter">\usecounter</link>). Use this
+to tell &latex; to number the items using the given counter. The
+counter will be reset to zero each time &latex; enters the environment,
+and the counter is incremented by one each time &latex; encounters an
+<literal>\item</literal> that does not have an optional argument.
</para>
<indexterm role="fn"><primary>\makelabel</primary></indexterm>
-<para>The label box is constructed by the command <literal>\makelabel</literal>. By
-default it positions the contents flush right. It takes one argument,
-the label. It typesets the contents in LR mode. An example of changing
-its definition is that to the above example before the definition of the
-<literal>named</literal> environment add
+<anchor id="list-makelabel"/><para>Another command that can go in <replaceable>spacing</replaceable> is
+<literal>\makelabel</literal>, which constructs the label box. By default it puts
+the contents flush right. Its only argument is the label, which it
+typesets in LR mode (see <link linkend="Modes">Modes</link>). One example of changing its
+definition is that to the above <literal>named</literal> example, before the
+definition of the environment add
<literal>\newcommand{\namedmakelabel}[1]{\textsc{#1}}</literal>, and between
the <literal>\setlength</literal> command and the parenthesis that closes the
<replaceable>spacing</replaceable> argument also add <literal>\let\makelabel\namedmakelabel</literal>.
Then the items will be typeset in small caps. Similarly, changing the
second code line to <literal>\let\makelabel\fbox</literal> puts the labels inside a
-framed box. Another example is at the bottom of this entry.
-</para>
-<para>The mandatory second argument <replaceable>spacing</replaceable> can have a list of
-commands to redefine the spacing parameters for the list, such as
-<literal>\setlength{\labelwidth}{2em}</literal>. If this argument is empty,
-i.e., <literal>{}</literal>, then the list will have the default spacing given
-below. To number the items using a counter, put
-<literal>\usecounter{<replaceable>countername</replaceable>}</literal> in this argument
-(see <link linkend="_005cusecounter">\usecounter</link>).
-</para>
-<para>Below are the spacing parameters for list formatting. See also the
-figure below. Each is a length (see <link linkend="Lengths">Lengths</link>). The vertical
-spaces are normally rubber lengths, with <literal>plus</literal> and <literal>minus</literal>
-components, to give &tex; flexibility in setting the page. Change
-each with a command such as <literal>\setlength{itemsep}{2pt plus1pt
-minus1pt}</literal>. For some effects these lengths should be zero or
-negative. Default values for derived environments such as
-<literal>itemize</literal> can be changed from the values shown here for the basic
-<literal>list</literal>.
+framed box. Another example of the <literal>\makelabel</literal> command is below,
+in the definition of the <literal>redlabel</literal> environment.
+</para>
+<para>Also often in <replaceable>spacing</replaceable> are commands to redefine the spacing for the
+list. Below are the spacing parameters with their default values.
+(Default values for derived environments such as <literal>itemize</literal> can be
+different than the values shown here.) See also the figure that follows
+the list. Each is a length (see <link linkend="Lengths">Lengths</link>). The vertical spaces are
+normally rubber lengths, with <literal>plus</literal> and <literal>minus</literal> components,
+to give &tex; flexibility in setting the page. Change each with a
+command such as <literal>\setlength{itemsep}{2pt plus1pt minus1pt}</literal>.
+For some effects these lengths should be zero or negative.
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\itemindent</primary></indexterm><literal>\itemindent</literal>
-</term><listitem><para>Extra horizontal space indentation, beyond <literal>leftmargin</literal>, of the
+</term><listitem><anchor id="list-itemindent"/><para>Extra horizontal space indentation, beyond <literal>leftmargin</literal>, of the
first line each item. Its default value is <literal>0pt</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\itemsep</primary></indexterm><literal>\itemsep</literal>
-</term><listitem><para>Vertical space between items, beyond the <literal>\parsep</literal>. The defaults
+</term><listitem><anchor id="list-itemsep"/><para>Vertical space between items, beyond the <literal>\parsep</literal>. The defaults
for the first three levels in &latex;&#8217;s &#8216;<literal>article</literal>&#8217;, &#8216;<literal>book</literal>&#8217;,
and &#8216;<literal>report</literal>&#8217; classes at 10 point size are: <literal>4pt plus2pt
minus1pt</literal>, <literal>\parsep</literal> (that is, <literal>2pt plus1pt minus1pt</literal>), and
@@ -3824,12 +4583,12 @@ minus1pt</literal>, <literal>\parsep</literal> (that is, <literal>2.5pt plus1pt
<literal>\topsep</literal> (that is, <literal>2.5pt plus1pt minus1pt</literal>).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\labelsep</primary></indexterm><literal>\labelsep</literal>
-</term><listitem><para>Horizontal space between the label and text of an item.
+</term><listitem><anchor id="list-labelsep"/><para>Horizontal space between the label and text of an item.
The default for &latex;&#8217;s &#8216;<literal>article</literal>&#8217;, &#8216;<literal>book</literal>&#8217;,
and &#8216;<literal>report</literal>&#8217; classes is <literal>0.5em</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\labelwidth</primary></indexterm><literal>\labelwidth</literal>
-</term><listitem><para>Horizontal width. The box containing the label is nominally this wide.
+</term><listitem><anchor id="list-labelwidth"/><para>Horizontal width. The box containing the label is nominally this wide.
If <literal>\makelabel</literal> returns text that is wider than this then the first
line of the item will be indented to make room for this extra material.
If <literal>\makelabel</literal> returns text of width less than or equal to
@@ -3850,7 +4609,7 @@ label&#8217;s left edge coincide with the left margin of the enclosing
environment.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\leftmargin</primary></indexterm><literal>\leftmargin</literal>
-</term><listitem><para>Horizontal space between the left margin of the enclosing environment
+</term><listitem><anchor id="list-leftmargin"/><para>Horizontal space between the left margin of the enclosing environment
(or the left margin of the page if this is a top-level list), and the
left margin of this list. It must be non-negative.
</para>
@@ -3867,13 +4626,13 @@ error message &#8216;<literal>Too deeply nested</literal>&#8217;.)
<literal>2.2em</literal>, and <literal>\leftmarginiii</literal> is <literal>1.87em</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\listparindent</primary></indexterm><literal>\listparindent</literal>
-</term><listitem><para>Horizontal space of additional line indentation, beyond
+</term><listitem><anchor id="list-listparindent"/><para>Horizontal space of additional line indentation, beyond
<literal>\leftmargin</literal>, for second and subsequent paragraphs within a list
item. A negative value makes this an &#8220;outdent&#8221;. Its default value
is <literal>0pt</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\parsep</primary></indexterm><literal>\parsep</literal>
-</term><listitem><para>Vertical space between paragraphs within an item. In the &#8216;<literal>book</literal>&#8217;
+</term><listitem><anchor id="list-parsep"/><para>Vertical space between paragraphs within an item. In the &#8216;<literal>book</literal>&#8217;
and &#8216;<literal>article</literal>&#8217; classes The defaults for the first three levels in
&latex;&#8217;s &#8216;<literal>article</literal>&#8217;, &#8216;<literal>book</literal>&#8217;, and &#8216;<literal>report</literal>&#8217; classes at 10
point size are: <literal>4pt plus2pt minus1pt</literal>, <literal>2pt plus1pt
@@ -3883,7 +4642,7 @@ minus1pt</literal>, and <literal>0pt</literal>. The defaults at 11 point size a
minus1pt</literal>, <literal>2.5pt plus1pt minus1pt</literal>, and <literal>0pt</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\partopsep</primary></indexterm><literal>\partopsep</literal>
-</term><listitem><para>Vertical space added, beyond <literal>\topsep</literal>+<literal>\parskip</literal>, to the top
+</term><listitem><anchor id="list-partopsep"/><para>Vertical space added, beyond <literal>\topsep</literal>+<literal>\parskip</literal>, to the top
and bottom of the entire environment if the list instance is preceded by
a blank line. (A blank line in the &latex; source before the list
changes spacing at both the top and bottom of the list; whether the line
@@ -3898,20 +4657,20 @@ defaults at 12 point are: <literal>3pt plus2pt minus3pt</literal>, <literal>3pt
minus2pt</literal>, and <literal>1pt plus0pt minus1pt</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\rightmargin</primary></indexterm><literal>\rightmargin</literal>
-</term><listitem><para>Horizontal space between the right margin of the list and the right
+</term><listitem><anchor id="list-rightmargin"/><para>Horizontal space between the right margin of the list and the right
margin of the enclosing environment. Its default value is <literal>0pt</literal>.
It must be non-negative.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\topsep</primary></indexterm><literal>\topsep</literal>
-</term><listitem><para>Vertical space added to both the top and bottom of the list, in addition
-to <literal>\parskip</literal> (see <link linkend="_005cparskip">\parskip</link>). The defaults for the first three
-levels in &latex;&#8217;s &#8216;<literal>article</literal>&#8217;, &#8216;<literal>book</literal>&#8217;, and &#8216;<literal>report</literal>&#8217;
-classes at 10 point size are: <literal>8pt plus2pt minus4pt</literal>, <literal>4pt
-plus2pt minus1pt</literal>, and <literal>2pt plus1pt minus1pt</literal>. The defaults at 11
-point are: <literal>9pt plus3pt minus5pt</literal>, <literal>4.5pt plus2pt minus1pt</literal>,
-and <literal>2pt plus1pt minus1pt</literal>. The defaults at 12 point are:
-<literal>10pt plus4pt minus6pt</literal>, <literal>5pt plus2.5pt minus1pt</literal>, and
-<literal>2.5pt plus1pt minus1pt</literal>.
+</term><listitem><anchor id="list-topsep"/><para>Vertical space added to both the top and bottom of the list, in addition
+to <literal>\parskip</literal> (see <link linkend="_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</link>). The defaults for
+the first three levels in &latex;&#8217;s &#8216;<literal>article</literal>&#8217;, &#8216;<literal>book</literal>&#8217;, and
+&#8216;<literal>report</literal>&#8217; classes at 10 point size are: <literal>8pt plus2pt minus4pt</literal>,
+<literal>4pt plus2pt minus1pt</literal>, and <literal>2pt plus1pt minus1pt</literal>. The
+defaults at 11 point are: <literal>9pt plus3pt minus5pt</literal>, <literal>4.5pt
+plus2pt minus1pt</literal>, and <literal>2pt plus1pt minus1pt</literal>. The defaults at 12
+point are: <literal>10pt plus4pt minus6pt</literal>, <literal>5pt plus2.5pt minus1pt</literal>,
+and <literal>2.5pt plus1pt minus1pt</literal>.
</para>
</listitem></varlistentry></variablelist>
<para>This shows the horizontal and vertical distances.
@@ -3956,6 +4715,9 @@ the list environment does not start a new paragraph, and
appears in the source above the environment; whether a blank line
appears in the source below the environment does not matter.)
</para>
+</listitem></varlistentry><varlistentry><term><replaceable>h0</replaceable>
+</term><listitem><para><literal>\labelwidth</literal>
+</para>
</listitem></varlistentry><varlistentry><term><replaceable>h1</replaceable>
</term><listitem><para><literal>\labelsep</literal>
</para>
@@ -3989,17 +4751,23 @@ e.g., <literal>\@beginparpenalty=9999</literal>; a value of 10000 prohibits a
page break.
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\@beginparpenalty</primary></indexterm><literal>\@beginparpenalty</literal>
-</term><listitem><para>The page breaking penalty for breaking before the list (default <literal>-51</literal>).
+</term><listitem><anchor id="list-beginparpenalty"/><para>The page breaking penalty for breaking before the list (default <literal>-51</literal>).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\@itempenalty</primary></indexterm><literal>\@itempenalty</literal>
-</term><listitem><para>The page breaking penalty for breaking before a list item (default <literal>-51</literal>).
+</term><listitem><anchor id="list-itempenalty"/><para>The page breaking penalty for breaking before a list item (default <literal>-51</literal>).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\@endparpenalty</primary></indexterm><literal>\@endparpenalty</literal>
-</term><listitem><para>The page breaking penalty for breaking after a list (default <literal>-51</literal>).
+</term><listitem><anchor id="list-endparpenalty"/><para>The page breaking penalty for breaking after a list (default <literal>-51</literal>).
</para>
</listitem></varlistentry></variablelist>
+<indexterm role="cp"><primary>package, <literal>enumitem</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>enumitem</literal> package</primary></indexterm>
+
+<para>The package <literal>enumitem</literal> is useful for customizing lists.
+</para>
<para>This example has the labels in red. They are numbered, and the left
edge of the label lines up with the left edge of the item text.
+See <link linkend="_005cusecounter">\usecounter</link>.
</para>
<screen>\usepackage{color}
\newcounter{cnt}
@@ -4027,7 +4795,8 @@ edge of the label lines up with the left edge of the item text.
<screen>\item text of item
</screen>
<para>or
-</para><screen>\item[<replaceable>optional-label</replaceable>] text of item
+</para>
+<screen>\item[<replaceable>optional-label</replaceable>] text of item
</screen>
<para>An entry in a list. The entries are prefixed by a label, whose default
depends on the list type.
@@ -4130,24 +4899,114 @@ See <link linkend="Math-formulas">Math formulas</link>.
<indexterm role="cp"><primary>minipage, creating a</primary></indexterm>
+<para>Synopses:
+</para>
+<screen>\begin{minipage}{<replaceable>width</replaceable>}
+ <replaceable>contents</replaceable>
+\end{minipage}
+</screen>
+<para>or
+</para>
<screen>\begin{minipage}[<replaceable>position</replaceable>][<replaceable>height</replaceable>][<replaceable>inner-pos</replaceable>]{<replaceable>width</replaceable>}
-<replaceable>text</replaceable>
+ <replaceable>contents</replaceable>
\end{minipage}
</screen>
-<para>The <literal>minipage</literal> environment typesets its body <replaceable>text</replaceable> in a
-block that will not be broken across pages. This is similar to the
-<literal>\parbox</literal> command (see <link linkend="_005cparbox">\parbox</link>), but unlike <literal>\parbox</literal>,
-other paragraph-making environments can be used inside a minipage.
+<para>Put <replaceable>contents</replaceable> into a box that is <replaceable>width</replaceable> wide. This is like a
+small version of a page; it can contain its own footnotes, itemized
+lists, etc. (There are some restrictions, including that it cannot have
+floats.) This box will not be broken across pages. So <literal>minipage</literal>
+is similar to <literal>\parbox</literal> (see <link linkend="_005cparbox">\parbox</link>) but here you can have
+paragraphs.
+</para>
+<para>This example will be 3&#160;inches wide, and has two paragraphs.
+</para>
+<screen>\begin{minipage}{3in}
+ Stephen Kleene was a founder of the Theory of Computation.
+
+ He was a student of Church, wrote three influential texts,
+ was President of the Association for Symbolic Logic,
+ and won the National Medal of Science.
+\end{minipage}
+</screen>
+<para>See below for a discussion of the paragraph indent inside a
+<literal>minipage</literal>.
+</para>
+<para>The required argument <replaceable>width</replaceable> is a rigid length (see <link linkend="Lengths">Lengths</link>).
+It gives the width of the box into which <replaceable>contents</replaceable> are typeset.
+</para>
+<para>There are three optional arguments, <replaceable>position</replaceable>, <replaceable>height</replaceable>, and
+<replaceable>inner-pos</replaceable>. You need not include all three. For example, get the
+default <replaceable>position</replaceable> and set the <replaceable>height</replaceable> with
+<literal>\begin{minipage}[c][2.54cm] <replaceable>contents</replaceable> \end{minipage}</literal>.
+(Get the natural height with an empty argument, <literal>[]</literal>.)
+</para>
+<para>The optional argument <replaceable>position</replaceable> governs how the <literal>minipage</literal>
+vertically aligns with the surrounding material.
</para>
-<!-- (xxref positions) -->
-<para>The arguments are the same as for <literal>\parbox</literal> (see <link linkend="_005cparbox">\parbox</link>).
+<variablelist><varlistentry><term><literal>c</literal>
+</term><listitem><para>(synonym <literal>m</literal>) Default. Positions the <literal>minipage</literal> so its
+vertical center lines up with the center of the adjacent text line (what
+Plain &tex; calls <literal>\vcenter</literal>).
+</para>
+</listitem></varlistentry><varlistentry><term><literal>t</literal>
+</term><listitem><para>Match the top line in the <literal>minipage</literal> with the baseline of the
+surrounding text (Plain &tex;&#8217;s <literal>\vtop</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>b</literal>
+</term><listitem><para>Match the bottom line in the <literal>minipage</literal> with the baseline of the
+surrounding text (Plain &tex;&#8217;s <literal>\vbox</literal>.
+</para></listitem></varlistentry></variablelist>
+<para>To see the effects of these, contrast running this
+</para>
+<screen>---\begin{minipage}[c]{0.25in}
+ first\\ second\\ third
+\end{minipage}
+</screen>
+<para>with the results of changing <literal>c</literal> to <literal>b</literal> or&#160;<literal>t</literal>.
</para>
+<para>The optional argument <replaceable>height</replaceable> is a rigid length (see <link linkend="Lengths">Lengths</link>).
+It sets the height of the <literal>minipage</literal>. You can enter any value
+larger than, or equal to, or smaller than the <literal>minipage</literal>&#8217;s natural
+height and &latex; will not give an error or warning. You can also set
+it to a height of zero or a negative value.
+</para>
+<para>The final optional argument <replaceable>inner-pos</replaceable> controls the placement of
+<replaceable>content</replaceable> inside the box. These are the possible values are (the
+default is the value of <replaceable>position</replaceable>).
+</para>
+<variablelist><varlistentry><term><literal>t</literal>
+</term><listitem><para>Place <replaceable>content</replaceable> at the top of the box.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>c</literal>
+</term><listitem><para>Place it in the vertical center.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>b</literal>
+</term><listitem><para>Place it at the box bottom.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>s</literal>
+</term><listitem><para>Stretch <replaceable>contents</replaceable> out vertically; it must contain vertically
+stretchable space.
+</para>
+</listitem></varlistentry></variablelist>
+<para>The <replaceable>inner-pos</replaceable> argument makes sense when the <replaceable>height</replaceable> options
+is set to a value larger than the <literal>minipage</literal>&#8217;s natural height. To
+see the effect of the options, run this example with the various choices
+in place of <literal>b</literal>.
+</para>
+<screen>Text before
+\begin{center}
+ ---\begin{minipage}[c][3in][b]{0.25\textwidth}
+ first\\ second\\ third
+ \end{minipage}
+\end{center}
+Text after
+</screen>
<indexterm role="cp"><primary>indentation of paragraphs, in minipage</primary></indexterm>
<indexterm role="cp"><primary>paragraph indentation, in minipage</primary></indexterm>
<indexterm role="fn"><primary>\parindent</primary></indexterm>
-<para>By default, paragraphs are not indented in the <literal>minipage</literal>
-environment. You can restore indentation with a command such as
-<literal>\setlength{\parindent}{1pc}</literal> command.
+<para>By default paragraphs are not indented in a <literal>minipage</literal>. Change
+that with a command such as <literal>\setlength{\parindent}{1pc}</literal> at
+the start of <replaceable>contents</replaceable>.
</para>
<indexterm role="cp"><primary>footnotes in figures</primary></indexterm>
<indexterm role="cp"><primary>figures, footnotes in</primary></indexterm>
@@ -4158,9 +5017,46 @@ the bottom of the minipage instead of at the bottom of the page, and it
uses the <literal>\mpfootnote</literal> counter instead of the ordinary
<literal>footnote</literal> counter (see <link linkend="Counters">Counters</link>).
</para>
-<para>However, don&#8217;t put one minipage inside another if you are using
-footnotes; they may wind up at the bottom of the wrong minipage.
+<para>This puts the footnote at the bottom of the table, not the bottom of the
+page.
+</para>
+<screen>\begin{center} % center the minipage on the line
+\begin{minipage}{2.5in}
+ \begin{center} % center the table inside the minipage
+ \begin{tabular}{ll}
+ \textsc{Monarch} &amp;\textsc{Reign} \\ \hline
+ Elizabeth II &amp;63 years\footnote{to date} \\
+ Victoria &amp;63 years \\
+ George III &amp;59 years
+ \end{tabular}
+ \end{center}
+\end{minipage}
+\end{center}
+</screen>
+<para>If you nest minipages then there is an oddness when using footnotes.
+Footnotes appear at the bottom of the text ended by the next
+<literal>\end{minipage}</literal> which may not be their logical place.
</para>
+<para>This puts a table containing data side by side with a map graphic. They
+are vertically centered.
+</para>
+<screen>\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
+ ...
+\begin{center}
+ \vcenteredhbox{\includegraphics[width=0.3\textwidth]{nyc.png}}
+ \hspace{0.1\textwidth}
+ \begin{minipage}{0.5\textwidth}
+ \begin{tabular}{r|l}
+ \multicolumn{1}{r}{Borough} &amp;Pop (million) \\ \hline
+ The Bronx &amp;$1.5$ \\
+ Brooklyn &amp;$2.6$ \\
+ Manhattan &amp;$1.6$ \\
+ Queens &amp;$2.3$ \\
+ Staten Island &amp;$0.5$
+ \end{tabular}
+ \end{minipage}
+\end{center}
+</screen>
</sect1>
<sect1 label="8.19" id="picture">
@@ -4172,356 +5068,643 @@ footnotes; they may wind up at the bottom of the wrong minipage.
<indexterm role="cp"><primary>creating pictures</primary></indexterm>
<indexterm role="cp"><primary>pictures, creating</primary></indexterm>
+<para>Synopses:
+</para><screen>\begin{picture}(<replaceable>width</replaceable>,<replaceable>height</replaceable>)
+ <replaceable>picture commands</replaceable>
+\end{picture}
+</screen>
+<para>or
+</para>
<screen>\begin{picture}(<replaceable>width</replaceable>,<replaceable>height</replaceable>)(<replaceable>xoffset</replaceable>,<replaceable>yoffset</replaceable>)
-&#8230; <replaceable>picture commands</replaceable> &#8230;
+ <replaceable>picture commands</replaceable>
\end{picture}
</screen>
+<para>An environment to create simple pictures containing lines, arrows,
+boxes, circles, and text. Note that while this environment is not
+obsolete, new documents typically use much more powerful graphics
+creation systems, such as <literal>TikZ</literal>, <literal>PSTricks</literal>, <literal>MetaPost</literal>,
+or <literal>Asymptote</literal>. These are not covered in this document; see CTAN.
+</para>
+<para>This shows the parallelogram law for adding vectors.
+</para>
<indexterm role="fn"><primary>\unitlength</primary></indexterm>
-<para>The <literal>picture</literal> environment allows you to create just about any
-kind of picture you want containing text, lines, arrows and circles.
-You tell &latex; where to put things in the picture by specifying
-their coordinates. A coordinate is a number that may have a decimal
-point and a minus sign&#8212;a number like <literal>5</literal>, <literal>0.3</literal> or
-<literal>-3.1416</literal>. A coordinate specifies a length in multiples of the
-unit length <literal>\unitlength</literal>, so if <literal>\unitlength</literal> has been set
-to <literal>1cm</literal>, then the coordinate 2.54 specifies a length of 2.54
-centimeters.
+<screen>\setlength{\unitlength}{1cm}
+\begin{picture}(6,6) % picture box will be 6cm wide by 6cm tall
+ \put(0,0){\vector(2,1){4}} % for every 2 over this vector goes 1 up
+ \put(2,1){\makebox(0,0)[l]{\ first leg}}
+ \put(4,2){\vector(1,2){2}}
+ \put(5,4){\makebox(0,0)[l]{\ second leg}}
+ \put(0,0){\line(1,1){6}}
+ \put(3,3){\makebox(0,0)[r]{sum\ }}
+\end{picture}
+</screen>
+<para>You can also use this environment to place arbitrary material at an
+exact location.
</para>
-<para>You should only change the value of <literal>\unitlength</literal>, using the
-<literal>\setlength</literal> command, outside of a <literal>picture</literal> environment.
-The default value is <literal>1pt</literal>.
+<screen>\usepackage{color,graphicx} % in preamble
+ ...
+\begin{center}
+\setlength{\unitlength}{\textwidth}
+\begin{picture}(1,1) % leave space, \textwidth wide and tall
+ \put(0,0){\includegraphics[width=\textwidth]{desertedisland.jpg}}
+ \put(0.25,0.35){\textcolor{red}{X Treasure here}}
+\end{picture}
+\end{center}
+</screen>
+<para>The red&#160;X will be precisely a quarter of the <literal>\linewidth</literal> from
+the left margin, and <literal>0.35\linewidth</literal> up from the bottom. Another
+example of this usage is to put similar code in the page header to get
+repeat material on each of a document&#8217;s pages.
</para>
-<indexterm role="cp"><primary>package, <literal>picture</literal></primary></indexterm>
-<indexterm role="cp"><primary><literal>picture</literal> package</primary></indexterm>
-
-<para>The <literal>picture</literal> package redefine the <literal>picture</literal> environment so
-that everywhere a number is used in a <replaceable>picture commands</replaceable> to specify
-a coordinate, one can use alternatively a length. Be aware however that
-this will prevent scaling those lengths by changing <literal>\unitlength</literal>.
+<para>The <literal>picture</literal> environment has one required argument, a pair of
+numbers (<replaceable>width</replaceable>,<replaceable>height</replaceable>). Multiply these by the value
+<literal>\unitlength</literal> to get the nominal size of the output, the space that
+&latex; reserves on the output page. This nominal size need not be how
+large the picture really is; &latex; will draw things from the picture
+outside the picture&#8217;s box.
</para>
-
-<indexterm role="cp"><primary>position, in picture</primary></indexterm>
-<para>A <firstterm>position</firstterm> is a pair of coordinates, such as <literal>(2.4,-5)</literal>, specifying
-the point with x-coordinate <literal>2.4</literal> and y-coordinate <literal>-5</literal>.
-Coordinates are specified in the usual way with respect to an origin,
-which is normally at the lower-left corner of the picture. Note that
-when a position appears as an argument, it is not enclosed in braces;
-the parentheses serve to delimit the argument.
-</para>
-<para>The <literal>picture</literal> environment has one mandatory argument which is a
-position (<replaceable>width</replaceable>,<replaceable>height</replaceable>), which specifies the size of the
-picture. The environment produces a rectangular box with these
-<replaceable>width</replaceable> and <replaceable>height</replaceable>.
-</para>
-<para>The <literal>picture</literal> environment also has an optional position argument
-(<replaceable>xoffset</replaceable>,<replaceable>yoffset</replaceable>), following the size argument, that can
-change the origin. (Unlike ordinary optional arguments, this argument
-is not contained in square brackets.) The optional argument gives the
-coordinates of the point at the lower-left corner of the picture
-(thereby determining the origin). For example, if <literal>\unitlength</literal>
-has been set to <literal>1mm</literal>, the command
+<para>This environment also has an optional argument
+(<replaceable>xoffset</replaceable>,<replaceable>yoffset</replaceable>). It is used to shift the origin. Unlike
+most optional arguments, this one is not contained in square brackets.
+As with the required argument, it consists of two real numbers.
+Multiply these by <literal>\unitlength</literal> to get the point at the lower-left
+corner of the picture.
+</para>
+<para>For example, if <literal>\unitlength</literal> has been set to <literal>1mm</literal>, the
+command
</para>
<screen>\begin{picture}(100,200)(10,20)
</screen>
-<para>produces a picture of width 100 millimeters and height 200
-millimeters, whose lower-left corner is the point (10,20) and whose
-upper-right corner is therefore the point (110,220). When you first
-draw a picture, you typically omit the optional argument, leaving the
-origin at the lower-left corner. If you then want to modify your
+<para>produces a box of width 100 millimeters and height 200 millimeters. The
+picture&#8217;s origin is the point (10mm,20mm) and so the lower-left corner
+is there, and the upper-right corner is at (110mm,220mm). When you
+first draw a picture you typically omit the optional argument, leaving
+the origin at the lower-left corner. If you then want to modify your
picture by shifting everything, you can just add the appropriate
optional argument.
</para>
-<para>The environment&#8217;s mandatory argument determines the nominal size of the
-picture. This need bear no relation to how large the picture really is;
-&latex; will happily allow you to put things outside the picture, or even
-off the page. The picture&#8217;s nominal size is used by &latex; in determining
-how much room to leave for it.
-</para>
-<para>Everything that appears in a picture is drawn by the <literal>\put</literal>
-command. The command
+<indexterm role="cp"><primary>position, in picture</primary></indexterm>
+<para>Each <replaceable>picture command</replaceable> tells &latex; where to put something by
+naming its position. A <firstterm>position</firstterm> is a pair such as <literal>(2.4,-5)</literal>
+giving the x- and y-coordinates. A <firstterm>coordinate</firstterm> is a not a length,
+it is a real number (it may have a decimal point or a minus sign). It
+specifies a length in multiples of the unit length <literal>\unitlength</literal>,
+so if <literal>\unitlength</literal> has been set to <literal>1cm</literal>, then the coordinate
+2.54 specifies a length of 2.54 centimeters.
+</para>
+<para>&latex;&#8217;s default for <literal>\unitlength</literal> is <literal>1pt</literal>. it is a rigid
+length (see <link linkend="Lengths">Lengths</link>). Change it with the <literal>\setlength</literal> command
+(see <link linkend="_005csetlength">\setlength</link>). Make this change only outside of a <literal>picture</literal>
+environment.
</para>
-<screen>\put (11.3,-.3){...}
+<para>Coordinates are given with respect to an origin, which is normally at
+the lower-left corner of the picture. Note that when a position appears
+as an argument, as with <literal>\put(1,2){...}</literal>, it is not enclosed in
+braces since the parentheses serve to delimit the argument. Also,
+unlike in some computer graphics systems, larger y-coordinates are
+further up the page.
+</para>
+<para>There are four ways to put things in a picture: <literal>\put</literal>,
+<literal>\multiput</literal>, <literal>\qbezier</literal>, and <literal>\graphpaper</literal>. The most
+often used is <literal>\put</literal>. This
+</para>
+<screen>\put(11.3,-0.3){...}
+</screen>
+<para>places the object with its reference point at coordinates
+<inlineequation><mathphrase>(11.3,-0.3)</mathphrase></inlineequation>. The reference points for various objects will be
+described below.
+<indexterm role="fn"><primary>LR box</primary></indexterm>
+The <literal>\put</literal> command creates an <firstterm>LR box</firstterm> (see <link linkend="Modes">Modes</link>).
+Anything that can go in an <literal>\mbox</literal> (see <link linkend="_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</link>) can
+go in the text argument of the <literal>\put</literal> command. The reference point
+will be the lower left corner of the box. In this picture
+</para>
+<screen>\setlength{\unitlength}{1cm}
+...\begin{picture}(1,1)
+ \put(0,0){\line(1,0){1}}
+ \put(0,0){\line(1,1){1}}
+\end{picture}
+</screen>
+<para>the three dots are just slightly left of the point of the angle formed
+by the two lines. (Also, <literal>\line(1,1){1}</literal> does not call for a
+line of length one; rather the line has a change in the x coordinate of
+1.)
+</para>
+<para>The <literal>\multiput</literal>, <literal>qbezier</literal>, and <literal>graphpaper</literal> commands are
+described below.
+</para>
+<para>This draws a rectangle with a wavy top, using <literal>\qbezier</literal> for
+that curve.
+</para>
+<screen>\begin{picture}(3,1.5)
+ \put(0,0){\vector(1,0){8}} % x axis
+ \put(0,0){\vector(0,1){4}} % y axis
+ \put(2,0){\line(0,1){3}} % left side rectangle
+ \put(4,0){\line(0,1){3.5}} % right side
+ \qbezier(2,3)(2.5,2.9)(3,3.25)
+ \qbezier(3,3.25)(3.5,3.6)(4,3.5)
+ \thicklines % below here, lines are twice as thick
+ \put(2,3){\line(4,1){2}}
+ \put(4.5,2.5){\framebox{Trapezoidal Rule}}
+\end{picture}
</screen>
-<para>puts the object specified by <literal>...</literal> in the
-picture, with its reference point at coordinates <inlineequation><mathphrase>(11.3,-.3)</mathphrase></inlineequation>.
-The reference points for various objects will be described below.
-</para>
-<indexterm role="fn"><primary>lR box</primary></indexterm>
-<para>The <literal>\put</literal> command creates an <firstterm>LR box</firstterm>. You can put anything
-that can go in an <literal>\mbox</literal> (see <link linkend="_005cmbox">\mbox</link>) in the text argument of
-the <literal>\put</literal> command. When you do this, the reference point will
-be the lower left corner of the box.
-</para>
-<para>The <literal>picture</literal> commands are described in the following sections.
-</para>
-<sect2 label="8.19.1" id="_005ccircle">
-<title><literal>\circle</literal></title>
+<sect2 label="8.19.1" id="_005cput">
+<title><literal>\put</literal></title>
-<indexterm role="fn"><primary>\circle</primary></indexterm>
+<indexterm role="fn"><primary>\put</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\circle[*]{<replaceable>diameter</replaceable>}
+<screen>\put(<replaceable>xcoord</replaceable>,<replaceable>ycoord</replaceable>){<replaceable>content</replaceable>}
</screen>
-<para>The <literal>\circle</literal> command produces a circle with a diameter as close
-to the specified one as possible. The <literal>*</literal>-form of the command
-draws a solid circle.
+<para>Place <replaceable>content</replaceable> at the coordinate (<replaceable>xcoord</replaceable>,<replaceable>ycoord</replaceable>). See
+the discussion of coordinates and <literal>\unitlength</literal> in <link linkend="picture">picture</link>.
+The <replaceable>content</replaceable> is processed in LR mode (see <link linkend="Modes">Modes</link>) so it cannot
+contain line breaks.
</para>
-<para>Circles up to 40pt can be drawn.
+<para>This includes the text into the <literal>picture</literal>.
+</para>
+<screen>\put(4.5,2.5){Apply the \textit{unpoke} move}
+</screen>
+<para>The reference point, the location (4.5,2.5), is the lower left of the
+text, at the bottom left of the &#8216;<literal>A</literal>&#8217;.
</para>
</sect2>
-<sect2 label="8.19.2" id="_005cmakebox-_0028picture_0029">
-<title><literal>\makebox</literal></title>
+<sect2 label="8.19.2" id="_005cmultiput">
+<title><literal>\multiput</literal></title>
-<indexterm role="fn"><primary>\makebox (for <literal>picture</literal>)</primary></indexterm>
+<indexterm role="fn"><primary>\multiput</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\makebox(<replaceable>width</replaceable>,<replaceable>height</replaceable>)[<replaceable>position</replaceable>]{<replaceable>text</replaceable>}
+<screen>\multiput(<replaceable>x</replaceable>,<replaceable>y</replaceable>)(<replaceable>delta_x</replaceable>,<replaceable>delta_y</replaceable>){<replaceable>num-copies</replaceable>}{<replaceable>obj</replaceable>}
</screen>
-<para>The <literal>\makebox</literal> command for the picture environment is similar to
-the normal <literal>\makebox</literal> command except that you must specify a
-<replaceable>width</replaceable> and <replaceable>height</replaceable> in multiples of <literal>\unitlength</literal>.
-</para>
-<para>The optional argument, <literal>[<replaceable>position</replaceable>]</literal>, specifies the quadrant that
-your <replaceable>text</replaceable> appears in. You may select up to two of the following:
-</para>
-<variablelist><varlistentry><term><literal>t</literal>
-</term><listitem><para>Moves the item to the top of the rectangle.
+<para>Copy <replaceable>obj</replaceable> a total of <replaceable>num-copies</replaceable> times, with an increment of
+<replaceable>delta_x,delta_y</replaceable>. The <replaceable>obj</replaceable> first appears at position
+<inlineequation><mathphrase>(x,y)</mathphrase></inlineequation>, then at <inlineequation><mathphrase>(x+\delta_x,y+\delta_y)</mathphrase></inlineequation>, and so on.
</para>
-</listitem></varlistentry><varlistentry><term><literal>b</literal>
-</term><listitem><para>Moves the item to the bottom.
-</para>
-</listitem></varlistentry><varlistentry><term><literal>l</literal>
-</term><listitem><para>Moves the item to the left.
-</para>
-</listitem></varlistentry><varlistentry><term><literal>r</literal>
-</term><listitem><para>Moves the item to the right.
-</para>
-</listitem></varlistentry></variablelist>
-<para>See <link linkend="_005cmakebox">\makebox</link>.
+<para>This draws a simple grid with every fifth line in bold (see also
+<link linkend="_005cgraphpaper">\graphpaper</link>).
</para>
+<screen>\begin{picture}(10,10)
+ \linethickness{0.05mm}
+ \multiput(0,0)(1,0){10}{\line(0,1){10}}
+ \multiput(0,0)(0,1){10}{\line(1,0){10}}
+ \linethickness{0.5mm}
+ \multiput(0,0)(5,0){3}{\line(0,1){10}}
+ \multiput(0,0)(0,5){3}{\line(1,0){10}}
+\end{picture}
+</screen>
</sect2>
-<sect2 label="8.19.3" id="_005cframebox-_0028picture_0029">
-<title><literal>\framebox</literal></title>
+<sect2 label="8.19.3" id="_005cqbezier">
+<title><literal>\qbezier</literal></title>
-<indexterm role="fn"><primary>\framebox</primary></indexterm>
+<indexterm role="fn"><primary>\qbezier</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\framebox(<replaceable>width</replaceable>,<replaceable>height</replaceable>)[<replaceable>pos</replaceable>]{...}
+<screen>\qbezier(<replaceable>x1</replaceable>,<replaceable>y1</replaceable>)(<replaceable>x2</replaceable>,<replaceable>y2</replaceable>)(<replaceable>x3</replaceable>,<replaceable>y3</replaceable>)
+\qbezier[<replaceable>num</replaceable>](<replaceable>x1</replaceable>,<replaceable>y1</replaceable>)(<replaceable>x2</replaceable>,<replaceable>y2</replaceable>)(<replaceable>x3</replaceable>,<replaceable>y3</replaceable>)
</screen>
-<para>The <literal>\framebox</literal> command is like <literal>\makebox</literal> (see previous
-section), except that it puts a frame around the outside of the box
-that it creates.
-</para>
-<indexterm role="fn"><primary>\fboxrule</primary></indexterm>
-<indexterm role="fn"><primary>\fboxsep</primary></indexterm>
-<para>The <literal>\framebox</literal> command produces a rule of thickness
-<literal>\fboxrule</literal>, and leaves a space <literal>\fboxsep</literal> between the rule
-and the contents of the box.
+<para>Draw a quadratic Bezier curve whose control points are given by the
+three required arguments <literal>(<replaceable>x1</replaceable>,<replaceable>y1</replaceable>)</literal>,
+<literal>(<replaceable>x2</replaceable>,<replaceable>y2</replaceable>)</literal>, and <literal>(<replaceable>x3</replaceable>,<replaceable>y3</replaceable>)</literal>. That is,
+the curve runs from <replaceable>(x1,y1)</replaceable> to <replaceable>(x3,y3)</replaceable>, is quadratic, and is
+such that the tangent line at <replaceable>(x1,y1)</replaceable> passes through
+<replaceable>(x2,y2)</replaceable>, as does the tangent line at <replaceable>(x3,y3)</replaceable>.
</para>
-
-</sect2>
-<sect2 label="8.19.4" id="_005cdashbox">
-<title><literal>\dashbox</literal></title>
-
-<indexterm role="fn"><primary>\dashbox</primary></indexterm>
-
-<para>Draws a box with a dashed line. Synopsis:
+<para>This draws a curve from the coordinate (1,1) to (1,0).
</para>
-<screen>\dashbox{<replaceable>dlen</replaceable>}(<replaceable>rwidth</replaceable>,<replaceable>rheight</replaceable>)[<replaceable>pos</replaceable>]{<replaceable>text</replaceable>}
+<screen>\qbezier(1,1)(1.25,0.75)(1,0)
</screen>
-<para><literal>\dashbox</literal> creates a dashed rectangle around <replaceable>text</replaceable> in a
-<literal>picture</literal> environment. Dashes are <replaceable>dlen</replaceable> units long, and the
-rectangle has overall width <replaceable>rwidth</replaceable> and height <replaceable>rheight</replaceable>.
-The <replaceable>text</replaceable> is positioned at optional <replaceable>pos</replaceable>. <!-- xxref positions. -->
+<para>The curve&#8217;s tangent line at (1,1) contains (1.25,0.75), as does the
+curve&#8217;s tangent line at (1,0).
</para>
-<para>A dashed box looks best when the <replaceable>rwidth</replaceable> and <replaceable>rheight</replaceable> are
-multiples of the <replaceable>dlen</replaceable>.
+<para>The optional argument <replaceable>num</replaceable> gives the number of calculated
+intermediate points. The default is to draw a smooth curve whose
+maximum number of points is <literal>\qbeziermax</literal> (change this value with
+<literal>\renewcommand</literal>).
</para>
</sect2>
-<sect2 label="8.19.5" id="_005cframe">
-<title><literal>\frame</literal></title>
-
-<indexterm role="fn"><primary>\frame</primary></indexterm>
+<sect2 label="8.19.4" id="_005cgraphpaper">
+<title><literal>\graphpaper</literal></title>
+<indexterm role="fn"><primary>\graphpaper</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\frame{<replaceable>text</replaceable>}
+<screen>\graphpaper(<replaceable>x_init</replaceable>,<replaceable>y_init</replaceable>)(<replaceable>x_dimen</replaceable>,<replaceable>y_dimen</replaceable>)
+\graphpaper[<replaceable>spacing</replaceable>](<replaceable>x_init</replaceable>,<replaceable>y_init</replaceable>)(<replaceable>x_dimen</replaceable>,<replaceable>y_dimen</replaceable>)
</screen>
-<para>The <literal>\frame</literal> command puts a rectangular frame around <replaceable>text</replaceable>.
-The reference point is the bottom left corner of the frame. No extra
-space is put between the frame and the object.
+<para>Draw a coordinate grid. Requires the <literal>graphpap</literal> package.
+The grid&#8217;s origin is <literal>(<replaceable>x_init</replaceable>,<replaceable>y_init</replaceable>)</literal>.
+Grid lines come every <replaceable>spacing</replaceable> units (the default is 10).
+The grid extends <replaceable>x_dimen</replaceable> units to the right and <replaceable>y_dimen</replaceable> units up.
+All arguments must be positive integers.
+</para>
+<para>This make a grid with seven vertical lines and eleven horizontal lines.
+</para>
+<screen>\usepackage{graphpap} % in preamble
+ ...
+\begin{picture}(6,20) % in document body
+ \graphpaper[2](0,0)(12,20)
+\end{picture}
+</screen>
+<para>The lines are numbered every ten units.
</para>
</sect2>
-<sect2 label="8.19.6" id="_005cline">
+<sect2 label="8.19.5" id="_005cline">
<title><literal>\line</literal></title>
<indexterm role="fn"><primary>\line</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\line(<replaceable>xslope</replaceable>,<replaceable>yslope</replaceable>){<replaceable>length</replaceable>}
+<screen>\line(<replaceable>x_run</replaceable>,<replaceable>y_rise</replaceable>){<replaceable>travel</replaceable>}
</screen>
-<para>The <literal>\line</literal> command draws a line with the given <replaceable>length</replaceable> and
-slope <replaceable>xslope</replaceable>/<replaceable>yslope</replaceable>.
+<para>Draw a line. It slopes such that it vertically rises <replaceable>y_rise</replaceable> for
+every horizontal <replaceable>x_run</replaceable>. The <replaceable>travel</replaceable> is the total horizontal
+change&#160;&#8212; it is not the length of the vector, it is the change in
+<inlineequation><mathphrase>x</mathphrase></inlineequation>. In the special case of vertical lines, where
+(<replaceable>x_run</replaceable>,<replaceable>y_rise</replaceable>)=(0,1), the <replaceable>travel</replaceable> gives the change in
+<inlineequation><mathphrase>y</mathphrase></inlineequation>.
+</para>
+<para>This draws a line starting at coordinates (1,3).
+</para>
+<screen>\put(1,3){\line(2,5){4}}
+</screen>
+<para>For every over 2, this line will go up 5. Because <replaceable>travel</replaceable>
+specifies that this goes over 4, it must go up&#160;10. Thus its
+endpoint is <inlineequation><mathphrase>(1,3)+(4,10)=(5,13)</mathphrase></inlineequation>. In particular, note that
+<inlineequation><mathphrase><replaceable>travel</replaceable>=4</mathphrase></inlineequation> is not the length of the line, it is the change in
+<inlineequation><mathphrase>x</mathphrase></inlineequation>.
+</para>
+<para>The arguments <replaceable>x_run</replaceable> and <replaceable>y_rise</replaceable> are integers that can be
+positive, negative, or zero. (If both are 0 then &latex; treats the
+second as 1.) With
+<literal>\put(<replaceable>x_init</replaceable>,<replaceable>y_init</replaceable>){\line(<replaceable>x_run</replaceable>,<replaceable>y_rise</replaceable>){<replaceable>travel</replaceable>}}</literal>,
+if <replaceable>x_run</replaceable> is negative then the line&#8217;s ending point has a first
+coordinate that is less than <replaceable>x_init</replaceable>. If <replaceable>y_rise</replaceable> is negative
+then the line&#8217;s ending point has a second coordinate that is less than
+<replaceable>y_init</replaceable>.
+</para>
+<para>If <replaceable>travel</replaceable> is negative then you get <literal>LaTeX Error: Bad \line or
+\vector argument.</literal>
</para>
<indexterm role="cp"><primary><literal>pict2e</literal> package</primary></indexterm>
<indexterm role="cp"><primary>graphics packages</primary></indexterm>
-<para>Standard &latex; can only draw lines with <inlineequation><mathphrase><replaceable>slope</replaceable> = x/y</mathphrase></inlineequation>,
-where <inlineequation><mathphrase>x</mathphrase></inlineequation> and <inlineequation><mathphrase>y</mathphrase></inlineequation> have integer values from &#8722;6
-through&#160;6. For lines of any slope, and plenty of other shapes,
-see <literal>pict2e</literal> and many other packages on CTAN.
+<indexterm role="cp"><primary>package, <literal>pict2e</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>pict2e</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>TikZ</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>TikZ</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>PSTricks</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>PSTricks</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>MetaPost</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>MetaPost</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>Asymptote</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>Asymptote</literal> package</primary></indexterm>
+
+<para>Standard &latex; can only draw lines with a limited range of slopes
+because these lines are made by putting together line segments from
+pre-made fonts. The two numbers <replaceable>x_run</replaceable> and <replaceable>y_rise</replaceable> must have
+integer values from &#8722;6 through&#160;6. Also, they must be
+relatively prime, so that <replaceable>(x_run,y_rise)</replaceable> can be (2,1) but not
+(4,2) (if you choose the latter then instead of lines you get sequences
+of arrowheads; the solution is to switch to the former). To get lines
+of arbitrary slope and plenty of other shapes in a system like
+<literal>picture</literal>, see the package <filename>pict2e</filename> on CTAN. Another solution
+is to use a full-featured graphics system such as <filename>TikZ</filename>, or
+<filename>PSTricks</filename>, or <filename>MetaPost</filename>, or <filename>Asymptote</filename>
</para>
</sect2>
-<sect2 label="8.19.7" id="_005clinethickness">
+<sect2 label="8.19.6" id="_005clinethickness">
<title><literal>\linethickness</literal></title>
<indexterm role="fn"><primary>\linethickness</primary></indexterm>
-<para>The <literal>\linethickness{<replaceable>dim</replaceable>}</literal> command declares the thickness
-of horizontal and vertical lines in a picture environment to be
-<replaceable>dim</replaceable>, which must be a positive length.
+<para>Synopsis:
</para>
-<para><literal>\linethickness</literal> does not affect the thickness of slanted lines,
-circles, or the quarter circles drawn by <literal>\oval</literal>.
+<screen>\linethickness{<replaceable>dim</replaceable>}
+</screen>
+<para>Declares the thickness of subsequent horizontal and vertical lines in a
+picture to be <replaceable>dim</replaceable>, which must be a positive length
+(see <link linkend="Lengths">Lengths</link>). It differs from <literal>\thinlines</literal> and
+<literal>\thicklines</literal> in that it does not affect the thickness of slanted
+lines, circles, or ovals.
</para>
</sect2>
-<sect2 label="8.19.8" id="_005cthicklines">
-<title><literal>\thicklines</literal></title>
+<sect2 label="8.19.7" id="_005cthinlines">
+<title><literal>\thinlines</literal></title>
-<indexterm role="fn"><primary>\thicklines</primary></indexterm>
+<indexterm role="fn"><primary>\thinlines</primary></indexterm>
-<para>The <literal>\thicklines</literal> command is an alternate line thickness for
-horizontal and vertical lines in a picture environment;
-cf.&#160;<link linkend="_005clinethickness">\linethickness</link> and <link linkend="_005cthinlines">\thinlines</link>.
+<para>Declaration to set the thickness of subsequent lines, circles, and ovals
+in a picture environment to be 0.4pt. This is the default
+thickness, so this command is unnecessary unless the thickness has been
+changed with either <link linkend="_005clinethickness">\linethickness</link> or <link linkend="_005cthicklines">\thicklines</link>.
</para>
</sect2>
-<sect2 label="8.19.9" id="_005cthinlines">
-<title><literal>\thinlines</literal></title>
+<sect2 label="8.19.8" id="_005cthicklines">
+<title><literal>\thicklines</literal></title>
-<indexterm role="fn"><primary>\thinlines</primary></indexterm>
+<indexterm role="fn"><primary>\thicklines</primary></indexterm>
-<para>The <literal>\thinlines</literal> command is the default line thickness for
-horizontal and vertical lines in a picture environment;
-cf.&#160;<link linkend="_005clinethickness">\linethickness</link> and <link linkend="_005cthicklines">\thicklines</link>.
+<para>Declaration to set the thickness of subsequent lines, circles, and ovals
+in a picture environment to be 0.8pt. See also
+<link linkend="_005clinethickness">\linethickness</link> and <link linkend="_005cthinlines">\thinlines</link>. This command is illustrated
+in the Trapezoidal Rule example of <link linkend="picture">picture</link>.
</para>
</sect2>
-<sect2 label="8.19.10" id="_005cmultiput">
-<title><literal>\multiput</literal></title>
+<sect2 label="8.19.9" id="_005ccircle">
+<title><literal>\circle</literal></title>
-<indexterm role="fn"><primary>\multiput</primary></indexterm>
+<indexterm role="fn"><primary>\circle</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\multiput(<replaceable>x</replaceable>,<replaceable>y</replaceable>)(<replaceable>delta_x</replaceable>,<replaceable>delta_y</replaceable>){<replaceable>n</replaceable>}{<replaceable>obj</replaceable>}
+<screen>\circle{<replaceable>diameter</replaceable>}
+\circle*{<replaceable>diameter</replaceable>}
</screen>
-<para>The <literal>\multiput</literal> command copies the object <replaceable>obj</replaceable> in a regular
-pattern across a picture. <replaceable>obj</replaceable> is first placed at position
-<inlineequation><mathphrase>(x,y)</mathphrase></inlineequation>, then at <inlineequation><mathphrase>(x+\delta x,y+\delta y)</mathphrase></inlineequation>, and so on,
-<replaceable>n</replaceable> times.
+<para>Produces a circle with a diameter as close as possible to the specified
+one. The <literal>*</literal>&#160;form produces a filled-in circle.
+</para>
+<para>This draws a circle of radius 6, centered at <literal>(5,7)</literal>.
+</para>
+<screen>\put(5,7){\circle{6}}
+</screen>
+<para>The available radii for <literal>circle</literal> are, in points, the even
+numbers from 2 to 20, inclusive. For <literal>circle*</literal> they are all the
+integers from 1 to 15.
</para>
</sect2>
-<sect2 label="8.19.11" id="_005coval">
+<sect2 label="8.19.10" id="_005coval">
<title><literal>\oval</literal></title>
<indexterm role="fn"><primary>\oval</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\oval(<replaceable>width</replaceable>,<replaceable>height</replaceable>)[<replaceable>portion</replaceable>]
+<screen>\oval(<replaceable>width</replaceable>,<replaceable>height</replaceable>)
+\oval(<replaceable>width</replaceable>,<replaceable>height</replaceable>)[<replaceable>portion</replaceable>]
</screen>
-<para>The <literal>\oval</literal> command produces a rectangle with rounded corners. The
-optional argument <replaceable>portion</replaceable> allows you to produce only half of the
-oval via the following:
+<para>Produce a rectangle with rounded corners. The optional argument
+<replaceable>portion</replaceable> allows you to produce only half or a quarter of the oval.
+For half an oval take <replaceable>portion</replaceable> to be one of these.
</para>
<variablelist><varlistentry><term><literal>t</literal>
-</term><listitem><para>selects the top half;
+</term><listitem><para>top half
</para></listitem></varlistentry><varlistentry><term><literal>b</literal>
-</term><listitem><para>selects the bottom half;
+</term><listitem><para>bottom half
</para></listitem></varlistentry><varlistentry><term><literal>r</literal>
-</term><listitem><para>selects the right half;
+</term><listitem><para>right half
</para></listitem></varlistentry><varlistentry><term><literal>l</literal>
-</term><listitem><para>selects the left half.
+</term><listitem><para>left half
</para></listitem></varlistentry></variablelist>
-<para>It is also possible to produce only one quarter of the oval by setting
-<replaceable>portion</replaceable> to <literal>tr</literal>, <literal>br</literal>, <literal>bl</literal>, or <literal>tl</literal>.
+<para>Produce only one quarter of the oval by setting <replaceable>portion</replaceable> to
+<literal>tr</literal>, <literal>br</literal>, <literal>bl</literal>, or <literal>tl</literal>.
</para>
-<para>The &#8220;corners&#8221; of the oval are made with quarter circles with a
-maximum radius of 20pt, so large &#8220;ovals&#8221; will look more like
-boxes with rounded corners.
+<para>This draws the top half of an oval that is 3 wide and 7 tall.
</para>
-
-</sect2>
-<sect2 label="8.19.12" id="_005cput">
-<title><literal>\put</literal></title>
-
-<indexterm role="fn"><primary>\put</primary></indexterm>
-
-<para>Synopsis:
-</para>
-<screen>\put(<replaceable>xcoord</replaceable>,<replaceable>ycoord</replaceable>){ ... }
+<screen>\put(5,7){\oval(3,7)[t]}
</screen>
-<para>The <literal>\put</literal> command places the material specified by the
-(mandatory) argument in braces at the given coordinate,
-(<replaceable>xcoord</replaceable>,<replaceable>ycoord</replaceable>).
+<para>The (5,7) is the center of the entire oval, not just the center of the
+top half.
+</para>
+<para>These shapes are not ellipses. They are rectangles whose corners are
+made with quarter circles. These circles have a maximum radius of
+20pt (see <link linkend="_005ccircle">\circle</link> for the sizes). Thus large ovals are just
+boxes with a small amount of corner rounding.
</para>
</sect2>
-<sect2 label="8.19.13" id="_005cshortstack">
+<sect2 label="8.19.11" id="_005cshortstack">
<title><literal>\shortstack</literal></title>
<indexterm role="fn"><primary>\shortstack</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\shortstack[<replaceable>position</replaceable>]{...\\...\\...}
+<screen>\shortstack[<replaceable>position</replaceable>]{<replaceable>line 1</replaceable> \\ ... }
</screen>
-<para>The <literal>\shortstack</literal> command produces a stack of objects. The valid
-positions are:
+<para>Produce a vertical stack of objects.
+</para>
+<para>This labels the <inlineequation><mathphrase>y</mathphrase></inlineequation> axis.
+</para>
+<screen>\put(0,0){\vector(1,0){4}} % x axis
+\put(0,0){\vector(0,1){2}} % y
+\put(-0.25,2){\makebox[0][r]{\shortstack[r]{$y$\\ axis}}}
+</screen>
+<para>For a short stack, the reference point is the lower left of the stack.
+In the above example the <link linkend="_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</link> puts the stack flush
+right in a zero width box so in total the short stack sits slightly to
+the left of the <inlineequation><mathphrase>y</mathphrase></inlineequation>&#160;axis.
+</para>
+<para>The valid positions are:
</para>
<variablelist><varlistentry><term><literal>r</literal>
-</term><listitem><para>Move the objects to the right of the stack.
+</term><listitem><para>Make objects flush right
</para></listitem></varlistentry><varlistentry><term><literal>l</literal>
-</term><listitem><para>Move the objects to the left of the stack
+</term><listitem><para>Make objects flush left
</para></listitem></varlistentry><varlistentry><term><literal>c</literal>
-</term><listitem><para>Move the objects to the centre of the stack (default)
+</term><listitem><para>Center objects (default)
</para></listitem></varlistentry></variablelist>
<indexterm role="fn"><primary>\\ (for <literal>\shortstack</literal> objects)</primary></indexterm>
-<para>Objects are separated with <literal>\\</literal>.
+<para>Separate objects into lines with <literal>\\</literal>. These stacks are short in
+that, unlike in a <literal>tabular</literal> or <literal>array</literal> environment, here the
+rows are not spaced out to be of even heights. Thus, in
+<literal>\shortstack{X\\o\\o\\X}</literal> the first and last rows are taller than
+the middle two. You can adjust row heights either by putting in the
+usual interline spacing with <literal>\shortstack{X\\ \strut o\\o\\X}</literal>,
+or by hand, via an explicit zero-width box <literal>\shortstack{X \\
+\rule{0pt}{12pt} o\\o\\X}</literal> or by using <literal>\\</literal>&#8217;s optional
+argument <literal>\shortstack{X\\[2pt] o\\o\\X}</literal>.
+</para>
+<para>The <literal>\shortstack</literal> command is also available outside the
+<literal>picture</literal> environment.
</para>
</sect2>
-<sect2 label="8.19.14" id="_005cvector">
+<sect2 label="8.19.12" id="_005cvector">
<title><literal>\vector</literal></title>
<indexterm role="fn"><primary>\vector</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\vector(<replaceable>xslope</replaceable>,<replaceable>yslope</replaceable>){<replaceable>length</replaceable>}
+<screen>\vector(<replaceable>x_run</replaceable>,<replaceable>y_rise</replaceable>){<replaceable>travel</replaceable>}
</screen>
-<para>The <literal>\vector</literal> command draws a line with an arrow of the specified
-length and slope. The <inlineequation><mathphrase><replaceable>xslope</replaceable></mathphrase></inlineequation> and <inlineequation><mathphrase><replaceable>yslope</replaceable></mathphrase></inlineequation>
-values must lie between &#8722;4 and +4, inclusive.
+<para>Draw a line ending in an arrow. The slope of that line is: it
+vertically rises <replaceable>y_rise</replaceable> for every horizontal <replaceable>x_run</replaceable>. The
+<replaceable>travel</replaceable> is the total horizontal change&#160;&#8212; it is not the
+length of the vector, it is the change in <inlineequation><mathphrase>x</mathphrase></inlineequation>. In the special case
+of vertical vectors, if (<replaceable>x_run</replaceable>,<replaceable>y_rise</replaceable>)=(0,1), then
+<replaceable>travel</replaceable> gives the change in <inlineequation><mathphrase>y</mathphrase></inlineequation>.
+</para>
+<para>For an example see <link linkend="picture">picture</link>.
+</para>
+<para>For elaboration on <replaceable>x_run</replaceable> and <replaceable>y_rise</replaceable> see <link linkend="_005cline">\line</link>. As
+there, the values of <replaceable>x_run</replaceable> and <replaceable>y_rise</replaceable> are limited. For
+<literal>\vector</literal> you must chooses integers between &#8722;4 and 4,
+inclusive. Also, the two you choose must be relatively prime. Thus,
+<literal>\vector(2,1){4}</literal> is acceptable but <literal>\vector(4,2){4}</literal> is
+not (if you use the latter then you get a sequence of arrowheads).
+</para>
+
+</sect2>
+<sect2 label="8.19.13" id="_005cmakebox-_0028picture_0029">
+<title><literal>\makebox</literal> (picture)</title>
+
+<indexterm role="fn"><primary>\makebox (for <literal>picture</literal>)</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\makebox(<replaceable>rec-width</replaceable>,<replaceable>rec-height</replaceable>){<replaceable>text</replaceable>}
+\makebox(<replaceable>rec-width</replaceable>,<replaceable>rec-height</replaceable>)[<replaceable>position</replaceable>]{<replaceable>text</replaceable>}
+</screen>
+<para>Make a box to hold <replaceable>text</replaceable>. This command fits with the
+<literal>picture</literal> environment, although you can use it outside of there,
+because <replaceable>rec-width</replaceable> and <replaceable>rec-height</replaceable> are numbers specifying
+distances in terms of the <literal>\unitlength</literal> (see <link linkend="picture">picture</link>). This
+command is similar to the normal <literal>\makebox</literal> command (see <link linkend="_005cmbox-_0026-_005cmakebox">\mbox &amp;
+\makebox</link>) except here that you must specify the width and height. This
+command is fragile (see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>This makes a box of length 3.5 times <literal>\unitlength</literal> and height 4
+times <literal>\unitlength</literal>.
+</para>
+<screen>\put(1,2){\makebox(3.5,4){...}}
+</screen>
+<para>The optional argument <literal><replaceable>position</replaceable></literal> specifies where in the box
+the <replaceable>text</replaceable> appears. The default is to center it, both horizontally
+and vertically. To place it somewhere else, use a string with one or
+two of these letters.
+</para>
+<variablelist><varlistentry><term><literal>t</literal>
+</term><listitem><para>Puts <replaceable>text</replaceable> the top of the box.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>b</literal>
+</term><listitem><para>Put <replaceable>text</replaceable> at the bottom.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>l</literal>
+</term><listitem><para>Put <replaceable>text</replaceable> on the left.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>r</literal>
+</term><listitem><para>Put <replaceable>text</replaceable> on the right.
+</para>
+</listitem></varlistentry></variablelist>
+
+</sect2>
+<sect2 label="8.19.14" id="_005cframebox-_0028picture_0029">
+<title><literal>\framebox</literal> (picture)</title>
+
+<indexterm role="fn"><primary>\framebox</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\framebox(<replaceable>rec-width</replaceable>,<replaceable>rec-height</replaceable>){<replaceable>text</replaceable>}
+\framebox(<replaceable>rec-width</replaceable>,<replaceable>rec-height</replaceable>)[<replaceable>position</replaceable>]{<replaceable>text</replaceable>}
+</screen>
+<para>This is the same as <link linkend="_005cmakebox-_0028picture_0029">\makebox (picture)</link> except that it puts a frame
+around the outside of the box that it creates. The reference point is
+the bottom left corner of the frame. This command fits with the
+<literal>picture</literal> environment, although you can use it outside of there,
+because lengths are numbers specifying the distance in terms of the
+<literal>\unitlength</literal> (see <link linkend="picture">picture</link>). This command is fragile
+(see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>This example creates a frame 2.5&#160;inches by 3&#160;inches and puts
+the text in the center.
+</para>
+<screen>\setlength{\unitlength}{1in}
+\framebox(2.5,3){test text}
+</screen>
+<para>The required arguments are that the rectangle has overall width
+<replaceable>rect-width</replaceable> units and height <replaceable>rect-height</replaceable> units.
+</para>
+<para>The optional argument <replaceable>position</replaceable> specifies the position of
+<replaceable>text</replaceable>; see <link linkend="_005cmakebox-_0028picture_0029">\makebox (picture)</link> for the values that it can
+take.
+</para>
+<indexterm role="fn"><primary>\fboxrule</primary></indexterm>
+<indexterm role="fn"><primary>\fboxsep</primary></indexterm>
+<para>The rule has thickness <literal>\fboxrule</literal> and there is a blank space
+<literal>\fboxsep</literal> between the frame and the contents of the box.
+</para>
+<para>For this command, you must specify the <replaceable>width</replaceable> and <replaceable>height</replaceable>. If
+you want to just put a frame around some contents whose dimension is
+determined in some other way then either use <literal>\fbox</literal> (see <link linkend="_005cfbox-_0026-_005cframebox">\fbox
+&amp; \framebox</link>) or <literal>\frame</literal> (see <link linkend="_005cframe">\frame</link>).
+</para>
+
+</sect2>
+<sect2 label="8.19.15" id="_005cframe">
+<title><literal>\frame</literal></title>
+
+<indexterm role="fn"><primary>\frame</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\frame{<replaceable>contents</replaceable>}
+</screen>
+<para>Puts a rectangular frame around <replaceable>contents</replaceable>. The reference point is
+the bottom left corner of the frame. In contrast to <literal>\framebox</literal>
+(see <link linkend="_005cframebox-_0028picture_0029">\framebox (picture)</link>), this command puts no extra space is put
+between the frame and the object. It is fragile (see <link linkend="_005cprotect">\protect</link>).
+</para>
+
+</sect2>
+<sect2 label="8.19.16" id="_005cdashbox">
+<title><literal>\dashbox</literal></title>
+
+<indexterm role="fn"><primary>\dashbox</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\dashbox{<replaceable>dash-len</replaceable>}(<replaceable>rect-width</replaceable>,<replaceable>rect-height</replaceable>){<replaceable>text</replaceable>}
+\dashbox{<replaceable>dash-len</replaceable>}(<replaceable>rect-width</replaceable>,<replaceable>rect-height</replaceable>)[<replaceable>position</replaceable>]{<replaceable>text</replaceable>}
+</screen>
+<para>Create a dashed rectangle around <replaceable>text</replaceable>. This command fits with the
+<literal>picture</literal> environment, although you can use it outside of there,
+because lengths are numbers specifying the distance in terms of the
+<literal>\unitlength</literal> (see <link linkend="picture">picture</link>).
+</para>
+<para>The required arguments are: dashes are <replaceable>dash-len</replaceable> units long, with
+the same length gap, and the rectangle has overall width
+<replaceable>rect-width</replaceable> units and height <replaceable>rect-height</replaceable> units.
+</para>
+<para>The optional argument <replaceable>position</replaceable> specifies the position of
+<replaceable>text</replaceable>; see <link linkend="_005cmakebox-_0028picture_0029">\makebox (picture)</link> for the values that it can
+take.
+</para>
+<para>This shows that you can use non-integer value for <replaceable>dash-len</replaceable>.
+</para>
+<screen>\put(0,0){\dashbox{0.1}(5,0.5){My hovercraft is full of eels.}}
+</screen>
+<para>Each dash will be <literal>0.1\unitlength</literal> long, the box&#8217;s width is
+<literal>5\unitlength</literal> and its height is <literal>0.5\unitlength</literal>.
+</para>
+<para>As in that example, a dashed box looks best when <replaceable>rect-width</replaceable> and
+<replaceable>rect-height</replaceable> are multiples of the <replaceable>dash-len</replaceable>.
</para>
</sect2>
</sect1>
-<sect1 label="8.20" id="quotation-and-quote">
-<title><literal>quotation</literal> and <literal>quote</literal></title>
+<sect1 label="8.20" id="quotation-_0026-quote">
+<title><literal>quotation</literal> &amp; <literal>quote</literal></title>
<indexterm role="fn"><primary>environment, <literal>quotation</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>quotation</literal> environment</primary></indexterm>
@@ -4539,35 +5722,28 @@ values must lie between &#8722;4 and +4, inclusive.
<para>Synopsis:
</para>
<screen>\begin{quotation}
-<replaceable>text</replaceable>
+ <replaceable>text</replaceable>
\end{quotation}
</screen>
<para>or
</para>
<screen>\begin{quote}
-<replaceable>text</replaceable>
+ <replaceable>text</replaceable>
\end{quote}
</screen>
-<para>Include a quotation.
-</para>
-<para>In both environments, margins are indented on both sides by
-<literal>\leftmargin</literal> and the text is justified at both. As with the main
-text, leaving a blank line produces a new paragraph.
+<para>Include a quotation. Both environments indent margins on both sides by
+<literal>\leftmargin</literal> and the text is right-justified.
</para>
-<para>To compare the two: in the <literal>quotation</literal> environment, paragraphs are
-indented by 1.5em and the space between paragraphs is small,
-<literal>0pt plus 1pt</literal>. In the <literal>quote</literal> environment, paragraphs are
-not indented and there is vertical space between paragraphs (it is the
-rubber length <literal>\parsep</literal>). Thus, the <literal>quotation</literal> environment
-may be more suitable for documents where new paragraphs are marked by an
-indent rather than by a vertical separation. In addition, <literal>quote</literal>
-may be more suitable for a short quotation or a sequence of short
-quotations.
+<para>They differ in how they treat paragraphs. In the <literal>quotation</literal>
+environment, paragraphs are indented by 1.5em and the space
+between paragraphs is small, <literal>0pt plus 1pt</literal>. In the <literal>quote</literal>
+environment, paragraphs are not indented and there is vertical space
+between paragraphs (it is the rubber length <literal>\parsep</literal>).
</para>
-<screen>\begin{quotation}
-\it Four score and seven years ago
+<screen>\begin{quotation} \small\it
+ Four score and seven years ago
... shall not perish from the earth.
-\hspace{1em plus 1fill}---Abraham Lincoln
+ \hspace{1em plus 1fill}---Abraham Lincoln
\end{quotation}
</screen>
@@ -4590,10 +5766,11 @@ quotations.
...
\end{tabbing}
</screen>
-<para>The <literal>tabbing</literal> environment aligns text in columns. It works by
-setting tab stops and tabbing to them much as was done on a typewriter.
-It is best suited for cases where the width of each column is constant
-and known in advance.
+<para>Align text in columns, by setting tab stops and tabbing to them much as
+was done on a typewriter. This is less often used than the environments
+<literal>tabular</literal> (see <link linkend="tabular">tabular</link>) or <literal>array</literal> (see <link linkend="array">array</link>) because
+in those the width of each column need not be constant and need not be
+known in advance.
</para>
<para>This example has a first line where the tab stops are set to explicit
widths, ended by a <literal>\kill</literal> command (which is described below):
@@ -4724,8 +5901,9 @@ function \= fact(n : integer) : integer;\\
end;\\
\end{tabbing}
</screen>
-<para>The output looks like this:
-</para><screen>function fact(n : integer) : integer;
+<para>The output looks like this.
+</para>
+<screen>function fact(n : integer) : integer;
begin
if n &gt; 1 then
fact := n * fact(n-1);
@@ -4743,13 +5921,11 @@ function \= fact(n : integer) : integer;\\
<indexterm role="cp"><primary>package, <literal>fancyvrb</literal></primary></indexterm>
<indexterm role="cp"><primary><literal>fancyvrb</literal> package</primary></indexterm>
-
-<para>(The above example is just for illustration of the environment. To
-actually typeset computer code in typewriter like this, a verbatim
-environment (see <link linkend="verbatim">verbatim</link>) would normally suffice. For
-pretty-printed code, there are quite a few packages, including
-<literal>algorithm2e</literal>, <literal>fancyvrb</literal>, <literal>listings</literal>, and
-<literal>minted</literal>.)
+<para>This example is just for illustration of the environment. To actually
+typeset computer code in typewriter like this, a verbatim environment
+(see <link linkend="verbatim">verbatim</link>) would normally be best. For pretty-printed code,
+there are quite a few packages, including <literal>algorithm2e</literal>,
+<literal>fancyvrb</literal>, <literal>listings</literal>, and <literal>minted</literal>.
</para>
</sect1>
@@ -4765,29 +5941,46 @@ pretty-printed code, there are quite a few packages, including
<para>Synopsis:
</para>
<screen>\begin{table}[<replaceable>placement</replaceable>]
- table body
-\caption[<replaceable>loftitle</replaceable>]{<replaceable>title</replaceable>}
-\label{<replaceable>label}</replaceable>
+ <replaceable>table body</replaceable>
+ \caption[<replaceable>loftitle</replaceable>]{<replaceable>title</replaceable>} % optional
+ \label{<replaceable>label}</replaceable> % also optional
\end{table}
</screen>
-<para>A class of floats (see <link linkend="Floats">Floats</link>). Because they cannot be split across
-pages, they are not typeset in sequence with the normal text but instead
-are &#8220;floated&#8221; to a convenient place, such as the top of a following
-page.
+<para>A class of floats (see <link linkend="Floats">Floats</link>). They cannot be split across pages
+and so they are not typeset in sequence with the normal text but instead
+are floated to a convenient place, such as the top of a following page.
+</para>
+<para>This example <literal>table</literal> environment contains a <literal>tabular</literal>
+</para>
+<screen>\begin{table}
+ \centering\small
+ \begin{tabular}{ll}
+ \multicolumn{1}{c}{\textit{Author}}
+ &amp;\multicolumn{1}{c}{\textit{Piece}} \\ \hline
+ Bach &amp;Cello Suite Number 1 \\
+ Beethoven &amp;Cello Sonata Number 3 \\
+ Brahms &amp;Cello Sonata Number 1
+ \end{tabular}
+ \caption{Top cello pieces}
+ \label{tab:cello}
+\end{table}
+</screen>
+<para>but you can put many different kinds of content in a <literal>table</literal>,
+including text, &latex; commands, etc.
</para>
<para>For the possible values of <replaceable>placement</replaceable> and their effect on the
float placement algorithm, see <link linkend="Floats">Floats</link>.
</para>
-<para>The table body is typeset in a <literal>parbox</literal> of width <literal>\textwidth</literal>
-and so it can contain text, commands, etc.
+<para>The table body is typeset in a <literal>parbox</literal> of width <literal>\textwidth</literal>.
+It can contain text, commands, graphics, etc.
</para>
<para>The label is optional; it is used for cross references (see <link linkend="Cross-references">Cross
references</link>).
<indexterm role="fn"><primary>\caption</primary></indexterm>
-The optional <literal>\caption</literal> command specifies caption text for the
-table. By default it is numbered. If <replaceable>lottitle</replaceable> is present, it is
-used in the list of tables instead of <replaceable>title</replaceable> (see <link linkend="Tables-of-contents">Tables of
-contents</link>).
+The <literal>\caption</literal> command is also optional. It specifies caption text
+for the table. By default it is numbered. If its optional
+<replaceable>lottitle</replaceable> is present then that text is used in the list of tables
+instead of <replaceable>title</replaceable> (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>).
</para>
<para>In this example the table and caption will float to the bottom of a page,
unless it is pushed to a float page at the end.
@@ -4817,20 +6010,20 @@ unless it is pushed to a float page at the end.
<para>Synopsis:
</para>
<screen>\begin{tabular}[<replaceable>pos</replaceable>]{<replaceable>cols</replaceable>}
-column 1 entry &amp;column 2 entry ... &amp;column n entry \\
+ <replaceable>column 1 entry</replaceable> &amp;<replaceable>column 2 entry</replaceable> ... &amp;<replaceable>column n entry</replaceable> \\
...
\end{tabular}
</screen>
<para>or
</para>
<screen>\begin{tabular*}{<replaceable>width</replaceable>}[<replaceable>pos</replaceable>]{<replaceable>cols</replaceable>}
-column 1 entry &amp;column 2 entry ... &amp;column n entry \\
+ <replaceable>column 1 entry</replaceable> &amp;<replaceable>column 2 entry</replaceable> ... &amp;<replaceable>column n entry</replaceable> \\
...
\end{tabular*}
</screen>
-<para>These environments produce a table, a box consisting of a sequence of
-horizontal rows. Each row consists of items that are aligned vertically
-in columns. This illustrates many of the features.
+<para>Produce a table, a box consisting of a sequence of horizontal rows.
+Each row consists of items that are aligned vertically in columns. This
+illustrates many of the features.
</para>
<screen>\begin{tabular}{l|l}
\textit{Player name} &amp;\textit{Career home runs} \\
@@ -4839,27 +6032,21 @@ in columns. This illustrates many of the features.
Babe Ruth &amp;714
\end{tabular}
</screen>
-<para>The vertical format of two left-aligned columns, with a vertical bar
-between them, is specified in <literal>tabular</literal>&#8217;s argument <literal>{l|l}</literal>.
+<para>The output will have two left-aligned columns with a vertical bar
+between them. This is specified in <literal>tabular</literal>&#8217;s argument
+<literal>{l|l}</literal>.
<indexterm role="fn"><primary>&amp;</primary></indexterm>
-Columns are separated with an ampersand <literal>&amp;</literal>. A horizontal rule
-between two rows is created with <literal>\hline</literal>.
+Put the entries into different columns by separating them with an
+ampersand, <literal>&amp;</literal>. The end of each row is marked with a double
+backslash, <literal>\\</literal>. Put a horizontal rule below a row, after a double
+backslash, with <literal>\hline</literal>.
<indexterm role="fn"><primary>\\ for <literal>tabular</literal></primary></indexterm>
-The end of each row is marked with a double backslash&#160;<literal>\\</literal>.
This <literal>\\</literal> is optional after the last row unless an <literal>\hline</literal>
command follows, to put a rule below the table.
</para>
<para>The required and optional arguments to <literal>tabular</literal> consist of:
</para>
-<variablelist><varlistentry><term><replaceable>width</replaceable>
-</term><listitem><para>Required for <literal>tabular*</literal>, not allowed for <literal>tabular</literal>. Specifies
-the width of the <literal>tabular*</literal> environment. The space between columns
-should be rubber, as with <literal>@{\extracolsep{\fill}}</literal>, to allow
-the table to stretch or shrink to make the specified width, or else you
-are likely to get the <literal>Underfull \hbox (badness 10000) in alignment
-...</literal> warning.
-</para>
-</listitem></varlistentry><varlistentry><term><replaceable>pos</replaceable>
+<variablelist><varlistentry><term><replaceable>pos</replaceable>
</term><listitem><para>Optional. Specifies the table&#8217;s vertical position. The default is to
align the table so its vertical center matches the baseline of the
surrounding text. There are two other possible alignments: <literal>t</literal>
@@ -4888,25 +6075,28 @@ column and intercolumn material.
</term><listitem><para>A vertical line the full height and depth of the environment.
</para>
</listitem></varlistentry><varlistentry><term><literal>@{<replaceable>text or space</replaceable>}</literal>
-</term><listitem><para>This inserts <replaceable>text or space</replaceable> at this location in every row. The
-<replaceable>text or space</replaceable> material is typeset in LR mode. This text is
-fragile (see <link linkend="_005cprotect">\protect</link>).
+</term><listitem><para>Insert <replaceable>text or space</replaceable> at this location in every row. The <replaceable>text
+or space</replaceable> material is typeset in LR mode. This text is fragile
+(see <link linkend="_005cprotect">\protect</link>).
</para>
-<para>This specifier is optional: with no @-expression, &latex;&#8217;s
+<para>If between two columns there is no @-expression then &latex;&#8217;s
<literal>book</literal>, <literal>article</literal>, and <literal>report</literal> classes will put on
-either side of each column a space of length <literal>\tabcolsep</literal>, which
-by default is &#8216;<literal>6pt</literal>&#8217;. That is, by default adjacent columns are
-separated by 12pt (so <literal>\tabcolsep</literal> is misleadingly-named since it
-is not the separation between tabular columns). By implication, a
-space of 6pt also comes before the first column and after the final
-column, unless you put a <literal>@{...}</literal> or <literal>|</literal> there.
-</para>
-<para>If you override the default and use an @-expression then you must
-insert any desired space yourself, as in <literal>@{\hspace{1em}}</literal>.
-</para>
-<para>An empty expression <literal>@{}</literal> will eliminate the space, including
-the space at the start or end, as in the example below where the tabular
-lines need to lie on the left margin.
+either side of each column a space of length <literal>\tabcolsep</literal>, which by
+default is 6pt. That is, by default adjacent columns are
+separated by 12pt (so <literal>\tabcolsep</literal> is misleadingly named
+since it is only half of the separation between tabular columns). In
+addition, a space of 6pt also comes before the first column and
+after the final column, unless you put a <literal>@{...}</literal> or <literal>|</literal>
+there.
+</para>
+<para>If you override the default and use an @-expression then &latex; does
+not insert <literal>\tabcolsep</literal> so you must insert any desired space
+yourself, as in <literal>@{\hspace{1em}}</literal>.
+</para>
+<para>An empty expression <literal>@{}</literal> will eliminate the space. In
+particular, sometimes you want to eliminate the the space before the
+first column or after the last one, as in the example below where the
+tabular lines need to lie on the left margin.
</para>
<screen>\begin{flushleft}
\begin{tabular}{@{}l}
@@ -4914,8 +6104,8 @@ lines need to lie on the left margin.
\end{tabular}
\end{flushleft}
</screen>
-<para>This example shows text, a decimal point, between the columns, arranged
-so the numbers in the table are aligned on that decimal point.
+<para>The next example shows text, a decimal point between the columns,
+arranged so the numbers in the table are aligned on it.
</para>
<screen>\begin{tabular}{r@{$.$}l}
$3$ &amp;$14$ \\
@@ -4925,19 +6115,17 @@ so the numbers in the table are aligned on that decimal point.
<indexterm role="fn"><primary>\extracolsep</primary></indexterm>
<para>An <literal>\extracolsep{<replaceable>wd</replaceable>}</literal> command in an @-expression causes an
extra space of width <replaceable>wd</replaceable> to appear to the left of all subsequent
-columns, until countermanded by another <literal>\extracolsep</literal> command.
-Unlike ordinary intercolumn space, this extra space is not suppressed by
-an @-expression. An <literal>\extracolsep</literal> command can be used only in an
+columns, until countermanded by another <literal>\extracolsep</literal>. Unlike
+ordinary intercolumn space, this extra space is not suppressed by an
+@-expression. An <literal>\extracolsep</literal> command can be used only in an
@-expression in the <literal>cols</literal> argument. Below, &latex; inserts the
right amount of intercolumn space to make the entire table 4 inches
wide.
</para>
-<screen>\begin{center}
- \begin{tabular*}{4in}{l@{\ \ldots\extracolsep{\fill}}l}
- Seven times down, eight times up
- &amp;such is life!
- \end{tabular*}
-\end{center}
+<screen>\begin{tabular*}{4in}{l@{\extracolsep{\fill}}l}
+ Seven times down, eight times up \ldots
+ &amp;such is life!
+\end{tabular*}
</screen>
<para>To insert commands that are automatically executed before a given
column, load the <literal>array</literal> package and use the <literal>&gt;{...}</literal>
@@ -4945,45 +6133,56 @@ specifier.
<!-- xx should fully explain array, tabularx, and all other base packages... -->
</para>
</listitem></varlistentry><varlistentry><term><literal>p{<replaceable>wd</replaceable>}</literal>
-</term><listitem><para>Each item in the column is typeset in a parbox of width <replaceable>wd</replaceable>.
+</term><listitem><para>Each item in the column is typeset in a parbox of width <replaceable>wd</replaceable>, as if
+it were the argument of a <literal>\parbox[t]{wd}{...}</literal> command.
</para>
-<para>Note that a line break double backslash <literal>\\</literal> may not appear in the
-item, except inside an environment like <literal>minipage</literal>, <literal>array</literal>,
-or <literal>tabular</literal>, or inside an explicit <literal>\parbox</literal>, or in the scope
-of a <literal>\centering</literal>, <literal>\raggedright</literal>, or <literal>\raggedleft</literal>
+<para>A line break double backslash <literal>\\</literal> may not appear in the item,
+except inside an environment like <literal>minipage</literal>, <literal>array</literal>, or
+<literal>tabular</literal>, or inside an explicit <literal>\parbox</literal>, or in the scope of
+a <literal>\centering</literal>, <literal>\raggedright</literal>, or <literal>\raggedleft</literal>
declaration (when used in a <literal>p</literal>-column element these declarations
must appear inside braces, as with <literal>{\centering .. \\
..}</literal>). Otherwise &latex; will misinterpret the double backslash as
-ending the row.
+ending the row. Instead, to get a line break in there use
+<literal>\newline</literal> (see <link linkend="_005cnewline">\newline</link>).
</para>
</listitem></varlistentry><varlistentry><term><literal>*{<replaceable>num</replaceable>}{<replaceable>cols</replaceable>}</literal>
</term><listitem><para>Equivalent to <replaceable>num</replaceable> copies of <replaceable>cols</replaceable>, where <replaceable>num</replaceable> is a
-positive integer and <replaceable>cols</replaceable> is a list of specifiers. Thus
-<literal>\begin{tabular}{|*{3}{l|r}|}</literal> is equivalent to
-<literal>\begin{tabular}{|l|rl|rl|r|}</literal>. Note that <replaceable>cols</replaceable> may
-contain another <literal>*</literal>-expression.
+positive integer and <replaceable>cols</replaceable> is a list of specifiers. Thus the
+specifier <literal>\begin{tabular}{|*{3}{l|r}|}</literal> is equivalent to
+the specifier <literal>\begin{tabular}{|l|rl|rl|r|}</literal>. Note that
+<replaceable>cols</replaceable> may contain another <literal>*</literal>-expression.
</para>
-</listitem></varlistentry></variablelist></listitem></varlistentry></variablelist>
+</listitem></varlistentry></variablelist>
+</listitem></varlistentry><varlistentry><term><replaceable>width</replaceable>
+</term><listitem><para>Required for <literal>tabular*</literal>, not allowed for <literal>tabular</literal>. Specifies
+the width of the <literal>tabular*</literal> environment. The space between columns
+should be rubber, as with <literal>@{\extracolsep{\fill}}</literal>, to allow
+the table to stretch or shrink to make the specified width, or else you
+are likely to get the <literal>Underfull \hbox (badness 10000) in alignment
+...</literal> warning.
+</para>
+</listitem></varlistentry></variablelist>
<para>Parameters that control formatting:
<!-- xx defaults, own node (xref from array)? -->
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\arrayrulewidth</primary></indexterm><literal>\arrayrulewidth</literal>
-</term><listitem><para>A length that is the thickness of the rule created by <literal>|</literal>,
+</term><listitem><anchor id="tabular-arrayrulewidth"/><para>A length that is the thickness of the rule created by <literal>|</literal>,
<literal>\hline</literal>, and <literal>\vline</literal> in the <literal>tabular</literal> and <literal>array</literal>
environments. The default is &#8216;<literal>.4pt</literal>&#8217;. Change it as in
<literal>\setlength{\arrayrulewidth}{0.8pt}</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\arraystretch</primary></indexterm><literal>\arraystretch</literal>
-</term><listitem><para>A factor by which the spacing between rows in the <literal>tabular</literal> and
+</term><listitem><anchor id="tabular-arraystrech"/><para>A factor by which the spacing between rows in the <literal>tabular</literal> and
<literal>array</literal> environments is multiplied. The default is &#8216;<literal>1</literal>&#8217;, for
no scaling. Change it as <literal>\renewcommand{\arraystretch}{1.2}</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\doublerulesep</primary></indexterm><literal>\doublerulesep</literal>
-</term><listitem><para>A length that is the distance between the vertical rules produced by the
+</term><listitem><anchor id="tabular-doublerulesep"/><para>A length that is the distance between the vertical rules produced by the
<literal>||</literal> specifier. The default is &#8216;<literal>2pt</literal>&#8217;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\tabcolsep</primary></indexterm><literal>\tabcolsep</literal>
-</term><listitem><para>A length that is half of the space between columns. The default is
+</term><listitem><anchor id="tabular-tabcolsep"/><para>A length that is half of the space between columns. The default is
&#8216;<literal>6pt</literal>&#8217;. Change it with <literal>\setlength</literal>.
</para>
</listitem></varlistentry></variablelist>
@@ -5013,8 +6212,9 @@ entry.
spanned by the single heading &#8216;<literal>Name</literal>&#8217;.
</para>
<screen>\begin{tabular}{lccl}
- \textit{ID} &amp;\multicolumn{2}{c}{\textit{Name}} &amp;\textit{Age} \\ \hline % row one
- 978-0-393-03701-2 &amp;O'Brian &amp;Patrick &amp;55 \\ % row two
+ \textit{ID} &amp;\multicolumn{2}{c}{\textit{Name}} &amp;\textit{Age} \\
+ \hline
+ 978-0-393-03701-2 &amp;O'Brian &amp;Patrick &amp;55 \\
...
\end{tabular}
</screen>
@@ -5092,23 +6292,23 @@ used in an @-expression, although its synonym vertical
bar&#160;<literal>|</literal> is more common. This command is rarely used in the
body of a table; typically a table&#8217;s vertical lines are specified in
<literal>tabular</literal>&#8217;s <replaceable>cols</replaceable> argument and overridden as needed with
-<literal>\multicolumn</literal>.
+<literal>\multicolumn</literal> (see <link linkend="tabular">tabular</link>).
</para>
-<para>This example illustrates some pitfalls. In the first line&#8217;s second
+<para>The example below illustrates some pitfalls. In the first row&#8217;s second
entry the <literal>\hfill</literal> moves the <literal>\vline</literal> to the left edge of the
cell. But that is different than putting it halfway between the two
-columns, so in that row between the first and second columns there are
-two vertical rules, with the one from the <literal>{c|cc}</literal> specifier
-coming before the one produced by the <literal>\vline\hfill</literal>. In contrast,
-the first line&#8217;s third entry shows the usual way to put a vertical bar
-between two columns. In the second line, the <literal>ghi</literal> is the widest
-entry in its column so in the <literal>\vline\hfill</literal> the <literal>\hfill</literal> has
-no effect and the vertical line in that entry appears immediately next
-to the <literal>g</literal>, with no whitespace.
+columns, so between the first and second columns there are two vertical
+rules, with the one from the <literal>{c|cc}</literal> specifier coming before the
+one produced by the <literal>\vline\hfill</literal>. In contrast, the first row&#8217;s
+third entry shows the usual way to put a vertical bar between two
+columns. In the second row, the <literal>ghi</literal> is the widest entry in its
+column so in the <literal>\vline\hfill</literal> the <literal>\hfill</literal> has no effect and
+the vertical line in that entry appears immediately next to the
+<literal>g</literal>, with no whitespace.
</para>
<screen>\begin{tabular}{c|cc}
- x &amp;\vline\hfill y &amp;\multicolumn{1}{|r}{z} \\
- abc &amp;def &amp;\vline\hfill ghi
+ x &amp;\vline\hfill y &amp;\multicolumn{1}{|r}{z} \\ % row 1
+ abc &amp;def &amp;\vline\hfill ghi % row 2
\end{tabular}
</screen>
@@ -5122,10 +6322,10 @@ to the <literal>g</literal>, with no whitespace.
</para>
<screen>\cline{<replaceable>i</replaceable>-<replaceable>j</replaceable>}
</screen>
-<para>Draw a horizontal rule in an <literal>array</literal> or <literal>tabular</literal> environment
-beginning in column <replaceable>i</replaceable> and ending in column <replaceable>j</replaceable>. The
-dash&#160;<literal>-</literal> must appear in the mandatory argument. To span a
-single column use the number twice.
+<para>In an <literal>array</literal> or <literal>tabular</literal> environment, draw a horizontal rule
+beginning in column&#160;<replaceable>i</replaceable> and ending in column&#160;<replaceable>j</replaceable>. The
+dash, <literal>-</literal>, must appear in the mandatory argument. To span a single
+column use the number twice, as with <literal>\cline{2-2}</literal>.
</para>
<para>This example puts two horizontal lines between the first and second
rows, one line in the first column only, and the other spanning the
@@ -5144,7 +6344,7 @@ height.
<indexterm role="fn"><primary>\hline</primary></indexterm>
-<para>Draws a horizontal line the width of the enclosing <literal>tabular</literal> or
+<para>Draw a horizontal line the width of the enclosing <literal>tabular</literal> or
<literal>array</literal> environment. It&#8217;s most commonly used to draw a line at the
top, bottom, and between the rows of a table.
</para>
@@ -5173,41 +6373,57 @@ is required.
<para>Synopsis:
</para>
<screen>\begin{thebibliography}{<replaceable>widest-label</replaceable>}
-\bibitem[<replaceable>label</replaceable>]{<replaceable>cite_key}</replaceable>
-...
+ \bibitem[<replaceable>label</replaceable>]{<replaceable>cite_key}</replaceable>
+ ...
\end{thebibliography}
</screen>
-<para>The <literal>thebibliography</literal> environment produces a bibliography or
-reference list.
+<para>Produce a bibliography or reference list. There are two ways to produce
+bibliographic lists. This environment is suitable when you have only a
+few references and can maintain the list by hand. See <link linkend="Using-BibTeX">Using BibTeX</link>
+for a more sophisticated approach.
</para>
-<para>In the <literal>article</literal> class, this reference list is labelled
-&#8216;<literal>References</literal>&#8217; and the label is stored in macro <literal>\refname</literal>; in
-the <literal>report</literal> class, it is labelled &#8216;<literal>Bibliography</literal>&#8217; and the
-label is stored in macro <literal>\bibname</literal>.
+<para>This shows the environment with two entries.
</para>
-<para>You can change the label by redefining the command <literal>\refname</literal> or
-<literal>\bibname</literal>, whichever is applicable depending on the class:
-</para>
-<itemizedlist><listitem><indexterm role="fn"><primary>\bibname</primary></indexterm>
-<para>For standard classes whose top level sectioning is <literal>\chapter</literal>
-(such as <filename>book</filename> and <filename>report</filename>), the label is in the macro
-<literal>\bibname</literal>;
+<screen>This work is based on \cite{latexdps}.
+Together they are \cite{latexdps, texbook}.
+ ...
+\begin{thebibliography}{9}
+\bibitem{latexdps}
+ Leslie Lamport.
+ \textit{\LaTeX{}: a document preparation system}.
+ Addison-Wesley, Reading, Massachusetts, 1993.
+\bibitem{texbook}
+ Donald Ervin Knuth.
+ \textit{The \TeX book}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+\end{thebibliography}
+</screen>
+<para>This styles the first reference as &#8216;<literal>[1] Leslie ...</literal>&#8217;, and so that
+<literal>\cite{latexdps}</literal> produces the matching &#8216;<literal>... based on [1]</literal>&#8217;.
+The second <literal>\cite</literal> produces &#8216;<literal>[1, 2]</literal>&#8217;. You must compile the
+document twice to resolve these references.
+</para>
+<para>The mandatory argument <replaceable>widest-label</replaceable> is text that, when typeset, is
+as wide as the widest item label produced by the <literal>\bibitem</literal>
+commands. The tradition is to use <literal>9</literal> for bibliographies with less
+than 10 references, <literal>99</literal> for ones with less than 100, etc.
+</para>
+<para>The bibliographic list is headed by a title such as &#8216;<literal>Bibliography</literal>&#8217;.
+To change it there are two cases. In the <filename>book</filename> and <filename>report</filename>
+classes, where the top level sectioning is <literal>\chapter</literal> and the
+default title is &#8216;<literal>Bibliography</literal>&#8217;, that title is in the macro
+<literal>\bibname</literal>. For <filename>article</filename>, where the class&#8217;s top level
+sectioning is <literal>\section</literal> and the default is &#8216;<literal>References</literal>&#8217;, the
+title is in macro <literal>\refname</literal>. Change it by redefining the command,
+as with <literal>\renewcommand{\refname}{Cited references}</literal> after
+<literal>\begin{document}</literal>.
</para>
-</listitem><listitem><indexterm role="fn"><primary>\refname</primary></indexterm>
-<para>For standard classes whose the top level sectioning is <literal>\section</literal>
-(such as <filename>article</filename>), the label is in macro <literal>\refname</literal>.
-</para></listitem></itemizedlist>
<indexterm role="cp"><primary>package, <literal>babel</literal></primary></indexterm>
<indexterm role="cp"><primary><literal>babel</literal> package</primary></indexterm>
-<para>Typically it is neither necessary nor desirable to directly redefine
-<literal>\refname</literal> or <literal>\bibname</literal>; language support packages like
-<filename>babel</filename> do this.
-</para>
-<para>The mandatory <replaceable>widest-label</replaceable> argument is text that, when typeset,
-is as wide as the widest item label produced by the <literal>\bibitem</literal>
-commands. It is typically given as <literal>9</literal> for bibliographies with
-less than 10 references, <literal>99</literal> for ones with less than 100, etc.
+<para>Language support packages such as <filename>babel</filename> will automatically
+redefine <literal>\refname</literal> or <literal>\bibname</literal> to fit the selected
+language.
</para>
@@ -5218,21 +6434,62 @@ less than 10 references, <literal>99</literal> for ones with less than 100, etc.
<para>Synopsis:
</para>
+<screen>\bibitem{<replaceable>cite_key</replaceable>}
+</screen>
+<para>or
+</para>
<screen>\bibitem[<replaceable>label</replaceable>]{<replaceable>cite_key</replaceable>}
</screen>
-<para>The <literal>\bibitem</literal> command generates an entry labelled by <replaceable>label</replaceable>.
-If the <replaceable>label</replaceable> argument is missing, a number is automatically
-generated using the <literal>enumi</literal> counter. The <replaceable>cite_key</replaceable> is a
+<para>Generate an entry labeled by <replaceable>label</replaceable>. The default is for &latex; to
+generates a number using the <literal>enumi</literal> counter. The <firstterm>citation key</firstterm>
<indexterm role="cp"><primary>citation key</primary></indexterm>
-<firstterm>citation key</firstterm> consisting in any sequence of
-letters, numbers, and punctuation symbols not containing a comma.
+<replaceable>cite_key</replaceable> is a string of
+letters, numbers, and punctuation symbols (but not comma).
+</para>
+<para>See <link linkend="thebibliography">thebibliography</link> for an example.
+</para>
+<para>The optional <replaceable>label</replaceable> changes the default label from an integer to the
+given string. With this
+</para>
+<screen>\begin{thebibliography}
+\bibitem[Lamport 1993]{latexdps}
+ Leslie Lamport.
+ \textit{\LaTeX{}: a document preparation system}.
+ Addison-Wesley, Reading, Massachusetts, 1993.
+\bibitem{texbook}
+ Donald Ervin Knuth.
+ \textit{The \TeX book}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+\end{thebibliography}
+</screen>
+<para>the first entry will be styled as &#8216;<literal>[Lamport 1993] Leslie ...</literal>&#8217; (The
+amount of horizontal space that &latex; leaves for the label depends on
+the <replaceable>widest-label</replaceable> argument of the <literal>thebibliography</literal>
+environment; see <link linkend="thebibliography">thebibliography</link>.) Similarly, <literal>... based on
+\cite{latexdps}</literal> will produce &#8216;<literal>... based on [Lamport 1994]</literal>&#8217;.
+</para>
+<para>If you mix <literal>\bibitem</literal> entries having a <replaceable>label</replaceable> with those that
+do not then &latex; will number the unlabelled ones sequentially. In
+the example above the <literal>texbook</literal> entry will appear as &#8216;<literal>[1]
+Donald ...</literal>&#8217;, despite that it is the second entry.
+</para>
+<para>If you use the same <replaceable>cite_key</replaceable> twice then you get &#8216;<literal>LaTeX
+Warning: There were multiply-defined labels</literal>&#8217;.
+</para>
+<para>Under the hood, &latex; remembers the <replaceable>cite_key</replaceable> and <replaceable>label</replaceable>
+information because <literal>\bibitem</literal> writes it to the auxiliary file
+<filename><replaceable>filename</replaceable>.aux</filename>. For instance, the above example causes
+<literal>\bibcite{latexdps}{Lamport, 1993}</literal> and
+<literal>\bibcite{texbook}{1}</literal> to appear in that file. The <filename>.aux</filename>
+file is read by the <literal>\begin{document}</literal> command and then the
+information is available for <literal>\cite</literal> commands. This explains why
+you need to run &latex; twice to resolve references: once to write it
+out and once to read it in.
</para>
-<para>This command writes an entry to the <filename>.aux</filename> file containing the
-item&#8217;s <replaceable>cite_key</replaceable> and <replaceable>label</replaceable>. When the <filename>.aux</filename> file is
-read by the <literal>\begin{document}</literal> command, the item&#8217;s <replaceable>label</replaceable> is
-associated with <literal>cite_key</literal>, causing references to <replaceable>cite_key</replaceable>
-with a <literal>\cite</literal> command (see <link linkend="_005ccite">\cite</link>) to produce the associated
-<replaceable>label</replaceable>.
+<para>Because of this two-pass algorithm, when you add a <literal>\bibitem</literal> or
+change its <replaceable>cite_key</replaceable> you may get &#8216;<literal>LaTeX Warning: Label(s) may
+have changed. Rerun to get cross-references right</literal>&#8217;. Fix it by
+recompiling.
</para>
</sect2>
@@ -5243,16 +6500,48 @@ with a <literal>\cite</literal> command (see <link linkend="_005ccite">\cite</li
<para>Synopsis:
</para>
+<screen>\cite{<replaceable>keys</replaceable>}
+</screen>
+<para>or
+</para>
<screen>\cite[<replaceable>subcite</replaceable>]{<replaceable>keys</replaceable>}
</screen>
-<para>The <replaceable>keys</replaceable> argument is a list of one or more citation keys
-(see <link linkend="_005cbibitem">\bibitem</link>), separated by commas. This command generates an
-in-text citation to the references associated with <replaceable>keys</replaceable> by entries
-in the <filename>.aux</filename> file.
+<para>Generate as output a citation to the references associated with
+<replaceable>keys</replaceable>. The mandatory <replaceable>keys</replaceable> is a citation key, or a
+comma-separated list of citation keys (see <link linkend="_005cbibitem">\bibitem</link>).
+</para>
+<para>This
</para>
-<para>The text of the optional <replaceable>subcite</replaceable> argument appears after the
-citation. For example, <literal>\cite[p.~314]{knuth}</literal> might produce
-&#8216;<literal>[Knuth, p.&#160;314]</literal>&#8217;.
+<screen>The ultimate source is \cite{texbook}.
+ ...
+\begin{thebibliography}
+\bibitem{texbook}
+ Donald Ervin Knuth.
+ \textit{The \TeX book}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+\end{thebibliography}
+</screen>
+<para>produces the output &#8216;<literal>... source is [1]</literal>&#8217;.
+</para>
+<para>The optional argument <replaceable>subcite</replaceable> is appended to the citation. For
+example, <literal>See 14.3 in \cite[p.~314]{texbook}</literal> might produce
+&#8216;<literal>See 14.3 in [1, p.&#160;314]</literal>&#8217;.
+</para>
+<para>If <replaceable>keys</replaceable> is not in your bibliography information then you get
+&#8216;<literal>LaTeX Warning: There were undefined references</literal>&#8217;, and in the output
+the citation shows as a boldface question mark between square brackets.
+There are two possible causes. If you have mistyped something, as in
+<literal>\cite{texbok}</literal> then you need to correct the spelling. On the
+other hand, if you have just added or modified the bibliographic
+information and so changed the <filename>.aux</filename> file (see <link linkend="_005cbibitem">\bibitem</link>) then
+the fix may be to just run &latex; again.
+</para>
+<para>In addition to what appears in the output, <literal>\cite</literal> writes
+information to the auxiliary file <filename><replaceable>filename</replaceable>.aux</filename>. For
+instance, <literal>\cite{latexdps}</literal> writes &#8216;<literal>\citation{latexdps}</literal>&#8217;
+to that file. This information is used by Bib&tex; to include in your
+reference list only those works that you have actually cited; see
+<link linkend="_005cnocite">\nocite</link> also.
</para>
</sect2>
@@ -5265,8 +6554,13 @@ citation. For example, <literal>\cite[p.~314]{knuth}</literal> might produce
</para>
<screen><literal>\nocite{<replaceable>keys</replaceable>}</literal>
</screen>
-<para>The <literal>\nocite</literal> command produces no text, but writes <replaceable>keys</replaceable>,
-which is a list of one or more citation keys, to the <filename>.aux</filename> file.
+<para>Produces no output but writes <replaceable>keys</replaceable> to the auxiliary file
+<filename><replaceable>doc-filename</replaceable>.aux</filename>.
+</para>
+<para>The mandatory argument <replaceable>keys</replaceable> is a comma-separated list of one or
+more citation keys (see <link linkend="_005cbibitem">\bibitem</link>). This information is used by
+Bib&tex; to include these works in your reference list even though you
+have not cited them (see <link linkend="_005ccite">\cite</link>).
</para>
</sect2>
@@ -5279,41 +6573,62 @@ which is a list of one or more citation keys, to the <filename>.aux</filename> f
<indexterm role="fn"><primary>\bibliographystyle</primary></indexterm>
<indexterm role="fn"><primary>\bibliography</primary></indexterm>
-<para>If you use the Bib&tex; program by Oren Patashnik (highly
-recommended if you need a bibliography of more than a couple of
-titles) to maintain your bibliography, you don&#8217;t use the
-<literal>thebibliography</literal> environment (see <link linkend="thebibliography">thebibliography</link>). Instead,
-you include the lines
+<para>As described in <literal>thebibliography</literal> (see <link linkend="thebibliography">thebibliography</link>), a
+sophisticated approach to managing bibliographies is provided by the
+Bib&tex; program. This is only an introduction; see the full
+documentation on CTAN.
+</para>
+<para>With Bib&tex;, you don&#8217;t use <literal>thebibliography</literal>
+(see <link linkend="thebibliography">thebibliography</link>). Instead, include these lines.
</para>
<screen>\bibliographystyle{<replaceable>bibstyle</replaceable>}
-\bibliography{<replaceable>bibfile1</replaceable>,<replaceable>bibfile2</replaceable>}
+\bibliography{<replaceable>bibfile1</replaceable>, <replaceable>bibfile2</replaceable>, ...}
</screen>
-<para>The <literal>\bibliographystyle</literal> command does not produce any output of
-its own. Rather, it defines the style in which the bibliography will
-be produced: <replaceable>bibstyle</replaceable> refers to a file
-<replaceable>bibstyle</replaceable><filename>.bst</filename>, which defines how your citations will look.
-The standard <replaceable>bibstyle</replaceable> names distributed with Bib&tex; are:
+<para>The <replaceable>bibstyle</replaceable> refers to a file <filename><replaceable>bibstyle</replaceable>.bst</filename>, which
+defines how your citations will look. The standard <replaceable>bibstyle</replaceable>&#8217;s
+distributed with Bib&tex; are:
</para>
<variablelist><varlistentry><term><literal>alpha</literal>
-</term><listitem><para>Sorted alphabetically. Labels are formed from name of author and year of
-publication.
+</term><listitem><para>Labels are formed from name of author and year of publication.
+The bibliographic items are sorted alphabetically.
</para></listitem></varlistentry><varlistentry><term><literal>plain</literal>
-</term><listitem><para>Sorted alphabetically. Labels are numeric.
+</term><listitem><para>Labels are integers.
+Sort the bibliographic items alphabetically.
</para></listitem></varlistentry><varlistentry><term><literal>unsrt</literal>
</term><listitem><para>Like <literal>plain</literal>, but entries are in order of citation.
</para></listitem></varlistentry><varlistentry><term><literal>abbrv</literal>
</term><listitem><para>Like <literal>plain</literal>, but more compact labels.
</para></listitem></varlistentry></variablelist>
-<para>In addition, numerous other Bib&tex; style files exist tailored to
-the demands of various publications. See
+<para>Many, many other Bib&tex; style files exist,
+tailored to the demands of various publications. See CTAN&#8217;s listing
<ulink url="http://mirror.ctan.org/biblio/bibtex/contrib">http://mirror.ctan.org/biblio/bibtex/contrib</ulink>.
</para>
<para>The <literal>\bibliography</literal> command is what actually produces the
-bibliography. The argument to <literal>\bibliography</literal> refers to files
-named <filename><replaceable>bibfile1</replaceable>.bib</filename>, <filename><replaceable>bibfile2</replaceable>.bib</filename>, &#8230;,
-which should contain your database in
-Bib&tex; format. Only the entries referred to via <literal>\cite</literal> and
-<literal>\nocite</literal> will be listed in the bibliography.
+bibliography. Its argument is a comma-separated list, referring to
+files named <filename><replaceable>bibfile1</replaceable>.bib</filename>, <filename><replaceable>bibfile2</replaceable>.bib</filename>,
+&#8230; These contain your database in Bib&tex; format. This shows a
+typical couple of entries in that format.
+</para>
+<screen>@book{texbook,
+ title = {The {{\TeX}}book},
+ author = {D.E. Knuth},
+ isbn = {0201134489},
+ series = {Computers \&amp; typesetting},
+ year = {1983},
+ publisher = {Addison-Wesley}
+}
+@book{sexbook,
+ author = {W.H. Masters and V.E. Johnson},
+ title = {Human Sexual Response},
+ year = {1966},
+ publisher = {Bantam Books}
+}
+</screen>
+<para>Only the bibliographic entries referred to via <literal>\cite</literal> and
+<literal>\nocite</literal> will be listed in the document&#8217;s bibliography. Thus you
+can keep all your sources together in one file, or a small number of
+files, and rely on Bib&tex; to include in this document only those that
+you used.
</para>
</sect2>
@@ -5329,13 +6644,35 @@ Bib&tex; format. Only the entries referred to via <literal>\cite</literal> and
<para>Synopsis:
</para>
<screen>\begin{theorem}
-<replaceable>theorem-text</replaceable>
+ <replaceable>theorem body</replaceable>
\end{theorem}
</screen>
-<para>The <literal>theorem</literal> environment produces &#8220;Theorem <replaceable>n</replaceable>&#8221; in
-boldface followed by <replaceable>theorem-text</replaceable>, where the numbering
-possibilities for <replaceable>n</replaceable> are described under <literal>\newtheorem</literal>
-(see <link linkend="_005cnewtheorem">\newtheorem</link>).
+<para>Produces &#8216;<literal>Theorem <replaceable>n</replaceable></literal>&#8217; in boldface followed by <replaceable>theorem
+body</replaceable> in italics. The numbering possibilities for <replaceable>n</replaceable> are described under
+<literal>\newtheorem</literal> (see <link linkend="_005cnewtheorem">\newtheorem</link>).
+</para>
+<screen>\newtheorem{lem}{Lemma} % in preamble
+\newtheorem{thm}{Theorem}
+ ...
+\begin{lem} % in document body
+ text of lemma
+\end{lem}
+
+The next result follows immediately.
+\begin{thm}[Gauss] % put `Gauss' in parens after theorem head
+ text of theorem
+\end{thm}
+</screen>
+<indexterm role="cp"><primary>package, <literal>amsmath</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>amsmath</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>amsthm</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>amsthm</literal> package</primary></indexterm>
+
+<para>Most new documents use the packages <literal>amsthm</literal> and <literal>amsmath</literal>
+from the American Mathematical Society. Among other things these
+packages include a large number of options for theorem environments,
+such as styling options.
</para>
</sect1>
@@ -5354,14 +6691,11 @@ possibilities for <replaceable>n</replaceable> are described under <literal>\new
... text and spacing ...
\end{titlepage}
</screen>
-<para>Create a title page, a page with no printed page number or heading. The
-following page will be numbered page one.
-</para>
-<para>To instead produce a standard title page without a <literal>titlepage</literal>
-environment you can use <literal>\maketitle</literal> (see <link linkend="_005cmaketitle">\maketitle</link>).
+<para>Create a title page, a page with no printed page number or heading and
+with succeeding pages numbered starting with page one.
</para>
-<para>Notice in this example that all formatting, including vertical spacing,
-is left to the author.
+<para>In this example all formatting, including vertical spacing, is left to
+the author.
</para>
<screen>\begin{titlepage}
\vspace*{\stretch{1}}
@@ -5384,6 +6718,9 @@ is left to the author.
\vspace{\stretch{2}}
\end{titlepage}
</screen>
+<para>To instead produce a standard title page without a <literal>titlepage</literal>
+environment, use <literal>\maketitle</literal> (see <link linkend="_005cmaketitle">\maketitle</link>).
+</para>
</sect1>
<sect1 label="8.27" id="verbatim">
@@ -5404,15 +6741,52 @@ is left to the author.
<replaceable>literal-text</replaceable>
\end{verbatim}
</screen>
-<para>The <literal>verbatim</literal> environment is a paragraph-making environment in
-which &latex; produces exactly what you type in; for instance the
-<literal>\</literal> character produces a printed &#8216;<literal>\</literal>&#8217;. It turns &latex;
-into a typewriter with carriage returns and blanks having the same
-effect that they would on a typewriter.
-</para>
-<para>The <literal>verbatim</literal> environment uses a monospaced typewriter-like font
+<para>A paragraph-making environment in which &latex; produces as output
+exactly what you type as input. For instance inside <replaceable>literal-text</replaceable>
+the backslash&#160;<literal>\</literal> character does not start commands, it
+produces a printed &#8216;<literal>\</literal>&#8217;, and carriage returns and blanks are taken
+literally. The output appears in a monospaced typewriter-like font
(<literal>\tt</literal>).
</para>
+<screen>\begin{verbatim}
+Symbol swearing: %&amp;$#?!.
+\end{verbatim}
+</screen>
+<para>The only restriction on <literal>literal-text</literal> is that it cannot include
+the string <literal>\end{verbatim}</literal>.
+</para>
+<indexterm role="cp"><primary>package, <literal>cprotect</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>cprotect</literal> package</primary></indexterm>
+
+<para>You cannot use the verbatim environment in the argument to macros, for
+instance in the argument to a <literal>\section</literal>. This is not the same as
+commands being fragile (see <link linkend="_005cprotect">\protect</link>), instead it just cannot appear
+there. (But the <literal>cprotect</literal> package can help with this.)
+</para>
+<indexterm role="cp"><primary>package, <literal>listings</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>listings</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>minted</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>minted</literal> package</primary></indexterm>
+
+<para>One common use of verbatim input is to typeset computer code. There are
+packages that are an improvement the <literal>verbatim</literal> environment. For
+instance, one improvement is to allow the verbatim inclusion of external
+files, or parts of those files. Such packages include <literal>listings</literal>,
+and <literal>minted</literal>.
+</para>
+<indexterm role="cp"><primary>package, <literal>fancyvrb</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>fancyvrb</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>verbatimbox</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>verbatimbox</literal> package</primary></indexterm>
+
+<para>A package that provides many more options for verbatim environments is
+<literal>fancyvrb</literal>. Another is <literal>verbatimbox</literal>.
+</para>
+<para>For a list of all the relevant packages, see CTAN.
+</para>
+
<sect2 label="8.27.1" id="_005cverb">
<title><literal>\verb</literal></title>
@@ -5422,18 +6796,61 @@ effect that they would on a typewriter.
<para>Synopsis:
</para>
-<screen>\verb<replaceable>char</replaceable><replaceable>literal-text</replaceable><replaceable>char</replaceable>
-\verb*<replaceable>char</replaceable><replaceable>literal-text</replaceable><replaceable>char</replaceable>
+<screen>\verb <replaceable>char</replaceable> <replaceable>literal-text</replaceable> <replaceable>char</replaceable>
+\verb* <replaceable>char</replaceable> <replaceable>literal-text</replaceable> <replaceable>char</replaceable>
+</screen>
+<para>Typeset <replaceable>literal-text</replaceable> as it is input, including special characters
+and spaces, using the typewriter (<literal>\tt</literal>) font.
+</para>
+<para>This example shows two different invocations of <literal>\verb</literal>.
+</para>
+<screen>This is \verb!literally! the biggest pumpkin ever.
+And this is the best squash, \verb+literally!+
</screen>
-<para>The <literal>\verb</literal> command typesets <replaceable>literal-text</replaceable> as it is input,
-including special characters and spaces, using the typewriter
-(<literal>\tt</literal>) font. No spaces are allowed between <literal>\verb</literal> or
-<literal>\verb*</literal> and the delimiter <replaceable>char</replaceable>, which begins and ends the
-verbatim text. The delimiter must not appear in <replaceable>literal-text</replaceable>.
+<para>The first <literal>\verb</literal> has its <replaceable>literal-text</replaceable> surrounded with
+exclamation point, <literal>!</literal>. The second instead uses plus, <literal>+</literal>,
+because the exclamation point is part of <literal>literal-text</literal>.
+</para>
+<para>The single-character delimiter <replaceable>char</replaceable> surrounds
+<replaceable>literal-text</replaceable>&#160;&#8212; it must be the same character before and
+after. No spaces come between <literal>\verb</literal> or <literal>\verb*</literal> and
+<replaceable>char</replaceable>, or between <replaceable>char</replaceable> and <replaceable>literal-text</replaceable>, or between
+<replaceable>literal-text</replaceable> and the second occurrence of <replaceable>char</replaceable> (the synopsis
+shows a space only to distinguish one component from the other). The
+delimiter must not appear in <replaceable>literal-text</replaceable>. The <replaceable>literal-text</replaceable>
+cannot include a line break.
</para>
<indexterm role="cp"><primary>visible space</primary></indexterm>
-<para>The <literal>*</literal>-form differs only in that spaces are printed with a
-&#8220;visible space&#8221; character.
+<para>The <literal>*</literal>-form differs only in that spaces are printed with a visible
+space character.
+</para>
+<para>The output from this will include a character showing the spaces.
+</para>
+<screen>The commands's first argument is \verb*!filename with extension! and ...
+</screen>
+<indexterm role="cp"><primary>package, <literal>url</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>url</literal> package</primary></indexterm>
+
+<para>For typesetting Internet addresses, urls, the package <literal>url</literal>
+provides an option that is better than the <literal>\verb</literal> command, since
+it allows line breaks.
+</para>
+<indexterm role="cp"><primary>package, <literal>listings</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>listings</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>minted</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>minted</literal> package</primary></indexterm>
+
+<para>For computer code there are many packages with advantages over
+<literal>\verb</literal>. One is <filename>listings</filename>, another is <filename>minted</filename>.
+</para>
+<indexterm role="cp"><primary>package, <literal>cprotect</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>cprotect</literal> package</primary></indexterm>
+
+<para>You cannot use <literal>\verb</literal> in the argument to a macro, for instance in
+the argument to a <literal>\section</literal>. It is not a question of <literal>\verb</literal>
+being fragile (see <link linkend="_005cprotect">\protect</link>), instead it just cannot appear there.
+(But the <literal>cprotect</literal> package can help with this.)
</para>
</sect2>
@@ -5449,19 +6866,36 @@ verbatim text. The delimiter must not appear in <replaceable>literal-text</repl
<para>Synopsis:
</para>
<screen>\begin{verse}
-<replaceable>line1</replaceable> \\
-<replaceable>line2</replaceable> \\
-...
+ <replaceable>line1</replaceable> \\
+ <replaceable>line2</replaceable> \\
+ ...
\end{verse}
</screen>
-<para>The <literal>verse</literal> environment is designed for poetry, though you may find
-other uses for it.
+<para>An environment for poetry.
+</para>
+<para>Here are two lines from Shakespeare&#8217;s Romeo and Juliet.
</para>
+<screen>Then plainly know my heart's dear love is set \\
+On the fair daughter of rich Capulet.
+</screen>
<indexterm role="fn"><primary>\\ for <literal>verse</literal></primary></indexterm>
-<para>The margins are indented on the left and the right, paragraphs are not
-indented, and the text is not justified. Separate the lines of each
-stanza with <literal>\\</literal>, and use one or more blank lines to separate the
-stanzas.
+<para>Separate the lines of each stanza with <literal>\\</literal>, and use one or more
+blank lines to separate the stanzas.
+</para>
+<screen>\begin{verse}
+\makebox[\linewidth][c]{\textit{Shut Not Your Doors} ---Walt Whitman}
+ \\[1\baselineskip]
+Shut not your doors to me proud libraries, \\
+For that which was lacking on all your well-fill'd shelves, \\
+\qquad yet needed most, I bring, \\
+Forth from the war emerging, a book I have made, \\
+The words of my book nothing, the drift of it every thing, \\
+A book separate, not link'd with the rest nor felt by the intellect, \\
+But you ye untold latencies will thrill to every page.
+\end{verse}
+</screen>
+<para>The output has margins indented on the left and the right, paragraphs
+are not indented, and the text is not right-justified.
</para>
</sect1>
@@ -5480,6 +6914,12 @@ produce a printed document, this sequence must be broken into lines
<para>&latex; usually does the line (and page) breaking in the text body for
you but in some environments you manually force line breaks.
</para>
+<para>A common workflow is to get a final version of the document content
+before taking a final pass through and considering line breaks (and page
+breaks). This differs from word processing, where you are formatting
+text as you input it. Putting these off until the end prevents a lot of
+fiddling with breaks that will change anyway.
+</para>
<sect1 label="9.1" id="_005c_005c">
@@ -5489,35 +6929,71 @@ you but in some environments you manually force line breaks.
<indexterm role="cp"><primary>new line, starting</primary></indexterm>
<indexterm role="cp"><primary>line break, forcing</primary></indexterm>
-<para>Synopsis:
+<para>Synopsis, one of:
</para>
-<screen>\\[<replaceable>morespace</replaceable>]
+<screen>\\
+\\[<replaceable>morespace</replaceable>]
</screen>
-<para>or
+<para>or one of:
</para>
-<screen>\\*[<replaceable>morespace</replaceable>]
+<screen>\\*
+\\*[<replaceable>morespace</replaceable>]
</screen>
-<para>Start a new line. The optional argument <replaceable>morespace</replaceable> specifies extra
-vertical space to be insert before the next line. This can be a
-negative length. The text before the break is set at its normal length,
-that is, it is not stretched to fill out the line width.
-</para>
-<para>Explicit line breaks in the text body are unusual in &latex;. In
-particular, to start a new paragraph instead leave a blank line. This
-command is mostly used outside of the main flow of text such as in
-a <literal>tabular</literal> or <literal>array</literal> environment.
+<para>End the current line. The optional argument <replaceable>morespace</replaceable> specifies
+extra vertical space to be inserted before the next line. This is a
+rubber length (see <link linkend="Lengths">Lengths</link>) and can be negative. The text before
+the line break is set at its normal length, that is, it is not stretched
+to fill out the line width. This command is fragile (see <link linkend="_005cprotect">\protect</link>).
</para>
-<para>Under ordinary circumstances (e.g., outside of a <literal>p{...}</literal> column
-in a <literal>tabular</literal> environment) the <literal>\newline</literal> command is a synonym for
-<literal>\\</literal> (see <link linkend="_005cnewline">\newline</link>).
-</para>
-<para>In addition to starting a new line, the starred form <literal>\\*</literal> tells
-&latex; not to start a new page between the two lines, by issuing a
-<literal>\nobreak</literal>.
+<para>The starred form, <literal>\\*</literal>, tells &latex; not to start a new page
+between the two lines, by issuing a <literal>\nobreak</literal>.
</para>
<screen>\title{My story: \\[0.25in]
a tale of woe}
</screen>
+<para>Explicit line breaks in the main text body are unusual in &latex;. In
+particular, don&#8217;t start new paragraphs with <literal>\\</literal>. Instead leave a
+blank line between the two paragraphs. And don&#8217;t put in a sequence of
+<literal>\\</literal>&#8217;s to make vertical space. Instead use
+<literal>\vspace{<replaceable>length</replaceable>}</literal>, or
+<literal>\leavevmode\vspace{<replaceable>length</replaceable>}</literal>, or
+<literal>\vspace*{<replaceable>length</replaceable>}</literal> if you want the space to not be thrown
+out at the top of a new page (see <link linkend="_005cvspace">\vspace</link>).
+</para>
+<para>The <literal>\\</literal> command is mostly used outside of the main flow of text
+such as in a <literal>tabular</literal> or <literal>array</literal> environment or in an
+equation environment.
+</para>
+<para>The <literal>\\</literal> command is a synonym for <literal>\newline</literal>
+(see <link linkend="_005cnewline">\newline</link>) under ordinary circumstances (an example of an
+exception is the <literal>p{...}</literal> column in a <literal>tabular</literal>
+environment; see <link linkend="tabular">tabular</link>).
+</para>
+<!-- credit: David Carlisle https://tex.stackexchange.com/a/82666 -->
+<para>The <literal>\\</literal> command is a macro, and its definition changes by context
+so that its definition in normal text, a <literal>center</literal> environment, a
+<literal>flushleft</literal> environment, and a <literal>tabular</literal> are all different.
+In normal text when it forces a linebreak it is essentially a shorthand
+for <literal>\newline</literal>. It does not end horizontal mode or end the
+paragraph, it just inserts some glue and penalties so that when the
+paragraph does end a linebreak will occur at that point, with the short
+line padded with white space.
+</para>
+<para>You get &#8216;<literal>LaTeX Error: There's no line here to end</literal>&#8217; if you use
+<literal>\\</literal> to ask for a new line, rather than to end the current line.
+An example is if you have <literal>\begin{document}\\</literal> or, more likely,
+something like this.
+</para>
+<screen>\begin{center}
+ \begin{minipage}{0.5\textwidth}
+ \\
+ In that vertical space put your mark.
+ \end{minipage}
+\end{center}
+</screen>
+<para>Fix it by replacing the double backslash with something like
+<literal>\vspace{\baselineskip}</literal>.
+</para>
</sect1>
<sect1 label="9.2" id="_005cobeycr-_0026-_005crestorecr">
@@ -5527,12 +7003,42 @@ in a <literal>tabular</literal> environment) the <literal>\newline</literal> com
<indexterm role="fn"><primary>\restorecr</primary></indexterm>
<indexterm role="cp"><primary>new line, output as input</primary></indexterm>
-<para>The <literal>\obeycr</literal> command makes a return in the input file
-(&#8216;<literal>^^M</literal>&#8217;, internally) the same as <literal>\\</literal> (followed by
-<literal>\relax</literal>). So each new line in the input will also be a new line
-in the output.
+<para>The <literal>\obeycr</literal> command makes a return in the input file (&#8216;<literal>^^M</literal>&#8217;,
+internally) the same as <literal>\\</literal>, followed by <literal>\relax</literal>. So each
+new line in the input will also be a new line in the output. The
+<literal>\restorecr</literal> command restores normal line-breaking behavior.
+</para>
+<para>This is not the way to show verbatim text or computer code.
+See <link linkend="verbatim">verbatim</link> instead.
</para>
-<para><literal>\restorecr</literal> restores normal line-breaking behavior.
+<para>With &latex;&#8217;s usual defaults, this
+</para>
+<screen>aaa
+bbb
+
+\obeycr
+ccc
+ddd
+ eee
+
+\restorecr
+fff
+ggg
+
+hhh
+iii
+</screen>
+<para>produces output like this.
+</para>
+<screen> aaa bbb
+ ccc
+ddd
+eee
+
+fff ggg
+ hhh iii
+</screen>
+<para>The indents are paragraph indents.
</para>
</sect1>
@@ -5542,14 +7048,18 @@ in the output.
<indexterm role="fn"><primary>\newline</primary></indexterm>
<indexterm role="cp"><primary>new line, starting (paragraph mode)</primary></indexterm>
-<para>In ordinary text this is equivalent to double-backslash (see <link linkend="_005c_005c">\\</link>); it
-breaks a line, with no stretching of the text before it.
+<para>In ordinary text, this ends a line in a way that does not right-justify
+the line, so the prior text is not stretched. That is, in paragraph mode
+(see <link linkend="Modes">Modes</link>), the <literal>\newline</literal> command is equivalent to
+double-backslash (see <link linkend="_005c_005c">\\</link>). This command is fragile
+(see <link linkend="_005cprotect">\protect</link>).
</para>
-<para>Inside a <literal>tabular</literal> or <literal>array</literal> environment, in a column with a
-specifier producing a paragraph box, like typically <literal>p{...}</literal>,
-<literal>\newline</literal> will insert a line break inside of the column, that is,
-it does not break the entire row. To break the entire row use <literal>\\</literal>
-or its equivalent <literal>\tabularnewline</literal>.
+<para>However, the two commands are different inside a <literal>tabular</literal> or
+<literal>array</literal> environment. In a column with a specifier producing a
+paragraph box such as typically <literal>p{...}</literal>, <literal>\newline</literal> will
+insert a line end inside of the column; that is, it does not break the
+entire tabular row. To break the entire row use <literal>\\</literal> or its
+equivalent <literal>\tabularnewline</literal>.
</para>
<para>This will print &#8216;<literal>Name:</literal>&#8217; and &#8216;<literal>Address:</literal>&#8217; as two lines in a
single cell of the table.
@@ -5568,16 +7078,39 @@ single cell of the table.
<indexterm role="fn"><primary>\- (hyphenation)</primary></indexterm>
<indexterm role="cp"><primary>hyphenation, forcing</primary></indexterm>
-<para>The <literal>\-</literal> command tells &latex; that it may hyphenate the word at
-that point. &latex; is pretty good at hyphenating, and usually finds
-most of the correct hyphenation points, while almost never using an
-incorrect one. The <literal>\-</literal> command is used for the exceptional
-cases.
+<para>Tell &latex; that it may hyphenate the word at that point. When you
+insert <literal>\-</literal> commands in a word, the word will only be hyphenated at
+those points and not at any of the hyphenation points that &latex;
+might otherwise have chosen. This command is robust (see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>&latex; is good at hyphenating and usually finds most of the correct
+hyphenation points, while almost never using an incorrect one. The
+<literal>\-</literal> command is for exceptional cases.
+</para>
+<para>For example, &latex; does not ordinarily hyphenate words containing a
+hyphen. Below, the long and hyphenated word means &latex; has to put
+in unacceptably large spaces to set the narrow column.
+</para>
+<screen>\begin{tabular}{rp{1.75in}}
+ Isaac Asimov &amp;The strain of
+ anti-intellectualism
+ % an\-ti-in\-tel\-lec\-tu\-al\-ism
+ has been a constant thread winding its way through our
+ political and cultural life, nurtured by
+ the false notion that democracy means that
+ `my ignorance is just as good as your knowledge'.
+\end{tabular}
+</screen>
+<para>Commenting out the third line and uncommenting the fourth makes a much
+better fit.
</para>
-<para>When you insert <literal>\-</literal> commands in a word, the word will only be
-hyphenated at those points and not at any of the hyphenation points
-that &latex; might otherwise have chosen.
+<para>The <literal>\-</literal> command only allows &latex; to break there, it does not
+require that it break there. You can insist on a split with something
+like <literal>Hef-\linebreak feron</literal>. Of course, if you later change the
+text then this forced break may look very odd, so this approach requires
+care.
</para>
+
</sect1>
<sect1 label="9.5" id="_005cdiscretionary">
<title><literal>\discretionary</literal> (generalized hyphenation point)</title>
@@ -5586,39 +7119,82 @@ that &latex; might otherwise have chosen.
<para>Synopsis:
</para>
-<screen>\discretionary{<replaceable>pre-break-text</replaceable>}{<replaceable>post-break-text</replaceable>}{<replaceable>no-break-text</replaceable>}
+<screen>\discretionary{<replaceable>pre-break</replaceable>}{<replaceable>post-break</replaceable>}{<replaceable>no-break</replaceable>}
+</screen>
+<para>Handle word changes around hyphens. This command is not often used in
+&latex; documents.
+</para>
+<para>If a line break occurs at the point where <literal>\discretionary</literal> appears
+then &tex; puts <replaceable>pre-break</replaceable> at the end of the current line and puts
+<replaceable>post-break</replaceable> at the start of the next line. If there is no line
+break here then &tex; puts <replaceable>no-break</replaceable>
+</para>
+<para>In &#8216;<literal>difficult</literal>&#8217; the three letters <literal>ffi</literal> form a ligature. But
+&tex; can nonetheless break between the two f&#8217;s with this.
+</para>
+<screen>di\discretionary{f-}{fi}{ffi}cult
</screen>
-<!-- xxx TODO, complete this node, see LaTeX-fr -->
+<para>Note that users do not have to do this. It is typically handled
+automatically by &tex;&#8217;s hyphenation algorithm.
+</para>
</sect1>
-<sect1 label="9.6" id="_005cfussy">
-<title><literal>\fussy</literal></title>
+<sect1 label="9.6" id="_005cfussy-_0026-_005csloppy">
+<title><literal>\fussy</literal> &amp; <literal>\sloppy</literal></title>
<indexterm role="fn"><primary>\fussy</primary></indexterm>
+<indexterm role="fn"><primary>\sloppy</primary></indexterm>
+<indexterm role="cp"><primary>line breaks, changing</primary></indexterm>
-<para>The declaration <literal>\fussy</literal> (which is the default) makes &tex;
-picky about line breaking. This usually avoids too much space between
-words, at the cost of an occasional overfull box.
+<para>Declarations to make &tex; more picky or less picky about line
+breaking. Declaring <literal>\fussy</literal> usually avoids too much space between
+words, at the cost of an occasional overfull box. Conversely,
+<literal>\sloppy</literal> avoids overfull boxes while suffering loose interword
+spacing.
</para>
-<para>This command cancels the effect of a previous <literal>\sloppy</literal> command
-(see <link linkend="_005csloppy">\sloppy</link>).
+<para>The default is <literal>\fussy</literal>. Line breaking in a paragraph is
+controlled by whichever declaration is current at the blank line, or
+<literal>\par</literal>, or displayed equation ending that paragraph. So to affect
+the line breaks, include that paragraph-ending material in the scope of
+the command.
</para>
-</sect1>
-<sect1 label="9.7" id="_005csloppy">
-<title><literal>\sloppy</literal></title>
-<indexterm role="fn"><primary>\sloppy</primary></indexterm>
+<sect2 label="9.6.1" id="sloppypar">
+<title><literal>sloppypar</literal></title>
-<para>The declaration <literal>\sloppy</literal> makes &tex; less fussy about line
-breaking. This will avoid overfull boxes, at the cost of loose
-interword spacing.
+<indexterm role="fn"><primary>sloppypar</primary></indexterm>
+<indexterm role="cp"><primary>sloppypar environment</primary></indexterm>
+
+<para>Synopsis:
</para>
-<para>Lasts until a <literal>\fussy</literal> command is issued (see <link linkend="_005cfussy">\fussy</link>).
+<screen>\begin{sloppypar}
+ ... paragraphs ...
+\end{sloppypar}
+</screen>
+<para>Typeset the paragraphs with <literal>\sloppy</literal> in effect (see <link linkend="_005cfussy-_0026-_005csloppy">\fussy &amp;
+\sloppy</link>). Use this to locally adjust line breaking, to avoid
+&#8216;<literal>Overfull box</literal>&#8217; or &#8216;<literal>Underfull box</literal>&#8217; errors.
+</para>
+<para>The example is simple.
</para>
+<screen>\begin{sloppypar}
+ Her plan for the morning thus settled, she sat quietly down to her
+ book after breakfast, resolving to remain in the same place and the
+ same employment till the clock struck one; and from habitude very
+ little incommoded by the remarks and ejaculations of Mrs.\ Allen,
+ whose vacancy of mind and incapacity for thinking were such, that
+ as she never talked a great deal, so she could never be entirely
+ silent; and, therefore, while she sat at her work, if she lost her
+ needle or broke her thread, if she heard a carriage in the street,
+ or saw a speck upon her gown, she must observe it aloud, whether
+ there were anyone at leisure to answer her or not.
+\end{sloppypar}
+</screen>
+</sect2>
</sect1>
-<sect1 label="9.8" id="_005chyphenation">
+<sect1 label="9.7" id="_005chyphenation">
<title><literal>\hyphenation</literal></title>
<indexterm role="fn"><primary>\hyphenation</primary></indexterm>
@@ -5626,20 +7202,22 @@ interword spacing.
<para>Synopsis:
</para>
-<screen>\hyphenation{<replaceable>word-one</replaceable> <replaceable>word-two</replaceable>}
+<screen>\hyphenation{<replaceable>word1</replaceable> ...}
</screen>
-<para>The <literal>\hyphenation</literal> command declares allowed hyphenation points
-with a <literal>-</literal> character in the given words. The words are separated
-by spaces. &tex; will only hyphenate if the word matches exactly, no
-inflections are tried. Multiple <literal>\hyphenation</literal> commands
-accumulate. Some examples (the default &tex; hyphenation patterns
-misses the hyphenations in these words):
+<para>Declares allowed hyphenation points within the words in the list. The
+words in that list are separated by spaces. Show permitted points for
+hyphenation with a dash character, <literal>-</literal>.
</para>
-<screen>\hyphenation{ap-pen-dix col-umns data-base data-bases}
+<para>Here is an example:
+</para>
+<screen>\hyphenation{hat-er il-lit-e-ra-ti tru-th-i-ness}
</screen>
+<para>Use lowercase letters. &tex; will only hyphenate if the word matches
+exactly. Multiple <literal>\hyphenation</literal> commands accumulate.
+</para>
</sect1>
-<sect1 label="9.9" id="_005clinebreak-_0026-_005cnolinebreak">
+<sect1 label="9.8" id="_005clinebreak-_0026-_005cnolinebreak">
<title><literal>\linebreak</literal> &amp; <literal>\nolinebreak</literal></title>
<indexterm role="fn"><primary>\linebreak</primary></indexterm>
@@ -5647,21 +7225,37 @@ misses the hyphenations in these words):
<indexterm role="cp"><primary>line breaks, forcing</primary></indexterm>
<indexterm role="cp"><primary>line breaks, preventing</primary></indexterm>
-<para>Synopses:
+<para>Synopses, one of:
+</para>
+<screen>\linebreak
+\linebreak[<replaceable>zero-to-four</replaceable>]
+</screen>
+<para>or one of these.
</para>
-<screen>\linebreak[<replaceable>priority</replaceable>]
-\nolinebreak[<replaceable>priority</replaceable>]
+<screen>\nolinebreak
+\nolinebreak[<replaceable>zero-to-four</replaceable>]
</screen>
-<para>By default, the <literal>\linebreak</literal> (<literal>\nolinebreak</literal>) command forces
-(prevents) a line break at the current position. For
-<literal>\linebreak</literal>, the spaces in the line are stretched out so that it
-extends to the right margin as usual.
+<para>Encourage or discourage a line break. The optional <replaceable>zero-to-four</replaceable>
+is an integer that allows you to soften the instruction. The default is
+4, so that without the optional argument these commands entirely force
+or prevent the break. But for instance, <literal>\nolinebreak[1]</literal> is a
+suggestion that another place may be better. The higher the number, the
+more insistent the request. Both commands are fragile
+(see <link linkend="_005cprotect">\protect</link>).
</para>
-<para>With the optional argument <replaceable>priority</replaceable>, you can convert the command
-from a demand to a request. The <replaceable>priority</replaceable> must be a number from
-0 to&#160;4. The higher the number, the more insistent the request.
+<para>Here we tell &latex; that a good place to put a linebreak is after the
+standard legal text.
+</para>
+<screen>\boilerplatelegal{} \linebreak[2]
+We especially encourage applications from members of traditionally
+underrepresented groups.
+</screen>
+<para>When you issue <literal>\linebreak</literal>, the spaces in the line are stretched
+out so that it extends to the right margin. See <link linkend="_005c_005c">\\</link>
+and&#160;<link linkend="_005cnewline">\newline</link> to have the spaces not stretched out.
</para>
+
</sect1>
</chapter>
<chapter label="10" id="Page-breaking">
@@ -5670,72 +7264,160 @@ from a demand to a request. The <replaceable>priority</replaceable> must be a n
<indexterm role="cp"><primary>page breaking</primary></indexterm>
<indexterm role="cp"><primary>breaking pages</primary></indexterm>
-<para>&latex; starts new pages asynchronously, when enough material has
-accumulated to fill up a page. Usually this happens automatically,
-but sometimes you may want to influence the breaks.
-</para>
-
-
-<sect1 label="10.1" id="_005ccleardoublepage">
-<title><literal>\cleardoublepage</literal></title>
-
-<indexterm role="fn"><primary>\cleardoublepage</primary></indexterm>
-<indexterm role="cp"><primary>starting on a right-hand page</primary></indexterm>
-
-<para>The <literal>\cleardoublepage</literal> command ends the current page and causes all
-the pending floating figures and tables that have so far appeared in the
-input to be printed. In a two-sided printing style, it also makes the
-next page a right-hand (odd-numbered) page, producing a blank page if
-necessary.
-</para>
-
-</sect1>
-<sect1 label="10.2" id="_005cclearpage">
-<title><literal>\clearpage</literal></title>
+<para>Ordinarily &latex; automatically takes care of breaking output into
+pages with its usual aplomb. But if you are writing commands, or
+tweaking the final version of a document, then you may need to
+understand how to influence its actions.
+</para>
+<!-- credit: H Vogt https://tex.stackexchange.com/a/115563 -->
+<para>&latex;&#8217;s algorithm for splitting a document into pages is more complex
+than just waiting until there is enough material to fill a page and
+outputting the result. Instead, &latex; typesets more material than
+would fit on the page and then chooses a break that is optimal in some
+way (it has the smallest badness). An example of the advantage of this
+approach is that if the page has some vertical space that can be
+stretched or shrunk, such as with rubber lengths between paragraphs,
+then &latex; can use that to avoid widow lines (where a new page starts
+with the last line of a paragraph; &latex; can squeeze the extra line
+onto the first page) and orphans (where the first line of paragraph is
+at the end of a page; &latex; can stretch the material of the first
+page so the extra line falls on the second page). Another example is
+where &latex; uses available vertical shrinkage to fit on a page not
+just the header for a new section but also the first two lines of that
+section.
+</para>
+<para>But &latex; does not optimize over the entire document&#8217;s set of page
+breaks. So it can happen that the first page break is great but the
+second one is lousy; to break the current page &latex; doesn&#8217;t look as
+far ahead as the next page break. So occasionally you may want to
+influence page breaks while preparing a final version of a document.
+</para>
+<para>See <link linkend="Layout">Layout</link> for more material that is relevant to page breaking.
+</para>
+
+
+<sect1 label="10.1" id="_005cclearpage-_0026-_005ccleardoublepage">
+<title><literal>\clearpage</literal> &amp; <literal>\cleardoublepage</literal></title>
<indexterm role="fn"><primary>\clearpage</primary></indexterm>
<indexterm role="cp"><primary>flushing floats and starting a page</primary></indexterm>
<indexterm role="cp"><primary>starting a new page and clearing floats</primary></indexterm>
+<indexterm role="fn"><primary>\cleardoublepage</primary></indexterm>
+<indexterm role="cp"><primary>starting on a right-hand page</primary></indexterm>
-<para>The <literal>\clearpage</literal> command ends the current page and causes all the
-pending floating figures and tables that have so far appeared in the
-input to be printed.
+<para>Synopsis:
</para>
+<screen>\clearpage
+</screen>
+<para>or
+</para>
+<screen>\cleardoublepage
+</screen>
+<para>End the current page and output all of the pending floating figures and
+tables (see <link linkend="Floats">Floats</link>). If there are too many floats to fit on the
+page then &latex; will put in extra pages containing only floats. In
+two-sided printing, <literal>\cleardoublepage</literal> also makes the next page of
+content a right-hand page, an odd-numbered page, if necessary inserting
+a blank page. The <literal>\clearpage</literal> command is robust while
+<literal>\cleardoublepage</literal> is fragile (see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>&latex;&#8217;s page breaks are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+</para>
+<!-- credit: https://www.tex.ac.uk/FAQ-reallyblank.html -->
+<para>The <literal>\cleardoublepage</literal> command will put in a blank page, but it
+will have the running headers and footers. To get a really blank
+page, use this command.
+</para>
+<screen>\let\origdoublepage\cleardoublepage
+\newcommand{\clearemptydoublepage}{%
+ \clearpage
+ {\pagestyle{empty}\origdoublepage}%
+}
+</screen>
+<para>If you want &latex;&#8217;s standard <literal>\chapter</literal> command to do this then
+add the line <literal>\let\cleardoublepage\clearemptydoublepage</literal>.
+</para>
+<para>The command <literal>\newpage</literal> (see <link linkend="_005cnewpage">\newpage</link>) also ends the current
+page, but without clearing pending floats. And, if &latex; is in
+two-column mode then <literal>\newpage</literal> ends the current column while
+<literal>\clearpage</literal> and <literal>\cleardoublepage</literal> end the current page.
+</para>
+
</sect1>
-<sect1 label="10.3" id="_005cnewpage">
+<sect1 label="10.2" id="_005cnewpage">
<title><literal>\newpage</literal></title>
<indexterm role="fn"><primary>\newpage</primary></indexterm>
<indexterm role="cp"><primary>new page, starting</primary></indexterm>
<indexterm role="cp"><primary>starting a new page</primary></indexterm>
-<para>The <literal>\newpage</literal> command ends the current page, but does not clear
-floats (see <link linkend="_005cclearpage">\clearpage</link>).
+<para>Synopsis:
+</para>
+<screen>\newpage
+</screen>
+<para>End the current page. This command is robust (see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>&latex;&#8217;s page breaks are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+</para>
+<para>While the commands <literal>\clearpage</literal> and <literal>\cleardoublepage</literal> also
+end the current page, in addition they clear pending floats
+(see <link linkend="_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</link>). And, if &latex; is in
+two-column mode then <literal>\clearpage</literal> and <literal>\cleardoublepage</literal> end
+the current page, possibly leaving an empty column, while
+<literal>\newpage</literal> only ends the current column.
+</para>
+<para>In contrast with <literal>\pagebreak</literal> (see <link linkend="_005cpagebreak-_0026-_005cnopagebreak">\pagebreak &amp; \nopagebreak</link>),
+the <literal>\newpage</literal> command will cause the new page to start right where
+requested. This
+</para>
+<screen>Four score and seven years ago our fathers brought forth on this
+continent,
+\newpage
+\noindent a new nation, conceived in Liberty, and dedicated to the
+proposition that all men are created equal.
+</screen>
+<para>makes a new page start after &#8216;<literal>continent,</literal>&#8217; and the cut-off line is
+not right justified. In addition, <literal>\newpage</literal> does not vertically
+stretch out the page, as <literal>\pagebreak</literal> does.
</para>
</sect1>
-<sect1 label="10.4" id="_005cenlargethispage">
+<sect1 label="10.3" id="_005cenlargethispage">
<title><literal>\enlargethispage</literal></title>
<indexterm role="fn"><primary>\enlargethispage</primary></indexterm>
<indexterm role="cp"><primary>enlarge current page</primary></indexterm>
-<para><literal>\enlargethispage{size}</literal>
+<para>Synopsis, one of:
</para>
-<para><literal>\enlargethispage*{size}</literal>
+<screen>\enlargethispage{size}
+\enlargethispage*{size}
+</screen>
+<para>Enlarge the <literal>\textheight</literal> for the current page. The required
+argument <replaceable>size</replaceable> must be a rigid length (see <link linkend="Lengths">Lengths</link>). It may be
+positive or negative. This command is fragile (see <link linkend="_005cprotect">\protect</link>).
</para>
-<para>Enlarge the <literal>\textheight</literal> for the current page by the specified
-amount; e.g., <literal>\enlargethispage{\baselineskip}</literal> will allow one
-additional line.
+<para>A common strategy is to wait until you have the final text of a
+document, and then pass through it tweaking line and page breaks. This
+command allows you some page size leeway.
</para>
-<para>The starred form tries to squeeze the material together on the page as
-much as possible. This is normally used together with an explicit
-<literal>\pagebreak</literal>.
+<para>This will allow one extra line on the current page.
+</para>
+<screen>\enlargethispage{\baselineskip}
+</screen>
+<para>The starred form <literal>\enlargesthispage*</literal> tries to squeeze the material
+together on the page as much as possible, for the common use case of
+getting one more line on the page. This is often used together with an
+explicit <literal>\pagebreak</literal>.
</para>
</sect1>
-<sect1 label="10.5" id="_005cpagebreak-_0026-_005cnopagebreak">
+<sect1 label="10.4" id="_005cpagebreak-_0026-_005cnopagebreak">
<title><literal>\pagebreak</literal> &amp; <literal>\nopagebreak</literal></title>
<indexterm role="fn"><primary>\pagebreak</primary></indexterm>
@@ -5745,18 +7427,43 @@ much as possible. This is normally used together with an explicit
<para>Synopses:
</para>
-<screen>\pagebreak[<replaceable>priority</replaceable>]
-\nopagebreak[<replaceable>priority</replaceable>]
+<screen>\pagebreak
+\pagebreak[<replaceable>zero-to-four</replaceable>]
</screen>
-<para>By default, the <literal>\pagebreak</literal> (<literal>\nopagebreak</literal>) command forces
-(prevents) a page break at the current position. With
-<literal>\pagebreak</literal>, the vertical space on the page is stretched out
-where possible so that it extends to the normal bottom margin.
+<para>or
</para>
-<para>With the optional argument <replaceable>priority</replaceable>, you can convert the
-<literal>\pagebreak</literal> command from a demand to a request. The number must
-be a number from 0 to&#160;4. The higher the number, the more
-insistent the request is.
+<screen>\nopagebreak
+\nopagebreak[<replaceable>zero-to-four</replaceable>]
+</screen>
+<para>Encourage or discourage a page break. The optional <replaceable>zero-to-four</replaceable>
+is an integer that allows you to soften the request. The default is 4,
+so that without the optional argument these commands entirely force or
+prevent the break. But for instance <literal>\nopagebreak[1]</literal> suggests to
+&latex; that another spot might be preferable. The higher the number,
+the more insistent the request. Both commands are fragile
+(see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>&latex;&#8217;s page endings are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+</para>
+<para>If you use these inside a paragraph, they apply to the point following
+the line in which they appear. So this
+</para>
+<screen>Four score and seven years ago our fathers brought forth on this
+continent,
+\pagebreak
+a new nation, conceived in Liberty, and dedicated to the proposition
+that all men are created equal.
+</screen>
+<para>does not give a page break at &#8216;<literal>continent,</literal>&#8217; but instead at
+&#8216;<literal>nation,</literal>&#8217; since that is where &latex; breaks that line. In
+addition, with <literal>\pagebreak</literal> the vertical space on the page is
+stretched out where possible so that it extends to the normal bottom
+margin. This can look strange, and if <literal>\flushbottom</literal> is in effect
+this can cause you to get &#8216;<literal>Underfull \vbox (badness 10000) has
+occurred while \output is active</literal>&#8217;. See <link linkend="_005cnewpage">\newpage</link> for a command that
+does not have these effects.
</para>
</sect1>
@@ -5766,21 +7473,22 @@ insistent the request is.
<indexterm role="cp"><primary>footnotes, creating</primary></indexterm>
-<para>Place a numbered footnote at the bottom of the current page, as here.
+<para>Place a footnote at the bottom of the current page, as here.
</para>
<screen>No&#235;l Coward quipped that having to read a footnote is like having
to go downstairs to answer the door, while in the midst of making
-love.\footnote{I wouldn't know, I don't read footnotes.}
+love.\footnote{%
+ I wouldn't know, I don't read footnotes.}
</screen>
-<para>You can place multiple footnotes on a page. If the text becomes too long
-it will flow to the next page.
+<para>You can put multiple footnotes on a page. If the footnote text becomes
+too long then it will flow to the next page.
</para>
<para>You can also produce footnotes by combining the <literal>\footnotemark</literal> and
the <literal>\footnotetext</literal> commands, which is useful in special
circumstances.
</para>
<para>To make bibliographic references come out as footnotes you need to
-include a bibliographic style with that behavior.
+include a bibliographic style with that behavior (see <link linkend="Using-BibTeX">Using BibTeX</link>).
</para>
@@ -5789,47 +7497,77 @@ include a bibliographic style with that behavior.
<indexterm role="fn"><primary>\footnote</primary></indexterm>
-<para>Synopsis:
+<para>Synopsis, one of:
</para>
-<screen>\footnote[<replaceable>number</replaceable>]{<replaceable>text</replaceable>}
+<screen>\footnote{<replaceable>text</replaceable>}
+\footnote[<replaceable>number</replaceable>]{<replaceable>text</replaceable>}
</screen>
-<para>Place a numbered footnote <replaceable>text</replaceable> at the bottom of the current page.
+<para>Place a footnote <replaceable>text</replaceable> at the bottom of the current page.
</para>
<screen>There are over a thousand footnotes in Gibbon's
-\textit{Decline and Fall of the Roman Empire}.\footnote{After
-reading an early version with endnotes David Hume complained,
-``One is also plagued with his Notes, according to the present Method
-of printing the Book'' and suggested that they ``only to be printed
-at the Margin or the Bottom of the Page.''}
+\textit{Decline and Fall of the Roman Empire}.\footnote{%
+ After reading an early version with endnotes David Hume complained,
+ ``One is also plagued with his Notes, according to the present Method
+ of printing the Book'' and suggested that they ``only to be printed
+ at the Margin or the Bottom of the Page.''}
</screen>
-<para>The optional argument <replaceable>number</replaceable> allows you to specify the footnote
-number. If you use this option then the footnote number counter is not
-incremented, and if you do not use it then the counter is incremented.
+<para>The optional argument <replaceable>number</replaceable> allows you to specify the number of
+the footnote. If you use this then &latex; does not increment the
+<literal>footnote</literal> counter.
</para>
<indexterm role="cp"><primary>footnotes, symbols instead of numbers</primary></indexterm>
<indexterm role="fn"><primary>\fnsymbol, and footnotes</primary></indexterm>
<indexterm role="fn"><primary>\@fnsymbol</primary></indexterm>
-<para>Change how &latex; shows the footnote counter with something like
+<para>By default, &latex; uses arabic numbers as footnote markers. Change
+this with something like
<literal>\renewcommand{\thefootnote}{\fnsymbol{footnote}}</literal>, which
uses a sequence of symbols (see <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman
\fnsymbol</link>). To make this change global put that in the preamble. If
you make the change local then you may want to reset the counter with
-<literal>\setcounter{footnote}{0}</literal>. By default &latex; uses arabic
-numbers.
+<literal>\setcounter{footnote}{0}</literal>.
+</para>
+<para>&latex; determines the spacing of footnotes with two parameters.
+</para>
+<indexterm role="cp"><primary>footnote parameters</primary></indexterm>
+<indexterm role="cp"><primary>parameters, for footnotes</primary></indexterm>
+
+<variablelist><varlistentry><term><indexterm role="fn"><primary>\footnoterule</primary></indexterm><literal>\footnoterule</literal>
+</term><listitem><anchor id="footnote-footnoterule"/><para>Produces the rule separating the main text on a page from the page&#8217;s
+footnotes. Default dimensions in the standard document classes (except
+<literal>slides</literal>, where it does not appear) is: vertical thickness of
+<literal>0.4pt</literal>, and horizontal size of <literal>0.4\columnwidth</literal> long.
+Change the rule with something like this.
+</para>
+<!-- Credit egreg: https://tex.stackexchange.com/a/21917 -->
+<screen>\renewcommand{\footnoterule}{% Kerns avoid vertical space
+ \kern -3pt % This -3 is negative
+ \hrule width \textwidth height 1pt % of the sum of this 1
+ \kern 2pt} % and this 2
+</screen>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\footnotesep</primary></indexterm><literal>\footnotesep</literal>
+</term><listitem><anchor id="footnote-footnotesep"/><para>The height of the strut placed at the beginning of the footnote
+(see <link linkend="_005cstrut">\strut</link>). By default, this is set to the normal strut for
+<literal>\footnotesize</literal> fonts (see <link linkend="Font-sizes">Font sizes</link>), therefore there is no
+extra space between footnotes. This is &#8216;<literal>6.65pt</literal>&#8217; for &#8216;<literal>10pt</literal>&#8217;,
+&#8216;<literal>7.7pt</literal>&#8217; for &#8216;<literal>11pt</literal>&#8217;, and &#8216;<literal>8.4pt</literal>&#8217; for &#8216;<literal>12pt</literal>&#8217;. Change
+it as with <literal>\setlength{\footnotesep}{11pt}</literal>.
+</para>
+</listitem></varlistentry></variablelist>
+<para>The <literal>\footnote</literal> command is fragile (see <link linkend="_005cprotect">\protect</link>).
</para>
<para>&latex;&#8217;s default puts many restrictions on where you can use a
<literal>\footnote</literal>; for instance, you cannot use it in an argument to a
sectioning command such as <literal>\chapter</literal> (it can only be used in outer
-paragraph mode). There are some workarounds; see following sections.
-<!-- xx mention packages that fix this -->
+paragraph mode; see <link linkend="Modes">Modes</link>). There are some workarounds; see
+following sections.
</para>
<indexterm role="cp"><primary>Footnotes, in a minipage</primary></indexterm>
<indexterm role="cp"><primary>mpfootnote counter</primary></indexterm>
-<para>In a <literal>minipage</literal> environment the <literal>\footnote</literal>
-command uses the <literal>mpfootnote</literal> counter instead of the
-<literal>footnote</literal> counter, so they are numbered independently. They are
-shown at the bottom of the environment, not at the bottom of the page.
-And by default they are shown alphabetically. See <link linkend="minipage">minipage</link>.
+<para>In a <literal>minipage</literal> environment the <literal>\footnote</literal> command uses the
+<literal>mpfootnote</literal> counter instead of the <literal>footnote</literal> counter, so
+they are numbered independently. They are shown at the bottom of the
+environment, not at the bottom of the page. And by default they are
+shown alphabetically. See <link linkend="minipage">minipage</link> and <link linkend="Footnotes-in-a-table">Footnotes in a table</link>.
</para>
</sect1>
@@ -5843,14 +7581,25 @@ And by default they are shown alphabetically. See <link linkend="minipage">minip
<screen>\footnotemark
\footnotemark[<replaceable>number</replaceable>]
</screen>
-<para>Put the current footnote number in the
-text. (See&#160;<link linkend="_005cfootnotetext">\footnotetext</link> for giving the text of the footnote
-separately.) The version with the optional argument <replaceable>number</replaceable> uses
-that number to determine the mark printed. This command can be used in
-inner paragraph mode.
+<para>Put the current footnote mark in the text. To specify associated text
+for the footnote see&#160;<link linkend="_005cfootnotetext">\footnotetext</link>. The optional argument
+<replaceable>number</replaceable> causes the command to use that number to determine the
+footnote mark. This command can be used in inner paragraph mode
+(see <link linkend="Modes">Modes</link>).
</para>
-<para>This example gives the same institutional affiliation to both the first
-and third authors (<literal>\thanks</literal> is a version of <literal>footnote</literal>).
+<para>If you use <literal>\footnotemark</literal> without the optional argument then it
+increments the footnote counter but if you use the optional <replaceable>number</replaceable>
+then it does not. The next example produces several consecutive footnote
+markers referring to the same footnote.
+</para>
+<screen>The first theorem\footnote{Due to Gauss.}
+and the second theorem\footnotemark[\value{footnote}]
+and the third theorem.\footnotemark[\value{footnote}]
+</screen>
+<para>If there are intervening footnotes then you must remember the value of the
+common mark. This example gives the same institutional affiliation to
+both the first and third authors (<literal>\thanks</literal> is a version of
+<literal>footnote</literal>), by-hand giving the number of the footnote.
</para>
<screen>\title{A Treatise on the Binomial Theorem}
\author{J Moriarty\thanks{University of Leeds}
@@ -5859,15 +7608,38 @@ and third authors (<literal>\thanks</literal> is a version of <literal>footnote<
\begin{document}
\maketitle
</screen>
-<para>If you use <literal>\footnotemark</literal> without the optional argument then it
-increments the footnote counter but if you use the optional <replaceable>number</replaceable>
-then it does not. This produces several consecutive footnote markers
-referring to the same footnote.
+<para>This uses a counter to remember the footnote number. The third sentence
+is followed by the same footnote marker as the first.
</para>
-<screen>The first theorem\footnote{Due to Gauss.}
-and the second theorem\footnotemark[\value{footnote}]
-and the third theorem.\footnotemark[\value{footnote}]
+<screen>\newcounter{footnoteValueSaver}
+All babies are illogical.\footnote{%
+ Lewis Carroll.}\setcounter{footnoteValueSaver}{\value{footnote}}
+Nobody is despised who can manage a crocodile.\footnote{%
+ Captain Hook.}
+Illogical persons are despised.\footnotemark[\value{footnoteValueSaver}]
+Therefore, anyone who can manage a crocodile is not a baby.
</screen>
+<indexterm role="cp"><primary>package, <literal>cleveref</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>cleveref</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>hyperref</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>hyperref</literal> package</primary></indexterm>
+
+<para>This example accomplishes the same by using the package <filename>cleveref</filename>.
+</para>
+<!-- from SE user Jake http://tex.stackexchange.com/a/10116/339 -->
+<screen>\usepackage{cleveref}[2012/02/15] % in preamble
+\crefformat{footnote}{#2\footnotemark[#1]#3}
+...
+The theorem is from Evers.\footnote{\label{fn:TE}Tinker, Evers, 1994.}
+The corollary is from Chance.\footnote{Evers, Chance, 1990.}
+But the key lemma is from Tinker.\cref{fn:TE}
+</screen>
+<indexterm role="cp"><primary>package, <literal>hyperref</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>hyperref</literal> package</primary></indexterm>
+
+<para>It will work with the package <filename>hyperref</filename>.
+</para>
</sect1>
<sect1 label="11.3" id="_005cfootnotetext">
@@ -5880,156 +7652,136 @@ and the third theorem.\footnotemark[\value{footnote}]
<screen>\footnotetext{<replaceable>text</replaceable>}
\footnotetext[<replaceable>number</replaceable>]{<replaceable>text</replaceable>}
</screen>
-<para>Place <replaceable>text</replaceable> at the bottom of the page as a footnote. This command
-can come anywhere after the <literal>\footnotemark</literal> command. The optional
-argument <replaceable>number</replaceable> changes the displayed footnote number. The
-<literal>\footnotetext</literal> command must appear in outer paragraph mode.
+<para>Place <replaceable>text</replaceable> at the bottom of the page as a footnote. It pairs with
+<literal>\footnotemark</literal> (see <link linkend="_005cfootnotemark">\footnotemark</link>) and can come anywhere after
+that command, but must appear in outer paragraph mode (see <link linkend="Modes">Modes</link>).
+The optional argument <replaceable>number</replaceable> changes the number of the footnote
+mark.
+</para>
+<para>See <link linkend="_005cfootnotemark">\footnotemark</link> and&#160;<link linkend="Footnotes-in-a-table">Footnotes in a table</link> for usage
+examples.
+</para>
+
+</sect1>
+<sect1 label="11.4" id="Footnotes-in-section-headings">
+<title>Footnotes in section headings</title>
+
+<indexterm role="cp"><primary>footnote, in section headings</primary></indexterm>
+<indexterm role="cp"><primary>table of contents, avoiding footnotes</primary></indexterm>
+
+<para>Putting a footnote in a section heading, as in:
+</para>
+<screen>\section{Full sets\protect\footnote{This material due to ...}}
+</screen>
+<para>causes the footnote to appear at the bottom of the page where the
+section starts, as usual, but also at the bottom of the table of
+contents, where it is not likely to be desired. The simplest way
+to have it not appear on the table of contents is to use the optional
+argument to <literal>\section</literal>
+</para>
+<screen>\section[Please]{Please\footnote{%
+ Don't footnote in chapter and section headers!}}
+</screen>
+<para>No <literal>\protect</literal> is needed in front of <literal>\footnote</literal> here because
+what gets moved to the table of contents is the optional argument.
</para>
</sect1>
-<sect1 label="11.4" id="Footnotes-in-a-table">
+<sect1 label="11.5" id="Footnotes-in-a-table">
<title>Footnotes in a table</title>
-<indexterm role="cp"><primary>Footnotes, in a table</primary></indexterm>
+<indexterm role="cp"><primary>footnote, in a table</primary></indexterm>
-<para>Inside a <literal>table</literal> environment the <literal>\footnote</literal> command does not
-work. For instance, if the code below appears on its own then the
-footnote simply disappears; there is a footnote mark in the table cell
-but nothing is set at the bottom of the page.
+<para>Inside a <literal>tabular</literal> or <literal>array</literal> environment the <literal>\footnote</literal>
+command does not work; there is a footnote mark in the table cell but
+the footnote text does not appear. The solution is to use a
+<literal>minipage</literal> environment as here (see <link linkend="minipage">minipage</link>).
</para>
<screen>\begin{center}
+ \begin{minipage}{\textwidth} \centering
\begin{tabular}{l|l}
- \textsc{Ship} &amp;\textsc{Book} \\ \hline
- \textit{HMS Sophie} &amp;Master and Commander \\
- \textit{HMS Polychrest} &amp;Post Captain \\
- \textit{HMS Lively} &amp;Post Captain \\
- \textit{HMS Surprise} &amp;A number of books\footnote{Starting with
- HMS Surprise.}
+ \textsc{Ship} &amp;\textsc{Book} \\ \hline
+ \textit{HMS Sophie} &amp;Master and Commander \\
+ \textit{HMS Polychrest} &amp;Post Captain \\
+ \textit{HMS Lively} &amp;Post Captain \\
+ \textit{HMS Surprise} &amp;A number of books\footnote{%
+ Starting with HMS Surprise.}
\end{tabular}
+ \end{minipage}
\end{center}
</screen>
-<para>The solution is to surround the <literal>tabular</literal> environment with a
-<literal>minipage</literal> environment, as here (see <link linkend="minipage">minipage</link>).
+<para>Inside a <literal>minipage</literal>, footnote marks are lowercase letters. Change
+that with something like
+<literal>\renewcommand{\thempfootnote}{\arabic{mpfootnote}}</literal>
+(see <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</link>).
</para>
-<screen>\begin{center}
- \begin{minipage}{.5\textwidth}
- ... tabular material ...
- \end{minipage}
+<para>The footnotes in the prior example appear at the bottom of the
+<literal>minipage</literal>. To have them appear at the bottom of the main page, as
+part of the regular footnote sequence, use the <literal>\footnotemark</literal> and
+<literal>\footnotetext</literal> pair and make a new counter.
+</para>
+<screen>\newcounter{mpFootnoteValueSaver}
+\begin{center}
+ \begin{minipage}{\textwidth}
+ \setcounter{mpFootnoteValueSaver}{\value{footnote}} \centering
+ \begin{tabular}{l|l}
+ \textsc{Woman} &amp;\textsc{Relationship} \\ \hline
+ Mona &amp;Attached\footnotemark \\
+ Diana Villiers &amp;Eventual wife \\
+ Christine Hatherleigh Wood &amp;Fiance\footnotemark
+ \end{tabular}
+ \end{minipage}% percent sign keeps footnote text close to minipage
+ \stepcounter{mpFootnoteValueSaver}%
+ \footnotetext[\value{mpFootnoteValueSaver}]{%
+ Little is known other than her death.}%
+ \stepcounter{mpFootnoteValueSaver}%
+ \footnotetext[\value{mpFootnoteValueSaver}]{%
+ Relationship is unresolved in XXI.}
\end{center}
</screen>
-<para>The same technique will work inside a floating <literal>table</literal> environment
-(see <link linkend="table">table</link>). To get the footnote at the bottom of the page use the
-<filename>tablefootnote</filename> package, as illustrated in this example. If you
-put <literal>\usepackage{tablefootnote}</literal> in the preamble and use the code
-shown then the footnote appears at the bottom and is numbered in
-sequence with other footnotes.
+<para>For a floating <literal>table</literal> environment (see <link linkend="table">table</link>), use the
+<filename>tablefootnote</filename> package.
</para>
-<screen>\begin{table}
+<screen>\usepackage{tablefootnote} % in preamble
+ ...
+\begin{table}
\centering
\begin{tabular}{l|l}
\textsc{Date} &amp;\textsc{Campaign} \\ \hline
1862 &amp;Fort Donelson \\
1863 &amp;Vicksburg \\
- 1865 &amp;Army of Northern Virginia\footnote{Ending the war.}
+ 1865 &amp;Army of Northern Virginia\tablefootnote{%
+ Ending the war.}
\end{tabular}
\caption{Forces captured by US Grant}
\end{table}
</screen>
-
-</sect1>
-<sect1 label="11.5" id="Footnotes-in-section-headings">
-<title>Footnotes in section headings</title>
-
-<indexterm role="cp"><primary>footnotes, in section headings</primary></indexterm>
-<indexterm role="cp"><primary>table of contents, avoiding footnotes</primary></indexterm>
-<para>Putting a footnote in a section heading, as in:
-</para>
-<screen>\section{Full sets\protect\footnote{This material due to ...}}
-</screen>
-<indexterm role="cp"><primary>package, <literal>footmisc</literal></primary></indexterm>
-<indexterm role="cp"><primary><literal>footmisc</literal> package</primary></indexterm>
-
-<indexterm role="cp"><primary><literal>stable</literal> option to <literal>footmisc</literal> package</primary></indexterm>
-<para>causes the footnote to appear at the bottom of the page where the
-section starts, as usual, but also at the bottom of the table of
-contents, where it is not likely to be desired. To have it not appear
-on the table of contents use the package <filename>footmisc</filename> with the
-<literal>stable</literal> option.
-</para>
-<screen>\usepackage[stable]{footmisc}
-...
-\begin{document}
-...
-\section{Full sets\footnote{This material due to ...}}
-</screen>
-<para>Note that the <literal>\protect</literal> is gone; including it would cause the
-footnote to reappear on the table of contents.
+<para>The footnote appears at the page bottom and is numbered in sequence with
+other footnotes.
</para>
</sect1>
<sect1 label="11.6" id="Footnotes-of-footnotes">
<title>Footnotes of footnotes</title>
+<indexterm role="cp"><primary>footnote, of a footnote</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>bigfoot</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>bigfoot</literal> package</primary></indexterm>
+
<para>Particularly in the humanities, authors can have multiple classes of
footnotes, including having footnotes of footnotes. The package
<filename>bigfoot</filename> extends &latex;&#8217;s default footnote mechanism in many
ways, including allow these two, as in this example.
</para>
-<screen>\usepackage{bigfoot}
+<screen>\usepackage{bigfoot} % in preamble
\DeclareNewFootnote{Default}
\DeclareNewFootnote{from}[alph] % create class \footnotefrom{}
...
-\begin{document}
-...
The third theorem is a partial converse of the
-second.\footnotefrom{First noted in Wilson.\footnote{Second edition only.}}
-...
-</screen>
-
-</sect1>
-<sect1 label="11.7" id="Multiple-reference-to-footnotes">
-<title>Multiple references to footnotes</title>
-
-<para>You can refer to a single footnote more than once. This example
-uses the package <filename>cleverref</filename>.
-</para>
-<!-- from SE user Jake http://tex.stackexchange.com/a/10116/339 -->
-<screen>\usepackage{cleveref}[2012/02/15] % this version of package or later
-\crefformat{footnote}{#2\footnotemark[#1]#3}
-...
-\begin{document}
-...
-The theorem is from Evers.\footnote{\label{fn:TE}Tinker and Evers, 1994.}
-The corollary is from Chance.\footnote{Evers and Chance, 1990.}
-But the key lemma is from Tinker.\cref{fn:TE}
-...
+second.\footnotefrom{%
+ First noted in Wilson.\footnote{Second edition only.}}
</screen>
-<para>This solution will work with the package <filename>hyperref</filename>.
-See&#160;<link linkend="_005cfootnotemark">\footnotemark</link> for a simpler solution in the common case
-of multiple authors with the same affiliation.
-</para>
-
-</sect1>
-<sect1 label="11.8" id="Footnote-parameters">
-<title>Footnote parameters</title>
-
-<indexterm role="cp"><primary>footnote parameters</primary></indexterm>
-<indexterm role="cp"><primary>parameters, for footnotes</primary></indexterm>
-
-<variablelist><varlistentry><term><indexterm role="fn"><primary>\footnoterule</primary></indexterm><literal>\footnoterule</literal>
-</term><listitem><para>Produces the rule separating the main text on a page from the page&#8217;s
-footnotes. Default dimensions: <literal>0.4pt</literal> thick (or wide), and
-<literal>0.4\columnwidth</literal> long in the standard document classes (except
-<literal>slides</literal>, where it does not appear).
-</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\footnotesep</primary></indexterm><literal>\footnotesep</literal>
-</term><listitem><para>The height of the strut placed at the beginning of the footnote. By
-default, this is set to the normal strut for <literal>\footnotesize</literal>
-fonts (see <link linkend="Font-sizes">Font sizes</link>), therefore there is no extra space between
-footnotes. This is &#8216;<literal>6.65pt</literal>&#8217; for &#8216;<literal>10pt</literal>&#8217;, &#8216;<literal>7.7pt</literal>&#8217; for
-&#8216;<literal>11pt</literal>&#8217;, and &#8216;<literal>8.4pt</literal>&#8217; for &#8216;<literal>12pt</literal>&#8217;.
-</para>
-</listitem></varlistentry></variablelist>
</sect1>
</chapter>
@@ -6040,9 +7792,6 @@ footnotes. This is &#8216;<literal>6.65pt</literal>&#8217; for &#8216;<literal>
<para>&latex; has support for making new commands of many different kinds.
</para>
-<!-- xx everything in this chapter needs examples. -->
-<!-- xx Add DeclareRobustCommand (see clsguide.pdf) -->
-
<sect1 label="12.1" id="_005cnewcommand-_0026-_005crenewcommand">
@@ -6054,101 +7803,136 @@ footnotes. This is &#8216;<literal>6.65pt</literal>&#8217; for &#8216;<literal>
<indexterm role="cp"><primary>defining a new command</primary></indexterm>
<indexterm role="cp"><primary>new commands, defining</primary></indexterm>
-<para><literal>\newcommand</literal> and <literal>\renewcommand</literal> define and redefine a
-command, respectively. Synopses:
+<para>Synopses, one of:
</para>
-<screen> \newcommand{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>defn</replaceable>}
- \newcommand*{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>defn</replaceable>}
+<screen>\newcommand{\<replaceable>cmd</replaceable>}{<replaceable>defn</replaceable>}
+\newcommand{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>]{<replaceable>defn</replaceable>}
+\newcommand{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>defn</replaceable>}
+\newcommand*{\<replaceable>cmd</replaceable>}{<replaceable>defn</replaceable>}
+\newcommand*{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>]{<replaceable>defn</replaceable>}
+\newcommand*{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>defn</replaceable>}
+</screen>
+<para>or one of these.
+</para>
+<screen>\renewcommand{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>]{<replaceable>defn</replaceable>}
+\renewcommand{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>]{<replaceable>defn</replaceable>}
\renewcommand{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>defn</replaceable>}
+\renewcommand*{\<replaceable>cmd</replaceable>}{<replaceable>defn</replaceable>}
+\renewcommand*{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>]{<replaceable>defn</replaceable>}
\renewcommand*{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>defn</replaceable>}
</screen>
+<para>Define or redefine a command. See also the discussion of
+<literal>\DeclareRobustCommand</literal> in <link linkend="Class-and-package-commands">Class and package commands</link>.
<indexterm role="cp"><primary>starred form, defining new commands</primary></indexterm>
<indexterm role="cp"><primary>*-form, defining new commands</primary></indexterm>
-<para>The starred form of these two commands requires that the arguments not
-contain multiple paragraphs of text (not <literal>\long</literal>, in plain &tex;
-terms).
+The starred form of these two requires that the arguments not contain
+multiple paragraphs of text (in plain &tex; terms that it not be
+<literal>\long</literal>).
+</para>
+<para>These are the parameters:
</para>
<variablelist><varlistentry><term><replaceable>cmd</replaceable>
-</term><listitem><para>Required; <literal>\<replaceable>cmd</replaceable></literal> is the command name. For <literal>\newcommand</literal>, it
-must not be already defined and must not begin with <literal>\end</literal>. For
-<literal>\renewcommand</literal>, it must already be defined.
+</term><listitem>
+<para>Required; the command name. It must begin with a backslash, <literal>\</literal>,
+and must not begin with the four letter string <literal>\end</literal>. For
+<literal>\newcommand</literal>, it must not be already defined. For
+<literal>\renewcommand</literal>, this name must already be defined.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>nargs</replaceable>
</term><listitem><para>Optional; an integer from 0 to 9, specifying the number of arguments
-that the command can take, including any optional argument. If this
-argument is not present, the default is for the command to have no
-arguments. When redefining a command, the new version can have a
+that the command takes, including any optional argument. Omitting this
+argument is the same as specifying 0, meaning that the command has no
+arguments. If you redefine a command, the new version can have a
different number of arguments than the old version.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>optargdefault</replaceable>
-</term><listitem><para>Optional; if this argument is present then the first argument of defined
-command <literal>\<replaceable>cmd</replaceable></literal> is optional, with default value <replaceable>optargdefault</replaceable>
+</term><listitem><para>Optional; if this argument is present then the first argument of
+<literal>\<replaceable>cmd</replaceable></literal> is optional, with default value <replaceable>optargdefault</replaceable>
(which may be the empty string). If this argument is not present then
<literal>\<replaceable>cmd</replaceable></literal> does not take an optional argument.
</para>
<indexterm role="cp"><primary>positional parameter</primary></indexterm>
-<para>That is, if <literal>\<replaceable>cmd</replaceable></literal> is used with square brackets following,
-as in <literal>\<replaceable>cmd</replaceable>[<replaceable>myval</replaceable>]</literal>, then within <replaceable>defn</replaceable> the first
-<firstterm>positional parameter</firstterm> <literal>#1</literal> expands <replaceable>myval</replaceable>. On the
-other hand, if <literal>\<replaceable>cmd</replaceable></literal> is called without square brackets
-following, then within <replaceable>defn</replaceable> the positional parameter <literal>#1</literal>
-expands to the default <replaceable>optargdefault</replaceable>. In either case, any
-required arguments will be referred to starting with <literal>#2</literal>.
-</para>
-<para>Omitting <literal>[<replaceable>myval</replaceable>]</literal> in a call is different from having the
-square brackets with no contents, as in <literal>[]</literal>. The former results
-in <literal>#1</literal> expanding to <replaceable>optargdefault</replaceable>; the latter results in
-<literal>#1</literal> expanding to the empty string.
+<para>That is, if <literal>\<replaceable>cmd</replaceable></literal> is used with square brackets, as in
+<literal>\<replaceable>cmd</replaceable>[<replaceable>optval</replaceable>]{...}...</literal>, then within <replaceable>defn</replaceable> the
+parameter&#160;<literal>#1</literal> is set to the value of <replaceable>optval</replaceable>. On the
+other hand, if <literal>\<replaceable>cmd</replaceable></literal> is called without the square brackets
+then within <replaceable>defn</replaceable> the parameter <literal>#1</literal> is set to the value of
+<replaceable>optargdefault</replaceable>. In either case, the required arguments start with
+<literal>#2</literal>.
+</para>
+<para>Omitting <literal>[<replaceable>optargdefault</replaceable>]</literal> is different from having the
+square brackets with no contents, as in <literal>[]</literal>. The former sets
+<literal>#1</literal> to the value of <replaceable>optargdefault</replaceable>; the latter sets <literal>#1</literal>
+to the empty string.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>defn</replaceable>
-</term><listitem><para>The text to be substituted for every occurrence of <literal>\<replaceable>cmd</replaceable></literal>; the
-positional parameter <literal>#<replaceable>n</replaceable></literal> in <replaceable>defn</replaceable> is replaced by
-the text of the <replaceable>n</replaceable>th argument.
+</term><listitem><para>Required; the text to be substituted for every occurrence of
+<literal>\<replaceable>cmd</replaceable></literal>. The parameters <literal>#1</literal>, <literal>#2</literal>,
+... <literal>#<replaceable>nargs</replaceable></literal> are replaced by the values that you supply when
+you call the command (or by the default value if there is an optional
+argument and you don&#8217;t exercise the option).
</para>
</listitem></varlistentry></variablelist>
<para>&tex; ignores spaces in the source following an alphabetic control
sequence, as in &#8216;<literal>\cmd </literal>&#8217;. If you actually want a space there, one
-solution is to type <literal>{}</literal> after the command (&#8216;<literal>\cmd{} </literal>&#8217;;
+solution is to type <literal>{}</literal> after the command (&#8216;<literal>\cmd{} </literal>&#8217;, and
another solution is to use an explicit control space (&#8216;<literal>\cmd\ </literal>&#8217;).
</para>
<para>A simple example of defining a new command:
-<literal>\newcommand{\RS}{Robin Smith}</literal> results in
-<literal>\RS</literal> being replaced by the longer text.
-</para>
-<para>Redefining an existing command is similar:
+<literal>\newcommand{\RS}{Robin Smith}</literal> results in <literal>\RS</literal> being
+replaced by the longer text. Redefining an existing command is similar:
<literal>\renewcommand{\qedsymbol}{{\small QED}}</literal>.
</para>
-<para>Here&#8217;s a command definition with one required argument:
+<para>If you try to define a command and the name has already been used then
+you get something like &#8216;<literal>LaTeX Error: Command \fred already
+defined. Or name \end... illegal, see p.192 of the manual</literal>&#8217;. If you try
+to redefine a command and the name has not yet been used then you get
+something like &#8216;<literal>LaTeX Error: \hank undefined</literal>&#8217;.
</para>
-<screen>\newcommand{\defref}[1]{Definition~\ref{#1}}
+<para>Here the first command definition has no arguments, and the second has
+one required argument.
+</para>
+<screen>\newcommand{\student}{Ms~O'Leary}
+\newcommand{\defref}[1]{Definition~\ref{#1}}
</screen>
-<para>Then, <literal>\defref{def:basis}</literal> expands to
-<literal>Definition~\ref{def:basis}</literal>, which will ultimately expand to
+<para>Use the first as in <literal>I highly recommend \student{} to you</literal>. The
+second has a variable, so that <literal>\defref{def:basis}</literal> expands to
+<literal>Definition~\ref{def:basis}</literal>, which ultimately expands to
something like &#8216;<literal>Definition~3.14</literal>&#8217;.
</para>
-<para>An example with two required arguments:
+<para>Similarly, but with two required arguments:
<literal>\newcommand{\nbym}[2]{$#1 \times #2$}</literal> is invoked as
<literal>\nbym{2}{k}</literal>.
</para>
-<para>An example with an optional argument:
+<para>This example has an optional argument.
</para>
<screen>\newcommand{\salutation}[1][Sir or Madam]{Dear #1:}
</screen>
-<para>Then, <literal>\salutation</literal> gives &#8216;<literal>Dear Sir or Madam:</literal>&#8217; while
+<para>Then <literal>\salutation</literal> gives &#8216;<literal>Dear Sir or Madam:</literal>&#8217; while
<literal>\salutation[John]</literal> gives &#8216;<literal>Dear John:</literal>&#8217;. And
<literal>\salutation[]</literal> gives &#8216;<literal>Dear :</literal>&#8217;.
</para>
-<para>The braces around <replaceable>defn</replaceable> do not define a group, that is, they do
-not delimit the scope of the result of expanding <replaceable>defn</replaceable>. So
-<literal>\newcommand{\shipname}[1]{\it #1}</literal> is problematic; in this
-sentence,
+<para>This example has an optional argument and two required arguments.
+</para>
+<screen>\newcommand{\lawyers}[3][company]{#2, #3, and~#1}
+I employ \lawyers[Howe]{Dewey}{Cheatem}.
+</screen>
+<para>The output is &#8216;<literal>I employ Dewey, Cheatem, and Howe</literal>&#8217;. The optional
+argument, the <literal>Howe</literal>, is associated with <literal>#1</literal>, while
+<literal>Dewey</literal> and <literal>Cheatem</literal> are associated with <literal>#2</literal>
+and&#160;<literal>#3</literal>. Because of the optional argument,
+<literal>\lawyers{Dewey}{Cheatem}</literal> will give the output &#8216;<literal>I employ
+Dewey, Cheatem, and company</literal>&#8217;.
+</para>
+<para>The braces around <replaceable>defn</replaceable> do not define a group, that is, they do not
+delimit the scope of the result of expanding <replaceable>defn</replaceable>. For example,
+with <literal>\newcommand{\shipname}[1]{\it #1}</literal>, in this sentence,
</para>
<screen>The \shipname{Monitor} met the \shipname{Merrimac}.
</screen>
-<para>the words &#8216;<literal>met the</literal>&#8217; would incorrectly be in italics. Another
-pair of braces in the definition is needed, like this:
-<literal>\newcommand{\shipname}[1]{{\it #1}}</literal>. Those braces are
-part of the definition and thus do define a group.
+<para>the words &#8216;<literal>met the</literal>&#8217; would incorrectly be in italics. The solution
+is to put another pair of braces inside the definition:
+<literal>\newcommand{\shipname}[1]{{\it #1}}</literal>.
</para>
</sect1>
@@ -6160,17 +7944,30 @@ part of the definition and thus do define a group.
<indexterm role="cp"><primary>defining a new command</primary></indexterm>
<indexterm role="cp"><primary>new commands, defining</primary></indexterm>
-<para>Defines a command, as long as no command of this name already exists.
-Synopses:
+<para>Synopses, one of:
</para>
-<screen>\providecommand{<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>defn</replaceable>}
+<screen>\providecommand{<replaceable>cmd</replaceable>}{<replaceable>defn</replaceable>}
+\providecommand{<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>]{<replaceable>defn</replaceable>}
+\providecommand{<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>defn</replaceable>}
+\providecommand*{<replaceable>cmd</replaceable>}{<replaceable>defn</replaceable>}
+\providecommand*{<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>]{<replaceable>defn</replaceable>}
\providecommand*{<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>defn</replaceable>}
</screen>
-<para>If no command of this name already exists then this has the same effect
-as <literal>\newcommand</literal> (see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link>). If a
-command of this name already exists then this definition does nothing.
-This is particularly useful in a style file, or other file that may be
-loaded more than once.
+<para>Defines a command, as long as no command of this name already exists.
+If no command of this name already exists then this has the same effect
+as <literal>\newcommand</literal>. If a command of this name already exists then
+this definition does nothing. This is particularly useful in a file
+that may be loaded more than once, such as a style file.
+See <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link> for the description of the arguments.
+</para>
+<para>This example
+</para>
+<screen>\providecommand{\myaffiliation}{Saint Michael's College}
+\providecommand{\myaffiliation}{Saint Michael's College}
+From \myaffiliation.
+</screen>
+<para>outputs &#8216;<literal>From Saint Michael's College</literal>&#8217;. Unlike <literal>\newcommand</literal>,
+the repeated use of <literal>\providecommand</literal> does not give an error.
</para>
</sect1>
@@ -6185,27 +7982,46 @@ loaded more than once.
<screen>\newcounter{<replaceable>countername</replaceable>}
\newcounter{<replaceable>countername</replaceable>}[<replaceable>supercounter</replaceable>]
</screen>
-<para>Globally defines a new counter named <replaceable>countername</replaceable> and initialize
-the new counter to zero.
+<para>Globally defines a new counter named <replaceable>countername</replaceable> and initialize it
+to zero (see <link linkend="Counters">Counters</link>).
</para>
-<para>The name <replaceable>countername</replaceable> must consists of letters only, and does not
+<para>The name <replaceable>countername</replaceable> must consist of letters only. It does not
begin with a backslash. This name must not already be in use by another
counter.
</para>
-<para>When you use the optional argument <literal>[<replaceable>supercounter</replaceable>]</literal> then
-<replaceable>countername</replaceable> will be numbered within, or subsidiary to, the
-existing counter <replaceable>supercounter</replaceable>. For example, ordinarily
-<literal>subsection</literal> is numbered within <literal>section</literal> so that any time
-<replaceable>supercounter</replaceable> is incremented with <literal>\stepcounter</literal>
+<para>When you use the optional argument <literal>[<replaceable>supercounter</replaceable>]</literal> then the
+counter <replaceable>countername</replaceable> will be reset to zero whenever
+<replaceable>supercounter</replaceable> is incremented. For example, ordinarily
+<literal>subsection</literal> is numbered within <literal>section</literal> so that any time you
+increment <replaceable>section</replaceable>, either with <literal>\stepcounter</literal>
(see <link linkend="_005cstepcounter">\stepcounter</link>) or <literal>\refstepcounter</literal>
-(see <link linkend="_005crefstepcounter">\refstepcounter</link>) then <replaceable>countername</replaceable> is reset to zero.
+(see <link linkend="_005crefstepcounter">\refstepcounter</link>), then &latex; will reset <replaceable>subsection</replaceable> to
+zero.
+</para>
+<para>This example
</para>
-<para>See <link linkend="Counters">Counters</link>, for more information about counters.
+<screen>\newcounter{asuper} \setcounter{asuper}{1}
+\newcounter{asub}[asuper] \setcounter{asub}{3} % Note `asuper'
+The value of asuper is \arabic{asuper} and of asub is \arabic{asub}.
+\stepcounter{asuper}
+Now asuper is \arabic{asuper} while asub is \arabic{asub}.
+</screen>
+<para>produces &#8216;<literal>The value of asuper is 1 and that of asub is 3</literal>&#8217; and
+&#8216;<literal>Now asuper is 2 while asub is 0</literal>&#8217;.
+</para>
+<para>If the counter already exists, for instance by entering <literal>asuper</literal>
+twice, then you get something like &#8216;<literal>LaTeX Error: Command \c@asuper
+already defined. Or name \end... illegal, see p.192 of the manual.</literal>&#8217;.
+</para>
+<para>If you use the optional argument then the super counter must already
+exist. Entering <literal>\newcounter{jh}[lh]</literal> when <literal>lh</literal> is not a
+defined counter will get you &#8216;<literal>LaTeX Error: No counter 'lh'
+defined.</literal>&#8217;
</para>
</sect1>
<sect1 label="12.4" id="_005cnewlength">
-<title><literal>\newlength</literal>: Allocating a length</title>
+<title><literal>\newlength</literal></title>
<indexterm role="fn"><primary>\newlength</primary></indexterm>
<indexterm role="cp"><primary>lengths, allocating new</primary></indexterm>
@@ -6213,39 +8029,57 @@ existing counter <replaceable>supercounter</replaceable>. For example, ordinari
<indexterm role="cp"><primary>skip register, plain &tex;</primary></indexterm>
<indexterm role="cp"><primary>glue register, plain &tex;</primary></indexterm>
-<para>Allocate a new <firstterm>length</firstterm> register. Synopsis:
+<para>Synopsis:
</para>
-<screen>\newlength{\<replaceable>arg</replaceable>}
+<screen>\newlength{<replaceable>arg</replaceable>}
</screen>
-<para>This command takes one required argument, which must begin with a
-backslash (&#8216;<literal>\</literal>&#8217;). It creates a new length register named
-<literal>\<replaceable>arg</replaceable></literal>, which is a place to hold (rubber) lengths such as
-<literal>1in plus.2in minus.1in</literal> (what plain &tex; calls a <literal>skip</literal>
-register). The register gets an initial value of zero. The control
-sequence <literal>\<replaceable>arg</replaceable></literal> must not already be defined.
+<para>Allocate a new length register (see <link linkend="Lengths">Lengths</link>). The required argument
+<replaceable>arg</replaceable> must begin with a backslash, <literal>\</literal>. The new register holds
+rubber lengths such as <literal>72.27pt</literal> or <literal>1in plus.2in minus.1in</literal>
+(a &latex; length register is what plain &tex; calls a <literal>skip</literal>
+register). The initial value is zero. The control sequence
+<literal>\<replaceable>arg</replaceable></literal> must not be already defined.
</para>
-<para>See <link linkend="Lengths">Lengths</link>, for more about lengths.
+<para>An example:
+</para>
+<screen>\newlength{\graphichgt}
+</screen>
+<para>If you forget the backslash then you get &#8216;<literal>Missing control sequence
+inserted</literal>&#8217;. If the command sequence already exists then you get
+something like &#8216;<literal>LaTeX Error: Command \graphichgt already defined.
+Or name \end... illegal, see p.192 of the manual</literal>&#8217;.
</para>
</sect1>
<sect1 label="12.5" id="_005cnewsavebox">
-<title><literal>\newsavebox</literal>: Allocating a box</title>
+<title><literal>\newsavebox</literal></title>
<indexterm role="fn"><primary>\newsavebox</primary></indexterm>
<indexterm role="cp"><primary>box, allocating new</primary></indexterm>
-<para>Allocate a &#8220;bin&#8221; for holding a box. Synopsis:
+<para>Synopsis:
</para>
-<screen>\newsavebox{\<replaceable>cmd</replaceable>}
+<screen>\newsavebox{<replaceable>cmd</replaceable>}
</screen>
-<para>Defines <literal>\<replaceable>cmd</replaceable></literal> to refer to a new bin for storing boxes.
-Such a box is for holding typeset material, to use multiple times
-(see <link linkend="Boxes">Boxes</link>) or to measure or manipulate. The name
-<literal>\<replaceable>cmd</replaceable></literal> must start with a backslash (&#8216;<literal>\</literal>&#8217;), and must not
-be already defined.
+<para>Define <literal>\<replaceable>cmd</replaceable></literal> to refer to a new &#8220;bin&#8221; for storing boxes.
+Such a box is for holding typeset material, to use multiple times or to
+measure or manipulate (see <link linkend="Boxes">Boxes</link>). The required bin name
+<literal><replaceable>cmd</replaceable></literal> must start with a backslash, <literal>\</literal>, and must not
+already be defined. This command is fragile (see <link linkend="_005cprotect">\protect</link>).
</para>
-<para>The allocation of a box is global. This command is fragile
-(see <link linkend="_005cprotect">\protect</link>).
+<para>The first line here sets you up to save the material for later use.
+</para>
+<screen>\newsavebox{\logobox}
+\savebox{\logobox}{LoGo}
+Our logo is \usebox{\logobox}.
+</screen>
+<para>The output is &#8216;<literal>Our logo is LoGo</literal>&#8217;.
+</para>
+<para>If there is an already defined bin then you get something like
+&#8216;<literal>LaTeX Error: Command \logobox already defined. Or name
+\end... illegal, see p.192 of the manual</literal>&#8217;.
+</para>
+<para>The allocation of a box is global.
</para>
</sect1>
@@ -6258,23 +8092,36 @@ be already defined.
<indexterm role="cp"><primary>defining new environments</primary></indexterm>
<indexterm role="cp"><primary>redefining environments</primary></indexterm>
-<para>These commands define or redefine an environment <replaceable>env</replaceable>, that is,
-<literal>\begin{<replaceable>env</replaceable>} <replaceable>body</replaceable> \end{<replaceable>env</replaceable>}</literal>. Synopses:
+<para>Synopses, one of:
+</para>
+<screen>\newenvironment{<replaceable>env</replaceable>}{<replaceable>begdef</replaceable>}{<replaceable>enddef</replaceable>}
+\newenvironment{<replaceable>env</replaceable>}[<replaceable>nargs</replaceable>]{<replaceable>begdef</replaceable>}{<replaceable>enddef</replaceable>}
+\newenvironment{<replaceable>env</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>begdef</replaceable>}{<replaceable>enddef</replaceable>}
+\newenvironment*{<replaceable>env</replaceable>}{<replaceable>begdef</replaceable>}{<replaceable>enddef</replaceable>}
+\newenvironment*{<replaceable>env</replaceable>}[<replaceable>nargs</replaceable>]{<replaceable>begdef</replaceable>}{<replaceable>enddef</replaceable>}
+\newenvironment*{<replaceable>env</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>begdef</replaceable>}{<replaceable>enddef</replaceable>}
+</screen>
+<para>or one of these.
</para>
-<screen> \newenvironment{<replaceable>env</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>begdefn</replaceable>}{<replaceable>enddefn</replaceable>}
- \newenvironment*{<replaceable>env</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>begdefn</replaceable>}{<replaceable>enddefn</replaceable>}
- \renewenvironment{<replaceable>env</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>begdefn</replaceable>}{<replaceable>enddefn</replaceable>}
-\renewenvironment*{<replaceable>env</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>begdefn</replaceable>}{<replaceable>enddefn</replaceable>}
+<screen>\renewenvironment{<replaceable>env</replaceable>}{<replaceable>begdef</replaceable>}{<replaceable>enddef</replaceable>}
+\renewenvironment{<replaceable>env</replaceable>}[<replaceable>nargs</replaceable>]{<replaceable>begdef</replaceable>}{<replaceable>enddef</replaceable>}
+\renewenvironment{<replaceable>env</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>begdef</replaceable>}{<replaceable>enddef</replaceable>}
+\renewenvironment*{<replaceable>env</replaceable>}{<replaceable>begdef</replaceable>}{<replaceable>enddef</replaceable>}
+\renewenvironment*{<replaceable>env</replaceable>}[<replaceable>nargs</replaceable>]{<replaceable>begdef</replaceable>}{<replaceable>enddef</replaceable>}
+\renewenvironment*{<replaceable>env</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdefault</replaceable>]{<replaceable>begdef</replaceable>}{<replaceable>enddef</replaceable>}
</screen>
+<para>Define or redefine the environment <replaceable>env</replaceable>, that is, create the
+construct <literal>\begin{<replaceable>env</replaceable>} ... <replaceable>body</replaceable> ... \end{<replaceable>env</replaceable>}</literal>.
+</para>
<indexterm role="cp"><primary><literal>*</literal>-form of environment commands</primary></indexterm>
<para>The starred form of these commands requires that the arguments not
-contain multiple paragraphs of text. The body of these environments can
-still contain multiple paragraphs.
+contain multiple paragraphs of text. However, the body of these
+environments can contain multiple paragraphs.
</para>
<variablelist><varlistentry><term><replaceable>env</replaceable>
</term><listitem><para>Required; the environment name. It consists only of letters or the
-<literal>*</literal> character, and thus does not begin with backslash
-(<literal>\</literal>). It must not begin with the string <literal>end</literal>. For
+<literal>*</literal> character, and thus does not begin with backslash, <literal>\</literal>.
+It must not begin with the string <literal>end</literal>. For
<literal>\newenvironment</literal>, the name <replaceable>env</replaceable> must not be the name of an
already existing environment, and also the command <literal>\<replaceable>env</replaceable></literal>
must be undefined. For <literal>\renewenvironment</literal>, <replaceable>env</replaceable> must be the
@@ -6282,54 +8129,60 @@ name of an existing environment.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>nargs</replaceable>
</term><listitem><para>Optional; an integer from 0 to 9 denoting the number of arguments of
-that the environment will take. When the environment is used these
+that the environment takes. When you use the environment these
arguments appear after the <literal>\begin</literal>, as in
-<literal>\begin{<replaceable>env</replaceable>}{<replaceable>arg1</replaceable>}&#8230;{<replaceable>argn</replaceable>}</literal>. If this
-argument is not present then the default is for the environment to have
-no arguments. When redefining an environment, the new version can have
-a different number of arguments than the old version.
+<literal>\begin{<replaceable>env</replaceable>}{<replaceable>arg1</replaceable>} ... {<replaceable>argn</replaceable>}</literal>. Omitting
+this is equivalent to setting it to 0; the environment will have no
+arguments. When redefining an environment, the new version can have a
+different number of arguments than the old version.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>optargdefault</replaceable>
-</term><listitem><para>Optional; if this argument is present then the first argument of the
-defined environment is optional, with default value <replaceable>optargdefault</replaceable>
-(which may be the empty string). If this argument is not present then
-the environment does not take an optional argument.
-</para>
-<para>That is, when <literal>[<replaceable>optargdefault</replaceable>]</literal> is present in the
-environment definition, if <literal>\begin{<replaceable>env</replaceable>}</literal> is used with
-square brackets following, as in
-<literal>\begin{<replaceable>env</replaceable>}[<replaceable>myval</replaceable>]</literal>, then, within <replaceable>begdefn</replaceable>,
-the positional parameter <literal>#1</literal> expands to <replaceable>myval</replaceable>. If
-<literal>\begin{<replaceable>env</replaceable>}</literal> is called without square brackets
-following, then, within within <replaceable>begdefn</replaceable>, the positional parameter
-<literal>#1</literal> expands to the default <replaceable>optargdefault</replaceable>. In either case,
-any required arguments will be referred to starting with <literal>#2</literal>.
-</para>
-<para>Omitting <literal>[<replaceable>myval</replaceable>]</literal> in the call is different from having the
+</term><listitem><para>Optional; if this is present then the first argument of the defined
+environment is optional, with default value <replaceable>optargdefault</replaceable> (which
+may be the empty string). If this is not in the definition then the
+environment does not take an optional argument.
+</para>
+<para>That is, when <replaceable>optargdefault</replaceable> is present in the definition of the
+environment then you can start the environment with square brackets, as
+in <literal>\begin{<replaceable>env</replaceable>}[<replaceable>optval</replaceable>]{...} ... \end{<replaceable>env</replaceable>}</literal>.
+In this case, within <replaceable>begdefn</replaceable> the parameter <literal>#1</literal> is set to the
+value of <replaceable>optval</replaceable>. If you call <literal>\begin{<replaceable>env</replaceable>}</literal> without
+square brackets, then within <replaceable>begdefn</replaceable> the parameter <literal>#1</literal> is
+set to the value of the default <replaceable>optargdefault</replaceable>. In either case,
+any required arguments start with <literal>#2</literal>.
+</para>
+<para>Omitting <literal>[<replaceable>myval</replaceable>]</literal> in the call is different than having the
square brackets with no contents, as in <literal>[]</literal>. The former results
in <literal>#1</literal> expanding to <replaceable>optargdefault</replaceable>; the latter results in
<literal>#1</literal> expanding to the empty string.
</para>
-</listitem></varlistentry><varlistentry><term><replaceable>begdefn</replaceable>
+</listitem></varlistentry><varlistentry><term><replaceable>begdef</replaceable>
</term><listitem><para>Required; the text expanded at every occurrence of
-<literal>\begin{<replaceable>env</replaceable>}</literal>. Within <replaceable>begdef</replaceable>, the <replaceable>n</replaceable>th
-positional parameter (i.e., <literal>#<replaceable>n</replaceable></literal>) is replaced by the text
-of the <replaceable>n</replaceable>th argument.
+<literal>\begin{<replaceable>env</replaceable>}</literal>. Within <replaceable>begdef</replaceable>, the parameters
+<literal>#1</literal>, <literal>#2</literal>, ... <literal>#<replaceable>nargs</replaceable></literal>, are replaced by the
+values that you supply when you call the environment; see the examples
+below.
</para>
-</listitem></varlistentry><varlistentry><term><replaceable>enddefn</replaceable>
+</listitem></varlistentry><varlistentry><term><replaceable>enddef</replaceable>
</term><listitem><para>Required; the text expanded at every occurrence of
-<literal>\end{<replaceable>env</replaceable>}</literal>. This may not contain any positional
-parameters, so <literal>#<replaceable>n</replaceable></literal> cannot be used here (but see the final
+<literal>\end{<replaceable>env</replaceable>}</literal>. This may not contain any parameters, that is,
+you cannot use <literal>#1</literal>, <literal>#2</literal>, etc., here (but see the final
example below).
</para>
</listitem></varlistentry></variablelist>
-<para>All environments, that is to say the <replaceable>begdefn</replaceable> code, the environment
-body and the <replaceable>enddefn</replaceable> code, are processed within a group. Thus, in
+<para>All environments, that is to say the <replaceable>begdef</replaceable> code, the environment
+body, and the <replaceable>enddef</replaceable> code, are processed within a group. Thus, in
the first example below, the effect of the <literal>\small</literal> is limited to
the quote and does not extend to material following the environment.
</para>
+<para>If you try to define an environment and the name has already been used
+then you get something like &#8216;<literal>LaTeX Error: Command \fred already
+defined. Or name \end... illegal, see p.192 of the manual</literal>&#8217;. If you try
+to redefine an environment and the name has not yet been used then you
+get something like &#8216;<literal>LaTeX Error: Environment hank undefined.</literal>&#8217;.
+</para>
<para>This example gives an environment like &latex;&#8217;s <literal>quotation</literal>
-except that it will be set in smaller type:
+except that it will be set in smaller type.
</para>
<screen>\newenvironment{smallquote}{%
\small\begin{quotation}
@@ -6337,8 +8190,16 @@ except that it will be set in smaller type:
\end{quotation}
}
</screen>
-<para>This one shows the use of arguments; it gives a quotation environment
-that cites the author:
+<para>This has an argument, which is set in boldface at the start of a
+paragraph.
+</para>
+<screen>\newenvironment{point}[1]{%
+ \noindent\textbf{#1}
+}{%
+}
+</screen>
+<para>This one shows the use of a optional argument; it gives a quotation
+environment that cites the author.
</para>
<screen>\newenvironment{citequote}[1][Shakespeare]{%
\begin{quotation}
@@ -6347,15 +8208,15 @@ that cites the author:
\end{quotation}
}
</screen>
-<para>The author&#8217;s name is optional, and defaults to &#8216;<literal>Shakespeare</literal>&#8217;.
-In the document, use the environment like this:
+<para>The author&#8217;s name is optional, and defaults to &#8216;<literal>Shakespeare</literal>&#8217;. In
+the document, use the environment like this.
</para>
<screen>\begin{citequote}[Lincoln]
...
\end{citequote}
</screen>
<para>The final example shows how to save the value of an argument to use in
-<replaceable>enddefn</replaceable>, in this case in a box (see <link linkend="_005csbox">\sbox</link>):
+<replaceable>enddef</replaceable>, in this case in a box (see <link linkend="_005csbox-_0026-_005csavebox">\sbox &amp; \savebox</link>).
</para>
<screen>\newsavebox{\quoteauthor}
\newenvironment{citequote}[1][Shakespeare]{%
@@ -6377,31 +8238,30 @@ In the document, use the environment like this:
<indexterm role="cp"><primary>theorem-like environment</primary></indexterm>
<indexterm role="cp"><primary>environment, theorem-like</primary></indexterm>
-<para>Define a new theorem-like environment. Synopses:
+<para>Synopses:
</para>
<screen>\newtheorem{<replaceable>name</replaceable>}{<replaceable>title</replaceable>}
\newtheorem{<replaceable>name</replaceable>}{<replaceable>title</replaceable>}[<replaceable>numbered_within</replaceable>]
\newtheorem{<replaceable>name</replaceable>}[<replaceable>numbered_like</replaceable>]{<replaceable>title</replaceable>}
</screen>
-<para>Using the first form, <literal>\newtheorem{<replaceable>name</replaceable>}{<replaceable>title</replaceable>}</literal>
-creates an environment that will be labelled with <replaceable>title</replaceable>. See the
-first example below.
+<para>Define a new theorem-like environment. You can specify one of
+<replaceable>numbered_within</replaceable> and <replaceable>numbered_like</replaceable>, or neither, but not both.
+</para>
+<para>The first form, <literal>\newtheorem{<replaceable>name</replaceable>}{<replaceable>title</replaceable>}</literal>, creates
+an environment that will be labelled with <replaceable>title</replaceable>; see the first
+example below.
</para>
-<para>The second form
-<literal>\newtheorem{<replaceable>name</replaceable>}{<replaceable>title</replaceable>}[<replaceable>numbered_within</replaceable>]</literal>
+<para>The second form,
+<literal>\newtheorem{<replaceable>name</replaceable>}{<replaceable>title</replaceable>}[<replaceable>numbered_within</replaceable>]</literal>,
creates an environment whose counter is subordinate to the existing
-counter <replaceable>numbered_within</replaceable> (its counter will be reset when
-<replaceable>numbered_within</replaceable> is reset).
+counter <replaceable>numbered_within</replaceable>, so this counter will be reset when
+<replaceable>numbered_within</replaceable> is reset. See the second example below.
</para>
-
<para>The third form
<literal>\newtheorem{<replaceable>name</replaceable>}[<replaceable>numbered_like</replaceable>]{<replaceable>title</replaceable>}</literal>,
-with optional argument between the two required arguments, will create
-an environment whose counter will share the previously defined counter
-<replaceable>numbered_like</replaceable>.
-</para>
-<para>You can specify one of <replaceable>numbered_within</replaceable> and <replaceable>numbered_like</replaceable>,
-or neither, but not both.
+with optional argument between the two required arguments, creates an
+environment whose counter will share the previously defined counter
+<replaceable>numbered_like</replaceable>. See the third example.
</para>
<para>This command creates a counter named <replaceable>name</replaceable>. In addition, unless
the optional argument <replaceable>numbered_like</replaceable> is used, inside of the
@@ -6413,12 +8273,13 @@ theorem-like environment the current <literal>\ref</literal> value will be that
<para>Arguments:
</para>
<variablelist><varlistentry><term><replaceable>name</replaceable>
-</term><listitem><para>The name of the environment. It must not begin with a backslash
-(&#8216;<literal>\</literal>&#8217;). It must not be the name of an existing environment; indeed,
-the command name <literal>\<replaceable>name</replaceable></literal> must not already be defined as anything.
+</term><listitem><para>The name of the environment. It is a string of letters. It must not
+begin with a backslash, <literal>\</literal>. It must not be the name of an
+existing environment, and the command name <literal>\<replaceable>name</replaceable></literal> must not
+already be defined.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>title</replaceable>
-</term><listitem><para>The text printed at the beginning of the environment, before the
+</term><listitem><para>The text to be printed at the beginning of the environment, before the
number. For example, &#8216;<literal>Theorem</literal>&#8217;.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>numbered_within</replaceable>
@@ -6452,10 +8313,10 @@ output.
Second def
\end{defn}
</screen>
-<para>Because the next example specifies the optional argument
-<replaceable>numbered_within</replaceable> to <literal>\newtheorem</literal> as <literal>section</literal>, the
-example, with the same document body, gives &#8216;<literal>Definition&#160;1.1</literal>&#8217;
-and &#8216;<literal>Definition&#160;2.1</literal>&#8217;.
+<para>This example has the same document body as the prior one. But here
+<literal>\newtheorem</literal>&#8217;s optional argument <replaceable>numbered_within</replaceable> is given as
+<literal>section</literal>, so the output is like &#8216;<literal>Definition&#160;1.1</literal>&#8217; and
+&#8216;<literal>Definition&#160;2.1</literal>&#8217;.
</para>
<screen>\newtheorem{defn}{Definition}[section]
\begin{document}
@@ -6494,43 +8355,41 @@ by &#8216;<literal>Theorem&#160;2.1</literal>&#8217; and &#8216;<literal>Definit
</sect1>
<sect1 label="12.8" id="_005cnewfont">
-<title><literal>\newfont</literal>: Define a new font (obsolete)</title>
+<title><literal>\newfont</literal></title>
<indexterm role="fn"><primary>\newfont</primary></indexterm>
<indexterm role="cp"><primary>fonts, new commands for</primary></indexterm>
<indexterm role="cp"><primary>defining new fonts</primary></indexterm>
-<para><literal>\newfont</literal>, now obsolete, defines a command that will switch fonts.
-Synopsis:
+<!-- @findex .fd @r{file} -->
+<para>This command is obsolete. This description is here only to help with old
+documents. New documents should define fonts in families through the
+New Font Selection Scheme which allows you to, for example, associate a
+boldface with a roman (see <link linkend="Fonts">Fonts</link>).
+<!-- This is done either by using -->
+<!-- @file{.fd} files or through the use of an engine that can access system -->
+<!-- fonts such as Xe@LaTeX{} (@pxref{@TeX{} engines}). -->
+</para>
+<para>Synopsis:
</para>
<screen>\newfont{\<replaceable>cmd</replaceable>}{<replaceable>font description</replaceable>}
</screen>
-<para>This defines a control sequence <literal>\<replaceable>cmd</replaceable></literal> that will change the
-current font. &latex; will look on your system for a file named
-<filename><replaceable>fontname</replaceable>.tfm</filename>. The control sequence must must not already
-be defined. It must begin with a backslash (&#8216;<literal>\</literal>&#8217;).
-</para>
-<indexterm role="fn"><primary>.fd file</primary></indexterm>
-<para>This command is obsolete. It is a low-level command for setting up an
-individual font. Today fonts are almost always defined in families
-(which allows you to, for example, associate a boldface with a roman)
-through the so-called &#8220;New Font Selection Scheme&#8221;, either by using
-<filename>.fd</filename> files or through the use of an engine that can access
-system fonts such as Xe&latex; (see <link linkend="TeX-engines">&tex; engines</link>).
-<!-- xx explain nfss somewhere -->
+<para>Define a command <literal>\<replaceable>cmd</replaceable></literal> that will change the current font.
+The control sequence must must not already be defined. It must begin
+with a backslash, <literal>\</literal>.
</para>
<indexterm role="cp"><primary>at clause, in font definitions</primary></indexterm>
<indexterm role="cp"><primary>design size, in font definitions</primary></indexterm>
-<para>But since it is part of &latex;, here is an explanation: the
-<replaceable>font description</replaceable> consists of a <replaceable>fontname</replaceable> and an optional
-<firstterm>at clause</firstterm>; this can have the form either <literal>at <replaceable>dimen</replaceable></literal>
-or <literal>scaled <replaceable>factor</replaceable></literal>, where a <replaceable>factor</replaceable> of &#8216;<literal>1000</literal>&#8217;
-means no scaling. For &latex;&#8217;s purposes, all this does is scale all
-the character and other font dimensions relative to the font&#8217;s design
-size, which is a value defined in the <filename>.tfm</filename> file.
+<para>The <replaceable>font description</replaceable> consists of a <replaceable>fontname</replaceable> and an optional
+<firstterm>at clause</firstterm>. &latex; will look on your system for a file named
+<filename><replaceable>fontname</replaceable>.tfm</filename>. The at clause can have the form either
+<literal>at <replaceable>dimen</replaceable></literal> or <literal>scaled <replaceable>factor</replaceable></literal>, where a
+<replaceable>factor</replaceable> of &#8216;<literal>1000</literal>&#8217; means no scaling. For &latex;&#8217;s purposes,
+all this does is scale all the character and other font dimensions
+relative to the font&#8217;s design size, which is a value defined in the
+<filename>.tfm</filename> file.
</para>
-<para>This example defines two equivalent fonts and typesets a few
-characters in each:
+<para>This defines two equivalent fonts and typesets a few characters in each.
</para>
<screen>\newfont{\testfontat}{cmb10 at 11pt}
\newfont{\testfontscaled}{cmb10 scaled 1100}
@@ -6631,12 +8490,14 @@ the command and the question text.
<screen>\newcommand{\points}[1]{\makebox[0pt]{\makebox[10em][l]{#1~pts}}
\begin{enumerate}
\item\points{10}no extra space output here
- \item\points{15} extra space output between the number and the word `extra'
+ \item\points{15} extra space between the number and the `extra'
\end{enumerate}
</screen>
-<para>The solution is to change to
-<literal>\newcommand{\points}[1]{\makebox[0pt]{\makebox[10em][l]{#1~pts}}\ignorespaces}</literal>.
+<para>The solution is to change to this.
</para>
+<screen>\newcommand{\points}[1]{%
+ \makebox[0pt]{\makebox[10em][l]{#1~pts}}\ignorespaces}
+</screen>
<para>A second example shows spaces being removed from the front of text. The
commands below allow a user to uniformly attach a title to names. But,
as given, if a title accidentally starts with a space then
@@ -6644,7 +8505,7 @@ as given, if a title accidentally starts with a space then
</para>
<screen>\makeatletter
\newcommand{\honorific}[1]{\def\@honorific{#1}} % remember title
-\newcommand{\fullname}[1]{\@honorific~#1} % recall title; put before name
+\newcommand{\fullname}[1]{\@honorific~#1} % put title before name
\makeatother
\begin{tabular}{|l|}
\honorific{Mr/Ms} \fullname{Jones} \\ % no extra space here
@@ -6710,6 +8571,8 @@ inside of a minipage (see <link linkend="minipage">minipage</link>). The counte
through <literal>enumiv</literal> are used in the <literal>enumerate</literal> environment, for
up to four levels of nesting (see <link linkend="enumerate">enumerate</link>).
</para>
+<para>Counters can have any integer value but they are typically positive.
+</para>
<para>New counters are created with <literal>\newcounter</literal>. See <link linkend="_005cnewcounter">\newcounter</link>.
</para>
@@ -6722,7 +8585,7 @@ up to four levels of nesting (see <link linkend="enumerate">enumerate</link>).
<para>Print the value of a counter, in a specified style. For instance, if
the counter <replaceable>counter</replaceable> has the value 1 then a
-<literal>\alph{<replaceable>counter</replaceable>}</literal> in your source will result in a lower case
+<literal>\alph{<replaceable>counter</replaceable>}</literal> in your source will result in a lowercase
letter&#160;a appearing in the output.
</para>
<para>All of these commands take a single counter as an argument, for
@@ -6730,46 +8593,54 @@ instance, <literal>\alph{enumi}</literal>. Note that the counter name does not
start with a backslash.
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\alph{<replaceable>counter</replaceable>}</primary></indexterm><literal>\alph{<replaceable>counter</replaceable>}</literal>
-</term><listitem><para>Print the value of <replaceable>counter</replaceable> in lowercase letters: &#8216;a&#8217;, &#8216;b&#8217;, ...
+</term><listitem><para>Print the value of <replaceable>counter</replaceable> in lowercase letters: &#8216;a&#8217;, &#8216;b&#8217;,
+... If the counter&#8217;s value is less than 1 or more than 26 then
+you get &#8216;<literal>LaTeX Error: Counter too large.</literal>&#8217;
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Alph{<replaceable>counter</replaceable>}</primary></indexterm><literal>\Alph{<replaceable>counter</replaceable>}</literal>
-</term><listitem><para>Print in uppercase letters: &#8216;A&#8217;, &#8216;B&#8217;, ...
+</term><listitem><para>Print in uppercase letters: &#8216;A&#8217;, &#8216;B&#8217;, ... If the counter&#8217;s value
+is less than 1 or more than 26 then you get &#8216;<literal>LaTeX Error: Counter
+too large.</literal>&#8217;
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\arabic{<replaceable>counter</replaceable>}</primary></indexterm><literal>\arabic{<replaceable>counter</replaceable>}</literal>
-</term><listitem><para>Print in Arabic numbers: &#8216;1&#8217;, &#8216;2&#8217;, ...
+</term><listitem><para>Print in Arabic numbers such as &#8216;<literal>5</literal>&#8217; or &#8216;<literal>-2</literal>&#8217;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\roman{<replaceable>counter</replaceable>}</primary></indexterm><literal>\roman{<replaceable>counter</replaceable>}</literal>
-</term><listitem><para>Print in lowercase roman numerals: &#8216;i&#8217;, &#8216;ii&#8217;, ...
+</term><listitem><para>Print in lowercase roman numerals: &#8216;i&#8217;, &#8216;ii&#8217;, ... If the
+counter&#8217;s value is less than 1 then you get no warning or error but
+&latex; does not print anything in the output.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Roman{<replaceable>counter</replaceable>}</primary></indexterm><literal>\Roman{<replaceable>counter</replaceable>}</literal>
-</term><listitem><para>Print in uppercase roman numerals: &#8216;I&#8217;, &#8216;II&#8217;, ...
+</term><listitem><para>Print in uppercase roman numerals: &#8216;I&#8217;, &#8216;II&#8217;, ... If the
+counter&#8217;s value is less than 1 then you get no warning or error but
+&latex; does not print anything in the output.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\fnsymbol{<replaceable>counter</replaceable>}</primary></indexterm><literal>\fnsymbol{<replaceable>counter</replaceable>}</literal>
-</term><listitem><para>Prints the value of <replaceable>counter</replaceable> in a specific sequence of nine
-symbols (conventionally used for labeling footnotes). The value of
-<replaceable>counter</replaceable> must be between&#160;1 and&#160;9, inclusive.
+</term><listitem><para>Prints the value of <replaceable>counter</replaceable> using a sequence of nine symbols that
+are traditionally used for labeling footnotes. The value of
+<replaceable>counter</replaceable> should be between&#160;1 and&#160;9, inclusive. If the
+counter&#8217;s value is less than 0 or more than 9 then you get &#8216;<literal>LaTeX
+Error: Counter too large</literal>&#8217;, while if it is 0 then you get no error or
+warning but &latex; does not output anything.
</para>
<para>Here are the symbols:
</para>
-<informaltable><tgroup cols="3"><colspec colwidth="33*"></colspec><colspec colwidth="33*"></colspec><colspec colwidth="33*"></colspec><thead><row><entry><para>Name</para></entry><entry><para>Command</para></entry><entry><para>Equivalent Unicode symbol and/or numeric code point<!--
- -->
-</para></entry></row></thead><tbody><row><entry><para>asterisk</para></entry><entry><para><literal>\ast</literal></para></entry><entry><para>*<!--
- -->
-</para></entry></row><row><entry><para>dagger</para></entry><entry><para><literal>\dagger</literal></para></entry><entry><para>&#x2020;
-</para></entry></row><row><entry><para>ddagger</para></entry><entry><para><literal>\ddagger</literal></para></entry><entry><para>&#x2021;
-</para></entry></row><row><entry><para>section-sign</para></entry><entry><para><literal>\S</literal></para></entry><entry><para>&#x00A7;
-</para></entry></row><row><entry><para>paragraph-sign</para></entry><entry><para><literal>\P</literal></para></entry><entry><para>&#x00B6;
-</para></entry></row><row><entry><para>double-vert</para></entry><entry><para><literal>\parallel</literal></para></entry><entry><para>&#x2016;
-</para></entry></row><row><entry><para>double-asterisk</para></entry><entry><para><literal>\ast\ast</literal></para></entry><entry><para>**<!--
- -->
-</para></entry></row><row><entry><para>double-dagger</para></entry><entry><para><literal>\dagger\dagger</literal></para></entry><entry><para>&#x2020;&#x2020;
-</para></entry></row><row><entry><para>double-ddagger</para></entry><entry><para><literal>\ddagger\ddagger</literal></para></entry><entry><para>&#x2021;&#x2021;
+<informaltable><tgroup cols="4"><colspec colwidth="10*"></colspec><colspec colwidth="30*"></colspec><colspec colwidth="30*"></colspec><colspec colwidth="30*"></colspec><thead><row><entry><para>Number</para></entry><entry><para>Name</para></entry><entry><para>Command</para></entry><entry><para>Symbol
+</para></entry></row></thead><tbody><row><entry><para>1</para></entry><entry><para>asterisk</para></entry><entry><para><literal>\ast</literal></para></entry><entry><para>*<!-- -->
+</para></entry></row><row><entry><para>2</para></entry><entry><para>dagger</para></entry><entry><para><literal>\dagger</literal></para></entry><entry><para>&#x2020;
+</para></entry></row><row><entry><para>3</para></entry><entry><para>ddagger</para></entry><entry><para><literal>\ddagger</literal></para></entry><entry><para>&#x2021;
+</para></entry></row><row><entry><para>4</para></entry><entry><para>section-sign</para></entry><entry><para><literal>\S</literal></para></entry><entry><para>&#x00A7;
+</para></entry></row><row><entry><para>5</para></entry><entry><para>paragraph-sign</para></entry><entry><para><literal>\P</literal></para></entry><entry><para>&#x00B6;
+</para></entry></row><row><entry><para>6</para></entry><entry><para>double-vert</para></entry><entry><para><literal>\parallel</literal></para></entry><entry><para>&#x2016;
+</para></entry></row><row><entry><para>7</para></entry><entry><para>double-asterisk</para></entry><entry><para><literal>\ast\ast</literal></para></entry><entry><para>**<!-- -->
+</para></entry></row><row><entry><para>8</para></entry><entry><para>double-dagger</para></entry><entry><para><literal>\dagger\dagger</literal></para></entry><entry><para>&#x2020;&#x2020;
+</para></entry></row><row><entry><para>9</para></entry><entry><para>double-ddagger</para></entry><entry><para><literal>\ddagger\ddagger</literal></para></entry><entry><para>&#x2021;&#x2021;
</para></entry></row></tbody></tgroup></informaltable>
</listitem></varlistentry></variablelist>
</sect1>
<sect1 label="13.2" id="_005cusecounter">
-<title><literal>\usecounter{<replaceable>counter</replaceable>}</literal></title>
+<title><literal>\usecounter</literal></title>
<indexterm role="fn"><primary>\usecounter</primary></indexterm>
<indexterm role="cp"><primary>list items, specifying counter</primary></indexterm>
@@ -6779,15 +8650,16 @@ symbols (conventionally used for labeling footnotes). The value of
</para>
<screen>\usecounter{<replaceable>counter</replaceable>}
</screen>
-<para>In the <literal>list</literal> environment, when used in the second argument, this
-command sets up <replaceable>counter</replaceable> to number the list items. It initializes
-<replaceable>counter</replaceable> to zero, and arranges that when <literal>\item</literal> is called
-without its optional argument then <replaceable>counter</replaceable> is incremented by
-<literal>\refstepcounter</literal>, making its value be the current <literal>ref</literal>
-value. This command is fragile (see <link linkend="_005cprotect">\protect</link>).
+<para>Used in the second argument of the <literal>list</literal> environment
+(see <link linkend="list">list</link>), this declares that list items will be numbered by
+<replaceable>counter</replaceable>. It initializes <replaceable>counter</replaceable> to zero, and arranges that
+when <literal>\item</literal> is called without its optional argument then
+<replaceable>counter</replaceable> is incremented by <literal>\refstepcounter</literal>, making its value
+be the current <literal>ref</literal> value (see <link linkend="_005cref">\ref</link>). This command is fragile
+(see <link linkend="_005cprotect">\protect</link>).
</para>
-<para>Put in the preamble, this makes a new list environment enumerated with
-<replaceable>testcounter</replaceable>:
+<para>Put in the document preamble, this example makes a new list environment
+enumerated with <replaceable>testcounter</replaceable>:
</para>
<screen>\newcounter{testcounter}
\newenvironment{test}{%
@@ -6801,7 +8673,7 @@ value. This command is fragile (see <link linkend="_005cprotect">\protect</link
</sect1>
<sect1 label="13.3" id="_005cvalue">
-<title><literal>\value{<replaceable>counter</replaceable>}</literal></title>
+<title><literal>\value</literal></title>
<indexterm role="fn"><primary>\value</primary></indexterm>
<indexterm role="cp"><primary>counters, getting value of</primary></indexterm>
@@ -6810,13 +8682,8 @@ value. This command is fragile (see <link linkend="_005cprotect">\protect</link
</para>
<screen>\value{<replaceable>counter</replaceable>}
</screen>
-<para>This command expands to the value of <replaceable>counter</replaceable>. It is often used
-in <literal>\setcounter</literal> or <literal>\addtocounter</literal>, but <literal>\value</literal> can
-be used anywhere that &latex; expects a number. It must not be
-preceded by <literal>\protect</literal> (see <link linkend="_005cprotect">\protect</link>).
-</para>
-<para>The <literal>\value</literal> command is not used for typesetting the value of the
-counter. See <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</link>.
+<para>Expands to the value of the counter <replaceable>counter</replaceable>. (Note that the name
+of a counter does not begin with a backslash.)
</para>
<para>This example outputs &#8216;<literal>Test counter is&#160;6. Other counter
is&#160;5.</literal>&#8217;.
@@ -6828,6 +8695,14 @@ is&#160;5.</literal>&#8217;.
Test counter is \arabic{test}.
Other counter is \arabic{other}.
</screen>
+<para>The <literal>\value</literal> command is not used for typesetting the value of the
+counter. For that, see <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</link>.
+</para>
+<para>It is often used in <literal>\setcounter</literal> or <literal>\addtocounter</literal> but
+<literal>\value</literal> can be used anywhere that &latex; expects a number, such
+as in <literal>\hspace{\value{foo}\parindent}</literal>. It must not be
+preceded by <literal>\protect</literal> (see <link linkend="_005cprotect">\protect</link>).
+</para>
<para>This example inserts <literal>\hspace{4\parindent}</literal>.
</para>
<screen>\setcounter{myctr}{3} \addtocounter{myctr}{1}
@@ -6836,7 +8711,7 @@ Other counter is \arabic{other}.
</sect1>
<sect1 label="13.4" id="_005csetcounter">
-<title><literal>\setcounter{<replaceable>counter</replaceable>}{<replaceable>value</replaceable>}</literal></title>
+<title><literal>\setcounter</literal></title>
<indexterm role="fn"><primary>\setcounter</primary></indexterm>
<indexterm role="cp"><primary>counters, setting</primary></indexterm>
@@ -6846,24 +8721,29 @@ Other counter is \arabic{other}.
</para>
<screen>\setcounter{<replaceable>counter</replaceable>}{<replaceable>value</replaceable>}
</screen>
-<para>The <literal>\setcounter</literal> command globally sets the value of <replaceable>counter</replaceable>
-to the <replaceable>value</replaceable> argument. Note that the counter name does not start
-with a backslash.
+<para>Globally set the counter <replaceable>counter</replaceable> to have the value of the
+<replaceable>value</replaceable> argument, which must be an integer. Thus, you can set a
+counter&#8217;s value as <literal>\setcounter{section}{5}</literal>. Note that the
+counter name does not start with a backslash.
</para>
-<para>In this example the section value appears as &#8216;<literal>V</literal>&#8217;.
+<para>In this example if the counter <literal>theorem</literal> has value 12 then the
+second line will print &#8216;<literal>XII</literal>&#8217;.
</para>
-<screen>\setcounter{section}{5}
-Here it is in Roman: \Roman{section}.
+<screen>\setcounter{exercise}{\value{theorem}}
+Here it is in Roman: \Roman{exercise}.
</screen>
</sect1>
<sect1 label="13.5" id="_005caddtocounter">
-<title><literal>\addtocounter{<replaceable>counter</replaceable>}{<replaceable>value</replaceable>}</literal></title>
+<title><literal>\addtocounter</literal></title>
<indexterm role="fn"><primary>\addtocounter</primary></indexterm>
-<para>The <literal>\addtocounter</literal> command globally increments <replaceable>counter</replaceable> by
-the amount specified by the <replaceable>value</replaceable> argument, which may be negative.
+<para>Synopsis:
+</para>
+<screen>\addtocounter{<replaceable>counter</replaceable>}{<replaceable>value</replaceable>&#160;</screen>
+<para>Globally increment <replaceable>counter</replaceable> by the amount specified by the
+<replaceable>value</replaceable> argument, which may be negative.
</para>
<para>In this example the section value appears as &#8216;<literal>VII</literal>&#8217;.
</para>
@@ -6874,15 +8754,18 @@ Here it is in Roman: \Roman{section}.
</sect1>
<sect1 label="13.6" id="_005crefstepcounter">
-<title><literal>\refstepcounter{<replaceable>counter</replaceable>}</literal></title>
+<title><literal>\refstepcounter</literal></title>
<indexterm role="fn"><primary>\refstepcounter</primary></indexterm>
-<para>The <literal>\refstepcounter</literal> command works in the same way as
-<literal>\stepcounter</literal> (see <link linkend="_005cstepcounter">\stepcounter</link>): it globally increments the
-value of <replaceable>counter</replaceable> by one and resets the value of any counter
-numbered within it. (For the definition of &#8220;counters numbered
-within&#8221;, see <link linkend="_005cnewcounter">\newcounter</link>.)
+<para>Synopsis:
+</para>
+<screen>\refstepcounter{<replaceable>counter</replaceable>}
+</screen>
+<para>Globally increments the value of <replaceable>counter</replaceable> by one, as does
+<literal>\stepcounter</literal> (see <link linkend="_005cstepcounter">\stepcounter</link>). The difference is that this
+command resets the value of any counter numbered within it. (For the
+definition of &#8220;counters numbered within&#8221;, see <link linkend="_005cnewcounter">\newcounter</link>.)
</para>
<para>In addition, this command also defines the current <literal>\ref</literal> value
to be the result of <literal>\thecounter</literal>.
@@ -6893,31 +8776,47 @@ locally, i.e., inside the current group.
</sect1>
<sect1 label="13.7" id="_005cstepcounter">
-<title><literal>\stepcounter{<replaceable>counter</replaceable>}</literal></title>
+<title><literal>\stepcounter</literal></title>
<indexterm role="fn"><primary>\stepcounter</primary></indexterm>
-<para>The <literal>\stepcounter</literal> command globally adds one to <replaceable>counter</replaceable> and
-resets all counters numbered within it. (For the definition of
-&#8220;counters numbered within&#8221;, see <link linkend="_005cnewcounter">\newcounter</link>.)
+<para>Synopsis:
+</para>
+<screen>\stepcounter{<replaceable>counter</replaceable>}
+</screen>
+<para>Globally adds one to <replaceable>counter</replaceable> and resets all counters numbered
+within it. (For the definition of &#8220;counters numbered within&#8221;,
+see <link linkend="_005cnewcounter">\newcounter</link>.)
+</para>
+<para>This command differs from <literal>\refstepcounter</literal> in that this one does
+not influence references&#160;&#8212; it does not define the current
+<literal>\ref</literal> value to be the result of <literal>\thecounter</literal>
+(see <link linkend="_005crefstepcounter">\refstepcounter</link>).
</para>
</sect1>
-<sect1 label="13.8" id="_005cday-_005cmonth-_005cyear">
-<title><literal>\day \month \year</literal>: Predefined counters</title>
+<sect1 label="13.8" id="_005cday-_0026-_005cmonth-_0026-_005cyear">
+<title><literal>\day</literal> &amp; <literal>\month</literal> &amp; <literal>\year</literal></title>
<indexterm role="fn"><primary>\day</primary></indexterm>
<indexterm role="fn"><primary>\month</primary></indexterm>
<indexterm role="fn"><primary>\year</primary></indexterm>
-<para>&latex; defines counters for the day of the month (<literal>\day</literal>,
-1&#8211;31), month of the year (<literal>\month</literal>, 1&#8211;12), and year
-(<literal>\year</literal>, Common Era). When &tex; starts up, they are
-set to the current values on the system where &tex; is running. They
-are not updated as the job progresses.
+<para>&latex; defines the counter <literal>\day</literal> for the day of the month
+(nominally with value between 1 and 31), <literal>\month</literal> for the month of
+the year (nominally with value between 1 and 12), and year <literal>\year</literal>.
+When &tex; starts up, they are set from the current values on the
+system. The related command <literal>\today</literal> produces a string
+representing the current day (see <link linkend="_005ctoday">\today</link>).
+</para>
+<para>They counters are not updated as the job progresses so in principle they
+could be incorrect by the end. In addition, &tex; does no sanity
+check:
</para>
-<para>The related command <literal>\today</literal> produces a string representing the
-current day (see <link linkend="_005ctoday">\today</link>).
+<screen>\day=-2 \month=13 \year=-4 \today
+</screen>
+<para>gives no error or warning and results in the output &#8216;<literal>-2, -4</literal>&#8217; (the
+bogus month value produces no output).
</para>
</sect1>
@@ -6930,32 +8829,99 @@ current day (see <link linkend="_005ctoday">\today</link>).
<para>A <firstterm>length</firstterm> is a measure of distance. Many &latex; commands take a
length as an argument.
</para>
+<para>This shows a box of the given length.
+</para>
+<screen>\newcommand{\blackbar}[1]{\rule{#1}{10pt}} % make a bar
+\newcommand{\showhbox}[2]{\fboxsep=0pt\fbox{\hbox to #1{#2}}} % box it
+XXX\showhbox{100pt}{\blackbar{100pt}}YYY
+</screen>
+<para>It produces a black bar 100&#160;points long between &#8216;<literal>XXX</literal>&#8217; and
+&#8216;<literal>YYY</literal>&#8217;.
+</para>
<para>Lengths come in two types. A <firstterm>rigid length</firstterm> (what Plain &tex;
-calls a <firstterm>dimen</firstterm>) such as <literal>10pt</literal> cannot contain a <literal>plus</literal> or
-<literal>minus</literal> component. A <firstterm>rubber length</firstterm> (what Plain &tex; calls
-a <firstterm>skip</firstterm>) can contain those, as with <literal>1cm plus0.05cm
-minus0.01cm</literal>. These give the ability to stretch or shrink; the length
-in the prior sentence could appear in the output as long as 1.05&#160;cm
-or as short as 0.99&#160;cm, depending on what &tex;&#8217;s typesetting
-algorithm finds optimum.
+calls a <firstterm>dimen</firstterm>) such as <literal>10pt</literal> does not contain a <literal>plus</literal>
+or <literal>minus</literal> component. The above example shows a rigid length. A
+<firstterm>rubber length</firstterm> (what Plain &tex; calls a <firstterm>skip</firstterm>) can contain
+those components, as with <literal>1cm plus0.05cm minus0.01cm</literal>. Here the
+<literal>1cm</literal> is the <firstterm>natural length</firstterm> while the other two, the
+<literal>plus</literal> and <literal>minus</literal> components, allow the length to stretch or
+shrink.
+</para>
+<para>Shrinking is simpler: with <literal>1cm minus 0.05cm</literal>, the natural length
+is 1cm but if smaller is needed then &tex; can shrink it down as
+far as 0.95cm. Beyond that, &tex; refuses to shrink any more.
+Thus, below the first one works fine, producing a space of
+98&#160;points between the two bars.
+</para>
+<screen>XXX\showhbox{300pt}{%
+ \blackbar{101pt}\hspace{100pt minus 2pt}\blackbar{101pt}}YYY
+
+XXX\showhbox{300pt}{%
+ \blackbar{105pt}\hspace{100pt minus 1pt}\blackbar{105pt}}YYY
+</screen>
+<para>But the second one gets a warning like &#8216;<literal>Overfull \hbox (1.0pt too
+wide) detected at line 17</literal>&#8217;. In the output the first &#8216;<literal>Y</literal>&#8217; is
+overwritten by the end of the black bar, because the box&#8217;s material is
+wider than the 300pt allocated, as &tex; has refused to shrink
+the total to less than 309&#160;points.
+</para>
+<para>Stretching is like shrinking except that if &tex; is asked to stretch
+beyond the given amount, it won&#8217;t refuse. Here the first line is fine,
+producing a space of 110&#160;points between the bars.
+</para>
+<screen>XXX\showhbox{300pt}{%
+ \blackbar{95pt}\hspace{100pt plus 10pt}\blackbar{95pt}}YYY
+
+XXX\showhbox{300pt}{%
+ \blackbar{95pt}\hspace{100pt plus 1pt}\blackbar{95pt}}YYY
+</screen>
+<para>In the second line &tex; needs a stretch of 10&#160;points and only
+1&#160;point was specified. In this situation, &tex; stretches the
+space to the required length, but it complains with a warning like
+&#8216;<literal>Underfull \hbox (badness 10000) detected at line 22</literal>&#8217;. (We won&#8217;t
+discuss badness; the point is that the system was not given as much
+stretch as needed.)
+</para>
+<para>You can put both stretch and shrink in the same length, as in
+<literal>1ex plus 0.05ex minus 0.02ex</literal>.
+</para>
+<para>If &tex; is setting two or more rubber lengths then it allocates the
+stretch or shrink in proportion.
+</para>
+<screen>XXX\showhbox{300pt}{\blackbar{100pt}% left
+ \hspace{0pt plus 50pt}\blackbar{80pt}\hspace{0pt plus 10pt}% middle
+ \blackbar{100pt}}YYY % right
+</screen>
+<para>The outside bars take up 100&#160;points, so the middle needs another
+100. In the middle the bar takes up 80&#160;points, so the two
+<literal>\hspace</literal>&#8217;s must stretch 20&#160;points. Because the two say
+<literal>plus 50pt</literal> and <literal>plus 10pt</literal>, &tex; gets 5/6 of the
+stretch from the first space and 1/6 from the second.
</para>
<para>The <literal>plus</literal> or <literal>minus</literal> component of a rubber length can contain
a <firstterm>fill</firstterm> component, as in <literal>1in plus2fill</literal>. This gives the
-length infinite stretchability or shrinkability, so that the length in
-the prior sentence can be set by &tex; to any distance greater than or
-equal to 1&#160;inch. &tex; actually provides three infinite glue
-components <literal>fil</literal>, <literal>fill</literal>, and <literal>filll</literal>, such that the
-later ones overcome the earlier ones, but only the middle value is
-ordinarily used. See <link linkend="_005chfill">\hfill</link>, See <link linkend="_005cvfill">\vfill</link>.
-</para>
-<para>Multiplying an entire rubber length by a number turns it into a rigid
-length, so that after <literal>\setlength{\ylength}{1in plus 0.2in}</literal>
-and <literal>\setlength{\zlength}{3\ylength}</literal> then the value of
+length infinite stretchability or shrinkability so that &tex; could set
+it to any distance. Here the two figures will be equal-spaced across
+the page.
+</para>
+<screen>\begin{minipage}{\linewidth}
+ \hspace{0pt plus 1fill}\includegraphics{godel.png}%
+ \hspace{0pt plus 1fill}\includegraphics{einstein.png}%
+ \hspace{0pt plus 1fill}
+\end{minipage}
+</screen>
+<para>&tex; actually has three infinite glue components <literal>fil</literal>,
+<literal>fill</literal>, and <literal>filll</literal>. The later ones are more infinite than
+the earlier ones. Ordinarily document authors only use the middle one
+(see <link linkend="_005chfill">\hfill</link> and see <link linkend="_005cvfill">\vfill</link>).
+</para>
+<para>Multiplying a rubber length by a number turns it into a rigid length, so
+that after <literal>\setlength{\ylength}{1in plus 0.2in}</literal> and
+<literal>\setlength{\zlength}{3\ylength}</literal> then the value of
<literal>\zlength</literal> is <literal>3in</literal>.
</para>
-
<sect1 label="14.1" id="Units-of-length">
<title>Units of length</title>
@@ -6967,49 +8933,49 @@ math mode.
<variablelist><varlistentry><term><literal>pt</literal>
</term><listitem><indexterm role="fn"><primary>pt</primary></indexterm>
<indexterm role="cp"><primary>Point</primary></indexterm>
-<para>Point 1/72.27 inch. The conversion to metric units, to two decimal
+<anchor id="units-of-length-pt"/><para>Point 1/72.27 inch. The conversion to metric units, to two decimal
places, is 1point = 2.85mm = 28.45cm.
</para>
</listitem></varlistentry><varlistentry><term><literal>pc</literal>
</term><listitem><indexterm role="cp"><primary>pica</primary></indexterm>
<indexterm role="fn"><primary>pc</primary></indexterm>
-<para>Pica, 12 pt
+<anchor id="units-of-length-pc"/><para>Pica, 12 pt
</para>
</listitem></varlistentry><varlistentry><term><literal>in</literal>
</term><listitem><indexterm role="fn"><primary>in</primary></indexterm>
<indexterm role="fn"><primary>inch</primary></indexterm>
-<para>Inch, 72.27 pt
+<anchor id="units-of-length-in"/><para>Inch, 72.27 pt
</para>
</listitem></varlistentry><varlistentry><term><literal>bp</literal>
</term><listitem><indexterm role="fn"><primary>bp</primary></indexterm>
<indexterm role="cp"><primary>Big point</primary></indexterm>
-<para>Big point, 1/72 inch. This length is the definition of a point in
+<anchor id="units-of-length-bp"/><para>Big point, 1/72 inch. This length is the definition of a point in
PostScript and many desktop publishing systems.
</para>
</listitem></varlistentry><varlistentry><term><literal>cm</literal>
</term><listitem><indexterm role="cp"><primary>Centimeter</primary></indexterm>
<indexterm role="fn"><primary>cm</primary></indexterm>
-<para>Centimeter
+<anchor id="units-of-length-cm"/><para>Centimeter
</para>
</listitem></varlistentry><varlistentry><term><literal>mm</literal>
</term><listitem><indexterm role="cp"><primary>Millimeter</primary></indexterm>
<indexterm role="fn"><primary>mm</primary></indexterm>
-<para>Millimeter
+<anchor id="units-of-length-mm"/><para>Millimeter
</para>
</listitem></varlistentry><varlistentry><term><literal>dd</literal>
</term><listitem><indexterm role="cp"><primary>Didot point</primary></indexterm>
<indexterm role="fn"><primary>dd</primary></indexterm>
-<para>Didot point, 1.07 pt
+<anchor id="units-of-length-dd"/><para>Didot point, 1.07 pt
</para>
</listitem></varlistentry><varlistentry><term><literal>cc</literal>
</term><listitem><indexterm role="cp"><primary>Cicero</primary></indexterm>
<indexterm role="fn"><primary>cc</primary></indexterm>
-<para>Cicero, 12 dd
+<anchor id="units-of-length-cc"/><para>Cicero, 12 dd
</para>
</listitem></varlistentry><varlistentry><term><literal>sp</literal>
</term><listitem><indexterm role="cp"><primary>Scaled point</primary></indexterm>
<indexterm role="fn"><primary>sp</primary></indexterm>
-<para>Scaled point, 1/65536 pt
+<anchor id="units-of-length-sp"/><para>Scaled point, 1/65536 pt
</para>
</listitem></varlistentry></variablelist>
<indexterm role="cp"><primary>ex</primary></indexterm>
@@ -7018,9 +8984,9 @@ PostScript and many desktop publishing systems.
<indexterm role="cp"><primary>m-width</primary></indexterm>
<indexterm role="cp"><primary>em</primary></indexterm>
<indexterm role="fn"><primary>em</primary></indexterm>
-<para>Two other lengths that are often used are values set by the designer of
+<anchor id="Lengths_002fem"/><anchor id="Lengths_002fen"/><anchor id="Lengths_002fex"/><anchor id="units-of-length-em"/><anchor id="units-of-length-en"/><anchor id="units-of-length-ex"/><para>Two other lengths that are often used are values set by the designer of
the font. The x-height of the current font <firstterm>ex</firstterm>, traditionally the
-height of the lower case letter x, is often used for vertical
+height of the lowercase letter x, is often used for vertical
lengths. Similarly <firstterm>em</firstterm>, traditionally the width of the capital
letter M, is often used for horizontal lengths (there is also
<literal>\enspace</literal>, which is <literal>0.5em</literal>). Use of these can help make a
@@ -7046,13 +9012,24 @@ math symbols family. See <link linkend="Spacing-in-math-mode">Spacing in math m
<para>Synopsis:
</para>
-<screen>\setlength{<replaceable>\len</replaceable>}{<replaceable>amount</replaceable>}
+<screen>\setlength{<replaceable>len</replaceable>}{<replaceable>amount</replaceable>}
+</screen>
+<para>Set the length <replaceable>len</replaceable> to <replaceable>amount</replaceable>. The length name <replaceable>len</replaceable>
+must begin with a backslash, <literal>\</literal>. The <literal>amount</literal> can be a
+rubber length (see <link linkend="Lengths">Lengths</link>). It can be positive, negative or zero,
+and can be in any units that &latex; understands (see <link linkend="Units-of-length">Units of
+length</link>).
+</para>
+<para>Below, with &latex;&#8217;s defaults the first paragraph will be indented
+while the second will not.
+</para>
+<screen>I told the doctor I broke my leg in two places.
+
+\setlength{\parindent}{0em}
+He said stop going to those places.
</screen>
-<para>The <literal>\setlength</literal> sets the value of <firstterm>length command</firstterm>
-<indexterm role="cp"><primary>length command</primary></indexterm>
-<literal>\<replaceable>len</replaceable></literal> to the <replaceable>value</replaceable> argument which can be expressed in any
-units that &latex; understands, i.e., inches (<literal>in</literal>), millimeters
-(<literal>mm</literal>), points (<literal>pt</literal>), big points (<literal>bp</literal>), etc.
+<para>If there is no such length <replaceable>len</replaceable> then you get something like
+&#8216;<literal>Undefined control sequence. &lt;argument&gt; \praindent</literal>&#8217;.
</para>
</sect1>
@@ -7064,12 +9041,28 @@ units that &latex; understands, i.e., inches (<literal>in</literal>), millimeter
<para>Synopsis:
</para>
-<screen>\addtolength{<replaceable>\len</replaceable>}{<replaceable>amount</replaceable>}
+<screen>\addtolength{<replaceable>len</replaceable>}{<replaceable>amount</replaceable>}
</screen>
+<para>Increment the length <replaceable>len</replaceable> by <replaceable>amount</replaceable>. The length name
+<replaceable>len</replaceable> begins with a backslash, <literal>\</literal>. The <literal>amount</literal> is a
+rubber length (see <link linkend="Lengths">Lengths</link>). It can be positive, negative or zero,
+and can be in any units that &latex; understands (see <link linkend="Units-of-length">Units of
+length</link>).
+</para>
+<para>Below, if <literal>\parskip</literal> starts with the value <literal>0pt plus 1pt</literal>
+</para>
+<screen>\addtolength{\parskip}{1pt}
+Doctor: how is the boy who swallowed the silver dollar?
-<para>The <literal>\addtolength</literal> command increments a length command <literal>\<replaceable>len</replaceable></literal>
-by the amount specified in the <replaceable>amount</replaceable> argument, which may be
-negative.
+Nurse: no change.
+</screen>
+<para>then it has the value <literal>1pt plus 1pt</literal> for the second paragraph.
+</para>
+<para>If there is no such length <replaceable>len</replaceable> then you get something like
+&#8216;<literal>Undefined control sequence. &lt;argument&gt; \praindent</literal>&#8217;. If you leave
+off the backslash at the start of <replaceable>len</replaceable>, as in
+<literal>\addtolength{parindent}{1pt}</literal>, then you get something like
+&#8216;<literal>You can't use `the letter p' after \advance</literal>&#8217;.
</para>
</sect1>
@@ -7080,10 +9073,23 @@ negative.
<para>Synopsis:
</para>
-<screen>\settodepth{\<replaceable>len</replaceable>}{<replaceable>text</replaceable>}
+<screen>\settodepth{<replaceable>len</replaceable>}{<replaceable>text</replaceable>}
</screen>
-<para>The <literal>\settodepth</literal> command sets the value of a length command
-<literal>\<replaceable>len</replaceable></literal> equal to the depth of the <replaceable>text</replaceable> argument.
+<para>Set the length <replaceable>len</replaceable> to the depth of box that &latex; gets on
+typesetting the <replaceable>text</replaceable> argument. The length name <replaceable>len</replaceable> must
+begin with a backslash, <literal>\</literal>.
+</para>
+<para>This will show how low the character descenders go.
+</para>
+<screen>\newlength{\alphabetdepth}
+\settodepth{\alphabetdepth}{abcdefghijklmnopqrstuvwxyz}
+\the\alphabetdepth
+</screen>
+<para>If there is no such length <replaceable>len</replaceable> then you get something like
+&#8216;<literal>Undefined control sequence. &lt;argument&gt; \alphabetdepth</literal>&#8217;. If you
+leave the backslash out of <replaceable>len</replaceable>, as in
+<literal>\settodepth{alphabetdepth}{...}</literal> then you get something like
+&#8216;<literal>Missing number, treated as zero. &lt;to be read again&gt; \setbox</literal>&#8217;.
</para>
</sect1>
@@ -7094,54 +9100,80 @@ negative.
<para>Synopsis:
</para>
-<screen>\settoheight{\<replaceable>len</replaceable>}{text}
+<screen>\settoheight{<replaceable>len</replaceable>}{text}
</screen>
-<para>The <literal>\settoheight</literal> command sets the value of a length command <literal>\<replaceable>len</replaceable></literal>
-equal to the height of the <literal>text</literal> argument.
+<para>Sets the length <replaceable>len</replaceable> to the height of box that &latex; gets on
+typesetting the <literal>text</literal> argument. The length name <replaceable>len</replaceable> must
+begin with a backslash, <literal>\</literal>.
+</para>
+<para>This will show how high the characters go.
+</para>
+<screen>\newlength{\alphabetheight}
+\settoheight{\alphabetheight}{abcdefghijklmnopqrstuvwxyz}
+\the\alphabetheight
+</screen>
+<para>If there is no such length <replaceable>len</replaceable> then you get something like
+&#8216;<literal>Undefined control sequence. &lt;argument&gt; \alphabetheight</literal>&#8217;. If you
+leave the backslash out of <replaceable>len</replaceable>, as in
+<literal>\settoheight{alphabetheight}{...}</literal> then you get something like
+&#8216;<literal>Missing number, treated as zero. &lt;to be read again&gt; \setbox</literal>&#8217;.
</para>
-
</sect1>
<sect1 label="14.6" id="_005csettowidth">
-<title><literal>\settowidth{\<replaceable>len</replaceable>}{<replaceable>text</replaceable>}</literal></title>
+<title><literal>\settowidth</literal></title>
<indexterm role="fn"><primary>\settowidth</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\settowidth{\<replaceable>len</replaceable>}{<replaceable>text</replaceable>}
+<screen>\settowidth{<replaceable>len</replaceable>}{<replaceable>text</replaceable>}
+</screen>
+<para>Set the length <replaceable>len</replaceable> to the width of the box that &latex; gets on
+typesetting the <replaceable>text</replaceable> argument. The length name <replaceable>len</replaceable> must
+begin with a backslash, <literal>\</literal>.
+</para>
+<para>This measures the width of the lowercase ASCII alphabet.
+</para>
+<screen>\newlength{\alphabetwidth}
+\settowidth{\alphabetwidth}{abcdefghijklmnopqrstuvwxyz}
+\the\alphabetwidth
</screen>
-<para>The <literal>\settowidth</literal> command sets the value of the command <replaceable>\len</replaceable>
-to the width of the <replaceable>text</replaceable> argument.
+<para>If there is no such length <replaceable>len</replaceable> then you get something like
+&#8216;<literal>Undefined control sequence. &lt;argument&gt; \alphabetwidth</literal>&#8217;. If you
+leave the backslash out of <replaceable>len</replaceable>, as in
+<literal>\settoheight{alphabetwidth}{...}</literal> then you get something like
+&#8216;<literal>Missing number, treated as zero. &lt;to be read again&gt; \setbox</literal>&#8217;.
</para>
-</sect1>
-<sect1 label="14.7" id="Predefined-lengths">
-<title>Predefined lengths</title>
+<!-- @node Predefined lengths -->
+<!-- @section Predefined lengths -->
-<indexterm role="cp"><primary>lengths, predefined</primary></indexterm>
-<indexterm role="cp"><primary>predefined lengths</primary></indexterm>
+<!-- @cindex lengths, predefined -->
+<!-- @cindex predefined lengths -->
+
+<!-- @code{\width} -->
+<!-- @findex \width -->
+
+<!-- @code{\height} -->
+<!-- @findex \height -->
+
+<!-- @code{\depth} -->
+<!-- @findex \depth -->
+
+<!-- @code{\totalheight} -->
+<!-- @findex \totalheight -->
+
+<!-- These length parameters can be used in the arguments of the box-making -->
+<!-- commands (@pxref{Boxes}). They specify the natural width, etc., of the -->
+<!-- text in the box. @code{\totalheight} equals -->
+<!-- @math{@code{@backslashchar{}height} + @code{@backslashchar{}depth}}. To -->
+<!-- make a box with the text stretched to double the natural size, e.g., say -->
+
+<!-- @example -->
+<!-- \makebox[2\width]@{Get a stretcher@} -->
+<!-- @end example -->
-<para><literal>\width</literal>
-<indexterm role="fn"><primary>\width</primary></indexterm>
-</para>
-<para><literal>\height</literal>
-<indexterm role="fn"><primary>\height</primary></indexterm>
-</para>
-<para><literal>\depth</literal>
-<indexterm role="fn"><primary>\depth</primary></indexterm>
-</para>
-<para><literal>\totalheight</literal>
-<indexterm role="fn"><primary>\totalheight</primary></indexterm>
-</para>
-<para>These length parameters can be used in the arguments of the box-making
-commands (see <link linkend="Boxes">Boxes</link>). They specify the natural width, etc., of
-the text in the box. <literal>\totalheight</literal> equals <inlineequation><mathphrase><literal>&#92;height</literal> +
-<literal>&#92;depth</literal></mathphrase></inlineequation>. To make a box with the text stretched to double the
-natural size, e.g., say
-</para>
-<screen>\makebox[2\width]{Get a stretcher}
-</screen>
</sect1>
</chapter>
@@ -7151,58 +9183,192 @@ natural size, e.g., say
<indexterm role="cp"><primary>making paragraphs</primary></indexterm>
<indexterm role="cp"><primary>paragraphs</primary></indexterm>
-<para>A paragraph is ended by one or more completely blank lines&#8212;lines not
-containing even a <literal>%</literal>. A blank line should not appear where a new
-paragraph cannot be started, such as in math mode or in the argument of
-a sectioning command.
+<para>Once &latex; has all of a paragraph&#8217;s contents it divides it into
+lines, in a way that is optimized over the entire paragraph (see <link linkend="Line-breaking">Line
+breaking</link>). To end the current paragraph, put an empty line.
+</para>
+<screen>It is a truth universally acknowledged, that a single man in possession
+of a good fortune, must be in want of a wife.
+
+However little known the feelings or views of such a man may be on his
+first entering a neighbourhood, this truth is so well fixed in the minds
+of the surrounding families, that he is considered the rightful property
+of some one or other of their daughters.
+
+``My dear Mr. Bennet,'' said his lady to him one day,
+``have you heard that Netherfield Park is let at last?''
+</screen>
+<para>The separator lines must be empty, including not containing a comment
+character, <literal>%</literal>.
+</para>
+<para>There are places where a new paragraph is not permitted. Don&#8217;t put a
+blank line in math mode (see <link linkend="Modes">Modes</link>); here the line before the
+<literal>\end{equation}</literal>
+</para>
+<screen>\begin{equation}
+ 2^{|S|} &gt; |S|
+
+\end{equation}
+</screen>
+<para>will get you the error &#8216;<literal>Missing $ inserted</literal>&#8217;. Similarly, the blank
+line in this <literal>section</literal> argument
</para>
+<screen>\section{aaa
+bbb}
+</screen>
+<para>gets &#8216;<literal>Runaway argument? {aaa ! Paragraph ended before \@sect was
+complete</literal>&#8217;.
+</para>
-<sect1 label="15.1" id="_005cindent">
-<title><literal>\indent</literal></title>
-<indexterm role="fn"><primary>\indent</primary></indexterm>
-<indexterm role="fn"><primary>\parindent</primary></indexterm>
-<indexterm role="cp"><primary>indent, forcing</primary></indexterm>
-<para><literal>\indent</literal> produces a horizontal space whose width equals to the
-<literal>\parindent</literal> length, the normal paragraph indentation. It is used
-to add paragraph indentation where it would otherwise be suppressed.
+<sect1 label="15.1" id="_005cpar">
+<title><literal>\par</literal></title>
+
+<indexterm role="fn"><primary>\par</primary></indexterm>
+<indexterm role="cp"><primary>paragraph, ending</primary></indexterm>
+
+<para>Synopsis (note that while reading the input &tex;, converts two
+consecutive newlines to a <literal>\par</literal>):
</para>
-<para>The default value for <literal>\parindent</literal> is <literal>1em</literal> in two-column
-mode, otherwise <literal>15pt</literal> for <literal>10pt</literal> documents, <literal>17pt</literal> for
-<literal>11pt</literal>, and <literal>1.5em</literal> for <literal>12pt</literal>.
+<screen>\par
+</screen>
+<para>End the current paragraph. The usual way to separate paragraphs is with
+a blank line but the <literal>\par</literal> command is entirely equivalent. This
+command is robust (see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>This example uses <literal>\par</literal> rather than a blank line simply for
+readability.
+</para>
+<screen>\newcommand{\syllabusLegalese}{%
+ \whatCheatingIs\par\whatHappensWhenICatchYou}
+</screen>
+<para>The <literal>\par</literal> command does nothing in LR mode or a vertical mode but
+it terminates paragraph mode, bringing &latex; to vertical mode
+(see <link linkend="Modes">Modes</link>).
+</para>
+<para>You cannot use the <literal>\par</literal> command in math mode or in the argument
+of many commands, such as the <literal>\section</literal> command (see <link linkend="Making-paragraphs">Making
+paragraphs</link> and see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link>).
+</para>
+<para>The <literal>\par</literal> command differs from the <literal>\paragraph</literal> command in
+that the latter is, like <literal>\section</literal> or <literal>\subsection</literal>, a
+sectioning unit used by the standard &latex; documents.
+</para>
+<para>The <literal>\par</literal> command differs from <literal>\newline</literal> and the line break
+double backslash, <literal>\\</literal>, in that \par ends the paragraph not just
+the line. It also triggers the addition of the between-paragraph
+vertical space <literal>\parskip</literal> (see <link linkend="_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</link>).
+</para>
+<para>The output from this example
+</para>
+<screen>xyz
+
+\setlength{\parindent}{3in}
+\setlength{\parskip}{5in}
+\noindent test\indent test1\par test2
+</screen>
+<para>is: after &#8216;<literal>xyz</literal>&#8217; there is a vertical skip of 5&#160;inches and then
+&#8216;<literal>test</literal>&#8217; appears, aligned with the left margin. On the same line,
+there is an empty horizontal space of 3&#160;inches and then
+&#8216;<literal>test1</literal>&#8217; appears. Finally. there is a vertical space of
+5&#160;inches, followed by a fresh paragraph with a paragraph indent of
+3&#160;inches, and then &latex; puts the text &#8216;<literal>test2</literal>&#8217;.
</para>
</sect1>
-<sect1 label="15.2" id="_005cnoindent">
-<title><literal>\noindent</literal></title>
+<sect1 label="15.2" id="_005cindent-_0026-_005cnoindent">
+<title><literal>\indent</literal> &amp; <literal>\noindent</literal></title>
+<indexterm role="fn"><primary>\indent</primary></indexterm>
<indexterm role="fn"><primary>\noindent</primary></indexterm>
-<indexterm role="cp"><primary>indent, suppressing</primary></indexterm>
+<indexterm role="fn"><primary>\parindent</primary></indexterm>
+<indexterm role="cp"><primary>indent, forcing</primary></indexterm>
-<para>When used at the beginning of the paragraph, this command suppresses any
-paragraph indentation, as in this example.
+<para>Synopsis:
+</para>
+<screen>\indent
+</screen>
+<para>or
+</para>
+<screen>\noindent
+</screen>
+<para>Go into horizontal mode (see <link linkend="Modes">Modes</link>). The <literal>\indent</literal> command
+first outputs an empty box whose width is <literal>\parindent</literal>. These
+commands are robust (see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>Ordinarily you create a new paragraph by putting in a blank line.
+See <link linkend="_005cpar">\par</link> for the difference between this command and <literal>\par</literal>. To
+start a paragraph without an indent, or to continue an interrupted
+paragraph, use <literal>\noindent</literal>.
+</para>
+<para>In the middle of a paragraph the <literal>\noindent</literal> command has no effect,
+because &latex; is already in horizontal mode there. The
+<literal>\indent</literal> command&#8217;s only effect is to output a space.
+</para>
+<para>This example starts a fresh paragraph.
</para>
<screen>... end of the prior paragraph.
\noindent This paragraph is not indented.
</screen>
-<para>It has no effect when used in the middle of a paragraph.
+<para>and this continues an interrupted paragraph.
</para>
-<para>To eliminate paragraph indentation in an entire document, put
-<literal>\setlength{\parindent}{0pt}</literal> in the preamble.
+<screen>The data
+
+\begin{center}
+ \begin{tabular}{rl} ... \end{tabular}
+\end{center}
+
+\noindent shows this clearly.
+</screen>
+<para>To omit indentation in the entire document put
+<literal>\setlength{\parindent}{0pt}</literal> in the preamble. If you do that,
+you may want to also set the length of spaces between paragraphs,
+<literal>\parskip</literal> (see <link linkend="_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</link>).
+</para>
+<indexterm role="cp"><primary>package, <literal>indentfirst</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>indentfirst</literal> package</primary></indexterm>
+
+<para>Default &latex; styles have the first paragraph after a section that is
+not indented, as is traditional typesetting in English. To change that,
+look on CTAN for the package <literal>indentfirst</literal>.
</para>
</sect1>
-<sect1 label="15.3" id="_005cparskip">
-<title><literal>\parskip</literal></title>
+<sect1 label="15.3" id="_005cparindent-_0026-_005cparskip">
+<title><literal>\parindent</literal> &amp; <literal>\parskip</literal></title>
+<indexterm role="fn"><primary>\parindent</primary></indexterm>
<indexterm role="fn"><primary>\parskip</primary></indexterm>
+<indexterm role="cp"><primary>paragraph indentation</primary></indexterm>
<indexterm role="cp"><primary>vertical space before paragraphs</primary></indexterm>
-<para><literal>\parskip</literal> is a rubber length defining extra vertical space added
-before each paragraph. The default is <literal>0pt plus1pt</literal>.
+<para>Synopsis:
+</para>
+<screen>\setlength{\parskip}{<replaceable>horizontal len</replaceable>}
+\setlength{\parinden}{<replaceable>vertical len</replaceable>}
+</screen>
+<para>Both are a rubber lengths (see <link linkend="Lengths">Lengths</link>). They give the indentation
+of ordinary paragraphs, not paragraphs inside minipages
+(see <link linkend="minipage">minipage</link>), and the vertical space between paragraphs.
+</para>
+<para>This, put in the preamble,
+</para>
+<screen>\setlength{\parindent}{0em}
+\setlength{\parskip}{1ex}
+</screen>
+<para>arranges that the document will have paragraphs that are not indented,
+but instead are vertically separated by about the height of a lowercase
+&#8216;<literal>x</literal>&#8217;.
+</para>
+<para>In standard &latex; documents, the default value for <literal>\parindent</literal>
+in one-column documents is <literal>15pt</literal> when the default text size is
+<literal>10pt</literal> , <literal>17pt</literal> for <literal>11pt</literal>, and <literal>1.5em</literal> for
+<literal>12pt</literal>. In two-column documents it is <literal>1em</literal>. The default
+value for <literal>\parskip</literal> in &latex;&#8217;s standard document styles is
+<literal>0pt plus1pt</literal>.
</para>
</sect1>
@@ -7214,45 +9380,50 @@ before each paragraph. The default is <literal>0pt plus1pt</literal>.
<indexterm role="cp"><primary>remarks in the margin</primary></indexterm>
<indexterm role="fn"><primary>\marginpar</primary></indexterm>
-<para>Synopsis:
+<para>Synopsis, one of:
</para>
-<screen>\marginpar[<replaceable>left</replaceable>]{<replaceable>right</replaceable>}
+<screen>\marginpar{<replaceable>right</replaceable>}
+\marginpar[<replaceable>left</replaceable>]{<replaceable>right</replaceable>}
</screen>
-<para>The <literal>\marginpar</literal> command creates a note in the margin. The first
-line of the note will have the same baseline as the line in the text
-where the <literal>\marginpar</literal> occurs.
+<para>Create a note in the margin. The first line of the note will have the
+same baseline as the line in the text where the <literal>\marginpar</literal>
+occurs.
</para>
-<para>When you only specify the mandatory argument <replaceable>right</replaceable>, the text
-will be placed
+<para>The margin that &latex; uses for the note depends on the current layout
+(see <link linkend="Document-class-options">Document class options</link>) and also on <literal>\reversemarginpar</literal>
+(see below). If you are using one-sided layout (document option
+<literal>oneside</literal>) then it goes in the right margin. If you are using
+two-sided layout (document option <literal>twoside</literal>) then it goes in the
+outside margin. If you are in two-column layout (document option
+<literal>twocolumn</literal>) then it goes in the nearest margin.
</para>
-<itemizedlist><listitem><para>in the right margin for one-sided layout (option <literal>oneside</literal>, see <link linkend="Document-class-options">Document class options</link>);
-</para></listitem><listitem><para>in the outside margin for two-sided layout (option <literal>twoside</literal>, see <link linkend="Document-class-options">Document class options</link>);
-</para></listitem><listitem><para>in the nearest margin for two-column layout (option <literal>twocolumn</literal>, see <link linkend="Document-class-options">Document class options</link>).
-</para></listitem></itemizedlist>
<indexterm role="fn"><primary>\reversemarginpar</primary></indexterm>
<indexterm role="fn"><primary>\normalmarginpar</primary></indexterm>
-<para>The command <literal>\reversemarginpar</literal> places subsequent marginal notes
-in the opposite (inside) margin. <literal>\normalmarginpar</literal> places them
-in the default position.
+<para>If you declare <literal>\reversemarginpar</literal> then &latex; will place
+subsequent marginal notes in the opposite margin to that given in the
+prior paragraph. Revert that to the default position with
+<literal>\normalmarginpar</literal>.
</para>
-<para>When you specify both arguments, <replaceable>left</replaceable> is used for the left
-margin, and <replaceable>right</replaceable> is used for the right margin.
+<para>When you specify the optional argument <replaceable>left</replaceable> then it is used for a
+note in the left margin, while the mandatory argument <replaceable>right</replaceable> is
+used for a note in the the right margin.
</para>
-<para>The first word will normally not be hyphenated; you can enable
-hyphenation there by beginning the node with <literal>\hspace{0pt}</literal>.
+<para>Normally, a note&#8217;s first word will not be hyphenated. You can enable
+hyphenation there by beginning <replaceable>left</replaceable> or <replaceable>right</replaceable> with
+<literal>\hspace{0pt}</literal>.
</para>
<para>These parameters affect the formatting of the note:
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\marginparpush</primary></indexterm><literal>\marginparpush</literal>
-</term><listitem><para>Minimum vertical space between notes; default &#8216;<literal>7pt</literal>&#8217; for
+</term><listitem><anchor id="marginal-notes-marginparpush"/><para>Minimum vertical space between notes; default &#8216;<literal>7pt</literal>&#8217; for
&#8216;<literal>12pt</literal>&#8217; documents, &#8216;<literal>5pt</literal>&#8217; else.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\marginparsep</primary></indexterm><literal>\marginparsep</literal>
-</term><listitem><para>Horizontal space between the main text and the note; default
+</term><listitem><anchor id="marginal-notes-marginparsep"/><para>Horizontal space between the main text and the note; default
&#8216;<literal>11pt</literal>&#8217; for &#8216;<literal>10pt</literal>&#8217; documents, &#8216;<literal>10pt</literal>&#8217; else.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\marginparwidth</primary></indexterm><literal>\marginparwidth</literal>
-</term><listitem><para>Width of the note itself; default for a one-sided &#8216;<literal>10pt</literal>&#8217; document
+</term><listitem><anchor id="marginal-notes-marginparwidth"/><para>Width of the note itself; default for a one-sided &#8216;<literal>10pt</literal>&#8217; document
is &#8216;<literal>90pt</literal>&#8217;, &#8216;<literal>83pt</literal>&#8217; for &#8216;<literal>11pt</literal>&#8217;, and &#8216;<literal>68pt</literal>&#8217; for
&#8216;<literal>12pt</literal>&#8217;; &#8216;<literal>17pt</literal>&#8217; more in each case for a two-sided document.
In two column mode, the default is &#8216;<literal>48pt</literal>&#8217;.
@@ -7283,51 +9454,105 @@ notes from falling off the bottom of the page.
<indexterm role="fn"><primary><literal>equation</literal> environment</primary></indexterm>
-<para>There are three environments that put &latex; in math mode:
+<para>Produce mathematical text by putting &latex; into math mode or display
+math mode (see <link linkend="Modes">Modes</link>). This example shows both.
</para>
-<variablelist><varlistentry><term><literal>math</literal>
-</term><listitem><para>For formulas that appear right in the text.
-</para></listitem></varlistentry><varlistentry><term><literal>displaymath</literal>
-</term><listitem><para>For formulas that appear on their own line.
-</para></listitem></varlistentry><varlistentry><term><literal>equation</literal>
-</term><listitem><para>The same as the displaymath environment except that it adds an equation
-number in the right margin.
-</para></listitem></varlistentry></variablelist>
-<indexterm role="fn"><primary>\(</primary></indexterm>
-<indexterm role="fn"><primary>\)</primary></indexterm>
-<indexterm role="fn"><primary>\[</primary></indexterm>
-<indexterm role="fn"><primary>\]</primary></indexterm>
-<para>The <literal>math</literal> environment can be used in both paragraph and LR mode,
-but the <literal>displaymath</literal> and <literal>equation</literal> environments can be used
-only in paragraph mode. The <literal>math</literal> and <literal>displaymath</literal>
-environments are used so often that they have the following short forms:
+<screen>The wave equation for \( u \) is
+\begin{displaymath}
+ \frac{\partial^2u}{\partial t^2} = c^2\nabla^2u
+\end{displaymath}
+where \( \nabla^2 \) is the spatial Laplacian and \( c \) is constant.
+</screen>
+<para>Math mode is for inline mathematics. In the above example it is invoked
+by the starting <literal>\(</literal> and finished by the matching ending <literal>\)</literal>.
+Display math mode is for displayed equations and here is invoked by the
+<literal>displaymath</literal> environment. Note that any mathematical text
+whatever, including mathematical text consisting of just one character,
+is handled in math mode.
+</para>
+<para>When in math mode or display math mode, &latex; handles many aspects of
+your input text differently than in other text modes. For example,
</para>
-<screen>\(...\) instead of \begin{math}...\end{math}
-\[...\] instead of \begin{displaymath}...\end{displaymath}
+<screen>contrast x+y with \( x+y \)
</screen>
-<indexterm role="fn"><primary>$</primary></indexterm>
-<para>In fact, the <literal>math</literal> environment is so common that it has an even
-shorter form:
+<para>in math mode the letters are in italics and the spacing around the plus
+sign is different.
</para>
-<screen>$ ... $ instead of \(...\)
+<para>There are three ways to make inline formulas, to put &latex; in math
+mode.
+</para>
+<screen>\( <replaceable>mathematical material</replaceable> \)
+$ <replaceable>mathematical material</replaceable> $
+\begin{math} <replaceable>mathematical material</replaceable> \end{math}
</screen>
-<indexterm role="fn"><primary>\boldmath</primary></indexterm>
-<indexterm role="fn"><primary>\unboldmath</primary></indexterm>
-<para>The <literal>\boldmath</literal> command changes math letters and symbols to be in
-a bold font. It is used <emphasis>outside</emphasis> of math mode. Conversely, the
-<literal>\unboldmath</literal> command changes math glyphs to be in a normal font;
-it too is used <emphasis>outside</emphasis> of math mode.
+<para>The first form is preferred and the second is quite common, but the
+third form is rarely used. You can sometimes use one and sometimes
+another, as in <literal>\(x\) and $y$</literal>. You can use these in paragraph
+mode or in LR mode (see <link linkend="Modes">Modes</link>).
</para>
-<!-- xx own section? Math fonts? -->
-<indexterm role="fn"><primary>\displaystyle</primary></indexterm>
-<para>The <literal>\displaystyle</literal> declaration forces the size and style of the
-formula to be that of <literal>displaymath</literal>, e.g., with limits above and
-below summations. For example:
+<para>To make displayed formulas, put &latex; into display math mode with
+either:
</para>
-<screen>$\displaystyle \sum_{n=0}^\infty x_n $
+<screen>\begin{displaymath}
+ <replaceable>mathematical material</replaceable>
+\end{displaymath}
</screen>
-<!-- xx see also \cal, \mathcal -->
+<para>or
+</para>
+<screen>\begin{equation}
+ <replaceable>mathematical material</replaceable>
+\end{equation}
+</screen>
+<para>(see <link linkend="displaymath">displaymath</link>, see <link linkend="equation">equation</link>). The only difference is that
+with the <literal>equation</literal> environment, &latex; puts a formula number
+alongside the formula. The construct <literal>\[ <replaceable>math</replaceable> \]</literal> is
+equivalent to <literal>\begin{displaymath} <replaceable>math</replaceable>
+\end{displaymath}</literal>. These environments can only be used in paragraph
+mode (see <link linkend="Modes">Modes</link>).
+</para>
+<indexterm role="fn"><primary>\displaystyle</primary></indexterm>
+<para>The two mathematics modes are similar, but there are some differences.
+One involves the placement of subscripts and superscripts; in display
+math mode they are further apart and in inline math mode they are closer
+together.
+</para>
+<para>Sometimes you want the display math typographical treatment to happen in
+the inline math mode. For this, the <literal>\displaystyle</literal> declaration
+forces the size and style of the formula to be that of
+<literal>displaymath</literal>. Thus <literal>\(\displaystyle \sum_{n=0}^\infty
+x_n\)</literal> will have the limits above and below the summation sign, not next
+to it. Another example is that
+</para>
+<screen>\begin{tabular}{r|cc}
+ \textsc{Name} &amp;\textsc{Series} &amp;\textsc{Sum} \\ \hline
+ Arithmetic &amp;\( a+(a+b)+(a+2b)+\cdots+(a+(n-1)b) \)
+ &amp;\( na+(n-1)n\cdot\frac{b}{2}\) \\
+ Geometric &amp;\( a+ab+ab^2+\cdots+ab^{n-1} \)
+ &amp;\(\displaystyle a\cdot\frac{1-b^n}{1-b}\) \\
+\end{tabular}
+</screen>
+<para>because it has no <literal>\displaystyle</literal>, the &#8216;<literal>Arithmetic</literal>&#8217; line&#8217;s
+fraction will be scrunched. But, because of its <literal>\displaystyle</literal>,
+the &#8216;<literal>Geometric</literal>&#8217; line&#8217;s fraction will be easy to read, with
+characters the same size as in the rest of the line.
+</para>
+<indexterm role="cp"><primary>package, <literal>amsmath</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>amsmath</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>amsfonts</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>amsfonts</literal> package</primary></indexterm>
+<indexterm role="cp"><primary>package, <literal>mathtools</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>mathtools</literal> package</primary></indexterm>
+
+<para>The American Mathematical Society has made freely available a set of
+packages that greatly expand your options for writing mathematics,
+<filename>amsmath</filename> and <filename>amssymb</filename> (also be aware of the <filename>mathtools</filename>
+package that is an extension to, and loads, <filename>amsmath</filename>). New
+documents that will have mathematical text should use these packages.
+Descriptions of these packages is outside the scope of this document;
+see their documentation on CTAN.
+</para>
<sect1 label="16.1" id="Subscripts-_0026-superscripts">
@@ -7339,38 +9564,69 @@ below summations. For example:
<indexterm role="fn"><primary>_</primary></indexterm>
<indexterm role="fn"><primary>^</primary></indexterm>
-<para>In math mode, use the caret character&#160;<literal>^</literal> to make the
-<replaceable>exp</replaceable> appear as a superscript: <literal>^{<replaceable>exp</replaceable>}</literal>.
-Similarly, in math mode, underscore&#160;<literal>_{<replaceable>exp</replaceable>}</literal> makes a
-subscript out of <replaceable>exp</replaceable>.
+<para>Synopsis (in math mode or display math mode), one of:
</para>
-<para>In this example the <literal>0</literal> and <literal>1</literal> appear as subscripts while the
-<literal>2</literal> is a superscript.
+<screen><replaceable>base</replaceable>^<replaceable>exp</replaceable>
+<replaceable>base</replaceable>^{<replaceable>exp</replaceable>}
+</screen>
+<para>or, one of:
</para>
-<screen>\( (x_0+x_1)^2 \)
+<screen><replaceable>base</replaceable>_<replaceable>exp</replaceable>
+<replaceable>base</replaceable>_{<replaceable>exp</replaceable>}
</screen>
-<para>To have more than one character in <replaceable>exp</replaceable> use curly braces as in
-<literal>e^{-2x}</literal>.
+<para>Make <replaceable>exp</replaceable> appear as a superscript of <replaceable>base</replaceable> (with the caret
+character,&#160;<literal>^</literal>) or a subscript (with
+underscore,&#160;<literal>_</literal>).
</para>
-<para>&latex; handles superscripts on superscripts, and all of that stuff, in
-the natural way, so expressions such as <literal>e^{x^2}</literal> and
-<literal>x_{a_0}</literal> will look right. It also does the right thing when
-something has both a subscript and a superscript. In this example the
-<literal>0</literal> appears at the bottom of the integral sign while the <literal>10</literal>
-appears at the top.
-</para>
-<screen>\int_0^{10} x^2 \,dx
+<para>In this example the <literal>0</literal>&#8217;s and <literal>1</literal>&#8217;s are subscripts while the
+<literal>2</literal>&#8217;s are superscripts.
+</para>
+<screen>\( (x_0+x_1)^2 \leq (x_0)^2+(x_1)^2 \)
+</screen>
+<para>To have the subscript or superscript contain more than one character,
+surround the expression with curly braces, as in <literal>e^{-2x}</literal>.
+This example&#8217;s fourth line shows curly braces used to group an expression
+for the exponent.
+</para>
+<screen>\begin{displaymath}
+ (3^3)^3=27^3=19\,683
+ \qquad
+ 3^{(3^3)}=3^{27}=7\,625\,597\,484\,987
+\end{displaymath}
+</screen>
+<para>&latex; knows how to handle a superscript on a superscript, or a
+subscript on a subscript, or supers on subs, or subs on supers. So,
+expressions such as <literal>e^{x^2}</literal> and <literal>x_{i_0}</literal> give correct
+output. Note the use in those expressions of curly braces to give the
+<replaceable>base</replaceable> a determined <replaceable>exp</replaceable>. If you enter <literal>\(3^3^3\)</literal> then
+you get &#8216;<literal>Double superscript</literal>&#8217;.
+</para>
+<para>&latex; does the right thing when something has both a subscript and a
+superscript. In this example the integral has both. They come out in
+the correct place without any author intervention.
+</para>
+<screen>\begin{displaymath}
+ \int_{x=a}^b f'(x)\,dx = f(b)-f(a)
+\end{displaymath}
</screen>
-<para>You can put a superscript or subscript before a symbol with a construct
-such as <literal>{}_t K^2</literal> in math mode (the initial <literal>{}</literal> prevents
-the prefixed subscript from being attached to any prior symbols in the
-expression).
+<para>Note the parentheses around <literal>x=a</literal> to make the entire expression a
+subscript.
+</para>
+<para>To put a superscript or subscript before a symbol, use a construct like
+<literal>{}_t K^2</literal>. The empty curly braces <literal>{}</literal> give the
+subscript something to attach to and keeps it from accidentally
+attaching to a prior symbols.
+</para>
+<para>Using the subscript or superscript command outside of math mode or
+display math mode, as in <literal>the expression x^2</literal>, will get you
+the error &#8216;<literal>Missing $ inserted</literal>&#8217;.
</para>
-<para>Outside of math mode, a construct like <literal>A
-test$_\textnormal{subscript}$</literal> will produce a subscript typeset in
-text mode, not math mode. Note that there are packages specialized for
-writing Chemical formulas such as <filename>mhchem</filename>.
-<!-- xx display mode -->
+<indexterm role="cp"><primary>package, <literal>mhchem</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>mhchem</literal> package</primary></indexterm>
+
+<para>A common reason to want subscripts outside of a mathematics mode is to
+typeset chemical formulas. There are packages for that such as
+<filename>mhchem</filename>; see CTAN.
</para>
</sect1>
@@ -7381,20 +9637,23 @@ writing Chemical formulas such as <filename>mhchem</filename>.
<indexterm role="cp"><primary>symbols, math</primary></indexterm>
<indexterm role="cp"><primary>greek letters</primary></indexterm>
-<para>&latex; provides almost any mathematical symbol you&#8217;re likely to need.
-For example, if you include <literal>$\pi$</literal> in your source, you will get
-the pi symbol &#x03C0;.
-</para>
-<para>Below is a list of commonly-available symbols. It is by no means an
-exhaustive list. Each symbol here is described with a short phrase, and
-its symbol class (which determines the spacing around it) is given in
-parenthesis. Unless said otherwise, the commands for these symbols can
-be used only in math mode.
+<indexterm role="cp"><primary>package, <literal>symbols</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>symbols</literal> package</primary></indexterm>
+
+
+<para>&latex; provides almost any mathematical or technical symbol that
+anyone uses. For example, if you include <literal>$\pi$</literal> in your source,
+you will get the pi symbol &#x03C0;. See the <filename>Comprehensive
+&latex; Symbol List</filename> at
+<ulink url="https://ctan.org/tex-archive/info/symbols/comprehensive/">https://ctan.org/tex-archive/info/symbols/comprehensive/</ulink>.
</para>
-<para>To redefine a command so that it can be used whatever the current mode,
-see <link linkend="_005censuremath">\ensuremath</link>.
+<para>Here is a list of commonly-used symbols. It is by no means exhaustive.
+Each symbol is described with a short phrase, and its symbol class,
+which determines the spacing around it, is given in parenthesis. Unless
+said otherwise, the commands for these symbols can be used only in math
+mode. To redefine a command so that it can be used whatever the current
+mode, see <link linkend="_005censuremath">\ensuremath</link>.
</para>
-
<!-- xx Add Negation: @code{} for negations of relevant symbols -->
<!-- Useful: http://www.w3.org/TR/WD-math-970515/section6.html -->
@@ -7405,7 +9664,7 @@ see <link linkend="_005censuremath">\ensuremath</link>.
</term><listitem><para>&#x2135; Aleph, transfinite cardinal (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\alpha</primary></indexterm><literal>\alpha</literal>
-</term><listitem><para>&#x03B1; Lower case Greek letter alpha (ordinary).
+</term><listitem><para>&#x03B1; Lowercase Greek letter alpha (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\amalg</primary></indexterm><literal>\amalg</literal>
</term><listitem><para>&#x2A3F; Disjoint union (binary)
@@ -7432,7 +9691,7 @@ sometimes reserved for cross-correlation.
<literal>\textbackslash</literal> for backslash outside of math mode.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\beta</primary></indexterm><literal>\beta</literal>
-</term><listitem><para>&#x03B2; Lower case Greek letter beta (ordinary).
+</term><listitem><para>&#x03B2; Lowercase Greek letter beta (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\bigcap</primary></indexterm><literal>\bigcap</literal>
</term><listitem><para>&#x22C2; Variable-sized, or n-ary, intersection (operator). Similar:
@@ -7502,7 +9761,7 @@ operator&#160;<literal>\bigcap</literal>.
dot&#160;<literal>\bullet</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\chi</primary></indexterm><literal>\chi</literal>
-</term><listitem><para>&#x03C7; Lower case Greek chi (ordinary).
+</term><listitem><para>&#x03C7; Lowercase Greek chi (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\circ</primary></indexterm><literal>\circ</literal>
</term><listitem><para>&#x2218; Function composition, ring operator (binary). Similar:
@@ -7513,8 +9772,8 @@ variable-sized operator&#160;<literal>\bigcirc</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\complement</primary></indexterm><literal>\complement</literal>
</term><listitem><para>&#x2201; Set complement, used as a superscript as in
-<literal>$S^\complement$</literal> (ordinary). Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package. Also
-used: <literal>$S^{\mathsf{c}}$</literal> or&#160;<literal>$\bar{S}$</literal>.
+<literal>$S^\complement$</literal> (ordinary). Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package. Also used:
+<literal>$S^{\mathsf{c}}$</literal> or&#160;<literal>$\bar{S}$</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\cong</primary></indexterm><literal>\cong</literal>
</term><listitem><para>&#x2245; Congruent (relation).
@@ -7537,17 +9796,16 @@ turnstile&#160;<literal>\vdash</literal>.
</term><listitem><para>&#x2021; Double dagger relation (binary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Delta</primary></indexterm><literal>\Delta</literal>
-</term><listitem><para>&#x0394; Greek upper case delta, used for increment (ordinary).
+</term><listitem><para>&#x0394; Greek uppercase delta, used for increment (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\delta</primary></indexterm><literal>\delta</literal>
-</term><listitem><para>&#x03B4; Greek lower case delta (ordinary).
+</term><listitem><para>&#x03B4; Greek lowercase delta (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Diamond</primary></indexterm><literal>\Diamond</literal>
</term><listitem><para>&#x25C7; Large diamond operator (ordinary). Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package.
-<!-- bb Best Unicode equivalent? -->
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\diamond</primary></indexterm><literal>\diamond</literal>
-</term><listitem><para>&#x22C4; Diamond operator, or diamond bullet (binary). Similar: large
+</term><listitem><para>&#x22C4; Diamond operator (binary). Similar: large
diamond&#160;<literal>\Diamond</literal>, circle bullet&#160;<literal>\bullet</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\diamondsuit</primary></indexterm><literal>\diamondsuit</literal>
@@ -7561,12 +9819,12 @@ diamond&#160;<literal>\Diamond</literal>, circle bullet&#160;<literal>\bullet</l
to&#160;<literal>\Doteq</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\downarrow</primary></indexterm><literal>\downarrow</literal>
-</term><listitem><para>&#x2193; Down arrow, converges (relation). Similar: double line down
-arrow&#160;<literal>\Downarrow</literal>.
+</term><listitem><para>&#x2193; Down arrow, converges (relation). Similar:
+<literal>\Downarrow</literal> double line down arrow.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Downarrow</primary></indexterm><literal>\Downarrow</literal>
-</term><listitem><para>&#x21D3; Double line down arrow (relation). Similar: single line down
-arrow&#160;<literal>\downarrow</literal>.
+</term><listitem><para>&#x21D3; Double line down arrow (relation). Similar:
+<literal>\downarrow</literal> single line down arrow.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\ell</primary></indexterm><literal>\ell</literal>
</term><listitem><para>&#x2113; Lowercase cursive letter l (ordinary).
@@ -7577,7 +9835,7 @@ arrow&#160;<literal>\downarrow</literal>.
<!-- bb Why Unicode has \revemptyset but no \emptyset? -->
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\epsilon</primary></indexterm><literal>\epsilon</literal>
-</term><listitem><para>&#x03F5; Lower case lunate epsilon (ordinary). Similar to
+</term><listitem><para>&#x03F5; Lowercase lunate epsilon (ordinary). Similar to
Greek text letter. More widely used in mathematics is the script small
letter epsilon <literal>\varepsilon</literal>&#160;&#x03B5;. Related:
the set membership relation <literal>\in</literal>&#160;&#x2208;.
@@ -7588,7 +9846,7 @@ the set membership relation <literal>\in</literal>&#160;&#x2208;.
</term><listitem><para>&#x2261; Equivalence (relation).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\eta</primary></indexterm><literal>\eta</literal>
-</term><listitem><para>&#x03B7; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03B7; Lowercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\exists</primary></indexterm><literal>\exists</literal>
</term><listitem><para>&#x2203; Existential quantifier (ordinary).
@@ -7603,10 +9861,10 @@ the set membership relation <literal>\in</literal>&#160;&#x2208;.
</term><listitem><para>&#x2322; Downward curving arc (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Gamma</primary></indexterm><literal>\Gamma</literal>
-</term><listitem><para>&#x0393; Upper case Greek letter (ordinary).
+</term><listitem><para>&#x0393; uppercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\gamma</primary></indexterm><literal>\gamma</literal>
-</term><listitem><para>&#x03B3; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03B3; Lowercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\ge</primary></indexterm><literal>\ge</literal>
</term><listitem><para>&#x2265; Greater than or equal to (relation). This is a synonym
@@ -7643,8 +9901,13 @@ with a <literal>\thickmuskip</literal> on either side.
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Im</primary></indexterm><literal>\Im</literal>
</term><listitem><para>&#x2111; Imaginary part (ordinary). See: real part&#160;<literal>\Re</literal>.
</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\imath</primary></indexterm><literal>\imath</literal>
+</term><listitem><indexterm role="cp"><primary>dotless i, math</primary></indexterm>
+<para>Dotless i; used when you are putting an accent on an i (see <link linkend="Math-accents">Math
+accents</link>).
+</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\in</primary></indexterm><literal>\in</literal>
-</term><listitem><para>&#x2208; Set element (relation). See also: lower case lunate
+</term><listitem><para>&#x2208; Set element (relation). See also: lowercase lunate
epsilon&#160;<literal>\epsilon</literal>&#x03F5; and small letter script
epsilon&#160;<literal>\varepsilon</literal>.
</para>
@@ -7655,20 +9918,25 @@ epsilon&#160;<literal>\varepsilon</literal>.
</term><listitem><para>&#x222B; Integral (operator).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\iota</primary></indexterm><literal>\iota</literal>
-</term><listitem><para>&#x03B9; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03B9; Lowercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Join</primary></indexterm><literal>\Join</literal>
</term><listitem><para>&#x2A1D; Condensed bowtie symbol (relation). Not available in Plain
&tex;.
</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\jmath</primary></indexterm><literal>\jmath</literal>
+</term><listitem><indexterm role="cp"><primary>dotless j, math</primary></indexterm>
+<para>Dotless j; used when you are putting an accent on a j (see <link linkend="Math-accents">Math
+accents</link>).
+</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\kappa</primary></indexterm><literal>\kappa</literal>
-</term><listitem><para>&#x03BA; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03BA; Lowercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Lambda</primary></indexterm><literal>\Lambda</literal>
-</term><listitem><para>&#x039B; Upper case Greek letter (ordinary).
+</term><listitem><para>&#x039B; uppercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\lambda</primary></indexterm><literal>\lambda</literal>
-</term><listitem><para>&#x03BB; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03BB; Lowercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\land</primary></indexterm><literal>\land</literal>
</term><listitem><para>&#x2227; Logical and (binary). This is a synonym for <literal>\wedge</literal>.
@@ -7789,7 +10057,7 @@ for&#160;<literal>\vert</literal> and for norm see the entry for&#160;<literal>\
</term><listitem><para>&#x2213; Minus or plus (relation).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mu</primary></indexterm><literal>\mu</literal>
-</term><listitem><para>&#x03BC; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03BC; Lowercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\nabla</primary></indexterm><literal>\nabla</literal>
</term><listitem><para>&#x2207; Hamilton&#8217;s del, or differential, operator (ordinary).
@@ -7817,20 +10085,20 @@ negation:&#160;<literal>\sim</literal>.
of&#160;<literal>\in</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\not</primary></indexterm><literal>\not</literal>
-</term><listitem><para>&#x0020;&#x00A0;&#x0338; Long solidus, or slash, used to overstrike a
+</term><listitem><!-- the "@ "s put in spaces so the not slash doesn't hit the next char. -->
+<para>&#x0020;&#160;&#160;&#160;&#160;Long solidus, or slash, used to overstrike a
following operator (relation).
-<!-- Need blank space for it to overstrike -->
</para>
-<para>Many negated operators that don&#8217;t require <literal>\not</literal> are available,
+<para>Many negated operators are available that don&#8217;t require <literal>\not</literal>,
particularly with the <filename>amssymb</filename> package. For example, <literal>\notin</literal>
-is probably typographically preferable to <literal>\not\in</literal>.
+is typographically preferable to <literal>\not\in</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\notin</primary></indexterm><literal>\notin</literal>
</term><listitem><para>&#x2209; Not an element of (relation). Similar: not subset
of&#160;<literal>\nsubseteq</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\nu</primary></indexterm><literal>\nu</literal>
-</term><listitem><para>&#x03BD; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03BD; Lowercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\nwarrow</primary></indexterm><literal>\nwarrow</literal>
</term><listitem><para>&#x2196; North-west arrow (relation).
@@ -7840,13 +10108,14 @@ of&#160;<literal>\nsubseteq</literal>.
operator&#160;<literal>\bigodot</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\oint</primary></indexterm><literal>\oint</literal>
-</term><listitem><para>&#x222E; Contour integral, integral with circle in the middle (operator).
+</term><listitem><para>&#x222E; Contour integral, integral with circle in the middle
+(operator).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Omega</primary></indexterm><literal>\Omega</literal>
-</term><listitem><para>&#x03A9; Upper case Greek letter (ordinary).
+</term><listitem><para>&#x03A9; uppercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\omega</primary></indexterm><literal>\omega</literal>
-</term><listitem><para>&#x03C9; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03C9; Lowercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\ominus</primary></indexterm><literal>\ominus</literal>
</term><listitem><para>&#x2296; Minus sign, or dash, inside a circle (binary).
@@ -7879,14 +10148,14 @@ same glyph but the spacing is different because it is in the class
ordinary.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\phi</primary></indexterm><literal>\phi</literal>
-</term><listitem><para>&#x03D5; Lower case Greek letter (ordinary). The variant form is
+</term><listitem><para>&#x03D5; Lowercase Greek letter (ordinary). The variant form is
<literal>\varphi</literal>&#160;&#x03C6;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Pi</primary></indexterm><literal>\Pi</literal>
-</term><listitem><para>&#x03A0; Upper case Greek letter (ordinary).
+</term><listitem><para>&#x03A0; uppercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\pi</primary></indexterm><literal>\pi</literal>
-</term><listitem><para>&#x03C0; Lower case Greek letter (ordinary). The variant form is
+</term><listitem><para>&#x03C0; Lowercase Greek letter (ordinary). The variant form is
<literal>\varpi</literal>&#160;&#x03D6;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\pm</primary></indexterm><literal>\pm</literal>
@@ -7916,14 +10185,14 @@ single quote&#160;<literal>'</literal> in text mode produces a different charact
</term><listitem><para>&#x221D; Is proportional to (relation)
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Psi</primary></indexterm><literal>\Psi</literal>
-</term><listitem><para>&#x03A8; Upper case Greek letter (ordinary).
+</term><listitem><para>&#x03A8; uppercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\psi</primary></indexterm><literal>\psi</literal>
-</term><listitem><para>&#x03C8; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03C8; Lowercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\rangle</primary></indexterm><literal>\rangle</literal>
-</term><listitem><para>&#x27E9; Right angle, or sequence, bracket (closing). Similar: greater
-than&#160;<literal>&gt;</literal>. Matches:<literal>\langle</literal>.
+</term><listitem><para>&#x27E9; Right angle, or sequence, bracket (closing).
+Similar: greater than&#160;<literal>&gt;</literal>. Matches:<literal>\langle</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\rbrace</primary></indexterm><literal>\rbrace</literal>
</term><listitem><para>&#x007D; Right curly brace
@@ -7942,8 +10211,8 @@ double-line, or blackboard bold, R&#160;<literal>\mathbb{R}</literal>; to access
this, load the <filename>amsfonts</filename> package.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\restriction</primary></indexterm><literal>\restriction</literal>
-</term><listitem><para>&#x21BE; Restriction of a function
-(relation). Synonym:&#160;<literal>\upharpoonright</literal>. Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package.
+</term><listitem><para>&#x21BE; Restriction of a function (relation). Synonym:
+<literal>\upharpoonright</literal>. Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\revemptyset</primary></indexterm><literal>\revemptyset</literal>
</term><listitem><para>&#x29B0; Reversed empty set symbol (ordinary). Related:
@@ -7956,45 +10225,50 @@ off (closing). Matches&#160;<literal>\lfloor</literal>.
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\rhd</primary></indexterm><literal>\rhd</literal>
</term><listitem><para>&#x25C1; Arrowhead, that is, triangle, pointing right (binary).
Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package. For the normal subgroup symbol you should instead
-load <filename>amssymb</filename> and use&#160;<literal>\vartriangleright</literal> (which
-is a relation and so gives better spacing).
+load <filename>amssymb</filename> and use&#160;<literal>\vartriangleright</literal> (which is a
+relation and so gives better spacing).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\rho</primary></indexterm><literal>\rho</literal>
-</term><listitem><para>&#x03C1; Lower case Greek letter (ordinary). The variant form is
+</term><listitem><para>&#x03C1; Lowercase Greek letter (ordinary). The variant form is
<literal>\varrho</literal>&#160;&#x03F1;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Rightarrow</primary></indexterm><literal>\Rightarrow</literal>
-</term><listitem><para>&#x21D2; Implies, right-pointing double line arrow (relation). Similar:
-right single-line arrow&#160;<literal>\rightarrow</literal>.
+</term><listitem><para>&#x21D2; Implies, right-pointing double line arrow
+(relation). Similar: right single-line arrow&#160;<literal>\rightarrow</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\rightarrow</primary></indexterm><literal>\rightarrow</literal>
-</term><listitem><para>&#x2192; Right-pointing single line arrow (relation). Synonym:&#160;<literal>\to</literal>. Similar: right double line arrow&#160;<literal>\Rightarrow</literal>.
+</term><listitem><para>&#x2192; Right-pointing single line arrow (relation).
+Synonym:&#160;<literal>\to</literal>. Similar: right double line
+arrow&#160;<literal>\Rightarrow</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\rightharpoondown</primary></indexterm><literal>\rightharpoondown</literal>
-</term><listitem><para>&#x21C1; Right-pointing harpoon with barb below the line (relation).
+</term><listitem><para>&#x21C1; Right-pointing harpoon with barb below
+the line (relation).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\rightharpoonup</primary></indexterm><literal>\rightharpoonup</literal>
-</term><listitem><para>&#x21C0; Right-pointing harpoon with barb above the line (relation).
+</term><listitem><para>&#x21C0; Right-pointing harpoon with barb above the
+line (relation).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\rightleftharpoons</primary></indexterm><literal>\rightleftharpoons</literal>
-</term><listitem><para>&#x21CC; Right harpoon up above left harpoon down (relation).
+</term><listitem><para>&#x21CC; Right harpoon up above left harpoon down
+(relation).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\searrow</primary></indexterm><literal>\searrow</literal>
</term><listitem><para>&#x2198; Arrow pointing southeast (relation).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\setminus</primary></indexterm><literal>\setminus</literal>
-</term><listitem><para>&#x29F5; Set difference, reverse solidus or slash, like \
-(binary). Similar: backslash&#160;<literal>\backslash</literal> and also
+</term><listitem><para>&#x29F5; Set difference, reverse solidus or reverse slash,
+like \ (binary). Similar: backslash&#160;<literal>\backslash</literal> and also
<literal>\textbackslash</literal> outside of math mode.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\sharp</primary></indexterm><literal>\sharp</literal>
</term><listitem><para>&#x266F; Musical sharp (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Sigma</primary></indexterm><literal>\Sigma</literal>
-</term><listitem><para>&#x03A3; Upper case Greek letter (ordinary).
+</term><listitem><para>&#x03A3; uppercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\sigma</primary></indexterm><literal>\sigma</literal>
-</term><listitem><para>&#x03C3; Lower case Greek letter (ordinary). The variant form is
+</term><listitem><para>&#x03C3; Lowercase Greek letter (ordinary). The variant form is
<literal>\varsigma</literal>&#160;&#x03C2;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\sim</primary></indexterm><literal>\sim</literal>
@@ -8035,15 +10309,15 @@ equal to&#160;<literal>\subseteq</literal>.
superset&#160;<literal>\supset</literal>. Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\sqsupseteq</primary></indexterm><literal>\sqsupseteq</literal>
-</term><listitem><para>&#x2292; Square superset or equal symbol (binary). Similar: superset or
-equal&#160;<literal>\supseteq</literal>.
+</term><listitem><para>&#x2292; Square superset or equal symbol (binary).
+Similar: superset or equal&#160;<literal>\supseteq</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\star</primary></indexterm><literal>\star</literal>
-</term><listitem><para>&#x22C6; Five-pointed star, sometimes used as a general binary operation
-but sometimes reserved for cross-correlation (binary). Similar: the
-synonyms asterisk&#160;<literal>*</literal> and <literal>\ast</literal>, which are six-pointed,
-and more often appear as a superscript or subscript, as with the Kleene
-star.
+</term><listitem><para>&#x22C6; Five-pointed star, sometimes used as a general binary
+operation but sometimes reserved for cross-correlation (binary).
+Similar: the synonyms asterisk&#160;<literal>*</literal> and <literal>\ast</literal>, which
+are six-pointed, and more often appear as a superscript or subscript,
+as with the Kleene star.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\subset</primary></indexterm><literal>\subset</literal>
</term><listitem><para>&#x2282; Subset (occasionally, is implied by) (relation).
@@ -8078,10 +10352,10 @@ that extends to cover the argument.
</term><listitem><para>&#x2199; Southwest-pointing arrow (relation).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\tau</primary></indexterm><literal>\tau</literal>
-</term><listitem><para>&#x03C4; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03C4; Lowercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\theta</primary></indexterm><literal>\theta</literal>
-</term><listitem><para>&#x03B8; Lower case Greek letter (ordinary). The variant form is
+</term><listitem><para>&#x03B8; Lowercase Greek letter (ordinary). The variant form is
<literal>\vartheta</literal>&#160;&#x03D1;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\times</primary></indexterm><literal>\times</literal>
@@ -8112,16 +10386,16 @@ is a relation and so gives better spacing).
relation and so gives better spacing).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\unlhd</primary></indexterm><literal>\unlhd</literal>
-</term><listitem><para>&#x22B4; Left-pointing not-filled underlined arrowhead, that
-is, triangle, with a line under (binary). Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package. For
-the normal subgroup symbol load <filename>amssymb</filename> and
+</term><listitem><para>&#x22B4; Left-pointing not-filled underlined arrowhead, that is,
+triangle, with a line under (binary). Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package. For the
+normal subgroup symbol load <filename>amssymb</filename> and
use&#160;<literal>\vartrianglelefteq</literal> (which is a relation and so gives
better spacing).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\unrhd</primary></indexterm><literal>\unrhd</literal>
-</term><listitem><para>&#x22B5; Right-pointing not-filled underlined arrowhead, that
-is, triangle, with a line under (binary). Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package. For
-the normal subgroup symbol load <filename>amssymb</filename> and
+</term><listitem><para>&#x22B5; Right-pointing not-filled underlined arrowhead, that is,
+triangle, with a line under (binary). Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package. For the
+normal subgroup symbol load <filename>amssymb</filename> and
use&#160;<literal>\vartrianglerighteq</literal> (which is a relation and so gives
better spacing).
</para>
@@ -8141,12 +10415,14 @@ arrow&#160;<literal>\Uparrow</literal>.
arrow&#160;<literal>\updownarrow</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\updownarrow</primary></indexterm><literal>\updownarrow</literal>
-</term><listitem><para>&#x2195; Single-line upward-and-downward-pointing arrow (relation). Similar:
-double-line upward-and-downward-pointing arrow&#160;<literal>\Updownarrow</literal>.
+</term><listitem><para>&#x2195; Single-line upward-and-downward-pointing arrow
+(relation). Similar: double-line upward-and-downward-pointing
+arrow&#160;<literal>\Updownarrow</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\upharpoonright</primary></indexterm><literal>\upharpoonright</literal>
</term><listitem><para>&#x21BE; Up harpoon, with barb on right side
-(relation). Synonym:&#160;<literal>&#92;restriction</literal>. Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package.
+(relation). Synonym:&#160;<literal>&#92;restriction</literal>.
+Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\uplus</primary></indexterm><literal>\uplus</literal>
</term><listitem><para>&#x228E; Multiset union, a union symbol with a plus symbol in
@@ -8154,10 +10430,10 @@ the middle (binary). Similar: union&#160;<literal>\cup</literal>. Related:
variable-sized operator&#160;<literal>\biguplus</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Upsilon</primary></indexterm><literal>\Upsilon</literal>
-</term><listitem><para>&#x03A5; Upper case Greek letter (ordinary).
+</term><listitem><para>&#x03A5; uppercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\upsilon</primary></indexterm><literal>\upsilon</literal>
-</term><listitem><para>&#x03C5; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03C5; Lowercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\varepsilon</primary></indexterm><literal>\varepsilon</literal>
</term><listitem><para>&#x03B5; Small letter script epsilon (ordinary). This is
@@ -8166,28 +10442,28 @@ more widely used in mathematics than the non-variant lunate epsilon form
membership&#160;<literal>\in</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\vanothing</primary></indexterm><literal>\vanothing</literal>
-</term><listitem><para>&#x2205; Empty set symbol. Similar:
-<literal>\emptyset</literal>. Related: <literal>\revemptyset</literal>. Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package.
+</term><listitem><para>&#x2205; Empty set symbol. Similar: <literal>\emptyset</literal>. Related:
+<literal>\revemptyset</literal>. Not available in plain &tex;. In &latex; you need to load the <filename>amssymb</filename> package.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\varphi</primary></indexterm><literal>\varphi</literal>
-</term><listitem><para>&#x03C6; Variant on the lower case Greek letter (ordinary).
+</term><listitem><para>&#x03C6; Variant on the lowercase Greek letter (ordinary).
The non-variant form is <literal>\phi</literal>&#160;&#x03D5;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\varpi</primary></indexterm><literal>\varpi</literal>
-</term><listitem><para>&#x03D6; Variant on the lower case Greek letter (ordinary).
+</term><listitem><para>&#x03D6; Variant on the lowercase Greek letter (ordinary).
The non-variant form is <literal>\pi</literal>&#160;&#x03C0;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\varrho</primary></indexterm><literal>\varrho</literal>
-</term><listitem><para>&#x03F1; Variant on the lower case Greek letter (ordinary).
+</term><listitem><para>&#x03F1; Variant on the lowercase Greek letter (ordinary).
The non-variant form is <literal>\rho</literal>&#160;&#x03C1;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\varsigma</primary></indexterm><literal>\varsigma</literal>
-</term><listitem><para>&#x03C2; Variant on the lower case Greek letter
+</term><listitem><para>&#x03C2; Variant on the lowercase Greek letter
(ordinary). The non-variant form is
<literal>\sigma</literal>&#160;&#x03C3;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\vartheta</primary></indexterm><literal>\vartheta</literal>
-</term><listitem><para>&#x03D1; Variant on the lower case Greek letter
+</term><listitem><para>&#x03D1; Variant on the lowercase Greek letter
(ordinary). The non-variant form is
<literal>\theta</literal>&#160;&#x03B8;.
</para>
@@ -8205,34 +10481,35 @@ operator&#160;<literal>\bigvee</literal>.
</term><listitem><para>&#x2016; Vertical double bar (ordinary). Similar: vertical single
bar&#160;<literal>\vert</literal>.
</para>
-<para>For a norm symbol, you can use the <filename>mathtools</filename> package and add
-<literal>\DeclarePairedDelimiter\norm{\lVert}{\rVert}</literal> to your
-preamble. This gives you three command variants for double-line
-vertical bars that are correctly horizontally spaced: if in the
-document body you write the starred version <literal>$\norm*{M^\perp}$</literal>
-then the height of the vertical bars will match the height of the
-argument, whereas with <literal>\norm{M^\perp}</literal> the bars do not grow
-with the height of the argument but instead are the default height,
-and <literal>\norm[<replaceable>size command</replaceable>]{M^\perp}</literal> also gives bars that
-do not grow but are set to the size given in the <replaceable>size command</replaceable>,
-e.g., <literal>\Bigg</literal>.
+<para>For a norm symbol, you can use the <filename>mathtools</filename> package and put in
+your preamble
+<literal>\DeclarePairedDelimiter\norm{\lVert}{\rVert}</literal>. This gives you
+three command variants for double-line vertical bars that are correctly
+horizontally spaced: if in the document body you write the starred
+version <literal>$\norm*{M^\perp}$</literal> then the height of the vertical bars
+will match the height of the argument, whereas with
+<literal>\norm{M^\perp}</literal> the bars do not grow with the height of the
+argument but instead are the default height, and <literal>\norm[<replaceable>size
+command</replaceable>]{M^\perp}</literal> also gives bars that do not grow but are set to
+the size given in the <replaceable>size command</replaceable>, e.g., <literal>\Bigg</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\vert</primary></indexterm><literal>\vert</literal>
</term><listitem><para>&#x007C; Single line vertical bar (ordinary). Similar: double-line
vertical bar&#160;<literal>\Vert</literal>. For such that, as in the definition of a
set, use&#160;<literal>\mid</literal> because it is a relation.
</para>
-<para>For absolute value you can use the <filename>mathtools</filename> package and add
-<literal>\DeclarePairedDelimiter\abs{\lvert}{\rvert}</literal> to your
-preamble. This gives you three command variants for single-line vertical
-bars that are correctly horizontally spaced: if in the document body you
-write the starred version <literal>$\abs*{\frac{22}{7}}$</literal> then the
-height of the vertical bars will match the height of the argument,
-whereas with <literal>\abs{\frac{22}{7}}</literal> the bars do not grow with
-the height of the argument but instead are the default height, and
-<literal>\abs[<replaceable>size command</replaceable>]{\frac{22}{7}}</literal> also gives bars
-that do not grow but are set to the size given in the <replaceable>size
-command</replaceable>, e.g., <literal>\Bigg</literal>.
+<para>For absolute value you can use the <filename>mathtools</filename> package and in your
+preamble put
+<literal>\DeclarePairedDelimiter\abs{\lvert}{\rvert}</literal>. This gives you
+three command variants for single-line vertical bars that are correctly
+horizontally spaced: if in the document body you write the starred
+version <literal>$\abs*{\frac{22}{7}}$</literal> then the height of the
+vertical bars will match the height of the argument, whereas with
+<literal>\abs{\frac{22}{7}}</literal> the bars do not grow with the height of
+the argument but instead are the default height, and
+<literal>\abs[<replaceable>size command</replaceable>]{\frac{22}{7}}</literal> also gives bars that
+do not grow but are set to the size given in the <replaceable>size command</replaceable>,
+e.g., <literal>\Bigg</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\wedge</primary></indexterm><literal>\wedge</literal>
</term><listitem><para>&#x2227; Logical and (binary). Synonym:&#160;<literal>\land</literal>. See also
@@ -8246,16 +10523,214 @@ operator&#160;<literal>\bigwedge</literal>.
</term><listitem><para>&#x2240; Wreath product (binary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Xi</primary></indexterm><literal>\Xi</literal>
-</term><listitem><para>&#x039E; Upper case Greek letter (ordinary).
+</term><listitem><para>&#x039E; uppercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\xi</primary></indexterm><literal>\xi</literal>
-</term><listitem><para>&#x03BE; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03BE; Lowercase Greek letter (ordinary).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\zeta</primary></indexterm><literal>\zeta</literal>
-</term><listitem><para>&#x03B6; Lower case Greek letter (ordinary).
+</term><listitem><para>&#x03B6; Lowercase Greek letter (ordinary).
+</para>
+</listitem></varlistentry></variablelist>
+<para>The following symbols are most often used in plain text but &latex;
+provides versions to use in mathematical text.
+</para>
+<variablelist><varlistentry><term><indexterm role="fn"><primary>\mathdollar</primary></indexterm><literal>\mathdollar</literal>
+</term><listitem><para>Dollar sign in math mode: $.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mathparagraph</primary></indexterm><literal>\mathparagraph</literal>
+</term><listitem><para>Paragraph sign (pilcrow) in math mode, &#x00B6;.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mathsection</primary></indexterm><literal>\mathsection</literal>
+</term><listitem><para>Section sign in math mode &#x00A7;.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mathsterling</primary></indexterm><literal>\mathsterling</literal>
+</term><listitem><para>Sterling sign in math mode: &#163;.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mathunderscore</primary></indexterm><literal>\mathunderscore</literal>
+</term><listitem><para>Underscore in math mode: _.
+</para>
+</listitem></varlistentry></variablelist>
+
+
+<sect2 label="16.2.1" id="Blackboard-bold">
+<title>Blackboard bold</title>
+
+<indexterm role="cp"><primary>blackboard bold</primary></indexterm>
+<indexterm role="cp"><primary>doublestruck</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\usepackage{amssymb} % in preamble
+ ...
+\mathbb{<replaceable>uppercase-letter</replaceable>}
+</screen>
+<para>Provide blackboard bold symbols, sometimes also known as doublestruck
+letters, used to denote number sets such as the natural numbers, the
+integers, etc.
+</para>
+<para>Here
+</para>
+<screen>\( \forall n \in \mathbb{N}, n^2 \geq 0 \)
+</screen>
+<para>the <literal>\mathbb{N}</literal> gives blackboard bold symbol &#x2115;
+representing the natural numbers.
+</para>
+<para>If you use other than an uppercase letter then you do not get an error
+but you get strange results, including unexpected characters.
+</para>
+<para>There are packages that give access to symbols other than just the
+capital letters; look on CTAN.
+</para>
+
+</sect2>
+<sect2 label="16.2.2" id="Calligraphic">
+<title>Calligraphic</title>
+
+<indexterm role="cp"><primary>calligraphic fonts</primary></indexterm>
+<indexterm role="cp"><primary>script fonts</primary></indexterm>
+<indexterm role="cp"><primary>fonts, script</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\mathcal{<replaceable>uppercase-letters</replaceable>}
+</screen>
+<para>Use a script-like font.
+</para>
+<para>In this example the graph identifier is output in a cursive font.
+</para>
+<screen>Let the graph be \( \mathcal{G} \).
+</screen>
+<para>If you use something other than an uppercase letter then you do not get
+an error. Instead you get unexpected output. For instance,
+<literal>\mathcal{g}</literal> outputs a close curly brace symbol, while
+<literal>\mathcal{+}</literal> outputs a plus sign.
+</para>
+
+</sect2>
+<sect2 label="16.2.3" id="_005cboldmath-_0026-_005cunboldmath">
+<title><literal>\boldmath</literal> &amp; <literal>\unboldmath</literal></title>
+
+<indexterm role="cp"><primary>boldface mathematics</primary></indexterm>
+<indexterm role="cp"><primary>symbols, boldface</primary></indexterm>
+<indexterm role="fn"><primary>\boldmath</primary></indexterm>
+<indexterm role="fn"><primary>\unboldmath</primary></indexterm>
+
+<para>Synopsis (used in paragraph mode or LR mode):
+</para>
+<screen>\boldmath \( <replaceable>math</replaceable> \)
+</screen>
+<para>or
+</para>
+<screen>\unboldmath \( <replaceable>math</replaceable> \)
+</screen>
+<indexterm role="fn"><primary>\boldmath</primary></indexterm>
+<indexterm role="fn"><primary>\unboldmath</primary></indexterm>
+<para>Declarations to change the letters and symbols in <replaceable>math</replaceable> to be in
+a bold font, or to countermand that and bring back the regular
+(non-bold) default. They must be used when not in math mode or display
+math mode (see <link linkend="Modes">Modes</link>). Both commands are fragile
+(see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>In this example each <literal>\boldmath</literal> command takes place inside an
+<literal>\mbox</literal>,
+</para>
+<screen>we have $\mbox{\boldmath \( v \)} = 5\cdot\mbox{\boldmath \( u \)$}$
+</screen>
+<para>which means <literal>\boldmath</literal> is only called in a text mode, here LR
+mode, and explains why &latex; must switch to math mode to set <literal>v</literal>
+and <literal>u</literal>.
+</para>
+<para>If you use either command inside math mode, as with <literal>Trouble: \(
+\boldmath x \)</literal>, then you get something like &#8216;<literal>LaTeX Font Warning:
+Command \boldmath invalid in math mode on input line 11</literal>&#8217; and &#8216;<literal>LaTeX
+Font Warning: Command \mathversion invalid in math mode on input line
+11</literal>&#8217;.
+</para>
+<indexterm role="cp"><primary>package, <literal>bm</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>bm</literal> package</primary></indexterm>
+
+<para>There are many issues with <literal>\boldmath</literal>. New documents should use
+the <filename>bm</filename> package provided by the &latex; Project team. A complete
+description is outside the scope of this document (see the full
+documentation on CTAN) but even this small example
+</para>
+<screen>\usepackage{bm} % in preamble
+...
+we have $\bm{v} = 5\cdot\bm{u}$
+</screen>
+<para>shows that it is an improvement over <literal>\boldmath</literal>.
+</para>
+
+</sect2>
+<sect2 label="16.2.4" id="Dots">
+<title>Dots, horizontal or vertical</title>
+
+<indexterm role="cp"><primary>ellipses</primary></indexterm>
+<indexterm role="cp"><primary>dots</primary></indexterm>
+
+<para>Ellipses are the three dots (usually three) indicating that a pattern
+continues.
+</para>
+<screen>\begin{array}{cccc}
+ a_{0,0} &amp;a_{0,1} &amp;a_{0,2} &amp;\ldots \\
+ a_{1,0} &amp;\ddots \\
+ \vdots
+\end{array}
+</screen>
+<para>&latex; provides these.
+</para>
+<variablelist><anchor id="ellipses-cdots"/><varlistentry><term><indexterm role="fn"><primary>\cdots</primary></indexterm><literal>\cdots</literal>
+</term><listitem><para>Horizontal ellipsis with the dots raised to the center of the line, as
+in &#x22EF;. Used as: <literal>\( a_0\cdot a_1\cdots a_{n-1}
+\)</literal>.
+</para>
+<anchor id="ellipses-ddots"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\ddots</primary></indexterm><literal>\ddots</literal>
+</term><listitem><para>Diagonal ellipsis, &#x22F1;. See the above array example for a
+usage.
+</para>
+<anchor id="ellipses-ldots"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\ldots</primary></indexterm><literal>\ldots</literal>
+</term><listitem><para>Ellipsis on the baseline, &#x2026;. Used as: <literal>\(
+x_0,\ldots x_{n-1} \)</literal>. Another example is the above array example. A
+synonym is <literal>\mathellipsis</literal>. A synonym from the <filename>amsmath</filename>
+package is <literal>\hdots</literal>.
+</para>
+<para>You can also use this command outside of mathematical text, as in
+<literal>The gears, brakes, \ldots{} are all broken</literal>. (In a paragraph
+mode or LR mode a synonym for <literal>\ldots</literal> is <literal>\dots</literal>.)
+</para>
+<anchor id="ellipses-vdots"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\vdots</primary></indexterm><literal>\vdots</literal>
+</term><listitem><para>Vertical ellipsis, &#x22EE;. See the above array example for a
+usage.
</para>
</listitem></varlistentry></variablelist>
+<indexterm role="cp"><primary>package, <literal>amsmath</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>amsmath</literal> package</primary></indexterm>
+
+<para>The <filename>amsmath</filename> package has the command <literal>\dots</literal> to semantically
+mark up ellipses. This example produces two different-looking outputs
+for the first two uses of the <literal>\dots</literal> command.
+</para>
+<screen>\usepackage{amsmath} % in preamble
+ ...
+Suppose that \( p_0, p_1, \dots, p_{n-1} \) lists all of the primes.
+Observe that \( p_0\cdot p_1 \dots \cdot p_{n-1} +1 \) is not a
+ multiple of any \( p_i \).
+Conclusion: there are infinitely many primes \( p_0, p_1, \dotsc \).
+</screen>
+<para>In the first line &latex; looks to the comma following <literal>\dots</literal> to
+determine that it should output an ellipsis on the baseline. The second
+line has a <literal>\cdot</literal> following <literal>\dots</literal> so &latex; outputs an
+ellipsis that is on the math axis, vertically centered. However, the
+third usage has no follow-on character so you have to tell &latex; what
+to do. You can use one of the commands: <literal>\dotsc</literal> if you need the
+ellipsis appropriate for a comma following, <literal>\dotsb</literal> if you need
+the ellipses that fits when the dots are followed by a binary operator
+or relation symbol, <literal>\dotsi</literal> for dots with integrals, or
+<literal>\dotso</literal> for others.
+</para>
+</sect2>
</sect1>
<sect1 label="16.3" id="Math-functions">
<title>Math functions</title>
@@ -8267,111 +10742,122 @@ operator&#160;<literal>\bigwedge</literal>.
spacing.
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\arccos</primary></indexterm><literal>\arccos</literal>
-</term><listitem><para><inlineequation><mathphrase>\arccos</mathphrase></inlineequation>
+</term><listitem><para>Inverse cosine
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\arcsin</primary></indexterm><literal>\arcsin</literal>
-</term><listitem><para><inlineequation><mathphrase>\arcsin</mathphrase></inlineequation>
+</term><listitem><para>Inverse sine
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\arctan</primary></indexterm><literal>\arctan</literal>
-</term><listitem><para><inlineequation><mathphrase>\arctan</mathphrase></inlineequation>
+</term><listitem><para>Inverse tangent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\arg</primary></indexterm><literal>\arg</literal>
-</term><listitem><para><inlineequation><mathphrase>\arg</mathphrase></inlineequation>
+</term><listitem><para>Angle between the real axis and a point in the complex plane
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\bmod</primary></indexterm><literal>\bmod</literal>
-</term><listitem><para>Binary modulo operator (<inlineequation><mathphrase>x \bmod y</mathphrase></inlineequation>)
+</term><listitem><para>Binary modulo operator, used as in <literal>\( 5\bmod 3=2 \)</literal>
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\cos</primary></indexterm><literal>\cos</literal>
-</term><listitem><para><inlineequation><mathphrase>\cos</mathphrase></inlineequation>
+</term><listitem><para>Cosine
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\cosh</primary></indexterm><literal>\cosh</literal>
-</term><listitem><para><inlineequation><mathphrase>\cosh</mathphrase></inlineequation>
+</term><listitem><para>Hyperbolic cosine
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\cot</primary></indexterm><literal>\cot</literal>
-</term><listitem><para><inlineequation><mathphrase>\cot</mathphrase></inlineequation>
+</term><listitem><para>Cotangent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\coth</primary></indexterm><literal>\coth</literal>
-</term><listitem><para><inlineequation><mathphrase>\coth</mathphrase></inlineequation>
+</term><listitem><para>Hyperbolic cotangent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\csc</primary></indexterm><literal>\csc</literal>
-</term><listitem><para><inlineequation><mathphrase>\csc</mathphrase></inlineequation>
+</term><listitem><para>Cosecant
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\deg</primary></indexterm><literal>\deg</literal>
-</term><listitem><para><inlineequation><mathphrase>\deg</mathphrase></inlineequation>
+</term><listitem><para>Degrees
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\det</primary></indexterm><literal>\det</literal>
-</term><listitem><para><inlineequation><mathphrase>\det</mathphrase></inlineequation>
+</term><listitem><para>Determinant
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dim</primary></indexterm><literal>\dim</literal>
-</term><listitem><para><inlineequation><mathphrase>\dim</mathphrase></inlineequation>
+</term><listitem><para>Dimension
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\exp</primary></indexterm><literal>\exp</literal>
-</term><listitem><para><inlineequation><mathphrase>\exp</mathphrase></inlineequation>
+</term><listitem><para>Exponential
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\gcd</primary></indexterm><literal>\gcd</literal>
-</term><listitem><para><inlineequation><mathphrase>\gcd</mathphrase></inlineequation>
+</term><listitem><para>Greatest common divisor
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\hom</primary></indexterm><literal>\hom</literal>
-</term><listitem><para><inlineequation><mathphrase>\hom</mathphrase></inlineequation>
+</term><listitem><para>Homomorphism
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\inf</primary></indexterm><literal>\inf</literal>
-</term><listitem><para><inlineequation><mathphrase>\inf</mathphrase></inlineequation>
+</term><listitem><para>Infinum
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\ker</primary></indexterm><literal>\ker</literal>
-</term><listitem><para><inlineequation><mathphrase>\ker</mathphrase></inlineequation>
+</term><listitem><para>Kernel
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\lg</primary></indexterm><literal>\lg</literal>
-</term><listitem><para><inlineequation><mathphrase>\lg</mathphrase></inlineequation>
+</term><listitem><para>Base 2 logarithm
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\lim</primary></indexterm><literal>\lim</literal>
-</term><listitem><para><inlineequation><mathphrase>\lim</mathphrase></inlineequation>
+</term><listitem><para>Limit
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\liminf</primary></indexterm><literal>\liminf</literal>
-</term><listitem><para><inlineequation><mathphrase>\liminf</mathphrase></inlineequation>
+</term><listitem><para>Limit inferior
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\limsup</primary></indexterm><literal>\limsup</literal>
-</term><listitem><para><inlineequation><mathphrase>\limsup</mathphrase></inlineequation>
+</term><listitem><para>Limit superior
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\ln</primary></indexterm><literal>\ln</literal>
-</term><listitem><para><inlineequation><mathphrase>\ln</mathphrase></inlineequation>
+</term><listitem><para>Natural logarithm
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\log</primary></indexterm><literal>\log</literal>
-</term><listitem><para><inlineequation><mathphrase>\log</mathphrase></inlineequation>
+</term><listitem><para>Logarithm
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\max</primary></indexterm><literal>\max</literal>
-</term><listitem><para><inlineequation><mathphrase>\max</mathphrase></inlineequation>
+</term><listitem><para>Maximum
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\min</primary></indexterm><literal>\min</literal>
-</term><listitem><para><inlineequation><mathphrase>\min</mathphrase></inlineequation>
+</term><listitem><para>Minimum
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\pmod</primary></indexterm><literal>\pmod</literal>
-</term><listitem><para>parenthesized modulus, as in (<inlineequation><mathphrase>\pmod 2^n - 1</mathphrase></inlineequation>)
+</term><listitem><para>Parenthesized modulus, as used in <literal>\( 5\equiv 2\pmod 3 \)</literal>
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\Pr</primary></indexterm><literal>\Pr</literal>
-</term><listitem><para><inlineequation><mathphrase>\Pr</mathphrase></inlineequation>
+</term><listitem><para>Probability
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\sec</primary></indexterm><literal>\sec</literal>
-</term><listitem><para><inlineequation><mathphrase>\sec</mathphrase></inlineequation>
+</term><listitem><para>Secant
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\sin</primary></indexterm><literal>\sin</literal>
-</term><listitem><para><inlineequation><mathphrase>\sin</mathphrase></inlineequation>
+</term><listitem><para>Sine
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\sinh</primary></indexterm><literal>\sinh</literal>
-</term><listitem><para><inlineequation><mathphrase>\sinh</mathphrase></inlineequation>
+</term><listitem><para>Hyperbolic sine
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\sup</primary></indexterm><literal>\sup</literal>
-</term><listitem><para><inlineequation><mathphrase>\sup</mathphrase></inlineequation>
+</term><listitem><para>sup
<!-- don't try to use \sup with dvi/pdf output since that turned into a -->
<!-- Texinfo command and it's not worth hassling with different versions -->
<!-- when it's just three roman letters anyway. -->
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\tan</primary></indexterm><literal>\tan</literal>
-</term><listitem><para><inlineequation><mathphrase>\tan</mathphrase></inlineequation>
+</term><listitem><para>Tangent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\tanh</primary></indexterm><literal>\tanh</literal>
-</term><listitem><para><inlineequation><mathphrase>\tanh</mathphrase></inlineequation>
+</term><listitem><para>Hyperbolic tangent
</para>
</listitem></varlistentry></variablelist>
+<indexterm role="cp"><primary>package, <literal>amsmath</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>amsmath</literal> package</primary></indexterm>
+
+<para>The <filename>amsmath</filename> package adds improvements on some of these, and also
+allows you to define your own. The full documentation is on CTAN, but
+briefly, you can define an identity operator with
+<literal>\DeclareMathOperator{\identity}{id}</literal> that is like the ones
+above but prints as &#8216;<literal>id</literal>&#8217;. The starred form
+<literal>\DeclareMathOperator*{\op}{op}</literal> sets any limits above and
+below, as is traditional with <literal>\lim</literal>, <literal>\sup</literal>, or <literal>\max</literal>.
+</para>
</sect1>
<sect1 label="16.4" id="Math-accents">
@@ -8386,276 +10872,437 @@ in math. These are different from accents in normal text
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\acute</primary></indexterm><literal>\acute</literal>
</term><listitem><indexterm role="cp"><primary>acute accent, math</primary></indexterm>
-<para>Math acute accent: <inlineequation><mathphrase>\acute{x}</mathphrase></inlineequation>.
+<para>Math acute accent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\bar</primary></indexterm><literal>\bar</literal>
</term><listitem><indexterm role="cp"><primary>bar-over accent, math</primary></indexterm>
<indexterm role="cp"><primary>macron accent, math</primary></indexterm>
-<para>Math bar-over accent: <inlineequation><mathphrase>\bar{x}</mathphrase></inlineequation>.
+<para>Math bar-over accent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\breve</primary></indexterm><literal>\breve</literal>
</term><listitem><indexterm role="cp"><primary>breve accent, math</primary></indexterm>
-<para>Math breve accent: <inlineequation><mathphrase>\breve{x}</mathphrase></inlineequation>.
+<para>Math breve accent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\check</primary></indexterm><literal>\check</literal>
</term><listitem><indexterm role="cp"><primary>check accent, math</primary></indexterm>
<indexterm role="cp"><primary>h&#225;&#269;ek accent, math</primary></indexterm>
-<para>Math h&#225;&#269;ek (check) accent: <inlineequation><mathphrase>\check{x}</mathphrase></inlineequation>.
+<para>Math h&#225;&#269;ek (check) accent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\ddot</primary></indexterm><literal>\ddot</literal>
</term><listitem><indexterm role="cp"><primary>double dot accent, math</primary></indexterm>
-<para>Math dieresis accent: <inlineequation><mathphrase>\ddot{x}</mathphrase></inlineequation>.
+<para>Math dieresis accent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dot</primary></indexterm><literal>\dot</literal>
</term><listitem><indexterm role="cp"><primary>overdot accent, math</primary></indexterm>
<indexterm role="cp"><primary>dot over accent, math</primary></indexterm>
-<para>Math dot accent: <inlineequation><mathphrase>\dot{x}</mathphrase></inlineequation>.
+<para>Math dot accent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\grave</primary></indexterm><literal>\grave</literal>
</term><listitem><indexterm role="cp"><primary>grave accent, math</primary></indexterm>
-<para>Math grave accent: <inlineequation><mathphrase>\grave{x}</mathphrase></inlineequation>.
+<para>Math grave accent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\hat</primary></indexterm><literal>\hat</literal>
</term><listitem><indexterm role="cp"><primary>hat accent, math</primary></indexterm>
<indexterm role="cp"><primary>circumflex accent, math</primary></indexterm>
-<para>Math hat (circumflex) accent: <inlineequation><mathphrase>\hat{x}</mathphrase></inlineequation>.
-</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\imath</primary></indexterm><literal>\imath</literal>
-</term><listitem><indexterm role="cp"><primary>dotless i, math</primary></indexterm>
-<para>Math dotless i.
-</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\jmath</primary></indexterm><literal>\jmath</literal>
-</term><listitem><indexterm role="cp"><primary>dotless j, math</primary></indexterm>
-<para>Math dotless j.
+<para>Math hat (circumflex) accent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mathring</primary></indexterm><literal>\mathring</literal>
</term><listitem><indexterm role="cp"><primary>ring accent, math</primary></indexterm>
-<para>Math ring accent: x*. <!-- don't bother implementing in texinfo -->
+<para>Math ring accent <!-- don't bother implementing in texinfo -->
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\tilde</primary></indexterm><literal>\tilde</literal>
</term><listitem><indexterm role="cp"><primary>tilde accent, math</primary></indexterm>
-<para>Math tilde accent: <inlineequation><mathphrase>\tilde{x}</mathphrase></inlineequation>.
+<para>Math tilde accent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\vec</primary></indexterm><literal>\vec</literal>
</term><listitem><indexterm role="cp"><primary>vector symbol, math</primary></indexterm>
-<para>Math vector symbol: <inlineequation><mathphrase>\vec{x}</mathphrase></inlineequation>.
+<para>Math vector symbol
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\widehat</primary></indexterm><literal>\widehat</literal>
</term><listitem><indexterm role="cp"><primary>wide hat accent, math</primary></indexterm>
-<para>Math wide hat accent: <inlineequation><mathphrase>\widehat{x+y}</mathphrase></inlineequation>.
+<para>Math wide hat accent
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\widetilde</primary></indexterm><literal>\widetilde</literal>
</term><listitem><indexterm role="cp"><primary>wide tilde accent, math</primary></indexterm>
-<para>Math wide tilde accent: <inlineequation><mathphrase>\widetilde{x+y}</mathphrase></inlineequation>.
+<para>Math wide tilde accent
</para>
</listitem></varlistentry></variablelist>
+<para>When you are putting an accent on an i or a j, the tradition is to use
+one without a dot, <literal>\imath</literal> or <literal>jmath</literal> (see <link linkend="Math-symbols">Math symbols</link>).
+</para>
</sect1>
-<sect1 label="16.5" id="Spacing-in-math-mode">
+<sect1 label="16.5" id="Over_002d-and-Underlining">
+<title>Over- and Underlining</title>
+
+<indexterm role="cp"><primary>overlining</primary></indexterm>
+<indexterm role="cp"><primary>underlining</primary></indexterm>
+
+<para>&latex; provides commands for making overlines or underlines, or
+putting braces over or under some material.
+</para>
+<variablelist>
+<varlistentry><term><indexterm role="fn"><primary>\underline{<replaceable>text</replaceable>}</primary></indexterm><literal>\underline{<replaceable>text</replaceable>}</literal>
+</term><listitem><para>Underline <replaceable>text</replaceable>. Works inside math mode, and outside.
+The line is always completely below the text, taking account of
+descenders, so in <literal>\(\underline{y}\)</literal> the line is lower than in
+<literal>\(\underline{x}\)</literal>. This command is fragile (see <link linkend="_005cprotect">\protect</link>).
+</para>
+<indexterm role="cp"><primary>package, <literal>ulem</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>ulem</literal> package</primary></indexterm>
+
+<para>Note that the package <filename>ulem</filename> does text mode underlining and allows
+line breaking as well as a number of other features. See the
+documentation on CTAN. See also&#160;<link linkend="_005chrulefill-_0026-_005cdotfill">\hrulefill &amp; \dotfill</link> for
+producing a line, for such things as a signature.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\overline{<replaceable>text</replaceable>}</primary></indexterm><literal>\overline{<replaceable>text</replaceable>}</literal>
+</term><listitem><para>Put a horizontal line over <replaceable>text</replaceable>. Works inside math mode, and
+outside. For example, <literal>\overline{x+y}</literal>.
+Note that this differs from the command <literal>\bar</literal> (see <link linkend="Math-accents">Math
+accents</link>).
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\underbrace{<replaceable>math</replaceable>}</primary></indexterm><literal>\underbrace{<replaceable>math</replaceable>}</literal>
+</term><listitem><para>Put a brace under <replaceable>math</replaceable>. For example, this
+<literal>(1-\underbrace{1/2)+(1/2}-1/3)</literal> emphasizes the telescoping part.
+Attach text to the brace by using subscript, <literal>_</literal>, or superscript,
+<literal>^</literal>, as here.
+</para>
+<screen>\begin{displaymath}
+ 1+1/2+\underbrace{1/3+1/4}_{&gt;1/2}+
+ \underbrace{1/5+1/6+1/7+1/8}_{&gt;1/2}+\cdots
+\end{displaymath}
+</screen>
+<para>The superscript appears on top of the expression, and so can look
+unconnected to the underbrace.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\overbrace{<replaceable>math</replaceable>}</primary></indexterm><literal>\overbrace{<replaceable>math</replaceable>}</literal>
+</term><listitem><para>Put a brace over <replaceable>math</replaceable>, as with
+<literal>\overbrace{x+x+\cdots+x}^{\mbox{\(k\) times}}</literal>. See also
+<literal>\underbrace</literal>.
+</para>
+</listitem></varlistentry></variablelist>
+<indexterm role="cp"><primary>package, <literal>mathtools</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>mathtools</literal> package</primary></indexterm>
+
+<para>The package <filename>mathtools</filename> adds an over- and underbrace, as well as
+some improvements on the braces. See the documentation on CTAN.
+</para>
+
+</sect1>
+<sect1 label="16.6" id="Spacing-in-math-mode">
<title>Spacing in math mode</title>
<indexterm role="cp"><primary>spacing within math mode</primary></indexterm>
<indexterm role="cp"><primary>math mode, spacing</primary></indexterm>
-<para>In a <literal>math</literal> environment, &latex; ignores the spaces that you use
-in the source, and instead puts in the spacing according to the normal
-rules for mathematics texts.
+<para>When typesetting mathematics, &latex; puts in spacing according to the
+normal rules for mathematics texts. If you enter <literal>y=m x</literal> then
+&latex; ignores the space and in the output the m is next to the x,
+as <inlineequation><mathphrase>y=mx</mathphrase></inlineequation>.
</para>
-<para>Many math mode spacing definitions are expressed in terms of the math unit
-<firstterm>mu</firstterm> given by 1 em = 18 mu, where the em is taken from the current
-math symbols family (see <link linkend="Units-of-length">Units of length</link>).
-&latex; provides the following commands for use in math mode:
+<para>But &latex;&#8217;s rules sometimes need tweaking. For example, in an
+integral the tradition is to put a small extra space between the
+<literal>f(x)</literal> and the <literal>dx</literal>, here done with the <literal>\,</literal> command.
+</para>
+<screen>\int_0^1 f(x)\,dx
+</screen>
+<para>&latex; provides the commands that follow for use in math mode. Many
+of these spacing definitions are expressed in terms of the math unit
+<firstterm>mu</firstterm>. It is defined as 1/18em, where the em is taken from the
+current math symbols family (see <link linkend="Units-of-length">Units of length</link>). Thus, a
+<literal>\thickspace</literal> is something like 5/18 times the width of
+a&#160;&#8216;<literal>M</literal>&#8217;.
</para>
<variablelist><varlistentry><term><literal>\;</literal>
</term><listitem><indexterm role="fn"><primary>\;</primary></indexterm>
<indexterm role="fn"><primary>\thickspace</primary></indexterm>
-<para>Normally <literal>5.0mu plus 5.0mu</literal>. The longer name is
-<literal>\thickspace</literal>. Math mode only.
+<anchor id="spacing-in-math-mode-thickspace"/><para>Synonym: <literal>\thickspace</literal>. Normally <literal>5.0mu plus 5.0mu</literal>. Math
+mode only.
</para>
</listitem></varlistentry><varlistentry><term><literal>\:</literal>
</term><term><literal>\&gt;</literal>
</term><listitem><indexterm role="fn"><primary>\:</primary></indexterm>
<indexterm role="fn"><primary>\&gt;</primary></indexterm>
<indexterm role="fn"><primary>\medspace</primary></indexterm>
-<para>Normally <literal>4.0mu plus 2.0mu minus 4.0mu</literal>. The longer name is
-<literal>\medspace</literal>. Math mode only.
+<anchor id="spacing-in-math-mode-medspace"/><para>Synonym: <literal>\medspace</literal>. Normally <literal>4.0mu plus 2.0mu minus 4.0mu</literal>.
+Math mode only.
</para>
</listitem></varlistentry><varlistentry><term><literal>\,</literal>
</term><listitem><indexterm role="fn"><primary>\,</primary></indexterm>
<indexterm role="fn"><primary>\thinspace</primary></indexterm>
-<para>Normally <literal>3mu</literal>. The longer name is <literal>\thinspace</literal>. This can
-be used in both math mode and text mode. See <link linkend="_005cthinspace">\thinspace</link>.
+<indexterm role="cp"><primary>thin space</primary></indexterm>
+<anchor id="Spacing-in-math-mode_002f_005cthinspace"/><anchor id="spacing-in-math-mode-thinspace"/><para>Synonym: <literal>\thinspace</literal>. Normally <literal>3mu</literal>, which is 1/6em.
+Can be used in both math mode and text mode (see <link linkend="_005cthinspace-_0026-_005cnegthinspace">\thinspace &amp;
+\negthinspace</link>).
</para>
+<para>This space is widely used, for instance between the function and the
+infinitesimal in an integral <literal>\int f(x)\,dx</literal> and, if an author does
+this, before punctuation in a displayed equation.
+</para>
+<screen>The antiderivative is
+\begin{equation}
+ 3x^{-1/2}+3^{1/2}\,.
+\end{equation}
+</screen>
</listitem></varlistentry><varlistentry><term><literal>\!</literal>
</term><listitem><indexterm role="fn"><primary>\!</primary></indexterm>
-<para>A negative thin space. Normally <literal>-3mu</literal>. Math mode only.
+<indexterm role="fn"><primary>\negthinspace</primary></indexterm>
+<indexterm role="cp"><primary>thin space, negative</primary></indexterm>
+<anchor id="spacing-in-math-mode-negthinspace"/><para>A negative thin space. Normally <literal>-3mu</literal>. The <literal>\!</literal> command is
+math mode only but the <literal>\negthinspace</literal> command is available for
+text mode (see <link linkend="_005cthinspace-_0026-_005cnegthinspace">\thinspace &amp; \negthinspace</link>).
</para>
</listitem></varlistentry><varlistentry><term><literal>\quad</literal>
</term><listitem><indexterm role="cp"><primary>quad</primary></indexterm>
<indexterm role="fn"><primary>\quad</primary></indexterm>
-<para>This is 18mu, that is, 1em. This is often used for space
+<anchor id="spacing-in-math-mode-quad"/><para>This is 18mu, that is, 1em. This is often used for space
surrounding equations or expressions, for instance for the space between
two equations inside a <literal>displaymath</literal> environment. It is available
in both text and math mode.
</para>
</listitem></varlistentry><varlistentry><term><literal>\qquad</literal>
</term><listitem><indexterm role="fn"><primary>\qquad</primary></indexterm>
-<para>A length of 2 quads, that is, 36mu = 2em. It is available in
+<anchor id="spacing-in-math-mode-qquad"/><para>A length of 2 quads, that is, 36mu = 2em. It is available in
both text and math mode.
</para></listitem></varlistentry></variablelist>
-<para>In this example a thinspace separates the function from the
-infinitesimal.
-</para>
-<screen>\int_0^1 f(x)\,dx
-</screen>
</sect1>
-<sect1 label="16.6" id="Math-miscellany">
+<sect1 label="16.7" id="Math-miscellany">
<title>Math miscellany</title>
<indexterm role="cp"><primary>math miscellany</primary></indexterm>
-<variablelist><varlistentry><term><indexterm role="fn"><primary>\*</primary></indexterm><literal>\*</literal>
-</term><listitem><indexterm role="cp"><primary>discretionary multiplication</primary></indexterm>
-<indexterm role="cp"><primary>multiplication symbol, discretionary line break</primary></indexterm>
-<para>A <firstterm>discretionary</firstterm> multiplication symbol, at which a line break is
-allowed. Without the break multiplication is implicitly indicated by a
-space, while in the case of a break a &#x00D7; symbol is
-printed immediately before the break. So
+<para>&latex; contains a wide variety of mathematics facilities. Here are
+some that don&#8217;t fit into other categories.
</para>
-<screen>\documentclass{article}
-\begin{document}
-Now \(A_3 = 0\), hence the product of all terms \(A_1\)
-through \(A_4\), that is \(A_1\* A_2\* A_3 \* A_4\), is
-equal to zero.
-\end{document}
+
+
+<sect2 label="16.7.1" id="Colon-character-_0026-_005ccolon">
+<title>Colon character <literal>:</literal> &amp; <literal>\colon</literal></title>
+
+<indexterm role="cp"><primary>:</primary></indexterm>
+<indexterm role="cp"><primary>colon character</primary></indexterm>
+<indexterm role="fn"><primary>:</primary></indexterm>
+<indexterm role="fn"><primary>\colon</primary></indexterm>
+
+<para>Synopsis, one of:
+</para>
+<screen>:
+\colon
</screen>
-<para>will make that sort of output<!-- -->
- <!-- /@w -->(the ellipsis &#8216;<literal>[&#8230;]</literal>&#8217; is here to show the line break at
-the same place as in a &tex; output)<!-- -->
-:
+<para>In mathematics, the colon character, <literal>:</literal>, is a relation.
</para>
-<para>Now <inlineequation><mathphrase>A_3 = 0</mathphrase></inlineequation>,
-[&#8230;]
-<inlineequation><mathphrase>A_1</mathphrase></inlineequation>
-through <inlineequation><mathphrase>A_4</mathphrase></inlineequation>, that is <inlineequation><mathphrase>A_1 A_2 \times</mathphrase></inlineequation>
-<inlineequation><mathphrase>A_3 A_4</mathphrase></inlineequation>, is
-equal to zero.
+<screen>With side ratios \( 3:4 \) and \( 4:5 \), the triangle is right.
+</screen>
+<indexterm role="cp"><primary>package, <literal>amsmath</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>amsmath</literal> package</primary></indexterm>
+
+<para>Ordinary &latex; defines <literal>\colon</literal> to produce the colon character
+with the spacing appropriate for punctuation, as in set-builder notation
+<literal>\{x\colon 0\leq x&lt;1\}</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\cdots</primary></indexterm><literal>\cdots</literal>
-</term><listitem><para>A horizontal ellipsis with the dots raised to the center of the line.
+<indexterm role="cp"><primary>package, <literal>amsmath</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>amsmath</literal> package</primary></indexterm>
+
+<para>But the widely-used <filename>amsmath</filename> package defines <literal>\colon</literal> for use
+in the definition of functions <literal>f\colon D\to C</literal>. So if you want
+the colon character as a punctuation then use <literal>\mathpunct{:}</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\ddots</primary></indexterm><literal>\ddots</literal>
-</term><listitem><para>A diagonal ellipsis: <inlineequation><mathphrase>\ddots</mathphrase></inlineequation>.
+
+</sect2>
+<sect2 label="16.7.2" id="_005c_002a">
+<title><literal>\*</literal></title>
+
+<indexterm role="cp"><primary>multiplication, discretionary</primary></indexterm>
+<indexterm role="cp"><primary>breaks, multiplication discretionary</primary></indexterm>
+<indexterm role="cp"><primary>line breaks, multiplication discretionary</primary></indexterm>
+<indexterm role="cp"><primary>discretionary breaks, multiplication</primary></indexterm>
+<indexterm role="fn"><primary>\*</primary></indexterm>
+
+<para>Synopsis:
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\frac{<replaceable>num</replaceable>}{<replaceable>den</replaceable>}</primary></indexterm><literal>\frac{<replaceable>num</replaceable>}{<replaceable>den</replaceable>}</literal>
-</term><listitem><indexterm role="fn"><primary>\frac</primary></indexterm>
-<para>Produces the fraction <replaceable>num</replaceable> divided by <replaceable>den</replaceable>.
+<screen>\*
+</screen>
+<para>A multiplication symbol that allows a line break. If there is a break
+then &latex; puts a <literal>\times</literal> symbol, &#x00D7;, before
+that break.
</para>
-
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\left <replaceable>delim1</replaceable> ... \right <replaceable>delim2</replaceable></primary></indexterm><literal>\left <replaceable>delim1</replaceable> ... \right <replaceable>delim2</replaceable></literal>
-</term><listitem><indexterm role="fn"><primary>\right</primary></indexterm>
-<indexterm role="cp"><primary>null delimiter</primary></indexterm>
-<para>The two delimiters need not match; &#8216;<literal>.</literal>&#8217; acts as a <firstterm>null delimiter</firstterm>,
-producing no output. The delimiters are sized according to the math
-in between. Example: <literal>\left( \sum_{i=1}^{10} a_i \right]</literal>.
+<para>In <literal>\( A_1\* A_2\* A_3\* A_4 \)</literal>, if there is no line break then
+&latex; outputs it as though it were <literal>\( A_1 A_2 A_3 A_4 \)</literal>. If
+a line break does happen, for example between the two middle ones, then
+&latex; sets it like <literal>\( A_1 A_2 \times \)</literal>, followed by the
+break, followed by <literal>\( A_3 A_4 \)</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mathdollar</primary></indexterm><literal>\mathdollar</literal>
-</term><listitem><para>Dollar sign in math mode: $.
+
+</sect2>
+<sect2 label="16.7.3" id="_005cfrac">
+<title><literal>\frac</literal></title>
+
+<indexterm role="cp"><primary>fraction</primary></indexterm>
+<indexterm role="fn"><primary>\frac</primary></indexterm>
+
+<para>Synopsis:
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mathellipsis</primary></indexterm><literal>\mathellipsis</literal>
-</term><listitem><para>Ellipsis (spaced for text) in math mode: &#8230;.
+<screen>\frac{<replaceable>numerator</replaceable>}{<replaceable>denominator</replaceable>}
+</screen>
+<para>Produces the fraction. Used as: <literal>\begin{displaymath}
+\frac{1}{\sqrt{2\pi\sigma}} \end{displaymath}</literal>. In inline math
+mode it comes out small; see the discussion of <literal>\displaystyle</literal>
+(see <link linkend="Math-formulas">Math formulas</link>).
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mathparagraph</primary></indexterm><literal>\mathparagraph</literal>
-</term><listitem><para>Paragraph sign (pilcrow) in math mode: &#x00B6;.
+
+</sect2>
+<sect2 label="16.7.4" id="_005cleft-_0026-_005cright">
+<title><literal>\left</literal> &amp; <literal>\right</literal></title>
+
+<indexterm role="cp"><primary>delimiters, paired</primary></indexterm>
+<indexterm role="cp"><primary>paired delimiters</primary></indexterm>
+<indexterm role="cp"><primary>matching parentheses</primary></indexterm>
+<indexterm role="cp"><primary>matching brackets</primary></indexterm>
+<indexterm role="cp"><primary>null delimiter</primary></indexterm>
+<indexterm role="fn"><primary>\left</primary></indexterm>
+<indexterm role="fn"><primary>\right</primary></indexterm>
+
+<para>Synopsis:
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mathsection</primary></indexterm><literal>\mathsection</literal>
-</term><listitem><para>Section sign in math mode.
+<screen>\left <replaceable>delimiter1</replaceable> ... \right <replaceable>delimiter2</replaceable>
+</screen>
+<para>Make matching parentheses, braces, or other delimiters. The delimiters
+are sized according to the math they enclose. This makes a unit vector
+surrounded by appropriate-height parentheses.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mathsterling</primary></indexterm><literal>\mathsterling</literal>
-</term><listitem><para>Sterling sign in math mode: &#163;.
+<screen>\begin{equation}
+ \left(\begin{array}{c}
+ 1 \\
+ 0 \\
+ \end{array}\right)
+</screen>
+<para>Every <literal>\left</literal> must have a matching <literal>\right</literal>. Leaving out the
+<literal>\left(</literal> in the above gets &#8216;<literal>Extra \right</literal>&#8217;. Leaving off the
+<literal>\right)</literal> gets &#8216;<literal>You can't use `\eqno' in math mode</literal>&#8217;.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mathunderscore</primary></indexterm><literal>\mathunderscore</literal>
-</term><listitem><para>Underscore in math mode: _.
+<para>However, the two delimiters <replaceable>delimiter1</replaceable> and <replaceable>delimiter2</replaceable> need
+not match. A common case is that you want an unmatched brace, as
+below. Use a period, &#8216;<literal>.</literal>&#8217;, as a null delimiter.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\overbrace{<replaceable>math</replaceable>}</primary></indexterm><literal>\overbrace{<replaceable>math</replaceable>}</literal>
-</term><listitem><para>Generates a brace over <replaceable>math</replaceable>.
-For example, <literal>\overbrace{x+\cdots+x}^{k \;\textrm{times}}</literal>.
-</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\overline{<replaceable>text</replaceable>}</primary></indexterm><literal>\overline{<replaceable>text</replaceable>}</literal>
-</term><listitem><para>Generates a horizontal line over <replaceable>tex</replaceable>.
-For example, <literal>\overline{x+y}</literal>.
+<screen>\begin{equation}
+ f(n)=\left\{\begin{array}{ll}
+ 1 &amp;\mbox{--if \(n=0\)} \\
+ f(n-1)+3n^2 &amp;\mbox{--else}
+ \end{array}\right.
+\end{equation}
+</screen>
+<para>Note that to get a curly brace as a delimiter you must prefix it with a
+backslash, <literal>\{</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\sqrt[<replaceable>root</replaceable>]{<replaceable>arg</replaceable>}</primary></indexterm><literal>\sqrt[<replaceable>root</replaceable>]{<replaceable>arg</replaceable>}</literal>
-</term><listitem><para>Produces the representation of the square root of <replaceable>arg</replaceable>. The
-optional argument <replaceable>root</replaceable> determines what root to produce. For
-example, the cube root of <literal>x+y</literal> would be typed as
-<literal>\sqrt[3]{x+y}</literal>.
+
+</sect2>
+<sect2 label="16.7.5" id="_005csqrt">
+<title><literal>\sqrt</literal></title>
+
+<indexterm role="cp"><primary>square root</primary></indexterm>
+<indexterm role="cp"><primary>roots</primary></indexterm>
+<indexterm role="cp"><primary>radical</primary></indexterm>
+<indexterm role="fn"><primary>\sqrt</primary></indexterm>
+
+<para>Synopsis, one of:
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\stackrel{<replaceable>text</replaceable>}{<replaceable>relation</replaceable>}</primary></indexterm><literal>\stackrel{<replaceable>text</replaceable>}{<replaceable>relation</replaceable>}</literal>
-</term><listitem><para>Puts <replaceable>text</replaceable> above <replaceable>relation</replaceable>. For example,
-<literal>\stackrel{f}{\longrightarrow}</literal>.
+<screen>\sqrt{<replaceable>arg</replaceable>}
+\sqrt[<replaceable>root-number</replaceable>]{<replaceable>arg</replaceable>}
+</screen>
+<para>The square root, or optionally other roots, of <replaceable>arg</replaceable>. The optional
+argument <replaceable>root-number</replaceable> gives the root, i.e., enter the cube root of
+<literal>x+y</literal> as <literal>\sqrt[3]{x+y}</literal>.
+The radical grows with the size of <replaceable>arg</replaceable> (as the height of the
+radical grows, the angle on the leftmost part gets steeper, until for
+a large enough <literal>arg</literal>, it is vertical).
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\underbrace{<replaceable>math</replaceable>}</primary></indexterm><literal>\underbrace{<replaceable>math</replaceable>}</literal>
-</term><listitem><para>Generates <replaceable>math</replaceable> with a brace underneath. For example, <literal>\underbrace{x+y+z}_{&gt;\,0}</literal>
+<para>&latex; has a separate <literal>\surd</literal> character (see <link linkend="Math-symbols">Math symbols</link>).
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\underline{<replaceable>text</replaceable>}</primary></indexterm><literal>\underline{<replaceable>text</replaceable>}</literal>
-</term><listitem><para>Causes <replaceable>text</replaceable>, which may be either math mode or not, to be
-underlined. The line is always below the text, taking account of
-descenders.
+
+</sect2>
+<sect2 label="16.7.6" id="_005cstackrel">
+<title><literal>\stackrel</literal></title>
+
+<indexterm role="cp"><primary>stack math</primary></indexterm>
+<indexterm role="cp"><primary>relation, text above</primary></indexterm>
+<indexterm role="fn"><primary>\stackrel</primary></indexterm>
+
+<para>Synopsis, one of:
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\vdots</primary></indexterm><literal>\vdots</literal>
-</term><listitem><para>Produces a vertical ellipsis.
+<screen>\stackrel{<replaceable>text</replaceable>}{<replaceable>relation</replaceable>}
+</screen>
+<para>Put <replaceable>text</replaceable> above <replaceable>relation</replaceable>. To put a function name above an
+arrow enter <literal>\stackrel{f}{\longrightarrow}</literal>.
</para>
-</listitem></varlistentry></variablelist>
+</sect2>
</sect1>
</chapter>
<chapter label="17" id="Modes">
<title>Modes</title>
<indexterm role="cp"><primary>modes</primary></indexterm>
-<indexterm role="cp"><primary>paragraph mode</primary></indexterm>
-<indexterm role="cp"><primary>math mode</primary></indexterm>
-<indexterm role="cp"><primary>left-to-right mode</primary></indexterm>
-<indexterm role="cp"><primary>LR mode</primary></indexterm>
-<para>When &latex; is processing your input text, it is always in one of three
-modes:
+<para>As &latex; processes your document, at any point it is in one of six
+modes. They fall into three categories of two each, the horizontal
+modes, the math modes, and the vertical modes. Some commands only work
+in one mode or another (in particular, many commands only work in one of
+the math modes), and error messages will refer to these.
</para>
-<itemizedlist><listitem><para>Paragraph mode
-</para></listitem><listitem><para>Math mode
-</para></listitem><listitem><para>Left-to-right mode, called LR mode for short
-</para></listitem></itemizedlist>
-<para>Mode changes occur only when entering or leaving an environment, or when
-&latex; is processing the argument of certain text-producing commands.
-</para>
-<para><firstterm>Paragraph mode</firstterm> is the most common; it&#8217;s the one &latex; is in
-when processing ordinary text. In this mode, &latex; breaks the
-input text into lines and breaks the lines into pages.
-</para>
-<para>&latex; is in <firstterm>math mode</firstterm> when it&#8217;s generating a mathematical
-formula, either displayed math or within a line.
-</para>
-<indexterm role="fn"><primary>\mbox, and LR mode</primary></indexterm>
-<para>In <firstterm>LR mode</firstterm>, as in paragraph mode, &latex; considers the output
-that it produces to be a string of words with spaces between them.
-However, unlike paragraph mode, &latex; keeps going from left to
-right; it never starts a new line in LR mode. Even if you put a
-hundred words into an <literal>\mbox</literal>, &latex; would keep typesetting
-them from left to right inside a single box (and then most likely
-complain because the resulting box was too wide to fit on the line).
-&latex; is in LR mode when it starts making a box with an
-<literal>\mbox</literal> command. You can get it to enter a different mode inside
-the box&#8212;for example, you can make it enter math mode to put a
-formula in the box.
-</para>
-<para>There are also several text-producing commands and environments for
-making a box that put &latex; into paragraph mode. The box made by
-one of these commands or environments will be called a <literal>parbox</literal>.
-When &latex; is in paragraph mode while making a box, it is said to
-be in &#8220;inner paragraph mode&#8221; (no page breaks). Its normal paragraph
-mode, which it starts out in, is called &#8220;outer paragraph mode&#8221;.
+<itemizedlist><listitem><anchor id="modes-paragraph-mode"/><indexterm role="cp"><primary>paragraph mode</primary></indexterm>
+<para><firstterm>Paragraph mode</firstterm> is what &latex; is in when processing ordinary
+text. It breaks the input text into lines and breaks the lines into
+pages. This is the mode &latex; is in most of the time.
+</para>
+<indexterm role="cp"><primary>left-to-right mode</primary></indexterm>
+<indexterm role="cp"><primary>LR mode</primary></indexterm>
+<anchor id="modes-lr-mode"/><para><firstterm>LR mode</firstterm> (for left-to-right mode; in plain &tex; this is called
+<firstterm>restricted horizontal mode</firstterm>) is in effect when &latex; starts
+making a box with an <literal>\mbox</literal> command. As in paragraph mode,
+&latex;&#8217;s output is a string of words with spaces between them. Unlike
+in paragraph mode, in LR mode &latex; never starts a new line, it just
+keeps going from left to right. (Although &latex; will not complain
+that the LR box is too long, when it is finished and next tries to put
+that box into a line, it could very well complain that the finished LR
+box won&#8217;t fit there.)
+</para>
+</listitem><listitem><indexterm role="cp"><primary>math mode</primary></indexterm>
+<anchor id="modes-math-mode"/><para><firstterm>Math mode</firstterm> is when &latex; is generating
+an inline mathematical formula.
+</para>
+<indexterm role="cp"><primary>display math mode</primary></indexterm>
+<para><firstterm>Display math mode</firstterm> is when &latex; is generating a displayed
+mathematical formula. (Displayed formulas differ somewhat from inline
+ones. One example is that the placement of the subscript on <literal>\int</literal>
+differs in the two situations.)
+</para>
+</listitem><listitem><indexterm role="cp"><primary>vertical mode</primary></indexterm>
+<anchor id="modes-vertical-mode"/><para><firstterm>Vertical mode</firstterm> is when &latex; is building the list of lines and
+other material making the output page. This is the mode &latex; is in
+when it starts a document.
+</para>
+<indexterm role="cp"><primary>internal vertical mode</primary></indexterm>
+<anchor id="modes-internal-vertical-mode"/><para><firstterm>Internal vertical mode</firstterm> is in effect when &latex; starts making a
+<literal>\vbox</literal>. This is the vertical analogue of LR mode.
+</para>
+</listitem></itemizedlist>
+<para>For instance, if you begin a &latex; article with &#8216;<literal>Let \( x \) be
+...</literal>&#8217; then these are the modes: first &latex; starts every document in
+vertical mode, then it reads the &#8216;<literal>L</literal>&#8217; and switches to paragraph
+mode, then the next switch happens at the &#8216;<literal>\(</literal>&#8217; where &latex;
+changes to math mode, and then when it leaves the formula it pops
+back to paragraph mode.
+</para>
+<indexterm role="cp"><primary>inner paragraph mode</primary></indexterm>
+<indexterm role="cp"><primary>outer paragraph mode</primary></indexterm>
+<anchor id="modes-inner-paragraph-mode"/><anchor id="modes-outer-paragraph-mode"/><para>Paragraph mode has two subcases. If you use a <literal>\parbox</literal> command or
+or a <literal>minipage</literal> then &latex; is put into paragraph mode. But it
+will not put a page break here. Inside one of these boxes, called a
+<firstterm>parbox</firstterm>, &latex; is in <firstterm>inner paragraph mode</firstterm>. Its more usual
+situation, where it can put page breaks, is <firstterm>outer paragraph mode</firstterm>
+(see <link linkend="Page-breaking">Page breaking</link>).
</para>
<sect1 label="17.1" id="_005censuremath">
@@ -8665,33 +11312,22 @@ mode, which it starts out in, is called &#8220;outer paragraph mode&#8221;.
</para>
<screen>\ensuremath{<replaceable>formula</replaceable>}
</screen>
-<para>The <literal>\ensuremath</literal> command ensures that <replaceable>formula</replaceable> is typeset in
-math mode whatever the current mode in which the command is used.
+<para>Ensure that <replaceable>formula</replaceable> is typeset in math mode.
</para>
-<para>For instance:
+<para>For instance, you can redefine commands that ordinarily can be used only
+in math mode, so that they can be used both in math and in plain text.
</para>
-<screen>\documentclass{report}
-\newcommand{\ab}{\ensuremath{(\delta, \varepsilon)}}
-\begin{document}
-Now, the \ab\ pair is equal to \(\ab = (\frac{1}{\pi}, 0)\), ...
-\end{document}
+<screen>\newcommand{\dx}{\ensuremath{dx}}
+In $\int f(x)\, \dx$, the \dx{} is an infinitesimal.
</screen>
-<para>One can redefine commands that can be used only in math mode so that
-they ca be used in any mode like in the following example given for
-<literal>\leadsto</literal>:
-</para>
-<!-- Vincent 2 Karl : "Tous les chemins mènent à Rome" is a French saying -->
-<!-- meaning that there are many different ways to get the same result. I -->
-<!-- am not sure whether in English the given example is also funny. -->
-<screen>\documentclass{report}
-\usepackage{amssymb}
-\newcommand{\originalMeaningOfLeadsTo}{}
-\let\originalMeaningOfLeadsTo\leadsto
-\renewcommand\leadsto{\ensuremath{\originalMeaningOfLeadsTo}}
-\begin{document}
-All roads \leadsto\ Rome.
-\end{document}
+<para>Caution: the <literal>\ensuremath</literal> command is useful but not a panacea.
+</para>
+<screen>\newcommand{\alf}{\ensuremath{\alpha}}
+You get an alpha in text mode: \alf.
+But compare the correct spacing in $\alf+\alf$ with that in \alf+\alf.
</screen>
+<para>Best is to typeset math things in a math mode.
+</para>
</sect1>
</chapter>
@@ -8701,8 +11337,17 @@ All roads \leadsto\ Rome.
<indexterm role="cp"><primary>styles, page</primary></indexterm>
<indexterm role="cp"><primary>page styles</primary></indexterm>
-<para>The <literal>\documentclass</literal> command determines the size and position of
-the page&#8217;s head and foot. The page style determines what goes in them.
+<para>The style of a page determines where &latex; places the components of
+that page, such as headers and footers, and the text body. This
+includes pages in the main part of the document but also includes
+special pages such as the title page of a book, a page from an index, or
+the first page of an article.
+</para>
+<indexterm role="cp"><primary>package, <literal>fancyhdr</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>fancyhdr</literal> package</primary></indexterm>
+
+<para>The package <filename>fancyhdr</filename> is very helpful for constructing page
+styles. See its documentation on CTAN.
</para>
@@ -8712,39 +11357,83 @@ the page&#8217;s head and foot. The page style determines what goes in them.
<indexterm role="cp"><primary>titles, making</primary></indexterm>
<indexterm role="fn"><primary>\maketitle</primary></indexterm>
-<para>The <literal>\maketitle</literal> command generates a title on a separate title
-page&#8212;except in the <literal>article</literal> class, where the title is placed
-at the top of the first page. Information used to produce the title
-is obtained from the following declarations:
+<para>Synopsis:
+</para>
+<screen>\maketitle
+</screen>
+<para>Generate a title. In the standard classes the title appears on a
+separate page, except in the <literal>article</literal> class where it is at the top
+of the first page. (See <link linkend="Document-class-options">Document class options</link> for information about
+the <literal>titlepage</literal> document class option.)
</para>
-<variablelist><varlistentry><term><indexterm role="fn"><primary>\author{<replaceable>name</replaceable> \and <replaceable>name2</replaceable>}</primary></indexterm><literal>\author{<replaceable>name</replaceable> \and <replaceable>name2</replaceable>}</literal>
+<para>This example shows <literal>\maketitle</literal> appearing in its usual place,
+immediately after <literal>\begin{document}</literal>.
+</para>
+<screen>\documentclass{article}
+\title{Constructing a Nuclear Reactor Using Only Coconuts}
+\author{Jonas Grumby\thanks{%
+ With the support of a Ginger Grant from the Roy Hinkley Society.} \\
+ Skipper, \textit{Minnow}
+ \and
+ Willy Gilligan\thanks{%
+ Thanks to the Mary Ann Summers foundation
+ and to Thurston and Lovey Howell.} \\
+ Mate, \textit{Minnow}
+ }
+\date{1964-Sep-26}
+\begin{document}
+\maketitle
+Just sit right back and you'll hear a tale, a tale of a fateful trip.
+That started from this tropic port, aboard this tiny ship. The mate was
+a mighty sailin' man, the Skipper brave and sure. Five passengers set
+sail that day for a three hour tour. A three hour tour.
+ ...
+</screen>
+<para>You tell &latex; the information used to produce the title by making
+the following declarations. These must come before the
+<literal>\maketitle</literal>, either in the preamble or in the document body.
+</para>
+<variablelist><varlistentry><term><indexterm role="fn"><primary>\author{<replaceable>name1</replaceable> \and <replaceable>name2</replaceable> \and ...}</primary></indexterm><literal>\author{<replaceable>name1</replaceable> \and <replaceable>name2</replaceable> \and ...}</literal>
</term><listitem><indexterm role="cp"><primary>author, for titlepage</primary></indexterm>
<indexterm role="fn"><primary>\\ for <literal>\author</literal></primary></indexterm>
<indexterm role="fn"><primary>\and for <literal>\author</literal></primary></indexterm>
-<para>The <literal>\author</literal> command declares the document author(s), where the
-argument is a list of authors separated by <literal>\and</literal> commands. Use
-<literal>\\</literal> to separate lines within a single author&#8217;s entry&#8212;for
-example, to give the author&#8217;s institution or address.
+<para>Required. Declare the document author or authors. The argument is a
+list of authors separated by <literal>\and</literal> commands. To separate lines
+within a single author&#8217;s entry, for instance to give the author&#8217;s
+institution or address, use a double backslash, <literal>\\</literal>. If you omit
+the <literal>\author</literal> declaration then you get &#8216;<literal>LaTeX Warning: No
+\author given</literal>&#8217;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\date{<replaceable>text</replaceable>}</primary></indexterm><literal>\date{<replaceable>text</replaceable>}</literal>
</term><listitem><indexterm role="cp"><primary>date, for titlepage</primary></indexterm>
-<para>The <literal>\date</literal> command declares <replaceable>text</replaceable> to be the document&#8217;s
-date. With no <literal>\date</literal> command, the current date (see <link linkend="_005ctoday">\today</link>)
-is used.
+<para>Optional. Declare <replaceable>text</replaceable> to be the document&#8217;s date. The <replaceable>text</replaceable>
+doesn&#8217;t need to be in a date format; it can be any text at all. If you
+omit <literal>\date</literal> then &latex; uses the current date (see <link linkend="_005ctoday">\today</link>).
+To have no date, instead use <literal>\date{}</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\thanks{<replaceable>text</replaceable>}</primary></indexterm><literal>\thanks{<replaceable>text</replaceable>}</literal>
</term><listitem><indexterm role="cp"><primary>thanks, for titlepage</primary></indexterm>
<indexterm role="cp"><primary>credit footnote</primary></indexterm>
-<para>The <literal>\thanks</literal> command produces a <literal>\footnote</literal> to the title,
-usually used for credit acknowledgements.
+<para>Optional. Produce a footnote. You can use it in the author information
+for acknowledgements, as illustrated below, but you can also use it in
+the title, or any place a footnote makes sense. It can be any text so
+you can use it to print an email address, or for any purpose.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\title{<replaceable>text</replaceable>}</primary></indexterm><literal>\title{<replaceable>text</replaceable>}</literal>
</term><listitem><indexterm role="cp"><primary>title, for titlepage</primary></indexterm>
<indexterm role="fn"><primary>\\ for <literal>\title</literal></primary></indexterm>
-<para>The <literal>\title</literal> command declares <replaceable>text</replaceable> to be the title of the
-document. Use <literal>\\</literal> to force a line break, as usual.
+<para>Required. Declare <replaceable>text</replaceable> to be the title of the document. Get line
+breaks inside <replaceable>text</replaceable> with a double backslash, <literal>\\</literal>. If you
+omit the <literal>\title</literal> declaration then you get &#8216;<literal>LaTeX Error: No
+\title given</literal>&#8217;.
</para>
</listitem></varlistentry></variablelist>
+<para>Many publishers will provide a class to use in place of <literal>article</literal>
+in that example, that formats the title according to their house
+requirements. To make your own, see&#160;<link linkend="titlepage">titlepage</link>. You can
+either create this as a one-off or you can include it as part of a
+renewed <literal>\maketitle</literal> command.
+</para>
</sect1>
<sect1 label="18.2" id="_005cpagenumbering">
@@ -8755,27 +11444,62 @@ document. Use <literal>\\</literal> to force a line break, as usual.
<para>Synopsis:
</para>
-<screen>\pagenumbering{<replaceable>style</replaceable>}
+<screen>\pagenumbering{<replaceable>number-style</replaceable>}
+</screen>
+<para>Specifies the style of page numbers, and resets the page number. The
+numbering style is reflected on the page, and also in the table of
+contents and other page references. This declaration has global scope
+so its effect is not delimited by braces or environments.
+</para>
+<para>In this example, before the Main section the pages are numbered
+&#8216;<literal>a</literal>&#8217;, etc. Starting on the page containing that section, the pages
+are numbered &#8216;<literal>1</literal>&#8217;, etc.
+</para>
+<screen>\begin{document}\pagenumbering{alph}
+ ...
+\section{Main}\pagenumbering{arabic}
+ ...
</screen>
-<para>Specifies the style of page numbers, according to <replaceable>style</replaceable>; also
-resets the page number to 1. The <replaceable>style</replaceable> argument is one of
-the following:
+<para>The argument <replaceable>number-style</replaceable> is one of the following (see
+also&#160;<link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</link>).
</para>
<variablelist><varlistentry><term><literal>arabic</literal>
-</term><listitem><para>arabic numerals
+</term><listitem><para>arabic numerals: 1, 2, &#8230;
</para>
</listitem></varlistentry><varlistentry><term><literal>roman</literal>
-</term><listitem><para>lowercase Roman numerals
+</term><listitem><para>lowercase Roman numerals: i, ii, &#8230;
</para>
</listitem></varlistentry><varlistentry><term><literal>Roman</literal>
-</term><listitem><para>uppercase Roman numerals
+</term><listitem><para>uppercase Roman numerals: I, II, &#8230;
</para>
</listitem></varlistentry><varlistentry><term><literal>alph</literal>
-</term><listitem><para>lowercase letters
+</term><listitem><para>lowercase letters: a, b, &#8230; If you have more than 26 pages then you
+get &#8216;<literal>LaTeX Error: Counter too large</literal>&#8217;.
</para>
</listitem></varlistentry><varlistentry><term><literal>Alph</literal>
-</term><listitem><para>uppercase letters
-</para></listitem></varlistentry></variablelist>
+</term><listitem><para>uppercase letters: A, B, &#8230; If you have more than 26 pages then you
+get &#8216;<literal>LaTeX Error: Counter too large</literal>&#8217;.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>gobble</literal>
+</term><listitem><indexterm role="cp"><primary>package, <literal>hyperref</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>hyperref</literal> package</primary></indexterm>
+<para>&latex; does not output a page number, although it
+does get reset. References to that page also are blank. (This does not
+work with the popular package <filename>hyperref</filename> so to have the page number
+not appear you may want to instead use <literal>\pagestyle{empty}</literal> or
+<literal>\thispagestyle{empty}</literal>.)
+</para>
+</listitem></varlistentry></variablelist>
+<para>Traditionally, if a document has front matter&#8212;preface, table of
+contents, etc.&#8212;then it is numbered with lowercase Roman numerals. The
+main matter of a document uses arabic. See <link linkend="_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter &amp; \mainmatter
+&amp; \backmatter</link>.
+</para>
+<para>If you want to address where the page number appears on the page,
+see&#160;<link linkend="_005cpagestyle">\pagestyle</link>. If you want to change the value of page
+number then you will manipulate the <literal>page</literal> counter
+(see <link linkend="Counters">Counters</link>).
+</para>
</sect1>
<sect1 label="18.3" id="_005cpagestyle">
@@ -8790,48 +11514,124 @@ the following:
</para>
<screen>\pagestyle{<replaceable>style</replaceable>}
</screen>
-<para>The <literal>\pagestyle</literal> command specifies how the headers and footers
-are typeset from the current page onwards. Values for <replaceable>style</replaceable>:
+<para>Declaration that specifies how the page headers and footers are typeset,
+from the current page onwards.
+</para>
+<indexterm role="cp"><primary>package, <literal>fancyhdr</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>fancyhdr</literal> package</primary></indexterm>
+
+<para>A discussion with an example is below. Note first that the package
+<filename>fancyhdr</filename> is now the standard way to manipulate headers and
+footers. New documents that need to do anything other than one of the
+standard options below should use this package. See its documentation
+on CTAN.
+</para>
+<para>Values for <replaceable>style</replaceable>:
</para>
<variablelist><varlistentry><term><literal>plain</literal>
-</term><listitem><para>Just a plain page number.
+</term><listitem><para>The header is empty. The footer contains only a page number, centered.
</para>
</listitem></varlistentry><varlistentry><term><literal>empty</literal>
-</term><listitem><para>Empty headers and footers, e.g., no page numbers.
+</term><listitem><para>The header and footer is empty.
</para>
</listitem></varlistentry><varlistentry><term><literal>headings</literal>
-</term><listitem><para>Put running headers on each page. The document style specifies what
-goes in the headers.
+</term><listitem><para>Put running headers and footers on each page. The document style
+specifies what goes in there; see the discussion below.
</para>
</listitem></varlistentry><varlistentry><term><literal>myheadings</literal>
</term><listitem><para>Custom headers, specified via the <literal>\markboth</literal> or the
<literal>\markright</literal> commands.
</para>
</listitem></varlistentry></variablelist>
+<para>Some discussion of the motivation for &latex;&#8217;s mechanism will help you
+work with the options <literal>headings</literal> or <literal>myheadings</literal>. The
+document source below produces an article, two-sided, with the pagestyle
+<literal>headings</literal>. On this document&#8217;s left hand pages, &latex; wants (in
+addition to the page number) the title of the current section. On its
+right hand pages &latex; wants the title of the current subsection.
+When it makes up a page, &latex; gets this information from the
+commands <literal>\leftmark</literal> and <literal>\rightmark</literal>. So it is up to
+<literal>\section</literal> and <literal>\subsection</literal> to store that information there.
+</para>
+<screen>\documentclass[twoside]{article}
+\pagestyle{headings}
+\begin{document}
+ ... \section{Section 1} ... \subsection{Subsection 1.1} ...
+\section{Section 2}
+ ...
+\subsection{Subsection 2.1}
+ ...
+\subsection{Subsection 2.2}
+ ...
+</screen>
+<para>Suppose that the second section falls on a left page. Although when the
+page starts it is in the first section, &latex; will put
+&#8216;<literal>Section&#160;2</literal>&#8217; in the left page header. As to the right header,
+if no subsection starts before the end of the right page then &latex;
+blanks the right hand header. If a subsection does appear before the
+right page finishes then there are two cases. If at least one
+subsection starts on the right hand page then &latex; will put in the
+right header the title of the first subsection starting on that right
+page. If at least one of 2.1, 2.2, &#8230;, starts on the left page but
+none starts on the right then &latex; puts in the right hand header the
+title of the last subsection to start, that is, the one in effect during
+the right hand page.
+</para>
+<para>To accomplish this, in a two-sided article, &latex; has <literal>\section</literal>
+issue a command <literal>\markboth</literal>, setting <literal>\leftmark</literal>
+to &#8216;<literal>Section&#160;2</literal>&#8217; and setting <literal>\rightmark</literal> to blank.
+And, &latex; has <literal>\subsection</literal> issue a command <literal>\markright</literal>,
+setting <literal>\rightmark</literal> to &#8216;<literal>Subsection&#160;2.1</literal>&#8217;, etc.
+</para>
<para>Here are the descriptions of <literal>\markboth</literal> and <literal>\markright</literal>:
</para>
-<variablelist><varlistentry><term><indexterm role="fn"><primary>\markboth{<replaceable>left</replaceable>}{<replaceable>right</replaceable>}</primary></indexterm><literal>\markboth{<replaceable>left</replaceable>}{<replaceable>right</replaceable>}</literal>
-</term><listitem><para>Sets both the left and the right heading. A &#8220;left-hand heading&#8221;
-(<replaceable>left</replaceable>) is generated by the last <literal>\markboth</literal> command before
-the end of the page, while a &#8220;right-hand heading&#8221; (<replaceable>right</replaceable>) is
-generated by the first <literal>\markboth</literal> or <literal>\markright</literal> that
-comes on the page if there is one, otherwise by the last one before
-the page.
+<variablelist><varlistentry><term><indexterm role="fn"><primary>\markboth{<replaceable>left-head</replaceable>}{<replaceable>right-head</replaceable>}</primary></indexterm><literal>\markboth{<replaceable>left-head</replaceable>}{<replaceable>right-head</replaceable>}</literal>
+</term><listitem><para>Sets both the right hand and left hand heading information for either a
+page style of <literal>headings</literal> or <literal>myheadings</literal>. A left hand page
+heading <replaceable>left-head</replaceable> is generated by the last <literal>\markboth</literal>
+command before the end of the page. A right hand page heading
+<replaceable>right-head</replaceable> is generated by the first <literal>\markboth</literal> or
+<literal>\markright</literal> that comes on the page if there is one, otherwise by
+the last one that came before that page.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\markright{<replaceable>right</replaceable>}</primary></indexterm><literal>\markright{<replaceable>right</replaceable>}</literal>
-</term><listitem><para>Sets the right heading, leaving the left heading unchanged.
+</term><listitem><para>Sets the right hand page heading, leaving the left unchanged.
</para>
</listitem></varlistentry></variablelist>
</sect1>
<sect1 label="18.4" id="_005cthispagestyle">
-<title><literal>\thispagestyle{<replaceable>style</replaceable>}</literal></title>
+<title><literal>\thispagestyle</literal></title>
<indexterm role="fn"><primary>\thispagestyle</primary></indexterm>
+<indexterm role="cp"><primary>page style, this page</primary></indexterm>
-<para>The <literal>\thispagestyle</literal> command works in the same manner as the
-<literal>\pagestyle</literal> command (see previous section) except that it
-changes to <replaceable>style</replaceable> for the current page only.
+<para>Synopsis:
+</para>
+<screen>\thispagestyle{<replaceable>style</replaceable>}
+</screen>
+<para>Works in the same way as the <literal>\pagestyle</literal> (see <link linkend="_005cpagestyle">\pagestyle</link>),
+except that it changes to <replaceable>style</replaceable> for the current page only. This
+declaration has global scope, so its effect is not delimited by braces
+or environments.
+</para>
+<para>Often the first page of a chapter or section has a different style. For
+example, this &latex; book document has the first page of the first
+chapter in in <literal>plain</literal> style, as is the default (see <link linkend="Page-styles">Page
+styles</link>).
+</para>
+<screen>\documentclass{book}
+\pagestyle{headings}
+\begin{document}
+\chapter{First chapter}
+ ...
+\chapter{Second chapter}\thispagestyle{empty}
+ ...
+</screen>
+<para>The <literal>plain</literal> style has a page number on it, centered in the footer.
+To make the page entirely empty, the command
+<literal>\thispagestyle{empty}</literal> immediately follows the second
+<literal>\chapter</literal>.
</para>
</sect1>
@@ -8842,60 +11642,169 @@ changes to <replaceable>style</replaceable> for the current page only.
<indexterm role="cp"><primary>spaces</primary></indexterm>
<indexterm role="cp"><primary>white space</primary></indexterm>
-<para>&latex; has many ways to produce white (or filled) space.
+<para>&latex; has many ways to produce white (or filled) space. Some of
+these are best suited to mathematical text; see&#160;<link linkend="Spacing-in-math-mode">Spacing in
+math mode</link>. Some spacing commands are suitable for both regular text
+and mathematical text; versions of some of these commands are in this
+chapter.
</para>
-<sect1 label="19.1" id="_005chspace">
+<sect1 label="19.1" id="_005censpace-_0026-_005cquad-_0026-_005cqquad">
+<title><literal>\enspace</literal> &amp; <literal>\quad</literal> &amp; <literal>\qquad</literal></title>
+
+<indexterm role="fn"><primary>\enspace</primary></indexterm>
+<indexterm role="fn"><primary>\quad</primary></indexterm>
+<indexterm role="fn"><primary>\qquad</primary></indexterm>
+
+<para>Synopsis, one of:
+</para>
+<screen>\enspace
+\quad
+\qquad
+</screen>
+<para>Insert a horizontal space of 1/2em, 1em, or 2em. The
+em is a length defined by a font designer, often thought of as being the
+width of a capital&#160;M. One advantage of describing space in ems is
+that it can be more portable across documents than an absolute
+measurement such as points (see <link linkend="Lengths_002fem">Lengths/em</link>).
+</para>
+<para>This puts a suitable gap between two graphics.
+</para>
+<screen>\begin{center}
+ \includegraphics{womensmile.png}%
+ \qquad\includegraphics{mensmile.png}
+\end{center}
+</screen>
+<para>See <link linkend="Spacing-in-math-mode">Spacing in math mode</link> for <literal>\quad</literal> and <literal>\qquad</literal>. These
+are lengths from centuries of typesetting and so may be a better choice
+in many circumstances than arbitrary lengths, such as you get with
+<literal>\hspace</literal>.
+</para>
+
+</sect1>
+<sect1 label="19.2" id="_005chspace">
<title><literal>\hspace</literal></title>
<indexterm role="fn"><primary>\hspace</primary></indexterm>
-<para>Synopsis:
+<para>Synopsis, one of:
</para>
<screen>\hspace{<replaceable>length</replaceable>}
\hspace*{<replaceable>length</replaceable>}
</screen>
-<para>Add the horizontal space given by <replaceable>length</replaceable>. The <replaceable>length</replaceable> is a
-rubber length, that is, it may contain a <literal>plus</literal> or <literal>minus</literal>
-component, in any unit that &latex; understands (see <link linkend="Lengths">Lengths</link>).
+<para>Insert the horizontal space <replaceable>length</replaceable>. The <replaceable>length</replaceable> can be
+positive, negative, or zero; adding negative space is like backspacing.
+It is a rubber length, that is, it may contain a <literal>plus</literal> or
+<literal>minus</literal> component, or both (see <link linkend="Lengths">Lengths</link>). Because the space is
+stretchable and shrinkable, it is sometimes called <firstterm>glue</firstterm>.
</para>
-<para>This command can add both positive and negative space; adding negative
-space is like backspacing.
+<para>This makes a line with &#8216;<literal>Name:</literal>&#8217; an inch from the right margin.
</para>
-<para>Normally when &tex; breaks a paragraph into lines it discards white
-space (glues and kerns) that would come at the start of a line, so you
-get an inter-word space or a line break between words but not both. This
-command&#8217;s starred version <literal>\hspace*{...}</literal> puts a non-discardable
-invisible item in front of the space, so the space appears in the
-output.
+<screen>\noindent\makebox[\linewidth][r]{Name:\hspace{1in}}
+</screen>
+<para>The <literal>*</literal>-version inserts horizontal space that non-discardable.
+More precisely, when &tex; breaks a paragraph into lines any white
+space&#8212;glues and kerns&#8212;that come at a line break are discarded. The
+<literal>*</literal>-version avoids that (technically, it adds a non-discardable
+invisible item in front of the space).
+</para>
+<para>In this example
+</para>
+<screen>\parbox{0.8\linewidth}{%
+ Fill in each blank: Four \hspace*{1in} and seven years ago our
+ fathers brought forth on this continent, a new \hspace*{1in},
+ conceived in \hspace*{1in}, and dedicated to the proposition
+ that all men are created \hspace*{1in}.}
+</screen>
+<para>the 1&#160;inch blank following &#8216;<literal>conceived in</literal>&#8217; falls at the start
+of a line. If you erase the <literal>*</literal> then &latex; discards the blank.
</para>
-<para>This example make a one-line paragraph that puts &#8216;<literal>Name:</literal>&#8217; an inch
-from the right margin.
+<para>Here, the <literal>\hspace</literal> separates the three graphics.
</para>
-<screen>\noindent\makebox[\linewidth]{\hspace{\fill}Name:\hspace{1in}}
+<screen>\begin{center}
+ \includegraphics{lion.png}% comment keeps out extra space
+ \hspace{1cm minus 0.25cm}\includegraphics{tiger.png}%
+ \hspace{1cm minus 0.25cm}\includegraphics{bear.png}
+\end{center}
</screen>
+<para>Because the argument to each <literal>\hspace</literal> has <literal>minus 0.25cm</literal>,
+each can shrink a little if the three figures are too wide. But each
+space won&#8217;t shrink more than 0.25cm (see <link linkend="Lengths">Lengths</link>).
+</para>
</sect1>
-<sect1 label="19.2" id="_005chfill">
+<sect1 label="19.3" id="_005chfill">
<title><literal>\hfill</literal></title>
<indexterm role="fn"><primary>\hfill</primary></indexterm>
<indexterm role="cp"><primary>stretch, infinite horizontal</primary></indexterm>
<indexterm role="cp"><primary>infinite horizontal stretch</primary></indexterm>
-<para>Produce a rubber length which has
-no natural space but can stretch horizontally as far as
-needed (see <link linkend="Lengths">Lengths</link>).
+
+<para>Synopsis:
+</para>
+<screen>\hfill
+</screen>
+<para>Produce a rubber length which has no natural space but that can stretch
+horizontally as far as needed (see <link linkend="Lengths">Lengths</link>).
+</para>
+<para>This creates a one-line paragraph with &#8216;<literal>Name:</literal>&#8217; on the left side
+of the page and &#8216;<literal>Quiz One</literal>&#8217; on the right.
</para>
+<screen>\noindent Name:\hfill Quiz One
+</screen>
<indexterm role="fn"><primary>\fill</primary></indexterm>
-<para>The command <literal>\hfill</literal> is equivalent to <literal>\hspace{\fill}</literal>. For
-space that does not disappear at line breaks use
-<literal>\hspace*{\fill}</literal> instead (see <link linkend="_005chspace">\hspace</link>).
+<para>The <literal>\hfill</literal> command is equivalent to <literal>\hspace{\fill}</literal> and
+so the space can be discarded at line breaks. To avoid that instead use
+<literal>\hspace*{\fill}</literal> (see <link linkend="_005chspace">\hspace</link>).
+</para>
+<para>Here the graphs are evenly spaced in the middle of the figure.
+</para>
+<screen>\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
+ ...
+\begin{figure}
+ \hspace*{\fill}%
+ \vcenteredhbox{\includegraphics{graph0.png}}%
+ \hfill\vcenteredhbox{\includegraphics{graph1.png}}%
+ \hspace*{\fill}%
+ \caption{Comparison of two graphs} \label{fig:twographs}
+\end{figure}
+</screen>
+<para>Note the <literal>\hspace*</literal>&#8217;s where the space could otherwise be dropped.
</para>
</sect1>
-<sect1 label="19.3" id="_005cspacefactor">
+<sect1 label="19.4" id="_005chss">
+<title><literal>\hss</literal></title>
+
+<indexterm role="fn"><primary>\hss</primary></indexterm>
+<indexterm role="cp"><primary>horizontal space</primary></indexterm>
+<indexterm role="cp"><primary>horizontal space, stretchable</primary></indexterm>
+<indexterm role="cp"><primary>space, inserting horizontal</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\hss
+</screen>
+<para>Produce a horizontal space that is infinitely shrinkable as well as
+infinitely stretchable (this command is a &tex; primitive). &latex;
+authors should reach first for the <literal>\makebox</literal> command to get the
+effects of <literal>\hss</literal> (see <link linkend="_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</link>).
+</para>
+<para>Here, the first line&#8217;s <literal>\hss</literal> makes the Z stick out to the right,
+overwriting the Y. In the second line the Z sticks out to the left,
+overwriting the X.
+</para>
+<screen>X\hbox to 0pt{Z\hss}Y
+X\hbox to 0pt{\hss Z}Y
+</screen>
+<para>Without the <literal>\hss</literal> you get something like &#8216;<literal>Overfull \hbox
+(6.11111pt too wide) detected at line 20</literal>&#8217;.
+</para>
+
+</sect1>
+<sect1 label="19.5" id="_005cspacefactor">
<title><literal>\spacefactor</literal></title>
<para>Synopsis:
@@ -8903,24 +11812,26 @@ space that does not disappear at line breaks use
<screen>\spacefactor=<replaceable>integer</replaceable>
</screen>
<indexterm role="fn"><primary>\spacefactor</primary></indexterm>
-<para>While &latex; is making the page, to give the lines the best appearance
-it may stretch or shrink the gaps between words. The
-<literal>\spacefactor</literal> command (from Plain&#160;&tex;) allows you to
-change the &latex;&#8217;s default behavior.
+<para>Influence &latex;&#8217;s glue stretch and shrink behavior. Most user-level
+documents do not use this command.
+</para>
+<para>While &latex; is laying out the material, it may stretch or shrink the
+gaps between words. (This space is not a character; it is called the
+<firstterm>interword glue</firstterm>; see <link linkend="_005chspace">\hspace</link>). The <literal>\spacefactor</literal> command
+(from Plain&#160;&tex;) allows you to, for instance, have the space
+after a period stretch more than the space after a word-ending letter.
</para>
<para>After &latex; places each character, or rule or other box, it sets a
parameter called the <firstterm>space factor</firstterm>. If the next thing in the input
-is a space then this parameter affects how much of a horizontal gap
-&latex; will have it span. (This gap is not a character; it is called
-<firstterm>interword glue</firstterm>.) A larger space factor means that the glue gap
-can stretch more and shrink less.
-</para>
-<para>Normally, the space factor is 1000; this value is in effect following
-most characters, and any non-character box or math formula. But it is
-3000 after a period, exclamation mark, or question mark, it is 2000
-after a colon, 1500 after a semicolon, 1250 after a comma, and 0 after a
-right parenthesis or bracket, or closing double quote or single quote.
-Finally, it is 999 after a capital letter.
+is a space then this parameter affects how much stretching or shrinking
+can happen. A space factor that is larger than the normal value means
+that the glue can stretch more and shrink less. Normally, the space
+factor is 1000. This value is in effect following most characters, and
+any non-character box or math formula. But it is 3000 after a period,
+exclamation mark, or question mark, it is 2000 after a colon, 1500 after
+a semicolon, 1250 after a comma, and 0 after a right parenthesis or
+bracket, or closing double quote or single quote. Finally, it is 999
+after a capital letter.
</para>
<para>If the space factor&#160;<replaceable>f</replaceable> is 1000 then the glue gap will be the
font&#8217;s normal space value (for Computer Modern Roman 10 point this is
@@ -8929,303 +11840,605 @@ than 2000 then &tex; adds the font&#8217;s extra space value (for Computer
Modern Roman 10 point this is 1.11111&#160;points), and then the font&#8217;s
normal stretch value is multiplied by <inlineequation><mathphrase>f /1000</mathphrase></inlineequation> and the normal
shrink value is multiplied by <inlineequation><mathphrase>1000/f</mathphrase></inlineequation> (for Computer Modern Roman
-10 point these are 1.66666 and 1.11111&#160;points). In short, compared
-to a normal space, such as the space following a word ending in a
-lowercase letter, inter-sentence spacing has a fixed extra space added
-and then the space can stretch 3 times as much and shrink 1/3 as much.
+10 point these are 1.66666 and 1.11111&#160;points).
+</para>
+<para>For example, consider the period ending <literal>A man's best friend is his
+dog.</literal> After it, &tex; puts in a fixed extra space, and also allows the
+glue to stretch 3 times as much and shrink 1/3 as much, as the glue
+after <literal>friend</literal>, which does not end in a period.
+</para>
+<para>The rules for space factors are even more complex because they play
+additional roles. In practice, there are two consequences. First, if a
+period or other punctuation is followed by a right parenthesis or
+bracket, or right single or double quote then the spacing effect of that
+period carries through those characters (that is, the following glue
+will have increased stretch and shrink). Second, if
+punctuation comes after a capital letter then its effect is not in place
+so you get an ordinary space. This second case also affects abbreviations
+that do not end in a capital letter (see <link linkend="_005c_0040">\@</link>).
</para>
-<para>The rules for how &tex; uses space factors are even more complex
-because they play two more roles. In practice, there are two
-consequences. First, if a period or other punctuation is followed by a
-close parenthesis or close double quote then its effect is still in
-place, that is, the following glue will have increased stretch and
-shrink. Second, conversely, if punctuation comes after a capital letter
-then its effect is not in place so you get an ordinary space. For how
-to adjust to this second case, for instance if an abbreviation does not
-end in a capital letter, see <link linkend="_005c_0028SPACE_0029-and-_005c_0040">\(SPACE) and \@</link>.
+<para>You can only use <literal>\spacefactor</literal> in paragraph mode or LR mode
+(see <link linkend="Modes">Modes</link>). You can see the current value with
+<literal>\the\spacefactor</literal> or <literal>\showthe\spacefactor</literal>.
+</para>
+<para>(Comment, not really related to <literal>\spacefactor</literal>: if you get errors
+like &#8216;<literal>You can't use `\spacefactor' in vertical mode</literal>&#8217;, or &#8216;<literal>You
+can't use `\spacefactor' in math mode.</literal>&#8217;, or &#8216;<literal>Improper \spacefactor</literal>&#8217;
+then you have probably tried to redefine an internal command.
+See <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</link>.)
</para>
-<sect2 label="19.3.1" id="_005c_0028SPACE_0029-and-_005c_0040">
-<title><literal>\(SPACE)</literal> and <literal>\@</literal></title>
+<sect2 label="19.5.1" id="_005c_0040">
+<title><literal>\@</literal></title>
-<indexterm role="fn"><primary>\(SPACE)</primary></indexterm>
-<indexterm role="fn"><primary>\TAB</primary></indexterm>
-<indexterm role="fn"><primary>\NEWLINE</primary></indexterm>
<indexterm role="fn"><primary>\@</primary></indexterm>
+<indexterm role="fn"><primary>at-sign</primary></indexterm>
+<indexterm role="cp"><primary>period, sentence-ending</primary></indexterm>
+<indexterm role="cp"><primary>period, abbreviation-ending</primary></indexterm>
+<indexterm role="cp"><primary>period, spacing after</primary></indexterm>
<anchor id="_005cAT"/><!-- old name -->
-<para>Here, <literal>\(SPACE)</literal> means a backslash followed by a space. These
-commands mark a punctuation character, typically a period, as either
-ending a sentence or as ending an abbreviation.
+<para>Synopsis:
+</para>
+<screen><replaceable>capital-letter</replaceable>\@.
+</screen>
+<para>Treat a period as sentence-ending, where &latex; would otherwise think
+it is part of an abbreviation. &latex; thinks that a period ends an
+abbreviation if the period comes after a capital letter, and otherwise
+thinks the period ends the sentence. By default, in justifying a line
+&latex; adjusts the space after a sentence-ending period (or a question
+mark, exclamation point, comma, or colon) more than it adjusts the space
+between words (see <link linkend="_005cspacefactor">\spacefactor</link>).
</para>
-<para>By default, in justifying a line &latex; adjusts the space after a
-sentence-ending period (or a question mark, exclamation point, comma, or
-colon) more than the space between words. See <link linkend="_005cspacefactor">\spacefactor</link>. As
-described there, &latex; assumes that the period ends a sentence unless
-it is preceded by a capital letter, in which case it takes that period
-for part of an abbreviation. Note that if a sentence-ending period is
-immediately followed by a right parenthesis or bracket, or right single
-or double quote, then the space effect of that period follows through
-that parenthesis or quote.
+<para>This example shows the two cases to remember.
</para>
-<para>So: if you have a period ending an abbreviation whose last letter is not
-a capital letter, and that abbreviation is not the last word in the
-sentence, then follow that period with a backslash-space (<literal>\ </literal>) or
-a tie (<literal>~</literal>) or a <literal>\@</literal>. Examples are <literal>Nat.\ Acad.\
-Science</literal>, and <literal>Mr.~Bean</literal>, and <literal>(manure, etc.\@) for sale</literal>
-(note that in the last the <literal>\@</literal> comes before the closing parenthesis).
+<screen>The songs \textit{Red Guitar}, etc.\ are by Loudon Wainwright~III\@.
+</screen>
+<para>The second period ends the sentence, despite that it is preceded by a
+capital. We tell &latex; that it ends the sentence by putting
+<literal>\@</literal> before it. The first period ends the abbreviation
+&#8216;<literal>etc.</literal>&#8217; but not the sentence. The backslash-space, <literal>\ </literal>,
+produces a mid-sentence space.
+</para>
+<para>So: if you have a capital letter followed by a period that ends the
+sentence, then put <literal>\@</literal> before the period. This holds even if
+there is an intervening right parenthesis or bracket, or right single or
+double quote, because the spacing effect of that period carries through
+those characters. For example, this
+</para>
+<screen>Use the \textit{Instructional Practices Guide},
+(a book by the MAA)\@.
+</screen>
+<para>will have correct inter-sentence spacing after the period.
</para>
-<para>In the opposite situation, if you have a capital letter followed by a
-period that does end the sentence, then put <literal>\@</literal> before the
-period. For example, <literal>book by the MAA\@.</literal> will have correct
-inter-sentence spacing after the period.
+<para>The <literal>\@</literal> command is only for a text mode. If you use it outside of
+a text mode then you get &#8216;<literal>You can't use `\spacefactor' in vertical
+mode</literal>&#8217; (see <link linkend="Modes">Modes</link>).
</para>
-<para>For another use of <literal>\(SPACE)</literal>, see <link linkend="_005c_0028SPACE_0029-after-control-sequence">\(SPACE) after control sequence</link>.
+<para>Comment: the converse case is a period ending an abbreviation whose last
+letter is not a capital letter, and that abbreviation is not the last
+word in the sentence. For that case follow the period with a
+backslash-space, (<literal>\ </literal>), or a tie, (<literal>~</literal>), or <literal>\@</literal>.
+Examples are <literal>Nat.\ Acad.\ Science</literal>, and <literal>Mr.~Bean</literal>, and
+<literal>(manure, etc.\@) for sale</literal> (note in the last one that the
+<literal>\@</literal> comes before the closing parenthesis).
</para>
</sect2>
-<sect2 label="19.3.2" id="_005cfrenchspacing">
+<sect2 label="19.5.2" id="_005cfrenchspacing">
<title><literal>\frenchspacing</literal></title>
<indexterm role="fn"><primary>\frenchspacing</primary></indexterm>
<indexterm role="fn"><primary>\nonfrenchspacing</primary></indexterm>
<indexterm role="cp"><primary>spacing, inter-sentence</primary></indexterm>
-<para>This declaration (from Plain &tex;) causes &latex; to treat
-inter-sentence spacing in the same way as interword spacing.
+<para>Synopsis, one of:
</para>
-<para>In justifying the text in a line, some typographic traditions, including
-English, prefer to adjust the space between sentences (or after other
-punctuation marks) more than the space between words. Following this
-declaration, all spaces are instead treated equally.
+<screen>\frenchspacing
+\nonfrenchspacing
+</screen>
+<para>The first declaration causes &latex; to treat spacing between sentences
+in the same way as spacing between words in the middle of a sentence.
+The second causes spacing between sentences to stretch or shrink more
+(see <link linkend="_005cspacefactor">\spacefactor</link>); this is the default.
</para>
-<para>Revert to the default behavior by declaring <literal>\nonfrenchspacing</literal>.
+<para>Some typographic traditions, including English, prefer to adjust the
+space between sentences (or spaces following a question mark,
+exclamation point, comma, or colon) more than the space between words
+that are in the middle of a sentence. Declaring <literal>\frenchspacing</literal>
+(the command is from Plain &tex;) switches to the tradition that all
+spaces are treated equally.
</para>
</sect2>
-<sect2 label="19.3.3" id="_005cnormalsfcodes">
+<sect2 label="19.5.3" id="_005cnormalsfcodes">
<title><literal>\normalsfcodes</literal></title>
<indexterm role="fn"><primary>\normalsfcodes</primary></indexterm>
<indexterm role="cp"><primary>spacing, inter-sentence</primary></indexterm>
-<para>Reset the &latex; space factor values to the default.
+<para>Synopsis:
+</para>
+<screen>\normalsfcodes
+</screen>
+<para>Reset the &latex; space factor values to the default
+(see <link linkend="_005cspacefactor">\spacefactor</link>).
</para>
</sect2>
</sect1>
-<sect1 label="19.4" id="_005c_0028SPACE_0029-after-control-sequence">
-<title><literal>\ </literal> after control sequence</title>
+<sect1 label="19.6" id="_005c_0028SPACE_0029">
+<title>Backslash-space, <literal>\ </literal></title>
+
+<indexterm role="cp"><primary>\NEWLINE</primary></indexterm>
+<indexterm role="cp"><primary>\SPACE</primary></indexterm>
+<indexterm role="cp"><primary>\TAB</primary></indexterm>
-<para>The <literal>\ </literal> command is often used after control sequences to keep
-them from gobbling the space that follows, as in &#8216;<literal>\TeX\ is nice</literal>&#8217;.
-And, under normal circumstances, <literal>\</literal><keycap>tab</keycap> and
-<literal>\</literal><keycap>newline</keycap> are equivalent to <literal>\ </literal>. For another use of
-<literal>\ </literal>, see also <link linkend="_005c_0028SPACE_0029-and-_005c_0040">\(SPACE) and \@</link>.
+<para>This section refers to the command consisting of two characters, a
+backslash followed by a space. Synopsis:
+</para>
+<screen>\
+</screen>
+<para>Produce a space. By default it produces white space of length
+3.33333pt plus 1.66666pt minus 1.11111pt.
+</para>
+<para>A blank is not a space. When you type a blank between words, &latex;
+produces white space. That&#8217;s different from an explicit space. This
+illustrates.
+</para>
+<screen>\begin{tabular}{l}
+Three blanks: in a row \\
+Three spaces:\ \ \ in a row \\
+\end{tabular}
+</screen>
+<para>On the first line &latex; collapses the three blanks to output one
+whitespace (it would be the same with a single blank or, for instance,
+with a blank and an tab and a blank, or a blank and a newline and a
+blank). But the second line asks for three spaces so the white area is
+wider. Thus, the backslash-space command will create some horizontal
+space. (But the best way to create horizontal space is with
+<literal>\hspace</literal>; See <link linkend="_005chspace">\hspace</link>.)
+</para>
+<para>The backslash-space command has two main uses. First, it is often used
+after control sequences to keep them from gobbling the space that
+follows, as in <literal>\TeX\ is nice</literal>. (But the approach of using curly
+parentheses, as in <literal>\TeX{} is nice</literal>, has the advantage of still
+working if the next character is a period.)
</para>
-<para>Some people prefer to use <literal>{}</literal> for the same purpose, as in
-<literal>\TeX{} is nice</literal>. This has the advantage that you can always
-write it the same way, namely <literal>\TeX{}</literal>, whether it is followed
-by a space or by a punctuation mark. Compare:
+<para>The second common use is that
+it mark a period as ending an abbreviation instead of ending
+a sentence, as in <literal>So says Prof.\ Smith</literal> (see <link linkend="_005c_0040">\@</link>).
</para>
-<screen>\TeX\ is a nice system. \TeX, a nice system.
+<para>Under normal circumstances, <literal>\</literal><keycap>tab</keycap> and <literal>\</literal><keycap>newline</keycap>
+are equivalent to backslash-space, <literal>\ </literal>.
+</para>
+<!-- @PkgIndex{xspace} -->
+<!-- Some individual commands, notably those defined with the @code{xspace}, -->
+<!-- package do not follow the standard behavior. -->
+
+
+</sect1>
+<sect1 label="19.7" id="_007e">
+<title><literal>~</literal></title>
-\TeX{} is a nice system. \TeX{}, a nice system.
+<indexterm role="fn"><primary>~</primary></indexterm>
+<indexterm role="cp"><primary>tie</primary></indexterm>
+<indexterm role="cp"><primary>space, hard</primary></indexterm>
+<indexterm role="cp"><primary>space, unbreakable</primary></indexterm>
+<indexterm role="cp"><primary>NBSP</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen><replaceable>before</replaceable>~<replaceable>after</replaceable>
</screen>
-<indexterm role="cp"><primary>package, <literal>xspace</literal></primary></indexterm>
-<indexterm role="cp"><primary><literal>xspace</literal> package</primary></indexterm>
+<para>The tie character, <literal>~</literal>, produces a space between <replaceable>before</replaceable> and
+<replaceable>after</replaceable> at which the line will not be broken. By default the white
+space has length 3.33333pt plus 1.66666pt minus
+1.11111pt (see <link linkend="Lengths">Lengths</link>).
+</para>
+<para>Here &latex; will not break the line between the final two words.
+</para>
+<screen>Thanks to Prof.~Lerman.
+</screen>
+<para>In addition, despite the period, &latex; does not use the
+end-of-sentence spacing (see <link linkend="_005c_0040">\@</link>).
+</para>
+<para>Ties prevent the end of line separation of things where that could cause
+confusion. But they also reduce &latex;&#8217;s options when it breaks lines
+into paragraphs, so you can use too many. They are also matters of
+taste, sometimes alarmingly dogmatic taste, among readers. Nevertheless,
+here are some usage models, many of them from the &tex;book.
+</para>
+<itemizedlist><listitem><para>Between an enumerator and its item, such as in references:
+<literal>Chapter~12</literal>, or <literal>Theorem~\ref{th:Wilsons}</literal>, or
+<literal>Figure~\ref{fig:KGraph}</literal>. When cases are enumerated inline:
+<literal>(b)~Show that $f(x)$ is (1)~continuous, and (2)~bounded</literal>.
+</para>
+<indexterm role="cp"><primary>package, <literal>siunitx</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>siunitx</literal> package</primary></indexterm>
-<para>Some individual commands, notably those defined with the <literal>xspace</literal>,
-package do not follow the standard behavior.
+</listitem><listitem><para>Between a number and its unit: <literal>$745.7.8$~watts</literal> (the
+<filename>siunitx</filename> package has a special facility for this) or
+<literal>144~eggs</literal>. This includes between a month and a date:
+<literal>October~12</literal> or <literal>12~Oct</literal>. In general, in any expressions where
+numbers and abbreviations or symbols are separated by a space:
+<literal>AD~565</literal>, or <literal>2:50~pm</literal>, or <literal>Boeing~747</literal>, or
+<literal>268~Plains Road</literal>, or <literal>\$$1.4$~billion</literal>.
+</para>
+</listitem><listitem><para>When mathematical phrases are rendered in words: <literal>equals~$n$</literal>, or
+<literal>less than~$\epsilon$</literal>, or <literal>given~$X$</literal>, or <literal>modulo~$p^e$
+for all large~$n$</literal> (but compare <literal>is~$15$</literal> with <literal>is $15$~times
+the height</literal>). Between mathematical symbols in apposition with nouns:
+<literal>dimension~$d$</literal> or <literal>function~$f(x)$</literal> (but compare <literal>with
+length $l$~or more</literal>). When a symbol is a tightly bound object of a
+preposition: <literal>of~$x$</literal>, or <literal>from $0$ to~$1$</literal>, or <literal>in
+common with~$m$</literal>.
+</para>
+</listitem><listitem><para>Between symbols in series: <literal>$1$,~$2$, or~$3$</literal> or <literal>$1$,~$2$,
+\ldots,~$n$</literal>.
+</para>
+</listitem><listitem><para>Between a person&#8217;s forenames and between multiple surnames:
+<literal>Donald~E. Knuth</literal>, or <literal>Luis~I. Trabb~Pardo</literal>, or
+<literal>Charles~XII</literal> (but you must give TeX places to break the line so
+you may do <literal>Charles Louis Xavier~Joseph de~la Vall\'ee~Poussin</literal>).
</para>
+</listitem><listitem><para>Before a dash: <literal>pages 12~--14</literal> or <literal>it is~--- it must be
+said~--- plausible</literal>.
+</para>
+</listitem></itemizedlist>
</sect1>
-<sect1 label="19.5" id="_005cthinspace">
-<title><literal>\thinspace</literal>: Insert 1/6em</title>
+<sect1 label="19.8" id="_005cthinspace-_0026-_005cnegthinspace">
+<title><literal>\thinspace</literal> &amp; <literal>\negthinspace</literal></title>
<indexterm role="fn"><primary>\thinspace</primary></indexterm>
+<indexterm role="fn"><primary>\negthinspace</primary></indexterm>
+<indexterm role="cp"><primary>thin space</primary></indexterm>
+<indexterm role="cp"><primary>space, thin</primary></indexterm>
+<indexterm role="cp"><primary>thin space, negative</primary></indexterm>
+<indexterm role="cp"><primary>space, negative thin</primary></indexterm>
-<para><literal>\thinspace</literal> produces an unbreakable and unstretchable space that
-is 1/6 of an em. This is the proper space to use between nested
-quotes, as in &#8217;&#8221;.<!-- Abuse @dmn, which is a thin space in Texinfo. -->
+<para>Synopsis, one of:
+</para>
+<screen>\thinspace
+\negthinspace
+</screen>
+<para>Produce an unbreakable and unstretchable space of 1/6em and
+-1/6em. These are the text mode equivalents of <literal>\,</literal> and
+<literal>\!</literal> (see <link linkend="Spacing-in-math-mode_002f_005cthinspace">Spacing in math mode/\thinspace</link>). You can use
+<literal>\,</literal> as a synonym for <literal>\thinspace</literal> in text mode.
+</para>
+<para>The <literal>\negthinspace</literal> command is used in text mode mostly for
+fiddling with spaces. One common use of <literal>\thinspace</literal> is as the
+space between nested quotes.
+</para>
+<screen>Killick replied, ``I heard the Captain say, `Ahoy there.'\thinspace''
+</screen>
+<para>Another use is that some style guides call for a <literal>\thinspace</literal>
+between an ellipsis and a sentence ending period (other style guides,
+though, think the three dots are quite enough already). Still another
+use is between initials, as in <literal>D.\thinspace E.\ Knuth</literal>.
</para>
</sect1>
-<sect1 label="19.6" id="_005c_002f">
-<title><literal>\/</literal>: Insert italic correction</title>
+<sect1 label="19.9" id="_005c_002f">
+<title><literal>\/</literal></title>
<indexterm role="fn"><primary>\/</primary></indexterm>
<indexterm role="cp"><primary>italic correction</primary></indexterm>
-<para>The <literal>\/</literal> command produces an <firstterm>italic correction</firstterm>. This is a
-small space defined by the font designer for a given character,
-to avoid the character colliding with whatever follows. The italic
-<emphasis>f</emphasis> character typically has a large italic correction value.
-</para>
-<para>If the following character is a period or comma, it&#8217;s not necessary to
-insert an italic correction, since those punctuation symbols have a
-very small height. However, with semicolons or colons, as well as
-normal letters, it can help. Compare
-<emphasis>f: f;</emphasis> (in the &tex; output, the &#8216;f&#8217;s are nicely separated)
-with <emphasis>f: f;</emphasis>.
-</para>
-<para>When changing fonts with commands such as <literal>\textit{italic
-text}</literal> or <literal>{\itshape italic text}</literal>, &latex; will
-automatically insert an italic correction if appropriate (see <link linkend="Font-styles">Font
-styles</link>).
+<para>Synopsis:
+</para>
+<screen><replaceable>before-character</replaceable>\/<replaceable>after-character</replaceable>
+</screen>
+<para>Insert an <firstterm>italic correction</firstterm>, a small space defined by the font
+designer for each character, to avoid the character colliding with
+whatever follows. When you use <literal>\/</literal>, &latex; takes the correction
+from the font metric file, scales it by any scaling that has been
+applied to the font, and then inserts that much horizontal space.
</para>
-<para>Despite the name, roman characters can also have an italic
-correction. Compare
-pdf&tex; (in the &tex; output, there is a small space after the &#8216;f&#8217;)
-with pdf&tex;.
+<para>Here, were it not for the <literal>\/</literal>, the <replaceable>before-character</replaceable>
+italic&#160;f would hit the <replaceable>after-character</replaceable> roman&#160;H
+</para>
+<screen>\newcommand{\companylogo}{{\it f}\/H}
+</screen>
+<para>because the italic letter leans far to the right.
+</para>
+<para>If <replaceable>after-character</replaceable> is a period or comma then don&#8217;t insert an
+italic correction since those punctuation symbols have a very small
+height. However, with semicolons or colons as well as with normal
+letters, the italic correction can help.
+</para>
+<para>When you use commands such as <literal>\textit</literal> or <literal>\itshape</literal> to
+change fonts, &latex; will automatically insert any needed italic
+correction (see <link linkend="Font-styles">Font styles</link>).
+</para>
+<para>Roman characters can also have an italic correction. An example is in
+the name <literal>pdf\/\TeX</literal>.
</para>
<para>There is no concept of italic correction in math mode; spacing is done
in a different way.
</para>
</sect1>
-<sect1 label="19.7" id="_005chrulefill-_005cdotfill">
-<title><literal>\hrulefill \dotfill</literal></title>
+<sect1 label="19.10" id="_005chrulefill-_0026-_005cdotfill">
+<title><literal>\hrulefill</literal> &amp; <literal>\dotfill</literal></title>
<indexterm role="fn"><primary>\hrulefill</primary></indexterm>
<indexterm role="fn"><primary>\dotfill</primary></indexterm>
-<para>Produce an infinite rubber length (see <link linkend="Lengths">Lengths</link>) filled with a
-horizontal rule (that is, a line) or with dots, instead of just white
-space.
+<para>Synopsis, one of:
</para>
-<para>When placed between blank lines this example creates a paragraph that is
-left and right justified, where the space in the middle is filled with
-evenly spaced dots.
+<screen>\hrulefill
+\dotfill
+</screen>
+<para>Produce an infinite horizontal rubber length (see <link linkend="Lengths">Lengths</link>) that
+&latex; fills with a rule (that is, a line) or with dots, instead of
+white space.
+</para>
+<para>This outputs a line 2 inches long.
+</para>
+<screen>Name:~\makebox[2in]{\hrulefill}
+</screen>
+<para>This example, when placed between blank lines, creates a paragraph that
+is left and right justified and where the middle is filled with evenly
+spaced dots.
</para>
-<screen>\noindent Jack Aubrey\dotfill Melbury Lodge
+<screen>\noindent John Aubrey, RN \dotfill{} Melbury Lodge
</screen>
<para>To make the rule or dots go to the line&#8217;s end use <literal>\null</literal> at the
start or end.
</para>
<para>To change the rule&#8217;s thickness, copy the definition and adjust it, as
-with <literal>\renewcommand{\hrulefill}{\leavevmode\leaders\hrule height
-1pt\hfill\kern\z@}</literal>, which changes the default thickness of
-0.4pt to 1pt. Similarly, adjust the dot spacing as with
-<literal>\renewcommand{\dotfill}{\leavevmode\cleaders\hb@xt@
-1.00em{\hss .\hss }\hfill\kern\z@}</literal>, which changes the default
-length of 0.33em to 1.00em.
+here
</para>
-
-</sect1>
-<sect1 label="19.8" id="_005caddvspace">
-<title><literal>\addvspace</literal></title>
-
-<indexterm role="fn"><primary>\addvspace</primary></indexterm>
-<indexterm role="cp"><primary>vertical space</primary></indexterm>
-<indexterm role="cp"><primary>space, inserting vertical</primary></indexterm>
-
-<para><literal>\addvspace{<replaceable>length</replaceable>}</literal>
-</para>
-<para>Add a vertical space of height <replaceable>length</replaceable>, which is a rubber length
-(see <link linkend="Lengths">Lengths</link>). However, if vertical space has already been added to
-the same point in the output by a previous <literal>\addvspace</literal> command
-then this command will not add more space than what is needed to make
-the natural length of the total vertical space equal to <replaceable>length</replaceable>.
+<screen>\renewcommand{\hrulefill}{%
+ \leavevmode\leaders\hrule height 1pt\hfill\kern\z@}
+</screen>
+<para>which changes the default thickness of 0.4pt to 1pt.
+Similarly, adjust the dot spacing as with
</para>
-<para>Use this command to adjust the vertical space above or below an
-environment that starts a new paragraph. For instance, a Theorem
-environment is defined to begin and end with <literal>\addvspace{...}</literal>
-so that two consecutive Theorem&#8217;s are separated by one vertical space,
-not two.
+<screen>\renewcommand{\dotfill}{%
+ \leavevmode\cleaders\hb@xt@1.00em{\hss .\hss }\hfill\kern\z@}
+</screen>
+<para>which changes the default length of 0.33em to 1.00em.
</para>
-<para>This command is fragile (see <link linkend="_005cprotect">\protect</link>).
+<para>This example produces a line for a signature.
</para>
-<para>The error &#8216;<literal>Something's wrong--perhaps a missing \item</literal>&#8217; means that
-you were not in vertical mode when you invoked this command; one way to
-change that is to precede this command with a <literal>\par</literal> command.
+<screen>\begin{minipage}{4cm}
+ \centering
+ \hrulefill\\
+ Signed
+\end{minipage}
+</screen>
+<para>The line is 4cm long.
</para>
</sect1>
-<sect1 label="19.9" id="_005cbigskip-_005cmedskip-_005csmallskip">
-<title><literal>\bigskip \medskip \smallskip</literal></title>
+<sect1 label="19.11" id="_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">
+<title><literal>\bigskip</literal> &amp; <literal>\medskip</literal> &amp; <literal>\smallskip</literal></title>
-<para>These commands produce a given amount of space, specified by the
-document class.
+<para>Synopsis, one of:
+</para>
+<screen>\bigskip
+\medskip
+\smallskip
+</screen>
+<para>Produce an amount of vertical space, large or medium-sized or
+small. These commands are fragile (see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>Here the skip suggests the passage of time (from <emphasis>The Golden Ocean</emphasis> by
+O&#8217;Brian).
</para>
-<variablelist><varlistentry><term><indexterm role="fn"><primary>\bigskip</primary></indexterm><literal>\bigskip</literal>
+<screen>Mr Saumarez would have something rude to say to him, no doubt: he
+was at home again, and it was delightful.
+
+\bigskip
+``A hundred and fifty-seven miles and one third, in twenty-four hours,''
+said Peter.
+</screen>
+<para>Each command is associated with a length defined in the document class
+file.
+</para>
+<variablelist><anchor id="bigskip"/><varlistentry><term><indexterm role="fn"><primary>\bigskip</primary></indexterm><literal>\bigskip</literal>
</term><listitem><indexterm role="fn"><primary>\bigskipamount</primary></indexterm>
<para>The same as <literal>\vspace{\bigskipamount}</literal>, ordinarily about one line
-space, with stretch and shrink (the default for the <literal>book</literal> and
-<literal>article</literal> classes is <literal>12pt plus 4pt minus 4pt</literal>).
+space, with stretch and shrink. The default for the <literal>book</literal> and
+<literal>article</literal> classes is <literal>12pt plus 4pt minus 4pt</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\medskip</primary></indexterm><literal>\medskip</literal>
+<anchor id="medskip"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\medskip</primary></indexterm><literal>\medskip</literal>
</term><listitem><indexterm role="fn"><primary>\medskipamount</primary></indexterm>
-<para>The same as <literal>\vspace{\medskipamount}</literal>, ordinarily about half of
-a line space, with stretch and shrink (the default for the <literal>book</literal>
-and <literal>article</literal> classes is <literal>6pt plus 2pt minus 2pt</literal>).
+<para>The same as <literal>\vspace{\medskipamount}</literal>, ordinarily about half of a
+line space, with stretch and shrink. The default for the <literal>book</literal>
+and <literal>article</literal> classes is <literal>6pt plus 2pt minus 2pt</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\smallskip</primary></indexterm><literal>\smallskip</literal>
+<anchor id="smallskip"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\smallskip</primary></indexterm><literal>\smallskip</literal>
</term><listitem><indexterm role="fn"><primary>\smallskipamount</primary></indexterm>
<para>The same as <literal>\vspace{\smallskipamount}</literal>, ordinarily about a
-quarter of a line space, with stretch and shrink (the default for the
-<literal>book</literal> and <literal>article</literal> classes is <literal>3pt plus 1pt minus
-1pt</literal>).
+quarter of a line space, with stretch and shrink. The default for the
+<literal>book</literal> and <literal>article</literal> classes is <literal>3pt plus 1pt minus 1pt</literal>.
</para>
</listitem></varlistentry></variablelist>
+<para>Because each command is a <literal>\vspace</literal>, if you use on in mid-paragraph
+then it will insert its vertical space between the line in which you use
+it and the next line, not necessarily at the place that you use it. So
+these are best between paragraphs.
+</para>
+<para>The commands <literal>\bigbreak</literal>, <literal>\medbreak</literal>, and <literal>\smallbreak</literal>
+are similar but also suggest to &latex; that this is a good place to
+put a page break (see <link linkend="_005cbigbreak-_0026-_005cmedbreak-_0026-_005csmallbreak">\bigbreak &amp; \medbreak &amp; \smallbreak</link>.
+</para>
</sect1>
-<sect1 label="19.10" id="_005cvfill">
-<title><literal>\vfill</literal></title>
+<sect1 label="19.12" id="_005cbigbreak-_0026-_005cmedbreak-_0026-_005csmallbreak">
+<title><literal>\bigbreak</literal> &amp; <literal>\medbreak</literal> &amp; <literal>\smallbreak</literal></title>
-<indexterm role="fn"><primary>\vfill</primary></indexterm>
+<para>Synopsis, one of:
+</para>
+<screen>\bigbreak
+\medbreak
+\smallbreak
+</screen>
+<para>Produce a vertical space that is big or medium-sized or small, and
+suggest to &latex; that this is a good place to break the page. (The
+associated penalties are -200, -100, and -50.)
+</para>
+<para>See <link linkend="_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">\bigskip &amp; \medskip &amp; \smallskip</link>, for more. These commands
+produce the same vertical space but differ in that they also remove a
+preceding vertical space if it is less than what they would insert (as
+with <literal>\addvspace</literal>). In addition, they terminate a paragraph where
+they are used: this example
+</para>
+<screen>abc\bigbreak def ghi
-<indexterm role="cp"><primary>stretch, infinite vertical</primary></indexterm>
-<indexterm role="cp"><primary>infinite vertical stretch</primary></indexterm>
+jkl mno pqr
+</screen>
+<para>will output three paragraphs, the first ending in &#8216;<literal>abc</literal>&#8217; and the
+second starting, after an extra vertical space and a paragraph indent,
+with &#8216;<literal>def</literal>&#8217;.
+</para>
+
+</sect1>
+<sect1 label="19.13" id="_005cstrut">
+<title><literal>\strut</literal></title>
-<para>End the current paragraph and insert a vertical rubber length
-(see <link linkend="Lengths">Lengths</link>) that is infinite, so it can stretch or shrink as far
-as needed.
+<indexterm role="fn"><primary>\strut</primary></indexterm>
+<indexterm role="cp"><primary>strut</primary></indexterm>
+
+<para>Synopsis:
</para>
-<para>It is often used in the same way as <literal>\vspace{\fill}</literal>, except that
-<literal>\vfill</literal> ends the current paragraph, whereas
-<literal>\vspace{\fill}</literal> adds the infinite vertical space below its line
-irrespective of the paragraph structure. In both cases that space will
-disappear at a page boundary; to circumvent this see&#160;<link linkend="_005cvspace">\vspace</link>.
+<screen>\strut
+</screen>
+<para>Ensure that the current line has height at least <literal>0.7\baselineskip</literal>
+and depth at least <literal>0.3\baselineskip</literal>. Essentially, &latex;
+inserts into the line a rectangle having zero width,
+<literal>\rule[-0.3\baselineskip]{0pt}{\baselineskip}</literal> (see <link linkend="_005crule">\rule</link>).
+The <literal>\baselineskip</literal> changes with the current font and fontsize.
</para>
-<para>In this example the page is filled, so the top and bottom lines contain
-the text &#8216;<literal>Lost Dog!</literal>&#8217; and the third &#8216;<literal>Lost Dog!</literal>&#8217; is exactly
-halfway between them.
-</para>
-<screen>\begin{document}
-Lost Dog!
-\vfill
-Lost Dog!
-\vfill
-Lost Dog!
-\end{document}
+<para>In this example the <literal>\strut</literal> keeps the box inside the frame from
+having zero height.
+</para>
+<screen>\setlength{\fboxsep}{0pt}\framebox[2in]{\strut}
+</screen>
+<para>This example has four lists. In the first there is a much bigger gap
+between items 2 and&#160;3 than there is between items 1 and&#160;2.
+The second list fixes that with a <literal>\strut</literal> at the end of its first
+item&#8217;s second line.
+</para>
+<screen>\setlength{\fboxsep}{0pt}
+\noindent\begin{minipage}[t]{0.2\linewidth}
+\begin{enumerate}
+ \item \parbox[t]{15pt}{test \\ test}
+ \item test
+ \item test
+\end{enumerate}
+\end{minipage}%
+\begin{minipage}[t]{0.2\linewidth}
+\begin{enumerate}
+ \item \parbox[t]{15pt}{test \\ test\strut}
+ \item test
+ \item test
+\end{enumerate}
+\end{minipage}%
+\begin{minipage}[t]{0.2\linewidth}
+\begin{enumerate}
+ \item \fbox{\parbox[t]{15pt}{test \\ test}}
+ \item \fbox{test}
+ \item \fbox{test}
+\end{enumerate}
+\end{minipage}%
+\begin{minipage}[t]{0.2\linewidth}
+\begin{enumerate}
+ \item \fbox{\parbox[t]{15pt}{test \\ test\strut}}
+ \item \fbox{test}
+ \item \fbox{test}
+\end{enumerate}
+\end{minipage}%
+</screen>
+<para>The final two lists use <literal>fbox</literal> to show what&#8217;s happening. The third
+list&#8217;s <literal>\parbox</literal> goes only to the bottom of its second &#8216;<literal>test</literal>&#8217;,
+which happens not have any characters that descend below the baseline.
+The fourth list adds the strut that gives the needed extra
+below-baseline space.
+</para>
+<indexterm role="cp"><primary>package, <literal>TikZ</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>TikZ</literal> package</primary></indexterm>
+<indexterm role="cp"><primary>package, <literal>Asymptote</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>Asymptote</literal> package</primary></indexterm>
+
+<para>The <literal>\strut</literal> command is often useful in graphics, such as in
+<filename>TikZ</filename> or <filename>Asymptote</filename>. For instance, you may have a command
+such as <literal>\graphnode{<replaceable>node-name</replaceable>}</literal> that fits a circle around
+<replaceable>node-name</replaceable>. However, unless you are careful the <replaceable>node-name</replaceable>&#8217;s
+&#8216;<literal>x</literal>&#8217; and &#8216;<literal>y</literal>&#8217; will produce different-diameter circles because
+the characters are different sizes. A careful <literal>\graphnode</literal> might
+insert a <literal>\strut</literal>, then <replaceable>node-name</replaceable>, and then draw the circle.
+</para>
+<para>The general approach of using a zero width <literal>\rule</literal> is useful in
+many circumstances. In this table, the zero-width rule keeps the top of
+the first integral from hitting the <literal>\hline</literal>. Similarly, the
+second rule keeps the second integral from hitting the first.
+</para>
+<screen>\begin{tabular}{rl}
+ \textsc{Integral} &amp;\textsc{Value} \\
+ \hline
+ $\int_0^x t\, dt$ &amp;$x^2/2$ \rule{0em}{2.5ex} \\
+ $\int_0^x t^2\, dt$ &amp;$x^3/3$ \rule{0em}{2.5ex}
+\end{tabular}
</screen>
+<para>(Although the line-ending double backslash command has an available
+optional argument to put in more vertical room, that won&#8217;t work here.
+Changing the first double backslash to something like <literal>\\[2.5ex]</literal>
+will put the room between the header line and the <literal>\hline</literal>, and the
+integral would still hit the line.)
+</para>
</sect1>
-<sect1 label="19.11" id="_005cvspace">
-<title><literal>\vspace{<replaceable>length</replaceable>}</literal></title>
+<sect1 label="19.14" id="_005cvspace">
+<title><literal>\vspace</literal></title>
<indexterm role="fn"><primary>\vspace</primary></indexterm>
<indexterm role="cp"><primary>vertical space</primary></indexterm>
<indexterm role="cp"><primary>space, vertical</primary></indexterm>
-<para>Synopsis, one of these two:
+<para>Synopsis, one of:
</para>
<screen>\vspace{<replaceable>length</replaceable>}
\vspace*{<replaceable>length</replaceable>}
</screen>
-<para>Add the vertical space <replaceable>length</replaceable>. This can be negative or positive,
-and is a rubber length (see <link linkend="Lengths">Lengths</link>).
+<para>Add the vertical space <replaceable>length</replaceable>. The <replaceable>length</replaceable> can be positive,
+negative, or zero. It is a rubber length&#8212;it may contain a <literal>plus</literal>
+or <literal>minus</literal> component (see <link linkend="Lengths">Lengths</link>).
</para>
-<para>&latex; removes the vertical space from <literal>\vspace</literal> at a page
-break, that is, at the top or bottom of a page. The starred version
-<literal>\vspace*{...}</literal> causes the space to stay.
+<para>This puts space between the two paragraphs.
</para>
-<para>If <literal>\vspace</literal> is used in the middle of a paragraph (i.e., in
-horizontal mode), the space is inserted <emphasis>after</emphasis> the line with
-the <literal>\vspace</literal> command. A new paragraph is not started.
+<screen>And I slept.
+
+\vspace{1ex plus 0.5ex}
+The new day dawned cold.
+</screen>
+<para>(See <link linkend="_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">\bigskip &amp; \medskip &amp; \smallskip</link> for common inter-paragraph
+spaces.)
+</para>
+<para>The <literal>*</literal>-version inserts vertical space that non-discardable. More
+precisely, &latex; discards vertical space at a page break and the
+<literal>*</literal>-version causes the space to stay. This example leaves space
+between the two questions.
+</para>
+<screen>Question: Find the integral of \( 5x^4+5 \).
+
+\vspace*{2cm plus 0.5cm}
+Question: Find the derivative of \( x^5+5x+9 \).
+</screen>
+<para>That space will be present even if the page break happens to fall
+between the questions.
+</para>
+<para>If you use <literal>\vspace</literal> in the middle of a paragraph (i.e., in
+horizontal mode) then the space is inserted after the line containing
+the <literal>\vspace</literal> command; it does not start a new paragraph at the
+<literal>\vspace</literal> command.
</para>
<para>In this example the two questions will be evenly spaced vertically on
the page, with at least one inch of space below each.
@@ -9240,222 +12453,548 @@ the page, with at least one inch of space below each.
</screen>
</sect1>
+<sect1 label="19.15" id="_005cvfill">
+<title><literal>\vfill</literal></title>
+
+<indexterm role="fn"><primary>\vfill</primary></indexterm>
+
+<indexterm role="cp"><primary>stretch, infinite vertical</primary></indexterm>
+<indexterm role="cp"><primary>infinite vertical stretch</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\vfill
+</screen>
+<para>End the current paragraph and insert a vertical rubber length that is
+infinite, so it can stretch or shrink as far as needed
+(see <link linkend="Lengths">Lengths</link>).
+</para>
+<para>It is often used in the same way as <literal>\vspace{\fill}</literal>, except that
+<literal>\vfill</literal> ends the current paragraph whereas <literal>\vspace{\fill}</literal>
+adds the infinite vertical space below its line, irrespective of the
+paragraph structure. In both cases that space will disappear at a page
+boundary; to circumvent this see the starred option
+in&#160;<link linkend="_005cvspace">\vspace</link>.
+</para>
+<para>In this example the page is filled, so the top and bottom lines contain
+the text &#8216;<literal>Lost Dog!</literal>&#8217; and the second &#8216;<literal>Lost Dog!</literal>&#8217; is exactly
+halfway between them.
+</para>
+<screen>\begin{document}
+Lost Dog!
+\vfill
+Lost Dog! % perfectly in the middle
+\vfill
+Lost Dog!
+\end{document}
+</screen>
+
+</sect1>
+<sect1 label="19.16" id="_005caddvspace">
+<title><literal>\addvspace</literal></title>
+
+<indexterm role="fn"><primary>\addvspace</primary></indexterm>
+<indexterm role="cp"><primary>vertical space</primary></indexterm>
+<indexterm role="cp"><primary>space, inserting vertical</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\addvspace{<replaceable>vert-length</replaceable>}
+</screen>
+<para>Add a vertical space of <replaceable>vert-length</replaceable>. However, if there are two or
+more <literal>\addvspace</literal>&#8217;s in a sequence then together they only add the
+space needed to make the natural length equal to the maximum of the
+<replaceable>vert-length</replaceable>&#8217;s in that sequence. This command is fragile
+(see <link linkend="_005cprotect">\protect</link>). The <replaceable>vert-length</replaceable> is a rubber length
+(see <link linkend="Lengths">Lengths</link>).
+</para>
+<para>This example illustrates. The <literal>picture</literal> draws a scale. In a
+standard &latex; article the length <literal>\baselineskip</literal> is 12pt.
+The two rules here are 22pt apart: the sum of the
+<literal>\baselineskip</literal> and the 10pt from the first <literal>addvspace</literal>.
+</para>
+<screen>\documentclass{article}
+\usepackage{color}
+\begin{document}
+\setlength{\unitlength}{2pt}%
+\noindent\begin{picture}(0,0)%
+ \multiput(0,0)(0,-1){25}{{\color{blue}\line(1,0){1}}}
+ \multiput(0,0)(0,-5){6}{{\color{red}\line(1,0){2}}}
+\end{picture}%
+\rule{0.25\linewidth}{0.1pt}%
+\par\addvspace{10pt}% \addvspace{20pt}%
+\par\noindent\rule{0.25\linewidth}{0.1pt}%
+\end{document}
+</screen>
+<para>Now uncomment the second <literal>\addvspace</literal>. It does not make the gap
+20pt longer; instead the gap is the sum of <literal>\baselineskip</literal>
+and 20pt. So <literal>\addvspace</literal> in a sense does the opposite of
+its name &#8212; it makes sure that multiple vertical spaces do not
+accumulate, but instead that only the largest one is used.
+</para>
+<para>&latex; uses this command to adjust the vertical space above or below
+an environment that starts a new paragraph. For instance, a
+<literal>theorem</literal> environment begins and ends with <literal>\addvspace</literal> so
+that two consecutive <literal>theorem</literal>&#8217;s are separated by one vertical
+space, not two.
+</para>
+<para>A error &#8216;<literal>Something's wrong--perhaps a missing \item</literal>&#8217; pointing to an
+<literal>\addvspace</literal> means that you were not in vertical mode when you hit
+this command. One way to change that is to precede <literal>\addvspace</literal>
+with a <literal>\par</literal> command (see <link linkend="_005cpar">\par</link>), as in the above example.
+</para>
+
+</sect1>
</chapter>
<chapter label="20" id="Boxes">
<title>Boxes</title>
<indexterm role="cp"><primary>boxes</primary></indexterm>
-<para>All the predefined length parameters (see <link linkend="Predefined-lengths">Predefined lengths</link>) can be
-used in the arguments of the box-making commands.
+<para>At its core, &latex; puts things in boxes and then puts the boxes on a
+page. So these commands are central.
+</para>
+<para>There are many packages on CTAN that are useful for manipulating boxes.
+One useful adjunct to the commands here is <filename>adjustbox</filename>.
</para>
-<sect1 label="20.1" id="_005cmbox">
-<title><literal>\mbox{<replaceable>text}</replaceable></literal></title>
+<sect1 label="20.1" id="_005cmbox-_0026-_005cmakebox">
+<title><literal>\mbox</literal> &amp; <literal>\makebox</literal></title>
<indexterm role="fn"><primary>\mbox</primary></indexterm>
-
+<indexterm role="fn"><primary>\makebox</primary></indexterm>
+<indexterm role="cp"><primary>box</primary></indexterm>
+<indexterm role="cp"><primary>make a box</primary></indexterm>
<indexterm role="cp"><primary>hyphenation, preventing</primary></indexterm>
-<para>The <literal>\mbox</literal> command creates a box just wide enough to hold the
-text created by its argument. The <replaceable>text</replaceable> is not broken into
-lines, so it can be used to prevent hyphenation.
+
+<para>Synopsis, one of:
+</para>
+<screen>\mbox{<replaceable>text</replaceable>}
+\makebox{<replaceable>text</replaceable>}
+\makebox[<replaceable>width</replaceable>]{<replaceable>text</replaceable>}
+\makebox[<replaceable>width</replaceable>][<replaceable>position</replaceable>]{<replaceable>text</replaceable>}
+</screen>
+<para>Create a box, a container for material. The <replaceable>text</replaceable> is is typeset in
+LR mode (see <link linkend="Modes">Modes</link>) so it is not broken into lines. The
+<literal>\mbox</literal> command is robust, while <literal>\makebox</literal> is fragile
+(see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>Because <literal>text</literal> is not broken into lines, you can use <literal>\mbox</literal>
+to prevent hyphenation. In this example, &latex; will not hyphenate
+the table name, &#8216;<literal>T-4</literal>&#8217;.
+</para>
+<screen>See Table~\mbox{T-4}
+</screen>
+<para>The first two command versions, <literal>\mbox</literal> and <literal>\makebox</literal>, are
+roughly equivalent. They create a box just wide enough to contain the
+<replaceable>text</replaceable>. (They are like plain &tex;&#8217;s <literal>\hbox</literal>.)
+</para>
+<para>In the third version the optional argument <replaceable>width</replaceable> specifies the
+width of the box. Note that the space occupied by the text need not
+equal the width of the box. For one thing, <replaceable>text</replaceable> can be too small;
+this creates a full-line box
+</para>
+<screen>\makebox[\linewidth]{Chapter Exam}
+</screen>
+<para>with &#8216;<literal>Chapter Exam</literal>&#8217; centered. But <replaceable>text</replaceable> can also be too wide
+for <replaceable>width</replaceable>. See the example below of zero-width boxes.
+</para>
+<anchor id="mbox-makebox-depth"/><anchor id="mbox-makebox-height"/><anchor id="mbox-makebox-width"/><anchor id="mbox-makebox-totalheight"/><para>In the <replaceable>width</replaceable> argument you can use the following lengths that refer
+to the dimension of the box that &latex; gets on typesetting
+<replaceable>text</replaceable>: <literal>\depth</literal>, <literal>\height</literal>, <literal>\width</literal>,
+<literal>\totalheight</literal> (this is the box&#8217;s height plus its depth). For
+example, to make a box with the text stretched to double the natural
+size you can say this.
+</para>
+<screen>\makebox[2\width]{Get a stretcher}
+</screen>
+<para>For the fourth command version the optional argument <replaceable>position</replaceable>
+gives position of the text within the box. It may take the following
+values:
+</para>
+<variablelist><varlistentry><term><literal>c</literal>
+</term><listitem><para>The <replaceable>text</replaceable> is centered (default).
+</para>
+</listitem></varlistentry><varlistentry><term><literal>l</literal>
+</term><listitem><para>The <replaceable>text</replaceable> is flush left.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>r</literal>
+</term><listitem><para>Flush right.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>s</literal>
+</term><listitem><para>Stretch the interword space in <replaceable>text</replaceable> across the entire <replaceable>width</replaceable>.
+The <replaceable>text</replaceable> must contain stretchable space for this to work. For
+instance, this could head a press release:
+<literal>\noindent\makebox[\textwidth][s]{\large\hfil IMMEDIATE\hfil
+RELEASE\hfil}</literal>
+</para></listitem></varlistentry></variablelist>
+<para>A common use of <literal>\makebox</literal> is to make zero-width text boxes. This
+puts the value of the quiz questions to the left of those questions.
+</para>
+<screen>\newcommand{\pts}[1]{\makebox[0em][r]{#1 points\hspace*{1em}}}
+\pts{10}What is the air-speed velocity of an unladen swallow?
+
+\pts{90}An African or European swallow?
+</screen>
+<para><indexterm role="cp"><primary>package, <literal>TikZ</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>TikZ</literal> package</primary></indexterm>
+</para>
+<indexterm role="cp"><primary>package, <literal>Asymptote</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>Asymptote</literal> package</primary></indexterm>
+
+<para>The right edge of the output &#8216;<literal>10 points </literal>&#8217; (note the ending space)
+will be just before the &#8216;<literal>What</literal>&#8217; (note the space after
+&#8216;<literal>points</literal>&#8217;). You can use <literal>\makebox</literal> similarly when making
+graphics, such as in <filename>TikZ</filename> or <filename>Asymptote</filename>, where you put the
+edge of the text at a known location, regardless of the length of that
+text.
+</para>
+<para>For boxes with frames see&#160;<link linkend="_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</link>. For colors
+see&#160;<link linkend="Colored-boxes">Colored boxes</link>.
+</para>
+<para>There is a related version of <literal>\makebox</literal> that is used within the
+<literal>picture</literal> environment, where the length is given in terms of
+<literal>\unitlength</literal> (see <link linkend="_005cmakebox-_0028picture_0029">\makebox (picture)</link>).
+</para>
+<para>If you put a double-backslash into <replaceable>text</replaceable> then &latex; will not
+give you a new line; for instance <literal>\makebox{abc def \\ ghi}</literal>
+outputs &#8216;<literal>abc defghi</literal>&#8217; while <literal>\makebox{abc def \par ghi}</literal>
+outputs &#8216;<literal>abc def ghi</literal>&#8217;, but neither go to a second line. To get
+multiple lines see&#160;<link linkend="_005cparbox">\parbox</link> and&#160;<link linkend="minipage">minipage</link>.
</para>
</sect1>
-<sect1 label="20.2" id="_005cfbox-and-_005cframebox">
-<title><literal>\fbox</literal> and <literal>\framebox</literal></title>
+<sect1 label="20.2" id="_005cfbox-_0026-_005cframebox">
+<title><literal>\fbox</literal> &amp; <literal>\framebox</literal></title>
<indexterm role="fn"><primary>\fbox</primary></indexterm>
<indexterm role="fn"><primary>\framebox</primary></indexterm>
-<para>Synopses:
+<para>Synopses, one of:
</para>
<screen>\fbox{<replaceable>text</replaceable>}
+\framebox{<replaceable>text</replaceable>}
+\framebox[<replaceable>width</replaceable>]{<replaceable>text</replaceable>}
\framebox[<replaceable>width</replaceable>][<replaceable>position</replaceable>]{<replaceable>text</replaceable>}
</screen>
-<para>The <literal>\fbox</literal> and <literal>\framebox</literal> commands are like <literal>\mbox</literal>,
-except that they put a frame around the outside of the box being created.
+<para>Create a box with an enclosing frame, four lines surrounding the space.
+These commands are the same as <literal>\mbox</literal> and <literal>\makebox</literal> except
+for the frame (see <link linkend="_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</link>). The <literal>\fbox</literal> command is
+robust, the <literal>\framebox</literal> command is fragile (see <link linkend="_005cprotect">\protect</link>).
</para>
-<para>In addition, the <literal>\framebox</literal> command allows for explicit
-specification of the box width with the optional <replaceable>width</replaceable> argument
-(a dimension), and positioning with the optional <replaceable>position</replaceable>
-argument. <!-- xxref -->
+<screen>\fbox{Warning! No work shown, no credit given.}
+</screen>
+<para>&latex; puts the text into a box that cannot be split or hyphenated.
+Around that box, separated from it by a small gap, are four lines making
+a frame.
</para>
-<indexterm role="fn"><primary>\fboxrule</primary></indexterm>
-<indexterm role="fn"><primary>\fboxsep</primary></indexterm>
-<para>Both commands produce a rule of thickness <literal>\fboxrule</literal> (default
-<literal>0.4pt</literal>), and leave a space of <literal>\fboxsep</literal> (default <literal>3pt</literal>)
-between the rule and the contents of the box.
+<para>The first two command invocations, <literal>\fbox{...}</literal> and
+<literal>\framebox{...}</literal>, are roughly the same. As to the third and
+fourth invocations, the optional arguments allow you to specify the box
+width as <replaceable>width</replaceable> and the position of the text inside that box as
+<replaceable>position</replaceable>. See <link linkend="_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</link> for the full description but
+here is an example creating an empty box that is 1/4in wide.
</para>
-<para>See <link linkend="_005cframebox-_0028picture_0029">\framebox (picture)</link>, for the <literal>\framebox</literal> command in the
-<literal>picture</literal> environment.
+<screen>\setlength{\fboxsep}{0pt}\framebox[0.25in]{\strut}}
+</screen>
+<para>The <literal>\strut</literal> inserts a vertical height of <literal>\baselineskip</literal>
+(see <link linkend="_005cstrut">\strut</link>).
</para>
-
-</sect1>
-<sect1 label="20.3" id="lrbox">
-<title><literal>lrbox</literal></title>
-
-<indexterm role="fn"><primary>lrbox</primary></indexterm>
-
-<para>Synopsis:
+<para>These parameters determine the frame layout.
</para>
-<screen>\begin{lrbox}{\<replaceable>cmd</replaceable>}
- <replaceable>text </replaceable>
-\end{lrbox}
-</screen>
-<para>This is the environment form of <link linkend="_005csbox"><literal>\sbox</literal></link>.
+<variablelist><anchor id="fbox-framebox-fboxrule"/><varlistentry><term><indexterm role="fn"><primary>\fboxrule</primary></indexterm><literal>\fboxrule</literal>
+</term><listitem><indexterm role="fn"><primary>frame, line width</primary></indexterm>
+<indexterm role="fn"><primary>frame rule width</primary></indexterm>
+<indexterm role="cp"><primary>\fboxrule</primary></indexterm>
+<para>The thickness of the lines around the enclosed box. The default is
+0.2pt. Change it with a command such as
+<literal>\setlength{\fboxrule}{0.8pt}</literal> (see <link linkend="_005csetlength">\setlength</link>).
</para>
-<para>The <replaceable>text</replaceable> inside the environment is saved in the box <literal>\<replaceable>cmd</replaceable></literal>,
-which must have been declared with <literal>\newsavebox</literal>.
+<anchor id="fbox-framebox-fboxsep"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\fboxsep</primary></indexterm><literal>\fboxsep</literal>
+</term><listitem><indexterm role="fn"><primary>frame, separation from contents</primary></indexterm>
+<indexterm role="cp"><primary>\fboxsep</primary></indexterm>
+<para>The distance from the frame to the enclosed box. The default is 3pt.
+Change it with a command such as <literal>\setlength{\fboxsep}{0pt}</literal>
+(see <link linkend="_005csetlength">\setlength</link>). Setting it to 0pt is useful sometimes:
+this will put a frame around the picture with no white border.
</para>
-
-</sect1>
-<sect1 label="20.4" id="_005cmakebox">
-<title><literal>\makebox</literal></title>
-
-<indexterm role="fn"><primary>\makebox</primary></indexterm>
-
-<para>Synopsis:
+<screen>{\setlength{\fboxsep}{0pt}
+ \framebox{%
+ \includegraphics[width=0.5\textwidth]{prudence.jpg}}}
+</screen>
+<para>The extra curly braces keep the effect of the <literal>\setlength</literal> local.
+</para>
+</listitem></varlistentry></variablelist>
+<para>As with <literal>\mbox</literal> and <literal>\makebox</literal>, &latex; will not break lines
+in <replaceable>text</replaceable>. But this example has &latex; break lines to make a
+paragraph, and then frame the result.
</para>
-<screen>\makebox[<replaceable>width</replaceable>][<replaceable>position</replaceable>]{<replaceable>text</replaceable>}
+<screen>\framebox{%
+ \begin{minipage}{0.6\linewidth}
+ My dear, here we must run as fast as we can, just to stay in place.
+ And if you wish to go anywhere you must run twice as fast as that.
+ \end{minipage}}
</screen>
-<para>The <literal>\makebox</literal> command creates a box just wide enough to contain
-the <replaceable>text</replaceable> specified. The width of the box can be overridden by the
-optional <replaceable>width</replaceable> argument. The position of the text within the box
-is determined by the optional <replaceable>position</replaceable> argument, which may take
-the following values:
+<para>See <link linkend="Colored-boxes">Colored boxes</link> for colors other than black and white.
</para>
-<variablelist><varlistentry><term><literal>c</literal>
-</term><listitem><para>Centered (default).
-</para></listitem></varlistentry><varlistentry><term><literal>l</literal>
-</term><listitem><para>Flush left.
-</para></listitem></varlistentry><varlistentry><term><literal>r</literal>
-</term><listitem><para>Flush right.
-</para></listitem></varlistentry><varlistentry><term><literal>s</literal>
-</term><listitem><para>Stretch (justify) across entire <replaceable>width</replaceable>; <replaceable>text</replaceable> must contain
-stretchable space for this to work.
-</para></listitem></varlistentry></variablelist>
-<para><literal>\makebox</literal> is also used within the <literal>picture</literal> environment
-see <link linkend="_005cmakebox-_0028picture_0029">\makebox (picture)</link>.
+<para>The <literal>picture</literal> environment has a version of this command where the
+units depend on <literal>picture</literal>&#8217;s <literal>\unitlength</literal> (see <link linkend="_005cframebox-_0028picture_0029">\framebox
+(picture)</link>).
</para>
</sect1>
-<sect1 label="20.5" id="_005cparbox">
+<sect1 label="20.3" id="_005cparbox">
<title><literal>\parbox</literal></title>
<indexterm role="fn"><primary>\parbox</primary></indexterm>
+<indexterm role="cp"><primary>paragraph mode</primary></indexterm>
+<indexterm role="cp"><primary>paragraph, in a box</primary></indexterm>
-<para>Synopsis:
+<para>Synopses, one of:
</para>
-<screen>\parbox[<replaceable>position</replaceable>][<replaceable>height</replaceable>][<replaceable>inner-pos</replaceable>]{<replaceable>width</replaceable>}{<replaceable>text</replaceable>}
+<screen>\parbox{<replaceable>width</replaceable>}{<replaceable>contents</replaceable>}
+\parbox[<replaceable>position</replaceable>]{<replaceable>width</replaceable>}{<replaceable>contents</replaceable>}
+\parbox[<replaceable>position</replaceable>][<replaceable>height</replaceable>]{<replaceable>width</replaceable>}{<replaceable>contents</replaceable>}
+\parbox[<replaceable>position</replaceable>][<replaceable>height</replaceable>][<replaceable>inner-pos</replaceable>]{<replaceable>width</replaceable>}{<replaceable>contents</replaceable>}
</screen>
-<indexterm role="cp"><primary>paragraph mode</primary></indexterm>
-<para>The <literal>\parbox</literal> command produces a box whose contents are created
-in <firstterm>paragraph mode</firstterm>. It should be used to make a box small
-pieces of text, with nothing fancy inside. In particular, you
-shouldn&#8217;t use any paragraph-making environments inside a
-<literal>\parbox</literal> argument. For larger pieces of text, including ones
-containing a paragraph-making environment, you should use a
-<literal>minipage</literal> environment (see <link linkend="minipage">minipage</link>).
-</para>
-<para><literal>\parbox</literal> has two mandatory arguments:
-</para>
-<variablelist><varlistentry><term><replaceable>width</replaceable>
-</term><listitem><para>the width of the parbox;
-</para></listitem></varlistentry><varlistentry><term><replaceable>text</replaceable>
-</term><listitem><para>the text that goes inside the parbox.
-</para></listitem></varlistentry></variablelist>
-<para>By default &latex; will position vertically a parbox so its center
-lines up with the center of the surrounding text line. When the
-optional <replaceable>position</replaceable> argument is present and equal either to &#8216;<literal>t</literal>&#8217;
-or &#8216;<literal>b</literal>&#8217;, this allows you respectively to align either the top or
-bottom line in the parbox with the baseline of the surrounding text. You
-may also specify &#8216;<literal>m</literal>&#8217; for <replaceable>position</replaceable> to get the default
-behaviour.
-</para>
-<para>The optional <replaceable>height</replaceable> argument overrides the natural height of the box.
+<para>Produce a box of text that is <replaceable>width</replaceable> wide. Use this command to make
+a box of small pieces of text, of a single paragraph. This command is
+fragile (see <link linkend="_005cprotect">\protect</link>).
</para>
-<para>The <replaceable>inner-pos</replaceable> argument controls the placement of the text inside
-the box, as follows; if it is not specified, <replaceable>position</replaceable> is used.
+<screen>\begin{picture}(0,0)
+ ...
+ \put(1,2){\parbox{1.75in}{\raggedright Because the graph is a line on
+ this semilog paper, the relationship is
+ exponential.}}
+\end{picture}
+</screen>
+<para>The <replaceable>contents</replaceable> are processed in a text mode (see <link linkend="Modes">Modes</link>) so
+&latex; will break lines to make a paragraph. But it won&#8217;t make
+multiple paragraphs; for that, use a <literal>minipage</literal> environment
+(see <link linkend="minipage">minipage</link>).
+</para>
+<para>The options for <literal>\parbox</literal> (except for <replaceable>contents</replaceable>) are the same
+as those for <literal>minipage</literal>. For convenience a summary of the options
+is here but see&#160;<link linkend="minipage">minipage</link> for a complete description.
+</para>
+<para>There are two required arguments. The <replaceable>width</replaceable> is a rigid length
+(see <link linkend="Lengths">Lengths</link>). It sets the width of the box into which &latex;
+typesets <replaceable>contents</replaceable>. The <replaceable>contents</replaceable> is the text that is placed
+in that box. It should not have any paragraph-making components.
+</para>
+<para>There are three optional arguments, <replaceable>position</replaceable>, <replaceable>height</replaceable>, and
+<replaceable>inner-pos</replaceable>. The <replaceable>position</replaceable> gives the vertical alignment of the
+<literal>parbox</literal> with respect to the surrounding material. The possible
+values are <literal>c</literal> or <literal>m</literal> to make the vertical center of the
+<literal>parbox</literal> lines up with the center of the adjacent line (this is the
+default), or <literal>t</literal> to match the top line of the <literal>parbox</literal> with
+the baseline of the surrounding material, or <literal>b</literal> to match the
+bottom line.
+</para>
+<para>The optional argument <replaceable>height</replaceable> overrides the natural height of the
+box.
+</para>
+<para>The optional argument <replaceable>inner-pos</replaceable> controls the placement of
+<replaceable>content</replaceable> inside the <literal>parbox</literal>. Its default is the value of
+<replaceable>position</replaceable>. Its possible values are: <literal>t</literal> to put the
+<replaceable>content</replaceable> at the top of the box, <literal>c</literal> to put it in the vertical
+center, <literal>b</literal> to put it at the bottom of the box, and <literal>s</literal> to
+stretch it out vertically (for this, the text must contain vertically
+stretchable space).
</para>
-<variablelist><varlistentry><term><literal>t</literal>
-</term><listitem><para>text is placed at the top of the box.
-</para></listitem></varlistentry><varlistentry><term><literal>c</literal>
-</term><listitem><para>text is centered in the box.
-</para></listitem></varlistentry><varlistentry><term><literal>b</literal>
-</term><listitem><para>text is placed at the bottom of the box.
-</para></listitem></varlistentry><varlistentry><term><literal>s</literal>
-</term><listitem><para>stretch vertically; the text must contain vertically stretchable space
-for this to work.
-</para></listitem></varlistentry></variablelist>
-
</sect1>
-<sect1 label="20.6" id="_005craisebox">
+<sect1 label="20.4" id="_005craisebox">
<title><literal>\raisebox</literal></title>
<indexterm role="fn"><primary>\raisebox</primary></indexterm>
-<para>Synopsis:
+<para>Synopsis, one of:
+</para>
+<screen>\raisebox{<replaceable>distance</replaceable>}{<replaceable>text</replaceable>}
+\raisebox{<replaceable>distance</replaceable>}[<replaceable>height</replaceable>]{<replaceable>text</replaceable>}
+\raisebox{<replaceable>distance</replaceable>}[<replaceable>height</replaceable>][<replaceable>depth</replaceable>]{<replaceable>text</replaceable>}
+</screen>
+<para>Raise or lower <replaceable>text</replaceable>. This command is fragile (see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>This example makes a command for the restriction of a function by
+lowering the vertical bar symbol.
</para>
-<screen>\raisebox{<replaceable>distance</replaceable>}[<replaceable>height</replaceable>][<replaceable>depth</replaceable>]{<replaceable>text</replaceable>}
+<!-- credit: egreg https://tex.stackexchange.com/a/278631/121234 -->
+<screen>\newcommand\restricted[1]{\raisebox{-.5ex}{$|$}_{#1}}
+$f\restricted{A}$
</screen>
-<para>The <literal>\raisebox</literal> command raises or lowers <replaceable>text</replaceable>. The first
-mandatory argument specifies how high <replaceable>text</replaceable> is to be raised (or
-lowered if it is a negative amount). <replaceable>text</replaceable> itself is processed
-in LR mode.
+<para>The first mandatory argument <replaceable>distance</replaceable> specifies how far to raise
+the second mandatory argument <replaceable>text</replaceable>. This is a rigid length
+(see <link linkend="Lengths">Lengths</link>). If it is negative then it lowers <replaceable>text</replaceable>. The
+<replaceable>text</replaceable> is processed in LR mode so it cannot contain line breaks
+(see <link linkend="Modes">Modes</link>).
</para>
<para>The optional arguments <replaceable>height</replaceable> and <replaceable>depth</replaceable> are dimensions. If
-they are specified, &latex; treats <replaceable>text</replaceable> as extending a certain
-distance above the baseline (<replaceable>height</replaceable>) or below (<replaceable>depth</replaceable>),
-ignoring its natural height and depth.
+they are specified, they override the natural height and depth of the
+box &latex; gets by typesetting <replaceable>text</replaceable>.
+</para>
+<anchor id="raisebox-depth"/><anchor id="raisebox-height"/><anchor id="raisebox-width"/><anchor id="raisebox-totalheight"/><para>In the arguments <replaceable>distance</replaceable>, <replaceable>height</replaceable>, and <replaceable>depth</replaceable> you can
+use the following lengths that refer to the dimension of the box that
+&latex; gets on typesetting <replaceable>text</replaceable>: <literal>\depth</literal>, <literal>\height</literal>,
+<literal>\width</literal>, <literal>\totalheight</literal> (this is the box&#8217;s height plus its
+depth).
+</para>
+<para>This will align two graphics on their top (see <link linkend="Graphics">Graphics</link>).
+</para>
+<!-- credit: FAQ https://texfaq.org/FAQ-topgraph -->
+<screen>\usepackage{graphicx} \usepackage{calc} % in preamble
+ ...
+\begin{center}
+ \raisebox{1ex-\height}{%
+ \includegraphics[width=0.4\linewidth]{lion.png}}
+ \qquad
+ \raisebox{1ex-\height}{%
+ \includegraphics[width=0.4\linewidth]{meta.png}}
+\end{center}
+</screen>
+<para>The first <literal>\height</literal> is the height of <filename>lion.png</filename> while the
+second is the height of <filename>meta.png</filename>.
</para>
</sect1>
-<sect1 label="20.7" id="_005csavebox">
-<title><literal>\savebox</literal></title>
+<sect1 label="20.5" id="_005csbox-_0026-_005csavebox">
+<title><literal>\sbox</literal> &amp; <literal>\savebox</literal></title>
+<indexterm role="fn"><primary>\sbox</primary></indexterm>
<indexterm role="fn"><primary>\savebox</primary></indexterm>
+<indexterm role="cp"><primary>box, save</primary></indexterm>
-<para>Synopsis:
+<para>Synopsis, one of:
+</para>
+<screen>\sbox{<replaceable>box-cmd</replaceable>}{<replaceable>text</replaceable>}
+\savebox{<replaceable>box-cmd</replaceable>}{<replaceable>text</replaceable>}
+\savebox{<replaceable>box-cmd</replaceable>}[<replaceable>width</replaceable>]{<replaceable>text</replaceable>}
+\savebox{<replaceable>box-cmd</replaceable>}[<replaceable>width</replaceable>][<replaceable>pos</replaceable>]{<replaceable>text</replaceable>}
+</screen>
+<para>Typeset <replaceable>text</replaceable> just as with <literal>\makebox</literal> (see <link linkend="_005cmbox-_0026-_005cmakebox">\mbox &amp;
+\makebox</link>) except that &latex; does not output it but instead saves it
+in a storage bin named <replaceable>box-cmd</replaceable>. The bin name <replaceable>box-cmd</replaceable> begins
+with a backslash, <literal>\</literal>. You must have previously allocated the bin
+<replaceable>box-cmd</replaceable> with <literal>\newsavebox</literal> (see <link linkend="_005cnewsavebox">\newsavebox</link>).The
+<literal>\sbox</literal> command is robust while <literal>\savebox</literal> is fragile
+(see <link linkend="_005cprotect">\protect</link>).
</para>
-<screen>\savebox{<replaceable>\boxcmd</replaceable>}[<replaceable>width</replaceable>][<replaceable>pos</replaceable>]{<replaceable>text</replaceable>}
+<para>This creates and uses a bin.
+</para>
+<screen>\newsavebox{\fullname}
+\sbox{\fullname}{John Jacob Jingleheimer Schmidt}
+ ...
+\usebox{\fullname}! His name is my name, too!
+Whenever we go out, the people always shout!
+There goes \\usebox{\fullname}! Ya da da da da da da.
+</screen>
+<para>One advantage of using and reusing a bin over a <literal>\newcommand</literal> is
+efficiency, that &latex; need not repeatedly retypeset the contents.
+See the example below.
+</para>
+<para>The first two command invocations,
+<literal>\sbox{<replaceable>box-cmd</replaceable>}{<replaceable>text</replaceable>}</literal> and
+<literal>\savebox{<replaceable>box-cmd</replaceable>}{<replaceable>text</replaceable>}</literal>, are roughly equivalent.
+As to the third and fourth, the optional arguments allow you to specify
+the box width as <replaceable>width</replaceable>, and the position of the text inside that
+box as <replaceable>position</replaceable>. See <link linkend="_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</link> for the full
+description.
+</para>
+<para>In the <literal>\sbox</literal> and <literal>\savebox</literal> commands the <replaceable>text</replaceable> is
+typeset in LR mode so it does not have line breaks (see <link linkend="Modes">Modes</link>). If
+you use these then &latex; doesn&#8217;t give you an error but it ignores
+what you want: if you enter <literal>\sbox{\newbin}{test \\ test}</literal> and
+<literal>\usebox{\newbin}</literal> then you get &#8216;<literal>testtest</literal>&#8217;, while if you
+enter <literal>\sbox{\newbin}{test \par test}</literal> and
+<literal>\usebox{\newbin}</literal> then you get &#8216;<literal>test test</literal>&#8217;, but no error or
+warning. To fix this use a <literal>\parbox</literal> or <literal>minipage</literal> as here.
+</para>
+<!-- credit: egreg https://tex.stackexchange.com/a/41668/121234 -->
+<screen>\savebox{\abin}{%
+ \begin{minipage}{\linewidth}
+ \begin{enumerate}
+ \item First item
+ \item Second item
+ \end{enumerate}
+ \end{minipage}}
+ ...
+\usebox{\abin}
+</screen>
+<para>As an example of the efficiency of reusing a bin&#8217;s contents, this puts
+the same picture on each page of the document by putting it in the
+header. &latex; only typesets it once.
+</para>
+<screen>\usepackage{graphicx} % all this in the preamble
+\newsavebox{\sealbin}
+\savebox{\sealbin}{%
+ \setlength{\unitlength}{1in}%
+ \begin{picture}(0,0)%
+ \put(1.5,-2.5){%
+ \begin{tabular}{c}
+ \includegraphics[height=2in]{companylogo.png} \\
+ Office of the President
+ \end{tabular}}
+ \end{picture}%
+}
+\markright{\usebox{\sealbin}}
+\pagestyle{headings}
</screen>
-<para>This command typeset <replaceable>text</replaceable> in a box just as with <literal>\makebox</literal>
-(see <link linkend="_005cmakebox">\makebox</link>), except that instead of printing the resulting box,
-it saves it in the box labeled <replaceable>\boxcmd</replaceable>, which must have been
-declared with <literal>\newsavebox</literal> (see <link linkend="_005cnewsavebox">\newsavebox</link>).
+<para>The <literal>picture</literal> environment is good for fine-tuning the placement.
+</para>
+<para>If the bin has not already been defined then you get something like
+&#8216;<literal>Undefined control sequence. &lt;argument&gt; \nobin</literal>&#8217;.
</para>
</sect1>
-<sect1 label="20.8" id="_005csbox">
-<title><literal>\sbox{<replaceable>\boxcmd</replaceable>}{<replaceable>text</replaceable>}</literal></title>
+<sect1 label="20.6" id="lrbox">
+<title><literal>lrbox</literal></title>
-<indexterm role="fn"><primary>\sbox</primary></indexterm>
+<indexterm role="fn"><primary>lrbox</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\sbox{<replaceable>\boxcmd</replaceable>}{<replaceable>text</replaceable>}
+<screen>\begin{lrbox}{<replaceable>box-cmd</replaceable>}
+ <replaceable>text</replaceable>
+\end{lrbox}
+</screen>
+<para>The <replaceable>text</replaceable> inside the environment is saved in the bin
+<literal><replaceable>box-cmd</replaceable></literal>. The <replaceable>box-cmd</replaceable> must begin with a
+backslash. You must create this bin in advance with <literal>\newsavebox</literal>
+(see <link linkend="_005cnewsavebox">\newsavebox</link>). This is the environment form of the <literal>\sbox</literal>
+and <literal>\savebox</literal> commands, and is equivalent to them. See <link linkend="_005csbox-_0026-_005csavebox">\sbox &amp;
+\savebox</link> for the full information.
+</para>
+<para>In this example the environment is convenient for entering the
+<literal>tabular</literal>.
+</para>
+<screen>\newsavebox{\jhbin}
+\begin{lrbox}{\jhbin}
+ \begin{tabular}{c}
+ \includegraphics[height=1in]{jh.png} \\
+ Jim Hef{}feron
+ \end{tabular}
+\end{lrbox}
+ ...
+\usebox{\jhbin}
</screen>
-<para><literal>\sbox</literal> types <replaceable>text</replaceable> in a box just as with <literal>\mbox</literal>
-(see <link linkend="_005cmbox">\mbox</link>) except that instead of the resulting box being
-included in the normal output, it is saved in the box labeled
-<replaceable>\boxcmd</replaceable>. <replaceable>\boxcmd</replaceable> must have been previously declared with
-<literal>\newsavebox</literal> (see <link linkend="_005cnewsavebox">\newsavebox</link>).
-</para>
</sect1>
-<sect1 label="20.9" id="_005cusebox">
-<title><literal>\usebox{<replaceable>\boxcmd</replaceable>}</literal></title>
+<sect1 label="20.7" id="_005cusebox">
+<title><literal>\usebox</literal></title>
<indexterm role="fn"><primary>\usebox</primary></indexterm>
+<indexterm role="cp"><primary>box, use saved box</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\usebox{<replaceable>\boxcmd</replaceable>}
+<screen>\usebox{<replaceable>box-cmd</replaceable>}
</screen>
-<para><literal>\usebox</literal> produces the box most recently saved in the bin
-<replaceable>\boxcmd</replaceable> by a <literal>\savebox</literal> command (see <link linkend="_005csavebox">\savebox</link>).
+<para>Produce the box most recently saved in the bin <replaceable>box-cmd</replaceable> by the
+commands <literal>\sbox</literal> or <literal>\savebox</literal>, or the <literal>lrbox</literal>
+environment. See <link linkend="_005csbox-_0026-_005csavebox">\sbox &amp; \savebox</link> for more information and examples.
+(Note that <replaceable>box-cmd</replaceable> starts with a backslash.) This command is
+robust (see <link linkend="_005cprotect">\protect</link>).
</para>
</sect1>
@@ -9480,7 +13019,7 @@ significantly extends the capabilities described here, including adding
<sect1 label="21.1" id="Color-package-options">
-<title>Color package options</title>
+<title><literal>color</literal> package options</title>
<indexterm role="cp"><primary>color package options</primary></indexterm>
<indexterm role="cp"><primary>options, color package</primary></indexterm>
@@ -9544,25 +13083,25 @@ of red, green, and blue produces white. Subtractive mixes pigments,
such as with inks, so that combining full intensity of cyan, magenta,
and yellow makes black.
</para>
-<variablelist><varlistentry><term><literal>cmyk</literal>
+<variablelist><anchor id="color-models-cmyk"/><varlistentry><term><literal>cmyk</literal>
</term><listitem><para>A comma-separated list with four real numbers between 0 and 1,
inclusive. The first number is the intensity of cyan, the second is
magenta, and the others are yellow and black. A number value of 0 means
minimal intensity, while a 1 is for full intensity. This model is often
used in color printing. It is a subtractive model.
</para>
-</listitem></varlistentry><varlistentry><term><literal>gray</literal>
+<anchor id="color-models-gray"/></listitem></varlistentry><varlistentry><term><literal>gray</literal>
</term><listitem><para>A single real number between 0 and 1, inclusive. The colors are shades
of grey. The number 0 produces black while 1 gives white.
</para>
-</listitem></varlistentry><varlistentry><term><literal>rgb</literal>
+<anchor id="color-models-rgb"/></listitem></varlistentry><varlistentry><term><literal>rgb</literal>
</term><listitem><para>A comma-separated list with three real numbers between 0 and 1,
inclusive. The first number is the intensity of the red component, the
second is green, and the third the blue. A number value of 0 means that
none of that component is added in, while a 1 means full intensity.
This is an additive model.
</para>
-</listitem></varlistentry><varlistentry><term><literal>RGB</literal>
+<anchor id="color-models-RGB"/></listitem></varlistentry><varlistentry><term><literal>RGB</literal>
</term><listitem><para>(<filename>pdftex</filename>, <filename>xetex</filename>, <filename>luatex</filename> drivers) A comma-separated
list with three integers between 0 and 255, inclusive. This model is a
convenience for using <literal>rgb</literal> since outside of &latex; colors are
@@ -9570,7 +13109,7 @@ often described in a red-green-blue model using numbers in this range.
The values entered here are converted to the <literal>rgb</literal> model by
dividing by 255.
</para>
-</listitem></varlistentry><varlistentry><term><literal>named</literal>
+<anchor id="color-models-named"/></listitem></varlistentry><varlistentry><term><literal>named</literal>
</term><listitem><para>Colors are accessed by name, such as &#8216;<literal>PrussianBlue</literal>&#8217;. The list of
names depends on the driver, but all support the names &#8216;<literal>black</literal>&#8217;,
&#8216;<literal>blue</literal>&#8217;, &#8216;<literal>cyan</literal>&#8217;, &#8216;<literal>green</literal>&#8217;, &#8216;<literal>magenta</literal>&#8217;, &#8216;<literal>red</literal>&#8217;,
@@ -9600,9 +13139,12 @@ names depends on the driver, but all support the names &#8216;<literal>black</li
</para>
<screen>\definecolor{<replaceable>name</replaceable>}{<replaceable>model</replaceable>}{<replaceable>specification</replaceable>}
</screen>
-<para>Give the name <replaceable>name</replaceable> to the color. For example, after
-<literal>\definecolor{silver}{rgb}{0.75,0.75,0.74}</literal> you can use that
-color name with <literal>Hi ho, \textcolor{silver}{Silver}!</literal>.
+<para>Give the name <replaceable>name</replaceable> to the color. For example, after this
+</para>
+<screen>\definecolor{silver}{rgb}{0.75,0.75,0.74}
+</screen>
+<para>you can use that color name with <literal>Hi ho,
+\textcolor{silver}{Silver}!</literal>.
</para>
<para>This example gives the color a more abstract name, so it could change and
not be misleading.
@@ -9633,7 +13175,8 @@ or style, rather than in the document body.
</screen>
<para>The affected text gets the color. This line
</para>
-<screen>\textcolor{magenta}{My name is Ozymandias, king of kings:} Look on my works, ye Mighty, and despair!
+<screen>\textcolor{magenta}{My name is Ozymandias, king of kings:}
+Look on my works, ye Mighty, and despair!
</screen>
<para>causes the first half to be in magenta while the rest is in black. You
can use a color declared with <literal>\definecolor</literal> in exactly the same
@@ -9658,9 +13201,12 @@ including the vertical and horizontal lines.
\end{tabular}
\end{center}
</screen>
-<para>You can use color in equations. A document might have
-<literal>\definecolor{highlightcolor}{RGB}{225,15,0}</literal> in the
-preamble, and then contain this equation.
+<para>You can use color in equations. A document might have this definition
+in the preamble
+</para>
+<screen>\definecolor{highlightcolor}{RGB}{225,15,0}
+</screen>
+<para>and then contain this equation.
</para>
<screen>\begin{equation}
\int_a^b \textcolor{highlightcolor}{f'(x)}\,dx=f(b)-f(a)
@@ -9670,7 +13216,8 @@ preamble, and then contain this equation.
but sometimes you want a one-off. Those are the second forms in the
synopses.
</para>
-<screen>Colors of \textcolor[rgb]{0.33,0.14,0.47}{Purple} and {\color[rgb]{0.72,0.60,0.37} Gold} for the team
+<screen>Colors of \textcolor[rgb]{0.33,0.14,0.47}{Purple} and
+{\color[rgb]{0.72,0.60,0.37} Gold} for the team.
</screen>
<para>The format of <replaceable>color specification </replaceable> depends on the color model
(see <link linkend="Color-models">Color models</link>). For instance, while <literal>rgb</literal> takes three
@@ -9698,12 +13245,12 @@ numbers, <literal>gray</literal> takes only one.
<para>Synopses:
</para>
<screen>\colorbox{<replaceable>name</replaceable>}{...}
-\colorbox[<replaceable>model name</replaceable>]{<replaceable>box background color specification</replaceable>}{...}
+\colorbox[<replaceable>model name</replaceable>]{<replaceable>box background color</replaceable>}{...}
</screen>
<para>or
</para>
<screen>\fcolorbox{<replaceable>frame color</replaceable>}{<replaceable>box background color</replaceable>}{...}
-\fcolorbox[<replaceable>model name</replaceable>]{<replaceable>frame color specification</replaceable>}{<replaceable>box background color specification</replaceable>}{...}
+\fcolorbox[<replaceable>model name</replaceable>]{<replaceable>frame color</replaceable>}{<replaceable>box background color</replaceable>}{...}
</screen>
<para>Make a box with the stated background color. The <literal>\fcolorbox</literal>
command puts a frame around the box. For instance this
@@ -9718,7 +13265,7 @@ puts white text on a blue background.
<screen>\colorbox{blue}{\textcolor{white}{Welcome to the machine.}}
</screen>
<para>The <literal>\fcolorbox</literal> commands use the same parameters as <literal>\fbox</literal>
-(see <link linkend="_005cfbox-and-_005cframebox">\fbox and \framebox</link>), <literal>\fboxrule</literal> and <literal>\fboxsep</literal>, to
+(see <link linkend="_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</link>), <literal>\fboxrule</literal> and <literal>\fboxsep</literal>, to
set the thickness of the rule and the boundary between the box interior
and the surrounding rule. &latex;&#8217;s defaults are <literal>0.4pt</literal> and
<literal>3pt</literal>, respectively.
@@ -9801,12 +13348,12 @@ external to &latex;, that generate a graphic that you include using the
commands of this chapter. Two that use a programming language are
Asymptote and MetaPost. One that uses a graphical interface is Xfig.
Full description of these systems is outside the scope of this document;
-see their documentation.
+see their documentation on CTAN.
</para>
<sect1 label="22.1" id="Graphics-package-options">
-<title>Graphics package options</title>
+<title><literal>graphics</literal> package options</title>
<indexterm role="cp"><primary>graphics package options</primary></indexterm>
<indexterm role="cp"><primary>options, graphics package</primary></indexterm>
@@ -9880,7 +13427,7 @@ option has &latex; to read the size from the latter.
</sect1>
<sect1 label="22.2" id="Graphics-package-configuration">
-<title>Graphics package configuration</title>
+<title><literal>graphics</literal> package configuration</title>
<indexterm role="cp"><primary>graphics</primary></indexterm>
<indexterm role="cp"><primary>graphics package</primary></indexterm>
@@ -9895,7 +13442,7 @@ option has &latex; to read the size from the latter.
the graphic.
</para>
<para>The behavior of file system search code is necessarily platform
-dependent. In this document we cover Linux, Macintosh, and Windows, as
+dependent. In this document we cover GNU/Linux, Macintosh, and Windows, as
those systems are typically configured. For other situations consult
the documentation in <filename>grfguide.pdf</filename>, or the &latex; source, or your
&tex; distribution&#8217;s documentation.
@@ -9959,9 +13506,9 @@ these means that the document is not portable. (You could preserve
portability by adjusting your &tex; system settings configuration file
parameter <literal>TEXINPUTS</literal>; see the documentation of your system.)
</para>
-<para>You can use <literal>\graphicspath</literal> in the preamble or in the document
-body. You can use it more than once. For debugging, show its value
-with <literal>\makeatletter\typeout{\Ginput@path}\makeatother</literal>.
+<para>You can use <literal>\graphicspath</literal> anywhere in the document. You can use
+it more than once. Show its value with
+<literal>\makeatletter\typeout{\Ginput@path}\makeatother</literal>.
</para>
<para>The directories are taken with respect to the base file. That is,
suppose that you are working on a document based on <filename>book/book.tex</filename>
@@ -10001,17 +13548,18 @@ and extensions then it reports &#8216;<literal>! LaTeX Error: File `<filename>li
not found</literal>&#8217;. Note that you must include the periods at the start of the
extensions.
</para>
-<para>Because Linux and Macintosh filenames are case sensitive, the list of
+<para>Because GNU/Linux and Macintosh filenames are case sensitive, the list of
file extensions is case sensitive on those platforms. The Windows
platform is not case sensitive.
</para>
<para>You are not required to include <literal>\DeclareGraphicsExtensions</literal> in
your document; the printer driver has a sensible default. For example,
-the most recent <filename>pdftex.def</filename> has the extension list
-&#8216;<literal><literal>.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2</literal></literal>&#8217;.
+the most recent <filename>pdftex.def</filename> has this extension list.
</para>
-<para>You can use this command in the preamble or in the document body. You
-can use it more than once. For debugging, show its value with
+<screen>.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2
+</screen>
+<para>You can use this command anywhere in the document. You can use it more
+than once. Show its value with
<literal>\makeatletter\typeout{\Gin@extensions}\makeatother</literal>.
</para>
@@ -10152,8 +13700,8 @@ centered and at its nominal size. You can also give a path to the file,
as with <literal>\includegraphics{graphics/plot.pdf}</literal>. To specify a list
of locations to search for the file, see <link linkend="_005cgraphicspath">\graphicspath</link>.
</para>
-<para>If your filename includes spaces then put it in double quotes, as with
-<literal>\includegraphics{&quot;sister picture.jpg&quot;}</literal>.
+<para>If your filename includes spaces then put it in double quotes. An example
+is <literal>\includegraphics{&quot;sister picture.jpg&quot;}</literal>.
</para>
<para>The <literal>\includegraphics{<replaceable>filename</replaceable>}</literal> command decides on the
type of graphic by splitting <replaceable>filename</replaceable> on the first dot. You can
@@ -10188,14 +13736,13 @@ caption.
...
\begin{center}
\includegraphics{pix/nix.png}
- \captionof{figure}{The spirit of the night} \label{pix:nix} % if you want a caption
+ \captionof{figure}{The spirit of the night} \label{pix:nix} % optional
\end{center}
</screen>
<para>This example puts a box with a graphic side by side with one having
text, with the two vertically centered.
</para>
-<screen>\newcommand*{\vcenteredhbox}[1]{\begingroup
- \setbox0=\hbox{#1}\parbox{\wd0}{\box0}\endgroup}
+<screen>\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
...
\begin{center}
\vcenteredhbox{\includegraphics[width=0.4\textwidth]{plot}}
@@ -10243,7 +13790,7 @@ go beyond this box, or sit inside this box, but when &latex; makes up a
page it puts together boxes and this is the box allocated for the
graphic.
</para>
-<variablelist><varlistentry><term><literal>width</literal>
+<variablelist><anchor id="includegraphics-width"/><varlistentry><term><literal>width</literal>
</term><listitem><para>The graphic will be shown so its bounding box is this width. An example
is <literal>\includegraphics[width=1in]{plot}</literal>. You can use the standard
&tex; dimensions (see <link linkend="Units-of-length">Units of length</link>) and also convenient is
@@ -10254,37 +13801,38 @@ the width of the text with
<literal>\includegraphics[width=\linewidth-1.0cm]{hefferon.jpg}</literal>.
</para>
</listitem></varlistentry><varlistentry><term><literal>height</literal>
-</term><listitem><para>The graphic will be shown so its bounding box is this height. You can
+</term><listitem><anchor id="includegraphics-height"/><para>The graphic will be shown so its bounding box is this height. You can
use the standard &tex; dimensions (see <link linkend="Units-of-length">Units of length</link>), and also
convenient are <literal>\pageheight</literal> and <literal>\textheight</literal> (see <link linkend="Page-layout-parameters">Page
-layout parameters</link>). For instance,
+layout parameters</link>). For instance, the command
<literal>\includegraphics[height=0.25\textheight]{godel}</literal> will make the
-graphic be a quarter of the height of the text area.
+graphic a quarter of the height of the text area.
</para>
</listitem></varlistentry><varlistentry><term><literal>totalheight</literal>
-</term><listitem><para>The graphic will be shown so its bounding box has this height plus
+</term><listitem><anchor id="includegraphics-totalheght"/><para>The graphic will be shown so its bounding box has this height plus
depth. This differs from the height if the graphic was rotated. For
instance, if it has been rotated by -90 then it will have zero height
but a large depth.
</para>
</listitem></varlistentry><varlistentry><term><literal>keepaspectratio</literal>
-</term><listitem><para>If set to <literal>true</literal>, or just specified as with
-<literal>\includegraphics[...,keepaspectratio,...]{...}</literal> and you give as
-options both <literal>width</literal> and <literal>height</literal> (or <literal>totalheight</literal>),
-then &latex; will make the graphic is as large as possible without
-distortion. That is, &latex; will ensure that neither is the graphic
-wider than <literal>width</literal> nor taller than <literal>height</literal> (or
+</term><listitem><anchor id="includegraphics-keepaspectratio"/><para>If set to <literal>true</literal>, or just specified as here
+</para>
+<screen><literal>\includegraphics[...,keepaspectratio,...]{...}</literal>
+</screen>
+<para>and you give as options both <literal>width</literal> and <literal>height</literal> (or
+<literal>totalheight</literal>), then &latex; will make the graphic is as large as
+possible without distortion. That is, &latex; will ensure that neither
+is the graphic wider than <literal>width</literal> nor taller than <literal>height</literal> (or
<literal>totalheight</literal>).
</para>
</listitem></varlistentry><varlistentry><term><literal>scale</literal>
-</term><listitem><para>Factor by which to scale the graphic. Specifying
-<literal>\includegraphics[scale=2.0]{...}</literal> makes the graphic twice its
-nominal size. This number may be any value; a number between 1
-and&#160;0 will shrink the graphic and a negative number will reflect
-it.
+</term><listitem><para>Factor by which to scale the graphic. To make a graphic twice its
+nominal size, enter <literal>\includegraphics[scale=2.0]{...}</literal>. This
+number may be any value; a number between 1 and&#160;0 will shrink the
+graphic and a negative number will reflect it.
</para>
</listitem></varlistentry><varlistentry><term><literal>angle</literal>
-</term><listitem><para>Rotate the picture. The angle is taken in degrees and counterclockwise.
+</term><listitem><para>Rotate the graphic. The angle is taken in degrees and counterclockwise.
The graphic is rotated about its <literal>origin</literal>; see that option. For a
complete description of how rotated material is typeset,
see <link linkend="_005crotatebox">\rotatebox</link>.
@@ -10293,9 +13841,9 @@ see <link linkend="_005crotatebox">\rotatebox</link>.
</term><listitem><para>The point of the graphic about which the rotation happens. Possible
values are any string containing one or two of: <literal>l</literal> for left,
<literal>r</literal> for right, <literal>b</literal> for bottom, <literal>c</literal> for center, <literal>t</literal>
-for top, and <literal>B</literal> for baseline. Thus,
+for top, and <literal>B</literal> for baseline. Thus, entering the command
<literal>\includegraphics[angle=180,origin=c]{moon}</literal> will turn the
-picture upside down from the center, while
+picture upside down about that picture&#8217;s center, while the command
<literal>\includegraphics[angle=180,origin=lB]{LeBateau}</literal> will turn its
picture upside down about its left baseline. (The character <literal>c</literal>
gives the horizontal center in <literal>bc</literal> or <literal>tc</literal>, but gives the
@@ -10306,7 +13854,7 @@ vertical center in <literal>lc</literal> or <literal>rc</literal>.) The default
</listitem></varlistentry></variablelist>
<para>These are lesser-used options.
</para>
-<variablelist><varlistentry><term><literal>viewport</literal>
+<variablelist><anchor id="includegraphics-viewport"/><varlistentry><term><literal>viewport</literal>
</term><listitem><para>Pick out a subregion of the graphic to show. Takes four arguments,
separated by spaces and given in &tex; dimensions, as with
<literal>\includegraphics[.., viewport=0in 0in 1in 0.618in]{...}</literal>. The
@@ -10314,7 +13862,7 @@ dimensions default to big points,&#160;<literal>bp</literal>. They are taken
relative to the origin specified by the bounding box. See also the
<literal>trim</literal> option.
</para>
-</listitem></varlistentry><varlistentry><term><literal>trim</literal>
+<anchor id="includegraphics-trim"/></listitem></varlistentry><varlistentry><term><literal>trim</literal>
</term><listitem><para>Gives parts of the graphic to not show. Takes four arguments, separated
by spaces, that are given in &tex; dimensions, as with
<literal>\includegraphics[.., trim= 0in 0.1in 0.2in 0.3in, ...]{...}</literal>.
@@ -10323,18 +13871,20 @@ will crop the picture by 0&#160;inches on the left, 0.1&#160;inches on
the bottom, 0.2&#160;inches on the right, and 0.3&#160;inches on the
top. See also the <literal>viewport</literal> option.
</para>
-</listitem></varlistentry><varlistentry><term><literal>clip</literal>
-</term><listitem><para>If set to <literal>true</literal>, or just specified as with
-<literal>\includegraphics[...,clip,...]{...}</literal>, then the graphic is
-cropped to the bounding box. You can get this effect by instead using
-the starred form of the command, as
+<anchor id="includegraphics-clip"/></listitem></varlistentry><varlistentry><term><literal>clip</literal>
+</term><listitem><para>If set to <literal>true</literal>, or just specified as here
+</para>
+<screen>\includegraphics[...,clip,...]{...}
+</screen>
+<para>then the graphic is cropped to the bounding box. This is the same as
+using the starred form of the command,
<literal>\includegraphics*[...]{...}</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><literal>page</literal>
+<anchor id="includegraphics-page"/></listitem></varlistentry><varlistentry><term><literal>page</literal>
</term><listitem><para>Give the page number of a multi-page PDF file. The default is
<literal>page=1</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><literal>pagebox</literal>
+<anchor id="includegraphics-pagebox"/></listitem></varlistentry><varlistentry><term><literal>pagebox</literal>
</term><listitem><para>Specifies which bounding box to use for PDF files from among
<literal>mediabox</literal>, <literal>cropbox</literal>, <literal>bleedbox</literal>, <literal>trimbox</literal>, or
<literal>artbox</literal>. PDF files do not have the BoundingBox that PostScript
@@ -10348,22 +13898,25 @@ content. The driver will set the image size based on CropBox if
present, otherwise it will not use one of the others, with a
driver-defined order of preference. MediaBox is always present.
</para>
-</listitem></varlistentry><varlistentry><term><literal>interpolate</literal>
+<anchor id="includegraphics-interpolate"/></listitem></varlistentry><varlistentry><term><literal>interpolate</literal>
</term><listitem><para>Enable or disable interpolation of raster images by the viewer. Can be
-set with <literal>interpolate=true</literal> or just specified as with
-<literal>\includegraphics[...,interpolate,...]{...}</literal>.
+set with <literal>interpolate=true</literal> or just specified as here.
</para>
-</listitem></varlistentry><varlistentry><term><literal>quiet</literal>
+<screen>\includegraphics[...,interpolate,...]{...}
+</screen>
+<anchor id="includegraphics-quiet"/></listitem></varlistentry><varlistentry><term><literal>quiet</literal>
</term><listitem><para>Do not write information to the log. You can set it with
<literal>quiet=true</literal> or just specified it with
<literal>\includegraphics[...,quite,...]{...}</literal>,
</para>
-</listitem></varlistentry><varlistentry><term><literal>draft</literal>
-</term><listitem><para>If you set it with <literal>draft=true</literal> or just specified it with
-<literal>\includegraphics[...,draft,...]{...}</literal>, then the graphic will not
-appear in the document, possibly saving color printer ink. Instead,
-&latex; will put an empty box of the correct size with the filename
-printed in it.
+<anchor id="includegraphics-draft"/></listitem></varlistentry><varlistentry><term><literal>draft</literal>
+</term><listitem><para>If you set it with <literal>draft=true</literal> or just specify it with
+</para>
+<screen>\includegraphics[...,draft,...]{...}
+</screen>
+<para>then the graphic will not appear in the document, possibly saving color
+printer ink. Instead, &latex; will put an empty box of the correct
+size with the filename printed in it.
</para>
</listitem></varlistentry></variablelist>
<para>These options address the bounding box for Encapsulated PostScript
@@ -10376,7 +13929,7 @@ For example, if an <filename>.eps</filename> file has the line <literal>%%Boundi
20 40 80</literal> then its natural size is 30/72&#160;inch wide by
60/72&#160;inch tall.
</para>
-<variablelist><varlistentry><term><literal>bb</literal>
+<variablelist><anchor id="includegraphics-bb"/><varlistentry><term><literal>bb</literal>
</term><listitem><para>Specify the bounding box of the displayed region. The argument is four
dimensions separated by spaces, as with <literal>\includegraphics[.., bb=
0in 0in 1in 0.618in]{...}</literal>. Usually <literal>\includegraphics</literal> reads the
@@ -10384,23 +13937,27 @@ BoundingBox numbers from the EPS file automatically, so this option is
only useful if the bounding box is missing from that file or if you want
to change it.
</para>
-</listitem></varlistentry><varlistentry><term><literal>bbllx, bblly, bburx, bbury</literal>
+<anchor id="includegraphics-bbllx"/><anchor id="includegraphics-bblly"/><anchor id="includegraphics-bburx"/><anchor id="includegraphics-bbury"/></listitem></varlistentry><varlistentry><term><literal>bbllx, bblly, bburx, bbury</literal>
</term><listitem><para>Set the bounding box. These four are obsolete, but are retained for
compatibility with old packages.
</para>
-</listitem></varlistentry><varlistentry><term><literal>natwidth, natheight</literal>
+<anchor id="includegraphics-natwidth"/><anchor id="includegraphics-natheight"/></listitem></varlistentry><varlistentry><term><literal>natwidth, natheight</literal>
</term><listitem><para>An alternative for <literal>bb</literal>. Setting
-<literal>\includegraphics[...,natwidth=1in,natheight=0.618in,...]{...}</literal>
-is the same as setting <literal>bb=0 0 1in 0.618in</literal>.
+</para>
+<screen>\includegraphics[...,natwidth=1in,natheight=0.618in,...]{...}
+</screen>
+<para>is the same as setting <literal>bb=0 0 1in 0.618in</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><literal>hiresbb</literal>
+<anchor id="includegraphics-hiresbb"/></listitem></varlistentry><varlistentry><term><literal>hiresbb</literal>
</term><listitem><para>If set to <literal>true</literal>, or just specified as with
-<literal>\includegraphics[...,hiresbb,...]{...}</literal>, then &latex; will look
-for <literal>%%HiResBoundingBox</literal> lines instead of <literal>%%BoundingBox</literal>
-lines. (The <literal>BoundingBox</literal> lines use only natural numbers while the
-<literal>HiResBoundingBox</literal> lines use decimals; both use units equivalent to
-&tex;&#8217;s big points, 1/72&#160;inch.) To override a prior setting of
-<literal>true</literal>, you can set it to <literal>false</literal>.
+</para>
+<screen>\includegraphics[...,hiresbb,...]{...}
+</screen>
+<para>then &latex; will look for <literal>%%HiResBoundingBox</literal> lines instead of
+<literal>%%BoundingBox</literal> lines. (The <literal>BoundingBox</literal> lines use only
+natural numbers while the <literal>HiResBoundingBox</literal> lines use decimals;
+both use units equivalent to &tex;&#8217;s big points, 1/72&#160;inch.) To
+override a prior setting of <literal>true</literal>, you can set it to <literal>false</literal>.
</para>
</listitem></varlistentry></variablelist>
<para>These following options allow a user to override &latex;&#8217;s method of
@@ -10409,21 +13966,22 @@ is that <literal>\includegraphics[type=png,ext=.xxx,read=.xxx]{lion}</literal>
will read the file <filename>lion.xxx</filename> as though it were
<filename>lion.png</filename>. For more on these, see <link linkend="_005cDeclareGraphicsRule">\DeclareGraphicsRule</link>.
</para>
-<variablelist><varlistentry><term><literal>type</literal>
+<variablelist><anchor id="includegraphics-type"/><varlistentry><term><literal>type</literal>
</term><listitem><para>Specify the graphics type.
</para>
-</listitem></varlistentry><varlistentry><term><literal>ext</literal>
+<anchor id="includegraphics-ext"/></listitem></varlistentry><varlistentry><term><literal>ext</literal>
</term><listitem><para>Specify the graphics extension.
Only use this in conjunction with the option <literal>type</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><literal>read</literal>
+<anchor id="includegraphics-read"/></listitem></varlistentry><varlistentry><term><literal>read</literal>
</term><listitem><para>Specify the file extension of the read file.
Only use this in conjunction with the option <literal>type</literal>.
</para>
-</listitem></varlistentry><varlistentry><term><literal>command</literal>
-</term><listitem><para>Specify a command to be applied to this file.
-Only use this in conjunction with the option <literal>type</literal>.
-<!-- write18 and restricted execution. -->
+<anchor id="includegraphics-command"/></listitem></varlistentry><varlistentry><term><literal>command</literal>
+</term><listitem><para>Specify a command to be applied to this file. Only use this in
+conjunction with the option <literal>type</literal>. See <link linkend="Command-line-options">Command line options</link>
+for a discussion of enabling the <literal>\write18</literal> functionality to run
+external commands.
</para>
</listitem></varlistentry></variablelist>
@@ -10445,7 +14003,8 @@ Only use this in conjunction with the option <literal>type</literal>.
<screen>\rotatebox{<replaceable>angle</replaceable>}{<replaceable>material</replaceable>}
\rotatebox[<replaceable>key-value list</replaceable>]{<replaceable>angle</replaceable>}{<replaceable>material</replaceable>}
</screen>
-<para>Put <replaceable>material</replaceable> in a box and rotate it <replaceable>angle</replaceable> degrees counterclockwise.
+<para>Put <replaceable>material</replaceable> in a box and rotate it <replaceable>angle</replaceable> degrees
+counterclockwise.
</para>
<para>This example rotates the table column heads forty five degrees.
</para>
@@ -10477,15 +14036,18 @@ except for the <literal>x</literal> and <literal>y</literal> options (see <link
</para>
<variablelist><varlistentry><term><literal>origin</literal>
</term><listitem><para>The point of the <replaceable>material</replaceable>&#8217;s box about which the rotation happens.
-Possible values are any string containing one or two of: <literal>l</literal> for
+Possible value is any string containing one or two of: <literal>l</literal> for
left, <literal>r</literal> for right, <literal>b</literal> for bottom, <literal>c</literal> for center,
-<literal>t</literal> for top, and <literal>B</literal> for baseline. Thus,
-<literal>\includegraphics[angle=180,origin=c]{moon}</literal> will turn the
-picture upside down from the center, while
-<literal>\includegraphics[angle=180,origin=lB]{LeBateau}</literal> will turn its
-picture upside down about its left baseline. (The character <literal>c</literal>
-gives the horizontal center in <literal>bc</literal> or <literal>tc</literal> but gives the
-vertical center in <literal>lc</literal> or <literal>rc</literal>.) The default is <literal>lB</literal>.
+<literal>t</literal> for top, and <literal>B</literal> for baseline. Thus, the first line here
+</para>
+<screen>\includegraphics[angle=180,origin=c]{moon}
+\includegraphics[angle=180,origin=lB]{LeBateau}
+</screen>
+<para>will turn the picture upside down from the center while the second will
+turn its picture upside down about its left baseline. (The character
+<literal>c</literal> gives the horizontal center in <literal>bc</literal> or <literal>tc</literal> but gives
+the vertical center in <literal>lc</literal> or <literal>rc</literal>.) The default is
+<literal>lB</literal>.
</para>
</listitem></varlistentry><varlistentry><term><literal>x, y</literal>
</term><listitem><para>Specify an arbitrary point of rotation with
@@ -10529,10 +14091,12 @@ first text and doubles the size of the second.
<para>If you do not specify the optional <replaceable>vertical factor</replaceable> then it
defaults to the same value as the <replaceable>horizontal factor</replaceable>.
</para>
-<para>You can use this command to resize a graphic, as with
-<literal>\scalebox{0.5}{\includegraphics{lion}}</literal>. If you use the
-<filename>graphicx</filename> package then you can accomplish the same thing with
-optional arguments to <literal>\includegraphics</literal>
+<para>You can use this command to resize a graphic, as here.
+</para>
+<screen>\scalebox{0.5}{\includegraphics{lion}}
+</screen>
+<para>If you use the <filename>graphicx</filename> package then you can accomplish the same
+thing with optional arguments to <literal>\includegraphics</literal>
(see <link linkend="_005cincludegraphics">\includegraphics</link>).
</para>
<para>The <literal>\reflectbox</literal> command abbreviates
@@ -10601,8 +14165,8 @@ special meaning do not correspond to simple characters you can type.
<indexterm role="cp"><primary>characters, reserved</primary></indexterm>
<indexterm role="cp"><primary>special characters</primary></indexterm>
<indexterm role="cp"><primary>characters, special</primary></indexterm>
-<para>&latex; sets aside the following characters for special purposes (for
-example, the percent sign&#160;<literal>%</literal> is for comments) so they are
+<para>&latex; sets aside the following characters for special purposes. For
+example, the percent sign&#160;<literal>%</literal> is for comments. They are
called <firstterm>reserved characters</firstterm> or <firstterm>special characters</firstterm>.
</para>
<screen># $ % &amp; { } _ ~ ^ \
@@ -10617,7 +14181,7 @@ called <firstterm>reserved characters</firstterm> or <firstterm>special characte
<para>If you want a reserved character to be printed as itself, in the text
body font, for all but the final three characters in that list simply
put a backslash&#160;<literal>\</literal> in front of the character. Thus,
-<literal>\$1.23</literal> will produce&#160;<literal>$1.23</literal> in your output.
+typing <literal>\$1.23</literal> will produce&#160;<literal>$1.23</literal> in your output.
</para>
<indexterm role="fn"><primary>\~</primary></indexterm>
<indexterm role="fn"><primary>\^</primary></indexterm>
@@ -10625,28 +14189,26 @@ put a backslash&#160;<literal>\</literal> in front of the character. Thus,
<para>As to the last three characters, to get a tilde in the text body font
use <literal>\~{}</literal> (omitting the curly braces would result in the next
character receiving a tilde accent). Similarly, to get a get a text
-body font circumflex use <literal>\^{}</literal>. A text body font backslash
-results from <literal>\textbackslash{}</literal>.
+body font circumflex use <literal>\^{}</literal>. To get a backslash in the font
+of the text body, enter <literal>\textbackslash{}</literal>.
</para>
<para>To produce the reserved characters in a typewriter font use
-<literal>\verb!!</literal>, as below.
+<literal>\verb!!</literal> as below (the double backslash&#160;<literal>\\</literal> is only
+there to split the lines).
</para>
<screen>\begin{center}
\# \$ \% \&amp; \{ \} \_ \~{} \^{} \textbackslash \\
\verb!# $ % &amp; { } _ ~ ^ \!
\end{center}
</screen>
-<para>In that example the double backslash&#160;<literal>\\</literal> is only there to
-split the lines.
-</para>
</sect1>
<sect1 label="23.2" id="Upper-and-lower-case">
<title>Upper and lower case</title>
-<indexterm role="cp"><primary>Upper case</primary></indexterm>
-<indexterm role="cp"><primary>Lower case</primary></indexterm>
-<indexterm role="cp"><primary>characters, case</primary></indexterm>
+<indexterm role="cp"><primary>uppercase</primary></indexterm>
+<indexterm role="cp"><primary>lowercase</primary></indexterm>
+<indexterm role="cp"><primary>characters, case of</primary></indexterm>
<para>Synopsis:
</para>
@@ -10726,22 +14288,23 @@ example could also be written as <literal>\symbol{'40}</literal> or
<indexterm role="cp"><primary>symbols, text</primary></indexterm>
<indexterm role="fn"><primary>textcomp package</primary></indexterm>
-<para>&latex; provides commands to generate a number of non-letter symbols
-in running text. Some of these, especially the more obscure ones, are
-not available in OT1; you may need to load the <literal>textcomp</literal> package.
+<para>&latex; provides commands to generate a number of non-letter symbols in
+running text. Some of these, especially the more obscure ones, are not
+available in OT1. Unless you are using Xe&latex; or Lua&latex; then
+you may need to load the <literal>textcomp</literal> package.
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\copyright</primary></indexterm><literal>\copyright</literal>
</term><term><indexterm role="fn"><primary>\textcopyright</primary></indexterm><literal>\textcopyright</literal>
</term><listitem><indexterm role="cp"><primary>copyright symbol</primary></indexterm>
-<para>The copyright symbol, &#169;.
+<para>&#169; The copyright symbol.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dag</primary></indexterm><literal>\dag</literal>
</term><listitem><indexterm role="cp"><primary>dagger, in text</primary></indexterm>
-<para>The dagger symbol (in text).
+<para>&#x2020; The dagger symbol (in text).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\ddag</primary></indexterm><literal>\ddag</literal>
</term><listitem><indexterm role="cp"><primary>double dagger, in text</primary></indexterm>
-<para>The double dagger symbol (in text).
+<para>&#x2021; The double dagger symbol (in text).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\LaTeX</primary></indexterm><literal>\LaTeX</literal>
</term><listitem><indexterm role="cp"><primary>&latex; logo</primary></indexterm>
@@ -10765,50 +14328,50 @@ not available in OT1; you may need to load the <literal>textcomp</literal> packa
<indexterm role="cp"><primary>single angle quotation marks</primary></indexterm>
<indexterm role="cp"><primary>French quotation marks</primary></indexterm>
<indexterm role="cp"><primary>quotation marks, French</primary></indexterm>
-<para>Double and single angle quotation marks, commonly used in French:
-&#171;, &#187;, &#8249;, &#8250;.
+<para>&#171;, &#187;, &#8249;, &#8250;
+Double and single angle quotation marks, commonly used in French.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\ldots</primary></indexterm><literal>\ldots</literal>
</term><term><indexterm role="fn"><primary>\dots</primary></indexterm><literal>\dots</literal>
</term><term><indexterm role="fn"><primary>\textellipsis</primary></indexterm><literal>\textellipsis</literal>
</term><listitem><indexterm role="cp"><primary>ellipsis</primary></indexterm>
-<para>An ellipsis (three dots at the baseline): &#8216;&#8230;&#8217;. <literal>\ldots</literal>
+<para>&#8230; An ellipsis (three dots at the baseline): <literal>\ldots</literal>
and <literal>\dots</literal> also work in math mode.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\lq</primary></indexterm><literal>\lq</literal>
</term><listitem><indexterm role="cp"><primary>left quote</primary></indexterm>
<indexterm role="cp"><primary>opening quote</primary></indexterm>
-<para>Left (opening) quote: &#8216;.
+<para>&#8216; Left (opening) quote.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\P</primary></indexterm><literal>\P</literal>
</term><term><indexterm role="fn"><primary>\textparagraph</primary></indexterm><literal>\textparagraph</literal>
</term><listitem><indexterm role="cp"><primary>paragraph symbol</primary></indexterm>
<indexterm role="cp"><primary>pilcrow</primary></indexterm>
-<para>Paragraph sign (pilcrow): &#x00B6;.
+<para>&#x00B6; Paragraph sign (pilcrow).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\pounds</primary></indexterm><literal>\pounds</literal>
</term><term><indexterm role="fn"><primary>\textsterling</primary></indexterm><literal>\textsterling</literal>
</term><listitem><indexterm role="cp"><primary>pounds symbol</primary></indexterm>
<indexterm role="cp"><primary>sterling symbol</primary></indexterm>
-<para>English pounds sterling: &#163;.
+<para>&#163; English pounds sterling.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\quotedblbase (&#8222;)</primary></indexterm><literal>\quotedblbase (&#8222;)</literal>
</term><term><indexterm role="fn"><primary>\quotesinglbase (&#8218;)</primary></indexterm><literal>\quotesinglbase (&#8218;)</literal>
</term><listitem><indexterm role="cp"><primary>double low-9 quotation mark</primary></indexterm>
<indexterm role="cp"><primary>single low-9 quotation mark</primary></indexterm>
<indexterm role="cp"><primary>low-9 quotation marks, single and double</primary></indexterm>
-<para>Double and single quotation marks on the baseline:
-&#8222; and &#8218;.
+<para>&#8222; and &#8218;
+Double and single quotation marks on the baseline.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\rq</primary></indexterm><literal>\rq</literal>
</term><listitem><indexterm role="cp"><primary>right quote</primary></indexterm>
<indexterm role="cp"><primary>closing quote</primary></indexterm>
-<para>Right (closing) quote: &#8217;.
+<para>&#8217; Right (closing) quote.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\S</primary></indexterm><literal>\S</literal>
-</term><listitem><para>\itemx \textsection
-<indexterm role="cp"><primary>section symbol</primary></indexterm>
-Section sign: &#x00A7;.
+</term><term><indexterm role="fn"><primary>\textsection</primary></indexterm><literal>\textsection</literal>
+</term><listitem><indexterm role="cp"><primary>section symbol</primary></indexterm>
+<para>&#x00A7; Section sign.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\TeX</primary></indexterm><literal>\TeX</literal>
</term><listitem><indexterm role="cp"><primary>&tex; logo</primary></indexterm>
@@ -10818,55 +14381,55 @@ Section sign: &#x00A7;.
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textasciicircum</primary></indexterm><literal>\textasciicircum</literal>
</term><listitem><indexterm role="cp"><primary>circumflex, ASCII, in text</primary></indexterm>
<indexterm role="cp"><primary>ASCII circumflex, in text</primary></indexterm>
-<para>ASCII circumflex: ^.
+<para>^ ASCII circumflex.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textasciitilde</primary></indexterm><literal>\textasciitilde</literal>
</term><listitem><indexterm role="cp"><primary>tilde, ASCII, in text</primary></indexterm>
<indexterm role="cp"><primary>ASCII tilde, in text</primary></indexterm>
-<para>ASCII tilde: ~.
+<para>~ ASCII tilde.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textasteriskcentered</primary></indexterm><literal>\textasteriskcentered</literal>
</term><listitem><indexterm role="cp"><primary>asterisk, centered, in text</primary></indexterm>
<indexterm role="cp"><primary>centered asterisk, in text</primary></indexterm>
-<para>Centered asterisk: *.
+<para>* Centered asterisk.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textbackslash</primary></indexterm><literal>\textbackslash</literal>
</term><listitem><indexterm role="cp"><primary>backslash, in text</primary></indexterm>
-<para>Backslash: \.
+<para>\ Backslash.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textbar</primary></indexterm><literal>\textbar</literal>
</term><listitem><indexterm role="cp"><primary>vertical bar, in text</primary></indexterm>
<indexterm role="cp"><primary>bar, vertical, in text</primary></indexterm>
-<para>Vertical bar: |.
+<para>| Vertical bar.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textbardbl</primary></indexterm><literal>\textbardbl</literal>
</term><listitem><indexterm role="cp"><primary>vertical bar, double, in text</primary></indexterm>
<indexterm role="cp"><primary>bar, double vertical, in text</primary></indexterm>
<indexterm role="cp"><primary>double vertical bar, in text</primary></indexterm>
-<para>Double vertical bar.
+<para>&#x23F8; Double vertical bar.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textbigcircle</primary></indexterm><literal>\textbigcircle</literal>
</term><listitem><indexterm role="cp"><primary>big circle symbols, in text</primary></indexterm>
<indexterm role="cp"><primary>circle symbol, big, in text</primary></indexterm>
-<para>Big circle symbol.
+<para>&#x25EF; Big circle symbol.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textbraceleft</primary></indexterm><literal>\textbraceleft</literal>
</term><listitem><indexterm role="cp"><primary>left brace, in text</primary></indexterm>
<indexterm role="cp"><primary>brace, left, in text</primary></indexterm>
-<para>Left brace: {.
+<para>{ Left brace.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textbraceright</primary></indexterm><literal>\textbraceright</literal>
</term><listitem><indexterm role="cp"><primary>right brace, in text</primary></indexterm>
<indexterm role="cp"><primary>brace, right, in text</primary></indexterm>
-<para>Right brace: }.
+<para>} Right brace.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textbullet</primary></indexterm><literal>\textbullet</literal>
</term><listitem><indexterm role="cp"><primary>bullet, in text</primary></indexterm>
-<para>Bullet: &#8226;.
+<para>&#8226; Bullet.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textcircled{<replaceable>letter</replaceable>}</primary></indexterm><literal>\textcircled{<replaceable>letter</replaceable>}</literal>
</term><listitem><indexterm role="cp"><primary>circled letter, in text</primary></indexterm>
-<para><replaceable>letter</replaceable> in a circle, as in &#174;.
+<para>&#x24B6; Circle around <replaceable>letter</replaceable>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textcompwordmark</primary></indexterm><literal>\textcompwordmark</literal>
</term><term><indexterm role="fn"><primary>\textcapitalcompwordmark</primary></indexterm><literal>\textcapitalcompwordmark</literal>
@@ -10874,53 +14437,62 @@ Section sign: &#x00A7;.
</term><listitem><indexterm role="cp"><primary>composite word mark, in text</primary></indexterm>
<indexterm role="cp"><primary>cap height</primary></indexterm>
<indexterm role="cp"><primary>ascender height</primary></indexterm>
-<para>Composite word mark (invisible). The <literal>\textcapital...</literal> form
-has the cap height of the font, while the <literal>\textascender...</literal> form
-has the ascender height.
+<para>Used to separate letters that would normally ligature. For example,
+<literal>f\textcompwordmark i</literal> produces &#8216;<literal>fi</literal>&#8217; without a ligature. This
+is most useful in non-English languages. The
+<literal>\textcapitalcompwordmark</literal> form has the cap height of the font
+while the <literal>\textascendercompwordmark</literal> form has the ascender height.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textdagger</primary></indexterm><literal>\textdagger</literal>
</term><listitem><indexterm role="cp"><primary>dagger, in text</primary></indexterm>
-<para>Dagger: <inlineequation><mathphrase>\dag</mathphrase></inlineequation>.
+<para>&#x2020; Dagger.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textdaggerdbl</primary></indexterm><literal>\textdaggerdbl</literal>
</term><listitem><indexterm role="cp"><primary>dagger, double, in text</primary></indexterm>
<indexterm role="cp"><primary>double dagger, in text</primary></indexterm>
-<para>Double dagger: <inlineequation><mathphrase>\ddag</mathphrase></inlineequation>.
+<para>&#x2021; Double dagger.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textdollar (or <literal>\$</literal>)</primary></indexterm><literal>\textdollar (or <literal>\$</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>dollar sign</primary></indexterm>
<indexterm role="cp"><primary>currency, dollar</primary></indexterm>
-<para>Dollar sign: $.
+<para>$ Dollar sign.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textemdash (or <literal>---</literal>)</primary></indexterm><literal>\textemdash (or <literal>---</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>em-dash</primary></indexterm>
-<para>Em-dash: &#8212; (for punctuation).
+<para>&#8212; Em-dash (used for punctuation, as in
+<literal>The playoffs --- if you are fortunate enough to make the playoffs ---
+is more like a sprint.</literal>).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textendash (or <literal>--</literal>)</primary></indexterm><literal>\textendash (or <literal>--</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>e-dash</primary></indexterm>
-<para>En-dash: &#8211; (for ranges).
+<para>&#8211; En-dash (used for ranges, as in <literal>See pages 12--14</literal>).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\texteuro</primary></indexterm><literal>\texteuro</literal>
</term><listitem><indexterm role="cp"><primary>euro symbol</primary></indexterm>
<indexterm role="cp"><primary>currency, euro</primary></indexterm>
-<para>The Euro symbol: &#8364;.
+<indexterm role="cp"><primary>package, <literal>eurosym</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>eurosym</literal> package</primary></indexterm>
+
+<para>The Euro symbol: &#8364;. For an alternative glyph design, try the
+<filename>eurosym</filename> package; also, most fonts nowadays come with their own
+Euro symbol (Unicode U+20AC).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textexclamdown (or <literal>!`</literal>)</primary></indexterm><literal>\textexclamdown (or <literal>!`</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>exclamation point, upside-down</primary></indexterm>
-<para>Upside down exclamation point: &#161;.
+<para>&#161; Upside down exclamation point.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textgreater</primary></indexterm><literal>\textgreater</literal>
</term><listitem><indexterm role="cp"><primary>greater than symbol, in text</primary></indexterm>
-<para>Greater than: &gt;.
+<para>&gt; Greater than symbol.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textless</primary></indexterm><literal>\textless</literal>
</term><listitem><indexterm role="cp"><primary>less than symbol, in text</primary></indexterm>
-<para>Less than: &lt;.
+<para>&lt; Less than symbol.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textleftarrow</primary></indexterm><literal>\textleftarrow</literal>
</term><listitem><indexterm role="cp"><primary>arrow, left, in text</primary></indexterm>
<indexterm role="cp"><primary>left arrow, in text</primary></indexterm>
-<para>Left arrow.
+<para>&#x2190; Left arrow.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textordfeminine</primary></indexterm><literal>\textordfeminine</literal>
</term><term><indexterm role="fn"><primary>\textordmasculine</primary></indexterm><literal>\textordmasculine</literal>
@@ -10928,42 +14500,42 @@ has the ascender height.
<indexterm role="cp"><primary>masculine ordinal symbol</primary></indexterm>
<indexterm role="cp"><primary>ordinals, feminine and masculine</primary></indexterm>
<indexterm role="cp"><primary>Spanish ordinals, feminine and masculine</primary></indexterm>
-<para>Feminine and masculine ordinal symbols: &#170;, &#186;.
+<para>&#170;, &#186; Feminine and masculine ordinal symbols.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textperiodcentered</primary></indexterm><literal>\textperiodcentered</literal>
</term><listitem><indexterm role="cp"><primary>period, centered, in text</primary></indexterm>
<indexterm role="cp"><primary>centered period, in text</primary></indexterm>
-<para>Centered period: &#x00B7;.
+<para>&#x00B7; Centered period.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquestiondown (or <literal>?`</literal>)</primary></indexterm><literal>\textquestiondown (or <literal>?`</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>question mark, upside-down</primary></indexterm>
-<para>Upside down question mark: &#191;.
+<para>&#191; Upside down question mark.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquotedblleft (or <literal>``</literal>)</primary></indexterm><literal>\textquotedblleft (or <literal>``</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>left quote, double</primary></indexterm>
<indexterm role="cp"><primary>double left quote</primary></indexterm>
-<para>Double left quote: &#8220;.
+<para>&#8220; Double left quote.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquotedblright (or <literal>''</literal>)</primary></indexterm><literal>\textquotedblright (or <literal>''</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>right quote, double</primary></indexterm>
<indexterm role="cp"><primary>double right quote</primary></indexterm>
-<para>Double right quote: &#8221;.
+<para>&#8221; Double right quote.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquoteleft (or <literal>`</literal>)</primary></indexterm><literal>\textquoteleft (or <literal>`</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>left quote, single</primary></indexterm>
<indexterm role="cp"><primary>single left quote</primary></indexterm>
-<para>Single left quote: &#8216;.
+<para>&#8216; Single left quote.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquoteright (or <literal>'</literal>)</primary></indexterm><literal>\textquoteright (or <literal>'</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>right quote, single</primary></indexterm>
<indexterm role="cp"><primary>single right quote</primary></indexterm>
-<para>Single right quote: &#8217;.
+<para>&#8217; Single right quote.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquotesingle</primary></indexterm><literal>\textquotesingle</literal>
</term><listitem><indexterm role="cp"><primary>quote, single straight</primary></indexterm>
<indexterm role="cp"><primary>straight single quote</primary></indexterm>
<indexterm role="cp"><primary>single quote, straight</primary></indexterm>
-<para>Straight single quote. (From TS1 encoding.)
+<para>&#x0027; Straight single quote. (From TS1 encoding.)
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquotestraightbase</primary></indexterm><literal>\textquotestraightbase</literal>
</term><term><indexterm role="fn"><primary>\textquotestraightdblbase</primary></indexterm><literal>\textquotestraightdblbase</literal>
@@ -10971,38 +14543,40 @@ has the ascender height.
<indexterm role="cp"><primary>straight quote, base</primary></indexterm>
<indexterm role="cp"><primary>double quote, straight base</primary></indexterm>
<indexterm role="cp"><primary>straight double quote, base</primary></indexterm>
+<!-- Unicode doesn't have these https://en.wikipedia.org/wiki/Quotation_mark -->
<para>Single and double straight quotes on the baseline.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textregistered</primary></indexterm><literal>\textregistered</literal>
</term><listitem><indexterm role="cp"><primary>registered symbol</primary></indexterm>
-<para>Registered symbol: &#174;.
+<para>&#174; Registered symbol.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textrightarrow</primary></indexterm><literal>\textrightarrow</literal>
</term><listitem><indexterm role="cp"><primary>arrow, right, in text</primary></indexterm>
<indexterm role="cp"><primary>right arrow, in text</primary></indexterm>
-<para>Right arrow.
+<para>&#x2192; Right arrow.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textthreequartersemdash</primary></indexterm><literal>\textthreequartersemdash</literal>
</term><listitem><indexterm role="cp"><primary>three-quarters em-dash</primary></indexterm>
<indexterm role="cp"><primary>em-dash, three-quarters</primary></indexterm>
-<para>&#8220;Three-quarters&#8221; em-dash, between en-dash and em-dash.
+<para>&#xFE58; &#8220;Three-quarters&#8221; em-dash, between en-dash and em-dash.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\texttrademark</primary></indexterm><literal>\texttrademark</literal>
</term><listitem><indexterm role="cp"><primary>trademark symbol</primary></indexterm>
-<para>Trademark symbol: &#x2122;.
+<para>&#x2122; Trademark symbol.
</para>
+<!-- ?? Diff from \textthreequartersemdash? In Unicode? -->
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\texttwelveudash</primary></indexterm><literal>\texttwelveudash</literal>
</term><listitem><indexterm role="cp"><primary>two-thirds em-dash</primary></indexterm>
<indexterm role="cp"><primary>em-dash, two-thirds</primary></indexterm>
-<para>&#8220;Two-thirds&#8221; em-dash, between en-dash and em-dash.
+<para>&#xFE58; &#8220;Two-thirds&#8221; em-dash, between en-dash and em-dash.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textunderscore</primary></indexterm><literal>\textunderscore</literal>
</term><listitem><indexterm role="cp"><primary>underscore, in text</primary></indexterm>
-<para>Underscore: _.
+<para>_ Underscore.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textvisiblespace</primary></indexterm><literal>\textvisiblespace</literal>
</term><listitem><indexterm role="cp"><primary>visible space symbol, in text</primary></indexterm>
-<para>Visible space symbol.
+<para>&#x2423; Visible space symbol.
</para>
</listitem></varlistentry></variablelist>
@@ -11017,14 +14591,31 @@ has the ascender height.
<indexterm role="cp"><primary>package, <literal>babel</literal></primary></indexterm>
<indexterm role="cp"><primary><literal>babel</literal> package</primary></indexterm>
+<indexterm role="cp"><primary>package, <literal>polyglossia</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>polyglossia</literal> package</primary></indexterm>
+
<indexterm role="cp"><primary>multilingual support</primary></indexterm>
-<para>&latex; has wide support for many of the world&#8217;s scripts and
-languages, through the <literal>babel</literal> package and related support. This
-section does not attempt to cover all that support. It merely lists
-the core &latex; commands for creating accented characters.
-</para>
-<para>The <literal>\capital...</literal> commands produce alternative forms for use with
-capital letters. These are not available with OT1.
+<para>&latex; has wide support for many of the world&#8217;s scripts and languages,
+through the <literal>babel</literal> package and related support if you are using
+pdf&latex;, or <filename>polyglossia</filename> if you are using Xe&latex; or
+Lua&latex;. This section does not cover that support. It only lists
+the core &latex; commands for creating accented characters. The
+<literal>\capital...</literal> commands shown here produce alternative forms for use
+with capital letters. These are not available with OT1.
+</para>
+<para>Below, to make them easier to find, the accents are all illustrated with
+lowercase &#8216;<literal>o</literal>&#8217;.
+</para>
+<indexterm role="fn"><primary>\i (dotless i)</primary></indexterm>
+<indexterm role="cp"><primary>dotless i</primary></indexterm>
+<para>Note that <literal>\i</literal> produces a dotless i,
+<!-- @dotless{i}, -->
+<indexterm role="fn"><primary>\j (dotless j)</primary></indexterm>
+<indexterm role="cp"><primary>dotless j</primary></indexterm>
+and <literal>\j</literal> produces a dotless j.
+<!-- @dotless{j}. -->
+These are often used in place of their dotted counterparts when they are
+accented.
</para>
<variablelist><varlistentry><term><literal>\&quot;</literal>
</term><term><literal>\capitaldieresis</literal>
@@ -11032,22 +14623,20 @@ capital letters. These are not available with OT1.
<indexterm role="fn"><primary>\capitaldieresis</primary></indexterm>
<indexterm role="cp"><primary>umlaut accent</primary></indexterm>
<indexterm role="cp"><primary>dieresis accent</primary></indexterm>
-<para>Produces an umlaut (dieresis), as in &#246;.
+<para>&#246; Umlaut (dieresis).
</para>
</listitem></varlistentry><varlistentry><term><literal>\'</literal>
</term><term><literal>\capitalacute</literal>
</term><listitem><indexterm role="fn"><primary>\' (acute accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalacute</primary></indexterm>
<indexterm role="cp"><primary>acute accent</primary></indexterm>
-<para>Produces an acute accent, as in &#243;. In the <literal>tabbing</literal>
-environment, pushes current column to the right of the previous column
-(see <link linkend="tabbing">tabbing</link>).
+<para>&#243; Acute accent.
</para>
</listitem></varlistentry><varlistentry><term><literal>\.</literal>
</term><listitem><indexterm role="fn"><primary>\. (dot-over accent)</primary></indexterm>
<indexterm role="cp"><primary>dot accent</primary></indexterm>
<indexterm role="cp"><primary>dot-over accent</primary></indexterm>
-<para>Produces a dot accent over the following, as in &#559;.
+<para>&#559; Dot accent.
</para>
</listitem></varlistentry><varlistentry><term><literal>\=</literal>
</term><term><literal>\capitalmacron</literal>
@@ -11056,7 +14645,7 @@ environment, pushes current column to the right of the previous column
<indexterm role="cp"><primary>macron accent</primary></indexterm>
<indexterm role="cp"><primary>overbar accent</primary></indexterm>
<indexterm role="cp"><primary>bar-over accent</primary></indexterm>
-<para>Produces a macron (overbar) accent over the following, as in &#333;.
+<para>&#333; Macron (overbar) accent.
</para>
</listitem></varlistentry><varlistentry><term><literal>\^</literal>
</term><term><literal>\capitalcircumflex</literal>
@@ -11064,75 +14653,69 @@ environment, pushes current column to the right of the previous column
<indexterm role="fn"><primary>\capitalcircumflex</primary></indexterm>
<indexterm role="cp"><primary>circumflex accent</primary></indexterm>
<indexterm role="cp"><primary>hat accent</primary></indexterm>
-<para>Produces a circumflex (hat) accent over the following, as in &#244;.
+<para>&#244; Circumflex (hat) accent.
</para>
</listitem></varlistentry><varlistentry><term><literal>\`</literal>
</term><term><literal>\capitalgrave</literal>
</term><listitem><indexterm role="fn"><primary>\` (grave accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalgrave</primary></indexterm>
<indexterm role="cp"><primary>grave accent</primary></indexterm>
-<para>Produces a grave accent over the following, as in &#242;. In the
-<literal>tabbing</literal> environment, move following text to the right margin
-(see <link linkend="tabbing">tabbing</link>).
+<para>&#242; Grave accent.
</para>
</listitem></varlistentry><varlistentry><term><literal>\~</literal>
</term><term><literal>\capitaltilde</literal>
</term><listitem><indexterm role="fn"><primary>\~ (tilde accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitaltilde</primary></indexterm>
<indexterm role="cp"><primary>tilde accent</primary></indexterm>
-<para>Produces a tilde accent over the following, as in &#241;.
+<para>&#241; Tilde accent.
</para>
</listitem></varlistentry><varlistentry><term><literal>\b</literal>
</term><listitem><indexterm role="fn"><primary>\b (bar-under accent)</primary></indexterm>
<indexterm role="cp"><primary>bar-under accent</primary></indexterm>
-<para>Produces a bar accent under the following, as in o_. See
-also <literal>\underbar</literal> hereinafter.
+<para>o_ Bar accent underneath.
+</para>
+<indexterm role="fn"><primary>\underbar</primary></indexterm>
+<indexterm role="cp"><primary>underbar</primary></indexterm>
+<para>Related to this, <literal>\underbar{<replaceable>text</replaceable>}</literal> produces a bar under
+<replaceable>text</replaceable>. The argument is always processed in LR mode
+(see <link linkend="Modes">Modes</link>). The bar is always a fixed position under the baseline,
+thus crossing through descenders. See also <literal>\underline</literal> in
+<link linkend="Math-miscellany">Math miscellany</link>.
</para>
</listitem></varlistentry><varlistentry><term><literal>\c</literal>
</term><term><literal>\capitalcedilla</literal>
</term><listitem><indexterm role="fn"><primary>\c (cedilla accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalcedilla</primary></indexterm>
<indexterm role="cp"><primary>cedilla accent</primary></indexterm>
-<para>Produces a cedilla accent under the following, as in &#231;.
+<para>&#231; Cedilla accent underneath.
</para>
</listitem></varlistentry><varlistentry><term><literal>\d</literal>
</term><term><literal>\capitaldotaccent</literal>
</term><listitem><indexterm role="fn"><primary>\d (dot-under accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitaldotaccent</primary></indexterm>
<indexterm role="cp"><primary>dot-under accent</primary></indexterm>
-<para>Produces a dot accent under the following, as in &#7885;.
+<para>&#7885; Dot accent underneath.
</para>
</listitem></varlistentry><varlistentry><term><literal>\H</literal>
</term><term><literal>\capitalhungarumlaut</literal>
</term><listitem><indexterm role="fn"><primary>\H (Hungarian umlaut accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalhungarumlaut</primary></indexterm>
<indexterm role="cp"><primary>hungarian umlaut accent</primary></indexterm>
-<para>Produces a long Hungarian umlaut accent over the following, as in &#337;.
-</para>
-</listitem></varlistentry><varlistentry><term><literal>\i</literal>
-</term><listitem><indexterm role="fn"><primary>\i (dotless i)</primary></indexterm>
-<indexterm role="cp"><primary>dotless i</primary></indexterm>
-<para>Produces a dotless i, as in &#8216;i&#8217;.
-</para>
-</listitem></varlistentry><varlistentry><term><literal>\j</literal>
-</term><listitem><indexterm role="fn"><primary>\j (dotless j)</primary></indexterm>
-<indexterm role="cp"><primary>dotless j</primary></indexterm>
-<para>Produces a dotless j, as in &#8216;j&#8217;.
+<para>&#337; Long Hungarian umlaut accent.
</para>
</listitem></varlistentry><varlistentry><term><literal>\k</literal>
</term><term><literal>\capitalogonek</literal>
</term><listitem><indexterm role="fn"><primary>\k (ogonek)</primary></indexterm>
<indexterm role="fn"><primary>\capitalogonek</primary></indexterm>
<indexterm role="cp"><primary>ogonek</primary></indexterm>
-<para>Produces a letter with ogonek, as in &#8216;&#491;&#8217;. Not available in
-the OT1 encoding.
+<para>&#491; Ogonek. Not available in the OT1 encoding.
</para>
</listitem></varlistentry><varlistentry><term><literal>\r</literal>
</term><term><literal>\capitalring</literal>
</term><listitem><indexterm role="fn"><primary>\r (ring accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalring</primary></indexterm>
<indexterm role="cp"><primary>ring accent</primary></indexterm>
-<para>Produces a ring accent, as in &#8216;o*&#8217;.
+<para>o* Ring accent.
</para>
</listitem></varlistentry><varlistentry><term><literal>\t</literal>
</term><term><literal>\capitaltie</literal>
@@ -11143,24 +14726,15 @@ the OT1 encoding.
<indexterm role="fn"><primary>\newtie</primary></indexterm>
<indexterm role="fn"><primary>\capitalnewtie</primary></indexterm>
<indexterm role="cp"><primary>tie-after accent</primary></indexterm>
-<para>Produces a tie-after accent, as in &#8216;oo[&#8217;. The
-<literal>\newtie</literal> form is centered in its box.
+<para>oo[ Tie-after accent. The <literal>\newtie</literal> form is centered in
+its box.
</para>
</listitem></varlistentry><varlistentry><term><literal>\u</literal>
</term><term><literal>\capitalbreve</literal>
</term><listitem><indexterm role="fn"><primary>\u (breve accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalbreve</primary></indexterm>
<indexterm role="cp"><primary>breve accent</primary></indexterm>
-<para>Produces a breve accent, as in &#8216;&#335;&#8217;.
-</para>
-</listitem></varlistentry><varlistentry><term><literal>\underbar</literal>
-</term><listitem><indexterm role="fn"><primary>\underbar</primary></indexterm>
-<indexterm role="cp"><primary>underbar</primary></indexterm>
-<para>Not exactly an accent, this produces a bar under the argument text.
-The argument is always processed in horizontal mode. The bar is
-always a fixed position under the baseline, thus crossing through
-descenders. See also <literal>\underline</literal> in <link linkend="Math-miscellany">Math miscellany</link>.
-See also <literal>\b</literal> above.
+<para>&#335; Breve accent.
</para>
</listitem></varlistentry><varlistentry><term><literal>\v</literal>
</term><term><literal>\capitalcaron</literal>
@@ -11169,7 +14743,7 @@ See also <literal>\b</literal> above.
<indexterm role="cp"><primary>hacek accent</primary></indexterm>
<indexterm role="cp"><primary>check accent</primary></indexterm>
<indexterm role="cp"><primary>caron accent</primary></indexterm>
-<para>Produces a h&#225;&#269;ek (check, caron) accent, as in &#8216;&#466;&#8217;.
+<para>&#466; H&#225;&#269;ek (check, caron) accent.
</para>
</listitem></varlistentry></variablelist>
@@ -11184,8 +14758,8 @@ See also <literal>\b</literal> above.
<indexterm role="cp"><primary>non-English characters</primary></indexterm>
<indexterm role="cp"><primary>characters, non-English</primary></indexterm>
-<para>Here are the basic &latex; commands for inserting letters (beyond
-A&#8211;Z) extending the Latin alphabet, used primarily in languages other
+<para>Here are the basic &latex; commands for inserting letters beyond
+A&#8211;Z that extend the Latin alphabet, used primarily in languages other
than English.
</para>
<variablelist><varlistentry><term><literal>\aa</literal>
@@ -11280,22 +14854,43 @@ font encoding, such as T1.
<indexterm role="fn"><primary>\rule</primary></indexterm>
-<para>Synopsis:
+<para>Synopsis, one of:
</para>
-<screen>\rule[<replaceable>raise</replaceable>]{<replaceable>width</replaceable>}{<replaceable>thickness</replaceable>}
+<screen>\rule{<replaceable>width</replaceable>}{<replaceable>thickness</replaceable>}
+\rule[<replaceable>raise</replaceable>]{<replaceable>width</replaceable>}{<replaceable>thickness</replaceable>}
</screen>
-<para>The <literal>\rule</literal> command produces <firstterm>rules</firstterm>, that is, lines or
-rectangles. The arguments are:
+<para>Produce a <firstterm>rule</firstterm>, a filled-in rectangle.
</para>
-<variablelist><varlistentry><term><replaceable>raise</replaceable>
-</term><listitem><para>How high to raise the rule (optional).
+<indexterm role="cp"><primary>Halmos symbol</primary></indexterm>
+<indexterm role="cp"><primary>tombstone</primary></indexterm>
+<para>This produces a rectangular blob, sometimes called a Halmos symbol,
+often used to mark the end of a proof.
</para>
-</listitem></varlistentry><varlistentry><term><replaceable>width</replaceable>
-</term><listitem><para>The length of the rule (mandatory).
+<screen>\newcommand{\qedsymbol}{\rule{0.4em}{2ex}}
+</screen>
+<indexterm role="cp"><primary>package, <literal>amsthm</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>amsthm</literal> package</primary></indexterm>
+
+<para>The <filename>amsthm</filename> package includes this command, with a somewhat
+different-looking symbol.
+</para>
+<para>The mandatory arguments give the horizontal <replaceable>width</replaceable> and vertical
+<replaceable>thickness</replaceable> of the rectangle. They are rigid lengths
+(see <link linkend="Lengths">Lengths</link>). The optional argument <replaceable>raise</replaceable> is also a rigid
+length, and tells &latex; how much to raise the rule above the
+baseline, or lower it if the length is negative.
+</para>
+<para>This produces a line, a rectangle that is wide but not tall.
+</para>
+<screen>\noindent\rule{\textwidth}{0.4pt}
+</screen>
+<para>The line is the width of the page and 0.4&#160;points tall. This line
+thickness is common in &latex;.
+</para>
+<para>A rule that has zero width, or zero thickness, will not show up in the
+output, but can cause &latex; to change the output around it.
+See <link linkend="_005cstrut">\strut</link> for examples.
</para>
-</listitem></varlistentry><varlistentry><term><replaceable>thickness</replaceable>
-</term><listitem><para>The thickness of the rule (mandatory).
-</para></listitem></varlistentry></variablelist>
</sect1>
<sect1 label="23.8" id="_005ctoday">
@@ -11303,16 +14898,25 @@ rectangles. The arguments are:
<indexterm role="fn"><primary>\today</primary></indexterm>
<indexterm role="cp"><primary>date, today&#8217;s</primary></indexterm>
+<indexterm role="cp"><primary>today&#8217;s date</primary></indexterm>
-<para>The <literal>\today</literal> command produces today&#8217;s date, in the format
-&#8216;<literal><replaceable>month</replaceable> <replaceable>dd</replaceable>, <replaceable>yyyy</replaceable></literal>&#8217;; for example, &#8216;<literal>July 4, 1976</literal>&#8217;.
-It uses the predefined counters <literal>\day</literal>, <literal>\month</literal>, and
-<literal>\year</literal> (see <link linkend="_005cday-_005cmonth-_005cyear">\day \month \year</link>) to do this. It is not
-updated as the program runs.
+<para>Synopsis:
</para>
-<para>Multilingual packages like <filename>babel</filename> or classes like <filename>lettre</filename>,
-among others, will localize <literal>\today</literal>. For example, the following
-will output &#8216;<literal>4 juillet 1976</literal>&#8217;:
+<screen>\today
+</screen>
+<para>Produce today&#8217;s date in the format &#8216;<literal><replaceable>month</replaceable> <replaceable>dd</replaceable>,
+<replaceable>yyyy</replaceable></literal>&#8217;. An example of a date in that format is &#8216;<literal>July 4,
+1976</literal>&#8217;.
+</para>
+<indexterm role="cp"><primary>package, <literal>babel</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>babel</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>polyglossia</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>polyglossia</literal> package</primary></indexterm>
+
+<para>Multilingual packages such as <filename>babel</filename> or <filename>polyglossia</filename>, or
+classes such as <filename>lettre</filename>, will localize <literal>\today</literal>. For example,
+the following will output &#8216;<literal>4 juillet 1976</literal>&#8217;:
</para>
<screen>\year=1976 \month=7 \day=4
\documentclass{minimal}
@@ -11321,11 +14925,17 @@ will output &#8216;<literal>4 juillet 1976</literal>&#8217;:
\today
\end{document}
</screen>
+<para><literal>\today</literal> uses the counters <literal>\day</literal>, <literal>\month</literal>, and
+<literal>\year</literal> (see <link linkend="_005cday-_0026-_005cmonth-_0026-_005cyear">\day &amp; \month &amp; \year</link>).
+</para>
<indexterm role="cp"><primary>package, <literal>datetime</literal></primary></indexterm>
<indexterm role="cp"><primary><literal>datetime</literal> package</primary></indexterm>
-<para>The <literal>datetime</literal> package, among others, can produce a wide variety
-of other date formats.
+<para>A number of package on CTAN work with dates. One is <filename>datetime</filename> package
+which can produce a wide variety of date formats, including ISO standards.
+</para>
+<para>The date is not updated as the &latex; process runs, so in principle the
+date could be incorrect by the time the program finishes.
</para>
</sect1>
@@ -11336,60 +14946,214 @@ of other date formats.
<indexterm role="cp"><primary>splitting the input file</primary></indexterm>
<indexterm role="cp"><primary>input file</primary></indexterm>
-<para>A large document requires a lot of input. Rather than putting the whole
-input in a single large file, it&#8217;s more efficient to split it into
-several smaller ones. Regardless of how many separate files you use,
-there is one that is the
+<para>&latex; lets you split a large document into several smaller ones.
+This can simplify editing or allow multiple authors to work on the
+document. It can also speed processing.
+</para>
+<para>Regardless of how many separate files you use, there is always one
<indexterm role="cp"><primary>root file</primary></indexterm>
<indexterm role="cp"><primary>file, root</primary></indexterm>
-<firstterm>root file</firstterm>; it is the one whose name you type
-when you run &latex;.
+<firstterm>root file</firstterm>, on which &latex; compilation starts. This shows such
+a file with five included files.
</para>
-<para>See <link linkend="filecontents">filecontents</link>, for an environment that allows bundling an
-external file to be created with the main document.
+<screen>\documentclass{book}
+\includeonly{ % comment out lines below to omit compiling
+ pref,
+ chap1,
+ chap2,
+ append,
+ bib
+ }
+\begin{document}
+\frontmatter
+\include{pref}
+\mainmatter
+\include{chap1}
+\include{chap2}
+\appendix
+\include{append}
+\backmatter
+\include{bib}
+\end{document}
+</screen>
+<para>This will bring in material from <filename>pref.tex</filename>, <filename>chap1.tex</filename>,
+<filename>chap2.tex</filename>, <filename>append.tex</filename>, and <filename>bib.tex</filename>. If you compile
+this file, and then comment out all of the lines inside
+<literal>\includeonly{...}</literal> except for <literal>chap1,</literal> and compile again,
+then &latex; will only process the material in the first chapter.
+Thus, your output will appear more quickly and be shorter to print.
+However, the advantage of the <literal>\includeonly</literal> command is that
+&latex; will retain the page numbers and all of the cross reference
+information from the other parts of the document so these will appear in
+your output correctly.
+</para>
+<para>See <link linkend="Larger-book-template">Larger book template</link> for another example of <literal>\includeonly</literal>.
</para>
-<sect1 label="24.1" id="_005cinclude">
-<title><literal>\include</literal></title>
-<indexterm role="fn"><primary>\include</primary></indexterm>
+<sect1 label="24.1" id="_005cendinput">
+<title><literal>\endinput</literal></title>
+
+<indexterm role="fn"><primary>\endinput</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\include{<replaceable>file</replaceable>}
+<screen>\endinput
</screen>
-<para>If no <literal>\includeonly</literal> command is present, the <literal>\include</literal>
-command executes <literal>\clearpage</literal> to start a new page
-(see <link linkend="_005cclearpage">\clearpage</link>), then reads <replaceable>file</replaceable>, then does another
-<literal>\clearpage</literal>.
+<para>When you <literal>\include{filename}</literal>, inside <filename>filename.tex</filename> the
+material after <literal>\endinput</literal> will not be included. This command is
+optional; if <filename>filename.tex</filename> has no <literal>\endinput</literal> then &latex;
+will read all of the file.
</para>
-<para>Given an <literal>\includeonly</literal> command, the <literal>\include</literal> actions are
-only run if <replaceable>file</replaceable> is listed as an argument to
-<literal>\includeonly</literal>. See <link linkend="_005cincludeonly">\includeonly</link>.
+<para>For example, suppose that a document&#8217;s root file has
+<literal>\input{chap1}</literal> and this is <filename>chap1.tex</filename>.
</para>
-<indexterm role="cp"><primary>nested <literal>\include</literal>, not allowed</primary></indexterm>
-<para>The <literal>\include</literal> command may not appear in the preamble or in a file
-read by another <literal>\include</literal> command.
+<screen>\chapter{One}
+This material will appear in the document.
+\endinput
+This will not appear.
+</screen>
+<para>This can be useful for putting documentation or comments at the end of a
+file, or for avoiding junk characters that can be added during mailing.
+It is also useful for debugging: one strategy to localize errors is to
+put <literal>\endinput</literal> halfway through the included file and see if the
+error disappears. Now, knowing which half contains the error, moving
+<literal>\endinput</literal> to halfway through that area further narrows down the
+location. This process rapidly finds the offending line.
+</para>
+<para>After reading <literal>\endinput</literal>, &latex; continues to read to the end of
+the line, so something can follow this command and be read nonetheless.
+This allows you, for instance, to close an <literal>\if...</literal> with a
+<literal>\fi</literal>.
</para>
</sect1>
-<sect1 label="24.2" id="_005cincludeonly">
-<title><literal>\includeonly</literal></title>
+<sect1 label="24.2" id="_005cinclude-_0026-_005cincludeonly">
+<title><literal>\include</literal> &amp; <literal>\includeonly</literal></title>
+<indexterm role="fn"><primary>\include</primary></indexterm>
<indexterm role="fn"><primary>\includeonly</primary></indexterm>
<para>Synopsis:
</para>
-<screen>\includeonly{<replaceable>file1</replaceable>,<replaceable>file2</replaceable>,...}
+<screen>\includeonly{ % in document preamble
+ ...
+ <replaceable>filename</replaceable>,
+ ...
+ }
+ ...
+\include{<replaceable>filename</replaceable>} % in document body
+</screen>
+<para>Bring material from the external file <filename><replaceable>filename</replaceable>.tex</filename> into a
+&latex; document.
+</para>
+<para>The <literal>\include</literal> command does three things: it executes
+<literal>\clearpage</literal> (see <link linkend="_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</link>), then it
+inputs the material from <filename><replaceable>filename</replaceable>.tex</filename> into the document,
+and then it does another <literal>\clearpage</literal>. This command can only
+appear in the document body. The <literal>\includeonly</literal> command controls
+which files will be read by &latex; under subsequent <literal>\include</literal>
+commands. Its list of filenames is comma-separated, and it can only
+appear in the preamble.
+</para>
+<para>This example root document, <filename>constitution.tex</filename>, brings in
+three files, <filename>preamble.tex</filename>, <filename>articles.tex</filename>, and
+<filename>amendments.tex</filename>.
+</para>
+<screen>\documentclass{book}
+\includeonly{
+ preamble,
+ articles,
+ amendments
+ }
+\begin{document}
+\include{preamble}
+\include{articles}
+\include{amendments}
+\end{document}
+</screen>
+<para>The file <filename>preamble.tex</filename> contains no special code; you have just
+excerpted the chapter from <filename>consitution.tex</filename> and put it in a
+separate file just for editing convenience.
+</para>
+<screen>\chapter{Preamble}
+We the People of the United States,
+in Order to form a more perfect Union, ...
</screen>
-<para>The <literal>\includeonly</literal> command controls which files will be read by
-subsequent <literal>\include</literal> commands. The list of filenames is
-comma-separated. Each element <replaceable>file1</replaceable>, <replaceable>file2</replaceable>, &#8230; must
-exactly match a filename specified in a <literal>\include</literal> command for the
-selection to be effective.
+<para>Running &latex; on <filename>constitution.tex</filename> makes the material from the
+three files appear in the document but also generates the auxiliary
+files <filename>preamble.aux</filename>, <filename>articles.aux</filename>, and
+<filename>amendments.tex</filename>. These contain information such as page numbers
+and cross-references (see <link linkend="Cross-references">Cross references</link>). If you now comment out
+<literal>\includeonly</literal>&#8217;s lines with <literal>preamble</literal> and <literal>amendments</literal>
+and run &latex; again then the resulting document shows only the
+material from <filename>articles.tex</filename>, not the material from
+<filename>preamble.tex</filename> or <filename>amendments.tex</filename>. Nonetheless, all of the
+auxiliary information from the omitted files is still there, including
+the starting page number of the chapter.
+</para>
+<para>If the document preamble does not have <literal>\includeonly</literal> then
+&latex; will include all the files you call for with <literal>\include</literal>
+commands.
+</para>
+<para>The <literal>\include</literal> command makes a new page. To avoid that, see
+<link linkend="_005cinput">\input</link> (which, however, does not retain the auxiliary
+information).
+</para>
+<para>See <link linkend="Larger-book-template">Larger book template</link> for another example using <literal>\include</literal>
+and <literal>\includeonly</literal>. That example also uses <literal>\input</literal> for some
+material that will not necessarily start on a new page.
</para>
-<para>This command can only appear in the preamble.
+<para>File names can involve paths.
+</para>
+<screen>\documentclass{book}
+\includeonly{
+ chapters/chap1,
+ }
+\begin{document}
+\include{chapters/chap1}
+\end{document}
+</screen>
+<para>To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores. Nevertheless, for the name &#8216;<literal>amo amas amat</literal>&#8217;,
+this works under &tex; Live on GNU/Linux:
+</para>
+<screen>\documentclass{book}
+\includeonly{
+ &quot;amo\space amas\space amat&quot;
+ }
+\begin{document}
+\include{&quot;amo\space amas\space amat&quot;}
+\end{document}
+</screen>
+<para>and this works under MiK&tex; on Windows:
+</para>
+<screen>\documentclass{book}
+\includeonly{
+ {&quot;amo amas amat&quot;}
+ }
+\begin{document}
+\include{{&quot;amo amas amat&quot;}}
+\end{document}
+</screen>
+<indexterm role="cp"><primary>nested <literal>\include</literal>, not allowed</primary></indexterm>
+<para>You cannot use <literal>\include</literal> inside a file that is being included or
+you get &#8216;<literal>LaTeX Error: \include cannot be nested.</literal>&#8217; The
+<literal>\include</literal> command cannot appear in the document preamble; you will
+get &#8216;<literal>LaTeX Error: Missing \begin{document}</literal>&#8217;.
+</para>
+<para>If a file that you <literal>\include</literal> does not exist, for instance if you
+<literal>\include{athiesm}</literal> but you meant <literal>\include{atheism}</literal>,
+then &latex; does not give you an error but will warn you &#8216;<literal>No file
+athiesm.tex.</literal>&#8217; (It will also create <filename>athiesm.aux</filename>.)
+</para>
+<para>If you <literal>\include</literal> the root file in itself then you first get
+&#8216;<literal>LaTeX Error: Can be used only in preamble.</literal>&#8217; Later runs get
+&#8216;<literal>TeX capacity exceeded, sorry [text input levels=15]</literal>&#8217;. To fix
+this, you must remove the inclusion <literal>\include{root}</literal> but also
+delete the file <filename><replaceable>root</replaceable>.aux</filename> and rerun &latex;.
</para>
</sect1>
@@ -11400,17 +15164,38 @@ selection to be effective.
<para>Synopsis:
</para>
-<screen>\input{<replaceable>file</replaceable>}
+<screen>\input{<replaceable>filename</replaceable>}
+</screen>
+<para>&latex; processes the file as if its contents were inserted in the
+current file. For a more sophisticated inclusion mechanism see
+<link linkend="_005cinclude-_0026-_005cincludeonly">\include &amp; \includeonly</link>.
+</para>
+<para>If <replaceable>filename</replaceable> does not end in &#8216;<literal>.tex</literal>&#8217; then &latex; first tries
+the filename with that extension; this is the usual case. If
+<replaceable>filename</replaceable> ends with &#8216;<literal>.tex</literal>&#8217; then &latex; looks for the
+filename as it is.
+</para>
+<para>For example, this
+</para>
+<screen>\input{macros}
</screen>
-<para>The <literal>\input</literal> command causes the specified <replaceable>file</replaceable> to be read
-and processed, as if its contents had been inserted in the current
-file at that point.
+<para>will cause &latex; to first look for <filename>macros.tex</filename>. If it finds
+that file then it processes its contents as thought they had been
+copy-pasted in. If there is no file of the name <filename>macros.tex</filename> then
+&latex; tries the name <filename>macros</filename>, without an extension. (This may
+vary by distribution.)
+</para>
+<para>To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores. Nevertheless, for the name &#8216;<literal>amo amas amat</literal>&#8217;,
+this works under &tex; Live on GNU/Linux:
</para>
-<para>If <replaceable>file</replaceable> does not end in &#8216;<literal>.tex</literal>&#8217; (e.g., &#8216;<literal>foo</literal>&#8217; or
-&#8216;<literal>foo.bar</literal>&#8217;), it is first tried with that extension (&#8216;<literal>foo.tex</literal>&#8217;
-or &#8216;<literal>foo.bar.tex</literal>&#8217;). If that is not found, the original <replaceable>file</replaceable>
-is tried (&#8216;<literal>foo</literal>&#8217; or &#8216;<literal>foo.bar</literal>&#8217;).
+<screen>\input{&quot;amo\space amas\space amat&quot;}
+</screen>
+<para>and this works under MiK&tex; on Windows:
</para>
+<screen>\input{{&quot;amo amas amat&quot;}}
+</screen>
</sect1>
</chapter>
@@ -11419,35 +15204,121 @@ is tried (&#8216;<literal>foo</literal>&#8217; or &#8216;<literal>foo.bar</liter
-<sect1 label="25.1" id="Tables-of-contents">
-<title>Tables of contents</title>
+<sect1 label="25.1" id="Table-of-contents-etc_002e">
+<title>Table of contents etc.</title>
<indexterm role="cp"><primary>table of contents, creating</primary></indexterm>
<indexterm role="fn"><primary>\tableofcontents</primary></indexterm>
<indexterm role="fn"><primary>.toc file</primary></indexterm>
-<para>A table of contents is produced with the <literal>\tableofcontents</literal>
-command. You put the command right where you want the table of
-contents to go; &latex; does the rest for you. A previous run must
-have generated a <filename>.toc</filename> file.
-</para>
-<para>The <literal>\tableofcontents</literal> command produces a heading, but it does
-not automatically start a new page. If you want a new page after the
-table of contents, write a <literal>\newpage</literal> command after the
-<literal>\tableofcontents</literal> command.
-</para>
<indexterm role="fn"><primary>\listoffigures</primary></indexterm>
<indexterm role="fn"><primary>\listoftables</primary></indexterm>
<indexterm role="fn"><primary>.lof file</primary></indexterm>
<indexterm role="fn"><primary>.lot file</primary></indexterm>
-<para>The analogous commands <literal>\listoffigures</literal> and <literal>\listoftables</literal>
-produce a list of figures and a list of tables (from <filename>.lof</filename> and
-<filename>.lot</filename> files), respectively. Everything works exactly the same
-as for the table of contents.
+
+<para>Synopsis, one of:
</para>
-<indexterm role="fn"><primary>\nofiles</primary></indexterm>
-<para>The command <literal>\nofiles</literal> overrides these commands, and
-<emphasis>prevents</emphasis> any of these lists from being generated.
+<screen>\tableofcontents
+\listoffigures
+\listoftables
+</screen>
+<para>Produce a table of contents, or list of figures, or list of tables. Put
+the command in the input file where you want the table or list to
+go. You do not type the entries; for example, typically the table of
+contents entries are automatically generated from the sectioning
+commands <literal>\chapter</literal>, etc.
+</para>
+<para>This example illustrates the first command, <literal>\tableofcontents</literal>.
+&latex; will produce a table of contents on the book&#8217;s first page.
+</para>
+<screen>\documentclass{book}
+% \setcounter{tocdepth}{1}
+\begin{document}
+\tableofcontents\newpage
+ ...
+\chapter{...}
+ ...
+\section{...}
+ ...
+\subsection{...}
+ ...
+\end{document}
+</screen>
+<para>Uncommenting the second line would cause that table to contain chapter
+and section listings but not subsection listings, because the
+<literal>\section</literal> command has level&#160;1. See <link linkend="Sectioning">Sectioning</link> for level
+numbers of the sectioning units. For more on the <literal>tocdepth</literal>
+see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>.
+</para>
+<para>Another example of the use of <literal>\tableofcontents</literal> is in <link linkend="Larger-book-template">Larger
+book template</link>.
+</para>
+<para>If you want a page break after the table of contents, write a
+<literal>\newpage</literal> command after the <literal>\tableofcontents</literal> command, as
+above.
+</para>
+<para>To make the table of contents &latex; stores the information in an
+auxiliary file named <filename><replaceable>root-file</replaceable>.toc</filename> (see <link linkend="Splitting-the-input">Splitting the
+input</link>). For example, this &latex; file <filename>test.tex</filename>
+</para>
+<screen>\documentclass{article}
+\begin{document}
+\tableofcontents\newpage
+\section{First section}
+\subsection{First subsection}
+ ...
+</screen>
+<para>writes the following line to <filename>test.toc</filename>.
+</para>
+<screen>\contentsline {section}{\numberline {1}First section}{2}
+\contentsline {subsection}{\numberline {1.1}First subsection}{2}
+</screen>
+<para>The <literal>section</literal> or <literal>subsection</literal> is the sectioning unit. The
+hook <literal>\numberline</literal> lets you to change how the information appears
+in the table of contents. Of its two arguments, <literal>1</literal> or <literal>1.1</literal>
+is the sectioning unit number and <literal>First section</literal> or <literal>First
+subsection</literal> is the title. Finally, <literal>2</literal> is the page number on which
+the sectioning units start.
+</para>
+<para>One consequence of this auxiliary file storage strategy is that to get the
+contents page correct you must run &latex; twice, once to store the
+information and once to get it. In particular, the first time that you
+run &latex; on a new document, the table of contents page will be empty
+except for its &#8216;<literal>Contents</literal>&#8217; header. Just run it again.
+</para>
+<para>The commands <literal>\listoffigures</literal> and <literal>\listoftables</literal> produce a
+list of figures and a list of tables. They work the same way as the
+contents commands; for instance, these work with information stored in
+<filename>.lof</filename> and <filename>.lot</filename> files.
+</para>
+<indexterm role="cp"><primary>package, <literal>babel</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>babel</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>polyglossia</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>polyglossia</literal> package</primary></indexterm>
+
+<para>To change the header for the table of contents page do something like
+the first line here.
+</para>
+<screen>\renewcommand{\contentsname}{Table of contents}
+\renewcommand{\listfigurename}{Plots}
+\renewcommand{\listtablename}{Tables}
+</screen>
+<para>Similarly, the other two lines will do the other two.
+Internationalization packages such as <filename>babel</filename> or <filename>polyglossia</filename>
+will change the headers depending on the chosen base language.
+</para>
+<indexterm role="cp"><primary>package, <literal>tocloft</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>tocloft</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>tocbibbind</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>tocbibbind</literal> package</primary></indexterm>
+
+<para>CTAN has many packages for the table of contents and lists of figures
+and tables. One convenient one for adjusting some aspects of the
+default, such as spacing, is <filename>tocloft</filename>. And, <filename>tocbibbind</filename>
+will automatically add the bibliography, index, etc. to the table of
+contents.
</para>
@@ -11461,36 +15332,82 @@ as for the table of contents.
</para>
<screen>\addcontentsline{<replaceable>ext</replaceable>}{<replaceable>unit</replaceable>}{<replaceable>text</replaceable>}
</screen>
-<para>The <literal>\addcontentsline</literal> command adds an entry to the specified list
-or table where:
+<indexterm role="fn"><primary>\contentsline</primary></indexterm>
+<para>Add an entry to the file specified by <replaceable>ext</replaceable>. Usually <replaceable>ext</replaceable> is
+one of <literal>toc</literal> for the table of contents, <literal>lof</literal> for the list of
+figures, or <literal>lot</literal> for the list of tables.
+</para>
+<para>The following will result in an &#8216;<literal>Appendices</literal>&#8217; line in the table of
+contents.
+</para>
+<screen>\addcontentsline{toc}{section}{\protect\textbf{Appendices}}
+</screen>
+<para>It will appear at the same indentation level as the sections, will be in
+boldface, and will be assigned the page number associated with the point
+where it appears in the input file.
+</para>
+<para>The <literal>\addcontentsline</literal> command writes information to the file
+<filename><replaceable>root-name</replaceable>.<replaceable>ext</replaceable></filename>. It writes that information as the
+text of the command
+<literal>\contentsline{<replaceable>unit</replaceable>}{<replaceable>text</replaceable>}{<replaceable>num</replaceable>}</literal>, where
+<literal><replaceable>num</replaceable></literal> is the current value of counter <literal><replaceable>unit</replaceable></literal>. The
+most common case is the table of contents and there <replaceable>num</replaceable> is the
+page number of the first page of <replaceable>unit</replaceable>.
+</para>
+<para>This command is invoked by the sectioning commands <literal>\chapter</literal>,
+etc., and also by <literal>\caption</literal> inside a float environment. But it is
+also used by authors. For example, in a book to have the preface
+unnumbered, you may use the starred <literal>\chapter*</literal>. But that does not
+put in table of contents information, so you can enter it manually, as
+here.
+</para>
+<screen>\chapter*{Preface}
+\addcontentsline{toc}{chapter}{\protect\numberline{}Preface}
+</screen>
+<para>In the <filename>.toc</filename> file &latex; will put the line <literal>\contentsline
+{chapter}{\numberline {}Preface}{3}</literal>; note the page number
+&#8216;<literal>3</literal>&#8217;.
+</para>
+<!-- xx how hardwired are these values? other unit names? -->
+
+<para>All of the arguments for <literal>\addcontentsline</literal> are required.
</para>
<variablelist><varlistentry><term><replaceable>ext</replaceable>
-</term><listitem><para>The filename extension of the file on which information is to be written,
-typically one of: <literal>toc</literal> (table of contents), <literal>lof</literal> (list of
-figures), or <literal>lot</literal> (list of tables).
+</term><listitem><para>Typically one of the strings <literal>toc</literal> for the table of contents,
+<literal>lof</literal> for the list of figures, or <literal>lot</literal> for the list of
+tables. The filename extension of the information file.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>unit</replaceable>
-</term><listitem><para>The name of the sectional unit being added, typically one of the
-following, matching the value of the <replaceable>ext</replaceable> argument:
+</term><listitem><para>A string that depends on the value of the <replaceable>ext</replaceable> argument:
</para>
<variablelist><varlistentry><term><literal>toc</literal>
-</term><listitem><para>The name of the sectional unit: <literal>part</literal>, <literal>chapter</literal>,
-<literal>section</literal>, <literal>subsection</literal>, <literal>subsubsection</literal>.
-</para></listitem></varlistentry><varlistentry><term><literal>lof</literal>
+</term><listitem><para>For the table of contents, this is the name of a sectional unit:
+<literal>part</literal>, <literal>chapter</literal>, <literal>section</literal>, <literal>subsection</literal>, etc.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>lof</literal>
</term><listitem><para>For the list of figures: <literal>figure</literal>.
-</para></listitem></varlistentry><varlistentry><term><literal>lot</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><literal>lot</literal>
</term><listitem><para>For the list of tables: <literal>table</literal>.
</para></listitem></varlistentry></variablelist>
</listitem></varlistentry><varlistentry><term><replaceable>text</replaceable>
-</term><listitem><para>The text of the entry.
+</term><listitem><para>The text of the entry. You must <literal>\protect</literal> any commands that are
+fragile (see <link linkend="_005cprotect">\protect</link>).
</para></listitem></varlistentry></variablelist>
-<indexterm role="fn"><primary>\contentsline</primary></indexterm>
-<para>What is written to the <filename>.<replaceable>ext</replaceable></filename> file is the command
-<literal>\contentsline{<replaceable>unit</replaceable>}{<replaceable>text</replaceable>}{<replaceable>num</replaceable>}</literal>, where
-<literal><replaceable>num</replaceable></literal> is the current value of counter <literal><replaceable>unit</replaceable></literal>.
+<para>The <literal>\addcontentsline</literal> command has an interaction with
+<literal>\include</literal> (see <link linkend="_005cinclude-_0026-_005cincludeonly">\include &amp; \includeonly</link>). If you use them at
+the same level, as with
+<literal>\addcontentsline{...}{...}{...}\include{...}</literal> then lines
+in the table of contents can come out in the wrong order. The solution
+is to move <literal>\addcontentsline</literal> into the file being included.
+</para>
+<para>If you use a <replaceable>unit</replaceable> that &latex; does not recognize, as here
+</para>
+<screen>\addcontentsline{toc}{setcion}{\protect\textbf{Appendices}}
+</screen>
+<para>then you don&#8217;t get an error but the formatting in the table of contents
+will not make sense.
</para>
-<!-- xx how hardwired are these values? other unit names? -->
-
</sect2>
<sect2 label="25.1.2" id="_005caddtocontents">
@@ -11498,114 +15415,628 @@ following, matching the value of the <replaceable>ext</replaceable> argument:
<indexterm role="fn"><primary>\addtocontents{<replaceable>ext</replaceable>}{<replaceable>text</replaceable>}</primary></indexterm>
-<para>The <literal>\addtocontents</literal>{<replaceable>ext</replaceable>}{<replaceable>text</replaceable>} command adds text
-(or formatting commands) directly to the <filename>.<replaceable>ext</replaceable></filename> file that
-generates the table of contents or lists of figures or tables.
+<para>Synopsis:
+</para>
+<screen>\addtocontents{<replaceable>ext</replaceable>}{<replaceable>text</replaceable>}
+</screen>
+<para>Add <replaceable>text</replaceable>, which may be text or formatting commands, directly to
+the auxiliary file with extension <replaceable>ext</replaceable>. This is most commonly used
+for the table of contents so that is the discussion here, but this also
+applies to the list of figures and list of tables.
+</para>
+<para>This will put some vertical space in the table of contents after the
+&#8216;<literal>Contents</literal>&#8217; header.
+</para>
+<screen>\tableofcontents\newpage
+\addtocontents{toc}{\protect\vspace*{3ex}}
+</screen>
+<para>The <literal>\addtocontents</literal> command has two arguments. Both are
+required.
</para>
<variablelist><varlistentry><term><replaceable>ext</replaceable>
-</term><listitem><para>The extension of the file on which information is to be written,
-typically one of: <filename>toc</filename> (table of contents), <filename>lof</filename> (list of
-figures), or <filename>lot</filename> (list of tables).
+</term><listitem><para>Typically one of: <filename>toc</filename> for the table of contents, <filename>lof</filename> for
+the list of figures, or <filename>lot</filename> for the list of tables. The
+extension of the file holding the information.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>text</replaceable>
-</term><listitem><para>The text to be written.
+</term><listitem><para>The text, and possibly commands, to be written.
</para></listitem></varlistentry></variablelist>
+<para>The sectioning commands such as <literal>\chapter</literal> use the
+<literal>\addcontentsline</literal> command to store information. This command
+creates lines in the <filename>.toc</filename> auxiliary file containing the
+<literal>\contentsline</literal> command (see <link linkend="_005caddcontentsline">\addcontentsline</link>). In contrast,
+the command <literal>\addtocontents</literal> puts material directly in that file.
+</para>
+<para>The <literal>\addtocontents</literal> command has an interaction with
+<literal>\include</literal> (see <link linkend="_005cinclude-_0026-_005cincludeonly">\include &amp; \includeonly</link>). If you use them at
+the same level, as with
+<literal>\addtocontents{...}{...}\include{...}</literal> then lines in the
+table of contents can come out in the wrong order. The solution is to
+move <literal>\addtocontents</literal> into the file being included.
+</para>
</sect2>
-</sect1>
-<sect1 label="25.2" id="Glossaries">
-<title>Glossaries</title>
+<sect2 label="25.1.3" id="_005cnofiles">
+<title><literal>\nofiles</literal></title>
-<indexterm role="cp"><primary>glossaries</primary></indexterm>
+<indexterm role="fn"><primary>\nofiles</primary></indexterm>
-<indexterm role="fn"><primary>\makeglossary</primary></indexterm>
-<para>The command <literal>\makeglossary</literal> enables creating glossaries.
+<para>Synopsis:
</para>
-<indexterm role="fn"><primary>\glossary</primary></indexterm>
-<indexterm role="cp"><primary><filename>.glo</filename> file</primary></indexterm>
-<para>The command <literal>\glossary{<replaceable>text</replaceable>}</literal> writes a glossary entry for
-<replaceable>text</replaceable> to an auxiliary file with the <filename>.glo</filename> extension.
+<screen>\nofiles
+</screen>
+<para>Prevent &latex; from writing any auxiliary files. The only output will
+be the <filename>.log</filename> and <filename>.pdf</filename> (or <filename>.dvi</filename>) files. This command
+must go in the preamble.
</para>
-<indexterm role="fn"><primary>\glossaryentry</primary></indexterm>
-<para>Specifically, what gets written is the command
-<literal>\glossaryentry{<replaceable>text</replaceable>}{<replaceable>pageno</replaceable>}</literal>, where
-<replaceable>pageno</replaceable> is the current <literal>\thepage</literal> value.
+<para>Because of the <literal>\nofiles</literal> command this example will not produce a
+<filename>.toc</filename> file.
</para>
-<indexterm role="cp"><primary>glossary package</primary></indexterm>
-<para>The <literal>glossary</literal> package on CTAN provides support for fancier
-glossaries.
+<screen>\documentclass{book}
+\nofiles
+\begin{document}
+\tableofcontents\newpage
+\chapter{...}
+ ...
+</screen>
+<para>&latex; will not erase any existing auxiliary files, so if you insert
+the <literal>\nofiles</literal> command after you have run the file and gotten
+a <filename>.toc</filename> then the table of contents page will continue to show
+the old information.
</para>
+</sect2>
</sect1>
-<sect1 label="25.3" id="Indexes">
+<sect1 label="25.2" id="Indexes">
<title>Indexes</title>
<indexterm role="cp"><primary>indexes</primary></indexterm>
<indexterm role="fn"><primary>\makeindex</primary></indexterm>
-<para>The command <literal>\makeindex</literal> enables creating indexes. Put this in
-the preamble.
-</para>
<indexterm role="fn"><primary>\index</primary></indexterm>
<indexterm role="cp"><primary><filename>.idx</filename> file</primary></indexterm>
-<para>The command <literal>\index{<replaceable>text</replaceable>}</literal> writes an index entry for
-<replaceable>text</replaceable> to an auxiliary file named with the <filename>.idx</filename> extension.
+
+<para>This document has an index.
</para>
-<indexterm role="fn"><primary>\indexentry</primary></indexterm>
-<para>Specifically, what gets written is the command
-<literal>\indexentry{<replaceable>text</replaceable>}{<replaceable>pageno</replaceable>}</literal>, where <replaceable>pageno</replaceable>
-is the current <literal>\thepage</literal> value.
+<screen>\documentclass{article}
+\usepackage{makeidx} \makeindex
+ ...
+\begin{document}
+ ...
+Recall Wilson's Theorem: \index{Wilson's Theorem}
+a number \( n&gt;1 \) is prime if and only if the factorial of \( n-1 \)
+is congruent to \( -1 \) modulo~\( n \).
+ ...
+\printindex
+ ...
+</screen>
+<para>The <literal>\usepackage{makeidx}</literal> and <literal>\makeindex</literal> in the preamble
+bring in the relevant commands.
+</para>
+<para>Producing an index is a three stage process. First, in the document
+body you declare index entries with the <literal>\index</literal> command
+(see <link linkend="_005cindex">\index</link>). When you run &latex;, the <literal>\index</literal> writes its
+information to an auxiliary file <filename><replaceable>root-name</replaceable>.idx</filename>. Next, to
+alphabetize and to do other manipulations you run an external command,
+typically <command>makeindex</command> or <command>xindy</command> (see <link linkend="makeindex">makeindex</link>).
+These output a file <filename><replaceable>root-name</replaceable>.ind</filename>. Finally, you bring the
+information back into your document and typeset it with the
+<literal>\printindex</literal> command (see <link linkend="_005cprintindex">\printindex</link>).
+</para>
+<indexterm role="cp"><primary>package, <literal>showidx</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>showidx</literal> package</primary></indexterm>
+
+<indexterm role="cp"><primary>package, <literal>multind</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>multind</literal> package</primary></indexterm>
+
+<para>There are many packages that apply to indexing commands. The
+<literal>showidx</literal> package causes each index entries to be shown in the
+margin on the page where the entry appears. This can help in preparing
+the index. The <literal>multind</literal> package supports multiple indexes. See
+also the &tex; FAQ entry on this topic,
+<ulink url="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind</ulink>.
+</para>
+
+
+<sect2 label="25.2.1" id="_005cindex">
+<title><literal>\index</literal></title>
+
+<indexterm role="cp"><primary>index entry</primary></indexterm>
+<indexterm role="fn"><primary>\index</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\index{<replaceable>index-entry-string</replaceable>}
+</screen>
+<para>Declare an entry in the index. This command is fragile
+(see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>For example, as described in <link linkend="Indexes">Indexes</link>, one way to get an index from
+what&#8217;s below is to compile the document with <literal>pdflatex test</literal>, then
+process the index entries with <literal>makeindex test</literal>, and then compile
+again with <literal>pdflatex test</literal>.
+</para>
+<screen>W~Ackermann (1896--1962).\index{Ackermann}
+ ...
+Ackermann function\index{Ackermann!function}
+ ...
+rate of growth\index{Ackermann!function!growth rate}
+</screen>
+<para>All three index entries will get a page number, such as &#8216;<literal>Ackermann,
+22</literal>&#8217;. &latex; will format the second as a subitem of the first, on the
+line below it and indented, and the third as a subitem of the second.
+Three levels deep is as far as you can nest subentries. (If you add
+<literal>\index{Ackermann!function!growth rate!comparison}</literal> then
+<command>makeindex</command> says &#8216;<literal>Scanning input file test.idx....done (4
+entries accepted, 1 rejected)</literal>&#8217; and nothing appears in the index).
+</para>
+<para>If you enter a second <literal>\index</literal> with the same
+<replaceable>index-entry-string</replaceable> then you will get a single index entry with two
+page numbers (unless they happen to fall on the same page). Thus,
+adding <literal>as for Ackermann.\index{Ackermann}</literal> later in the same
+document as above will give an index entry like &#8216;<literal>Ackermann, 22,
+151</literal>&#8217;. Also, you can enter the index entries in any order, so for
+instance <literal>\index{Ackermann!function}</literal> could come before
+<literal>\index{Ackermann}</literal>.
+</para>
+<indexterm role="cp"><primary>index, page range</primary></indexterm>
+<para>Get a page range in the output, like &#8216;<literal>Hilbert, 23--27</literal>&#8217;, as here.
+</para>
+<screen>W~Ackermann (1896--1962).\index{Ackermann}
+ ...
+D~Hilbert (1862--1943)\index{Ackermann!Hilbert\(}
+ ...
+disapproved of his marriage.\index{Ackermann!Hilbert\)}
+</screen>
+<para>If the beginning and ending of the page range are equal then the system
+just gives a single page entry, not a range.
+</para>
+<para>If you index subentries but not a main entry, as with
+<literal>\index{Jones!program}</literal> and <literal>\index{Jones!results}</literal>, then
+the output is the item &#8216;<literal>Jones</literal>&#8217; with no comma or page number,
+followed by two subitems, like &#8216;<literal>program, 50</literal>&#8217; and &#8216;<literal>results,
+51</literal>&#8217;.
</para>
<indexterm role="cp"><primary>&#8216;see&#8217; and &#8216;see also&#8217; index entries</primary></indexterm>
<indexterm role="cp"><primary>index entries, &#8216;see&#8217; and &#8216;see also&#8217;</primary></indexterm>
-<para>To generate a index entry for &#8216;bar&#8217; that says &#8216;See foo&#8217;, use a
-vertical bar: <literal>\index{bar|see{foo}}</literal>. Use <literal>seealso</literal>
-instead of <literal>see</literal> to make a &#8216;See also&#8217; entry.
-</para>
<indexterm role="fn"><primary>\seename</primary></indexterm>
<indexterm role="fn"><primary>\alsoname</primary></indexterm>
-<para>The text &#8216;See&#8217; is defined by the macro <literal>\seename</literal>, and &#8216;See also&#8217;
-by the macro <literal>\alsoname</literal>. These can be redefined for other
-languages.
+<indexterm role="cp"><primary>package, <literal>babel</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>babel</literal> package</primary></indexterm>
+<indexterm role="cp"><primary>package, <literal>polyglossia</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>polyglossia</literal> package</primary></indexterm>
+
+
+<para>Generate a index entry that says &#8216;<literal>See</literal>&#8217; by using a vertical bar
+character: <literal>\index{Ackermann!function|see{P\'eter's
+function}}</literal>. You can instead get &#8216;<literal>See also</literal>&#8217; with <literal>seealso</literal>.
+(The text &#8216;<literal>See</literal>&#8217; is defined by <literal>\seename</literal>, and &#8216;<literal>See also</literal>&#8217;
+by <literal>\alsoname</literal>. You can redefine these either by using an
+internationalization package such as <filename>babel</filename> or <filename>polyglossia</filename>,
+or directly as with <literal>\renewcommand{\alsoname}[1]{Also see
+#1}</literal>.)
+</para>
+<para>The &#8216;<literal>See</literal>&#8217; feature is part of a more general functionality. After
+the vertical bar you can put the name of a one-input command, as in
+<literal>\index{group|textit}</literal> (note the missing backslash on the
+<literal>\textit</literal> command) and the system will apply that command to the
+page number, here giving something like <literal>\textit{7}</literal>. You can
+define your own one-input commands, such as
+<literal>\newcommand{\definedpage}[1]{{\color{blue}#1}}</literal> and then
+<literal>\index{Ackermann!function|definedpage}</literal> will give a blue page
+number (see <link linkend="Color">Color</link>). Another, less practical, example is this,
+</para>
+<!-- credit Ian Thompson https://tex.stackexchange.com/a/272572/121234 -->
+<screen>\newcommand\indexownpage[1]{#1, \thepage}
+ ... Epimenides.\index{self-reference|indexownpage}
+</screen>
+<para>which creates an entry citing the page number of its own index listing.
+</para>
+<para>The two functions just described combine, as here
+</para>
+<screen>\index{Ackermann!function|(definedpage}
+ ...
+\index{Ackermann!function|)}
+</screen>
+<para>which outputs an index entry like &#8216;<literal>function, 23--27</literal>&#8217; where the page
+number range is in blue.
+</para>
+<para>Consider an index entry such as &#8216;<literal>&#x03B1;-ring</literal>&#8217;. Entering
+it as <literal>$\alpha$-ring</literal> will cause it to be alphabetized according to
+the dollar sign. You can instead enter it using an at-sign, as
+<literal>\index{alpha-ring@$\alpha$-ring}</literal>. If you specify an entry
+with an at-sign separating two strings, <literal><replaceable>pos</replaceable>@<replaceable>text</replaceable></literal>,
+then <replaceable>pos</replaceable> gives the alphabetical position of the entry while
+<replaceable>text</replaceable> produces the text of the entry. Another example is that
+<literal>\index{Saint Michael's College@SMC}</literal> produces an index entry
+&#8216;<literal>SMC</literal>&#8217; alphabetized into a different location than its spelling
+would naturally give it.
+</para>
+<para>To put a <literal>!</literal>, or <literal>@</literal>, or <literal>|</literal> character in an index
+entry, preceding it with a double quote, <literal>&quot;</literal>. (The double quote
+gets deleted before alphabetization.)
+</para>
+<indexterm role="cp"><primary>package, <literal>index</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>index</literal> package</primary></indexterm>
+
+<para>A number of packages on CTAN have additional functionality beyond that
+provided by <filename>makeidx</filename>. One is <filename>index</filename>, which allows for
+multiple indices and contains a command
+<literal>\index*{<replaceable>index-entry-string</replaceable>}</literal> that prints the
+<replaceable>index-entry-string</replaceable> as well as indexing it.
+</para>
+<indexterm role="fn"><primary>\indexentry</primary></indexterm>
+<indexterm role="cp"><primary>idx file</primary></indexterm>
+<para>The <literal>\index</literal> command writes the indexing information to the file
+<filename><replaceable>root-name</replaceable>.idx</filename> file. Specifically, it writes text of the
+command
+<literal>\indexentry{<replaceable>index-entry-string</replaceable>}{<replaceable>page-num</replaceable>}</literal>, where
+where <replaceable>page-num</replaceable> is the value of the <literal>\thepage</literal> counter. On
+occasion, when the <literal>\printindex</literal> command is confused, you have to
+delete this file to start with a fresh slate.
</para>
+<para>If you omit the closing brace of an <literal>\index</literal> command then you get a
+message like this.
+</para>
+<screen>Runaway argument? {Ackermann!function
+! Paragraph ended before \@wrindex was complete.
+</screen>
+
+</sect2>
+<sect2 label="25.2.2" id="makeindex">
+<title><command>makeindex</command></title>
+
+<indexterm role="cp"><primary>index, processing</primary></indexterm>
+<indexterm role="fn"><primary>makeindex</primary></indexterm>
<indexterm role="cp"><primary><command>makeindex</command> program</primary></indexterm>
-<indexterm role="cp"><primary><command>xindy</command> program</primary></indexterm>
<indexterm role="cp"><primary><filename>.ind</filename> file</primary></indexterm>
-<para>The generated <filename>.idx</filename> file is then sorted with an external
-command, usually either <command>makeindex</command>
-(<ulink url="http://mirror.ctan.org/indexing/makeindex">http://mirror.ctan.org/indexing/makeindex</ulink>) or (the
-multi-lingual) <command>xindy</command> (<ulink url="http://xindy.sourceforge.net">http://xindy.sourceforge.net</ulink>).
-This results in a <filename>.ind</filename> file, which can then be read to typeset
-the index.
+<indexterm role="cp"><primary><filename>.idx</filename> file</primary></indexterm>
+
+<para>Synopsis, one of:
+</para>
+<screen>makeindex <replaceable>filename</replaceable>
+makeindex -s <replaceable>style-file</replaceable> <replaceable>filename</replaceable>
+makeindex <replaceable>options</replaceable> <replaceable>filename0</replaceable> ...
+</screen>
+<para>Sort, and otherwise process, the index information in the auxiliary file
+<replaceable>filename</replaceable>. This is a command line program. It takes one or more
+raw index files, <filename><replaceable>filename</replaceable>.idx</filename> files, and produces the
+actual index file, the <filename><replaceable>filename</replaceable>.ind</filename> file that is input by
+<literal>\printindex</literal> (see <link linkend="_005cprintindex">\printindex</link>).
+</para>
+<indexterm role="cp"><primary><filename>.isty</filename> file</primary></indexterm>
+<indexterm role="fn"><primary>index, style file</primary></indexterm>
+<indexterm role="fn"><primary>makeindex, style file</primary></indexterm>
+<para>The first form of the command suffices for many uses. The second allows
+you to format the index by using an <firstterm>index style file</firstterm>, a
+<filename>.isty</filename> file. The third form is the most general; see the full
+documentation on CTAN.
+</para>
+<para>This is a simple <filename>.isty</filename> file.
+</para>
+<screen>% book.isty
+% $ makeindex -s book.isty -p odd book.idx
+% creates the index as book.ind, starting on an odd page.
+preamble
+&quot;\\pagestyle{empty}
+\\small
+\\begin{theindex}
+\\thispagestyle{empty}&quot;
+
+postamble
+&quot;\n
+\\end{theindex}&quot;
+</screen>
+<para>The description here covers only some of the index formatting
+possibilities in <replaceable>style-file</replaceable>. For a full list see the documentation
+on CTAN.
+</para>
+<para>A style file consists of a list of pairs: <replaceable>specifier</replaceable> and
+<replaceable>attribute</replaceable>. These can appear in the file in any order. All of the
+<replaceable>attributes</replaceable> are strings, except where noted. Strings are
+surrounded with double quotes, <literal>&quot;</literal>, and the maximum length of a
+string is 144 characters. The <literal>\n</literal> is for a newline and <literal>\t</literal>
+is for a tab. Backslashes are escaped with another backslash,
+<literal>\\</literal>. If a line begins with a percent sign, <literal>%</literal>, then it is a
+comment.
+</para>
+<variablelist><anchor id="makeindex-preamble"/><varlistentry><term><indexterm role="fn"><primary>preamble</primary></indexterm><literal>preamble</literal>
+</term><listitem><para>Preamble of the output file. Defines the context in which the index is
+formatted. Default: <literal>&quot;\\begin{theindex}\n&quot;</literal>.
+</para>
+<anchor id="makeindex-postamble"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>postamble</primary></indexterm><literal>postamble</literal>
+</term><listitem><para>Postamble of the output file. Default: <literal>&quot;\n\n\\end{theindex}\n&quot;</literal>.
+</para>
+<anchor id="makeindex-group-skip"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>group_skip</primary></indexterm><literal>group_skip</literal>
+</term><listitem><indexterm role="fn"><primary>\indexspace</primary></indexterm>
+<para>Traditionally index items are broken into groups, typically a group for
+entries starting with &#8216;<literal>a</literal>&#8217;, etc. This specifier gives what is
+inserted when a new group begins. Default: <literal>&quot;\n\n \\indexspace\n&quot;</literal>
+(<literal>\indexspace</literal> is a rubber length with default value <literal>10pt
+plus5pt minus3pt</literal>).
+</para>
+<anchor id="makeindex-letheadflag"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>lethead_flag</primary></indexterm><literal>lethead_flag</literal>
+</term><listitem><para>An integer. It governs what is inserted for a new group or letter. If
+it is 0 (which is the default) then other than <literal>group_skip</literal> nothing
+will be inserted before the group. If it is is positive then at a new
+letter the <literal>lethead_prefix</literal> and <literal>lethead_suffix</literal> will be
+inserted, with that letter in uppercase between them. If it is negative
+then what will be inserted is the letter in lowercase. The default
+is&#160;0.
+</para>
+<anchor id="makeindex-lethead-prefix"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>lethead_prefix</primary></indexterm><literal>lethead_prefix</literal>
+</term><listitem><para>If a new group begins with a different letter then this is the prefix
+inserted before the new letter header. Default: <literal>&quot;&quot;</literal>
+</para>
+<anchor id="makeindex-lethead-suffix"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>lethead_suffix</primary></indexterm><literal>lethead_suffix</literal>
+</term><listitem><para>If a group begins with a different letter then this is the suffix
+inserted after the new letter header. Default: <literal>&quot;&quot;</literal>.
+</para>
+<anchor id="makeindex-item-0"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>item_0</primary></indexterm><literal>item_0</literal>
+</term><listitem><para>What is put between two level&#160;0 items. Default: <literal>&quot;\n \\item
+&quot;</literal>.
+</para>
+<anchor id="makeindex-item-1"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>item_1</primary></indexterm><literal>item_1</literal>
+</term><listitem><para>Put between two level&#160;1 items. Default: <literal>&quot;\n \\subitem &quot;</literal>.
+</para>
+<anchor id="makeindex-item-2"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>item_2</primary></indexterm><literal>item_2</literal>
+</term><listitem><para>put between two level&#160;2 items. Default: <literal>&quot;\n \\subsubitem &quot;</literal>.
+</para>
+<anchor id="makeindex-item-01"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>item_01</primary></indexterm><literal>item_01</literal>
+</term><listitem><para>What is put between a level&#160;0 item and a level&#160;1 item.
+Default: <literal>&quot;\n \\subitem &quot;</literal>.
+</para>
+<anchor id="makeindex-item-x1"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>item_x1</primary></indexterm><literal>item_x1</literal>
+</term><listitem><para>What is put between a level&#160;0 item and a level&#160;1 item in the
+case that the level&#160;0 item doesn&#8217;t have any page numbers (as in
+<literal>\index{aaa|see{bbb}}</literal>). Default: <literal>&quot;\n \\subitem &quot;</literal>.
+</para>
+<anchor id="makeindex-item-12"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>item_12</primary></indexterm><literal>item_12</literal>
+</term><listitem><para>What is put between a level&#160;1 item and a level&#160;2 item.
+Default: <literal>&quot;\n \\subsubitem &quot;</literal>.
+</para>
+<anchor id="makeindex-item-x2"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>item_x2</primary></indexterm><literal>item_x2</literal>
+</term><listitem><para>What is put between a level&#160;1 item and a level&#160;2 item, if the
+level&#160;1 item doesn&#8217;t have page numbers. Default: <literal>&quot;\n
+\\subsubitem &quot;</literal>.
+</para>
+<anchor id="makeindex-delim-0"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>delim_0</primary></indexterm><literal>delim_0</literal>
+</term><listitem><para>Delimiter put between a level&#160;0 key and its first page
+number. Default: a comma followed by a blank, <literal>&quot;, &quot;</literal>.
+</para>
+<anchor id="makeindex-delim-1"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>delim_1</primary></indexterm><literal>delim_1</literal>
+</term><listitem><para>Delimiter put between a level&#160;1 key and its first page
+number. Default: a comma followed by a blank, <literal>&quot;, &quot;</literal>.
+</para>
+<anchor id="makeindex-delim-2"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>delim_2</primary></indexterm><literal>delim_2</literal>
+</term><listitem><para>Delimiter between a level&#160;2 key and its first page number. Default:
+a comma followed by a blank, <literal>&quot;, &quot;</literal>.
+</para>
+<anchor id="makeindex-delim-n"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>delim_n</primary></indexterm><literal>delim_n</literal>
+</term><listitem><para>Delimiter between two page numbers for the same key (at any
+level). Default: a comma followed by a blank, <literal>&quot;, &quot;</literal>.
+</para>
+<anchor id="makeindex-delim-r"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>delim_r</primary></indexterm><literal>delim_r</literal>
+</term><listitem><para>What is put between the starting and ending page numbers of a range.
+Default: <literal>&quot;--&quot;</literal>.
+</para>
+<anchor id="makeindex-line-max"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>line_max</primary></indexterm><literal>line_max</literal>
+</term><listitem><para>An integer. Maximum length of an index entry&#8217;s line in the output,
+beyond which the line wraps. Default: <literal>72</literal>.
+</para>
+<anchor id="makeindex-indent-space"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>indent_space</primary></indexterm><literal>indent_space</literal>
+</term><listitem><para>What is inserted at the start of a wrapped line. Default:
+<literal>&quot;\t\t&quot;</literal>.
+</para>
+<anchor id="makeindex-indent-length"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>indent_length</primary></indexterm><literal>indent_length</literal>
+</term><listitem><para>A number. The length of the wrapped line indentation. The default
+<literal>indent_space</literal> is two tabs and each tab is eight spaces so the
+default here is <literal>16</literal>.
+</para>
+<anchor id="makeindex-page-precedence"/></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>page_precedence</primary></indexterm><literal>page_precedence</literal>
+</term><listitem><para>A document may have pages numbered in different ways. For example, a
+book may have front matter pages numbered in lowercase roman while main
+matter pages are in arabic. This string specifies the order in which
+they will appear in the index. The <command>makeindex</command> command supports
+five different types of numerals: lowercase roman <literal>r</literal>, and numeric
+or arabic <literal>n</literal>, and lowercase alphabetic <literal>a</literal>, and uppercase
+roman <literal>R</literal>, and uppercase alphabetic <literal>A</literal>. Default:
+<literal>&quot;rnaRA&quot;</literal>.
+</para>
+</listitem></varlistentry></variablelist>
+<indexterm role="fn"><primary>xindy</primary></indexterm>
+<indexterm role="cp"><primary><command>xindy</command> program</primary></indexterm>
+<para>There are a number of other programs that do the job <command>makeindex</command>
+does. One is <command>xindy</command>, which does internationalization and can
+process indexes for documents marked up using &latex; and a number of
+other languages. It is is highly configurable, both in markup terms and
+in terms of the collating order of the text. See the documentation on
+CTAN.
</para>
+
+</sect2>
+<sect2 label="25.2.3" id="_005cprintindex">
+<title><command>\printindex</command></title>
+
+<indexterm role="cp"><primary>index, printing</primary></indexterm>
<indexterm role="fn"><primary>\printindex</primary></indexterm>
-<indexterm role="cp"><primary>package, <literal>makeidx</literal></primary></indexterm>
-<indexterm role="cp"><primary><literal>makeidx</literal> package</primary></indexterm>
-<para>The index is usually generated with the <literal>\printindex</literal> command.
-This is defined in the <literal>makeidx</literal> package, so
-<literal>\usepackage{makeidx}</literal> needs to be in the preamble.
+<para>Synopsis:
</para>
-<indexterm role="fn"><primary>\indexspace</primary></indexterm>
-<para>The rubber length <literal>\indexspace</literal> is inserted before each new
-letter in the printed index; its default value is &#8216;<literal>10pt plus5pt
-minus3pt</literal>&#8217;.
+<screen>\printindex
+</screen>
+<indexterm role="fn"><primary>\printindex</primary></indexterm>
+<para>Place the index into the output.
</para>
-<indexterm role="cp"><primary>package, <literal>showidx</literal></primary></indexterm>
-<indexterm role="cp"><primary><literal>showidx</literal> package</primary></indexterm>
+<para>To get an index you must first include
+<literal>\usepackage{makeidx}\makeindex</literal> in the document preamble and
+compile the document, then run the system command <command>makeindex</command>,
+and then compile the document again. See <link linkend="Indexes">Indexes</link> for further
+discussion and an example of the use of <literal>\printindex</literal>.
+</para>
+
+</sect2>
+</sect1>
+<sect1 label="25.3" id="Glossaries">
+<title>Glossaries</title>
+
+<indexterm role="cp"><primary>glossary</primary></indexterm>
+<indexterm role="cp"><primary>glossaries</primary></indexterm>
+<indexterm role="cp"><primary>acronyms, list of</primary></indexterm>
+<indexterm role="fn"><primary>\makeglossary</primary></indexterm>
+<indexterm role="fn"><primary>\printglossaries</primary></indexterm>
-<para>The <literal>showidx</literal> package causes each index entries to be shown in
-the margin on the page where the entry appears. This can help in
-preparing the index.
+<para>Synopsis:
+</para>
+<screen>\usepackage{glossaries} \makeglossaries
+ ...
+\newglossaryentry{<replaceable>label</replaceable>}{<replaceable>settings</replaceable>}
+ ...
+\gls{<replaceable>label</replaceable>}.
+ ...
+\printglossaries
+</screen>
+<para>The <filename>glossaries</filename> package allows you to make glossaries, including
+multiple glossaries, as well as lists of acronyms.
+</para>
+<para>To get the output from this example, compile the document (for instance
+with <literal>pdflatex filename</literal>), then run the command line command
+<literal>makeglossaries filename</literal>, and then compile the document again.
+</para>
+<screen>\documentclass{...}
+\usepackage{glossaries} \makeglossaries
+\newglossaryentry{tm}{%
+ name={Turing machine},
+ description={A model of a machine that computes. The model is simple
+ but can compute anything any existing device can compute.
+ It is the standard model used in Computer Science.},
+ }
+\begin{document}
+Everything begins with the definition of a \gls{tm}.
+ ...
+\printglossaries
+\end{document}
+</screen>
+<para>That gives two things. In the main text it outputs &#8216;<literal>... definition
+of a Turing machine</literal>&#8217;. In addition, in a separate sectional unit headed
+&#8216;<literal>Glossary</literal>&#8217; there appears a description list. In boldface it says
+&#8216;<literal>Turing machine</literal>&#8217; and the rest of the item says in normal type
+&#8216;<literal>A model of a machine &#8230; Computer Science</literal>&#8217;.
+</para>
+<indexterm role="fn"><primary>\makeglossary</primary></indexterm>
+<indexterm role="fn"><primary>\printglossaries</primary></indexterm>
+<indexterm role="cp"><primary><filename>.glo</filename> file</primary></indexterm>
+<para>The command <literal>\makeglossary</literal> opens the file that will contain the
+entry information, <filename><replaceable>root-file</replaceable>.glo</filename>. Put the
+<literal>\printglossaries</literal> command where you want the glossaries to appear
+in your document.
+</para>
+<para>The <filename>glossaries</filename> package is very powerful. For instance, besides
+the commands <literal>\newglossaryentry</literal> and <literal>\gls</literal>, there are similar
+commands for a list of acronyms. See the package documentations on
+CTAN.
</para>
-<indexterm role="cp"><primary>package, <literal>multind</literal></primary></indexterm>
-<indexterm role="cp"><primary><literal>multind</literal> package</primary></indexterm>
-<para>The <literal>multind</literal> package supports multiple indexes. See also the
-&tex; FAQ entry on this topic,
-<ulink url="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind</ulink>.
+
+<sect2 label="25.3.1" id="_005cnewglossaryentry">
+<title><literal>\newglossaryentry</literal></title>
+
+<indexterm role="cp"><primary>glossary, entries</primary></indexterm>
+<indexterm role="fn"><primary>\newglossaryentry</primary></indexterm>
+
+<para>Synopsis, one of:
+</para>
+<screen>\newglossaryentry{<replaceable>label</replaceable>}
+{
+ name={<replaceable>name</replaceable>},
+ description={<replaceable>description</replaceable>},
+ <replaceable>other options</replaceable>, ...
+}
+</screen>
+<para>or
+</para>
+<screen>\longnewglossaryentry{<replaceable>label</replaceable>}
+{
+ name={<replaceable>name</replaceable>},
+ <replaceable>other options</replaceable> ...,
+}
+{<replaceable>description</replaceable>}
+</screen>
+<para>Declare a new entry for a glossary. The <replaceable>label</replaceable> must be unique for
+the document. The settings associated with the label are pairs:
+<literal><replaceable>key</replaceable>=<replaceable>value</replaceable></literal>.
+</para>
+<para>This puts the blackboard bold symbol for the real numbers &#x211D; in the
+glossary.
</para>
+<screen>\newglossaryentry{R}
+{
+ name={\ensuremath{\mathbb{R}}},
+ description={the real numbers},
+}
+</screen>
+<para>Use the second command form if the <replaceable>description</replaceable> spans more than one
+paragraph.
+</para>
+<para>For a full list of <replaceable>key</replaceable>s see the package documentation on CTAN but
+here are a few.
+</para>
+<variablelist><varlistentry><term><indexterm role="fn"><primary>name</primary></indexterm><literal>name</literal>
+</term><listitem><para>(Required.) The word, phrase, or symbol that you are defining.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>description</primary></indexterm><literal>description</literal>
+</term><listitem><para>(Required.) The description that will appear in the glossary.
+If this has more than one paragraph then you must use the second command
+form given in the synopsis.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>plural</primary></indexterm><literal>plural</literal>
+</term><listitem><para>The plural form of <replaceable>name</replaceable>. Refer to the plural form using
+<literal>\glspl</literal> or <literal>\Glspl</literal> (see <link linkend="_005cgls">\gls</link>).
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>sort</primary></indexterm><literal>sort</literal>
+</term><listitem><para>How to place this entry in the list of entries that the glossary holds.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>symbol</primary></indexterm><literal>symbol</literal>
+</term><listitem><para>A symbol, such as a mathematical symbol, besides the name.
+</para>
+</listitem></varlistentry></variablelist>
+
+</sect2>
+<sect2 label="25.3.2" id="_005cgls">
+<title><literal>\gls</literal></title>
+<indexterm role="cp"><primary>glossary, entry reference</primary></indexterm>
+<indexterm role="fn"><primary>\gls</primary></indexterm>
+
+<para>Synopsis, one of:
+</para>
+<screen>\gls{<replaceable>label</replaceable>}
+\glspl{<replaceable>label</replaceable>}
+\Gls{<replaceable>label</replaceable>}
+\Glspl{<replaceable>label</replaceable>}
+</screen>
+<para>Refer to a glossary entry. The entries are declared with
+<literal>\newglossaryentry</literal> (see <link linkend="_005cnewglossaryentry">\newglossaryentry</link>).
+</para>
+<para>This
+</para>
+<screen>\newglossaryentry{N}{%
+ name={the natural numbers},
+ description={The numbers $0$, $1$, $2$, $\ldots$\@},
+ symbol={\ensuremath{\mathbb{N}}},
+ }
+ ...
+Consider \gls{N}.
+</screen>
+<para>gives the output &#8216;<literal>Consider the natural numbers</literal>&#8217;.
+</para>
+<para>The second command form <literal>\glspl{<replaceable>label</replaceable>}</literal> produces the plural
+of <replaceable>name</replaceable> (by default it tries adding an &#8216;<literal>s</literal>&#8217;). The third form
+capitalizes the first letter of <replaceable>name</replaceable>, as does the fourth form,
+which also takes the plural.
+</para>
+
+</sect2>
</sect1>
</chapter>
<chapter label="26" id="Letters">
@@ -11617,7 +16048,7 @@ preparing the index.
<para>Synopsis:
</para>
<screen>\documentclass{letter}
-\address{<replaceable>sender address</replaceable>}
+\address{<replaceable>senders address</replaceable>} % return address
\signature{<replaceable>sender name</replaceable>}
\begin{document}
\begin{letter}{<replaceable>recipient address</replaceable>}
@@ -11625,18 +16056,17 @@ preparing the index.
<replaceable>letter body</replaceable>
\closing{<replaceable>closing text</replaceable>}
\end{letter}
-... more letters ...
+ ...
\end{document}
</screen>
<para>Produce one or more letters.
</para>
<para>Each letter is in a separate <literal>letter</literal> environment, whose argument
<replaceable>recipient address</replaceable> often contains multiple lines separated with a
-double backslash&#160;(<literal>\\</literal>). For example, you might have:
+double backslash,&#160;(<literal>\\</literal>). For example, you might have:
</para>
-<screen> \begin{letter}{Mr. Joe Smith \\
- 2345 Princess St. \\
- Edinburgh, EH1 1AA}
+<screen> \begin{letter}{Ninon de l'Enclos \\
+ l'h\^otel Sagonne}
...
\end{letter}
</screen>
@@ -11649,15 +16079,15 @@ preamble. As with the recipient address, often <replaceable>sender address</rep
contains multiple lines separated by a double
backslash&#160;(<literal>\\</literal>). &latex; will put the <replaceable>sender name</replaceable>
under the closing, after a vertical space for the traditional
-hand-written signature; it also can contain multiple lines.
+hand-written signature.
</para>
-<para>Each <literal>letter</literal> environment body begins with a required <literal>\opening</literal> command
-such as <literal>\opening{Dear Madam or Sir:}</literal>. The <replaceable>letter body</replaceable>
-text is ordinary &latex; so it can contain everything from
-enumerated lists to displayed math, except that commands such as
-<literal>\chapter</literal> that make no sense in a letter are turned off. Each
-<literal>letter</literal> environment body typically ends with a <literal>\closing</literal>
-command such as <literal>\closing{Yours,}</literal>.
+<para>Each <literal>letter</literal> environment body begins with a required
+<literal>\opening</literal> command such as <literal>\opening{Dear Madam or Sir:}</literal>.
+The <replaceable>letter body</replaceable> text is ordinary &latex; so it can contain
+everything from enumerated lists to displayed math, except that commands
+such as <literal>\chapter</literal> that make no sense in a letter are turned off.
+Each <literal>letter</literal> environment body typically ends with a
+<literal>\closing</literal> command such as <literal>\closing{Yours,}</literal>.
</para>
<indexterm role="fn"><primary>\\ for letters</primary></indexterm>
<para>Additional material may come after the <literal>\closing</literal>. You can say who
@@ -11665,13 +16095,13 @@ is receiving a copy of the letter with a command like <literal>\cc{the
Boss \\ the Boss's Boss}</literal>. There&#8217;s a similar <literal>\encl</literal> command for
a list of enclosures. And, you can add a postscript with <literal>\ps</literal>.
</para>
-<para>&latex;&#8217;s default is to indent the signature and the <literal>\closing</literal>
-above it by a length of <literal>\longindentation</literal>. By default this is
+<para>&latex;&#8217;s default is to indent the sender name and the closing above it
+by a length of <literal>\longindentation</literal>. By default this is
<literal>0.5\textwidth</literal>. To make them flush left, put
<literal>\setlength{\longindentation}{0em}</literal> in your preamble.
</para>
<para>To set a fixed date use something like
-<literal>\renewcommand{\today}{2015-Oct-12}</literal>. If put in your preamble
+<literal>\renewcommand{\today}{1958-Oct-12}</literal>. If put in your preamble
then it will apply to all the letters.
</para>
<para>This example shows only one <literal>letter</literal> environment. The three lines
@@ -11704,19 +16134,18 @@ I am not interested in entering a business arrangement with you.
</para>
<screen>\address{<replaceable>senders address</replaceable>}
</screen>
-<para>Specifies the return address as it appears on the letter and on the
+<para>Specify the return address, as it appears on the letter and on the
envelope. Separate multiple lines in <replaceable>senders address</replaceable> with a
-double backslash&#160;<literal>\\</literal>.
+double backslash,&#160;<literal>\\</literal>.
</para>
<para>Because it can apply to multiple letters this declaration is often put
in the preamble. However, it can go anywhere, including inside an
individual <literal>letter</literal> environment.
</para>
-<para>This command is optional: without the <literal>\address</literal> declaration the
-letter is formatted with some blank space on top, for copying onto
-pre-printed letterhead paper. (See <link linkend="Overview">Overview</link>, for details on your
-local implementation.) With the <literal>\address</literal> declaration, it is
-formatted as a personal letter.
+<para>This command is optional: if you do not use it then the letter is
+formatted with some blank space on top, for copying onto pre-printed
+letterhead paper. If you do use the <literal>\address</literal> declaration then it
+is formatted as a personal letter.
</para>
<para>Here is an example.
</para>
@@ -11733,13 +16162,13 @@ formatted as a personal letter.
<para>Synopsis:
</para>
-<screen>\cc{<replaceable>first name</replaceable> \\
+<screen>\cc{<replaceable>name0</replaceable> \\
... }
</screen>
<para>Produce a list of names to which copies of the letter were sent. This
command is optional. If it appears then typically it comes after
-<literal>\closing</literal>. Separate multiple lines with a double
-backslash&#160;<literal>\\</literal>, as in:
+<literal>\closing</literal>. Put the names on different lines by separating them
+with a double backslash, <literal>\\</literal>, as in:
</para>
<screen>\cc{President \\
Vice President}
@@ -11757,8 +16186,8 @@ backslash&#160;<literal>\\</literal>, as in:
</para>
<screen>\closing{<replaceable>text</replaceable>}
</screen>
-<para>Usually at the end of a letter, above the handwritten signature, there
-is a <literal>\closing</literal> (although this command is optional). For example,
+<para>Produce the letter&#8217;s closing. This is optional, but usual. It appears
+at the end of a letter, above a handwritten signature. For example:
</para>
<screen>\closing{Regards,}
</screen>
@@ -11777,10 +16206,10 @@ is a <literal>\closing</literal> (although this command is optional). For examp
</screen>
<para>Produce a list of things included with the letter. This command is
optional; when it is used, it typically is put after <literal>\closing</literal>.
-Separate multiple lines with a double backslash&#160;<literal>\\</literal>.
+Separate multiple lines with a double backslash, <literal>\\</literal>.
</para>
<screen>\encl{License \\
- Passport }
+ Passport}
</screen>
</sect1>
@@ -11793,7 +16222,7 @@ Separate multiple lines with a double backslash&#160;<literal>\\</literal>.
</para>
<screen>\location{<replaceable>text</replaceable>}
</screen>
-<para>The <replaceable>text</replaceable> appears centered at the bottom of the each page. It only
+<para>The <replaceable>text</replaceable> appears centered at the bottom of the page. It only
appears if the page style is <literal>firstpage</literal>.
</para>
@@ -11805,25 +16234,62 @@ appears if the page style is <literal>firstpage</literal>.
<para>Synopsis:
</para>
-<screen>\makelabels
+<screen>\makelabels % in preamble
</screen>
-<para>Create a sheet of address labels from the recipient addresses, one for
-each letter. This sheet will be output before the letters, with the idea
-that you can copy it to a sheet of peel-off labels. This command goes
-in the preamble.
+<para>Optional, for a document that contains <literal>letter</literal> environments. If
+you just put <literal>\makelabels</literal> in the preamble then at the end of the
+document you will get a sheet with labels for all the recipients, one
+for each letter environment, that you can copy to a sheet of peel-off
+address labels.
</para>
<para>Customize the labels by redefining the commands <literal>\startlabels</literal>,
-<literal>\mlabel</literal>, and <literal>\returnaddress</literal> in the preamble. The command
-<literal>\startlabels</literal> sets the width, height, number of columns, etc., of
-the page onto which the labels are printed. The command
-<literal>\mlabel{<replaceable>sender address</replaceable>}{<replaceable>recipient address</replaceable>}</literal>
-produces the two labels (or one, if you choose to ignore the <replaceable>sender
-address</replaceable>). The <replaceable>sender address</replaceable> is the value returned by the macro
-<literal>\returnaddress</literal> while <replaceable>recipient address</replaceable> is the value passed
-in the argument to the <literal>letter</literal> environment. By default
-<literal>\mlabel</literal> ignores the first argument, the <replaceable>sender address</replaceable>.
+<literal>\mlabel</literal>, and <literal>\returnaddress</literal> (and perhaps <literal>\name</literal>) in
+the preamble. The command <literal>\startlabels</literal> sets the width, height,
+number of columns, etc., of the page onto which the labels are printed.
+The command <literal>\mlabel{<replaceable>return address</replaceable>}{<replaceable>recipient
+address</replaceable>}</literal> produces the two labels (or one, if you choose to ignore the
+<replaceable>return address</replaceable>) for each letter environment. The first argument,
+<replaceable>return address</replaceable>, is the value returned by the macro
+<literal>\returnaddress</literal>. The second argument, <replaceable>recipient address</replaceable>, is
+the value passed in the argument to the <literal>letter</literal> environment. By
+default <literal>\mlabel</literal> ignores the first argument, the <replaceable>return
+address</replaceable>, causing the default behavior described in the prior paragraph.
+</para>
+<para>This illustrates customization. Its output includes a page with two
+columns having two labels each.
+</para>
+<screen>\documentclass{letter}
+\renewcommand*{\returnaddress}{Fred McGuilicuddy \\
+ Oshkosh, Mineola 12305}
+\newcommand*\originalMlabel{}
+\let\originalMlabel\mlabel
+\def\mlabel#1#2{\originalMlabel{}{#1}\originalMlabel{}{#2}}
+\makelabels
+ ...
+\begin{document}
+\begin{letter}{A Einstein \\
+ 112 Mercer Street \\
+ Princeton, New Jersey, USA 08540}
+ ...
+\end{letter}
+\begin{letter}{K G\&quot;odel \\
+ 145 Linden Lane \\
+ Princeton, New Jersey, USA 08540}
+ ...
+\end{letter}
+\end{document}
+</screen>
+<para>The first column contains the return address twice. The second column
+contains the address for each recipient.
+</para>
+<indexterm role="cp"><primary>package, <literal>envlab</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>envlab</literal> package</primary></indexterm>
+
+<para>The package <literal>envlab</literal> makes formatting the labels easier, with
+standard sizes already provided. The preamble lines
+<literal>\usepackage[personalenvelope]{envlab}</literal> and <literal>\makelabels</literal>
+are all that you need to print envelopes.
</para>
-<!-- xxx TODO, align on latex2e-fr.texi, see https://mail.gna.org/public/latexrefman-discuss/2015-10/msg00000.html -->
</sect1>
<sect1 label="26.7" id="_005cname">
@@ -11835,8 +16301,8 @@ in the argument to the <literal>letter</literal> environment. By default
</para>
<screen>\name{<replaceable>name</replaceable>}
</screen>
-<para>Sender&#8217;s name, used for printing on the envelope together with the
-return address.
+<para>Optional. Sender&#8217;s name, used for printing on the envelope together
+with the return address.
</para>
</sect1>
@@ -11848,11 +16314,10 @@ return address.
<para>Synopsis:
</para>
-<screen>\opening{<replaceable>text</replaceable>}
+<screen>\opening{<replaceable>salutation</replaceable>}
</screen>
-<para>This command is required. It starts a letter, following the
-<literal>\begin{letter}{...}</literal>. The mandatory argument <replaceable>text</replaceable> is the
-text that starts your letter. For instance:
+<para>Required. Follows the <literal>\begin{letter}{...}</literal>. The argument
+<replaceable>salutation</replaceable> is mandatory. For instance:
</para>
<screen>\opening{Dear John:}
</screen>
@@ -11887,26 +16352,31 @@ text that starts your letter. For instance:
<para>The sender&#8217;s name. This command is optional, although its inclusion is
usual.
</para>
-<para>The argument text appears at the end of the letter, after the closing
-and after a vertical space for the traditional hand-written
+<para>The argument text appears at the end of the letter, after the closing.
+&latex; leaves some vertical space for a handwritten
signature. Separate multiple lines with a double
-backslash&#160;<literal>\\</literal>. For example:
+backslash,&#160;<literal>\\</literal>. For example:
</para>
<screen>\signature{J Fred Muggs \\
White House}
</screen>
<para>&latex;&#8217;s default for the vertical space from the <literal>\closing</literal> text
down to the <literal>\signature</literal> text is <literal>6\medskipamount</literal>, which is
-six times 0.7em.
+six times <literal>\medskipamount</literal> (where <literal>\medskipamount</literal> is equal to
+a <literal>\parskip</literal>, which in turn is defined by default here to
+0.7em).
</para>
<para>This command is usually in the preamble, to apply to all the letters in
the document. To have it apply to one letter only, put it inside a
<literal>letter</literal> environment and before the <literal>\closing</literal>.
</para>
-<para>You can include a graphic in the signature, for instance with
-<literal>\signature{\vspace{-6\medskipamount}\includegraphics{sig.png}\\
-My name}</literal> (this requires writing <literal>\usepackage{graphicx}</literal> in the
-preamble).
+<para>You can include a graphic in the signature as here.
+</para>
+<screen>\signature{\vspace{-6\medskipamount}\includegraphics{sig.png}\\
+ My name}
+</screen>
+<para>For this you must put <literal>\usepackage{graphicx}</literal> in the preamble
+(see <link linkend="Graphics">Graphics</link>).
</para>
<!-- I think this is not a user-level command; it is used to keep from breaking -->
@@ -11954,26 +16424,56 @@ page.
<sect1 label="27.1" id="_005ctypein">
-<title><literal>\typein[<replaceable>cmd</replaceable>]{<replaceable>msg</replaceable>}</literal></title>
+<title><literal>\typein</literal></title>
<indexterm role="fn"><primary>\typein</primary></indexterm>
-<para>Synopsis:
+<para>Synopsis, one of:
+</para>
+<screen>\typein{<replaceable>prompt-msg</replaceable>}
+\typein[<replaceable>cmd</replaceable>]{<replaceable>prompt-msg</replaceable>}
+</screen>
+<para>Print <replaceable>prompt-msg</replaceable> on the terminal and cause &latex; to stop and
+wait for you to type a line of input. This line of input ends when you
+hit the return key.
+</para>
+<para>For example, this
+</para>
+<screen>As long as I live I shall never forget \typein{Enter student name:}
+</screen>
+<para>coupled with this command line interaction
+</para>
+<screen>Enter student name:
+
+\@typein=Aphra Behn
+</screen>
+<para>gives the output &#8216;<literal>... never forget Aphra Behn</literal>&#8217;.
</para>
-<screen>\typein[\<replaceable>cmd</replaceable>]{<replaceable>msg</replaceable>}
+<para>The first command version, <literal>\typein{<replaceable>prompt-msg</replaceable>}</literal>, causes
+the input you typed to be processed as if it had been included in the
+input file in place of the <literal>\typein</literal> command.
+</para>
+<para>In the second command version the optional argument <literal><replaceable>cmd</replaceable></literal>
+argument must be a command name &#8212; it must begin with a backslash, \.
+This command name is then defined or redefined to be the input that you
+typed. For example, this
+</para>
+<screen>\typein[\student]{Enter student name:}
+\typeout{Recommendation for \student .}
+</screen>
+<para>gives this output on the command line,
+</para>
+<screen>Enter student name:
+
+\student=John Dee
+Recommendation for John Dee.
</screen>
-<para><literal>\typein</literal> prints <replaceable>msg</replaceable> on the terminal and causes &latex; to
-stop and wait for you to type a line of input, ending with return. If
-the optional <literal>\<replaceable>cmd</replaceable></literal> argument is omitted, the typed input is
-processed as if it had been included in the input file in place of the
-<literal>\typein</literal> command. If the <literal>\<replaceable>cmd</replaceable></literal> argument is present, it
-must be a command name. This command name is then defined or
-redefined to be the typed input.
+<para>where the user has entered &#8216;<literal>John Dee.</literal>&#8217;
</para>
</sect1>
<sect1 label="27.2" id="_005ctypeout">
-<title><literal>\typeout{<replaceable>msg</replaceable>}</literal></title>
+<title><literal>\typeout</literal></title>
<indexterm role="fn"><primary>\typeout</primary></indexterm>
@@ -11981,16 +16481,31 @@ redefined to be the typed input.
</para>
<screen>\typeout{<replaceable>msg</replaceable>}
</screen>
-<para>Prints <literal>msg</literal> on the terminal and in the <literal>log</literal> file.
-Commands in <literal>msg</literal> that are defined with <literal>\newcommand</literal> or
+<para>Print <literal>msg</literal> on the terminal and in the <literal>log</literal> file.
+</para>
+<para>This
+</para>
+<screen>\newcommand{\student}{John Dee}
+\typeout{Recommendation for \student .}
+</screen>
+<para>outputs &#8216;<literal>Recommendation for John Dee</literal>&#8217;. Like what happens here with
+<literal>\student</literal>, commands that are defined with <literal>\newcommand</literal> or
<literal>\renewcommand</literal> (among others) are replaced by their definitions
before being printed.
</para>
<para>&latex;&#8217;s usual rules for treating multiple spaces as a single space
-and ignoring spaces after a command name apply to <literal>msg</literal>. A
-<literal>\space</literal> command in <literal>msg</literal> causes a single space to be
-printed, independent of surrounding spaces. A <literal>^^J</literal> in
-<literal>msg</literal> prints a newline.
+and ignoring spaces after a command name apply to <literal>msg</literal>. As above,
+use the command <literal>\space</literal> to get a single space, independent of
+surrounding spaces. Use <literal>^^J</literal> to get a newline. Get a percent
+character with <literal>\csname @percentchar\endcsname</literal>.
+</para>
+<para>This command can be useful for simple debugging, as here:
+</para>
+<screen>\newlength{\jhlength}
+\setlength{\jhlength}{5pt}
+\typeout{The length is \the\jhlength.}
+</screen>
+<para>produces on the command line &#8216;<literal>The length is 5.0pt</literal>&#8217;.
</para>
</sect1>
@@ -12000,31 +16515,257 @@ printed, independent of surrounding spaces. A <literal>^^J</literal> in
<indexterm role="cp"><primary>command line</primary></indexterm>
-<indexterm role="fn"><primary>.tex, default extension</primary></indexterm>
-<para>The input file specification indicates the file to be formatted;
-&tex; uses <filename>.tex</filename> as a default file extension. If you omit the
-input file entirely, &tex; accepts input from the terminal. You can
-also specify arbitrary &latex; input by starting with a backslash.
-For example, this processes <filename>foo.tex</filename> without pausing after every
-error:
+<para>Synopsis (from a terminal command line):
+</para>
+<screen>pdflatex <replaceable>options</replaceable> <replaceable>argument</replaceable>
+</screen>
+<para>Run &latex; on <replaceable>argument</replaceable>. In place of <command>pdflatex</command> you can
+also use <command>xelatex</command>, or <literal>lualatex</literal>, or <literal>dviluatex</literal>, or
+<literal>latex</literal>.
+</para>
+<para>For example, this will run &latex; on the file <filename>thesis.tex</filename>,
+creating the output <filename>thesis.pdf</filename>.
</para>
-<screen>latex '\nonstopmode\input foo.tex'
+<screen>pdflatex thesis
</screen>
+<para><indexterm role="fn"><primary>.tex, default extension</primary></indexterm>
+Note that <filename>.tex</filename> is the default file extension.
+</para>
+<para>pdf&tex; is a development of the original &tex; program, as are
+Xe&tex; and Lua&tex; (see <link linkend="TeX-engines">&tex; engines</link>). They are completely
+backward compatible. But the original program had a custom output
+format, DVI, while the newer ones can output directly to PDF. This
+allows them to take advantage of the extra features in PDF such as
+hyperlinks, support for modern image formats such as JPG and PNG, and
+ubiquitous viewing programs. In short, if you run <command>pdflatex</command> or
+<command>xelatex</command> or <command>lualatex</command> then you will by default get PDF
+and have access to all its modern features. If you run <command>latex</command>,
+or <literal>dvilualatex</literal>, then you will get DVI. The description here
+assumes pdf&latex;.
+</para>
+<para>See <link linkend="Command-line-options">Command line options</link>, for a selection of the most useful
+command line options. As to <replaceable>argument</replaceable>, the usual case is that it
+does not begin with a backslash, so the system takes it to be the name
+of a file and it compiles that file. If <replaceable>argument</replaceable> begins with a
+backslash then the system will interpret it as a line of &latex;
+input, which can be used for special effects (see <link linkend="Command-line-input">Command line
+input</link>).
+</para>
+<para>If you gave no arguments or options then <command>pdflatex</command> prompts for
+input from the terminal. You can escape from this by entering
+<literal>&lt;control&gt;-D</literal>.
+</para>
+<para>If &latex; finds an error in your document then by default it stops and
+asks you about it. See <link linkend="Recovering-from-errors">Recovering from errors</link> for an outline of what
+to do.
+</para>
+
+
+<sect1 label="28.1" id="Command-line-options">
+<title>Command line options</title>
+
+<indexterm role="cp"><primary>options, command line</primary></indexterm>
+
+<para>These are the command-line options relevant to ordinary document
+authoring. For a full list, try running &#8216;<literal>latex --help</literal>&#8217; from the
+command line.
+</para>
+<para>With many implementations you can specify command line options by
+prefixing them with &#8216;<literal>-</literal>&#8217; or &#8216;<literal>--</literal>&#8217;. This is the case for
+both &tex; Live (and Mac&tex;) and MiK&tex;. We will use both
+conventions interchangeably.
+</para>
+<variablelist><indexterm role="fn"><primary>--version command-line option</primary></indexterm>
+<varlistentry><term><literal>-version</literal>
+</term><listitem><para>Show the current version, like &#8216;<literal>pdfTeX 3.14159265-2.6-1.40.16 (TeX
+Live 2015/Debian)</literal>&#8217; along with a small amount of additional information,
+and exit.
+</para>
<indexterm role="fn"><primary>--help command-line option</primary></indexterm>
-<para>With many, but not all, implementations, command-line options can also
-be specified in the usual Unix way, starting with &#8216;<literal>-</literal>&#8217; or
-&#8216;<literal>--</literal>&#8217;. For a list of those options, try &#8216;<literal>latex --help</literal>&#8217;.
+</listitem></varlistentry><varlistentry><term><literal>-help</literal>
+</term><listitem><para>Give a brief usage message that is useful as a prompt and exit.
+</para>
+<indexterm role="fn"><primary>--interaction command-line option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>-interaction=<replaceable>mode</replaceable></literal>
+</term><listitem><para>&tex; compiles a document in one of four interaction modes:
+<literal>batchmode</literal>, <literal>nonstopmode</literal>, <literal>scrollmode</literal>,
+<literal>errorstopmode</literal>. In <firstterm>errorstop mode</firstterm> (the default), &tex;
+stops at each error and asks for user intervention. In <firstterm>batch
+mode</firstterm> it prints nothing on the terminal, errors are scrolled as if the
+user hit <literal>&lt;return&gt;</literal> at every error, and missing files cause the
+job to abort. In <firstterm>nonstop mode</firstterm>, diagnostic message appear on the
+terminal but as in batch mode there is no user interaction. In
+<firstterm>scroll mode</firstterm>, &tex; only stops for missing files or keyboard
+input.
+</para>
+<para>For instance, starting &latex; with this command line
+</para>
+<screen>pdflatex -interaction=batchmode <replaceable>filename</replaceable>
+</screen>
+<para>eliminates most terminal output.
+</para>
+<indexterm role="fn"><primary>--jobname command-line option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>-jobname=<replaceable>string</replaceable></literal>
+</term><listitem><para>Set the value of &tex;&#8217;s <literal>jobname</literal> to the string. The log file
+and output file will then be named <filename><replaceable>string</replaceable>.log</filename> and
+<filename><replaceable>string</replaceable>.pdf</filename>.
+</para>
+<para>When you run <literal><command>pdflatex</command> <replaceable>options</replaceable> <replaceable>argument</replaceable></literal>, if
+<replaceable>argument</replaceable> does not start with a backslash then &tex; considers it
+the name of a file to input. Otherwise it waits for the first
+<literal>\input</literal> instruction and the name of the input file will be the job
+name. This is used to name the log file the output file. This option
+overrides that process and directly specifies the name. See <link linkend="Command-line-input">Command
+line input</link> for an example of its use.
+</para>
+<indexterm role="fn"><primary>--output-directory command-line option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>-output-directory=<replaceable>directory</replaceable></literal>
+</term><listitem><para>Write files in the directory <replaceable>directory</replaceable>. It must already exist.
+</para>
+<indexterm role="fn"><primary>--shell-escape command-line option</primary></indexterm>
+<indexterm role="fn"><primary>--no-shell-escape command-line option</primary></indexterm>
+<indexterm role="fn"><primary>--enable-write18 command-line option</primary></indexterm>
+<indexterm role="fn"><primary>--disable-write18 command-line option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>shell-escape</literal>
+</term><term><literal>no-shell-escape</literal>
+</term><term><literal>enable-write18</literal>
+</term><term><literal>disable-write18</literal>
+</term><listitem><para>Enable or disable <literal>\write18{<replaceable>shell command</replaceable>}</literal>. The first two
+options are for with &tex; Live or Mac&tex; while the second two are
+for MiK&tex;.
+</para>
+<indexterm role="cp"><primary>package, <literal>sagetex</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>sagetex</literal> package</primary></indexterm>
+
+<para>Sometimes you want to run external system commands from inside a
+&latex; file. For instance the package <filename>sagetex</filename> allows you to
+have the mathematics software system <emphasis>Sage</emphasis> do calculations or draw
+graphs and then incorporate that output in your document. For this
+&tex; provides the <literal>\write18</literal> command.
+</para>
+<para>But with this functionality enabled, security issues could happen if you
+compiled a &latex; file from the Internet. By default <literal>\write18</literal>
+is disabled. (More precisely, by default &tex; Live, Mac&tex;, and
+MiK&tex; only allow the execution of a limited number of &tex;-related
+programs, which they distribute.)
+</para>
+<para>If you invoke &latex; with the option <literal>no-shell-escape</literal>, and in
+your document you call <literal>\write18{ls -l}</literal>, then you do not get an
+error but the log file says &#8216;<literal>runsystem(ls -l)...disabled</literal>&#8217;.
+</para>
+<indexterm role="fn"><primary>--halt-on-error command-line option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>-halt-on-error</literal>
+</term><listitem><para>Stop processing at the first error.
+</para>
+<indexterm role="fn"><primary>--file-line-error command-line option</primary></indexterm>
+<indexterm role="fn"><primary>--no-file-line-error command-line option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>-file-line-error</literal>
+</term></varlistentry><varlistentry><term><literal>-no-file-line-error</literal>
+</term><listitem><para>Enable or disable <literal><replaceable>filename</replaceable>:<replaceable>lineno</replaceable>:<replaceable>error</replaceable></literal>-style
+error messages. These are only available with &tex; Live or Mac&tex;.
+</para></listitem></varlistentry></variablelist>
+
+</sect1>
+<sect1 label="28.2" id="Command-line-input">
+<title>Command line input</title>
+
+<indexterm role="cp"><primary>input, on command line</primary></indexterm>
+
+<para>As part of the command line invocation <literal>pdflatex <replaceable>options</replaceable>
+<replaceable>argument</replaceable></literal> you can specify arbitrary &latex; input by starting
+<replaceable>argument</replaceable> with a backslash. This allows you to do some special
+effects.
+</para>
+<indexterm role="cp"><primary>package, <literal>hyperref</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>hyperref</literal> package</primary></indexterm>
+
+<para>For example, this file (which uses the <filename>hyperref</filename> package for
+hyperlinks) can produce two kinds of output, one for paper and one for a
+PDF.
+</para>
+<screen>\ifdefined\paperversion % in preamble
+\newcommand{\urlcolor}{black}
+\else
+\newcommand{\urlcolor}{blue}
+\fi
+\usepackage[colorlinks=true,urlcolor=\urlcolor]{hyperref}
+ ...
+\href{https://www.ctan.org}{CTAN} % in body
+ ...
+</screen>
+<para>Compiling this document <filename>book.tex</filename> with the command line
+<literal>pdflatex test</literal> will give the &#8216;<literal>CTAN</literal>&#8217; link in blue. But
+compiling it with <literal>pdflatex &quot;\def\paperversion{}\input test.tex&quot;</literal>
+has the link in black. (Note the use of double quotes to prevent
+interpretation of the symbols by the command line shell; your system may
+do this differently.)
+</para>
+<para>In a similar way, from the single file <filename>main.tex</filename> you can compile
+two different versions.
+</para>
+<!-- credit Paul Gaborit: https://tex.stackexchange.com/a/220101/121234 -->
+<screen>pdflatex -jobname=students &quot;\def\student{}\input{main}&quot;
+pdflatex -jobname=teachers &quot;\def\teachers{}\input{main}&quot;
+</screen>
+<para>The <literal>jobname</literal> option is there because otherwise both files would be
+called <filename>main.pdf</filename> and the second would overwrite the first.
+</para>
+<para>A final example. This loads the package <filename>graphicx</filename> with the option
+<literal>draft</literal>
+</para>
+<!-- credit Herbert Voss: https://tex.stackexchange.com/a/17236/121234 -->
+<screen>pdflatex -jobname=aa &quot;\RequirePackage[draft]{graphicx}\input{aa.tex}&quot;
+</screen>
+<para>so the graphic files are read for their size information but not
+incorporated into the PDF. (The <literal>jobname</literal> option is needed because
+otherwise the output file would be <filename>graphicx.pdf</filename>, as
+<literal>\RequirePackage</literal> does an <literal>\input</literal> of its own.)
+</para>
+
+</sect1>
+<sect1 label="28.3" id="Recovering-from-errors">
+<title>Recovering from errors</title>
+
+<para>If &latex; finds an error in your document then it gives you an error
+message and prompts you with a question mark, <literal>?</literal>. For instance,
+running &latex; on this file
+</para>
+<screen>\newcommand{\NP}{\ensuremath{\textbf{NP}}}
+The \PN{} problem is a million dollar one.
+</screen>
+<para>causes it show this, and wait for input.
+</para>
+<screen>! Undefined control sequence.
+l.5 The \PN
+ {} problem is a million dollar one.
+?
+</screen>
+<para>The simplest thing is to enter &#8216;<literal>x</literal>&#8217; and <literal>&lt;return&gt;</literal> and fix the
+typo. You could instead enter &#8216;<literal>?</literal>&#8217; and <literal>&lt;return&gt;</literal> to see other
+options.
</para>
<indexterm role="cp"><primary>&#8216;<literal>*</literal>&#8217; prompt</primary></indexterm>
<indexterm role="cp"><primary>prompt, &#8216;<literal>*</literal>&#8217;</primary></indexterm>
<indexterm role="fn"><primary>\stop</primary></indexterm>
-<para>If &latex; stops in the middle of the document and gives you a
-&#8216;<literal>*</literal>&#8217; prompt, it is waiting for input. You can type <literal>\stop</literal>
-(and return) and it will prematurely end the document.
+<para>There are two other error scenarios. The first is that you forgot to
+include the <literal>\end{document}</literal> or misspelled it. In this case
+&latex; gives you a &#8216;<literal>*</literal>&#8217; prompt. You can get back to the command
+line by typing <literal>\stop</literal> and <literal>&lt;return&gt;</literal>.
+</para>
+<para>The last scenario is that you mistyped the file name. For instance,
+instead of <literal>pdflatex test</literal> you might type <literal>pdflatex tste</literal>.
</para>
-<para>See <link linkend="TeX-engines">&tex; engines</link>, for other system commands invoking &latex;.
+<screen>! I can't find file `tste'.
+&lt;*&gt; tste
+
+(Press Enter to retry, or Control-D to exit)
+Please type another input file name:
+</screen>
+<para>The simplest thing is to enter <literal>&lt;Contol&gt;</literal> and &#8216;<literal>d</literal>&#8217; (holding
+them down at the same time), and just fix the command line.
</para>
+</sect1>
</chapter>
<appendix label="A" id="Document-templates">
<title>Document templates</title>
@@ -12074,11 +16815,38 @@ array of features, but here is a basic template:
</para>
</sect1>
-<sect1 label="A.2" id="book-template">
+<sect1 label="A.2" id="article-template">
+<title><literal>article</literal> template</title>
+
+<indexterm role="cp"><primary>template, <literal>article</literal></primary></indexterm>
+
+<screen>\documentclass{article}
+\title{Article Class Template}
+\author{Alex Author}
+
+\begin{document}
+\maketitle
+
+\section{First section}
+Some text.
+
+\subsection{First section, first subsection}
+Additional text.
+
+\section{Second section}
+Some more text.
+\end{document}
+</screen>
+
+</sect1>
+<sect1 label="A.3" id="book-template">
<title><literal>book</literal> template</title>
<indexterm role="cp"><primary>template, <literal>book</literal></primary></indexterm>
+<para>This is a straightforward template for a book. See See <link linkend="Larger-book-template">Larger book
+template</link> for a more elaborate one.
+</para>
<screen>\documentclass{book}
\title{Book Class Template}
\author{Alex Author}
@@ -12098,7 +16866,62 @@ The end.
</screen>
</sect1>
-<sect1 label="A.3" id="tugboat-template">
+<sect1 label="A.4" id="Larger-book-template">
+<title>Larger <literal>book</literal> template</title>
+
+<indexterm role="cp"><primary>template, <literal>book</literal></primary></indexterm>
+
+<para>This is a more elaborate template for a book. It has
+<literal>\frontmatter</literal>, <literal>\mainmatter</literal>, and <literal>\backmatter</literal> to
+control the typography of the three main areas of a book
+(see <link linkend="_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter &amp; \mainmatter &amp; \backmatter</link>). The book has a
+bibliography and an index.
+</para>
+<para>Notable is that it uses <literal>\include</literal> and <literal>\includeonly</literal>
+(see <link linkend="Splitting-the-input">Splitting the input</link>). While you are working on a chapter you
+can comment out all the other chapter entries from the argument to
+<literal>\includeonly</literal>. That will speed up compilation without losing any
+information such as cross-references. (Material that does not need to
+come on a new page is brought in with <literal>\input</literal> instead of
+<literal>\include</literal>. You don&#8217;t get the cross-reference benefit this way.)
+</para>
+<screen>\documentclass[titlepage]{book}
+\usepackage{makeidx}\makeindex
+
+\title{Book Class Template}
+\author{Alex Author}
+
+\includeonly{%
+ frontcover,
+ preface,
+ chap1,
+ ...
+ }
+\begin{document}
+\frontmatter
+\include{frontcover}
+ % maybe comment out while drafting:
+\maketitle \input{dedication} \input{copyright}
+\tableofcontents
+\include{preface}
+\mainmatter
+\include{chap1}
+...
+\appendix
+\include{appena}
+...
+\backmatter
+\bibliographystyle{apalike}
+\addcontentsline{toc}{chapter}{Bibliography}
+\bibliography
+\addcontentsline{toc}{chapter}{Index}
+\printindex
+\include{backcover}
+\end{document}
+</screen>
+
+</sect1>
+<sect1 label="A.5" id="tugboat-template">
<title><literal>tugboat</literal> template</title>
<indexterm role="cp"><primary>template, TUGboat</primary></indexterm>
@@ -12191,17 +17014,12 @@ Email \verb|tugboat@tug.org| if problems or questions.
</sect1>
</appendix>
-<chapter label="" id="Concept-Index">
-<title>Concept Index</title>
+<chapter label="" id="Index">
+<title>Index</title>
+<!-- Keep `Command Index' working for ltx-help.el. -->
+<anchor id="Command-Index"/>
<index role="cp"></index>
-<!-- The name of the `Command Index' node must NOT be altered for ltx-help.el. -->
-</chapter>
-<chapter label="" id="Command-Index">
-<title>Command Index</title>
-
-<index role="fn"></index>
-
</chapter>
</book>
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.html b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.html
index 149b8b35ac7..9b0efda6d50 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.html
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.html
@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This document is an unofficial reference manual for LaTeX, a
-document preparation system, version of March 2018.
+document preparation system, version of July 2018.
This manual was originally translated from LATEX.HLP v1.0a in
the VMS Help Library. The pre-translation version was written by
@@ -37,15 +37,15 @@ into another language, under the above conditions for modified versions. -->
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<title>LaTeX2e unofficial reference manual (March 2018)</title>
+<title>LaTeX2e unofficial reference manual (July 2018)</title>
-<meta name="description" content="LaTeX2e unofficial reference manual (March 2018)">
-<meta name="keywords" content="LaTeX2e unofficial reference manual (March 2018)">
+<meta name="description" content="LaTeX2e unofficial reference manual (July 2018)">
+<meta name="keywords" content="LaTeX2e unofficial reference manual (July 2018)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="#Top" rel="start" title="Top">
-<link href="#Concept-Index" rel="index" title="Concept Index">
+<link href="#Index" rel="index" title="Index">
<link href="#SEC_Contents" rel="contents" title="Table of Contents">
<link href="http://tug.org/texinfohtml/" rel="up" title="(dir)">
<style type="text/css">
@@ -81,7 +81,7 @@ code {font-style: normal; font-family: monospace}
</head>
<body lang="en">
-<h1 class="settitle" align="center">LaTeX2e unofficial reference manual (March 2018)</h1>
+<h1 class="settitle" align="center">LaTeX2e unofficial reference manual (July 2018)</h1>
@@ -90,6 +90,7 @@ code {font-style: normal; font-family: monospace}
+
<a name="SEC_Overview"></a>
<h2 class="shortcontents-heading">Short Table of Contents</h2>
@@ -124,8 +125,7 @@ code {font-style: normal; font-family: monospace}
<li><a name="stoc-Terminal-input_002foutput-1" href="#toc-Terminal-input_002foutput-1">27 Terminal input/output</a></li>
<li><a name="stoc-Command-line-1" href="#toc-Command-line-1">28 Command line</a></li>
<li><a name="stoc-Document-templates-1" href="#toc-Document-templates-1">Appendix A Document templates</a></li>
-<li><a name="stoc-Concept-Index-1" href="#toc-Concept-Index-1">Concept Index</a></li>
-<li><a name="stoc-Command-Index-1" href="#toc-Command-Index-1">Command Index</a></li>
+<li><a name="stoc-Index-1" href="#toc-Index-1">Index</a></li>
</ul>
</div>
@@ -145,11 +145,12 @@ code {font-style: normal; font-family: monospace}
<ul class="no-bullet">
<li><a name="toc-Environments-1" href="#Environment">2.4.1 Environments</a></li>
<li><a name="toc-Command-declarations" href="#Declaration">2.4.2 Command declarations</a></li>
- <li><a name="toc-_005cmakeatletter-and-_005cmakeatother-1" href="#g_t_005cmakeatletter-and-_005cmakeatother">2.4.3 <code>\makeatletter</code> and <code>\makeatother</code></a>
+ <li><a name="toc-_005cmakeatletter-_0026-_005cmakeatother-1" href="#g_t_005cmakeatletter-_0026-_005cmakeatother">2.4.3 <code>\makeatletter</code> &amp; <code>\makeatother</code></a>
<ul class="no-bullet">
<li><a name="toc-_005c_0040ifstar-1" href="#g_t_005c_0040ifstar">2.4.3.1 <code>\@ifstar</code></a></li>
</ul></li>
</ul></li>
+ <li><a name="toc-CTAN_003a-Comprehensive-TeX-Archive-Network" href="#CTAN">2.5 CTAN: Comprehensive TeX Archive Network</a></li>
</ul></li>
<li><a name="toc-Document-classes-1" href="#Document-classes">3 Document classes</a>
<ul class="no-bullet">
@@ -178,13 +179,20 @@ code {font-style: normal; font-family: monospace}
</ul></li>
<li><a name="toc-Sectioning-1" href="#Sectioning">6 Sectioning</a>
<ul class="no-bullet">
- <li><a name="toc-_005c_0040startsection-1" href="#g_t_005c_0040startsection">6.1 <code>\@startsection</code></a></li>
+ <li><a name="toc-_005cpart-1" href="#g_t_005cpart">6.1 <code>\part</code></a></li>
+ <li><a name="toc-_005cchapter-1" href="#g_t_005cchapter">6.2 <code>\chapter</code></a></li>
+ <li><a name="toc-_005csection-1" href="#g_t_005csection">6.3 <code>\section</code></a></li>
+ <li><a name="toc-_005csubsection-1" href="#g_t_005csubsection">6.4 <code>\subsection</code></a></li>
+ <li><a name="toc-_005csubsubsection_002c-_005cparagraph_002c-_005csubparagraph" href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">6.5 <code>\subsubsection</code>, <code>\paragraph</code>, <code>\subparagraph</code></a></li>
+ <li><a name="toc-_005cappendix-1" href="#g_t_005cappendix">6.6 <code>\appendix</code></a></li>
+ <li><a name="toc-_005cfrontmatter_002c-_005cmainmatter_002c-_005cbackmatter" href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">6.7 <code>\frontmatter</code>, <code>\mainmatter</code>, <code>\backmatter</code></a></li>
+ <li><a name="toc-_005c_0040startsection-1" href="#g_t_005c_0040startsection">6.8 <code>\@startsection</code></a></li>
</ul></li>
<li><a name="toc-Cross-references-1" href="#Cross-references">7 Cross references</a>
<ul class="no-bullet">
<li><a name="toc-_005clabel-1" href="#g_t_005clabel">7.1 <code>\label</code></a></li>
- <li><a name="toc-_005cpageref_007bkey_007d" href="#g_t_005cpageref">7.2 <code>\pageref{<var>key</var>}</code></a></li>
- <li><a name="toc-_005cref_007bkey_007d" href="#g_t_005cref">7.3 <code>\ref{<var>key</var>}</code></a></li>
+ <li><a name="toc-_005cpageref-1" href="#g_t_005cpageref">7.2 <code>\pageref</code></a></li>
+ <li><a name="toc-_005cref-1" href="#g_t_005cref">7.3 <code>\ref</code></a></li>
</ul></li>
<li><a name="toc-Environments-2" href="#Environments">8 Environments</a>
<ul class="no-bullet">
@@ -225,22 +233,24 @@ code {font-style: normal; font-family: monospace}
<li><a name="toc-minipage-1" href="#minipage">8.18 <code>minipage</code></a></li>
<li><a name="toc-picture-1" href="#picture">8.19 <code>picture</code></a>
<ul class="no-bullet">
- <li><a name="toc-_005ccircle-1" href="#g_t_005ccircle">8.19.1 <code>\circle</code></a></li>
- <li><a name="toc-_005cmakebox-1" href="#g_t_005cmakebox-_0028picture_0029">8.19.2 <code>\makebox</code></a></li>
- <li><a name="toc-_005cframebox" href="#g_t_005cframebox-_0028picture_0029">8.19.3 <code>\framebox</code></a></li>
- <li><a name="toc-_005cdashbox-1" href="#g_t_005cdashbox">8.19.4 <code>\dashbox</code></a></li>
- <li><a name="toc-_005cframe-1" href="#g_t_005cframe">8.19.5 <code>\frame</code></a></li>
- <li><a name="toc-_005cline-1" href="#g_t_005cline">8.19.6 <code>\line</code></a></li>
- <li><a name="toc-_005clinethickness-1" href="#g_t_005clinethickness">8.19.7 <code>\linethickness</code></a></li>
+ <li><a name="toc-_005cput-1" href="#g_t_005cput">8.19.1 <code>\put</code></a></li>
+ <li><a name="toc-_005cmultiput-1" href="#g_t_005cmultiput">8.19.2 <code>\multiput</code></a></li>
+ <li><a name="toc-_005cqbezier-1" href="#g_t_005cqbezier">8.19.3 <code>\qbezier</code></a></li>
+ <li><a name="toc-_005cgraphpaper-1" href="#g_t_005cgraphpaper">8.19.4 <code>\graphpaper</code></a></li>
+ <li><a name="toc-_005cline-1" href="#g_t_005cline">8.19.5 <code>\line</code></a></li>
+ <li><a name="toc-_005clinethickness-1" href="#g_t_005clinethickness">8.19.6 <code>\linethickness</code></a></li>
+ <li><a name="toc-_005cthinlines-1" href="#g_t_005cthinlines">8.19.7 <code>\thinlines</code></a></li>
<li><a name="toc-_005cthicklines-1" href="#g_t_005cthicklines">8.19.8 <code>\thicklines</code></a></li>
- <li><a name="toc-_005cthinlines-1" href="#g_t_005cthinlines">8.19.9 <code>\thinlines</code></a></li>
- <li><a name="toc-_005cmultiput-1" href="#g_t_005cmultiput">8.19.10 <code>\multiput</code></a></li>
- <li><a name="toc-_005coval-1" href="#g_t_005coval">8.19.11 <code>\oval</code></a></li>
- <li><a name="toc-_005cput-1" href="#g_t_005cput">8.19.12 <code>\put</code></a></li>
- <li><a name="toc-_005cshortstack-1" href="#g_t_005cshortstack">8.19.13 <code>\shortstack</code></a></li>
- <li><a name="toc-_005cvector-1" href="#g_t_005cvector">8.19.14 <code>\vector</code></a></li>
+ <li><a name="toc-_005ccircle-1" href="#g_t_005ccircle">8.19.9 <code>\circle</code></a></li>
+ <li><a name="toc-_005coval-1" href="#g_t_005coval">8.19.10 <code>\oval</code></a></li>
+ <li><a name="toc-_005cshortstack-1" href="#g_t_005cshortstack">8.19.11 <code>\shortstack</code></a></li>
+ <li><a name="toc-_005cvector-1" href="#g_t_005cvector">8.19.12 <code>\vector</code></a></li>
+ <li><a name="toc-_005cmakebox-_0028picture_0029-1" href="#g_t_005cmakebox-_0028picture_0029">8.19.13 <code>\makebox</code> (picture)</a></li>
+ <li><a name="toc-_005cframebox-_0028picture_0029-1" href="#g_t_005cframebox-_0028picture_0029">8.19.14 <code>\framebox</code> (picture)</a></li>
+ <li><a name="toc-_005cframe-1" href="#g_t_005cframe">8.19.15 <code>\frame</code></a></li>
+ <li><a name="toc-_005cdashbox-1" href="#g_t_005cdashbox">8.19.16 <code>\dashbox</code></a></li>
</ul></li>
- <li><a name="toc-quotation-and-quote-1" href="#quotation-and-quote">8.20 <code>quotation</code> and <code>quote</code></a></li>
+ <li><a name="toc-quotation-_0026-quote-1" href="#quotation-_0026-quote">8.20 <code>quotation</code> &amp; <code>quote</code></a></li>
<li><a name="toc-tabbing-1" href="#tabbing">8.21 <code>tabbing</code></a></li>
<li><a name="toc-table-1" href="#table">8.22 <code>table</code></a></li>
<li><a name="toc-tabular-1" href="#tabular">8.23 <code>tabular</code></a>
@@ -272,53 +282,52 @@ code {font-style: normal; font-family: monospace}
<li><a name="toc-_005cnewline-1" href="#g_t_005cnewline">9.3 <code>\newline</code></a></li>
<li><a name="toc-_005c_002d-_0028discretionary-hyphen_0029" href="#g_t_005c_002d-_0028hyphenation_0029">9.4 <code>\-</code> (discretionary hyphen)</a></li>
<li><a name="toc-_005cdiscretionary-_0028generalized-hyphenation-point_0029" href="#g_t_005cdiscretionary">9.5 <code>\discretionary</code> (generalized hyphenation point)</a></li>
- <li><a name="toc-_005cfussy-1" href="#g_t_005cfussy">9.6 <code>\fussy</code></a></li>
- <li><a name="toc-_005csloppy-1" href="#g_t_005csloppy">9.7 <code>\sloppy</code></a></li>
- <li><a name="toc-_005chyphenation-1" href="#g_t_005chyphenation">9.8 <code>\hyphenation</code></a></li>
- <li><a name="toc-_005clinebreak-_0026-_005cnolinebreak-1" href="#g_t_005clinebreak-_0026-_005cnolinebreak">9.9 <code>\linebreak</code> &amp; <code>\nolinebreak</code></a></li>
+ <li><a name="toc-_005cfussy-_0026-_005csloppy-1" href="#g_t_005cfussy-_0026-_005csloppy">9.6 <code>\fussy</code> &amp; <code>\sloppy</code></a>
+ <ul class="no-bullet">
+ <li><a name="toc-sloppypar-1" href="#sloppypar">9.6.1 <code>sloppypar</code></a></li>
+ </ul></li>
+ <li><a name="toc-_005chyphenation-1" href="#g_t_005chyphenation">9.7 <code>\hyphenation</code></a></li>
+ <li><a name="toc-_005clinebreak-_0026-_005cnolinebreak-1" href="#g_t_005clinebreak-_0026-_005cnolinebreak">9.8 <code>\linebreak</code> &amp; <code>\nolinebreak</code></a></li>
</ul></li>
<li><a name="toc-Page-breaking-1" href="#Page-breaking">10 Page breaking</a>
<ul class="no-bullet">
- <li><a name="toc-_005ccleardoublepage-1" href="#g_t_005ccleardoublepage">10.1 <code>\cleardoublepage</code></a></li>
- <li><a name="toc-_005cclearpage-1" href="#g_t_005cclearpage">10.2 <code>\clearpage</code></a></li>
- <li><a name="toc-_005cnewpage-1" href="#g_t_005cnewpage">10.3 <code>\newpage</code></a></li>
- <li><a name="toc-_005cenlargethispage-1" href="#g_t_005cenlargethispage">10.4 <code>\enlargethispage</code></a></li>
- <li><a name="toc-_005cpagebreak-_0026-_005cnopagebreak-1" href="#g_t_005cpagebreak-_0026-_005cnopagebreak">10.5 <code>\pagebreak</code> &amp; <code>\nopagebreak</code></a></li>
+ <li><a name="toc-_005cclearpage-_0026-_005ccleardoublepage-1" href="#g_t_005cclearpage-_0026-_005ccleardoublepage">10.1 <code>\clearpage</code> &amp; <code>\cleardoublepage</code></a></li>
+ <li><a name="toc-_005cnewpage-1" href="#g_t_005cnewpage">10.2 <code>\newpage</code></a></li>
+ <li><a name="toc-_005cenlargethispage-1" href="#g_t_005cenlargethispage">10.3 <code>\enlargethispage</code></a></li>
+ <li><a name="toc-_005cpagebreak-_0026-_005cnopagebreak-1" href="#g_t_005cpagebreak-_0026-_005cnopagebreak">10.4 <code>\pagebreak</code> &amp; <code>\nopagebreak</code></a></li>
</ul></li>
<li><a name="toc-Footnotes-1" href="#Footnotes">11 Footnotes</a>
<ul class="no-bullet">
<li><a name="toc-_005cfootnote-1" href="#g_t_005cfootnote">11.1 <code>\footnote</code></a></li>
<li><a name="toc-_005cfootnotemark-1" href="#g_t_005cfootnotemark">11.2 <code>\footnotemark</code></a></li>
<li><a name="toc-_005cfootnotetext-1" href="#g_t_005cfootnotetext">11.3 <code>\footnotetext</code></a></li>
- <li><a name="toc-Footnotes-in-a-table-1" href="#Footnotes-in-a-table">11.4 Footnotes in a table</a></li>
- <li><a name="toc-Footnotes-in-section-headings-1" href="#Footnotes-in-section-headings">11.5 Footnotes in section headings</a></li>
+ <li><a name="toc-Footnotes-in-section-headings-1" href="#Footnotes-in-section-headings">11.4 Footnotes in section headings</a></li>
+ <li><a name="toc-Footnotes-in-a-table-1" href="#Footnotes-in-a-table">11.5 Footnotes in a table</a></li>
<li><a name="toc-Footnotes-of-footnotes-1" href="#Footnotes-of-footnotes">11.6 Footnotes of footnotes</a></li>
- <li><a name="toc-Multiple-references-to-footnotes" href="#Multiple-reference-to-footnotes">11.7 Multiple references to footnotes</a></li>
- <li><a name="toc-Footnote-parameters-1" href="#Footnote-parameters">11.8 Footnote parameters</a></li>
</ul></li>
<li><a name="toc-Definitions-1" href="#Definitions">12 Definitions</a>
<ul class="no-bullet">
<li><a name="toc-_005cnewcommand-_0026-_005crenewcommand-1" href="#g_t_005cnewcommand-_0026-_005crenewcommand">12.1 <code>\newcommand</code> &amp; <code>\renewcommand</code></a></li>
<li><a name="toc-_005cprovidecommand-1" href="#g_t_005cprovidecommand">12.2 <code>\providecommand</code></a></li>
<li><a name="toc-_005cnewcounter_003a-Allocating-a-counter" href="#g_t_005cnewcounter">12.3 <code>\newcounter</code>: Allocating a counter</a></li>
- <li><a name="toc-_005cnewlength_003a-Allocating-a-length" href="#g_t_005cnewlength">12.4 <code>\newlength</code>: Allocating a length</a></li>
- <li><a name="toc-_005cnewsavebox_003a-Allocating-a-box" href="#g_t_005cnewsavebox">12.5 <code>\newsavebox</code>: Allocating a box</a></li>
+ <li><a name="toc-_005cnewlength-1" href="#g_t_005cnewlength">12.4 <code>\newlength</code></a></li>
+ <li><a name="toc-_005cnewsavebox-1" href="#g_t_005cnewsavebox">12.5 <code>\newsavebox</code></a></li>
<li><a name="toc-_005cnewenvironment-_0026-_005crenewenvironment-1" href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">12.6 <code>\newenvironment</code> &amp; <code>\renewenvironment</code></a></li>
<li><a name="toc-_005cnewtheorem-1" href="#g_t_005cnewtheorem">12.7 <code>\newtheorem</code></a></li>
- <li><a name="toc-_005cnewfont_003a-Define-a-new-font-_0028obsolete_0029" href="#g_t_005cnewfont">12.8 <code>\newfont</code>: Define a new font (obsolete)</a></li>
+ <li><a name="toc-_005cnewfont-1" href="#g_t_005cnewfont">12.8 <code>\newfont</code></a></li>
<li><a name="toc-_005cprotect-1" href="#g_t_005cprotect">12.9 <code>\protect</code></a></li>
<li><a name="toc-_005cignorespaces-_0026-_005cignorespacesafterend-1" href="#g_t_005cignorespaces-_0026-_005cignorespacesafterend">12.10 <code>\ignorespaces &amp; \ignorespacesafterend</code></a></li>
</ul></li>
<li><a name="toc-Counters-1" href="#Counters">13 Counters</a>
<ul class="no-bullet">
<li><a name="toc-_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol_003a-Printing-counters" href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">13.1 <code>\alph \Alph \arabic \roman \Roman \fnsymbol</code>: Printing counters</a></li>
- <li><a name="toc-_005cusecounter_007bcounter_007d" href="#g_t_005cusecounter">13.2 <code>\usecounter{<var>counter</var>}</code></a></li>
- <li><a name="toc-_005cvalue_007bcounter_007d" href="#g_t_005cvalue">13.3 <code>\value{<var>counter</var>}</code></a></li>
- <li><a name="toc-_005csetcounter_007bcounter_007d_007bvalue_007d" href="#g_t_005csetcounter">13.4 <code>\setcounter{<var>counter</var>}{<var>value</var>}</code></a></li>
- <li><a name="toc-_005caddtocounter_007bcounter_007d_007bvalue_007d" href="#g_t_005caddtocounter">13.5 <code>\addtocounter{<var>counter</var>}{<var>value</var>}</code></a></li>
- <li><a name="toc-_005crefstepcounter_007bcounter_007d" href="#g_t_005crefstepcounter">13.6 <code>\refstepcounter{<var>counter</var>}</code></a></li>
- <li><a name="toc-_005cstepcounter_007bcounter_007d" href="#g_t_005cstepcounter">13.7 <code>\stepcounter{<var>counter</var>}</code></a></li>
- <li><a name="toc-_005cday-_005cmonth-_005cyear_003a-Predefined-counters" href="#g_t_005cday-_005cmonth-_005cyear">13.8 <code>\day \month \year</code>: Predefined counters</a></li>
+ <li><a name="toc-_005cusecounter-1" href="#g_t_005cusecounter">13.2 <code>\usecounter</code></a></li>
+ <li><a name="toc-_005cvalue-1" href="#g_t_005cvalue">13.3 <code>\value</code></a></li>
+ <li><a name="toc-_005csetcounter-1" href="#g_t_005csetcounter">13.4 <code>\setcounter</code></a></li>
+ <li><a name="toc-_005caddtocounter-1" href="#g_t_005caddtocounter">13.5 <code>\addtocounter</code></a></li>
+ <li><a name="toc-_005crefstepcounter-1" href="#g_t_005crefstepcounter">13.6 <code>\refstepcounter</code></a></li>
+ <li><a name="toc-_005cstepcounter-1" href="#g_t_005cstepcounter">13.7 <code>\stepcounter</code></a></li>
+ <li><a name="toc-_005cday-_0026-_005cmonth-_0026-_005cyear-1" href="#g_t_005cday-_0026-_005cmonth-_0026-_005cyear">13.8 <code>\day</code> &amp; <code>\month</code> &amp; <code>\year</code></a></li>
</ul></li>
<li><a name="toc-Lengths-1" href="#Lengths">14 Lengths</a>
<ul class="no-bullet">
@@ -327,24 +336,38 @@ code {font-style: normal; font-family: monospace}
<li><a name="toc-_005caddtolength-1" href="#g_t_005caddtolength">14.3 <code>\addtolength</code></a></li>
<li><a name="toc-_005csettodepth-1" href="#g_t_005csettodepth">14.4 <code>\settodepth</code></a></li>
<li><a name="toc-_005csettoheight-1" href="#g_t_005csettoheight">14.5 <code>\settoheight</code></a></li>
- <li><a name="toc-_005csettowidth_007b_005clen_007d_007btext_007d" href="#g_t_005csettowidth">14.6 <code>\settowidth{\<var>len</var>}{<var>text</var>}</code></a></li>
- <li><a name="toc-Predefined-lengths-1" href="#Predefined-lengths">14.7 Predefined lengths</a></li>
+ <li><a name="toc-_005csettowidth-1" href="#g_t_005csettowidth">14.6 <code>\settowidth</code></a></li>
</ul></li>
<li><a name="toc-Making-paragraphs-1" href="#Making-paragraphs">15 Making paragraphs</a>
<ul class="no-bullet">
- <li><a name="toc-_005cindent-1" href="#g_t_005cindent">15.1 <code>\indent</code></a></li>
- <li><a name="toc-_005cnoindent-1" href="#g_t_005cnoindent">15.2 <code>\noindent</code></a></li>
- <li><a name="toc-_005cparskip-1" href="#g_t_005cparskip">15.3 <code>\parskip</code></a></li>
+ <li><a name="toc-_005cpar-1" href="#g_t_005cpar">15.1 <code>\par</code></a></li>
+ <li><a name="toc-_005cindent-_0026-_005cnoindent-1" href="#g_t_005cindent-_0026-_005cnoindent">15.2 <code>\indent</code> &amp; <code>\noindent</code></a></li>
+ <li><a name="toc-_005cparindent-_0026-_005cparskip-1" href="#g_t_005cparindent-_0026-_005cparskip">15.3 <code>\parindent</code> &amp; <code>\parskip</code></a></li>
<li><a name="toc-Marginal-notes-1" href="#Marginal-notes">15.4 Marginal notes</a></li>
</ul></li>
<li><a name="toc-Math-formulas-1" href="#Math-formulas">16 Math formulas</a>
<ul class="no-bullet">
<li><a name="toc-Subscripts-_0026-superscripts-1" href="#Subscripts-_0026-superscripts">16.1 Subscripts &amp; superscripts</a></li>
- <li><a name="toc-Math-symbols-1" href="#Math-symbols">16.2 Math symbols</a></li>
+ <li><a name="toc-Math-symbols-1" href="#Math-symbols">16.2 Math symbols</a>
+ <ul class="no-bullet">
+ <li><a name="toc-Blackboard-bold-1" href="#Blackboard-bold">16.2.1 Blackboard bold</a></li>
+ <li><a name="toc-Calligraphic-1" href="#Calligraphic">16.2.2 Calligraphic</a></li>
+ <li><a name="toc-_005cboldmath-_0026-_005cunboldmath-1" href="#g_t_005cboldmath-_0026-_005cunboldmath">16.2.3 <code>\boldmath</code> &amp; <code>\unboldmath</code></a></li>
+ <li><a name="toc-Dots_002c-horizontal-or-vertical" href="#Dots">16.2.4 Dots, horizontal or vertical</a></li>
+ </ul></li>
<li><a name="toc-Math-functions-1" href="#Math-functions">16.3 Math functions</a></li>
<li><a name="toc-Math-accents-1" href="#Math-accents">16.4 Math accents</a></li>
- <li><a name="toc-Spacing-in-math-mode-1" href="#Spacing-in-math-mode">16.5 Spacing in math mode</a></li>
- <li><a name="toc-Math-miscellany-1" href="#Math-miscellany">16.6 Math miscellany</a></li>
+ <li><a name="toc-Over_002d-and-Underlining-1" href="#Over_002d-and-Underlining">16.5 Over- and Underlining</a></li>
+ <li><a name="toc-Spacing-in-math-mode-1" href="#Spacing-in-math-mode">16.6 Spacing in math mode</a></li>
+ <li><a name="toc-Math-miscellany-1" href="#Math-miscellany">16.7 Math miscellany</a>
+ <ul class="no-bullet">
+ <li><a name="toc-Colon-character-_003a-_0026-_005ccolon" href="#Colon-character-_0026-_005ccolon">16.7.1 Colon character <code>:</code> &amp; <code>\colon</code></a></li>
+ <li><a name="toc-_005c_002a-1" href="#g_t_005c_002a">16.7.2 <code>\*</code></a></li>
+ <li><a name="toc-_005cfrac-1" href="#g_t_005cfrac">16.7.3 <code>\frac</code></a></li>
+ <li><a name="toc-_005cleft-_0026-_005cright-1" href="#g_t_005cleft-_0026-_005cright">16.7.4 <code>\left</code> &amp; <code>\right</code></a></li>
+ <li><a name="toc-_005csqrt-1" href="#g_t_005csqrt">16.7.5 <code>\sqrt</code></a></li>
+ <li><a name="toc-_005cstackrel-1" href="#g_t_005cstackrel">16.7.6 <code>\stackrel</code></a></li>
+ </ul></li>
</ul></li>
<li><a name="toc-Modes-1" href="#Modes">17 Modes</a>
<ul class="no-bullet">
@@ -355,42 +378,45 @@ code {font-style: normal; font-family: monospace}
<li><a name="toc-_005cmaketitle-1" href="#g_t_005cmaketitle">18.1 <code>\maketitle</code></a></li>
<li><a name="toc-_005cpagenumbering-1" href="#g_t_005cpagenumbering">18.2 <code>\pagenumbering</code></a></li>
<li><a name="toc-_005cpagestyle-1" href="#g_t_005cpagestyle">18.3 <code>\pagestyle</code></a></li>
- <li><a name="toc-_005cthispagestyle_007bstyle_007d" href="#g_t_005cthispagestyle">18.4 <code>\thispagestyle{<var>style</var>}</code></a></li>
+ <li><a name="toc-_005cthispagestyle-1" href="#g_t_005cthispagestyle">18.4 <code>\thispagestyle</code></a></li>
</ul></li>
<li><a name="toc-Spaces-1" href="#Spaces">19 Spaces</a>
<ul class="no-bullet">
- <li><a name="toc-_005chspace-1" href="#g_t_005chspace">19.1 <code>\hspace</code></a></li>
- <li><a name="toc-_005chfill-1" href="#g_t_005chfill">19.2 <code>\hfill</code></a></li>
- <li><a name="toc-_005cspacefactor-1" href="#g_t_005cspacefactor">19.3 <code>\spacefactor</code></a>
+ <li><a name="toc-_005censpace-_0026-_005cquad-_0026-_005cqquad-1" href="#g_t_005censpace-_0026-_005cquad-_0026-_005cqquad">19.1 <code>\enspace</code> &amp; <code>\quad</code> &amp; <code>\qquad</code></a></li>
+ <li><a name="toc-_005chspace-1" href="#g_t_005chspace">19.2 <code>\hspace</code></a></li>
+ <li><a name="toc-_005chfill-1" href="#g_t_005chfill">19.3 <code>\hfill</code></a></li>
+ <li><a name="toc-_005chss-1" href="#g_t_005chss">19.4 <code>\hss</code></a></li>
+ <li><a name="toc-_005cspacefactor-1" href="#g_t_005cspacefactor">19.5 <code>\spacefactor</code></a>
<ul class="no-bullet">
- <li><a name="toc-_005c_0028SPACE_0029-and-_005c_0040-1" href="#g_t_005c_0028SPACE_0029-and-_005c_0040">19.3.1 <code>\(SPACE)</code> and <code>\@</code></a></li>
- <li><a name="toc-_005cfrenchspacing-1" href="#g_t_005cfrenchspacing">19.3.2 <code>\frenchspacing</code></a></li>
- <li><a name="toc-_005cnormalsfcodes-1" href="#g_t_005cnormalsfcodes">19.3.3 <code>\normalsfcodes</code></a></li>
+ <li><a name="toc-_005c_0040-1" href="#g_t_005c_0040">19.5.1 <code>\@</code></a></li>
+ <li><a name="toc-_005cfrenchspacing-1" href="#g_t_005cfrenchspacing">19.5.2 <code>\frenchspacing</code></a></li>
+ <li><a name="toc-_005cnormalsfcodes-1" href="#g_t_005cnormalsfcodes">19.5.3 <code>\normalsfcodes</code></a></li>
</ul></li>
- <li><a name="toc-_005c--after-control-sequence" href="#g_t_005c_0028SPACE_0029-after-control-sequence">19.4 <code>\ </code> after control sequence</a></li>
- <li><a name="toc-_005cthinspace_003a-Insert-1_002f6em" href="#g_t_005cthinspace">19.5 <code>\thinspace</code>: Insert 1/6em</a></li>
- <li><a name="toc-_005c_002f_003a-Insert-italic-correction" href="#g_t_005c_002f">19.6 <code>\/</code>: Insert italic correction</a></li>
- <li><a name="toc-_005chrulefill-_005cdotfill-1" href="#g_t_005chrulefill-_005cdotfill">19.7 <code>\hrulefill \dotfill</code></a></li>
- <li><a name="toc-_005caddvspace-1" href="#g_t_005caddvspace">19.8 <code>\addvspace</code></a></li>
- <li><a name="toc-_005cbigskip-_005cmedskip-_005csmallskip-1" href="#g_t_005cbigskip-_005cmedskip-_005csmallskip">19.9 <code>\bigskip \medskip \smallskip</code></a></li>
- <li><a name="toc-_005cvfill-1" href="#g_t_005cvfill">19.10 <code>\vfill</code></a></li>
- <li><a name="toc-_005cvspace_007blength_007d" href="#g_t_005cvspace">19.11 <code>\vspace{<var>length</var>}</code></a></li>
+ <li><a name="toc-Backslash_002dspace_002c-_005c-" href="#g_t_005c_0028SPACE_0029">19.6 Backslash-space, <code>\ </code></a></li>
+ <li><a name="toc-_007e-1" href="#g_t_007e">19.7 <code>~</code></a></li>
+ <li><a name="toc-_005cthinspace-_0026-_005cnegthinspace-1" href="#g_t_005cthinspace-_0026-_005cnegthinspace">19.8 <code>\thinspace</code> &amp; <code>\negthinspace</code></a></li>
+ <li><a name="toc-_005c_002f-1" href="#g_t_005c_002f">19.9 <code>\/</code></a></li>
+ <li><a name="toc-_005chrulefill-_0026-_005cdotfill-1" href="#g_t_005chrulefill-_0026-_005cdotfill">19.10 <code>\hrulefill</code> &amp; <code>\dotfill</code></a></li>
+ <li><a name="toc-_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip-1" href="#g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">19.11 <code>\bigskip</code> &amp; <code>\medskip</code> &amp; <code>\smallskip</code></a></li>
+ <li><a name="toc-_005cbigbreak-_0026-_005cmedbreak-_0026-_005csmallbreak-1" href="#g_t_005cbigbreak-_0026-_005cmedbreak-_0026-_005csmallbreak">19.12 <code>\bigbreak</code> &amp; <code>\medbreak</code> &amp; <code>\smallbreak</code></a></li>
+ <li><a name="toc-_005cstrut-1" href="#g_t_005cstrut">19.13 <code>\strut</code></a></li>
+ <li><a name="toc-_005cvspace-1" href="#g_t_005cvspace">19.14 <code>\vspace</code></a></li>
+ <li><a name="toc-_005cvfill-1" href="#g_t_005cvfill">19.15 <code>\vfill</code></a></li>
+ <li><a name="toc-_005caddvspace-1" href="#g_t_005caddvspace">19.16 <code>\addvspace</code></a></li>
</ul></li>
<li><a name="toc-Boxes-1" href="#Boxes">20 Boxes</a>
<ul class="no-bullet">
- <li><a name="toc-_005cmbox_007btext_007d" href="#g_t_005cmbox">20.1 <code>\mbox{<var>text}</var></code></a></li>
- <li><a name="toc-_005cfbox-and-_005cframebox-1" href="#g_t_005cfbox-and-_005cframebox">20.2 <code>\fbox</code> and <code>\framebox</code></a></li>
- <li><a name="toc-lrbox-1" href="#lrbox">20.3 <code>lrbox</code></a></li>
- <li><a name="toc-_005cmakebox-2" href="#g_t_005cmakebox">20.4 <code>\makebox</code></a></li>
- <li><a name="toc-_005cparbox-1" href="#g_t_005cparbox">20.5 <code>\parbox</code></a></li>
- <li><a name="toc-_005craisebox-1" href="#g_t_005craisebox">20.6 <code>\raisebox</code></a></li>
- <li><a name="toc-_005csavebox-1" href="#g_t_005csavebox">20.7 <code>\savebox</code></a></li>
- <li><a name="toc-_005csbox_007b_005cboxcmd_007d_007btext_007d" href="#g_t_005csbox">20.8 <code>\sbox{<var>\boxcmd</var>}{<var>text</var>}</code></a></li>
- <li><a name="toc-_005cusebox_007b_005cboxcmd_007d" href="#g_t_005cusebox">20.9 <code>\usebox{<var>\boxcmd</var>}</code></a></li>
+ <li><a name="toc-_005cmbox-_0026-_005cmakebox-1" href="#g_t_005cmbox-_0026-_005cmakebox">20.1 <code>\mbox</code> &amp; <code>\makebox</code></a></li>
+ <li><a name="toc-_005cfbox-_0026-_005cframebox-1" href="#g_t_005cfbox-_0026-_005cframebox">20.2 <code>\fbox</code> &amp; <code>\framebox</code></a></li>
+ <li><a name="toc-_005cparbox-1" href="#g_t_005cparbox">20.3 <code>\parbox</code></a></li>
+ <li><a name="toc-_005craisebox-1" href="#g_t_005craisebox">20.4 <code>\raisebox</code></a></li>
+ <li><a name="toc-_005csbox-_0026-_005csavebox-1" href="#g_t_005csbox-_0026-_005csavebox">20.5 <code>\sbox</code> &amp; <code>\savebox</code></a></li>
+ <li><a name="toc-lrbox-1" href="#lrbox">20.6 <code>lrbox</code></a></li>
+ <li><a name="toc-_005cusebox-1" href="#g_t_005cusebox">20.7 <code>\usebox</code></a></li>
</ul></li>
<li><a name="toc-Color-1" href="#Color">21 Color</a>
<ul class="no-bullet">
- <li><a name="toc-Color-package-options-1" href="#Color-package-options">21.1 Color package options</a></li>
+ <li><a name="toc-color-package-options" href="#Color-package-options">21.1 <code>color</code> package options</a></li>
<li><a name="toc-Color-models-1" href="#Color-models">21.2 Color models</a></li>
<li><a name="toc-Commands-for-color-1" href="#Commands-for-color">21.3 Commands for color</a>
<ul class="no-bullet">
@@ -402,8 +428,8 @@ code {font-style: normal; font-family: monospace}
</ul></li>
<li><a name="toc-Graphics-1" href="#Graphics">22 Graphics</a>
<ul class="no-bullet">
- <li><a name="toc-Graphics-package-options-1" href="#Graphics-package-options">22.1 Graphics package options</a></li>
- <li><a name="toc-Graphics-package-configuration-1" href="#Graphics-package-configuration">22.2 Graphics package configuration</a>
+ <li><a name="toc-graphics-package-options" href="#Graphics-package-options">22.1 <code>graphics</code> package options</a></li>
+ <li><a name="toc-graphics-package-configuration" href="#Graphics-package-configuration">22.2 <code>graphics</code> package configuration</a>
<ul class="no-bullet">
<li><a name="toc-_005cgraphicspath-1" href="#g_t_005cgraphicspath">22.2.1 <code>\graphicspath</code></a></li>
<li><a name="toc-_005cDeclareGraphicsExtensions-1" href="#g_t_005cDeclareGraphicsExtensions">22.2.2 <code>\DeclareGraphicsExtensions</code></a></li>
@@ -430,19 +456,29 @@ code {font-style: normal; font-family: monospace}
</ul></li>
<li><a name="toc-Splitting-the-input-1" href="#Splitting-the-input">24 Splitting the input</a>
<ul class="no-bullet">
- <li><a name="toc-_005cinclude-1" href="#g_t_005cinclude">24.1 <code>\include</code></a></li>
- <li><a name="toc-_005cincludeonly-1" href="#g_t_005cincludeonly">24.2 <code>\includeonly</code></a></li>
+ <li><a name="toc-_005cendinput-1" href="#g_t_005cendinput">24.1 <code>\endinput</code></a></li>
+ <li><a name="toc-_005cinclude-_0026-_005cincludeonly-1" href="#g_t_005cinclude-_0026-_005cincludeonly">24.2 <code>\include</code> &amp; <code>\includeonly</code></a></li>
<li><a name="toc-_005cinput-1" href="#g_t_005cinput">24.3 <code>\input</code></a></li>
</ul></li>
<li><a name="toc-Front_002fback-matter-1" href="#Front_002fback-matter">25 Front/back matter</a>
<ul class="no-bullet">
- <li><a name="toc-Tables-of-contents-1" href="#Tables-of-contents">25.1 Tables of contents</a>
+ <li><a name="toc-Table-of-contents-etc_002e-1" href="#Table-of-contents-etc_002e">25.1 Table of contents etc.</a>
<ul class="no-bullet">
<li><a name="toc-_005caddcontentsline-1" href="#g_t_005caddcontentsline">25.1.1 <code>\addcontentsline</code></a></li>
<li><a name="toc-_005caddtocontents-1" href="#g_t_005caddtocontents">25.1.2 <code>\addtocontents</code></a></li>
+ <li><a name="toc-_005cnofiles-1" href="#g_t_005cnofiles">25.1.3 <code>\nofiles</code></a></li>
+ </ul></li>
+ <li><a name="toc-Indexes-1" href="#Indexes">25.2 Indexes</a>
+ <ul class="no-bullet">
+ <li><a name="toc-_005cindex-1" href="#g_t_005cindex">25.2.1 <code>\index</code></a></li>
+ <li><a name="toc-makeindex-1" href="#makeindex">25.2.2 <code>makeindex</code></a></li>
+ <li><a name="toc-_005cprintindex-1" href="#g_t_005cprintindex">25.2.3 <code>\printindex</code></a></li>
+ </ul></li>
+ <li><a name="toc-Glossaries-1" href="#Glossaries">25.3 Glossaries</a>
+ <ul class="no-bullet">
+ <li><a name="toc-_005cnewglossaryentry-1" href="#g_t_005cnewglossaryentry">25.3.1 <code>\newglossaryentry</code></a></li>
+ <li><a name="toc-_005cgls-1" href="#g_t_005cgls">25.3.2 <code>\gls</code></a></li>
</ul></li>
- <li><a name="toc-Glossaries-1" href="#Glossaries">25.2 Glossaries</a></li>
- <li><a name="toc-Indexes-1" href="#Indexes">25.3 Indexes</a></li>
</ul></li>
<li><a name="toc-Letters-1" href="#Letters">26 Letters</a>
<ul class="no-bullet">
@@ -460,18 +496,24 @@ code {font-style: normal; font-family: monospace}
</ul></li>
<li><a name="toc-Terminal-input_002foutput-1" href="#Terminal-input_002foutput">27 Terminal input/output</a>
<ul class="no-bullet">
- <li><a name="toc-_005ctypein_005bcmd_005d_007bmsg_007d" href="#g_t_005ctypein">27.1 <code>\typein[<var>cmd</var>]{<var>msg</var>}</code></a></li>
- <li><a name="toc-_005ctypeout_007bmsg_007d" href="#g_t_005ctypeout">27.2 <code>\typeout{<var>msg</var>}</code></a></li>
+ <li><a name="toc-_005ctypein-1" href="#g_t_005ctypein">27.1 <code>\typein</code></a></li>
+ <li><a name="toc-_005ctypeout-1" href="#g_t_005ctypeout">27.2 <code>\typeout</code></a></li>
+ </ul></li>
+ <li><a name="toc-Command-line-1" href="#Command-line">28 Command line</a>
+ <ul class="no-bullet">
+ <li><a name="toc-Command-line-options-1" href="#Command-line-options">28.1 Command line options</a></li>
+ <li><a name="toc-Command-line-input-1" href="#Command-line-input">28.2 Command line input</a></li>
+ <li><a name="toc-Recovering-from-errors-1" href="#Recovering-from-errors">28.3 Recovering from errors</a></li>
</ul></li>
- <li><a name="toc-Command-line-1" href="#Command-line">28 Command line</a></li>
<li><a name="toc-Document-templates-1" href="#Document-templates">Appendix A Document templates</a>
<ul class="no-bullet">
<li><a name="toc-beamer-template-1" href="#beamer-template">A.1 <code>beamer</code> template</a></li>
- <li><a name="toc-book-template-1" href="#book-template">A.2 <code>book</code> template</a></li>
- <li><a name="toc-tugboat-template-1" href="#tugboat-template">A.3 <code>tugboat</code> template</a></li>
+ <li><a name="toc-article-template-1" href="#article-template">A.2 <code>article</code> template</a></li>
+ <li><a name="toc-book-template-1" href="#book-template">A.3 <code>book</code> template</a></li>
+ <li><a name="toc-Larger-book-template-1" href="#Larger-book-template">A.4 Larger <code>book</code> template</a></li>
+ <li><a name="toc-tugboat-template-1" href="#tugboat-template">A.5 <code>tugboat</code> template</a></li>
</ul></li>
- <li><a name="toc-Concept-Index-1" href="#Concept-Index">Concept Index</a></li>
- <li><a name="toc-Command-Index-1" href="#Command-Index">Command Index</a></li>
+ <li><a name="toc-Index-1" href="#Index">Index</a></li>
</ul>
</div>
@@ -481,13 +523,13 @@ code {font-style: normal; font-family: monospace}
<a name="Top"></a>
<div class="header">
<p>
-Next: <a href="#About-this-document" accesskey="n" rel="next">About this document</a>, Up: <a href="http://tug.org/texinfohtml/" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#About-this-document" accesskey="n" rel="next">About this document</a>, Up: <a href="http://tug.org/texinfohtml/" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="LaTeX2e_003a-An-unofficial-reference-manual"></a>
<h1 class="top">LaTeX2e: An unofficial reference manual</h1>
<p>This document is an unofficial reference manual (version of
-March 2018) for LaTeX2e, a document preparation system.
+July 2018) for LaTeX2e, a document preparation system.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#About-this-document" accesskey="1">About this document</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Bug reporting, etc.
@@ -500,7 +542,7 @@ March 2018) for LaTeX2e, a document preparation system.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Layout" accesskey="5">Layout</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Controlling the page layout.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Sectioning" accesskey="6">Sectioning</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">How to section properly.
+<tr><td align="left" valign="top">&bull; <a href="#Sectioning" accesskey="6">Sectioning</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Parts, Chapters, Sections, etc.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Cross-references" accesskey="7">Cross references</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Automatic referencing.
</td></tr>
@@ -548,9 +590,7 @@ March 2018) for LaTeX2e, a document preparation system.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Document-templates">Document templates</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Starter templates for various document classes.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Concept-Index">Concept Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">General index.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Command-Index">Command Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Alphabetical list of LaTeX commands.
+<tr><td align="left" valign="top">&bull; <a href="#Index">Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">General index.
</td></tr>
</table>
@@ -559,16 +599,16 @@ March 2018) for LaTeX2e, a document preparation system.
<a name="About-this-document"></a>
<div class="header">
<p>
-Next: <a href="#Overview" accesskey="n" rel="next">Overview</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Overview" accesskey="n" rel="next">Overview</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="About-this-document-1"></a>
<h2 class="chapter">1 About this document</h2>
-<a name="index-http_003a_002f_002fpuszcza_002egnu_002eorg_002eua_002fsoftware_002flatexrefman_002f-home-page"></a>
+<a name="index-home-page-for-manual"></a>
<p>This is an unofficial reference manual for the LaTeX2e document
preparation system, which is a macro package for the TeX
typesetting program (see <a href="#Overview">Overview</a>). This document&rsquo;s home page is
-<a href="http://puszcza.gnu.org.ua/software/latexrefman/">http://puszcza.gnu.org.ua/software/latexrefman/</a>. That page has links to the
+<a href="puszcza.gnu.org.ua/software/latexrefman">puszcza.gnu.org.ua/software/latexrefman</a>. That page has links to the
current output in various formats, sources, mailing list archives and
subscriptions, and other infrastructure.
</p>
@@ -629,7 +669,7 @@ references.
<a name="Overview"></a>
<div class="header">
<p>
-Next: <a href="#Document-classes" accesskey="n" rel="next">Document classes</a>, Previous: <a href="#About-this-document" accesskey="p" rel="prev">About this document</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Document-classes" accesskey="n" rel="next">Document classes</a>, Previous: <a href="#About-this-document" accesskey="p" rel="prev">About this document</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Overview-of-LaTeX"></a>
<h2 class="chapter">2 Overview of LaTeX</h2>
@@ -674,6 +714,8 @@ sensible, such as in plain text, write it as &lsquo;<samp>LaTeX</samp>&rsquo;.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#LaTeX-command-syntax" accesskey="4">LaTeX command syntax</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">General syntax of LaTeX commands.
</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#CTAN" accesskey="5">CTAN</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Our repository.
+</td></tr>
</table>
@@ -681,7 +723,7 @@ sensible, such as in plain text, write it as &lsquo;<samp>LaTeX</samp>&rsquo;.
<a name="Starting-and-ending"></a>
<div class="header">
<p>
-Next: <a href="#Output-files" accesskey="n" rel="next">Output files</a>, Up: <a href="#Overview" accesskey="u" rel="up">Overview</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Output-files" accesskey="n" rel="next">Output files</a>, Up: <a href="#Overview" accesskey="u" rel="up">Overview</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Starting-and-ending-1"></a>
<h3 class="section">2.1 Starting and ending</h3>
@@ -691,7 +733,7 @@ Next: <a href="#Output-files" accesskey="n" rel="next">Output files</a>, Up: <a
<a name="index-hello_002c-world"></a>
<p>LaTeX files have a simple global structure, with a standard beginning
-and ending. Here is a &ldquo;hello, world&rdquo; example:
+and ending. This is a small example.
</p>
<div class="example">
<pre class="example">\documentclass{article}
@@ -700,10 +742,13 @@ Hello, \LaTeX\ world.
\end{document}
</pre></div>
+<p>Every LaTeX document has a <code>\begin{document}</code> line and an
+<code>\end{document}</code> line.
+</p>
<a name="index-document-class_002c-defined"></a>
-<p>Here, the &lsquo;<samp>article</samp>&rsquo; is the so-called <em>document class</em>,
-implemented in a file <samp>article.cls</samp>. Any document class can be
-used. A few document classes are defined by LaTeX itself, and vast
+<p>Here, the &lsquo;<samp>article</samp>&rsquo; is the <em>document class</em>. It is implemented
+in a file <samp>article.cls</samp>. You can use any document class on your
+system. A few document classes are defined by LaTeX itself, and vast
array of others are widely available. See <a href="#Document-classes">Document classes</a>.
</p>
<a name="index-preamble_002c-defined"></a>
@@ -711,12 +756,13 @@ array of others are widely available. See <a href="#Document-classes">Document
<code>\documentclass</code> and the <code>\begin{document}</code> commands.
This area is called the <em>preamble</em>.
</p>
-<p>The <code>\begin{document} ... \end{document}</code> is a so-called
+<p>The <code>\begin{document}</code>, <code>\end{document}</code> pair defines an
<a name="index-environment"></a>
<em>environment</em>; the &lsquo;<samp>document</samp>&rsquo; environment (and no others) is
-required in all LaTeX documents (see <a href="#document">document</a>). LaTeX
-provides many environments itself, and many more are defined separately.
-See <a href="#Environments">Environments</a>.
+required in all LaTeX documents (see <a href="#document">document</a>). LaTeX make
+available to you many environments that are documented here
+(see <a href="#Environments">Environments</a>). Many more are available to you from external
+packages, most importantly those available at CTAN (see <a href="#CTAN">CTAN</a>).
</p>
<p>The following sections discuss how to produce PDF or other output from
a LaTeX input file.
@@ -726,12 +772,12 @@ a LaTeX input file.
<a name="Output-files"></a>
<div class="header">
<p>
-Next: <a href="#TeX-engines" accesskey="n" rel="next">TeX engines</a>, Previous: <a href="#Starting-and-ending" accesskey="p" rel="prev">Starting and ending</a>, Up: <a href="#Overview" accesskey="u" rel="up">Overview</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#TeX-engines" accesskey="n" rel="next">TeX engines</a>, Previous: <a href="#Starting-and-ending" accesskey="p" rel="prev">Starting and ending</a>, Up: <a href="#Overview" accesskey="u" rel="up">Overview</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Output-files-1"></a>
<h3 class="section">2.2 Output files</h3>
-<p>LaTeX produces a main output file and at least two accessory files.
+<p>LaTeX produces a main output file and at least two auxiliary files.
The main output file&rsquo;s name ends in either <samp>.dvi</samp> or <samp>.pdf</samp>.
</p>
<dl compact="compact">
@@ -742,7 +788,7 @@ The main output file&rsquo;s name ends in either <samp>.dvi</samp> or <samp>.pdf
<a name="index-dvips-command"></a>
<a name="index-dvipdfmx-command"></a>
<a name="index-dvitype-command"></a>
-<p>If LaTeX is invoked with the system command <code>latex</code> then it
+<a name="output-files-dvi"></a><p>If LaTeX is invoked with the system command <code>latex</code> then it
produces a DeVice Independent file, with extension <samp>.dvi</samp>. You
can view this file with a command such as <code>xdvi</code>, or convert
it to a PostScript <code>.ps</code> file with <code>dvips</code> or to a
@@ -756,7 +802,7 @@ available (<a href="http://mirror.ctan.org/dviware">http://mirror.ctan.org/dviwa
<dd><a name="index-_002epdf-file"></a>
<a name="index-pdfTeX"></a>
<a name="index-pdflatex-command"></a>
-<p>If LaTeX is invoked via the system command <code>pdflatex</code>,
+<a name="output-files-pdf"></a><p>If LaTeX is invoked via the system command <code>pdflatex</code>,
among other commands (see <a href="#TeX-engines">TeX engines</a>), then the main output is
a Portable Document Format (PDF) file. Typically this is a
self-contained file, with all fonts and images included.
@@ -771,7 +817,7 @@ self-contained file, with all fonts and images included.
<dd><a name="index-transcript-file"></a>
<a name="index-log-file"></a>
<a name="index-_002elog-file"></a>
-<p>This transcript file contains summary information such as a list of
+<a name="output-files-log"></a><p>This transcript file contains summary information such as a list of
loaded packages. It also includes diagnostic messages and perhaps
additional information for any errors.
</p>
@@ -782,7 +828,7 @@ additional information for any errors.
<a name="index-cross-references_002c-resolving"></a>
<a name="index-forward-references_002c-resolving"></a>
<a name="index-references_002c-resolving-forward"></a>
-<p>Auxiliary information is used by LaTeX for things such as
+<a name="output-files-aux"></a><p>Auxiliary information is used by LaTeX for things such as
cross references. For example, the first time that LaTeX finds a
forward reference&mdash;a cross reference to something that has not yet
appeared in the source&mdash;it will appear in the output as a doubled
@@ -804,17 +850,17 @@ location.
<a name="index-table-of-contents-file"></a>
<a name="index-contents-file"></a>
<p>LaTeX may produce yet more files, characterized by the filename
-ending. These include a <code>.lof</code> file that is used to make a list
-of figures, a <code>.lot</code> file used to make a list of tables, and a
-<code>.toc</code> file used to make a table of contents. A particular class
-may create others; the list is open-ended.
+ending. These include a <code>.lof</code> file that is used to make a list of
+figures, a <code>.lot</code> file used to make a list of tables, and a
+<code>.toc</code> file used to make a table of contents (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>). A particular class may create others; the list is
+open-ended.
</p>
<hr>
<a name="TeX-engines"></a>
<div class="header">
<p>
-Next: <a href="#LaTeX-command-syntax" accesskey="n" rel="next">LaTeX command syntax</a>, Previous: <a href="#Output-files" accesskey="p" rel="prev">Output files</a>, Up: <a href="#Overview" accesskey="u" rel="up">Overview</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#LaTeX-command-syntax" accesskey="n" rel="next">LaTeX command syntax</a>, Previous: <a href="#Output-files" accesskey="p" rel="prev">Output files</a>, Up: <a href="#Overview" accesskey="u" rel="up">Overview</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="TeX-engines-1"></a>
<h3 class="section">2.3 TeX engines</h3>
@@ -828,7 +874,7 @@ Next: <a href="#LaTeX-command-syntax" accesskey="n" rel="next">LaTeX command syn
<p>LaTeX is defined to be a set of commands that are run by a TeX
implementation (see <a href="#Overview">Overview</a>). This section gives a terse
-overview of the main programs.
+overview of the main programs (see also&nbsp;<a href="#Command-line">Command line</a>).
</p>
<dl compact="compact">
<dt><code>latex</code></dt>
@@ -836,7 +882,7 @@ overview of the main programs.
<dd><a name="index-pdfTeX-engine"></a>
<a name="index-etex-command"></a>
<a name="index-e_002dTeX"></a>
-<p>In TeX Live (<a href="http://tug.org/texlive">http://tug.org/texlive</a>), if LaTeX is invoked
+<a name="tex-engines-latex"></a><p>In TeX Live (<a href="http://tug.org/texlive">http://tug.org/texlive</a>), if LaTeX is invoked
via either the system command <code>latex</code> or <code>pdflatex</code>,
then the pdfTeX engine is run (<a href="http://ctan.org/pkg/pdftex">http://ctan.org/pkg/pdftex</a>).
When invoked as <code>latex</code>, the main output is a <samp>.dvi</samp>
@@ -857,7 +903,7 @@ assumed to be available in LaTeX.
<dt><code>lualatex</code></dt>
<dd><a name="index-lualatex-command"></a>
<a name="index-LuaTeX"></a>
-<p>If LaTeX is invoked via the system command <code>lualatex</code>, the
+<a name="tex-engines-lualatex"></a><p>If LaTeX is invoked via the system command <code>lualatex</code>, the
LuaTeX engine is run (<a href="http://ctan.org/pkg/luatex">http://ctan.org/pkg/luatex</a>). This
program allows code written in the scripting language Lua
(<a href="http://luatex.org">http://luatex.org</a>) to interact with TeX&rsquo;s typesetting.
@@ -872,7 +918,7 @@ but this is rarely used.
<a name="index-XeTeX"></a>
<a name="index-_002exdv-file"></a>
<a name="index-xdvipdfmx"></a>
-<p>If LaTeX is invoked with the system command <code>xelatex</code>, the
+<a name="tex-engines-xelatex"></a><p>If LaTeX is invoked with the system command <code>xelatex</code>, the
XeTeX engine is run (<a href="http://tug.org/xetex">http://tug.org/xetex</a>). Like LuaTeX,
XeTeX natively supports UTF-8 Unicode and TrueType and OpenType
fonts, though the implementation is completely different, mainly using
@@ -896,7 +942,7 @@ additional support for Japanese and other languages ([u]pTeX,
<a name="LaTeX-command-syntax"></a>
<div class="header">
<p>
-Previous: <a href="#TeX-engines" accesskey="p" rel="prev">TeX engines</a>, Up: <a href="#Overview" accesskey="u" rel="up">Overview</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#CTAN" accesskey="n" rel="next">CTAN</a>, Previous: <a href="#TeX-engines" accesskey="p" rel="prev">TeX engines</a>, Up: <a href="#Overview" accesskey="u" rel="up">Overview</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="LaTeX-command-syntax-1"></a>
<h3 class="section">2.4 LaTeX command syntax</h3>
@@ -941,7 +987,7 @@ commands it covers (barring unintentional omissions, a.k.a. bugs).
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Declaration" accesskey="2">Declaration</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Change the value or meaning of a command.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cmakeatletter-and-_005cmakeatother" accesskey="3">\makeatletter and \makeatother</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Change the status of the at-sign character.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cmakeatletter-_0026-_005cmakeatother" accesskey="3">\makeatletter &amp; \makeatother</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Change the status of the at-sign character.
</td></tr>
</table>
@@ -950,7 +996,7 @@ commands it covers (barring unintentional omissions, a.k.a. bugs).
<a name="Environment"></a>
<div class="header">
<p>
-Next: <a href="#Declaration" accesskey="n" rel="next">Declaration</a>, Up: <a href="#LaTeX-command-syntax" accesskey="u" rel="up">LaTeX command syntax</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Declaration" accesskey="n" rel="next">Declaration</a>, Up: <a href="#LaTeX-command-syntax" accesskey="u" rel="up">LaTeX command syntax</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Environments-1"></a>
<h4 class="subsection">2.4.1 Environments</h4>
@@ -974,7 +1020,7 @@ behavior. For instance, for poetry in LaTeX put the lines between
\end{verse}
</pre></div>
-<p>See&nbsp;<a href="#Environments">Environments</a> for a list of environments.
+<p>See <a href="#Environments">Environments</a> for a list of environments.
</p>
<p>The <var>environment name</var> at the beginning must exactly match that at
the end. This includes the case where <var>environment name</var> ends in a
@@ -997,7 +1043,7 @@ required (it specifies the formatting of columns).
<a name="Declaration"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cmakeatletter-and-_005cmakeatother" accesskey="n" rel="next">\makeatletter and \makeatother</a>, Previous: <a href="#Environment" accesskey="p" rel="prev">Environment</a>, Up: <a href="#LaTeX-command-syntax" accesskey="u" rel="up">LaTeX command syntax</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cmakeatletter-_0026-_005cmakeatother" accesskey="n" rel="next">\makeatletter &amp; \makeatother</a>, Previous: <a href="#Environment" accesskey="p" rel="prev">Environment</a>, Up: <a href="#LaTeX-command-syntax" accesskey="u" rel="up">LaTeX command syntax</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Command-declarations"></a>
<h4 class="subsection">2.4.2 Command declarations</h4>
@@ -1008,13 +1054,13 @@ changes the setting of page numbers from roman numerals to arabic.
</p>
<hr>
-<a name="g_t_005cmakeatletter-and-_005cmakeatother"></a>
+<a name="g_t_005cmakeatletter-_0026-_005cmakeatother"></a>
<div class="header">
<p>
-Previous: <a href="#Declaration" accesskey="p" rel="prev">Declaration</a>, Up: <a href="#LaTeX-command-syntax" accesskey="u" rel="up">LaTeX command syntax</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Declaration" accesskey="p" rel="prev">Declaration</a>, Up: <a href="#LaTeX-command-syntax" accesskey="u" rel="up">LaTeX command syntax</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cmakeatletter-and-_005cmakeatother-1"></a>
-<h4 class="subsection">2.4.3 <code>\makeatletter</code> and <code>\makeatother</code></h4>
+<a name="g_t_005cmakeatletter-_0026-_005cmakeatother-1"></a>
+<h4 class="subsection">2.4.3 <code>\makeatletter</code> &amp; <code>\makeatother</code></h4>
<p>Synopsis:
</p>
@@ -1061,9 +1107,9 @@ have the character code of a letter.
in their names see <a href="http://ctan.org/pkg/macros2e">http://ctan.org/pkg/macros2e</a>. These macros are
mainly intended to package or class authors.
</p>
-<p>The example below is typical. In the user&rsquo;s class file is a command
-<code>\thesis@universityname</code>. The user wants to change the
-definition. These three lines should go in the preamble, before the
+<p>In this example the class file has a command
+<code>\thesis@universityname</code> that the user wants to change. These
+three lines should go in the preamble, before the
<code>\begin{document}</code>.
</p>
<div class="example">
@@ -1082,7 +1128,7 @@ definition. These three lines should go in the preamble, before the
<a name="g_t_005c_0040ifstar"></a>
<div class="header">
<p>
-Up: <a href="#g_t_005cmakeatletter-and-_005cmakeatother" accesskey="u" rel="up">\makeatletter and \makeatother</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Up: <a href="#g_t_005cmakeatletter-_0026-_005cmakeatother" accesskey="u" rel="up">\makeatletter &amp; \makeatother</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005c_0040ifstar-1"></a>
<h4 class="subsubsection">2.4.3.1 <code>\@ifstar</code></h4>
@@ -1095,8 +1141,8 @@ Up: <a href="#g_t_005cmakeatletter-and-_005cmakeatother" accesskey="u" rel="up">
</p>
<div class="example">
<pre class="example">\newcommand{\mycmd}{\@ifstar{\mycmd@star}{\mycmd@nostar}}
-\newcommand{\mycmd@nostar}[<var>non-starred command number of args</var>]{<var>body of non-starred command</var>}
-\newcommand{\mycmd@star}[<var>starred command number of args</var>]{<var>body of starred command</var>}
+\newcommand{\mycmd@nostar}[<var>nostar-num-args</var>]{<var>nostar-body</var>}
+\newcommand{\mycmd@star}[<var>star-num-args</var>]{<var>star-body</var>}
</pre></div>
<p>Many standard LaTeX environments or commands have a variant with the
@@ -1117,7 +1163,7 @@ are <code>\mycmd@nostar</code> and <code>\mycmd@star</code>. They could take th
same number of arguments or a different number, or no arguments at all.
As always, in a LaTeX document a command using at-sign&nbsp;<code>@</code>
must be enclosed inside a <code>\makeatletter ... \makeatother</code> block
-(see <a href="#g_t_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</a>).
+(see <a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</a>).
</p>
<p>This example of <code>\@ifstar</code> defines the command <code>\ciel</code> and a
variant <code>\ciel*</code>. Both have one required argument. A call to
@@ -1131,15 +1177,16 @@ variant <code>\ciel*</code>. Both have one required argument. A call to
</pre></div>
<p>In the next example, the starred variant takes a different number of
-arguments than does the unstarred one. With this definition, Agent
-007&rsquo;s <code>``My name is \agentsecret*{Bond},
-\agentsecret{James}{Bond}.''</code> is equivalent to <code>``My name is
-\textsc{Bond}, \textit{James} textsc{Bond}.''</code>
+arguments than the unstarred one. With this definition, Agent 007&rsquo;s
+<code>``My name is \agentsecret*{Bond},
+\agentsecret{James}{Bond}.''</code> is equivalent to entering the commands
+<code>``My name is \textsc{Bond}, \textit{James} textsc{Bond}.''</code>
</p>
<div class="example">
<pre class="example">\newcommand*{\agentsecret@unstarred}[2]{\textit{#1} \textsc{#2}}
\newcommand*{\agentsecret@starred}[1]{\textsc{#1}}
-\newcommand*{\agentsecret}{\@ifstar{\agentsecret@starred}{\agentsecret@unstarred}}
+\newcommand*{\agentsecret}{%
+ \@ifstar{\agentsecret@starred}{\agentsecret@unstarred}}
</pre></div>
<p>There are two sometimes more convenient ways to accomplish the work of
@@ -1157,10 +1204,48 @@ LaTeX3 has the <samp>xparse</samp> package that allows this code.
<hr>
+<a name="CTAN"></a>
+<div class="header">
+<p>
+Previous: <a href="#LaTeX-command-syntax" accesskey="p" rel="prev">LaTeX command syntax</a>, Up: <a href="#Overview" accesskey="u" rel="up">Overview</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="CTAN_003a-Comprehensive-TeX-Archive-Network"></a>
+<h3 class="section">2.5 CTAN: Comprehensive TeX Archive Network</h3>
+
+<a name="index-CTAN"></a>
+
+<p>The Comprehensive TeX Archive Network, CTAN, is the TeX and
+LaTeX community&rsquo;s repository of free material. It is a set of
+Internet sites around the world that offer material related to LaTeX
+for download. Visit CTAN on the web at <a href="https://ctan.org">https://ctan.org</a>.
+</p>
+<p>This material is organized into packages, discrete bundles that
+typically offer some coherent functionality and are maintained by one
+person or a small number of people. For instance, many publishers have
+a package that allows authors to format papers to that publisher&rsquo;s
+specifications.
+</p>
+<p>In addition to the massive holdings, the web site offers features such
+as search by name or by functionality.
+</p>
+<a name="index-DANTE-e_002eV_002e"></a>
+<a name="index-mirrors-of-CTAN"></a>
+<p>CTAN is not a single site, but instead is a set of sites. One of the
+sites is the core. This site actively manages the material, for
+instance, by accepting uploads of new or updated packages. It is
+hosted by the German TeX group DANTE e.V. Other sites around the
+world help out by mirroring, that is, automatically syncing their
+collections with the core site and then in turn making their copies
+publicly available. This gives users close to their location better
+access and relieves the load on the core site. The list of mirrors is
+at <a href="https://ctan.org/mirrors">https://ctan.org/mirrors</a>.
+</p>
+
+<hr>
<a name="Document-classes"></a>
<div class="header">
<p>
-Next: <a href="#Fonts" accesskey="n" rel="next">Fonts</a>, Previous: <a href="#Overview" accesskey="p" rel="prev">Overview</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Fonts" accesskey="n" rel="next">Fonts</a>, Previous: <a href="#Overview" accesskey="p" rel="prev">Overview</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Document-classes-1"></a>
<h2 class="chapter">3 Document classes</h2>
@@ -1187,27 +1272,27 @@ see <a href="#Overview">Overview</a>.)
</p>
<dl compact="compact">
<dt><code>article</code></dt>
-<dd><p>For a journal article, a presentation, and miscellaneous general use.
+<dd><a name="document-classes-article"></a><p>For a journal article, a presentation, and miscellaneous general use.
</p>
</dd>
<dt><code>book</code></dt>
-<dd><p>Full-length books, including chapters and possibly including front
+<dd><a name="document-classes-book"></a><p>Full-length books, including chapters and possibly including front
matter, such as a preface, and back matter, such as an appendix
(see <a href="#Front_002fback-matter">Front/back matter</a>).
</p>
</dd>
<dt><code>letter</code></dt>
-<dd><p>Mail, optionally including mailing labels
+<dd><a name="document-classes-letter"></a><p>Mail, optionally including mailing labels
(see <a href="#Letters">Letters</a>).
</p>
</dd>
<dt><code>report</code></dt>
-<dd><p>For documents of length between an <code>article</code> and a <code>book</code>,
+<dd><a name="document-classes-report"></a><p>For documents of length between an <code>article</code> and a <code>book</code>,
such as technical reports or theses, which may contain several chapters.
</p>
</dd>
<dt><code>slides</code></dt>
-<dd><p>For slide presentations&mdash;rarely used today. In its place the
+<dd><a name="document-classes-slides"></a><p>For slide presentations&mdash;rarely used today. In its place the
<code>beamer</code> package is perhaps the most prevalent (see <a href="#beamer-template">beamer template</a>).
</p>
</dd>
@@ -1229,7 +1314,7 @@ such as technical reports or theses, which may contain several chapters.
<a name="Document-class-options"></a>
<div class="header">
<p>
-Next: <a href="#Additional-packages" accesskey="n" rel="next">Additional packages</a>, Up: <a href="#Document-classes" accesskey="u" rel="up">Document classes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Additional-packages" accesskey="n" rel="next">Additional packages</a>, Up: <a href="#Document-classes" accesskey="u" rel="up">Document classes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Document-class-options-1"></a>
<h3 class="section">3.1 Document class options</h3>
@@ -1239,9 +1324,9 @@ Next: <a href="#Additional-packages" accesskey="n" rel="next">Additional package
<a name="index-class-options"></a>
<a name="index-global-options"></a>
-<p>You can specify so-called <em>global options</em> or <em>class options</em> to
-the <code>\documentclass</code> command by enclosing them in square brackets.
-To specify more than one <var>option</var>, separate them with a comma, as in:
+<p>You can specify <em>global options</em> or <em>class options</em> to the
+<code>\documentclass</code> command by enclosing them in square brackets. To
+specify more than one <var>option</var>, separate them with a comma.
</p>
<div class="example">
<pre class="example">\documentclass[<var>option1</var>,<var>option2</var>,...]{<var>class</var>}
@@ -1408,7 +1493,7 @@ the time at the bottom of each note.
<a name="Additional-packages"></a>
<div class="header">
<p>
-Next: <a href="#Class-and-package-construction" accesskey="n" rel="next">Class and package construction</a>, Previous: <a href="#Document-class-options" accesskey="p" rel="prev">Document class options</a>, Up: <a href="#Document-classes" accesskey="u" rel="up">Document classes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Class-and-package-construction" accesskey="n" rel="next">Class and package construction</a>, Previous: <a href="#Document-class-options" accesskey="p" rel="prev">Document class options</a>, Up: <a href="#Document-classes" accesskey="u" rel="up">Document classes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Additional-packages-1"></a>
<h3 class="section">3.2 Additional packages</h3>
@@ -1439,7 +1524,7 @@ to the selected document class are passed on to the packages loaded with
<a name="Class-and-package-construction"></a>
<div class="header">
<p>
-Previous: <a href="#Additional-packages" accesskey="p" rel="prev">Additional packages</a>, Up: <a href="#Document-classes" accesskey="u" rel="up">Document classes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Additional-packages" accesskey="p" rel="prev">Additional packages</a>, Up: <a href="#Document-classes" accesskey="u" rel="up">Document classes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Class-and-package-construction-1"></a>
<h3 class="section">3.3 Class and package construction</h3>
@@ -1465,7 +1550,7 @@ SMC Math Department</code> is for a class.
<p>Inside of a class or package file you can use the at-sign <code>@</code> as a
character in command names without having to surround the code
containing that command with <code>\makeatletter</code> and
-<code>\makeatother</code>. See <a href="#g_t_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</a>. This allow
+<code>\makeatother</code>. See <a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</a>. This allow
you to create commands that users will not accidentally redefine.
Another technique is to preface class- or package-specific commands with
some string to prevent your class or package from interfering with
@@ -1485,7 +1570,7 @@ others. For instance, the class <code>smcmemo</code> might have commands
<a name="Class-and-package-structure"></a>
<div class="header">
<p>
-Next: <a href="#Class-and-package-commands" accesskey="n" rel="next">Class and package commands</a>, Up: <a href="#Class-and-package-construction" accesskey="u" rel="up">Class and package construction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Class-and-package-commands" accesskey="n" rel="next">Class and package commands</a>, Up: <a href="#Class-and-package-construction" accesskey="u" rel="up">Class and package construction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Class-and-package-structure-1"></a>
<h4 class="subsection">3.3.1 Class and package structure</h4>
@@ -1522,7 +1607,6 @@ most of its work: declaring new variables, commands and fonts, and
loading other files.
</li></ol>
-
<p>Here is a starting class file, which should be saved as <samp>stub.cls</samp>
where LaTeX can find it, for example in the same directory as the
<samp>.tex</samp> file.
@@ -1546,11 +1630,12 @@ Class Guide, at
of the descriptions here derive from this document), or the tutorial
<a href="https://www.tug.org/TUGboat/tb26-3/tb84heff.pdf">https://www.tug.org/TUGboat/tb26-3/tb84heff.pdf</a>.
</p>
+
<hr>
<a name="Class-and-package-commands"></a>
<div class="header">
<p>
-Previous: <a href="#Class-and-package-structure" accesskey="p" rel="prev">Class and package structure</a>, Up: <a href="#Class-and-package-construction" accesskey="u" rel="up">Class and package construction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Class-and-package-structure" accesskey="p" rel="prev">Class and package structure</a>, Up: <a href="#Class-and-package-construction" accesskey="u" rel="up">Class and package construction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Class-and-package-commands-1"></a>
<h4 class="subsection">3.3.2 Class and package commands</h4>
@@ -1648,10 +1733,10 @@ or <code>\DeclareOption*</code>.
<a name="index-package-options-1"></a>
<a name="index-options_002c-class"></a>
<a name="index-options_002c-package-1"></a>
-<p>Make an option available to a user, for invoking in their
+<p>Make an option available to a user to invoke in their
<code>\documentclass</code> command. For example, the <code>smcmemo</code> class
-could have an option allowing users to put the institutional logo on the
-first page with <code>\documentclass[logo]{smcmemo}</code>. The class file
+could have an option <code>\documentclass[logo]{smcmemo}</code> allowing
+users to put the institutional logo on the first page. The class file
must contain <code>\DeclareOption{logo}{<var>code</var>}</code> (and later,
<code>\ProcessOptions</code>).
</p>
@@ -1700,14 +1785,14 @@ command is used within a moving argument, use <code>\newcommand</code>.
</p>
<a name="index-package_002c-etoolbox"></a>
<a name="index-etoolbox-package"></a>
-
-<p>The <code>etoolbox</code> package offers commands <code>\newrobustcmd</code>,
-<code>\newrobustcmd*</code>, <code>\renewrobustcmd</code>, <code>\renewrobustcmd*</code>,
-<code>\providerobustcmd</code>, and <code>\providerobustcmd*</code> which are similar
-to <code>\newcommand</code>, <code>\newcommand*</code>, <code>\renewcommand</code>,
-<code>\renewcommand*</code>, <code>\providecommand</code>, and
-<code>\providecommand*</code>, but define a robust <var>cmd</var> with two advantages
-as compared to <code>\DeclareRobustCommand</code>:
+<p>The <samp>etoolbox</samp> package offers the commands
+<code>\newrobustcmd</code>, <code>\newrobustcmd*</code>, as well as the commands
+<code>\renewrobustcmd</code>, <code>\renewrobustcmd*</code>, and the commands
+<code>\providerobustcmd</code>, and <code>\providerobustcmd*</code>. These are
+similar to <code>\newcommand</code>, <code>\newcommand*</code>,
+<code>\renewcommand</code>, <code>\renewcommand*</code>, <code>\providecommand</code>, and
+<code>\providecommand*</code>, but define a robust <var>cmd</var> with two
+advantages as compared to <code>\DeclareRobustCommand</code>:
</p><ol>
<li> They use the low-level e-TeX protection mechanism rather than the
higher level LaTeX <code>\protect</code> mechanism, so they do not incur
@@ -1725,12 +1810,17 @@ commands, so they do not just make a log message when you redefine
<dt><code>\InputIfFileExists{<var>file name</var>}{<var>true code</var>}{<var>false code</var>}</code></dt>
<dd><a name="index-_005cIfFileExists"></a>
<a name="index-_005cInputIfFileExists"></a>
-<p>Execute <var>true code</var> if LaTeX can find the file <samp><var>file
-name</var></samp> and <var>false code</var> otherwise. In the second case it inputs the
-file immediately after executing <var>true code</var>. Thus
-<code>\IfFileExists{img.pdf}{\includegraphics{img.pdf}}{\typeout{WARNING:
-img.pdf not found}}</code> will include the graphic <samp>img.pdf</samp> if it is
-found but otherwise just give a warning.
+<p>Execute <var>true code</var> if LaTeX finds the file <samp><var>file
+name</var></samp> or <var>false code</var> otherwise. In the first case it executing
+<var>true code</var> and then inputs the file. Thus the command
+</p>
+<div class="example">
+<pre class="example">\IfFileExists{img.pdf}{%
+ \includegraphics{img.pdf}}{\typeout{!! img.pdf not found}
+</pre></div>
+
+<p>will include the graphic <samp>img.pdf</samp> if it is found and otherwise
+give a warning.
</p>
<p>This command looks for the file in all search paths that LaTeX uses,
not only in the current directory. To look only in the current
@@ -1753,12 +1843,16 @@ list</var>]{<var>class name</var>}[<var>release info</var>]</code>. An example
<var>release date</var> is optional. If present it must have the form
<var>YYYY/MM/DD</var>.
</p>
-<p>If you request a <var>release date</var> and the date of
-the package installed on your system is earlier, then you get a warning
-on the screen and in the log like <code>You have requested, on input
-line 4, version `2038/01/19' of document class article, but only version
-`2014/09/29 v1.4h Standard LaTeX document class' is available.</code>
+<p>If you request a <var>release date</var> and the date of the package
+installed on your system is earlier, then you get a warning on the
+screen and in the log like this.
</p>
+<div class="example">
+<pre class="example">You have requested, on input line 4, version `2038/01/19' of
+document class article, but only version `2014/09/29 v1.4h
+Standard LaTeX document class' is available.
+</pre></div>
+
<p>The command version <code>\LoadClassWithOptions</code> uses the list of
options for the current class. This means it ignores any options passed
to it via <code>\PassOptionsToClass</code>. This is a convenience command
@@ -1792,10 +1886,13 @@ like &lsquo;<samp>This file needs format `LaTeX2e' but this is `xxx'.</samp>&rsq
features, include the optional <var>format date</var> on which those features
were implemented. If present it must be in the form <code>YYYY/MM/DD</code>.
If the format version installed on your system is earlier than
-<var>format date</var> then you get a warning like &lsquo;<samp>You have requested
-release `2038/01/20' of LaTeX, but only release `2016/02/01' is
-available.</samp>&rsquo;
+<var>format date</var> then you get a warning like this.
</p>
+<div class="example">
+<pre class="example">You have requested release `2038/01/20' of LaTeX, but only
+release `2016/02/01' is available.
+</pre></div>
+
</dd>
<dt><code>\OptionNotUsed</code></dt>
<dd><a name="index-_005cOptionNotUsed"></a>
@@ -1822,17 +1919,22 @@ options.)
</p>
<p>If your own code is bringing in a package twice then you can collapse
that to once, for example replacing the two
-<code>\RequirePackage[landscape]{geometry}\RequirePackage[margins=1in]{geometry}</code>
-with the single
-<code>\RequirePackage[landscape,margins=1in]{geometry}</code>. But if you
-are loading a package that in turn loads another package then you need
-to queue up the options you desire for this other package. For
-instance, suppose the package <code>foo</code> loads the package
-<code>geometry</code>. Instead of
-<code>\RequirePackage{foo}\RequirePackage[draft]{graphics}</code> you must
-write <code>\PassOptionsToPackage{draft}{graphics}
-\RequirePackage{foo}</code>. (If <code>foo.sty</code> loads an option in conflict
-with what you want then you may have to look into altering its source.)
+<code>\RequirePackage[landscape]{geometry}</code> and
+<code>\RequirePackage[margins=1in]{geometry}</code> with the single command
+<code>\RequirePackage[landscape,margins=1in]{geometry}</code>.
+</p>
+<p>However, imagine that you are loading <samp>firstpkg</samp> and inside that
+package it loads <samp>secondpkg</samp>, and you need the second package to be
+loaded with option <code>draft</code>. Then before doing the first package
+you must queue up the options for the second package, like this.
+</p>
+<div class="example">
+<pre class="example">\PassOptionsToPackage{draft}{secondpkg}
+\RequirePackage{firstpkg}
+</pre></div>
+
+<p>(If <code>firstpkg.sty</code> loads an option in conflict with what you want
+then you may have to alter its source.)
</p>
<p>These commands are useful for general users as well as class and package
writers. For instance, suppose a user wants to load the <code>graphicx</code>
@@ -1883,7 +1985,6 @@ options in the order specified in the calling commands, rather than in
the order of declaration in the class or package. For a package this
means that the global options are processed first.
</p>
-
</dd>
<dt><code>\ProvidesClass{<var>class name</var>}[<var>release date</var> <var>brief additional information</var>]</code></dt>
<dt><code>\ProvidesClass{<var>class name</var>}[<var>release date</var>]</code></dt>
@@ -1891,34 +1992,36 @@ means that the global options are processed first.
<dt><code>\ProvidesPackage{<var>package name</var>}[<var>release date</var>]</code></dt>
<dd><a name="index-_005cProvidesClass"></a>
<a name="index-_005cProvidesPackage"></a>
-<p>Identifies the class or package, printing a message to the screen and the log file.
+<p>Identifies the class or package, printing a message to the screen and
+the log file.
</p>
-<p>When a user writes <code>\documentclass{smcmemo}</code> then LaTeX loads
-the file <samp>smcmemo.cls</samp>. Similarly, a user writing
-<code>\usepackage{test}</code> prompts LaTeX to load the file
-<code>test.sty</code>. If the name of the file does not match the declared
-class or package name then you get a warning. Thus, if you invoke
+<p>When you load a class or package, for example with
+<code>\documentclass{smcmemo}</code> or <code>\usepackage{test}</code>, LaTeX
+inputs a file. If the name of the file does not match the class or
+package name declared in it then you get a warning. Thus, if you invoke
<code>\documentclass{smcmemo}</code>, and the file <samp>smcmemo.cls</samp> has
the statement <code>\ProvidesClass{xxx}</code> then you get a warning like
<code>You have requested document class `smcmemo', but the document
class provides 'xxx'.</code> This warning does not prevent LaTeX from
processing the rest of the class file normally.
</p>
-<p>If you include the optional argument, then you must include the date, before
-the first space if any, and it must have the form <code>YYYY/MM/DD</code>. The rest
-of the optional argument is free-form, although it traditionally identifies
-the class, and is written to the screen during compilation and to the
-log file. Thus, if your file <samp>smcmemo.cls</samp> contains the line
-<code>\ProvidesClass{smcmemo}[2008/06/01 v1.0 SMC memo class]</code> and your
-document&rsquo;s first line is <code>\documentclass{smcmemo}</code> then you will
-see <code>Document Class: smcmemo 2008/06/01 v1.0 SMC memo class</code>.
+<p>If you include the optional argument then you must include a date,
+before any spaces, of the form <code>YYYY/MM/DD</code>. The rest of the
+optional argument is free-form, although it traditionally identifies the
+class, and is written to the screen during compilation and to the log
+file. Thus, if your file <samp>smcmemo.cls</samp> contains the line
+<code>\ProvidesClass{smcmemo}[2008/06/01 v1.0 SMC memo class]</code> and
+your document&rsquo;s first line is <code>\documentclass{smcmemo}</code> then you
+will see <code>Document Class: smcmemo 2008/06/01 v1.0 SMC memo class</code>.
</p>
<p>The date in the optional argument allows class and package users to ask
-to be warned if the version of the class or package installed on their
-system is earlier than <var>release date</var>, by using the optional arguments
-such as <code>\documentclass{smcmemo}[2018/10/12]</code> or
-<code>\usepackage{foo}[[2017/07/07]]</code>. (Note that package users only
-rarely include a date, and class users almost never do.)
+to be warned if the version of the class or package is earlier than
+<var>release date</var>. For instance, a user could enter
+<code>\documentclass{smcmemo}[2018/10/12]</code> or
+<code>\usepackage{foo}[[2017/07/07]]</code> to require a class or package
+with certain features by specifying that it must be released no earlier
+than the given date. (Although, in practice package users only rarely
+include a date, and class users almost never do.)
</p>
</dd>
<dt><code>\ProvidesFile{<var>file name</var>}[<var>additional information</var>]</code></dt>
@@ -1935,11 +2038,10 @@ file and you get in the log a string like <code>File: test.config
<dt><code>\RequirePackageWithOptions{<var>package name</var>}[<var>release date</var>]</code></dt>
<dd><a name="index-_005cRequirePackage"></a>
<a name="index-_005cRequirePackageWithOptions"></a>
-<p>Load a package, like the document author command <code>\usepackage</code>.
-See <a href="#Additional-packages">Additional packages</a>. An example is
-<code>\RequirePackage[landscape,margin=1in]{geometry}</code>. Note that the
-LaTeX development team strongly recommends use of these commands over
-Plain&nbsp;TeX&rsquo;s <code>\input</code>; see the Class Guide.
+<p>Load a package, like the command <code>\usepackage</code> (see <a href="#Additional-packages">Additional packages</a>). The LaTeX development team strongly recommends use of
+these commands over Plain&nbsp;TeX&rsquo;s <code>\input</code>; see the Class
+Guide. An example is
+<code>\RequirePackage[landscape,margin=1in]{geometry}</code>.
</p>
<p>The <var>option list</var>, if present, is a comma-separated list. The
<var>release date</var>, if present, must have the form <var>YYYY/MM/DD</var>. If
@@ -1968,7 +2070,7 @@ causes LaTeX to give error like <code>\usepackage before
<a name="Fonts"></a>
<div class="header">
<p>
-Next: <a href="#Layout" accesskey="n" rel="next">Layout</a>, Previous: <a href="#Document-classes" accesskey="p" rel="prev">Document classes</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Layout" accesskey="n" rel="next">Layout</a>, Previous: <a href="#Document-classes" accesskey="p" rel="prev">Document classes</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Fonts-1"></a>
<h2 class="chapter">4 Fonts</h2>
@@ -1993,7 +2095,7 @@ and a style. The LaTeX commands for doing this are described here.
<a name="Font-styles"></a>
<div class="header">
<p>
-Next: <a href="#Font-sizes" accesskey="n" rel="next">Font sizes</a>, Up: <a href="#Fonts" accesskey="u" rel="up">Fonts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Font-sizes" accesskey="n" rel="next">Font sizes</a>, Up: <a href="#Fonts" accesskey="u" rel="up">Fonts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Font-styles-1"></a>
<h3 class="section">4.1 Font styles</h3>
@@ -2004,30 +2106,28 @@ Next: <a href="#Font-sizes" accesskey="n" rel="next">Font sizes</a>, Up: <a href
<p>The following type style commands are supported by LaTeX.
</p>
-<p>This first group of commands is typically used with an argument, as in
-<code>\textit{<var>text</var>}</code>. In the table below, the corresponding
-command in parenthesis is the &ldquo;declaration form&rdquo;, which takes no
-arguments, as in <code>{\itshape <var>text</var>}</code>. The scope of the
-declaration form lasts until the next type style command or the end of
-the current group.
-</p>
-<p>These commands, in both the argument form and the declaration form,
-are cumulative; e.g., you can say either <code>\sffamily\bfseries</code> or
-<code>\bfseries\sffamily</code> to get bold sans serif.
+<p>In the table below the listed commands, the <code>\text...</code> commands,
+is used with an argument, as in <code>\textit{<var>text</var>}</code>. This is
+the preferred form. But shown after it, in parenthesis, is the
+corresponding declaration form, which is sometimes useful. This form
+takes no arguments, as in <code>{\itshape <var>text</var>}</code>. The scope of
+the declaration form lasts until the next type style command or the end
+of the current group. In addition, each has an environment form such as
+<code>\begin{itshape}...\end{itshape}</code>.
</p>
-<p>You can alternatively use an environment form of the declarations; for
-instance, <code>\begin{ttfamily}...\end{ttfamily}</code>.
+<p>These commands, in both the argument form and the declaration form, are
+cumulative; for instance you can get bold sans serif by saying either of
+<code>\sffamily\bfseries</code> or <code>\bfseries\sffamily</code>.
</p>
<a name="index-_005cnocorrlist"></a>
<a name="index-_005cnocorr"></a>
-<p>These font-switching commands automatically insert italic corrections
-if needed. (See <a href="#g_t_005c_002f">\/</a>, for the details of italic corrections.)
-Specifically, they insert the italic correction unless the following
-character is in the list <code>\nocorrlist</code>, which by default consists
-of a period and a comma. To suppress the automatic insertion of
-italic correction, use <code>\nocorr</code> at the start or end of the
-command argument, such as <code>\textit{\nocorr text}</code> or
-<code>\textsc{text \nocorr}</code>.
+<p>One advantage of these commands is that they automatically insert italic
+corrections if needed (see <a href="#g_t_005c_002f">\/</a>). Specifically, they insert the
+italic correction unless the following character is in the list
+<code>\nocorrlist</code>, which by default consists of a period and a comma.
+To suppress the automatic insertion of italic correction, use
+<code>\nocorr</code> at the start or end of the command argument, such as
+<code>\textit{\nocorr text}</code> or <code>\textsc{text \nocorr}</code>.
</p>
<dl compact="compact">
<dt><code>\textrm (\rmfamily)</code></dt>
@@ -2102,10 +2202,14 @@ text</var> \emph{<var>middle text</var>} <var>end text</var>}</code> will result
will be in roman.
</p>
<p>LaTeX also provides the following commands, which unconditionally
-switch to the given style, that is, are <em>not</em> cumulative. Also,
-they are used differently than the above commands:
-<code>{\<var>cmd</var>...}</code> instead of <code>\<var>cmd</var>{...}</code>. These
-are two unrelated constructs.
+switch to the given style, that is, are <em>not</em> cumulative. They are
+used as declarations: <code>{\<var>cmd</var>...}</code> instead of
+<code>\<var>cmd</var>{...}</code>.
+</p>
+<p>(The unconditional commands below are an older version of font
+switching. The earlier commands are an improvement in most
+circumstances. But sometimes an unconditional font switch is precisely
+what you want.)
</p>
<dl compact="compact">
<dt><code>\bf</code>
@@ -2172,13 +2276,6 @@ are two unrelated constructs.
<p>The <code>\em</code> command is the unconditional version of <code>\emph</code>.
</p>
-<p>(Some people consider the unconditional font-switching commands, such
-as <code>\tt</code>, obsolete and that only the cumulative commands
-(<code>\texttt</code>) should be used. Others think that both sets of
-commands have their place and sometimes an unconditional font switch
-is precisely what you want; for one example,
-see <a href="#description"><code>description</code></a>.)
-</p>
<p>The following commands are for use in math mode. They are not
cumulative, so <code>\mathbf{\mathit{<var>symbol</var>}}</code> does not
create a boldface and italic <var>symbol</var>; instead, it will just be in
@@ -2253,7 +2350,7 @@ are provided to make them the default. FAQ entry:
<a name="Font-sizes"></a>
<div class="header">
<p>
-Next: <a href="#Low_002dlevel-font-commands" accesskey="n" rel="next">Low-level font commands</a>, Previous: <a href="#Font-styles" accesskey="p" rel="prev">Font styles</a>, Up: <a href="#Fonts" accesskey="u" rel="up">Fonts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Low_002dlevel-font-commands" accesskey="n" rel="next">Low-level font commands</a>, Previous: <a href="#Font-styles" accesskey="p" rel="prev">Font styles</a>, Up: <a href="#Fonts" accesskey="u" rel="up">Fonts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Font-sizes-1"></a>
<h3 class="section">4.2 Font sizes</h3>
@@ -2292,17 +2389,28 @@ size used (in points) with the &lsquo;<samp>10pt</samp>&rsquo;, &lsquo;<samp>11p
<tr><td><code>\Huge</code></td><td>24.88</td><td>24.88</td><td>24.88</td></tr>
</table>
-<p>The commands as listed here are &ldquo;declaration forms&rdquo;. The scope of
-the declaration form lasts until the next type style command or the
-end of the current group. You can also use the environment form of
-these commands; for instance, <code>\begin{tiny}...\end{tiny}</code>.
+<p>The commands are listed here in declaration forms. You use them by
+declaring them, as with this example.
+</p>
+<div class="example">
+<pre class="example">\begin{quotation} \small
+ The Tao that can be named is not the eternal Tao.
+\end{quotation}
+</pre></div>
+
+<p>The scope of the <code>\small</code> lasts until the end of the
+<code>quotation</code> environment. It would also end at the next type style
+command or the end of the current group, so you could enclose it in
+extra curly braces <code>{\small We are here, we are here, we are
+here!}</code>. You can instead use the environment form of these commands;
+for instance, <code>\begin{tiny}...\end{tiny}</code>.
</p>
<hr>
<a name="Low_002dlevel-font-commands"></a>
<div class="header">
<p>
-Previous: <a href="#Font-sizes" accesskey="p" rel="prev">Font sizes</a>, Up: <a href="#Fonts" accesskey="u" rel="up">Fonts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Font-sizes" accesskey="p" rel="prev">Font sizes</a>, Up: <a href="#Fonts" accesskey="u" rel="up">Fonts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Low_002dlevel-font-commands-1"></a>
<h3 class="section">4.3 Low-level font commands</h3>
@@ -2315,6 +2423,7 @@ packages. The commands listed here are only a subset of the available
ones.
</p>
<dl compact="compact">
+<dd><a name="low-level-font-commands-fontencoding"></a></dd>
<dt><code>\fontencoding{<var>encoding</var>}</code></dt>
<dd><a name="index-_005cfontencoding"></a>
<p>Select the font encoding, the encoding of the output font. There are a
@@ -2326,7 +2435,7 @@ accented characters used by the most widespread European languages
hyphenate words containing accented letters. For more, see
<a href="https://ctan.org/pkg/encguide">https://ctan.org/pkg/encguide</a>.
</p>
-</dd>
+<a name="low-level-font-commands-fontfamily"></a></dd>
<dt><code>\fontfamily{<var>family</var>}</code></dt>
<dd><a name="index-_005cfontfamily"></a>
<a name="index-families_002c-of-fonts"></a>
@@ -2334,7 +2443,7 @@ hyphenate words containing accented letters. For more, see
<p>Select the font family. The web page
<a href="http://www.tug.dk/FontCatalogue/">http://www.tug.dk/FontCatalogue/</a> provides one way to browse
through many of the fonts easily used with LaTeX. Here are
-examples of some common families:
+examples of some common families.
</p>
<table>
<tr><td><code>pag</code></td><td>Avant Garde</td></tr>
@@ -2360,7 +2469,7 @@ examples of some common families:
</table>
-</dd>
+<a name="low-level-font-commands-fontseries"></a></dd>
<dt><code>\fontseries{<var>series</var>}</code></dt>
<dd><a name="index-_005cfontseries"></a>
<a name="index-series_002c-of-fonts"></a>
@@ -2395,7 +2504,6 @@ combinations. Some common combined series values include:
<p>The possible values for width, individually, are (the meaning and
relationship of these terms varies with individual typefaces):
</p>
-
<table>
<tr><td><code>uc</code></td><td>Ultra condensed</td></tr>
<tr><td><code>ec</code></td><td>Extra condensed</td></tr>
@@ -2408,7 +2516,6 @@ relationship of these terms varies with individual typefaces):
<tr><td><code>ux</code></td><td>Ultra expanded</td></tr>
</table>
-
<p>When forming the <var>series</var> string from the weight and width, drop the
<code>m</code> that stands for medium weight or medium width, unless both
weight and width are <code>m</code>, in which case use just one
@@ -2418,7 +2525,7 @@ weight and width are <code>m</code>, in which case use just one
<dt><code>\fontshape{<var>shape</var>}</code></dt>
<dd><a name="index-_005cfontshape"></a>
<a name="index-shapes_002c-of-fonts"></a>
-<p>Select font shape. Valid shapes are:
+<a name="low-level-font-commands-fontshape"></a><p>Select font shape. Valid shapes are:
</p>
<table>
<tr><td><code>n</code></td><td>Upright (normal)</td></tr>
@@ -2429,11 +2536,10 @@ weight and width are <code>m</code>, in which case use just one
<tr><td><code>ol</code></td><td>Outline</td></tr>
</table>
-
<p>The two last shapes are not available for most font families, and
small caps are often missing as well.
</p>
-</dd>
+<a name="low-level-font-commands-fontsize"></a></dd>
<dt><code>\fontsize{<var>size</var>}{<var>skip</var>}</code></dt>
<dd><a name="index-_005cfontsize"></a>
<a name="index-font-size"></a>
@@ -2446,7 +2552,7 @@ the Computer Modern typeface is 1.2 times the <code>\fontsize</code>.
Changing <code>\baselineskip</code> directly is inadvisable since its value is
reset every time a size change happens; see <code>\baselinestretch</code>, next.
</p>
-</dd>
+<a name="low-level-font-commands-baselinestretch"></a></dd>
<dt><code>\baselinestretch</code></dt>
<dd><a name="index-_005cbaselinestretch"></a>
<p>LaTeX multiplies the line spacing by the value of the
@@ -2466,7 +2572,7 @@ options, this package keeps the line spacing single-spaced in places
where that is typically desirable, such as footnotes and figure
captions. See the package documentation.
</p>
-</dd>
+<a name="low-level-font-commands-linespread"></a></dd>
<dt><code>\linespread{<var>factor</var>}</code></dt>
<dd><a name="index-_005clinespread"></a>
<p>Equivalent to
@@ -2475,7 +2581,7 @@ therefore must be followed by <code>\selectfont</code> to have any effect.
Best specified in the preamble, or use the <code>setspace</code> package, as
just described.
</p>
-</dd>
+<a name="low-level-font-commands-selectfont"></a></dd>
<dt><code>\selectfont</code></dt>
<dd><a name="index-_005cselectfont"></a>
<p>The effects of the font commands described above do not happen until
@@ -2485,7 +2591,7 @@ to put this in a macro:<br>
<code>\newcommand*{\myfont}{\fontfamily{<var>familyname</var>}\selectfont}</code><br>
(see <a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a>).
</p>
-</dd>
+<a name="low-level-font-commands-usefont"></a></dd>
<dt><code>\usefont{<var>enc</var>}{<var>family</var>}{<var>series</var>}{<var>shape</var>}</code></dt>
<dd><a name="index-_005cusefont"></a>
<p>The same as invoking <code>\fontencoding</code>, <code>\fontfamily</code>,
@@ -2504,7 +2610,7 @@ followed by <code>\selectfont</code>. For example:
<a name="Layout"></a>
<div class="header">
<p>
-Next: <a href="#Sectioning" accesskey="n" rel="next">Sectioning</a>, Previous: <a href="#Fonts" accesskey="p" rel="prev">Fonts</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Sectioning" accesskey="n" rel="next">Sectioning</a>, Previous: <a href="#Fonts" accesskey="p" rel="prev">Fonts</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Layout-1"></a>
<h2 class="chapter">5 Layout</h2>
@@ -2533,7 +2639,7 @@ Next: <a href="#Sectioning" accesskey="n" rel="next">Sectioning</a>, Previous: <
<a name="g_t_005conecolumn"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005ctwocolumn" accesskey="n" rel="next">\twocolumn</a>, Up: <a href="#Layout" accesskey="u" rel="up">Layout</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005ctwocolumn" accesskey="n" rel="next">\twocolumn</a>, Up: <a href="#Layout" accesskey="u" rel="up">Layout</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005conecolumn-1"></a>
<h3 class="section">5.1 <code>\onecolumn</code></h3>
@@ -2541,18 +2647,23 @@ Next: <a href="#g_t_005ctwocolumn" accesskey="n" rel="next">\twocolumn</a>, Up:
<a name="index-_005conecolumn"></a>
<a name="index-one_002dcolumn-output"></a>
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\onecolumn
+</pre></div>
+
<p>Start a new page and produce single-column output. If the document is
given the class option <code>onecolumn</code> then this is the default
-behavior (see <a href="#Document-class-options">Document class options</a>).
-</p>
-<p>This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
+behavior (see <a href="#Document-class-options">Document class options</a>). This command is fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
</p>
<hr>
<a name="g_t_005ctwocolumn"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cflushbottom" accesskey="n" rel="next">\flushbottom</a>, Previous: <a href="#g_t_005conecolumn" accesskey="p" rel="prev">\onecolumn</a>, Up: <a href="#Layout" accesskey="u" rel="up">Layout</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cflushbottom" accesskey="n" rel="next">\flushbottom</a>, Previous: <a href="#g_t_005conecolumn" accesskey="p" rel="prev">\onecolumn</a>, Up: <a href="#Layout" accesskey="u" rel="up">Layout</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005ctwocolumn-1"></a>
<h3 class="section">5.2 <code>\twocolumn</code></h3>
@@ -2570,21 +2681,20 @@ Next: <a href="#g_t_005cflushbottom" accesskey="n" rel="next">\flushbottom</a>,
<p>Start a new page and produce two-column output. If the document is given
the class option <code>twocolumn</code> then this is the default
-(see <a href="#Document-class-options">Document class options</a>).
+(see <a href="#Document-class-options">Document class options</a>). This command is fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
</p>
<p>If the optional <var>prelim one column text</var> argument
is present, it is typeset in one-column mode before the two-column
typesetting starts.
</p>
-<p>This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
-</p>
<p>These parameters control typesetting in two-column output:
</p>
<dl compact="compact">
<dt><code>\columnsep</code>
<a name="index-_005ccolumnsep"></a>
</dt>
-<dd><p>The distance between columns. The default is 35pt. Change it with a
+<dd><a name="twocolumn-columnsep"></a><p>The distance between columns. The default is 35pt. Change it with a
command such as <code>\setlength{\columnsep}{40pt}</code> You must change
it before the two column environment starts; in the preamble is a good
place.
@@ -2593,7 +2703,7 @@ place.
<dt><code>\columnseprule</code>
<a name="index-_005ccolumnseprule"></a>
</dt>
-<dd><p>The width of the rule between columns. The rule appears halfway between
+<dd><a name="twocolumn-columnseprule"></a><p>The width of the rule between columns. The rule appears halfway between
the two columns. The default is 0pt, meaning that there is no rule.
Change it with a command such as
<code>\setlength{\columnseprule}{0.4pt}</code>, before the two-column
@@ -2603,7 +2713,7 @@ environment starts.
<dt><code>\columnwidth</code>
<a name="index-_005ccolumnwidth"></a>
</dt>
-<dd><p>The width of a single column. In one-column mode this is equal to
+<dd><a name="twocolumn-columnwidth"></a><p>The width of a single column. In one-column mode this is equal to
<code>\textwidth</code>. In two-column mode by default LaTeX sets the
width of each of the two columns to be half of <code>\textwidth</code> minus
<code>\columnsep</code>.
@@ -2618,6 +2728,7 @@ and see <a href="#table">table</a>). LaTeX places starred floats at the top of a
The following parameters control float behavior of two-column output.
</p>
<dl compact="compact">
+<dd><a name="twocolumn-dbltopfraction"></a></dd>
<dt><code>\dbltopfraction</code>
<a name="index-_005cdbltopfraction"></a>
</dt>
@@ -2639,10 +2750,10 @@ the bulky float on a page by itself, as well as at the top of a page.
to avoid going to float pages so soon.
</li></ul>
-<p>You can redefine it, for instance with
+<p>You can redefine it, as with
<code>\renewcommand{\dbltopfraction}{0.9}</code>.
</p>
-</dd>
+<a name="twocolumn-dblfloatpagefraction"></a></dd>
<dt><code>\dblfloatpagefraction</code>
<a name="index-_005cdblfloatpagefraction"></a>
</dt>
@@ -2650,7 +2761,7 @@ to avoid going to float pages so soon.
that must be occupied by floats, limiting the amount of blank space.
LaTeX&rsquo;s default is <code>0.5</code>. Change it with <code>\renewcommand</code>.
</p>
-</dd>
+<a name="twocolumn-dblfloatsep"></a></dd>
<dt><code>\dblfloatsep</code>
<a name="index-_005cdblfloatsep"></a>
</dt>
@@ -2660,7 +2771,7 @@ between floats, at both the top and bottom of the page. The default is
<code>11pt</code>, and <code>14pt plus2pt minus4pt</code> for a document set at
<code>12pt</code>.
</p>
-</dd>
+<a name="twocolumn-dbltextfloatsep"></a></dd>
<dt><code>\dbltextfloatsep</code>
<a name="index-_005cdbltextfloatsep"></a>
</dt>
@@ -2668,7 +2779,7 @@ between floats, at both the top and bottom of the page. The default is
bottom of a page and the main text. The default is <code>20pt plus2pt
minus4pt</code>.
</p>
-</dd>
+<a name="twocolumn-dbltopnumber"></a></dd>
<dt><code>\dbltopnumber</code>
<a name="index-_005cdbltopnumber"></a>
</dt>
@@ -2707,7 +2818,7 @@ Two column text here.
<a name="g_t_005cflushbottom"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005craggedbottom" accesskey="n" rel="next">\raggedbottom</a>, Previous: <a href="#g_t_005ctwocolumn" accesskey="p" rel="prev">\twocolumn</a>, Up: <a href="#Layout" accesskey="u" rel="up">Layout</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005craggedbottom" accesskey="n" rel="next">\raggedbottom</a>, Previous: <a href="#g_t_005ctwocolumn" accesskey="p" rel="prev">\twocolumn</a>, Up: <a href="#Layout" accesskey="u" rel="up">Layout</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cflushbottom-1"></a>
<h3 class="section">5.3 <code>\flushbottom</code></h3>
@@ -2737,7 +2848,7 @@ is to, in a final editing stage, adjust the height of individual pages
<a name="g_t_005craggedbottom"></a>
<div class="header">
<p>
-Next: <a href="#Page-layout-parameters" accesskey="n" rel="next">Page layout parameters</a>, Previous: <a href="#g_t_005cflushbottom" accesskey="p" rel="prev">\flushbottom</a>, Up: <a href="#Layout" accesskey="u" rel="up">Layout</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Page-layout-parameters" accesskey="n" rel="next">Page layout parameters</a>, Previous: <a href="#g_t_005cflushbottom" accesskey="p" rel="prev">\flushbottom</a>, Up: <a href="#Layout" accesskey="u" rel="up">Layout</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005craggedbottom-1"></a>
<h3 class="section">5.4 <code>\raggedbottom</code></h3>
@@ -2758,7 +2869,7 @@ option (see <a href="#Document-class-options">Document class options</a>).
<a name="Page-layout-parameters"></a>
<div class="header">
<p>
-Next: <a href="#Floats" accesskey="n" rel="next">Floats</a>, Previous: <a href="#g_t_005craggedbottom" accesskey="p" rel="prev">\raggedbottom</a>, Up: <a href="#Layout" accesskey="u" rel="up">Layout</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Floats" accesskey="n" rel="next">Floats</a>, Previous: <a href="#g_t_005craggedbottom" accesskey="p" rel="prev">\raggedbottom</a>, Up: <a href="#Layout" accesskey="u" rel="up">Layout</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Page-layout-parameters-1"></a>
<h3 class="section">5.5 Page layout parameters</h3>
@@ -2783,7 +2894,7 @@ Next: <a href="#Floats" accesskey="n" rel="next">Floats</a>, Previous: <a href="
<dd><a name="index-_005ccolumnsep-2"></a>
<a name="index-_005ccolumnseprule-2"></a>
<a name="index-_005ccolumnwidth-2"></a>
-<p>The distance between the two columns, the width of a rule between the
+<a name="page-layout-parameters-columnsep"></a><a name="page-layout-parameters-columnseprule"></a><a name="page-layout-parameters-columnwidth"></a><p>The distance between the two columns, the width of a rule between the
columns, and the width of the columns, when the document class option
<code>twocolumn</code> is in effect (see <a href="#Document-class-options">Document class options</a>).
See <a href="#g_t_005ctwocolumn">\twocolumn</a>.
@@ -2793,7 +2904,7 @@ See <a href="#g_t_005ctwocolumn">\twocolumn</a>.
<a name="index-_005cheadheight"></a>
</dt>
<dd><a name="index-_005cheadheight-1"></a>
-<p>Height of the box that contains the running head. The default in the
+<a name="page-layout-parameters-headheight"></a><p>Height of the box that contains the running head. The default in the
<code>article</code>, <code>report</code>, and <code>book</code> classes is &lsquo;<samp>12pt</samp>&rsquo;,
at all type sizes.
</p>
@@ -2802,7 +2913,7 @@ at all type sizes.
<a name="index-_005cheadsep"></a>
</dt>
<dd><a name="index-_005cheadsep-1"></a>
-<p>Vertical distance between the bottom of the header line and the top of
+<a name="page-layout-parameters-headsep"></a><p>Vertical distance between the bottom of the header line and the top of
the main text. The default in the <code>article</code> and <code>report</code>
classes is &lsquo;<samp>25pt</samp>&rsquo;. In the <code>book</code> class the default is: if the
document is set at 10pt then it is &lsquo;<samp>0.25in</samp>&rsquo;, and at 11pt and 12pt
@@ -2813,7 +2924,7 @@ it is &lsquo;<samp>0.275in</samp>&rsquo;.
<a name="index-_005cfootskip"></a>
</dt>
<dd><a name="index-_005cfootskip-1"></a>
-<p>Distance from the baseline of the last line of text to the baseline of
+<a name="page-layout-parameters-footskip"></a><p>Distance from the baseline of the last line of text to the baseline of
the page footer. The default in the <code>article</code> and <code>report</code>
classes is &lsquo;<samp>30pt</samp>&rsquo;. In the <code>book</code> class the default is: when
the type size is 10pt the default is &lsquo;<samp>0.35in</samp>&rsquo;, while at 11pt it is
@@ -2824,7 +2935,7 @@ the type size is 10pt the default is &lsquo;<samp>0.35in</samp>&rsquo;, while at
<a name="index-_005clinewidth"></a>
</dt>
<dd><a name="index-_005clinewidth-1"></a>
-<p>Width of the current line, decreased for each nested <code>list</code>
+<a name="page-layout-parameters-linewidth"></a><p>Width of the current line, decreased for each nested <code>list</code>
(see <a href="#list">list</a>). That is, the nominal value for <code>\linewidth</code> is to
equal <code>\textwidth</code> but for each nested list the <code>\linewidth</code>
is decreased by the sum of that list&rsquo;s <code>\leftmargin</code> and
@@ -2843,7 +2954,7 @@ is decreased by the sum of that list&rsquo;s <code>\leftmargin</code> and
<dd><a name="index-_005cmarginparpush-1"></a>
<a name="index-_005cmarginsep-1"></a>
<a name="index-_005cmarginparwidth-1"></a>
-<p>The minimum vertical space between two marginal notes, the horizontal
+<a name="page-layout-parameters-marginparpush"></a><a name="page-layout-parameters-marginsep"></a><a name="page-layout-parameters-marginparwidth"></a><p>The minimum vertical space between two marginal notes, the horizontal
space between the text body and the marginal notes, and the horizontal
width of the notes.
</p>
@@ -2876,7 +2987,7 @@ distance.
</dt>
<dd><a name="index-_005coddsidemargin-2"></a>
<a name="index-_005cevensidemargin-2"></a>
-<p>The <code>\oddsidemargin</code> is the extra distance between the left side of
+<a name="page-layout-parameters-oddsidemargin"></a><a name="page-layout-parameters-evensidemargin"></a><p>The <code>\oddsidemargin</code> is the extra distance between the left side of
the page and the text&rsquo;s left margin, on odd-numbered pages when the
document class option <code>twoside</code> is chosen and on all pages when
<code>oneside</code> is in effect. When <code>twoside</code> is in effect, on
@@ -2892,8 +3003,8 @@ difference between <code>\paperwidth</code> and <code>\textwidth</code>, and
<a name="index-_005cpaperheight"></a>
</dt>
<dd><a name="index-_005cpaperheight-1"></a>
-<p>The height of the paper, as distinct from the height of the print area.
-It is normally set with a document class option, as in
+<a name="page-layout-parameters-paperheight"></a><p>The height of the paper, as distinct from the height of the print area.
+Normally set with a document class option, as in
<code>\documentclass[a4paper]{article}</code> (see <a href="#Document-class-options">Document class options</a>).
</p>
</dd>
@@ -2901,8 +3012,8 @@ It is normally set with a document class option, as in
<a name="index-_005cpaperwidth"></a>
</dt>
<dd><a name="index-_005cpaperwidth-1"></a>
-<p>The width of the paper, as distinct from the width of the print area.
-It is normally set with a document class option, as in
+<a name="page-layout-parameters-paperwidth"></a><p>The width of the paper, as distinct from the width of the print area.
+Normally set with a document class option, as in
<code>\documentclass[a4paper]{article}</code> (see <a href="#Document-class-options">Document class options</a>).
</p>
</dd>
@@ -2910,7 +3021,7 @@ It is normally set with a document class option, as in
<a name="index-_005ctextheight"></a>
</dt>
<dd><a name="index-_005ctextheight-1"></a>
-<p>The normal vertical height of the page body. If the document is set at
+<a name="page-layout-parameters-textheight"></a><p>The normal vertical height of the page body. If the document is set at
a nominal type size of 10pt then for an <code>article</code> or <code>report</code>
the default is &lsquo;<samp>43\baselineskip</samp>&rsquo;, while for a <code>book</code> it is
&lsquo;<samp>41\baselineskip</samp>&rsquo;. At a type size of 11pt the default is
@@ -2922,7 +3033,7 @@ the default is &lsquo;<samp>43\baselineskip</samp>&rsquo;, while for a <code>boo
<a name="index-_005ctextwidth"></a>
</dt>
<dd><a name="index-_005ctextwidth-1"></a>
-<p>The full horizontal width of the entire page body. For an
+<a name="page-layout-parameters-textwidth"></a><p>The full horizontal width of the entire page body. For an
<code>article</code> or <code>report</code> document, the default is &lsquo;<samp>345pt</samp>&rsquo;
when the chosen type size is 10pt, the default is &lsquo;<samp>360pt</samp>&rsquo; at 11pt,
and it is &lsquo;<samp>390pt</samp>&rsquo; at 12pt. For a <code>book</code> document, the default
@@ -2942,8 +3053,11 @@ specified width, and revert to their normal values at the end of the
<code>minipage</code> or <code>\parbox</code>.
</p>
<a name="index-_005chsize"></a>
+<a name="page-layout-parameters-hsize"></a></dd>
+<dt><code>\hsize</code>
<a name="index-_005chsize-1"></a>
-<p>This entry is included for completeness: <code>\hsize</code> is the TeX
+</dt>
+<dd><p>This entry is included for completeness: <code>\hsize</code> is the TeX
primitive parameter used when text is broken into lines. It should not
be used in normal LaTeX documents.
</p>
@@ -2952,7 +3066,7 @@ be used in normal LaTeX documents.
<a name="index-_005ctopmargin"></a>
</dt>
<dd><a name="index-topmargin"></a>
-<p>Space between the top of the TeX page (one inch from the top of the
+<a name="page-layout-parameters-topmargin"></a><p>Space between the top of the TeX page (one inch from the top of the
paper, by default) and the top of the header. The value is computed
based on many other parameters: <code>\paperheight - 2in -
\headheight - \headsep - \textheight - \footskip</code>,
@@ -2963,7 +3077,7 @@ and then divided by two.
<a name="index-_005ctopskip"></a>
</dt>
<dd><a name="index-_005ctopskip-1"></a>
-<p>Minimum distance between the top of the page body and the baseline of
+<a name="page-layout-parameters-topskip"></a><p>Minimum distance between the top of the page body and the baseline of
the first line of text. For the standard classes, the default is the
same as the font size, e.g., &lsquo;<samp>10pt</samp>&rsquo; at a type size of 10pt.
</p>
@@ -2975,7 +3089,7 @@ same as the font size, e.g., &lsquo;<samp>10pt</samp>&rsquo; at a type size of 1
<a name="Floats"></a>
<div class="header">
<p>
-Previous: <a href="#Page-layout-parameters" accesskey="p" rel="prev">Page layout parameters</a>, Up: <a href="#Layout" accesskey="u" rel="up">Layout</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Page-layout-parameters" accesskey="p" rel="prev">Page layout parameters</a>, Up: <a href="#Layout" accesskey="u" rel="up">Layout</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Floats-1"></a>
<h3 class="section">5.6 Floats</h3>
@@ -3094,7 +3208,7 @@ non-float text (change them with
<a name="index-_005cbottomfraction"></a>
</dt>
<dd><a name="index-_005cbottomfraction-1"></a>
-<p>The maximum fraction of the page allowed to be occupied by floats at
+<a name="floats-bottomfraction"></a><p>The maximum fraction of the page allowed to be occupied by floats at
the bottom; default &lsquo;<samp>.3</samp>&rsquo;.
</p>
</dd>
@@ -3102,7 +3216,7 @@ the bottom; default &lsquo;<samp>.3</samp>&rsquo;.
<a name="index-_005cfloatpagefraction"></a>
</dt>
<dd><a name="index-_005cfloatpagefraction-1"></a>
-<p>The minimum fraction of a float page that must be occupied by floats;
+<a name="floats-floatpagefraction"></a><p>The minimum fraction of a float page that must be occupied by floats;
default &lsquo;<samp>.5</samp>&rsquo;.
</p>
</dd>
@@ -3110,7 +3224,7 @@ default &lsquo;<samp>.5</samp>&rsquo;.
<a name="index-_005ctextfraction"></a>
</dt>
<dd><a name="index-_005ctextfraction-1"></a>
-<p>Minimum fraction of a page that must be text; if floats take up too
+<a name="floats-textfraction"></a><p>Minimum fraction of a page that must be text; if floats take up too
much space to preserve this much text, floats will be moved to a
different page. The default is &lsquo;<samp>.2</samp>&rsquo;.
</p>
@@ -3119,20 +3233,21 @@ different page. The default is &lsquo;<samp>.2</samp>&rsquo;.
<a name="index-_005ctopfraction"></a>
</dt>
<dd><a name="index-_005ctopfraction-1"></a>
-<p>Maximum fraction at the top of a page that may be occupied before
+<a name="floats-topfraction"></a><p>Maximum fraction at the top of a page that may be occupied before
floats; default &lsquo;<samp>.7</samp>&rsquo;.
</p></dd>
</dl>
-<p>Parameters relating to vertical space around floats (change them with
-<code>\setlength{<var>parameter</var>}{<var>length expression</var>}</code>):
+<p>Parameters relating to vertical space around floats (change them with a
+command of the form <code>\setlength{<var>parameter</var>}{<var>length
+expression</var>}</code>):
</p>
<dl compact="compact">
<dt><code>\floatsep</code>
<a name="index-_005cfloatsep"></a>
</dt>
<dd><a name="index-_005cfloatsep-1"></a>
-<p>Space between floats at the top or bottom of a page; default
+<a name="floats-floatsep"></a><p>Space between floats at the top or bottom of a page; default
&lsquo;<samp>12pt plus2pt minus2pt</samp>&rsquo;.
</p>
</dd>
@@ -3140,7 +3255,7 @@ floats; default &lsquo;<samp>.7</samp>&rsquo;.
<a name="index-_005cintextsep"></a>
</dt>
<dd><a name="index-_005cintextsep-1"></a>
-<p>Space above and below a float in the middle of the main text; default
+<a name="floats-intextsep"></a><p>Space above and below a float in the middle of the main text; default
&lsquo;<samp>12pt plus2pt minus2pt</samp>&rsquo; for 10 point and 11 point documents,
and &lsquo;<samp>14pt plus4pt minus4pt</samp>&rsquo; for 12 point documents.
</p>
@@ -3149,20 +3264,21 @@ and &lsquo;<samp>14pt plus4pt minus4pt</samp>&rsquo; for 12 point documents.
<a name="index-_005ctextfloatsep"></a>
</dt>
<dd><a name="index-_005ctextfloatsep-1"></a>
-<p>Space between the last (first) float at the top (bottom) of a page;
+<a name="floats-textfloatsep"></a><p>Space between the last (first) float at the top (bottom) of a page;
default &lsquo;<samp>20pt plus2pt minus4pt</samp>&rsquo;.
</p></dd>
</dl>
-<p>Counters relating to the number of floats on a page (change them with
-<code>\setcounter{<var>ctrname</var>}{<var>natural number</var>}</code>):
+<p>Counters relating to the number of floats on a page (change them with a
+command of the form <code>\setcounter{<var>ctrname</var>}{<var>natural
+number</var>}</code>):
</p>
<dl compact="compact">
<dt><code>bottomnumber</code>
<a name="index-bottomnumber"></a>
</dt>
<dd><a name="index-bottomnumber-1"></a>
-<p>Maximum number of floats that can appear at the bottom of a text page;
+<a name="floats-bottomnumber"></a><p>Maximum number of floats that can appear at the bottom of a text page;
default 1.
</p>
</dd>
@@ -3170,7 +3286,7 @@ default 1.
<a name="index-dbltopnumber"></a>
</dt>
<dd><a name="index-dbltopnumber-1"></a>
-<p>Maximum number of full-sized floats that can appear at the top of a
+<a name="floats-dbltopnumber"></a><p>Maximum number of full-sized floats that can appear at the top of a
two-column page; default 2.
</p>
</dd>
@@ -3178,7 +3294,7 @@ two-column page; default 2.
<a name="index-topnumber"></a>
</dt>
<dd><a name="index-topnumber-1"></a>
-<p>Maximum number of floats that can appear at the top of a text page;
+<a name="floats-topnumber"></a><p>Maximum number of floats that can appear at the top of a text page;
default 2.
</p>
</dd>
@@ -3186,7 +3302,7 @@ default 2.
<a name="index-totalnumber"></a>
</dt>
<dd><a name="index-totalnumber-1"></a>
-<p>Maximum number of floats that can appear on a text page; default 3.
+<a name="floats-totalnumber"></a><p>Maximum number of floats that can appear on a text page; default 3.
</p></dd>
</dl>
@@ -3204,111 +3320,746 @@ LaTeX?&rdquo;
<a name="Sectioning"></a>
<div class="header">
<p>
-Next: <a href="#Cross-references" accesskey="n" rel="next">Cross references</a>, Previous: <a href="#Layout" accesskey="p" rel="prev">Layout</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Cross-references" accesskey="n" rel="next">Cross references</a>, Previous: <a href="#Layout" accesskey="p" rel="prev">Layout</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Sectioning-1"></a>
<h2 class="chapter">6 Sectioning</h2>
<a name="index-sectioning-commands"></a>
-
-<p>Sectioning commands provide the means to structure your text into units:
-</p>
-<dl compact="compact">
-<dt><code>\part</code>
+<a name="index-part"></a>
+<a name="index-chapter"></a>
+<a name="index-section"></a>
+<a name="index-subsection"></a>
+<a name="index-paragraph"></a>
+<a name="index-subparagraph"></a>
<a name="index-_005cpart"></a>
-</dt>
-<dt><code>\chapter</code>
<a name="index-_005cchapter"></a>
-</dt>
-<dd><p>(<code>report</code> and <code>book</code> class only)
-</p></dd>
-<dt><code>\section</code>
<a name="index-_005csection"></a>
-</dt>
-<dt><code>\subsection</code>
<a name="index-_005csubsection"></a>
-</dt>
-<dt><code>\subsubsection</code>
-<a name="index-_005csubsubsection"></a>
-</dt>
-<dt><code>\paragraph</code>
<a name="index-_005cparagraph"></a>
-</dt>
-<dt><code>\subparagraph</code>
<a name="index-_005csubparagraph"></a>
+
+<p>Structure your text into divisions: parts, chapters, sections, etc. All
+sectioning commands have the same form, one of:
+</p>
+<div class="example">
+<pre class="example"><var>sectioning-command</var>{<var>title</var>}
+<var>sectioning-command</var>*{<var>title</var>}
+<var>sectioning-command</var>[<var>toc-title</var>]{<var>title</var>}
+</pre></div>
+
+<p>For instance, declare the start of a subsection as with
+<code>\subsection{Motivation}</code>.
+</p>
+<p>The table has each <var>sectioning-command</var> in LaTeX. All are
+available in all of LaTeX&rsquo;s standard document classes <code>book</code>,
+<code>report</code>, and&nbsp;<code>article</code>, except that <code>\chapter</code> is
+not available in <code>article</code>.
+</p>
+<table>
+<thead><tr><th width="25%">Sectioning unit</th><th width="25%">Command</th><th width="40%">Level</th></tr></thead>
+<tr><td width="25%">Part</td><td width="25%"><code>\part</code></td><td width="40%">-1 (<code>book</code>, <code>report</code>), 0 (<code>article</code>)</td></tr>
+<tr><td width="25%">Chapter</td><td width="25%"><code>\chapter</code></td><td width="40%">0</td></tr>
+<tr><td width="25%">Section</td><td width="25%"><code>\section</code></td><td width="40%">1</td></tr>
+<tr><td width="25%">Subsection</td><td width="25%"><code>\subsection</code></td><td width="40%">2</td></tr>
+<tr><td width="25%">Subsubsection</td><td width="25%"><code>\subsubsection</code></td><td width="40%">3</td></tr>
+<tr><td width="25%">Paragraph</td><td width="25%"><code>\paragraph</code></td><td width="40%">4</td></tr>
+<tr><td width="25%">Subparagraph</td><td width="25%"><code>\subparagraph</code></td><td width="40%">5</td></tr>
+</table>
+
+<a name="index-_002a_002dform-of-sectioning-commands"></a>
+<p>All these commands have a <code>*</code>-form that prints <var>title</var> as usual
+but is not numbered and does not make an entry in the table of contents.
+An example of using this is for an appendix in an <code>article</code> . The
+input <code>\appendix\section{Appendix}</code> gives the output &lsquo;<samp>A
+Appendix</samp>&rsquo; (see <a href="#g_t_005cappendix">\appendix</a>). You can lose the numbering&nbsp;&lsquo;<samp>A</samp>&rsquo;
+by instead entering <code>\section*{Appendix}</code> (articles often omit a
+table of contents and have simple page headers so the other differences
+from the <code>\section</code> command may not matter).
+</p>
+<p>The section title <var>title</var> provides the heading in the main text, but
+it may also appear in the table of contents and in the running head or
+foot (see <a href="#Page-styles">Page styles</a>). You may not want the same text in these
+places as in the main text. All of these commands have an optional
+argument <var>toc-title</var> for these other places.
+</p>
+<p>The level number in the table above determines which sectional units are
+numbered, and which appear in the table of contents. If the sectioning
+command&rsquo;s <var>level</var> is less than or equal to the value of the counter
+<code>secnumdepth</code> then the titles for this sectioning command will be
+numbered (see <a href="#Sectioning_002fsecnumdepth">Sectioning/secnumdepth</a>). And, if <var>level</var> is less
+than or equal to the value of the counter <code>tocdepth</code> then the table
+of contents will have an entry for this sectioning unit
+(see <a href="#Sectioning_002ftocdepth">Sectioning/tocdepth</a>).
+</p>
+<p>LaTeX expects that before you have a <code>\subsection</code> you will have
+a <code>\section</code> and, in a book, that before a <code>\section</code> you will
+have a <code>\chapter</code>. Otherwise you can get a something like a
+subsection numbered &lsquo;<samp>3.0.1</samp>&rsquo;.
+</p>
+<p>Two counters relate to the appearance of sectioning commands.
+</p>
+<dl compact="compact">
+<dt><code>secnumdepth</code>
+<a name="index-secnumdepth"></a>
</dt>
+<dd><a name="index-secnumdepth-counter"></a>
+<a name="index-section-numbers_002c-printing"></a>
+<a name="sectioning-secnumdepth"></a><a name="Sectioning_002fsecnumdepth"></a><p>Controls which sectioning commands are
+numbered. Suppress numbering of sectioning at any depth greater than
+<var>level</var> <code>\setcounter{secnumdepth}{<var>level</var>}</code>
+(see <a href="#g_t_005csetcounter">\setcounter</a>). See the above table for the level numbers. For
+instance, if the <code>secnumdepth</code> is 1 in an <code>article</code> then a
+<code>\section{Introduction}</code> command will produce output like &lsquo;<samp>1
+Introduction</samp>&rsquo; while <code>\subsection{Discussion}</code> will produce output
+like &lsquo;<samp>Discussion</samp>&rsquo;, without the number. LaTeX&rsquo;s default
+<code>secnumdepth</code> is&nbsp;3 in <samp>article</samp> class and &nbsp;2 in the
+<samp>book</samp> and <samp>report</samp> classes.
+</p>
+</dd>
+<dt><code>tocdepth</code>
+<a name="index-tocdepth"></a>
+</dt>
+<dd><a name="index-tocdepth-counter"></a>
+<a name="index-table-of-contents_002c-sectioning-numbers-printed"></a>
+<a name="sectioning-tocdepth"></a><a name="Sectioning_002ftocdepth"></a><p>Controls which sectioning units are listed in the table of contents.
+The setting <code>\setcounter{tocdepth}{<var>level</var>}</code> makes the
+sectioning units at <var>level</var> be the smallest ones listed
+(see <a href="#g_t_005csetcounter">\setcounter</a>). See the above table for the level numbers. For
+instance, if <code>tocdepth</code> is&nbsp;1 then the table of contents will
+list sections but not subsections. LaTeX&rsquo;s default
+<code>secnumdepth</code> is&nbsp;3 in <samp>article</samp> class and &nbsp;2 in the
+<samp>book</samp> and <samp>report</samp> classes.
+</p>
+</dd>
</dl>
-<p>All sectioning commands take the same general form, e.g.,
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cpart" accesskey="1">\part</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Start a part.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cchapter" accesskey="2">\chapter</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Start a chapter.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005csection" accesskey="3">\section</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Start a section.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005csubsection" accesskey="4">\subsection</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Start a subsection.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph" accesskey="5">\subsubsection &amp; \paragraph &amp; \subparagraph</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Lower divisions.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cappendix" accesskey="6">\appendix</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Start appendices.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter" accesskey="7">\frontmatter &amp; \mainmatter &amp; \backmatter</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The three parts of a book.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005c_0040startsection" accesskey="8">\@startsection</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Layout of sectional units.
+</td></tr>
+</table>
+
+
+<hr>
+<a name="g_t_005cpart"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cchapter" accesskey="n" rel="next">\chapter</a>, Up: <a href="#Sectioning" accesskey="u" rel="up">Sectioning</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cpart-1"></a>
+<h3 class="section">6.1 <code>\part</code></h3>
+
+<a name="index-_005cpart-1"></a>
+<a name="index-part-1"></a>
+<a name="index-sectioning_002c-part"></a>
+
+<p>Synopsis, one of:
</p>
<div class="example">
-<pre class="example">\chapter[<var>toctitle</var>]{<var>title</var>}
+<pre class="example">\part{<var>title</var>}
+\part*{<var>title</var>}
+\part[<var>toc-title</var>]{<var>title</var>}
</pre></div>
-<p>In addition to providing the heading <var>title</var> in the main text, the
-section title can appear in two other places:
+<p>Start a document part. The standard LaTeX classes <code>book</code>,
+<code>report</code>, and <code>article</code>, all have this command.
</p>
-<ol>
-<li> The table of contents.
-</li><li> The running head at the top of the page.
-</li></ol>
+<p>This produces a document part, in a book.
+</p>
+<div class="example">
+<pre class="example">\part{VOLUME I \\
+ PERSONAL MEMOIRS OF U.\ S.\ GRANT}
+\chapter{ANCESTRY--BIRTH--BOYHOOD.}
+My family is American, and has been for generations,
+in all its branches, direct and collateral.
+</pre></div>
-<p>You may not want the same text in these places as in the main text.
-To handle this, the sectioning commands have an optional argument
-<var>toctitle</var> that, when given, specifies the text for these other
-places.
+<p>In each standard class the <code>\part</code> command outputs a part number
+such as &lsquo;<samp>Part I</samp>&rsquo;, alone on its line, in boldface, and in large
+type. Then LaTeX outputs <var>title</var>, also alone on its line, in
+bold and in even larger type. In class <code>book</code>, the LaTeX
+default puts each part alone on its own page. If the book is two-sided
+then LaTeX will skip a page if needed to have the new part on an
+odd-numbered page. In <code>report</code> it is again alone on a page, but
+LaTeX won&rsquo;t force it onto an odd-numbered page. In an <code>article</code>
+LaTeX does not put it on a fresh page, but instead outputs the part
+number and part title onto the main document page.
</p>
-<a name="index-_002a_002dform-of-sectioning-commands"></a>
-<p>Also, all sectioning commands have <code>*</code>-forms that print
-<var>title</var> as usual, but do not include a number and do not make an
-entry in the table of contents. For instance:
+<p>The <code>*</code>&nbsp;form shows <var>title</var>
+but it does not show the part number, does not increment the
+<code>part</code> counter, and produces no table of contents entry.
+</p>
+<p>The optional argument <var>toc-title</var> will appear as the part title in
+the table of contents (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>) and in running
+headers (see <a href="#Page-styles">Page styles</a>). If it is not present then <var>title</var>
+will be there. This example puts a line break in <var>title</var> but leaves
+out the break in the table of contents.
+</p>
+<div class="example">
+<pre class="example">\part[Up from the bottom; my life]{Up from the bottom\\ my life}
+</pre></div>
+
+<p>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a part is&nbsp;-1
+(see <a href="#Sectioning_002fsecnumdepth">Sectioning/secnumdepth</a> and see <a href="#Sectioning_002ftocdepth">Sectioning/tocdepth</a>).
+</p>
+<a name="index-package_002c-indentfirst"></a>
+<a name="index-indentfirst-package"></a>
+
+<p>In the class <code>article</code>, if a paragraph immediately follows the part
+title then it is not indented. To get an indent you can use the package
+<samp>indentfirst</samp>.
+</p>
+<a name="index-package_002c-titlesec"></a>
+<a name="index-titlesec-package"></a>
+
+<p>One package to change the behavior of <code>\part</code> is <samp>titlesec</samp>.
+See its documentation on CTAN.
+</p>
+
+<hr>
+<a name="g_t_005cchapter"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005csection" accesskey="n" rel="next">\section</a>, Previous: <a href="#g_t_005cpart" accesskey="p" rel="prev">\part</a>, Up: <a href="#Sectioning" accesskey="u" rel="up">Sectioning</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cchapter-1"></a>
+<h3 class="section">6.2 <code>\chapter</code></h3>
+
+<a name="index-_005cchapter-1"></a>
+<a name="index-chapter-1"></a>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\chapter{<var>title</var>}
+\chapter*{<var>title</var>}
+\chapter[<var>toc-title</var>]{<var>title</var>}
+</pre></div>
+
+<p>Start a chapter. The standard LaTeX classes <code>book</code> and
+<code>report</code> have this command but <code>article</code> does not.
+</p>
+<p>This produces a chapter.
</p>
<div class="example">
-<pre class="example">\section*{Preamble}
+<pre class="example">\chapter{Loomings}
+Call me Ishmael.
+Some years ago---never mind how long precisely---having little or no
+money in my purse, and nothing particular to interest me on shore, I
+thought I would sail about a little and see the watery part of
+the world.
</pre></div>
+<p>The LaTeX default starts each chapter on a fresh page, an
+odd-numbered page if the document is two-sided. It produces a chapter
+number such as &lsquo;<samp>Chapter 1</samp>&rsquo; in large boldface type (the size is
+<code>\huge</code>). It then puts <var>title</var> on a fresh line, in boldface
+type that is still larger (size <code>\Huge</code>). It also increments the
+<code>chapter</code> counter, adds an entry to the table of contents
+(see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>), and sets the running header
+information (see <a href="#Page-styles">Page styles</a>).
+</p>
+<p>The <code>*</code>&nbsp;form shows <var>title</var> on a fresh line, in boldface.
+But it does not show the chapter number, does not increment the
+<code>chapter</code> counter, produces no table of contents entry, and does
+not affect the running header. (If you use the page style
+<code>headings</code> in a two-sided document then the header will be from the
+prior chapter.) This example illustrates.
+</p>
+<div class="example">
+<pre class="example">\chapter*{Preamble}
+</pre></div>
+
+<p>The optional argument <var>toc-title</var> will appear as the chapter title
+in the table of contents (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>) and in
+running headers (see <a href="#Page-styles">Page styles</a>). If it is not present then
+<var>title</var> will be there. This shows the full name in the chapter
+title,
+</p>
+<div class="example">
+<pre class="example">\chapter[Weyl]{Hermann Klaus Hugo (Peter) Weyl (1885--1955)}
+</pre></div>
+
+<p>but only &lsquo;<samp>Weyl</samp>&rsquo; on the contents page. This puts a line break in
+the title but that doesn&rsquo;t work well with running headers so it omits
+the break in the contents
+</p>
+<div class="example">
+<pre class="example">\chapter[Given it all\\ my story]{Given it all\\ my story}
+</pre></div>
+
+<p>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a chapter is&nbsp;0
+(see <a href="#Sectioning_002fsecnumdepth">Sectioning/secnumdepth</a> and see <a href="#Sectioning_002ftocdepth">Sectioning/tocdepth</a>).
+</p>
+<a name="index-package_002c-indentfirst-1"></a>
+<a name="index-indentfirst-package-1"></a>
+
+<p>The paragraph that follows the chapter title is not indented, as is a
+standard typographical practice. To get an indent use the package
+<samp>indentfirst</samp>.
+</p>
+<p>You can change what is shown for the chapter number. To change it to
+something like &lsquo;<samp>Lecture 1</samp>&rsquo;, put in the preamble either
+<code>\renewcommand{\chaptername}{Lecture}</code> or this
+(see <a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</a>).
+</p>
+<div class="example">
+<pre class="example">\makeatletter
+\renewcommand{\@chapapp}{Lecture}
+\makeatother
+</pre></div>
+
+<a name="index-package_002c-babel"></a>
+<a name="index-babel-package"></a>
+
+<p>To make this change because of the primary language for
+the document, see the package <samp>babel</samp>.
+</p>
+<p>In a two-sided document LaTeX puts a chapter on odd-numbered page, if
+necessary leaving an even-numbered page that is blank except for any
+running headers. To make that page completely blank,
+see&nbsp;<a href="#g_t_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</a>.
+</p>
+<a name="index-package_002c-titlesec-1"></a>
+<a name="index-titlesec-package-1"></a>
+
+<p>To change the behavior of the <code>\chapter</code> command, you can copy its
+definition from the LaTeX format file and make adjustments. But
+there are also many packages on CTAN that address this. One is
+<samp>titlesec</samp>. See its documentation, but the example below gives a
+sense of what it can do.
+</p>
+<div class="example">
+<pre class="example">\usepackage{titlesec} % in preamble
+\titleformat{\chapter}
+ {\Huge\bfseries} % format of title
+ {} % label, such as 1.2 for a subsection
+ {0pt} % length of separation between label and title
+ {} % before-code hook
+</pre></div>
+
+<p>This omits the chapter number &lsquo;<samp>Chapter 1</samp>&rsquo; from the page but unlike
+<code>\chapter*</code> it keeps the chapter in the table of contents and the
+running headers.
+</p>
+
+<hr>
+<a name="g_t_005csection"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005csubsection" accesskey="n" rel="next">\subsection</a>, Previous: <a href="#g_t_005cchapter" accesskey="p" rel="prev">\chapter</a>, Up: <a href="#Sectioning" accesskey="u" rel="up">Sectioning</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005csection-1"></a>
+<h3 class="section">6.3 <code>\section</code></h3>
+
+<a name="index-_005csection-1"></a>
+<a name="index-section-1"></a>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\section{<var>title</var>}
+\section*{<var>title</var>}
+\section[<var>toc-title</var>]{<var>title</var>}
+</pre></div>
+
+<p>Start a section. The standard LaTeX classes <code>article</code>,
+<code>book</code>, and <code>report</code> all have this command.
+</p>
+<p>This produces a section.
+</p>
+<div class="example">
+<pre class="example">In this Part we tend to be more interested in the function,
+in the input-output behavior,
+than in the details of implementing that behavior.
+
+\section{Turing machines}
+Despite this desire to downplay implementation,
+we follow the approach of A~Turing that the
+first step toward defining the set of computable functions
+is to reflect on the details of what mechanisms can do.
+</pre></div>
+
+<p>For the standard LaTeX classes <code>book</code> and <code>report</code> the
+default output is like &lsquo;<samp>1.2 <var>title</var></samp>&rsquo; (for chapter&nbsp;1,
+section&nbsp;2), alone on its line and flush left, in boldface and a
+larger type (the type size is <code>\Large</code>). The same holds in
+<code>article</code> except that there are no chapters in that class so it
+looks like &lsquo;<samp>2 <var>title</var></samp>&rsquo;.
+</p>
+<p>The <code>*</code>&nbsp;form shows <var>title</var>.
+But it does not show the section number, does not increment the
+<code>section</code> counter, produces no table of contents entry, and does
+not affect the running header. (If you use the page style
+<code>headings</code> in a two-sided document then the header will be from the
+prior section.)
+</p>
+<p>The optional argument <var>toc-title</var> will appear as the section title
+in the table of contents (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>) and in
+running headers (see <a href="#Page-styles">Page styles</a>). If it is not present then
+<var>title</var> will be there. This shows the full name in the title of the
+section,
+</p>
+<div class="example">
+<pre class="example">\section[Elizabeth~II]{Elizabeth the Second,
+ by the Grace of God of the United Kingdom,
+ Canada and Her other Realms and Territories Queen,
+ Head of the Commonwealth, Defender of the Faith.}
+</pre></div>
+
+<p>but only &lsquo;<samp>Elizabeth II</samp>&rsquo; on the contents page and in the headers.
+This has a line break in <var>title</var> but that does not work with headers
+so it is omitted from the contents and headers.
+</p>
+<div class="example">
+<pre class="example">\section[Truth is, I cheated; my life story]{Truth is,
+ I cheated\\my life story}
+</pre></div>
+
+<p>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a section is&nbsp;1
+(see <a href="#Sectioning_002fsecnumdepth">Sectioning/secnumdepth</a> and see <a href="#Sectioning_002ftocdepth">Sectioning/tocdepth</a>).
+</p>
+<a name="index-package_002c-indentfirst-2"></a>
+<a name="index-indentfirst-package-2"></a>
+
+<p>The paragraph that follows the section title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package <samp>indentfirst</samp>.
+</p>
+<a name="index-package_002c-titlesec-2"></a>
+<a name="index-titlesec-package-2"></a>
+
+<p>In general, to change the behavior of the <code>\section</code> command, there
+are a number of options. One is the <code>\@startsection</code> command
+(see <a href="#g_t_005c_0040startsection">\@startsection</a>). There are also many packages on CTAN that
+address this, including <samp>titlesec</samp>. See the documentation but the
+example below gives a sense of what they can do.
+</p>
+<div class="example">
+<pre class="example">\usepackage{titlesec} % in preamble
+\titleformat{\section}
+ {\normalfont\Large\bfseries} % format of title
+ {\makebox[1pc][r]{\thesection\hspace{1pc}}} % label
+ {0pt} % length of separation between label and title
+ {} % before-code hook
+\titlespacing*{\section}
+ {-1pc}{18pt}{10pt}[10pc]
+</pre></div>
+
+<p>That puts the section number in the margin.
+</p>
+
+<hr>
+<a name="g_t_005csubsection"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph" accesskey="n" rel="next">\subsubsection &amp; \paragraph &amp; \subparagraph</a>, Previous: <a href="#g_t_005csection" accesskey="p" rel="prev">\section</a>, Up: <a href="#Sectioning" accesskey="u" rel="up">Sectioning</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005csubsection-1"></a>
+<h3 class="section">6.4 <code>\subsection</code></h3>
+
+<a name="index-_005csubsection-1"></a>
+<a name="index-subsection-1"></a>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\subsection{<var>title</var>}
+\subsection*{<var>title</var>}
+\subsection[<var>toc-title</var>]{<var>title</var>}
+</pre></div>
+
+<p>Start a subsection. The standard LaTeX classes <code>article</code>,
+<code>book</code>, and <code>report</code> all have this command.
+</p>
+<p>This produces a subsection.
+</p>
+<div class="example">
+<pre class="example">We will show that there are more functions than Turing machines and that
+therefore some functions have no associated machine.
+
+\subsection{Cardinality} We will begin with two paradoxes that
+dramatize the challenge to our intuition posed by comparing the sizes of
+infinite sets.
+</pre></div>
+
+<p>For the standard LaTeX classes <code>book</code> and <code>report</code> the
+default output is like &lsquo;<samp>1.2.3 <var>title</var></samp>&rsquo; (for chapter&nbsp;1,
+section&nbsp;2, subsection&nbsp;3), alone on its line and flush left, in
+boldface and a larger type (the type size is <code>\large</code>). The same
+holds in <code>article</code> except that there are no chapters in that class
+so it looks like &lsquo;<samp>2.3 <var>title</var></samp>&rsquo;.
+</p>
+<p>The <code>*</code>&nbsp;form shows <var>title</var>.
+But it does not show the section number, does not increment the
+<code>section</code> counter, and produces no table of contents entry.
+</p>
+<p>The optional argument <var>toc-title</var> will appear as the section title
+in the table of contents (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>). If it is
+not present then <var>title</var> will be there. This shows the full name in
+the title of the section,
+</p>
+<div class="example">
+<pre class="example">\subsection[$\alpha,\beta,\gamma$ paper]{\textit{The Origin of
+ Chemical Elements} by R.A.~Alpher, H.~Bethe, and G.~Gamow}
+</pre></div>
+
+<p>but only &lsquo;<samp>&#x03B1;,&#x03B2;,&#x03B3;
+paper</samp>&rsquo; on the contents page.
+</p>
+<p>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a subsection is&nbsp;2
+(see <a href="#Sectioning_002fsecnumdepth">Sectioning/secnumdepth</a> and see <a href="#Sectioning_002ftocdepth">Sectioning/tocdepth</a>).
+</p>
+<a name="index-package_002c-indentfirst-3"></a>
+<a name="index-indentfirst-package-3"></a>
+
+<p>The paragraph that follows the subsection title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package <samp>indentfirst</samp>.
+</p>
+<a name="index-package_002c-titlesec-3"></a>
+<a name="index-titlesec-package-3"></a>
+
+<p>There are a number of ways to change the behavior of the
+<code>\subsection</code> command. One is the <code>\@startsection</code> command
+(see <a href="#g_t_005c_0040startsection">\@startsection</a>). There are also many packages on CTAN that
+address this, including <samp>titlesec</samp>. See the documentation but the
+example below gives a sense of what they can do.
+</p>
+<div class="example">
+<pre class="example">\usepackage{titlesec} % in preamble
+\titleformat{\subsection}[runin]
+ {\normalfont\normalsize\bfseries} % format of the title
+ {\thesubsection} % label
+ {0.6em} % space between label and title
+ {} % before-code hook
+</pre></div>
+
+<p>That puts the subsection number and <var>title</var> in the first line of
+text.
+</p>
+
+<hr>
+<a name="g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cappendix" accesskey="n" rel="next">\appendix</a>, Previous: <a href="#g_t_005csubsection" accesskey="p" rel="prev">\subsection</a>, Up: <a href="#Sectioning" accesskey="u" rel="up">Sectioning</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+
+<a name="g_t_005csubsubsection_002c-_005cparagraph_002c-_005csubparagraph"></a>
+<h3 class="section">6.5 <code>\subsubsection</code>, <code>\paragraph</code>, <code>\subparagraph</code></h3>
+
+<a name="index-_005csubsubsection"></a>
+<a name="index-subsubsection"></a>
+<a name="index-_005cparagraph-1"></a>
+<a name="index-paragraph-1"></a>
+<a name="index-_005csubparagraph-1"></a>
+<a name="index-subparagraph-1"></a>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\subsubsection{<var>title</var>}
+\subsubsection*{<var>title</var>}
+\subsubsection[<var>toc-title</var>]{<var>title</var>}
+</pre></div>
+
+<p>or one of:
+</p>
+<div class="example">
+<pre class="example">\paragraph{<var>title</var>}
+\paragraph*{<var>title</var>}
+\paragraph[<var>toc-title</var>]{<var>title</var>}
+</pre></div>
+
+<p>or one of:
+</p>
+<div class="example">
+<pre class="example">\subparagraph{<var>title</var>}
+\subparagraph*{<var>title</var>}
+\subparagraph[<var>toc-title</var>]{<var>title</var>}
+</pre></div>
+
+<p>Start a subsubsection, paragraph, or subparagraph. The standard
+LaTeX classes <code>article</code>, <code>book</code>, and <code>report</code> all have
+these commands, although they are not commonly used.
+</p>
+<p>This produces a subsubsection.
+</p>
+<div class="example">
+<pre class="example">\subsubsection{Piston ring compressors: structural performance}
+Provide exterior/interior wall cladding assemblies
+capable of withstanding the effects of load and stresses from
+consumer-grade gasoline engine piston rings.
+</pre></div>
+
+<p>The default output of each of the three does not change over the
+standard LaTeX classes <code>article</code>, <code>book</code>, and
+<code>report</code>. For <code>\subsubsection</code> the <var>title</var> is alone on
+its line, in boldface and normal size type. For <code>\paragraph</code> the
+<var>title</var> is inline with the text, not indented, in boldface and
+normal size type. For <code>\subparagraph</code> the <var>title</var> is inline
+with the text, with a paragraph indent, in boldface and normal size type
+(Because an <code>article</code> has no chapters its subsubsections are
+numbered and so it looks like &lsquo;<samp>1.2.3 <var>title</var></samp>&rsquo;, for
+section&nbsp;1, subsection&nbsp;2, and subsubsection&nbsp;3. The other
+two divisions are not numbered.)
+</p>
+<p>The <code>*</code>&nbsp;form shows <var>title</var>. But it does not increment the
+associated counter and produces no table of contents entry (and does not
+show the number for <code>\subsubsection</code>).
+</p>
+<p>The optional argument <var>toc-title</var> will appear as the division title
+in the table of contents (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>). If it is
+not present then <var>title</var> will be there.
+</p>
+<p>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a subsubsection is&nbsp;3, of
+a paragraph is&nbsp;4, and of a subparagraph is&nbsp;5
+(see <a href="#Sectioning_002fsecnumdepth">Sectioning/secnumdepth</a> and see <a href="#Sectioning_002ftocdepth">Sectioning/tocdepth</a>).
+</p>
+<a name="index-package_002c-indentfirst-4"></a>
+<a name="index-indentfirst-package-4"></a>
+
+<p>The paragraph that follows the subsubsection title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package <samp>indentfirst</samp>.
+</p>
+<a name="index-package_002c-titlesec-4"></a>
+<a name="index-titlesec-package-4"></a>
+
+<p>There are a number of ways to change the behavior of the these commands.
+One is the <code>\@startsection</code> command (see <a href="#g_t_005c_0040startsection">\@startsection</a>).
+There are also many packages on CTAN that address this, including
+<samp>titlesec</samp>. See the documentation on CTAN.
+</p>
+
+<hr>
+<a name="g_t_005cappendix"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter" accesskey="n" rel="next">\frontmatter &amp; \mainmatter &amp; \backmatter</a>, Previous: <a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph" accesskey="p" rel="prev">\subsubsection &amp; \paragraph &amp; \subparagraph</a>, Up: <a href="#Sectioning" accesskey="u" rel="up">Sectioning</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+
+<a name="g_t_005cappendix-1"></a>
+<h3 class="section">6.6 <code>\appendix</code></h3>
+
<a name="index-_005cappendix"></a>
-<a name="index-appendix_002c-creating"></a>
-<p>The <code>\appendix</code> command changes the way following sectional units
-are numbered. The <code>\appendix</code> command itself generates no text
-and does not affect the numbering of parts. The normal use of this
-command is something like
+<a name="index-appendix"></a>
+<a name="index-appendices"></a>
+
+<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\chapter{A Chapter}
-&hellip;
-\appendix
-\chapter{The First Appendix}
+<pre class="example">\appendix
</pre></div>
-<a name="index-secnumdepth-counter"></a>
-<a name="index-section-numbers_002c-printing"></a>
-<a name="Sectioning_002fsecnumdepth"></a><p>The <code>secnumdepth</code> counter controls printing of section numbers.
-The setting
+<p>This does not directly produce any output. But in a book or report it
+declares that subsequent <code>\chapter</code> commands start an appendix. In
+an article it does the same, for <code>\section</code> commands. It also
+resets the <code>chapter</code> and <code>section</code> counters to&nbsp;0 in a
+book or report, and in an article resets the <code>section</code> and
+<code>subsection</code> counters.
+</p>
+<p>In this book
</p>
<div class="example">
-<pre class="example">\setcounter{secnumdepth}{<var>level</var>}
+<pre class="example">\chapter{One} ...
+\chapter{Two} ...
+ ...
+\appendix
+\chapter{Three} ...
+\chapter{Four} ...
</pre></div>
-<p>suppresses heading numbers at any depth <em>&gt; <var>level</var></em>, where
-<code>chapter</code> is level zero. The default <code>secnumdepth</code> is 3 in
-LaTeX&rsquo;s <samp>article</samp> class and 2 in the <samp>book</samp> and
-<samp>report</samp> classes. (See <a href="#g_t_005csetcounter">\setcounter</a>.)
+<p>the first two will generate output numbered &lsquo;<samp>Chapter 1</samp>&rsquo; and
+&lsquo;<samp>Chapter 2</samp>&rsquo;. After the <code>\appendix</code> the numbering will be
+&lsquo;<samp>Appendix A</samp>&rsquo; and &lsquo;<samp>Appendix B</samp>&rsquo;. See <a href="#Larger-book-template">Larger book template</a>
+for another example.
+</p>
+<a name="index-package_002c-appendix"></a>
+<a name="index-appendix-package"></a>
+<p>The <samp>appendix</samp> package adds the command
+<code>\appendixpage</code> to put a separate &lsquo;<samp>Appendices</samp>&rsquo; in the document
+body before the first appendix, and the command <code>\addappheadtotoc</code>
+to do the same in the table of contents. You can reset the name
+&lsquo;<samp>Appendix</samp>&rsquo; with a command like
+<code>\renewcommand{\appendixname}{Specification}</code>, as well as a
+number of other features. See the documentation on CTAN.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005c_0040startsection" accesskey="1">\@startsection</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Redefine layout of start of sections, subsections, etc.
-</td></tr>
-</table>
+<hr>
+<a name="g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005c_0040startsection" accesskey="n" rel="next">\@startsection</a>, Previous: <a href="#g_t_005cappendix" accesskey="p" rel="prev">\appendix</a>, Up: <a href="#Sectioning" accesskey="u" rel="up">Sectioning</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+
+<a name="g_t_005cfrontmatter_002c-_005cmainmatter_002c-_005cbackmatter"></a>
+<h3 class="section">6.7 <code>\frontmatter</code>, <code>\mainmatter</code>, <code>\backmatter</code></h3>
+
+<a name="index-_005cfrontmatter"></a>
+<a name="index-book_002c-front-matter"></a>
+<a name="index-_005cmainmatter"></a>
+<a name="index-book_002c-main-matter"></a>
+<a name="index-_005cbackmatter"></a>
+<a name="index-book_002c-back-matter"></a>
+<a name="index-book_002c-end-matter"></a>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\frontmatter
+\mainmatter
+\backmatter
+</pre></div>
+
+<p>Format a <code>book</code> class document differently according to which part
+of the document is being produced. All three commands are optional.
+</p>
+<p>Traditionally, a book&rsquo;s front matter contains such things as the title
+page, an abstract, a table of contents, a preface, a list of notations,
+a list of figures, and a list of tables. (Some of these front matter
+pages, such as the title page, are traditionally not numbered.) The
+back matter may contain such things as a glossary, notes, a
+bibliography, and an index.
+</p>
+<p>The <code>\frontmatter</code> declaration makes the pages numbered in
+lowercase roman, and makes chapters not numbered, although each
+chapter&rsquo;s title appears in the table of contents; if you use other
+sectioning commands here, use the <code>*</code>-version (see <a href="#Sectioning">Sectioning</a>).
+The <code>\mainmatter</code> changes the behavior back to the expected
+version, and resets the page number. The <code>\backmatter</code> leaves the
+page numbering alone but switches the chapters back to being not
+numbered. See <a href="#Larger-book-template">Larger book template</a> for an example using the three.
+</p>
<hr>
<a name="g_t_005c_0040startsection"></a>
<div class="header">
<p>
-Up: <a href="#Sectioning" accesskey="u" rel="up">Sectioning</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter" accesskey="p" rel="prev">\frontmatter &amp; \mainmatter &amp; \backmatter</a>, Up: <a href="#Sectioning" accesskey="u" rel="up">Sectioning</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005c_0040startsection-1"></a>
-<h3 class="section">6.1 <code>\@startsection</code></h3>
+<h3 class="section">6.8 <code>\@startsection</code></h3>
<a name="index-_005c_0040startsection"></a>
<a name="index-section_002c-redefining"></a>
@@ -3330,13 +4081,27 @@ the standard LaTeX <code>book</code> and <code>report</code> classes the command
make such a command you may want to use the <code>\secdef</code> command.
</p>
<p>Technically, <code>\@startsection</code> has the form
-</p><div class="example">
-<pre class="example">\@startsection{<var>name</var>}{<var>level</var>}{<var>indent</var>}{<var>beforeskip</var>}{<var>afterskip</var>}{<var>style</var>}*[<var>toctitle</var>]{<var>title</var>}
+</p>
+<div class="example">
+<pre class="example">\@startsection{<var>name</var>}
+ {<var>level</var>}
+ {<var>indent</var>}
+ {<var>beforeskip</var>}
+ {<var>afterskip</var>}
+ {<var>style</var>}*[<var>toctitle</var>]{<var>title</var>}
</pre></div>
-<p>(the star&nbsp;<code>*</code> is optional), so that issuing
-</p><div class="example">
-<pre class="example">\renewcommand{\section}{\@startsection{<var>name</var>}{<var>level</var>}{<var>indent</var>}{<var>beforeskip</var>}{<var>afterskip</var>}{<var>style</var>}}
+
+<p>so that issuing
+</p>
+<div class="example">
+<pre class="example">\renewcommand{\section}{\@startsection{<var>name</var>}
+ {<var>level</var>}
+ {<var>indent</var>}
+ {<var>beforeskip</var>}
+ {<var>afterskip</var>}
+ {<var>style</var>}}
</pre></div>
+
<p>redefines <code>\section</code> to have the form
<code>\section*[<var>toctitle</var>]{<var>title</var>}</code> (here too, the
star&nbsp;<code>*</code> is optional). See <a href="#Sectioning">Sectioning</a>. This implies that
@@ -3346,12 +4111,11 @@ the examples below.
</p>
<dl compact="compact">
<dt><var>name</var></dt>
-<dd><a name="g_t_005c_0040startsection_002fname"></a><p>Name of the counter used to number the
-sectioning header. This counter must be defined separately. Most
-commonly this is either <code>section</code>, <code>subsection</code>, or
-<code>paragraph</code>. Although in those three cases the counter name is the
-same as the sectioning command itself, using the same name is not
-required.
+<dd><a name="startsection-name"></a><a name="g_t_005c_0040startsection_002fname"></a><p>Name of the counter used to number the sectioning header. This counter
+must be defined separately. Most commonly this is either
+<code>section</code>, <code>subsection</code>, or <code>paragraph</code>. Although in
+those cases the counter name is the same as the sectioning command
+itself, you don&rsquo;t have to use the same name.
</p>
<p>Then <code>\the</code><var>name</var> displays the title number and
<code>\</code><var>name</var><code>mark</code> is for the page headers. See the third
@@ -3359,44 +4123,39 @@ example below.
</p>
</dd>
<dt><var>level</var></dt>
-<dd><a name="g_t_005c_0040startsection_002flevel"></a><p>An integer giving the depth of the
-sectioning command: 0 for <code>chapter</code> (only applies to the standard
-<code>book</code> and <code>report</code> classes), 1 for <code>section</code>, 2 for
-<code>subsection</code>, 3 for <code>subsubsection</code>, 4 for <code>paragraph</code>,
-and 5 for <code>subparagraph</code>. In the <code>book</code> and <code>report</code>
-classes <code>part</code> has level -1, while in the <code>article</code> class
-<code>part</code> has level 0.
-</p>
-<p>If <var>level</var> is less than or equal to the value of <code>secnumdepth</code>
-then the titles for this sectioning command will be numbered. For
-instance, in an <code>article</code>, if <code>secnumdepth</code> is 1 then a
-<code>\section{Introduction}</code> command will produce output like &ldquo;1
+<dd><a name="startsection-level"></a><a name="g_t_005c_0040startsection_002flevel"></a><p>An integer giving the depth of the sectioning command.
+See <a href="#Sectioning">Sectioning</a> for the list of standard level numbers.
+</p>
+<p>If <var>level</var> is less than or equal to the value of the counter
+<code>secnumdepth</code> then titles for this sectioning command will be
+numbered (see <a href="#Sectioning_002fsecnumdepth">Sectioning/secnumdepth</a>). For instance, if
+<code>secnumdepth</code> is 1 in an <code>article</code> then the command
+<code>\section{Introduction}</code> will produce output like &ldquo;1
Introduction&rdquo; while <code>\subsection{Discussion}</code> will produce
output like &ldquo;Discussion&rdquo;, without the number prefix.
-See <a href="#Sectioning_002fsecnumdepth">Sectioning/secnumdepth</a>.
</p>
-<p>If <var>level</var> is less than or equal to the value of <var>tocdepth</var> then
-the table of contents will have an entry for this sectioning unit.
-For instance, in an <code>article</code>, if <var>tocdepth</var> is 1 then the table of
-contents will list sections but not subsections.
+<p>If <var>level</var> is less than or equal to the value of the counter
+<var>tocdepth</var> then the table of contents will have an entry for this
+sectioning unit (see <a href="#Sectioning_002ftocdepth">Sectioning/tocdepth</a>). For instance, in an
+<code>article</code>, if <var>tocdepth</var> is 1 then the table of contents will
+list sections but not subsections.
</p>
</dd>
<dt><var>indent</var></dt>
-<dd><a name="g_t_005c_0040startsection_002findent"></a><p>A length giving the indentation of all
-of the title lines with respect to the left margin. To have the title
-flush with the margin use <code>0pt</code>. A negative indentation such as
-<code>-\parindent</code> will move the title into the left margin.
+<dd><a name="startsection-indent"></a><a name="g_t_005c_0040startsection_002findent"></a><p>A length giving the indentation of all of the title lines with respect
+to the left margin. To have the title flush with the margin use
+<code>0pt</code>. A negative indentation such as <code>-\parindent</code> will move
+the title into the left margin.
</p>
</dd>
<dt><var>beforeskip</var></dt>
-<dd><a name="g_t_005c_0040startsection_002fbeforeskip"></a><p>The absolute value of this length is
-the amount of vertical space that is inserted before this sectioning
-unit&rsquo;s title. This space will be discarded if the sectioning unit
-happens to start at the top of a fresh page. If this number is negative
-then the first paragraph following the header is not indented, if it is
-non-negative then the first paragraph is indented. (Note that the
-negative of <code>1pt plus 2pt minus 3pt</code> is <code>-1pt plus -2pt minus
--3pt</code>.)
+<dd><a name="startsection-beforeskip"></a><a name="g_t_005c_0040startsection_002fbeforeskip"></a><p>The absolute value of this length is the amount of vertical space that
+is inserted before this sectioning unit&rsquo;s title. This space will be
+discarded if the sectioning unit happens to start at the top of a fresh
+page. If this number is negative then the first paragraph following the
+header is not indented, if it is non-negative then the first paragraph
+is indented. (Note that the negative of <code>1pt plus 2pt minus 3pt</code>
+is <code>-1pt plus -2pt minus -3pt</code>.)
</p>
<p>For example, if <var>beforeskip</var> is <code>-3.5ex plus -1ex minus -0.2ex</code>
then to start the new sectioning unit, LaTeX will add about 3.5 times
@@ -3417,14 +4176,13 @@ page.)
</p>
</dd>
<dt><var>afterskip</var></dt>
-<dd><a name="g_t_005c_0040startsection_002fafterskip"></a><p>This is a length. If <var>afterskip</var>
-is non-negative then this is the vertical space inserted after the
-sectioning unit&rsquo;s title header. If it is negative then the title header
-becomes a run-in header, so that it becomes part of the next paragraph.
-In this case the absolute value of the length gives the horizontal space
-between the end of the title and the beginning of the following
-paragraph. (Note that the negative of <code>1pt plus 2pt minus 3pt</code> is
-<code>-1pt plus -2pt minus -3pt</code>.)
+<dd><a name="startsection-afterskip"></a><a name="g_t_005c_0040startsection_002fafterskip"></a><p>This is a length. If <var>afterskip</var> is non-negative then this is the
+vertical space inserted after the sectioning unit&rsquo;s title header. If it
+is negative then the title header becomes a run-in header, so that it
+becomes part of the next paragraph. In this case the absolute value of
+the length gives the horizontal space between the end of the title and
+the beginning of the following paragraph. (Note that the negative of
+<code>1pt plus 2pt minus 3pt</code> is <code>-1pt plus -2pt minus -3pt</code>.)
</p>
<p>As with <var>beforeskip</var>, using a rubber length, with <code>plus</code> and
<code>minus</code> components, is good practice here since it gives LaTeX
@@ -3442,37 +4200,38 @@ header&rsquo;s from standalone to run-in, you cannot use a negative
</p>
</dd>
<dt><var>style</var></dt>
-<dd><a name="g_t_005c_0040startsection_002fstyle"></a><p>Controls the styling of the title. See
-the examples below. Typical commands to use here are <code>\centering</code>,
-<code>\raggedright</code>, <code>\normalfont</code>, <code>\hrule</code>, or
-<code>\newpage</code>. The last command in <var>style</var> may be one such as
-<code>\MakeUppercase</code> or <code>\fbox</code> that takes one argument. The
+<dd><a name="startsection-style"></a><a name="g_t_005c_0040startsection_002fstyle"></a><p>Controls the styling of the title. See the examples below. Typical
+commands to use here are <code>\centering</code>, <code>\raggedright</code>,
+<code>\normalfont</code>, <code>\hrule</code>, or <code>\newpage</code>. The last command
+in <var>style</var> may be one that takes one argument, such as
+<code>\MakeUppercase</code> or <code>\fbox</code> that takes one argument. The
section title will be supplied as the argument to this command. For
instance, setting <var>style</var> to <code>\bfseries\MakeUppercase</code> would
-produce titles that are bold and upper case.
+produce titles that are bold and uppercase.
</p></dd>
</dl>
<p>These are LaTeX&rsquo;s defaults for the first three sectioning units that
are defined with <code>\@startsection</code>, for the <samp>article</samp>,
-<samp>book</samp>, and <samp>report</samp> classes.
+<samp>book</samp>, and <samp>report</samp> classes. For section, the <var>level</var> is
+1, the <var>indent</var> is 0pt, the <var>beforeskip</var> is <code>-3.5ex
+plus -1ex minus -0.2ex</code>, the <var>afterskip</var> is <code>2.3ex plus 0.2ex</code>,
+and the <var>style</var> is <code>\normalfont\Large\bfseries</code>. For
+subsection, the <var>level</var> is 2, the <var>indent</var> is 0pt, the
+<var>beforeskip</var> is <code>-3.25ex plus -1ex minus -0.2ex</code>, the
+<var>afterskip</var> is <code>1.5ex plus 0.2ex</code>, and the <var>style</var> is
+<code>\normalfont\large\bfseries</code>. For subsubsection, the <var>level</var>
+is 3, the <var>indent</var> is 0pt, the <var>beforeskip</var> is
+<code>-3.25ex plus -1ex minus -0.2ex</code>, the <var>afterskip</var> is
+<code>1.5ex plus 0.2ex</code>, and the <var>style</var> is
+<code>\normalfont\normalsize\bfseries</code>.
</p>
-<table>
-<thead><tr><th width="10%"></th><th width="30%"><code>section</code></th><th width="30%"><code>subsection</code></th><th width="30%"><code>subsubsection</code></th></tr></thead>
-<tr><td width="10%"><a href="#g_t_005c_0040startsection_002fname"><var>name</var></a></td><td width="30%">section</td><td width="30%">subsection</td><td width="30%">subsubsection</td></tr>
-<tr><td width="10%"><a href="#g_t_005c_0040startsection_002flevel"><var>level</var></a></td><td width="30%">1</td><td width="30%">2</td><td width="30%">3</td></tr>
-<tr><td width="10%"><a href="#g_t_005c_0040startsection_002findent"><var>indent</var></a></td><td width="30%"><code>0pt</code></td><td width="30%"><code>0pt</code></td><td width="30%"><code>0pt</code></td></tr>
-<tr><td width="10%"><a href="#g_t_005c_0040startsection_002fbeforeskip"><var>beforeskip</var></a></td><td width="30%"><code>-3.5ex plus -1ex minus -0.2ex</code></td><td width="30%"><code>-3.25ex plus -1ex minus -0.2ex</code></td><td width="30%"><code>-3.25ex plus -1ex minus -0.2ex</code></td></tr>
-<tr><td width="10%"><a href="#g_t_005c_0040startsection_002fafterskip"><var>afterskip</var></a></td><td width="30%"><code>2.3ex plus 0.2ex</code></td><td width="30%"><code>1.5ex plus 0.2ex</code></td><td width="30%"><code>1.5ex plus 0.2ex</code></td></tr>
-<tr><td width="10%"><a href="#g_t_005c_0040startsection_002fstyle"><var>style</var></a></td><td width="30%"><code>\normalfont\Large\bfseries</code></td><td width="30%"><code>\normalfont\large\bfseries</code></td><td width="30%"><code>\normalfont\normalsize\bfseries</code></td></tr>
-</table>
-
<p>Here are examples. They go either in a package or class file or in the
preamble of a LaTeX document. If you put them in the preamble they
must go between a <code>\makeatletter</code> command and a
<code>\makeatother</code>. (Probably the error message <code>You can't use
`\spacefactor' in vertical mode.</code> means that you forgot this.)
-See <a href="#g_t_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</a>.
+See <a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</a>.
</p>
<p>This will put section titles in large boldface type, centered. It says
<code>\renewcommand</code> because LaTeX&rsquo;s standard classes have already
@@ -3504,7 +4263,9 @@ defined a <code>\section</code>. For the same reason it does not define a
}
</pre></div>
-<p>The prior examples redefined existing sectional unit title commands. This defines a new one, illustrating the needed counter and macros to display that counter.
+<p>The prior examples redefined existing sectional unit title commands.
+This defines a new one, illustrating the needed counter and macros to
+display that counter.
</p>
<div class="example">
<pre class="example">\setcounter{secnumdepth}{6}% show counters this far down
@@ -3527,45 +4288,57 @@ defined a <code>\section</code>. For the same reason it does not define a
<a name="Cross-references"></a>
<div class="header">
<p>
-Next: <a href="#Environments" accesskey="n" rel="next">Environments</a>, Previous: <a href="#Sectioning" accesskey="p" rel="prev">Sectioning</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Environments" accesskey="n" rel="next">Environments</a>, Previous: <a href="#Sectioning" accesskey="p" rel="prev">Sectioning</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Cross-references-1"></a>
<h2 class="chapter">7 Cross references</h2>
<a name="index-cross-references"></a>
-<p>One reason for numbering things such as figures and equations is to
-refer the reader to them, as in &ldquo;See Figure~3 for more details.&rdquo;
-</p>
<a name="index-label"></a>
-<p>Including the figure number in the source is poor practice since if that
-number changes as the document evolves then you must remember to update
-this reference by hand. Instead, LaTeX has you write a <em>label</em>
-like <code>\label{eq:GreensThm}</code> and refer to it with <code>See
-equation~\ref{eq:GreensThm}</code>.
-</p>
-<p>LaTeX writes the information from the labels to a file with the same
-name as the file containing the <code>\label{...}</code> but with an
-<samp>.aux</samp> extension. (The information has the format
-<code>\newlabel{<var>label</var>}{{<var>currentlabel</var>}{<var>pagenumber</var>}}</code>
-where <var>currentlabel</var> is the current value of the macro
-<code>\@currentlabel</code> that is usually updated whenever you call
-<code>\refstepcounter{<var>counter</var>}</code>.)
+<p>We often want something like &lsquo;<samp>See Theorem~31</samp>&rsquo;. But by-hand typing
+the 31 is poor practice. Instead you should write a <em>label</em> such as
+<code>\label{eq:GreensThm}</code> and then <em>reference</em> it, as with
+<code>See equation~\ref{eq:GreensThm}</code>. LaTeX will automatically
+work out the number, put it into the output, and will change that number
+later if needed.
+</p>
+<div class="example">
+<pre class="example">We will see this with Theorem~\ref{th:GreensThm}. % forward reference
+...
+\begin{theorem} \label{th:GreensThm}
+ ...
+\end{theorem}
+...
+See Theorem~\ref{th:GreensThm} on page~\pageref{th:GreensThm}.
+</pre></div>
+
+<p>LaTeX tracks cross reference information in a file having the
+extension <samp>.aux</samp> and with the same base name as the file containing
+the <code>\label</code>. So if <code>\label</code> is in <samp>calculus.tex</samp> then
+the information is in <samp>calculus.aux</samp>. LaTeX puts the
+information in that file every time it runs across a <code>\label</code>.
</p>
<a name="index-forward-reference"></a>
<a name="index-reference_002c-forward"></a>
-<p>The most common side effect of the prior paragraph happens when your
-document has a <em>forward reference</em>, a <code>\ref{<var>key</var>}</code> that
-appears earlier than the associated <code>\label{<var>key</var>}</code>; see the
-example in the <code>\pageref{...}</code> description. LaTeX gets the
-information for references from the <samp>.aux</samp> file. If this is the
-first time you are compiling the document then you will get a message
-<code>LaTeX Warning: Label(s) may have changed. Rerun to get
-cross references right.</code> and in the output the reference will appear as
-two question marks&nbsp;&lsquo;<samp>??</samp>&rsquo;, in boldface. Or, if you change some
-things so the references change then you get the same warning and the
-output contains the old reference information. The solution in either
-case is just to compile the document a second time.
+<p>The behavior described in the prior paragraph results in a quirk that
+happens when your document has a <em>forward reference</em>, a <code>\ref</code>
+that appears before the associated <code>\label</code>. If this is the first
+time that you are compiling the document then you will get &lsquo;<samp>LaTeX
+Warning: Label(s) may have changed. Rerun to get cross references right</samp>&rsquo;
+and in the output the forward reference will appear as two question
+marks&nbsp;&lsquo;<samp>??</samp>&rsquo;, in boldface. A similar thing happens if you
+change some things so the references changes; you get the same warning
+and the output contains the old reference information. In both cases,
+resolve this by compiling the document a second time.
+</p>
+<a name="index-package_002c-cleveref"></a>
+<a name="index-cleveref-package"></a>
+<p>The <code>cleveref</code> package enhances LaTeX&rsquo;s
+cross referencing features. You can arrange that if you enter
+<code>\begin{thm}\label{th:Nerode}...\end{thm}</code> then
+<code>\cref{th:Nerode}</code> will output &lsquo;<samp>Theorem 3.21</samp>&rsquo;, without you
+having to enter the &ldquo;Theorem.&rdquo;
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#g_t_005clabel" accesskey="1">\label</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Assign a symbolic name to a piece of text.
@@ -3581,7 +4354,7 @@ case is just to compile the document a second time.
<a name="g_t_005clabel"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cpageref" accesskey="n" rel="next">\pageref</a>, Up: <a href="#Cross-references" accesskey="u" rel="up">Cross references</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cpageref" accesskey="n" rel="next">\pageref</a>, Up: <a href="#Cross-references" accesskey="u" rel="up">Cross references</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005clabel-1"></a>
<h3 class="section">7.1 <code>\label</code></h3>
@@ -3607,35 +4380,44 @@ punctuation characters. Upper and lowercase letters are
distinguished, as usual.
</p>
<p>A common convention is to use labels consisting of a prefix and a suffix
-separated by a colon or period. This helps to avoid accidentally
-creating two labels with the same name, and makes your source more
-readable. Some commonly-used prefixes:
+separated by a colon or period. Thus, <code>\label{fig:Post}</code> is a
+label for a figure with a portrait of Emil Post. This helps to avoid
+accidentally creating two labels with the same name, and makes your
+source more readable. Some commonly-used prefixes:
</p>
<dl compact="compact">
<dt><code>ch</code></dt>
<dd><p>for chapters
-</p></dd>
+</p>
+</dd>
<dt><code>sec</code></dt>
+<dt><code>subsec</code></dt>
<dd><p>for lower-level sectioning commands
-</p></dd>
+</p>
+</dd>
<dt><code>fig</code></dt>
<dd><p>for figures
-</p></dd>
+</p>
+</dd>
<dt><code>tab</code></dt>
<dd><p>for tables
-</p></dd>
+</p>
+</dd>
<dt><code>eq</code></dt>
<dd><p>for equations
</p></dd>
</dl>
-<p>Thus, <code>\label{fig:Euler}</code> is a label for a figure with a portrait
-of the great man.
+<p>In the auxiliary file the reference information is kept as the text of
+a command of the form
+<code>\newlabel{<var>label</var>}{{<var>currentlabel</var>}{<var>pagenumber</var>}}</code>.
+Here <var>currentlabel</var> is the current value of the macro
+<code>\@currentlabel</code> that is usually updated whenever you call
+<code>\refstepcounter{<var>counter</var>}</code>.
</p>
-<p>In this example below the key <code>sec:test</code> will get the number of the
-current section and the key <code>fig:test</code> will get the number of the
-figure. (Incidentally, put labels after captions in figures and
-tables.)
+<p>Below, the key <code>sec:test</code> will get the number of the current
+section and the key <code>fig:test</code> will get the number of the figure.
+(Incidentally, put labels after captions in figures and tables.)
</p>
<div class="example">
<pre class="example">\section{section name}
@@ -3654,10 +4436,10 @@ See Figure~\ref{fig:test}.
<a name="g_t_005cpageref"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cref" accesskey="n" rel="next">\ref</a>, Previous: <a href="#g_t_005clabel" accesskey="p" rel="prev">\label</a>, Up: <a href="#Cross-references" accesskey="u" rel="up">Cross references</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cref" accesskey="n" rel="next">\ref</a>, Previous: <a href="#g_t_005clabel" accesskey="p" rel="prev">\label</a>, Up: <a href="#Cross-references" accesskey="u" rel="up">Cross references</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cpageref_007bkey_007d"></a>
-<h3 class="section">7.2 <code>\pageref{<var>key</var>}</code></h3>
+<a name="g_t_005cpageref-1"></a>
+<h3 class="section">7.2 <code>\pageref</code></h3>
<a name="index-_005cpageref"></a>
<a name="index-cross-referencing-with-page-number"></a>
@@ -3672,10 +4454,14 @@ Next: <a href="#g_t_005cref" accesskey="n" rel="next">\ref</a>, Previous: <a hre
<p>Produce the page number of the place in the text where the corresponding
<code>\label</code>{<var>key</var>} command appears.
</p>
-<p>In this example the <code>\label{eq:main}</code> is used both for the
-formula number and for the page number. (Note that the two references
-are forward references, so this document would need to be compiled twice
-to resolve those.)
+<p>If there is no <code>\label{<var>key</var>}</code> then you get something like
+&lsquo;<samp>LaTeX Warning: Reference `th:GrensThm' on page 1 undefined on
+input line 11.</samp>&rsquo;
+</p>
+<p>Below, the <code>\label{eq:main}</code> is used both for the formula number
+and for the page number. (Note that the two references are forward
+references so this document would need to be compiled twice to resolve
+those.)
</p>
<div class="example">
<pre class="example">The main result is formula~\ref{eq:main} on page~\pageref{eq:main}.
@@ -3690,10 +4476,10 @@ to resolve those.)
<a name="g_t_005cref"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cpageref" accesskey="p" rel="prev">\pageref</a>, Up: <a href="#Cross-references" accesskey="u" rel="up">Cross references</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cpageref" accesskey="p" rel="prev">\pageref</a>, Up: <a href="#Cross-references" accesskey="u" rel="up">Cross references</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cref_007bkey_007d"></a>
-<h3 class="section">7.3 <code>\ref{<var>key</var>}</code></h3>
+<a name="g_t_005cref-1"></a>
+<h3 class="section">7.3 <code>\ref</code></h3>
<a name="index-_005cref"></a>
<a name="index-cross-referencing_002c-symbolic"></a>
@@ -3713,9 +4499,13 @@ equation, footnote, figure, &hellip;, of the corresponding
<code>\label</code> command (see <a href="#g_t_005clabel">\label</a>). It does not produce any text,
such as the word &lsquo;Section&rsquo; or &lsquo;Figure&rsquo;, just the bare number itself.
</p>
-<p>In this example, the <code>\ref{popular}</code> produces &lsquo;<samp>2</samp>&rsquo;. Note
-that it is a forward reference since it comes before
-<code>\label{popular}</code>.
+<p>If there is no <code>\label{<var>key</var>}</code> then you get something like
+&lsquo;<samp>LaTeX Warning: Reference `th:GrensThm' on page 1 undefined on
+input line 11.</samp>&rsquo;
+</p>
+<p>In this example the <code>\ref{popular}</code> produces &lsquo;<samp>2</samp>&rsquo;. Note that
+it is a forward reference since it comes before <code>\label{popular}</code>
+so this document would have to be compiled twice.
</p>
<div class="example">
<pre class="example">The most widely-used format is item number~\ref{popular}.
@@ -3726,12 +4516,18 @@ that it is a forward reference since it comes before
\end{enumerate}
</pre></div>
+<a name="index-package_002c-cleveref-1"></a>
+<a name="index-cleveref-package-1"></a>
+
+<p>The <samp>cleveref</samp> package includes text such as &lsquo;<samp>Theorem</samp>&rsquo; in the
+reference. See the documentation on CTAN.
+</p>
<hr>
<a name="Environments"></a>
<div class="header">
<p>
-Next: <a href="#Line-breaking" accesskey="n" rel="next">Line breaking</a>, Previous: <a href="#Cross-references" accesskey="p" rel="prev">Cross references</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Line-breaking" accesskey="n" rel="next">Line breaking</a>, Previous: <a href="#Cross-references" accesskey="p" rel="prev">Cross references</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Environments-2"></a>
<h2 class="chapter">8 Environments</h2>
@@ -3798,7 +4594,7 @@ the end. For instance, the input
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#picture">picture</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Picture with text, arrows, lines and circles.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#quotation-and-quote">quotation and quote</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Include a quotation.
+<tr><td align="left" valign="top">&bull; <a href="#quotation-_0026-quote">quotation &amp; quote</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Include a quotation.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tabbing">tabbing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Align text arbitrarily.
</td></tr>
@@ -3823,7 +4619,7 @@ the end. For instance, the input
<a name="abstract"></a>
<div class="header">
<p>
-Next: <a href="#array" accesskey="n" rel="next">array</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#array" accesskey="n" rel="next">array</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="abstract-1"></a>
<h3 class="section">8.1 <code>abstract</code></h3>
@@ -3887,7 +4683,7 @@ a more flexible solution, use the package <samp>abstract</samp>).
<a name="array"></a>
<div class="header">
<p>
-Next: <a href="#center" accesskey="n" rel="next">center</a>, Previous: <a href="#abstract" accesskey="p" rel="prev">abstract</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#center" accesskey="n" rel="next">center</a>, Previous: <a href="#abstract" accesskey="p" rel="prev">abstract</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="array-1"></a>
<h3 class="section">8.2 <code>array</code></h3>
@@ -3906,7 +4702,7 @@ Next: <a href="#center" accesskey="n" rel="next">center</a>, Previous: <a href="
\end{array}
</pre></div>
-<p>or
+<p>or:
</p>
<div class="example">
<pre class="example">\begin{array}[<var>pos</var>]{<var>cols</var>}
@@ -3917,26 +4713,44 @@ Next: <a href="#center" accesskey="n" rel="next">center</a>, Previous: <a href="
<p>Produce a mathematical array. This environment can only be used in math
mode, and normally appears within a displayed mathematics environment
-such as <code>equation</code> (see <a href="#equation">equation</a>). Column entries are
-separated by an ampersand&nbsp;(<code>&amp;</code>). Rows are terminated with
-double-backslashes (see <a href="#g_t_005c_005c">\\</a>).
+such as <code>equation</code> (see <a href="#equation">equation</a>). Inside of each row the
+column entries are separated by an ampersand, (<code>&amp;</code>). Rows are
+terminated with double-backslashes (see <a href="#g_t_005c_005c">\\</a>).
+</p>
+<p>This example shows a three by three array.
</p>
+<div class="example">
+<pre class="example">\begin{equation*}
+ \chi(x) =
+ \left| % vertical bar fence
+ \begin{array}{ccc}
+ x-a &amp;-b &amp;-c \\
+ -d &amp;x-e &amp;-f \\
+ -g &amp;-h &amp;x-i
+ \end{array}
+ \right|
+\end{equation*}
+</pre></div>
+
<p>The required argument <var>cols</var> describes the number of columns, their
-alignment, and the formatting of the intercolumn regions. See
-<a href="#tabular">tabular</a> for the complete description of <var>cols</var>, and of the
+alignment, and the formatting of the intercolumn regions. For instance,
+<code>\begin{array}{rcl}...\end{array}</code> gives three columns: the
+first flush right, the second centered, and the third flush left. See
+<a href="#tabular">tabular</a> for the complete description of <var>cols</var> and of the
other common features of the two environments, including the optional
<var>pos</var> argument.
</p>
<p>There are two ways that <code>array</code> diverges from <code>tabular</code>. The
first is that <code>array</code> entries are typeset in math mode, in
-textstyle (except if the <var>cols</var> definition specifies the column with
-<code>p{...}</code>, which causes the entry to be typeset in text mode).
-The second is that, instead of <code>tabular</code>&rsquo;s parameter
-<code>\tabcolsep</code>, LaTeX&rsquo;s intercolumn space in an <code>array</code> is governed
-by
+textstyle (see <a href="#Modes">Modes</a>) except if the <var>cols</var> definition specifies
+the column with <code>p{...}</code>, which causes the entry to be typeset in
+text mode. The second is that, instead of <code>tabular</code>&rsquo;s parameter
+<code>\tabcolsep</code>, LaTeX&rsquo;s intercolumn space in an <code>array</code> is
+governed by
<a name="index-_005carraycolsep"></a>
<code>\arraycolsep</code>, which gives half the width between columns. The
-default for this is &lsquo;<samp>5pt</samp>&rsquo;.
+default for this is &lsquo;<samp>5pt</samp>&rsquo; so that between two columns comes
+10pt of space.
</p>
<a name="index-package_002c-amsmath"></a>
<a name="index-amsmath-package"></a>
@@ -3950,35 +4764,39 @@ an array surrounded by vertical bars&nbsp;<code>|...|</code>, and
<code>Vmatrix</code> for an array surrounded by double vertical
bars&nbsp;<code>||...||</code>, along with a number of other array constructs.
</p>
-<p>Here is an example of an array:
-</p>
-<div class="example">
-<pre class="example">\begin{equation}
- \begin{array}{cr}
- \sqrt{y} &amp;12.3 \\
- x^2 &amp;3.4
- \end{array}
-\end{equation}
-</pre></div>
+<a name="index-package_002c-amsmath-1"></a>
+<a name="index-amsmath-package-1"></a>
-<p>The next example works if <code>\usepackage{amsmath}</code> is in the
-preamble:
+<p>The next example uses the <samp>amsmath</samp> package.
</p>
<div class="example">
-<pre class="example">\begin{equation}
- \begin{vmatrix}{cc}
+<pre class="example">\usepackage{amsmath} % in preamble
+
+\begin{equation}
+ \begin{vmatrix}{cc} % array with vert lines
a &amp;b \\
c &amp;d
\end{vmatrix}=ad-bc
\end{equation}
</pre></div>
+<a name="index-package_002c-array-_0028package_0029"></a>
+<a name="index-array-_0028package_0029-package"></a>
+
+<a name="index-package_002c-dcolumn"></a>
+<a name="index-dcolumn-package"></a>
+
+<p>There are many packages concerning arrays. The <samp>array</samp> package has
+many useful extensions, including more column types. The <samp>dcolumn</samp>
+package adds a column type to center on a decimal point. For both see
+the documentation on CTAN.
+</p>
<hr>
<a name="center"></a>
<div class="header">
<p>
-Next: <a href="#description" accesskey="n" rel="next">description</a>, Previous: <a href="#array" accesskey="p" rel="prev">array</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#description" accesskey="n" rel="next">description</a>, Previous: <a href="#array" accesskey="p" rel="prev">array</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="center-1"></a>
<h3 class="section">8.3 <code>center</code></h3>
@@ -3992,17 +4810,19 @@ Next: <a href="#description" accesskey="n" rel="next">description</a>, Previous:
</p>
<div class="example">
<pre class="example">\begin{center}
- ... text ...
+ <var>line1</var> \\
+ <var>line2</var> \\
+ ...
\end{center}
</pre></div>
<p>Create a new paragraph consisting of a sequence of lines that are
-centered within the left and right margins on the current page. Use
-double-backslash to get a line break at a particular spot (see <a href="#g_t_005c_005c">\\</a>).
+centered within the left and right margins. Use
+double-backslash, <code>\\</code>, to get a line break (see <a href="#g_t_005c_005c">\\</a>).
<a name="index-_005c_005c-_0028for-center_0029"></a>
-If some text environment body is too long to fit on a line, LaTeX
-will insert line breaks that avoid hyphenation and avoid stretching or
-shrinking any interword space.
+If some text is too long to fit on a line then LaTeX will insert line
+breaks that avoid hyphenation and avoid stretching or shrinking any
+interword space.
</p>
<p>This environment inserts space above and below the text body. See
<a href="#g_t_005ccentering">\centering</a> to avoid such space, for example inside a <code>figure</code>
@@ -4033,7 +4853,11 @@ ending.
\end{center}
</pre></div>
-<p>A double backslash after the final line is optional.
+<p>A double backslash after the final line is optional. If present it
+doesn&rsquo;t add any vertical space.
+</p>
+<p>In a two-column document the text is centered in a column, not in the
+entire page.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#g_t_005ccentering" accesskey="1">\centering</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Declaration form of the <code>center</code> environment.
@@ -4045,7 +4869,7 @@ ending.
<a name="g_t_005ccentering"></a>
<div class="header">
<p>
-Up: <a href="#center" accesskey="u" rel="up">center</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Up: <a href="#center" accesskey="u" rel="up">center</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005ccentering-1"></a>
<h4 class="subsection">8.3.1 <code>\centering</code></h4>
@@ -4053,12 +4877,40 @@ Up: <a href="#center" accesskey="u" rel="up">center</a> &nbsp; [<a href="#SEC_Co
<a name="index-_005ccentering"></a>
<a name="index-centering-text_002c-declaration-for"></a>
-<p>A declaration that causes material in its scope to be centered. It is
-most often used inside an environment such as <code>figure</code>, or in a
-<code>parbox</code>.
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">{\centering ... }
+</pre></div>
+
+<p>or
+</p>
+<div class="example">
+<pre class="example">\begin{group}
+ \centering ...
+\end{group}
+</pre></div>
+
+<p>Center the material in its scope. It is most often used inside an
+environment such as <code>figure</code>, or in a <code>parbox</code>.
+</p>
+<p>This example&rsquo;s <code>\centering</code> declaration causes the graphic to be
+horizontally centered.
+</p>
+<div class="example">
+<pre class="example">\begin{figure}
+ \centering
+ \includegraphics[width=0.6\textwidth]{ctan_lion.png}
+ \caption{CTAN Lion} \label{fig:CTANLion}
+\end{figure}
+</pre></div>
+
+<p>The scope of this <code>\centering</code> ends with the <code>\end{figure}</code>.
</p>
<p>Unlike the <code>center</code> environment, the <code>\centering</code> command does
-not add vertical space above and below the text.
+not add vertical space above and below the text. That&rsquo;s its advantage
+in the above example; there is not an excess of space.
</p>
<p>It also does not start a new paragraph; it simply changes how LaTeX
formats paragraph units. If <code>ww {\centering xx \\ yy} zz</code> is
@@ -4070,27 +4922,14 @@ environment such as <code>figure</code> or <code>table</code> that ends the
paragraph unit. Thus, if <code>{\centering xx \\ yy\par} zz</code> is
surrounded by blank lines then it makes a new paragraph with two
centered lines &lsquo;<samp>xx</samp>&rsquo; and &lsquo;<samp>yy</samp>&rsquo;, followed by a new paragraph with
-&lsquo;<samp>zz</samp>&rsquo; that is formatted as usual. See also the following example.
-</p>
-<p>This example&rsquo;s <code>\centering</code> causes the graphic to be horizontally
-centered.
-</p>
-<div class="example">
-<pre class="example">\begin{figure}
- \centering
- \includegraphics[width=0.6\textwidth]{ctan_lion.png}
- \caption{CTAN Lion} \label{fig:CTANLion}
-\end{figure}
-</pre></div>
-
-<p>The scope of the <code>\centering</code> ends with the <code>\end{figure}</code>.
+&lsquo;<samp>zz</samp>&rsquo; that is formatted as usual.
</p>
<hr>
<a name="description"></a>
<div class="header">
<p>
-Next: <a href="#displaymath" accesskey="n" rel="next">displaymath</a>, Previous: <a href="#center" accesskey="p" rel="prev">center</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#displaymath" accesskey="n" rel="next">displaymath</a>, Previous: <a href="#center" accesskey="p" rel="prev">center</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="description-1"></a>
<h3 class="section">8.4 <code>description</code></h3>
@@ -4105,21 +4944,19 @@ Next: <a href="#displaymath" accesskey="n" rel="next">displaymath</a>, Previous:
</p>
<div class="example">
<pre class="example">\begin{description}
-\item[<var>label of first item</var>] text of first item
-\item[<var>label of second item</var>] text of second item
- ...
+ \item[<var>label of first item</var>] <var>text of first item</var>
+ \item[<var>label of second item</var>] <var>text of second item</var>
+ ...
\end{description}
</pre></div>
-<p>Environment to make a labeled list of items. Each item&rsquo;s <var>label</var> is
-typeset in bold, and is flush left so that long labels continue into the
+<p>Environment to make a list of labeled items. Each item&rsquo;s <var>label</var> is
+typeset in bold and is flush left, so that long labels continue into the
first line of the item text. There must be at least one item; having
none causes the LaTeX error &lsquo;<samp>Something's wrong--perhaps a
missing \item</samp>&rsquo;.
</p>
<p>This example shows the environment used for a sequence of definitions.
-The labels &lsquo;<samp>lama</samp>&rsquo; and &lsquo;<samp>llama</samp>&rsquo; come out in boldface with their
-left edges aligned on the left margin.
</p>
<div class="example">
<pre class="example">\begin{definition}
@@ -4128,6 +4965,9 @@ left edges aligned on the left margin.
\end{definition}
</pre></div>
+<p>The labels &lsquo;<samp>lama</samp>&rsquo; and &lsquo;<samp>llama</samp>&rsquo; are output in boldface, with the
+left edge on the left margin.
+</p>
<a name="index-_005citem"></a>
<p>Start list items with the <code>\item</code> command (see <a href="#g_t_005citem">\item</a>). Use the
optional labels, as in <code>\item[Main point]</code>, because there is
@@ -4140,10 +4980,10 @@ may contain multiple paragraphs.
change given in argument style (see <a href="#Font-styles">Font styles</a>) then it will come
out bold. For instance, if the label text calls for typewriter with
<code>\item[\texttt{label text}]</code> then it will appear in bold
-typewriter, if that is available. The simplest way to get non-bold
-typewriter is to use declarative style: <code>\item[{\tt label
-text}]</code>. Similarly, get the standard roman font with <code>\item[{\rm
-label text}]</code>.
+typewriter, if that is available. The simplest way around this, in this
+example to get non-bold typewriter, is to use declarative style:
+<code>\item[{\tt label text}]</code>. Similarly, get the standard roman
+font with <code>\item[{\rm label text}]</code>.
</p>
<p>For other major LaTeX labelled list environments, see <a href="#itemize">itemize</a>
and <a href="#enumerate">enumerate</a>. Unlike those environments, nesting
@@ -4167,7 +5007,7 @@ lists.
<a name="displaymath"></a>
<div class="header">
<p>
-Next: <a href="#document" accesskey="n" rel="next">document</a>, Previous: <a href="#description" accesskey="p" rel="prev">description</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#document" accesskey="n" rel="next">document</a>, Previous: <a href="#description" accesskey="p" rel="prev">description</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="displaymath-1"></a>
<h3 class="section">8.5 <code>displaymath</code></h3>
@@ -4180,7 +5020,7 @@ Next: <a href="#document" accesskey="n" rel="next">document</a>, Previous: <a hr
</p>
<div class="example">
<pre class="example">\begin{displaymath}
-<var>math text</var>
+ <var>mathematical text</var>
\end{displaymath}
</pre></div>
@@ -4194,8 +5034,8 @@ math text. One way to get an equation number is to use the
</p>
<p>LaTeX will not break the <var>math text</var> across lines.
</p>
-<a name="index-package_002c-amsmath-1"></a>
-<a name="index-amsmath-package-1"></a>
+<a name="index-package_002c-amsmath-2"></a>
+<a name="index-amsmath-package-2"></a>
<p>Note that the <samp>amsmath</samp> package has significantly more extensive
displayed equation facilities. For example, there are a number of
@@ -4215,11 +5055,13 @@ different vertical spacing, and because the <code>displaymath</code>
environment honors the <code>fleqn</code> option.)
</p>
<p>The output from this example is centered and alone on its line.
-</p><div class="example">
+</p>
+<div class="example">
<pre class="example">\begin{displaymath}
\int_1^2 x^2\,dx=7/3
\end{displaymath}
</pre></div>
+
<p>Also, the integral sign is larger than the inline version
<code>\( \int_1^2 x^2\,dx=7/3 \)</code> produces.
</p>
@@ -4228,7 +5070,7 @@ environment honors the <code>fleqn</code> option.)
<a name="document"></a>
<div class="header">
<p>
-Next: <a href="#enumerate" accesskey="n" rel="next">enumerate</a>, Previous: <a href="#displaymath" accesskey="p" rel="prev">displaymath</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#enumerate" accesskey="n" rel="next">enumerate</a>, Previous: <a href="#displaymath" accesskey="p" rel="prev">displaymath</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="document-1"></a>
<h3 class="section">8.6 <code>document</code></h3>
@@ -4252,7 +5094,7 @@ It is required in every LaTeX document. See <a href="#Starting-and-ending">Star
<a name="g_t_005cAtBeginDocument"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cAtEndDocument" accesskey="n" rel="next">\AtEndDocument</a>, Up: <a href="#document" accesskey="u" rel="up">document</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cAtEndDocument" accesskey="n" rel="next">\AtEndDocument</a>, Up: <a href="#document" accesskey="u" rel="up">document</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cAtBeginDocument-1"></a>
<h4 class="subsection">8.6.1 <code>\AtBeginDocument</code></h4>
@@ -4280,7 +5122,7 @@ will be executed in the order that you gave them.
<a name="g_t_005cAtEndDocument"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cAtBeginDocument" accesskey="p" rel="prev">\AtBeginDocument</a>, Up: <a href="#document" accesskey="u" rel="up">document</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cAtBeginDocument" accesskey="p" rel="prev">\AtBeginDocument</a>, Up: <a href="#document" accesskey="u" rel="up">document</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cAtEndDocument-1"></a>
<h4 class="subsection">8.6.2 <code>\AtEndDocument</code></h4>
@@ -4309,7 +5151,7 @@ will be executed in the order that you gave them.
<a name="enumerate"></a>
<div class="header">
<p>
-Next: <a href="#eqnarray" accesskey="n" rel="next">eqnarray</a>, Previous: <a href="#document" accesskey="p" rel="prev">document</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#eqnarray" accesskey="n" rel="next">eqnarray</a>, Previous: <a href="#document" accesskey="p" rel="prev">document</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="enumerate-1"></a>
<h3 class="section">8.7 <code>enumerate</code></h3>
@@ -4323,9 +5165,9 @@ Next: <a href="#eqnarray" accesskey="n" rel="next">eqnarray</a>, Previous: <a hr
</p>
<div class="example">
<pre class="example">\begin{enumerate}
-\item[<var>optional label of first item</var>] text of first item
-\item[<var>optional label of second item</var>] text of second item
-...
+ \item[<var>optional label of first item</var>] <var>text of first item</var>
+ \item[<var>optional label of second item</var>] <var>text of second item</var>
+ ...
\end{enumerate}
</pre></div>
@@ -4364,16 +5206,16 @@ the outermost level.
</p>
<ol>
<li> arabic number followed by a period: &lsquo;<samp>1.</samp>&rsquo;, &lsquo;<samp>2.</samp>&rsquo;,&nbsp;&hellip;
-</li><li> lower case letter inside parentheses: &lsquo;<samp>(a)</samp>&rsquo;, &lsquo;<samp>(b)</samp>&rsquo;&nbsp;&hellip;
-</li><li> lower case roman numeral followed by a period: &lsquo;<samp>i.</samp>&rsquo;, &lsquo;<samp>ii.</samp>&rsquo;,&nbsp;&hellip;
-</li><li> upper case letter followed by a period: &lsquo;<samp>A.</samp>&rsquo;, &lsquo;<samp>B.</samp>&rsquo;,&nbsp;&hellip;
+</li><li> lowercase letter inside parentheses: &lsquo;<samp>(a)</samp>&rsquo;, &lsquo;<samp>(b)</samp>&rsquo;&nbsp;&hellip;
+</li><li> lowercase roman numeral followed by a period: &lsquo;<samp>i.</samp>&rsquo;, &lsquo;<samp>ii.</samp>&rsquo;,&nbsp;&hellip;
+</li><li> uppercase letter followed by a period: &lsquo;<samp>A.</samp>&rsquo;, &lsquo;<samp>B.</samp>&rsquo;,&nbsp;&hellip;
</li></ol>
<a name="index-_005cenumi"></a>
<a name="index-_005cenumii"></a>
<a name="index-_005cenumiii"></a>
<a name="index-_005cenumiv"></a>
-<p>The <code>enumerate</code> environment uses the counters <code>\enumi</code> through
+<a name="enumerate-enumi"></a><a name="enumerate-enumii"></a><a name="enumerate-enumiii"></a><a name="enumerate-enumiv"></a><p>The <code>enumerate</code> environment uses the counters <code>\enumi</code> through
<code>\enumiv</code> (see <a href="#Counters">Counters</a>).
</p>
<p>For other major LaTeX labeled list environments, see
@@ -4386,7 +5228,7 @@ useful for customizing lists.
<a name="index-_005clabelenumii"></a>
<a name="index-_005clabelenumiii"></a>
<a name="index-_005clabelenumiv"></a>
-<p>To change the format of the label use <code>\renewcommand</code>
+<a name="enumerate-labelenumi"></a><a name="enumerate-labelenumii"></a><a name="enumerate-labelenumiii"></a><a name="enumerate-labelenumiv"></a><p>To change the format of the label use <code>\renewcommand</code>
(see <a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a>) on the commands <code>\labelenumi</code>
through <code>\labelenumiv</code>. For instance, this first level list will be
labelled with uppercase letters, in boldface, and without a trailing
@@ -4408,7 +5250,7 @@ period.
<a name="eqnarray"></a>
<div class="header">
<p>
-Next: <a href="#equation" accesskey="n" rel="next">equation</a>, Previous: <a href="#enumerate" accesskey="p" rel="prev">enumerate</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#equation" accesskey="n" rel="next">equation</a>, Previous: <a href="#enumerate" accesskey="p" rel="prev">enumerate</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="eqnarray-1"></a>
<h3 class="section">8.8 <code>eqnarray</code></h3>
@@ -4422,17 +5264,16 @@ Next: <a href="#equation" accesskey="n" rel="next">equation</a>, Previous: <a hr
<a name="index-align-environment_002c-from-amsmath"></a>
<a name="index-amsmath-package_002c-replacing-eqnarray"></a>
<a name="index-Madsen_002c-Lars"></a>
-<p>First, a caveat: the <code>eqnarray</code> environment is depreciated. It has
-infelicities that cannot be overcome, including spacing that is
-inconsistent with other mathematics elements (see the article &ldquo;Avoid
-eqnarray!&rdquo; by Lars Madsen
+<p>The <code>eqnarray</code> environment is obsolete. It has infelicities,
+including spacing that is inconsistent with other mathematics elements.
+(See &ldquo;Avoid eqnarray!&rdquo; by Lars Madsen
<a href="http://tug.org/TUGboat/tb33-1/tb103madsen.pdf">http://tug.org/TUGboat/tb33-1/tb103madsen.pdf</a>). New documents
should include the <samp>amsmath</samp> package and use the displayed
mathematics environments provided there, such as the <code>align</code>
-environment.
+environment. We include a description only for completeness and for
+working with old documents.
</p>
-<p>Nevertheless, for completeness and for a reference when working with old
-documents, a synopsis:
+<p>Synopsis:
</p>
<div class="example">
<pre class="example">\begin{eqnarray}
@@ -4490,7 +5331,7 @@ while the third line has not entry on the left side.
<a name="equation"></a>
<div class="header">
<p>
-Next: <a href="#figure" accesskey="n" rel="next">figure</a>, Previous: <a href="#eqnarray" accesskey="p" rel="prev">eqnarray</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#figure" accesskey="n" rel="next">figure</a>, Previous: <a href="#eqnarray" accesskey="p" rel="prev">eqnarray</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="equation-1"></a>
<h3 class="section">8.9 <code>equation</code></h3>
@@ -4505,29 +5346,30 @@ Next: <a href="#figure" accesskey="n" rel="next">figure</a>, Previous: <a href="
</p>
<div class="example">
<pre class="example">\begin{equation}
- math text
+ <var>mathematical text</var>
\end{equation}
</pre></div>
-<p>Make a <code>displaymath</code> environment (see <a href="#displaymath">displaymath</a>) with an
-equation number in the right margin.
-</p>
-<p>The equation number is generated using the <code>equation</code> counter.
+<p>The same as a <code>displaymath</code> environment (see <a href="#displaymath">displaymath</a>)
+except that LaTeX puts an equation number flush to the right margin.
+The equation number is generated using the <code>equation</code> counter.
</p>
<p>You should have no blank lines between <code>\begin{equation}</code> and
<code>\begin{equation}</code>, or LaTeX will tell you that there is a
-missing dollar sign,&nbsp;$<code>$</code>.
+missing dollar sign.
</p>
-<p>Note that the <samp>amsmath</samp> package has extensive displayed equation
-facilities. Those facilities are the best approach for such output in
-new documents.
+<a name="index-package_002c-amsmath-3"></a>
+<a name="index-amsmath-package-3"></a>
+
+<p>The package <samp>amsmath</samp> package has extensive displayed equation
+facilities. New documents should include this package.
</p>
<hr>
<a name="figure"></a>
<div class="header">
<p>
-Next: <a href="#filecontents" accesskey="n" rel="next">filecontents</a>, Previous: <a href="#equation" accesskey="p" rel="prev">equation</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#filecontents" accesskey="n" rel="next">filecontents</a>, Previous: <a href="#equation" accesskey="p" rel="prev">equation</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="figure-1"></a>
<h3 class="section">8.10 <code>figure</code></h3>
@@ -4542,29 +5384,36 @@ Next: <a href="#filecontents" accesskey="n" rel="next">filecontents</a>, Previou
</p>
<div class="example">
<pre class="example">\begin{figure}[<var>placement</var>]
- figure body
-\caption[<var>loftitle</var>]{<var>title</var>}
-\label{<var>label}</var>
+ <var>figure body</var>
+ \caption[<var>loftitle</var>]{<var>title</var>} % optional
+ \label{<var>label}</var> % optional
\end{figure}
</pre></div>
-<p>or
+<p>or:
</p>
<div class="example">
<pre class="example">\begin{figure*}[<var>placement</var>]
- figure body
-\caption[<var>loftitle</var>]{<var>title</var>}
-\label{<var>label}</var>
+ <var>figure body</var>
+ \caption[<var>loftitle</var>]{<var>title</var>} % optional
+ \label{<var>label}</var> % optional
\end{figure*}
</pre></div>
-<p>A class of floats (see <a href="#Floats">Floats</a>). Because they cannot be split across
-pages, they are not typeset in sequence with the normal text but instead
-are &ldquo;floated&rdquo; to a convenient place, such as the top of a following
-page.
+<p>Figures are for material that is not part of the normal text. An
+example is material that you cannot have split between two pages, such
+as a graphic. Because of this, LaTeX does not typeset figures in
+sequence with normal text but instead &ldquo;floats&rdquo; them to a convenient
+place, such as the top of a following page (see <a href="#Floats">Floats</a>).
</p>
-<p>For the possible values of <var>placement</var> and their effect on the
-float placement algorithm, see <a href="#Floats">Floats</a>.
+<p>The <var>figure body</var> can consist of imported graphics
+(see <a href="#Graphics">Graphics</a>), or text, LaTeX commands, etc. It is typeset in a
+<code>parbox</code> of width <code>\textwidth</code>.
+</p>
+<p>The possible values of <var>placement</var> are <code>h</code> for &lsquo;<samp>here</samp>&rsquo;,
+<code>t</code> for &lsquo;<samp>top</samp>&rsquo;, <code>b</code> for &lsquo;<samp>bottom</samp>&rsquo;, and <code>p</code> for
+&lsquo;<samp>on a separate page of floats</samp>&rsquo;. For the effect of these options on
+the float placement algorithm, see <a href="#Floats">Floats</a>.
</p>
<p>The starred form <code>figure*</code> is used when a document is in
double-column mode (see <a href="#g_t_005ctwocolumn">\twocolumn</a>). It produces a figure that
@@ -4572,22 +5421,20 @@ spans both columns, at the top of the page. To add the possibility of
placing at a page bottom see the discussion of <var>placement</var> <code>b</code>
in <a href="#Floats">Floats</a>.
</p>
-<p>The figure body is typeset in a <code>parbox</code> of width <code>\textwidth</code>
-and so it can contain text, commands, etc.
-</p>
<p>The label is optional; it is used for cross references (see <a href="#Cross-references">Cross references</a>).
<a name="index-_005ccaption"></a>
The optional <code>\caption</code> command specifies caption text for the
figure. By default it is numbered. If <var>loftitle</var> is present, it is
-used in the list of figures instead of <var>title</var> (see <a href="#Tables-of-contents">Tables of contents</a>).
+used in the list of figures instead of <var>title</var> (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>).
</p>
-<p>This example makes a figure out of a graphic. It requires one of the
-packages <samp>graphics</samp> or <samp>graphicx</samp>. The graphic, with its
-caption, will be placed at the top of a page or, if it is pushed to the
+<p>This example makes a figure out of a graphic. LaTeX will place that
+graphic and its caption at the top of a page or, if it is pushed to the
end of the document, on a page of floats.
</p>
<div class="example">
-<pre class="example">\begin{figure}[t]
+<pre class="example">\usepackage{graphicx} % in preamble
+ ...
+\begin{figure}[t]
\centering
\includegraphics[width=0.5\textwidth]{CTANlion.png}
\caption{The CTAN lion, by Duane Bibby}
@@ -4599,7 +5446,7 @@ end of the document, on a page of floats.
<a name="filecontents"></a>
<div class="header">
<p>
-Next: <a href="#flushleft" accesskey="n" rel="next">flushleft</a>, Previous: <a href="#figure" accesskey="p" rel="prev">figure</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#flushleft" accesskey="n" rel="next">flushleft</a>, Previous: <a href="#figure" accesskey="p" rel="prev">figure</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="filecontents_003a-Write-an-external-file"></a>
<h3 class="section">8.11 <code>filecontents</code>: Write an external file</h3>
@@ -4674,7 +5521,7 @@ Article by \myname.
<a name="flushleft"></a>
<div class="header">
<p>
-Next: <a href="#flushright" accesskey="n" rel="next">flushright</a>, Previous: <a href="#filecontents" accesskey="p" rel="prev">filecontents</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#flushright" accesskey="n" rel="next">flushright</a>, Previous: <a href="#filecontents" accesskey="p" rel="prev">filecontents</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="flushleft-1"></a>
<h3 class="section">8.12 <code>flushleft</code></h3>
@@ -4685,19 +5532,38 @@ Next: <a href="#flushright" accesskey="n" rel="next">flushright</a>, Previous: <
<a name="index-left_002djustifying-text_002c-environment-for"></a>
<a name="index-ragged-right-text_002c-environment-for"></a>
+<p>Synopsis:
+</p>
<div class="example">
<pre class="example">\begin{flushleft}
-<var>line1</var> \\
-<var>line2</var> \\
-...
+ <var>line1</var> \\
+ <var>line2</var> \\
+ ...
\end{flushleft}
</pre></div>
<a name="index-_005c_005c-for-flushleft"></a>
-<p>The <code>flushleft</code> environment allows you to create a paragraph
-consisting of lines that are flush to the left-hand margin and ragged
-right. Each line must be terminated with the string <code>\\</code>.
-</p>
+<p>An environment that creates a paragraph whose lines are flush to the
+left-hand margin, and ragged right. If you have lines that are too long
+then LaTeX will linebreak them in a way that avoids hyphenation and
+stretching or shrinking spaces. To force a new line use a double
+backslash, <code>\\</code>. For the declaration form
+see&nbsp;<a href="#g_t_005craggedright">\raggedright</a>.
+</p>
+<p>This creates a box of text that is at most 3 inches wide, with the text
+flush left and ragged right.
+</p>
+<div class="example">
+<pre class="example">\noindent\begin{minipage}{3in}
+\begin{flushleft}
+ A long sentence that will be broken by \LaTeX{}
+ at a convenient spot. \\
+ And, a fresh line forced by the double backslash.
+\end{flushleft}
+\end{minipage}
+</pre></div>
+
+
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#g_t_005craggedright" accesskey="1">\raggedright</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Declaration form of the <code>flushleft</code> environment.
</td></tr>
@@ -4708,7 +5574,7 @@ right. Each line must be terminated with the string <code>\\</code>.
<a name="g_t_005craggedright"></a>
<div class="header">
<p>
-Up: <a href="#flushleft" accesskey="u" rel="up">flushleft</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Up: <a href="#flushleft" accesskey="u" rel="up">flushleft</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005craggedright-1"></a>
<h4 class="subsection">8.12.1 <code>\raggedright</code></h4>
@@ -4718,9 +5584,24 @@ Up: <a href="#flushleft" accesskey="u" rel="up">flushleft</a> &nbsp; [<a href="#
<a name="index-left_002djustifying-text"></a>
<a name="index-justification_002c-ragged-right"></a>
-<p>The <code>\raggedright</code> declaration corresponds to the
-<code>flushleft</code> environment. This declaration can be used inside an
-environment such as <code>quote</code> or in a <code>parbox</code>.
+<p>Synopses:
+</p>
+<div class="example">
+<pre class="example">{\raggedright ... }
+</pre></div>
+
+<p>or
+</p>
+<div class="example">
+<pre class="example">\begin{<var>environment</var>} \raggedright
+ ...
+\end{<var>environment</var>}
+</pre></div>
+
+<p>A declaration which causes lines to be flush to the left margin and
+ragged right. It can be used inside an environment such as <code>quote</code>
+or in a <code>parbox</code>. For the environment form
+see&nbsp;<a href="#flushleft">flushleft</a>.
</p>
<p>Unlike the <code>flushleft</code> environment, the <code>\raggedright</code>
command does not start a new paragraph; it only changes how LaTeX
@@ -4728,12 +5609,25 @@ formats paragraph units. To affect a paragraph unit&rsquo;s format, the
scope of the declaration must contain the blank line or <code>\end</code>
command that ends the paragraph unit.
</p>
+<p>Here <code>\raggedright</code> in each second column keeps LaTeX from doing
+very awkward typesetting to fit the text into the narrow column. Note
+that <code>\raggedright</code> is inside the curly braces <code>{...}</code> to
+delimit its effect.
+</p>
+<div class="example">
+<pre class="example">\begin{tabular}{rp{2in}}
+ Team alpha &amp;{\raggedright This team does all the real work.} \\
+ Team beta &amp;{\raggedright This team ensures that the water
+ cooler is never empty.} \\
+\end{tabular}
+</pre></div>
+
<hr>
<a name="flushright"></a>
<div class="header">
<p>
-Next: <a href="#itemize" accesskey="n" rel="next">itemize</a>, Previous: <a href="#flushleft" accesskey="p" rel="prev">flushleft</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#itemize" accesskey="n" rel="next">itemize</a>, Previous: <a href="#flushleft" accesskey="p" rel="prev">flushleft</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="flushright-1"></a>
<h3 class="section">8.13 <code>flushright</code></h3>
@@ -4746,16 +5640,21 @@ Next: <a href="#itemize" accesskey="n" rel="next">itemize</a>, Previous: <a href
<div class="example">
<pre class="example">\begin{flushright}
-<var>line1</var> \\
-<var>line2</var> \\
-...
+ <var>line1</var> \\
+ <var>line2</var> \\
+ ...
\end{flushright}
</pre></div>
<a name="index-_005c_005c-_0028for-flushright_0029"></a>
-<p>The <code>flushright</code> environment allows you to create a paragraph
-consisting of lines that are flush to the right-hand margin and ragged
-left. Each line must be terminated with the control sequence <code>\\</code>.
+<p>An environment that creates a paragraph whose lines are flush to the
+right-hand margin and ragged left. If you have lines that are too long
+to fit the margins then LaTeX will linebreak them in a way that
+avoids hyphenation and stretching or shrinking spaces. To force a new
+line use a double backslash, <code>\\</code>. For the declaration form
+see&nbsp;<a href="#g_t_005craggedleft">\raggedleft</a>.
+</p>
+<p>For an example related to this environment, see&nbsp;<a href="#flushleft">flushleft</a>.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#g_t_005craggedleft" accesskey="1">\raggedleft</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Declaration form of the <code>flushright</code> environment.
@@ -4767,7 +5666,7 @@ left. Each line must be terminated with the control sequence <code>\\</code>.
<a name="g_t_005craggedleft"></a>
<div class="header">
<p>
-Up: <a href="#flushright" accesskey="u" rel="up">flushright</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Up: <a href="#flushright" accesskey="u" rel="up">flushright</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005craggedleft-1"></a>
<h4 class="subsection">8.13.1 <code>\raggedleft</code></h4>
@@ -4777,9 +5676,24 @@ Up: <a href="#flushright" accesskey="u" rel="up">flushright</a> &nbsp; [<a href=
<a name="index-justification_002c-ragged-left"></a>
<a name="index-right_002djustifying-text"></a>
-<p>The <code>\raggedleft</code> declaration corresponds to the
-<code>flushright</code> environment. This declaration can be used inside an
-environment such as <code>quote</code> or in a <code>parbox</code>.
+<p>Synopses:
+</p>
+<div class="example">
+<pre class="example">{\raggedleft ... }
+</pre></div>
+
+<p>or
+</p>
+<div class="example">
+<pre class="example">\begin{<var>environment</var>} \raggedleft
+ ...
+\end{<var>environment</var>}
+</pre></div>
+
+<p>A declaration which causes lines to be flush to the right margin and
+ragged left. It can be used inside an environment such as <code>quote</code>
+or in a <code>parbox</code>. For the environment form
+see&nbsp;<a href="#flushright">flushright</a>.
</p>
<p>Unlike the <code>flushright</code> environment, the <code>\raggedleft</code>
command does not start a new paragraph; it only changes how LaTeX
@@ -4787,12 +5701,14 @@ formats paragraph units. To affect a paragraph unit&rsquo;s format, the
scope of the declaration must contain the blank line or <code>\end</code>
command that ends the paragraph unit.
</p>
+<p>For an example related to this environment, see&nbsp;<a href="#g_t_005craggedright">\raggedright</a>.
+</p>
<hr>
<a name="itemize"></a>
<div class="header">
<p>
-Next: <a href="#letter" accesskey="n" rel="next">letter</a>, Previous: <a href="#flushright" accesskey="p" rel="prev">flushright</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#letter" accesskey="n" rel="next">letter</a>, Previous: <a href="#flushright" accesskey="p" rel="prev">flushright</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="itemize-1"></a>
<h3 class="section">8.14 <code>itemize</code></h3>
@@ -4804,25 +5720,23 @@ Next: <a href="#letter" accesskey="n" rel="next">letter</a>, Previous: <a href="
<a name="index-lists-of-items"></a>
<a name="index-unordered-lists"></a>
<a name="index-bulleted-lists"></a>
+<a name="index-bullet-lists"></a>
<p>Synopsis:
</p>
<div class="example">
<pre class="example">\begin{itemize}
-\item[<var>optional label of first item</var>] text of first item
-\item[<var>optional label of second item</var>] text of second item
-...
+ \item[<var>optional label of first item</var>] <var>text of first item</var>
+ \item[<var>optional label of second item</var>] <var>text of second item</var>
+ ...
\end{itemize}
</pre></div>
-<p>The <code>itemize</code> environment produces an &ldquo;unordered&rdquo;, &ldquo;bulleted&rdquo;
-list. The format of the label numbering depends on the nesting level of
-this environment; see below. Each <code>itemize</code> list environment must
-have at least one item; having none causes the LaTeX error
-&lsquo;<samp>Something's wrong--perhaps a missing \item</samp>&rsquo;.
+<p>Produce a list that is unordered, sometimes called a bullet list. The
+environment must have at least one <code>\item</code>; having none causes the
+LaTeX error &lsquo;<samp>Something's wrong--perhaps a missing \item</samp>&rsquo;.
</p>
-<p>This example gives a two-item list. As a top-level list each label
-would come out as a bullet, &bull;.
+<p>This gives a two-item list.
</p>
<div class="example">
<pre class="example">\begin{itemize}
@@ -4831,6 +5745,9 @@ would come out as a bullet, &bull;.
\end{itemize}
</pre></div>
+<p>As a top-level list each label would come out as a bullet, &bull;.
+The format of the labeling depends on the nesting level; see below.
+</p>
<a name="index-_005citem-3"></a>
<p>Start list items with the <code>\item</code> command (see <a href="#g_t_005citem">\item</a>). If you
give <code>\item</code> an optional argument by following it with square
@@ -4844,11 +5761,11 @@ contain multiple paragraphs.
<a name="index-_005clabelitemii"></a>
<a name="index-_005clabelitemiii"></a>
<a name="index-_005clabelitemiv"></a>
-<p>Itemized lists can be nested within one another, up to four levels deep.
+<a name="itemize-labelitemi"></a><a name="itemize-labelitemii"></a><a name="itemize-labelitemiii"></a><a name="itemize-labelitemiv"></a><p>Itemized lists can be nested within one another, up to four levels deep.
They can also be nested within other paragraph-making environments, such
as <code>enumerate</code> (see <a href="#enumerate">enumerate</a>). The <code>itemize</code> environment
uses the commands <code>\labelitemi</code> through <code>\labelitemiv</code> to
-produce the default label (this also uses the convention of lower case
+produce the default label (this also uses the convention of lowercase
roman numerals at the end of the command names that signify the nesting
level). These are the default marks at each level.
</p>
@@ -4873,10 +5790,10 @@ the first level use diamonds.
<a name="index-_005cleftmarginiv"></a>
<a name="index-_005cleftmarginv"></a>
<a name="index-_005cleftmarginvi"></a>
-<p>The distance between the left margin of the enclosing environment and
+<a name="itemize-leftmargin"></a><a name="itemize-leftmargini"></a><a name="itemize-leftmarginii"></a><a name="itemize-leftmarginiii"></a><a name="itemize-leftmarginiv"></a><a name="itemize-leftmarginv"></a><a name="itemize-leftmarginvi"></a><p>The distance between the left margin of the enclosing environment and
the left margin of the <code>itemize</code> list is determined by the
parameters <code>\leftmargini</code> through <code>\leftmarginvi</code>. (Note the
-convention of using lower case roman numerals a the end of the command
+convention of using lowercase roman numerals a the end of the command
name to denote the nesting level.) The defaults are: <code>2.5em</code> in
level 1 (<code>2em</code> in two-column mode), <code>2.2em</code> in level 2,
<code>1.87em</code> in level 3, and <code>1.7em</code> in level 4, with smaller
@@ -4900,7 +5817,7 @@ lists.
space between items. Here is an example defining an <code>itemize*</code>
environment with no extra spacing between items, or between paragraphs
within a single item (<code>\parskip</code> is not list-specific,
-see <a href="#g_t_005cparskip">\parskip</a>):
+see <a href="#g_t_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</a>):
</p>
<div class="example">
<pre class="example">\newenvironment{itemize*}%
@@ -4916,7 +5833,7 @@ see <a href="#g_t_005cparskip">\parskip</a>):
<a name="letter"></a>
<div class="header">
<p>
-Next: <a href="#list" accesskey="n" rel="next">list</a>, Previous: <a href="#itemize" accesskey="p" rel="prev">itemize</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#list" accesskey="n" rel="next">list</a>, Previous: <a href="#itemize" accesskey="p" rel="prev">itemize</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="letter-environment_003a-writing-letters"></a>
<h3 class="section">8.15 <code>letter</code> environment: writing letters</h3>
@@ -4932,7 +5849,7 @@ Next: <a href="#list" accesskey="n" rel="next">list</a>, Previous: <a href="#ite
<a name="list"></a>
<div class="header">
<p>
-Next: <a href="#math" accesskey="n" rel="next">math</a>, Previous: <a href="#letter" accesskey="p" rel="prev">letter</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#math" accesskey="n" rel="next">math</a>, Previous: <a href="#letter" accesskey="p" rel="prev">letter</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="list-1"></a>
<h3 class="section">8.16 <code>list</code></h3>
@@ -4946,36 +5863,34 @@ Next: <a href="#math" accesskey="n" rel="next">math</a>, Previous: <a href="#let
</p>
<div class="example">
<pre class="example">\begin{list}{<var>labeling</var>}{<var>spacing</var>}
-\item[<var>optional label of first item</var>] text of first item
-\item[<var>optional label of second item</var>] text of second item
-...
+ \item[<var>optional label of first item</var>] <var>text of first item</var>
+ \item[<var>optional label of second item</var>] <var>text of second item</var>
+ ...
\end{list}
</pre></div>
-<p>The <code>list</code> environment is a generic environment for constructing
-more specialized lists. It is most often used to create lists via the
-<code>description</code>, <code>enumerate</code>, and <code>itemize</code> environments
-(see <a href="#description">description</a>, <a href="#enumerate">enumerate</a>, and <a href="#itemize">itemize</a>).
+<p>An environment for constructing lists.
</p>
-<p>Also, many standard LaTeX environments that are not visually lists
-are constructed using <code>list</code>, including <code>quotation</code>,
-<code>quote</code>, <code>center</code>, <code>verbatim</code>, and plenty more
-(see <a href="#quotation-and-quote">quotation and quote</a>, see <a href="#center">center</a>, see <a href="#flushright">flushright</a>).
+<p>Note that this environment does not typically appear in the document
+body. Most lists created by LaTeX authors are the ones that come
+standard: the <code>description</code>, <code>enumerate</code>, and <code>itemize</code>
+environments (see <a href="#description">description</a>, <a href="#enumerate">enumerate</a>, and <a href="#itemize">itemize</a>).
</p>
-<a name="index-package_002c-enumitem"></a>
-<a name="index-enumitem-package"></a>
-
-<p>The third-party package <code>enumitem</code> is useful for customizing lists.
-Here, we describe the <code>list</code> environment by defining a new custom
+<p>Instead, the <code>list</code> environment is most often used in macros. For
+example, many standard LaTeX environments that do not immediately
+appear to be lists are in fact constructed using <code>list</code>, including
+<code>quotation</code>, <code>quote</code>, and <code>center</code> (see <a href="#quotation-_0026-quote">quotation &amp; quote</a>, see <a href="#center">center</a>).
+</p>
+<p>This uses the <code>list</code> environment to define a new custom
environment.
</p>
<div class="example">
<pre class="example">\newcounter{namedlistcounter} % number the items
\newenvironment{named}
{\begin{list}
- {Item~\Roman{namedlistcounter}.} % labeling argument
- {\usecounter{namedlistcounter} % spacing argument
- \setlength{\leftmargin}{3.5em}} % still spacing arg
+ {Item~\Roman{namedlistcounter}.} % labeling
+ {\usecounter{namedlistcounter} % set counter
+ \setlength{\leftmargin}{3.5em}} % set spacing
}
{\end{list}}
@@ -4986,60 +5901,61 @@ environment.
\end{named}
</pre></div>
-<p>The <code>list</code> environment&rsquo;s mandatory first argument,
-<var>labeling</var>, specifies the default labeling of list items. It can
-contain text and LaTeX commands, as above where it contains both
-&lsquo;<samp>Item</samp>&rsquo; and &lsquo;<samp>\Roman{...}</samp>&rsquo;. LaTeX forms the label by
-putting the <var>labeling</var> argument in a box of width
-<code>\labelwidth</code>. If the label is wider than that, the additional
-material extends to the right. When making an instance of a list you
-can override the default labeling by giving <code>\item</code> an optional
-argument by including square braces and the text, as in the above
-<code>\item[Special label.]</code>; see <a href="#g_t_005citem">\item</a>.
+<p>The mandatory first argument <var>labeling</var> specifies the default
+labeling of list items. It can contain text and LaTeX commands, as
+above where it contains both &lsquo;<samp>Item</samp>&rsquo; and &lsquo;<samp>\Roman{...}</samp>&rsquo;.
+LaTeX forms the label by putting the <var>labeling</var> argument in a box
+of width <code>\labelwidth</code>. If the label is wider than that, the
+additional material extends to the right. When making an instance of a
+list you can override the default labeling by giving <code>\item</code> an
+optional argument by including square braces and the text, as in the
+above <code>\item[Special label.]</code>; see <a href="#g_t_005citem">\item</a>.
+</p>
+<p>The mandatory second argument <var>spacing</var> has a list of commands.
+This list can be empty. A command that can go in here is
+<code>\usecounter{<var>countername</var>}</code> (see <a href="#g_t_005cusecounter">\usecounter</a>). Use this
+to tell LaTeX to number the items using the given counter. The
+counter will be reset to zero each time LaTeX enters the environment,
+and the counter is incremented by one each time LaTeX encounters an
+<code>\item</code> that does not have an optional argument.
</p>
<a name="index-_005cmakelabel"></a>
-<p>The label box is constructed by the command <code>\makelabel</code>. By
-default it positions the contents flush right. It takes one argument,
-the label. It typesets the contents in LR mode. An example of changing
-its definition is that to the above example before the definition of the
-<code>named</code> environment add
+<a name="list-makelabel"></a><p>Another command that can go in <var>spacing</var> is
+<code>\makelabel</code>, which constructs the label box. By default it puts
+the contents flush right. Its only argument is the label, which it
+typesets in LR mode (see <a href="#Modes">Modes</a>). One example of changing its
+definition is that to the above <code>named</code> example, before the
+definition of the environment add
<code>\newcommand{\namedmakelabel}[1]{\textsc{#1}}</code>, and between
the <code>\setlength</code> command and the parenthesis that closes the
<var>spacing</var> argument also add <code>\let\makelabel\namedmakelabel</code>.
Then the items will be typeset in small caps. Similarly, changing the
second code line to <code>\let\makelabel\fbox</code> puts the labels inside a
-framed box. Another example is at the bottom of this entry.
-</p>
-<p>The mandatory second argument <var>spacing</var> can have a list of
-commands to redefine the spacing parameters for the list, such as
-<code>\setlength{\labelwidth}{2em}</code>. If this argument is empty,
-i.e., <code>{}</code>, then the list will have the default spacing given
-below. To number the items using a counter, put
-<code>\usecounter{<var>countername</var>}</code> in this argument
-(see <a href="#g_t_005cusecounter">\usecounter</a>).
-</p>
-<p>Below are the spacing parameters for list formatting. See also the
-figure below. Each is a length (see <a href="#Lengths">Lengths</a>). The vertical
-spaces are normally rubber lengths, with <code>plus</code> and <code>minus</code>
-components, to give TeX flexibility in setting the page. Change
-each with a command such as <code>\setlength{itemsep}{2pt plus1pt
-minus1pt}</code>. For some effects these lengths should be zero or
-negative. Default values for derived environments such as
-<code>itemize</code> can be changed from the values shown here for the basic
-<code>list</code>.
+framed box. Another example of the <code>\makelabel</code> command is below,
+in the definition of the <code>redlabel</code> environment.
+</p>
+<p>Also often in <var>spacing</var> are commands to redefine the spacing for the
+list. Below are the spacing parameters with their default values.
+(Default values for derived environments such as <code>itemize</code> can be
+different than the values shown here.) See also the figure that follows
+the list. Each is a length (see <a href="#Lengths">Lengths</a>). The vertical spaces are
+normally rubber lengths, with <code>plus</code> and <code>minus</code> components,
+to give TeX flexibility in setting the page. Change each with a
+command such as <code>\setlength{itemsep}{2pt plus1pt minus1pt}</code>.
+For some effects these lengths should be zero or negative.
</p>
<dl compact="compact">
<dt><code>\itemindent</code>
<a name="index-_005citemindent"></a>
</dt>
-<dd><p>Extra horizontal space indentation, beyond <code>leftmargin</code>, of the
+<dd><a name="list-itemindent"></a><p>Extra horizontal space indentation, beyond <code>leftmargin</code>, of the
first line each item. Its default value is <code>0pt</code>.
</p>
</dd>
<dt><code>\itemsep</code>
<a name="index-_005citemsep"></a>
</dt>
-<dd><p>Vertical space between items, beyond the <code>\parsep</code>. The defaults
+<dd><a name="list-itemsep"></a><p>Vertical space between items, beyond the <code>\parsep</code>. The defaults
for the first three levels in LaTeX&rsquo;s &lsquo;<samp>article</samp>&rsquo;, &lsquo;<samp>book</samp>&rsquo;,
and &lsquo;<samp>report</samp>&rsquo; classes at 10 point size are: <code>4pt plus2pt
minus1pt</code>, <code>\parsep</code> (that is, <code>2pt plus1pt minus1pt</code>), and
@@ -5054,7 +5970,7 @@ minus1pt</code>, <code>\parsep</code> (that is, <code>2.5pt plus1pt minus1pt</co
<dt><code>\labelsep</code>
<a name="index-_005clabelsep"></a>
</dt>
-<dd><p>Horizontal space between the label and text of an item.
+<dd><a name="list-labelsep"></a><p>Horizontal space between the label and text of an item.
The default for LaTeX&rsquo;s &lsquo;<samp>article</samp>&rsquo;, &lsquo;<samp>book</samp>&rsquo;,
and &lsquo;<samp>report</samp>&rsquo; classes is <code>0.5em</code>.
</p>
@@ -5062,7 +5978,7 @@ and &lsquo;<samp>report</samp>&rsquo; classes is <code>0.5em</code>.
<dt><code>\labelwidth</code>
<a name="index-_005clabelwidth"></a>
</dt>
-<dd><p>Horizontal width. The box containing the label is nominally this wide.
+<dd><a name="list-labelwidth"></a><p>Horizontal width. The box containing the label is nominally this wide.
If <code>\makelabel</code> returns text that is wider than this then the first
line of the item will be indented to make room for this extra material.
If <code>\makelabel</code> returns text of width less than or equal to
@@ -5086,7 +6002,7 @@ environment.
<dt><code>\leftmargin</code>
<a name="index-_005cleftmargin-1"></a>
</dt>
-<dd><p>Horizontal space between the left margin of the enclosing environment
+<dd><a name="list-leftmargin"></a><p>Horizontal space between the left margin of the enclosing environment
(or the left margin of the page if this is a top-level list), and the
left margin of this list. It must be non-negative.
</p>
@@ -5106,7 +6022,7 @@ error message &lsquo;<samp>Too deeply nested</samp>&rsquo;.)
<dt><code>\listparindent</code>
<a name="index-_005clistparindent"></a>
</dt>
-<dd><p>Horizontal space of additional line indentation, beyond
+<dd><a name="list-listparindent"></a><p>Horizontal space of additional line indentation, beyond
<code>\leftmargin</code>, for second and subsequent paragraphs within a list
item. A negative value makes this an &ldquo;outdent&rdquo;. Its default value
is <code>0pt</code>.
@@ -5115,7 +6031,7 @@ is <code>0pt</code>.
<dt><code>\parsep</code>
<a name="index-_005cparsep"></a>
</dt>
-<dd><p>Vertical space between paragraphs within an item. In the &lsquo;<samp>book</samp>&rsquo;
+<dd><a name="list-parsep"></a><p>Vertical space between paragraphs within an item. In the &lsquo;<samp>book</samp>&rsquo;
and &lsquo;<samp>article</samp>&rsquo; classes The defaults for the first three levels in
LaTeX&rsquo;s &lsquo;<samp>article</samp>&rsquo;, &lsquo;<samp>book</samp>&rsquo;, and &lsquo;<samp>report</samp>&rsquo; classes at 10
point size are: <code>4pt plus2pt minus1pt</code>, <code>2pt plus1pt
@@ -5128,7 +6044,7 @@ minus1pt</code>, <code>2.5pt plus1pt minus1pt</code>, and <code>0pt</code>.
<dt><code>\partopsep</code>
<a name="index-_005cpartopsep"></a>
</dt>
-<dd><p>Vertical space added, beyond <code>\topsep</code>+<code>\parskip</code>, to the top
+<dd><a name="list-partopsep"></a><p>Vertical space added, beyond <code>\topsep</code>+<code>\parskip</code>, to the top
and bottom of the entire environment if the list instance is preceded by
a blank line. (A blank line in the LaTeX source before the list
changes spacing at both the top and bottom of the list; whether the line
@@ -5146,7 +6062,7 @@ minus2pt</code>, and <code>1pt plus0pt minus1pt</code>.
<dt><code>\rightmargin</code>
<a name="index-_005crightmargin"></a>
</dt>
-<dd><p>Horizontal space between the right margin of the list and the right
+<dd><a name="list-rightmargin"></a><p>Horizontal space between the right margin of the list and the right
margin of the enclosing environment. Its default value is <code>0pt</code>.
It must be non-negative.
</p>
@@ -5154,15 +6070,15 @@ It must be non-negative.
<dt><code>\topsep</code>
<a name="index-_005ctopsep"></a>
</dt>
-<dd><p>Vertical space added to both the top and bottom of the list, in addition
-to <code>\parskip</code> (see <a href="#g_t_005cparskip">\parskip</a>). The defaults for the first three
-levels in LaTeX&rsquo;s &lsquo;<samp>article</samp>&rsquo;, &lsquo;<samp>book</samp>&rsquo;, and &lsquo;<samp>report</samp>&rsquo;
-classes at 10 point size are: <code>8pt plus2pt minus4pt</code>, <code>4pt
-plus2pt minus1pt</code>, and <code>2pt plus1pt minus1pt</code>. The defaults at 11
-point are: <code>9pt plus3pt minus5pt</code>, <code>4.5pt plus2pt minus1pt</code>,
-and <code>2pt plus1pt minus1pt</code>. The defaults at 12 point are:
-<code>10pt plus4pt minus6pt</code>, <code>5pt plus2.5pt minus1pt</code>, and
-<code>2.5pt plus1pt minus1pt</code>.
+<dd><a name="list-topsep"></a><p>Vertical space added to both the top and bottom of the list, in addition
+to <code>\parskip</code> (see <a href="#g_t_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</a>). The defaults for
+the first three levels in LaTeX&rsquo;s &lsquo;<samp>article</samp>&rsquo;, &lsquo;<samp>book</samp>&rsquo;, and
+&lsquo;<samp>report</samp>&rsquo; classes at 10 point size are: <code>8pt plus2pt minus4pt</code>,
+<code>4pt plus2pt minus1pt</code>, and <code>2pt plus1pt minus1pt</code>. The
+defaults at 11 point are: <code>9pt plus3pt minus5pt</code>, <code>4.5pt
+plus2pt minus1pt</code>, and <code>2pt plus1pt minus1pt</code>. The defaults at 12
+point are: <code>10pt plus4pt minus6pt</code>, <code>5pt plus2.5pt minus1pt</code>,
+and <code>2.5pt plus1pt minus1pt</code>.
</p>
</dd>
</dl>
@@ -5198,6 +6114,10 @@ appears in the source above the environment; whether a blank line
appears in the source below the environment does not matter.)
</p>
</dd>
+<dt><var>h0</var></dt>
+<dd><p><code>\labelwidth</code>
+</p>
+</dd>
<dt><var>h1</var></dt>
<dd><p><code>\labelsep</code>
</p>
@@ -5239,25 +6159,31 @@ page break.
<dt><code>\@beginparpenalty</code>
<a name="index-_005c_0040beginparpenalty"></a>
</dt>
-<dd><p>The page breaking penalty for breaking before the list (default <code>-51</code>).
+<dd><a name="list-beginparpenalty"></a><p>The page breaking penalty for breaking before the list (default <code>-51</code>).
</p>
</dd>
<dt><code>\@itempenalty</code>
<a name="index-_005c_0040itempenalty"></a>
</dt>
-<dd><p>The page breaking penalty for breaking before a list item (default <code>-51</code>).
+<dd><a name="list-itempenalty"></a><p>The page breaking penalty for breaking before a list item (default <code>-51</code>).
</p>
</dd>
<dt><code>\@endparpenalty</code>
<a name="index-_005c_0040endparpenalty"></a>
</dt>
-<dd><p>The page breaking penalty for breaking after a list (default <code>-51</code>).
+<dd><a name="list-endparpenalty"></a><p>The page breaking penalty for breaking after a list (default <code>-51</code>).
</p>
</dd>
</dl>
+<a name="index-package_002c-enumitem"></a>
+<a name="index-enumitem-package"></a>
+
+<p>The package <code>enumitem</code> is useful for customizing lists.
+</p>
<p>This example has the labels in red. They are numbered, and the left
edge of the label lines up with the left edge of the item text.
+See <a href="#g_t_005cusecounter">\usecounter</a>.
</p>
<div class="example">
<pre class="example">\usepackage{color}
@@ -5289,7 +6215,7 @@ edge of the label lines up with the left edge of the item text.
<a name="g_t_005citem"></a>
<div class="header">
<p>
-Next: <a href="#trivlist" accesskey="n" rel="next">trivlist</a>, Up: <a href="#list" accesskey="u" rel="up">list</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#trivlist" accesskey="n" rel="next">trivlist</a>, Up: <a href="#list" accesskey="u" rel="up">list</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005citem_003a-An-entry-in-a-list"></a>
<h4 class="subsection">8.16.1 <code>\item</code>: An entry in a list</h4>
@@ -5301,7 +6227,8 @@ Next: <a href="#trivlist" accesskey="n" rel="next">trivlist</a>, Up: <a href="#l
</pre></div>
<p>or
-</p><div class="example">
+</p>
+<div class="example">
<pre class="example">\item[<var>optional-label</var>] text of item
</pre></div>
@@ -5339,7 +6266,7 @@ labelled&nbsp;&lsquo;<samp>3.</samp>&rsquo;.
<a name="trivlist"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005citem" accesskey="p" rel="prev">\item</a>, Up: <a href="#list" accesskey="u" rel="up">list</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005citem" accesskey="p" rel="prev">\item</a>, Up: <a href="#list" accesskey="u" rel="up">list</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="trivlist_003a-A-restricted-form-of-list"></a>
<h4 class="subsection">8.16.2 <code>trivlist</code>: A restricted form of <code>list</code></h4>
@@ -5392,7 +6319,7 @@ default) they have no paragraph indent and are vertically separated.
<a name="math"></a>
<div class="header">
<p>
-Next: <a href="#minipage" accesskey="n" rel="next">minipage</a>, Previous: <a href="#list" accesskey="p" rel="prev">list</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#minipage" accesskey="n" rel="next">minipage</a>, Previous: <a href="#list" accesskey="p" rel="prev">list</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="math-1"></a>
<h3 class="section">8.17 <code>math</code></h3>
@@ -5419,7 +6346,7 @@ See <a href="#Math-formulas">Math formulas</a>.
<a name="minipage"></a>
<div class="header">
<p>
-Next: <a href="#picture" accesskey="n" rel="next">picture</a>, Previous: <a href="#math" accesskey="p" rel="prev">math</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#picture" accesskey="n" rel="next">picture</a>, Previous: <a href="#math" accesskey="p" rel="prev">math</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="minipage-1"></a>
<h3 class="section">8.18 <code>minipage</code></h3>
@@ -5429,25 +6356,135 @@ Next: <a href="#picture" accesskey="n" rel="next">picture</a>, Previous: <a href
<a name="index-minipage_002c-creating-a"></a>
+<p>Synopses:
+</p>
+<div class="example">
+<pre class="example">\begin{minipage}{<var>width</var>}
+ <var>contents</var>
+\end{minipage}
+</pre></div>
+
+<p>or
+</p>
<div class="example">
<pre class="example">\begin{minipage}[<var>position</var>][<var>height</var>][<var>inner-pos</var>]{<var>width</var>}
-<var>text</var>
+ <var>contents</var>
\end{minipage}
</pre></div>
-<p>The <code>minipage</code> environment typesets its body <var>text</var> in a
-block that will not be broken across pages. This is similar to the
-<code>\parbox</code> command (see <a href="#g_t_005cparbox">\parbox</a>), but unlike <code>\parbox</code>,
-other paragraph-making environments can be used inside a minipage.
+<p>Put <var>contents</var> into a box that is <var>width</var> wide. This is like a
+small version of a page; it can contain its own footnotes, itemized
+lists, etc. (There are some restrictions, including that it cannot have
+floats.) This box will not be broken across pages. So <code>minipage</code>
+is similar to <code>\parbox</code> (see <a href="#g_t_005cparbox">\parbox</a>) but here you can have
+paragraphs.
</p>
-<p>The arguments are the same as for <code>\parbox</code> (see <a href="#g_t_005cparbox">\parbox</a>).
+<p>This example will be 3&nbsp;inches wide, and has two paragraphs.
</p>
+<div class="example">
+<pre class="example">\begin{minipage}{3in}
+ Stephen Kleene was a founder of the Theory of Computation.
+
+ He was a student of Church, wrote three influential texts,
+ was President of the Association for Symbolic Logic,
+ and won the National Medal of Science.
+\end{minipage}
+</pre></div>
+
+<p>See below for a discussion of the paragraph indent inside a
+<code>minipage</code>.
+</p>
+<p>The required argument <var>width</var> is a rigid length (see <a href="#Lengths">Lengths</a>).
+It gives the width of the box into which <var>contents</var> are typeset.
+</p>
+<p>There are three optional arguments, <var>position</var>, <var>height</var>, and
+<var>inner-pos</var>. You need not include all three. For example, get the
+default <var>position</var> and set the <var>height</var> with
+<code>\begin{minipage}[c][2.54cm] <var>contents</var> \end{minipage}</code>.
+(Get the natural height with an empty argument, <code>[]</code>.)
+</p>
+<p>The optional argument <var>position</var> governs how the <code>minipage</code>
+vertically aligns with the surrounding material.
+</p>
+<dl compact="compact">
+<dt><code>c</code></dt>
+<dd><p>(synonym <code>m</code>) Default. Positions the <code>minipage</code> so its
+vertical center lines up with the center of the adjacent text line (what
+Plain TeX calls <code>\vcenter</code>).
+</p>
+</dd>
+<dt><code>t</code></dt>
+<dd><p>Match the top line in the <code>minipage</code> with the baseline of the
+surrounding text (Plain TeX&rsquo;s <code>\vtop</code>.
+</p>
+</dd>
+<dt><code>b</code></dt>
+<dd><p>Match the bottom line in the <code>minipage</code> with the baseline of the
+surrounding text (Plain TeX&rsquo;s <code>\vbox</code>.
+</p></dd>
+</dl>
+
+<p>To see the effects of these, contrast running this
+</p>
+<div class="example">
+<pre class="example">---\begin{minipage}[c]{0.25in}
+ first\\ second\\ third
+\end{minipage}
+</pre></div>
+
+<p>with the results of changing <code>c</code> to <code>b</code> or&nbsp;<code>t</code>.
+</p>
+<p>The optional argument <var>height</var> is a rigid length (see <a href="#Lengths">Lengths</a>).
+It sets the height of the <code>minipage</code>. You can enter any value
+larger than, or equal to, or smaller than the <code>minipage</code>&rsquo;s natural
+height and LaTeX will not give an error or warning. You can also set
+it to a height of zero or a negative value.
+</p>
+<p>The final optional argument <var>inner-pos</var> controls the placement of
+<var>content</var> inside the box. These are the possible values are (the
+default is the value of <var>position</var>).
+</p>
+<dl compact="compact">
+<dt><code>t</code></dt>
+<dd><p>Place <var>content</var> at the top of the box.
+</p>
+</dd>
+<dt><code>c</code></dt>
+<dd><p>Place it in the vertical center.
+</p>
+</dd>
+<dt><code>b</code></dt>
+<dd><p>Place it at the box bottom.
+</p>
+</dd>
+<dt><code>s</code></dt>
+<dd><p>Stretch <var>contents</var> out vertically; it must contain vertically
+stretchable space.
+</p>
+</dd>
+</dl>
+
+<p>The <var>inner-pos</var> argument makes sense when the <var>height</var> options
+is set to a value larger than the <code>minipage</code>&rsquo;s natural height. To
+see the effect of the options, run this example with the various choices
+in place of <code>b</code>.
+</p>
+<div class="example">
+<pre class="example">Text before
+\begin{center}
+ ---\begin{minipage}[c][3in][b]{0.25\textwidth}
+ first\\ second\\ third
+ \end{minipage}
+\end{center}
+Text after
+</pre></div>
+
<a name="index-indentation-of-paragraphs_002c-in-minipage"></a>
<a name="index-paragraph-indentation_002c-in-minipage"></a>
<a name="index-_005cparindent"></a>
-<p>By default, paragraphs are not indented in the <code>minipage</code>
-environment. You can restore indentation with a command such as
-<code>\setlength{\parindent}{1pc}</code> command.
+<p>By default paragraphs are not indented in a <code>minipage</code>. Change
+that with a command such as <code>\setlength{\parindent}{1pc}</code> at
+the start of <var>contents</var>.
</p>
<a name="index-footnotes-in-figures"></a>
<a name="index-figures_002c-footnotes-in"></a>
@@ -5458,15 +6495,56 @@ the bottom of the minipage instead of at the bottom of the page, and it
uses the <code>\mpfootnote</code> counter instead of the ordinary
<code>footnote</code> counter (see <a href="#Counters">Counters</a>).
</p>
-<p>However, don&rsquo;t put one minipage inside another if you are using
-footnotes; they may wind up at the bottom of the wrong minipage.
+<p>This puts the footnote at the bottom of the table, not the bottom of the
+page.
</p>
+<div class="example">
+<pre class="example">\begin{center} % center the minipage on the line
+\begin{minipage}{2.5in}
+ \begin{center} % center the table inside the minipage
+ \begin{tabular}{ll}
+ \textsc{Monarch} &amp;\textsc{Reign} \\ \hline
+ Elizabeth II &amp;63 years\footnote{to date} \\
+ Victoria &amp;63 years \\
+ George III &amp;59 years
+ \end{tabular}
+ \end{center}
+\end{minipage}
+\end{center}
+</pre></div>
+
+<p>If you nest minipages then there is an oddness when using footnotes.
+Footnotes appear at the bottom of the text ended by the next
+<code>\end{minipage}</code> which may not be their logical place.
+</p>
+<p>This puts a table containing data side by side with a map graphic. They
+are vertically centered.
+</p>
+<div class="example">
+<pre class="example">\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
+ ...
+\begin{center}
+ \vcenteredhbox{\includegraphics[width=0.3\textwidth]{nyc.png}}
+ \hspace{0.1\textwidth}
+ \begin{minipage}{0.5\textwidth}
+ \begin{tabular}{r|l}
+ \multicolumn{1}{r}{Borough} &amp;Pop (million) \\ \hline
+ The Bronx &amp;$1.5$ \\
+ Brooklyn &amp;$2.6$ \\
+ Manhattan &amp;$1.6$ \\
+ Queens &amp;$2.3$ \\
+ Staten Island &amp;$0.5$
+ \end{tabular}
+ \end{minipage}
+\end{center}
+</pre></div>
+
<hr>
<a name="picture"></a>
<div class="header">
<p>
-Next: <a href="#quotation-and-quote" accesskey="n" rel="next">quotation and quote</a>, Previous: <a href="#minipage" accesskey="p" rel="prev">minipage</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#quotation-_0026-quote" accesskey="n" rel="next">quotation &amp; quote</a>, Previous: <a href="#minipage" accesskey="p" rel="prev">minipage</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="picture-1"></a>
<h3 class="section">8.19 <code>picture</code></h3>
@@ -5477,505 +6555,843 @@ Next: <a href="#quotation-and-quote" accesskey="n" rel="next">quotation and quot
<a name="index-creating-pictures"></a>
<a name="index-pictures_002c-creating"></a>
+<p>Synopses:
+</p><div class="example">
+<pre class="example">\begin{picture}(<var>width</var>,<var>height</var>)
+ <var>picture commands</var>
+\end{picture}
+</pre></div>
+
+<p>or
+</p>
<div class="example">
<pre class="example">\begin{picture}(<var>width</var>,<var>height</var>)(<var>xoffset</var>,<var>yoffset</var>)
-&hellip; <var>picture commands</var> &hellip;
+ <var>picture commands</var>
\end{picture}
</pre></div>
-<a name="index-_005cunitlength"></a>
-<p>The <code>picture</code> environment allows you to create just about any
-kind of picture you want containing text, lines, arrows and circles.
-You tell LaTeX where to put things in the picture by specifying
-their coordinates. A coordinate is a number that may have a decimal
-point and a minus sign&mdash;a number like <code>5</code>, <code>0.3</code> or
-<code>-3.1416</code>. A coordinate specifies a length in multiples of the
-unit length <code>\unitlength</code>, so if <code>\unitlength</code> has been set
-to <code>1cm</code>, then the coordinate 2.54 specifies a length of 2.54
-centimeters.
+<p>An environment to create simple pictures containing lines, arrows,
+boxes, circles, and text. Note that while this environment is not
+obsolete, new documents typically use much more powerful graphics
+creation systems, such as <code>TikZ</code>, <code>PSTricks</code>, <code>MetaPost</code>,
+or <code>Asymptote</code>. These are not covered in this document; see CTAN.
</p>
-<p>You should only change the value of <code>\unitlength</code>, using the
-<code>\setlength</code> command, outside of a <code>picture</code> environment.
-The default value is <code>1pt</code>.
+<p>This shows the parallelogram law for adding vectors.
</p>
-<a name="index-package_002c-picture"></a>
-<a name="index-picture-package"></a>
+<a name="index-_005cunitlength"></a>
+<div class="example">
+<pre class="example">\setlength{\unitlength}{1cm}
+\begin{picture}(6,6) % picture box will be 6cm wide by 6cm tall
+ \put(0,0){\vector(2,1){4}} % for every 2 over this vector goes 1 up
+ \put(2,1){\makebox(0,0)[l]{\ first leg}}
+ \put(4,2){\vector(1,2){2}}
+ \put(5,4){\makebox(0,0)[l]{\ second leg}}
+ \put(0,0){\line(1,1){6}}
+ \put(3,3){\makebox(0,0)[r]{sum\ }}
+\end{picture}
+</pre></div>
-<p>The <code>picture</code> package redefine the <code>picture</code> environment so
-that everywhere a number is used in a <var>picture commands</var> to specify
-a coordinate, one can use alternatively a length. Be aware however that
-this will prevent scaling those lengths by changing <code>\unitlength</code>.
+<p>You can also use this environment to place arbitrary material at an
+exact location.
</p>
+<div class="example">
+<pre class="example">\usepackage{color,graphicx} % in preamble
+ ...
+\begin{center}
+\setlength{\unitlength}{\textwidth}
+\begin{picture}(1,1) % leave space, \textwidth wide and tall
+ \put(0,0){\includegraphics[width=\textwidth]{desertedisland.jpg}}
+ \put(0.25,0.35){\textcolor{red}{X Treasure here}}
+\end{picture}
+\end{center}
+</pre></div>
-<a name="index-position_002c-in-picture"></a>
-<p>A <em>position</em> is a pair of coordinates, such as <code>(2.4,-5)</code>, specifying
-the point with x-coordinate <code>2.4</code> and y-coordinate <code>-5</code>.
-Coordinates are specified in the usual way with respect to an origin,
-which is normally at the lower-left corner of the picture. Note that
-when a position appears as an argument, it is not enclosed in braces;
-the parentheses serve to delimit the argument.
-</p>
-<p>The <code>picture</code> environment has one mandatory argument which is a
-position (<var>width</var>,<var>height</var>), which specifies the size of the
-picture. The environment produces a rectangular box with these
-<var>width</var> and <var>height</var>.
-</p>
-<p>The <code>picture</code> environment also has an optional position argument
-(<var>xoffset</var>,<var>yoffset</var>), following the size argument, that can
-change the origin. (Unlike ordinary optional arguments, this argument
-is not contained in square brackets.) The optional argument gives the
-coordinates of the point at the lower-left corner of the picture
-(thereby determining the origin). For example, if <code>\unitlength</code>
-has been set to <code>1mm</code>, the command
+<p>The red&nbsp;X will be precisely a quarter of the <code>\linewidth</code> from
+the left margin, and <code>0.35\linewidth</code> up from the bottom. Another
+example of this usage is to put similar code in the page header to get
+repeat material on each of a document&rsquo;s pages.
+</p>
+<p>The <code>picture</code> environment has one required argument, a pair of
+numbers (<var>width</var>,<var>height</var>). Multiply these by the value
+<code>\unitlength</code> to get the nominal size of the output, the space that
+LaTeX reserves on the output page. This nominal size need not be how
+large the picture really is; LaTeX will draw things from the picture
+outside the picture&rsquo;s box.
+</p>
+<p>This environment also has an optional argument
+(<var>xoffset</var>,<var>yoffset</var>). It is used to shift the origin. Unlike
+most optional arguments, this one is not contained in square brackets.
+As with the required argument, it consists of two real numbers.
+Multiply these by <code>\unitlength</code> to get the point at the lower-left
+corner of the picture.
+</p>
+<p>For example, if <code>\unitlength</code> has been set to <code>1mm</code>, the
+command
</p>
<div class="example">
<pre class="example">\begin{picture}(100,200)(10,20)
</pre></div>
-<p>produces a picture of width 100 millimeters and height 200
-millimeters, whose lower-left corner is the point (10,20) and whose
-upper-right corner is therefore the point (110,220). When you first
-draw a picture, you typically omit the optional argument, leaving the
-origin at the lower-left corner. If you then want to modify your
+<p>produces a box of width 100 millimeters and height 200 millimeters. The
+picture&rsquo;s origin is the point (10mm,20mm) and so the lower-left corner
+is there, and the upper-right corner is at (110mm,220mm). When you
+first draw a picture you typically omit the optional argument, leaving
+the origin at the lower-left corner. If you then want to modify your
picture by shifting everything, you can just add the appropriate
optional argument.
</p>
-<p>The environment&rsquo;s mandatory argument determines the nominal size of the
-picture. This need bear no relation to how large the picture really is;
-LaTeX will happily allow you to put things outside the picture, or even
-off the page. The picture&rsquo;s nominal size is used by LaTeX in determining
-how much room to leave for it.
+<a name="index-position_002c-in-picture"></a>
+<p>Each <var>picture command</var> tells LaTeX where to put something by
+naming its position. A <em>position</em> is a pair such as <code>(2.4,-5)</code>
+giving the x- and y-coordinates. A <em>coordinate</em> is a not a length,
+it is a real number (it may have a decimal point or a minus sign). It
+specifies a length in multiples of the unit length <code>\unitlength</code>,
+so if <code>\unitlength</code> has been set to <code>1cm</code>, then the coordinate
+2.54 specifies a length of 2.54 centimeters.
+</p>
+<p>LaTeX&rsquo;s default for <code>\unitlength</code> is <code>1pt</code>. it is a rigid
+length (see <a href="#Lengths">Lengths</a>). Change it with the <code>\setlength</code> command
+(see <a href="#g_t_005csetlength">\setlength</a>). Make this change only outside of a <code>picture</code>
+environment.
</p>
-<p>Everything that appears in a picture is drawn by the <code>\put</code>
-command. The command
+<p>Coordinates are given with respect to an origin, which is normally at
+the lower-left corner of the picture. Note that when a position appears
+as an argument, as with <code>\put(1,2){...}</code>, it is not enclosed in
+braces since the parentheses serve to delimit the argument. Also,
+unlike in some computer graphics systems, larger y-coordinates are
+further up the page.
+</p>
+<p>There are four ways to put things in a picture: <code>\put</code>,
+<code>\multiput</code>, <code>\qbezier</code>, and <code>\graphpaper</code>. The most
+often used is <code>\put</code>. This
</p>
<div class="example">
-<pre class="example">\put (11.3,-.3){...}
+<pre class="example">\put(11.3,-0.3){...}
+</pre></div>
+
+<p>places the object with its reference point at coordinates
+<em>(11.3,-0.3)</em>. The reference points for various objects will be
+described below.
+<a name="index-LR-box"></a>
+The <code>\put</code> command creates an <em>LR box</em> (see <a href="#Modes">Modes</a>).
+Anything that can go in an <code>\mbox</code> (see <a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a>) can
+go in the text argument of the <code>\put</code> command. The reference point
+will be the lower left corner of the box. In this picture
+</p>
+<div class="example">
+<pre class="example">\setlength{\unitlength}{1cm}
+...\begin{picture}(1,1)
+ \put(0,0){\line(1,0){1}}
+ \put(0,0){\line(1,1){1}}
+\end{picture}
</pre></div>
-<p>puts the object specified by <code>...</code> in the
-picture, with its reference point at coordinates <em>(11.3,-.3)</em>.
-The reference points for various objects will be described below.
+<p>the three dots are just slightly left of the point of the angle formed
+by the two lines. (Also, <code>\line(1,1){1}</code> does not call for a
+line of length one; rather the line has a change in the x coordinate of
+1.)
</p>
-<a name="index-lR-box"></a>
-<p>The <code>\put</code> command creates an <em>LR box</em>. You can put anything
-that can go in an <code>\mbox</code> (see <a href="#g_t_005cmbox">\mbox</a>) in the text argument of
-the <code>\put</code> command. When you do this, the reference point will
-be the lower left corner of the box.
+<p>The <code>\multiput</code>, <code>qbezier</code>, and <code>graphpaper</code> commands are
+described below.
</p>
-<p>The <code>picture</code> commands are described in the following sections.
+<p>This draws a rectangle with a wavy top, using <code>\qbezier</code> for
+that curve.
</p>
+<div class="example">
+<pre class="example">\begin{picture}(3,1.5)
+ \put(0,0){\vector(1,0){8}} % x axis
+ \put(0,0){\vector(0,1){4}} % y axis
+ \put(2,0){\line(0,1){3}} % left side rectangle
+ \put(4,0){\line(0,1){3.5}} % right side
+ \qbezier(2,3)(2.5,2.9)(3,3.25)
+ \qbezier(3,3.25)(3.5,3.6)(4,3.5)
+ \thicklines % below here, lines are twice as thick
+ \put(2,3){\line(4,1){2}}
+ \put(4.5,2.5){\framebox{Trapezoidal Rule}}
+\end{picture}
+</pre></div>
+
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005ccircle" accesskey="1">\circle</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a circle.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cput" accesskey="1">\put</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Place an object at a specified place.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cmakebox-_0028picture_0029" accesskey="2">\makebox (picture)</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a box of the specified size.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cmultiput" accesskey="2">\multiput</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw multiple instances of an object.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cframebox-_0028picture_0029" accesskey="3">\framebox (picture)</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a box with a frame around it.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cqbezier" accesskey="3">\qbezier</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a quadratic Bezier curve.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cdashbox" accesskey="4">\dashbox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a dashed box.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cgraphpaper" accesskey="4">\graphpaper</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw graph paper.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cframe" accesskey="5">\frame</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a frame around an object.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cline" accesskey="5">\line</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a straight line.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cline" accesskey="6">\line</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a straight line.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005clinethickness" accesskey="6">\linethickness</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Set thickness of horizontal and vertical lines.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005clinethickness" accesskey="7">\linethickness</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Set the line thickness.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cthinlines" accesskey="7">\thinlines</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The default line thickness.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#g_t_005cthicklines" accesskey="8">\thicklines</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">A heavier line thickness.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cthinlines" accesskey="9">\thinlines</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The default line thickness.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005ccircle" accesskey="9">\circle</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a circle.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005coval">\oval</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw an oval.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cmultiput">\multiput</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw multiple instances of an object.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cshortstack">\shortstack</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Make a stack of objects.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005coval">\oval</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw an ellipse.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cvector">\vector</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a line with an arrow.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cput">\put</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Place an object at a specified place.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cmakebox-_0028picture_0029">\makebox (picture)</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a box of the specified size.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cshortstack">\shortstack</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Make a pile of objects.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cframebox-_0028picture_0029">\framebox (picture)</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a box with a frame around it.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cvector">\vector</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a line with an arrow.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cframe">\frame</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a frame around an object.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cdashbox">\dashbox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Draw a dashed box.
</td></tr>
</table>
<hr>
-<a name="g_t_005ccircle"></a>
+<a name="g_t_005cput"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cmakebox-_0028picture_0029" accesskey="n" rel="next">\makebox (picture)</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cmultiput" accesskey="n" rel="next">\multiput</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005ccircle-1"></a>
-<h4 class="subsection">8.19.1 <code>\circle</code></h4>
+<a name="g_t_005cput-1"></a>
+<h4 class="subsection">8.19.1 <code>\put</code></h4>
-<a name="index-_005ccircle"></a>
+<a name="index-_005cput"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\circle[*]{<var>diameter</var>}
+<pre class="example">\put(<var>xcoord</var>,<var>ycoord</var>){<var>content</var>}
</pre></div>
-<p>The <code>\circle</code> command produces a circle with a diameter as close
-to the specified one as possible. The <code>*</code>-form of the command
-draws a solid circle.
+<p>Place <var>content</var> at the coordinate (<var>xcoord</var>,<var>ycoord</var>). See
+the discussion of coordinates and <code>\unitlength</code> in <a href="#picture">picture</a>.
+The <var>content</var> is processed in LR mode (see <a href="#Modes">Modes</a>) so it cannot
+contain line breaks.
</p>
-<p>Circles up to 40pt can be drawn.
+<p>This includes the text into the <code>picture</code>.
+</p>
+<div class="example">
+<pre class="example">\put(4.5,2.5){Apply the \textit{unpoke} move}
+</pre></div>
+
+<p>The reference point, the location (4.5,2.5), is the lower left of the
+text, at the bottom left of the &lsquo;<samp>A</samp>&rsquo;.
</p>
<hr>
-<a name="g_t_005cmakebox-_0028picture_0029"></a>
+<a name="g_t_005cmultiput"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cframebox-_0028picture_0029" accesskey="n" rel="next">\framebox (picture)</a>, Previous: <a href="#g_t_005ccircle" accesskey="p" rel="prev">\circle</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cqbezier" accesskey="n" rel="next">\qbezier</a>, Previous: <a href="#g_t_005cput" accesskey="p" rel="prev">\put</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cmakebox-1"></a>
-<h4 class="subsection">8.19.2 <code>\makebox</code></h4>
+<a name="g_t_005cmultiput-1"></a>
+<h4 class="subsection">8.19.2 <code>\multiput</code></h4>
-<a name="index-_005cmakebox-_0028for-picture_0029"></a>
+<a name="index-_005cmultiput"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\makebox(<var>width</var>,<var>height</var>)[<var>position</var>]{<var>text</var>}
+<pre class="example">\multiput(<var>x</var>,<var>y</var>)(<var>delta_x</var>,<var>delta_y</var>){<var>num-copies</var>}{<var>obj</var>}
</pre></div>
-<p>The <code>\makebox</code> command for the picture environment is similar to
-the normal <code>\makebox</code> command except that you must specify a
-<var>width</var> and <var>height</var> in multiples of <code>\unitlength</code>.
-</p>
-<p>The optional argument, <code>[<var>position</var>]</code>, specifies the quadrant that
-your <var>text</var> appears in. You may select up to two of the following:
-</p>
-<dl compact="compact">
-<dt><code>t</code></dt>
-<dd><p>Moves the item to the top of the rectangle.
-</p>
-</dd>
-<dt><code>b</code></dt>
-<dd><p>Moves the item to the bottom.
+<p>Copy <var>obj</var> a total of <var>num-copies</var> times, with an increment of
+<var>delta_x,delta_y</var>. The <var>obj</var> first appears at position
+<em>(x,y)</em>, then at <em>(x+\delta_x,y+\delta_y)</em>, and so on.
</p>
-</dd>
-<dt><code>l</code></dt>
-<dd><p>Moves the item to the left.
+<p>This draws a simple grid with every fifth line in bold (see also
+<a href="#g_t_005cgraphpaper">\graphpaper</a>).
</p>
-</dd>
-<dt><code>r</code></dt>
-<dd><p>Moves the item to the right.
-</p>
-</dd>
-</dl>
+<div class="example">
+<pre class="example">\begin{picture}(10,10)
+ \linethickness{0.05mm}
+ \multiput(0,0)(1,0){10}{\line(0,1){10}}
+ \multiput(0,0)(0,1){10}{\line(1,0){10}}
+ \linethickness{0.5mm}
+ \multiput(0,0)(5,0){3}{\line(0,1){10}}
+ \multiput(0,0)(0,5){3}{\line(1,0){10}}
+\end{picture}
+</pre></div>
-<p>See <a href="#g_t_005cmakebox">\makebox</a>.
-</p>
<hr>
-<a name="g_t_005cframebox-_0028picture_0029"></a>
+<a name="g_t_005cqbezier"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cdashbox" accesskey="n" rel="next">\dashbox</a>, Previous: <a href="#g_t_005cmakebox-_0028picture_0029" accesskey="p" rel="prev">\makebox (picture)</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cgraphpaper" accesskey="n" rel="next">\graphpaper</a>, Previous: <a href="#g_t_005cmultiput" accesskey="p" rel="prev">\multiput</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cframebox"></a>
-<h4 class="subsection">8.19.3 <code>\framebox</code></h4>
+<a name="g_t_005cqbezier-1"></a>
+<h4 class="subsection">8.19.3 <code>\qbezier</code></h4>
-<a name="index-_005cframebox"></a>
+<a name="index-_005cqbezier"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\framebox(<var>width</var>,<var>height</var>)[<var>pos</var>]{...}
+<pre class="example">\qbezier(<var>x1</var>,<var>y1</var>)(<var>x2</var>,<var>y2</var>)(<var>x3</var>,<var>y3</var>)
+\qbezier[<var>num</var>](<var>x1</var>,<var>y1</var>)(<var>x2</var>,<var>y2</var>)(<var>x3</var>,<var>y3</var>)
</pre></div>
-<p>The <code>\framebox</code> command is like <code>\makebox</code> (see previous
-section), except that it puts a frame around the outside of the box
-that it creates.
+<p>Draw a quadratic Bezier curve whose control points are given by the
+three required arguments <code>(<var>x1</var>,<var>y1</var>)</code>,
+<code>(<var>x2</var>,<var>y2</var>)</code>, and <code>(<var>x3</var>,<var>y3</var>)</code>. That is,
+the curve runs from <var>(x1,y1)</var> to <var>(x3,y3)</var>, is quadratic, and is
+such that the tangent line at <var>(x1,y1)</var> passes through
+<var>(x2,y2)</var>, as does the tangent line at <var>(x3,y3)</var>.
</p>
-<a name="index-_005cfboxrule"></a>
-<a name="index-_005cfboxsep"></a>
-<p>The <code>\framebox</code> command produces a rule of thickness
-<code>\fboxrule</code>, and leaves a space <code>\fboxsep</code> between the rule
-and the contents of the box.
-</p>
-
-<hr>
-<a name="g_t_005cdashbox"></a>
-<div class="header">
-<p>
-Next: <a href="#g_t_005cframe" accesskey="n" rel="next">\frame</a>, Previous: <a href="#g_t_005cframebox-_0028picture_0029" accesskey="p" rel="prev">\framebox (picture)</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="g_t_005cdashbox-1"></a>
-<h4 class="subsection">8.19.4 <code>\dashbox</code></h4>
-
-<a name="index-_005cdashbox"></a>
-
-<p>Draws a box with a dashed line. Synopsis:
+<p>This draws a curve from the coordinate (1,1) to (1,0).
</p>
<div class="example">
-<pre class="example">\dashbox{<var>dlen</var>}(<var>rwidth</var>,<var>rheight</var>)[<var>pos</var>]{<var>text</var>}
+<pre class="example">\qbezier(1,1)(1.25,0.75)(1,0)
</pre></div>
-<p><code>\dashbox</code> creates a dashed rectangle around <var>text</var> in a
-<code>picture</code> environment. Dashes are <var>dlen</var> units long, and the
-rectangle has overall width <var>rwidth</var> and height <var>rheight</var>.
-The <var>text</var> is positioned at optional <var>pos</var>. </p>
-<p>A dashed box looks best when the <var>rwidth</var> and <var>rheight</var> are
-multiples of the <var>dlen</var>.
+<p>The curve&rsquo;s tangent line at (1,1) contains (1.25,0.75), as does the
+curve&rsquo;s tangent line at (1,0).
+</p>
+<p>The optional argument <var>num</var> gives the number of calculated
+intermediate points. The default is to draw a smooth curve whose
+maximum number of points is <code>\qbeziermax</code> (change this value with
+<code>\renewcommand</code>).
</p>
<hr>
-<a name="g_t_005cframe"></a>
+<a name="g_t_005cgraphpaper"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cline" accesskey="n" rel="next">\line</a>, Previous: <a href="#g_t_005cdashbox" accesskey="p" rel="prev">\dashbox</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cline" accesskey="n" rel="next">\line</a>, Previous: <a href="#g_t_005cqbezier" accesskey="p" rel="prev">\qbezier</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cframe-1"></a>
-<h4 class="subsection">8.19.5 <code>\frame</code></h4>
-
-<a name="index-_005cframe"></a>
+<a name="g_t_005cgraphpaper-1"></a>
+<h4 class="subsection">8.19.4 <code>\graphpaper</code></h4>
+<a name="index-_005cgraphpaper"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\frame{<var>text</var>}
+<pre class="example">\graphpaper(<var>x_init</var>,<var>y_init</var>)(<var>x_dimen</var>,<var>y_dimen</var>)
+\graphpaper[<var>spacing</var>](<var>x_init</var>,<var>y_init</var>)(<var>x_dimen</var>,<var>y_dimen</var>)
+</pre></div>
+
+<p>Draw a coordinate grid. Requires the <code>graphpap</code> package.
+The grid&rsquo;s origin is <code>(<var>x_init</var>,<var>y_init</var>)</code>.
+Grid lines come every <var>spacing</var> units (the default is 10).
+The grid extends <var>x_dimen</var> units to the right and <var>y_dimen</var> units up.
+All arguments must be positive integers.
+</p>
+<p>This make a grid with seven vertical lines and eleven horizontal lines.
+</p>
+<div class="example">
+<pre class="example">\usepackage{graphpap} % in preamble
+ ...
+\begin{picture}(6,20) % in document body
+ \graphpaper[2](0,0)(12,20)
+\end{picture}
</pre></div>
-<p>The <code>\frame</code> command puts a rectangular frame around <var>text</var>.
-The reference point is the bottom left corner of the frame. No extra
-space is put between the frame and the object.
+<p>The lines are numbered every ten units.
</p>
<hr>
<a name="g_t_005cline"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005clinethickness" accesskey="n" rel="next">\linethickness</a>, Previous: <a href="#g_t_005cframe" accesskey="p" rel="prev">\frame</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005clinethickness" accesskey="n" rel="next">\linethickness</a>, Previous: <a href="#g_t_005cgraphpaper" accesskey="p" rel="prev">\graphpaper</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cline-1"></a>
-<h4 class="subsection">8.19.6 <code>\line</code></h4>
+<h4 class="subsection">8.19.5 <code>\line</code></h4>
<a name="index-_005cline"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\line(<var>xslope</var>,<var>yslope</var>){<var>length</var>}
+<pre class="example">\line(<var>x_run</var>,<var>y_rise</var>){<var>travel</var>}
</pre></div>
-<p>The <code>\line</code> command draws a line with the given <var>length</var> and
-slope <var>xslope</var>/<var>yslope</var>.
+<p>Draw a line. It slopes such that it vertically rises <var>y_rise</var> for
+every horizontal <var>x_run</var>. The <var>travel</var> is the total horizontal
+change&nbsp;&mdash; it is not the length of the vector, it is the change in
+<em>x</em>. In the special case of vertical lines, where
+(<var>x_run</var>,<var>y_rise</var>)=(0,1), the <var>travel</var> gives the change in
+<em>y</em>.
+</p>
+<p>This draws a line starting at coordinates (1,3).
+</p>
+<div class="example">
+<pre class="example">\put(1,3){\line(2,5){4}}
+</pre></div>
+
+<p>For every over 2, this line will go up 5. Because <var>travel</var>
+specifies that this goes over 4, it must go up&nbsp;10. Thus its
+endpoint is <em>(1,3)+(4,10)=(5,13)</em>. In particular, note that
+<em><var>travel</var>=4</em> is not the length of the line, it is the change in
+<em>x</em>.
+</p>
+<p>The arguments <var>x_run</var> and <var>y_rise</var> are integers that can be
+positive, negative, or zero. (If both are 0 then LaTeX treats the
+second as 1.) With
+<code>\put(<var>x_init</var>,<var>y_init</var>){\line(<var>x_run</var>,<var>y_rise</var>){<var>travel</var>}}</code>,
+if <var>x_run</var> is negative then the line&rsquo;s ending point has a first
+coordinate that is less than <var>x_init</var>. If <var>y_rise</var> is negative
+then the line&rsquo;s ending point has a second coordinate that is less than
+<var>y_init</var>.
+</p>
+<p>If <var>travel</var> is negative then you get <code>LaTeX Error: Bad \line or
+\vector argument.</code>
</p>
<a name="index-pict2e-package"></a>
<a name="index-graphics-packages"></a>
-<p>Standard LaTeX can only draw lines with <em><var>slope</var> = x/y</em>,
-where <em>x</em> and <em>y</em> have integer values from -6
-through&nbsp;6. For lines of any slope, and plenty of other shapes,
-see <code>pict2e</code> and many other packages on CTAN.
+<a name="index-package_002c-pict2e"></a>
+<a name="index-pict2e-package-1"></a>
+
+<a name="index-package_002c-TikZ"></a>
+<a name="index-TikZ-package"></a>
+
+<a name="index-package_002c-PSTricks"></a>
+<a name="index-PSTricks-package"></a>
+
+<a name="index-package_002c-MetaPost"></a>
+<a name="index-MetaPost-package"></a>
+
+<a name="index-package_002c-Asymptote"></a>
+<a name="index-Asymptote-package"></a>
+
+<p>Standard LaTeX can only draw lines with a limited range of slopes
+because these lines are made by putting together line segments from
+pre-made fonts. The two numbers <var>x_run</var> and <var>y_rise</var> must have
+integer values from -6 through&nbsp;6. Also, they must be
+relatively prime, so that <var>(x_run,y_rise)</var> can be (2,1) but not
+(4,2) (if you choose the latter then instead of lines you get sequences
+of arrowheads; the solution is to switch to the former). To get lines
+of arbitrary slope and plenty of other shapes in a system like
+<code>picture</code>, see the package <samp>pict2e</samp> on CTAN. Another solution
+is to use a full-featured graphics system such as <samp>TikZ</samp>, or
+<samp>PSTricks</samp>, or <samp>MetaPost</samp>, or <samp>Asymptote</samp>
</p>
<hr>
<a name="g_t_005clinethickness"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cthicklines" accesskey="n" rel="next">\thicklines</a>, Previous: <a href="#g_t_005cline" accesskey="p" rel="prev">\line</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cthinlines" accesskey="n" rel="next">\thinlines</a>, Previous: <a href="#g_t_005cline" accesskey="p" rel="prev">\line</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005clinethickness-1"></a>
-<h4 class="subsection">8.19.7 <code>\linethickness</code></h4>
+<h4 class="subsection">8.19.6 <code>\linethickness</code></h4>
<a name="index-_005clinethickness"></a>
-<p>The <code>\linethickness{<var>dim</var>}</code> command declares the thickness
-of horizontal and vertical lines in a picture environment to be
-<var>dim</var>, which must be a positive length.
+<p>Synopsis:
</p>
-<p><code>\linethickness</code> does not affect the thickness of slanted lines,
-circles, or the quarter circles drawn by <code>\oval</code>.
+<div class="example">
+<pre class="example">\linethickness{<var>dim</var>}
+</pre></div>
+
+<p>Declares the thickness of subsequent horizontal and vertical lines in a
+picture to be <var>dim</var>, which must be a positive length
+(see <a href="#Lengths">Lengths</a>). It differs from <code>\thinlines</code> and
+<code>\thicklines</code> in that it does not affect the thickness of slanted
+lines, circles, or ovals.
</p>
<hr>
-<a name="g_t_005cthicklines"></a>
+<a name="g_t_005cthinlines"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cthinlines" accesskey="n" rel="next">\thinlines</a>, Previous: <a href="#g_t_005clinethickness" accesskey="p" rel="prev">\linethickness</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cthicklines" accesskey="n" rel="next">\thicklines</a>, Previous: <a href="#g_t_005clinethickness" accesskey="p" rel="prev">\linethickness</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cthicklines-1"></a>
-<h4 class="subsection">8.19.8 <code>\thicklines</code></h4>
+<a name="g_t_005cthinlines-1"></a>
+<h4 class="subsection">8.19.7 <code>\thinlines</code></h4>
-<a name="index-_005cthicklines"></a>
+<a name="index-_005cthinlines"></a>
-<p>The <code>\thicklines</code> command is an alternate line thickness for
-horizontal and vertical lines in a picture environment;
-cf.&nbsp;<a href="#g_t_005clinethickness">\linethickness</a> and <a href="#g_t_005cthinlines">\thinlines</a>.
+<p>Declaration to set the thickness of subsequent lines, circles, and ovals
+in a picture environment to be 0.4pt. This is the default
+thickness, so this command is unnecessary unless the thickness has been
+changed with either <a href="#g_t_005clinethickness">\linethickness</a> or <a href="#g_t_005cthicklines">\thicklines</a>.
</p>
<hr>
-<a name="g_t_005cthinlines"></a>
+<a name="g_t_005cthicklines"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cmultiput" accesskey="n" rel="next">\multiput</a>, Previous: <a href="#g_t_005cthicklines" accesskey="p" rel="prev">\thicklines</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005ccircle" accesskey="n" rel="next">\circle</a>, Previous: <a href="#g_t_005cthinlines" accesskey="p" rel="prev">\thinlines</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cthinlines-1"></a>
-<h4 class="subsection">8.19.9 <code>\thinlines</code></h4>
+<a name="g_t_005cthicklines-1"></a>
+<h4 class="subsection">8.19.8 <code>\thicklines</code></h4>
-<a name="index-_005cthinlines"></a>
+<a name="index-_005cthicklines"></a>
-<p>The <code>\thinlines</code> command is the default line thickness for
-horizontal and vertical lines in a picture environment;
-cf.&nbsp;<a href="#g_t_005clinethickness">\linethickness</a> and <a href="#g_t_005cthicklines">\thicklines</a>.
+<p>Declaration to set the thickness of subsequent lines, circles, and ovals
+in a picture environment to be 0.8pt. See also
+<a href="#g_t_005clinethickness">\linethickness</a> and <a href="#g_t_005cthinlines">\thinlines</a>. This command is illustrated
+in the Trapezoidal Rule example of <a href="#picture">picture</a>.
</p>
<hr>
-<a name="g_t_005cmultiput"></a>
+<a name="g_t_005ccircle"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005coval" accesskey="n" rel="next">\oval</a>, Previous: <a href="#g_t_005cthinlines" accesskey="p" rel="prev">\thinlines</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005coval" accesskey="n" rel="next">\oval</a>, Previous: <a href="#g_t_005cthicklines" accesskey="p" rel="prev">\thicklines</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cmultiput-1"></a>
-<h4 class="subsection">8.19.10 <code>\multiput</code></h4>
+<a name="g_t_005ccircle-1"></a>
+<h4 class="subsection">8.19.9 <code>\circle</code></h4>
-<a name="index-_005cmultiput"></a>
+<a name="index-_005ccircle"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\multiput(<var>x</var>,<var>y</var>)(<var>delta_x</var>,<var>delta_y</var>){<var>n</var>}{<var>obj</var>}
+<pre class="example">\circle{<var>diameter</var>}
+\circle*{<var>diameter</var>}
</pre></div>
-<p>The <code>\multiput</code> command copies the object <var>obj</var> in a regular
-pattern across a picture. <var>obj</var> is first placed at position
-<em>(x,y)</em>, then at <em>(x+\delta x,y+\delta y)</em>, and so on,
-<var>n</var> times.
+<p>Produces a circle with a diameter as close as possible to the specified
+one. The <code>*</code>&nbsp;form produces a filled-in circle.
+</p>
+<p>This draws a circle of radius 6, centered at <code>(5,7)</code>.
+</p>
+<div class="example">
+<pre class="example">\put(5,7){\circle{6}}
+</pre></div>
+
+<p>The available radii for <code>circle</code> are, in points, the even
+numbers from 2 to 20, inclusive. For <code>circle*</code> they are all the
+integers from 1 to 15.
</p>
<hr>
<a name="g_t_005coval"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cput" accesskey="n" rel="next">\put</a>, Previous: <a href="#g_t_005cmultiput" accesskey="p" rel="prev">\multiput</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cshortstack" accesskey="n" rel="next">\shortstack</a>, Previous: <a href="#g_t_005ccircle" accesskey="p" rel="prev">\circle</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005coval-1"></a>
-<h4 class="subsection">8.19.11 <code>\oval</code></h4>
+<h4 class="subsection">8.19.10 <code>\oval</code></h4>
<a name="index-_005coval"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\oval(<var>width</var>,<var>height</var>)[<var>portion</var>]
+<pre class="example">\oval(<var>width</var>,<var>height</var>)
+\oval(<var>width</var>,<var>height</var>)[<var>portion</var>]
</pre></div>
-<p>The <code>\oval</code> command produces a rectangle with rounded corners. The
-optional argument <var>portion</var> allows you to produce only half of the
-oval via the following:
+<p>Produce a rectangle with rounded corners. The optional argument
+<var>portion</var> allows you to produce only half or a quarter of the oval.
+For half an oval take <var>portion</var> to be one of these.
</p>
<dl compact="compact">
<dt><code>t</code></dt>
-<dd><p>selects the top half;
+<dd><p>top half
</p></dd>
<dt><code>b</code></dt>
-<dd><p>selects the bottom half;
+<dd><p>bottom half
</p></dd>
<dt><code>r</code></dt>
-<dd><p>selects the right half;
+<dd><p>right half
</p></dd>
<dt><code>l</code></dt>
-<dd><p>selects the left half.
+<dd><p>left half
</p></dd>
</dl>
-<p>It is also possible to produce only one quarter of the oval by setting
-<var>portion</var> to <code>tr</code>, <code>br</code>, <code>bl</code>, or <code>tl</code>.
+<p>Produce only one quarter of the oval by setting <var>portion</var> to
+<code>tr</code>, <code>br</code>, <code>bl</code>, or <code>tl</code>.
</p>
-<p>The &ldquo;corners&rdquo; of the oval are made with quarter circles with a
-maximum radius of 20pt, so large &ldquo;ovals&rdquo; will look more like
-boxes with rounded corners.
-</p>
-
-<hr>
-<a name="g_t_005cput"></a>
-<div class="header">
-<p>
-Next: <a href="#g_t_005cshortstack" accesskey="n" rel="next">\shortstack</a>, Previous: <a href="#g_t_005coval" accesskey="p" rel="prev">\oval</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="g_t_005cput-1"></a>
-<h4 class="subsection">8.19.12 <code>\put</code></h4>
-
-<a name="index-_005cput"></a>
-
-<p>Synopsis:
+<p>This draws the top half of an oval that is 3 wide and 7 tall.
</p>
<div class="example">
-<pre class="example">\put(<var>xcoord</var>,<var>ycoord</var>){ ... }
+<pre class="example">\put(5,7){\oval(3,7)[t]}
</pre></div>
-<p>The <code>\put</code> command places the material specified by the
-(mandatory) argument in braces at the given coordinate,
-(<var>xcoord</var>,<var>ycoord</var>).
+<p>The (5,7) is the center of the entire oval, not just the center of the
+top half.
+</p>
+<p>These shapes are not ellipses. They are rectangles whose corners are
+made with quarter circles. These circles have a maximum radius of
+20pt (see <a href="#g_t_005ccircle">\circle</a> for the sizes). Thus large ovals are just
+boxes with a small amount of corner rounding.
</p>
<hr>
<a name="g_t_005cshortstack"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cvector" accesskey="n" rel="next">\vector</a>, Previous: <a href="#g_t_005cput" accesskey="p" rel="prev">\put</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cvector" accesskey="n" rel="next">\vector</a>, Previous: <a href="#g_t_005coval" accesskey="p" rel="prev">\oval</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cshortstack-1"></a>
-<h4 class="subsection">8.19.13 <code>\shortstack</code></h4>
+<h4 class="subsection">8.19.11 <code>\shortstack</code></h4>
<a name="index-_005cshortstack"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\shortstack[<var>position</var>]{...\\...\\...}
+<pre class="example">\shortstack[<var>position</var>]{<var>line 1</var> \\ ... }
</pre></div>
-<p>The <code>\shortstack</code> command produces a stack of objects. The valid
-positions are:
+<p>Produce a vertical stack of objects.
+</p>
+<p>This labels the <em>y</em> axis.
+</p>
+<div class="example">
+<pre class="example">\put(0,0){\vector(1,0){4}} % x axis
+\put(0,0){\vector(0,1){2}} % y
+\put(-0.25,2){\makebox[0][r]{\shortstack[r]{$y$\\ axis}}}
+</pre></div>
+
+<p>For a short stack, the reference point is the lower left of the stack.
+In the above example the <a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a> puts the stack flush
+right in a zero width box so in total the short stack sits slightly to
+the left of the <em>y</em>&nbsp;axis.
+</p>
+<p>The valid positions are:
</p>
<dl compact="compact">
<dt><code>r</code></dt>
-<dd><p>Move the objects to the right of the stack.
+<dd><p>Make objects flush right
</p></dd>
<dt><code>l</code></dt>
-<dd><p>Move the objects to the left of the stack
+<dd><p>Make objects flush left
</p></dd>
<dt><code>c</code></dt>
-<dd><p>Move the objects to the centre of the stack (default)
+<dd><p>Center objects (default)
</p></dd>
</dl>
<a name="index-_005c_005c-_0028for-_005cshortstack-objects_0029"></a>
-<p>Objects are separated with <code>\\</code>.
+<p>Separate objects into lines with <code>\\</code>. These stacks are short in
+that, unlike in a <code>tabular</code> or <code>array</code> environment, here the
+rows are not spaced out to be of even heights. Thus, in
+<code>\shortstack{X\\o\\o\\X}</code> the first and last rows are taller than
+the middle two. You can adjust row heights either by putting in the
+usual interline spacing with <code>\shortstack{X\\ \strut o\\o\\X}</code>,
+or by hand, via an explicit zero-width box <code>\shortstack{X \\
+\rule{0pt}{12pt} o\\o\\X}</code> or by using <code>\\</code>&rsquo;s optional
+argument <code>\shortstack{X\\[2pt] o\\o\\X}</code>.
+</p>
+<p>The <code>\shortstack</code> command is also available outside the
+<code>picture</code> environment.
</p>
<hr>
<a name="g_t_005cvector"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cshortstack" accesskey="p" rel="prev">\shortstack</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cmakebox-_0028picture_0029" accesskey="n" rel="next">\makebox (picture)</a>, Previous: <a href="#g_t_005cshortstack" accesskey="p" rel="prev">\shortstack</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cvector-1"></a>
-<h4 class="subsection">8.19.14 <code>\vector</code></h4>
+<h4 class="subsection">8.19.12 <code>\vector</code></h4>
<a name="index-_005cvector"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\vector(<var>xslope</var>,<var>yslope</var>){<var>length</var>}
+<pre class="example">\vector(<var>x_run</var>,<var>y_rise</var>){<var>travel</var>}
+</pre></div>
+
+<p>Draw a line ending in an arrow. The slope of that line is: it
+vertically rises <var>y_rise</var> for every horizontal <var>x_run</var>. The
+<var>travel</var> is the total horizontal change&nbsp;&mdash; it is not the
+length of the vector, it is the change in <em>x</em>. In the special case
+of vertical vectors, if (<var>x_run</var>,<var>y_rise</var>)=(0,1), then
+<var>travel</var> gives the change in <em>y</em>.
+</p>
+<p>For an example see <a href="#picture">picture</a>.
+</p>
+<p>For elaboration on <var>x_run</var> and <var>y_rise</var> see <a href="#g_t_005cline">\line</a>. As
+there, the values of <var>x_run</var> and <var>y_rise</var> are limited. For
+<code>\vector</code> you must chooses integers between -4 and 4,
+inclusive. Also, the two you choose must be relatively prime. Thus,
+<code>\vector(2,1){4}</code> is acceptable but <code>\vector(4,2){4}</code> is
+not (if you use the latter then you get a sequence of arrowheads).
+</p>
+
+<hr>
+<a name="g_t_005cmakebox-_0028picture_0029"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cframebox-_0028picture_0029" accesskey="n" rel="next">\framebox (picture)</a>, Previous: <a href="#g_t_005cvector" accesskey="p" rel="prev">\vector</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cmakebox-_0028picture_0029-1"></a>
+<h4 class="subsection">8.19.13 <code>\makebox</code> (picture)</h4>
+
+<a name="index-_005cmakebox-_0028for-picture_0029"></a>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\makebox(<var>rec-width</var>,<var>rec-height</var>){<var>text</var>}
+\makebox(<var>rec-width</var>,<var>rec-height</var>)[<var>position</var>]{<var>text</var>}
+</pre></div>
+
+<p>Make a box to hold <var>text</var>. This command fits with the
+<code>picture</code> environment, although you can use it outside of there,
+because <var>rec-width</var> and <var>rec-height</var> are numbers specifying
+distances in terms of the <code>\unitlength</code> (see <a href="#picture">picture</a>). This
+command is similar to the normal <code>\makebox</code> command (see <a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a>) except here that you must specify the width and height. This
+command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>This makes a box of length 3.5 times <code>\unitlength</code> and height 4
+times <code>\unitlength</code>.
+</p>
+<div class="example">
+<pre class="example">\put(1,2){\makebox(3.5,4){...}}
+</pre></div>
+
+<p>The optional argument <code><var>position</var></code> specifies where in the box
+the <var>text</var> appears. The default is to center it, both horizontally
+and vertically. To place it somewhere else, use a string with one or
+two of these letters.
+</p>
+<dl compact="compact">
+<dt><code>t</code></dt>
+<dd><p>Puts <var>text</var> the top of the box.
+</p>
+</dd>
+<dt><code>b</code></dt>
+<dd><p>Put <var>text</var> at the bottom.
+</p>
+</dd>
+<dt><code>l</code></dt>
+<dd><p>Put <var>text</var> on the left.
+</p>
+</dd>
+<dt><code>r</code></dt>
+<dd><p>Put <var>text</var> on the right.
+</p>
+</dd>
+</dl>
+
+
+<hr>
+<a name="g_t_005cframebox-_0028picture_0029"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cframe" accesskey="n" rel="next">\frame</a>, Previous: <a href="#g_t_005cmakebox-_0028picture_0029" accesskey="p" rel="prev">\makebox (picture)</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cframebox-_0028picture_0029-1"></a>
+<h4 class="subsection">8.19.14 <code>\framebox</code> (picture)</h4>
+
+<a name="index-_005cframebox"></a>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\framebox(<var>rec-width</var>,<var>rec-height</var>){<var>text</var>}
+\framebox(<var>rec-width</var>,<var>rec-height</var>)[<var>position</var>]{<var>text</var>}
+</pre></div>
+
+<p>This is the same as <a href="#g_t_005cmakebox-_0028picture_0029">\makebox (picture)</a> except that it puts a frame
+around the outside of the box that it creates. The reference point is
+the bottom left corner of the frame. This command fits with the
+<code>picture</code> environment, although you can use it outside of there,
+because lengths are numbers specifying the distance in terms of the
+<code>\unitlength</code> (see <a href="#picture">picture</a>). This command is fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>This example creates a frame 2.5&nbsp;inches by 3&nbsp;inches and puts
+the text in the center.
+</p>
+<div class="example">
+<pre class="example">\setlength{\unitlength}{1in}
+\framebox(2.5,3){test text}
+</pre></div>
+
+<p>The required arguments are that the rectangle has overall width
+<var>rect-width</var> units and height <var>rect-height</var> units.
+</p>
+<p>The optional argument <var>position</var> specifies the position of
+<var>text</var>; see <a href="#g_t_005cmakebox-_0028picture_0029">\makebox (picture)</a> for the values that it can
+take.
+</p>
+<a name="index-_005cfboxrule-1"></a>
+<a name="index-_005cfboxsep-1"></a>
+<p>The rule has thickness <code>\fboxrule</code> and there is a blank space
+<code>\fboxsep</code> between the frame and the contents of the box.
+</p>
+<p>For this command, you must specify the <var>width</var> and <var>height</var>. If
+you want to just put a frame around some contents whose dimension is
+determined in some other way then either use <code>\fbox</code> (see <a href="#g_t_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</a>) or <code>\frame</code> (see <a href="#g_t_005cframe">\frame</a>).
+</p>
+
+<hr>
+<a name="g_t_005cframe"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cdashbox" accesskey="n" rel="next">\dashbox</a>, Previous: <a href="#g_t_005cframebox-_0028picture_0029" accesskey="p" rel="prev">\framebox (picture)</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cframe-1"></a>
+<h4 class="subsection">8.19.15 <code>\frame</code></h4>
+
+<a name="index-_005cframe"></a>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\frame{<var>contents</var>}
+</pre></div>
+
+<p>Puts a rectangular frame around <var>contents</var>. The reference point is
+the bottom left corner of the frame. In contrast to <code>\framebox</code>
+(see <a href="#g_t_005cframebox-_0028picture_0029">\framebox (picture)</a>), this command puts no extra space is put
+between the frame and the object. It is fragile (see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+
+<hr>
+<a name="g_t_005cdashbox"></a>
+<div class="header">
+<p>
+Previous: <a href="#g_t_005cframe" accesskey="p" rel="prev">\frame</a>, Up: <a href="#picture" accesskey="u" rel="up">picture</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cdashbox-1"></a>
+<h4 class="subsection">8.19.16 <code>\dashbox</code></h4>
+
+<a name="index-_005cdashbox"></a>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\dashbox{<var>dash-len</var>}(<var>rect-width</var>,<var>rect-height</var>){<var>text</var>}
+\dashbox{<var>dash-len</var>}(<var>rect-width</var>,<var>rect-height</var>)[<var>position</var>]{<var>text</var>}
+</pre></div>
+
+<p>Create a dashed rectangle around <var>text</var>. This command fits with the
+<code>picture</code> environment, although you can use it outside of there,
+because lengths are numbers specifying the distance in terms of the
+<code>\unitlength</code> (see <a href="#picture">picture</a>).
+</p>
+<p>The required arguments are: dashes are <var>dash-len</var> units long, with
+the same length gap, and the rectangle has overall width
+<var>rect-width</var> units and height <var>rect-height</var> units.
+</p>
+<p>The optional argument <var>position</var> specifies the position of
+<var>text</var>; see <a href="#g_t_005cmakebox-_0028picture_0029">\makebox (picture)</a> for the values that it can
+take.
+</p>
+<p>This shows that you can use non-integer value for <var>dash-len</var>.
+</p>
+<div class="example">
+<pre class="example">\put(0,0){\dashbox{0.1}(5,0.5){My hovercraft is full of eels.}}
</pre></div>
-<p>The <code>\vector</code> command draws a line with an arrow of the specified
-length and slope. The <em><var>xslope</var></em> and <em><var>yslope</var></em>
-values must lie between -4 and +4, inclusive.
+<p>Each dash will be <code>0.1\unitlength</code> long, the box&rsquo;s width is
+<code>5\unitlength</code> and its height is <code>0.5\unitlength</code>.
+</p>
+<p>As in that example, a dashed box looks best when <var>rect-width</var> and
+<var>rect-height</var> are multiples of the <var>dash-len</var>.
</p>
<hr>
-<a name="quotation-and-quote"></a>
+<a name="quotation-_0026-quote"></a>
<div class="header">
<p>
-Next: <a href="#tabbing" accesskey="n" rel="next">tabbing</a>, Previous: <a href="#picture" accesskey="p" rel="prev">picture</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tabbing" accesskey="n" rel="next">tabbing</a>, Previous: <a href="#picture" accesskey="p" rel="prev">picture</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="quotation-and-quote-1"></a>
-<h3 class="section">8.20 <code>quotation</code> and <code>quote</code></h3>
+<a name="quotation-_0026-quote-1"></a>
+<h3 class="section">8.20 <code>quotation</code> &amp; <code>quote</code></h3>
<a name="index-environment_002c-quotation"></a>
<a name="index-quotation-environment"></a>
@@ -5994,7 +7410,7 @@ Next: <a href="#tabbing" accesskey="n" rel="next">tabbing</a>, Previous: <a href
</p>
<div class="example">
<pre class="example">\begin{quotation}
-<var>text</var>
+ <var>text</var>
\end{quotation}
</pre></div>
@@ -6002,31 +7418,24 @@ Next: <a href="#tabbing" accesskey="n" rel="next">tabbing</a>, Previous: <a href
</p>
<div class="example">
<pre class="example">\begin{quote}
-<var>text</var>
+ <var>text</var>
\end{quote}
</pre></div>
-<p>Include a quotation.
-</p>
-<p>In both environments, margins are indented on both sides by
-<code>\leftmargin</code> and the text is justified at both. As with the main
-text, leaving a blank line produces a new paragraph.
+<p>Include a quotation. Both environments indent margins on both sides by
+<code>\leftmargin</code> and the text is right-justified.
</p>
-<p>To compare the two: in the <code>quotation</code> environment, paragraphs are
-indented by 1.5em and the space between paragraphs is small,
-<code>0pt plus 1pt</code>. In the <code>quote</code> environment, paragraphs are
-not indented and there is vertical space between paragraphs (it is the
-rubber length <code>\parsep</code>). Thus, the <code>quotation</code> environment
-may be more suitable for documents where new paragraphs are marked by an
-indent rather than by a vertical separation. In addition, <code>quote</code>
-may be more suitable for a short quotation or a sequence of short
-quotations.
+<p>They differ in how they treat paragraphs. In the <code>quotation</code>
+environment, paragraphs are indented by 1.5em and the space
+between paragraphs is small, <code>0pt plus 1pt</code>. In the <code>quote</code>
+environment, paragraphs are not indented and there is vertical space
+between paragraphs (it is the rubber length <code>\parsep</code>).
</p>
<div class="example">
-<pre class="example">\begin{quotation}
-\it Four score and seven years ago
+<pre class="example">\begin{quotation} \small\it
+ Four score and seven years ago
... shall not perish from the earth.
-\hspace{1em plus 1fill}---Abraham Lincoln
+ \hspace{1em plus 1fill}---Abraham Lincoln
\end{quotation}
</pre></div>
@@ -6035,7 +7444,7 @@ quotations.
<a name="tabbing"></a>
<div class="header">
<p>
-Next: <a href="#table" accesskey="n" rel="next">table</a>, Previous: <a href="#quotation-and-quote" accesskey="p" rel="prev">quotation and quote</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#table" accesskey="n" rel="next">table</a>, Previous: <a href="#quotation-_0026-quote" accesskey="p" rel="prev">quotation &amp; quote</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="tabbing-1"></a>
<h3 class="section">8.21 <code>tabbing</code></h3>
@@ -6057,10 +7466,11 @@ Next: <a href="#table" accesskey="n" rel="next">table</a>, Previous: <a href="#q
\end{tabbing}
</pre></div>
-<p>The <code>tabbing</code> environment aligns text in columns. It works by
-setting tab stops and tabbing to them much as was done on a typewriter.
-It is best suited for cases where the width of each column is constant
-and known in advance.
+<p>Align text in columns, by setting tab stops and tabbing to them much as
+was done on a typewriter. This is less often used than the environments
+<code>tabular</code> (see <a href="#tabular">tabular</a>) or <code>array</code> (see <a href="#array">array</a>) because
+in those the width of each column need not be constant and need not be
+known in advance.
</p>
<p>This example has a first line where the tab stops are set to explicit
widths, ended by a <code>\kill</code> command (which is described below):
@@ -6236,8 +7646,9 @@ function \= fact(n : integer) : integer;\\
\end{tabbing}
</pre></div>
-<p>The output looks like this:
-</p><div class="example">
+<p>The output looks like this.
+</p>
+<div class="example">
<pre class="example">function fact(n : integer) : integer;
begin
if n &gt; 1 then
@@ -6257,20 +7668,18 @@ function \= fact(n : integer) : integer;\\
<a name="index-package_002c-fancyvrb"></a>
<a name="index-fancyvrb-package"></a>
-
-<p>(The above example is just for illustration of the environment. To
-actually typeset computer code in typewriter like this, a verbatim
-environment (see <a href="#verbatim">verbatim</a>) would normally suffice. For
-pretty-printed code, there are quite a few packages, including
-<code>algorithm2e</code>, <code>fancyvrb</code>, <code>listings</code>, and
-<code>minted</code>.)
+<p>This example is just for illustration of the environment. To actually
+typeset computer code in typewriter like this, a verbatim environment
+(see <a href="#verbatim">verbatim</a>) would normally be best. For pretty-printed code,
+there are quite a few packages, including <code>algorithm2e</code>,
+<code>fancyvrb</code>, <code>listings</code>, and <code>minted</code>.
</p>
<hr>
<a name="table"></a>
<div class="header">
<p>
-Next: <a href="#tabular" accesskey="n" rel="next">tabular</a>, Previous: <a href="#tabbing" accesskey="p" rel="prev">tabbing</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tabular" accesskey="n" rel="next">tabular</a>, Previous: <a href="#tabbing" accesskey="p" rel="prev">tabbing</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="table-1"></a>
<h3 class="section">8.22 <code>table</code></h3>
@@ -6285,28 +7694,48 @@ Next: <a href="#tabular" accesskey="n" rel="next">tabular</a>, Previous: <a href
</p>
<div class="example">
<pre class="example">\begin{table}[<var>placement</var>]
- table body
-\caption[<var>loftitle</var>]{<var>title</var>}
-\label{<var>label}</var>
+ <var>table body</var>
+ \caption[<var>loftitle</var>]{<var>title</var>} % optional
+ \label{<var>label}</var> % also optional
\end{table}
</pre></div>
-<p>A class of floats (see <a href="#Floats">Floats</a>). Because they cannot be split across
-pages, they are not typeset in sequence with the normal text but instead
-are &ldquo;floated&rdquo; to a convenient place, such as the top of a following
-page.
+<p>A class of floats (see <a href="#Floats">Floats</a>). They cannot be split across pages
+and so they are not typeset in sequence with the normal text but instead
+are floated to a convenient place, such as the top of a following page.
+</p>
+<p>This example <code>table</code> environment contains a <code>tabular</code>
+</p>
+<div class="example">
+<pre class="example">\begin{table}
+ \centering\small
+ \begin{tabular}{ll}
+ \multicolumn{1}{c}{\textit{Author}}
+ &amp;\multicolumn{1}{c}{\textit{Piece}} \\ \hline
+ Bach &amp;Cello Suite Number 1 \\
+ Beethoven &amp;Cello Sonata Number 3 \\
+ Brahms &amp;Cello Sonata Number 1
+ \end{tabular}
+ \caption{Top cello pieces}
+ \label{tab:cello}
+\end{table}
+</pre></div>
+
+<p>but you can put many different kinds of content in a <code>table</code>,
+including text, LaTeX commands, etc.
</p>
<p>For the possible values of <var>placement</var> and their effect on the
float placement algorithm, see <a href="#Floats">Floats</a>.
</p>
-<p>The table body is typeset in a <code>parbox</code> of width <code>\textwidth</code>
-and so it can contain text, commands, etc.
+<p>The table body is typeset in a <code>parbox</code> of width <code>\textwidth</code>.
+It can contain text, commands, graphics, etc.
</p>
<p>The label is optional; it is used for cross references (see <a href="#Cross-references">Cross references</a>).
<a name="index-_005ccaption-1"></a>
-The optional <code>\caption</code> command specifies caption text for the
-table. By default it is numbered. If <var>lottitle</var> is present, it is
-used in the list of tables instead of <var>title</var> (see <a href="#Tables-of-contents">Tables of contents</a>).
+The <code>\caption</code> command is also optional. It specifies caption text
+for the table. By default it is numbered. If its optional
+<var>lottitle</var> is present then that text is used in the list of tables
+instead of <var>title</var> (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>).
</p>
<p>In this example the table and caption will float to the bottom of a page,
unless it is pushed to a float page at the end.
@@ -6329,7 +7758,7 @@ unless it is pushed to a float page at the end.
<a name="tabular"></a>
<div class="header">
<p>
-Next: <a href="#thebibliography" accesskey="n" rel="next">thebibliography</a>, Previous: <a href="#table" accesskey="p" rel="prev">table</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#thebibliography" accesskey="n" rel="next">thebibliography</a>, Previous: <a href="#table" accesskey="p" rel="prev">table</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="tabular-1"></a>
<h3 class="section">8.23 <code>tabular</code></h3>
@@ -6344,7 +7773,7 @@ Next: <a href="#thebibliography" accesskey="n" rel="next">thebibliography</a>, P
</p>
<div class="example">
<pre class="example">\begin{tabular}[<var>pos</var>]{<var>cols</var>}
-column 1 entry &amp;column 2 entry ... &amp;column n entry \\
+ <var>column 1 entry</var> &amp;<var>column 2 entry</var> ... &amp;<var>column n entry</var> \\
...
\end{tabular}
</pre></div>
@@ -6353,14 +7782,14 @@ column 1 entry &amp;column 2 entry ... &amp;column n entry \\
</p>
<div class="example">
<pre class="example">\begin{tabular*}{<var>width</var>}[<var>pos</var>]{<var>cols</var>}
-column 1 entry &amp;column 2 entry ... &amp;column n entry \\
+ <var>column 1 entry</var> &amp;<var>column 2 entry</var> ... &amp;<var>column n entry</var> \\
...
\end{tabular*}
</pre></div>
-<p>These environments produce a table, a box consisting of a sequence of
-horizontal rows. Each row consists of items that are aligned vertically
-in columns. This illustrates many of the features.
+<p>Produce a table, a box consisting of a sequence of horizontal rows.
+Each row consists of items that are aligned vertically in columns. This
+illustrates many of the features.
</p>
<div class="example">
<pre class="example">\begin{tabular}{l|l}
@@ -6371,28 +7800,21 @@ in columns. This illustrates many of the features.
\end{tabular}
</pre></div>
-<p>The vertical format of two left-aligned columns, with a vertical bar
-between them, is specified in <code>tabular</code>&rsquo;s argument <code>{l|l}</code>.
+<p>The output will have two left-aligned columns with a vertical bar
+between them. This is specified in <code>tabular</code>&rsquo;s argument
+<code>{l|l}</code>.
<a name="index-_0026"></a>
-Columns are separated with an ampersand <code>&amp;</code>. A horizontal rule
-between two rows is created with <code>\hline</code>.
+Put the entries into different columns by separating them with an
+ampersand, <code>&amp;</code>. The end of each row is marked with a double
+backslash, <code>\\</code>. Put a horizontal rule below a row, after a double
+backslash, with <code>\hline</code>.
<a name="index-_005c_005c-for-tabular"></a>
-The end of each row is marked with a double backslash&nbsp;<code>\\</code>.
This <code>\\</code> is optional after the last row unless an <code>\hline</code>
command follows, to put a rule below the table.
</p>
<p>The required and optional arguments to <code>tabular</code> consist of:
</p>
<dl compact="compact">
-<dt><var>width</var></dt>
-<dd><p>Required for <code>tabular*</code>, not allowed for <code>tabular</code>. Specifies
-the width of the <code>tabular*</code> environment. The space between columns
-should be rubber, as with <code>@{\extracolsep{\fill}}</code>, to allow
-the table to stretch or shrink to make the specified width, or else you
-are likely to get the <code>Underfull \hbox (badness 10000) in alignment
-...</code> warning.
-</p>
-</dd>
<dt><var>pos</var></dt>
<dd><p>Optional. Specifies the table&rsquo;s vertical position. The default is to
align the table so its vertical center matches the baseline of the
@@ -6428,25 +7850,28 @@ column and intercolumn material.
</p>
</dd>
<dt><code>@{<var>text or space</var>}</code></dt>
-<dd><p>This inserts <var>text or space</var> at this location in every row. The
-<var>text or space</var> material is typeset in LR mode. This text is
-fragile (see <a href="#g_t_005cprotect">\protect</a>).
+<dd><p>Insert <var>text or space</var> at this location in every row. The <var>text
+or space</var> material is typeset in LR mode. This text is fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
</p>
-<p>This specifier is optional: with no @-expression, LaTeX&rsquo;s
+<p>If between two columns there is no @-expression then LaTeX&rsquo;s
<code>book</code>, <code>article</code>, and <code>report</code> classes will put on
-either side of each column a space of length <code>\tabcolsep</code>, which
-by default is &lsquo;<samp>6pt</samp>&rsquo;. That is, by default adjacent columns are
-separated by 12pt (so <code>\tabcolsep</code> is misleadingly-named since it
-is not the separation between tabular columns). By implication, a
-space of 6pt also comes before the first column and after the final
-column, unless you put a <code>@{...}</code> or <code>|</code> there.
+either side of each column a space of length <code>\tabcolsep</code>, which by
+default is 6pt. That is, by default adjacent columns are
+separated by 12pt (so <code>\tabcolsep</code> is misleadingly named
+since it is only half of the separation between tabular columns). In
+addition, a space of 6pt also comes before the first column and
+after the final column, unless you put a <code>@{...}</code> or <code>|</code>
+there.
</p>
-<p>If you override the default and use an @-expression then you must
-insert any desired space yourself, as in <code>@{\hspace{1em}}</code>.
+<p>If you override the default and use an @-expression then LaTeX does
+not insert <code>\tabcolsep</code> so you must insert any desired space
+yourself, as in <code>@{\hspace{1em}}</code>.
</p>
-<p>An empty expression <code>@{}</code> will eliminate the space, including
-the space at the start or end, as in the example below where the tabular
-lines need to lie on the left margin.
+<p>An empty expression <code>@{}</code> will eliminate the space. In
+particular, sometimes you want to eliminate the the space before the
+first column or after the last one, as in the example below where the
+tabular lines need to lie on the left margin.
</p>
<div class="example">
<pre class="example">\begin{flushleft}
@@ -6456,8 +7881,8 @@ lines need to lie on the left margin.
\end{flushleft}
</pre></div>
-<p>This example shows text, a decimal point, between the columns, arranged
-so the numbers in the table are aligned on that decimal point.
+<p>The next example shows text, a decimal point between the columns,
+arranged so the numbers in the table are aligned on it.
</p>
<div class="example">
<pre class="example">\begin{tabular}{r@{$.$}l}
@@ -6469,20 +7894,18 @@ so the numbers in the table are aligned on that decimal point.
<a name="index-_005cextracolsep"></a>
<p>An <code>\extracolsep{<var>wd</var>}</code> command in an @-expression causes an
extra space of width <var>wd</var> to appear to the left of all subsequent
-columns, until countermanded by another <code>\extracolsep</code> command.
-Unlike ordinary intercolumn space, this extra space is not suppressed by
-an @-expression. An <code>\extracolsep</code> command can be used only in an
+columns, until countermanded by another <code>\extracolsep</code>. Unlike
+ordinary intercolumn space, this extra space is not suppressed by an
+@-expression. An <code>\extracolsep</code> command can be used only in an
@-expression in the <code>cols</code> argument. Below, LaTeX inserts the
right amount of intercolumn space to make the entire table 4 inches
wide.
</p>
<div class="example">
-<pre class="example">\begin{center}
- \begin{tabular*}{4in}{l@{\ \ldots\extracolsep{\fill}}l}
- Seven times down, eight times up
- &amp;such is life!
- \end{tabular*}
-\end{center}
+<pre class="example">\begin{tabular*}{4in}{l@{\extracolsep{\fill}}l}
+ Seven times down, eight times up \ldots
+ &amp;such is life!
+\end{tabular*}
</pre></div>
<p>To insert commands that are automatically executed before a given
@@ -6491,27 +7914,39 @@ specifier.
</p>
</dd>
<dt><code>p{<var>wd</var>}</code></dt>
-<dd><p>Each item in the column is typeset in a parbox of width <var>wd</var>.
+<dd><p>Each item in the column is typeset in a parbox of width <var>wd</var>, as if
+it were the argument of a <code>\parbox[t]{wd}{...}</code> command.
</p>
-<p>Note that a line break double backslash <code>\\</code> may not appear in the
-item, except inside an environment like <code>minipage</code>, <code>array</code>,
-or <code>tabular</code>, or inside an explicit <code>\parbox</code>, or in the scope
-of a <code>\centering</code>, <code>\raggedright</code>, or <code>\raggedleft</code>
+<p>A line break double backslash <code>\\</code> may not appear in the item,
+except inside an environment like <code>minipage</code>, <code>array</code>, or
+<code>tabular</code>, or inside an explicit <code>\parbox</code>, or in the scope of
+a <code>\centering</code>, <code>\raggedright</code>, or <code>\raggedleft</code>
declaration (when used in a <code>p</code>-column element these declarations
must appear inside braces, as with <code>{\centering .. \\
..}</code>). Otherwise LaTeX will misinterpret the double backslash as
-ending the row.
+ending the row. Instead, to get a line break in there use
+<code>\newline</code> (see <a href="#g_t_005cnewline">\newline</a>).
</p>
</dd>
<dt><code>*{<var>num</var>}{<var>cols</var>}</code></dt>
<dd><p>Equivalent to <var>num</var> copies of <var>cols</var>, where <var>num</var> is a
-positive integer and <var>cols</var> is a list of specifiers. Thus
-<code>\begin{tabular}{|*{3}{l|r}|}</code> is equivalent to
-<code>\begin{tabular}{|l|rl|rl|r|}</code>. Note that <var>cols</var> may
-contain another <code>*</code>-expression.
+positive integer and <var>cols</var> is a list of specifiers. Thus the
+specifier <code>\begin{tabular}{|*{3}{l|r}|}</code> is equivalent to
+the specifier <code>\begin{tabular}{|l|rl|rl|r|}</code>. Note that
+<var>cols</var> may contain another <code>*</code>-expression.
</p>
</dd>
</dl>
+
+</dd>
+<dt><var>width</var></dt>
+<dd><p>Required for <code>tabular*</code>, not allowed for <code>tabular</code>. Specifies
+the width of the <code>tabular*</code> environment. The space between columns
+should be rubber, as with <code>@{\extracolsep{\fill}}</code>, to allow
+the table to stretch or shrink to make the specified width, or else you
+are likely to get the <code>Underfull \hbox (badness 10000) in alignment
+...</code> warning.
+</p>
</dd>
</dl>
@@ -6521,7 +7956,7 @@ contain another <code>*</code>-expression.
<dt><code>\arrayrulewidth</code>
<a name="index-_005carrayrulewidth"></a>
</dt>
-<dd><p>A length that is the thickness of the rule created by <code>|</code>,
+<dd><a name="tabular-arrayrulewidth"></a><p>A length that is the thickness of the rule created by <code>|</code>,
<code>\hline</code>, and <code>\vline</code> in the <code>tabular</code> and <code>array</code>
environments. The default is &lsquo;<samp>.4pt</samp>&rsquo;. Change it as in
<code>\setlength{\arrayrulewidth}{0.8pt}</code>.
@@ -6530,7 +7965,7 @@ environments. The default is &lsquo;<samp>.4pt</samp>&rsquo;. Change it as in
<dt><code>\arraystretch</code>
<a name="index-_005carraystretch"></a>
</dt>
-<dd><p>A factor by which the spacing between rows in the <code>tabular</code> and
+<dd><a name="tabular-arraystrech"></a><p>A factor by which the spacing between rows in the <code>tabular</code> and
<code>array</code> environments is multiplied. The default is &lsquo;<samp>1</samp>&rsquo;, for
no scaling. Change it as <code>\renewcommand{\arraystretch}{1.2}</code>.
</p>
@@ -6538,14 +7973,14 @@ no scaling. Change it as <code>\renewcommand{\arraystretch}{1.2}</code>.
<dt><code>\doublerulesep</code>
<a name="index-_005cdoublerulesep"></a>
</dt>
-<dd><p>A length that is the distance between the vertical rules produced by the
+<dd><a name="tabular-doublerulesep"></a><p>A length that is the distance between the vertical rules produced by the
<code>||</code> specifier. The default is &lsquo;<samp>2pt</samp>&rsquo;.
</p>
</dd>
<dt><code>\tabcolsep</code>
<a name="index-_005ctabcolsep"></a>
</dt>
-<dd><p>A length that is half of the space between columns. The default is
+<dd><a name="tabular-tabcolsep"></a><p>A length that is half of the space between columns. The default is
&lsquo;<samp>6pt</samp>&rsquo;. Change it with <code>\setlength</code>.
</p>
</dd>
@@ -6571,7 +8006,7 @@ lines:
<a name="g_t_005cmulticolumn"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cvline" accesskey="n" rel="next">\vline</a>, Up: <a href="#tabular" accesskey="u" rel="up">tabular</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cvline" accesskey="n" rel="next">\vline</a>, Up: <a href="#tabular" accesskey="u" rel="up">tabular</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cmulticolumn-1"></a>
<h4 class="subsection">8.23.1 <code>\multicolumn</code></h4>
@@ -6596,8 +8031,9 @@ spanned by the single heading &lsquo;<samp>Name</samp>&rsquo;.
</p>
<div class="example">
<pre class="example">\begin{tabular}{lccl}
- \textit{ID} &amp;\multicolumn{2}{c}{\textit{Name}} &amp;\textit{Age} \\ \hline % row one
- 978-0-393-03701-2 &amp;O'Brian &amp;Patrick &amp;55 \\ % row two
+ \textit{ID} &amp;\multicolumn{2}{c}{\textit{Name}} &amp;\textit{Age} \\
+ \hline
+ 978-0-393-03701-2 &amp;O'Brian &amp;Patrick &amp;55 \\
...
\end{tabular}
</pre></div>
@@ -6673,7 +8109,7 @@ vertical bar in the <var>cols</var> of either of the first row&rsquo;s
<a name="g_t_005cvline"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005ccline" accesskey="n" rel="next">\cline</a>, Previous: <a href="#g_t_005cmulticolumn" accesskey="p" rel="prev">\multicolumn</a>, Up: <a href="#tabular" accesskey="u" rel="up">tabular</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005ccline" accesskey="n" rel="next">\cline</a>, Previous: <a href="#g_t_005cmulticolumn" accesskey="p" rel="prev">\multicolumn</a>, Up: <a href="#tabular" accesskey="u" rel="up">tabular</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cvline-1"></a>
<h4 class="subsection">8.23.2 <code>\vline</code></h4>
@@ -6685,24 +8121,24 @@ used in an @-expression, although its synonym vertical
bar&nbsp;<code>|</code> is more common. This command is rarely used in the
body of a table; typically a table&rsquo;s vertical lines are specified in
<code>tabular</code>&rsquo;s <var>cols</var> argument and overridden as needed with
-<code>\multicolumn</code>.
+<code>\multicolumn</code> (see <a href="#tabular">tabular</a>).
</p>
-<p>This example illustrates some pitfalls. In the first line&rsquo;s second
+<p>The example below illustrates some pitfalls. In the first row&rsquo;s second
entry the <code>\hfill</code> moves the <code>\vline</code> to the left edge of the
cell. But that is different than putting it halfway between the two
-columns, so in that row between the first and second columns there are
-two vertical rules, with the one from the <code>{c|cc}</code> specifier
-coming before the one produced by the <code>\vline\hfill</code>. In contrast,
-the first line&rsquo;s third entry shows the usual way to put a vertical bar
-between two columns. In the second line, the <code>ghi</code> is the widest
-entry in its column so in the <code>\vline\hfill</code> the <code>\hfill</code> has
-no effect and the vertical line in that entry appears immediately next
-to the <code>g</code>, with no whitespace.
+columns, so between the first and second columns there are two vertical
+rules, with the one from the <code>{c|cc}</code> specifier coming before the
+one produced by the <code>\vline\hfill</code>. In contrast, the first row&rsquo;s
+third entry shows the usual way to put a vertical bar between two
+columns. In the second row, the <code>ghi</code> is the widest entry in its
+column so in the <code>\vline\hfill</code> the <code>\hfill</code> has no effect and
+the vertical line in that entry appears immediately next to the
+<code>g</code>, with no whitespace.
</p>
<div class="example">
<pre class="example">\begin{tabular}{c|cc}
- x &amp;\vline\hfill y &amp;\multicolumn{1}{|r}{z} \\
- abc &amp;def &amp;\vline\hfill ghi
+ x &amp;\vline\hfill y &amp;\multicolumn{1}{|r}{z} \\ % row 1
+ abc &amp;def &amp;\vline\hfill ghi % row 2
\end{tabular}
</pre></div>
@@ -6711,7 +8147,7 @@ to the <code>g</code>, with no whitespace.
<a name="g_t_005ccline"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005chline" accesskey="n" rel="next">\hline</a>, Previous: <a href="#g_t_005cvline" accesskey="p" rel="prev">\vline</a>, Up: <a href="#tabular" accesskey="u" rel="up">tabular</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005chline" accesskey="n" rel="next">\hline</a>, Previous: <a href="#g_t_005cvline" accesskey="p" rel="prev">\vline</a>, Up: <a href="#tabular" accesskey="u" rel="up">tabular</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005ccline-1"></a>
<h4 class="subsection">8.23.3 <code>\cline</code></h4>
@@ -6724,10 +8160,10 @@ Next: <a href="#g_t_005chline" accesskey="n" rel="next">\hline</a>, Previous: <a
<pre class="example">\cline{<var>i</var>-<var>j</var>}
</pre></div>
-<p>Draw a horizontal rule in an <code>array</code> or <code>tabular</code> environment
-beginning in column <var>i</var> and ending in column <var>j</var>. The
-dash&nbsp;<code>-</code> must appear in the mandatory argument. To span a
-single column use the number twice.
+<p>In an <code>array</code> or <code>tabular</code> environment, draw a horizontal rule
+beginning in column&nbsp;<var>i</var> and ending in column&nbsp;<var>j</var>. The
+dash, <code>-</code>, must appear in the mandatory argument. To span a single
+column use the number twice, as with <code>\cline{2-2}</code>.
</p>
<p>This example puts two horizontal lines between the first and second
rows, one line in the first column only, and the other spanning the
@@ -6746,14 +8182,14 @@ height.
<a name="g_t_005chline"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005ccline" accesskey="p" rel="prev">\cline</a>, Up: <a href="#tabular" accesskey="u" rel="up">tabular</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005ccline" accesskey="p" rel="prev">\cline</a>, Up: <a href="#tabular" accesskey="u" rel="up">tabular</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005chline-1"></a>
<h4 class="subsection">8.23.4 <code>\hline</code></h4>
<a name="index-_005chline"></a>
-<p>Draws a horizontal line the width of the enclosing <code>tabular</code> or
+<p>Draw a horizontal line the width of the enclosing <code>tabular</code> or
<code>array</code> environment. It&rsquo;s most commonly used to draw a line at the
top, bottom, and between the rows of a table.
</p>
@@ -6775,7 +8211,7 @@ is required.
<a name="thebibliography"></a>
<div class="header">
<p>
-Next: <a href="#theorem" accesskey="n" rel="next">theorem</a>, Previous: <a href="#tabular" accesskey="p" rel="prev">tabular</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#theorem" accesskey="n" rel="next">theorem</a>, Previous: <a href="#tabular" accesskey="p" rel="prev">tabular</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="thebibliography-1"></a>
<h3 class="section">8.24 <code>thebibliography</code></h3>
@@ -6789,44 +8225,60 @@ Next: <a href="#theorem" accesskey="n" rel="next">theorem</a>, Previous: <a href
</p>
<div class="example">
<pre class="example">\begin{thebibliography}{<var>widest-label</var>}
-\bibitem[<var>label</var>]{<var>cite_key}</var>
-...
+ \bibitem[<var>label</var>]{<var>cite_key}</var>
+ ...
\end{thebibliography}
</pre></div>
-<p>The <code>thebibliography</code> environment produces a bibliography or
-reference list.
+<p>Produce a bibliography or reference list. There are two ways to produce
+bibliographic lists. This environment is suitable when you have only a
+few references and can maintain the list by hand. See <a href="#Using-BibTeX">Using BibTeX</a>
+for a more sophisticated approach.
</p>
-<p>In the <code>article</code> class, this reference list is labelled
-&lsquo;<samp>References</samp>&rsquo; and the label is stored in macro <code>\refname</code>; in
-the <code>report</code> class, it is labelled &lsquo;<samp>Bibliography</samp>&rsquo; and the
-label is stored in macro <code>\bibname</code>.
+<p>This shows the environment with two entries.
</p>
-<p>You can change the label by redefining the command <code>\refname</code> or
-<code>\bibname</code>, whichever is applicable depending on the class:
-</p>
-<ul>
-<li> <a name="index-_005cbibname"></a>
-For standard classes whose top level sectioning is <code>\chapter</code>
-(such as <samp>book</samp> and <samp>report</samp>), the label is in the macro
-<code>\bibname</code>;
-
-</li><li> <a name="index-_005crefname"></a>
-For standard classes whose the top level sectioning is <code>\section</code>
-(such as <samp>article</samp>), the label is in macro <code>\refname</code>.
-</li></ul>
-
-<a name="index-package_002c-babel"></a>
-<a name="index-babel-package"></a>
+<div class="example">
+<pre class="example">This work is based on \cite{latexdps}.
+Together they are \cite{latexdps, texbook}.
+ ...
+\begin{thebibliography}{9}
+\bibitem{latexdps}
+ Leslie Lamport.
+ \textit{\LaTeX{}: a document preparation system}.
+ Addison-Wesley, Reading, Massachusetts, 1993.
+\bibitem{texbook}
+ Donald Ervin Knuth.
+ \textit{The \TeX book}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+\end{thebibliography}
+</pre></div>
-<p>Typically it is neither necessary nor desirable to directly redefine
-<code>\refname</code> or <code>\bibname</code>; language support packages like
-<samp>babel</samp> do this.
+<p>This styles the first reference as &lsquo;<samp>[1] Leslie ...</samp>&rsquo;, and so that
+<code>\cite{latexdps}</code> produces the matching &lsquo;<samp>... based on [1]</samp>&rsquo;.
+The second <code>\cite</code> produces &lsquo;<samp>[1, 2]</samp>&rsquo;. You must compile the
+document twice to resolve these references.
+</p>
+<p>The mandatory argument <var>widest-label</var> is text that, when typeset, is
+as wide as the widest item label produced by the <code>\bibitem</code>
+commands. The tradition is to use <code>9</code> for bibliographies with less
+than 10 references, <code>99</code> for ones with less than 100, etc.
+</p>
+<p>The bibliographic list is headed by a title such as &lsquo;<samp>Bibliography</samp>&rsquo;.
+To change it there are two cases. In the <samp>book</samp> and <samp>report</samp>
+classes, where the top level sectioning is <code>\chapter</code> and the
+default title is &lsquo;<samp>Bibliography</samp>&rsquo;, that title is in the macro
+<code>\bibname</code>. For <samp>article</samp>, where the class&rsquo;s top level
+sectioning is <code>\section</code> and the default is &lsquo;<samp>References</samp>&rsquo;, the
+title is in macro <code>\refname</code>. Change it by redefining the command,
+as with <code>\renewcommand{\refname}{Cited references}</code> after
+<code>\begin{document}</code>.
</p>
-<p>The mandatory <var>widest-label</var> argument is text that, when typeset,
-is as wide as the widest item label produced by the <code>\bibitem</code>
-commands. It is typically given as <code>9</code> for bibliographies with
-less than 10 references, <code>99</code> for ones with less than 100, etc.
+<a name="index-package_002c-babel-1"></a>
+<a name="index-babel-package-1"></a>
+
+<p>Language support packages such as <samp>babel</samp> will automatically
+redefine <code>\refname</code> or <code>\bibname</code> to fit the selected
+language.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#g_t_005cbibitem" accesskey="1">\bibitem</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Specify a bibliography item.
@@ -6844,7 +8296,7 @@ less than 10 references, <code>99</code> for ones with less than 100, etc.
<a name="g_t_005cbibitem"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005ccite" accesskey="n" rel="next">\cite</a>, Up: <a href="#thebibliography" accesskey="u" rel="up">thebibliography</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005ccite" accesskey="n" rel="next">\cite</a>, Up: <a href="#thebibliography" accesskey="u" rel="up">thebibliography</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cbibitem-1"></a>
<h4 class="subsection">8.24.1 <code>\bibitem</code></h4>
@@ -6854,29 +8306,74 @@ Next: <a href="#g_t_005ccite" accesskey="n" rel="next">\cite</a>, Up: <a href="#
<p>Synopsis:
</p>
<div class="example">
+<pre class="example">\bibitem{<var>cite_key</var>}
+</pre></div>
+
+<p>or
+</p>
+<div class="example">
<pre class="example">\bibitem[<var>label</var>]{<var>cite_key</var>}
</pre></div>
-<p>The <code>\bibitem</code> command generates an entry labelled by <var>label</var>.
-If the <var>label</var> argument is missing, a number is automatically
-generated using the <code>enumi</code> counter. The <var>cite_key</var> is a
+<p>Generate an entry labeled by <var>label</var>. The default is for LaTeX to
+generates a number using the <code>enumi</code> counter. The <em>citation key</em>
<a name="index-citation-key"></a>
-<em>citation key</em> consisting in any sequence of
-letters, numbers, and punctuation symbols not containing a comma.
+<var>cite_key</var> is a string of
+letters, numbers, and punctuation symbols (but not comma).
+</p>
+<p>See <a href="#thebibliography">thebibliography</a> for an example.
</p>
-<p>This command writes an entry to the <samp>.aux</samp> file containing the
-item&rsquo;s <var>cite_key</var> and <var>label</var>. When the <samp>.aux</samp> file is
-read by the <code>\begin{document}</code> command, the item&rsquo;s <var>label</var> is
-associated with <code>cite_key</code>, causing references to <var>cite_key</var>
-with a <code>\cite</code> command (see <a href="#g_t_005ccite">\cite</a>) to produce the associated
-<var>label</var>.
+<p>The optional <var>label</var> changes the default label from an integer to the
+given string. With this
+</p>
+<div class="example">
+<pre class="example">\begin{thebibliography}
+\bibitem[Lamport 1993]{latexdps}
+ Leslie Lamport.
+ \textit{\LaTeX{}: a document preparation system}.
+ Addison-Wesley, Reading, Massachusetts, 1993.
+\bibitem{texbook}
+ Donald Ervin Knuth.
+ \textit{The \TeX book}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+\end{thebibliography}
+</pre></div>
+
+<p>the first entry will be styled as &lsquo;<samp>[Lamport 1993] Leslie ...</samp>&rsquo; (The
+amount of horizontal space that LaTeX leaves for the label depends on
+the <var>widest-label</var> argument of the <code>thebibliography</code>
+environment; see <a href="#thebibliography">thebibliography</a>.) Similarly, <code>... based on
+\cite{latexdps}</code> will produce &lsquo;<samp>... based on [Lamport 1994]</samp>&rsquo;.
+</p>
+<p>If you mix <code>\bibitem</code> entries having a <var>label</var> with those that
+do not then LaTeX will number the unlabelled ones sequentially. In
+the example above the <code>texbook</code> entry will appear as &lsquo;<samp>[1]
+Donald ...</samp>&rsquo;, despite that it is the second entry.
+</p>
+<p>If you use the same <var>cite_key</var> twice then you get &lsquo;<samp>LaTeX
+Warning: There were multiply-defined labels</samp>&rsquo;.
+</p>
+<p>Under the hood, LaTeX remembers the <var>cite_key</var> and <var>label</var>
+information because <code>\bibitem</code> writes it to the auxiliary file
+<samp><var>filename</var>.aux</samp>. For instance, the above example causes
+<code>\bibcite{latexdps}{Lamport, 1993}</code> and
+<code>\bibcite{texbook}{1}</code> to appear in that file. The <samp>.aux</samp>
+file is read by the <code>\begin{document}</code> command and then the
+information is available for <code>\cite</code> commands. This explains why
+you need to run LaTeX twice to resolve references: once to write it
+out and once to read it in.
+</p>
+<p>Because of this two-pass algorithm, when you add a <code>\bibitem</code> or
+change its <var>cite_key</var> you may get &lsquo;<samp>LaTeX Warning: Label(s) may
+have changed. Rerun to get cross-references right</samp>&rsquo;. Fix it by
+recompiling.
</p>
<hr>
<a name="g_t_005ccite"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cnocite" accesskey="n" rel="next">\nocite</a>, Previous: <a href="#g_t_005cbibitem" accesskey="p" rel="prev">\bibitem</a>, Up: <a href="#thebibliography" accesskey="u" rel="up">thebibliography</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cnocite" accesskey="n" rel="next">\nocite</a>, Previous: <a href="#g_t_005cbibitem" accesskey="p" rel="prev">\bibitem</a>, Up: <a href="#thebibliography" accesskey="u" rel="up">thebibliography</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005ccite-1"></a>
<h4 class="subsection">8.24.2 <code>\cite</code></h4>
@@ -6886,24 +8383,60 @@ Next: <a href="#g_t_005cnocite" accesskey="n" rel="next">\nocite</a>, Previous:
<p>Synopsis:
</p>
<div class="example">
+<pre class="example">\cite{<var>keys</var>}
+</pre></div>
+
+<p>or
+</p>
+<div class="example">
<pre class="example">\cite[<var>subcite</var>]{<var>keys</var>}
</pre></div>
-<p>The <var>keys</var> argument is a list of one or more citation keys
-(see <a href="#g_t_005cbibitem">\bibitem</a>), separated by commas. This command generates an
-in-text citation to the references associated with <var>keys</var> by entries
-in the <samp>.aux</samp> file.
+<p>Generate as output a citation to the references associated with
+<var>keys</var>. The mandatory <var>keys</var> is a citation key, or a
+comma-separated list of citation keys (see <a href="#g_t_005cbibitem">\bibitem</a>).
</p>
-<p>The text of the optional <var>subcite</var> argument appears after the
-citation. For example, <code>\cite[p.~314]{knuth}</code> might produce
-&lsquo;<samp>[Knuth, p.&nbsp;314]</samp>&rsquo;.
+<p>This
+</p>
+<div class="example">
+<pre class="example">The ultimate source is \cite{texbook}.
+ ...
+\begin{thebibliography}
+\bibitem{texbook}
+ Donald Ervin Knuth.
+ \textit{The \TeX book}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+\end{thebibliography}
+</pre></div>
+
+<p>produces the output &lsquo;<samp>... source is [1]</samp>&rsquo;.
+</p>
+<p>The optional argument <var>subcite</var> is appended to the citation. For
+example, <code>See 14.3 in \cite[p.~314]{texbook}</code> might produce
+&lsquo;<samp>See 14.3 in [1, p.&nbsp;314]</samp>&rsquo;.
+</p>
+<p>If <var>keys</var> is not in your bibliography information then you get
+&lsquo;<samp>LaTeX Warning: There were undefined references</samp>&rsquo;, and in the output
+the citation shows as a boldface question mark between square brackets.
+There are two possible causes. If you have mistyped something, as in
+<code>\cite{texbok}</code> then you need to correct the spelling. On the
+other hand, if you have just added or modified the bibliographic
+information and so changed the <samp>.aux</samp> file (see <a href="#g_t_005cbibitem">\bibitem</a>) then
+the fix may be to just run LaTeX again.
+</p>
+<p>In addition to what appears in the output, <code>\cite</code> writes
+information to the auxiliary file <samp><var>filename</var>.aux</samp>. For
+instance, <code>\cite{latexdps}</code> writes &lsquo;<samp>\citation{latexdps}</samp>&rsquo;
+to that file. This information is used by BibTeX to include in your
+reference list only those works that you have actually cited; see
+<a href="#g_t_005cnocite">\nocite</a> also.
</p>
<hr>
<a name="g_t_005cnocite"></a>
<div class="header">
<p>
-Next: <a href="#Using-BibTeX" accesskey="n" rel="next">Using BibTeX</a>, Previous: <a href="#g_t_005ccite" accesskey="p" rel="prev">\cite</a>, Up: <a href="#thebibliography" accesskey="u" rel="up">thebibliography</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Using-BibTeX" accesskey="n" rel="next">Using BibTeX</a>, Previous: <a href="#g_t_005ccite" accesskey="p" rel="prev">\cite</a>, Up: <a href="#thebibliography" accesskey="u" rel="up">thebibliography</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cnocite-1"></a>
<h4 class="subsection">8.24.3 <code>\nocite</code></h4>
@@ -6916,15 +8449,20 @@ Next: <a href="#Using-BibTeX" accesskey="n" rel="next">Using BibTeX</a>, Previou
<pre class="example"><code>\nocite{<var>keys</var>}</code>
</pre></div>
-<p>The <code>\nocite</code> command produces no text, but writes <var>keys</var>,
-which is a list of one or more citation keys, to the <samp>.aux</samp> file.
+<p>Produces no output but writes <var>keys</var> to the auxiliary file
+<samp><var>doc-filename</var>.aux</samp>.
+</p>
+<p>The mandatory argument <var>keys</var> is a comma-separated list of one or
+more citation keys (see <a href="#g_t_005cbibitem">\bibitem</a>). This information is used by
+BibTeX to include these works in your reference list even though you
+have not cited them (see <a href="#g_t_005ccite">\cite</a>).
</p>
<hr>
<a name="Using-BibTeX"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cnocite" accesskey="p" rel="prev">\nocite</a>, Up: <a href="#thebibliography" accesskey="u" rel="up">thebibliography</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cnocite" accesskey="p" rel="prev">\nocite</a>, Up: <a href="#thebibliography" accesskey="u" rel="up">thebibliography</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Using-BibTeX-1"></a>
<h4 class="subsection">8.24.4 Using BibTeX</h4>
@@ -6935,30 +8473,31 @@ Previous: <a href="#g_t_005cnocite" accesskey="p" rel="prev">\nocite</a>, Up: <a
<a name="index-_005cbibliographystyle"></a>
<a name="index-_005cbibliography"></a>
-<p>If you use the BibTeX program by Oren Patashnik (highly
-recommended if you need a bibliography of more than a couple of
-titles) to maintain your bibliography, you don&rsquo;t use the
-<code>thebibliography</code> environment (see <a href="#thebibliography">thebibliography</a>). Instead,
-you include the lines
+<p>As described in <code>thebibliography</code> (see <a href="#thebibliography">thebibliography</a>), a
+sophisticated approach to managing bibliographies is provided by the
+BibTeX program. This is only an introduction; see the full
+documentation on CTAN.
+</p>
+<p>With BibTeX, you don&rsquo;t use <code>thebibliography</code>
+(see <a href="#thebibliography">thebibliography</a>). Instead, include these lines.
</p>
<div class="example">
<pre class="example">\bibliographystyle{<var>bibstyle</var>}
-\bibliography{<var>bibfile1</var>,<var>bibfile2</var>}
+\bibliography{<var>bibfile1</var>, <var>bibfile2</var>, ...}
</pre></div>
-<p>The <code>\bibliographystyle</code> command does not produce any output of
-its own. Rather, it defines the style in which the bibliography will
-be produced: <var>bibstyle</var> refers to a file
-<var>bibstyle</var><samp>.bst</samp>, which defines how your citations will look.
-The standard <var>bibstyle</var> names distributed with BibTeX are:
+<p>The <var>bibstyle</var> refers to a file <samp><var>bibstyle</var>.bst</samp>, which
+defines how your citations will look. The standard <var>bibstyle</var>&rsquo;s
+distributed with BibTeX are:
</p>
<dl compact="compact">
<dt><code>alpha</code></dt>
-<dd><p>Sorted alphabetically. Labels are formed from name of author and year of
-publication.
+<dd><p>Labels are formed from name of author and year of publication.
+The bibliographic items are sorted alphabetically.
</p></dd>
<dt><code>plain</code></dt>
-<dd><p>Sorted alphabetically. Labels are numeric.
+<dd><p>Labels are integers.
+Sort the bibliographic items alphabetically.
</p></dd>
<dt><code>unsrt</code></dt>
<dd><p>Like <code>plain</code>, but entries are in order of citation.
@@ -6968,23 +8507,45 @@ publication.
</p></dd>
</dl>
-<p>In addition, numerous other BibTeX style files exist tailored to
-the demands of various publications. See
+<p>Many, many other BibTeX style files exist,
+tailored to the demands of various publications. See CTAN&rsquo;s listing
<a href="http://mirror.ctan.org/biblio/bibtex/contrib">http://mirror.ctan.org/biblio/bibtex/contrib</a>.
</p>
<p>The <code>\bibliography</code> command is what actually produces the
-bibliography. The argument to <code>\bibliography</code> refers to files
-named <samp><var>bibfile1</var>.bib</samp>, <samp><var>bibfile2</var>.bib</samp>, &hellip;,
-which should contain your database in
-BibTeX format. Only the entries referred to via <code>\cite</code> and
-<code>\nocite</code> will be listed in the bibliography.
+bibliography. Its argument is a comma-separated list, referring to
+files named <samp><var>bibfile1</var>.bib</samp>, <samp><var>bibfile2</var>.bib</samp>,
+&hellip; These contain your database in BibTeX format. This shows a
+typical couple of entries in that format.
+</p>
+<div class="example">
+<pre class="example">@book{texbook,
+ title = {The {{\TeX}}book},
+ author = {D.E. Knuth},
+ isbn = {0201134489},
+ series = {Computers \&amp; typesetting},
+ year = {1983},
+ publisher = {Addison-Wesley}
+}
+@book{sexbook,
+ author = {W.H. Masters and V.E. Johnson},
+ title = {Human Sexual Response},
+ year = {1966},
+ publisher = {Bantam Books}
+}
+</pre></div>
+
+<p>Only the bibliographic entries referred to via <code>\cite</code> and
+<code>\nocite</code> will be listed in the document&rsquo;s bibliography. Thus you
+can keep all your sources together in one file, or a small number of
+files, and rely on BibTeX to include in this document only those that
+you used.
</p>
<hr>
<a name="theorem"></a>
<div class="header">
<p>
-Next: <a href="#titlepage" accesskey="n" rel="next">titlepage</a>, Previous: <a href="#thebibliography" accesskey="p" rel="prev">thebibliography</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#titlepage" accesskey="n" rel="next">titlepage</a>, Previous: <a href="#thebibliography" accesskey="p" rel="prev">thebibliography</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="theorem-1"></a>
<h3 class="section">8.25 <code>theorem</code></h3>
@@ -6998,21 +8559,45 @@ Next: <a href="#titlepage" accesskey="n" rel="next">titlepage</a>, Previous: <a
</p>
<div class="example">
<pre class="example">\begin{theorem}
-<var>theorem-text</var>
+ <var>theorem body</var>
\end{theorem}
</pre></div>
-<p>The <code>theorem</code> environment produces &ldquo;Theorem <var>n</var>&rdquo; in
-boldface followed by <var>theorem-text</var>, where the numbering
-possibilities for <var>n</var> are described under <code>\newtheorem</code>
-(see <a href="#g_t_005cnewtheorem">\newtheorem</a>).
+<p>Produces &lsquo;<samp>Theorem <var>n</var></samp>&rsquo; in boldface followed by <var>theorem
+body</var> in italics. The numbering possibilities for <var>n</var> are described under
+<code>\newtheorem</code> (see <a href="#g_t_005cnewtheorem">\newtheorem</a>).
+</p>
+<div class="example">
+<pre class="example">\newtheorem{lem}{Lemma} % in preamble
+\newtheorem{thm}{Theorem}
+ ...
+\begin{lem} % in document body
+ text of lemma
+\end{lem}
+
+The next result follows immediately.
+\begin{thm}[Gauss] % put `Gauss' in parens after theorem head
+ text of theorem
+\end{thm}
+</pre></div>
+
+<a name="index-package_002c-amsmath-4"></a>
+<a name="index-amsmath-package-4"></a>
+
+<a name="index-package_002c-amsthm"></a>
+<a name="index-amsthm-package"></a>
+
+<p>Most new documents use the packages <code>amsthm</code> and <code>amsmath</code>
+from the American Mathematical Society. Among other things these
+packages include a large number of options for theorem environments,
+such as styling options.
</p>
<hr>
<a name="titlepage"></a>
<div class="header">
<p>
-Next: <a href="#verbatim" accesskey="n" rel="next">verbatim</a>, Previous: <a href="#theorem" accesskey="p" rel="prev">theorem</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#verbatim" accesskey="n" rel="next">verbatim</a>, Previous: <a href="#theorem" accesskey="p" rel="prev">theorem</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="titlepage-1"></a>
<h3 class="section">8.26 <code>titlepage</code></h3>
@@ -7031,14 +8616,11 @@ Next: <a href="#verbatim" accesskey="n" rel="next">verbatim</a>, Previous: <a hr
\end{titlepage}
</pre></div>
-<p>Create a title page, a page with no printed page number or heading. The
-following page will be numbered page one.
+<p>Create a title page, a page with no printed page number or heading and
+with succeeding pages numbered starting with page one.
</p>
-<p>To instead produce a standard title page without a <code>titlepage</code>
-environment you can use <code>\maketitle</code> (see <a href="#g_t_005cmaketitle">\maketitle</a>).
-</p>
-<p>Notice in this example that all formatting, including vertical spacing,
-is left to the author.
+<p>In this example all formatting, including vertical spacing, is left to
+the author.
</p>
<div class="example">
<pre class="example">\begin{titlepage}
@@ -7063,12 +8645,15 @@ is left to the author.
\end{titlepage}
</pre></div>
+<p>To instead produce a standard title page without a <code>titlepage</code>
+environment, use <code>\maketitle</code> (see <a href="#g_t_005cmaketitle">\maketitle</a>).
+</p>
<hr>
<a name="verbatim"></a>
<div class="header">
<p>
-Next: <a href="#verse" accesskey="n" rel="next">verse</a>, Previous: <a href="#titlepage" accesskey="p" rel="prev">titlepage</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#verse" accesskey="n" rel="next">verse</a>, Previous: <a href="#titlepage" accesskey="p" rel="prev">titlepage</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="verbatim-1"></a>
<h3 class="section">8.27 <code>verbatim</code></h3>
@@ -7090,25 +8675,64 @@ Next: <a href="#verse" accesskey="n" rel="next">verse</a>, Previous: <a href="#t
\end{verbatim}
</pre></div>
-<p>The <code>verbatim</code> environment is a paragraph-making environment in
-which LaTeX produces exactly what you type in; for instance the
-<code>\</code> character produces a printed &lsquo;<samp>\</samp>&rsquo;. It turns LaTeX
-into a typewriter with carriage returns and blanks having the same
-effect that they would on a typewriter.
-</p>
-<p>The <code>verbatim</code> environment uses a monospaced typewriter-like font
+<p>A paragraph-making environment in which LaTeX produces as output
+exactly what you type as input. For instance inside <var>literal-text</var>
+the backslash&nbsp;<code>\</code> character does not start commands, it
+produces a printed &lsquo;<samp>\</samp>&rsquo;, and carriage returns and blanks are taken
+literally. The output appears in a monospaced typewriter-like font
(<code>\tt</code>).
</p>
+<div class="example">
+<pre class="example">\begin{verbatim}
+Symbol swearing: %&amp;$#?!.
+\end{verbatim}
+</pre></div>
+
+<p>The only restriction on <code>literal-text</code> is that it cannot include
+the string <code>\end{verbatim}</code>.
+</p>
+<a name="index-package_002c-cprotect"></a>
+<a name="index-cprotect-package"></a>
+
+<p>You cannot use the verbatim environment in the argument to macros, for
+instance in the argument to a <code>\section</code>. This is not the same as
+commands being fragile (see <a href="#g_t_005cprotect">\protect</a>), instead it just cannot appear
+there. (But the <code>cprotect</code> package can help with this.)
+</p>
+<a name="index-package_002c-listings-1"></a>
+<a name="index-listings-package-1"></a>
+
+<a name="index-package_002c-minted-1"></a>
+<a name="index-minted-package-1"></a>
+
+<p>One common use of verbatim input is to typeset computer code. There are
+packages that are an improvement the <code>verbatim</code> environment. For
+instance, one improvement is to allow the verbatim inclusion of external
+files, or parts of those files. Such packages include <code>listings</code>,
+and <code>minted</code>.
+</p>
+<a name="index-package_002c-fancyvrb-1"></a>
+<a name="index-fancyvrb-package-1"></a>
+
+<a name="index-package_002c-verbatimbox"></a>
+<a name="index-verbatimbox-package"></a>
+
+<p>A package that provides many more options for verbatim environments is
+<code>fancyvrb</code>. Another is <code>verbatimbox</code>.
+</p>
+<p>For a list of all the relevant packages, see CTAN.
+</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#g_t_005cverb" accesskey="1">\verb</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The macro form of the <code>verbatim</code> environment.
</td></tr>
</table>
+
<hr>
<a name="g_t_005cverb"></a>
<div class="header">
<p>
-Up: <a href="#verbatim" accesskey="u" rel="up">verbatim</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Up: <a href="#verbatim" accesskey="u" rel="up">verbatim</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cverb-1"></a>
<h4 class="subsection">8.27.1 <code>\verb</code></h4>
@@ -7119,26 +8743,73 @@ Up: <a href="#verbatim" accesskey="u" rel="up">verbatim</a> &nbsp; [<a href="#SE
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\verb<var>char</var><var>literal-text</var><var>char</var>
-\verb*<var>char</var><var>literal-text</var><var>char</var>
+<pre class="example">\verb <var>char</var> <var>literal-text</var> <var>char</var>
+\verb* <var>char</var> <var>literal-text</var> <var>char</var>
+</pre></div>
+
+<p>Typeset <var>literal-text</var> as it is input, including special characters
+and spaces, using the typewriter (<code>\tt</code>) font.
+</p>
+<p>This example shows two different invocations of <code>\verb</code>.
+</p>
+<div class="example">
+<pre class="example">This is \verb!literally! the biggest pumpkin ever.
+And this is the best squash, \verb+literally!+
</pre></div>
-<p>The <code>\verb</code> command typesets <var>literal-text</var> as it is input,
-including special characters and spaces, using the typewriter
-(<code>\tt</code>) font. No spaces are allowed between <code>\verb</code> or
-<code>\verb*</code> and the delimiter <var>char</var>, which begins and ends the
-verbatim text. The delimiter must not appear in <var>literal-text</var>.
+<p>The first <code>\verb</code> has its <var>literal-text</var> surrounded with
+exclamation point, <code>!</code>. The second instead uses plus, <code>+</code>,
+because the exclamation point is part of <code>literal-text</code>.
+</p>
+<p>The single-character delimiter <var>char</var> surrounds
+<var>literal-text</var>&nbsp;&mdash; it must be the same character before and
+after. No spaces come between <code>\verb</code> or <code>\verb*</code> and
+<var>char</var>, or between <var>char</var> and <var>literal-text</var>, or between
+<var>literal-text</var> and the second occurrence of <var>char</var> (the synopsis
+shows a space only to distinguish one component from the other). The
+delimiter must not appear in <var>literal-text</var>. The <var>literal-text</var>
+cannot include a line break.
</p>
<a name="index-visible-space"></a>
-<p>The <code>*</code>-form differs only in that spaces are printed with a
-&ldquo;visible space&rdquo; character.
+<p>The <code>*</code>-form differs only in that spaces are printed with a visible
+space character.
+</p>
+<p>The output from this will include a character showing the spaces.
+</p>
+<div class="example">
+<pre class="example">The commands's first argument is \verb*!filename with extension! and ...
+</pre></div>
+
+<a name="index-package_002c-url"></a>
+<a name="index-url-package"></a>
+
+<p>For typesetting Internet addresses, urls, the package <code>url</code>
+provides an option that is better than the <code>\verb</code> command, since
+it allows line breaks.
+</p>
+<a name="index-package_002c-listings-2"></a>
+<a name="index-listings-package-2"></a>
+
+<a name="index-package_002c-minted-2"></a>
+<a name="index-minted-package-2"></a>
+
+<p>For computer code there are many packages with advantages over
+<code>\verb</code>. One is <samp>listings</samp>, another is <samp>minted</samp>.
+</p>
+<a name="index-package_002c-cprotect-1"></a>
+<a name="index-cprotect-package-1"></a>
+
+<p>You cannot use <code>\verb</code> in the argument to a macro, for instance in
+the argument to a <code>\section</code>. It is not a question of <code>\verb</code>
+being fragile (see <a href="#g_t_005cprotect">\protect</a>), instead it just cannot appear there.
+(But the <code>cprotect</code> package can help with this.)
</p>
<hr>
<a name="verse"></a>
<div class="header">
<p>
-Previous: <a href="#verbatim" accesskey="p" rel="prev">verbatim</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#verbatim" accesskey="p" rel="prev">verbatim</a>, Up: <a href="#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="verse-1"></a>
<h3 class="section">8.28 <code>verse</code></h3>
@@ -7152,27 +8823,48 @@ Previous: <a href="#verbatim" accesskey="p" rel="prev">verbatim</a>, Up: <a href
</p>
<div class="example">
<pre class="example">\begin{verse}
-<var>line1</var> \\
-<var>line2</var> \\
-...
+ <var>line1</var> \\
+ <var>line2</var> \\
+ ...
\end{verse}
</pre></div>
-<p>The <code>verse</code> environment is designed for poetry, though you may find
-other uses for it.
+<p>An environment for poetry.
</p>
+<p>Here are two lines from Shakespeare&rsquo;s Romeo and Juliet.
+</p>
+<div class="example">
+<pre class="example">Then plainly know my heart's dear love is set \\
+On the fair daughter of rich Capulet.
+</pre></div>
+
<a name="index-_005c_005c-for-verse"></a>
-<p>The margins are indented on the left and the right, paragraphs are not
-indented, and the text is not justified. Separate the lines of each
-stanza with <code>\\</code>, and use one or more blank lines to separate the
-stanzas.
+<p>Separate the lines of each stanza with <code>\\</code>, and use one or more
+blank lines to separate the stanzas.
+</p>
+<div class="example">
+<pre class="example">\begin{verse}
+\makebox[\linewidth][c]{\textit{Shut Not Your Doors} ---Walt Whitman}
+ \\[1\baselineskip]
+Shut not your doors to me proud libraries, \\
+For that which was lacking on all your well-fill'd shelves, \\
+\qquad yet needed most, I bring, \\
+Forth from the war emerging, a book I have made, \\
+The words of my book nothing, the drift of it every thing, \\
+A book separate, not link'd with the rest nor felt by the intellect, \\
+But you ye untold latencies will thrill to every page.
+\end{verse}
+</pre></div>
+
+<p>The output has margins indented on the left and the right, paragraphs
+are not indented, and the text is not right-justified.
</p>
<hr>
<a name="Line-breaking"></a>
<div class="header">
<p>
-Next: <a href="#Page-breaking" accesskey="n" rel="next">Page breaking</a>, Previous: <a href="#Environments" accesskey="p" rel="prev">Environments</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Page-breaking" accesskey="n" rel="next">Page breaking</a>, Previous: <a href="#Environments" accesskey="p" rel="prev">Environments</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Line-breaking-1"></a>
<h2 class="chapter">9 Line breaking</h2>
@@ -7188,6 +8880,12 @@ produce a printed document, this sequence must be broken into lines
<p>LaTeX usually does the line (and page) breaking in the text body for
you but in some environments you manually force line breaks.
</p>
+<p>A common workflow is to get a final version of the document content
+before taking a final pass through and considering line breaks (and page
+breaks). This differs from word processing, where you are formatting
+text as you input it. Putting these off until the end prevents a lot of
+fiddling with breaks that will change anyway.
+</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#g_t_005c_005c" accesskey="1">\\</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Start a new line.
</td></tr>
@@ -7197,15 +8895,13 @@ you but in some environments you manually force line breaks.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#g_t_005c_002d-_0028hyphenation_0029" accesskey="4">\- (hyphenation)</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Insert explicit hyphenation.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cdiscretionary" accesskey="5">\discretionary</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Insert explicit hyphenation with control of hyphen character.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cfussy" accesskey="6">\fussy</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Be fussy about line breaking.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cdiscretionary" accesskey="5">\discretionary</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Explicit control of the hyphen character.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005csloppy" accesskey="7">\sloppy</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Be sloppy about line breaking.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cfussy-_0026-_005csloppy" accesskey="6">\fussy &amp; \sloppy</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Be more or less particular with line breaking.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005chyphenation" accesskey="8">\hyphenation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Tell LaTeX how to hyphenate a word.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005chyphenation" accesskey="7">\hyphenation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Tell LaTeX how to hyphenate a word.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005clinebreak-_0026-_005cnolinebreak" accesskey="9">\linebreak &amp; \nolinebreak</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Forcing &amp; avoiding line breaks.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005clinebreak-_0026-_005cnolinebreak" accesskey="8">\linebreak &amp; \nolinebreak</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Forcing &amp; avoiding line breaks.
</td></tr>
</table>
@@ -7214,7 +8910,7 @@ you but in some environments you manually force line breaks.
<a name="g_t_005c_005c"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cobeycr-_0026-_005crestorecr" accesskey="n" rel="next">\obeycr &amp; \restorecr</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cobeycr-_0026-_005crestorecr" accesskey="n" rel="next">\obeycr &amp; \restorecr</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005c_005c-1"></a>
<h3 class="section">9.1 <code>\\</code></h3>
@@ -7223,47 +8919,84 @@ Next: <a href="#g_t_005cobeycr-_0026-_005crestorecr" accesskey="n" rel="next">\o
<a name="index-new-line_002c-starting"></a>
<a name="index-line-break_002c-forcing"></a>
-<p>Synopsis:
+<p>Synopsis, one of:
</p>
<div class="example">
-<pre class="example">\\[<var>morespace</var>]
+<pre class="example">\\
+\\[<var>morespace</var>]
</pre></div>
-<p>or
+<p>or one of:
</p>
<div class="example">
-<pre class="example">\\*[<var>morespace</var>]
+<pre class="example">\\*
+\\*[<var>morespace</var>]
</pre></div>
-<p>Start a new line. The optional argument <var>morespace</var> specifies extra
-vertical space to be insert before the next line. This can be a
-negative length. The text before the break is set at its normal length,
-that is, it is not stretched to fill out the line width.
-</p>
-<p>Explicit line breaks in the text body are unusual in LaTeX. In
-particular, to start a new paragraph instead leave a blank line. This
-command is mostly used outside of the main flow of text such as in
-a <code>tabular</code> or <code>array</code> environment.
-</p>
-<p>Under ordinary circumstances (e.g., outside of a <code>p{...}</code> column
-in a <code>tabular</code> environment) the <code>\newline</code> command is a synonym for
-<code>\\</code> (see <a href="#g_t_005cnewline">\newline</a>).
+<p>End the current line. The optional argument <var>morespace</var> specifies
+extra vertical space to be inserted before the next line. This is a
+rubber length (see <a href="#Lengths">Lengths</a>) and can be negative. The text before
+the line break is set at its normal length, that is, it is not stretched
+to fill out the line width. This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
</p>
-<p>In addition to starting a new line, the starred form <code>\\*</code> tells
-LaTeX not to start a new page between the two lines, by issuing a
-<code>\nobreak</code>.
+<p>The starred form, <code>\\*</code>, tells LaTeX not to start a new page
+between the two lines, by issuing a <code>\nobreak</code>.
</p>
<div class="example">
<pre class="example">\title{My story: \\[0.25in]
a tale of woe}
</pre></div>
+<p>Explicit line breaks in the main text body are unusual in LaTeX. In
+particular, don&rsquo;t start new paragraphs with <code>\\</code>. Instead leave a
+blank line between the two paragraphs. And don&rsquo;t put in a sequence of
+<code>\\</code>&rsquo;s to make vertical space. Instead use
+<code>\vspace{<var>length</var>}</code>, or
+<code>\leavevmode\vspace{<var>length</var>}</code>, or
+<code>\vspace*{<var>length</var>}</code> if you want the space to not be thrown
+out at the top of a new page (see <a href="#g_t_005cvspace">\vspace</a>).
+</p>
+<p>The <code>\\</code> command is mostly used outside of the main flow of text
+such as in a <code>tabular</code> or <code>array</code> environment or in an
+equation environment.
+</p>
+<p>The <code>\\</code> command is a synonym for <code>\newline</code>
+(see <a href="#g_t_005cnewline">\newline</a>) under ordinary circumstances (an example of an
+exception is the <code>p{...}</code> column in a <code>tabular</code>
+environment; see <a href="#tabular">tabular</a>).
+</p>
+<p>The <code>\\</code> command is a macro, and its definition changes by context
+so that its definition in normal text, a <code>center</code> environment, a
+<code>flushleft</code> environment, and a <code>tabular</code> are all different.
+In normal text when it forces a linebreak it is essentially a shorthand
+for <code>\newline</code>. It does not end horizontal mode or end the
+paragraph, it just inserts some glue and penalties so that when the
+paragraph does end a linebreak will occur at that point, with the short
+line padded with white space.
+</p>
+<p>You get &lsquo;<samp>LaTeX Error: There's no line here to end</samp>&rsquo; if you use
+<code>\\</code> to ask for a new line, rather than to end the current line.
+An example is if you have <code>\begin{document}\\</code> or, more likely,
+something like this.
+</p>
+<div class="example">
+<pre class="example">\begin{center}
+ \begin{minipage}{0.5\textwidth}
+ \\
+ In that vertical space put your mark.
+ \end{minipage}
+\end{center}
+</pre></div>
+
+<p>Fix it by replacing the double backslash with something like
+<code>\vspace{\baselineskip}</code>.
+</p>
<hr>
<a name="g_t_005cobeycr-_0026-_005crestorecr"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cnewline" accesskey="n" rel="next">\newline</a>, Previous: <a href="#g_t_005c_005c" accesskey="p" rel="prev">\\</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cnewline" accesskey="n" rel="next">\newline</a>, Previous: <a href="#g_t_005c_005c" accesskey="p" rel="prev">\\</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cobeycr-_0026-_005crestorecr-1"></a>
<h3 class="section">9.2 <code>\obeycr</code> &amp; <code>\restorecr</code></h3>
@@ -7272,19 +9005,53 @@ Next: <a href="#g_t_005cnewline" accesskey="n" rel="next">\newline</a>, Previous
<a name="index-_005crestorecr"></a>
<a name="index-new-line_002c-output-as-input"></a>
-<p>The <code>\obeycr</code> command makes a return in the input file
-(&lsquo;<samp>^^M</samp>&rsquo;, internally) the same as <code>\\</code> (followed by
-<code>\relax</code>). So each new line in the input will also be a new line
-in the output.
+<p>The <code>\obeycr</code> command makes a return in the input file (&lsquo;<samp>^^M</samp>&rsquo;,
+internally) the same as <code>\\</code>, followed by <code>\relax</code>. So each
+new line in the input will also be a new line in the output. The
+<code>\restorecr</code> command restores normal line-breaking behavior.
+</p>
+<p>This is not the way to show verbatim text or computer code.
+See <a href="#verbatim">verbatim</a> instead.
+</p>
+<p>With LaTeX&rsquo;s usual defaults, this
+</p>
+<div class="example">
+<pre class="example">aaa
+bbb
+
+\obeycr
+ccc
+ddd
+ eee
+
+\restorecr
+fff
+ggg
+
+hhh
+iii
+</pre></div>
+
+<p>produces output like this.
</p>
-<p><code>\restorecr</code> restores normal line-breaking behavior.
+<div class="example">
+<pre class="example"> aaa bbb
+ ccc
+ddd
+eee
+
+fff ggg
+ hhh iii
+</pre></div>
+
+<p>The indents are paragraph indents.
</p>
<hr>
<a name="g_t_005cnewline"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005c_002d-_0028hyphenation_0029" accesskey="n" rel="next">\- (hyphenation)</a>, Previous: <a href="#g_t_005cobeycr-_0026-_005crestorecr" accesskey="p" rel="prev">\obeycr &amp; \restorecr</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005c_002d-_0028hyphenation_0029" accesskey="n" rel="next">\- (hyphenation)</a>, Previous: <a href="#g_t_005cobeycr-_0026-_005crestorecr" accesskey="p" rel="prev">\obeycr &amp; \restorecr</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cnewline-1"></a>
<h3 class="section">9.3 <code>\newline</code></h3>
@@ -7292,14 +9059,18 @@ Next: <a href="#g_t_005c_002d-_0028hyphenation_0029" accesskey="n" rel="next">\-
<a name="index-_005cnewline"></a>
<a name="index-new-line_002c-starting-_0028paragraph-mode_0029"></a>
-<p>In ordinary text this is equivalent to double-backslash (see <a href="#g_t_005c_005c">\\</a>); it
-breaks a line, with no stretching of the text before it.
+<p>In ordinary text, this ends a line in a way that does not right-justify
+the line, so the prior text is not stretched. That is, in paragraph mode
+(see <a href="#Modes">Modes</a>), the <code>\newline</code> command is equivalent to
+double-backslash (see <a href="#g_t_005c_005c">\\</a>). This command is fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
</p>
-<p>Inside a <code>tabular</code> or <code>array</code> environment, in a column with a
-specifier producing a paragraph box, like typically <code>p{...}</code>,
-<code>\newline</code> will insert a line break inside of the column, that is,
-it does not break the entire row. To break the entire row use <code>\\</code>
-or its equivalent <code>\tabularnewline</code>.
+<p>However, the two commands are different inside a <code>tabular</code> or
+<code>array</code> environment. In a column with a specifier producing a
+paragraph box such as typically <code>p{...}</code>, <code>\newline</code> will
+insert a line end inside of the column; that is, it does not break the
+entire tabular row. To break the entire row use <code>\\</code> or its
+equivalent <code>\tabularnewline</code>.
</p>
<p>This will print &lsquo;<samp>Name:</samp>&rsquo; and &lsquo;<samp>Address:</samp>&rsquo; as two lines in a
single cell of the table.
@@ -7317,7 +9088,7 @@ single cell of the table.
<a name="g_t_005c_002d-_0028hyphenation_0029"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cdiscretionary" accesskey="n" rel="next">\discretionary</a>, Previous: <a href="#g_t_005cnewline" accesskey="p" rel="prev">\newline</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cdiscretionary" accesskey="n" rel="next">\discretionary</a>, Previous: <a href="#g_t_005cnewline" accesskey="p" rel="prev">\newline</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005c_002d-_0028discretionary-hyphen_0029"></a>
<h3 class="section">9.4 <code>\-</code> (discretionary hyphen)</h3>
@@ -7325,21 +9096,46 @@ Next: <a href="#g_t_005cdiscretionary" accesskey="n" rel="next">\discretionary</
<a name="index-_005c_002d-_0028hyphenation_0029"></a>
<a name="index-hyphenation_002c-forcing"></a>
-<p>The <code>\-</code> command tells LaTeX that it may hyphenate the word at
-that point. LaTeX is pretty good at hyphenating, and usually finds
-most of the correct hyphenation points, while almost never using an
-incorrect one. The <code>\-</code> command is used for the exceptional
-cases.
+<p>Tell LaTeX that it may hyphenate the word at that point. When you
+insert <code>\-</code> commands in a word, the word will only be hyphenated at
+those points and not at any of the hyphenation points that LaTeX
+might otherwise have chosen. This command is robust (see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>LaTeX is good at hyphenating and usually finds most of the correct
+hyphenation points, while almost never using an incorrect one. The
+<code>\-</code> command is for exceptional cases.
</p>
-<p>When you insert <code>\-</code> commands in a word, the word will only be
-hyphenated at those points and not at any of the hyphenation points
-that LaTeX might otherwise have chosen.
+<p>For example, LaTeX does not ordinarily hyphenate words containing a
+hyphen. Below, the long and hyphenated word means LaTeX has to put
+in unacceptably large spaces to set the narrow column.
</p>
+<div class="example">
+<pre class="example">\begin{tabular}{rp{1.75in}}
+ Isaac Asimov &amp;The strain of
+ anti-intellectualism
+ % an\-ti-in\-tel\-lec\-tu\-al\-ism
+ has been a constant thread winding its way through our
+ political and cultural life, nurtured by
+ the false notion that democracy means that
+ `my ignorance is just as good as your knowledge'.
+\end{tabular}
+</pre></div>
+
+<p>Commenting out the third line and uncommenting the fourth makes a much
+better fit.
+</p>
+<p>The <code>\-</code> command only allows LaTeX to break there, it does not
+require that it break there. You can insist on a split with something
+like <code>Hef-\linebreak feron</code>. Of course, if you later change the
+text then this forced break may look very odd, so this approach requires
+care.
+</p>
+
<hr>
<a name="g_t_005cdiscretionary"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cfussy" accesskey="n" rel="next">\fussy</a>, Previous: <a href="#g_t_005c_002d-_0028hyphenation_0029" accesskey="p" rel="prev">\- (hyphenation)</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cfussy-_0026-_005csloppy" accesskey="n" rel="next">\fussy &amp; \sloppy</a>, Previous: <a href="#g_t_005c_002d-_0028hyphenation_0029" accesskey="p" rel="prev">\- (hyphenation)</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cdiscretionary-_0028generalized-hyphenation-point_0029"></a>
<h3 class="section">9.5 <code>\discretionary</code> (generalized hyphenation point)</h3>
@@ -7349,55 +9145,108 @@ Next: <a href="#g_t_005cfussy" accesskey="n" rel="next">\fussy</a>, Previous: <a
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\discretionary{<var>pre-break-text</var>}{<var>post-break-text</var>}{<var>no-break-text</var>}
+<pre class="example">\discretionary{<var>pre-break</var>}{<var>post-break</var>}{<var>no-break</var>}
</pre></div>
+<p>Handle word changes around hyphens. This command is not often used in
+LaTeX documents.
+</p>
+<p>If a line break occurs at the point where <code>\discretionary</code> appears
+then TeX puts <var>pre-break</var> at the end of the current line and puts
+<var>post-break</var> at the start of the next line. If there is no line
+break here then TeX puts <var>no-break</var>
+</p>
+<p>In &lsquo;<samp>difficult</samp>&rsquo; the three letters <code>ffi</code> form a ligature. But
+TeX can nonetheless break between the two f&rsquo;s with this.
+</p>
+<div class="example">
+<pre class="example">di\discretionary{f-}{fi}{ffi}cult
+</pre></div>
+
+<p>Note that users do not have to do this. It is typically handled
+automatically by TeX&rsquo;s hyphenation algorithm.
+</p>
<hr>
-<a name="g_t_005cfussy"></a>
+<a name="g_t_005cfussy-_0026-_005csloppy"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005csloppy" accesskey="n" rel="next">\sloppy</a>, Previous: <a href="#g_t_005cdiscretionary" accesskey="p" rel="prev">\discretionary</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005chyphenation" accesskey="n" rel="next">\hyphenation</a>, Previous: <a href="#g_t_005cdiscretionary" accesskey="p" rel="prev">\discretionary</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cfussy-1"></a>
-<h3 class="section">9.6 <code>\fussy</code></h3>
+<a name="g_t_005cfussy-_0026-_005csloppy-1"></a>
+<h3 class="section">9.6 <code>\fussy</code> &amp; <code>\sloppy</code></h3>
<a name="index-_005cfussy"></a>
+<a name="index-_005csloppy"></a>
+<a name="index-line-breaks_002c-changing"></a>
-<p>The declaration <code>\fussy</code> (which is the default) makes TeX
-picky about line breaking. This usually avoids too much space between
-words, at the cost of an occasional overfull box.
+<p>Declarations to make TeX more picky or less picky about line
+breaking. Declaring <code>\fussy</code> usually avoids too much space between
+words, at the cost of an occasional overfull box. Conversely,
+<code>\sloppy</code> avoids overfull boxes while suffering loose interword
+spacing.
</p>
-<p>This command cancels the effect of a previous <code>\sloppy</code> command
-(see <a href="#g_t_005csloppy">\sloppy</a>).
+<p>The default is <code>\fussy</code>. Line breaking in a paragraph is
+controlled by whichever declaration is current at the blank line, or
+<code>\par</code>, or displayed equation ending that paragraph. So to affect
+the line breaks, include that paragraph-ending material in the scope of
+the command.
</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">&bull; <a href="#sloppypar" accesskey="1">sloppypar</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Environment version of \sloppy command.
+</td></tr>
+</table>
+
<hr>
-<a name="g_t_005csloppy"></a>
+<a name="sloppypar"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005chyphenation" accesskey="n" rel="next">\hyphenation</a>, Previous: <a href="#g_t_005cfussy" accesskey="p" rel="prev">\fussy</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Up: <a href="#g_t_005cfussy-_0026-_005csloppy" accesskey="u" rel="up">\fussy &amp; \sloppy</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005csloppy-1"></a>
-<h3 class="section">9.7 <code>\sloppy</code></h3>
+<a name="sloppypar-1"></a>
+<h4 class="subsection">9.6.1 <code>sloppypar</code></h4>
-<a name="index-_005csloppy"></a>
+<a name="index-sloppypar"></a>
+<a name="index-sloppypar-environment"></a>
-<p>The declaration <code>\sloppy</code> makes TeX less fussy about line
-breaking. This will avoid overfull boxes, at the cost of loose
-interword spacing.
+<p>Synopsis:
</p>
-<p>Lasts until a <code>\fussy</code> command is issued (see <a href="#g_t_005cfussy">\fussy</a>).
+<div class="example">
+<pre class="example">\begin{sloppypar}
+ ... paragraphs ...
+\end{sloppypar}
+</pre></div>
+
+<p>Typeset the paragraphs with <code>\sloppy</code> in effect (see <a href="#g_t_005cfussy-_0026-_005csloppy">\fussy &amp; \sloppy</a>). Use this to locally adjust line breaking, to avoid
+&lsquo;<samp>Overfull box</samp>&rsquo; or &lsquo;<samp>Underfull box</samp>&rsquo; errors.
</p>
+<p>The example is simple.
+</p>
+<div class="example">
+<pre class="example">\begin{sloppypar}
+ Her plan for the morning thus settled, she sat quietly down to her
+ book after breakfast, resolving to remain in the same place and the
+ same employment till the clock struck one; and from habitude very
+ little incommoded by the remarks and ejaculations of Mrs.\ Allen,
+ whose vacancy of mind and incapacity for thinking were such, that
+ as she never talked a great deal, so she could never be entirely
+ silent; and, therefore, while she sat at her work, if she lost her
+ needle or broke her thread, if she heard a carriage in the street,
+ or saw a speck upon her gown, she must observe it aloud, whether
+ there were anyone at leisure to answer her or not.
+\end{sloppypar}
+</pre></div>
+
<hr>
<a name="g_t_005chyphenation"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005clinebreak-_0026-_005cnolinebreak" accesskey="n" rel="next">\linebreak &amp; \nolinebreak</a>, Previous: <a href="#g_t_005csloppy" accesskey="p" rel="prev">\sloppy</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005clinebreak-_0026-_005cnolinebreak" accesskey="n" rel="next">\linebreak &amp; \nolinebreak</a>, Previous: <a href="#g_t_005cfussy-_0026-_005csloppy" accesskey="p" rel="prev">\fussy &amp; \sloppy</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005chyphenation-1"></a>
-<h3 class="section">9.8 <code>\hyphenation</code></h3>
+<h3 class="section">9.7 <code>\hyphenation</code></h3>
<a name="index-_005chyphenation"></a>
<a name="index-hyphenation_002c-defining"></a>
@@ -7405,57 +9254,79 @@ Next: <a href="#g_t_005clinebreak-_0026-_005cnolinebreak" accesskey="n" rel="nex
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\hyphenation{<var>word-one</var> <var>word-two</var>}
+<pre class="example">\hyphenation{<var>word1</var> ...}
</pre></div>
-<p>The <code>\hyphenation</code> command declares allowed hyphenation points
-with a <code>-</code> character in the given words. The words are separated
-by spaces. TeX will only hyphenate if the word matches exactly, no
-inflections are tried. Multiple <code>\hyphenation</code> commands
-accumulate. Some examples (the default TeX hyphenation patterns
-misses the hyphenations in these words):
+<p>Declares allowed hyphenation points within the words in the list. The
+words in that list are separated by spaces. Show permitted points for
+hyphenation with a dash character, <code>-</code>.
+</p>
+<p>Here is an example:
</p>
<div class="example">
-<pre class="example">\hyphenation{ap-pen-dix col-umns data-base data-bases}
+<pre class="example">\hyphenation{hat-er il-lit-e-ra-ti tru-th-i-ness}
</pre></div>
+<p>Use lowercase letters. TeX will only hyphenate if the word matches
+exactly. Multiple <code>\hyphenation</code> commands accumulate.
+</p>
<hr>
<a name="g_t_005clinebreak-_0026-_005cnolinebreak"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005chyphenation" accesskey="p" rel="prev">\hyphenation</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005chyphenation" accesskey="p" rel="prev">\hyphenation</a>, Up: <a href="#Line-breaking" accesskey="u" rel="up">Line breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005clinebreak-_0026-_005cnolinebreak-1"></a>
-<h3 class="section">9.9 <code>\linebreak</code> &amp; <code>\nolinebreak</code></h3>
+<h3 class="section">9.8 <code>\linebreak</code> &amp; <code>\nolinebreak</code></h3>
<a name="index-_005clinebreak"></a>
<a name="index-_005cnolinebreak"></a>
<a name="index-line-breaks_002c-forcing"></a>
<a name="index-line-breaks_002c-preventing"></a>
-<p>Synopses:
+<p>Synopses, one of:
</p>
<div class="example">
-<pre class="example">\linebreak[<var>priority</var>]
-\nolinebreak[<var>priority</var>]
+<pre class="example">\linebreak
+\linebreak[<var>zero-to-four</var>]
</pre></div>
-<p>By default, the <code>\linebreak</code> (<code>\nolinebreak</code>) command forces
-(prevents) a line break at the current position. For
-<code>\linebreak</code>, the spaces in the line are stretched out so that it
-extends to the right margin as usual.
+<p>or one of these.
</p>
-<p>With the optional argument <var>priority</var>, you can convert the command
-from a demand to a request. The <var>priority</var> must be a number from
-0 to&nbsp;4. The higher the number, the more insistent the request.
+<div class="example">
+<pre class="example">\nolinebreak
+\nolinebreak[<var>zero-to-four</var>]
+</pre></div>
+
+<p>Encourage or discourage a line break. The optional <var>zero-to-four</var>
+is an integer that allows you to soften the instruction. The default is
+4, so that without the optional argument these commands entirely force
+or prevent the break. But for instance, <code>\nolinebreak[1]</code> is a
+suggestion that another place may be better. The higher the number, the
+more insistent the request. Both commands are fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>Here we tell LaTeX that a good place to put a linebreak is after the
+standard legal text.
</p>
+<div class="example">
+<pre class="example">\boilerplatelegal{} \linebreak[2]
+We especially encourage applications from members of traditionally
+underrepresented groups.
+</pre></div>
+
+<p>When you issue <code>\linebreak</code>, the spaces in the line are stretched
+out so that it extends to the right margin. See <a href="#g_t_005c_005c">\\</a>
+and&nbsp;<a href="#g_t_005cnewline">\newline</a> to have the spaces not stretched out.
+</p>
+
<hr>
<a name="Page-breaking"></a>
<div class="header">
<p>
-Next: <a href="#Footnotes" accesskey="n" rel="next">Footnotes</a>, Previous: <a href="#Line-breaking" accesskey="p" rel="prev">Line breaking</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Footnotes" accesskey="n" rel="next">Footnotes</a>, Previous: <a href="#Line-breaking" accesskey="p" rel="prev">Line breaking</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Page-breaking-1"></a>
<h2 class="chapter">10 Page breaking</h2>
@@ -7463,111 +9334,204 @@ Next: <a href="#Footnotes" accesskey="n" rel="next">Footnotes</a>, Previous: <a
<a name="index-page-breaking"></a>
<a name="index-breaking-pages"></a>
-<p>LaTeX starts new pages asynchronously, when enough material has
-accumulated to fill up a page. Usually this happens automatically,
-but sometimes you may want to influence the breaks.
+<p>Ordinarily LaTeX automatically takes care of breaking output into
+pages with its usual aplomb. But if you are writing commands, or
+tweaking the final version of a document, then you may need to
+understand how to influence its actions.
+</p>
+<p>LaTeX&rsquo;s algorithm for splitting a document into pages is more complex
+than just waiting until there is enough material to fill a page and
+outputting the result. Instead, LaTeX typesets more material than
+would fit on the page and then chooses a break that is optimal in some
+way (it has the smallest badness). An example of the advantage of this
+approach is that if the page has some vertical space that can be
+stretched or shrunk, such as with rubber lengths between paragraphs,
+then LaTeX can use that to avoid widow lines (where a new page starts
+with the last line of a paragraph; LaTeX can squeeze the extra line
+onto the first page) and orphans (where the first line of paragraph is
+at the end of a page; LaTeX can stretch the material of the first
+page so the extra line falls on the second page). Another example is
+where LaTeX uses available vertical shrinkage to fit on a page not
+just the header for a new section but also the first two lines of that
+section.
+</p>
+<p>But LaTeX does not optimize over the entire document&rsquo;s set of page
+breaks. So it can happen that the first page break is great but the
+second one is lousy; to break the current page LaTeX doesn&rsquo;t look as
+far ahead as the next page break. So occasionally you may want to
+influence page breaks while preparing a final version of a document.
+</p>
+<p>See <a href="#Layout">Layout</a> for more material that is relevant to page breaking.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005ccleardoublepage" accesskey="1">\cleardoublepage</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Start a new right-hand page.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cclearpage-_0026-_005ccleardoublepage" accesskey="1">\clearpage &amp; \cleardoublepage</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Start a new page; eject floats.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cclearpage" accesskey="2">\clearpage</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Start a new page.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cnewpage" accesskey="2">\newpage</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Start a new page.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cnewpage" accesskey="3">\newpage</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Start a new page.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cenlargethispage" accesskey="3">\enlargethispage</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Enlarge the current page a bit.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cenlargethispage" accesskey="4">\enlargethispage</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Enlarge the current page a bit.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cpagebreak-_0026-_005cnopagebreak" accesskey="5">\pagebreak &amp; \nopagebreak</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Forcing &amp; avoiding page breaks.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cpagebreak-_0026-_005cnopagebreak" accesskey="4">\pagebreak &amp; \nopagebreak</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Forcing &amp; avoiding page breaks.
</td></tr>
</table>
<hr>
-<a name="g_t_005ccleardoublepage"></a>
+<a name="g_t_005cclearpage-_0026-_005ccleardoublepage"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cclearpage" accesskey="n" rel="next">\clearpage</a>, Up: <a href="#Page-breaking" accesskey="u" rel="up">Page breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cnewpage" accesskey="n" rel="next">\newpage</a>, Up: <a href="#Page-breaking" accesskey="u" rel="up">Page breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005ccleardoublepage-1"></a>
-<h3 class="section">10.1 <code>\cleardoublepage</code></h3>
+<a name="g_t_005cclearpage-_0026-_005ccleardoublepage-1"></a>
+<h3 class="section">10.1 <code>\clearpage</code> &amp; <code>\cleardoublepage</code></h3>
+<a name="index-_005cclearpage"></a>
+<a name="index-flushing-floats-and-starting-a-page"></a>
+<a name="index-starting-a-new-page-and-clearing-floats"></a>
<a name="index-_005ccleardoublepage"></a>
<a name="index-starting-on-a-right_002dhand-page"></a>
-<p>The <code>\cleardoublepage</code> command ends the current page and causes all
-the pending floating figures and tables that have so far appeared in the
-input to be printed. In a two-sided printing style, it also makes the
-next page a right-hand (odd-numbered) page, producing a blank page if
-necessary.
+<p>Synopsis:
</p>
+<div class="example">
+<pre class="example">\clearpage
+</pre></div>
-<hr>
-<a name="g_t_005cclearpage"></a>
-<div class="header">
-<p>
-Next: <a href="#g_t_005cnewpage" accesskey="n" rel="next">\newpage</a>, Previous: <a href="#g_t_005ccleardoublepage" accesskey="p" rel="prev">\cleardoublepage</a>, Up: <a href="#Page-breaking" accesskey="u" rel="up">Page breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="g_t_005cclearpage-1"></a>
-<h3 class="section">10.2 <code>\clearpage</code></h3>
+<p>or
+</p>
+<div class="example">
+<pre class="example">\cleardoublepage
+</pre></div>
-<a name="index-_005cclearpage"></a>
-<a name="index-flushing-floats-and-starting-a-page"></a>
-<a name="index-starting-a-new-page-and-clearing-floats"></a>
+<p>End the current page and output all of the pending floating figures and
+tables (see <a href="#Floats">Floats</a>). If there are too many floats to fit on the
+page then LaTeX will put in extra pages containing only floats. In
+two-sided printing, <code>\cleardoublepage</code> also makes the next page of
+content a right-hand page, an odd-numbered page, if necessary inserting
+a blank page. The <code>\clearpage</code> command is robust while
+<code>\cleardoublepage</code> is fragile (see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>LaTeX&rsquo;s page breaks are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+</p>
+<p>The <code>\cleardoublepage</code> command will put in a blank page, but it
+will have the running headers and footers. To get a really blank
+page, use this command.
+</p>
+<div class="example">
+<pre class="example">\let\origdoublepage\cleardoublepage
+\newcommand{\clearemptydoublepage}{%
+ \clearpage
+ {\pagestyle{empty}\origdoublepage}%
+}
+</pre></div>
-<p>The <code>\clearpage</code> command ends the current page and causes all the
-pending floating figures and tables that have so far appeared in the
-input to be printed.
+<p>If you want LaTeX&rsquo;s standard <code>\chapter</code> command to do this then
+add the line <code>\let\cleardoublepage\clearemptydoublepage</code>.
</p>
+<p>The command <code>\newpage</code> (see <a href="#g_t_005cnewpage">\newpage</a>) also ends the current
+page, but without clearing pending floats. And, if LaTeX is in
+two-column mode then <code>\newpage</code> ends the current column while
+<code>\clearpage</code> and <code>\cleardoublepage</code> end the current page.
+</p>
+
<hr>
<a name="g_t_005cnewpage"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cenlargethispage" accesskey="n" rel="next">\enlargethispage</a>, Previous: <a href="#g_t_005cclearpage" accesskey="p" rel="prev">\clearpage</a>, Up: <a href="#Page-breaking" accesskey="u" rel="up">Page breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cenlargethispage" accesskey="n" rel="next">\enlargethispage</a>, Previous: <a href="#g_t_005cclearpage-_0026-_005ccleardoublepage" accesskey="p" rel="prev">\clearpage &amp; \cleardoublepage</a>, Up: <a href="#Page-breaking" accesskey="u" rel="up">Page breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cnewpage-1"></a>
-<h3 class="section">10.3 <code>\newpage</code></h3>
+<h3 class="section">10.2 <code>\newpage</code></h3>
<a name="index-_005cnewpage"></a>
<a name="index-new-page_002c-starting"></a>
<a name="index-starting-a-new-page"></a>
-<p>The <code>\newpage</code> command ends the current page, but does not clear
-floats (see <a href="#g_t_005cclearpage">\clearpage</a>).
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\newpage
+</pre></div>
+
+<p>End the current page. This command is robust (see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>LaTeX&rsquo;s page breaks are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+</p>
+<p>While the commands <code>\clearpage</code> and <code>\cleardoublepage</code> also
+end the current page, in addition they clear pending floats
+(see <a href="#g_t_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</a>). And, if LaTeX is in
+two-column mode then <code>\clearpage</code> and <code>\cleardoublepage</code> end
+the current page, possibly leaving an empty column, while
+<code>\newpage</code> only ends the current column.
+</p>
+<p>In contrast with <code>\pagebreak</code> (see <a href="#g_t_005cpagebreak-_0026-_005cnopagebreak">\pagebreak &amp; \nopagebreak</a>),
+the <code>\newpage</code> command will cause the new page to start right where
+requested. This
+</p>
+<div class="example">
+<pre class="example">Four score and seven years ago our fathers brought forth on this
+continent,
+\newpage
+\noindent a new nation, conceived in Liberty, and dedicated to the
+proposition that all men are created equal.
+</pre></div>
+
+<p>makes a new page start after &lsquo;<samp>continent,</samp>&rsquo; and the cut-off line is
+not right justified. In addition, <code>\newpage</code> does not vertically
+stretch out the page, as <code>\pagebreak</code> does.
</p>
<hr>
<a name="g_t_005cenlargethispage"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cpagebreak-_0026-_005cnopagebreak" accesskey="n" rel="next">\pagebreak &amp; \nopagebreak</a>, Previous: <a href="#g_t_005cnewpage" accesskey="p" rel="prev">\newpage</a>, Up: <a href="#Page-breaking" accesskey="u" rel="up">Page breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cpagebreak-_0026-_005cnopagebreak" accesskey="n" rel="next">\pagebreak &amp; \nopagebreak</a>, Previous: <a href="#g_t_005cnewpage" accesskey="p" rel="prev">\newpage</a>, Up: <a href="#Page-breaking" accesskey="u" rel="up">Page breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cenlargethispage-1"></a>
-<h3 class="section">10.4 <code>\enlargethispage</code></h3>
+<h3 class="section">10.3 <code>\enlargethispage</code></h3>
<a name="index-_005cenlargethispage"></a>
<a name="index-enlarge-current-page"></a>
-<p><code>\enlargethispage{size}</code>
+<p>Synopsis, one of:
</p>
-<p><code>\enlargethispage*{size}</code>
+<div class="example">
+<pre class="example">\enlargethispage{size}
+\enlargethispage*{size}
+</pre></div>
+
+<p>Enlarge the <code>\textheight</code> for the current page. The required
+argument <var>size</var> must be a rigid length (see <a href="#Lengths">Lengths</a>). It may be
+positive or negative. This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
</p>
-<p>Enlarge the <code>\textheight</code> for the current page by the specified
-amount; e.g., <code>\enlargethispage{\baselineskip}</code> will allow one
-additional line.
+<p>A common strategy is to wait until you have the final text of a
+document, and then pass through it tweaking line and page breaks. This
+command allows you some page size leeway.
</p>
-<p>The starred form tries to squeeze the material together on the page as
-much as possible. This is normally used together with an explicit
-<code>\pagebreak</code>.
+<p>This will allow one extra line on the current page.
+</p>
+<div class="example">
+<pre class="example">\enlargethispage{\baselineskip}
+</pre></div>
+
+<p>The starred form <code>\enlargesthispage*</code> tries to squeeze the material
+together on the page as much as possible, for the common use case of
+getting one more line on the page. This is often used together with an
+explicit <code>\pagebreak</code>.
</p>
<hr>
<a name="g_t_005cpagebreak-_0026-_005cnopagebreak"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cenlargethispage" accesskey="p" rel="prev">\enlargethispage</a>, Up: <a href="#Page-breaking" accesskey="u" rel="up">Page breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cenlargethispage" accesskey="p" rel="prev">\enlargethispage</a>, Up: <a href="#Page-breaking" accesskey="u" rel="up">Page breaking</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cpagebreak-_0026-_005cnopagebreak-1"></a>
-<h3 class="section">10.5 <code>\pagebreak</code> &amp; <code>\nopagebreak</code></h3>
+<h3 class="section">10.4 <code>\pagebreak</code> &amp; <code>\nopagebreak</code></h3>
<a name="index-_005cpagebreak"></a>
<a name="index-_005cnopagebreak"></a>
@@ -7577,49 +9541,79 @@ Previous: <a href="#g_t_005cenlargethispage" accesskey="p" rel="prev">\enlargeth
<p>Synopses:
</p>
<div class="example">
-<pre class="example">\pagebreak[<var>priority</var>]
-\nopagebreak[<var>priority</var>]
+<pre class="example">\pagebreak
+\pagebreak[<var>zero-to-four</var>]
+</pre></div>
+
+<p>or
+</p>
+<div class="example">
+<pre class="example">\nopagebreak
+\nopagebreak[<var>zero-to-four</var>]
</pre></div>
-<p>By default, the <code>\pagebreak</code> (<code>\nopagebreak</code>) command forces
-(prevents) a page break at the current position. With
-<code>\pagebreak</code>, the vertical space on the page is stretched out
-where possible so that it extends to the normal bottom margin.
+<p>Encourage or discourage a page break. The optional <var>zero-to-four</var>
+is an integer that allows you to soften the request. The default is 4,
+so that without the optional argument these commands entirely force or
+prevent the break. But for instance <code>\nopagebreak[1]</code> suggests to
+LaTeX that another spot might be preferable. The higher the number,
+the more insistent the request. Both commands are fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
</p>
-<p>With the optional argument <var>priority</var>, you can convert the
-<code>\pagebreak</code> command from a demand to a request. The number must
-be a number from 0 to&nbsp;4. The higher the number, the more
-insistent the request is.
+<p>LaTeX&rsquo;s page endings are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+</p>
+<p>If you use these inside a paragraph, they apply to the point following
+the line in which they appear. So this
+</p>
+<div class="example">
+<pre class="example">Four score and seven years ago our fathers brought forth on this
+continent,
+\pagebreak
+a new nation, conceived in Liberty, and dedicated to the proposition
+that all men are created equal.
+</pre></div>
+
+<p>does not give a page break at &lsquo;<samp>continent,</samp>&rsquo; but instead at
+&lsquo;<samp>nation,</samp>&rsquo; since that is where LaTeX breaks that line. In
+addition, with <code>\pagebreak</code> the vertical space on the page is
+stretched out where possible so that it extends to the normal bottom
+margin. This can look strange, and if <code>\flushbottom</code> is in effect
+this can cause you to get &lsquo;<samp>Underfull \vbox (badness 10000) has
+occurred while \output is active</samp>&rsquo;. See <a href="#g_t_005cnewpage">\newpage</a> for a command that
+does not have these effects.
</p>
<hr>
<a name="Footnotes"></a>
<div class="header">
<p>
-Next: <a href="#Definitions" accesskey="n" rel="next">Definitions</a>, Previous: <a href="#Page-breaking" accesskey="p" rel="prev">Page breaking</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Definitions" accesskey="n" rel="next">Definitions</a>, Previous: <a href="#Page-breaking" accesskey="p" rel="prev">Page breaking</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Footnotes-1"></a>
<h2 class="chapter">11 Footnotes</h2>
<a name="index-footnotes_002c-creating"></a>
-<p>Place a numbered footnote at the bottom of the current page, as here.
+<p>Place a footnote at the bottom of the current page, as here.
</p>
<div class="example">
<pre class="example">No&euml;l Coward quipped that having to read a footnote is like having
to go downstairs to answer the door, while in the midst of making
-love.\footnote{I wouldn't know, I don't read footnotes.}
+love.\footnote{%
+ I wouldn't know, I don't read footnotes.}
</pre></div>
-<p>You can place multiple footnotes on a page. If the text becomes too long
-it will flow to the next page.
+<p>You can put multiple footnotes on a page. If the footnote text becomes
+too long then it will flow to the next page.
</p>
<p>You can also produce footnotes by combining the <code>\footnotemark</code> and
the <code>\footnotetext</code> commands, which is useful in special
circumstances.
</p>
<p>To make bibliographic references come out as footnotes you need to
-include a bibliographic style with that behavior.
+include a bibliographic style with that behavior (see <a href="#Using-BibTeX">Using BibTeX</a>).
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#g_t_005cfootnote" accesskey="1">\footnote</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Insert a footnote.
@@ -7628,16 +9622,12 @@ include a bibliographic style with that behavior.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#g_t_005cfootnotetext" accesskey="3">\footnotetext</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Insert footnote text only.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Footnotes-in-a-table" accesskey="4">Footnotes in a table</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Table footnotes.
+<tr><td align="left" valign="top">&bull; <a href="#Footnotes-in-section-headings" accesskey="4">Footnotes in section headings</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Chapter or section titles.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Footnotes-in-section-headings" accesskey="5">Footnotes in section headings</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Chapter or section titles.
+<tr><td align="left" valign="top">&bull; <a href="#Footnotes-in-a-table" accesskey="5">Footnotes in a table</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Table footnotes.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Footnotes-of-footnotes" accesskey="6">Footnotes of footnotes</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Multiple classes of footnotes.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Multiple-reference-to-footnotes" accesskey="7">Multiple reference to footnotes</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Referring to a footnote more than once.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Footnote-parameters" accesskey="8">Footnote parameters</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Parameters for footnote formatting.
-</td></tr>
</table>
@@ -7645,63 +9635,103 @@ include a bibliographic style with that behavior.
<a name="g_t_005cfootnote"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cfootnotemark" accesskey="n" rel="next">\footnotemark</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cfootnotemark" accesskey="n" rel="next">\footnotemark</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cfootnote-1"></a>
<h3 class="section">11.1 <code>\footnote</code></h3>
<a name="index-_005cfootnote"></a>
-<p>Synopsis:
+<p>Synopsis, one of:
</p>
<div class="example">
-<pre class="example">\footnote[<var>number</var>]{<var>text</var>}
+<pre class="example">\footnote{<var>text</var>}
+\footnote[<var>number</var>]{<var>text</var>}
</pre></div>
-<p>Place a numbered footnote <var>text</var> at the bottom of the current page.
+<p>Place a footnote <var>text</var> at the bottom of the current page.
</p>
<div class="example">
<pre class="example">There are over a thousand footnotes in Gibbon's
-\textit{Decline and Fall of the Roman Empire}.\footnote{After
-reading an early version with endnotes David Hume complained,
-``One is also plagued with his Notes, according to the present Method
-of printing the Book'' and suggested that they ``only to be printed
-at the Margin or the Bottom of the Page.''}
+\textit{Decline and Fall of the Roman Empire}.\footnote{%
+ After reading an early version with endnotes David Hume complained,
+ ``One is also plagued with his Notes, according to the present Method
+ of printing the Book'' and suggested that they ``only to be printed
+ at the Margin or the Bottom of the Page.''}
</pre></div>
-<p>The optional argument <var>number</var> allows you to specify the footnote
-number. If you use this option then the footnote number counter is not
-incremented, and if you do not use it then the counter is incremented.
+<p>The optional argument <var>number</var> allows you to specify the number of
+the footnote. If you use this then LaTeX does not increment the
+<code>footnote</code> counter.
</p>
<a name="index-footnotes_002c-symbols-instead-of-numbers"></a>
<a name="index-_005cfnsymbol_002c-and-footnotes"></a>
<a name="index-_005c_0040fnsymbol"></a>
-<p>Change how LaTeX shows the footnote counter with something like
+<p>By default, LaTeX uses arabic numbers as footnote markers. Change
+this with something like
<code>\renewcommand{\thefootnote}{\fnsymbol{footnote}}</code>, which
uses a sequence of symbols (see <a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a>). To make this change global put that in the preamble. If
you make the change local then you may want to reset the counter with
-<code>\setcounter{footnote}{0}</code>. By default LaTeX uses arabic
-numbers.
+<code>\setcounter{footnote}{0}</code>.
+</p>
+<p>LaTeX determines the spacing of footnotes with two parameters.
+</p>
+<a name="index-footnote-parameters"></a>
+<a name="index-parameters_002c-for-footnotes"></a>
+
+<dl compact="compact">
+<dt><code>\footnoterule</code>
+<a name="index-_005cfootnoterule"></a>
+</dt>
+<dd><a name="footnote-footnoterule"></a><p>Produces the rule separating the main text on a page from the page&rsquo;s
+footnotes. Default dimensions in the standard document classes (except
+<code>slides</code>, where it does not appear) is: vertical thickness of
+<code>0.4pt</code>, and horizontal size of <code>0.4\columnwidth</code> long.
+Change the rule with something like this.
+</p>
+<div class="example">
+<pre class="example">\renewcommand{\footnoterule}{% Kerns avoid vertical space
+ \kern -3pt % This -3 is negative
+ \hrule width \textwidth height 1pt % of the sum of this 1
+ \kern 2pt} % and this 2
+</pre></div>
+
+</dd>
+<dt><code>\footnotesep</code>
+<a name="index-_005cfootnotesep"></a>
+</dt>
+<dd><a name="footnote-footnotesep"></a><p>The height of the strut placed at the beginning of the footnote
+(see <a href="#g_t_005cstrut">\strut</a>). By default, this is set to the normal strut for
+<code>\footnotesize</code> fonts (see <a href="#Font-sizes">Font sizes</a>), therefore there is no
+extra space between footnotes. This is &lsquo;<samp>6.65pt</samp>&rsquo; for &lsquo;<samp>10pt</samp>&rsquo;,
+&lsquo;<samp>7.7pt</samp>&rsquo; for &lsquo;<samp>11pt</samp>&rsquo;, and &lsquo;<samp>8.4pt</samp>&rsquo; for &lsquo;<samp>12pt</samp>&rsquo;. Change
+it as with <code>\setlength{\footnotesep}{11pt}</code>.
+</p>
+</dd>
+</dl>
+
+<p>The <code>\footnote</code> command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
</p>
<p>LaTeX&rsquo;s default puts many restrictions on where you can use a
<code>\footnote</code>; for instance, you cannot use it in an argument to a
sectioning command such as <code>\chapter</code> (it can only be used in outer
-paragraph mode). There are some workarounds; see following sections.
+paragraph mode; see <a href="#Modes">Modes</a>). There are some workarounds; see
+following sections.
</p>
<a name="index-Footnotes_002c-in-a-minipage"></a>
<a name="index-mpfootnote-counter"></a>
-<p>In a <code>minipage</code> environment the <code>\footnote</code>
-command uses the <code>mpfootnote</code> counter instead of the
-<code>footnote</code> counter, so they are numbered independently. They are
-shown at the bottom of the environment, not at the bottom of the page.
-And by default they are shown alphabetically. See <a href="#minipage">minipage</a>.
+<p>In a <code>minipage</code> environment the <code>\footnote</code> command uses the
+<code>mpfootnote</code> counter instead of the <code>footnote</code> counter, so
+they are numbered independently. They are shown at the bottom of the
+environment, not at the bottom of the page. And by default they are
+shown alphabetically. See <a href="#minipage">minipage</a> and <a href="#Footnotes-in-a-table">Footnotes in a table</a>.
</p>
<hr>
<a name="g_t_005cfootnotemark"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cfootnotetext" accesskey="n" rel="next">\footnotetext</a>, Previous: <a href="#g_t_005cfootnote" accesskey="p" rel="prev">\footnote</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cfootnotetext" accesskey="n" rel="next">\footnotetext</a>, Previous: <a href="#g_t_005cfootnote" accesskey="p" rel="prev">\footnote</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cfootnotemark-1"></a>
<h3 class="section">11.2 <code>\footnotemark</code></h3>
@@ -7715,14 +9745,27 @@ Next: <a href="#g_t_005cfootnotetext" accesskey="n" rel="next">\footnotetext</a>
\footnotemark[<var>number</var>]
</pre></div>
-<p>Put the current footnote number in the
-text. (See&nbsp;<a href="#g_t_005cfootnotetext">\footnotetext</a> for giving the text of the footnote
-separately.) The version with the optional argument <var>number</var> uses
-that number to determine the mark printed. This command can be used in
-inner paragraph mode.
+<p>Put the current footnote mark in the text. To specify associated text
+for the footnote see&nbsp;<a href="#g_t_005cfootnotetext">\footnotetext</a>. The optional argument
+<var>number</var> causes the command to use that number to determine the
+footnote mark. This command can be used in inner paragraph mode
+(see <a href="#Modes">Modes</a>).
+</p>
+<p>If you use <code>\footnotemark</code> without the optional argument then it
+increments the footnote counter but if you use the optional <var>number</var>
+then it does not. The next example produces several consecutive footnote
+markers referring to the same footnote.
</p>
-<p>This example gives the same institutional affiliation to both the first
-and third authors (<code>\thanks</code> is a version of <code>footnote</code>).
+<div class="example">
+<pre class="example">The first theorem\footnote{Due to Gauss.}
+and the second theorem\footnotemark[\value{footnote}]
+and the third theorem.\footnotemark[\value{footnote}]
+</pre></div>
+
+<p>If there are intervening footnotes then you must remember the value of the
+common mark. This example gives the same institutional affiliation to
+both the first and third authors (<code>\thanks</code> is a version of
+<code>footnote</code>), by-hand giving the number of the footnote.
</p>
<div class="example">
<pre class="example">\title{A Treatise on the Binomial Theorem}
@@ -7733,23 +9776,47 @@ and third authors (<code>\thanks</code> is a version of <code>footnote</code>).
\maketitle
</pre></div>
-<p>If you use <code>\footnotemark</code> without the optional argument then it
-increments the footnote counter but if you use the optional <var>number</var>
-then it does not. This produces several consecutive footnote markers
-referring to the same footnote.
+<p>This uses a counter to remember the footnote number. The third sentence
+is followed by the same footnote marker as the first.
</p>
<div class="example">
-<pre class="example">The first theorem\footnote{Due to Gauss.}
-and the second theorem\footnotemark[\value{footnote}]
-and the third theorem.\footnotemark[\value{footnote}]
+<pre class="example">\newcounter{footnoteValueSaver}
+All babies are illogical.\footnote{%
+ Lewis Carroll.}\setcounter{footnoteValueSaver}{\value{footnote}}
+Nobody is despised who can manage a crocodile.\footnote{%
+ Captain Hook.}
+Illogical persons are despised.\footnotemark[\value{footnoteValueSaver}]
+Therefore, anyone who can manage a crocodile is not a baby.
+</pre></div>
+
+<a name="index-package_002c-cleveref-2"></a>
+<a name="index-cleveref-package-2"></a>
+
+<a name="index-package_002c-hyperref"></a>
+<a name="index-hyperref-package"></a>
+
+<p>This example accomplishes the same by using the package <samp>cleveref</samp>.
+</p>
+<div class="example">
+<pre class="example">\usepackage{cleveref}[2012/02/15] % in preamble
+\crefformat{footnote}{#2\footnotemark[#1]#3}
+...
+The theorem is from Evers.\footnote{\label{fn:TE}Tinker, Evers, 1994.}
+The corollary is from Chance.\footnote{Evers, Chance, 1990.}
+But the key lemma is from Tinker.\cref{fn:TE}
</pre></div>
+<a name="index-package_002c-hyperref-1"></a>
+<a name="index-hyperref-package-1"></a>
+
+<p>It will work with the package <samp>hyperref</samp>.
+</p>
<hr>
<a name="g_t_005cfootnotetext"></a>
<div class="header">
<p>
-Next: <a href="#Footnotes-in-a-table" accesskey="n" rel="next">Footnotes in a table</a>, Previous: <a href="#g_t_005cfootnotemark" accesskey="p" rel="prev">\footnotemark</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Footnotes-in-section-headings" accesskey="n" rel="next">Footnotes in section headings</a>, Previous: <a href="#g_t_005cfootnotemark" accesskey="p" rel="prev">\footnotemark</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cfootnotetext-1"></a>
<h3 class="section">11.3 <code>\footnotetext</code></h3>
@@ -7763,208 +9830,169 @@ Next: <a href="#Footnotes-in-a-table" accesskey="n" rel="next">Footnotes in a ta
\footnotetext[<var>number</var>]{<var>text</var>}
</pre></div>
-<p>Place <var>text</var> at the bottom of the page as a footnote. This command
-can come anywhere after the <code>\footnotemark</code> command. The optional
-argument <var>number</var> changes the displayed footnote number. The
-<code>\footnotetext</code> command must appear in outer paragraph mode.
+<p>Place <var>text</var> at the bottom of the page as a footnote. It pairs with
+<code>\footnotemark</code> (see <a href="#g_t_005cfootnotemark">\footnotemark</a>) and can come anywhere after
+that command, but must appear in outer paragraph mode (see <a href="#Modes">Modes</a>).
+The optional argument <var>number</var> changes the number of the footnote
+mark.
+</p>
+<p>See <a href="#g_t_005cfootnotemark">\footnotemark</a> and&nbsp;<a href="#Footnotes-in-a-table">Footnotes in a table</a> for usage
+examples.
+</p>
+
+<hr>
+<a name="Footnotes-in-section-headings"></a>
+<div class="header">
+<p>
+Next: <a href="#Footnotes-in-a-table" accesskey="n" rel="next">Footnotes in a table</a>, Previous: <a href="#g_t_005cfootnotetext" accesskey="p" rel="prev">\footnotetext</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Footnotes-in-section-headings-1"></a>
+<h3 class="section">11.4 Footnotes in section headings</h3>
+
+<a name="index-footnote_002c-in-section-headings"></a>
+<a name="index-table-of-contents_002c-avoiding-footnotes"></a>
+
+<p>Putting a footnote in a section heading, as in:
+</p>
+<div class="example">
+<pre class="example">\section{Full sets\protect\footnote{This material due to ...}}
+</pre></div>
+
+<p>causes the footnote to appear at the bottom of the page where the
+section starts, as usual, but also at the bottom of the table of
+contents, where it is not likely to be desired. The simplest way
+to have it not appear on the table of contents is to use the optional
+argument to <code>\section</code>
+</p>
+<div class="example">
+<pre class="example">\section[Please]{Please\footnote{%
+ Don't footnote in chapter and section headers!}}
+</pre></div>
+
+<p>No <code>\protect</code> is needed in front of <code>\footnote</code> here because
+what gets moved to the table of contents is the optional argument.
</p>
<hr>
<a name="Footnotes-in-a-table"></a>
<div class="header">
<p>
-Next: <a href="#Footnotes-in-section-headings" accesskey="n" rel="next">Footnotes in section headings</a>, Previous: <a href="#g_t_005cfootnotetext" accesskey="p" rel="prev">\footnotetext</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Footnotes-of-footnotes" accesskey="n" rel="next">Footnotes of footnotes</a>, Previous: <a href="#Footnotes-in-section-headings" accesskey="p" rel="prev">Footnotes in section headings</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Footnotes-in-a-table-1"></a>
-<h3 class="section">11.4 Footnotes in a table</h3>
+<h3 class="section">11.5 Footnotes in a table</h3>
-<a name="index-Footnotes_002c-in-a-table"></a>
+<a name="index-footnote_002c-in-a-table"></a>
-<p>Inside a <code>table</code> environment the <code>\footnote</code> command does not
-work. For instance, if the code below appears on its own then the
-footnote simply disappears; there is a footnote mark in the table cell
-but nothing is set at the bottom of the page.
+<p>Inside a <code>tabular</code> or <code>array</code> environment the <code>\footnote</code>
+command does not work; there is a footnote mark in the table cell but
+the footnote text does not appear. The solution is to use a
+<code>minipage</code> environment as here (see <a href="#minipage">minipage</a>).
</p>
<div class="example">
<pre class="example">\begin{center}
+ \begin{minipage}{\textwidth} \centering
\begin{tabular}{l|l}
- \textsc{Ship} &amp;\textsc{Book} \\ \hline
- \textit{HMS Sophie} &amp;Master and Commander \\
- \textit{HMS Polychrest} &amp;Post Captain \\
- \textit{HMS Lively} &amp;Post Captain \\
- \textit{HMS Surprise} &amp;A number of books\footnote{Starting with
- HMS Surprise.}
+ \textsc{Ship} &amp;\textsc{Book} \\ \hline
+ \textit{HMS Sophie} &amp;Master and Commander \\
+ \textit{HMS Polychrest} &amp;Post Captain \\
+ \textit{HMS Lively} &amp;Post Captain \\
+ \textit{HMS Surprise} &amp;A number of books\footnote{%
+ Starting with HMS Surprise.}
\end{tabular}
+ \end{minipage}
\end{center}
</pre></div>
-<p>The solution is to surround the <code>tabular</code> environment with a
-<code>minipage</code> environment, as here (see <a href="#minipage">minipage</a>).
+<p>Inside a <code>minipage</code>, footnote marks are lowercase letters. Change
+that with something like
+<code>\renewcommand{\thempfootnote}{\arabic{mpfootnote}}</code>
+(see <a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a>).
+</p>
+<p>The footnotes in the prior example appear at the bottom of the
+<code>minipage</code>. To have them appear at the bottom of the main page, as
+part of the regular footnote sequence, use the <code>\footnotemark</code> and
+<code>\footnotetext</code> pair and make a new counter.
</p>
<div class="example">
-<pre class="example">\begin{center}
- \begin{minipage}{.5\textwidth}
- ... tabular material ...
- \end{minipage}
+<pre class="example">\newcounter{mpFootnoteValueSaver}
+\begin{center}
+ \begin{minipage}{\textwidth}
+ \setcounter{mpFootnoteValueSaver}{\value{footnote}} \centering
+ \begin{tabular}{l|l}
+ \textsc{Woman} &amp;\textsc{Relationship} \\ \hline
+ Mona &amp;Attached\footnotemark \\
+ Diana Villiers &amp;Eventual wife \\
+ Christine Hatherleigh Wood &amp;Fiance\footnotemark
+ \end{tabular}
+ \end{minipage}% percent sign keeps footnote text close to minipage
+ \stepcounter{mpFootnoteValueSaver}%
+ \footnotetext[\value{mpFootnoteValueSaver}]{%
+ Little is known other than her death.}%
+ \stepcounter{mpFootnoteValueSaver}%
+ \footnotetext[\value{mpFootnoteValueSaver}]{%
+ Relationship is unresolved in XXI.}
\end{center}
</pre></div>
-<p>The same technique will work inside a floating <code>table</code> environment
-(see <a href="#table">table</a>). To get the footnote at the bottom of the page use the
-<samp>tablefootnote</samp> package, as illustrated in this example. If you
-put <code>\usepackage{tablefootnote}</code> in the preamble and use the code
-shown then the footnote appears at the bottom and is numbered in
-sequence with other footnotes.
+<p>For a floating <code>table</code> environment (see <a href="#table">table</a>), use the
+<samp>tablefootnote</samp> package.
</p>
<div class="example">
-<pre class="example">\begin{table}
+<pre class="example">\usepackage{tablefootnote} % in preamble
+ ...
+\begin{table}
\centering
\begin{tabular}{l|l}
\textsc{Date} &amp;\textsc{Campaign} \\ \hline
1862 &amp;Fort Donelson \\
1863 &amp;Vicksburg \\
- 1865 &amp;Army of Northern Virginia\footnote{Ending the war.}
+ 1865 &amp;Army of Northern Virginia\tablefootnote{%
+ Ending the war.}
\end{tabular}
\caption{Forces captured by US Grant}
\end{table}
</pre></div>
-
-<hr>
-<a name="Footnotes-in-section-headings"></a>
-<div class="header">
-<p>
-Next: <a href="#Footnotes-of-footnotes" accesskey="n" rel="next">Footnotes of footnotes</a>, Previous: <a href="#Footnotes-in-a-table" accesskey="p" rel="prev">Footnotes in a table</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="Footnotes-in-section-headings-1"></a>
-<h3 class="section">11.5 Footnotes in section headings</h3>
-
-<a name="index-footnotes_002c-in-section-headings"></a>
-<a name="index-table-of-contents_002c-avoiding-footnotes"></a>
-<p>Putting a footnote in a section heading, as in:
-</p>
-<div class="example">
-<pre class="example">\section{Full sets\protect\footnote{This material due to ...}}
-</pre></div>
-
-<a name="index-package_002c-footmisc"></a>
-<a name="index-footmisc-package"></a>
-
-<a name="index-stable-option-to-footmisc-package"></a>
-<p>causes the footnote to appear at the bottom of the page where the
-section starts, as usual, but also at the bottom of the table of
-contents, where it is not likely to be desired. To have it not appear
-on the table of contents use the package <samp>footmisc</samp> with the
-<code>stable</code> option.
-</p>
-<div class="example">
-<pre class="example">\usepackage[stable]{footmisc}
-...
-\begin{document}
-...
-\section{Full sets\footnote{This material due to ...}}
-</pre></div>
-
-<p>Note that the <code>\protect</code> is gone; including it would cause the
-footnote to reappear on the table of contents.
+<p>The footnote appears at the page bottom and is numbered in sequence with
+other footnotes.
</p>
<hr>
<a name="Footnotes-of-footnotes"></a>
<div class="header">
<p>
-Next: <a href="#Multiple-reference-to-footnotes" accesskey="n" rel="next">Multiple reference to footnotes</a>, Previous: <a href="#Footnotes-in-section-headings" accesskey="p" rel="prev">Footnotes in section headings</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Footnotes-in-a-table" accesskey="p" rel="prev">Footnotes in a table</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Footnotes-of-footnotes-1"></a>
<h3 class="section">11.6 Footnotes of footnotes</h3>
+<a name="index-footnote_002c-of-a-footnote"></a>
+
+<a name="index-package_002c-bigfoot"></a>
+<a name="index-bigfoot-package"></a>
+
<p>Particularly in the humanities, authors can have multiple classes of
footnotes, including having footnotes of footnotes. The package
<samp>bigfoot</samp> extends LaTeX&rsquo;s default footnote mechanism in many
ways, including allow these two, as in this example.
</p>
<div class="example">
-<pre class="example">\usepackage{bigfoot}
+<pre class="example">\usepackage{bigfoot} % in preamble
\DeclareNewFootnote{Default}
\DeclareNewFootnote{from}[alph] % create class \footnotefrom{}
...
-\begin{document}
-...
The third theorem is a partial converse of the
-second.\footnotefrom{First noted in Wilson.\footnote{Second edition only.}}
-...
-</pre></div>
-
-
-<hr>
-<a name="Multiple-reference-to-footnotes"></a>
-<div class="header">
-<p>
-Next: <a href="#Footnote-parameters" accesskey="n" rel="next">Footnote parameters</a>, Previous: <a href="#Footnotes-of-footnotes" accesskey="p" rel="prev">Footnotes of footnotes</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="Multiple-references-to-footnotes"></a>
-<h3 class="section">11.7 Multiple references to footnotes</h3>
-
-<p>You can refer to a single footnote more than once. This example
-uses the package <samp>cleverref</samp>.
-</p>
-<div class="example">
-<pre class="example">\usepackage{cleveref}[2012/02/15] % this version of package or later
-\crefformat{footnote}{#2\footnotemark[#1]#3}
-...
-\begin{document}
-...
-The theorem is from Evers.\footnote{\label{fn:TE}Tinker and Evers, 1994.}
-The corollary is from Chance.\footnote{Evers and Chance, 1990.}
-But the key lemma is from Tinker.\cref{fn:TE}
-...
+second.\footnotefrom{%
+ First noted in Wilson.\footnote{Second edition only.}}
</pre></div>
-<p>This solution will work with the package <samp>hyperref</samp>.
-See&nbsp;<a href="#g_t_005cfootnotemark">\footnotemark</a> for a simpler solution in the common case
-of multiple authors with the same affiliation.
-</p>
-
-<hr>
-<a name="Footnote-parameters"></a>
-<div class="header">
-<p>
-Previous: <a href="#Multiple-reference-to-footnotes" accesskey="p" rel="prev">Multiple reference to footnotes</a>, Up: <a href="#Footnotes" accesskey="u" rel="up">Footnotes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="Footnote-parameters-1"></a>
-<h3 class="section">11.8 Footnote parameters</h3>
-
-<a name="index-footnote-parameters"></a>
-<a name="index-parameters_002c-for-footnotes"></a>
-
-<dl compact="compact">
-<dt><code>\footnoterule</code>
-<a name="index-_005cfootnoterule"></a>
-</dt>
-<dd><p>Produces the rule separating the main text on a page from the page&rsquo;s
-footnotes. Default dimensions: <code>0.4pt</code> thick (or wide), and
-<code>0.4\columnwidth</code> long in the standard document classes (except
-<code>slides</code>, where it does not appear).
-</p>
-</dd>
-<dt><code>\footnotesep</code>
-<a name="index-_005cfootnotesep"></a>
-</dt>
-<dd><p>The height of the strut placed at the beginning of the footnote. By
-default, this is set to the normal strut for <code>\footnotesize</code>
-fonts (see <a href="#Font-sizes">Font sizes</a>), therefore there is no extra space between
-footnotes. This is &lsquo;<samp>6.65pt</samp>&rsquo; for &lsquo;<samp>10pt</samp>&rsquo;, &lsquo;<samp>7.7pt</samp>&rsquo; for
-&lsquo;<samp>11pt</samp>&rsquo;, and &lsquo;<samp>8.4pt</samp>&rsquo; for &lsquo;<samp>12pt</samp>&rsquo;.
-</p>
-</dd>
-</dl>
-
<hr>
<a name="Definitions"></a>
<div class="header">
<p>
-Next: <a href="#Counters" accesskey="n" rel="next">Counters</a>, Previous: <a href="#Footnotes" accesskey="p" rel="prev">Footnotes</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Counters" accesskey="n" rel="next">Counters</a>, Previous: <a href="#Footnotes" accesskey="p" rel="prev">Footnotes</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Definitions-1"></a>
<h2 class="chapter">12 Definitions</h2>
@@ -7973,7 +10001,6 @@ Next: <a href="#Counters" accesskey="n" rel="next">Counters</a>, Previous: <a hr
<p>LaTeX has support for making new commands of many different kinds.
</p>
-
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#g_t_005cnewcommand-_0026-_005crenewcommand" accesskey="1">\newcommand &amp; \renewcommand</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">(Re)define a new command.
</td></tr>
@@ -8002,7 +10029,7 @@ Next: <a href="#Counters" accesskey="n" rel="next">Counters</a>, Previous: <a hr
<a name="g_t_005cnewcommand-_0026-_005crenewcommand"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cprovidecommand" accesskey="n" rel="next">\providecommand</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cprovidecommand" accesskey="n" rel="next">\providecommand</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cnewcommand-_0026-_005crenewcommand-1"></a>
<h3 class="section">12.1 <code>\newcommand</code> &amp; <code>\renewcommand</code></h3>
@@ -8013,122 +10040,161 @@ Next: <a href="#g_t_005cprovidecommand" accesskey="n" rel="next">\providecommand
<a name="index-defining-a-new-command"></a>
<a name="index-new-commands_002c-defining"></a>
-<p><code>\newcommand</code> and <code>\renewcommand</code> define and redefine a
-command, respectively. Synopses:
+<p>Synopses, one of:
+</p>
+<div class="example">
+<pre class="example">\newcommand{\<var>cmd</var>}{<var>defn</var>}
+\newcommand{\<var>cmd</var>}[<var>nargs</var>]{<var>defn</var>}
+\newcommand{\<var>cmd</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>defn</var>}
+\newcommand*{\<var>cmd</var>}{<var>defn</var>}
+\newcommand*{\<var>cmd</var>}[<var>nargs</var>]{<var>defn</var>}
+\newcommand*{\<var>cmd</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>defn</var>}
+</pre></div>
+
+<p>or one of these.
</p>
<div class="example">
-<pre class="example"> \newcommand{\<var>cmd</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>defn</var>}
- \newcommand*{\<var>cmd</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>defn</var>}
+<pre class="example">\renewcommand{\<var>cmd</var>}[<var>nargs</var>]{<var>defn</var>}
+\renewcommand{\<var>cmd</var>}[<var>nargs</var>]{<var>defn</var>}
\renewcommand{\<var>cmd</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>defn</var>}
+\renewcommand*{\<var>cmd</var>}{<var>defn</var>}
+\renewcommand*{\<var>cmd</var>}[<var>nargs</var>]{<var>defn</var>}
\renewcommand*{\<var>cmd</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>defn</var>}
</pre></div>
+<p>Define or redefine a command. See also the discussion of
+<code>\DeclareRobustCommand</code> in <a href="#Class-and-package-commands">Class and package commands</a>.
<a name="index-starred-form_002c-defining-new-commands"></a>
<a name="index-_002a_002dform_002c-defining-new-commands"></a>
-<p>The starred form of these two commands requires that the arguments not
-contain multiple paragraphs of text (not <code>\long</code>, in plain TeX
-terms).
+The starred form of these two requires that the arguments not contain
+multiple paragraphs of text (in plain TeX terms that it not be
+<code>\long</code>).
+</p>
+<p>These are the parameters:
</p>
<dl compact="compact">
<dt><var>cmd</var></dt>
-<dd><p>Required; <code>\<var>cmd</var></code> is the command name. For <code>\newcommand</code>, it
-must not be already defined and must not begin with <code>\end</code>. For
-<code>\renewcommand</code>, it must already be defined.
+<dd>
+<p>Required; the command name. It must begin with a backslash, <code>\</code>,
+and must not begin with the four letter string <code>\end</code>. For
+<code>\newcommand</code>, it must not be already defined. For
+<code>\renewcommand</code>, this name must already be defined.
</p>
</dd>
<dt><var>nargs</var></dt>
<dd><p>Optional; an integer from 0 to 9, specifying the number of arguments
-that the command can take, including any optional argument. If this
-argument is not present, the default is for the command to have no
-arguments. When redefining a command, the new version can have a
+that the command takes, including any optional argument. Omitting this
+argument is the same as specifying 0, meaning that the command has no
+arguments. If you redefine a command, the new version can have a
different number of arguments than the old version.
</p>
</dd>
<dt><var>optargdefault</var></dt>
-<dd><p>Optional; if this argument is present then the first argument of defined
-command <code>\<var>cmd</var></code> is optional, with default value <var>optargdefault</var>
+<dd><p>Optional; if this argument is present then the first argument of
+<code>\<var>cmd</var></code> is optional, with default value <var>optargdefault</var>
(which may be the empty string). If this argument is not present then
<code>\<var>cmd</var></code> does not take an optional argument.
</p>
<a name="index-positional-parameter"></a>
-<p>That is, if <code>\<var>cmd</var></code> is used with square brackets following,
-as in <code>\<var>cmd</var>[<var>myval</var>]</code>, then within <var>defn</var> the first
-<em>positional parameter</em> <code>#1</code> expands <var>myval</var>. On the
-other hand, if <code>\<var>cmd</var></code> is called without square brackets
-following, then within <var>defn</var> the positional parameter <code>#1</code>
-expands to the default <var>optargdefault</var>. In either case, any
-required arguments will be referred to starting with <code>#2</code>.
-</p>
-<p>Omitting <code>[<var>myval</var>]</code> in a call is different from having the
-square brackets with no contents, as in <code>[]</code>. The former results
-in <code>#1</code> expanding to <var>optargdefault</var>; the latter results in
-<code>#1</code> expanding to the empty string.
+<p>That is, if <code>\<var>cmd</var></code> is used with square brackets, as in
+<code>\<var>cmd</var>[<var>optval</var>]{...}...</code>, then within <var>defn</var> the
+parameter&nbsp;<code>#1</code> is set to the value of <var>optval</var>. On the
+other hand, if <code>\<var>cmd</var></code> is called without the square brackets
+then within <var>defn</var> the parameter <code>#1</code> is set to the value of
+<var>optargdefault</var>. In either case, the required arguments start with
+<code>#2</code>.
+</p>
+<p>Omitting <code>[<var>optargdefault</var>]</code> is different from having the
+square brackets with no contents, as in <code>[]</code>. The former sets
+<code>#1</code> to the value of <var>optargdefault</var>; the latter sets <code>#1</code>
+to the empty string.
</p>
</dd>
<dt><var>defn</var></dt>
-<dd><p>The text to be substituted for every occurrence of <code>\<var>cmd</var></code>; the
-positional parameter <code>#<var>n</var></code> in <var>defn</var> is replaced by
-the text of the <var>n</var>th argument.
+<dd><p>Required; the text to be substituted for every occurrence of
+<code>\<var>cmd</var></code>. The parameters <code>#1</code>, <code>#2</code>,
+... <code>#<var>nargs</var></code> are replaced by the values that you supply when
+you call the command (or by the default value if there is an optional
+argument and you don&rsquo;t exercise the option).
</p>
</dd>
</dl>
<p>TeX ignores spaces in the source following an alphabetic control
sequence, as in &lsquo;<samp>\cmd </samp>&rsquo;. If you actually want a space there, one
-solution is to type <code>{}</code> after the command (&lsquo;<samp>\cmd{} </samp>&rsquo;;
+solution is to type <code>{}</code> after the command (&lsquo;<samp>\cmd{} </samp>&rsquo;, and
another solution is to use an explicit control space (&lsquo;<samp>\cmd\ </samp>&rsquo;).
</p>
<p>A simple example of defining a new command:
-<code>\newcommand{\RS}{Robin Smith}</code> results in
-<code>\RS</code> being replaced by the longer text.
-</p>
-<p>Redefining an existing command is similar:
+<code>\newcommand{\RS}{Robin Smith}</code> results in <code>\RS</code> being
+replaced by the longer text. Redefining an existing command is similar:
<code>\renewcommand{\qedsymbol}{{\small QED}}</code>.
</p>
-<p>Here&rsquo;s a command definition with one required argument:
+<p>If you try to define a command and the name has already been used then
+you get something like &lsquo;<samp>LaTeX Error: Command \fred already
+defined. Or name \end... illegal, see p.192 of the manual</samp>&rsquo;. If you try
+to redefine a command and the name has not yet been used then you get
+something like &lsquo;<samp>LaTeX Error: \hank undefined</samp>&rsquo;.
+</p>
+<p>Here the first command definition has no arguments, and the second has
+one required argument.
</p>
<div class="example">
-<pre class="example">\newcommand{\defref}[1]{Definition~\ref{#1}}
+<pre class="example">\newcommand{\student}{Ms~O'Leary}
+\newcommand{\defref}[1]{Definition~\ref{#1}}
</pre></div>
-<p>Then, <code>\defref{def:basis}</code> expands to
-<code>Definition~\ref{def:basis}</code>, which will ultimately expand to
+<p>Use the first as in <code>I highly recommend \student{} to you</code>. The
+second has a variable, so that <code>\defref{def:basis}</code> expands to
+<code>Definition~\ref{def:basis}</code>, which ultimately expands to
something like &lsquo;<samp>Definition~3.14</samp>&rsquo;.
</p>
-<p>An example with two required arguments:
+<p>Similarly, but with two required arguments:
<code>\newcommand{\nbym}[2]{$#1 \times #2$}</code> is invoked as
<code>\nbym{2}{k}</code>.
</p>
-<p>An example with an optional argument:
+<p>This example has an optional argument.
</p>
<div class="example">
<pre class="example">\newcommand{\salutation}[1][Sir or Madam]{Dear #1:}
</pre></div>
-<p>Then, <code>\salutation</code> gives &lsquo;<samp>Dear Sir or Madam:</samp>&rsquo; while
+<p>Then <code>\salutation</code> gives &lsquo;<samp>Dear Sir or Madam:</samp>&rsquo; while
<code>\salutation[John]</code> gives &lsquo;<samp>Dear John:</samp>&rsquo;. And
<code>\salutation[]</code> gives &lsquo;<samp>Dear :</samp>&rsquo;.
</p>
-<p>The braces around <var>defn</var> do not define a group, that is, they do
-not delimit the scope of the result of expanding <var>defn</var>. So
-<code>\newcommand{\shipname}[1]{\it #1}</code> is problematic; in this
-sentence,
+<p>This example has an optional argument and two required arguments.
+</p>
+<div class="example">
+<pre class="example">\newcommand{\lawyers}[3][company]{#2, #3, and~#1}
+I employ \lawyers[Howe]{Dewey}{Cheatem}.
+</pre></div>
+
+<p>The output is &lsquo;<samp>I employ Dewey, Cheatem, and Howe</samp>&rsquo;. The optional
+argument, the <code>Howe</code>, is associated with <code>#1</code>, while
+<code>Dewey</code> and <code>Cheatem</code> are associated with <code>#2</code>
+and&nbsp;<code>#3</code>. Because of the optional argument,
+<code>\lawyers{Dewey}{Cheatem}</code> will give the output &lsquo;<samp>I employ
+Dewey, Cheatem, and company</samp>&rsquo;.
+</p>
+<p>The braces around <var>defn</var> do not define a group, that is, they do not
+delimit the scope of the result of expanding <var>defn</var>. For example,
+with <code>\newcommand{\shipname}[1]{\it #1}</code>, in this sentence,
</p>
<div class="example">
<pre class="example">The \shipname{Monitor} met the \shipname{Merrimac}.
</pre></div>
-<p>the words &lsquo;<samp>met the</samp>&rsquo; would incorrectly be in italics. Another
-pair of braces in the definition is needed, like this:
-<code>\newcommand{\shipname}[1]{{\it #1}}</code>. Those braces are
-part of the definition and thus do define a group.
+<p>the words &lsquo;<samp>met the</samp>&rsquo; would incorrectly be in italics. The solution
+is to put another pair of braces inside the definition:
+<code>\newcommand{\shipname}[1]{{\it #1}}</code>.
</p>
<hr>
<a name="g_t_005cprovidecommand"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cnewcounter" accesskey="n" rel="next">\newcounter</a>, Previous: <a href="#g_t_005cnewcommand-_0026-_005crenewcommand" accesskey="p" rel="prev">\newcommand &amp; \renewcommand</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cnewcounter" accesskey="n" rel="next">\newcounter</a>, Previous: <a href="#g_t_005cnewcommand-_0026-_005crenewcommand" accesskey="p" rel="prev">\newcommand &amp; \renewcommand</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cprovidecommand-1"></a>
<h3 class="section">12.2 <code>\providecommand</code></h3>
@@ -8138,26 +10204,41 @@ Next: <a href="#g_t_005cnewcounter" accesskey="n" rel="next">\newcounter</a>, Pr
<a name="index-defining-a-new-command-1"></a>
<a name="index-new-commands_002c-defining-1"></a>
-<p>Defines a command, as long as no command of this name already exists.
-Synopses:
+<p>Synopses, one of:
</p>
<div class="example">
-<pre class="example">\providecommand{<var>cmd</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>defn</var>}
+<pre class="example">\providecommand{<var>cmd</var>}{<var>defn</var>}
+\providecommand{<var>cmd</var>}[<var>nargs</var>]{<var>defn</var>}
+\providecommand{<var>cmd</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>defn</var>}
+\providecommand*{<var>cmd</var>}{<var>defn</var>}
+\providecommand*{<var>cmd</var>}[<var>nargs</var>]{<var>defn</var>}
\providecommand*{<var>cmd</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>defn</var>}
</pre></div>
-<p>If no command of this name already exists then this has the same effect
-as <code>\newcommand</code> (see <a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a>). If a
-command of this name already exists then this definition does nothing.
-This is particularly useful in a style file, or other file that may be
-loaded more than once.
+<p>Defines a command, as long as no command of this name already exists.
+If no command of this name already exists then this has the same effect
+as <code>\newcommand</code>. If a command of this name already exists then
+this definition does nothing. This is particularly useful in a file
+that may be loaded more than once, such as a style file.
+See <a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a> for the description of the arguments.
+</p>
+<p>This example
+</p>
+<div class="example">
+<pre class="example">\providecommand{\myaffiliation}{Saint Michael's College}
+\providecommand{\myaffiliation}{Saint Michael's College}
+From \myaffiliation.
+</pre></div>
+
+<p>outputs &lsquo;<samp>From Saint Michael's College</samp>&rsquo;. Unlike <code>\newcommand</code>,
+the repeated use of <code>\providecommand</code> does not give an error.
</p>
<hr>
<a name="g_t_005cnewcounter"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cnewlength" accesskey="n" rel="next">\newlength</a>, Previous: <a href="#g_t_005cprovidecommand" accesskey="p" rel="prev">\providecommand</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cnewlength" accesskey="n" rel="next">\newlength</a>, Previous: <a href="#g_t_005cprovidecommand" accesskey="p" rel="prev">\providecommand</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cnewcounter_003a-Allocating-a-counter"></a>
<h3 class="section">12.3 <code>\newcounter</code>: Allocating a counter</h3>
@@ -8172,32 +10253,53 @@ Next: <a href="#g_t_005cnewlength" accesskey="n" rel="next">\newlength</a>, Prev
\newcounter{<var>countername</var>}[<var>supercounter</var>]
</pre></div>
-<p>Globally defines a new counter named <var>countername</var> and initialize
-the new counter to zero.
+<p>Globally defines a new counter named <var>countername</var> and initialize it
+to zero (see <a href="#Counters">Counters</a>).
</p>
-<p>The name <var>countername</var> must consists of letters only, and does not
+<p>The name <var>countername</var> must consist of letters only. It does not
begin with a backslash. This name must not already be in use by another
counter.
</p>
-<p>When you use the optional argument <code>[<var>supercounter</var>]</code> then
-<var>countername</var> will be numbered within, or subsidiary to, the
-existing counter <var>supercounter</var>. For example, ordinarily
-<code>subsection</code> is numbered within <code>section</code> so that any time
-<var>supercounter</var> is incremented with <code>\stepcounter</code>
+<p>When you use the optional argument <code>[<var>supercounter</var>]</code> then the
+counter <var>countername</var> will be reset to zero whenever
+<var>supercounter</var> is incremented. For example, ordinarily
+<code>subsection</code> is numbered within <code>section</code> so that any time you
+increment <var>section</var>, either with <code>\stepcounter</code>
(see <a href="#g_t_005cstepcounter">\stepcounter</a>) or <code>\refstepcounter</code>
-(see <a href="#g_t_005crefstepcounter">\refstepcounter</a>) then <var>countername</var> is reset to zero.
+(see <a href="#g_t_005crefstepcounter">\refstepcounter</a>), then LaTeX will reset <var>subsection</var> to
+zero.
</p>
-<p>See <a href="#Counters">Counters</a>, for more information about counters.
+<p>This example
+</p>
+<div class="example">
+<pre class="example">\newcounter{asuper} \setcounter{asuper}{1}
+\newcounter{asub}[asuper] \setcounter{asub}{3} % Note `asuper'
+The value of asuper is \arabic{asuper} and of asub is \arabic{asub}.
+\stepcounter{asuper}
+Now asuper is \arabic{asuper} while asub is \arabic{asub}.
+</pre></div>
+
+<p>produces &lsquo;<samp>The value of asuper is 1 and that of asub is 3</samp>&rsquo; and
+&lsquo;<samp>Now asuper is 2 while asub is 0</samp>&rsquo;.
+</p>
+<p>If the counter already exists, for instance by entering <code>asuper</code>
+twice, then you get something like &lsquo;<samp>LaTeX Error: Command \c@asuper
+already defined. Or name \end... illegal, see p.192 of the manual.</samp>&rsquo;.
+</p>
+<p>If you use the optional argument then the super counter must already
+exist. Entering <code>\newcounter{jh}[lh]</code> when <code>lh</code> is not a
+defined counter will get you &lsquo;<samp>LaTeX Error: No counter 'lh'
+defined.</samp>&rsquo;
</p>
<hr>
<a name="g_t_005cnewlength"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cnewsavebox" accesskey="n" rel="next">\newsavebox</a>, Previous: <a href="#g_t_005cnewcounter" accesskey="p" rel="prev">\newcounter</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cnewsavebox" accesskey="n" rel="next">\newsavebox</a>, Previous: <a href="#g_t_005cnewcounter" accesskey="p" rel="prev">\newcounter</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cnewlength_003a-Allocating-a-length"></a>
-<h3 class="section">12.4 <code>\newlength</code>: Allocating a length</h3>
+<a name="g_t_005cnewlength-1"></a>
+<h3 class="section">12.4 <code>\newlength</code></h3>
<a name="index-_005cnewlength"></a>
<a name="index-lengths_002c-allocating-new"></a>
@@ -8205,55 +10307,77 @@ Next: <a href="#g_t_005cnewsavebox" accesskey="n" rel="next">\newsavebox</a>, Pr
<a name="index-skip-register_002c-plain-TeX"></a>
<a name="index-glue-register_002c-plain-TeX"></a>
-<p>Allocate a new <em>length</em> register. Synopsis:
+<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\newlength{\<var>arg</var>}
+<pre class="example">\newlength{<var>arg</var>}
</pre></div>
-<p>This command takes one required argument, which must begin with a
-backslash (&lsquo;<samp>\</samp>&rsquo;). It creates a new length register named
-<code>\<var>arg</var></code>, which is a place to hold (rubber) lengths such as
-<code>1in plus.2in minus.1in</code> (what plain TeX calls a <code>skip</code>
-register). The register gets an initial value of zero. The control
-sequence <code>\<var>arg</var></code> must not already be defined.
+<p>Allocate a new length register (see <a href="#Lengths">Lengths</a>). The required argument
+<var>arg</var> must begin with a backslash, <code>\</code>. The new register holds
+rubber lengths such as <code>72.27pt</code> or <code>1in plus.2in minus.1in</code>
+(a LaTeX length register is what plain TeX calls a <code>skip</code>
+register). The initial value is zero. The control sequence
+<code>\<var>arg</var></code> must not be already defined.
+</p>
+<p>An example:
</p>
-<p>See <a href="#Lengths">Lengths</a>, for more about lengths.
+<div class="example">
+<pre class="example">\newlength{\graphichgt}
+</pre></div>
+
+<p>If you forget the backslash then you get &lsquo;<samp>Missing control sequence
+inserted</samp>&rsquo;. If the command sequence already exists then you get
+something like &lsquo;<samp>LaTeX Error: Command \graphichgt already defined.
+Or name \end... illegal, see p.192 of the manual</samp>&rsquo;.
</p>
<hr>
<a name="g_t_005cnewsavebox"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment" accesskey="n" rel="next">\newenvironment &amp; \renewenvironment</a>, Previous: <a href="#g_t_005cnewlength" accesskey="p" rel="prev">\newlength</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment" accesskey="n" rel="next">\newenvironment &amp; \renewenvironment</a>, Previous: <a href="#g_t_005cnewlength" accesskey="p" rel="prev">\newlength</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cnewsavebox_003a-Allocating-a-box"></a>
-<h3 class="section">12.5 <code>\newsavebox</code>: Allocating a box</h3>
+<a name="g_t_005cnewsavebox-1"></a>
+<h3 class="section">12.5 <code>\newsavebox</code></h3>
<a name="index-_005cnewsavebox"></a>
<a name="index-box_002c-allocating-new"></a>
-<p>Allocate a &ldquo;bin&rdquo; for holding a box. Synopsis:
+<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\newsavebox{\<var>cmd</var>}
+<pre class="example">\newsavebox{<var>cmd</var>}
</pre></div>
-<p>Defines <code>\<var>cmd</var></code> to refer to a new bin for storing boxes.
-Such a box is for holding typeset material, to use multiple times
-(see <a href="#Boxes">Boxes</a>) or to measure or manipulate. The name
-<code>\<var>cmd</var></code> must start with a backslash (&lsquo;<samp>\</samp>&rsquo;), and must not
-be already defined.
+<p>Define <code>\<var>cmd</var></code> to refer to a new &ldquo;bin&rdquo; for storing boxes.
+Such a box is for holding typeset material, to use multiple times or to
+measure or manipulate (see <a href="#Boxes">Boxes</a>). The required bin name
+<code><var>cmd</var></code> must start with a backslash, <code>\</code>, and must not
+already be defined. This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
</p>
-<p>The allocation of a box is global. This command is fragile
-(see <a href="#g_t_005cprotect">\protect</a>).
+<p>The first line here sets you up to save the material for later use.
+</p>
+<div class="example">
+<pre class="example">\newsavebox{\logobox}
+\savebox{\logobox}{LoGo}
+Our logo is \usebox{\logobox}.
+</pre></div>
+
+<p>The output is &lsquo;<samp>Our logo is LoGo</samp>&rsquo;.
+</p>
+<p>If there is an already defined bin then you get something like
+&lsquo;<samp>LaTeX Error: Command \logobox already defined. Or name
+\end... illegal, see p.192 of the manual</samp>&rsquo;.
+</p>
+<p>The allocation of a box is global.
</p>
<hr>
<a name="g_t_005cnewenvironment-_0026-_005crenewenvironment"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cnewtheorem" accesskey="n" rel="next">\newtheorem</a>, Previous: <a href="#g_t_005cnewsavebox" accesskey="p" rel="prev">\newsavebox</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cnewtheorem" accesskey="n" rel="next">\newtheorem</a>, Previous: <a href="#g_t_005cnewsavebox" accesskey="p" rel="prev">\newsavebox</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cnewenvironment-_0026-_005crenewenvironment-1"></a>
<h3 class="section">12.6 <code>\newenvironment</code> &amp; <code>\renewenvironment</code></h3>
@@ -8264,26 +10388,41 @@ Next: <a href="#g_t_005cnewtheorem" accesskey="n" rel="next">\newtheorem</a>, Pr
<a name="index-defining-new-environments"></a>
<a name="index-redefining-environments"></a>
-<p>These commands define or redefine an environment <var>env</var>, that is,
-<code>\begin{<var>env</var>} <var>body</var> \end{<var>env</var>}</code>. Synopses:
+<p>Synopses, one of:
+</p>
+<div class="example">
+<pre class="example">\newenvironment{<var>env</var>}{<var>begdef</var>}{<var>enddef</var>}
+\newenvironment{<var>env</var>}[<var>nargs</var>]{<var>begdef</var>}{<var>enddef</var>}
+\newenvironment{<var>env</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>begdef</var>}{<var>enddef</var>}
+\newenvironment*{<var>env</var>}{<var>begdef</var>}{<var>enddef</var>}
+\newenvironment*{<var>env</var>}[<var>nargs</var>]{<var>begdef</var>}{<var>enddef</var>}
+\newenvironment*{<var>env</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>begdef</var>}{<var>enddef</var>}
+</pre></div>
+
+<p>or one of these.
</p>
<div class="example">
-<pre class="example"> \newenvironment{<var>env</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>begdefn</var>}{<var>enddefn</var>}
- \newenvironment*{<var>env</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>begdefn</var>}{<var>enddefn</var>}
- \renewenvironment{<var>env</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>begdefn</var>}{<var>enddefn</var>}
-\renewenvironment*{<var>env</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>begdefn</var>}{<var>enddefn</var>}
+<pre class="example">\renewenvironment{<var>env</var>}{<var>begdef</var>}{<var>enddef</var>}
+\renewenvironment{<var>env</var>}[<var>nargs</var>]{<var>begdef</var>}{<var>enddef</var>}
+\renewenvironment{<var>env</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>begdef</var>}{<var>enddef</var>}
+\renewenvironment*{<var>env</var>}{<var>begdef</var>}{<var>enddef</var>}
+\renewenvironment*{<var>env</var>}[<var>nargs</var>]{<var>begdef</var>}{<var>enddef</var>}
+\renewenvironment*{<var>env</var>}[<var>nargs</var>][<var>optargdefault</var>]{<var>begdef</var>}{<var>enddef</var>}
</pre></div>
+<p>Define or redefine the environment <var>env</var>, that is, create the
+construct <code>\begin{<var>env</var>} ... <var>body</var> ... \end{<var>env</var>}</code>.
+</p>
<a name="index-_002a_002dform-of-environment-commands"></a>
<p>The starred form of these commands requires that the arguments not
-contain multiple paragraphs of text. The body of these environments can
-still contain multiple paragraphs.
+contain multiple paragraphs of text. However, the body of these
+environments can contain multiple paragraphs.
</p>
<dl compact="compact">
<dt><var>env</var></dt>
<dd><p>Required; the environment name. It consists only of letters or the
-<code>*</code> character, and thus does not begin with backslash
-(<code>\</code>). It must not begin with the string <code>end</code>. For
+<code>*</code> character, and thus does not begin with backslash, <code>\</code>.
+It must not begin with the string <code>end</code>. For
<code>\newenvironment</code>, the name <var>env</var> must not be the name of an
already existing environment, and also the command <code>\<var>env</var></code>
must be undefined. For <code>\renewenvironment</code>, <var>env</var> must be the
@@ -8292,59 +10431,65 @@ name of an existing environment.
</dd>
<dt><var>nargs</var></dt>
<dd><p>Optional; an integer from 0 to 9 denoting the number of arguments of
-that the environment will take. When the environment is used these
+that the environment takes. When you use the environment these
arguments appear after the <code>\begin</code>, as in
-<code>\begin{<var>env</var>}{<var>arg1</var>}&hellip;{<var>argn</var>}</code>. If this
-argument is not present then the default is for the environment to have
-no arguments. When redefining an environment, the new version can have
-a different number of arguments than the old version.
+<code>\begin{<var>env</var>}{<var>arg1</var>} ... {<var>argn</var>}</code>. Omitting
+this is equivalent to setting it to 0; the environment will have no
+arguments. When redefining an environment, the new version can have a
+different number of arguments than the old version.
</p>
</dd>
<dt><var>optargdefault</var></dt>
-<dd><p>Optional; if this argument is present then the first argument of the
-defined environment is optional, with default value <var>optargdefault</var>
-(which may be the empty string). If this argument is not present then
-the environment does not take an optional argument.
-</p>
-<p>That is, when <code>[<var>optargdefault</var>]</code> is present in the
-environment definition, if <code>\begin{<var>env</var>}</code> is used with
-square brackets following, as in
-<code>\begin{<var>env</var>}[<var>myval</var>]</code>, then, within <var>begdefn</var>,
-the positional parameter <code>#1</code> expands to <var>myval</var>. If
-<code>\begin{<var>env</var>}</code> is called without square brackets
-following, then, within within <var>begdefn</var>, the positional parameter
-<code>#1</code> expands to the default <var>optargdefault</var>. In either case,
-any required arguments will be referred to starting with <code>#2</code>.
-</p>
-<p>Omitting <code>[<var>myval</var>]</code> in the call is different from having the
+<dd><p>Optional; if this is present then the first argument of the defined
+environment is optional, with default value <var>optargdefault</var> (which
+may be the empty string). If this is not in the definition then the
+environment does not take an optional argument.
+</p>
+<p>That is, when <var>optargdefault</var> is present in the definition of the
+environment then you can start the environment with square brackets, as
+in <code>\begin{<var>env</var>}[<var>optval</var>]{...} ... \end{<var>env</var>}</code>.
+In this case, within <var>begdefn</var> the parameter <code>#1</code> is set to the
+value of <var>optval</var>. If you call <code>\begin{<var>env</var>}</code> without
+square brackets, then within <var>begdefn</var> the parameter <code>#1</code> is
+set to the value of the default <var>optargdefault</var>. In either case,
+any required arguments start with <code>#2</code>.
+</p>
+<p>Omitting <code>[<var>myval</var>]</code> in the call is different than having the
square brackets with no contents, as in <code>[]</code>. The former results
in <code>#1</code> expanding to <var>optargdefault</var>; the latter results in
<code>#1</code> expanding to the empty string.
</p>
</dd>
-<dt><var>begdefn</var></dt>
+<dt><var>begdef</var></dt>
<dd><p>Required; the text expanded at every occurrence of
-<code>\begin{<var>env</var>}</code>. Within <var>begdef</var>, the <var>n</var>th
-positional parameter (i.e., <code>#<var>n</var></code>) is replaced by the text
-of the <var>n</var>th argument.
+<code>\begin{<var>env</var>}</code>. Within <var>begdef</var>, the parameters
+<code>#1</code>, <code>#2</code>, ... <code>#<var>nargs</var></code>, are replaced by the
+values that you supply when you call the environment; see the examples
+below.
</p>
</dd>
-<dt><var>enddefn</var></dt>
+<dt><var>enddef</var></dt>
<dd><p>Required; the text expanded at every occurrence of
-<code>\end{<var>env</var>}</code>. This may not contain any positional
-parameters, so <code>#<var>n</var></code> cannot be used here (but see the final
+<code>\end{<var>env</var>}</code>. This may not contain any parameters, that is,
+you cannot use <code>#1</code>, <code>#2</code>, etc., here (but see the final
example below).
</p>
</dd>
</dl>
-<p>All environments, that is to say the <var>begdefn</var> code, the environment
-body and the <var>enddefn</var> code, are processed within a group. Thus, in
+<p>All environments, that is to say the <var>begdef</var> code, the environment
+body, and the <var>enddef</var> code, are processed within a group. Thus, in
the first example below, the effect of the <code>\small</code> is limited to
the quote and does not extend to material following the environment.
</p>
+<p>If you try to define an environment and the name has already been used
+then you get something like &lsquo;<samp>LaTeX Error: Command \fred already
+defined. Or name \end... illegal, see p.192 of the manual</samp>&rsquo;. If you try
+to redefine an environment and the name has not yet been used then you
+get something like &lsquo;<samp>LaTeX Error: Environment hank undefined.</samp>&rsquo;.
+</p>
<p>This example gives an environment like LaTeX&rsquo;s <code>quotation</code>
-except that it will be set in smaller type:
+except that it will be set in smaller type.
</p>
<div class="example">
<pre class="example">\newenvironment{smallquote}{%
@@ -8354,8 +10499,18 @@ except that it will be set in smaller type:
}
</pre></div>
-<p>This one shows the use of arguments; it gives a quotation environment
-that cites the author:
+<p>This has an argument, which is set in boldface at the start of a
+paragraph.
+</p>
+<div class="example">
+<pre class="example">\newenvironment{point}[1]{%
+ \noindent\textbf{#1}
+}{%
+}
+</pre></div>
+
+<p>This one shows the use of a optional argument; it gives a quotation
+environment that cites the author.
</p>
<div class="example">
<pre class="example">\newenvironment{citequote}[1][Shakespeare]{%
@@ -8366,8 +10521,8 @@ that cites the author:
}
</pre></div>
-<p>The author&rsquo;s name is optional, and defaults to &lsquo;<samp>Shakespeare</samp>&rsquo;.
-In the document, use the environment like this:
+<p>The author&rsquo;s name is optional, and defaults to &lsquo;<samp>Shakespeare</samp>&rsquo;. In
+the document, use the environment like this.
</p>
<div class="example">
<pre class="example">\begin{citequote}[Lincoln]
@@ -8376,7 +10531,7 @@ In the document, use the environment like this:
</pre></div>
<p>The final example shows how to save the value of an argument to use in
-<var>enddefn</var>, in this case in a box (see <a href="#g_t_005csbox">\sbox</a>):
+<var>enddef</var>, in this case in a box (see <a href="#g_t_005csbox-_0026-_005csavebox">\sbox &amp; \savebox</a>).
</p>
<div class="example">
<pre class="example">\newsavebox{\quoteauthor}
@@ -8394,7 +10549,7 @@ In the document, use the environment like this:
<a name="g_t_005cnewtheorem"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cnewfont" accesskey="n" rel="next">\newfont</a>, Previous: <a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment" accesskey="p" rel="prev">\newenvironment &amp; \renewenvironment</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cnewfont" accesskey="n" rel="next">\newfont</a>, Previous: <a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment" accesskey="p" rel="prev">\newenvironment &amp; \renewenvironment</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cnewtheorem-1"></a>
<h3 class="section">12.7 <code>\newtheorem</code></h3>
@@ -8405,7 +10560,7 @@ Next: <a href="#g_t_005cnewfont" accesskey="n" rel="next">\newfont</a>, Previous
<a name="index-theorem_002dlike-environment"></a>
<a name="index-environment_002c-theorem_002dlike"></a>
-<p>Define a new theorem-like environment. Synopses:
+<p>Synopses:
</p>
<div class="example">
<pre class="example">\newtheorem{<var>name</var>}{<var>title</var>}
@@ -8413,25 +10568,24 @@ Next: <a href="#g_t_005cnewfont" accesskey="n" rel="next">\newfont</a>, Previous
\newtheorem{<var>name</var>}[<var>numbered_like</var>]{<var>title</var>}
</pre></div>
-<p>Using the first form, <code>\newtheorem{<var>name</var>}{<var>title</var>}</code>
-creates an environment that will be labelled with <var>title</var>. See the
-first example below.
+<p>Define a new theorem-like environment. You can specify one of
+<var>numbered_within</var> and <var>numbered_like</var>, or neither, but not both.
+</p>
+<p>The first form, <code>\newtheorem{<var>name</var>}{<var>title</var>}</code>, creates
+an environment that will be labelled with <var>title</var>; see the first
+example below.
</p>
-<p>The second form
-<code>\newtheorem{<var>name</var>}{<var>title</var>}[<var>numbered_within</var>]</code>
+<p>The second form,
+<code>\newtheorem{<var>name</var>}{<var>title</var>}[<var>numbered_within</var>]</code>,
creates an environment whose counter is subordinate to the existing
-counter <var>numbered_within</var> (its counter will be reset when
-<var>numbered_within</var> is reset).
+counter <var>numbered_within</var>, so this counter will be reset when
+<var>numbered_within</var> is reset. See the second example below.
</p>
-
<p>The third form
<code>\newtheorem{<var>name</var>}[<var>numbered_like</var>]{<var>title</var>}</code>,
-with optional argument between the two required arguments, will create
-an environment whose counter will share the previously defined counter
-<var>numbered_like</var>.
-</p>
-<p>You can specify one of <var>numbered_within</var> and <var>numbered_like</var>,
-or neither, but not both.
+with optional argument between the two required arguments, creates an
+environment whose counter will share the previously defined counter
+<var>numbered_like</var>. See the third example.
</p>
<p>This command creates a counter named <var>name</var>. In addition, unless
the optional argument <var>numbered_like</var> is used, inside of the
@@ -8444,13 +10598,14 @@ theorem-like environment the current <code>\ref</code> value will be that of
</p>
<dl compact="compact">
<dt><var>name</var></dt>
-<dd><p>The name of the environment. It must not begin with a backslash
-(&lsquo;<samp>\</samp>&rsquo;). It must not be the name of an existing environment; indeed,
-the command name <code>\<var>name</var></code> must not already be defined as anything.
+<dd><p>The name of the environment. It is a string of letters. It must not
+begin with a backslash, <code>\</code>. It must not be the name of an
+existing environment, and the command name <code>\<var>name</var></code> must not
+already be defined.
</p>
</dd>
<dt><var>title</var></dt>
-<dd><p>The text printed at the beginning of the environment, before the
+<dd><p>The text to be printed at the beginning of the environment, before the
number. For example, &lsquo;<samp>Theorem</samp>&rsquo;.
</p>
</dd>
@@ -8490,10 +10645,10 @@ output.
\end{defn}
</pre></div>
-<p>Because the next example specifies the optional argument
-<var>numbered_within</var> to <code>\newtheorem</code> as <code>section</code>, the
-example, with the same document body, gives &lsquo;<samp>Definition&nbsp;1.1</samp>&rsquo;
-and &lsquo;<samp>Definition&nbsp;2.1</samp>&rsquo;.
+<p>This example has the same document body as the prior one. But here
+<code>\newtheorem</code>&rsquo;s optional argument <var>numbered_within</var> is given as
+<code>section</code>, so the output is like &lsquo;<samp>Definition&nbsp;1.1</samp>&rsquo; and
+&lsquo;<samp>Definition&nbsp;2.1</samp>&rsquo;.
</p>
<div class="example">
<pre class="example">\newtheorem{defn}{Definition}[section]
@@ -8538,47 +10693,42 @@ by &lsquo;<samp>Theorem&nbsp;2.1</samp>&rsquo; and &lsquo;<samp>Definition&nbsp;
<a name="g_t_005cnewfont"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cprotect" accesskey="n" rel="next">\protect</a>, Previous: <a href="#g_t_005cnewtheorem" accesskey="p" rel="prev">\newtheorem</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cprotect" accesskey="n" rel="next">\protect</a>, Previous: <a href="#g_t_005cnewtheorem" accesskey="p" rel="prev">\newtheorem</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cnewfont_003a-Define-a-new-font-_0028obsolete_0029"></a>
-<h3 class="section">12.8 <code>\newfont</code>: Define a new font (obsolete)</h3>
+<a name="g_t_005cnewfont-1"></a>
+<h3 class="section">12.8 <code>\newfont</code></h3>
<a name="index-_005cnewfont"></a>
<a name="index-fonts_002c-new-commands-for"></a>
<a name="index-defining-new-fonts"></a>
-<p><code>\newfont</code>, now obsolete, defines a command that will switch fonts.
-Synopsis:
+<p>This command is obsolete. This description is here only to help with old
+documents. New documents should define fonts in families through the
+New Font Selection Scheme which allows you to, for example, associate a
+boldface with a roman (see <a href="#Fonts">Fonts</a>).
+</p>
+<p>Synopsis:
</p>
<div class="example">
<pre class="example">\newfont{\<var>cmd</var>}{<var>font description</var>}
</pre></div>
-<p>This defines a control sequence <code>\<var>cmd</var></code> that will change the
-current font. LaTeX will look on your system for a file named
-<samp><var>fontname</var>.tfm</samp>. The control sequence must must not already
-be defined. It must begin with a backslash (&lsquo;<samp>\</samp>&rsquo;).
-</p>
-<a name="index-_002efd-file"></a>
-<p>This command is obsolete. It is a low-level command for setting up an
-individual font. Today fonts are almost always defined in families
-(which allows you to, for example, associate a boldface with a roman)
-through the so-called &ldquo;New Font Selection Scheme&rdquo;, either by using
-<samp>.fd</samp> files or through the use of an engine that can access
-system fonts such as XeLaTeX (see <a href="#TeX-engines">TeX engines</a>).
+<p>Define a command <code>\<var>cmd</var></code> that will change the current font.
+The control sequence must must not already be defined. It must begin
+with a backslash, <code>\</code>.
</p>
<a name="index-at-clause_002c-in-font-definitions"></a>
<a name="index-design-size_002c-in-font-definitions"></a>
-<p>But since it is part of LaTeX, here is an explanation: the
-<var>font description</var> consists of a <var>fontname</var> and an optional
-<em>at clause</em>; this can have the form either <code>at <var>dimen</var></code>
-or <code>scaled <var>factor</var></code>, where a <var>factor</var> of &lsquo;<samp>1000</samp>&rsquo;
-means no scaling. For LaTeX&rsquo;s purposes, all this does is scale all
-the character and other font dimensions relative to the font&rsquo;s design
-size, which is a value defined in the <samp>.tfm</samp> file.
+<p>The <var>font description</var> consists of a <var>fontname</var> and an optional
+<em>at clause</em>. LaTeX will look on your system for a file named
+<samp><var>fontname</var>.tfm</samp>. The at clause can have the form either
+<code>at <var>dimen</var></code> or <code>scaled <var>factor</var></code>, where a
+<var>factor</var> of &lsquo;<samp>1000</samp>&rsquo; means no scaling. For LaTeX&rsquo;s purposes,
+all this does is scale all the character and other font dimensions
+relative to the font&rsquo;s design size, which is a value defined in the
+<samp>.tfm</samp> file.
</p>
-<p>This example defines two equivalent fonts and typesets a few
-characters in each:
+<p>This defines two equivalent fonts and typesets a few characters in each.
</p>
<div class="example">
<pre class="example">\newfont{\testfontat}{cmb10 at 11pt}
@@ -8592,7 +10742,7 @@ characters in each:
<a name="g_t_005cprotect"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cignorespaces-_0026-_005cignorespacesafterend" accesskey="n" rel="next">\ignorespaces &amp; \ignorespacesafterend</a>, Previous: <a href="#g_t_005cnewfont" accesskey="p" rel="prev">\newfont</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cignorespaces-_0026-_005cignorespacesafterend" accesskey="n" rel="next">\ignorespaces &amp; \ignorespacesafterend</a>, Previous: <a href="#g_t_005cnewfont" accesskey="p" rel="prev">\newfont</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cprotect-1"></a>
<h3 class="section">12.9 <code>\protect</code></h3>
@@ -8663,7 +10813,7 @@ to <code>\protect\(..\protect\)</code>.
<a name="g_t_005cignorespaces-_0026-_005cignorespacesafterend"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cprotect" accesskey="p" rel="prev">\protect</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cprotect" accesskey="p" rel="prev">\protect</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cignorespaces-_0026-_005cignorespacesafterend-1"></a>
<h3 class="section">12.10 <code>\ignorespaces &amp; \ignorespacesafterend</code></h3>
@@ -8700,13 +10850,17 @@ the command and the question text.
<pre class="example">\newcommand{\points}[1]{\makebox[0pt]{\makebox[10em][l]{#1~pts}}
\begin{enumerate}
\item\points{10}no extra space output here
- \item\points{15} extra space output between the number and the word `extra'
+ \item\points{15} extra space between the number and the `extra'
\end{enumerate}
</pre></div>
-<p>The solution is to change to
-<code>\newcommand{\points}[1]{\makebox[0pt]{\makebox[10em][l]{#1~pts}}\ignorespaces}</code>.
+<p>The solution is to change to this.
</p>
+<div class="example">
+<pre class="example">\newcommand{\points}[1]{%
+ \makebox[0pt]{\makebox[10em][l]{#1~pts}}\ignorespaces}
+</pre></div>
+
<p>A second example shows spaces being removed from the front of text. The
commands below allow a user to uniformly attach a title to names. But,
as given, if a title accidentally starts with a space then
@@ -8715,7 +10869,7 @@ as given, if a title accidentally starts with a space then
<div class="example">
<pre class="example">\makeatletter
\newcommand{\honorific}[1]{\def\@honorific{#1}} % remember title
-\newcommand{\fullname}[1]{\@honorific~#1} % recall title; put before name
+\newcommand{\fullname}[1]{\@honorific~#1} % put title before name
\makeatother
\begin{tabular}{|l|}
\honorific{Mr/Ms} \fullname{Jones} \\ % no extra space here
@@ -8759,7 +10913,7 @@ inconvenient. The solution is to change to
<a name="Counters"></a>
<div class="header">
<p>
-Next: <a href="#Lengths" accesskey="n" rel="next">Lengths</a>, Previous: <a href="#Definitions" accesskey="p" rel="prev">Definitions</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Lengths" accesskey="n" rel="next">Lengths</a>, Previous: <a href="#Definitions" accesskey="p" rel="prev">Definitions</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Counters-1"></a>
<h2 class="chapter">13 Counters</h2>
@@ -8790,6 +10944,8 @@ inside of a minipage (see <a href="#minipage">minipage</a>). The counters <code
through <code>enumiv</code> are used in the <code>enumerate</code> environment, for
up to four levels of nesting (see <a href="#enumerate">enumerate</a>).
</p>
+<p>Counters can have any integer value but they are typically positive.
+</p>
<p>New counters are created with <code>\newcounter</code>. See <a href="#g_t_005cnewcounter">\newcounter</a>.
</p>
@@ -8808,7 +10964,7 @@ up to four levels of nesting (see <a href="#enumerate">enumerate</a>).
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#g_t_005cstepcounter" accesskey="7">\stepcounter</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Add to a counter, resetting subsidiary counters.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cday-_005cmonth-_005cyear" accesskey="8">\day \month \year</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Numeric date values.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cday-_0026-_005cmonth-_0026-_005cyear" accesskey="8">\day &amp; \month &amp; \year</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Numeric date values.
</td></tr>
</table>
@@ -8817,7 +10973,7 @@ up to four levels of nesting (see <a href="#enumerate">enumerate</a>).
<a name="g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cusecounter" accesskey="n" rel="next">\usecounter</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cusecounter" accesskey="n" rel="next">\usecounter</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol_003a-Printing-counters"></a>
<h3 class="section">13.1 <code>\alph \Alph \arabic \roman \Roman \fnsymbol</code>: Printing counters</h3>
@@ -8826,7 +10982,7 @@ Next: <a href="#g_t_005cusecounter" accesskey="n" rel="next">\usecounter</a>, Up
<p>Print the value of a counter, in a specified style. For instance, if
the counter <var>counter</var> has the value 1 then a
-<code>\alph{<var>counter</var>}</code> in your source will result in a lower case
+<code>\alph{<var>counter</var>}</code> in your source will result in a lowercase
letter&nbsp;a appearing in the output.
</p>
<p>All of these commands take a single counter as an argument, for
@@ -8837,53 +10993,64 @@ start with a backslash.
<dt><code>\alph{<var>counter</var>}</code>
<a name="index-_005calph_007bcounter_007d"></a>
</dt>
-<dd><p>Print the value of <var>counter</var> in lowercase letters: &lsquo;a&rsquo;, &lsquo;b&rsquo;, <small class="enddots">...</small>
+<dd><p>Print the value of <var>counter</var> in lowercase letters: &lsquo;a&rsquo;, &lsquo;b&rsquo;,
+<small class="enddots">...</small> If the counter&rsquo;s value is less than 1 or more than 26 then
+you get &lsquo;<samp>LaTeX Error: Counter too large.</samp>&rsquo;
</p>
</dd>
<dt><code>\Alph{<var>counter</var>}</code>
<a name="index-_005cAlph_007bcounter_007d"></a>
</dt>
-<dd><p>Print in uppercase letters: &lsquo;A&rsquo;, &lsquo;B&rsquo;, <small class="enddots">...</small>
+<dd><p>Print in uppercase letters: &lsquo;A&rsquo;, &lsquo;B&rsquo;, <small class="enddots">...</small> If the counter&rsquo;s value
+is less than 1 or more than 26 then you get &lsquo;<samp>LaTeX Error: Counter
+too large.</samp>&rsquo;
</p>
</dd>
<dt><code>\arabic{<var>counter</var>}</code>
<a name="index-_005carabic_007bcounter_007d"></a>
</dt>
-<dd><p>Print in Arabic numbers: &lsquo;1&rsquo;, &lsquo;2&rsquo;, <small class="enddots">...</small>
+<dd><p>Print in Arabic numbers such as &lsquo;<samp>5</samp>&rsquo; or &lsquo;<samp>-2</samp>&rsquo;.
</p>
</dd>
<dt><code>\roman{<var>counter</var>}</code>
<a name="index-_005croman_007bcounter_007d"></a>
</dt>
-<dd><p>Print in lowercase roman numerals: &lsquo;i&rsquo;, &lsquo;ii&rsquo;, <small class="enddots">...</small>
+<dd><p>Print in lowercase roman numerals: &lsquo;i&rsquo;, &lsquo;ii&rsquo;, <small class="enddots">...</small> If the
+counter&rsquo;s value is less than 1 then you get no warning or error but
+LaTeX does not print anything in the output.
</p>
</dd>
<dt><code>\Roman{<var>counter</var>}</code>
<a name="index-_005cRoman_007bcounter_007d"></a>
</dt>
-<dd><p>Print in uppercase roman numerals: &lsquo;I&rsquo;, &lsquo;II&rsquo;, <small class="enddots">...</small>
+<dd><p>Print in uppercase roman numerals: &lsquo;I&rsquo;, &lsquo;II&rsquo;, <small class="enddots">...</small> If the
+counter&rsquo;s value is less than 1 then you get no warning or error but
+LaTeX does not print anything in the output.
</p>
</dd>
<dt><code>\fnsymbol{<var>counter</var>}</code>
<a name="index-_005cfnsymbol_007bcounter_007d"></a>
</dt>
-<dd><p>Prints the value of <var>counter</var> in a specific sequence of nine
-symbols (conventionally used for labeling footnotes). The value of
-<var>counter</var> must be between&nbsp;1 and&nbsp;9, inclusive.
+<dd><p>Prints the value of <var>counter</var> using a sequence of nine symbols that
+are traditionally used for labeling footnotes. The value of
+<var>counter</var> should be between&nbsp;1 and&nbsp;9, inclusive. If the
+counter&rsquo;s value is less than 0 or more than 9 then you get &lsquo;<samp>LaTeX
+Error: Counter too large</samp>&rsquo;, while if it is 0 then you get no error or
+warning but LaTeX does not output anything.
</p>
<p>Here are the symbols:
</p>
<table>
-<thead><tr><th width="33%">Name</th><th width="33%">Command</th><th width="33%">Equivalent Unicode symbol and/or numeric code point</th></tr></thead>
-<tr><td width="33%">asterisk</td><td width="33%"><code>\ast</code></td><td width="33%">*</td></tr>
-<tr><td width="33%">dagger</td><td width="33%"><code>\dagger</code></td><td width="33%">&#x2020;</td></tr>
-<tr><td width="33%">ddagger</td><td width="33%"><code>\ddagger</code></td><td width="33%">&#x2021;</td></tr>
-<tr><td width="33%">section-sign</td><td width="33%"><code>\S</code></td><td width="33%">&#x00A7;</td></tr>
-<tr><td width="33%">paragraph-sign</td><td width="33%"><code>\P</code></td><td width="33%">&#x00B6;</td></tr>
-<tr><td width="33%">double-vert</td><td width="33%"><code>\parallel</code></td><td width="33%">&#x2016;</td></tr>
-<tr><td width="33%">double-asterisk</td><td width="33%"><code>\ast\ast</code></td><td width="33%">**</td></tr>
-<tr><td width="33%">double-dagger</td><td width="33%"><code>\dagger\dagger</code></td><td width="33%">&#x2020;&#x2020;</td></tr>
-<tr><td width="33%">double-ddagger</td><td width="33%"><code>\ddagger\ddagger</code></td><td width="33%">&#x2021;&#x2021;</td></tr>
+<thead><tr><th width="10%">Number</th><th width="30%">Name</th><th width="30%">Command</th><th width="30%">Symbol</th></tr></thead>
+<tr><td width="10%">1</td><td width="30%">asterisk</td><td width="30%"><code>\ast</code></td><td width="30%">*</td></tr>
+<tr><td width="10%">2</td><td width="30%">dagger</td><td width="30%"><code>\dagger</code></td><td width="30%">&#x2020;</td></tr>
+<tr><td width="10%">3</td><td width="30%">ddagger</td><td width="30%"><code>\ddagger</code></td><td width="30%">&#x2021;</td></tr>
+<tr><td width="10%">4</td><td width="30%">section-sign</td><td width="30%"><code>\S</code></td><td width="30%">&#x00A7;</td></tr>
+<tr><td width="10%">5</td><td width="30%">paragraph-sign</td><td width="30%"><code>\P</code></td><td width="30%">&#x00B6;</td></tr>
+<tr><td width="10%">6</td><td width="30%">double-vert</td><td width="30%"><code>\parallel</code></td><td width="30%">&#x2016;</td></tr>
+<tr><td width="10%">7</td><td width="30%">double-asterisk</td><td width="30%"><code>\ast\ast</code></td><td width="30%">**</td></tr>
+<tr><td width="10%">8</td><td width="30%">double-dagger</td><td width="30%"><code>\dagger\dagger</code></td><td width="30%">&#x2020;&#x2020;</td></tr>
+<tr><td width="10%">9</td><td width="30%">double-ddagger</td><td width="30%"><code>\ddagger\ddagger</code></td><td width="30%">&#x2021;&#x2021;</td></tr>
</table>
</dd>
@@ -8894,10 +11061,10 @@ symbols (conventionally used for labeling footnotes). The value of
<a name="g_t_005cusecounter"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cvalue" accesskey="n" rel="next">\value</a>, Previous: <a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol" accesskey="p" rel="prev">\alph \Alph \arabic \roman \Roman \fnsymbol</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cvalue" accesskey="n" rel="next">\value</a>, Previous: <a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol" accesskey="p" rel="prev">\alph \Alph \arabic \roman \Roman \fnsymbol</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cusecounter_007bcounter_007d"></a>
-<h3 class="section">13.2 <code>\usecounter{<var>counter</var>}</code></h3>
+<a name="g_t_005cusecounter-1"></a>
+<h3 class="section">13.2 <code>\usecounter</code></h3>
<a name="index-_005cusecounter"></a>
<a name="index-list-items_002c-specifying-counter"></a>
@@ -8909,15 +11076,16 @@ Next: <a href="#g_t_005cvalue" accesskey="n" rel="next">\value</a>, Previous: <a
<pre class="example">\usecounter{<var>counter</var>}
</pre></div>
-<p>In the <code>list</code> environment, when used in the second argument, this
-command sets up <var>counter</var> to number the list items. It initializes
-<var>counter</var> to zero, and arranges that when <code>\item</code> is called
-without its optional argument then <var>counter</var> is incremented by
-<code>\refstepcounter</code>, making its value be the current <code>ref</code>
-value. This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
+<p>Used in the second argument of the <code>list</code> environment
+(see <a href="#list">list</a>), this declares that list items will be numbered by
+<var>counter</var>. It initializes <var>counter</var> to zero, and arranges that
+when <code>\item</code> is called without its optional argument then
+<var>counter</var> is incremented by <code>\refstepcounter</code>, making its value
+be the current <code>ref</code> value (see <a href="#g_t_005cref">\ref</a>). This command is fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
</p>
-<p>Put in the preamble, this makes a new list environment enumerated with
-<var>testcounter</var>:
+<p>Put in the document preamble, this example makes a new list environment
+enumerated with <var>testcounter</var>:
</p>
<div class="example">
<pre class="example">\newcounter{testcounter}
@@ -8935,10 +11103,10 @@ value. This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
<a name="g_t_005cvalue"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005csetcounter" accesskey="n" rel="next">\setcounter</a>, Previous: <a href="#g_t_005cusecounter" accesskey="p" rel="prev">\usecounter</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005csetcounter" accesskey="n" rel="next">\setcounter</a>, Previous: <a href="#g_t_005cusecounter" accesskey="p" rel="prev">\usecounter</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cvalue_007bcounter_007d"></a>
-<h3 class="section">13.3 <code>\value{<var>counter</var>}</code></h3>
+<a name="g_t_005cvalue-1"></a>
+<h3 class="section">13.3 <code>\value</code></h3>
<a name="index-_005cvalue"></a>
<a name="index-counters_002c-getting-value-of"></a>
@@ -8949,13 +11117,8 @@ Next: <a href="#g_t_005csetcounter" accesskey="n" rel="next">\setcounter</a>, Pr
<pre class="example">\value{<var>counter</var>}
</pre></div>
-<p>This command expands to the value of <var>counter</var>. It is often used
-in <code>\setcounter</code> or <code>\addtocounter</code>, but <code>\value</code> can
-be used anywhere that LaTeX expects a number. It must not be
-preceded by <code>\protect</code> (see <a href="#g_t_005cprotect">\protect</a>).
-</p>
-<p>The <code>\value</code> command is not used for typesetting the value of the
-counter. See <a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a>.
+<p>Expands to the value of the counter <var>counter</var>. (Note that the name
+of a counter does not begin with a backslash.)
</p>
<p>This example outputs &lsquo;<samp>Test counter is&nbsp;6. Other counter
is&nbsp;5.</samp>&rsquo;.
@@ -8969,6 +11132,14 @@ Test counter is \arabic{test}.
Other counter is \arabic{other}.
</pre></div>
+<p>The <code>\value</code> command is not used for typesetting the value of the
+counter. For that, see <a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a>.
+</p>
+<p>It is often used in <code>\setcounter</code> or <code>\addtocounter</code> but
+<code>\value</code> can be used anywhere that LaTeX expects a number, such
+as in <code>\hspace{\value{foo}\parindent}</code>. It must not be
+preceded by <code>\protect</code> (see <a href="#g_t_005cprotect">\protect</a>).
+</p>
<p>This example inserts <code>\hspace{4\parindent}</code>.
</p>
<div class="example">
@@ -8981,10 +11152,10 @@ Other counter is \arabic{other}.
<a name="g_t_005csetcounter"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005caddtocounter" accesskey="n" rel="next">\addtocounter</a>, Previous: <a href="#g_t_005cvalue" accesskey="p" rel="prev">\value</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005caddtocounter" accesskey="n" rel="next">\addtocounter</a>, Previous: <a href="#g_t_005cvalue" accesskey="p" rel="prev">\value</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005csetcounter_007bcounter_007d_007bvalue_007d"></a>
-<h3 class="section">13.4 <code>\setcounter{<var>counter</var>}{<var>value</var>}</code></h3>
+<a name="g_t_005csetcounter-1"></a>
+<h3 class="section">13.4 <code>\setcounter</code></h3>
<a name="index-_005csetcounter"></a>
<a name="index-counters_002c-setting"></a>
@@ -8996,15 +11167,17 @@ Next: <a href="#g_t_005caddtocounter" accesskey="n" rel="next">\addtocounter</a>
<pre class="example">\setcounter{<var>counter</var>}{<var>value</var>}
</pre></div>
-<p>The <code>\setcounter</code> command globally sets the value of <var>counter</var>
-to the <var>value</var> argument. Note that the counter name does not start
-with a backslash.
+<p>Globally set the counter <var>counter</var> to have the value of the
+<var>value</var> argument, which must be an integer. Thus, you can set a
+counter&rsquo;s value as <code>\setcounter{section}{5}</code>. Note that the
+counter name does not start with a backslash.
</p>
-<p>In this example the section value appears as &lsquo;<samp>V</samp>&rsquo;.
+<p>In this example if the counter <code>theorem</code> has value 12 then the
+second line will print &lsquo;<samp>XII</samp>&rsquo;.
</p>
<div class="example">
-<pre class="example">\setcounter{section}{5}
-Here it is in Roman: \Roman{section}.
+<pre class="example">\setcounter{exercise}{\value{theorem}}
+Here it is in Roman: \Roman{exercise}.
</pre></div>
@@ -9012,15 +11185,20 @@ Here it is in Roman: \Roman{section}.
<a name="g_t_005caddtocounter"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005crefstepcounter" accesskey="n" rel="next">\refstepcounter</a>, Previous: <a href="#g_t_005csetcounter" accesskey="p" rel="prev">\setcounter</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005crefstepcounter" accesskey="n" rel="next">\refstepcounter</a>, Previous: <a href="#g_t_005csetcounter" accesskey="p" rel="prev">\setcounter</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005caddtocounter_007bcounter_007d_007bvalue_007d"></a>
-<h3 class="section">13.5 <code>\addtocounter{<var>counter</var>}{<var>value</var>}</code></h3>
+<a name="g_t_005caddtocounter-1"></a>
+<h3 class="section">13.5 <code>\addtocounter</code></h3>
<a name="index-_005caddtocounter"></a>
-<p>The <code>\addtocounter</code> command globally increments <var>counter</var> by
-the amount specified by the <var>value</var> argument, which may be negative.
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\addtocounter{<var>counter</var>}{<var>value</var>&nbsp;</pre></div>
+
+<p>Globally increment <var>counter</var> by the amount specified by the
+<var>value</var> argument, which may be negative.
</p>
<p>In this example the section value appears as &lsquo;<samp>VII</samp>&rsquo;.
</p>
@@ -9035,18 +11213,23 @@ Here it is in Roman: \Roman{section}.
<a name="g_t_005crefstepcounter"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cstepcounter" accesskey="n" rel="next">\stepcounter</a>, Previous: <a href="#g_t_005caddtocounter" accesskey="p" rel="prev">\addtocounter</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cstepcounter" accesskey="n" rel="next">\stepcounter</a>, Previous: <a href="#g_t_005caddtocounter" accesskey="p" rel="prev">\addtocounter</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005crefstepcounter_007bcounter_007d"></a>
-<h3 class="section">13.6 <code>\refstepcounter{<var>counter</var>}</code></h3>
+<a name="g_t_005crefstepcounter-1"></a>
+<h3 class="section">13.6 <code>\refstepcounter</code></h3>
<a name="index-_005crefstepcounter"></a>
-<p>The <code>\refstepcounter</code> command works in the same way as
-<code>\stepcounter</code> (see <a href="#g_t_005cstepcounter">\stepcounter</a>): it globally increments the
-value of <var>counter</var> by one and resets the value of any counter
-numbered within it. (For the definition of &ldquo;counters numbered
-within&rdquo;, see <a href="#g_t_005cnewcounter">\newcounter</a>.)
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\refstepcounter{<var>counter</var>}
+</pre></div>
+
+<p>Globally increments the value of <var>counter</var> by one, as does
+<code>\stepcounter</code> (see <a href="#g_t_005cstepcounter">\stepcounter</a>). The difference is that this
+command resets the value of any counter numbered within it. (For the
+definition of &ldquo;counters numbered within&rdquo;, see <a href="#g_t_005cnewcounter">\newcounter</a>.)
</p>
<p>In addition, this command also defines the current <code>\ref</code> value
to be the result of <code>\thecounter</code>.
@@ -9059,46 +11242,66 @@ locally, i.e., inside the current group.
<a name="g_t_005cstepcounter"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cday-_005cmonth-_005cyear" accesskey="n" rel="next">\day \month \year</a>, Previous: <a href="#g_t_005crefstepcounter" accesskey="p" rel="prev">\refstepcounter</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cday-_0026-_005cmonth-_0026-_005cyear" accesskey="n" rel="next">\day &amp; \month &amp; \year</a>, Previous: <a href="#g_t_005crefstepcounter" accesskey="p" rel="prev">\refstepcounter</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cstepcounter_007bcounter_007d"></a>
-<h3 class="section">13.7 <code>\stepcounter{<var>counter</var>}</code></h3>
+<a name="g_t_005cstepcounter-1"></a>
+<h3 class="section">13.7 <code>\stepcounter</code></h3>
<a name="index-_005cstepcounter"></a>
-<p>The <code>\stepcounter</code> command globally adds one to <var>counter</var> and
-resets all counters numbered within it. (For the definition of
-&ldquo;counters numbered within&rdquo;, see <a href="#g_t_005cnewcounter">\newcounter</a>.)
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\stepcounter{<var>counter</var>}
+</pre></div>
+
+<p>Globally adds one to <var>counter</var> and resets all counters numbered
+within it. (For the definition of &ldquo;counters numbered within&rdquo;,
+see <a href="#g_t_005cnewcounter">\newcounter</a>.)
+</p>
+<p>This command differs from <code>\refstepcounter</code> in that this one does
+not influence references&nbsp;&mdash; it does not define the current
+<code>\ref</code> value to be the result of <code>\thecounter</code>
+(see <a href="#g_t_005crefstepcounter">\refstepcounter</a>).
</p>
<hr>
-<a name="g_t_005cday-_005cmonth-_005cyear"></a>
+<a name="g_t_005cday-_0026-_005cmonth-_0026-_005cyear"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cstepcounter" accesskey="p" rel="prev">\stepcounter</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cstepcounter" accesskey="p" rel="prev">\stepcounter</a>, Up: <a href="#Counters" accesskey="u" rel="up">Counters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cday-_005cmonth-_005cyear_003a-Predefined-counters"></a>
-<h3 class="section">13.8 <code>\day \month \year</code>: Predefined counters</h3>
+<a name="g_t_005cday-_0026-_005cmonth-_0026-_005cyear-1"></a>
+<h3 class="section">13.8 <code>\day</code> &amp; <code>\month</code> &amp; <code>\year</code></h3>
<a name="index-_005cday"></a>
<a name="index-_005cmonth"></a>
<a name="index-_005cyear"></a>
-<p>LaTeX defines counters for the day of the month (<code>\day</code>,
-1&ndash;31), month of the year (<code>\month</code>, 1&ndash;12), and year
-(<code>\year</code>, Common Era). When TeX starts up, they are
-set to the current values on the system where TeX is running. They
-are not updated as the job progresses.
+<p>LaTeX defines the counter <code>\day</code> for the day of the month
+(nominally with value between 1 and 31), <code>\month</code> for the month of
+the year (nominally with value between 1 and 12), and year <code>\year</code>.
+When TeX starts up, they are set from the current values on the
+system. The related command <code>\today</code> produces a string
+representing the current day (see <a href="#g_t_005ctoday">\today</a>).
+</p>
+<p>They counters are not updated as the job progresses so in principle they
+could be incorrect by the end. In addition, TeX does no sanity
+check:
</p>
-<p>The related command <code>\today</code> produces a string representing the
-current day (see <a href="#g_t_005ctoday">\today</a>).
+<div class="example">
+<pre class="example">\day=-2 \month=13 \year=-4 \today
+</pre></div>
+
+<p>gives no error or warning and results in the output &lsquo;<samp>-2, -4</samp>&rsquo; (the
+bogus month value produces no output).
</p>
<hr>
<a name="Lengths"></a>
<div class="header">
<p>
-Next: <a href="#Making-paragraphs" accesskey="n" rel="next">Making paragraphs</a>, Previous: <a href="#Counters" accesskey="p" rel="prev">Counters</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Making-paragraphs" accesskey="n" rel="next">Making paragraphs</a>, Previous: <a href="#Counters" accesskey="p" rel="prev">Counters</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Lengths-1"></a>
<h2 class="chapter">14 Lengths</h2>
@@ -9108,30 +11311,107 @@ Next: <a href="#Making-paragraphs" accesskey="n" rel="next">Making paragraphs</a
<p>A <em>length</em> is a measure of distance. Many LaTeX commands take a
length as an argument.
</p>
+<p>This shows a box of the given length.
+</p>
+<div class="example">
+<pre class="example">\newcommand{\blackbar}[1]{\rule{#1}{10pt}} % make a bar
+\newcommand{\showhbox}[2]{\fboxsep=0pt\fbox{\hbox to #1{#2}}} % box it
+XXX\showhbox{100pt}{\blackbar{100pt}}YYY
+</pre></div>
+
+<p>It produces a black bar 100&nbsp;points long between &lsquo;<samp>XXX</samp>&rsquo; and
+&lsquo;<samp>YYY</samp>&rsquo;.
+</p>
<p>Lengths come in two types. A <em>rigid length</em> (what Plain TeX
-calls a <em>dimen</em>) such as <code>10pt</code> cannot contain a <code>plus</code> or
-<code>minus</code> component. A <em>rubber length</em> (what Plain TeX calls
-a <em>skip</em>) can contain those, as with <code>1cm plus0.05cm
-minus0.01cm</code>. These give the ability to stretch or shrink; the length
-in the prior sentence could appear in the output as long as 1.05&nbsp;cm
-or as short as 0.99&nbsp;cm, depending on what TeX&rsquo;s typesetting
-algorithm finds optimum.
+calls a <em>dimen</em>) such as <code>10pt</code> does not contain a <code>plus</code>
+or <code>minus</code> component. The above example shows a rigid length. A
+<em>rubber length</em> (what Plain TeX calls a <em>skip</em>) can contain
+those components, as with <code>1cm plus0.05cm minus0.01cm</code>. Here the
+<code>1cm</code> is the <em>natural length</em> while the other two, the
+<code>plus</code> and <code>minus</code> components, allow the length to stretch or
+shrink.
+</p>
+<p>Shrinking is simpler: with <code>1cm minus 0.05cm</code>, the natural length
+is 1cm but if smaller is needed then TeX can shrink it down as
+far as 0.95cm. Beyond that, TeX refuses to shrink any more.
+Thus, below the first one works fine, producing a space of
+98&nbsp;points between the two bars.
+</p>
+<div class="example">
+<pre class="example">XXX\showhbox{300pt}{%
+ \blackbar{101pt}\hspace{100pt minus 2pt}\blackbar{101pt}}YYY
+
+XXX\showhbox{300pt}{%
+ \blackbar{105pt}\hspace{100pt minus 1pt}\blackbar{105pt}}YYY
+</pre></div>
+
+<p>But the second one gets a warning like &lsquo;<samp>Overfull \hbox (1.0pt too
+wide) detected at line 17</samp>&rsquo;. In the output the first &lsquo;<samp>Y</samp>&rsquo; is
+overwritten by the end of the black bar, because the box&rsquo;s material is
+wider than the 300pt allocated, as TeX has refused to shrink
+the total to less than 309&nbsp;points.
+</p>
+<p>Stretching is like shrinking except that if TeX is asked to stretch
+beyond the given amount, it won&rsquo;t refuse. Here the first line is fine,
+producing a space of 110&nbsp;points between the bars.
+</p>
+<div class="example">
+<pre class="example">XXX\showhbox{300pt}{%
+ \blackbar{95pt}\hspace{100pt plus 10pt}\blackbar{95pt}}YYY
+
+XXX\showhbox{300pt}{%
+ \blackbar{95pt}\hspace{100pt plus 1pt}\blackbar{95pt}}YYY
+</pre></div>
+
+<p>In the second line TeX needs a stretch of 10&nbsp;points and only
+1&nbsp;point was specified. In this situation, TeX stretches the
+space to the required length, but it complains with a warning like
+&lsquo;<samp>Underfull \hbox (badness 10000) detected at line 22</samp>&rsquo;. (We won&rsquo;t
+discuss badness; the point is that the system was not given as much
+stretch as needed.)
+</p>
+<p>You can put both stretch and shrink in the same length, as in
+<code>1ex plus 0.05ex minus 0.02ex</code>.
+</p>
+<p>If TeX is setting two or more rubber lengths then it allocates the
+stretch or shrink in proportion.
+</p>
+<div class="example">
+<pre class="example">XXX\showhbox{300pt}{\blackbar{100pt}% left
+ \hspace{0pt plus 50pt}\blackbar{80pt}\hspace{0pt plus 10pt}% middle
+ \blackbar{100pt}}YYY % right
+</pre></div>
+
+<p>The outside bars take up 100&nbsp;points, so the middle needs another
+100. In the middle the bar takes up 80&nbsp;points, so the two
+<code>\hspace</code>&rsquo;s must stretch 20&nbsp;points. Because the two say
+<code>plus 50pt</code> and <code>plus 10pt</code>, TeX gets 5/6 of the
+stretch from the first space and 1/6 from the second.
</p>
<p>The <code>plus</code> or <code>minus</code> component of a rubber length can contain
a <em>fill</em> component, as in <code>1in plus2fill</code>. This gives the
-length infinite stretchability or shrinkability, so that the length in
-the prior sentence can be set by TeX to any distance greater than or
-equal to 1&nbsp;inch. TeX actually provides three infinite glue
-components <code>fil</code>, <code>fill</code>, and <code>filll</code>, such that the
-later ones overcome the earlier ones, but only the middle value is
-ordinarily used. See <a href="#g_t_005chfill">\hfill</a>, See <a href="#g_t_005cvfill">\vfill</a>.
-</p>
-<p>Multiplying an entire rubber length by a number turns it into a rigid
-length, so that after <code>\setlength{\ylength}{1in plus 0.2in}</code>
-and <code>\setlength{\zlength}{3\ylength}</code> then the value of
-<code>\zlength</code> is <code>3in</code>.
+length infinite stretchability or shrinkability so that TeX could set
+it to any distance. Here the two figures will be equal-spaced across
+the page.
</p>
+<div class="example">
+<pre class="example">\begin{minipage}{\linewidth}
+ \hspace{0pt plus 1fill}\includegraphics{godel.png}%
+ \hspace{0pt plus 1fill}\includegraphics{einstein.png}%
+ \hspace{0pt plus 1fill}
+\end{minipage}
+</pre></div>
+<p>TeX actually has three infinite glue components <code>fil</code>,
+<code>fill</code>, and <code>filll</code>. The later ones are more infinite than
+the earlier ones. Ordinarily document authors only use the middle one
+(see <a href="#g_t_005chfill">\hfill</a> and see <a href="#g_t_005cvfill">\vfill</a>).
+</p>
+<p>Multiplying a rubber length by a number turns it into a rigid length, so
+that after <code>\setlength{\ylength}{1in plus 0.2in}</code> and
+<code>\setlength{\zlength}{3\ylength}</code> then the value of
+<code>\zlength</code> is <code>3in</code>.
+</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Units-of-length" accesskey="1">Units of length</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The units that LaTeX knows.
</td></tr>
@@ -9145,8 +11425,6 @@ and <code>\setlength{\zlength}{3\ylength}</code> then the value of
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#g_t_005csettowidth" accesskey="6">\settowidth</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Set a length to the width of something.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Predefined-lengths" accesskey="7">Predefined lengths</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Lengths that are, like, predefined.
-</td></tr>
</table>
@@ -9154,7 +11432,7 @@ and <code>\setlength{\zlength}{3\ylength}</code> then the value of
<a name="Units-of-length"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005csetlength" accesskey="n" rel="next">\setlength</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005csetlength" accesskey="n" rel="next">\setlength</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Units-of-length-1"></a>
<h3 class="section">14.1 Units of length</h3>
@@ -9168,57 +11446,57 @@ math mode.
<dt><code>pt</code></dt>
<dd><a name="index-pt"></a>
<a name="index-Point"></a>
-<p>Point 1/72.27 inch. The conversion to metric units, to two decimal
+<a name="units-of-length-pt"></a><p>Point 1/72.27 inch. The conversion to metric units, to two decimal
places, is 1point = 2.85mm = 28.45cm.
</p>
</dd>
<dt><code>pc</code></dt>
<dd><a name="index-pica"></a>
<a name="index-pc"></a>
-<p>Pica, 12 pt
+<a name="units-of-length-pc"></a><p>Pica, 12 pt
</p>
</dd>
<dt><code>in</code></dt>
<dd><a name="index-in"></a>
<a name="index-inch"></a>
-<p>Inch, 72.27 pt
+<a name="units-of-length-in"></a><p>Inch, 72.27 pt
</p>
</dd>
<dt><code>bp</code></dt>
<dd><a name="index-bp"></a>
<a name="index-Big-point"></a>
-<p>Big point, 1/72 inch. This length is the definition of a point in
+<a name="units-of-length-bp"></a><p>Big point, 1/72 inch. This length is the definition of a point in
PostScript and many desktop publishing systems.
</p>
</dd>
<dt><code>cm</code></dt>
<dd><a name="index-Centimeter"></a>
<a name="index-cm"></a>
-<p>Centimeter
+<a name="units-of-length-cm"></a><p>Centimeter
</p>
</dd>
<dt><code>mm</code></dt>
<dd><a name="index-Millimeter"></a>
<a name="index-mm"></a>
-<p>Millimeter
+<a name="units-of-length-mm"></a><p>Millimeter
</p>
</dd>
<dt><code>dd</code></dt>
<dd><a name="index-Didot-point"></a>
<a name="index-dd"></a>
-<p>Didot point, 1.07 pt
+<a name="units-of-length-dd"></a><p>Didot point, 1.07 pt
</p>
</dd>
<dt><code>cc</code></dt>
<dd><a name="index-Cicero"></a>
<a name="index-cc"></a>
-<p>Cicero, 12 dd
+<a name="units-of-length-cc"></a><p>Cicero, 12 dd
</p>
</dd>
<dt><code>sp</code></dt>
<dd><a name="index-Scaled-point"></a>
<a name="index-sp"></a>
-<p>Scaled point, 1/65536 pt
+<a name="units-of-length-sp"></a><p>Scaled point, 1/65536 pt
</p>
</dd>
</dl>
@@ -9229,9 +11507,9 @@ PostScript and many desktop publishing systems.
<a name="index-m_002dwidth"></a>
<a name="index-em"></a>
<a name="index-em-1"></a>
-<p>Two other lengths that are often used are values set by the designer of
+<a name="Lengths_002fem"></a><a name="Lengths_002fen"></a><a name="Lengths_002fex"></a><a name="units-of-length-em"></a><a name="units-of-length-en"></a><a name="units-of-length-ex"></a><p>Two other lengths that are often used are values set by the designer of
the font. The x-height of the current font <em>ex</em>, traditionally the
-height of the lower case letter x, is often used for vertical
+height of the lowercase letter x, is often used for vertical
lengths. Similarly <em>em</em>, traditionally the width of the capital
letter M, is often used for horizontal lengths (there is also
<code>\enspace</code>, which is <code>0.5em</code>). Use of these can help make a
@@ -9252,7 +11530,7 @@ math symbols family. See <a href="#Spacing-in-math-mode">Spacing in math mode</
<a name="g_t_005csetlength"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005caddtolength" accesskey="n" rel="next">\addtolength</a>, Previous: <a href="#Units-of-length" accesskey="p" rel="prev">Units of length</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005caddtolength" accesskey="n" rel="next">\addtolength</a>, Previous: <a href="#Units-of-length" accesskey="p" rel="prev">Units of length</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005csetlength-1"></a>
<h3 class="section">14.2 <code>\setlength</code></h3>
@@ -9263,21 +11541,33 @@ Next: <a href="#g_t_005caddtolength" accesskey="n" rel="next">\addtolength</a>,
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\setlength{<var>\len</var>}{<var>amount</var>}
+<pre class="example">\setlength{<var>len</var>}{<var>amount</var>}
+</pre></div>
+
+<p>Set the length <var>len</var> to <var>amount</var>. The length name <var>len</var>
+must begin with a backslash, <code>\</code>. The <code>amount</code> can be a
+rubber length (see <a href="#Lengths">Lengths</a>). It can be positive, negative or zero,
+and can be in any units that LaTeX understands (see <a href="#Units-of-length">Units of length</a>).
+</p>
+<p>Below, with LaTeX&rsquo;s defaults the first paragraph will be indented
+while the second will not.
+</p>
+<div class="example">
+<pre class="example">I told the doctor I broke my leg in two places.
+
+\setlength{\parindent}{0em}
+He said stop going to those places.
</pre></div>
-<p>The <code>\setlength</code> sets the value of <em>length command</em>
-<a name="index-length-command"></a>
-<code>\<var>len</var></code> to the <var>value</var> argument which can be expressed in any
-units that LaTeX understands, i.e., inches (<code>in</code>), millimeters
-(<code>mm</code>), points (<code>pt</code>), big points (<code>bp</code>), etc.
+<p>If there is no such length <var>len</var> then you get something like
+&lsquo;<samp>Undefined control sequence. &lt;argument&gt; \praindent</samp>&rsquo;.
</p>
<hr>
<a name="g_t_005caddtolength"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005csettodepth" accesskey="n" rel="next">\settodepth</a>, Previous: <a href="#g_t_005csetlength" accesskey="p" rel="prev">\setlength</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005csettodepth" accesskey="n" rel="next">\settodepth</a>, Previous: <a href="#g_t_005csetlength" accesskey="p" rel="prev">\setlength</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005caddtolength-1"></a>
<h3 class="section">14.3 <code>\addtolength</code></h3>
@@ -9288,20 +11578,37 @@ Next: <a href="#g_t_005csettodepth" accesskey="n" rel="next">\settodepth</a>, Pr
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\addtolength{<var>\len</var>}{<var>amount</var>}
+<pre class="example">\addtolength{<var>len</var>}{<var>amount</var>}
</pre></div>
+<p>Increment the length <var>len</var> by <var>amount</var>. The length name
+<var>len</var> begins with a backslash, <code>\</code>. The <code>amount</code> is a
+rubber length (see <a href="#Lengths">Lengths</a>). It can be positive, negative or zero,
+and can be in any units that LaTeX understands (see <a href="#Units-of-length">Units of length</a>).
+</p>
+<p>Below, if <code>\parskip</code> starts with the value <code>0pt plus 1pt</code>
+</p>
+<div class="example">
+<pre class="example">\addtolength{\parskip}{1pt}
+Doctor: how is the boy who swallowed the silver dollar?
-<p>The <code>\addtolength</code> command increments a length command <code>\<var>len</var></code>
-by the amount specified in the <var>amount</var> argument, which may be
-negative.
+Nurse: no change.
+</pre></div>
+
+<p>then it has the value <code>1pt plus 1pt</code> for the second paragraph.
+</p>
+<p>If there is no such length <var>len</var> then you get something like
+&lsquo;<samp>Undefined control sequence. &lt;argument&gt; \praindent</samp>&rsquo;. If you leave
+off the backslash at the start of <var>len</var>, as in
+<code>\addtolength{parindent}{1pt}</code>, then you get something like
+&lsquo;<samp>You can't use `the letter p' after \advance</samp>&rsquo;.
</p>
<hr>
<a name="g_t_005csettodepth"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005csettoheight" accesskey="n" rel="next">\settoheight</a>, Previous: <a href="#g_t_005caddtolength" accesskey="p" rel="prev">\addtolength</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005csettoheight" accesskey="n" rel="next">\settoheight</a>, Previous: <a href="#g_t_005caddtolength" accesskey="p" rel="prev">\addtolength</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005csettodepth-1"></a>
<h3 class="section">14.4 <code>\settodepth</code></h3>
@@ -9311,18 +11618,33 @@ Next: <a href="#g_t_005csettoheight" accesskey="n" rel="next">\settoheight</a>,
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\settodepth{\<var>len</var>}{<var>text</var>}
+<pre class="example">\settodepth{<var>len</var>}{<var>text</var>}
+</pre></div>
+
+<p>Set the length <var>len</var> to the depth of box that LaTeX gets on
+typesetting the <var>text</var> argument. The length name <var>len</var> must
+begin with a backslash, <code>\</code>.
+</p>
+<p>This will show how low the character descenders go.
+</p>
+<div class="example">
+<pre class="example">\newlength{\alphabetdepth}
+\settodepth{\alphabetdepth}{abcdefghijklmnopqrstuvwxyz}
+\the\alphabetdepth
</pre></div>
-<p>The <code>\settodepth</code> command sets the value of a length command
-<code>\<var>len</var></code> equal to the depth of the <var>text</var> argument.
+<p>If there is no such length <var>len</var> then you get something like
+&lsquo;<samp>Undefined control sequence. &lt;argument&gt; \alphabetdepth</samp>&rsquo;. If you
+leave the backslash out of <var>len</var>, as in
+<code>\settodepth{alphabetdepth}{...}</code> then you get something like
+&lsquo;<samp>Missing number, treated as zero. &lt;to be read again&gt; \setbox</samp>&rsquo;.
</p>
<hr>
<a name="g_t_005csettoheight"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005csettowidth" accesskey="n" rel="next">\settowidth</a>, Previous: <a href="#g_t_005csettodepth" accesskey="p" rel="prev">\settodepth</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005csettowidth" accesskey="n" rel="next">\settowidth</a>, Previous: <a href="#g_t_005csettodepth" accesskey="p" rel="prev">\settodepth</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005csettoheight-1"></a>
<h3 class="section">14.5 <code>\settoheight</code></h3>
@@ -9332,75 +11654,78 @@ Next: <a href="#g_t_005csettowidth" accesskey="n" rel="next">\settowidth</a>, Pr
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\settoheight{\<var>len</var>}{text}
+<pre class="example">\settoheight{<var>len</var>}{text}
</pre></div>
-<p>The <code>\settoheight</code> command sets the value of a length command <code>\<var>len</var></code>
-equal to the height of the <code>text</code> argument.
+<p>Sets the length <var>len</var> to the height of box that LaTeX gets on
+typesetting the <code>text</code> argument. The length name <var>len</var> must
+begin with a backslash, <code>\</code>.
+</p>
+<p>This will show how high the characters go.
</p>
+<div class="example">
+<pre class="example">\newlength{\alphabetheight}
+\settoheight{\alphabetheight}{abcdefghijklmnopqrstuvwxyz}
+\the\alphabetheight
+</pre></div>
+<p>If there is no such length <var>len</var> then you get something like
+&lsquo;<samp>Undefined control sequence. &lt;argument&gt; \alphabetheight</samp>&rsquo;. If you
+leave the backslash out of <var>len</var>, as in
+<code>\settoheight{alphabetheight}{...}</code> then you get something like
+&lsquo;<samp>Missing number, treated as zero. &lt;to be read again&gt; \setbox</samp>&rsquo;.
+</p>
<hr>
<a name="g_t_005csettowidth"></a>
<div class="header">
<p>
-Next: <a href="#Predefined-lengths" accesskey="n" rel="next">Predefined lengths</a>, Previous: <a href="#g_t_005csettoheight" accesskey="p" rel="prev">\settoheight</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005csettoheight" accesskey="p" rel="prev">\settoheight</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005csettowidth_007b_005clen_007d_007btext_007d"></a>
-<h3 class="section">14.6 <code>\settowidth{\<var>len</var>}{<var>text</var>}</code></h3>
+<a name="g_t_005csettowidth-1"></a>
+<h3 class="section">14.6 <code>\settowidth</code></h3>
<a name="index-_005csettowidth"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\settowidth{\<var>len</var>}{<var>text</var>}
+<pre class="example">\settowidth{<var>len</var>}{<var>text</var>}
</pre></div>
-<p>The <code>\settowidth</code> command sets the value of the command <var>\len</var>
-to the width of the <var>text</var> argument.
-</p>
-
-<hr>
-<a name="Predefined-lengths"></a>
-<div class="header">
-<p>
-Previous: <a href="#g_t_005csettowidth" accesskey="p" rel="prev">\settowidth</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="Predefined-lengths-1"></a>
-<h3 class="section">14.7 Predefined lengths</h3>
-
-<a name="index-lengths_002c-predefined"></a>
-<a name="index-predefined-lengths"></a>
-
-<p><code>\width</code>
-<a name="index-_005cwidth"></a>
-</p>
-<p><code>\height</code>
-<a name="index-_005cheight"></a>
-</p>
-<p><code>\depth</code>
-<a name="index-_005cdepth"></a>
-</p>
-<p><code>\totalheight</code>
-<a name="index-_005ctotalheight"></a>
+<p>Set the length <var>len</var> to the width of the box that LaTeX gets on
+typesetting the <var>text</var> argument. The length name <var>len</var> must
+begin with a backslash, <code>\</code>.
</p>
-<p>These length parameters can be used in the arguments of the box-making
-commands (see <a href="#Boxes">Boxes</a>). They specify the natural width, etc., of
-the text in the box. <code>\totalheight</code> equals <em><code>\height</code> +
-<code>\depth</code></em>. To make a box with the text stretched to double the
-natural size, e.g., say
+<p>This measures the width of the lowercase ASCII alphabet.
</p>
<div class="example">
-<pre class="example">\makebox[2\width]{Get a stretcher}
+<pre class="example">\newlength{\alphabetwidth}
+\settowidth{\alphabetwidth}{abcdefghijklmnopqrstuvwxyz}
+\the\alphabetwidth
</pre></div>
+<p>If there is no such length <var>len</var> then you get something like
+&lsquo;<samp>Undefined control sequence. &lt;argument&gt; \alphabetwidth</samp>&rsquo;. If you
+leave the backslash out of <var>len</var>, as in
+<code>\settoheight{alphabetwidth}{...}</code> then you get something like
+&lsquo;<samp>Missing number, treated as zero. &lt;to be read again&gt; \setbox</samp>&rsquo;.
+</p>
+
+
+
+
+
+
+
+
+
<hr>
<a name="Making-paragraphs"></a>
<div class="header">
<p>
-Next: <a href="#Math-formulas" accesskey="n" rel="next">Math formulas</a>, Previous: <a href="#Lengths" accesskey="p" rel="prev">Lengths</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Math-formulas" accesskey="n" rel="next">Math formulas</a>, Previous: <a href="#Lengths" accesskey="p" rel="prev">Lengths</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Making-paragraphs-1"></a>
<h2 class="chapter">15 Making paragraphs</h2>
@@ -9408,59 +11733,166 @@ Next: <a href="#Math-formulas" accesskey="n" rel="next">Math formulas</a>, Previ
<a name="index-making-paragraphs"></a>
<a name="index-paragraphs"></a>
-<p>A paragraph is ended by one or more completely blank lines&mdash;lines not
-containing even a <code>%</code>. A blank line should not appear where a new
-paragraph cannot be started, such as in math mode or in the argument of
-a sectioning command.
+<p>Once LaTeX has all of a paragraph&rsquo;s contents it divides it into
+lines, in a way that is optimized over the entire paragraph (see <a href="#Line-breaking">Line breaking</a>). To end the current paragraph, put an empty line.
+</p>
+<div class="example">
+<pre class="example">It is a truth universally acknowledged, that a single man in possession
+of a good fortune, must be in want of a wife.
+
+However little known the feelings or views of such a man may be on his
+first entering a neighbourhood, this truth is so well fixed in the minds
+of the surrounding families, that he is considered the rightful property
+of some one or other of their daughters.
+
+``My dear Mr. Bennet,'' said his lady to him one day,
+``have you heard that Netherfield Park is let at last?''
+</pre></div>
+
+<p>The separator lines must be empty, including not containing a comment
+character, <code>%</code>.
+</p>
+<p>There are places where a new paragraph is not permitted. Don&rsquo;t put a
+blank line in math mode (see <a href="#Modes">Modes</a>); here the line before the
+<code>\end{equation}</code>
+</p>
+<div class="example">
+<pre class="example">\begin{equation}
+ 2^{|S|} &gt; |S|
+
+\end{equation}
+</pre></div>
+
+<p>will get you the error &lsquo;<samp>Missing $ inserted</samp>&rsquo;. Similarly, the blank
+line in this <code>section</code> argument
</p>
+<div class="example">
+<pre class="example">\section{aaa
+
+bbb}
+</pre></div>
+
+<p>gets &lsquo;<samp>Runaway argument? {aaa ! Paragraph ended before \@sect was
+complete</samp>&rsquo;.
+</p>
+
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cindent" accesskey="1">\indent</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Indent this paragraph.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cpar" accesskey="1">\par</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">End the current paragraph.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cnoindent" accesskey="2">\noindent</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Do not indent this paragraph.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cindent-_0026-_005cnoindent" accesskey="2">\indent &amp; \noindent</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Go into horizontal mode, possibly with an indent.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cparskip" accesskey="3">\parskip</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Space added before paragraphs.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cparindent-_0026-_005cparskip" accesskey="3">\parindent &amp; \parskip</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Space added before paragraphs.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Marginal-notes" accesskey="4">Marginal notes</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Putting remarks in the margin.
+<tr><td align="left" valign="top">&bull; <a href="#Marginal-notes" accesskey="4">Marginal notes</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Put remarks in the margin.
</td></tr>
</table>
<hr>
-<a name="g_t_005cindent"></a>
+<a name="g_t_005cpar"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cnoindent" accesskey="n" rel="next">\noindent</a>, Up: <a href="#Making-paragraphs" accesskey="u" rel="up">Making paragraphs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cindent-_0026-_005cnoindent" accesskey="n" rel="next">\indent &amp; \noindent</a>, Up: <a href="#Making-paragraphs" accesskey="u" rel="up">Making paragraphs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cindent-1"></a>
-<h3 class="section">15.1 <code>\indent</code></h3>
+<a name="g_t_005cpar-1"></a>
+<h3 class="section">15.1 <code>\par</code></h3>
-<a name="index-_005cindent"></a>
-<a name="index-_005cparindent-1"></a>
-<a name="index-indent_002c-forcing"></a>
+<a name="index-_005cpar"></a>
+<a name="index-paragraph_002c-ending"></a>
-<p><code>\indent</code> produces a horizontal space whose width equals to the
-<code>\parindent</code> length, the normal paragraph indentation. It is used
-to add paragraph indentation where it would otherwise be suppressed.
+<p>Synopsis (note that while reading the input TeX, converts two
+consecutive newlines to a <code>\par</code>):
</p>
-<p>The default value for <code>\parindent</code> is <code>1em</code> in two-column
-mode, otherwise <code>15pt</code> for <code>10pt</code> documents, <code>17pt</code> for
-<code>11pt</code>, and <code>1.5em</code> for <code>12pt</code>.
+<div class="example">
+<pre class="example">\par
+</pre></div>
+
+<p>End the current paragraph. The usual way to separate paragraphs is with
+a blank line but the <code>\par</code> command is entirely equivalent. This
+command is robust (see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>This example uses <code>\par</code> rather than a blank line simply for
+readability.
+</p>
+<div class="example">
+<pre class="example">\newcommand{\syllabusLegalese}{%
+ \whatCheatingIs\par\whatHappensWhenICatchYou}
+</pre></div>
+
+<p>The <code>\par</code> command does nothing in LR mode or a vertical mode but
+it terminates paragraph mode, bringing LaTeX to vertical mode
+(see <a href="#Modes">Modes</a>).
+</p>
+<p>You cannot use the <code>\par</code> command in math mode or in the argument
+of many commands, such as the <code>\section</code> command (see <a href="#Making-paragraphs">Making paragraphs</a> and see <a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a>).
+</p>
+<p>The <code>\par</code> command differs from the <code>\paragraph</code> command in
+that the latter is, like <code>\section</code> or <code>\subsection</code>, a
+sectioning unit used by the standard LaTeX documents.
+</p>
+<p>The <code>\par</code> command differs from <code>\newline</code> and the line break
+double backslash, <code>\\</code>, in that \par ends the paragraph not just
+the line. It also triggers the addition of the between-paragraph
+vertical space <code>\parskip</code> (see <a href="#g_t_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</a>).
+</p>
+<p>The output from this example
+</p>
+<div class="example">
+<pre class="example">xyz
+
+\setlength{\parindent}{3in}
+\setlength{\parskip}{5in}
+\noindent test\indent test1\par test2
+</pre></div>
+
+<p>is: after &lsquo;<samp>xyz</samp>&rsquo; there is a vertical skip of 5&nbsp;inches and then
+&lsquo;<samp>test</samp>&rsquo; appears, aligned with the left margin. On the same line,
+there is an empty horizontal space of 3&nbsp;inches and then
+&lsquo;<samp>test1</samp>&rsquo; appears. Finally. there is a vertical space of
+5&nbsp;inches, followed by a fresh paragraph with a paragraph indent of
+3&nbsp;inches, and then LaTeX puts the text &lsquo;<samp>test2</samp>&rsquo;.
</p>
<hr>
-<a name="g_t_005cnoindent"></a>
+<a name="g_t_005cindent-_0026-_005cnoindent"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cparskip" accesskey="n" rel="next">\parskip</a>, Previous: <a href="#g_t_005cindent" accesskey="p" rel="prev">\indent</a>, Up: <a href="#Making-paragraphs" accesskey="u" rel="up">Making paragraphs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cparindent-_0026-_005cparskip" accesskey="n" rel="next">\parindent &amp; \parskip</a>, Previous: <a href="#g_t_005cpar" accesskey="p" rel="prev">\par</a>, Up: <a href="#Making-paragraphs" accesskey="u" rel="up">Making paragraphs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cnoindent-1"></a>
-<h3 class="section">15.2 <code>\noindent</code></h3>
+<a name="g_t_005cindent-_0026-_005cnoindent-1"></a>
+<h3 class="section">15.2 <code>\indent</code> &amp; <code>\noindent</code></h3>
+<a name="index-_005cindent"></a>
<a name="index-_005cnoindent"></a>
-<a name="index-indent_002c-suppressing"></a>
+<a name="index-_005cparindent-1"></a>
+<a name="index-indent_002c-forcing"></a>
-<p>When used at the beginning of the paragraph, this command suppresses any
-paragraph indentation, as in this example.
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\indent
+</pre></div>
+
+<p>or
+</p>
+<div class="example">
+<pre class="example">\noindent
+</pre></div>
+
+<p>Go into horizontal mode (see <a href="#Modes">Modes</a>). The <code>\indent</code> command
+first outputs an empty box whose width is <code>\parindent</code>. These
+commands are robust (see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>Ordinarily you create a new paragraph by putting in a blank line.
+See <a href="#g_t_005cpar">\par</a> for the difference between this command and <code>\par</code>. To
+start a paragraph without an indent, or to continue an interrupted
+paragraph, use <code>\noindent</code>.
+</p>
+<p>In the middle of a paragraph the <code>\noindent</code> command has no effect,
+because LaTeX is already in horizontal mode there. The
+<code>\indent</code> command&rsquo;s only effect is to output a space.
+</p>
+<p>This example starts a fresh paragraph.
</p>
<div class="example">
<pre class="example">... end of the prior paragraph.
@@ -9468,33 +11900,80 @@ paragraph indentation, as in this example.
\noindent This paragraph is not indented.
</pre></div>
-<p>It has no effect when used in the middle of a paragraph.
+<p>and this continues an interrupted paragraph.
</p>
-<p>To eliminate paragraph indentation in an entire document, put
-<code>\setlength{\parindent}{0pt}</code> in the preamble.
+<div class="example">
+<pre class="example">The data
+
+\begin{center}
+ \begin{tabular}{rl} ... \end{tabular}
+\end{center}
+
+\noindent shows this clearly.
+</pre></div>
+
+<p>To omit indentation in the entire document put
+<code>\setlength{\parindent}{0pt}</code> in the preamble. If you do that,
+you may want to also set the length of spaces between paragraphs,
+<code>\parskip</code> (see <a href="#g_t_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</a>).
+</p>
+<a name="index-package_002c-indentfirst-5"></a>
+<a name="index-indentfirst-package-5"></a>
+
+<p>Default LaTeX styles have the first paragraph after a section that is
+not indented, as is traditional typesetting in English. To change that,
+look on CTAN for the package <code>indentfirst</code>.
</p>
<hr>
-<a name="g_t_005cparskip"></a>
+<a name="g_t_005cparindent-_0026-_005cparskip"></a>
<div class="header">
<p>
-Next: <a href="#Marginal-notes" accesskey="n" rel="next">Marginal notes</a>, Previous: <a href="#g_t_005cnoindent" accesskey="p" rel="prev">\noindent</a>, Up: <a href="#Making-paragraphs" accesskey="u" rel="up">Making paragraphs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Marginal-notes" accesskey="n" rel="next">Marginal notes</a>, Previous: <a href="#g_t_005cindent-_0026-_005cnoindent" accesskey="p" rel="prev">\indent &amp; \noindent</a>, Up: <a href="#Making-paragraphs" accesskey="u" rel="up">Making paragraphs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cparskip-1"></a>
-<h3 class="section">15.3 <code>\parskip</code></h3>
+<a name="g_t_005cparindent-_0026-_005cparskip-1"></a>
+<h3 class="section">15.3 <code>\parindent</code> &amp; <code>\parskip</code></h3>
+<a name="index-_005cparindent-2"></a>
<a name="index-_005cparskip"></a>
+<a name="index-paragraph-indentation"></a>
<a name="index-vertical-space-before-paragraphs"></a>
-<p><code>\parskip</code> is a rubber length defining extra vertical space added
-before each paragraph. The default is <code>0pt plus1pt</code>.
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\setlength{\parskip}{<var>horizontal len</var>}
+\setlength{\parinden}{<var>vertical len</var>}
+</pre></div>
+
+<p>Both are a rubber lengths (see <a href="#Lengths">Lengths</a>). They give the indentation
+of ordinary paragraphs, not paragraphs inside minipages
+(see <a href="#minipage">minipage</a>), and the vertical space between paragraphs.
+</p>
+<p>This, put in the preamble,
+</p>
+<div class="example">
+<pre class="example">\setlength{\parindent}{0em}
+\setlength{\parskip}{1ex}
+</pre></div>
+
+<p>arranges that the document will have paragraphs that are not indented,
+but instead are vertically separated by about the height of a lowercase
+&lsquo;<samp>x</samp>&rsquo;.
+</p>
+<p>In standard LaTeX documents, the default value for <code>\parindent</code>
+in one-column documents is <code>15pt</code> when the default text size is
+<code>10pt</code> , <code>17pt</code> for <code>11pt</code>, and <code>1.5em</code> for
+<code>12pt</code>. In two-column documents it is <code>1em</code>. The default
+value for <code>\parskip</code> in LaTeX&rsquo;s standard document styles is
+<code>0pt plus1pt</code>.
</p>
<hr>
<a name="Marginal-notes"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cparskip" accesskey="p" rel="prev">\parskip</a>, Up: <a href="#Making-paragraphs" accesskey="u" rel="up">Making paragraphs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cparindent-_0026-_005cparskip" accesskey="p" rel="prev">\parindent &amp; \parskip</a>, Up: <a href="#Making-paragraphs" accesskey="u" rel="up">Making paragraphs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Marginal-notes-1"></a>
<h3 class="section">15.4 Marginal notes</h3>
@@ -9504,36 +11983,39 @@ Previous: <a href="#g_t_005cparskip" accesskey="p" rel="prev">\parskip</a>, Up:
<a name="index-remarks-in-the-margin"></a>
<a name="index-_005cmarginpar"></a>
-<p>Synopsis:
+<p>Synopsis, one of:
</p>
<div class="example">
-<pre class="example">\marginpar[<var>left</var>]{<var>right</var>}
+<pre class="example">\marginpar{<var>right</var>}
+\marginpar[<var>left</var>]{<var>right</var>}
</pre></div>
-<p>The <code>\marginpar</code> command creates a note in the margin. The first
-line of the note will have the same baseline as the line in the text
-where the <code>\marginpar</code> occurs.
+<p>Create a note in the margin. The first line of the note will have the
+same baseline as the line in the text where the <code>\marginpar</code>
+occurs.
</p>
-<p>When you only specify the mandatory argument <var>right</var>, the text
-will be placed
+<p>The margin that LaTeX uses for the note depends on the current layout
+(see <a href="#Document-class-options">Document class options</a>) and also on <code>\reversemarginpar</code>
+(see below). If you are using one-sided layout (document option
+<code>oneside</code>) then it goes in the right margin. If you are using
+two-sided layout (document option <code>twoside</code>) then it goes in the
+outside margin. If you are in two-column layout (document option
+<code>twocolumn</code>) then it goes in the nearest margin.
</p>
-<ul>
-<li> in the right margin for one-sided layout (option <code>oneside</code>, see <a href="#Document-class-options">Document class options</a>);
-</li><li> in the outside margin for two-sided layout (option <code>twoside</code>, see <a href="#Document-class-options">Document class options</a>);
-</li><li> in the nearest margin for two-column layout (option <code>twocolumn</code>, see <a href="#Document-class-options">Document class options</a>).
-</li></ul>
-
<a name="index-_005creversemarginpar"></a>
<a name="index-_005cnormalmarginpar"></a>
-<p>The command <code>\reversemarginpar</code> places subsequent marginal notes
-in the opposite (inside) margin. <code>\normalmarginpar</code> places them
-in the default position.
+<p>If you declare <code>\reversemarginpar</code> then LaTeX will place
+subsequent marginal notes in the opposite margin to that given in the
+prior paragraph. Revert that to the default position with
+<code>\normalmarginpar</code>.
</p>
-<p>When you specify both arguments, <var>left</var> is used for the left
-margin, and <var>right</var> is used for the right margin.
+<p>When you specify the optional argument <var>left</var> then it is used for a
+note in the left margin, while the mandatory argument <var>right</var> is
+used for a note in the the right margin.
</p>
-<p>The first word will normally not be hyphenated; you can enable
-hyphenation there by beginning the node with <code>\hspace{0pt}</code>.
+<p>Normally, a note&rsquo;s first word will not be hyphenated. You can enable
+hyphenation there by beginning <var>left</var> or <var>right</var> with
+<code>\hspace{0pt}</code>.
</p>
<p>These parameters affect the formatting of the note:
</p>
@@ -9541,21 +12023,21 @@ hyphenation there by beginning the node with <code>\hspace{0pt}</code>.
<dt><code>\marginparpush</code>
<a name="index-_005cmarginparpush-2"></a>
</dt>
-<dd><p>Minimum vertical space between notes; default &lsquo;<samp>7pt</samp>&rsquo; for
+<dd><a name="marginal-notes-marginparpush"></a><p>Minimum vertical space between notes; default &lsquo;<samp>7pt</samp>&rsquo; for
&lsquo;<samp>12pt</samp>&rsquo; documents, &lsquo;<samp>5pt</samp>&rsquo; else.
</p>
</dd>
<dt><code>\marginparsep</code>
<a name="index-_005cmarginparsep"></a>
</dt>
-<dd><p>Horizontal space between the main text and the note; default
+<dd><a name="marginal-notes-marginparsep"></a><p>Horizontal space between the main text and the note; default
&lsquo;<samp>11pt</samp>&rsquo; for &lsquo;<samp>10pt</samp>&rsquo; documents, &lsquo;<samp>10pt</samp>&rsquo; else.
</p>
</dd>
<dt><code>\marginparwidth</code>
<a name="index-_005cmarginparwidth-2"></a>
</dt>
-<dd><p>Width of the note itself; default for a one-sided &lsquo;<samp>10pt</samp>&rsquo; document
+<dd><a name="marginal-notes-marginparwidth"></a><p>Width of the note itself; default for a one-sided &lsquo;<samp>10pt</samp>&rsquo; document
is &lsquo;<samp>90pt</samp>&rsquo;, &lsquo;<samp>83pt</samp>&rsquo; for &lsquo;<samp>11pt</samp>&rsquo;, and &lsquo;<samp>68pt</samp>&rsquo; for
&lsquo;<samp>12pt</samp>&rsquo;; &lsquo;<samp>17pt</samp>&rsquo; more in each case for a two-sided document.
In two column mode, the default is &lsquo;<samp>48pt</samp>&rsquo;.
@@ -9571,7 +12053,7 @@ notes from falling off the bottom of the page.
<a name="Math-formulas"></a>
<div class="header">
<p>
-Next: <a href="#Modes" accesskey="n" rel="next">Modes</a>, Previous: <a href="#Making-paragraphs" accesskey="p" rel="prev">Making paragraphs</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Modes" accesskey="n" rel="next">Modes</a>, Previous: <a href="#Making-paragraphs" accesskey="p" rel="prev">Making paragraphs</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Math-formulas-1"></a>
<h2 class="chapter">16 Math formulas</h2>
@@ -9589,60 +12071,117 @@ Next: <a href="#Modes" accesskey="n" rel="next">Modes</a>, Previous: <a href="#M
<a name="index-equation-environment-1"></a>
-<p>There are three environments that put LaTeX in math mode:
+<p>Produce mathematical text by putting LaTeX into math mode or display
+math mode (see <a href="#Modes">Modes</a>). This example shows both.
</p>
-<dl compact="compact">
-<dt><code>math</code></dt>
-<dd><p>For formulas that appear right in the text.
-</p></dd>
-<dt><code>displaymath</code></dt>
-<dd><p>For formulas that appear on their own line.
-</p></dd>
-<dt><code>equation</code></dt>
-<dd><p>The same as the displaymath environment except that it adds an equation
-number in the right margin.
-</p></dd>
-</dl>
+<div class="example">
+<pre class="example">The wave equation for \( u \) is
+\begin{displaymath}
+ \frac{\partial^2u}{\partial t^2} = c^2\nabla^2u
+\end{displaymath}
+where \( \nabla^2 \) is the spatial Laplacian and \( c \) is constant.
+</pre></div>
-<a name="index-_005c_0028"></a>
-<a name="index-_005c_0029"></a>
-<a name="index-_005c_005b"></a>
-<a name="index-_005c_005d"></a>
-<p>The <code>math</code> environment can be used in both paragraph and LR mode,
-but the <code>displaymath</code> and <code>equation</code> environments can be used
-only in paragraph mode. The <code>math</code> and <code>displaymath</code>
-environments are used so often that they have the following short forms:
+<p>Math mode is for inline mathematics. In the above example it is invoked
+by the starting <code>\(</code> and finished by the matching ending <code>\)</code>.
+Display math mode is for displayed equations and here is invoked by the
+<code>displaymath</code> environment. Note that any mathematical text
+whatever, including mathematical text consisting of just one character,
+is handled in math mode.
+</p>
+<p>When in math mode or display math mode, LaTeX handles many aspects of
+your input text differently than in other text modes. For example,
</p>
<div class="example">
-<pre class="example">\(...\) <span class="roman">instead of</span> \begin{math}...\end{math}
-\[...\] <span class="roman">instead of</span> \begin{displaymath}...\end{displaymath}
+<pre class="example">contrast x+y with \( x+y \)
</pre></div>
-<a name="index-_0024"></a>
-<p>In fact, the <code>math</code> environment is so common that it has an even
-shorter form:
+<p>in math mode the letters are in italics and the spacing around the plus
+sign is different.
+</p>
+<p>There are three ways to make inline formulas, to put LaTeX in math
+mode.
</p>
<div class="example">
-<pre class="example">$ ... $ <span class="roman">instead of</span> \(...\)
+<pre class="example">\( <var>mathematical material</var> \)
+$ <var>mathematical material</var> $
+\begin{math} <var>mathematical material</var> \end{math}
</pre></div>
-<a name="index-_005cboldmath"></a>
-<a name="index-_005cunboldmath"></a>
-<p>The <code>\boldmath</code> command changes math letters and symbols to be in
-a bold font. It is used <em>outside</em> of math mode. Conversely, the
-<code>\unboldmath</code> command changes math glyphs to be in a normal font;
-it too is used <em>outside</em> of math mode.
+<p>The first form is preferred and the second is quite common, but the
+third form is rarely used. You can sometimes use one and sometimes
+another, as in <code>\(x\) and $y$</code>. You can use these in paragraph
+mode or in LR mode (see <a href="#Modes">Modes</a>).
</p>
-<a name="index-_005cdisplaystyle"></a>
-<p>The <code>\displaystyle</code> declaration forces the size and style of the
-formula to be that of <code>displaymath</code>, e.g., with limits above and
-below summations. For example:
+<p>To make displayed formulas, put LaTeX into display math mode with
+either:
</p>
<div class="example">
-<pre class="example">$\displaystyle \sum_{n=0}^\infty x_n $
+<pre class="example">\begin{displaymath}
+ <var>mathematical material</var>
+\end{displaymath}
</pre></div>
+<p>or
+</p>
+<div class="example">
+<pre class="example">\begin{equation}
+ <var>mathematical material</var>
+\end{equation}
+</pre></div>
+
+<p>(see <a href="#displaymath">displaymath</a>, see <a href="#equation">equation</a>). The only difference is that
+with the <code>equation</code> environment, LaTeX puts a formula number
+alongside the formula. The construct <code>\[ <var>math</var> \]</code> is
+equivalent to <code>\begin{displaymath} <var>math</var>
+\end{displaymath}</code>. These environments can only be used in paragraph
+mode (see <a href="#Modes">Modes</a>).
+</p>
+<a name="index-_005cdisplaystyle"></a>
+<p>The two mathematics modes are similar, but there are some differences.
+One involves the placement of subscripts and superscripts; in display
+math mode they are further apart and in inline math mode they are closer
+together.
+</p>
+<p>Sometimes you want the display math typographical treatment to happen in
+the inline math mode. For this, the <code>\displaystyle</code> declaration
+forces the size and style of the formula to be that of
+<code>displaymath</code>. Thus <code>\(\displaystyle \sum_{n=0}^\infty
+x_n\)</code> will have the limits above and below the summation sign, not next
+to it. Another example is that
+</p>
+<div class="example">
+<pre class="example">\begin{tabular}{r|cc}
+ \textsc{Name} &amp;\textsc{Series} &amp;\textsc{Sum} \\ \hline
+ Arithmetic &amp;\( a+(a+b)+(a+2b)+\cdots+(a+(n-1)b) \)
+ &amp;\( na+(n-1)n\cdot\frac{b}{2}\) \\
+ Geometric &amp;\( a+ab+ab^2+\cdots+ab^{n-1} \)
+ &amp;\(\displaystyle a\cdot\frac{1-b^n}{1-b}\) \\
+\end{tabular}
+</pre></div>
+
+<p>because it has no <code>\displaystyle</code>, the &lsquo;<samp>Arithmetic</samp>&rsquo; line&rsquo;s
+fraction will be scrunched. But, because of its <code>\displaystyle</code>,
+the &lsquo;<samp>Geometric</samp>&rsquo; line&rsquo;s fraction will be easy to read, with
+characters the same size as in the rest of the line.
+</p>
+<a name="index-package_002c-amsmath-5"></a>
+<a name="index-amsmath-package-5"></a>
+
+<a name="index-package_002c-amsfonts"></a>
+<a name="index-amsfonts-package"></a>
+
+<a name="index-package_002c-mathtools"></a>
+<a name="index-mathtools-package"></a>
+<p>The American Mathematical Society has made freely available a set of
+packages that greatly expand your options for writing mathematics,
+<samp>amsmath</samp> and <samp>amssymb</samp> (also be aware of the <samp>mathtools</samp>
+package that is an extension to, and loads, <samp>amsmath</samp>). New
+documents that will have mathematical text should use these packages.
+Descriptions of these packages is outside the scope of this document;
+see their documentation on CTAN.
+</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Subscripts-_0026-superscripts" accesskey="1">Subscripts &amp; superscripts</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Also known as exponent or index.
</td></tr>
@@ -9652,9 +12191,11 @@ below summations. For example:
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Math-accents" accesskey="4">Math accents</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Accents in math.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Spacing-in-math-mode" accesskey="5">Spacing in math mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Thick, medium, thin and negative spaces.
+<tr><td align="left" valign="top">&bull; <a href="#Over_002d-and-Underlining" accesskey="5">Over- and Underlining</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Things over or under formulas.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#Spacing-in-math-mode" accesskey="6">Spacing in math mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Thick, medium, thin, and negative spaces.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Math-miscellany" accesskey="6">Math miscellany</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Stuff that doesn&rsquo;t fit anywhere else.
+<tr><td align="left" valign="top">&bull; <a href="#Math-miscellany" accesskey="7">Math miscellany</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Stuff that doesn&rsquo;t fit anywhere else.
</td></tr>
</table>
@@ -9663,7 +12204,7 @@ below summations. For example:
<a name="Subscripts-_0026-superscripts"></a>
<div class="header">
<p>
-Next: <a href="#Math-symbols" accesskey="n" rel="next">Math symbols</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Math-symbols" accesskey="n" rel="next">Math symbols</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Subscripts-_0026-superscripts-1"></a>
<h3 class="section">16.1 Subscripts &amp; superscripts</h3>
@@ -9674,48 +12215,86 @@ Next: <a href="#Math-symbols" accesskey="n" rel="next">Math symbols</a>, Up: <a
<a name="index-_005f"></a>
<a name="index-_005e"></a>
-<p>In math mode, use the caret character&nbsp;<code>^</code> to make the
-<var>exp</var> appear as a superscript: <code>^{<var>exp</var>}</code>.
-Similarly, in math mode, underscore&nbsp;<code>_{<var>exp</var>}</code> makes a
-subscript out of <var>exp</var>.
+<p>Synopsis (in math mode or display math mode), one of:
</p>
-<p>In this example the <code>0</code> and <code>1</code> appear as subscripts while the
-<code>2</code> is a superscript.
+<div class="example">
+<pre class="example"><var>base</var>^<var>exp</var>
+<var>base</var>^{<var>exp</var>}
+</pre></div>
+
+<p>or, one of:
</p>
<div class="example">
-<pre class="example">\( (x_0+x_1)^2 \)
+<pre class="example"><var>base</var>_<var>exp</var>
+<var>base</var>_{<var>exp</var>}
</pre></div>
-<p>To have more than one character in <var>exp</var> use curly braces as in
-<code>e^{-2x}</code>.
+<p>Make <var>exp</var> appear as a superscript of <var>base</var> (with the caret
+character,&nbsp;<code>^</code>) or a subscript (with
+underscore,&nbsp;<code>_</code>).
+</p>
+<p>In this example the <code>0</code>&rsquo;s and <code>1</code>&rsquo;s are subscripts while the
+<code>2</code>&rsquo;s are superscripts.
+</p>
+<div class="example">
+<pre class="example">\( (x_0+x_1)^2 \leq (x_0)^2+(x_1)^2 \)
+</pre></div>
+
+<p>To have the subscript or superscript contain more than one character,
+surround the expression with curly braces, as in <code>e^{-2x}</code>.
+This example&rsquo;s fourth line shows curly braces used to group an expression
+for the exponent.
</p>
-<p>LaTeX handles superscripts on superscripts, and all of that stuff, in
-the natural way, so expressions such as <code>e^{x^2}</code> and
-<code>x_{a_0}</code> will look right. It also does the right thing when
-something has both a subscript and a superscript. In this example the
-<code>0</code> appears at the bottom of the integral sign while the <code>10</code>
-appears at the top.
-</p>
<div class="example">
-<pre class="example">\int_0^{10} x^2 \,dx
+<pre class="example">\begin{displaymath}
+ (3^3)^3=27^3=19\,683
+ \qquad
+ 3^{(3^3)}=3^{27}=7\,625\,597\,484\,987
+\end{displaymath}
</pre></div>
-<p>You can put a superscript or subscript before a symbol with a construct
-such as <code>{}_t K^2</code> in math mode (the initial <code>{}</code> prevents
-the prefixed subscript from being attached to any prior symbols in the
-expression).
+<p>LaTeX knows how to handle a superscript on a superscript, or a
+subscript on a subscript, or supers on subs, or subs on supers. So,
+expressions such as <code>e^{x^2}</code> and <code>x_{i_0}</code> give correct
+output. Note the use in those expressions of curly braces to give the
+<var>base</var> a determined <var>exp</var>. If you enter <code>\(3^3^3\)</code> then
+you get &lsquo;<samp>Double superscript</samp>&rsquo;.
</p>
-<p>Outside of math mode, a construct like <code>A
-test$_\textnormal{subscript}$</code> will produce a subscript typeset in
-text mode, not math mode. Note that there are packages specialized for
-writing Chemical formulas such as <samp>mhchem</samp>.
+<p>LaTeX does the right thing when something has both a subscript and a
+superscript. In this example the integral has both. They come out in
+the correct place without any author intervention.
+</p>
+<div class="example">
+<pre class="example">\begin{displaymath}
+ \int_{x=a}^b f'(x)\,dx = f(b)-f(a)
+\end{displaymath}
+</pre></div>
+
+<p>Note the parentheses around <code>x=a</code> to make the entire expression a
+subscript.
+</p>
+<p>To put a superscript or subscript before a symbol, use a construct like
+<code>{}_t K^2</code>. The empty curly braces <code>{}</code> give the
+subscript something to attach to and keeps it from accidentally
+attaching to a prior symbols.
+</p>
+<p>Using the subscript or superscript command outside of math mode or
+display math mode, as in <code>the expression x^2</code>, will get you
+the error &lsquo;<samp>Missing $ inserted</samp>&rsquo;.
+</p>
+<a name="index-package_002c-mhchem"></a>
+<a name="index-mhchem-package"></a>
+
+<p>A common reason to want subscripts outside of a mathematics mode is to
+typeset chemical formulas. There are packages for that such as
+<samp>mhchem</samp>; see CTAN.
</p>
<hr>
<a name="Math-symbols"></a>
<div class="header">
<p>
-Next: <a href="#Math-functions" accesskey="n" rel="next">Math functions</a>, Previous: <a href="#Subscripts-_0026-superscripts" accesskey="p" rel="prev">Subscripts &amp; superscripts</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Math-functions" accesskey="n" rel="next">Math functions</a>, Previous: <a href="#Subscripts-_0026-superscripts" accesskey="p" rel="prev">Subscripts &amp; superscripts</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Math-symbols-1"></a>
<h3 class="section">16.2 Math symbols</h3>
@@ -9724,21 +12303,24 @@ Next: <a href="#Math-functions" accesskey="n" rel="next">Math functions</a>, Pre
<a name="index-symbols_002c-math"></a>
<a name="index-greek-letters"></a>
-<p>LaTeX provides almost any mathematical symbol you&rsquo;re likely to need.
-For example, if you include <code>$\pi$</code> in your source, you will get
-the pi symbol &#x03C0;.
-</p>
-<p>Below is a list of commonly-available symbols. It is by no means an
-exhaustive list. Each symbol here is described with a short phrase, and
-its symbol class (which determines the spacing around it) is given in
-parenthesis. Unless said otherwise, the commands for these symbols can
-be used only in math mode.
+<a name="index-package_002c-symbols"></a>
+<a name="index-symbols-package"></a>
+
+
+<p>LaTeX provides almost any mathematical or technical symbol that
+anyone uses. For example, if you include <code>$\pi$</code> in your source,
+you will get the pi symbol &#x03C0;. See the <samp>Comprehensive
+LaTeX Symbol List</samp> at
+<a href="https://ctan.org/tex-archive/info/symbols/comprehensive/">https://ctan.org/tex-archive/info/symbols/comprehensive/</a>.
</p>
-<p>To redefine a command so that it can be used whatever the current mode,
-see <a href="#g_t_005censuremath">\ensuremath</a>.
+<p>Here is a list of commonly-used symbols. It is by no means exhaustive.
+Each symbol is described with a short phrase, and its symbol class,
+which determines the spacing around it, is given in parenthesis. Unless
+said otherwise, the commands for these symbols can be used only in math
+mode. To redefine a command so that it can be used whatever the current
+mode, see <a href="#g_t_005censuremath">\ensuremath</a>.
</p>
-
<dl compact="compact">
<dt><code>\|</code>
<a name="index-_005c_007c"></a>
@@ -9755,7 +12337,7 @@ see <a href="#g_t_005censuremath">\ensuremath</a>.
<dt><code>\alpha</code>
<a name="index-_005calpha"></a>
</dt>
-<dd><p>&#x03B1; Lower case Greek letter alpha (ordinary).
+<dd><p>&#x03B1; Lowercase Greek letter alpha (ordinary).
</p>
</dd>
<dt><code>\amalg</code>
@@ -9803,7 +12385,7 @@ sometimes reserved for cross-correlation.
<dt><code>\beta</code>
<a name="index-_005cbeta"></a>
</dt>
-<dd><p>&#x03B2; Lower case Greek letter beta (ordinary).
+<dd><p>&#x03B2; Lowercase Greek letter beta (ordinary).
</p>
</dd>
<dt><code>\bigcap</code>
@@ -9928,7 +12510,7 @@ dot&nbsp;<code>\bullet</code>.
<dt><code>\chi</code>
<a name="index-_005cchi"></a>
</dt>
-<dd><p>&#x03C7; Lower case Greek chi (ordinary).
+<dd><p>&#x03C7; Lowercase Greek chi (ordinary).
</p>
</dd>
<dt><code>\circ</code>
@@ -9948,8 +12530,8 @@ variable-sized operator&nbsp;<code>\bigcirc</code>.
<a name="index-_005ccomplement"></a>
</dt>
<dd><p>&#x2201; Set complement, used as a superscript as in
-<code>$S^\complement$</code> (ordinary). Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package. Also
-used: <code>$S^{\mathsf{c}}$</code> or&nbsp;<code>$\bar{S}$</code>.
+<code>$S^\complement$</code> (ordinary). Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package. Also used:
+<code>$S^{\mathsf{c}}$</code> or&nbsp;<code>$\bar{S}$</code>.
</p>
</dd>
<dt><code>\cong</code>
@@ -9993,13 +12575,13 @@ turnstile&nbsp;<code>\vdash</code>.
<dt><code>\Delta</code>
<a name="index-_005cDelta"></a>
</dt>
-<dd><p>&#x0394; Greek upper case delta, used for increment (ordinary).
+<dd><p>&#x0394; Greek uppercase delta, used for increment (ordinary).
</p>
</dd>
<dt><code>\delta</code>
<a name="index-_005cdelta"></a>
</dt>
-<dd><p>&#x03B4; Greek lower case delta (ordinary).
+<dd><p>&#x03B4; Greek lowercase delta (ordinary).
</p>
</dd>
<dt><code>\Diamond</code>
@@ -10011,7 +12593,7 @@ turnstile&nbsp;<code>\vdash</code>.
<dt><code>\diamond</code>
<a name="index-_005cdiamond"></a>
</dt>
-<dd><p>&#x22C4; Diamond operator, or diamond bullet (binary). Similar: large
+<dd><p>&#x22C4; Diamond operator (binary). Similar: large
diamond&nbsp;<code>\Diamond</code>, circle bullet&nbsp;<code>\bullet</code>.
</p>
</dd>
@@ -10037,15 +12619,15 @@ to&nbsp;<code>\Doteq</code>.
<dt><code>\downarrow</code>
<a name="index-_005cdownarrow"></a>
</dt>
-<dd><p>&#x2193; Down arrow, converges (relation). Similar: double line down
-arrow&nbsp;<code>\Downarrow</code>.
+<dd><p>&#x2193; Down arrow, converges (relation). Similar:
+<code>\Downarrow</code> double line down arrow.
</p>
</dd>
<dt><code>\Downarrow</code>
<a name="index-_005cDownarrow"></a>
</dt>
-<dd><p>&#x21D3; Double line down arrow (relation). Similar: single line down
-arrow&nbsp;<code>\downarrow</code>.
+<dd><p>&#x21D3; Double line down arrow (relation). Similar:
+<code>\downarrow</code> single line down arrow.
</p>
</dd>
<dt><code>\ell</code>
@@ -10064,7 +12646,7 @@ arrow&nbsp;<code>\downarrow</code>.
<dt><code>\epsilon</code>
<a name="index-_005cepsilon"></a>
</dt>
-<dd><p>&#x03F5; Lower case lunate epsilon (ordinary). Similar to
+<dd><p>&#x03F5; Lowercase lunate epsilon (ordinary). Similar to
Greek text letter. More widely used in mathematics is the script small
letter epsilon <code>\varepsilon</code>&nbsp;&#x03B5;. Related:
the set membership relation <code>\in</code>&nbsp;&#x2208;.
@@ -10079,7 +12661,7 @@ the set membership relation <code>\in</code>&nbsp;&#x2208;.
<dt><code>\eta</code>
<a name="index-_005ceta"></a>
</dt>
-<dd><p>&#x03B7; Lower case Greek letter (ordinary).
+<dd><p>&#x03B7; Lowercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\exists</code>
@@ -10109,13 +12691,13 @@ the set membership relation <code>\in</code>&nbsp;&#x2208;.
<dt><code>\Gamma</code>
<a name="index-_005cGamma"></a>
</dt>
-<dd><p>&#x0393; Upper case Greek letter (ordinary).
+<dd><p>&#x0393; uppercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\gamma</code>
<a name="index-_005cgamma"></a>
</dt>
-<dd><p>&#x03B3; Lower case Greek letter (ordinary).
+<dd><p>&#x03B3; Lowercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\ge</code>
@@ -10183,10 +12765,17 @@ with a <code>\thickmuskip</code> on either side.
<dd><p>&#x2111; Imaginary part (ordinary). See: real part&nbsp;<code>\Re</code>.
</p>
</dd>
+<dt><code>\imath</code>
+<a name="index-_005cimath"></a>
+</dt>
+<dd><a name="index-dotless-i_002c-math"></a>
+<p>Dotless i; used when you are putting an accent on an i (see <a href="#Math-accents">Math accents</a>).
+</p>
+</dd>
<dt><code>\in</code>
<a name="index-_005cin"></a>
</dt>
-<dd><p>&#x2208; Set element (relation). See also: lower case lunate
+<dd><p>&#x2208; Set element (relation). See also: lowercase lunate
epsilon&nbsp;<code>\epsilon</code>&#x03F5; and small letter script
epsilon&nbsp;<code>\varepsilon</code>.
</p>
@@ -10206,7 +12795,7 @@ epsilon&nbsp;<code>\varepsilon</code>.
<dt><code>\iota</code>
<a name="index-_005ciota"></a>
</dt>
-<dd><p>&#x03B9; Lower case Greek letter (ordinary).
+<dd><p>&#x03B9; Lowercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\Join</code>
@@ -10216,22 +12805,29 @@ epsilon&nbsp;<code>\varepsilon</code>.
TeX.
</p>
</dd>
+<dt><code>\jmath</code>
+<a name="index-_005cjmath"></a>
+</dt>
+<dd><a name="index-dotless-j_002c-math"></a>
+<p>Dotless j; used when you are putting an accent on a j (see <a href="#Math-accents">Math accents</a>).
+</p>
+</dd>
<dt><code>\kappa</code>
<a name="index-_005ckappa"></a>
</dt>
-<dd><p>&#x03BA; Lower case Greek letter (ordinary).
+<dd><p>&#x03BA; Lowercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\Lambda</code>
<a name="index-_005cLambda"></a>
</dt>
-<dd><p>&#x039B; Upper case Greek letter (ordinary).
+<dd><p>&#x039B; uppercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\lambda</code>
<a name="index-_005clambda"></a>
</dt>
-<dd><p>&#x03BB; Lower case Greek letter (ordinary).
+<dd><p>&#x03BB; Lowercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\land</code>
@@ -10438,7 +13034,7 @@ for&nbsp;<code>\vert</code> and for norm see the entry for&nbsp;<code>\Vert</cod
<dt><code>\mu</code>
<a name="index-_005cmu"></a>
</dt>
-<dd><p>&#x03BC; Lower case Greek letter (ordinary).
+<dd><p>&#x03BC; Lowercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\nabla</code>
@@ -10490,12 +13086,12 @@ of&nbsp;<code>\in</code>.
<dt><code>\not</code>
<a name="index-_005cnot"></a>
</dt>
-<dd><p>&#x0020;&#x00A0;&#x0338; Long solidus, or slash, used to overstrike a
+<dd><p>&#x0020;&nbsp;&nbsp;&nbsp;&nbsp;Long solidus, or slash, used to overstrike a
following operator (relation).
</p>
-<p>Many negated operators that don&rsquo;t require <code>\not</code> are available,
+<p>Many negated operators are available that don&rsquo;t require <code>\not</code>,
particularly with the <samp>amssymb</samp> package. For example, <code>\notin</code>
-is probably typographically preferable to <code>\not\in</code>.
+is typographically preferable to <code>\not\in</code>.
</p>
</dd>
<dt><code>\notin</code>
@@ -10508,7 +13104,7 @@ of&nbsp;<code>\nsubseteq</code>.
<dt><code>\nu</code>
<a name="index-_005cnu"></a>
</dt>
-<dd><p>&#x03BD; Lower case Greek letter (ordinary).
+<dd><p>&#x03BD; Lowercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\nwarrow</code>
@@ -10527,19 +13123,20 @@ operator&nbsp;<code>\bigodot</code>.
<dt><code>\oint</code>
<a name="index-_005coint"></a>
</dt>
-<dd><p>&#x222E; Contour integral, integral with circle in the middle (operator).
+<dd><p>&#x222E; Contour integral, integral with circle in the middle
+(operator).
</p>
</dd>
<dt><code>\Omega</code>
<a name="index-_005cOmega"></a>
</dt>
-<dd><p>&#x03A9; Upper case Greek letter (ordinary).
+<dd><p>&#x03A9; uppercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\omega</code>
<a name="index-_005comega"></a>
</dt>
-<dd><p>&#x03C9; Lower case Greek letter (ordinary).
+<dd><p>&#x03C9; Lowercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\ominus</code>
@@ -10599,20 +13196,20 @@ ordinary.
<dt><code>\phi</code>
<a name="index-_005cphi"></a>
</dt>
-<dd><p>&#x03D5; Lower case Greek letter (ordinary). The variant form is
+<dd><p>&#x03D5; Lowercase Greek letter (ordinary). The variant form is
<code>\varphi</code>&nbsp;&#x03C6;.
</p>
</dd>
<dt><code>\Pi</code>
<a name="index-_005cPi"></a>
</dt>
-<dd><p>&#x03A0; Upper case Greek letter (ordinary).
+<dd><p>&#x03A0; uppercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\pi</code>
<a name="index-_005cpi"></a>
</dt>
-<dd><p>&#x03C0; Lower case Greek letter (ordinary). The variant form is
+<dd><p>&#x03C0; Lowercase Greek letter (ordinary). The variant form is
<code>\varpi</code>&nbsp;&#x03D6;.
</p>
</dd>
@@ -10663,20 +13260,20 @@ single quote&nbsp;<code>'</code> in text mode produces a different character
<dt><code>\Psi</code>
<a name="index-_005cPsi"></a>
</dt>
-<dd><p>&#x03A8; Upper case Greek letter (ordinary).
+<dd><p>&#x03A8; uppercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\psi</code>
<a name="index-_005cpsi"></a>
</dt>
-<dd><p>&#x03C8; Lower case Greek letter (ordinary).
+<dd><p>&#x03C8; Lowercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\rangle</code>
<a name="index-_005crangle"></a>
</dt>
-<dd><p>&#x27E9; Right angle, or sequence, bracket (closing). Similar: greater
-than&nbsp;<code>&gt;</code>. Matches:<code>\langle</code>.
+<dd><p>&#x27E9; Right angle, or sequence, bracket (closing).
+Similar: greater than&nbsp;<code>&gt;</code>. Matches:<code>\langle</code>.
</p>
</dd>
<dt><code>\rbrace</code>
@@ -10710,8 +13307,8 @@ this, load the <samp>amsfonts</samp> package.
<dt><code>\restriction</code>
<a name="index-_005crestriction"></a>
</dt>
-<dd><p>&#x21BE; Restriction of a function
-(relation). Synonym:&nbsp;<code>\upharpoonright</code>. Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package.
+<dd><p>&#x21BE; Restriction of a function (relation). Synonym:
+<code>\upharpoonright</code>. Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package.
</p>
</dd>
<dt><code>\revemptyset</code>
@@ -10733,46 +13330,51 @@ off (closing). Matches&nbsp;<code>\lfloor</code>.
</dt>
<dd><p>&#x25C1; Arrowhead, that is, triangle, pointing right (binary).
Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package. For the normal subgroup symbol you should instead
-load <samp>amssymb</samp> and use&nbsp;<code>\vartriangleright</code> (which
-is a relation and so gives better spacing).
+load <samp>amssymb</samp> and use&nbsp;<code>\vartriangleright</code> (which is a
+relation and so gives better spacing).
</p>
</dd>
<dt><code>\rho</code>
<a name="index-_005crho"></a>
</dt>
-<dd><p>&#x03C1; Lower case Greek letter (ordinary). The variant form is
+<dd><p>&#x03C1; Lowercase Greek letter (ordinary). The variant form is
<code>\varrho</code>&nbsp;&#x03F1;.
</p>
</dd>
<dt><code>\Rightarrow</code>
<a name="index-_005cRightarrow"></a>
</dt>
-<dd><p>&#x21D2; Implies, right-pointing double line arrow (relation). Similar:
-right single-line arrow&nbsp;<code>\rightarrow</code>.
+<dd><p>&#x21D2; Implies, right-pointing double line arrow
+(relation). Similar: right single-line arrow&nbsp;<code>\rightarrow</code>.
</p>
</dd>
<dt><code>\rightarrow</code>
<a name="index-_005crightarrow"></a>
</dt>
-<dd><p>&#x2192; Right-pointing single line arrow (relation). Synonym:&nbsp;<code>\to</code>. Similar: right double line arrow&nbsp;<code>\Rightarrow</code>.
+<dd><p>&#x2192; Right-pointing single line arrow (relation).
+Synonym:&nbsp;<code>\to</code>. Similar: right double line
+arrow&nbsp;<code>\Rightarrow</code>.
</p>
</dd>
<dt><code>\rightharpoondown</code>
<a name="index-_005crightharpoondown"></a>
</dt>
-<dd><p>&#x21C1; Right-pointing harpoon with barb below the line (relation).
+<dd><p>&#x21C1; Right-pointing harpoon with barb below
+the line (relation).
</p>
</dd>
<dt><code>\rightharpoonup</code>
<a name="index-_005crightharpoonup"></a>
</dt>
-<dd><p>&#x21C0; Right-pointing harpoon with barb above the line (relation).
+<dd><p>&#x21C0; Right-pointing harpoon with barb above the
+line (relation).
</p>
</dd>
<dt><code>\rightleftharpoons</code>
<a name="index-_005crightleftharpoons"></a>
</dt>
-<dd><p>&#x21CC; Right harpoon up above left harpoon down (relation).
+<dd><p>&#x21CC; Right harpoon up above left harpoon down
+(relation).
</p>
</dd>
<dt><code>\searrow</code>
@@ -10784,8 +13386,8 @@ right single-line arrow&nbsp;<code>\rightarrow</code>.
<dt><code>\setminus</code>
<a name="index-_005csetminus"></a>
</dt>
-<dd><p>&#x29F5; Set difference, reverse solidus or slash, like \
-(binary). Similar: backslash&nbsp;<code>\backslash</code> and also
+<dd><p>&#x29F5; Set difference, reverse solidus or reverse slash,
+like \ (binary). Similar: backslash&nbsp;<code>\backslash</code> and also
<code>\textbackslash</code> outside of math mode.
</p>
</dd>
@@ -10798,13 +13400,13 @@ right single-line arrow&nbsp;<code>\rightarrow</code>.
<dt><code>\Sigma</code>
<a name="index-_005cSigma"></a>
</dt>
-<dd><p>&#x03A3; Upper case Greek letter (ordinary).
+<dd><p>&#x03A3; uppercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\sigma</code>
<a name="index-_005csigma"></a>
</dt>
-<dd><p>&#x03C3; Lower case Greek letter (ordinary). The variant form is
+<dd><p>&#x03C3; Lowercase Greek letter (ordinary). The variant form is
<code>\varsigma</code>&nbsp;&#x03C2;.
</p>
</dd>
@@ -10878,18 +13480,18 @@ superset&nbsp;<code>\supset</code>. Not available in plain TeX. In LaTeX you nee
<dt><code>\sqsupseteq</code>
<a name="index-_005csqsupseteq"></a>
</dt>
-<dd><p>&#x2292; Square superset or equal symbol (binary). Similar: superset or
-equal&nbsp;<code>\supseteq</code>.
+<dd><p>&#x2292; Square superset or equal symbol (binary).
+Similar: superset or equal&nbsp;<code>\supseteq</code>.
</p>
</dd>
<dt><code>\star</code>
<a name="index-_005cstar"></a>
</dt>
-<dd><p>&#x22C6; Five-pointed star, sometimes used as a general binary operation
-but sometimes reserved for cross-correlation (binary). Similar: the
-synonyms asterisk&nbsp;<code>*</code> and <code>\ast</code>, which are six-pointed,
-and more often appear as a superscript or subscript, as with the Kleene
-star.
+<dd><p>&#x22C6; Five-pointed star, sometimes used as a general binary
+operation but sometimes reserved for cross-correlation (binary).
+Similar: the synonyms asterisk&nbsp;<code>*</code> and <code>\ast</code>, which
+are six-pointed, and more often appear as a superscript or subscript,
+as with the Kleene star.
</p>
</dd>
<dt><code>\subset</code>
@@ -10954,13 +13556,13 @@ that extends to cover the argument.
<dt><code>\tau</code>
<a name="index-_005ctau"></a>
</dt>
-<dd><p>&#x03C4; Lower case Greek letter (ordinary).
+<dd><p>&#x03C4; Lowercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\theta</code>
<a name="index-_005ctheta"></a>
</dt>
-<dd><p>&#x03B8; Lower case Greek letter (ordinary). The variant form is
+<dd><p>&#x03B8; Lowercase Greek letter (ordinary). The variant form is
<code>\vartheta</code>&nbsp;&#x03D1;.
</p>
</dd>
@@ -11012,9 +13614,9 @@ relation and so gives better spacing).
<dt><code>\unlhd</code>
<a name="index-_005cunlhd"></a>
</dt>
-<dd><p>&#x22B4; Left-pointing not-filled underlined arrowhead, that
-is, triangle, with a line under (binary). Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package. For
-the normal subgroup symbol load <samp>amssymb</samp> and
+<dd><p>&#x22B4; Left-pointing not-filled underlined arrowhead, that is,
+triangle, with a line under (binary). Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package. For the
+normal subgroup symbol load <samp>amssymb</samp> and
use&nbsp;<code>\vartrianglelefteq</code> (which is a relation and so gives
better spacing).
</p>
@@ -11022,9 +13624,9 @@ better spacing).
<dt><code>\unrhd</code>
<a name="index-_005cunrhd"></a>
</dt>
-<dd><p>&#x22B5; Right-pointing not-filled underlined arrowhead, that
-is, triangle, with a line under (binary). Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package. For
-the normal subgroup symbol load <samp>amssymb</samp> and
+<dd><p>&#x22B5; Right-pointing not-filled underlined arrowhead, that is,
+triangle, with a line under (binary). Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package. For the
+normal subgroup symbol load <samp>amssymb</samp> and
use&nbsp;<code>\vartrianglerighteq</code> (which is a relation and so gives
better spacing).
</p>
@@ -11056,15 +13658,17 @@ arrow&nbsp;<code>\updownarrow</code>.
<dt><code>\updownarrow</code>
<a name="index-_005cupdownarrow"></a>
</dt>
-<dd><p>&#x2195; Single-line upward-and-downward-pointing arrow (relation). Similar:
-double-line upward-and-downward-pointing arrow&nbsp;<code>\Updownarrow</code>.
+<dd><p>&#x2195; Single-line upward-and-downward-pointing arrow
+(relation). Similar: double-line upward-and-downward-pointing
+arrow&nbsp;<code>\Updownarrow</code>.
</p>
</dd>
<dt><code>\upharpoonright</code>
<a name="index-_005cupharpoonright"></a>
</dt>
<dd><p>&#x21BE; Up harpoon, with barb on right side
-(relation). Synonym:&nbsp;<code>\restriction</code>. Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package.
+(relation). Synonym:&nbsp;<code>\restriction</code>.
+Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package.
</p>
</dd>
<dt><code>\uplus</code>
@@ -11078,13 +13682,13 @@ variable-sized operator&nbsp;<code>\biguplus</code>.
<dt><code>\Upsilon</code>
<a name="index-_005cUpsilon"></a>
</dt>
-<dd><p>&#x03A5; Upper case Greek letter (ordinary).
+<dd><p>&#x03A5; uppercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\upsilon</code>
<a name="index-_005cupsilon"></a>
</dt>
-<dd><p>&#x03C5; Lower case Greek letter (ordinary).
+<dd><p>&#x03C5; Lowercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\varepsilon</code>
@@ -11099,35 +13703,35 @@ membership&nbsp;<code>\in</code>.
<dt><code>\vanothing</code>
<a name="index-_005cvanothing"></a>
</dt>
-<dd><p>&#x2205; Empty set symbol. Similar:
-<code>\emptyset</code>. Related: <code>\revemptyset</code>. Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package.
+<dd><p>&#x2205; Empty set symbol. Similar: <code>\emptyset</code>. Related:
+<code>\revemptyset</code>. Not available in plain TeX. In LaTeX you need to load the <samp>amssymb</samp> package.
</p>
</dd>
<dt><code>\varphi</code>
<a name="index-_005cvarphi"></a>
</dt>
-<dd><p>&#x03C6; Variant on the lower case Greek letter (ordinary).
+<dd><p>&#x03C6; Variant on the lowercase Greek letter (ordinary).
The non-variant form is <code>\phi</code>&nbsp;&#x03D5;.
</p>
</dd>
<dt><code>\varpi</code>
<a name="index-_005cvarpi"></a>
</dt>
-<dd><p>&#x03D6; Variant on the lower case Greek letter (ordinary).
+<dd><p>&#x03D6; Variant on the lowercase Greek letter (ordinary).
The non-variant form is <code>\pi</code>&nbsp;&#x03C0;.
</p>
</dd>
<dt><code>\varrho</code>
<a name="index-_005cvarrho"></a>
</dt>
-<dd><p>&#x03F1; Variant on the lower case Greek letter (ordinary).
+<dd><p>&#x03F1; Variant on the lowercase Greek letter (ordinary).
The non-variant form is <code>\rho</code>&nbsp;&#x03C1;.
</p>
</dd>
<dt><code>\varsigma</code>
<a name="index-_005cvarsigma"></a>
</dt>
-<dd><p>&#x03C2; Variant on the lower case Greek letter
+<dd><p>&#x03C2; Variant on the lowercase Greek letter
(ordinary). The non-variant form is
<code>\sigma</code>&nbsp;&#x03C3;.
</p>
@@ -11135,7 +13739,7 @@ The non-variant form is <code>\rho</code>&nbsp;&#x03C1;.
<dt><code>\vartheta</code>
<a name="index-_005cvartheta"></a>
</dt>
-<dd><p>&#x03D1; Variant on the lower case Greek letter
+<dd><p>&#x03D1; Variant on the lowercase Greek letter
(ordinary). The non-variant form is
<code>\theta</code>&nbsp;&#x03B8;.
</p>
@@ -11162,17 +13766,17 @@ operator&nbsp;<code>\bigvee</code>.
<dd><p>&#x2016; Vertical double bar (ordinary). Similar: vertical single
bar&nbsp;<code>\vert</code>.
</p>
-<p>For a norm symbol, you can use the <samp>mathtools</samp> package and add
-<code>\DeclarePairedDelimiter\norm{\lVert}{\rVert}</code> to your
-preamble. This gives you three command variants for double-line
-vertical bars that are correctly horizontally spaced: if in the
-document body you write the starred version <code>$\norm*{M^\perp}$</code>
-then the height of the vertical bars will match the height of the
-argument, whereas with <code>\norm{M^\perp}</code> the bars do not grow
-with the height of the argument but instead are the default height,
-and <code>\norm[<var>size command</var>]{M^\perp}</code> also gives bars that
-do not grow but are set to the size given in the <var>size command</var>,
-e.g., <code>\Bigg</code>.
+<p>For a norm symbol, you can use the <samp>mathtools</samp> package and put in
+your preamble
+<code>\DeclarePairedDelimiter\norm{\lVert}{\rVert}</code>. This gives you
+three command variants for double-line vertical bars that are correctly
+horizontally spaced: if in the document body you write the starred
+version <code>$\norm*{M^\perp}$</code> then the height of the vertical bars
+will match the height of the argument, whereas with
+<code>\norm{M^\perp}</code> the bars do not grow with the height of the
+argument but instead are the default height, and <code>\norm[<var>size
+command</var>]{M^\perp}</code> also gives bars that do not grow but are set to
+the size given in the <var>size command</var>, e.g., <code>\Bigg</code>.
</p>
</dd>
<dt><code>\vert</code>
@@ -11182,17 +13786,18 @@ e.g., <code>\Bigg</code>.
vertical bar&nbsp;<code>\Vert</code>. For such that, as in the definition of a
set, use&nbsp;<code>\mid</code> because it is a relation.
</p>
-<p>For absolute value you can use the <samp>mathtools</samp> package and add
-<code>\DeclarePairedDelimiter\abs{\lvert}{\rvert}</code> to your
-preamble. This gives you three command variants for single-line vertical
-bars that are correctly horizontally spaced: if in the document body you
-write the starred version <code>$\abs*{\frac{22}{7}}$</code> then the
-height of the vertical bars will match the height of the argument,
-whereas with <code>\abs{\frac{22}{7}}</code> the bars do not grow with
-the height of the argument but instead are the default height, and
-<code>\abs[<var>size command</var>]{\frac{22}{7}}</code> also gives bars
-that do not grow but are set to the size given in the <var>size
-command</var>, e.g., <code>\Bigg</code>.
+<p>For absolute value you can use the <samp>mathtools</samp> package and in your
+preamble put
+<code>\DeclarePairedDelimiter\abs{\lvert}{\rvert}</code>. This gives you
+three command variants for single-line vertical bars that are correctly
+horizontally spaced: if in the document body you write the starred
+version <code>$\abs*{\frac{22}{7}}$</code> then the height of the
+vertical bars will match the height of the argument, whereas with
+<code>\abs{\frac{22}{7}}</code> the bars do not grow with the height of
+the argument but instead are the default height, and
+<code>\abs[<var>size command</var>]{\frac{22}{7}}</code> also gives bars that
+do not grow but are set to the size given in the <var>size command</var>,
+e.g., <code>\Bigg</code>.
</p>
</dd>
<dt><code>\wedge</code>
@@ -11218,29 +13823,309 @@ operator&nbsp;<code>\bigwedge</code>.
<dt><code>\Xi</code>
<a name="index-_005cXi"></a>
</dt>
-<dd><p>&#x039E; Upper case Greek letter (ordinary).
+<dd><p>&#x039E; uppercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\xi</code>
<a name="index-_005cxi"></a>
</dt>
-<dd><p>&#x03BE; Lower case Greek letter (ordinary).
+<dd><p>&#x03BE; Lowercase Greek letter (ordinary).
</p>
</dd>
<dt><code>\zeta</code>
<a name="index-_005czeta"></a>
</dt>
-<dd><p>&#x03B6; Lower case Greek letter (ordinary).
+<dd><p>&#x03B6; Lowercase Greek letter (ordinary).
</p>
</dd>
</dl>
+<p>The following symbols are most often used in plain text but LaTeX
+provides versions to use in mathematical text.
+</p>
+<dl compact="compact">
+<dt><code>\mathdollar</code>
+<a name="index-_005cmathdollar"></a>
+</dt>
+<dd><p>Dollar sign in math mode: $.
+</p>
+</dd>
+<dt><code>\mathparagraph</code>
+<a name="index-_005cmathparagraph"></a>
+</dt>
+<dd><p>Paragraph sign (pilcrow) in math mode, &#x00B6;.
+</p>
+</dd>
+<dt><code>\mathsection</code>
+<a name="index-_005cmathsection"></a>
+</dt>
+<dd><p>Section sign in math mode &#x00A7;.
+</p>
+</dd>
+<dt><code>\mathsterling</code>
+<a name="index-_005cmathsterling"></a>
+</dt>
+<dd><p>Sterling sign in math mode: &pound;.
+</p>
+</dd>
+<dt><code>\mathunderscore</code>
+<a name="index-_005cmathunderscore"></a>
+</dt>
+<dd><p>Underscore in math mode: _.
+</p>
+</dd>
+</dl>
+
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">&bull; <a href="#Blackboard-bold" accesskey="1">Blackboard bold</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Doublestruck characters.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#Calligraphic" accesskey="2">Calligraphic</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Cursive characters.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cboldmath-_0026-_005cunboldmath" accesskey="3">\boldmath &amp; \unboldmath</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Symbols in boldface.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#Dots" accesskey="4">Dots</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Ellipses, etc.
+</td></tr>
+</table>
+
+
+<hr>
+<a name="Blackboard-bold"></a>
+<div class="header">
+<p>
+Next: <a href="#Calligraphic" accesskey="n" rel="next">Calligraphic</a>, Up: <a href="#Math-symbols" accesskey="u" rel="up">Math symbols</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Blackboard-bold-1"></a>
+<h4 class="subsection">16.2.1 Blackboard bold</h4>
+
+<a name="index-blackboard-bold"></a>
+<a name="index-doublestruck"></a>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\usepackage{amssymb} % in preamble
+ ...
+\mathbb{<var>uppercase-letter</var>}
+</pre></div>
+
+<p>Provide blackboard bold symbols, sometimes also known as doublestruck
+letters, used to denote number sets such as the natural numbers, the
+integers, etc.
+</p>
+<p>Here
+</p>
+<div class="example">
+<pre class="example">\( \forall n \in \mathbb{N}, n^2 \geq 0 \)
+</pre></div>
+
+<p>the <code>\mathbb{N}</code> gives blackboard bold symbol &#x2115;
+representing the natural numbers.
+</p>
+<p>If you use other than an uppercase letter then you do not get an error
+but you get strange results, including unexpected characters.
+</p>
+<p>There are packages that give access to symbols other than just the
+capital letters; look on CTAN.
+</p>
+
+<hr>
+<a name="Calligraphic"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cboldmath-_0026-_005cunboldmath" accesskey="n" rel="next">\boldmath &amp; \unboldmath</a>, Previous: <a href="#Blackboard-bold" accesskey="p" rel="prev">Blackboard bold</a>, Up: <a href="#Math-symbols" accesskey="u" rel="up">Math symbols</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Calligraphic-1"></a>
+<h4 class="subsection">16.2.2 Calligraphic</h4>
+
+<a name="index-calligraphic-fonts"></a>
+<a name="index-script-fonts"></a>
+<a name="index-fonts_002c-script"></a>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\mathcal{<var>uppercase-letters</var>}
+</pre></div>
+
+<p>Use a script-like font.
+</p>
+<p>In this example the graph identifier is output in a cursive font.
+</p>
+<div class="example">
+<pre class="example">Let the graph be \( \mathcal{G} \).
+</pre></div>
+
+<p>If you use something other than an uppercase letter then you do not get
+an error. Instead you get unexpected output. For instance,
+<code>\mathcal{g}</code> outputs a close curly brace symbol, while
+<code>\mathcal{+}</code> outputs a plus sign.
+</p>
+
+<hr>
+<a name="g_t_005cboldmath-_0026-_005cunboldmath"></a>
+<div class="header">
+<p>
+Next: <a href="#Dots" accesskey="n" rel="next">Dots</a>, Previous: <a href="#Calligraphic" accesskey="p" rel="prev">Calligraphic</a>, Up: <a href="#Math-symbols" accesskey="u" rel="up">Math symbols</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cboldmath-_0026-_005cunboldmath-1"></a>
+<h4 class="subsection">16.2.3 <code>\boldmath</code> &amp; <code>\unboldmath</code></h4>
+
+<a name="index-boldface-mathematics"></a>
+<a name="index-symbols_002c-boldface"></a>
+<a name="index-_005cboldmath"></a>
+<a name="index-_005cunboldmath"></a>
+
+<p>Synopsis (used in paragraph mode or LR mode):
+</p>
+<div class="example">
+<pre class="example">\boldmath \( <var>math</var> \)
+</pre></div>
+
+<p>or
+</p>
+<div class="example">
+<pre class="example">\unboldmath \( <var>math</var> \)
+</pre></div>
+
+<a name="index-_005cboldmath-1"></a>
+<a name="index-_005cunboldmath-1"></a>
+<p>Declarations to change the letters and symbols in <var>math</var> to be in
+a bold font, or to countermand that and bring back the regular
+(non-bold) default. They must be used when not in math mode or display
+math mode (see <a href="#Modes">Modes</a>). Both commands are fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>In this example each <code>\boldmath</code> command takes place inside an
+<code>\mbox</code>,
+</p>
+<div class="example">
+<pre class="example">we have $\mbox{\boldmath \( v \)} = 5\cdot\mbox{\boldmath \( u \)$}$
+</pre></div>
+
+<p>which means <code>\boldmath</code> is only called in a text mode, here LR
+mode, and explains why LaTeX must switch to math mode to set <code>v</code>
+and <code>u</code>.
+</p>
+<p>If you use either command inside math mode, as with <code>Trouble: \(
+\boldmath x \)</code>, then you get something like &lsquo;<samp>LaTeX Font Warning:
+Command \boldmath invalid in math mode on input line 11</samp>&rsquo; and &lsquo;<samp>LaTeX
+Font Warning: Command \mathversion invalid in math mode on input line
+11</samp>&rsquo;.
+</p>
+<a name="index-package_002c-bm"></a>
+<a name="index-bm-package"></a>
+
+<p>There are many issues with <code>\boldmath</code>. New documents should use
+the <samp>bm</samp> package provided by the LaTeX Project team. A complete
+description is outside the scope of this document (see the full
+documentation on CTAN) but even this small example
+</p>
+<div class="example">
+<pre class="example">\usepackage{bm} % in preamble
+...
+we have $\bm{v} = 5\cdot\bm{u}$
+</pre></div>
+
+<p>shows that it is an improvement over <code>\boldmath</code>.
+</p>
+
+<hr>
+<a name="Dots"></a>
+<div class="header">
+<p>
+Previous: <a href="#g_t_005cboldmath-_0026-_005cunboldmath" accesskey="p" rel="prev">\boldmath &amp; \unboldmath</a>, Up: <a href="#Math-symbols" accesskey="u" rel="up">Math symbols</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Dots_002c-horizontal-or-vertical"></a>
+<h4 class="subsection">16.2.4 Dots, horizontal or vertical</h4>
+
+<a name="index-ellipses"></a>
+<a name="index-dots"></a>
+
+<p>Ellipses are the three dots (usually three) indicating that a pattern
+continues.
+</p>
+<div class="example">
+<pre class="example">\begin{array}{cccc}
+ a_{0,0} &amp;a_{0,1} &amp;a_{0,2} &amp;\ldots \\
+ a_{1,0} &amp;\ddots \\
+ \vdots
+\end{array}
+</pre></div>
+
+<p>LaTeX provides these.
+</p>
+<dl compact="compact">
+<dd><a name="ellipses-cdots"></a></dd>
+<dt><code>\cdots</code>
+<a name="index-_005ccdots"></a>
+</dt>
+<dd><p>Horizontal ellipsis with the dots raised to the center of the line, as
+in &#x22EF;. Used as: <code>\( a_0\cdot a_1\cdots a_{n-1}
+\)</code>.
+</p>
+<a name="ellipses-ddots"></a></dd>
+<dt><code>\ddots</code>
+<a name="index-_005cddots"></a>
+</dt>
+<dd><p>Diagonal ellipsis, &#x22F1;. See the above array example for a
+usage.
+</p>
+<a name="ellipses-ldots"></a></dd>
+<dt><code>\ldots</code>
+<a name="index-_005cldots"></a>
+</dt>
+<dd><p>Ellipsis on the baseline, &#x2026;. Used as: <code>\(
+x_0,\ldots x_{n-1} \)</code>. Another example is the above array example. A
+synonym is <code>\mathellipsis</code>. A synonym from the <samp>amsmath</samp>
+package is <code>\hdots</code>.
+</p>
+<p>You can also use this command outside of mathematical text, as in
+<code>The gears, brakes, \ldots{} are all broken</code>. (In a paragraph
+mode or LR mode a synonym for <code>\ldots</code> is <code>\dots</code>.)
+</p>
+<a name="ellipses-vdots"></a></dd>
+<dt><code>\vdots</code>
+<a name="index-_005cvdots"></a>
+</dt>
+<dd><p>Vertical ellipsis, &#x22EE;. See the above array example for a
+usage.
+</p>
+</dd>
+</dl>
+
+<a name="index-package_002c-amsmath-6"></a>
+<a name="index-amsmath-package-6"></a>
+
+<p>The <samp>amsmath</samp> package has the command <code>\dots</code> to semantically
+mark up ellipses. This example produces two different-looking outputs
+for the first two uses of the <code>\dots</code> command.
+</p>
+<div class="example">
+<pre class="example">\usepackage{amsmath} % in preamble
+ ...
+Suppose that \( p_0, p_1, \dots, p_{n-1} \) lists all of the primes.
+Observe that \( p_0\cdot p_1 \dots \cdot p_{n-1} +1 \) is not a
+ multiple of any \( p_i \).
+Conclusion: there are infinitely many primes \( p_0, p_1, \dotsc \).
+</pre></div>
+
+<p>In the first line LaTeX looks to the comma following <code>\dots</code> to
+determine that it should output an ellipsis on the baseline. The second
+line has a <code>\cdot</code> following <code>\dots</code> so LaTeX outputs an
+ellipsis that is on the math axis, vertically centered. However, the
+third usage has no follow-on character so you have to tell LaTeX what
+to do. You can use one of the commands: <code>\dotsc</code> if you need the
+ellipsis appropriate for a comma following, <code>\dotsb</code> if you need
+the ellipses that fits when the dots are followed by a binary operator
+or relation symbol, <code>\dotsi</code> for dots with integrals, or
+<code>\dotso</code> for others.
+</p>
<hr>
<a name="Math-functions"></a>
<div class="header">
<p>
-Next: <a href="#Math-accents" accesskey="n" rel="next">Math accents</a>, Previous: <a href="#Math-symbols" accesskey="p" rel="prev">Math symbols</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Math-accents" accesskey="n" rel="next">Math accents</a>, Previous: <a href="#Math-symbols" accesskey="p" rel="prev">Math symbols</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Math-functions-1"></a>
<h3 class="section">16.3 Math functions</h3>
@@ -11255,215 +14140,226 @@ spacing.
<dt><code>\arccos</code>
<a name="index-_005carccos"></a>
</dt>
-<dd><p><em>\arccos</em>
+<dd><p>Inverse cosine
</p>
</dd>
<dt><code>\arcsin</code>
<a name="index-_005carcsin"></a>
</dt>
-<dd><p><em>\arcsin</em>
+<dd><p>Inverse sine
</p>
</dd>
<dt><code>\arctan</code>
<a name="index-_005carctan"></a>
</dt>
-<dd><p><em>\arctan</em>
+<dd><p>Inverse tangent
</p>
</dd>
<dt><code>\arg</code>
<a name="index-_005carg"></a>
</dt>
-<dd><p><em>\arg</em>
+<dd><p>Angle between the real axis and a point in the complex plane
</p>
</dd>
<dt><code>\bmod</code>
<a name="index-_005cbmod"></a>
</dt>
-<dd><p>Binary modulo operator (<em>x \bmod y</em>)
+<dd><p>Binary modulo operator, used as in <code>\( 5\bmod 3=2 \)</code>
</p>
</dd>
<dt><code>\cos</code>
<a name="index-_005ccos"></a>
</dt>
-<dd><p><em>\cos</em>
+<dd><p>Cosine
</p>
</dd>
<dt><code>\cosh</code>
<a name="index-_005ccosh"></a>
</dt>
-<dd><p><em>\cosh</em>
+<dd><p>Hyperbolic cosine
</p>
</dd>
<dt><code>\cot</code>
<a name="index-_005ccot"></a>
</dt>
-<dd><p><em>\cot</em>
+<dd><p>Cotangent
</p>
</dd>
<dt><code>\coth</code>
<a name="index-_005ccoth"></a>
</dt>
-<dd><p><em>\coth</em>
+<dd><p>Hyperbolic cotangent
</p>
</dd>
<dt><code>\csc</code>
<a name="index-_005ccsc"></a>
</dt>
-<dd><p><em>\csc</em>
+<dd><p>Cosecant
</p>
</dd>
<dt><code>\deg</code>
<a name="index-_005cdeg"></a>
</dt>
-<dd><p><em>\deg</em>
+<dd><p>Degrees
</p>
</dd>
<dt><code>\det</code>
<a name="index-_005cdet"></a>
</dt>
-<dd><p><em>\det</em>
+<dd><p>Determinant
</p>
</dd>
<dt><code>\dim</code>
<a name="index-_005cdim"></a>
</dt>
-<dd><p><em>\dim</em>
+<dd><p>Dimension
</p>
</dd>
<dt><code>\exp</code>
<a name="index-_005cexp"></a>
</dt>
-<dd><p><em>\exp</em>
+<dd><p>Exponential
</p>
</dd>
<dt><code>\gcd</code>
<a name="index-_005cgcd"></a>
</dt>
-<dd><p><em>\gcd</em>
+<dd><p>Greatest common divisor
</p>
</dd>
<dt><code>\hom</code>
<a name="index-_005chom"></a>
</dt>
-<dd><p><em>\hom</em>
+<dd><p>Homomorphism
</p>
</dd>
<dt><code>\inf</code>
<a name="index-_005cinf"></a>
</dt>
-<dd><p><em>\inf</em>
+<dd><p>Infinum
</p>
</dd>
<dt><code>\ker</code>
<a name="index-_005cker"></a>
</dt>
-<dd><p><em>\ker</em>
+<dd><p>Kernel
</p>
</dd>
<dt><code>\lg</code>
<a name="index-_005clg"></a>
</dt>
-<dd><p><em>\lg</em>
+<dd><p>Base 2 logarithm
</p>
</dd>
<dt><code>\lim</code>
<a name="index-_005clim"></a>
</dt>
-<dd><p><em>\lim</em>
+<dd><p>Limit
</p>
</dd>
<dt><code>\liminf</code>
<a name="index-_005climinf"></a>
</dt>
-<dd><p><em>\liminf</em>
+<dd><p>Limit inferior
</p>
</dd>
<dt><code>\limsup</code>
<a name="index-_005climsup"></a>
</dt>
-<dd><p><em>\limsup</em>
+<dd><p>Limit superior
</p>
</dd>
<dt><code>\ln</code>
<a name="index-_005cln"></a>
</dt>
-<dd><p><em>\ln</em>
+<dd><p>Natural logarithm
</p>
</dd>
<dt><code>\log</code>
<a name="index-_005clog"></a>
</dt>
-<dd><p><em>\log</em>
+<dd><p>Logarithm
</p>
</dd>
<dt><code>\max</code>
<a name="index-_005cmax"></a>
</dt>
-<dd><p><em>\max</em>
+<dd><p>Maximum
</p>
</dd>
<dt><code>\min</code>
<a name="index-_005cmin"></a>
</dt>
-<dd><p><em>\min</em>
+<dd><p>Minimum
</p>
</dd>
<dt><code>\pmod</code>
<a name="index-_005cpmod"></a>
</dt>
-<dd><p>parenthesized modulus, as in (<em>\pmod 2^n - 1</em>)
+<dd><p>Parenthesized modulus, as used in <code>\( 5\equiv 2\pmod 3 \)</code>
</p>
</dd>
<dt><code>\Pr</code>
<a name="index-_005cPr"></a>
</dt>
-<dd><p><em>\Pr</em>
+<dd><p>Probability
</p>
</dd>
<dt><code>\sec</code>
<a name="index-_005csec"></a>
</dt>
-<dd><p><em>\sec</em>
+<dd><p>Secant
</p>
</dd>
<dt><code>\sin</code>
<a name="index-_005csin"></a>
</dt>
-<dd><p><em>\sin</em>
+<dd><p>Sine
</p>
</dd>
<dt><code>\sinh</code>
<a name="index-_005csinh"></a>
</dt>
-<dd><p><em>\sinh</em>
+<dd><p>Hyperbolic sine
</p>
</dd>
<dt><code>\sup</code>
<a name="index-_005csup"></a>
</dt>
-<dd><p><em>\sup</em>
+<dd><p>sup
</p>
</dd>
<dt><code>\tan</code>
<a name="index-_005ctan"></a>
</dt>
-<dd><p><em>\tan</em>
+<dd><p>Tangent
</p>
</dd>
<dt><code>\tanh</code>
<a name="index-_005ctanh"></a>
</dt>
-<dd><p><em>\tanh</em>
+<dd><p>Hyperbolic tangent
</p>
</dd>
</dl>
+<a name="index-package_002c-amsmath-7"></a>
+<a name="index-amsmath-package-7"></a>
+
+<p>The <samp>amsmath</samp> package adds improvements on some of these, and also
+allows you to define your own. The full documentation is on CTAN, but
+briefly, you can define an identity operator with
+<code>\DeclareMathOperator{\identity}{id}</code> that is like the ones
+above but prints as &lsquo;<samp>id</samp>&rsquo;. The starred form
+<code>\DeclareMathOperator*{\op}{op}</code> sets any limits above and
+below, as is traditional with <code>\lim</code>, <code>\sup</code>, or <code>\max</code>.
+</p>
<hr>
<a name="Math-accents"></a>
<div class="header">
<p>
-Next: <a href="#Spacing-in-math-mode" accesskey="n" rel="next">Spacing in math mode</a>, Previous: <a href="#Math-functions" accesskey="p" rel="prev">Math functions</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Over_002d-and-Underlining" accesskey="n" rel="next">Over- and Underlining</a>, Previous: <a href="#Math-functions" accesskey="p" rel="prev">Math functions</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Math-accents-1"></a>
<h3 class="section">16.4 Math accents</h3>
@@ -11480,7 +14376,7 @@ in math. These are different from accents in normal text
<a name="index-_005cacute"></a>
</dt>
<dd><a name="index-acute-accent_002c-math"></a>
-<p>Math acute accent: <em>\acute{x}</em>.
+<p>Math acute accent
</p>
</dd>
<dt><code>\bar</code>
@@ -11488,14 +14384,14 @@ in math. These are different from accents in normal text
</dt>
<dd><a name="index-bar_002dover-accent_002c-math"></a>
<a name="index-macron-accent_002c-math"></a>
-<p>Math bar-over accent: <em>\bar{x}</em>.
+<p>Math bar-over accent
</p>
</dd>
<dt><code>\breve</code>
<a name="index-_005cbreve"></a>
</dt>
<dd><a name="index-breve-accent_002c-math"></a>
-<p>Math breve accent: <em>\breve{x}</em>.
+<p>Math breve accent
</p>
</dd>
<dt><code>\check</code>
@@ -11503,14 +14399,14 @@ in math. These are different from accents in normal text
</dt>
<dd><a name="index-check-accent_002c-math"></a>
<a name="index-hacek-accent_002c-math"></a>
-<p>Math h&aacute;&#269;ek (check) accent: <em>\check{x}</em>.
+<p>Math h&aacute;&#269;ek (check) accent
</p>
</dd>
<dt><code>\ddot</code>
<a name="index-_005cddot"></a>
</dt>
<dd><a name="index-double-dot-accent_002c-math"></a>
-<p>Math dieresis accent: <em>\ddot{x}</em>.
+<p>Math dieresis accent
</p>
</dd>
<dt><code>\dot</code>
@@ -11518,14 +14414,14 @@ in math. These are different from accents in normal text
</dt>
<dd><a name="index-overdot-accent_002c-math"></a>
<a name="index-dot-over-accent_002c-math"></a>
-<p>Math dot accent: <em>\dot{x}</em>.
+<p>Math dot accent
</p>
</dd>
<dt><code>\grave</code>
<a name="index-_005cgrave"></a>
</dt>
<dd><a name="index-grave-accent_002c-math"></a>
-<p>Math grave accent: <em>\grave{x}</em>.
+<p>Math grave accent
</p>
</dd>
<dt><code>\hat</code>
@@ -11533,87 +14429,164 @@ in math. These are different from accents in normal text
</dt>
<dd><a name="index-hat-accent_002c-math"></a>
<a name="index-circumflex-accent_002c-math"></a>
-<p>Math hat (circumflex) accent: <em>\hat{x}</em>.
-</p>
-</dd>
-<dt><code>\imath</code>
-<a name="index-_005cimath"></a>
-</dt>
-<dd><a name="index-dotless-i_002c-math"></a>
-<p>Math dotless i.
-</p>
-</dd>
-<dt><code>\jmath</code>
-<a name="index-_005cjmath"></a>
-</dt>
-<dd><a name="index-dotless-j_002c-math"></a>
-<p>Math dotless j.
+<p>Math hat (circumflex) accent
</p>
</dd>
<dt><code>\mathring</code>
<a name="index-_005cmathring"></a>
</dt>
<dd><a name="index-ring-accent_002c-math"></a>
-<p>Math ring accent: x*. </p>
+<p>Math ring accent </p>
</dd>
<dt><code>\tilde</code>
<a name="index-_005ctilde"></a>
</dt>
<dd><a name="index-tilde-accent_002c-math"></a>
-<p>Math tilde accent: <em>\tilde{x}</em>.
+<p>Math tilde accent
</p>
</dd>
<dt><code>\vec</code>
<a name="index-_005cvec"></a>
</dt>
<dd><a name="index-vector-symbol_002c-math"></a>
-<p>Math vector symbol: <em>\vec{x}</em>.
+<p>Math vector symbol
</p>
</dd>
<dt><code>\widehat</code>
<a name="index-_005cwidehat"></a>
</dt>
<dd><a name="index-wide-hat-accent_002c-math"></a>
-<p>Math wide hat accent: <em>\widehat{x+y}</em>.
+<p>Math wide hat accent
</p>
</dd>
<dt><code>\widetilde</code>
<a name="index-_005cwidetilde"></a>
</dt>
<dd><a name="index-wide-tilde-accent_002c-math"></a>
-<p>Math wide tilde accent: <em>\widetilde{x+y}</em>.
+<p>Math wide tilde accent
+</p>
+</dd>
+</dl>
+
+<p>When you are putting an accent on an i or a j, the tradition is to use
+one without a dot, <code>\imath</code> or <code>jmath</code> (see <a href="#Math-symbols">Math symbols</a>).
+</p>
+
+<hr>
+<a name="Over_002d-and-Underlining"></a>
+<div class="header">
+<p>
+Next: <a href="#Spacing-in-math-mode" accesskey="n" rel="next">Spacing in math mode</a>, Previous: <a href="#Math-accents" accesskey="p" rel="prev">Math accents</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Over_002d-and-Underlining-1"></a>
+<h3 class="section">16.5 Over- and Underlining</h3>
+
+<a name="index-overlining"></a>
+<a name="index-underlining"></a>
+
+<p>LaTeX provides commands for making overlines or underlines, or
+putting braces over or under some material.
+</p>
+<dl compact="compact">
+<dt><code>\underline{<var>text</var>}</code>
+<a name="index-_005cunderline_007btext_007d"></a>
+</dt>
+<dd><p>Underline <var>text</var>. Works inside math mode, and outside.
+The line is always completely below the text, taking account of
+descenders, so in <code>\(\underline{y}\)</code> the line is lower than in
+<code>\(\underline{x}\)</code>. This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<a name="index-package_002c-ulem"></a>
+<a name="index-ulem-package"></a>
+
+<p>Note that the package <samp>ulem</samp> does text mode underlining and allows
+line breaking as well as a number of other features. See the
+documentation on CTAN. See also&nbsp;<a href="#g_t_005chrulefill-_0026-_005cdotfill">\hrulefill &amp; \dotfill</a> for
+producing a line, for such things as a signature.
+</p>
+</dd>
+<dt><code>\overline{<var>text</var>}</code>
+<a name="index-_005coverline_007btext_007d"></a>
+</dt>
+<dd><p>Put a horizontal line over <var>text</var>. Works inside math mode, and
+outside. For example, <code>\overline{x+y}</code>.
+Note that this differs from the command <code>\bar</code> (see <a href="#Math-accents">Math accents</a>).
+</p>
+</dd>
+<dt><code>\underbrace{<var>math</var>}</code>
+<a name="index-_005cunderbrace_007bmath_007d"></a>
+</dt>
+<dd><p>Put a brace under <var>math</var>. For example, this
+<code>(1-\underbrace{1/2)+(1/2}-1/3)</code> emphasizes the telescoping part.
+Attach text to the brace by using subscript, <code>_</code>, or superscript,
+<code>^</code>, as here.
+</p>
+<div class="example">
+<pre class="example">\begin{displaymath}
+ 1+1/2+\underbrace{1/3+1/4}_{&gt;1/2}+
+ \underbrace{1/5+1/6+1/7+1/8}_{&gt;1/2}+\cdots
+\end{displaymath}
+</pre></div>
+
+<p>The superscript appears on top of the expression, and so can look
+unconnected to the underbrace.
+</p>
+</dd>
+<dt><code>\overbrace{<var>math</var>}</code>
+<a name="index-_005coverbrace_007bmath_007d"></a>
+</dt>
+<dd><p>Put a brace over <var>math</var>, as with
+<code>\overbrace{x+x+\cdots+x}^{\mbox{\(k\) times}}</code>. See also
+<code>\underbrace</code>.
</p>
</dd>
</dl>
+<a name="index-package_002c-mathtools-1"></a>
+<a name="index-mathtools-package-1"></a>
+
+<p>The package <samp>mathtools</samp> adds an over- and underbrace, as well as
+some improvements on the braces. See the documentation on CTAN.
+</p>
<hr>
<a name="Spacing-in-math-mode"></a>
<div class="header">
<p>
-Next: <a href="#Math-miscellany" accesskey="n" rel="next">Math miscellany</a>, Previous: <a href="#Math-accents" accesskey="p" rel="prev">Math accents</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Math-miscellany" accesskey="n" rel="next">Math miscellany</a>, Previous: <a href="#Over_002d-and-Underlining" accesskey="p" rel="prev">Over- and Underlining</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Spacing-in-math-mode-1"></a>
-<h3 class="section">16.5 Spacing in math mode</h3>
+<h3 class="section">16.6 Spacing in math mode</h3>
<a name="index-spacing-within-math-mode"></a>
<a name="index-math-mode_002c-spacing"></a>
-<p>In a <code>math</code> environment, LaTeX ignores the spaces that you use
-in the source, and instead puts in the spacing according to the normal
-rules for mathematics texts.
+<p>When typesetting mathematics, LaTeX puts in spacing according to the
+normal rules for mathematics texts. If you enter <code>y=m x</code> then
+LaTeX ignores the space and in the output the m is next to the x,
+as <em>y=mx</em>.
</p>
-<p>Many math mode spacing definitions are expressed in terms of the math unit
-<em>mu</em> given by 1 em = 18 mu, where the em is taken from the current
-math symbols family (see <a href="#Units-of-length">Units of length</a>).
-LaTeX provides the following commands for use in math mode:
+<p>But LaTeX&rsquo;s rules sometimes need tweaking. For example, in an
+integral the tradition is to put a small extra space between the
+<code>f(x)</code> and the <code>dx</code>, here done with the <code>\,</code> command.
+</p>
+<div class="example">
+<pre class="example">\int_0^1 f(x)\,dx
+</pre></div>
+
+<p>LaTeX provides the commands that follow for use in math mode. Many
+of these spacing definitions are expressed in terms of the math unit
+<em>mu</em>. It is defined as 1/18em, where the em is taken from the
+current math symbols family (see <a href="#Units-of-length">Units of length</a>). Thus, a
+<code>\thickspace</code> is something like 5/18 times the width of
+a&nbsp;&lsquo;<samp>M</samp>&rsquo;.
</p>
<dl compact="compact">
<dt><code>\;</code></dt>
<dd><a name="index-_005c_003b"></a>
<a name="index-_005cthickspace"></a>
-<p>Normally <code>5.0mu plus 5.0mu</code>. The longer name is
-<code>\thickspace</code>. Math mode only.
+<a name="spacing-in-math-mode-thickspace"></a><p>Synonym: <code>\thickspace</code>. Normally <code>5.0mu plus 5.0mu</code>. Math
+mode only.
</p>
</dd>
<dt><code>\:</code></dt>
@@ -11621,26 +14594,42 @@ LaTeX provides the following commands for use in math mode:
<dd><a name="index-_005c_003a"></a>
<a name="index-_005c_003e-1"></a>
<a name="index-_005cmedspace"></a>
-<p>Normally <code>4.0mu plus 2.0mu minus 4.0mu</code>. The longer name is
-<code>\medspace</code>. Math mode only.
+<a name="spacing-in-math-mode-medspace"></a><p>Synonym: <code>\medspace</code>. Normally <code>4.0mu plus 2.0mu minus 4.0mu</code>.
+Math mode only.
</p>
</dd>
<dt><code>\,</code></dt>
<dd><a name="index-_005c_002c"></a>
<a name="index-_005cthinspace"></a>
-<p>Normally <code>3mu</code>. The longer name is <code>\thinspace</code>. This can
-be used in both math mode and text mode. See <a href="#g_t_005cthinspace">\thinspace</a>.
+<a name="index-thin-space"></a>
+<a name="Spacing-in-math-mode_002f_005cthinspace"></a><a name="spacing-in-math-mode-thinspace"></a><p>Synonym: <code>\thinspace</code>. Normally <code>3mu</code>, which is 1/6em.
+Can be used in both math mode and text mode (see <a href="#g_t_005cthinspace-_0026-_005cnegthinspace">\thinspace &amp; \negthinspace</a>).
+</p>
+<p>This space is widely used, for instance between the function and the
+infinitesimal in an integral <code>\int f(x)\,dx</code> and, if an author does
+this, before punctuation in a displayed equation.
</p>
+<div class="example">
+<pre class="example">The antiderivative is
+\begin{equation}
+ 3x^{-1/2}+3^{1/2}\,.
+\end{equation}
+</pre></div>
+
</dd>
<dt><code>\!</code></dt>
<dd><a name="index-_005c_0021"></a>
-<p>A negative thin space. Normally <code>-3mu</code>. Math mode only.
+<a name="index-_005cnegthinspace"></a>
+<a name="index-thin-space_002c-negative"></a>
+<a name="spacing-in-math-mode-negthinspace"></a><p>A negative thin space. Normally <code>-3mu</code>. The <code>\!</code> command is
+math mode only but the <code>\negthinspace</code> command is available for
+text mode (see <a href="#g_t_005cthinspace-_0026-_005cnegthinspace">\thinspace &amp; \negthinspace</a>).
</p>
</dd>
<dt><code>\quad</code></dt>
<dd><a name="index-quad"></a>
<a name="index-_005cquad"></a>
-<p>This is 18mu, that is, 1em. This is often used for space
+<a name="spacing-in-math-mode-quad"></a><p>This is 18mu, that is, 1em. This is often used for space
surrounding equations or expressions, for instance for the space between
two equations inside a <code>displaymath</code> environment. It is available
in both text and math mode.
@@ -11648,234 +14637,321 @@ in both text and math mode.
</dd>
<dt><code>\qquad</code></dt>
<dd><a name="index-_005cqquad"></a>
-<p>A length of 2 quads, that is, 36mu = 2em. It is available in
+<a name="spacing-in-math-mode-qquad"></a><p>A length of 2 quads, that is, 36mu = 2em. It is available in
both text and math mode.
</p></dd>
</dl>
-<p>In this example a thinspace separates the function from the
-infinitesimal.
-</p>
-<div class="example">
-<pre class="example">\int_0^1 f(x)\,dx
-</pre></div>
-
<hr>
<a name="Math-miscellany"></a>
<div class="header">
<p>
-Previous: <a href="#Spacing-in-math-mode" accesskey="p" rel="prev">Spacing in math mode</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Spacing-in-math-mode" accesskey="p" rel="prev">Spacing in math mode</a>, Up: <a href="#Math-formulas" accesskey="u" rel="up">Math formulas</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Math-miscellany-1"></a>
-<h3 class="section">16.6 Math miscellany</h3>
+<h3 class="section">16.7 Math miscellany</h3>
<a name="index-math-miscellany"></a>
-<dl compact="compact">
-<dt><code>\*</code>
-<a name="index-_005c_002a"></a>
-</dt>
-<dd><a name="index-discretionary-multiplication"></a>
-<a name="index-multiplication-symbol_002c-discretionary-line-break"></a>
-<p>A <em>discretionary</em> multiplication symbol, at which a line break is
-allowed. Without the break multiplication is implicitly indicated by a
-space, while in the case of a break a &#x00D7; symbol is
-printed immediately before the break. So
+<p>LaTeX contains a wide variety of mathematics facilities. Here are
+some that don&rsquo;t fit into other categories.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">&bull; <a href="#Colon-character-_0026-_005ccolon" accesskey="1">Colon character &amp; \colon</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Colon.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005c_002a" accesskey="2">\*</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Discretionary multiplication.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cfrac" accesskey="3">\frac</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Fraction.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cleft-_0026-_005cright" accesskey="4">\left &amp; \right</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Paired delimiters.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005csqrt" accesskey="5">\sqrt</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Radicals.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cstackrel" accesskey="6">\stackrel</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Text over a relation.
+</td></tr>
+</table>
+
+
+<hr>
+<a name="Colon-character-_0026-_005ccolon"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005c_002a" accesskey="n" rel="next">\*</a>, Up: <a href="#Math-miscellany" accesskey="u" rel="up">Math miscellany</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Colon-character-_003a-_0026-_005ccolon"></a>
+<h4 class="subsection">16.7.1 Colon character <code>:</code> &amp; <code>\colon</code></h4>
+
+<a name="index-_003a"></a>
+<a name="index-colon-character"></a>
+<a name="index-_003a-1"></a>
+<a name="index-_005ccolon"></a>
+
+<p>Synopsis, one of:
</p>
<div class="example">
-<pre class="example">\documentclass{article}
-\begin{document}
-Now \(A_3 = 0\), hence the product of all terms \(A_1\)
-through \(A_4\), that is \(A_1\* A_2\* A_3 \* A_4\), is
-equal to zero.
-\end{document}
+<pre class="example">:
+\colon
</pre></div>
-<p>will make that sort of output&nbsp;<!-- /@w -->(the ellipsis &lsquo;<samp>[&hellip;]</samp>&rsquo; is here to show the line break at
-the same place as in a TeX output):
+<p>In mathematics, the colon character, <code>:</code>, is a relation.
</p>
-<blockquote class="indentedblock">
-<p>Now <em>A_3 = 0</em>,
-[&hellip;]
-<em>A_1</em>
-through <em>A_4</em>, that is <em>A_1 A_2 \times</em><br><em>A_3 A_4</em>, is
-equal to zero.
-</p></blockquote>
+<div class="example">
+<pre class="example">With side ratios \( 3:4 \) and \( 4:5 \), the triangle is right.
+</pre></div>
-</dd>
-<dt><code>\cdots</code>
-<a name="index-_005ccdots"></a>
-</dt>
-<dd><p>A horizontal ellipsis with the dots raised to the center of the line.
+<a name="index-package_002c-amsmath-8"></a>
+<a name="index-amsmath-package-8"></a>
+
+<p>Ordinary LaTeX defines <code>\colon</code> to produce the colon character
+with the spacing appropriate for punctuation, as in set-builder notation
+<code>\{x\colon 0\leq x&lt;1\}</code>.
</p>
-</dd>
-<dt><code>\ddots</code>
-<a name="index-_005cddots"></a>
-</dt>
-<dd><p>A diagonal ellipsis: <em>\ddots</em>.
+<a name="index-package_002c-amsmath-9"></a>
+<a name="index-amsmath-package-9"></a>
+
+<p>But the widely-used <samp>amsmath</samp> package defines <code>\colon</code> for use
+in the definition of functions <code>f\colon D\to C</code>. So if you want
+the colon character as a punctuation then use <code>\mathpunct{:}</code>.
</p>
-</dd>
-<dt><code>\frac{<var>num</var>}{<var>den</var>}</code>
-<a name="index-_005cfrac_007bnum_007d_007bden_007d"></a>
-</dt>
-<dd><a name="index-_005cfrac"></a>
-<p>Produces the fraction <var>num</var> divided by <var>den</var>.
+
+<hr>
+<a name="g_t_005c_002a"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cfrac" accesskey="n" rel="next">\frac</a>, Previous: <a href="#Colon-character-_0026-_005ccolon" accesskey="p" rel="prev">Colon character &amp; \colon</a>, Up: <a href="#Math-miscellany" accesskey="u" rel="up">Math miscellany</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005c_002a-1"></a>
+<h4 class="subsection">16.7.2 <code>\*</code></h4>
+
+<a name="index-multiplication_002c-discretionary"></a>
+<a name="index-breaks_002c-multiplication-discretionary"></a>
+<a name="index-line-breaks_002c-multiplication-discretionary"></a>
+<a name="index-discretionary-breaks_002c-multiplication"></a>
+<a name="index-_005c_002a"></a>
+
+<p>Synopsis:
</p>
+<div class="example">
+<pre class="example">\*
+</pre></div>
-</dd>
-<dt><code>\left <var>delim1</var> ... \right <var>delim2</var></code>
-<a name="index-_005cleft-delim1-_002e_002e_002e-_005cright-delim2"></a>
-</dt>
-<dd><a name="index-_005cright"></a>
-<a name="index-null-delimiter"></a>
-<p>The two delimiters need not match; &lsquo;<samp>.</samp>&rsquo; acts as a <em>null delimiter</em>,
-producing no output. The delimiters are sized according to the math
-in between. Example: <code>\left( \sum_{i=1}^{10} a_i \right]</code>.
+<p>A multiplication symbol that allows a line break. If there is a break
+then LaTeX puts a <code>\times</code> symbol, &#x00D7;, before
+that break.
</p>
-</dd>
-<dt><code>\mathdollar</code>
-<a name="index-_005cmathdollar"></a>
-</dt>
-<dd><p>Dollar sign in math mode: $.
+<p>In <code>\( A_1\* A_2\* A_3\* A_4 \)</code>, if there is no line break then
+LaTeX outputs it as though it were <code>\( A_1 A_2 A_3 A_4 \)</code>. If
+a line break does happen, for example between the two middle ones, then
+LaTeX sets it like <code>\( A_1 A_2 \times \)</code>, followed by the
+break, followed by <code>\( A_3 A_4 \)</code>.
</p>
-</dd>
-<dt><code>\mathellipsis</code>
-<a name="index-_005cmathellipsis"></a>
-</dt>
-<dd><p>Ellipsis (spaced for text) in math mode: &hellip;.
+
+<hr>
+<a name="g_t_005cfrac"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cleft-_0026-_005cright" accesskey="n" rel="next">\left &amp; \right</a>, Previous: <a href="#g_t_005c_002a" accesskey="p" rel="prev">\*</a>, Up: <a href="#Math-miscellany" accesskey="u" rel="up">Math miscellany</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cfrac-1"></a>
+<h4 class="subsection">16.7.3 <code>\frac</code></h4>
+
+<a name="index-fraction"></a>
+<a name="index-_005cfrac"></a>
+
+<p>Synopsis:
</p>
-</dd>
-<dt><code>\mathparagraph</code>
-<a name="index-_005cmathparagraph"></a>
-</dt>
-<dd><p>Paragraph sign (pilcrow) in math mode: &#x00B6;.
+<div class="example">
+<pre class="example">\frac{<var>numerator</var>}{<var>denominator</var>}
+</pre></div>
+
+<p>Produces the fraction. Used as: <code>\begin{displaymath}
+\frac{1}{\sqrt{2\pi\sigma}} \end{displaymath}</code>. In inline math
+mode it comes out small; see the discussion of <code>\displaystyle</code>
+(see <a href="#Math-formulas">Math formulas</a>).
</p>
-</dd>
-<dt><code>\mathsection</code>
-<a name="index-_005cmathsection"></a>
-</dt>
-<dd><p>Section sign in math mode.
+
+<hr>
+<a name="g_t_005cleft-_0026-_005cright"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005csqrt" accesskey="n" rel="next">\sqrt</a>, Previous: <a href="#g_t_005cfrac" accesskey="p" rel="prev">\frac</a>, Up: <a href="#Math-miscellany" accesskey="u" rel="up">Math miscellany</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cleft-_0026-_005cright-1"></a>
+<h4 class="subsection">16.7.4 <code>\left</code> &amp; <code>\right</code></h4>
+
+<a name="index-delimiters_002c-paired"></a>
+<a name="index-paired-delimiters"></a>
+<a name="index-matching-parentheses"></a>
+<a name="index-matching-brackets"></a>
+<a name="index-null-delimiter"></a>
+<a name="index-_005cleft"></a>
+<a name="index-_005cright"></a>
+
+<p>Synopsis:
</p>
-</dd>
-<dt><code>\mathsterling</code>
-<a name="index-_005cmathsterling"></a>
-</dt>
-<dd><p>Sterling sign in math mode: &pound;.
+<div class="example">
+<pre class="example">\left <var>delimiter1</var> ... \right <var>delimiter2</var>
+</pre></div>
+
+<p>Make matching parentheses, braces, or other delimiters. The delimiters
+are sized according to the math they enclose. This makes a unit vector
+surrounded by appropriate-height parentheses.
</p>
-</dd>
-<dt><code>\mathunderscore</code>
-<a name="index-_005cmathunderscore"></a>
-</dt>
-<dd><p>Underscore in math mode: _.
+<div class="example">
+<pre class="example">\begin{equation}
+ \left(\begin{array}{c}
+ 1 \\
+ 0 \\
+ \end{array}\right)
+</pre></div>
+
+<p>Every <code>\left</code> must have a matching <code>\right</code>. Leaving out the
+<code>\left(</code> in the above gets &lsquo;<samp>Extra \right</samp>&rsquo;. Leaving off the
+<code>\right)</code> gets &lsquo;<samp>You can't use `\eqno' in math mode</samp>&rsquo;.
</p>
-</dd>
-<dt><code>\overbrace{<var>math</var>}</code>
-<a name="index-_005coverbrace_007bmath_007d"></a>
-</dt>
-<dd><p>Generates a brace over <var>math</var>.
-For example, <code>\overbrace{x+\cdots+x}^{k \;\textrm{times}}</code>.
-</p>
-</dd>
-<dt><code>\overline{<var>text</var>}</code>
-<a name="index-_005coverline_007btext_007d"></a>
-</dt>
-<dd><p>Generates a horizontal line over <var>tex</var>.
-For example, <code>\overline{x+y}</code>.
+<p>However, the two delimiters <var>delimiter1</var> and <var>delimiter2</var> need
+not match. A common case is that you want an unmatched brace, as
+below. Use a period, &lsquo;<samp>.</samp>&rsquo;, as a null delimiter.
</p>
-</dd>
-<dt><code>\sqrt[<var>root</var>]{<var>arg</var>}</code>
-<a name="index-_005csqrt_005broot_005d_007barg_007d"></a>
-</dt>
-<dd><p>Produces the representation of the square root of <var>arg</var>. The
-optional argument <var>root</var> determines what root to produce. For
-example, the cube root of <code>x+y</code> would be typed as
-<code>\sqrt[3]{x+y}</code>.
+<div class="example">
+<pre class="example">\begin{equation}
+ f(n)=\left\{\begin{array}{ll}
+ 1 &amp;\mbox{--if \(n=0\)} \\
+ f(n-1)+3n^2 &amp;\mbox{--else}
+ \end{array}\right.
+\end{equation}
+</pre></div>
+
+<p>Note that to get a curly brace as a delimiter you must prefix it with a
+backslash, <code>\{</code>.
</p>
-</dd>
-<dt><code>\stackrel{<var>text</var>}{<var>relation</var>}</code>
-<a name="index-_005cstackrel_007btext_007d_007brelation_007d"></a>
-</dt>
-<dd><p>Puts <var>text</var> above <var>relation</var>. For example,
-<code>\stackrel{f}{\longrightarrow}</code>.
+
+<hr>
+<a name="g_t_005csqrt"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cstackrel" accesskey="n" rel="next">\stackrel</a>, Previous: <a href="#g_t_005cleft-_0026-_005cright" accesskey="p" rel="prev">\left &amp; \right</a>, Up: <a href="#Math-miscellany" accesskey="u" rel="up">Math miscellany</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005csqrt-1"></a>
+<h4 class="subsection">16.7.5 <code>\sqrt</code></h4>
+
+<a name="index-square-root"></a>
+<a name="index-roots"></a>
+<a name="index-radical"></a>
+<a name="index-_005csqrt"></a>
+
+<p>Synopsis, one of:
</p>
-</dd>
-<dt><code>\underbrace{<var>math</var>}</code>
-<a name="index-_005cunderbrace_007bmath_007d"></a>
-</dt>
-<dd><p>Generates <var>math</var> with a brace underneath. For example, <code>\underbrace{x+y+z}_{&gt;\,0}</code>
+<div class="example">
+<pre class="example">\sqrt{<var>arg</var>}
+\sqrt[<var>root-number</var>]{<var>arg</var>}
+</pre></div>
+
+<p>The square root, or optionally other roots, of <var>arg</var>. The optional
+argument <var>root-number</var> gives the root, i.e., enter the cube root of
+<code>x+y</code> as <code>\sqrt[3]{x+y}</code>.
+The radical grows with the size of <var>arg</var> (as the height of the
+radical grows, the angle on the leftmost part gets steeper, until for
+a large enough <code>arg</code>, it is vertical).
</p>
-</dd>
-<dt><code>\underline{<var>text</var>}</code>
-<a name="index-_005cunderline_007btext_007d"></a>
-</dt>
-<dd><p>Causes <var>text</var>, which may be either math mode or not, to be
-underlined. The line is always below the text, taking account of
-descenders.
+<p>LaTeX has a separate <code>\surd</code> character (see <a href="#Math-symbols">Math symbols</a>).
</p>
-</dd>
-<dt><code>\vdots</code>
-<a name="index-_005cvdots"></a>
-</dt>
-<dd><p>Produces a vertical ellipsis.
+
+<hr>
+<a name="g_t_005cstackrel"></a>
+<div class="header">
+<p>
+Previous: <a href="#g_t_005csqrt" accesskey="p" rel="prev">\sqrt</a>, Up: <a href="#Math-miscellany" accesskey="u" rel="up">Math miscellany</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cstackrel-1"></a>
+<h4 class="subsection">16.7.6 <code>\stackrel</code></h4>
+
+<a name="index-stack-math"></a>
+<a name="index-relation_002c-text-above"></a>
+<a name="index-_005cstackrel"></a>
+
+<p>Synopsis, one of:
</p>
-</dd>
-</dl>
+<div class="example">
+<pre class="example">\stackrel{<var>text</var>}{<var>relation</var>}
+</pre></div>
+<p>Put <var>text</var> above <var>relation</var>. To put a function name above an
+arrow enter <code>\stackrel{f}{\longrightarrow}</code>.
+</p>
<hr>
<a name="Modes"></a>
<div class="header">
<p>
-Next: <a href="#Page-styles" accesskey="n" rel="next">Page styles</a>, Previous: <a href="#Math-formulas" accesskey="p" rel="prev">Math formulas</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Page-styles" accesskey="n" rel="next">Page styles</a>, Previous: <a href="#Math-formulas" accesskey="p" rel="prev">Math formulas</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Modes-1"></a>
<h2 class="chapter">17 Modes</h2>
<a name="index-modes"></a>
-<a name="index-paragraph-mode"></a>
-<a name="index-math-mode"></a>
-<a name="index-left_002dto_002dright-mode"></a>
-<a name="index-LR-mode"></a>
-<p>When LaTeX is processing your input text, it is always in one of three
-modes:
+<p>As LaTeX processes your document, at any point it is in one of six
+modes. They fall into three categories of two each, the horizontal
+modes, the math modes, and the vertical modes. Some commands only work
+in one mode or another (in particular, many commands only work in one of
+the math modes), and error messages will refer to these.
</p>
<ul>
-<li> Paragraph mode
-</li><li> Math mode
-</li><li> Left-to-right mode, called LR mode for short
+<li> <a name="modes-paragraph-mode"></a><a name="index-paragraph-mode"></a>
+<em>Paragraph mode</em> is what LaTeX is in when processing ordinary
+text. It breaks the input text into lines and breaks the lines into
+pages. This is the mode LaTeX is in most of the time.
+
+<a name="index-left_002dto_002dright-mode"></a>
+<a name="index-LR-mode"></a>
+<a name="modes-lr-mode"></a><p><em>LR mode</em> (for left-to-right mode; in plain TeX this is called
+<em>restricted horizontal mode</em>) is in effect when LaTeX starts
+making a box with an <code>\mbox</code> command. As in paragraph mode,
+LaTeX&rsquo;s output is a string of words with spaces between them. Unlike
+in paragraph mode, in LR mode LaTeX never starts a new line, it just
+keeps going from left to right. (Although LaTeX will not complain
+that the LR box is too long, when it is finished and next tries to put
+that box into a line, it could very well complain that the finished LR
+box won&rsquo;t fit there.)
+</p>
+</li><li> <a name="index-math-mode"></a>
+<a name="modes-math-mode"></a><em>Math mode</em> is when LaTeX is generating
+an inline mathematical formula.
+
+<a name="index-display-math-mode"></a>
+<p><em>Display math mode</em> is when LaTeX is generating a displayed
+mathematical formula. (Displayed formulas differ somewhat from inline
+ones. One example is that the placement of the subscript on <code>\int</code>
+differs in the two situations.)
+</p>
+</li><li> <a name="index-vertical-mode"></a>
+<a name="modes-vertical-mode"></a><em>Vertical mode</em> is when LaTeX is building the list of lines and
+other material making the output page. This is the mode LaTeX is in
+when it starts a document.
+
+<a name="index-internal-vertical-mode"></a>
+<a name="modes-internal-vertical-mode"></a><p><em>Internal vertical mode</em> is in effect when LaTeX starts making a
+<code>\vbox</code>. This is the vertical analogue of LR mode.
+</p>
</li></ul>
-<p>Mode changes occur only when entering or leaving an environment, or when
-LaTeX is processing the argument of certain text-producing commands.
-</p>
-<p><em>Paragraph mode</em> is the most common; it&rsquo;s the one LaTeX is in
-when processing ordinary text. In this mode, LaTeX breaks the
-input text into lines and breaks the lines into pages.
-</p>
-<p>LaTeX is in <em>math mode</em> when it&rsquo;s generating a mathematical
-formula, either displayed math or within a line.
-</p>
-<a name="index-_005cmbox_002c-and-LR-mode"></a>
-<p>In <em>LR mode</em>, as in paragraph mode, LaTeX considers the output
-that it produces to be a string of words with spaces between them.
-However, unlike paragraph mode, LaTeX keeps going from left to
-right; it never starts a new line in LR mode. Even if you put a
-hundred words into an <code>\mbox</code>, LaTeX would keep typesetting
-them from left to right inside a single box (and then most likely
-complain because the resulting box was too wide to fit on the line).
-LaTeX is in LR mode when it starts making a box with an
-<code>\mbox</code> command. You can get it to enter a different mode inside
-the box&mdash;for example, you can make it enter math mode to put a
-formula in the box.
-</p>
-<p>There are also several text-producing commands and environments for
-making a box that put LaTeX into paragraph mode. The box made by
-one of these commands or environments will be called a <code>parbox</code>.
-When LaTeX is in paragraph mode while making a box, it is said to
-be in &ldquo;inner paragraph mode&rdquo; (no page breaks). Its normal paragraph
-mode, which it starts out in, is called &ldquo;outer paragraph mode&rdquo;.
+<p>For instance, if you begin a LaTeX article with &lsquo;<samp>Let \( x \) be
+...</samp>&rsquo; then these are the modes: first LaTeX starts every document in
+vertical mode, then it reads the &lsquo;<samp>L</samp>&rsquo; and switches to paragraph
+mode, then the next switch happens at the &lsquo;<samp>\(</samp>&rsquo; where LaTeX
+changes to math mode, and then when it leaves the formula it pops
+back to paragraph mode.
+</p>
+<a name="index-inner-paragraph-mode"></a>
+<a name="index-outer-paragraph-mode"></a>
+<a name="modes-inner-paragraph-mode"></a><a name="modes-outer-paragraph-mode"></a><p>Paragraph mode has two subcases. If you use a <code>\parbox</code> command or
+or a <code>minipage</code> then LaTeX is put into paragraph mode. But it
+will not put a page break here. Inside one of these boxes, called a
+<em>parbox</em>, LaTeX is in <em>inner paragraph mode</em>. Its more usual
+situation, where it can put page breaks, is <em>outer paragraph mode</em>
+(see <a href="#Page-breaking">Page breaking</a>).
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#g_t_005censuremath" accesskey="1">\ensuremath</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Ensure that math mode is active
@@ -11886,7 +14962,7 @@ mode, which it starts out in, is called &ldquo;outer paragraph mode&rdquo;.
<a name="g_t_005censuremath"></a>
<div class="header">
<p>
-Up: <a href="#Modes" accesskey="u" rel="up">Modes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Up: <a href="#Modes" accesskey="u" rel="up">Modes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005censuremath-1"></a>
<h3 class="section">17.1 <code>\ensuremath</code></h3>
@@ -11897,40 +14973,32 @@ Up: <a href="#Modes" accesskey="u" rel="up">Modes</a> &nbsp; [<a href="#SEC_Cont
<pre class="example">\ensuremath{<var>formula</var>}
</pre></div>
-<p>The <code>\ensuremath</code> command ensures that <var>formula</var> is typeset in
-math mode whatever the current mode in which the command is used.
+<p>Ensure that <var>formula</var> is typeset in math mode.
</p>
-<p>For instance:
+<p>For instance, you can redefine commands that ordinarily can be used only
+in math mode, so that they can be used both in math and in plain text.
</p>
<div class="example">
-<pre class="example">\documentclass{report}
-\newcommand{\ab}{\ensuremath{(\delta, \varepsilon)}}
-\begin{document}
-Now, the \ab\ pair is equal to \(\ab = (\frac{1}{\pi}, 0)\), ...
-\end{document}
+<pre class="example">\newcommand{\dx}{\ensuremath{dx}}
+In $\int f(x)\, \dx$, the \dx{} is an infinitesimal.
</pre></div>
-<p>One can redefine commands that can be used only in math mode so that
-they ca be used in any mode like in the following example given for
-<code>\leadsto</code>:
+<p>Caution: the <code>\ensuremath</code> command is useful but not a panacea.
</p>
<div class="example">
-<pre class="example">\documentclass{report}
-\usepackage{amssymb}
-\newcommand{\originalMeaningOfLeadsTo}{}
-\let\originalMeaningOfLeadsTo\leadsto
-\renewcommand\leadsto{\ensuremath{\originalMeaningOfLeadsTo}}
-\begin{document}
-All roads \leadsto\ Rome.
-\end{document}
+<pre class="example">\newcommand{\alf}{\ensuremath{\alpha}}
+You get an alpha in text mode: \alf.
+But compare the correct spacing in $\alf+\alf$ with that in \alf+\alf.
</pre></div>
+<p>Best is to typeset math things in a math mode.
+</p>
<hr>
<a name="Page-styles"></a>
<div class="header">
<p>
-Next: <a href="#Spaces" accesskey="n" rel="next">Spaces</a>, Previous: <a href="#Modes" accesskey="p" rel="prev">Modes</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Spaces" accesskey="n" rel="next">Spaces</a>, Previous: <a href="#Modes" accesskey="p" rel="prev">Modes</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Page-styles-1"></a>
<h2 class="chapter">18 Page styles</h2>
@@ -11938,8 +15006,17 @@ Next: <a href="#Spaces" accesskey="n" rel="next">Spaces</a>, Previous: <a href="
<a name="index-styles_002c-page"></a>
<a name="index-page-styles"></a>
-<p>The <code>\documentclass</code> command determines the size and position of
-the page&rsquo;s head and foot. The page style determines what goes in them.
+<p>The style of a page determines where LaTeX places the components of
+that page, such as headers and footers, and the text body. This
+includes pages in the main part of the document but also includes
+special pages such as the title page of a book, a page from an index, or
+the first page of an article.
+</p>
+<a name="index-package_002c-fancyhdr"></a>
+<a name="index-fancyhdr-package"></a>
+
+<p>The package <samp>fancyhdr</samp> is very helpful for constructing page
+styles. See its documentation on CTAN.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#g_t_005cmaketitle" accesskey="1">\maketitle</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Generate a title page.
@@ -11957,7 +15034,7 @@ the page&rsquo;s head and foot. The page style determines what goes in them.
<a name="g_t_005cmaketitle"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cpagenumbering" accesskey="n" rel="next">\pagenumbering</a>, Up: <a href="#Page-styles" accesskey="u" rel="up">Page styles</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cpagenumbering" accesskey="n" rel="next">\pagenumbering</a>, Up: <a href="#Page-styles" accesskey="u" rel="up">Page styles</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cmaketitle-1"></a>
<h3 class="section">18.1 <code>\maketitle</code></h3>
@@ -11965,31 +15042,69 @@ Next: <a href="#g_t_005cpagenumbering" accesskey="n" rel="next">\pagenumbering</
<a name="index-titles_002c-making"></a>
<a name="index-_005cmaketitle"></a>
-<p>The <code>\maketitle</code> command generates a title on a separate title
-page&mdash;except in the <code>article</code> class, where the title is placed
-at the top of the first page. Information used to produce the title
-is obtained from the following declarations:
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\maketitle
+</pre></div>
+
+<p>Generate a title. In the standard classes the title appears on a
+separate page, except in the <code>article</code> class where it is at the top
+of the first page. (See <a href="#Document-class-options">Document class options</a> for information about
+the <code>titlepage</code> document class option.)
+</p>
+<p>This example shows <code>\maketitle</code> appearing in its usual place,
+immediately after <code>\begin{document}</code>.
+</p>
+<div class="example">
+<pre class="example">\documentclass{article}
+\title{Constructing a Nuclear Reactor Using Only Coconuts}
+\author{Jonas Grumby\thanks{%
+ With the support of a Ginger Grant from the Roy Hinkley Society.} \\
+ Skipper, \textit{Minnow}
+ \and
+ Willy Gilligan\thanks{%
+ Thanks to the Mary Ann Summers foundation
+ and to Thurston and Lovey Howell.} \\
+ Mate, \textit{Minnow}
+ }
+\date{1964-Sep-26}
+\begin{document}
+\maketitle
+Just sit right back and you'll hear a tale, a tale of a fateful trip.
+That started from this tropic port, aboard this tiny ship. The mate was
+a mighty sailin' man, the Skipper brave and sure. Five passengers set
+sail that day for a three hour tour. A three hour tour.
+ ...
+</pre></div>
+
+<p>You tell LaTeX the information used to produce the title by making
+the following declarations. These must come before the
+<code>\maketitle</code>, either in the preamble or in the document body.
</p>
<dl compact="compact">
-<dt><code>\author{<var>name</var> \and <var>name2</var>}</code>
-<a name="index-_005cauthor_007bname-_005cand-name2_007d"></a>
+<dt><code>\author{<var>name1</var> \and <var>name2</var> \and ...}</code>
+<a name="index-_005cauthor_007bname1-_005cand-name2-_005cand-_002e_002e_002e_007d"></a>
</dt>
<dd><a name="index-author_002c-for-titlepage"></a>
<a name="index-_005c_005c-for-_005cauthor"></a>
<a name="index-_005cand-for-_005cauthor"></a>
-<p>The <code>\author</code> command declares the document author(s), where the
-argument is a list of authors separated by <code>\and</code> commands. Use
-<code>\\</code> to separate lines within a single author&rsquo;s entry&mdash;for
-example, to give the author&rsquo;s institution or address.
+<p>Required. Declare the document author or authors. The argument is a
+list of authors separated by <code>\and</code> commands. To separate lines
+within a single author&rsquo;s entry, for instance to give the author&rsquo;s
+institution or address, use a double backslash, <code>\\</code>. If you omit
+the <code>\author</code> declaration then you get &lsquo;<samp>LaTeX Warning: No
+\author given</samp>&rsquo;.
</p>
</dd>
<dt><code>\date{<var>text</var>}</code>
<a name="index-_005cdate_007btext_007d"></a>
</dt>
<dd><a name="index-date_002c-for-titlepage"></a>
-<p>The <code>\date</code> command declares <var>text</var> to be the document&rsquo;s
-date. With no <code>\date</code> command, the current date (see <a href="#g_t_005ctoday">\today</a>)
-is used.
+<p>Optional. Declare <var>text</var> to be the document&rsquo;s date. The <var>text</var>
+doesn&rsquo;t need to be in a date format; it can be any text at all. If you
+omit <code>\date</code> then LaTeX uses the current date (see <a href="#g_t_005ctoday">\today</a>).
+To have no date, instead use <code>\date{}</code>.
</p>
</dd>
<dt><code>\thanks{<var>text</var>}</code>
@@ -11997,8 +15112,10 @@ is used.
</dt>
<dd><a name="index-thanks_002c-for-titlepage"></a>
<a name="index-credit-footnote"></a>
-<p>The <code>\thanks</code> command produces a <code>\footnote</code> to the title,
-usually used for credit acknowledgements.
+<p>Optional. Produce a footnote. You can use it in the author information
+for acknowledgements, as illustrated below, but you can also use it in
+the title, or any place a footnote makes sense. It can be any text so
+you can use it to print an email address, or for any purpose.
</p>
</dd>
<dt><code>\title{<var>text</var>}</code>
@@ -12006,18 +15123,26 @@ usually used for credit acknowledgements.
</dt>
<dd><a name="index-title_002c-for-titlepage"></a>
<a name="index-_005c_005c-for-_005ctitle"></a>
-<p>The <code>\title</code> command declares <var>text</var> to be the title of the
-document. Use <code>\\</code> to force a line break, as usual.
+<p>Required. Declare <var>text</var> to be the title of the document. Get line
+breaks inside <var>text</var> with a double backslash, <code>\\</code>. If you
+omit the <code>\title</code> declaration then you get &lsquo;<samp>LaTeX Error: No
+\title given</samp>&rsquo;.
</p>
</dd>
</dl>
+<p>Many publishers will provide a class to use in place of <code>article</code>
+in that example, that formats the title according to their house
+requirements. To make your own, see&nbsp;<a href="#titlepage">titlepage</a>. You can
+either create this as a one-off or you can include it as part of a
+renewed <code>\maketitle</code> command.
+</p>
<hr>
<a name="g_t_005cpagenumbering"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cpagestyle" accesskey="n" rel="next">\pagestyle</a>, Previous: <a href="#g_t_005cmaketitle" accesskey="p" rel="prev">\maketitle</a>, Up: <a href="#Page-styles" accesskey="u" rel="up">Page styles</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cpagestyle" accesskey="n" rel="next">\pagestyle</a>, Previous: <a href="#g_t_005cmaketitle" accesskey="p" rel="prev">\maketitle</a>, Up: <a href="#Page-styles" accesskey="u" rel="up">Page styles</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cpagenumbering-1"></a>
<h3 class="section">18.2 <code>\pagenumbering</code></h3>
@@ -12028,41 +15153,78 @@ Next: <a href="#g_t_005cpagestyle" accesskey="n" rel="next">\pagestyle</a>, Prev
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\pagenumbering{<var>style</var>}
+<pre class="example">\pagenumbering{<var>number-style</var>}
</pre></div>
-<p>Specifies the style of page numbers, according to <var>style</var>; also
-resets the page number to 1. The <var>style</var> argument is one of
-the following:
+<p>Specifies the style of page numbers, and resets the page number. The
+numbering style is reflected on the page, and also in the table of
+contents and other page references. This declaration has global scope
+so its effect is not delimited by braces or environments.
+</p>
+<p>In this example, before the Main section the pages are numbered
+&lsquo;<samp>a</samp>&rsquo;, etc. Starting on the page containing that section, the pages
+are numbered &lsquo;<samp>1</samp>&rsquo;, etc.
+</p>
+<div class="example">
+<pre class="example">\begin{document}\pagenumbering{alph}
+ ...
+\section{Main}\pagenumbering{arabic}
+ ...
+</pre></div>
+
+<p>The argument <var>number-style</var> is one of the following (see
+also&nbsp;<a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a>).
</p>
<dl compact="compact">
<dt><code>arabic</code></dt>
-<dd><p>arabic numerals
+<dd><p>arabic numerals: 1, 2, &hellip;
</p>
</dd>
<dt><code>roman</code></dt>
-<dd><p>lowercase Roman numerals
+<dd><p>lowercase Roman numerals: i, ii, &hellip;
</p>
</dd>
<dt><code>Roman</code></dt>
-<dd><p>uppercase Roman numerals
+<dd><p>uppercase Roman numerals: I, II, &hellip;
</p>
</dd>
<dt><code>alph</code></dt>
-<dd><p>lowercase letters
+<dd><p>lowercase letters: a, b, &hellip; If you have more than 26 pages then you
+get &lsquo;<samp>LaTeX Error: Counter too large</samp>&rsquo;.
</p>
</dd>
<dt><code>Alph</code></dt>
-<dd><p>uppercase letters
-</p></dd>
+<dd><p>uppercase letters: A, B, &hellip; If you have more than 26 pages then you
+get &lsquo;<samp>LaTeX Error: Counter too large</samp>&rsquo;.
+</p>
+</dd>
+<dt><code>gobble</code></dt>
+<dd><a name="index-package_002c-hyperref-2"></a>
+<a name="index-hyperref-package-2"></a>
+<p>LaTeX does not output a page number, although it
+does get reset. References to that page also are blank. (This does not
+work with the popular package <samp>hyperref</samp> so to have the page number
+not appear you may want to instead use <code>\pagestyle{empty}</code> or
+<code>\thispagestyle{empty}</code>.)
+</p>
+</dd>
</dl>
+<p>Traditionally, if a document has front matter&mdash;preface, table of
+contents, etc.&mdash;then it is numbered with lowercase Roman numerals. The
+main matter of a document uses arabic. See <a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter &amp; \mainmatter &amp; \backmatter</a>.
+</p>
+<p>If you want to address where the page number appears on the page,
+see&nbsp;<a href="#g_t_005cpagestyle">\pagestyle</a>. If you want to change the value of page
+number then you will manipulate the <code>page</code> counter
+(see <a href="#Counters">Counters</a>).
+</p>
<hr>
<a name="g_t_005cpagestyle"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cthispagestyle" accesskey="n" rel="next">\thispagestyle</a>, Previous: <a href="#g_t_005cpagenumbering" accesskey="p" rel="prev">\pagenumbering</a>, Up: <a href="#Page-styles" accesskey="u" rel="up">Page styles</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cthispagestyle" accesskey="n" rel="next">\thispagestyle</a>, Previous: <a href="#g_t_005cpagenumbering" accesskey="p" rel="prev">\pagenumbering</a>, Up: <a href="#Page-styles" accesskey="u" rel="up">Page styles</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cpagestyle-1"></a>
<h3 class="section">18.3 <code>\pagestyle</code></h3>
@@ -12078,21 +15240,32 @@ Next: <a href="#g_t_005cthispagestyle" accesskey="n" rel="next">\thispagestyle</
<pre class="example">\pagestyle{<var>style</var>}
</pre></div>
-<p>The <code>\pagestyle</code> command specifies how the headers and footers
-are typeset from the current page onwards. Values for <var>style</var>:
+<p>Declaration that specifies how the page headers and footers are typeset,
+from the current page onwards.
+</p>
+<a name="index-package_002c-fancyhdr-1"></a>
+<a name="index-fancyhdr-package-1"></a>
+
+<p>A discussion with an example is below. Note first that the package
+<samp>fancyhdr</samp> is now the standard way to manipulate headers and
+footers. New documents that need to do anything other than one of the
+standard options below should use this package. See its documentation
+on CTAN.
+</p>
+<p>Values for <var>style</var>:
</p>
<dl compact="compact">
<dt><code>plain</code></dt>
-<dd><p>Just a plain page number.
+<dd><p>The header is empty. The footer contains only a page number, centered.
</p>
</dd>
<dt><code>empty</code></dt>
-<dd><p>Empty headers and footers, e.g., no page numbers.
+<dd><p>The header and footer is empty.
</p>
</dd>
<dt><code>headings</code></dt>
-<dd><p>Put running headers on each page. The document style specifies what
-goes in the headers.
+<dd><p>Put running headers and footers on each page. The document style
+specifies what goes in there; see the discussion below.
</p>
</dd>
<dt><code>myheadings</code></dt>
@@ -12102,24 +15275,67 @@ goes in the headers.
</dd>
</dl>
+<p>Some discussion of the motivation for LaTeX&rsquo;s mechanism will help you
+work with the options <code>headings</code> or <code>myheadings</code>. The
+document source below produces an article, two-sided, with the pagestyle
+<code>headings</code>. On this document&rsquo;s left hand pages, LaTeX wants (in
+addition to the page number) the title of the current section. On its
+right hand pages LaTeX wants the title of the current subsection.
+When it makes up a page, LaTeX gets this information from the
+commands <code>\leftmark</code> and <code>\rightmark</code>. So it is up to
+<code>\section</code> and <code>\subsection</code> to store that information there.
+</p>
+<div class="example">
+<pre class="example">\documentclass[twoside]{article}
+\pagestyle{headings}
+\begin{document}
+ ... \section{Section 1} ... \subsection{Subsection 1.1} ...
+\section{Section 2}
+ ...
+\subsection{Subsection 2.1}
+ ...
+\subsection{Subsection 2.2}
+ ...
+</pre></div>
+
+<p>Suppose that the second section falls on a left page. Although when the
+page starts it is in the first section, LaTeX will put
+&lsquo;<samp>Section&nbsp;2</samp>&rsquo; in the left page header. As to the right header,
+if no subsection starts before the end of the right page then LaTeX
+blanks the right hand header. If a subsection does appear before the
+right page finishes then there are two cases. If at least one
+subsection starts on the right hand page then LaTeX will put in the
+right header the title of the first subsection starting on that right
+page. If at least one of 2.1, 2.2, &hellip;, starts on the left page but
+none starts on the right then LaTeX puts in the right hand header the
+title of the last subsection to start, that is, the one in effect during
+the right hand page.
+</p>
+<p>To accomplish this, in a two-sided article, LaTeX has <code>\section</code>
+issue a command <code>\markboth</code>, setting <code>\leftmark</code>
+to &lsquo;<samp>Section&nbsp;2</samp>&rsquo; and setting <code>\rightmark</code> to blank.
+And, LaTeX has <code>\subsection</code> issue a command <code>\markright</code>,
+setting <code>\rightmark</code> to &lsquo;<samp>Subsection&nbsp;2.1</samp>&rsquo;, etc.
+</p>
<p>Here are the descriptions of <code>\markboth</code> and <code>\markright</code>:
</p>
<dl compact="compact">
-<dt><code>\markboth{<var>left</var>}{<var>right</var>}</code>
-<a name="index-_005cmarkboth_007bleft_007d_007bright_007d"></a>
-</dt>
-<dd><p>Sets both the left and the right heading. A &ldquo;left-hand heading&rdquo;
-(<var>left</var>) is generated by the last <code>\markboth</code> command before
-the end of the page, while a &ldquo;right-hand heading&rdquo; (<var>right</var>) is
-generated by the first <code>\markboth</code> or <code>\markright</code> that
-comes on the page if there is one, otherwise by the last one before
-the page.
+<dt><code>\markboth{<var>left-head</var>}{<var>right-head</var>}</code>
+<a name="index-_005cmarkboth_007bleft_002dhead_007d_007bright_002dhead_007d"></a>
+</dt>
+<dd><p>Sets both the right hand and left hand heading information for either a
+page style of <code>headings</code> or <code>myheadings</code>. A left hand page
+heading <var>left-head</var> is generated by the last <code>\markboth</code>
+command before the end of the page. A right hand page heading
+<var>right-head</var> is generated by the first <code>\markboth</code> or
+<code>\markright</code> that comes on the page if there is one, otherwise by
+the last one that came before that page.
</p>
</dd>
<dt><code>\markright{<var>right</var>}</code>
<a name="index-_005cmarkright_007bright_007d"></a>
</dt>
-<dd><p>Sets the right heading, leaving the left heading unchanged.
+<dd><p>Sets the right hand page heading, leaving the left unchanged.
</p>
</dd>
</dl>
@@ -12129,23 +15345,50 @@ the page.
<a name="g_t_005cthispagestyle"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cpagestyle" accesskey="p" rel="prev">\pagestyle</a>, Up: <a href="#Page-styles" accesskey="u" rel="up">Page styles</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cpagestyle" accesskey="p" rel="prev">\pagestyle</a>, Up: <a href="#Page-styles" accesskey="u" rel="up">Page styles</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cthispagestyle_007bstyle_007d"></a>
-<h3 class="section">18.4 <code>\thispagestyle{<var>style</var>}</code></h3>
+<a name="g_t_005cthispagestyle-1"></a>
+<h3 class="section">18.4 <code>\thispagestyle</code></h3>
<a name="index-_005cthispagestyle"></a>
+<a name="index-page-style_002c-this-page"></a>
-<p>The <code>\thispagestyle</code> command works in the same manner as the
-<code>\pagestyle</code> command (see previous section) except that it
-changes to <var>style</var> for the current page only.
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\thispagestyle{<var>style</var>}
+</pre></div>
+
+<p>Works in the same way as the <code>\pagestyle</code> (see <a href="#g_t_005cpagestyle">\pagestyle</a>),
+except that it changes to <var>style</var> for the current page only. This
+declaration has global scope, so its effect is not delimited by braces
+or environments.
+</p>
+<p>Often the first page of a chapter or section has a different style. For
+example, this LaTeX book document has the first page of the first
+chapter in in <code>plain</code> style, as is the default (see <a href="#Page-styles">Page styles</a>).
+</p>
+<div class="example">
+<pre class="example">\documentclass{book}
+\pagestyle{headings}
+\begin{document}
+\chapter{First chapter}
+ ...
+\chapter{Second chapter}\thispagestyle{empty}
+ ...
+</pre></div>
+
+<p>The <code>plain</code> style has a page number on it, centered in the footer.
+To make the page entirely empty, the command
+<code>\thispagestyle{empty}</code> immediately follows the second
+<code>\chapter</code>.
</p>
<hr>
<a name="Spaces"></a>
<div class="header">
<p>
-Next: <a href="#Boxes" accesskey="n" rel="next">Boxes</a>, Previous: <a href="#Page-styles" accesskey="p" rel="prev">Page styles</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Boxes" accesskey="n" rel="next">Boxes</a>, Previous: <a href="#Page-styles" accesskey="p" rel="prev">Page styles</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Spaces-1"></a>
<h2 class="chapter">19 Spaces</h2>
@@ -12153,109 +15396,255 @@ Next: <a href="#Boxes" accesskey="n" rel="next">Boxes</a>, Previous: <a href="#P
<a name="index-spaces"></a>
<a name="index-white-space"></a>
-<p>LaTeX has many ways to produce white (or filled) space.
+<p>LaTeX has many ways to produce white (or filled) space. Some of
+these are best suited to mathematical text; see&nbsp;<a href="#Spacing-in-math-mode">Spacing in math mode</a>. Some spacing commands are suitable for both regular text
+and mathematical text; versions of some of these commands are in this
+chapter.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">Horizontal space
-</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#g_t_005chspace" accesskey="1">\hspace</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Fixed horizontal space.
+</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#g_t_005censpace-_0026-_005cquad-_0026-_005cqquad" accesskey="1">\enspace &amp; \quad &amp; \qquad</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Traditional horizontal spaces.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005chspace" accesskey="2">\hspace</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Any horizontal space.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005chfill" accesskey="2">\hfill</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Stretchable horizontal space.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005chfill" accesskey="3">\hfill</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Stretchable horizontal space.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cspacefactor" accesskey="3">\spacefactor</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Stretchability of following space
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005chss" accesskey="4">\hss</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Infinitely stretchable/shrinkable horizontal space.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005c_0028SPACE_0029-after-control-sequence" accesskey="4">\(SPACE) after control sequence</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Space (gobbling) after a control sequence.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cspacefactor" accesskey="5">\spacefactor</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Stretchability of following space
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cthinspace" accesskey="5">\thinspace</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">One-sixth of an em.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005c_0028SPACE_0029" accesskey="6">\(SPACE)</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Backslash-space; and explicit space.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005c_002f" accesskey="6">\/</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Insert italic correction.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_007e" accesskey="7">~</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Tie, an unbreakable space.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005chrulefill-_005cdotfill" accesskey="7">\hrulefill \dotfill</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Stretchable horizontal rule or dots.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cthinspace-_0026-_005cnegthinspace" accesskey="8">\thinspace &amp; \negthinspace</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">One-sixth of an em, and negative one-sixth.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005c_002f" accesskey="9">\/</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Italic correction.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005chrulefill-_0026-_005cdotfill">\hrulefill &amp; \dotfill</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Stretchable horizontal rule or dots.
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
Vertical space
-</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#g_t_005caddvspace" accesskey="8">\addvspace</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Add arbitrary vertical space if needed.
+</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">\bigskip &amp; \medskip &amp; \smallskip</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Inter-paragraph vertical spaces.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cbigbreak-_0026-_005cmedbreak-_0026-_005csmallbreak">\bigbreak &amp; \medbreak &amp; \smallbreak</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Inter-paragraph space and page breaks.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cstrut">\strut</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Ensure height of a line.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cbigskip-_005cmedskip-_005csmallskip" accesskey="9">\bigskip \medskip \smallskip</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Fixed vertical spaces.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cvspace">\vspace</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Vertical space.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cvfill">\vfill</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Infinitely stretchable vertical space.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cvfill">\vfill</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Stretchable vertical space.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cvspace">\vspace</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Add arbitrary vertical space.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005caddvspace">\addvspace</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Add arbitrary vertical space if needed.
</td></tr>
</table>
<hr>
+<a name="g_t_005censpace-_0026-_005cquad-_0026-_005cqquad"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005chspace" accesskey="n" rel="next">\hspace</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005censpace-_0026-_005cquad-_0026-_005cqquad-1"></a>
+<h3 class="section">19.1 <code>\enspace</code> &amp; <code>\quad</code> &amp; <code>\qquad</code></h3>
+
+<a name="index-_005censpace"></a>
+<a name="index-_005cquad-1"></a>
+<a name="index-_005cqquad-1"></a>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\enspace
+\quad
+\qquad
+</pre></div>
+
+<p>Insert a horizontal space of 1/2em, 1em, or 2em. The
+em is a length defined by a font designer, often thought of as being the
+width of a capital&nbsp;M. One advantage of describing space in ems is
+that it can be more portable across documents than an absolute
+measurement such as points (see <a href="#Lengths_002fem">Lengths/em</a>).
+</p>
+<p>This puts a suitable gap between two graphics.
+</p>
+<div class="example">
+<pre class="example">\begin{center}
+ \includegraphics{womensmile.png}%
+ \qquad\includegraphics{mensmile.png}
+\end{center}
+</pre></div>
+
+<p>See <a href="#Spacing-in-math-mode">Spacing in math mode</a> for <code>\quad</code> and <code>\qquad</code>. These
+are lengths from centuries of typesetting and so may be a better choice
+in many circumstances than arbitrary lengths, such as you get with
+<code>\hspace</code>.
+</p>
+
+<hr>
<a name="g_t_005chspace"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005chfill" accesskey="n" rel="next">\hfill</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005chfill" accesskey="n" rel="next">\hfill</a>, Previous: <a href="#g_t_005censpace-_0026-_005cquad-_0026-_005cqquad" accesskey="p" rel="prev">\enspace &amp; \quad &amp; \qquad</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005chspace-1"></a>
-<h3 class="section">19.1 <code>\hspace</code></h3>
+<h3 class="section">19.2 <code>\hspace</code></h3>
<a name="index-_005chspace"></a>
-<p>Synopsis:
+<p>Synopsis, one of:
</p>
<div class="example">
<pre class="example">\hspace{<var>length</var>}
\hspace*{<var>length</var>}
</pre></div>
-<p>Add the horizontal space given by <var>length</var>. The <var>length</var> is a
-rubber length, that is, it may contain a <code>plus</code> or <code>minus</code>
-component, in any unit that LaTeX understands (see <a href="#Lengths">Lengths</a>).
+<p>Insert the horizontal space <var>length</var>. The <var>length</var> can be
+positive, negative, or zero; adding negative space is like backspacing.
+It is a rubber length, that is, it may contain a <code>plus</code> or
+<code>minus</code> component, or both (see <a href="#Lengths">Lengths</a>). Because the space is
+stretchable and shrinkable, it is sometimes called <em>glue</em>.
</p>
-<p>This command can add both positive and negative space; adding negative
-space is like backspacing.
+<p>This makes a line with &lsquo;<samp>Name:</samp>&rsquo; an inch from the right margin.
</p>
-<p>Normally when TeX breaks a paragraph into lines it discards white
-space (glues and kerns) that would come at the start of a line, so you
-get an inter-word space or a line break between words but not both. This
-command&rsquo;s starred version <code>\hspace*{...}</code> puts a non-discardable
-invisible item in front of the space, so the space appears in the
-output.
+<div class="example">
+<pre class="example">\noindent\makebox[\linewidth][r]{Name:\hspace{1in}}
+</pre></div>
+
+<p>The <code>*</code>-version inserts horizontal space that non-discardable.
+More precisely, when TeX breaks a paragraph into lines any white
+space&mdash;glues and kerns&mdash;that come at a line break are discarded. The
+<code>*</code>-version avoids that (technically, it adds a non-discardable
+invisible item in front of the space).
</p>
-<p>This example make a one-line paragraph that puts &lsquo;<samp>Name:</samp>&rsquo; an inch
-from the right margin.
+<p>In this example
</p>
<div class="example">
-<pre class="example">\noindent\makebox[\linewidth]{\hspace{\fill}Name:\hspace{1in}}
+<pre class="example">\parbox{0.8\linewidth}{%
+ Fill in each blank: Four \hspace*{1in} and seven years ago our
+ fathers brought forth on this continent, a new \hspace*{1in},
+ conceived in \hspace*{1in}, and dedicated to the proposition
+ that all men are created \hspace*{1in}.}
</pre></div>
+<p>the 1&nbsp;inch blank following &lsquo;<samp>conceived in</samp>&rsquo; falls at the start
+of a line. If you erase the <code>*</code> then LaTeX discards the blank.
+</p>
+<p>Here, the <code>\hspace</code> separates the three graphics.
+</p>
+<div class="example">
+<pre class="example">\begin{center}
+ \includegraphics{lion.png}% comment keeps out extra space
+ \hspace{1cm minus 0.25cm}\includegraphics{tiger.png}%
+ \hspace{1cm minus 0.25cm}\includegraphics{bear.png}
+\end{center}
+</pre></div>
+
+<p>Because the argument to each <code>\hspace</code> has <code>minus 0.25cm</code>,
+each can shrink a little if the three figures are too wide. But each
+space won&rsquo;t shrink more than 0.25cm (see <a href="#Lengths">Lengths</a>).
+</p>
<hr>
<a name="g_t_005chfill"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cspacefactor" accesskey="n" rel="next">\spacefactor</a>, Previous: <a href="#g_t_005chspace" accesskey="p" rel="prev">\hspace</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005chss" accesskey="n" rel="next">\hss</a>, Previous: <a href="#g_t_005chspace" accesskey="p" rel="prev">\hspace</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005chfill-1"></a>
-<h3 class="section">19.2 <code>\hfill</code></h3>
+<h3 class="section">19.3 <code>\hfill</code></h3>
<a name="index-_005chfill"></a>
<a name="index-stretch_002c-infinite-horizontal"></a>
<a name="index-infinite-horizontal-stretch"></a>
-<p>Produce a rubber length which has
-no natural space but can stretch horizontally as far as
-needed (see <a href="#Lengths">Lengths</a>).
+
+<p>Synopsis:
</p>
+<div class="example">
+<pre class="example">\hfill
+</pre></div>
+
+<p>Produce a rubber length which has no natural space but that can stretch
+horizontally as far as needed (see <a href="#Lengths">Lengths</a>).
+</p>
+<p>This creates a one-line paragraph with &lsquo;<samp>Name:</samp>&rsquo; on the left side
+of the page and &lsquo;<samp>Quiz One</samp>&rsquo; on the right.
+</p>
+<div class="example">
+<pre class="example">\noindent Name:\hfill Quiz One
+</pre></div>
+
<a name="index-_005cfill"></a>
-<p>The command <code>\hfill</code> is equivalent to <code>\hspace{\fill}</code>. For
-space that does not disappear at line breaks use
-<code>\hspace*{\fill}</code> instead (see <a href="#g_t_005chspace">\hspace</a>).
+<p>The <code>\hfill</code> command is equivalent to <code>\hspace{\fill}</code> and
+so the space can be discarded at line breaks. To avoid that instead use
+<code>\hspace*{\fill}</code> (see <a href="#g_t_005chspace">\hspace</a>).
+</p>
+<p>Here the graphs are evenly spaced in the middle of the figure.
+</p>
+<div class="example">
+<pre class="example">\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
+ ...
+\begin{figure}
+ \hspace*{\fill}%
+ \vcenteredhbox{\includegraphics{graph0.png}}%
+ \hfill\vcenteredhbox{\includegraphics{graph1.png}}%
+ \hspace*{\fill}%
+ \caption{Comparison of two graphs} \label{fig:twographs}
+\end{figure}
+</pre></div>
+
+<p>Note the <code>\hspace*</code>&rsquo;s where the space could otherwise be dropped.
+</p>
+
+<hr>
+<a name="g_t_005chss"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cspacefactor" accesskey="n" rel="next">\spacefactor</a>, Previous: <a href="#g_t_005chfill" accesskey="p" rel="prev">\hfill</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005chss-1"></a>
+<h3 class="section">19.4 <code>\hss</code></h3>
+
+<a name="index-_005chss"></a>
+<a name="index-horizontal-space"></a>
+<a name="index-horizontal-space_002c-stretchable"></a>
+<a name="index-space_002c-inserting-horizontal"></a>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\hss
+</pre></div>
+
+<p>Produce a horizontal space that is infinitely shrinkable as well as
+infinitely stretchable (this command is a TeX primitive). LaTeX
+authors should reach first for the <code>\makebox</code> command to get the
+effects of <code>\hss</code> (see <a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a>).
+</p>
+<p>Here, the first line&rsquo;s <code>\hss</code> makes the Z stick out to the right,
+overwriting the Y. In the second line the Z sticks out to the left,
+overwriting the X.
+</p>
+<div class="example">
+<pre class="example">X\hbox to 0pt{Z\hss}Y
+X\hbox to 0pt{\hss Z}Y
+</pre></div>
+
+<p>Without the <code>\hss</code> you get something like &lsquo;<samp>Overfull \hbox
+(6.11111pt too wide) detected at line 20</samp>&rsquo;.
</p>
<hr>
<a name="g_t_005cspacefactor"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005c_0028SPACE_0029-after-control-sequence" accesskey="n" rel="next">\(SPACE) after control sequence</a>, Previous: <a href="#g_t_005chfill" accesskey="p" rel="prev">\hfill</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005c_0028SPACE_0029" accesskey="n" rel="next">\(SPACE)</a>, Previous: <a href="#g_t_005chss" accesskey="p" rel="prev">\hss</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cspacefactor-1"></a>
-<h3 class="section">19.3 <code>\spacefactor</code></h3>
+<h3 class="section">19.5 <code>\spacefactor</code></h3>
<p>Synopsis:
</p>
@@ -12264,24 +15653,26 @@ Next: <a href="#g_t_005c_0028SPACE_0029-after-control-sequence" accesskey="n" re
</pre></div>
<a name="index-_005cspacefactor"></a>
-<p>While LaTeX is making the page, to give the lines the best appearance
-it may stretch or shrink the gaps between words. The
-<code>\spacefactor</code> command (from Plain&nbsp;TeX) allows you to
-change the LaTeX&rsquo;s default behavior.
+<p>Influence LaTeX&rsquo;s glue stretch and shrink behavior. Most user-level
+documents do not use this command.
+</p>
+<p>While LaTeX is laying out the material, it may stretch or shrink the
+gaps between words. (This space is not a character; it is called the
+<em>interword glue</em>; see <a href="#g_t_005chspace">\hspace</a>). The <code>\spacefactor</code> command
+(from Plain&nbsp;TeX) allows you to, for instance, have the space
+after a period stretch more than the space after a word-ending letter.
</p>
<p>After LaTeX places each character, or rule or other box, it sets a
parameter called the <em>space factor</em>. If the next thing in the input
-is a space then this parameter affects how much of a horizontal gap
-LaTeX will have it span. (This gap is not a character; it is called
-<em>interword glue</em>.) A larger space factor means that the glue gap
-can stretch more and shrink less.
-</p>
-<p>Normally, the space factor is 1000; this value is in effect following
-most characters, and any non-character box or math formula. But it is
-3000 after a period, exclamation mark, or question mark, it is 2000
-after a colon, 1500 after a semicolon, 1250 after a comma, and 0 after a
-right parenthesis or bracket, or closing double quote or single quote.
-Finally, it is 999 after a capital letter.
+is a space then this parameter affects how much stretching or shrinking
+can happen. A space factor that is larger than the normal value means
+that the glue can stretch more and shrink less. Normally, the space
+factor is 1000. This value is in effect following most characters, and
+any non-character box or math formula. But it is 3000 after a period,
+exclamation mark, or question mark, it is 2000 after a colon, 1500 after
+a semicolon, 1250 after a comma, and 0 after a right parenthesis or
+bracket, or closing double quote or single quote. Finally, it is 999
+after a capital letter.
</p>
<p>If the space factor&nbsp;<var>f</var> is 1000 then the glue gap will be the
font&rsquo;s normal space value (for Computer Modern Roman 10 point this is
@@ -12290,24 +15681,36 @@ than 2000 then TeX adds the font&rsquo;s extra space value (for Computer
Modern Roman 10 point this is 1.11111&nbsp;points), and then the font&rsquo;s
normal stretch value is multiplied by <em>f /1000</em> and the normal
shrink value is multiplied by <em>1000/f</em> (for Computer Modern Roman
-10 point these are 1.66666 and 1.11111&nbsp;points). In short, compared
-to a normal space, such as the space following a word ending in a
-lowercase letter, inter-sentence spacing has a fixed extra space added
-and then the space can stretch 3 times as much and shrink 1/3 as much.
-</p>
-<p>The rules for how TeX uses space factors are even more complex
-because they play two more roles. In practice, there are two
-consequences. First, if a period or other punctuation is followed by a
-close parenthesis or close double quote then its effect is still in
-place, that is, the following glue will have increased stretch and
-shrink. Second, conversely, if punctuation comes after a capital letter
-then its effect is not in place so you get an ordinary space. For how
-to adjust to this second case, for instance if an abbreviation does not
-end in a capital letter, see <a href="#g_t_005c_0028SPACE_0029-and-_005c_0040">\(SPACE) and \@</a>.
+10 point these are 1.66666 and 1.11111&nbsp;points).
+</p>
+<p>For example, consider the period ending <code>A man's best friend is his
+dog.</code> After it, TeX puts in a fixed extra space, and also allows the
+glue to stretch 3 times as much and shrink 1/3 as much, as the glue
+after <code>friend</code>, which does not end in a period.
+</p>
+<p>The rules for space factors are even more complex because they play
+additional roles. In practice, there are two consequences. First, if a
+period or other punctuation is followed by a right parenthesis or
+bracket, or right single or double quote then the spacing effect of that
+period carries through those characters (that is, the following glue
+will have increased stretch and shrink). Second, if
+punctuation comes after a capital letter then its effect is not in place
+so you get an ordinary space. This second case also affects abbreviations
+that do not end in a capital letter (see <a href="#g_t_005c_0040">\@</a>).
+</p>
+<p>You can only use <code>\spacefactor</code> in paragraph mode or LR mode
+(see <a href="#Modes">Modes</a>). You can see the current value with
+<code>\the\spacefactor</code> or <code>\showthe\spacefactor</code>.
+</p>
+<p>(Comment, not really related to <code>\spacefactor</code>: if you get errors
+like &lsquo;<samp>You can't use `\spacefactor' in vertical mode</samp>&rsquo;, or &lsquo;<samp>You
+can't use `\spacefactor' in math mode.</samp>&rsquo;, or &lsquo;<samp>Improper \spacefactor</samp>&rsquo;
+then you have probably tried to redefine an internal command.
+See <a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</a>.)
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005c_0028SPACE_0029-and-_005c_0040" accesskey="1">\(SPACE) and \@</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Space after a period.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005c_0040" accesskey="1">\@</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Distinguish sentence-ending periods from abbreviations.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#g_t_005cfrenchspacing" accesskey="2">\frenchspacing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Equal interword and inter-sentence space.
</td></tr>
@@ -12317,319 +15720,759 @@ end in a capital letter, see <a href="#g_t_005c_0028SPACE_0029-and-_005c_0040">\
<hr>
-<a name="g_t_005c_0028SPACE_0029-and-_005c_0040"></a>
+<a name="g_t_005c_0040"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cfrenchspacing" accesskey="n" rel="next">\frenchspacing</a>, Up: <a href="#g_t_005cspacefactor" accesskey="u" rel="up">\spacefactor</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cfrenchspacing" accesskey="n" rel="next">\frenchspacing</a>, Up: <a href="#g_t_005cspacefactor" accesskey="u" rel="up">\spacefactor</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005c_0028SPACE_0029-and-_005c_0040-1"></a>
-<h4 class="subsection">19.3.1 <code>\(SPACE)</code> and <code>\@</code></h4>
+<a name="g_t_005c_0040-1"></a>
+<h4 class="subsection">19.5.1 <code>\@</code></h4>
-<a name="index-_005c_0028SPACE_0029"></a>
-<a name="index-_005cTAB"></a>
-<a name="index-_005cNEWLINE"></a>
<a name="index-_005c_0040"></a>
+<a name="index-at_002dsign"></a>
+<a name="index-period_002c-sentence_002dending"></a>
+<a name="index-period_002c-abbreviation_002dending"></a>
+<a name="index-period_002c-spacing-after"></a>
<a name="g_t_005cAT"></a>
-<p>Here, <code>\(SPACE)</code> means a backslash followed by a space. These
-commands mark a punctuation character, typically a period, as either
-ending a sentence or as ending an abbreviation.
+<p>Synopsis:
</p>
-<p>By default, in justifying a line LaTeX adjusts the space after a
-sentence-ending period (or a question mark, exclamation point, comma, or
-colon) more than the space between words. See <a href="#g_t_005cspacefactor">\spacefactor</a>. As
-described there, LaTeX assumes that the period ends a sentence unless
-it is preceded by a capital letter, in which case it takes that period
-for part of an abbreviation. Note that if a sentence-ending period is
-immediately followed by a right parenthesis or bracket, or right single
-or double quote, then the space effect of that period follows through
-that parenthesis or quote.
+<div class="example">
+<pre class="example"><var>capital-letter</var>\@.
+</pre></div>
+
+<p>Treat a period as sentence-ending, where LaTeX would otherwise think
+it is part of an abbreviation. LaTeX thinks that a period ends an
+abbreviation if the period comes after a capital letter, and otherwise
+thinks the period ends the sentence. By default, in justifying a line
+LaTeX adjusts the space after a sentence-ending period (or a question
+mark, exclamation point, comma, or colon) more than it adjusts the space
+between words (see <a href="#g_t_005cspacefactor">\spacefactor</a>).
+</p>
+<p>This example shows the two cases to remember.
+</p>
+<div class="example">
+<pre class="example">The songs \textit{Red Guitar}, etc.\ are by Loudon Wainwright~III\@.
+</pre></div>
+
+<p>The second period ends the sentence, despite that it is preceded by a
+capital. We tell LaTeX that it ends the sentence by putting
+<code>\@</code> before it. The first period ends the abbreviation
+&lsquo;<samp>etc.</samp>&rsquo; but not the sentence. The backslash-space, <code>\ </code>,
+produces a mid-sentence space.
+</p>
+<p>So: if you have a capital letter followed by a period that ends the
+sentence, then put <code>\@</code> before the period. This holds even if
+there is an intervening right parenthesis or bracket, or right single or
+double quote, because the spacing effect of that period carries through
+those characters. For example, this
</p>
-<p>So: if you have a period ending an abbreviation whose last letter is not
-a capital letter, and that abbreviation is not the last word in the
-sentence, then follow that period with a backslash-space (<code>\ </code>) or
-a tie (<code>~</code>) or a <code>\@</code>. Examples are <code>Nat.\ Acad.\
-Science</code>, and <code>Mr.~Bean</code>, and <code>(manure, etc.\@) for sale</code>
-(note that in the last the <code>\@</code> comes before the closing parenthesis).
+<div class="example">
+<pre class="example">Use the \textit{Instructional Practices Guide},
+(a book by the MAA)\@.
+</pre></div>
+
+<p>will have correct inter-sentence spacing after the period.
</p>
-<p>In the opposite situation, if you have a capital letter followed by a
-period that does end the sentence, then put <code>\@</code> before the
-period. For example, <code>book by the MAA\@.</code> will have correct
-inter-sentence spacing after the period.
+<p>The <code>\@</code> command is only for a text mode. If you use it outside of
+a text mode then you get &lsquo;<samp>You can't use `\spacefactor' in vertical
+mode</samp>&rsquo; (see <a href="#Modes">Modes</a>).
</p>
-<p>For another use of <code>\(SPACE)</code>, see <a href="#g_t_005c_0028SPACE_0029-after-control-sequence">\(SPACE) after control sequence</a>.
+<p>Comment: the converse case is a period ending an abbreviation whose last
+letter is not a capital letter, and that abbreviation is not the last
+word in the sentence. For that case follow the period with a
+backslash-space, (<code>\ </code>), or a tie, (<code>~</code>), or <code>\@</code>.
+Examples are <code>Nat.\ Acad.\ Science</code>, and <code>Mr.~Bean</code>, and
+<code>(manure, etc.\@) for sale</code> (note in the last one that the
+<code>\@</code> comes before the closing parenthesis).
</p>
<hr>
<a name="g_t_005cfrenchspacing"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cnormalsfcodes" accesskey="n" rel="next">\normalsfcodes</a>, Previous: <a href="#g_t_005c_0028SPACE_0029-and-_005c_0040" accesskey="p" rel="prev">\(SPACE) and \@</a>, Up: <a href="#g_t_005cspacefactor" accesskey="u" rel="up">\spacefactor</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cnormalsfcodes" accesskey="n" rel="next">\normalsfcodes</a>, Previous: <a href="#g_t_005c_0040" accesskey="p" rel="prev">\@</a>, Up: <a href="#g_t_005cspacefactor" accesskey="u" rel="up">\spacefactor</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cfrenchspacing-1"></a>
-<h4 class="subsection">19.3.2 <code>\frenchspacing</code></h4>
+<h4 class="subsection">19.5.2 <code>\frenchspacing</code></h4>
<a name="index-_005cfrenchspacing"></a>
<a name="index-_005cnonfrenchspacing"></a>
<a name="index-spacing_002c-inter_002dsentence"></a>
-<p>This declaration (from Plain TeX) causes LaTeX to treat
-inter-sentence spacing in the same way as interword spacing.
+<p>Synopsis, one of:
</p>
-<p>In justifying the text in a line, some typographic traditions, including
-English, prefer to adjust the space between sentences (or after other
-punctuation marks) more than the space between words. Following this
-declaration, all spaces are instead treated equally.
+<div class="example">
+<pre class="example">\frenchspacing
+\nonfrenchspacing
+</pre></div>
+
+<p>The first declaration causes LaTeX to treat spacing between sentences
+in the same way as spacing between words in the middle of a sentence.
+The second causes spacing between sentences to stretch or shrink more
+(see <a href="#g_t_005cspacefactor">\spacefactor</a>); this is the default.
</p>
-<p>Revert to the default behavior by declaring <code>\nonfrenchspacing</code>.
+<p>Some typographic traditions, including English, prefer to adjust the
+space between sentences (or spaces following a question mark,
+exclamation point, comma, or colon) more than the space between words
+that are in the middle of a sentence. Declaring <code>\frenchspacing</code>
+(the command is from Plain TeX) switches to the tradition that all
+spaces are treated equally.
</p>
<hr>
<a name="g_t_005cnormalsfcodes"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cfrenchspacing" accesskey="p" rel="prev">\frenchspacing</a>, Up: <a href="#g_t_005cspacefactor" accesskey="u" rel="up">\spacefactor</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cfrenchspacing" accesskey="p" rel="prev">\frenchspacing</a>, Up: <a href="#g_t_005cspacefactor" accesskey="u" rel="up">\spacefactor</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cnormalsfcodes-1"></a>
-<h4 class="subsection">19.3.3 <code>\normalsfcodes</code></h4>
+<h4 class="subsection">19.5.3 <code>\normalsfcodes</code></h4>
<a name="index-_005cnormalsfcodes"></a>
<a name="index-spacing_002c-inter_002dsentence-1"></a>
-<p>Reset the LaTeX space factor values to the default.
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\normalsfcodes
+</pre></div>
+
+<p>Reset the LaTeX space factor values to the default
+(see <a href="#g_t_005cspacefactor">\spacefactor</a>).
</p>
<hr>
-<a name="g_t_005c_0028SPACE_0029-after-control-sequence"></a>
+<a name="g_t_005c_0028SPACE_0029"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cthinspace" accesskey="n" rel="next">\thinspace</a>, Previous: <a href="#g_t_005cspacefactor" accesskey="p" rel="prev">\spacefactor</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_007e" accesskey="n" rel="next">~</a>, Previous: <a href="#g_t_005cspacefactor" accesskey="p" rel="prev">\spacefactor</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005c--after-control-sequence"></a>
-<h3 class="section">19.4 <code>\ </code> after control sequence</h3>
+<a name="Backslash_002dspace_002c-_005c-"></a>
+<h3 class="section">19.6 Backslash-space, <code>\ </code></h3>
+
+<a name="index-_005cNEWLINE"></a>
+<a name="index-_005cSPACE"></a>
+<a name="index-_005cTAB"></a>
+
+<p>This section refers to the command consisting of two characters, a
+backslash followed by a space. Synopsis:
+</p>
+<div class="example">
+<pre class="example">\
+</pre></div>
-<p>The <code>\ </code> command is often used after control sequences to keep
-them from gobbling the space that follows, as in &lsquo;<samp>\TeX\ is nice</samp>&rsquo;.
-And, under normal circumstances, <code>\</code><tt class="key">tab</tt> and
-<code>\</code><tt class="key">newline</tt> are equivalent to <code>\ </code>. For another use of
-<code>\ </code>, see also <a href="#g_t_005c_0028SPACE_0029-and-_005c_0040">\(SPACE) and \@</a>.
+<p>Produce a space. By default it produces white space of length
+3.33333pt plus 1.66666pt minus 1.11111pt.
</p>
-<p>Some people prefer to use <code>{}</code> for the same purpose, as in
-<code>\TeX{} is nice</code>. This has the advantage that you can always
-write it the same way, namely <code>\TeX{}</code>, whether it is followed
-by a space or by a punctuation mark. Compare:
+<p>A blank is not a space. When you type a blank between words, LaTeX
+produces white space. That&rsquo;s different from an explicit space. This
+illustrates.
</p>
<div class="example">
-<pre class="example">\TeX\ is a nice system. \TeX, a nice system.
+<pre class="example">\begin{tabular}{l}
+Three blanks: in a row \\
+Three spaces:\ \ \ in a row \\
+\end{tabular}
+</pre></div>
-\TeX{} is a nice system. \TeX{}, a nice system.
+<p>On the first line LaTeX collapses the three blanks to output one
+whitespace (it would be the same with a single blank or, for instance,
+with a blank and an tab and a blank, or a blank and a newline and a
+blank). But the second line asks for three spaces so the white area is
+wider. Thus, the backslash-space command will create some horizontal
+space. (But the best way to create horizontal space is with
+<code>\hspace</code>; See <a href="#g_t_005chspace">\hspace</a>.)
+</p>
+<p>The backslash-space command has two main uses. First, it is often used
+after control sequences to keep them from gobbling the space that
+follows, as in <code>\TeX\ is nice</code>. (But the approach of using curly
+parentheses, as in <code>\TeX{} is nice</code>, has the advantage of still
+working if the next character is a period.)
+</p>
+<p>The second common use is that
+it mark a period as ending an abbreviation instead of ending
+a sentence, as in <code>So says Prof.\ Smith</code> (see <a href="#g_t_005c_0040">\@</a>).
+</p>
+<p>Under normal circumstances, <code>\</code><tt class="key">tab</tt> and <code>\</code><tt class="key">newline</tt>
+are equivalent to backslash-space, <code>\ </code>.
+</p>
+
+
+<hr>
+<a name="g_t_007e"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cthinspace-_0026-_005cnegthinspace" accesskey="n" rel="next">\thinspace &amp; \negthinspace</a>, Previous: <a href="#g_t_005c_0028SPACE_0029" accesskey="p" rel="prev">\(SPACE)</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_007e-1"></a>
+<h3 class="section">19.7 <code>~</code></h3>
+
+<a name="index-_007e"></a>
+<a name="index-tie"></a>
+<a name="index-space_002c-hard"></a>
+<a name="index-space_002c-unbreakable"></a>
+<a name="index-NBSP"></a>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example"><var>before</var>~<var>after</var>
</pre></div>
-<a name="index-package_002c-xspace"></a>
-<a name="index-xspace-package"></a>
+<p>The tie character, <code>~</code>, produces a space between <var>before</var> and
+<var>after</var> at which the line will not be broken. By default the white
+space has length 3.33333pt plus 1.66666pt minus
+1.11111pt (see <a href="#Lengths">Lengths</a>).
+</p>
+<p>Here LaTeX will not break the line between the final two words.
+</p>
+<div class="example">
+<pre class="example">Thanks to Prof.~Lerman.
+</pre></div>
-<p>Some individual commands, notably those defined with the <code>xspace</code>,
-package do not follow the standard behavior.
+<p>In addition, despite the period, LaTeX does not use the
+end-of-sentence spacing (see <a href="#g_t_005c_0040">\@</a>).
</p>
+<p>Ties prevent the end of line separation of things where that could cause
+confusion. But they also reduce LaTeX&rsquo;s options when it breaks lines
+into paragraphs, so you can use too many. They are also matters of
+taste, sometimes alarmingly dogmatic taste, among readers. Nevertheless,
+here are some usage models, many of them from the TeXbook.
+</p>
+<ul>
+<li> Between an enumerator and its item, such as in references:
+<code>Chapter~12</code>, or <code>Theorem~\ref{th:Wilsons}</code>, or
+<code>Figure~\ref{fig:KGraph}</code>. When cases are enumerated inline:
+<code>(b)~Show that $f(x)$ is (1)~continuous, and (2)~bounded</code>.
+
+<a name="index-package_002c-siunitx"></a>
+<a name="index-siunitx-package"></a>
+
+</li><li> Between a number and its unit: <code>$745.7.8$~watts</code> (the
+<samp>siunitx</samp> package has a special facility for this) or
+<code>144~eggs</code>. This includes between a month and a date:
+<code>October~12</code> or <code>12~Oct</code>. In general, in any expressions where
+numbers and abbreviations or symbols are separated by a space:
+<code>AD~565</code>, or <code>2:50~pm</code>, or <code>Boeing~747</code>, or
+<code>268~Plains Road</code>, or <code>\$$1.4$~billion</code>.
+
+</li><li> When mathematical phrases are rendered in words: <code>equals~$n$</code>, or
+<code>less than~$\epsilon$</code>, or <code>given~$X$</code>, or <code>modulo~$p^e$
+for all large~$n$</code> (but compare <code>is~$15$</code> with <code>is $15$~times
+the height</code>). Between mathematical symbols in apposition with nouns:
+<code>dimension~$d$</code> or <code>function~$f(x)$</code> (but compare <code>with
+length $l$~or more</code>). When a symbol is a tightly bound object of a
+preposition: <code>of~$x$</code>, or <code>from $0$ to~$1$</code>, or <code>in
+common with~$m$</code>.
+
+</li><li> Between symbols in series: <code>$1$,~$2$, or~$3$</code> or <code>$1$,~$2$,
+\ldots,~$n$</code>.
+
+</li><li> Between a person&rsquo;s forenames and between multiple surnames:
+<code>Donald~E. Knuth</code>, or <code>Luis~I. Trabb~Pardo</code>, or
+<code>Charles~XII</code> (but you must give TeX places to break the line so
+you may do <code>Charles Louis Xavier~Joseph de~la Vall\'ee~Poussin</code>).
+
+</li><li> Before a dash: <code>pages 12~--14</code> or <code>it is~--- it must be
+said~--- plausible</code>.
+
+</li></ul>
+
<hr>
-<a name="g_t_005cthinspace"></a>
+<a name="g_t_005cthinspace-_0026-_005cnegthinspace"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005c_002f" accesskey="n" rel="next">\/</a>, Previous: <a href="#g_t_005c_0028SPACE_0029-after-control-sequence" accesskey="p" rel="prev">\(SPACE) after control sequence</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005c_002f" accesskey="n" rel="next">\/</a>, Previous: <a href="#g_t_007e" accesskey="p" rel="prev">~</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cthinspace_003a-Insert-1_002f6em"></a>
-<h3 class="section">19.5 <code>\thinspace</code>: Insert 1/6em</h3>
+<a name="g_t_005cthinspace-_0026-_005cnegthinspace-1"></a>
+<h3 class="section">19.8 <code>\thinspace</code> &amp; <code>\negthinspace</code></h3>
<a name="index-_005cthinspace-1"></a>
+<a name="index-_005cnegthinspace-1"></a>
+<a name="index-thin-space-1"></a>
+<a name="index-space_002c-thin"></a>
+<a name="index-thin-space_002c-negative-1"></a>
+<a name="index-space_002c-negative-thin"></a>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\thinspace
+\negthinspace
+</pre></div>
+
+<p>Produce an unbreakable and unstretchable space of 1/6em and
+-1/6em. These are the text mode equivalents of <code>\,</code> and
+<code>\!</code> (see <a href="#Spacing-in-math-mode_002f_005cthinspace">Spacing in math mode/\thinspace</a>). You can use
+<code>\,</code> as a synonym for <code>\thinspace</code> in text mode.
+</p>
+<p>The <code>\negthinspace</code> command is used in text mode mostly for
+fiddling with spaces. One common use of <code>\thinspace</code> is as the
+space between nested quotes.
+</p>
+<div class="example">
+<pre class="example">Killick replied, ``I heard the Captain say, `Ahoy there.'\thinspace''
+</pre></div>
-<p><code>\thinspace</code> produces an unbreakable and unstretchable space that
-is 1/6 of an em. This is the proper space to use between nested
-quotes, as in &rsquo;&rdquo;.</p>
+<p>Another use is that some style guides call for a <code>\thinspace</code>
+between an ellipsis and a sentence ending period (other style guides,
+though, think the three dots are quite enough already). Still another
+use is between initials, as in <code>D.\thinspace E.\ Knuth</code>.
+</p>
<hr>
<a name="g_t_005c_002f"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005chrulefill-_005cdotfill" accesskey="n" rel="next">\hrulefill \dotfill</a>, Previous: <a href="#g_t_005cthinspace" accesskey="p" rel="prev">\thinspace</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005chrulefill-_0026-_005cdotfill" accesskey="n" rel="next">\hrulefill &amp; \dotfill</a>, Previous: <a href="#g_t_005cthinspace-_0026-_005cnegthinspace" accesskey="p" rel="prev">\thinspace &amp; \negthinspace</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005c_002f_003a-Insert-italic-correction"></a>
-<h3 class="section">19.6 <code>\/</code>: Insert italic correction</h3>
+<a name="g_t_005c_002f-1"></a>
+<h3 class="section">19.9 <code>\/</code></h3>
<a name="index-_005c_002f"></a>
<a name="index-italic-correction"></a>
-<p>The <code>\/</code> command produces an <em>italic correction</em>. This is a
-small space defined by the font designer for a given character,
-to avoid the character colliding with whatever follows. The italic
-<i>f</i> character typically has a large italic correction value.
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example"><var>before-character</var>\/<var>after-character</var>
+</pre></div>
+
+<p>Insert an <em>italic correction</em>, a small space defined by the font
+designer for each character, to avoid the character colliding with
+whatever follows. When you use <code>\/</code>, LaTeX takes the correction
+from the font metric file, scales it by any scaling that has been
+applied to the font, and then inserts that much horizontal space.
</p>
-<p>If the following character is a period or comma, it&rsquo;s not necessary to
-insert an italic correction, since those punctuation symbols have a
-very small height. However, with semicolons or colons, as well as
-normal letters, it can help. Compare
-<i>f: f;</i> (in the TeX output, the &lsquo;f&rsquo;s are nicely separated)
-with <i>f: f;</i>.
+<p>Here, were it not for the <code>\/</code>, the <var>before-character</var>
+italic&nbsp;f would hit the <var>after-character</var> roman&nbsp;H
+</p>
+<div class="example">
+<pre class="example">\newcommand{\companylogo}{{\it f}\/H}
+</pre></div>
+
+<p>because the italic letter leans far to the right.
</p>
-<p>When changing fonts with commands such as <code>\textit{italic
-text}</code> or <code>{\itshape italic text}</code>, LaTeX will
-automatically insert an italic correction if appropriate (see <a href="#Font-styles">Font styles</a>).
+<p>If <var>after-character</var> is a period or comma then don&rsquo;t insert an
+italic correction since those punctuation symbols have a very small
+height. However, with semicolons or colons as well as with normal
+letters, the italic correction can help.
</p>
-<p>Despite the name, roman characters can also have an italic
-correction. Compare
-pdfTeX (in the TeX output, there is a small space after the &lsquo;f&rsquo;)
-with pdfTeX.
+<p>When you use commands such as <code>\textit</code> or <code>\itshape</code> to
+change fonts, LaTeX will automatically insert any needed italic
+correction (see <a href="#Font-styles">Font styles</a>).
+</p>
+<p>Roman characters can also have an italic correction. An example is in
+the name <code>pdf\/\TeX</code>.
</p>
<p>There is no concept of italic correction in math mode; spacing is done
in a different way.
</p>
<hr>
-<a name="g_t_005chrulefill-_005cdotfill"></a>
+<a name="g_t_005chrulefill-_0026-_005cdotfill"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005caddvspace" accesskey="n" rel="next">\addvspace</a>, Previous: <a href="#g_t_005c_002f" accesskey="p" rel="prev">\/</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip" accesskey="n" rel="next">\bigskip &amp; \medskip &amp; \smallskip</a>, Previous: <a href="#g_t_005c_002f" accesskey="p" rel="prev">\/</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005chrulefill-_005cdotfill-1"></a>
-<h3 class="section">19.7 <code>\hrulefill \dotfill</code></h3>
+<a name="g_t_005chrulefill-_0026-_005cdotfill-1"></a>
+<h3 class="section">19.10 <code>\hrulefill</code> &amp; <code>\dotfill</code></h3>
<a name="index-_005chrulefill"></a>
<a name="index-_005cdotfill"></a>
-<p>Produce an infinite rubber length (see <a href="#Lengths">Lengths</a>) filled with a
-horizontal rule (that is, a line) or with dots, instead of just white
-space.
+<p>Synopsis, one of:
</p>
-<p>When placed between blank lines this example creates a paragraph that is
-left and right justified, where the space in the middle is filled with
-evenly spaced dots.
+<div class="example">
+<pre class="example">\hrulefill
+\dotfill
+</pre></div>
+
+<p>Produce an infinite horizontal rubber length (see <a href="#Lengths">Lengths</a>) that
+LaTeX fills with a rule (that is, a line) or with dots, instead of
+white space.
+</p>
+<p>This outputs a line 2 inches long.
+</p>
+<div class="example">
+<pre class="example">Name:~\makebox[2in]{\hrulefill}
+</pre></div>
+
+<p>This example, when placed between blank lines, creates a paragraph that
+is left and right justified and where the middle is filled with evenly
+spaced dots.
</p>
<div class="example">
-<pre class="example">\noindent Jack Aubrey\dotfill Melbury Lodge
+<pre class="example">\noindent John Aubrey, RN \dotfill{} Melbury Lodge
</pre></div>
<p>To make the rule or dots go to the line&rsquo;s end use <code>\null</code> at the
start or end.
</p>
<p>To change the rule&rsquo;s thickness, copy the definition and adjust it, as
-with <code>\renewcommand{\hrulefill}{\leavevmode\leaders\hrule height
-1pt\hfill\kern\z@}</code>, which changes the default thickness of
-0.4pt to 1pt. Similarly, adjust the dot spacing as with
-<code>\renewcommand{\dotfill}{\leavevmode\cleaders\hb@xt@
-1.00em{\hss .\hss }\hfill\kern\z@}</code>, which changes the default
-length of 0.33em to 1.00em.
+here
</p>
+<div class="example">
+<pre class="example">\renewcommand{\hrulefill}{%
+ \leavevmode\leaders\hrule height 1pt\hfill\kern\z@}
+</pre></div>
-<hr>
-<a name="g_t_005caddvspace"></a>
-<div class="header">
-<p>
-Next: <a href="#g_t_005cbigskip-_005cmedskip-_005csmallskip" accesskey="n" rel="next">\bigskip \medskip \smallskip</a>, Previous: <a href="#g_t_005chrulefill-_005cdotfill" accesskey="p" rel="prev">\hrulefill \dotfill</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="g_t_005caddvspace-1"></a>
-<h3 class="section">19.8 <code>\addvspace</code></h3>
-
-<a name="index-_005caddvspace"></a>
-<a name="index-vertical-space"></a>
-<a name="index-space_002c-inserting-vertical"></a>
-
-<p><code>\addvspace{<var>length</var>}</code>
+<p>which changes the default thickness of 0.4pt to 1pt.
+Similarly, adjust the dot spacing as with
</p>
-<p>Add a vertical space of height <var>length</var>, which is a rubber length
-(see <a href="#Lengths">Lengths</a>). However, if vertical space has already been added to
-the same point in the output by a previous <code>\addvspace</code> command
-then this command will not add more space than what is needed to make
-the natural length of the total vertical space equal to <var>length</var>.
-</p>
-<p>Use this command to adjust the vertical space above or below an
-environment that starts a new paragraph. For instance, a Theorem
-environment is defined to begin and end with <code>\addvspace{...}</code>
-so that two consecutive Theorem&rsquo;s are separated by one vertical space,
-not two.
+<div class="example">
+<pre class="example">\renewcommand{\dotfill}{%
+ \leavevmode\cleaders\hb@xt@1.00em{\hss .\hss }\hfill\kern\z@}
+</pre></div>
+
+<p>which changes the default length of 0.33em to 1.00em.
</p>
-<p>This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
+<p>This example produces a line for a signature.
</p>
-<p>The error &lsquo;<samp>Something's wrong--perhaps a missing \item</samp>&rsquo; means that
-you were not in vertical mode when you invoked this command; one way to
-change that is to precede this command with a <code>\par</code> command.
+<div class="example">
+<pre class="example">\begin{minipage}{4cm}
+ \centering
+ \hrulefill\\
+ Signed
+\end{minipage}
+</pre></div>
+
+<p>The line is 4cm long.
</p>
<hr>
-<a name="g_t_005cbigskip-_005cmedskip-_005csmallskip"></a>
+<a name="g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cvfill" accesskey="n" rel="next">\vfill</a>, Previous: <a href="#g_t_005caddvspace" accesskey="p" rel="prev">\addvspace</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cbigbreak-_0026-_005cmedbreak-_0026-_005csmallbreak" accesskey="n" rel="next">\bigbreak &amp; \medbreak &amp; \smallbreak</a>, Previous: <a href="#g_t_005chrulefill-_0026-_005cdotfill" accesskey="p" rel="prev">\hrulefill &amp; \dotfill</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cbigskip-_005cmedskip-_005csmallskip-1"></a>
-<h3 class="section">19.9 <code>\bigskip \medskip \smallskip</code></h3>
+<a name="g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip-1"></a>
+<h3 class="section">19.11 <code>\bigskip</code> &amp; <code>\medskip</code> &amp; <code>\smallskip</code></h3>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\bigskip
+\medskip
+\smallskip
+</pre></div>
-<p>These commands produce a given amount of space, specified by the
-document class.
+<p>Produce an amount of vertical space, large or medium-sized or
+small. These commands are fragile (see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>Here the skip suggests the passage of time (from <i>The Golden Ocean</i> by
+O&rsquo;Brian).
+</p>
+<div class="example">
+<pre class="example">Mr Saumarez would have something rude to say to him, no doubt: he
+was at home again, and it was delightful.
+
+\bigskip
+``A hundred and fifty-seven miles and one third, in twenty-four hours,''
+said Peter.
+</pre></div>
+
+<p>Each command is associated with a length defined in the document class
+file.
</p>
<dl compact="compact">
+<dd><a name="bigskip"></a></dd>
<dt><code>\bigskip</code>
<a name="index-_005cbigskip"></a>
</dt>
<dd><a name="index-_005cbigskipamount"></a>
<p>The same as <code>\vspace{\bigskipamount}</code>, ordinarily about one line
-space, with stretch and shrink (the default for the <code>book</code> and
-<code>article</code> classes is <code>12pt plus 4pt minus 4pt</code>).
+space, with stretch and shrink. The default for the <code>book</code> and
+<code>article</code> classes is <code>12pt plus 4pt minus 4pt</code>.
</p>
-</dd>
+<a name="medskip"></a></dd>
<dt><code>\medskip</code>
<a name="index-_005cmedskip"></a>
</dt>
<dd><a name="index-_005cmedskipamount"></a>
-<p>The same as <code>\vspace{\medskipamount}</code>, ordinarily about half of
-a line space, with stretch and shrink (the default for the <code>book</code>
-and <code>article</code> classes is <code>6pt plus 2pt minus 2pt</code>).
+<p>The same as <code>\vspace{\medskipamount}</code>, ordinarily about half of a
+line space, with stretch and shrink. The default for the <code>book</code>
+and <code>article</code> classes is <code>6pt plus 2pt minus 2pt</code>.
</p>
-</dd>
+<a name="smallskip"></a></dd>
<dt><code>\smallskip</code>
<a name="index-_005csmallskip"></a>
</dt>
<dd><a name="index-_005csmallskipamount"></a>
<p>The same as <code>\vspace{\smallskipamount}</code>, ordinarily about a
-quarter of a line space, with stretch and shrink (the default for the
-<code>book</code> and <code>article</code> classes is <code>3pt plus 1pt minus
-1pt</code>).
+quarter of a line space, with stretch and shrink. The default for the
+<code>book</code> and <code>article</code> classes is <code>3pt plus 1pt minus 1pt</code>.
</p>
</dd>
</dl>
+<p>Because each command is a <code>\vspace</code>, if you use on in mid-paragraph
+then it will insert its vertical space between the line in which you use
+it and the next line, not necessarily at the place that you use it. So
+these are best between paragraphs.
+</p>
+<p>The commands <code>\bigbreak</code>, <code>\medbreak</code>, and <code>\smallbreak</code>
+are similar but also suggest to LaTeX that this is a good place to
+put a page break (see <a href="#g_t_005cbigbreak-_0026-_005cmedbreak-_0026-_005csmallbreak">\bigbreak &amp; \medbreak &amp; \smallbreak</a>.
+</p>
+
+<hr>
+<a name="g_t_005cbigbreak-_0026-_005cmedbreak-_0026-_005csmallbreak"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cstrut" accesskey="n" rel="next">\strut</a>, Previous: <a href="#g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip" accesskey="p" rel="prev">\bigskip &amp; \medskip &amp; \smallskip</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cbigbreak-_0026-_005cmedbreak-_0026-_005csmallbreak-1"></a>
+<h3 class="section">19.12 <code>\bigbreak</code> &amp; <code>\medbreak</code> &amp; <code>\smallbreak</code></h3>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\bigbreak
+\medbreak
+\smallbreak
+</pre></div>
+
+<p>Produce a vertical space that is big or medium-sized or small, and
+suggest to LaTeX that this is a good place to break the page. (The
+associated penalties are -200, -100, and -50.)
+</p>
+<p>See <a href="#g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">\bigskip &amp; \medskip &amp; \smallskip</a>, for more. These commands
+produce the same vertical space but differ in that they also remove a
+preceding vertical space if it is less than what they would insert (as
+with <code>\addvspace</code>). In addition, they terminate a paragraph where
+they are used: this example
+</p>
+<div class="example">
+<pre class="example">abc\bigbreak def ghi
+
+jkl mno pqr
+</pre></div>
+
+<p>will output three paragraphs, the first ending in &lsquo;<samp>abc</samp>&rsquo; and the
+second starting, after an extra vertical space and a paragraph indent,
+with &lsquo;<samp>def</samp>&rsquo;.
+</p>
+
+<hr>
+<a name="g_t_005cstrut"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cvspace" accesskey="n" rel="next">\vspace</a>, Previous: <a href="#g_t_005cbigbreak-_0026-_005cmedbreak-_0026-_005csmallbreak" accesskey="p" rel="prev">\bigbreak &amp; \medbreak &amp; \smallbreak</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cstrut-1"></a>
+<h3 class="section">19.13 <code>\strut</code></h3>
+
+<a name="index-_005cstrut"></a>
+<a name="index-strut"></a>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\strut
+</pre></div>
+
+<p>Ensure that the current line has height at least <code>0.7\baselineskip</code>
+and depth at least <code>0.3\baselineskip</code>. Essentially, LaTeX
+inserts into the line a rectangle having zero width,
+<code>\rule[-0.3\baselineskip]{0pt}{\baselineskip}</code> (see <a href="#g_t_005crule">\rule</a>).
+The <code>\baselineskip</code> changes with the current font and fontsize.
+</p>
+<p>In this example the <code>\strut</code> keeps the box inside the frame from
+having zero height.
+</p>
+<div class="example">
+<pre class="example">\setlength{\fboxsep}{0pt}\framebox[2in]{\strut}
+</pre></div>
+
+<p>This example has four lists. In the first there is a much bigger gap
+between items 2 and&nbsp;3 than there is between items 1 and&nbsp;2.
+The second list fixes that with a <code>\strut</code> at the end of its first
+item&rsquo;s second line.
+</p>
+<div class="example">
+<pre class="example">\setlength{\fboxsep}{0pt}
+\noindent\begin{minipage}[t]{0.2\linewidth}
+\begin{enumerate}
+ \item \parbox[t]{15pt}{test \\ test}
+ \item test
+ \item test
+\end{enumerate}
+\end{minipage}%
+\begin{minipage}[t]{0.2\linewidth}
+\begin{enumerate}
+ \item \parbox[t]{15pt}{test \\ test\strut}
+ \item test
+ \item test
+\end{enumerate}
+\end{minipage}%
+\begin{minipage}[t]{0.2\linewidth}
+\begin{enumerate}
+ \item \fbox{\parbox[t]{15pt}{test \\ test}}
+ \item \fbox{test}
+ \item \fbox{test}
+\end{enumerate}
+\end{minipage}%
+\begin{minipage}[t]{0.2\linewidth}
+\begin{enumerate}
+ \item \fbox{\parbox[t]{15pt}{test \\ test\strut}}
+ \item \fbox{test}
+ \item \fbox{test}
+\end{enumerate}
+\end{minipage}%
+</pre></div>
+
+<p>The final two lists use <code>fbox</code> to show what&rsquo;s happening. The third
+list&rsquo;s <code>\parbox</code> goes only to the bottom of its second &lsquo;<samp>test</samp>&rsquo;,
+which happens not have any characters that descend below the baseline.
+The fourth list adds the strut that gives the needed extra
+below-baseline space.
+</p>
+<a name="index-package_002c-TikZ-1"></a>
+<a name="index-TikZ-package-1"></a>
+<a name="index-package_002c-Asymptote-1"></a>
+<a name="index-Asymptote-package-1"></a>
+
+<p>The <code>\strut</code> command is often useful in graphics, such as in
+<samp>TikZ</samp> or <samp>Asymptote</samp>. For instance, you may have a command
+such as <code>\graphnode{<var>node-name</var>}</code> that fits a circle around
+<var>node-name</var>. However, unless you are careful the <var>node-name</var>&rsquo;s
+&lsquo;<samp>x</samp>&rsquo; and &lsquo;<samp>y</samp>&rsquo; will produce different-diameter circles because
+the characters are different sizes. A careful <code>\graphnode</code> might
+insert a <code>\strut</code>, then <var>node-name</var>, and then draw the circle.
+</p>
+<p>The general approach of using a zero width <code>\rule</code> is useful in
+many circumstances. In this table, the zero-width rule keeps the top of
+the first integral from hitting the <code>\hline</code>. Similarly, the
+second rule keeps the second integral from hitting the first.
+</p>
+<div class="example">
+<pre class="example">\begin{tabular}{rl}
+ \textsc{Integral} &amp;\textsc{Value} \\
+ \hline
+ $\int_0^x t\, dt$ &amp;$x^2/2$ \rule{0em}{2.5ex} \\
+ $\int_0^x t^2\, dt$ &amp;$x^3/3$ \rule{0em}{2.5ex}
+\end{tabular}
+</pre></div>
+
+<p>(Although the line-ending double backslash command has an available
+optional argument to put in more vertical room, that won&rsquo;t work here.
+Changing the first double backslash to something like <code>\\[2.5ex]</code>
+will put the room between the header line and the <code>\hline</code>, and the
+integral would still hit the line.)
+</p>
+
+<hr>
+<a name="g_t_005cvspace"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cvfill" accesskey="n" rel="next">\vfill</a>, Previous: <a href="#g_t_005cstrut" accesskey="p" rel="prev">\strut</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cvspace-1"></a>
+<h3 class="section">19.14 <code>\vspace</code></h3>
+
+<a name="index-_005cvspace"></a>
+<a name="index-vertical-space"></a>
+<a name="index-space_002c-vertical"></a>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\vspace{<var>length</var>}
+\vspace*{<var>length</var>}
+</pre></div>
+
+<p>Add the vertical space <var>length</var>. The <var>length</var> can be positive,
+negative, or zero. It is a rubber length&mdash;it may contain a <code>plus</code>
+or <code>minus</code> component (see <a href="#Lengths">Lengths</a>).
+</p>
+<p>This puts space between the two paragraphs.
+</p>
+<div class="example">
+<pre class="example">And I slept.
+
+\vspace{1ex plus 0.5ex}
+The new day dawned cold.
+</pre></div>
+
+<p>(See <a href="#g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">\bigskip &amp; \medskip &amp; \smallskip</a> for common inter-paragraph
+spaces.)
+</p>
+<p>The <code>*</code>-version inserts vertical space that non-discardable. More
+precisely, LaTeX discards vertical space at a page break and the
+<code>*</code>-version causes the space to stay. This example leaves space
+between the two questions.
+</p>
+<div class="example">
+<pre class="example">Question: Find the integral of \( 5x^4+5 \).
+
+\vspace*{2cm plus 0.5cm}
+Question: Find the derivative of \( x^5+5x+9 \).
+</pre></div>
+
+<p>That space will be present even if the page break happens to fall
+between the questions.
+</p>
+<p>If you use <code>\vspace</code> in the middle of a paragraph (i.e., in
+horizontal mode) then the space is inserted after the line containing
+the <code>\vspace</code> command; it does not start a new paragraph at the
+<code>\vspace</code> command.
+</p>
+<p>In this example the two questions will be evenly spaced vertically on
+the page, with at least one inch of space below each.
+</p>
+<div class="example">
+<pre class="example">\begin{document}
+1) Who put the bomp in the bomp bah bomp bah bomp?
+\vspace{1in plus 1fill}
+
+2) Who put the ram in the rama lama ding dong?
+\vspace{1in plus 1fill}
+\end{document}
+</pre></div>
+
<hr>
<a name="g_t_005cvfill"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cvspace" accesskey="n" rel="next">\vspace</a>, Previous: <a href="#g_t_005cbigskip-_005cmedskip-_005csmallskip" accesskey="p" rel="prev">\bigskip \medskip \smallskip</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005caddvspace" accesskey="n" rel="next">\addvspace</a>, Previous: <a href="#g_t_005cvspace" accesskey="p" rel="prev">\vspace</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cvfill-1"></a>
-<h3 class="section">19.10 <code>\vfill</code></h3>
+<h3 class="section">19.15 <code>\vfill</code></h3>
<a name="index-_005cvfill"></a>
<a name="index-stretch_002c-infinite-vertical"></a>
<a name="index-infinite-vertical-stretch"></a>
-<p>End the current paragraph and insert a vertical rubber length
-(see <a href="#Lengths">Lengths</a>) that is infinite, so it can stretch or shrink as far
-as needed.
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\vfill
+</pre></div>
+
+<p>End the current paragraph and insert a vertical rubber length that is
+infinite, so it can stretch or shrink as far as needed
+(see <a href="#Lengths">Lengths</a>).
</p>
<p>It is often used in the same way as <code>\vspace{\fill}</code>, except that
-<code>\vfill</code> ends the current paragraph, whereas
-<code>\vspace{\fill}</code> adds the infinite vertical space below its line
-irrespective of the paragraph structure. In both cases that space will
-disappear at a page boundary; to circumvent this see&nbsp;<a href="#g_t_005cvspace">\vspace</a>.
+<code>\vfill</code> ends the current paragraph whereas <code>\vspace{\fill}</code>
+adds the infinite vertical space below its line, irrespective of the
+paragraph structure. In both cases that space will disappear at a page
+boundary; to circumvent this see the starred option
+in&nbsp;<a href="#g_t_005cvspace">\vspace</a>.
</p>
<p>In this example the page is filled, so the top and bottom lines contain
-the text &lsquo;<samp>Lost Dog!</samp>&rsquo; and the third &lsquo;<samp>Lost Dog!</samp>&rsquo; is exactly
+the text &lsquo;<samp>Lost Dog!</samp>&rsquo; and the second &lsquo;<samp>Lost Dog!</samp>&rsquo; is exactly
halfway between them.
</p>
<div class="example">
<pre class="example">\begin{document}
Lost Dog!
\vfill
-Lost Dog!
+Lost Dog! % perfectly in the middle
\vfill
Lost Dog!
\end{document}
@@ -12637,375 +16480,636 @@ Lost Dog!
<hr>
-<a name="g_t_005cvspace"></a>
+<a name="g_t_005caddvspace"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cvfill" accesskey="p" rel="prev">\vfill</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cvfill" accesskey="p" rel="prev">\vfill</a>, Up: <a href="#Spaces" accesskey="u" rel="up">Spaces</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cvspace_007blength_007d"></a>
-<h3 class="section">19.11 <code>\vspace{<var>length</var>}</code></h3>
+<a name="g_t_005caddvspace-1"></a>
+<h3 class="section">19.16 <code>\addvspace</code></h3>
-<a name="index-_005cvspace"></a>
+<a name="index-_005caddvspace"></a>
<a name="index-vertical-space-1"></a>
-<a name="index-space_002c-vertical"></a>
+<a name="index-space_002c-inserting-vertical"></a>
-<p>Synopsis, one of these two:
+<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\vspace{<var>length</var>}
-\vspace*{<var>length</var>}
+<pre class="example">\addvspace{<var>vert-length</var>}
</pre></div>
-<p>Add the vertical space <var>length</var>. This can be negative or positive,
-and is a rubber length (see <a href="#Lengths">Lengths</a>).
-</p>
-<p>LaTeX removes the vertical space from <code>\vspace</code> at a page
-break, that is, at the top or bottom of a page. The starred version
-<code>\vspace*{...}</code> causes the space to stay.
-</p>
-<p>If <code>\vspace</code> is used in the middle of a paragraph (i.e., in
-horizontal mode), the space is inserted <em>after</em> the line with
-the <code>\vspace</code> command. A new paragraph is not started.
+<p>Add a vertical space of <var>vert-length</var>. However, if there are two or
+more <code>\addvspace</code>&rsquo;s in a sequence then together they only add the
+space needed to make the natural length equal to the maximum of the
+<var>vert-length</var>&rsquo;s in that sequence. This command is fragile
+(see <a href="#g_t_005cprotect">\protect</a>). The <var>vert-length</var> is a rubber length
+(see <a href="#Lengths">Lengths</a>).
</p>
-<p>In this example the two questions will be evenly spaced vertically on
-the page, with at least one inch of space below each.
+<p>This example illustrates. The <code>picture</code> draws a scale. In a
+standard LaTeX article the length <code>\baselineskip</code> is 12pt.
+The two rules here are 22pt apart: the sum of the
+<code>\baselineskip</code> and the 10pt from the first <code>addvspace</code>.
</p>
<div class="example">
-<pre class="example">\begin{document}
-1) Who put the bomp in the bomp bah bomp bah bomp?
-\vspace{1in plus 1fill}
-
-2) Who put the ram in the rama lama ding dong?
-\vspace{1in plus 1fill}
+<pre class="example">\documentclass{article}
+\usepackage{color}
+\begin{document}
+\setlength{\unitlength}{2pt}%
+\noindent\begin{picture}(0,0)%
+ \multiput(0,0)(0,-1){25}{{\color{blue}\line(1,0){1}}}
+ \multiput(0,0)(0,-5){6}{{\color{red}\line(1,0){2}}}
+\end{picture}%
+\rule{0.25\linewidth}{0.1pt}%
+\par\addvspace{10pt}% \addvspace{20pt}%
+\par\noindent\rule{0.25\linewidth}{0.1pt}%
\end{document}
</pre></div>
+<p>Now uncomment the second <code>\addvspace</code>. It does not make the gap
+20pt longer; instead the gap is the sum of <code>\baselineskip</code>
+and 20pt. So <code>\addvspace</code> in a sense does the opposite of
+its name &mdash; it makes sure that multiple vertical spaces do not
+accumulate, but instead that only the largest one is used.
+</p>
+<p>LaTeX uses this command to adjust the vertical space above or below
+an environment that starts a new paragraph. For instance, a
+<code>theorem</code> environment begins and ends with <code>\addvspace</code> so
+that two consecutive <code>theorem</code>&rsquo;s are separated by one vertical
+space, not two.
+</p>
+<p>A error &lsquo;<samp>Something's wrong--perhaps a missing \item</samp>&rsquo; pointing to an
+<code>\addvspace</code> means that you were not in vertical mode when you hit
+this command. One way to change that is to precede <code>\addvspace</code>
+with a <code>\par</code> command (see <a href="#g_t_005cpar">\par</a>), as in the above example.
+</p>
<hr>
<a name="Boxes"></a>
<div class="header">
<p>
-Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Spaces" accesskey="p" rel="prev">Spaces</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Spaces" accesskey="p" rel="prev">Spaces</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Boxes-1"></a>
<h2 class="chapter">20 Boxes</h2>
<a name="index-boxes"></a>
-<p>All the predefined length parameters (see <a href="#Predefined-lengths">Predefined lengths</a>) can be
-used in the arguments of the box-making commands.
+<p>At its core, LaTeX puts things in boxes and then puts the boxes on a
+page. So these commands are central.
+</p>
+<p>There are many packages on CTAN that are useful for manipulating boxes.
+One useful adjunct to the commands here is <samp>adjustbox</samp>.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cmbox" accesskey="1">\mbox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Horizontal boxes.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cfbox-and-_005cframebox" accesskey="2">\fbox and \framebox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Put a frame around a box.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#lrbox" accesskey="3">lrbox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">An environment like <code>\sbox</code>.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cmbox-_0026-_005cmakebox" accesskey="1">\mbox &amp; \makebox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Horizontal boxes.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cmakebox" accesskey="4">\makebox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Box, adjustable position.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cfbox-_0026-_005cframebox" accesskey="2">\fbox &amp; \framebox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Put a frame around a box.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cparbox" accesskey="5">\parbox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Box with text in paragraph mode.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cparbox" accesskey="3">\parbox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Box with text in paragraph mode.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005craisebox" accesskey="6">\raisebox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Raise or lower text.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005craisebox" accesskey="4">\raisebox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Raise or lower text.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005csavebox" accesskey="7">\savebox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Like <code>\makebox</code>, but save the text for later use.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005csbox-_0026-_005csavebox" accesskey="5">\sbox &amp; \savebox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Like <code>\makebox</code> but save the text for later.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005csbox" accesskey="8">\sbox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Like <code>\mbox</code>, but save the text for later use.
+<tr><td align="left" valign="top">&bull; <a href="#lrbox" accesskey="6">lrbox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Environment version of <code>\sbox</code>.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cusebox" accesskey="9">\usebox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Print saved text.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cusebox" accesskey="7">\usebox</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Print saved text.
</td></tr>
</table>
<hr>
-<a name="g_t_005cmbox"></a>
+<a name="g_t_005cmbox-_0026-_005cmakebox"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cfbox-and-_005cframebox" accesskey="n" rel="next">\fbox and \framebox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cfbox-_0026-_005cframebox" accesskey="n" rel="next">\fbox &amp; \framebox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cmbox_007btext_007d"></a>
-<h3 class="section">20.1 <code>\mbox{<var>text}</var></code></h3>
+<a name="g_t_005cmbox-_0026-_005cmakebox-1"></a>
+<h3 class="section">20.1 <code>\mbox</code> &amp; <code>\makebox</code></h3>
<a name="index-_005cmbox"></a>
-
+<a name="index-_005cmakebox"></a>
+<a name="index-box"></a>
+<a name="index-make-a-box"></a>
<a name="index-hyphenation_002c-preventing"></a>
-<p>The <code>\mbox</code> command creates a box just wide enough to hold the
-text created by its argument. The <var>text</var> is not broken into
-lines, so it can be used to prevent hyphenation.
+
+<p>Synopsis, one of:
</p>
+<div class="example">
+<pre class="example">\mbox{<var>text</var>}
+\makebox{<var>text</var>}
+\makebox[<var>width</var>]{<var>text</var>}
+\makebox[<var>width</var>][<var>position</var>]{<var>text</var>}
+</pre></div>
-<hr>
-<a name="g_t_005cfbox-and-_005cframebox"></a>
-<div class="header">
-<p>
-Next: <a href="#lrbox" accesskey="n" rel="next">lrbox</a>, Previous: <a href="#g_t_005cmbox" accesskey="p" rel="prev">\mbox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="g_t_005cfbox-and-_005cframebox-1"></a>
-<h3 class="section">20.2 <code>\fbox</code> and <code>\framebox</code></h3>
+<p>Create a box, a container for material. The <var>text</var> is is typeset in
+LR mode (see <a href="#Modes">Modes</a>) so it is not broken into lines. The
+<code>\mbox</code> command is robust, while <code>\makebox</code> is fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>Because <code>text</code> is not broken into lines, you can use <code>\mbox</code>
+to prevent hyphenation. In this example, LaTeX will not hyphenate
+the table name, &lsquo;<samp>T-4</samp>&rsquo;.
+</p>
+<div class="example">
+<pre class="example">See Table~\mbox{T-4}
+</pre></div>
-<a name="index-_005cfbox"></a>
-<a name="index-_005cframebox-1"></a>
+<p>The first two command versions, <code>\mbox</code> and <code>\makebox</code>, are
+roughly equivalent. They create a box just wide enough to contain the
+<var>text</var>. (They are like plain TeX&rsquo;s <code>\hbox</code>.)
+</p>
+<p>In the third version the optional argument <var>width</var> specifies the
+width of the box. Note that the space occupied by the text need not
+equal the width of the box. For one thing, <var>text</var> can be too small;
+this creates a full-line box
+</p>
+<div class="example">
+<pre class="example">\makebox[\linewidth]{Chapter Exam}
+</pre></div>
-<p>Synopses:
+<p>with &lsquo;<samp>Chapter Exam</samp>&rsquo; centered. But <var>text</var> can also be too wide
+for <var>width</var>. See the example below of zero-width boxes.
+</p>
+<a name="mbox-makebox-depth"></a><a name="mbox-makebox-height"></a><a name="mbox-makebox-width"></a><a name="mbox-makebox-totalheight"></a><p>In the <var>width</var> argument you can use the following lengths that refer
+to the dimension of the box that LaTeX gets on typesetting
+<var>text</var>: <code>\depth</code>, <code>\height</code>, <code>\width</code>,
+<code>\totalheight</code> (this is the box&rsquo;s height plus its depth). For
+example, to make a box with the text stretched to double the natural
+size you can say this.
</p>
<div class="example">
-<pre class="example">\fbox{<var>text</var>}
-\framebox[<var>width</var>][<var>position</var>]{<var>text</var>}
+<pre class="example">\makebox[2\width]{Get a stretcher}
</pre></div>
-<p>The <code>\fbox</code> and <code>\framebox</code> commands are like <code>\mbox</code>,
-except that they put a frame around the outside of the box being created.
+<p>For the fourth command version the optional argument <var>position</var>
+gives position of the text within the box. It may take the following
+values:
</p>
-<p>In addition, the <code>\framebox</code> command allows for explicit
-specification of the box width with the optional <var>width</var> argument
-(a dimension), and positioning with the optional <var>position</var>
-argument. </p>
-<a name="index-_005cfboxrule-1"></a>
-<a name="index-_005cfboxsep-1"></a>
-<p>Both commands produce a rule of thickness <code>\fboxrule</code> (default
-<code>0.4pt</code>), and leave a space of <code>\fboxsep</code> (default <code>3pt</code>)
-between the rule and the contents of the box.
+<dl compact="compact">
+<dt><code>c</code></dt>
+<dd><p>The <var>text</var> is centered (default).
</p>
-<p>See <a href="#g_t_005cframebox-_0028picture_0029">\framebox (picture)</a>, for the <code>\framebox</code> command in the
-<code>picture</code> environment.
+</dd>
+<dt><code>l</code></dt>
+<dd><p>The <var>text</var> is flush left.
</p>
+</dd>
+<dt><code>r</code></dt>
+<dd><p>Flush right.
+</p>
+</dd>
+<dt><code>s</code></dt>
+<dd><p>Stretch the interword space in <var>text</var> across the entire <var>width</var>.
+The <var>text</var> must contain stretchable space for this to work. For
+instance, this could head a press release:
+<code>\noindent\makebox[\textwidth][s]{\large\hfil IMMEDIATE\hfil
+RELEASE\hfil}</code>
+</p></dd>
+</dl>
-<hr>
-<a name="lrbox"></a>
-<div class="header">
-<p>
-Next: <a href="#g_t_005cmakebox" accesskey="n" rel="next">\makebox</a>, Previous: <a href="#g_t_005cfbox-and-_005cframebox" accesskey="p" rel="prev">\fbox and \framebox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="lrbox-1"></a>
-<h3 class="section">20.3 <code>lrbox</code></h3>
-
-<a name="index-lrbox"></a>
-
-<p>Synopsis:
+<p>A common use of <code>\makebox</code> is to make zero-width text boxes. This
+puts the value of the quiz questions to the left of those questions.
</p>
<div class="example">
-<pre class="example">\begin{lrbox}{\<var>cmd</var>}
- <var>text </var>
-\end{lrbox}
+<pre class="example">\newcommand{\pts}[1]{\makebox[0em][r]{#1 points\hspace*{1em}}}
+\pts{10}What is the air-speed velocity of an unladen swallow?
+
+\pts{90}An African or European swallow?
</pre></div>
-<p>This is the environment form of <a href="#g_t_005csbox"><code>\sbox</code></a>.
+<p><a name="index-package_002c-TikZ-2"></a>
+<a name="index-TikZ-package-2"></a>
+</p>
+<a name="index-package_002c-Asymptote-2"></a>
+<a name="index-Asymptote-package-2"></a>
+
+<p>The right edge of the output &lsquo;<samp>10 points </samp>&rsquo; (note the ending space)
+will be just before the &lsquo;<samp>What</samp>&rsquo; (note the space after
+&lsquo;<samp>points</samp>&rsquo;). You can use <code>\makebox</code> similarly when making
+graphics, such as in <samp>TikZ</samp> or <samp>Asymptote</samp>, where you put the
+edge of the text at a known location, regardless of the length of that
+text.
</p>
-<p>The <var>text</var> inside the environment is saved in the box <code>\<var>cmd</var></code>,
-which must have been declared with <code>\newsavebox</code>.
+<p>For boxes with frames see&nbsp;<a href="#g_t_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</a>. For colors
+see&nbsp;<a href="#Colored-boxes">Colored boxes</a>.
+</p>
+<p>There is a related version of <code>\makebox</code> that is used within the
+<code>picture</code> environment, where the length is given in terms of
+<code>\unitlength</code> (see <a href="#g_t_005cmakebox-_0028picture_0029">\makebox (picture)</a>).
+</p>
+<p>If you put a double-backslash into <var>text</var> then LaTeX will not
+give you a new line; for instance <code>\makebox{abc def \\ ghi}</code>
+outputs &lsquo;<samp>abc defghi</samp>&rsquo; while <code>\makebox{abc def \par ghi}</code>
+outputs &lsquo;<samp>abc def ghi</samp>&rsquo;, but neither go to a second line. To get
+multiple lines see&nbsp;<a href="#g_t_005cparbox">\parbox</a> and&nbsp;<a href="#minipage">minipage</a>.
</p>
<hr>
-<a name="g_t_005cmakebox"></a>
+<a name="g_t_005cfbox-_0026-_005cframebox"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cparbox" accesskey="n" rel="next">\parbox</a>, Previous: <a href="#lrbox" accesskey="p" rel="prev">lrbox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cparbox" accesskey="n" rel="next">\parbox</a>, Previous: <a href="#g_t_005cmbox-_0026-_005cmakebox" accesskey="p" rel="prev">\mbox &amp; \makebox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cmakebox-2"></a>
-<h3 class="section">20.4 <code>\makebox</code></h3>
+<a name="g_t_005cfbox-_0026-_005cframebox-1"></a>
+<h3 class="section">20.2 <code>\fbox</code> &amp; <code>\framebox</code></h3>
-<a name="index-_005cmakebox"></a>
+<a name="index-_005cfbox"></a>
+<a name="index-_005cframebox-1"></a>
-<p>Synopsis:
+<p>Synopses, one of:
</p>
<div class="example">
-<pre class="example">\makebox[<var>width</var>][<var>position</var>]{<var>text</var>}
+<pre class="example">\fbox{<var>text</var>}
+\framebox{<var>text</var>}
+\framebox[<var>width</var>]{<var>text</var>}
+\framebox[<var>width</var>][<var>position</var>]{<var>text</var>}
</pre></div>
-<p>The <code>\makebox</code> command creates a box just wide enough to contain
-the <var>text</var> specified. The width of the box can be overridden by the
-optional <var>width</var> argument. The position of the text within the box
-is determined by the optional <var>position</var> argument, which may take
-the following values:
+<p>Create a box with an enclosing frame, four lines surrounding the space.
+These commands are the same as <code>\mbox</code> and <code>\makebox</code> except
+for the frame (see <a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a>). The <code>\fbox</code> command is
+robust, the <code>\framebox</code> command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<div class="example">
+<pre class="example">\fbox{Warning! No work shown, no credit given.}
+</pre></div>
+
+<p>LaTeX puts the text into a box that cannot be split or hyphenated.
+Around that box, separated from it by a small gap, are four lines making
+a frame.
+</p>
+<p>The first two command invocations, <code>\fbox{...}</code> and
+<code>\framebox{...}</code>, are roughly the same. As to the third and
+fourth invocations, the optional arguments allow you to specify the box
+width as <var>width</var> and the position of the text inside that box as
+<var>position</var>. See <a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a> for the full description but
+here is an example creating an empty box that is 1/4in wide.
+</p>
+<div class="example">
+<pre class="example">\setlength{\fboxsep}{0pt}\framebox[0.25in]{\strut}}
+</pre></div>
+
+<p>The <code>\strut</code> inserts a vertical height of <code>\baselineskip</code>
+(see <a href="#g_t_005cstrut">\strut</a>).
+</p>
+<p>These parameters determine the frame layout.
</p>
<dl compact="compact">
-<dt><code>c</code></dt>
-<dd><p>Centered (default).
-</p></dd>
-<dt><code>l</code></dt>
-<dd><p>Flush left.
-</p></dd>
-<dt><code>r</code></dt>
-<dd><p>Flush right.
-</p></dd>
-<dt><code>s</code></dt>
-<dd><p>Stretch (justify) across entire <var>width</var>; <var>text</var> must contain
-stretchable space for this to work.
-</p></dd>
+<dd><a name="fbox-framebox-fboxrule"></a></dd>
+<dt><code>\fboxrule</code>
+<a name="index-_005cfboxrule-2"></a>
+</dt>
+<dd><a name="index-frame_002c-line-width"></a>
+<a name="index-frame-rule-width"></a>
+<a name="index-_005cfboxrule"></a>
+<p>The thickness of the lines around the enclosed box. The default is
+0.2pt. Change it with a command such as
+<code>\setlength{\fboxrule}{0.8pt}</code> (see <a href="#g_t_005csetlength">\setlength</a>).
+</p>
+<a name="fbox-framebox-fboxsep"></a></dd>
+<dt><code>\fboxsep</code>
+<a name="index-_005cfboxsep-2"></a>
+</dt>
+<dd><a name="index-frame_002c-separation-from-contents"></a>
+<a name="index-_005cfboxsep"></a>
+<p>The distance from the frame to the enclosed box. The default is 3pt.
+Change it with a command such as <code>\setlength{\fboxsep}{0pt}</code>
+(see <a href="#g_t_005csetlength">\setlength</a>). Setting it to 0pt is useful sometimes:
+this will put a frame around the picture with no white border.
+</p>
+<div class="example">
+<pre class="example">{\setlength{\fboxsep}{0pt}
+ \framebox{%
+ \includegraphics[width=0.5\textwidth]{prudence.jpg}}}
+</pre></div>
+
+<p>The extra curly braces keep the effect of the <code>\setlength</code> local.
+</p>
+</dd>
</dl>
-<p><code>\makebox</code> is also used within the <code>picture</code> environment
-see <a href="#g_t_005cmakebox-_0028picture_0029">\makebox (picture)</a>.
+<p>As with <code>\mbox</code> and <code>\makebox</code>, LaTeX will not break lines
+in <var>text</var>. But this example has LaTeX break lines to make a
+paragraph, and then frame the result.
+</p>
+<div class="example">
+<pre class="example">\framebox{%
+ \begin{minipage}{0.6\linewidth}
+ My dear, here we must run as fast as we can, just to stay in place.
+ And if you wish to go anywhere you must run twice as fast as that.
+ \end{minipage}}
+</pre></div>
+
+<p>See <a href="#Colored-boxes">Colored boxes</a> for colors other than black and white.
+</p>
+<p>The <code>picture</code> environment has a version of this command where the
+units depend on <code>picture</code>&rsquo;s <code>\unitlength</code> (see <a href="#g_t_005cframebox-_0028picture_0029">\framebox (picture)</a>).
</p>
<hr>
<a name="g_t_005cparbox"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005craisebox" accesskey="n" rel="next">\raisebox</a>, Previous: <a href="#g_t_005cmakebox" accesskey="p" rel="prev">\makebox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005craisebox" accesskey="n" rel="next">\raisebox</a>, Previous: <a href="#g_t_005cfbox-_0026-_005cframebox" accesskey="p" rel="prev">\fbox &amp; \framebox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cparbox-1"></a>
-<h3 class="section">20.5 <code>\parbox</code></h3>
+<h3 class="section">20.3 <code>\parbox</code></h3>
<a name="index-_005cparbox"></a>
+<a name="index-paragraph-mode-1"></a>
+<a name="index-paragraph_002c-in-a-box"></a>
-<p>Synopsis:
+<p>Synopses, one of:
</p>
<div class="example">
-<pre class="example">\parbox[<var>position</var>][<var>height</var>][<var>inner-pos</var>]{<var>width</var>}{<var>text</var>}
+<pre class="example">\parbox{<var>width</var>}{<var>contents</var>}
+\parbox[<var>position</var>]{<var>width</var>}{<var>contents</var>}
+\parbox[<var>position</var>][<var>height</var>]{<var>width</var>}{<var>contents</var>}
+\parbox[<var>position</var>][<var>height</var>][<var>inner-pos</var>]{<var>width</var>}{<var>contents</var>}
</pre></div>
-<a name="index-paragraph-mode-1"></a>
-<p>The <code>\parbox</code> command produces a box whose contents are created
-in <em>paragraph mode</em>. It should be used to make a box small
-pieces of text, with nothing fancy inside. In particular, you
-shouldn&rsquo;t use any paragraph-making environments inside a
-<code>\parbox</code> argument. For larger pieces of text, including ones
-containing a paragraph-making environment, you should use a
-<code>minipage</code> environment (see <a href="#minipage">minipage</a>).
-</p>
-<p><code>\parbox</code> has two mandatory arguments:
+<p>Produce a box of text that is <var>width</var> wide. Use this command to make
+a box of small pieces of text, of a single paragraph. This command is
+fragile (see <a href="#g_t_005cprotect">\protect</a>).
</p>
-<dl compact="compact">
-<dt><var>width</var></dt>
-<dd><p>the width of the parbox;
-</p></dd>
-<dt><var>text</var></dt>
-<dd><p>the text that goes inside the parbox.
-</p></dd>
-</dl>
+<div class="example">
+<pre class="example">\begin{picture}(0,0)
+ ...
+ \put(1,2){\parbox{1.75in}{\raggedright Because the graph is a line on
+ this semilog paper, the relationship is
+ exponential.}}
+\end{picture}
+</pre></div>
-<p>By default LaTeX will position vertically a parbox so its center
-lines up with the center of the surrounding text line. When the
-optional <var>position</var> argument is present and equal either to &lsquo;<samp>t</samp>&rsquo;
-or &lsquo;<samp>b</samp>&rsquo;, this allows you respectively to align either the top or
-bottom line in the parbox with the baseline of the surrounding text. You
-may also specify &lsquo;<samp>m</samp>&rsquo; for <var>position</var> to get the default
-behaviour.
-</p>
-<p>The optional <var>height</var> argument overrides the natural height of the box.
+<p>The <var>contents</var> are processed in a text mode (see <a href="#Modes">Modes</a>) so
+LaTeX will break lines to make a paragraph. But it won&rsquo;t make
+multiple paragraphs; for that, use a <code>minipage</code> environment
+(see <a href="#minipage">minipage</a>).
+</p>
+<p>The options for <code>\parbox</code> (except for <var>contents</var>) are the same
+as those for <code>minipage</code>. For convenience a summary of the options
+is here but see&nbsp;<a href="#minipage">minipage</a> for a complete description.
+</p>
+<p>There are two required arguments. The <var>width</var> is a rigid length
+(see <a href="#Lengths">Lengths</a>). It sets the width of the box into which LaTeX
+typesets <var>contents</var>. The <var>contents</var> is the text that is placed
+in that box. It should not have any paragraph-making components.
+</p>
+<p>There are three optional arguments, <var>position</var>, <var>height</var>, and
+<var>inner-pos</var>. The <var>position</var> gives the vertical alignment of the
+<code>parbox</code> with respect to the surrounding material. The possible
+values are <code>c</code> or <code>m</code> to make the vertical center of the
+<code>parbox</code> lines up with the center of the adjacent line (this is the
+default), or <code>t</code> to match the top line of the <code>parbox</code> with
+the baseline of the surrounding material, or <code>b</code> to match the
+bottom line.
+</p>
+<p>The optional argument <var>height</var> overrides the natural height of the
+box.
+</p>
+<p>The optional argument <var>inner-pos</var> controls the placement of
+<var>content</var> inside the <code>parbox</code>. Its default is the value of
+<var>position</var>. Its possible values are: <code>t</code> to put the
+<var>content</var> at the top of the box, <code>c</code> to put it in the vertical
+center, <code>b</code> to put it at the bottom of the box, and <code>s</code> to
+stretch it out vertically (for this, the text must contain vertically
+stretchable space).
</p>
-<p>The <var>inner-pos</var> argument controls the placement of the text inside
-the box, as follows; if it is not specified, <var>position</var> is used.
-</p>
-<dl compact="compact">
-<dt><code>t</code></dt>
-<dd><p>text is placed at the top of the box.
-</p></dd>
-<dt><code>c</code></dt>
-<dd><p>text is centered in the box.
-</p></dd>
-<dt><code>b</code></dt>
-<dd><p>text is placed at the bottom of the box.
-</p></dd>
-<dt><code>s</code></dt>
-<dd><p>stretch vertically; the text must contain vertically stretchable space
-for this to work.
-</p></dd>
-</dl>
-
-
<hr>
<a name="g_t_005craisebox"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005csavebox" accesskey="n" rel="next">\savebox</a>, Previous: <a href="#g_t_005cparbox" accesskey="p" rel="prev">\parbox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005csbox-_0026-_005csavebox" accesskey="n" rel="next">\sbox &amp; \savebox</a>, Previous: <a href="#g_t_005cparbox" accesskey="p" rel="prev">\parbox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005craisebox-1"></a>
-<h3 class="section">20.6 <code>\raisebox</code></h3>
+<h3 class="section">20.4 <code>\raisebox</code></h3>
<a name="index-_005craisebox"></a>
-<p>Synopsis:
+<p>Synopsis, one of:
</p>
<div class="example">
-<pre class="example">\raisebox{<var>distance</var>}[<var>height</var>][<var>depth</var>]{<var>text</var>}
+<pre class="example">\raisebox{<var>distance</var>}{<var>text</var>}
+\raisebox{<var>distance</var>}[<var>height</var>]{<var>text</var>}
+\raisebox{<var>distance</var>}[<var>height</var>][<var>depth</var>]{<var>text</var>}
</pre></div>
-<p>The <code>\raisebox</code> command raises or lowers <var>text</var>. The first
-mandatory argument specifies how high <var>text</var> is to be raised (or
-lowered if it is a negative amount). <var>text</var> itself is processed
-in LR mode.
+<p>Raise or lower <var>text</var>. This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>This example makes a command for the restriction of a function by
+lowering the vertical bar symbol.
+</p>
+<div class="example">
+<pre class="example">\newcommand\restricted[1]{\raisebox{-.5ex}{$|$}_{#1}}
+$f\restricted{A}$
+</pre></div>
+
+<p>The first mandatory argument <var>distance</var> specifies how far to raise
+the second mandatory argument <var>text</var>. This is a rigid length
+(see <a href="#Lengths">Lengths</a>). If it is negative then it lowers <var>text</var>. The
+<var>text</var> is processed in LR mode so it cannot contain line breaks
+(see <a href="#Modes">Modes</a>).
</p>
<p>The optional arguments <var>height</var> and <var>depth</var> are dimensions. If
-they are specified, LaTeX treats <var>text</var> as extending a certain
-distance above the baseline (<var>height</var>) or below (<var>depth</var>),
-ignoring its natural height and depth.
+they are specified, they override the natural height and depth of the
+box LaTeX gets by typesetting <var>text</var>.
+</p>
+<a name="raisebox-depth"></a><a name="raisebox-height"></a><a name="raisebox-width"></a><a name="raisebox-totalheight"></a><p>In the arguments <var>distance</var>, <var>height</var>, and <var>depth</var> you can
+use the following lengths that refer to the dimension of the box that
+LaTeX gets on typesetting <var>text</var>: <code>\depth</code>, <code>\height</code>,
+<code>\width</code>, <code>\totalheight</code> (this is the box&rsquo;s height plus its
+depth).
+</p>
+<p>This will align two graphics on their top (see <a href="#Graphics">Graphics</a>).
+</p>
+<div class="example">
+<pre class="example">\usepackage{graphicx} \usepackage{calc} % in preamble
+ ...
+\begin{center}
+ \raisebox{1ex-\height}{%
+ \includegraphics[width=0.4\linewidth]{lion.png}}
+ \qquad
+ \raisebox{1ex-\height}{%
+ \includegraphics[width=0.4\linewidth]{meta.png}}
+\end{center}
+</pre></div>
+
+<p>The first <code>\height</code> is the height of <samp>lion.png</samp> while the
+second is the height of <samp>meta.png</samp>.
</p>
<hr>
-<a name="g_t_005csavebox"></a>
+<a name="g_t_005csbox-_0026-_005csavebox"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005csbox" accesskey="n" rel="next">\sbox</a>, Previous: <a href="#g_t_005craisebox" accesskey="p" rel="prev">\raisebox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#lrbox" accesskey="n" rel="next">lrbox</a>, Previous: <a href="#g_t_005craisebox" accesskey="p" rel="prev">\raisebox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005csavebox-1"></a>
-<h3 class="section">20.7 <code>\savebox</code></h3>
+<a name="g_t_005csbox-_0026-_005csavebox-1"></a>
+<h3 class="section">20.5 <code>\sbox</code> &amp; <code>\savebox</code></h3>
+<a name="index-_005csbox"></a>
<a name="index-_005csavebox"></a>
+<a name="index-box_002c-save"></a>
-<p>Synopsis:
+<p>Synopsis, one of:
</p>
<div class="example">
-<pre class="example">\savebox{<var>\boxcmd</var>}[<var>width</var>][<var>pos</var>]{<var>text</var>}
+<pre class="example">\sbox{<var>box-cmd</var>}{<var>text</var>}
+\savebox{<var>box-cmd</var>}{<var>text</var>}
+\savebox{<var>box-cmd</var>}[<var>width</var>]{<var>text</var>}
+\savebox{<var>box-cmd</var>}[<var>width</var>][<var>pos</var>]{<var>text</var>}
</pre></div>
-<p>This command typeset <var>text</var> in a box just as with <code>\makebox</code>
-(see <a href="#g_t_005cmakebox">\makebox</a>), except that instead of printing the resulting box,
-it saves it in the box labeled <var>\boxcmd</var>, which must have been
-declared with <code>\newsavebox</code> (see <a href="#g_t_005cnewsavebox">\newsavebox</a>).
+<p>Typeset <var>text</var> just as with <code>\makebox</code> (see <a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a>) except that LaTeX does not output it but instead saves it
+in a storage bin named <var>box-cmd</var>. The bin name <var>box-cmd</var> begins
+with a backslash, <code>\</code>. You must have previously allocated the bin
+<var>box-cmd</var> with <code>\newsavebox</code> (see <a href="#g_t_005cnewsavebox">\newsavebox</a>).The
+<code>\sbox</code> command is robust while <code>\savebox</code> is fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>This creates and uses a bin.
+</p>
+<div class="example">
+<pre class="example">\newsavebox{\fullname}
+\sbox{\fullname}{John Jacob Jingleheimer Schmidt}
+ ...
+\usebox{\fullname}! His name is my name, too!
+Whenever we go out, the people always shout!
+There goes \\usebox{\fullname}! Ya da da da da da da.
+</pre></div>
+
+<p>One advantage of using and reusing a bin over a <code>\newcommand</code> is
+efficiency, that LaTeX need not repeatedly retypeset the contents.
+See the example below.
+</p>
+<p>The first two command invocations,
+<code>\sbox{<var>box-cmd</var>}{<var>text</var>}</code> and
+<code>\savebox{<var>box-cmd</var>}{<var>text</var>}</code>, are roughly equivalent.
+As to the third and fourth, the optional arguments allow you to specify
+the box width as <var>width</var>, and the position of the text inside that
+box as <var>position</var>. See <a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a> for the full
+description.
+</p>
+<p>In the <code>\sbox</code> and <code>\savebox</code> commands the <var>text</var> is
+typeset in LR mode so it does not have line breaks (see <a href="#Modes">Modes</a>). If
+you use these then LaTeX doesn&rsquo;t give you an error but it ignores
+what you want: if you enter <code>\sbox{\newbin}{test \\ test}</code> and
+<code>\usebox{\newbin}</code> then you get &lsquo;<samp>testtest</samp>&rsquo;, while if you
+enter <code>\sbox{\newbin}{test \par test}</code> and
+<code>\usebox{\newbin}</code> then you get &lsquo;<samp>test test</samp>&rsquo;, but no error or
+warning. To fix this use a <code>\parbox</code> or <code>minipage</code> as here.
+</p>
+<div class="example">
+<pre class="example">\savebox{\abin}{%
+ \begin{minipage}{\linewidth}
+ \begin{enumerate}
+ \item First item
+ \item Second item
+ \end{enumerate}
+ \end{minipage}}
+ ...
+\usebox{\abin}
+</pre></div>
+
+<p>As an example of the efficiency of reusing a bin&rsquo;s contents, this puts
+the same picture on each page of the document by putting it in the
+header. LaTeX only typesets it once.
+</p>
+<div class="example">
+<pre class="example">\usepackage{graphicx} % all this in the preamble
+\newsavebox{\sealbin}
+\savebox{\sealbin}{%
+ \setlength{\unitlength}{1in}%
+ \begin{picture}(0,0)%
+ \put(1.5,-2.5){%
+ \begin{tabular}{c}
+ \includegraphics[height=2in]{companylogo.png} \\
+ Office of the President
+ \end{tabular}}
+ \end{picture}%
+}
+\markright{\usebox{\sealbin}}
+\pagestyle{headings}
+</pre></div>
+
+<p>The <code>picture</code> environment is good for fine-tuning the placement.
+</p>
+<p>If the bin has not already been defined then you get something like
+&lsquo;<samp>Undefined control sequence. &lt;argument&gt; \nobin</samp>&rsquo;.
</p>
<hr>
-<a name="g_t_005csbox"></a>
+<a name="lrbox"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cusebox" accesskey="n" rel="next">\usebox</a>, Previous: <a href="#g_t_005csavebox" accesskey="p" rel="prev">\savebox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cusebox" accesskey="n" rel="next">\usebox</a>, Previous: <a href="#g_t_005csbox-_0026-_005csavebox" accesskey="p" rel="prev">\sbox &amp; \savebox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005csbox_007b_005cboxcmd_007d_007btext_007d"></a>
-<h3 class="section">20.8 <code>\sbox{<var>\boxcmd</var>}{<var>text</var>}</code></h3>
+<a name="lrbox-1"></a>
+<h3 class="section">20.6 <code>lrbox</code></h3>
-<a name="index-_005csbox"></a>
+<a name="index-lrbox"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\sbox{<var>\boxcmd</var>}{<var>text</var>}
+<pre class="example">\begin{lrbox}{<var>box-cmd</var>}
+ <var>text</var>
+\end{lrbox}
</pre></div>
-<p><code>\sbox</code> types <var>text</var> in a box just as with <code>\mbox</code>
-(see <a href="#g_t_005cmbox">\mbox</a>) except that instead of the resulting box being
-included in the normal output, it is saved in the box labeled
-<var>\boxcmd</var>. <var>\boxcmd</var> must have been previously declared with
-<code>\newsavebox</code> (see <a href="#g_t_005cnewsavebox">\newsavebox</a>).
+<p>The <var>text</var> inside the environment is saved in the bin
+<code><var>box-cmd</var></code>. The <var>box-cmd</var> must begin with a
+backslash. You must create this bin in advance with <code>\newsavebox</code>
+(see <a href="#g_t_005cnewsavebox">\newsavebox</a>). This is the environment form of the <code>\sbox</code>
+and <code>\savebox</code> commands, and is equivalent to them. See <a href="#g_t_005csbox-_0026-_005csavebox">\sbox &amp; \savebox</a> for the full information.
</p>
+<p>In this example the environment is convenient for entering the
+<code>tabular</code>.
+</p>
+<div class="example">
+<pre class="example">\newsavebox{\jhbin}
+\begin{lrbox}{\jhbin}
+ \begin{tabular}{c}
+ \includegraphics[height=1in]{jh.png} \\
+ Jim Hef{}feron
+ \end{tabular}
+\end{lrbox}
+ ...
+\usebox{\jhbin}
+</pre></div>
+
<hr>
<a name="g_t_005cusebox"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005csbox" accesskey="p" rel="prev">\sbox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#lrbox" accesskey="p" rel="prev">lrbox</a>, Up: <a href="#Boxes" accesskey="u" rel="up">Boxes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cusebox_007b_005cboxcmd_007d"></a>
-<h3 class="section">20.9 <code>\usebox{<var>\boxcmd</var>}</code></h3>
+<a name="g_t_005cusebox-1"></a>
+<h3 class="section">20.7 <code>\usebox</code></h3>
<a name="index-_005cusebox"></a>
+<a name="index-box_002c-use-saved-box"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\usebox{<var>\boxcmd</var>}
+<pre class="example">\usebox{<var>box-cmd</var>}
</pre></div>
-<p><code>\usebox</code> produces the box most recently saved in the bin
-<var>\boxcmd</var> by a <code>\savebox</code> command (see <a href="#g_t_005csavebox">\savebox</a>).
+<p>Produce the box most recently saved in the bin <var>box-cmd</var> by the
+commands <code>\sbox</code> or <code>\savebox</code>, or the <code>lrbox</code>
+environment. See <a href="#g_t_005csbox-_0026-_005csavebox">\sbox &amp; \savebox</a> for more information and examples.
+(Note that <var>box-cmd</var> starts with a backslash.) This command is
+robust (see <a href="#g_t_005cprotect">\protect</a>).
</p>
<hr>
<a name="Color"></a>
<div class="header">
<p>
-Next: <a href="#Graphics" accesskey="n" rel="next">Graphics</a>, Previous: <a href="#Boxes" accesskey="p" rel="prev">Boxes</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Graphics" accesskey="n" rel="next">Graphics</a>, Previous: <a href="#Boxes" accesskey="p" rel="prev">Boxes</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Color-1"></a>
<h2 class="chapter">21 Color</h2>
@@ -13038,10 +17142,10 @@ significantly extends the capabilities described here, including adding
<a name="Color-package-options"></a>
<div class="header">
<p>
-Next: <a href="#Color-models" accesskey="n" rel="next">Color models</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Color-models" accesskey="n" rel="next">Color models</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Color-package-options-1"></a>
-<h3 class="section">21.1 Color package options</h3>
+<a name="color-package-options"></a>
+<h3 class="section">21.1 <code>color</code> package options</h3>
<a name="index-color-package-options"></a>
<a name="index-options_002c-color-package"></a>
@@ -13096,7 +17200,7 @@ memory space.
<a name="Color-models"></a>
<div class="header">
<p>
-Next: <a href="#Commands-for-color" accesskey="n" rel="next">Commands for color</a>, Previous: <a href="#Color-package-options" accesskey="p" rel="prev">Color package options</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Commands-for-color" accesskey="n" rel="next">Commands for color</a>, Previous: <a href="#Color-package-options" accesskey="p" rel="prev">Color package options</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Color-models-1"></a>
<h3 class="section">21.2 Color models</h3>
@@ -13117,6 +17221,7 @@ such as with inks, so that combining full intensity of cyan, magenta,
and yellow makes black.
</p>
<dl compact="compact">
+<dd><a name="color-models-cmyk"></a></dd>
<dt><code>cmyk</code></dt>
<dd><p>A comma-separated list with four real numbers between 0 and 1,
inclusive. The first number is the intensity of cyan, the second is
@@ -13124,12 +17229,12 @@ magenta, and the others are yellow and black. A number value of 0 means
minimal intensity, while a 1 is for full intensity. This model is often
used in color printing. It is a subtractive model.
</p>
-</dd>
+<a name="color-models-gray"></a></dd>
<dt><code>gray</code></dt>
<dd><p>A single real number between 0 and 1, inclusive. The colors are shades
of grey. The number 0 produces black while 1 gives white.
</p>
-</dd>
+<a name="color-models-rgb"></a></dd>
<dt><code>rgb</code></dt>
<dd><p>A comma-separated list with three real numbers between 0 and 1,
inclusive. The first number is the intensity of the red component, the
@@ -13137,7 +17242,7 @@ second is green, and the third the blue. A number value of 0 means that
none of that component is added in, while a 1 means full intensity.
This is an additive model.
</p>
-</dd>
+<a name="color-models-RGB"></a></dd>
<dt><code>RGB</code></dt>
<dd><p>(<samp>pdftex</samp>, <samp>xetex</samp>, <samp>luatex</samp> drivers) A comma-separated
list with three integers between 0 and 255, inclusive. This model is a
@@ -13146,7 +17251,7 @@ often described in a red-green-blue model using numbers in this range.
The values entered here are converted to the <code>rgb</code> model by
dividing by 255.
</p>
-</dd>
+<a name="color-models-named"></a></dd>
<dt><code>named</code></dt>
<dd><p>Colors are accessed by name, such as &lsquo;<samp>PrussianBlue</samp>&rsquo;. The list of
names depends on the driver, but all support the names &lsquo;<samp>black</samp>&rsquo;,
@@ -13162,7 +17267,7 @@ names depends on the driver, but all support the names &lsquo;<samp>black</samp>
<a name="Commands-for-color"></a>
<div class="header">
<p>
-Previous: <a href="#Color-models" accesskey="p" rel="prev">Color models</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Color-models" accesskey="p" rel="prev">Color models</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Commands-for-color-1"></a>
<h3 class="section">21.3 Commands for color</h3>
@@ -13187,7 +17292,7 @@ Previous: <a href="#Color-models" accesskey="p" rel="prev">Color models</a>, Up:
<a name="Define-colors"></a>
<div class="header">
<p>
-Next: <a href="#Colored-text" accesskey="n" rel="next">Colored text</a>, Up: <a href="#Commands-for-color" accesskey="u" rel="up">Commands for color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Colored-text" accesskey="n" rel="next">Colored text</a>, Up: <a href="#Commands-for-color" accesskey="u" rel="up">Commands for color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Define-colors-1"></a>
<h4 class="subsection">21.3.1 Define colors</h4>
@@ -13202,9 +17307,14 @@ Next: <a href="#Colored-text" accesskey="n" rel="next">Colored text</a>, Up: <a
<pre class="example">\definecolor{<var>name</var>}{<var>model</var>}{<var>specification</var>}
</pre></div>
-<p>Give the name <var>name</var> to the color. For example, after
-<code>\definecolor{silver}{rgb}{0.75,0.75,0.74}</code> you can use that
-color name with <code>Hi ho, \textcolor{silver}{Silver}!</code>.
+<p>Give the name <var>name</var> to the color. For example, after this
+</p>
+<div class="example">
+<pre class="example">\definecolor{silver}{rgb}{0.75,0.75,0.74}
+</pre></div>
+
+<p>you can use that color name with <code>Hi ho,
+\textcolor{silver}{Silver}!</code>.
</p>
<p>This example gives the color a more abstract name, so it could change and
not be misleading.
@@ -13222,7 +17332,7 @@ or style, rather than in the document body.
<a name="Colored-text"></a>
<div class="header">
<p>
-Next: <a href="#Colored-boxes" accesskey="n" rel="next">Colored boxes</a>, Previous: <a href="#Define-colors" accesskey="p" rel="prev">Define colors</a>, Up: <a href="#Commands-for-color" accesskey="u" rel="up">Commands for color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Colored-boxes" accesskey="n" rel="next">Colored boxes</a>, Previous: <a href="#Define-colors" accesskey="p" rel="prev">Define colors</a>, Up: <a href="#Commands-for-color" accesskey="u" rel="up">Commands for color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Colored-text-1"></a>
<h4 class="subsection">21.3.2 Colored text</h4>
@@ -13247,7 +17357,8 @@ Next: <a href="#Colored-boxes" accesskey="n" rel="next">Colored boxes</a>, Previ
<p>The affected text gets the color. This line
</p>
<div class="example">
-<pre class="example">\textcolor{magenta}{My name is Ozymandias, king of kings:} Look on my works, ye Mighty, and despair!
+<pre class="example">\textcolor{magenta}{My name is Ozymandias, king of kings:}
+Look on my works, ye Mighty, and despair!
</pre></div>
<p>causes the first half to be in magenta while the rest is in black. You
@@ -13277,9 +17388,14 @@ including the vertical and horizontal lines.
\end{center}
</pre></div>
-<p>You can use color in equations. A document might have
-<code>\definecolor{highlightcolor}{RGB}{225,15,0}</code> in the
-preamble, and then contain this equation.
+<p>You can use color in equations. A document might have this definition
+in the preamble
+</p>
+<div class="example">
+<pre class="example">\definecolor{highlightcolor}{RGB}{225,15,0}
+</pre></div>
+
+<p>and then contain this equation.
</p>
<div class="example">
<pre class="example">\begin{equation}
@@ -13292,7 +17408,8 @@ but sometimes you want a one-off. Those are the second forms in the
synopses.
</p>
<div class="example">
-<pre class="example">Colors of \textcolor[rgb]{0.33,0.14,0.47}{Purple} and {\color[rgb]{0.72,0.60,0.37} Gold} for the team
+<pre class="example">Colors of \textcolor[rgb]{0.33,0.14,0.47}{Purple} and
+{\color[rgb]{0.72,0.60,0.37} Gold} for the team.
</pre></div>
<p>The format of <var>color specification </var> depends on the color model
@@ -13317,7 +17434,7 @@ numbers, <code>gray</code> takes only one.
<a name="Colored-boxes"></a>
<div class="header">
<p>
-Next: <a href="#Colored-pages" accesskey="n" rel="next">Colored pages</a>, Previous: <a href="#Colored-text" accesskey="p" rel="prev">Colored text</a>, Up: <a href="#Commands-for-color" accesskey="u" rel="up">Commands for color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Colored-pages" accesskey="n" rel="next">Colored pages</a>, Previous: <a href="#Colored-text" accesskey="p" rel="prev">Colored text</a>, Up: <a href="#Commands-for-color" accesskey="u" rel="up">Commands for color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Colored-boxes-1"></a>
<h4 class="subsection">21.3.3 Colored boxes</h4>
@@ -13330,14 +17447,14 @@ Next: <a href="#Colored-pages" accesskey="n" rel="next">Colored pages</a>, Previ
</p>
<div class="example">
<pre class="example">\colorbox{<var>name</var>}{...}
-\colorbox[<var>model name</var>]{<var>box background color specification</var>}{...}
+\colorbox[<var>model name</var>]{<var>box background color</var>}{...}
</pre></div>
<p>or
</p>
<div class="example">
<pre class="example">\fcolorbox{<var>frame color</var>}{<var>box background color</var>}{...}
-\fcolorbox[<var>model name</var>]{<var>frame color specification</var>}{<var>box background color specification</var>}{...}
+\fcolorbox[<var>model name</var>]{<var>frame color</var>}{<var>box background color</var>}{...}
</pre></div>
<p>Make a box with the stated background color. The <code>\fcolorbox</code>
@@ -13357,7 +17474,7 @@ puts white text on a blue background.
</pre></div>
<p>The <code>\fcolorbox</code> commands use the same parameters as <code>\fbox</code>
-(see <a href="#g_t_005cfbox-and-_005cframebox">\fbox and \framebox</a>), <code>\fboxrule</code> and <code>\fboxsep</code>, to
+(see <a href="#g_t_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</a>), <code>\fboxrule</code> and <code>\fboxsep</code>, to
set the thickness of the rule and the boundary between the box interior
and the surrounding rule. LaTeX&rsquo;s defaults are <code>0.4pt</code> and
<code>3pt</code>, respectively.
@@ -13376,7 +17493,7 @@ of the second line.
<a name="Colored-pages"></a>
<div class="header">
<p>
-Previous: <a href="#Colored-boxes" accesskey="p" rel="prev">Colored boxes</a>, Up: <a href="#Commands-for-color" accesskey="u" rel="up">Commands for color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Colored-boxes" accesskey="p" rel="prev">Colored boxes</a>, Up: <a href="#Commands-for-color" accesskey="u" rel="up">Commands for color</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Colored-pages-1"></a>
<h4 class="subsection">21.3.4 Colored pages</h4>
@@ -13413,7 +17530,7 @@ rather than the default transparent background.)
<a name="Graphics"></a>
<div class="header">
<p>
-Next: <a href="#Special-insertions" accesskey="n" rel="next">Special insertions</a>, Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Special-insertions" accesskey="n" rel="next">Special insertions</a>, Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Graphics-1"></a>
<h2 class="chapter">22 Graphics</h2>
@@ -13456,7 +17573,7 @@ external to LaTeX, that generate a graphic that you include using the
commands of this chapter. Two that use a programming language are
Asymptote and MetaPost. One that uses a graphical interface is Xfig.
Full description of these systems is outside the scope of this document;
-see their documentation.
+see their documentation on CTAN.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Graphics-package-options" accesskey="1">Graphics package options</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Options when you load the package.
@@ -13472,10 +17589,10 @@ see their documentation.
<a name="Graphics-package-options"></a>
<div class="header">
<p>
-Next: <a href="#Graphics-package-configuration" accesskey="n" rel="next">Graphics package configuration</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Graphics-package-configuration" accesskey="n" rel="next">Graphics package configuration</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Graphics-package-options-1"></a>
-<h3 class="section">22.1 Graphics package options</h3>
+<a name="graphics-package-options"></a>
+<h3 class="section">22.1 <code>graphics</code> package options</h3>
<a name="index-graphics-package-options"></a>
<a name="index-options_002c-graphics-package"></a>
@@ -13561,10 +17678,10 @@ option has LaTeX to read the size from the latter.
<a name="Graphics-package-configuration"></a>
<div class="header">
<p>
-Next: <a href="#Commands-for-graphics" accesskey="n" rel="next">Commands for graphics</a>, Previous: <a href="#Graphics-package-options" accesskey="p" rel="prev">Graphics package options</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Commands-for-graphics" accesskey="n" rel="next">Commands for graphics</a>, Previous: <a href="#Graphics-package-options" accesskey="p" rel="prev">Graphics package options</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Graphics-package-configuration-1"></a>
-<h3 class="section">22.2 Graphics package configuration</h3>
+<a name="graphics-package-configuration"></a>
+<h3 class="section">22.2 <code>graphics</code> package configuration</h3>
<a name="index-graphics-1"></a>
<a name="index-graphics-package-1"></a>
@@ -13579,7 +17696,7 @@ Next: <a href="#Commands-for-graphics" accesskey="n" rel="next">Commands for gra
the graphic.
</p>
<p>The behavior of file system search code is necessarily platform
-dependent. In this document we cover Linux, Macintosh, and Windows, as
+dependent. In this document we cover GNU/Linux, Macintosh, and Windows, as
those systems are typically configured. For other situations consult
the documentation in <samp>grfguide.pdf</samp>, or the LaTeX source, or your
TeX distribution&rsquo;s documentation.
@@ -13598,7 +17715,7 @@ TeX distribution&rsquo;s documentation.
<a name="g_t_005cgraphicspath"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cDeclareGraphicsExtensions" accesskey="n" rel="next">\DeclareGraphicsExtensions</a>, Up: <a href="#Graphics-package-configuration" accesskey="u" rel="up">Graphics package configuration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cDeclareGraphicsExtensions" accesskey="n" rel="next">\DeclareGraphicsExtensions</a>, Up: <a href="#Graphics-package-configuration" accesskey="u" rel="up">Graphics package configuration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cgraphicspath-1"></a>
<h4 class="subsection">22.2.1 <code>\graphicspath</code></h4>
@@ -13663,9 +17780,9 @@ these means that the document is not portable. (You could preserve
portability by adjusting your TeX system settings configuration file
parameter <code>TEXINPUTS</code>; see the documentation of your system.)
</p>
-<p>You can use <code>\graphicspath</code> in the preamble or in the document
-body. You can use it more than once. For debugging, show its value
-with <code>\makeatletter\typeout{\Ginput@path}\makeatother</code>.
+<p>You can use <code>\graphicspath</code> anywhere in the document. You can use
+it more than once. Show its value with
+<code>\makeatletter\typeout{\Ginput@path}\makeatother</code>.
</p>
<p>The directories are taken with respect to the base file. That is,
suppose that you are working on a document based on <samp>book/book.tex</samp>
@@ -13679,7 +17796,7 @@ instead in <samp>book/plots</samp>.
<a name="g_t_005cDeclareGraphicsExtensions"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cDeclareGraphicsRule" accesskey="n" rel="next">\DeclareGraphicsRule</a>, Previous: <a href="#g_t_005cgraphicspath" accesskey="p" rel="prev">\graphicspath</a>, Up: <a href="#Graphics-package-configuration" accesskey="u" rel="up">Graphics package configuration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cDeclareGraphicsRule" accesskey="n" rel="next">\DeclareGraphicsRule</a>, Previous: <a href="#g_t_005cgraphicspath" accesskey="p" rel="prev">\graphicspath</a>, Up: <a href="#Graphics-package-configuration" accesskey="u" rel="up">Graphics package configuration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cDeclareGraphicsExtensions-1"></a>
<h4 class="subsection">22.2.2 <code>\DeclareGraphicsExtensions</code></h4>
@@ -13714,17 +17831,20 @@ and extensions then it reports &lsquo;<samp>! LaTeX Error: File `<samp>lion</sam
not found</samp>&rsquo;. Note that you must include the periods at the start of the
extensions.
</p>
-<p>Because Linux and Macintosh filenames are case sensitive, the list of
+<p>Because GNU/Linux and Macintosh filenames are case sensitive, the list of
file extensions is case sensitive on those platforms. The Windows
platform is not case sensitive.
</p>
<p>You are not required to include <code>\DeclareGraphicsExtensions</code> in
your document; the printer driver has a sensible default. For example,
-the most recent <samp>pdftex.def</samp> has the extension list
-&lsquo;<samp><code>.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2</code></samp>&rsquo;.
+the most recent <samp>pdftex.def</samp> has this extension list.
</p>
-<p>You can use this command in the preamble or in the document body. You
-can use it more than once. For debugging, show its value with
+<div class="example">
+<pre class="example">.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2
+</pre></div>
+
+<p>You can use this command anywhere in the document. You can use it more
+than once. Show its value with
<code>\makeatletter\typeout{\Gin@extensions}\makeatother</code>.
</p>
@@ -13732,7 +17852,7 @@ can use it more than once. For debugging, show its value with
<a name="g_t_005cDeclareGraphicsRule"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cDeclareGraphicsExtensions" accesskey="p" rel="prev">\DeclareGraphicsExtensions</a>, Up: <a href="#Graphics-package-configuration" accesskey="u" rel="up">Graphics package configuration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cDeclareGraphicsExtensions" accesskey="p" rel="prev">\DeclareGraphicsExtensions</a>, Up: <a href="#Graphics-package-configuration" accesskey="u" rel="up">Graphics package configuration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cDeclareGraphicsRule-1"></a>
<h4 class="subsection">22.2.3 <code>\DeclareGraphicsRule</code></h4>
@@ -13825,7 +17945,7 @@ See the documentation for your TeX distribution.
<a name="Commands-for-graphics"></a>
<div class="header">
<p>
-Previous: <a href="#Graphics-package-configuration" accesskey="p" rel="prev">Graphics package configuration</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Graphics-package-configuration" accesskey="p" rel="prev">Graphics package configuration</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Commands-for-graphics-1"></a>
<h3 class="section">22.3 Commands for graphics</h3>
@@ -13852,7 +17972,7 @@ Previous: <a href="#Graphics-package-configuration" accesskey="p" rel="prev">Gra
<a name="g_t_005cincludegraphics"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005crotatebox" accesskey="n" rel="next">\rotatebox</a>, Up: <a href="#Commands-for-graphics" accesskey="u" rel="up">Commands for graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005crotatebox" accesskey="n" rel="next">\rotatebox</a>, Up: <a href="#Commands-for-graphics" accesskey="u" rel="up">Commands for graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cincludegraphics-1"></a>
<h4 class="subsection">22.3.1 <code>\includegraphics</code></h4>
@@ -13908,8 +18028,8 @@ centered and at its nominal size. You can also give a path to the file,
as with <code>\includegraphics{graphics/plot.pdf}</code>. To specify a list
of locations to search for the file, see <a href="#g_t_005cgraphicspath">\graphicspath</a>.
</p>
-<p>If your filename includes spaces then put it in double quotes, as with
-<code>\includegraphics{&quot;sister picture.jpg&quot;}</code>.
+<p>If your filename includes spaces then put it in double quotes. An example
+is <code>\includegraphics{&quot;sister picture.jpg&quot;}</code>.
</p>
<p>The <code>\includegraphics{<var>filename</var>}</code> command decides on the
type of graphic by splitting <var>filename</var> on the first dot. You can
@@ -13947,7 +18067,7 @@ caption.
...
\begin{center}
\includegraphics{pix/nix.png}
- \captionof{figure}{The spirit of the night} \label{pix:nix} % if you want a caption
+ \captionof{figure}{The spirit of the night} \label{pix:nix} % optional
\end{center}
</pre></div>
@@ -13955,8 +18075,7 @@ caption.
text, with the two vertically centered.
</p>
<div class="example">
-<pre class="example">\newcommand*{\vcenteredhbox}[1]{\begingroup
- \setbox0=\hbox{#1}\parbox{\wd0}{\box0}\endgroup}
+<pre class="example">\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
...
\begin{center}
\vcenteredhbox{\includegraphics[width=0.4\textwidth]{plot}}
@@ -14007,6 +18126,7 @@ page it puts together boxes and this is the box allocated for the
graphic.
</p>
<dl compact="compact">
+<dd><a name="includegraphics-width"></a></dd>
<dt><code>width</code></dt>
<dd><p>The graphic will be shown so its bounding box is this width. An example
is <code>\includegraphics[width=1in]{plot}</code>. You can use the standard
@@ -14019,40 +18139,43 @@ the width of the text with
</p>
</dd>
<dt><code>height</code></dt>
-<dd><p>The graphic will be shown so its bounding box is this height. You can
+<dd><a name="includegraphics-height"></a><p>The graphic will be shown so its bounding box is this height. You can
use the standard TeX dimensions (see <a href="#Units-of-length">Units of length</a>), and also
-convenient are <code>\pageheight</code> and <code>\textheight</code> (see <a href="#Page-layout-parameters">Page layout parameters</a>). For instance,
+convenient are <code>\pageheight</code> and <code>\textheight</code> (see <a href="#Page-layout-parameters">Page layout parameters</a>). For instance, the command
<code>\includegraphics[height=0.25\textheight]{godel}</code> will make the
-graphic be a quarter of the height of the text area.
+graphic a quarter of the height of the text area.
</p>
</dd>
<dt><code>totalheight</code></dt>
-<dd><p>The graphic will be shown so its bounding box has this height plus
+<dd><a name="includegraphics-totalheght"></a><p>The graphic will be shown so its bounding box has this height plus
depth. This differs from the height if the graphic was rotated. For
instance, if it has been rotated by -90 then it will have zero height
but a large depth.
</p>
</dd>
<dt><code>keepaspectratio</code></dt>
-<dd><p>If set to <code>true</code>, or just specified as with
-<code>\includegraphics[...,keepaspectratio,...]{...}</code> and you give as
-options both <code>width</code> and <code>height</code> (or <code>totalheight</code>),
-then LaTeX will make the graphic is as large as possible without
-distortion. That is, LaTeX will ensure that neither is the graphic
-wider than <code>width</code> nor taller than <code>height</code> (or
+<dd><a name="includegraphics-keepaspectratio"></a><p>If set to <code>true</code>, or just specified as here
+</p>
+<div class="example">
+<pre class="example"><code>\includegraphics[...,keepaspectratio,...]{...}</code>
+</pre></div>
+
+<p>and you give as options both <code>width</code> and <code>height</code> (or
+<code>totalheight</code>), then LaTeX will make the graphic is as large as
+possible without distortion. That is, LaTeX will ensure that neither
+is the graphic wider than <code>width</code> nor taller than <code>height</code> (or
<code>totalheight</code>).
</p>
</dd>
<dt><code>scale</code></dt>
-<dd><p>Factor by which to scale the graphic. Specifying
-<code>\includegraphics[scale=2.0]{...}</code> makes the graphic twice its
-nominal size. This number may be any value; a number between 1
-and&nbsp;0 will shrink the graphic and a negative number will reflect
-it.
+<dd><p>Factor by which to scale the graphic. To make a graphic twice its
+nominal size, enter <code>\includegraphics[scale=2.0]{...}</code>. This
+number may be any value; a number between 1 and&nbsp;0 will shrink the
+graphic and a negative number will reflect it.
</p>
</dd>
<dt><code>angle</code></dt>
-<dd><p>Rotate the picture. The angle is taken in degrees and counterclockwise.
+<dd><p>Rotate the graphic. The angle is taken in degrees and counterclockwise.
The graphic is rotated about its <code>origin</code>; see that option. For a
complete description of how rotated material is typeset,
see <a href="#g_t_005crotatebox">\rotatebox</a>.
@@ -14062,9 +18185,9 @@ see <a href="#g_t_005crotatebox">\rotatebox</a>.
<dd><p>The point of the graphic about which the rotation happens. Possible
values are any string containing one or two of: <code>l</code> for left,
<code>r</code> for right, <code>b</code> for bottom, <code>c</code> for center, <code>t</code>
-for top, and <code>B</code> for baseline. Thus,
+for top, and <code>B</code> for baseline. Thus, entering the command
<code>\includegraphics[angle=180,origin=c]{moon}</code> will turn the
-picture upside down from the center, while
+picture upside down about that picture&rsquo;s center, while the command
<code>\includegraphics[angle=180,origin=lB]{LeBateau}</code> will turn its
picture upside down about its left baseline. (The character <code>c</code>
gives the horizontal center in <code>bc</code> or <code>tc</code>, but gives the
@@ -14078,6 +18201,7 @@ vertical center in <code>lc</code> or <code>rc</code>.) The default is <code>lB
<p>These are lesser-used options.
</p>
<dl compact="compact">
+<dd><a name="includegraphics-viewport"></a></dd>
<dt><code>viewport</code></dt>
<dd><p>Pick out a subregion of the graphic to show. Takes four arguments,
separated by spaces and given in TeX dimensions, as with
@@ -14086,7 +18210,7 @@ dimensions default to big points,&nbsp;<code>bp</code>. They are taken
relative to the origin specified by the bounding box. See also the
<code>trim</code> option.
</p>
-</dd>
+<a name="includegraphics-trim"></a></dd>
<dt><code>trim</code></dt>
<dd><p>Gives parts of the graphic to not show. Takes four arguments, separated
by spaces, that are given in TeX dimensions, as with
@@ -14096,20 +18220,24 @@ will crop the picture by 0&nbsp;inches on the left, 0.1&nbsp;inches on
the bottom, 0.2&nbsp;inches on the right, and 0.3&nbsp;inches on the
top. See also the <code>viewport</code> option.
</p>
-</dd>
+<a name="includegraphics-clip"></a></dd>
<dt><code>clip</code></dt>
-<dd><p>If set to <code>true</code>, or just specified as with
-<code>\includegraphics[...,clip,...]{...}</code>, then the graphic is
-cropped to the bounding box. You can get this effect by instead using
-the starred form of the command, as
+<dd><p>If set to <code>true</code>, or just specified as here
+</p>
+<div class="example">
+<pre class="example">\includegraphics[...,clip,...]{...}
+</pre></div>
+
+<p>then the graphic is cropped to the bounding box. This is the same as
+using the starred form of the command,
<code>\includegraphics*[...]{...}</code>.
</p>
-</dd>
+<a name="includegraphics-page"></a></dd>
<dt><code>page</code></dt>
<dd><p>Give the page number of a multi-page PDF file. The default is
<code>page=1</code>.
</p>
-</dd>
+<a name="includegraphics-pagebox"></a></dd>
<dt><code>pagebox</code></dt>
<dd><p>Specifies which bounding box to use for PDF files from among
<code>mediabox</code>, <code>cropbox</code>, <code>bleedbox</code>, <code>trimbox</code>, or
@@ -14124,25 +18252,32 @@ content. The driver will set the image size based on CropBox if
present, otherwise it will not use one of the others, with a
driver-defined order of preference. MediaBox is always present.
</p>
-</dd>
+<a name="includegraphics-interpolate"></a></dd>
<dt><code>interpolate</code></dt>
<dd><p>Enable or disable interpolation of raster images by the viewer. Can be
-set with <code>interpolate=true</code> or just specified as with
-<code>\includegraphics[...,interpolate,...]{...}</code>.
+set with <code>interpolate=true</code> or just specified as here.
</p>
-</dd>
+<div class="example">
+<pre class="example">\includegraphics[...,interpolate,...]{...}
+</pre></div>
+
+<a name="includegraphics-quiet"></a></dd>
<dt><code>quiet</code></dt>
<dd><p>Do not write information to the log. You can set it with
<code>quiet=true</code> or just specified it with
<code>\includegraphics[...,quite,...]{...}</code>,
</p>
-</dd>
+<a name="includegraphics-draft"></a></dd>
<dt><code>draft</code></dt>
-<dd><p>If you set it with <code>draft=true</code> or just specified it with
-<code>\includegraphics[...,draft,...]{...}</code>, then the graphic will not
-appear in the document, possibly saving color printer ink. Instead,
-LaTeX will put an empty box of the correct size with the filename
-printed in it.
+<dd><p>If you set it with <code>draft=true</code> or just specify it with
+</p>
+<div class="example">
+<pre class="example">\includegraphics[...,draft,...]{...}
+</pre></div>
+
+<p>then the graphic will not appear in the document, possibly saving color
+printer ink. Instead, LaTeX will put an empty box of the correct
+size with the filename printed in it.
</p>
</dd>
</dl>
@@ -14158,6 +18293,7 @@ For example, if an <samp>.eps</samp> file has the line <code>%%BoundingBox 10
60/72&nbsp;inch tall.
</p>
<dl compact="compact">
+<dd><a name="includegraphics-bb"></a></dd>
<dt><code>bb</code></dt>
<dd><p>Specify the bounding box of the displayed region. The argument is four
dimensions separated by spaces, as with <code>\includegraphics[.., bb=
@@ -14166,26 +18302,34 @@ BoundingBox numbers from the EPS file automatically, so this option is
only useful if the bounding box is missing from that file or if you want
to change it.
</p>
-</dd>
+<a name="includegraphics-bbllx"></a><a name="includegraphics-bblly"></a><a name="includegraphics-bburx"></a><a name="includegraphics-bbury"></a></dd>
<dt><code>bbllx, bblly, bburx, bbury</code></dt>
<dd><p>Set the bounding box. These four are obsolete, but are retained for
compatibility with old packages.
</p>
-</dd>
+<a name="includegraphics-natwidth"></a><a name="includegraphics-natheight"></a></dd>
<dt><code>natwidth, natheight</code></dt>
<dd><p>An alternative for <code>bb</code>. Setting
-<code>\includegraphics[...,natwidth=1in,natheight=0.618in,...]{...}</code>
-is the same as setting <code>bb=0 0 1in 0.618in</code>.
+</p>
+<div class="example">
+<pre class="example">\includegraphics[...,natwidth=1in,natheight=0.618in,...]{...}
+</pre></div>
+
+<p>is the same as setting <code>bb=0 0 1in 0.618in</code>.
</p>
-</dd>
+<a name="includegraphics-hiresbb"></a></dd>
<dt><code>hiresbb</code></dt>
<dd><p>If set to <code>true</code>, or just specified as with
-<code>\includegraphics[...,hiresbb,...]{...}</code>, then LaTeX will look
-for <code>%%HiResBoundingBox</code> lines instead of <code>%%BoundingBox</code>
-lines. (The <code>BoundingBox</code> lines use only natural numbers while the
-<code>HiResBoundingBox</code> lines use decimals; both use units equivalent to
-TeX&rsquo;s big points, 1/72&nbsp;inch.) To override a prior setting of
-<code>true</code>, you can set it to <code>false</code>.
+</p>
+<div class="example">
+<pre class="example">\includegraphics[...,hiresbb,...]{...}
+</pre></div>
+
+<p>then LaTeX will look for <code>%%HiResBoundingBox</code> lines instead of
+<code>%%BoundingBox</code> lines. (The <code>BoundingBox</code> lines use only
+natural numbers while the <code>HiResBoundingBox</code> lines use decimals;
+both use units equivalent to TeX&rsquo;s big points, 1/72&nbsp;inch.) To
+override a prior setting of <code>true</code>, you can set it to <code>false</code>.
</p>
</dd>
</dl>
@@ -14197,23 +18341,26 @@ will read the file <samp>lion.xxx</samp> as though it were
<samp>lion.png</samp>. For more on these, see <a href="#g_t_005cDeclareGraphicsRule">\DeclareGraphicsRule</a>.
</p>
<dl compact="compact">
+<dd><a name="includegraphics-type"></a></dd>
<dt><code>type</code></dt>
<dd><p>Specify the graphics type.
</p>
-</dd>
+<a name="includegraphics-ext"></a></dd>
<dt><code>ext</code></dt>
<dd><p>Specify the graphics extension.
Only use this in conjunction with the option <code>type</code>.
</p>
-</dd>
+<a name="includegraphics-read"></a></dd>
<dt><code>read</code></dt>
<dd><p>Specify the file extension of the read file.
Only use this in conjunction with the option <code>type</code>.
</p>
-</dd>
+<a name="includegraphics-command"></a></dd>
<dt><code>command</code></dt>
-<dd><p>Specify a command to be applied to this file.
-Only use this in conjunction with the option <code>type</code>.
+<dd><p>Specify a command to be applied to this file. Only use this in
+conjunction with the option <code>type</code>. See <a href="#Command-line-options">Command line options</a>
+for a discussion of enabling the <code>\write18</code> functionality to run
+external commands.
</p>
</dd>
</dl>
@@ -14223,7 +18370,7 @@ Only use this in conjunction with the option <code>type</code>.
<a name="g_t_005crotatebox"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cscalebox" accesskey="n" rel="next">\scalebox</a>, Previous: <a href="#g_t_005cincludegraphics" accesskey="p" rel="prev">\includegraphics</a>, Up: <a href="#Commands-for-graphics" accesskey="u" rel="up">Commands for graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cscalebox" accesskey="n" rel="next">\scalebox</a>, Previous: <a href="#g_t_005cincludegraphics" accesskey="p" rel="prev">\includegraphics</a>, Up: <a href="#Commands-for-graphics" accesskey="u" rel="up">Commands for graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005crotatebox-1"></a>
<h4 class="subsection">22.3.2 <code>\rotatebox</code></h4>
@@ -14246,7 +18393,8 @@ Next: <a href="#g_t_005cscalebox" accesskey="n" rel="next">\scalebox</a>, Previo
\rotatebox[<var>key-value list</var>]{<var>angle</var>}{<var>material</var>}
</pre></div>
-<p>Put <var>material</var> in a box and rotate it <var>angle</var> degrees counterclockwise.
+<p>Put <var>material</var> in a box and rotate it <var>angle</var> degrees
+counterclockwise.
</p>
<p>This example rotates the table column heads forty five degrees.
</p>
@@ -14283,15 +18431,20 @@ except for the <code>x</code> and <code>y</code> options (see <a href="#g_t_005c
<dl compact="compact">
<dt><code>origin</code></dt>
<dd><p>The point of the <var>material</var>&rsquo;s box about which the rotation happens.
-Possible values are any string containing one or two of: <code>l</code> for
+Possible value is any string containing one or two of: <code>l</code> for
left, <code>r</code> for right, <code>b</code> for bottom, <code>c</code> for center,
-<code>t</code> for top, and <code>B</code> for baseline. Thus,
-<code>\includegraphics[angle=180,origin=c]{moon}</code> will turn the
-picture upside down from the center, while
-<code>\includegraphics[angle=180,origin=lB]{LeBateau}</code> will turn its
-picture upside down about its left baseline. (The character <code>c</code>
-gives the horizontal center in <code>bc</code> or <code>tc</code> but gives the
-vertical center in <code>lc</code> or <code>rc</code>.) The default is <code>lB</code>.
+<code>t</code> for top, and <code>B</code> for baseline. Thus, the first line here
+</p>
+<div class="example">
+<pre class="example">\includegraphics[angle=180,origin=c]{moon}
+\includegraphics[angle=180,origin=lB]{LeBateau}
+</pre></div>
+
+<p>will turn the picture upside down from the center while the second will
+turn its picture upside down about its left baseline. (The character
+<code>c</code> gives the horizontal center in <code>bc</code> or <code>tc</code> but gives
+the vertical center in <code>lc</code> or <code>rc</code>.) The default is
+<code>lB</code>.
</p>
</dd>
<dt><code>x, y</code></dt>
@@ -14314,7 +18467,7 @@ setting <code>units=6.283185</code> changes to radians counterclockwise.
<a name="g_t_005cscalebox"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cresizebox" accesskey="n" rel="next">\resizebox</a>, Previous: <a href="#g_t_005crotatebox" accesskey="p" rel="prev">\rotatebox</a>, Up: <a href="#Commands-for-graphics" accesskey="u" rel="up">Commands for graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cresizebox" accesskey="n" rel="next">\resizebox</a>, Previous: <a href="#g_t_005crotatebox" accesskey="p" rel="prev">\rotatebox</a>, Up: <a href="#Commands-for-graphics" accesskey="u" rel="up">Commands for graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cscalebox-1"></a>
<h4 class="subsection">22.3.3 <code>\scalebox</code></h4>
@@ -14348,10 +18501,14 @@ first text and doubles the size of the second.
<p>If you do not specify the optional <var>vertical factor</var> then it
defaults to the same value as the <var>horizontal factor</var>.
</p>
-<p>You can use this command to resize a graphic, as with
-<code>\scalebox{0.5}{\includegraphics{lion}}</code>. If you use the
-<samp>graphicx</samp> package then you can accomplish the same thing with
-optional arguments to <code>\includegraphics</code>
+<p>You can use this command to resize a graphic, as here.
+</p>
+<div class="example">
+<pre class="example">\scalebox{0.5}{\includegraphics{lion}}
+</pre></div>
+
+<p>If you use the <samp>graphicx</samp> package then you can accomplish the same
+thing with optional arguments to <code>\includegraphics</code>
(see <a href="#g_t_005cincludegraphics">\includegraphics</a>).
</p>
<p>The <code>\reflectbox</code> command abbreviates
@@ -14364,7 +18521,7 @@ immediately followed by its mirror reflection.
<a name="g_t_005cresizebox"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cscalebox" accesskey="p" rel="prev">\scalebox</a>, Up: <a href="#Commands-for-graphics" accesskey="u" rel="up">Commands for graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cscalebox" accesskey="p" rel="prev">\scalebox</a>, Up: <a href="#Commands-for-graphics" accesskey="u" rel="up">Commands for graphics</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cresizebox-1"></a>
<h4 class="subsection">22.3.4 <code>\resizebox</code></h4>
@@ -14412,7 +18569,7 @@ text two inches wide but keep the original height with
<a name="Special-insertions"></a>
<div class="header">
<p>
-Next: <a href="#Splitting-the-input" accesskey="n" rel="next">Splitting the input</a>, Previous: <a href="#Graphics" accesskey="p" rel="prev">Graphics</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Splitting-the-input" accesskey="n" rel="next">Splitting the input</a>, Previous: <a href="#Graphics" accesskey="p" rel="prev">Graphics</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Special-insertions-1"></a>
<h2 class="chapter">23 Special insertions</h2>
@@ -14447,7 +18604,7 @@ special meaning do not correspond to simple characters you can type.
<a name="Reserved-characters"></a>
<div class="header">
<p>
-Next: <a href="#Upper-and-lower-case" accesskey="n" rel="next">Upper and lower case</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Upper-and-lower-case" accesskey="n" rel="next">Upper and lower case</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Reserved-characters-1"></a>
<h3 class="section">23.1 Reserved characters</h3>
@@ -14456,8 +18613,8 @@ Next: <a href="#Upper-and-lower-case" accesskey="n" rel="next">Upper and lower c
<a name="index-characters_002c-reserved"></a>
<a name="index-special-characters"></a>
<a name="index-characters_002c-special"></a>
-<p>LaTeX sets aside the following characters for special purposes (for
-example, the percent sign&nbsp;<code>%</code> is for comments) so they are
+<p>LaTeX sets aside the following characters for special purposes. For
+example, the percent sign&nbsp;<code>%</code> is for comments. They are
called <em>reserved characters</em> or <em>special characters</em>.
</p>
<div class="example">
@@ -14474,7 +18631,7 @@ called <em>reserved characters</em> or <em>special characters</em>.
<p>If you want a reserved character to be printed as itself, in the text
body font, for all but the final three characters in that list simply
put a backslash&nbsp;<code>\</code> in front of the character. Thus,
-<code>\$1.23</code> will produce&nbsp;<code>$1.23</code> in your output.
+typing <code>\$1.23</code> will produce&nbsp;<code>$1.23</code> in your output.
</p>
<a name="index-_005c_007e"></a>
<a name="index-_005c_005e"></a>
@@ -14482,11 +18639,12 @@ put a backslash&nbsp;<code>\</code> in front of the character. Thus,
<p>As to the last three characters, to get a tilde in the text body font
use <code>\~{}</code> (omitting the curly braces would result in the next
character receiving a tilde accent). Similarly, to get a get a text
-body font circumflex use <code>\^{}</code>. A text body font backslash
-results from <code>\textbackslash{}</code>.
+body font circumflex use <code>\^{}</code>. To get a backslash in the font
+of the text body, enter <code>\textbackslash{}</code>.
</p>
<p>To produce the reserved characters in a typewriter font use
-<code>\verb!!</code>, as below.
+<code>\verb!!</code> as below (the double backslash&nbsp;<code>\\</code> is only
+there to split the lines).
</p>
<div class="example">
<pre class="example">\begin{center}
@@ -14495,22 +18653,19 @@ results from <code>\textbackslash{}</code>.
\end{center}
</pre></div>
-<p>In that example the double backslash&nbsp;<code>\\</code> is only there to
-split the lines.
-</p>
<hr>
<a name="Upper-and-lower-case"></a>
<div class="header">
<p>
-Next: <a href="#Symbols-by-font-position" accesskey="n" rel="next">Symbols by font position</a>, Previous: <a href="#Reserved-characters" accesskey="p" rel="prev">Reserved characters</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Symbols-by-font-position" accesskey="n" rel="next">Symbols by font position</a>, Previous: <a href="#Reserved-characters" accesskey="p" rel="prev">Reserved characters</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Upper-and-lower-case-1"></a>
<h3 class="section">23.2 Upper and lower case</h3>
-<a name="index-Upper-case"></a>
-<a name="index-Lower-case"></a>
-<a name="index-characters_002c-case"></a>
+<a name="index-uppercase"></a>
+<a name="index-lowercase"></a>
+<a name="index-characters_002c-case-of"></a>
<p>Synopsis:
</p>
@@ -14571,7 +18726,7 @@ standard LaTeX commands <code>\MakeUppercase</code> and
<a name="Symbols-by-font-position"></a>
<div class="header">
<p>
-Next: <a href="#Text-symbols" accesskey="n" rel="next">Text symbols</a>, Previous: <a href="#Upper-and-lower-case" accesskey="p" rel="prev">Upper and lower case</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Text-symbols" accesskey="n" rel="next">Text symbols</a>, Previous: <a href="#Upper-and-lower-case" accesskey="p" rel="prev">Upper and lower case</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Symbols-by-font-position-1"></a>
<h3 class="section">23.3 Symbols by font position</h3>
@@ -14595,7 +18750,7 @@ example could also be written as <code>\symbol{'40}</code> or
<a name="Text-symbols"></a>
<div class="header">
<p>
-Next: <a href="#Accents" accesskey="n" rel="next">Accents</a>, Previous: <a href="#Symbols-by-font-position" accesskey="p" rel="prev">Symbols by font position</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Accents" accesskey="n" rel="next">Accents</a>, Previous: <a href="#Symbols-by-font-position" accesskey="p" rel="prev">Symbols by font position</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Text-symbols-1"></a>
<h3 class="section">23.4 Text symbols</h3>
@@ -14604,9 +18759,10 @@ Next: <a href="#Accents" accesskey="n" rel="next">Accents</a>, Previous: <a href
<a name="index-symbols_002c-text"></a>
<a name="index-textcomp-package-1"></a>
-<p>LaTeX provides commands to generate a number of non-letter symbols
-in running text. Some of these, especially the more obscure ones, are
-not available in OT1; you may need to load the <code>textcomp</code> package.
+<p>LaTeX provides commands to generate a number of non-letter symbols in
+running text. Some of these, especially the more obscure ones, are not
+available in OT1. Unless you are using XeLaTeX or LuaLaTeX then
+you may need to load the <code>textcomp</code> package.
</p>
<dl compact="compact">
<dt><code>\copyright</code>
@@ -14616,21 +18772,21 @@ not available in OT1; you may need to load the <code>textcomp</code> package.
<a name="index-_005ctextcopyright"></a>
</dt>
<dd><a name="index-copyright-symbol"></a>
-<p>The copyright symbol, &copy;.
+<p>&copy; The copyright symbol.
</p>
</dd>
<dt><code>\dag</code>
<a name="index-_005cdag"></a>
</dt>
<dd><a name="index-dagger_002c-in-text"></a>
-<p>The dagger symbol (in text).
+<p>&#x2020; The dagger symbol (in text).
</p>
</dd>
<dt><code>\ddag</code>
<a name="index-_005cddag"></a>
</dt>
<dd><a name="index-double-dagger_002c-in-text"></a>
-<p>The double dagger symbol (in text).
+<p>&#x2021; The double dagger symbol (in text).
</p>
</dd>
<dt><code>\LaTeX</code>
@@ -14669,12 +18825,12 @@ not available in OT1; you may need to load the <code>textcomp</code> package.
<a name="index-single-angle-quotation-marks"></a>
<a name="index-French-quotation-marks"></a>
<a name="index-quotation-marks_002c-French"></a>
-<p>Double and single angle quotation marks, commonly used in French:
-&laquo;, &raquo;, &lsaquo;, &rsaquo;.
+<p>&laquo;, &raquo;, &lsaquo;, &rsaquo;
+Double and single angle quotation marks, commonly used in French.
</p>
</dd>
<dt><code>\ldots</code>
-<a name="index-_005cldots"></a>
+<a name="index-_005cldots-1"></a>
</dt>
<dt><code>\dots</code>
<a name="index-_005cdots"></a>
@@ -14683,7 +18839,7 @@ not available in OT1; you may need to load the <code>textcomp</code> package.
<a name="index-_005ctextellipsis"></a>
</dt>
<dd><a name="index-ellipsis"></a>
-<p>An ellipsis (three dots at the baseline): &lsquo;&hellip;&rsquo;. <code>\ldots</code>
+<p>&hellip; An ellipsis (three dots at the baseline): <code>\ldots</code>
and <code>\dots</code> also work in math mode.
</p>
</dd>
@@ -14692,7 +18848,7 @@ and <code>\dots</code> also work in math mode.
</dt>
<dd><a name="index-left-quote"></a>
<a name="index-opening-quote"></a>
-<p>Left (opening) quote: &lsquo;.
+<p>&lsquo; Left (opening) quote.
</p>
</dd>
<dt><code>\P</code>
@@ -14703,7 +18859,7 @@ and <code>\dots</code> also work in math mode.
</dt>
<dd><a name="index-paragraph-symbol"></a>
<a name="index-pilcrow"></a>
-<p>Paragraph sign (pilcrow): &#x00B6;.
+<p>&#x00B6; Paragraph sign (pilcrow).
</p>
</dd>
<dt><code>\pounds</code>
@@ -14714,7 +18870,7 @@ and <code>\dots</code> also work in math mode.
</dt>
<dd><a name="index-pounds-symbol"></a>
<a name="index-sterling-symbol"></a>
-<p>English pounds sterling: &pound;.
+<p>&pound; English pounds sterling.
</p>
</dd>
<dt><code>\quotedblbase <span class="roman">(&bdquo;)</span></code>
@@ -14726,8 +18882,8 @@ and <code>\dots</code> also work in math mode.
<dd><a name="index-double-low_002d9-quotation-mark"></a>
<a name="index-single-low_002d9-quotation-mark"></a>
<a name="index-low_002d9-quotation-marks_002c-single-and-double"></a>
-<p>Double and single quotation marks on the baseline:
-&bdquo; and &sbquo;.
+<p>&bdquo; and &sbquo;
+Double and single quotation marks on the baseline.
</p>
</dd>
<dt><code>\rq</code>
@@ -14735,15 +18891,17 @@ and <code>\dots</code> also work in math mode.
</dt>
<dd><a name="index-right-quote"></a>
<a name="index-closing-quote"></a>
-<p>Right (closing) quote: &rsquo;.
+<p>&rsquo; Right (closing) quote.
</p>
</dd>
<dt><code>\S</code>
<a name="index-_005cS"></a>
</dt>
-<dd><p>\itemx \textsection
-<a name="index-section-symbol"></a>
-Section sign: &#x00A7;.
+<dt><code>\textsection</code>
+<a name="index-_005ctextsection"></a>
+</dt>
+<dd><a name="index-section-symbol"></a>
+<p>&#x00A7; Section sign.
</p>
</dd>
<dt><code>\TeX</code>
@@ -14759,7 +18917,7 @@ Section sign: &#x00A7;.
</dt>
<dd><a name="index-circumflex_002c-ASCII_002c-in-text"></a>
<a name="index-ASCII-circumflex_002c-in-text"></a>
-<p>ASCII circumflex: ^.
+<p>^ ASCII circumflex.
</p>
</dd>
<dt><code>\textasciitilde</code>
@@ -14767,7 +18925,7 @@ Section sign: &#x00A7;.
</dt>
<dd><a name="index-tilde_002c-ASCII_002c-in-text"></a>
<a name="index-ASCII-tilde_002c-in-text"></a>
-<p>ASCII tilde: ~.
+<p>~ ASCII tilde.
</p>
</dd>
<dt><code>\textasteriskcentered</code>
@@ -14775,14 +18933,14 @@ Section sign: &#x00A7;.
</dt>
<dd><a name="index-asterisk_002c-centered_002c-in-text"></a>
<a name="index-centered-asterisk_002c-in-text"></a>
-<p>Centered asterisk: *.
+<p>* Centered asterisk.
</p>
</dd>
<dt><code>\textbackslash</code>
<a name="index-_005ctextbackslash-1"></a>
</dt>
<dd><a name="index-backslash_002c-in-text"></a>
-<p>Backslash: \.
+<p>\ Backslash.
</p>
</dd>
<dt><code>\textbar</code>
@@ -14790,7 +18948,7 @@ Section sign: &#x00A7;.
</dt>
<dd><a name="index-vertical-bar_002c-in-text"></a>
<a name="index-bar_002c-vertical_002c-in-text"></a>
-<p>Vertical bar: |.
+<p>| Vertical bar.
</p>
</dd>
<dt><code>\textbardbl</code>
@@ -14799,7 +18957,7 @@ Section sign: &#x00A7;.
<dd><a name="index-vertical-bar_002c-double_002c-in-text"></a>
<a name="index-bar_002c-double-vertical_002c-in-text"></a>
<a name="index-double-vertical-bar_002c-in-text"></a>
-<p>Double vertical bar.
+<p>&#x23F8; Double vertical bar.
</p>
</dd>
<dt><code>\textbigcircle</code>
@@ -14807,7 +18965,7 @@ Section sign: &#x00A7;.
</dt>
<dd><a name="index-big-circle-symbols_002c-in-text"></a>
<a name="index-circle-symbol_002c-big_002c-in-text"></a>
-<p>Big circle symbol.
+<p>&#x25EF; Big circle symbol.
</p>
</dd>
<dt><code>\textbraceleft</code>
@@ -14815,7 +18973,7 @@ Section sign: &#x00A7;.
</dt>
<dd><a name="index-left-brace_002c-in-text"></a>
<a name="index-brace_002c-left_002c-in-text"></a>
-<p>Left brace: {.
+<p>{ Left brace.
</p>
</dd>
<dt><code>\textbraceright</code>
@@ -14823,21 +18981,21 @@ Section sign: &#x00A7;.
</dt>
<dd><a name="index-right-brace_002c-in-text"></a>
<a name="index-brace_002c-right_002c-in-text"></a>
-<p>Right brace: }.
+<p>} Right brace.
</p>
</dd>
<dt><code>\textbullet</code>
<a name="index-_005ctextbullet"></a>
</dt>
<dd><a name="index-bullet_002c-in-text"></a>
-<p>Bullet: &bull;.
+<p>&bull; Bullet.
</p>
</dd>
<dt><code>\textcircled{<var>letter</var>}</code>
<a name="index-_005ctextcircled_007bletter_007d"></a>
</dt>
<dd><a name="index-circled-letter_002c-in-text"></a>
-<p><var>letter</var> in a circle, as in &reg;.
+<p>&#x24B6; Circle around <var>letter</var>.
</p>
</dd>
<dt><code>\textcompwordmark</code>
@@ -14852,16 +19010,18 @@ Section sign: &#x00A7;.
<dd><a name="index-composite-word-mark_002c-in-text"></a>
<a name="index-cap-height"></a>
<a name="index-ascender-height"></a>
-<p>Composite word mark (invisible). The <code>\textcapital...</code> form
-has the cap height of the font, while the <code>\textascender...</code> form
-has the ascender height.
+<p>Used to separate letters that would normally ligature. For example,
+<code>f\textcompwordmark i</code> produces &lsquo;<samp>fi</samp>&rsquo; without a ligature. This
+is most useful in non-English languages. The
+<code>\textcapitalcompwordmark</code> form has the cap height of the font
+while the <code>\textascendercompwordmark</code> form has the ascender height.
</p>
</dd>
<dt><code>\textdagger</code>
<a name="index-_005ctextdagger"></a>
</dt>
<dd><a name="index-dagger_002c-in-text-1"></a>
-<p>Dagger: <em>\dag</em>.
+<p>&#x2020; Dagger.
</p>
</dd>
<dt><code>\textdaggerdbl</code>
@@ -14869,7 +19029,7 @@ has the ascender height.
</dt>
<dd><a name="index-dagger_002c-double_002c-in-text"></a>
<a name="index-double-dagger_002c-in-text-1"></a>
-<p>Double dagger: <em>\ddag</em>.
+<p>&#x2021; Double dagger.
</p>
</dd>
<dt><code>\textdollar <span class="roman">(or <code>\$</code>)</span></code>
@@ -14877,21 +19037,23 @@ has the ascender height.
</dt>
<dd><a name="index-dollar-sign"></a>
<a name="index-currency_002c-dollar"></a>
-<p>Dollar sign: $.
+<p>$ Dollar sign.
</p>
</dd>
<dt><code>\textemdash <span class="roman">(or <code>---</code>)</span></code>
<a name="index-_005ctextemdash-_0028or-_002d_002d_002d_0029"></a>
</dt>
<dd><a name="index-em_002ddash"></a>
-<p>Em-dash: &mdash; (for punctuation).
+<p>&mdash; Em-dash (used for punctuation, as in
+<code>The playoffs --- if you are fortunate enough to make the playoffs ---
+is more like a sprint.</code>).
</p>
</dd>
<dt><code>\textendash <span class="roman">(or <code>--</code>)</span></code>
<a name="index-_005ctextendash-_0028or-_002d_002d_0029"></a>
</dt>
<dd><a name="index-e_002ddash"></a>
-<p>En-dash: &ndash; (for ranges).
+<p>&ndash; En-dash (used for ranges, as in <code>See pages 12--14</code>).
</p>
</dd>
<dt><code>\texteuro</code>
@@ -14899,28 +19061,33 @@ has the ascender height.
</dt>
<dd><a name="index-euro-symbol"></a>
<a name="index-currency_002c-euro"></a>
-<p>The Euro symbol: &euro;.
+<a name="index-package_002c-eurosym"></a>
+<a name="index-eurosym-package"></a>
+
+<p>The Euro symbol: &euro;. For an alternative glyph design, try the
+<samp>eurosym</samp> package; also, most fonts nowadays come with their own
+Euro symbol (Unicode U+20AC).
</p>
</dd>
<dt><code>\textexclamdown <span class="roman">(or <code>!`</code>)</span></code>
<a name="index-_005ctextexclamdown-_0028or-_0021_0060_0029"></a>
</dt>
<dd><a name="index-exclamation-point_002c-upside_002ddown"></a>
-<p>Upside down exclamation point: &iexcl;.
+<p>&iexcl; Upside down exclamation point.
</p>
</dd>
<dt><code>\textgreater</code>
<a name="index-_005ctextgreater"></a>
</dt>
<dd><a name="index-greater-than-symbol_002c-in-text"></a>
-<p>Greater than: &gt;.
+<p>&gt; Greater than symbol.
</p>
</dd>
<dt><code>\textless</code>
<a name="index-_005ctextless"></a>
</dt>
<dd><a name="index-less-than-symbol_002c-in-text"></a>
-<p>Less than: &lt;.
+<p>&lt; Less than symbol.
</p>
</dd>
<dt><code>\textleftarrow</code>
@@ -14928,7 +19095,7 @@ has the ascender height.
</dt>
<dd><a name="index-arrow_002c-left_002c-in-text"></a>
<a name="index-left-arrow_002c-in-text"></a>
-<p>Left arrow.
+<p>&#x2190; Left arrow.
</p>
</dd>
<dt><code>\textordfeminine</code>
@@ -14941,7 +19108,7 @@ has the ascender height.
<a name="index-masculine-ordinal-symbol"></a>
<a name="index-ordinals_002c-feminine-and-masculine"></a>
<a name="index-Spanish-ordinals_002c-feminine-and-masculine"></a>
-<p>Feminine and masculine ordinal symbols: &ordf;, &ordm;.
+<p>&ordf;, &ordm; Feminine and masculine ordinal symbols.
</p>
</dd>
<dt><code>\textperiodcentered</code>
@@ -14949,14 +19116,14 @@ has the ascender height.
</dt>
<dd><a name="index-period_002c-centered_002c-in-text"></a>
<a name="index-centered-period_002c-in-text"></a>
-<p>Centered period: &#x00B7;.
+<p>&#x00B7; Centered period.
</p>
</dd>
<dt><code>\textquestiondown <span class="roman">(or <code>?`</code>)</span></code>
<a name="index-_005ctextquestiondown-_0028or-_003f_0060_0029"></a>
</dt>
<dd><a name="index-question-mark_002c-upside_002ddown"></a>
-<p>Upside down question mark: &iquest;.
+<p>&iquest; Upside down question mark.
</p>
</dd>
<dt><code>\textquotedblleft <span class="roman">(or <code>``</code>)</span></code>
@@ -14964,7 +19131,7 @@ has the ascender height.
</dt>
<dd><a name="index-left-quote_002c-double"></a>
<a name="index-double-left-quote"></a>
-<p>Double left quote: &ldquo;.
+<p>&ldquo; Double left quote.
</p>
</dd>
<dt><code>\textquotedblright <span class="roman">(or <code>''</code>)</span></code>
@@ -14972,7 +19139,7 @@ has the ascender height.
</dt>
<dd><a name="index-right-quote_002c-double"></a>
<a name="index-double-right-quote"></a>
-<p>Double right quote: &rdquo;.
+<p>&rdquo; Double right quote.
</p>
</dd>
<dt><code>\textquoteleft <span class="roman">(or <code>`</code>)</span></code>
@@ -14980,7 +19147,7 @@ has the ascender height.
</dt>
<dd><a name="index-left-quote_002c-single"></a>
<a name="index-single-left-quote"></a>
-<p>Single left quote: &lsquo;.
+<p>&lsquo; Single left quote.
</p>
</dd>
<dt><code>\textquoteright <span class="roman">(or <code>'</code>)</span></code>
@@ -14988,7 +19155,7 @@ has the ascender height.
</dt>
<dd><a name="index-right-quote_002c-single"></a>
<a name="index-single-right-quote"></a>
-<p>Single right quote: &rsquo;.
+<p>&rsquo; Single right quote.
</p>
</dd>
<dt><code>\textquotesingle</code>
@@ -14997,7 +19164,7 @@ has the ascender height.
<dd><a name="index-quote_002c-single-straight"></a>
<a name="index-straight-single-quote"></a>
<a name="index-single-quote_002c-straight"></a>
-<p>Straight single quote. (From TS1 encoding.)
+<p>&#x0027; Straight single quote. (From TS1 encoding.)
</p>
</dd>
<dt><code>\textquotestraightbase</code>
@@ -15017,7 +19184,7 @@ has the ascender height.
<a name="index-_005ctextregistered"></a>
</dt>
<dd><a name="index-registered-symbol"></a>
-<p>Registered symbol: &reg;.
+<p>&reg; Registered symbol.
</p>
</dd>
<dt><code>\textrightarrow</code>
@@ -15025,7 +19192,7 @@ has the ascender height.
</dt>
<dd><a name="index-arrow_002c-right_002c-in-text"></a>
<a name="index-right-arrow_002c-in-text"></a>
-<p>Right arrow.
+<p>&#x2192; Right arrow.
</p>
</dd>
<dt><code>\textthreequartersemdash</code>
@@ -15033,14 +19200,14 @@ has the ascender height.
</dt>
<dd><a name="index-three_002dquarters-em_002ddash"></a>
<a name="index-em_002ddash_002c-three_002dquarters"></a>
-<p>&ldquo;Three-quarters&rdquo; em-dash, between en-dash and em-dash.
+<p>&#xFE58; &ldquo;Three-quarters&rdquo; em-dash, between en-dash and em-dash.
</p>
</dd>
<dt><code>\texttrademark</code>
<a name="index-_005ctexttrademark"></a>
</dt>
<dd><a name="index-trademark-symbol"></a>
-<p>Trademark symbol: &#x2122;.
+<p>&#x2122; Trademark symbol.
</p>
</dd>
<dt><code>\texttwelveudash</code>
@@ -15048,21 +19215,21 @@ has the ascender height.
</dt>
<dd><a name="index-two_002dthirds-em_002ddash"></a>
<a name="index-em_002ddash_002c-two_002dthirds"></a>
-<p>&ldquo;Two-thirds&rdquo; em-dash, between en-dash and em-dash.
+<p>&#xFE58; &ldquo;Two-thirds&rdquo; em-dash, between en-dash and em-dash.
</p>
</dd>
<dt><code>\textunderscore</code>
<a name="index-_005ctextunderscore"></a>
</dt>
<dd><a name="index-underscore_002c-in-text"></a>
-<p>Underscore: _.
+<p>_ Underscore.
</p>
</dd>
<dt><code>\textvisiblespace</code>
<a name="index-_005ctextvisiblespace"></a>
</dt>
<dd><a name="index-visible-space-symbol_002c-in-text"></a>
-<p>Visible space symbol.
+<p>&#x2423; Visible space symbol.
</p>
</dd>
</dl>
@@ -15072,7 +19239,7 @@ has the ascender height.
<a name="Accents"></a>
<div class="header">
<p>
-Next: <a href="#Additional-Latin-letters" accesskey="n" rel="next">Additional Latin letters</a>, Previous: <a href="#Text-symbols" accesskey="p" rel="prev">Text symbols</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Additional-Latin-letters" accesskey="n" rel="next">Additional Latin letters</a>, Previous: <a href="#Text-symbols" accesskey="p" rel="prev">Text symbols</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Accents-1"></a>
<h3 class="section">23.5 Accents</h3>
@@ -15081,17 +19248,32 @@ Next: <a href="#Additional-Latin-letters" accesskey="n" rel="next">Additional La
<a name="index-characters_002c-accented"></a>
<a name="index-letters_002c-accented"></a>
-<a name="index-package_002c-babel-1"></a>
-<a name="index-babel-package-1"></a>
+<a name="index-package_002c-babel-2"></a>
+<a name="index-babel-package-2"></a>
+
+<a name="index-package_002c-polyglossia"></a>
+<a name="index-polyglossia-package"></a>
<a name="index-multilingual-support"></a>
-<p>LaTeX has wide support for many of the world&rsquo;s scripts and
-languages, through the <code>babel</code> package and related support. This
-section does not attempt to cover all that support. It merely lists
-the core LaTeX commands for creating accented characters.
-</p>
-<p>The <code>\capital...</code> commands produce alternative forms for use with
-capital letters. These are not available with OT1.
+<p>LaTeX has wide support for many of the world&rsquo;s scripts and languages,
+through the <code>babel</code> package and related support if you are using
+pdfLaTeX, or <samp>polyglossia</samp> if you are using XeLaTeX or
+LuaLaTeX. This section does not cover that support. It only lists
+the core LaTeX commands for creating accented characters. The
+<code>\capital...</code> commands shown here produce alternative forms for use
+with capital letters. These are not available with OT1.
+</p>
+<p>Below, to make them easier to find, the accents are all illustrated with
+lowercase &lsquo;<samp>o</samp>&rsquo;.
+</p>
+<a name="index-_005ci-_0028dotless-i_0029"></a>
+<a name="index-dotless-i"></a>
+<p>Note that <code>\i</code> produces a dotless i,
+<a name="index-_005cj-_0028dotless-j_0029"></a>
+<a name="index-dotless-j"></a>
+and <code>\j</code> produces a dotless j.
+These are often used in place of their dotted counterparts when they are
+accented.
</p>
<dl compact="compact">
<dt><code>\&quot;</code></dt>
@@ -15100,7 +19282,7 @@ capital letters. These are not available with OT1.
<a name="index-_005ccapitaldieresis"></a>
<a name="index-umlaut-accent"></a>
<a name="index-dieresis-accent"></a>
-<p>Produces an umlaut (dieresis), as in &ouml;.
+<p>&ouml; Umlaut (dieresis).
</p>
</dd>
<dt><code>\'</code></dt>
@@ -15108,16 +19290,14 @@ capital letters. These are not available with OT1.
<dd><a name="index-_005c_0027-_0028acute-accent_0029"></a>
<a name="index-_005ccapitalacute"></a>
<a name="index-acute-accent"></a>
-<p>Produces an acute accent, as in &oacute;. In the <code>tabbing</code>
-environment, pushes current column to the right of the previous column
-(see <a href="#tabbing">tabbing</a>).
+<p>&oacute; Acute accent.
</p>
</dd>
<dt><code>\.</code></dt>
<dd><a name="index-_005c_002e-_0028dot_002dover-accent_0029"></a>
<a name="index-dot-accent"></a>
<a name="index-dot_002dover-accent"></a>
-<p>Produces a dot accent over the following, as in &#559;.
+<p>&#559; Dot accent.
</p>
</dd>
<dt><code>\=</code></dt>
@@ -15127,7 +19307,7 @@ environment, pushes current column to the right of the previous column
<a name="index-macron-accent"></a>
<a name="index-overbar-accent"></a>
<a name="index-bar_002dover-accent"></a>
-<p>Produces a macron (overbar) accent over the following, as in &#333;.
+<p>&#333; Macron (overbar) accent.
</p>
</dd>
<dt><code>\^</code></dt>
@@ -15136,7 +19316,7 @@ environment, pushes current column to the right of the previous column
<a name="index-_005ccapitalcircumflex"></a>
<a name="index-circumflex-accent"></a>
<a name="index-hat-accent"></a>
-<p>Produces a circumflex (hat) accent over the following, as in &ocirc;.
+<p>&ocirc; Circumflex (hat) accent.
</p>
</dd>
<dt><code>\`</code></dt>
@@ -15144,9 +19324,7 @@ environment, pushes current column to the right of the previous column
<dd><a name="index-_005c_0060-_0028grave-accent_0029"></a>
<a name="index-_005ccapitalgrave"></a>
<a name="index-grave-accent"></a>
-<p>Produces a grave accent over the following, as in &ograve;. In the
-<code>tabbing</code> environment, move following text to the right margin
-(see <a href="#tabbing">tabbing</a>).
+<p>&ograve; Grave accent.
</p>
</dd>
<dt><code>\~</code></dt>
@@ -15154,14 +19332,21 @@ environment, pushes current column to the right of the previous column
<dd><a name="index-_005c_007e-_0028tilde-accent_0029"></a>
<a name="index-_005ccapitaltilde"></a>
<a name="index-tilde-accent"></a>
-<p>Produces a tilde accent over the following, as in &ntilde;.
+<p>&ntilde; Tilde accent.
</p>
</dd>
<dt><code>\b</code></dt>
<dd><a name="index-_005cb-_0028bar_002dunder-accent_0029"></a>
<a name="index-bar_002dunder-accent"></a>
-<p>Produces a bar accent under the following, as in o_. See
-also <code>\underbar</code> hereinafter.
+<p>o_ Bar accent underneath.
+</p>
+<a name="index-_005cunderbar"></a>
+<a name="index-underbar"></a>
+<p>Related to this, <code>\underbar{<var>text</var>}</code> produces a bar under
+<var>text</var>. The argument is always processed in LR mode
+(see <a href="#Modes">Modes</a>). The bar is always a fixed position under the baseline,
+thus crossing through descenders. See also <code>\underline</code> in
+<a href="#Math-miscellany">Math miscellany</a>.
</p>
</dd>
<dt><code>\c</code></dt>
@@ -15169,7 +19354,7 @@ also <code>\underbar</code> hereinafter.
<dd><a name="index-_005cc-_0028cedilla-accent_0029"></a>
<a name="index-_005ccapitalcedilla"></a>
<a name="index-cedilla-accent"></a>
-<p>Produces a cedilla accent under the following, as in &ccedil;.
+<p>&ccedil; Cedilla accent underneath.
</p>
</dd>
<dt><code>\d</code></dt>
@@ -15177,7 +19362,7 @@ also <code>\underbar</code> hereinafter.
<dd><a name="index-_005cd-_0028dot_002dunder-accent_0029"></a>
<a name="index-_005ccapitaldotaccent"></a>
<a name="index-dot_002dunder-accent"></a>
-<p>Produces a dot accent under the following, as in &#7885;.
+<p>&#7885; Dot accent underneath.
</p>
</dd>
<dt><code>\H</code></dt>
@@ -15185,19 +19370,7 @@ also <code>\underbar</code> hereinafter.
<dd><a name="index-_005cH-_0028Hungarian-umlaut-accent_0029"></a>
<a name="index-_005ccapitalhungarumlaut"></a>
<a name="index-hungarian-umlaut-accent"></a>
-<p>Produces a long Hungarian umlaut accent over the following, as in &#337;.
-</p>
-</dd>
-<dt><code>\i</code></dt>
-<dd><a name="index-_005ci-_0028dotless-i_0029"></a>
-<a name="index-dotless-i"></a>
-<p>Produces a dotless i, as in &lsquo;i&rsquo;.
-</p>
-</dd>
-<dt><code>\j</code></dt>
-<dd><a name="index-_005cj-_0028dotless-j_0029"></a>
-<a name="index-dotless-j"></a>
-<p>Produces a dotless j, as in &lsquo;j&rsquo;.
+<p>&#337; Long Hungarian umlaut accent.
</p>
</dd>
<dt><code>\k</code></dt>
@@ -15205,8 +19378,7 @@ also <code>\underbar</code> hereinafter.
<dd><a name="index-_005ck-_0028ogonek_0029"></a>
<a name="index-_005ccapitalogonek"></a>
<a name="index-ogonek"></a>
-<p>Produces a letter with ogonek, as in &lsquo;&#491;&rsquo;. Not available in
-the OT1 encoding.
+<p>&#491; Ogonek. Not available in the OT1 encoding.
</p>
</dd>
<dt><code>\r</code></dt>
@@ -15214,7 +19386,7 @@ the OT1 encoding.
<dd><a name="index-_005cr-_0028ring-accent_0029"></a>
<a name="index-_005ccapitalring"></a>
<a name="index-ring-accent"></a>
-<p>Produces a ring accent, as in &lsquo;o*&rsquo;.
+<p>o* Ring accent.
</p>
</dd>
<dt><code>\t</code></dt>
@@ -15226,8 +19398,8 @@ the OT1 encoding.
<a name="index-_005cnewtie"></a>
<a name="index-_005ccapitalnewtie"></a>
<a name="index-tie_002dafter-accent"></a>
-<p>Produces a tie-after accent, as in &lsquo;oo[&rsquo;. The
-<code>\newtie</code> form is centered in its box.
+<p>oo[ Tie-after accent. The <code>\newtie</code> form is centered in
+its box.
</p>
</dd>
<dt><code>\u</code></dt>
@@ -15235,17 +19407,7 @@ the OT1 encoding.
<dd><a name="index-_005cu-_0028breve-accent_0029"></a>
<a name="index-_005ccapitalbreve"></a>
<a name="index-breve-accent"></a>
-<p>Produces a breve accent, as in &lsquo;&#335;&rsquo;.
-</p>
-</dd>
-<dt><code>\underbar</code></dt>
-<dd><a name="index-_005cunderbar"></a>
-<a name="index-underbar"></a>
-<p>Not exactly an accent, this produces a bar under the argument text.
-The argument is always processed in horizontal mode. The bar is
-always a fixed position under the baseline, thus crossing through
-descenders. See also <code>\underline</code> in <a href="#Math-miscellany">Math miscellany</a>.
-See also <code>\b</code> above.
+<p>&#335; Breve accent.
</p>
</dd>
<dt><code>\v</code></dt>
@@ -15255,7 +19417,7 @@ See also <code>\b</code> above.
<a name="index-hacek-accent"></a>
<a name="index-check-accent"></a>
<a name="index-caron-accent"></a>
-<p>Produces a h&aacute;&#269;ek (check, caron) accent, as in &lsquo;&#466;&rsquo;.
+<p>&#466; H&aacute;&#269;ek (check, caron) accent.
</p>
</dd>
</dl>
@@ -15265,7 +19427,7 @@ See also <code>\b</code> above.
<a name="Additional-Latin-letters"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005crule" accesskey="n" rel="next">\rule</a>, Previous: <a href="#Accents" accesskey="p" rel="prev">Accents</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005crule" accesskey="n" rel="next">\rule</a>, Previous: <a href="#Accents" accesskey="p" rel="prev">Accents</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Additional-Latin-letters-1"></a>
<h3 class="section">23.6 Additional Latin letters</h3>
@@ -15277,8 +19439,8 @@ Next: <a href="#g_t_005crule" accesskey="n" rel="next">\rule</a>, Previous: <a h
<a name="index-non_002dEnglish-characters"></a>
<a name="index-characters_002c-non_002dEnglish"></a>
-<p>Here are the basic LaTeX commands for inserting letters (beyond
-A&ndash;Z) extending the Latin alphabet, used primarily in languages other
+<p>Here are the basic LaTeX commands for inserting letters beyond
+A&ndash;Z that extend the Latin alphabet, used primarily in languages other
than English.
</p>
<dl compact="compact">
@@ -15384,58 +19546,89 @@ font encoding, such as <small>T1</small>.
<a name="g_t_005crule"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005ctoday" accesskey="n" rel="next">\today</a>, Previous: <a href="#Additional-Latin-letters" accesskey="p" rel="prev">Additional Latin letters</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005ctoday" accesskey="n" rel="next">\today</a>, Previous: <a href="#Additional-Latin-letters" accesskey="p" rel="prev">Additional Latin letters</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005crule-1"></a>
<h3 class="section">23.7 <code>\rule</code></h3>
<a name="index-_005crule"></a>
-<p>Synopsis:
+<p>Synopsis, one of:
</p>
<div class="example">
-<pre class="example">\rule[<var>raise</var>]{<var>width</var>}{<var>thickness</var>}
+<pre class="example">\rule{<var>width</var>}{<var>thickness</var>}
+\rule[<var>raise</var>]{<var>width</var>}{<var>thickness</var>}
</pre></div>
-<p>The <code>\rule</code> command produces <em>rules</em>, that is, lines or
-rectangles. The arguments are:
+<p>Produce a <em>rule</em>, a filled-in rectangle.
</p>
-<dl compact="compact">
-<dt><var>raise</var></dt>
-<dd><p>How high to raise the rule (optional).
+<a name="index-Halmos-symbol"></a>
+<a name="index-tombstone"></a>
+<p>This produces a rectangular blob, sometimes called a Halmos symbol,
+often used to mark the end of a proof.
</p>
-</dd>
-<dt><var>width</var></dt>
-<dd><p>The length of the rule (mandatory).
+<div class="example">
+<pre class="example">\newcommand{\qedsymbol}{\rule{0.4em}{2ex}}
+</pre></div>
+
+<a name="index-package_002c-amsthm-1"></a>
+<a name="index-amsthm-package-1"></a>
+
+<p>The <samp>amsthm</samp> package includes this command, with a somewhat
+different-looking symbol.
</p>
-</dd>
-<dt><var>thickness</var></dt>
-<dd><p>The thickness of the rule (mandatory).
-</p></dd>
-</dl>
+<p>The mandatory arguments give the horizontal <var>width</var> and vertical
+<var>thickness</var> of the rectangle. They are rigid lengths
+(see <a href="#Lengths">Lengths</a>). The optional argument <var>raise</var> is also a rigid
+length, and tells LaTeX how much to raise the rule above the
+baseline, or lower it if the length is negative.
+</p>
+<p>This produces a line, a rectangle that is wide but not tall.
+</p>
+<div class="example">
+<pre class="example">\noindent\rule{\textwidth}{0.4pt}
+</pre></div>
+<p>The line is the width of the page and 0.4&nbsp;points tall. This line
+thickness is common in LaTeX.
+</p>
+<p>A rule that has zero width, or zero thickness, will not show up in the
+output, but can cause LaTeX to change the output around it.
+See <a href="#g_t_005cstrut">\strut</a> for examples.
+</p>
<hr>
<a name="g_t_005ctoday"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005crule" accesskey="p" rel="prev">\rule</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005crule" accesskey="p" rel="prev">\rule</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005ctoday-1"></a>
<h3 class="section">23.8 <code>\today</code></h3>
<a name="index-_005ctoday"></a>
<a name="index-date_002c-today_0027s"></a>
+<a name="index-today_0027s-date"></a>
-<p>The <code>\today</code> command produces today&rsquo;s date, in the format
-&lsquo;<samp><var>month</var> <var>dd</var>, <var>yyyy</var></samp>&rsquo;; for example, &lsquo;<samp>July 4, 1976</samp>&rsquo;.
-It uses the predefined counters <code>\day</code>, <code>\month</code>, and
-<code>\year</code> (see <a href="#g_t_005cday-_005cmonth-_005cyear">\day \month \year</a>) to do this. It is not
-updated as the program runs.
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\today
+</pre></div>
+
+<p>Produce today&rsquo;s date in the format &lsquo;<samp><var>month</var> <var>dd</var>,
+<var>yyyy</var></samp>&rsquo;. An example of a date in that format is &lsquo;<samp>July 4,
+1976</samp>&rsquo;.
</p>
-<p>Multilingual packages like <samp>babel</samp> or classes like <samp>lettre</samp>,
-among others, will localize <code>\today</code>. For example, the following
-will output &lsquo;<samp>4 juillet 1976</samp>&rsquo;:
+<a name="index-package_002c-babel-3"></a>
+<a name="index-babel-package-3"></a>
+
+<a name="index-package_002c-polyglossia-1"></a>
+<a name="index-polyglossia-package-1"></a>
+
+<p>Multilingual packages such as <samp>babel</samp> or <samp>polyglossia</samp>, or
+classes such as <samp>lettre</samp>, will localize <code>\today</code>. For example,
+the following will output &lsquo;<samp>4 juillet 1976</samp>&rsquo;:
</p>
<div class="example">
<pre class="example">\year=1976 \month=7 \day=4
@@ -15446,18 +19639,24 @@ will output &lsquo;<samp>4 juillet 1976</samp>&rsquo;:
\end{document}
</pre></div>
+<p><code>\today</code> uses the counters <code>\day</code>, <code>\month</code>, and
+<code>\year</code> (see <a href="#g_t_005cday-_0026-_005cmonth-_0026-_005cyear">\day &amp; \month &amp; \year</a>).
+</p>
<a name="index-package_002c-datetime"></a>
<a name="index-datetime-package"></a>
-<p>The <code>datetime</code> package, among others, can produce a wide variety
-of other date formats.
+<p>A number of package on CTAN work with dates. One is <samp>datetime</samp> package
+which can produce a wide variety of date formats, including ISO standards.
+</p>
+<p>The date is not updated as the LaTeX process runs, so in principle the
+date could be incorrect by the time the program finishes.
</p>
<hr>
<a name="Splitting-the-input"></a>
<div class="header">
<p>
-Next: <a href="#Front_002fback-matter" accesskey="n" rel="next">Front/back matter</a>, Previous: <a href="#Special-insertions" accesskey="p" rel="prev">Special insertions</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Front_002fback-matter" accesskey="n" rel="next">Front/back matter</a>, Previous: <a href="#Special-insertions" accesskey="p" rel="prev">Special insertions</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Splitting-the-input-1"></a>
<h2 class="chapter">24 Splitting the input</h2>
@@ -15465,90 +19664,258 @@ Next: <a href="#Front_002fback-matter" accesskey="n" rel="next">Front/back matte
<a name="index-splitting-the-input-file"></a>
<a name="index-input-file"></a>
-<p>A large document requires a lot of input. Rather than putting the whole
-input in a single large file, it&rsquo;s more efficient to split it into
-several smaller ones. Regardless of how many separate files you use,
-there is one that is the
+<p>LaTeX lets you split a large document into several smaller ones.
+This can simplify editing or allow multiple authors to work on the
+document. It can also speed processing.
+</p>
+<p>Regardless of how many separate files you use, there is always one
<a name="index-root-file"></a>
<a name="index-file_002c-root"></a>
-<em>root file</em>; it is the one whose name you type
-when you run LaTeX.
+<em>root file</em>, on which LaTeX compilation starts. This shows such
+a file with five included files.
</p>
-<p>See <a href="#filecontents">filecontents</a>, for an environment that allows bundling an
-external file to be created with the main document.
+<div class="example">
+<pre class="example">\documentclass{book}
+\includeonly{ % comment out lines below to omit compiling
+ pref,
+ chap1,
+ chap2,
+ append,
+ bib
+ }
+\begin{document}
+\frontmatter
+\include{pref}
+\mainmatter
+\include{chap1}
+\include{chap2}
+\appendix
+\include{append}
+\backmatter
+\include{bib}
+\end{document}
+</pre></div>
+
+<p>This will bring in material from <samp>pref.tex</samp>, <samp>chap1.tex</samp>,
+<samp>chap2.tex</samp>, <samp>append.tex</samp>, and <samp>bib.tex</samp>. If you compile
+this file, and then comment out all of the lines inside
+<code>\includeonly{...}</code> except for <code>chap1,</code> and compile again,
+then LaTeX will only process the material in the first chapter.
+Thus, your output will appear more quickly and be shorter to print.
+However, the advantage of the <code>\includeonly</code> command is that
+LaTeX will retain the page numbers and all of the cross reference
+information from the other parts of the document so these will appear in
+your output correctly.
+</p>
+<p>See <a href="#Larger-book-template">Larger book template</a> for another example of <code>\includeonly</code>.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cinclude" accesskey="1">\include</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Conditionally include a file.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cendinput" accesskey="1">\endinput</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Stop including material from a file.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_005cincludeonly" accesskey="2">\includeonly</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Determine which files are included.
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cinclude-_0026-_005cincludeonly" accesskey="2">\include &amp; \includeonly</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Conditionally include files.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#g_t_005cinput" accesskey="3">\input</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Unconditionally include a file.
</td></tr>
</table>
+
<hr>
-<a name="g_t_005cinclude"></a>
+<a name="g_t_005cendinput"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cincludeonly" accesskey="n" rel="next">\includeonly</a>, Up: <a href="#Splitting-the-input" accesskey="u" rel="up">Splitting the input</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cinclude-_0026-_005cincludeonly" accesskey="n" rel="next">\include &amp; \includeonly</a>, Up: <a href="#Splitting-the-input" accesskey="u" rel="up">Splitting the input</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cinclude-1"></a>
-<h3 class="section">24.1 <code>\include</code></h3>
+<a name="g_t_005cendinput-1"></a>
+<h3 class="section">24.1 <code>\endinput</code></h3>
-<a name="index-_005cinclude"></a>
+<a name="index-_005cendinput"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\include{<var>file</var>}
+<pre class="example">\endinput
</pre></div>
-<p>If no <code>\includeonly</code> command is present, the <code>\include</code>
-command executes <code>\clearpage</code> to start a new page
-(see <a href="#g_t_005cclearpage">\clearpage</a>), then reads <var>file</var>, then does another
-<code>\clearpage</code>.
+<p>When you <code>\include{filename}</code>, inside <samp>filename.tex</samp> the
+material after <code>\endinput</code> will not be included. This command is
+optional; if <samp>filename.tex</samp> has no <code>\endinput</code> then LaTeX
+will read all of the file.
</p>
-<p>Given an <code>\includeonly</code> command, the <code>\include</code> actions are
-only run if <var>file</var> is listed as an argument to
-<code>\includeonly</code>. See <a href="#g_t_005cincludeonly">\includeonly</a>.
+<p>For example, suppose that a document&rsquo;s root file has
+<code>\input{chap1}</code> and this is <samp>chap1.tex</samp>.
</p>
-<a name="index-nested-_005cinclude_002c-not-allowed"></a>
-<p>The <code>\include</code> command may not appear in the preamble or in a file
-read by another <code>\include</code> command.
+<div class="example">
+<pre class="example">\chapter{One}
+This material will appear in the document.
+\endinput
+This will not appear.
+</pre></div>
+
+<p>This can be useful for putting documentation or comments at the end of a
+file, or for avoiding junk characters that can be added during mailing.
+It is also useful for debugging: one strategy to localize errors is to
+put <code>\endinput</code> halfway through the included file and see if the
+error disappears. Now, knowing which half contains the error, moving
+<code>\endinput</code> to halfway through that area further narrows down the
+location. This process rapidly finds the offending line.
+</p>
+<p>After reading <code>\endinput</code>, LaTeX continues to read to the end of
+the line, so something can follow this command and be read nonetheless.
+This allows you, for instance, to close an <code>\if...</code> with a
+<code>\fi</code>.
</p>
<hr>
-<a name="g_t_005cincludeonly"></a>
+<a name="g_t_005cinclude-_0026-_005cincludeonly"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cinput" accesskey="n" rel="next">\input</a>, Previous: <a href="#g_t_005cinclude" accesskey="p" rel="prev">\include</a>, Up: <a href="#Splitting-the-input" accesskey="u" rel="up">Splitting the input</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cinput" accesskey="n" rel="next">\input</a>, Previous: <a href="#g_t_005cendinput" accesskey="p" rel="prev">\endinput</a>, Up: <a href="#Splitting-the-input" accesskey="u" rel="up">Splitting the input</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cincludeonly-1"></a>
-<h3 class="section">24.2 <code>\includeonly</code></h3>
+<a name="g_t_005cinclude-_0026-_005cincludeonly-1"></a>
+<h3 class="section">24.2 <code>\include</code> &amp; <code>\includeonly</code></h3>
+<a name="index-_005cinclude"></a>
<a name="index-_005cincludeonly"></a>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\includeonly{<var>file1</var>,<var>file2</var>,...}
+<pre class="example">\includeonly{ % in document preamble
+ ...
+ <var>filename</var>,
+ ...
+ }
+ ...
+\include{<var>filename</var>} % in document body
+</pre></div>
+
+<p>Bring material from the external file <samp><var>filename</var>.tex</samp> into a
+LaTeX document.
+</p>
+<p>The <code>\include</code> command does three things: it executes
+<code>\clearpage</code> (see <a href="#g_t_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</a>), then it
+inputs the material from <samp><var>filename</var>.tex</samp> into the document,
+and then it does another <code>\clearpage</code>. This command can only
+appear in the document body. The <code>\includeonly</code> command controls
+which files will be read by LaTeX under subsequent <code>\include</code>
+commands. Its list of filenames is comma-separated, and it can only
+appear in the preamble.
+</p>
+<p>This example root document, <samp>constitution.tex</samp>, brings in
+three files, <samp>preamble.tex</samp>, <samp>articles.tex</samp>, and
+<samp>amendments.tex</samp>.
+</p>
+<div class="example">
+<pre class="example">\documentclass{book}
+\includeonly{
+ preamble,
+ articles,
+ amendments
+ }
+\begin{document}
+\include{preamble}
+\include{articles}
+\include{amendments}
+\end{document}
+</pre></div>
+
+<p>The file <samp>preamble.tex</samp> contains no special code; you have just
+excerpted the chapter from <samp>consitution.tex</samp> and put it in a
+separate file just for editing convenience.
+</p>
+<div class="example">
+<pre class="example">\chapter{Preamble}
+We the People of the United States,
+in Order to form a more perfect Union, ...
</pre></div>
-<p>The <code>\includeonly</code> command controls which files will be read by
-subsequent <code>\include</code> commands. The list of filenames is
-comma-separated. Each element <var>file1</var>, <var>file2</var>, &hellip; must
-exactly match a filename specified in a <code>\include</code> command for the
-selection to be effective.
+<p>Running LaTeX on <samp>constitution.tex</samp> makes the material from the
+three files appear in the document but also generates the auxiliary
+files <samp>preamble.aux</samp>, <samp>articles.aux</samp>, and
+<samp>amendments.tex</samp>. These contain information such as page numbers
+and cross-references (see <a href="#Cross-references">Cross references</a>). If you now comment out
+<code>\includeonly</code>&rsquo;s lines with <code>preamble</code> and <code>amendments</code>
+and run LaTeX again then the resulting document shows only the
+material from <samp>articles.tex</samp>, not the material from
+<samp>preamble.tex</samp> or <samp>amendments.tex</samp>. Nonetheless, all of the
+auxiliary information from the omitted files is still there, including
+the starting page number of the chapter.
+</p>
+<p>If the document preamble does not have <code>\includeonly</code> then
+LaTeX will include all the files you call for with <code>\include</code>
+commands.
+</p>
+<p>The <code>\include</code> command makes a new page. To avoid that, see
+<a href="#g_t_005cinput">\input</a> (which, however, does not retain the auxiliary
+information).
</p>
-<p>This command can only appear in the preamble.
+<p>See <a href="#Larger-book-template">Larger book template</a> for another example using <code>\include</code>
+and <code>\includeonly</code>. That example also uses <code>\input</code> for some
+material that will not necessarily start on a new page.
+</p>
+<p>File names can involve paths.
+</p>
+<div class="example">
+<pre class="example">\documentclass{book}
+\includeonly{
+ chapters/chap1,
+ }
+\begin{document}
+\include{chapters/chap1}
+\end{document}
+</pre></div>
+
+<p>To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores. Nevertheless, for the name &lsquo;<samp>amo amas amat</samp>&rsquo;,
+this works under TeX Live on GNU/Linux:
+</p>
+<div class="example">
+<pre class="example">\documentclass{book}
+\includeonly{
+ &quot;amo\space amas\space amat&quot;
+ }
+\begin{document}
+\include{&quot;amo\space amas\space amat&quot;}
+\end{document}
+</pre></div>
+
+<p>and this works under MiKTeX on Windows:
+</p>
+<div class="example">
+<pre class="example">\documentclass{book}
+\includeonly{
+ {&quot;amo amas amat&quot;}
+ }
+\begin{document}
+\include{{&quot;amo amas amat&quot;}}
+\end{document}
+</pre></div>
+
+<a name="index-nested-_005cinclude_002c-not-allowed"></a>
+<p>You cannot use <code>\include</code> inside a file that is being included or
+you get &lsquo;<samp>LaTeX Error: \include cannot be nested.</samp>&rsquo; The
+<code>\include</code> command cannot appear in the document preamble; you will
+get &lsquo;<samp>LaTeX Error: Missing \begin{document}</samp>&rsquo;.
+</p>
+<p>If a file that you <code>\include</code> does not exist, for instance if you
+<code>\include{athiesm}</code> but you meant <code>\include{atheism}</code>,
+then LaTeX does not give you an error but will warn you &lsquo;<samp>No file
+athiesm.tex.</samp>&rsquo; (It will also create <samp>athiesm.aux</samp>.)
+</p>
+<p>If you <code>\include</code> the root file in itself then you first get
+&lsquo;<samp>LaTeX Error: Can be used only in preamble.</samp>&rsquo; Later runs get
+&lsquo;<samp>TeX capacity exceeded, sorry [text input levels=15]</samp>&rsquo;. To fix
+this, you must remove the inclusion <code>\include{root}</code> but also
+delete the file <samp><var>root</var>.aux</samp> and rerun LaTeX.
</p>
<hr>
<a name="g_t_005cinput"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005cincludeonly" accesskey="p" rel="prev">\includeonly</a>, Up: <a href="#Splitting-the-input" accesskey="u" rel="up">Splitting the input</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005cinclude-_0026-_005cincludeonly" accesskey="p" rel="prev">\include &amp; \includeonly</a>, Up: <a href="#Splitting-the-input" accesskey="u" rel="up">Splitting the input</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cinput-1"></a>
<h3 class="section">24.3 <code>\input</code></h3>
@@ -15558,79 +19925,202 @@ Previous: <a href="#g_t_005cincludeonly" accesskey="p" rel="prev">\includeonly</
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\input{<var>file</var>}
+<pre class="example">\input{<var>filename</var>}
+</pre></div>
+
+<p>LaTeX processes the file as if its contents were inserted in the
+current file. For a more sophisticated inclusion mechanism see
+<a href="#g_t_005cinclude-_0026-_005cincludeonly">\include &amp; \includeonly</a>.
+</p>
+<p>If <var>filename</var> does not end in &lsquo;<samp>.tex</samp>&rsquo; then LaTeX first tries
+the filename with that extension; this is the usual case. If
+<var>filename</var> ends with &lsquo;<samp>.tex</samp>&rsquo; then LaTeX looks for the
+filename as it is.
+</p>
+<p>For example, this
+</p>
+<div class="example">
+<pre class="example">\input{macros}
</pre></div>
-<p>The <code>\input</code> command causes the specified <var>file</var> to be read
-and processed, as if its contents had been inserted in the current
-file at that point.
+<p>will cause LaTeX to first look for <samp>macros.tex</samp>. If it finds
+that file then it processes its contents as thought they had been
+copy-pasted in. If there is no file of the name <samp>macros.tex</samp> then
+LaTeX tries the name <samp>macros</samp>, without an extension. (This may
+vary by distribution.)
+</p>
+<p>To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores. Nevertheless, for the name &lsquo;<samp>amo amas amat</samp>&rsquo;,
+this works under TeX Live on GNU/Linux:
</p>
-<p>If <var>file</var> does not end in &lsquo;<samp>.tex</samp>&rsquo; (e.g., &lsquo;<samp>foo</samp>&rsquo; or
-&lsquo;<samp>foo.bar</samp>&rsquo;), it is first tried with that extension (&lsquo;<samp>foo.tex</samp>&rsquo;
-or &lsquo;<samp>foo.bar.tex</samp>&rsquo;). If that is not found, the original <var>file</var>
-is tried (&lsquo;<samp>foo</samp>&rsquo; or &lsquo;<samp>foo.bar</samp>&rsquo;).
+<div class="example">
+<pre class="example">\input{&quot;amo\space amas\space amat&quot;}
+</pre></div>
+
+<p>and this works under MiKTeX on Windows:
</p>
+<div class="example">
+<pre class="example">\input{{&quot;amo amas amat&quot;}}
+</pre></div>
+
<hr>
<a name="Front_002fback-matter"></a>
<div class="header">
<p>
-Next: <a href="#Letters" accesskey="n" rel="next">Letters</a>, Previous: <a href="#Splitting-the-input" accesskey="p" rel="prev">Splitting the input</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Letters" accesskey="n" rel="next">Letters</a>, Previous: <a href="#Splitting-the-input" accesskey="p" rel="prev">Splitting the input</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Front_002fback-matter-1"></a>
<h2 class="chapter">25 Front/back matter</h2>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Tables-of-contents" accesskey="1">Tables of contents</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#Table-of-contents-etc_002e" accesskey="1">Table of contents etc.</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Table of contents, list of figures, list of tables.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Glossaries" accesskey="2">Glossaries</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#Indexes" accesskey="2">Indexes</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Generate an index.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Indexes" accesskey="3">Indexes</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#Glossaries" accesskey="3">Glossaries</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Generate a glossary.
</td></tr>
</table>
<hr>
-<a name="Tables-of-contents"></a>
+<a name="Table-of-contents-etc_002e"></a>
<div class="header">
<p>
-Next: <a href="#Glossaries" accesskey="n" rel="next">Glossaries</a>, Up: <a href="#Front_002fback-matter" accesskey="u" rel="up">Front/back matter</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Indexes" accesskey="n" rel="next">Indexes</a>, Up: <a href="#Front_002fback-matter" accesskey="u" rel="up">Front/back matter</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Tables-of-contents-1"></a>
-<h3 class="section">25.1 Tables of contents</h3>
+<a name="Table-of-contents-etc_002e-1"></a>
+<h3 class="section">25.1 Table of contents etc.</h3>
<a name="index-table-of-contents_002c-creating"></a>
<a name="index-_005ctableofcontents"></a>
<a name="index-_002etoc-file-1"></a>
-<p>A table of contents is produced with the <code>\tableofcontents</code>
-command. You put the command right where you want the table of
-contents to go; LaTeX does the rest for you. A previous run must
-have generated a <samp>.toc</samp> file.
-</p>
-<p>The <code>\tableofcontents</code> command produces a heading, but it does
-not automatically start a new page. If you want a new page after the
-table of contents, write a <code>\newpage</code> command after the
-<code>\tableofcontents</code> command.
-</p>
<a name="index-_005clistoffigures"></a>
<a name="index-_005clistoftables"></a>
<a name="index-_002elof-file-1"></a>
<a name="index-_002elot-file-1"></a>
-<p>The analogous commands <code>\listoffigures</code> and <code>\listoftables</code>
-produce a list of figures and a list of tables (from <samp>.lof</samp> and
-<samp>.lot</samp> files), respectively. Everything works exactly the same
-as for the table of contents.
+
+<p>Synopsis, one of:
</p>
-<a name="index-_005cnofiles"></a>
-<p>The command <code>\nofiles</code> overrides these commands, and
-<em>prevents</em> any of these lists from being generated.
+<div class="example">
+<pre class="example">\tableofcontents
+\listoffigures
+\listoftables
+</pre></div>
+
+<p>Produce a table of contents, or list of figures, or list of tables. Put
+the command in the input file where you want the table or list to
+go. You do not type the entries; for example, typically the table of
+contents entries are automatically generated from the sectioning
+commands <code>\chapter</code>, etc.
+</p>
+<p>This example illustrates the first command, <code>\tableofcontents</code>.
+LaTeX will produce a table of contents on the book&rsquo;s first page.
+</p>
+<div class="example">
+<pre class="example">\documentclass{book}
+% \setcounter{tocdepth}{1}
+\begin{document}
+\tableofcontents\newpage
+ ...
+\chapter{...}
+ ...
+\section{...}
+ ...
+\subsection{...}
+ ...
+\end{document}
+</pre></div>
+
+<p>Uncommenting the second line would cause that table to contain chapter
+and section listings but not subsection listings, because the
+<code>\section</code> command has level&nbsp;1. See <a href="#Sectioning">Sectioning</a> for level
+numbers of the sectioning units. For more on the <code>tocdepth</code>
+see <a href="#Sectioning_002ftocdepth">Sectioning/tocdepth</a>.
+</p>
+<p>Another example of the use of <code>\tableofcontents</code> is in <a href="#Larger-book-template">Larger book template</a>.
+</p>
+<p>If you want a page break after the table of contents, write a
+<code>\newpage</code> command after the <code>\tableofcontents</code> command, as
+above.
+</p>
+<p>To make the table of contents LaTeX stores the information in an
+auxiliary file named <samp><var>root-file</var>.toc</samp> (see <a href="#Splitting-the-input">Splitting the input</a>). For example, this LaTeX file <samp>test.tex</samp>
+</p>
+<div class="example">
+<pre class="example">\documentclass{article}
+\begin{document}
+\tableofcontents\newpage
+\section{First section}
+\subsection{First subsection}
+ ...
+</pre></div>
+
+<p>writes the following line to <samp>test.toc</samp>.
+</p>
+<div class="example">
+<pre class="example">\contentsline {section}{\numberline {1}First section}{2}
+\contentsline {subsection}{\numberline {1.1}First subsection}{2}
+</pre></div>
+
+<p>The <code>section</code> or <code>subsection</code> is the sectioning unit. The
+hook <code>\numberline</code> lets you to change how the information appears
+in the table of contents. Of its two arguments, <code>1</code> or <code>1.1</code>
+is the sectioning unit number and <code>First section</code> or <code>First
+subsection</code> is the title. Finally, <code>2</code> is the page number on which
+the sectioning units start.
+</p>
+<p>One consequence of this auxiliary file storage strategy is that to get the
+contents page correct you must run LaTeX twice, once to store the
+information and once to get it. In particular, the first time that you
+run LaTeX on a new document, the table of contents page will be empty
+except for its &lsquo;<samp>Contents</samp>&rsquo; header. Just run it again.
+</p>
+<p>The commands <code>\listoffigures</code> and <code>\listoftables</code> produce a
+list of figures and a list of tables. They work the same way as the
+contents commands; for instance, these work with information stored in
+<samp>.lof</samp> and <samp>.lot</samp> files.
+</p>
+<a name="index-package_002c-babel-4"></a>
+<a name="index-babel-package-4"></a>
+
+<a name="index-package_002c-polyglossia-2"></a>
+<a name="index-polyglossia-package-2"></a>
+
+<p>To change the header for the table of contents page do something like
+the first line here.
+</p>
+<div class="example">
+<pre class="example">\renewcommand{\contentsname}{Table of contents}
+\renewcommand{\listfigurename}{Plots}
+\renewcommand{\listtablename}{Tables}
+</pre></div>
+
+<p>Similarly, the other two lines will do the other two.
+Internationalization packages such as <samp>babel</samp> or <samp>polyglossia</samp>
+will change the headers depending on the chosen base language.
+</p>
+<a name="index-package_002c-tocloft"></a>
+<a name="index-tocloft-package"></a>
+
+<a name="index-package_002c-tocbibbind"></a>
+<a name="index-tocbibbind-package"></a>
+
+<p>CTAN has many packages for the table of contents and lists of figures
+and tables. One convenient one for adjusting some aspects of the
+default, such as spacing, is <samp>tocloft</samp>. And, <samp>tocbibbind</samp>
+will automatically add the bibliography, index, etc. to the table of
+contents.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#g_t_005caddcontentsline" accesskey="1">\addcontentsline</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Add an entry to table of contents, etc.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#g_t_005caddtocontents" accesskey="2">\addtocontents</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Add text directly to table of contents file, etc.
</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cnofiles" accesskey="3">\nofiles</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Prevent writing to auxiliary files.
+</td></tr>
</table>
@@ -15638,7 +20128,7 @@ as for the table of contents.
<a name="g_t_005caddcontentsline"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005caddtocontents" accesskey="n" rel="next">\addtocontents</a>, Up: <a href="#Tables-of-contents" accesskey="u" rel="up">Tables of contents</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005caddtocontents" accesskey="n" rel="next">\addtocontents</a>, Up: <a href="#Table-of-contents-etc_002e" accesskey="u" rel="up">Table of contents etc.</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005caddcontentsline-1"></a>
<h4 class="subsection">25.1.1 <code>\addcontentsline</code></h4>
@@ -15652,28 +20142,69 @@ Next: <a href="#g_t_005caddtocontents" accesskey="n" rel="next">\addtocontents</
<pre class="example">\addcontentsline{<var>ext</var>}{<var>unit</var>}{<var>text</var>}
</pre></div>
-<p>The <code>\addcontentsline</code> command adds an entry to the specified list
-or table where:
+<a name="index-_005ccontentsline"></a>
+<p>Add an entry to the file specified by <var>ext</var>. Usually <var>ext</var> is
+one of <code>toc</code> for the table of contents, <code>lof</code> for the list of
+figures, or <code>lot</code> for the list of tables.
+</p>
+<p>The following will result in an &lsquo;<samp>Appendices</samp>&rsquo; line in the table of
+contents.
+</p>
+<div class="example">
+<pre class="example">\addcontentsline{toc}{section}{\protect\textbf{Appendices}}
+</pre></div>
+
+<p>It will appear at the same indentation level as the sections, will be in
+boldface, and will be assigned the page number associated with the point
+where it appears in the input file.
+</p>
+<p>The <code>\addcontentsline</code> command writes information to the file
+<samp><var>root-name</var>.<var>ext</var></samp>. It writes that information as the
+text of the command
+<code>\contentsline{<var>unit</var>}{<var>text</var>}{<var>num</var>}</code>, where
+<code><var>num</var></code> is the current value of counter <code><var>unit</var></code>. The
+most common case is the table of contents and there <var>num</var> is the
+page number of the first page of <var>unit</var>.
+</p>
+<p>This command is invoked by the sectioning commands <code>\chapter</code>,
+etc., and also by <code>\caption</code> inside a float environment. But it is
+also used by authors. For example, in a book to have the preface
+unnumbered, you may use the starred <code>\chapter*</code>. But that does not
+put in table of contents information, so you can enter it manually, as
+here.
+</p>
+<div class="example">
+<pre class="example">\chapter*{Preface}
+\addcontentsline{toc}{chapter}{\protect\numberline{}Preface}
+</pre></div>
+
+<p>In the <samp>.toc</samp> file LaTeX will put the line <code>\contentsline
+{chapter}{\numberline {}Preface}{3}</code>; note the page number
+&lsquo;<samp>3</samp>&rsquo;.
+</p>
+
+<p>All of the arguments for <code>\addcontentsline</code> are required.
</p>
<dl compact="compact">
<dt><var>ext</var></dt>
-<dd><p>The filename extension of the file on which information is to be written,
-typically one of: <code>toc</code> (table of contents), <code>lof</code> (list of
-figures), or <code>lot</code> (list of tables).
+<dd><p>Typically one of the strings <code>toc</code> for the table of contents,
+<code>lof</code> for the list of figures, or <code>lot</code> for the list of
+tables. The filename extension of the information file.
</p>
</dd>
<dt><var>unit</var></dt>
-<dd><p>The name of the sectional unit being added, typically one of the
-following, matching the value of the <var>ext</var> argument:
+<dd><p>A string that depends on the value of the <var>ext</var> argument:
</p>
<dl compact="compact">
<dt><code>toc</code></dt>
-<dd><p>The name of the sectional unit: <code>part</code>, <code>chapter</code>,
-<code>section</code>, <code>subsection</code>, <code>subsubsection</code>.
-</p></dd>
+<dd><p>For the table of contents, this is the name of a sectional unit:
+<code>part</code>, <code>chapter</code>, <code>section</code>, <code>subsection</code>, etc.
+</p>
+</dd>
<dt><code>lof</code></dt>
<dd><p>For the list of figures: <code>figure</code>.
-</p></dd>
+</p>
+</dd>
<dt><code>lot</code></dt>
<dd><p>For the list of tables: <code>table</code>.
</p></dd>
@@ -15681,154 +20212,850 @@ following, matching the value of the <var>ext</var> argument:
</dd>
<dt><var>text</var></dt>
-<dd><p>The text of the entry.
+<dd><p>The text of the entry. You must <code>\protect</code> any commands that are
+fragile (see <a href="#g_t_005cprotect">\protect</a>).
</p></dd>
</dl>
-<a name="index-_005ccontentsline"></a>
-<p>What is written to the <samp>.<var>ext</var></samp> file is the command
-<code>\contentsline{<var>unit</var>}{<var>text</var>}{<var>num</var>}</code>, where
-<code><var>num</var></code> is the current value of counter <code><var>unit</var></code>.
+<p>The <code>\addcontentsline</code> command has an interaction with
+<code>\include</code> (see <a href="#g_t_005cinclude-_0026-_005cincludeonly">\include &amp; \includeonly</a>). If you use them at
+the same level, as with
+<code>\addcontentsline{...}{...}{...}\include{...}</code> then lines
+in the table of contents can come out in the wrong order. The solution
+is to move <code>\addcontentsline</code> into the file being included.
+</p>
+<p>If you use a <var>unit</var> that LaTeX does not recognize, as here
</p>
+<div class="example">
+<pre class="example">\addcontentsline{toc}{setcion}{\protect\textbf{Appendices}}
+</pre></div>
+<p>then you don&rsquo;t get an error but the formatting in the table of contents
+will not make sense.
+</p>
<hr>
<a name="g_t_005caddtocontents"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005caddcontentsline" accesskey="p" rel="prev">\addcontentsline</a>, Up: <a href="#Tables-of-contents" accesskey="u" rel="up">Tables of contents</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cnofiles" accesskey="n" rel="next">\nofiles</a>, Previous: <a href="#g_t_005caddcontentsline" accesskey="p" rel="prev">\addcontentsline</a>, Up: <a href="#Table-of-contents-etc_002e" accesskey="u" rel="up">Table of contents etc.</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005caddtocontents-1"></a>
<h4 class="subsection">25.1.2 <code>\addtocontents</code></h4>
<a name="index-_005caddtocontents_007bext_007d_007btext_007d"></a>
-<p>The <code>\addtocontents</code>{<var>ext</var>}{<var>text</var>} command adds text
-(or formatting commands) directly to the <samp>.<var>ext</var></samp> file that
-generates the table of contents or lists of figures or tables.
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\addtocontents{<var>ext</var>}{<var>text</var>}
+</pre></div>
+
+<p>Add <var>text</var>, which may be text or formatting commands, directly to
+the auxiliary file with extension <var>ext</var>. This is most commonly used
+for the table of contents so that is the discussion here, but this also
+applies to the list of figures and list of tables.
+</p>
+<p>This will put some vertical space in the table of contents after the
+&lsquo;<samp>Contents</samp>&rsquo; header.
+</p>
+<div class="example">
+<pre class="example">\tableofcontents\newpage
+\addtocontents{toc}{\protect\vspace*{3ex}}
+</pre></div>
+
+<p>The <code>\addtocontents</code> command has two arguments. Both are
+required.
</p>
<dl compact="compact">
<dt><var>ext</var></dt>
-<dd><p>The extension of the file on which information is to be written,
-typically one of: <samp>toc</samp> (table of contents), <samp>lof</samp> (list of
-figures), or <samp>lot</samp> (list of tables).
+<dd><p>Typically one of: <samp>toc</samp> for the table of contents, <samp>lof</samp> for
+the list of figures, or <samp>lot</samp> for the list of tables. The
+extension of the file holding the information.
</p>
</dd>
<dt><var>text</var></dt>
-<dd><p>The text to be written.
+<dd><p>The text, and possibly commands, to be written.
</p></dd>
</dl>
+<p>The sectioning commands such as <code>\chapter</code> use the
+<code>\addcontentsline</code> command to store information. This command
+creates lines in the <samp>.toc</samp> auxiliary file containing the
+<code>\contentsline</code> command (see <a href="#g_t_005caddcontentsline">\addcontentsline</a>). In contrast,
+the command <code>\addtocontents</code> puts material directly in that file.
+</p>
+<p>The <code>\addtocontents</code> command has an interaction with
+<code>\include</code> (see <a href="#g_t_005cinclude-_0026-_005cincludeonly">\include &amp; \includeonly</a>). If you use them at
+the same level, as with
+<code>\addtocontents{...}{...}\include{...}</code> then lines in the
+table of contents can come out in the wrong order. The solution is to
+move <code>\addtocontents</code> into the file being included.
+</p>
<hr>
-<a name="Glossaries"></a>
+<a name="g_t_005cnofiles"></a>
<div class="header">
<p>
-Next: <a href="#Indexes" accesskey="n" rel="next">Indexes</a>, Previous: <a href="#Tables-of-contents" accesskey="p" rel="prev">Tables of contents</a>, Up: <a href="#Front_002fback-matter" accesskey="u" rel="up">Front/back matter</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005caddtocontents" accesskey="p" rel="prev">\addtocontents</a>, Up: <a href="#Table-of-contents-etc_002e" accesskey="u" rel="up">Table of contents etc.</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Glossaries-1"></a>
-<h3 class="section">25.2 Glossaries</h3>
+<a name="g_t_005cnofiles-1"></a>
+<h4 class="subsection">25.1.3 <code>\nofiles</code></h4>
-<a name="index-glossaries"></a>
+<a name="index-_005cnofiles"></a>
-<a name="index-_005cmakeglossary"></a>
-<p>The command <code>\makeglossary</code> enables creating glossaries.
+<p>Synopsis:
</p>
-<a name="index-_005cglossary"></a>
-<a name="index-_002eglo-file"></a>
-<p>The command <code>\glossary{<var>text</var>}</code> writes a glossary entry for
-<var>text</var> to an auxiliary file with the <samp>.glo</samp> extension.
+<div class="example">
+<pre class="example">\nofiles
+</pre></div>
+
+<p>Prevent LaTeX from writing any auxiliary files. The only output will
+be the <samp>.log</samp> and <samp>.pdf</samp> (or <samp>.dvi</samp>) files. This command
+must go in the preamble.
</p>
-<a name="index-_005cglossaryentry"></a>
-<p>Specifically, what gets written is the command
-<code>\glossaryentry{<var>text</var>}{<var>pageno</var>}</code>, where
-<var>pageno</var> is the current <code>\thepage</code> value.
+<p>Because of the <code>\nofiles</code> command this example will not produce a
+<samp>.toc</samp> file.
</p>
-<a name="index-glossary-package"></a>
-<p>The <code>glossary</code> package on CTAN provides support for fancier
-glossaries.
+<div class="example">
+<pre class="example">\documentclass{book}
+\nofiles
+\begin{document}
+\tableofcontents\newpage
+\chapter{...}
+ ...
+</pre></div>
+
+<p>LaTeX will not erase any existing auxiliary files, so if you insert
+the <code>\nofiles</code> command after you have run the file and gotten
+a <samp>.toc</samp> then the table of contents page will continue to show
+the old information.
</p>
<hr>
<a name="Indexes"></a>
<div class="header">
<p>
-Previous: <a href="#Glossaries" accesskey="p" rel="prev">Glossaries</a>, Up: <a href="#Front_002fback-matter" accesskey="u" rel="up">Front/back matter</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Glossaries" accesskey="n" rel="next">Glossaries</a>, Previous: <a href="#Table-of-contents-etc_002e" accesskey="p" rel="prev">Table of contents etc.</a>, Up: <a href="#Front_002fback-matter" accesskey="u" rel="up">Front/back matter</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Indexes-1"></a>
-<h3 class="section">25.3 Indexes</h3>
+<h3 class="section">25.2 Indexes</h3>
<a name="index-indexes"></a>
<a name="index-_005cmakeindex"></a>
-<p>The command <code>\makeindex</code> enables creating indexes. Put this in
-the preamble.
-</p>
<a name="index-_005cindex"></a>
<a name="index-_002eidx-file"></a>
-<p>The command <code>\index{<var>text</var>}</code> writes an index entry for
-<var>text</var> to an auxiliary file named with the <samp>.idx</samp> extension.
+
+<p>This document has an index.
</p>
-<a name="index-_005cindexentry"></a>
-<p>Specifically, what gets written is the command
-<code>\indexentry{<var>text</var>}{<var>pageno</var>}</code>, where <var>pageno</var>
-is the current <code>\thepage</code> value.
+<div class="example">
+<pre class="example">\documentclass{article}
+\usepackage{makeidx} \makeindex
+ ...
+\begin{document}
+ ...
+Recall Wilson's Theorem: \index{Wilson's Theorem}
+a number \( n&gt;1 \) is prime if and only if the factorial of \( n-1 \)
+is congruent to \( -1 \) modulo~\( n \).
+ ...
+\printindex
+ ...
+</pre></div>
+
+<p>The <code>\usepackage{makeidx}</code> and <code>\makeindex</code> in the preamble
+bring in the relevant commands.
+</p>
+<p>Producing an index is a three stage process. First, in the document
+body you declare index entries with the <code>\index</code> command
+(see <a href="#g_t_005cindex">\index</a>). When you run LaTeX, the <code>\index</code> writes its
+information to an auxiliary file <samp><var>root-name</var>.idx</samp>. Next, to
+alphabetize and to do other manipulations you run an external command,
+typically <code>makeindex</code> or <code>xindy</code> (see <a href="#makeindex">makeindex</a>).
+These output a file <samp><var>root-name</var>.ind</samp>. Finally, you bring the
+information back into your document and typeset it with the
+<code>\printindex</code> command (see <a href="#g_t_005cprintindex">\printindex</a>).
+</p>
+<a name="index-package_002c-showidx"></a>
+<a name="index-showidx-package"></a>
+
+<a name="index-package_002c-multind"></a>
+<a name="index-multind-package"></a>
+
+<p>There are many packages that apply to indexing commands. The
+<code>showidx</code> package causes each index entries to be shown in the
+margin on the page where the entry appears. This can help in preparing
+the index. The <code>multind</code> package supports multiple indexes. See
+also the TeX FAQ entry on this topic,
+<a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind</a>.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cindex" accesskey="1">\index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Declare an index entry.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#makeindex" accesskey="2">makeindex</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Alphabetize index entries.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cprintindex" accesskey="3">\printindex</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Put the index here.
+</td></tr>
+</table>
+
+
+<hr>
+<a name="g_t_005cindex"></a>
+<div class="header">
+<p>
+Next: <a href="#makeindex" accesskey="n" rel="next">makeindex</a>, Up: <a href="#Indexes" accesskey="u" rel="up">Indexes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cindex-1"></a>
+<h4 class="subsection">25.2.1 <code>\index</code></h4>
+
+<a name="index-index-entry"></a>
+<a name="index-_005cindex-1"></a>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\index{<var>index-entry-string</var>}
+</pre></div>
+
+<p>Declare an entry in the index. This command is fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
+</p>
+<p>For example, as described in <a href="#Indexes">Indexes</a>, one way to get an index from
+what&rsquo;s below is to compile the document with <code>pdflatex test</code>, then
+process the index entries with <code>makeindex test</code>, and then compile
+again with <code>pdflatex test</code>.
+</p>
+<div class="example">
+<pre class="example">W~Ackermann (1896--1962).\index{Ackermann}
+ ...
+Ackermann function\index{Ackermann!function}
+ ...
+rate of growth\index{Ackermann!function!growth rate}
+</pre></div>
+
+<p>All three index entries will get a page number, such as &lsquo;<samp>Ackermann,
+22</samp>&rsquo;. LaTeX will format the second as a subitem of the first, on the
+line below it and indented, and the third as a subitem of the second.
+Three levels deep is as far as you can nest subentries. (If you add
+<code>\index{Ackermann!function!growth rate!comparison}</code> then
+<code>makeindex</code> says &lsquo;<samp>Scanning input file test.idx....done (4
+entries accepted, 1 rejected)</samp>&rsquo; and nothing appears in the index).
+</p>
+<p>If you enter a second <code>\index</code> with the same
+<var>index-entry-string</var> then you will get a single index entry with two
+page numbers (unless they happen to fall on the same page). Thus,
+adding <code>as for Ackermann.\index{Ackermann}</code> later in the same
+document as above will give an index entry like &lsquo;<samp>Ackermann, 22,
+151</samp>&rsquo;. Also, you can enter the index entries in any order, so for
+instance <code>\index{Ackermann!function}</code> could come before
+<code>\index{Ackermann}</code>.
+</p>
+<a name="index-index_002c-page-range"></a>
+<p>Get a page range in the output, like &lsquo;<samp>Hilbert, 23--27</samp>&rsquo;, as here.
+</p>
+<div class="example">
+<pre class="example">W~Ackermann (1896--1962).\index{Ackermann}
+ ...
+D~Hilbert (1862--1943)\index{Ackermann!Hilbert\(}
+ ...
+disapproved of his marriage.\index{Ackermann!Hilbert\)}
+</pre></div>
+
+<p>If the beginning and ending of the page range are equal then the system
+just gives a single page entry, not a range.
+</p>
+<p>If you index subentries but not a main entry, as with
+<code>\index{Jones!program}</code> and <code>\index{Jones!results}</code>, then
+the output is the item &lsquo;<samp>Jones</samp>&rsquo; with no comma or page number,
+followed by two subitems, like &lsquo;<samp>program, 50</samp>&rsquo; and &lsquo;<samp>results,
+51</samp>&rsquo;.
</p>
<a name="index-_0060see_0027-and-_0060see-also_0027-index-entries"></a>
<a name="index-index-entries_002c-_0060see_0027-and-_0060see-also_0027"></a>
-<p>To generate a index entry for &lsquo;bar&rsquo; that says &lsquo;See foo&rsquo;, use a
-vertical bar: <code>\index{bar|see{foo}}</code>. Use <code>seealso</code>
-instead of <code>see</code> to make a &lsquo;See also&rsquo; entry.
-</p>
<a name="index-_005cseename"></a>
<a name="index-_005calsoname"></a>
-<p>The text &lsquo;See&rsquo; is defined by the macro <code>\seename</code>, and &lsquo;See also&rsquo;
-by the macro <code>\alsoname</code>. These can be redefined for other
-languages.
+<a name="index-package_002c-babel-5"></a>
+<a name="index-babel-package-5"></a>
+<a name="index-package_002c-polyglossia-3"></a>
+<a name="index-polyglossia-package-3"></a>
+
+
+<p>Generate a index entry that says &lsquo;<samp>See</samp>&rsquo; by using a vertical bar
+character: <code>\index{Ackermann!function|see{P\'eter's
+function}}</code>. You can instead get &lsquo;<samp>See also</samp>&rsquo; with <code>seealso</code>.
+(The text &lsquo;<samp>See</samp>&rsquo; is defined by <code>\seename</code>, and &lsquo;<samp>See also</samp>&rsquo;
+by <code>\alsoname</code>. You can redefine these either by using an
+internationalization package such as <samp>babel</samp> or <samp>polyglossia</samp>,
+or directly as with <code>\renewcommand{\alsoname}[1]{Also see
+#1}</code>.)
+</p>
+<p>The &lsquo;<samp>See</samp>&rsquo; feature is part of a more general functionality. After
+the vertical bar you can put the name of a one-input command, as in
+<code>\index{group|textit}</code> (note the missing backslash on the
+<code>\textit</code> command) and the system will apply that command to the
+page number, here giving something like <code>\textit{7}</code>. You can
+define your own one-input commands, such as
+<code>\newcommand{\definedpage}[1]{{\color{blue}#1}}</code> and then
+<code>\index{Ackermann!function|definedpage}</code> will give a blue page
+number (see <a href="#Color">Color</a>). Another, less practical, example is this,
+</p>
+<div class="example">
+<pre class="example">\newcommand\indexownpage[1]{#1, \thepage}
+ ... Epimenides.\index{self-reference|indexownpage}
+</pre></div>
+
+<p>which creates an entry citing the page number of its own index listing.
+</p>
+<p>The two functions just described combine, as here
+</p>
+<div class="example">
+<pre class="example">\index{Ackermann!function|(definedpage}
+ ...
+\index{Ackermann!function|)}
+</pre></div>
+
+<p>which outputs an index entry like &lsquo;<samp>function, 23--27</samp>&rsquo; where the page
+number range is in blue.
+</p>
+<p>Consider an index entry such as &lsquo;<samp>&#x03B1;-ring</samp>&rsquo;. Entering
+it as <code>$\alpha$-ring</code> will cause it to be alphabetized according to
+the dollar sign. You can instead enter it using an at-sign, as
+<code>\index{alpha-ring@$\alpha$-ring}</code>. If you specify an entry
+with an at-sign separating two strings, <code><var>pos</var>@<var>text</var></code>,
+then <var>pos</var> gives the alphabetical position of the entry while
+<var>text</var> produces the text of the entry. Another example is that
+<code>\index{Saint Michael's College@SMC}</code> produces an index entry
+&lsquo;<samp>SMC</samp>&rsquo; alphabetized into a different location than its spelling
+would naturally give it.
</p>
+<p>To put a <code>!</code>, or <code>@</code>, or <code>|</code> character in an index
+entry, preceding it with a double quote, <code>&quot;</code>. (The double quote
+gets deleted before alphabetization.)
+</p>
+<a name="index-package_002c-index"></a>
+<a name="index-index-package"></a>
+
+<p>A number of packages on CTAN have additional functionality beyond that
+provided by <samp>makeidx</samp>. One is <samp>index</samp>, which allows for
+multiple indices and contains a command
+<code>\index*{<var>index-entry-string</var>}</code> that prints the
+<var>index-entry-string</var> as well as indexing it.
+</p>
+<a name="index-_005cindexentry"></a>
+<a name="index-idx-file"></a>
+<p>The <code>\index</code> command writes the indexing information to the file
+<samp><var>root-name</var>.idx</samp> file. Specifically, it writes text of the
+command
+<code>\indexentry{<var>index-entry-string</var>}{<var>page-num</var>}</code>, where
+where <var>page-num</var> is the value of the <code>\thepage</code> counter. On
+occasion, when the <code>\printindex</code> command is confused, you have to
+delete this file to start with a fresh slate.
+</p>
+<p>If you omit the closing brace of an <code>\index</code> command then you get a
+message like this.
+</p>
+<div class="example">
+<pre class="example">Runaway argument? {Ackermann!function
+! Paragraph ended before \@wrindex was complete.
+</pre></div>
+
+
+<hr>
+<a name="makeindex"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cprintindex" accesskey="n" rel="next">\printindex</a>, Previous: <a href="#g_t_005cindex" accesskey="p" rel="prev">\index</a>, Up: <a href="#Indexes" accesskey="u" rel="up">Indexes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="makeindex-1"></a>
+<h4 class="subsection">25.2.2 <code>makeindex</code></h4>
+
+<a name="index-index_002c-processing"></a>
+<a name="index-makeindex"></a>
<a name="index-makeindex-program"></a>
-<a name="index-xindy-program"></a>
<a name="index-_002eind-file"></a>
-<p>The generated <samp>.idx</samp> file is then sorted with an external
-command, usually either <code>makeindex</code>
-(<a href="http://mirror.ctan.org/indexing/makeindex">http://mirror.ctan.org/indexing/makeindex</a>) or (the
-multi-lingual) <code>xindy</code> (<a href="http://xindy.sourceforge.net">http://xindy.sourceforge.net</a>).
-This results in a <samp>.ind</samp> file, which can then be read to typeset
-the index.
+<a name="index-_002eidx-file-1"></a>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">makeindex <var>filename</var>
+makeindex -s <var>style-file</var> <var>filename</var>
+makeindex <var>options</var> <var>filename0</var> ...
+</pre></div>
+
+<p>Sort, and otherwise process, the index information in the auxiliary file
+<var>filename</var>. This is a command line program. It takes one or more
+raw index files, <samp><var>filename</var>.idx</samp> files, and produces the
+actual index file, the <samp><var>filename</var>.ind</samp> file that is input by
+<code>\printindex</code> (see <a href="#g_t_005cprintindex">\printindex</a>).
+</p>
+<a name="index-_002eisty-file"></a>
+<a name="index-index_002c-style-file"></a>
+<a name="index-makeindex_002c-style-file"></a>
+<p>The first form of the command suffices for many uses. The second allows
+you to format the index by using an <em>index style file</em>, a
+<samp>.isty</samp> file. The third form is the most general; see the full
+documentation on CTAN.
+</p>
+<p>This is a simple <samp>.isty</samp> file.
+</p>
+<div class="example">
+<pre class="example">% book.isty
+% $ makeindex -s book.isty -p odd book.idx
+% creates the index as book.ind, starting on an odd page.
+preamble
+&quot;\\pagestyle{empty}
+\\small
+\\begin{theindex}
+\\thispagestyle{empty}&quot;
+
+postamble
+&quot;\n
+\\end{theindex}&quot;
+</pre></div>
+
+<p>The description here covers only some of the index formatting
+possibilities in <var>style-file</var>. For a full list see the documentation
+on CTAN.
+</p>
+<p>A style file consists of a list of pairs: <var>specifier</var> and
+<var>attribute</var>. These can appear in the file in any order. All of the
+<var>attributes</var> are strings, except where noted. Strings are
+surrounded with double quotes, <code>&quot;</code>, and the maximum length of a
+string is 144 characters. The <code>\n</code> is for a newline and <code>\t</code>
+is for a tab. Backslashes are escaped with another backslash,
+<code>\\</code>. If a line begins with a percent sign, <code>%</code>, then it is a
+comment.
+</p>
+<dl compact="compact">
+<dd><a name="makeindex-preamble"></a></dd>
+<dt><code>preamble</code>
+<a name="index-preamble"></a>
+</dt>
+<dd><p>Preamble of the output file. Defines the context in which the index is
+formatted. Default: <code>&quot;\\begin{theindex}\n&quot;</code>.
+</p>
+<a name="makeindex-postamble"></a></dd>
+<dt><code>postamble</code>
+<a name="index-postamble"></a>
+</dt>
+<dd><p>Postamble of the output file. Default: <code>&quot;\n\n\\end{theindex}\n&quot;</code>.
+</p>
+<a name="makeindex-group-skip"></a></dd>
+<dt><code>group_skip</code>
+<a name="index-group_005fskip"></a>
+</dt>
+<dd><a name="index-_005cindexspace"></a>
+<p>Traditionally index items are broken into groups, typically a group for
+entries starting with &lsquo;<samp>a</samp>&rsquo;, etc. This specifier gives what is
+inserted when a new group begins. Default: <code>&quot;\n\n \\indexspace\n&quot;</code>
+(<code>\indexspace</code> is a rubber length with default value <code>10pt
+plus5pt minus3pt</code>).
+</p>
+<a name="makeindex-letheadflag"></a></dd>
+<dt><code>lethead_flag</code>
+<a name="index-lethead_005fflag"></a>
+</dt>
+<dd><p>An integer. It governs what is inserted for a new group or letter. If
+it is 0 (which is the default) then other than <code>group_skip</code> nothing
+will be inserted before the group. If it is is positive then at a new
+letter the <code>lethead_prefix</code> and <code>lethead_suffix</code> will be
+inserted, with that letter in uppercase between them. If it is negative
+then what will be inserted is the letter in lowercase. The default
+is&nbsp;0.
+</p>
+<a name="makeindex-lethead-prefix"></a></dd>
+<dt><code>lethead_prefix</code>
+<a name="index-lethead_005fprefix"></a>
+</dt>
+<dd><p>If a new group begins with a different letter then this is the prefix
+inserted before the new letter header. Default: <code>&quot;&quot;</code>
+</p>
+<a name="makeindex-lethead-suffix"></a></dd>
+<dt><code>lethead_suffix</code>
+<a name="index-lethead_005fsuffix"></a>
+</dt>
+<dd><p>If a group begins with a different letter then this is the suffix
+inserted after the new letter header. Default: <code>&quot;&quot;</code>.
+</p>
+<a name="makeindex-item-0"></a></dd>
+<dt><code>item_0</code>
+<a name="index-item_005f0"></a>
+</dt>
+<dd><p>What is put between two level&nbsp;0 items. Default: <code>&quot;\n \\item
+&quot;</code>.
+</p>
+<a name="makeindex-item-1"></a></dd>
+<dt><code>item_1</code>
+<a name="index-item_005f1"></a>
+</dt>
+<dd><p>Put between two level&nbsp;1 items. Default: <code>&quot;\n \\subitem &quot;</code>.
+</p>
+<a name="makeindex-item-2"></a></dd>
+<dt><code>item_2</code>
+<a name="index-item_005f2"></a>
+</dt>
+<dd><p>put between two level&nbsp;2 items. Default: <code>&quot;\n \\subsubitem &quot;</code>.
+</p>
+<a name="makeindex-item-01"></a></dd>
+<dt><code>item_01</code>
+<a name="index-item_005f01"></a>
+</dt>
+<dd><p>What is put between a level&nbsp;0 item and a level&nbsp;1 item.
+Default: <code>&quot;\n \\subitem &quot;</code>.
+</p>
+<a name="makeindex-item-x1"></a></dd>
+<dt><code>item_x1</code>
+<a name="index-item_005fx1"></a>
+</dt>
+<dd><p>What is put between a level&nbsp;0 item and a level&nbsp;1 item in the
+case that the level&nbsp;0 item doesn&rsquo;t have any page numbers (as in
+<code>\index{aaa|see{bbb}}</code>). Default: <code>&quot;\n \\subitem &quot;</code>.
+</p>
+<a name="makeindex-item-12"></a></dd>
+<dt><code>item_12</code>
+<a name="index-item_005f12"></a>
+</dt>
+<dd><p>What is put between a level&nbsp;1 item and a level&nbsp;2 item.
+Default: <code>&quot;\n \\subsubitem &quot;</code>.
+</p>
+<a name="makeindex-item-x2"></a></dd>
+<dt><code>item_x2</code>
+<a name="index-item_005fx2"></a>
+</dt>
+<dd><p>What is put between a level&nbsp;1 item and a level&nbsp;2 item, if the
+level&nbsp;1 item doesn&rsquo;t have page numbers. Default: <code>&quot;\n
+\\subsubitem &quot;</code>.
+</p>
+<a name="makeindex-delim-0"></a></dd>
+<dt><code>delim_0</code>
+<a name="index-delim_005f0"></a>
+</dt>
+<dd><p>Delimiter put between a level&nbsp;0 key and its first page
+number. Default: a comma followed by a blank, <code>&quot;, &quot;</code>.
+</p>
+<a name="makeindex-delim-1"></a></dd>
+<dt><code>delim_1</code>
+<a name="index-delim_005f1"></a>
+</dt>
+<dd><p>Delimiter put between a level&nbsp;1 key and its first page
+number. Default: a comma followed by a blank, <code>&quot;, &quot;</code>.
+</p>
+<a name="makeindex-delim-2"></a></dd>
+<dt><code>delim_2</code>
+<a name="index-delim_005f2"></a>
+</dt>
+<dd><p>Delimiter between a level&nbsp;2 key and its first page number. Default:
+a comma followed by a blank, <code>&quot;, &quot;</code>.
+</p>
+<a name="makeindex-delim-n"></a></dd>
+<dt><code>delim_n</code>
+<a name="index-delim_005fn"></a>
+</dt>
+<dd><p>Delimiter between two page numbers for the same key (at any
+level). Default: a comma followed by a blank, <code>&quot;, &quot;</code>.
+</p>
+<a name="makeindex-delim-r"></a></dd>
+<dt><code>delim_r</code>
+<a name="index-delim_005fr"></a>
+</dt>
+<dd><p>What is put between the starting and ending page numbers of a range.
+Default: <code>&quot;--&quot;</code>.
+</p>
+<a name="makeindex-line-max"></a></dd>
+<dt><code>line_max</code>
+<a name="index-line_005fmax"></a>
+</dt>
+<dd><p>An integer. Maximum length of an index entry&rsquo;s line in the output,
+beyond which the line wraps. Default: <code>72</code>.
+</p>
+<a name="makeindex-indent-space"></a></dd>
+<dt><code>indent_space</code>
+<a name="index-indent_005fspace"></a>
+</dt>
+<dd><p>What is inserted at the start of a wrapped line. Default:
+<code>&quot;\t\t&quot;</code>.
+</p>
+<a name="makeindex-indent-length"></a></dd>
+<dt><code>indent_length</code>
+<a name="index-indent_005flength"></a>
+</dt>
+<dd><p>A number. The length of the wrapped line indentation. The default
+<code>indent_space</code> is two tabs and each tab is eight spaces so the
+default here is <code>16</code>.
</p>
+<a name="makeindex-page-precedence"></a></dd>
+<dt><code>page_precedence</code>
+<a name="index-page_005fprecedence"></a>
+</dt>
+<dd><p>A document may have pages numbered in different ways. For example, a
+book may have front matter pages numbered in lowercase roman while main
+matter pages are in arabic. This string specifies the order in which
+they will appear in the index. The <code>makeindex</code> command supports
+five different types of numerals: lowercase roman <code>r</code>, and numeric
+or arabic <code>n</code>, and lowercase alphabetic <code>a</code>, and uppercase
+roman <code>R</code>, and uppercase alphabetic <code>A</code>. Default:
+<code>&quot;rnaRA&quot;</code>.
+</p>
+</dd>
+</dl>
+
+<a name="index-xindy"></a>
+<a name="index-xindy-program"></a>
+<p>There are a number of other programs that do the job <code>makeindex</code>
+does. One is <code>xindy</code>, which does internationalization and can
+process indexes for documents marked up using LaTeX and a number of
+other languages. It is is highly configurable, both in markup terms and
+in terms of the collating order of the text. See the documentation on
+CTAN.
+</p>
+
+<hr>
+<a name="g_t_005cprintindex"></a>
+<div class="header">
+<p>
+Previous: <a href="#makeindex" accesskey="p" rel="prev">makeindex</a>, Up: <a href="#Indexes" accesskey="u" rel="up">Indexes</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cprintindex-1"></a>
+<h4 class="subsection">25.2.3 <code>\printindex</code></h4>
+
+<a name="index-index_002c-printing"></a>
<a name="index-_005cprintindex"></a>
-<a name="index-package_002c-makeidx"></a>
-<a name="index-makeidx-package"></a>
-<p>The index is usually generated with the <code>\printindex</code> command.
-This is defined in the <code>makeidx</code> package, so
-<code>\usepackage{makeidx}</code> needs to be in the preamble.
+<p>Synopsis:
</p>
-<a name="index-_005cindexspace"></a>
-<p>The rubber length <code>\indexspace</code> is inserted before each new
-letter in the printed index; its default value is &lsquo;<samp>10pt plus5pt
-minus3pt</samp>&rsquo;.
+<div class="example">
+<pre class="example">\printindex
+</pre></div>
+
+<a name="index-_005cprintindex-1"></a>
+<p>Place the index into the output.
</p>
-<a name="index-package_002c-showidx"></a>
-<a name="index-showidx-package"></a>
+<p>To get an index you must first include
+<code>\usepackage{makeidx}\makeindex</code> in the document preamble and
+compile the document, then run the system command <code>makeindex</code>,
+and then compile the document again. See <a href="#Indexes">Indexes</a> for further
+discussion and an example of the use of <code>\printindex</code>.
+</p>
+
+<hr>
+<a name="Glossaries"></a>
+<div class="header">
+<p>
+Previous: <a href="#Indexes" accesskey="p" rel="prev">Indexes</a>, Up: <a href="#Front_002fback-matter" accesskey="u" rel="up">Front/back matter</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Glossaries-1"></a>
+<h3 class="section">25.3 Glossaries</h3>
+
+<a name="index-glossary"></a>
+<a name="index-glossaries"></a>
+<a name="index-acronyms_002c-list-of"></a>
+<a name="index-_005cmakeglossary"></a>
+<a name="index-_005cprintglossaries"></a>
-<p>The <code>showidx</code> package causes each index entries to be shown in
-the margin on the page where the entry appears. This can help in
-preparing the index.
+<p>Synopsis:
</p>
-<a name="index-package_002c-multind"></a>
-<a name="index-multind-package"></a>
+<div class="example">
+<pre class="example">\usepackage{glossaries} \makeglossaries
+ ...
+\newglossaryentry{<var>label</var>}{<var>settings</var>}
+ ...
+\gls{<var>label</var>}.
+ ...
+\printglossaries
+</pre></div>
-<p>The <code>multind</code> package supports multiple indexes. See also the
-TeX FAQ entry on this topic,
-<a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind</a>.
+<p>The <samp>glossaries</samp> package allows you to make glossaries, including
+multiple glossaries, as well as lists of acronyms.
+</p>
+<p>To get the output from this example, compile the document (for instance
+with <code>pdflatex filename</code>), then run the command line command
+<code>makeglossaries filename</code>, and then compile the document again.
+</p>
+<div class="example">
+<pre class="example">\documentclass{...}
+\usepackage{glossaries} \makeglossaries
+\newglossaryentry{tm}{%
+ name={Turing machine},
+ description={A model of a machine that computes. The model is simple
+ but can compute anything any existing device can compute.
+ It is the standard model used in Computer Science.},
+ }
+\begin{document}
+Everything begins with the definition of a \gls{tm}.
+ ...
+\printglossaries
+\end{document}
+</pre></div>
+
+<p>That gives two things. In the main text it outputs &lsquo;<samp>... definition
+of a Turing machine</samp>&rsquo;. In addition, in a separate sectional unit headed
+&lsquo;<samp>Glossary</samp>&rsquo; there appears a description list. In boldface it says
+&lsquo;<samp>Turing machine</samp>&rsquo; and the rest of the item says in normal type
+&lsquo;<samp>A model of a machine &hellip; Computer Science</samp>&rsquo;.
+</p>
+<a name="index-_005cmakeglossary-1"></a>
+<a name="index-_005cprintglossaries-1"></a>
+<a name="index-_002eglo-file"></a>
+<p>The command <code>\makeglossary</code> opens the file that will contain the
+entry information, <samp><var>root-file</var>.glo</samp>. Put the
+<code>\printglossaries</code> command where you want the glossaries to appear
+in your document.
+</p>
+<p>The <samp>glossaries</samp> package is very powerful. For instance, besides
+the commands <code>\newglossaryentry</code> and <code>\gls</code>, there are similar
+commands for a list of acronyms. See the package documentations on
+CTAN.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cnewglossaryentry" accesskey="1">\newglossaryentry</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Declare the content of a glossary entry.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#g_t_005cgls" accesskey="2">\gls</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Give a page reference for a glossary entry.
+</td></tr>
+</table>
+
+
+<hr>
+<a name="g_t_005cnewglossaryentry"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005cgls" accesskey="n" rel="next">\gls</a>, Up: <a href="#Glossaries" accesskey="u" rel="up">Glossaries</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cnewglossaryentry-1"></a>
+<h4 class="subsection">25.3.1 <code>\newglossaryentry</code></h4>
+
+<a name="index-glossary_002c-entries"></a>
+<a name="index-_005cnewglossaryentry"></a>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\newglossaryentry{<var>label</var>}
+{
+ name={<var>name</var>},
+ description={<var>description</var>},
+ <var>other options</var>, ...
+}
+</pre></div>
+
+<p>or
+</p>
+<div class="example">
+<pre class="example">\longnewglossaryentry{<var>label</var>}
+{
+ name={<var>name</var>},
+ <var>other options</var> ...,
+}
+{<var>description</var>}
+</pre></div>
+
+<p>Declare a new entry for a glossary. The <var>label</var> must be unique for
+the document. The settings associated with the label are pairs:
+<code><var>key</var>=<var>value</var></code>.
+</p>
+<p>This puts the blackboard bold symbol for the real numbers &#x211D; in the
+glossary.
+</p>
+<div class="example">
+<pre class="example">\newglossaryentry{R}
+{
+ name={\ensuremath{\mathbb{R}}},
+ description={the real numbers},
+}
+</pre></div>
+
+<p>Use the second command form if the <var>description</var> spans more than one
+paragraph.
+</p>
+<p>For a full list of <var>key</var>s see the package documentation on CTAN but
+here are a few.
+</p>
+<dl compact="compact">
+<dt><code>name</code>
+<a name="index-name"></a>
+</dt>
+<dd><p>(Required.) The word, phrase, or symbol that you are defining.
+</p>
+</dd>
+<dt><code>description</code>
+<a name="index-description"></a>
+</dt>
+<dd><p>(Required.) The description that will appear in the glossary.
+If this has more than one paragraph then you must use the second command
+form given in the synopsis.
+</p>
+</dd>
+<dt><code>plural</code>
+<a name="index-plural"></a>
+</dt>
+<dd><p>The plural form of <var>name</var>. Refer to the plural form using
+<code>\glspl</code> or <code>\Glspl</code> (see <a href="#g_t_005cgls">\gls</a>).
+</p>
+</dd>
+<dt><code>sort</code>
+<a name="index-sort"></a>
+</dt>
+<dd><p>How to place this entry in the list of entries that the glossary holds.
+</p>
+</dd>
+<dt><code>symbol</code>
+<a name="index-symbol"></a>
+</dt>
+<dd><p>A symbol, such as a mathematical symbol, besides the name.
+</p>
+</dd>
+</dl>
+
+
+<hr>
+<a name="g_t_005cgls"></a>
+<div class="header">
+<p>
+Previous: <a href="#g_t_005cnewglossaryentry" accesskey="p" rel="prev">\newglossaryentry</a>, Up: <a href="#Glossaries" accesskey="u" rel="up">Glossaries</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005cgls-1"></a>
+<h4 class="subsection">25.3.2 <code>\gls</code></h4>
+
+<a name="index-glossary_002c-entry-reference"></a>
+<a name="index-_005cgls"></a>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\gls{<var>label</var>}
+\glspl{<var>label</var>}
+\Gls{<var>label</var>}
+\Glspl{<var>label</var>}
+</pre></div>
+
+<p>Refer to a glossary entry. The entries are declared with
+<code>\newglossaryentry</code> (see <a href="#g_t_005cnewglossaryentry">\newglossaryentry</a>).
+</p>
+<p>This
+</p>
+<div class="example">
+<pre class="example">\newglossaryentry{N}{%
+ name={the natural numbers},
+ description={The numbers $0$, $1$, $2$, $\ldots$\@},
+ symbol={\ensuremath{\mathbb{N}}},
+ }
+ ...
+Consider \gls{N}.
+</pre></div>
+
+<p>gives the output &lsquo;<samp>Consider the natural numbers</samp>&rsquo;.
+</p>
+<p>The second command form <code>\glspl{<var>label</var>}</code> produces the plural
+of <var>name</var> (by default it tries adding an &lsquo;<samp>s</samp>&rsquo;). The third form
+capitalizes the first letter of <var>name</var>, as does the fourth form,
+which also takes the plural.
</p>
<hr>
<a name="Letters"></a>
<div class="header">
<p>
-Next: <a href="#Terminal-input_002foutput" accesskey="n" rel="next">Terminal input/output</a>, Previous: <a href="#Front_002fback-matter" accesskey="p" rel="prev">Front/back matter</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Terminal-input_002foutput" accesskey="n" rel="next">Terminal input/output</a>, Previous: <a href="#Front_002fback-matter" accesskey="p" rel="prev">Front/back matter</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Letters-1"></a>
<h2 class="chapter">26 Letters</h2>
@@ -15840,7 +21067,7 @@ Next: <a href="#Terminal-input_002foutput" accesskey="n" rel="next">Terminal inp
</p>
<div class="example">
<pre class="example">\documentclass{letter}
-\address{<var>sender address</var>}
+\address{<var>senders address</var>} % return address
\signature{<var>sender name</var>}
\begin{document}
\begin{letter}{<var>recipient address</var>}
@@ -15848,7 +21075,7 @@ Next: <a href="#Terminal-input_002foutput" accesskey="n" rel="next">Terminal inp
<var>letter body</var>
\closing{<var>closing text</var>}
\end{letter}
-... more letters ...
+ ...
\end{document}
</pre></div>
@@ -15856,12 +21083,11 @@ Next: <a href="#Terminal-input_002foutput" accesskey="n" rel="next">Terminal inp
</p>
<p>Each letter is in a separate <code>letter</code> environment, whose argument
<var>recipient address</var> often contains multiple lines separated with a
-double backslash&nbsp;(<code>\\</code>). For example, you might have:
+double backslash,&nbsp;(<code>\\</code>). For example, you might have:
</p>
<div class="example">
-<pre class="example"> \begin{letter}{Mr. Joe Smith \\
- 2345 Princess St. \\
- Edinburgh, EH1 1AA}
+<pre class="example"> \begin{letter}{Ninon de l'Enclos \\
+ l'h\^otel Sagonne}
...
\end{letter}
</pre></div>
@@ -15875,15 +21101,15 @@ preamble. As with the recipient address, often <var>sender address</var>
contains multiple lines separated by a double
backslash&nbsp;(<code>\\</code>). LaTeX will put the <var>sender name</var>
under the closing, after a vertical space for the traditional
-hand-written signature; it also can contain multiple lines.
+hand-written signature.
</p>
-<p>Each <code>letter</code> environment body begins with a required <code>\opening</code> command
-such as <code>\opening{Dear Madam or Sir:}</code>. The <var>letter body</var>
-text is ordinary LaTeX so it can contain everything from
-enumerated lists to displayed math, except that commands such as
-<code>\chapter</code> that make no sense in a letter are turned off. Each
-<code>letter</code> environment body typically ends with a <code>\closing</code>
-command such as <code>\closing{Yours,}</code>.
+<p>Each <code>letter</code> environment body begins with a required
+<code>\opening</code> command such as <code>\opening{Dear Madam or Sir:}</code>.
+The <var>letter body</var> text is ordinary LaTeX so it can contain
+everything from enumerated lists to displayed math, except that commands
+such as <code>\chapter</code> that make no sense in a letter are turned off.
+Each <code>letter</code> environment body typically ends with a
+<code>\closing</code> command such as <code>\closing{Yours,}</code>.
</p>
<a name="index-_005c_005c-for-letters"></a>
<p>Additional material may come after the <code>\closing</code>. You can say who
@@ -15891,13 +21117,13 @@ is receiving a copy of the letter with a command like <code>\cc{the
Boss \\ the Boss's Boss}</code>. There&rsquo;s a similar <code>\encl</code> command for
a list of enclosures. And, you can add a postscript with <code>\ps</code>.
</p>
-<p>LaTeX&rsquo;s default is to indent the signature and the <code>\closing</code>
-above it by a length of <code>\longindentation</code>. By default this is
+<p>LaTeX&rsquo;s default is to indent the sender name and the closing above it
+by a length of <code>\longindentation</code>. By default this is
<code>0.5\textwidth</code>. To make them flush left, put
<code>\setlength{\longindentation}{0em}</code> in your preamble.
</p>
<p>To set a fixed date use something like
-<code>\renewcommand{\today}{2015-Oct-12}</code>. If put in your preamble
+<code>\renewcommand{\today}{1958-Oct-12}</code>. If put in your preamble
then it will apply to all the letters.
</p>
<p>This example shows only one <code>letter</code> environment. The three lines
@@ -15951,7 +21177,7 @@ I am not interested in entering a business arrangement with you.
<a name="g_t_005caddress"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005ccc" accesskey="n" rel="next">\cc</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005ccc" accesskey="n" rel="next">\cc</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005caddress-1"></a>
<h3 class="section">26.1 <code>\address</code></h3>
@@ -15964,19 +21190,18 @@ Next: <a href="#g_t_005ccc" accesskey="n" rel="next">\cc</a>, Up: <a href="#Lett
<pre class="example">\address{<var>senders address</var>}
</pre></div>
-<p>Specifies the return address as it appears on the letter and on the
+<p>Specify the return address, as it appears on the letter and on the
envelope. Separate multiple lines in <var>senders address</var> with a
-double backslash&nbsp;<code>\\</code>.
+double backslash,&nbsp;<code>\\</code>.
</p>
<p>Because it can apply to multiple letters this declaration is often put
in the preamble. However, it can go anywhere, including inside an
individual <code>letter</code> environment.
</p>
-<p>This command is optional: without the <code>\address</code> declaration the
-letter is formatted with some blank space on top, for copying onto
-pre-printed letterhead paper. (See <a href="#Overview">Overview</a>, for details on your
-local implementation.) With the <code>\address</code> declaration, it is
-formatted as a personal letter.
+<p>This command is optional: if you do not use it then the letter is
+formatted with some blank space on top, for copying onto pre-printed
+letterhead paper. If you do use the <code>\address</code> declaration then it
+is formatted as a personal letter.
</p>
<p>Here is an example.
</p>
@@ -15990,7 +21215,7 @@ formatted as a personal letter.
<a name="g_t_005ccc"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cclosing" accesskey="n" rel="next">\closing</a>, Previous: <a href="#g_t_005caddress" accesskey="p" rel="prev">\address</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cclosing" accesskey="n" rel="next">\closing</a>, Previous: <a href="#g_t_005caddress" accesskey="p" rel="prev">\address</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005ccc-1"></a>
<h3 class="section">26.2 <code>\cc</code></h3>
@@ -16001,14 +21226,14 @@ Next: <a href="#g_t_005cclosing" accesskey="n" rel="next">\closing</a>, Previous
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\cc{<var>first name</var> \\
+<pre class="example">\cc{<var>name0</var> \\
... }
</pre></div>
<p>Produce a list of names to which copies of the letter were sent. This
command is optional. If it appears then typically it comes after
-<code>\closing</code>. Separate multiple lines with a double
-backslash&nbsp;<code>\\</code>, as in:
+<code>\closing</code>. Put the names on different lines by separating them
+with a double backslash, <code>\\</code>, as in:
</p>
<div class="example">
<pre class="example">\cc{President \\
@@ -16020,7 +21245,7 @@ backslash&nbsp;<code>\\</code>, as in:
<a name="g_t_005cclosing"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cencl" accesskey="n" rel="next">\encl</a>, Previous: <a href="#g_t_005ccc" accesskey="p" rel="prev">\cc</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cencl" accesskey="n" rel="next">\encl</a>, Previous: <a href="#g_t_005ccc" accesskey="p" rel="prev">\cc</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cclosing-1"></a>
<h3 class="section">26.3 <code>\closing</code></h3>
@@ -16035,8 +21260,8 @@ Next: <a href="#g_t_005cencl" accesskey="n" rel="next">\encl</a>, Previous: <a h
<pre class="example">\closing{<var>text</var>}
</pre></div>
-<p>Usually at the end of a letter, above the handwritten signature, there
-is a <code>\closing</code> (although this command is optional). For example,
+<p>Produce the letter&rsquo;s closing. This is optional, but usual. It appears
+at the end of a letter, above a handwritten signature. For example:
</p>
<div class="example">
<pre class="example">\closing{Regards,}
@@ -16047,7 +21272,7 @@ is a <code>\closing</code> (although this command is optional). For example,
<a name="g_t_005cencl"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005clocation" accesskey="n" rel="next">\location</a>, Previous: <a href="#g_t_005cclosing" accesskey="p" rel="prev">\closing</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005clocation" accesskey="n" rel="next">\location</a>, Previous: <a href="#g_t_005cclosing" accesskey="p" rel="prev">\closing</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cencl-1"></a>
<h3 class="section">26.4 <code>\encl</code></h3>
@@ -16064,11 +21289,11 @@ Next: <a href="#g_t_005clocation" accesskey="n" rel="next">\location</a>, Previo
<p>Produce a list of things included with the letter. This command is
optional; when it is used, it typically is put after <code>\closing</code>.
-Separate multiple lines with a double backslash&nbsp;<code>\\</code>.
+Separate multiple lines with a double backslash, <code>\\</code>.
</p>
<div class="example">
<pre class="example">\encl{License \\
- Passport }
+ Passport}
</pre></div>
@@ -16076,7 +21301,7 @@ Separate multiple lines with a double backslash&nbsp;<code>\\</code>.
<a name="g_t_005clocation"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cmakelabels" accesskey="n" rel="next">\makelabels</a>, Previous: <a href="#g_t_005cencl" accesskey="p" rel="prev">\encl</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cmakelabels" accesskey="n" rel="next">\makelabels</a>, Previous: <a href="#g_t_005cencl" accesskey="p" rel="prev">\encl</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005clocation-1"></a>
<h3 class="section">26.5 <code>\location</code></h3>
@@ -16089,7 +21314,7 @@ Next: <a href="#g_t_005cmakelabels" accesskey="n" rel="next">\makelabels</a>, Pr
<pre class="example">\location{<var>text</var>}
</pre></div>
-<p>The <var>text</var> appears centered at the bottom of the each page. It only
+<p>The <var>text</var> appears centered at the bottom of the page. It only
appears if the page style is <code>firstpage</code>.
</p>
@@ -16097,7 +21322,7 @@ appears if the page style is <code>firstpage</code>.
<a name="g_t_005cmakelabels"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cname" accesskey="n" rel="next">\name</a>, Previous: <a href="#g_t_005clocation" accesskey="p" rel="prev">\location</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cname" accesskey="n" rel="next">\name</a>, Previous: <a href="#g_t_005clocation" accesskey="p" rel="prev">\location</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cmakelabels-1"></a>
<h3 class="section">26.6 <code>\makelabels</code></h3>
@@ -16107,31 +21332,71 @@ Next: <a href="#g_t_005cname" accesskey="n" rel="next">\name</a>, Previous: <a h
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\makelabels
+<pre class="example">\makelabels % in preamble
</pre></div>
-<p>Create a sheet of address labels from the recipient addresses, one for
-each letter. This sheet will be output before the letters, with the idea
-that you can copy it to a sheet of peel-off labels. This command goes
-in the preamble.
+<p>Optional, for a document that contains <code>letter</code> environments. If
+you just put <code>\makelabels</code> in the preamble then at the end of the
+document you will get a sheet with labels for all the recipients, one
+for each letter environment, that you can copy to a sheet of peel-off
+address labels.
</p>
<p>Customize the labels by redefining the commands <code>\startlabels</code>,
-<code>\mlabel</code>, and <code>\returnaddress</code> in the preamble. The command
-<code>\startlabels</code> sets the width, height, number of columns, etc., of
-the page onto which the labels are printed. The command
-<code>\mlabel{<var>sender address</var>}{<var>recipient address</var>}</code>
-produces the two labels (or one, if you choose to ignore the <var>sender
-address</var>). The <var>sender address</var> is the value returned by the macro
-<code>\returnaddress</code> while <var>recipient address</var> is the value passed
-in the argument to the <code>letter</code> environment. By default
-<code>\mlabel</code> ignores the first argument, the <var>sender address</var>.
+<code>\mlabel</code>, and <code>\returnaddress</code> (and perhaps <code>\name</code>) in
+the preamble. The command <code>\startlabels</code> sets the width, height,
+number of columns, etc., of the page onto which the labels are printed.
+The command <code>\mlabel{<var>return address</var>}{<var>recipient
+address</var>}</code> produces the two labels (or one, if you choose to ignore the
+<var>return address</var>) for each letter environment. The first argument,
+<var>return address</var>, is the value returned by the macro
+<code>\returnaddress</code>. The second argument, <var>recipient address</var>, is
+the value passed in the argument to the <code>letter</code> environment. By
+default <code>\mlabel</code> ignores the first argument, the <var>return
+address</var>, causing the default behavior described in the prior paragraph.
+</p>
+<p>This illustrates customization. Its output includes a page with two
+columns having two labels each.
+</p>
+<div class="example">
+<pre class="example">\documentclass{letter}
+\renewcommand*{\returnaddress}{Fred McGuilicuddy \\
+ Oshkosh, Mineola 12305}
+\newcommand*\originalMlabel{}
+\let\originalMlabel\mlabel
+\def\mlabel#1#2{\originalMlabel{}{#1}\originalMlabel{}{#2}}
+\makelabels
+ ...
+\begin{document}
+\begin{letter}{A Einstein \\
+ 112 Mercer Street \\
+ Princeton, New Jersey, USA 08540}
+ ...
+\end{letter}
+\begin{letter}{K G\&quot;odel \\
+ 145 Linden Lane \\
+ Princeton, New Jersey, USA 08540}
+ ...
+\end{letter}
+\end{document}
+</pre></div>
+
+<p>The first column contains the return address twice. The second column
+contains the address for each recipient.
+</p>
+<a name="index-package_002c-envlab"></a>
+<a name="index-envlab-package"></a>
+
+<p>The package <code>envlab</code> makes formatting the labels easier, with
+standard sizes already provided. The preamble lines
+<code>\usepackage[personalenvelope]{envlab}</code> and <code>\makelabels</code>
+are all that you need to print envelopes.
</p>
<hr>
<a name="g_t_005cname"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005copening" accesskey="n" rel="next">\opening</a>, Previous: <a href="#g_t_005cmakelabels" accesskey="p" rel="prev">\makelabels</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005copening" accesskey="n" rel="next">\opening</a>, Previous: <a href="#g_t_005cmakelabels" accesskey="p" rel="prev">\makelabels</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cname-1"></a>
<h3 class="section">26.7 <code>\name</code></h3>
@@ -16144,15 +21409,15 @@ Next: <a href="#g_t_005copening" accesskey="n" rel="next">\opening</a>, Previous
<pre class="example">\name{<var>name</var>}
</pre></div>
-<p>Sender&rsquo;s name, used for printing on the envelope together with the
-return address.
+<p>Optional. Sender&rsquo;s name, used for printing on the envelope together
+with the return address.
</p>
<hr>
<a name="g_t_005copening"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005cps" accesskey="n" rel="next">\ps</a>, Previous: <a href="#g_t_005cname" accesskey="p" rel="prev">\name</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005cps" accesskey="n" rel="next">\ps</a>, Previous: <a href="#g_t_005cname" accesskey="p" rel="prev">\name</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005copening-1"></a>
<h3 class="section">26.8 <code>\opening</code></h3>
@@ -16163,12 +21428,11 @@ Next: <a href="#g_t_005cps" accesskey="n" rel="next">\ps</a>, Previous: <a href=
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\opening{<var>text</var>}
+<pre class="example">\opening{<var>salutation</var>}
</pre></div>
-<p>This command is required. It starts a letter, following the
-<code>\begin{letter}{...}</code>. The mandatory argument <var>text</var> is the
-text that starts your letter. For instance:
+<p>Required. Follows the <code>\begin{letter}{...}</code>. The argument
+<var>salutation</var> is mandatory. For instance:
</p>
<div class="example">
<pre class="example">\opening{Dear John:}
@@ -16179,7 +21443,7 @@ text that starts your letter. For instance:
<a name="g_t_005cps"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005csignature" accesskey="n" rel="next">\signature</a>, Previous: <a href="#g_t_005copening" accesskey="p" rel="prev">\opening</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005csignature" accesskey="n" rel="next">\signature</a>, Previous: <a href="#g_t_005copening" accesskey="p" rel="prev">\opening</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cps-1"></a>
<h3 class="section">26.9 <code>\ps</code></h3>
@@ -16204,7 +21468,7 @@ Next: <a href="#g_t_005csignature" accesskey="n" rel="next">\signature</a>, Prev
<a name="g_t_005csignature"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005ctelephone" accesskey="n" rel="next">\telephone</a>, Previous: <a href="#g_t_005cps" accesskey="p" rel="prev">\ps</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005ctelephone" accesskey="n" rel="next">\telephone</a>, Previous: <a href="#g_t_005cps" accesskey="p" rel="prev">\ps</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005csignature-1"></a>
<h3 class="section">26.10 <code>\signature</code></h3>
@@ -16221,10 +21485,10 @@ Next: <a href="#g_t_005ctelephone" accesskey="n" rel="next">\telephone</a>, Prev
<p>The sender&rsquo;s name. This command is optional, although its inclusion is
usual.
</p>
-<p>The argument text appears at the end of the letter, after the closing
-and after a vertical space for the traditional hand-written
+<p>The argument text appears at the end of the letter, after the closing.
+LaTeX leaves some vertical space for a handwritten
signature. Separate multiple lines with a double
-backslash&nbsp;<code>\\</code>. For example:
+backslash,&nbsp;<code>\\</code>. For example:
</p>
<div class="example">
<pre class="example">\signature{J Fred Muggs \\
@@ -16233,16 +21497,23 @@ backslash&nbsp;<code>\\</code>. For example:
<p>LaTeX&rsquo;s default for the vertical space from the <code>\closing</code> text
down to the <code>\signature</code> text is <code>6\medskipamount</code>, which is
-six times 0.7em.
+six times <code>\medskipamount</code> (where <code>\medskipamount</code> is equal to
+a <code>\parskip</code>, which in turn is defined by default here to
+0.7em).
</p>
<p>This command is usually in the preamble, to apply to all the letters in
the document. To have it apply to one letter only, put it inside a
<code>letter</code> environment and before the <code>\closing</code>.
</p>
-<p>You can include a graphic in the signature, for instance with
-<code>\signature{\vspace{-6\medskipamount}\includegraphics{sig.png}\\
-My name}</code> (this requires writing <code>\usepackage{graphicx}</code> in the
-preamble).
+<p>You can include a graphic in the signature as here.
+</p>
+<div class="example">
+<pre class="example">\signature{\vspace{-6\medskipamount}\includegraphics{sig.png}\\
+ My name}
+</pre></div>
+
+<p>For this you must put <code>\usepackage{graphicx}</code> in the preamble
+(see <a href="#Graphics">Graphics</a>).
</p>
@@ -16252,7 +21523,7 @@ preamble).
<a name="g_t_005ctelephone"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005csignature" accesskey="p" rel="prev">\signature</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005csignature" accesskey="p" rel="prev">\signature</a>, Up: <a href="#Letters" accesskey="u" rel="up">Letters</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005ctelephone-1"></a>
<h3 class="section">26.11 <code>\telephone</code></h3>
@@ -16275,7 +21546,7 @@ page.
<a name="Terminal-input_002foutput"></a>
<div class="header">
<p>
-Next: <a href="#Command-line" accesskey="n" rel="next">Command line</a>, Previous: <a href="#Letters" accesskey="p" rel="prev">Letters</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Command-line" accesskey="n" rel="next">Command line</a>, Previous: <a href="#Letters" accesskey="p" rel="prev">Letters</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Terminal-input_002foutput-1"></a>
<h2 class="chapter">27 Terminal input/output</h2>
@@ -16295,36 +21566,74 @@ Next: <a href="#Command-line" accesskey="n" rel="next">Command line</a>, Previou
<a name="g_t_005ctypein"></a>
<div class="header">
<p>
-Next: <a href="#g_t_005ctypeout" accesskey="n" rel="next">\typeout</a>, Up: <a href="#Terminal-input_002foutput" accesskey="u" rel="up">Terminal input/output</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005ctypeout" accesskey="n" rel="next">\typeout</a>, Up: <a href="#Terminal-input_002foutput" accesskey="u" rel="up">Terminal input/output</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005ctypein_005bcmd_005d_007bmsg_007d"></a>
-<h3 class="section">27.1 <code>\typein[<var>cmd</var>]{<var>msg</var>}</code></h3>
+<a name="g_t_005ctypein-1"></a>
+<h3 class="section">27.1 <code>\typein</code></h3>
<a name="index-_005ctypein"></a>
-<p>Synopsis:
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\typein{<var>prompt-msg</var>}
+\typein[<var>cmd</var>]{<var>prompt-msg</var>}
+</pre></div>
+
+<p>Print <var>prompt-msg</var> on the terminal and cause LaTeX to stop and
+wait for you to type a line of input. This line of input ends when you
+hit the return key.
+</p>
+<p>For example, this
+</p>
+<div class="example">
+<pre class="example">As long as I live I shall never forget \typein{Enter student name:}
+</pre></div>
+
+<p>coupled with this command line interaction
+</p>
+<div class="example">
+<pre class="example">Enter student name:
+
+\@typein=Aphra Behn
+</pre></div>
+
+<p>gives the output &lsquo;<samp>... never forget Aphra Behn</samp>&rsquo;.
+</p>
+<p>The first command version, <code>\typein{<var>prompt-msg</var>}</code>, causes
+the input you typed to be processed as if it had been included in the
+input file in place of the <code>\typein</code> command.
+</p>
+<p>In the second command version the optional argument <code><var>cmd</var></code>
+argument must be a command name &mdash; it must begin with a backslash, \.
+This command name is then defined or redefined to be the input that you
+typed. For example, this
</p>
<div class="example">
-<pre class="example">\typein[\<var>cmd</var>]{<var>msg</var>}
+<pre class="example">\typein[\student]{Enter student name:}
+\typeout{Recommendation for \student .}
</pre></div>
-<p><code>\typein</code> prints <var>msg</var> on the terminal and causes LaTeX to
-stop and wait for you to type a line of input, ending with return. If
-the optional <code>\<var>cmd</var></code> argument is omitted, the typed input is
-processed as if it had been included in the input file in place of the
-<code>\typein</code> command. If the <code>\<var>cmd</var></code> argument is present, it
-must be a command name. This command name is then defined or
-redefined to be the typed input.
+<p>gives this output on the command line,
+</p>
+<div class="example">
+<pre class="example">Enter student name:
+
+\student=John Dee
+Recommendation for John Dee.
+</pre></div>
+
+<p>where the user has entered &lsquo;<samp>John Dee.</samp>&rsquo;
</p>
<hr>
<a name="g_t_005ctypeout"></a>
<div class="header">
<p>
-Previous: <a href="#g_t_005ctypein" accesskey="p" rel="prev">\typein</a>, Up: <a href="#Terminal-input_002foutput" accesskey="u" rel="up">Terminal input/output</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#g_t_005ctypein" accesskey="p" rel="prev">\typein</a>, Up: <a href="#Terminal-input_002foutput" accesskey="u" rel="up">Terminal input/output</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005ctypeout_007bmsg_007d"></a>
-<h3 class="section">27.2 <code>\typeout{<var>msg</var>}</code></h3>
+<a name="g_t_005ctypeout-1"></a>
+<h3 class="section">27.2 <code>\typeout</code></h3>
<a name="index-_005ctypeout"></a>
@@ -16334,61 +21643,352 @@ Previous: <a href="#g_t_005ctypein" accesskey="p" rel="prev">\typein</a>, Up: <a
<pre class="example">\typeout{<var>msg</var>}
</pre></div>
-<p>Prints <code>msg</code> on the terminal and in the <code>log</code> file.
-Commands in <code>msg</code> that are defined with <code>\newcommand</code> or
+<p>Print <code>msg</code> on the terminal and in the <code>log</code> file.
+</p>
+<p>This
+</p>
+<div class="example">
+<pre class="example">\newcommand{\student}{John Dee}
+\typeout{Recommendation for \student .}
+</pre></div>
+
+<p>outputs &lsquo;<samp>Recommendation for John Dee</samp>&rsquo;. Like what happens here with
+<code>\student</code>, commands that are defined with <code>\newcommand</code> or
<code>\renewcommand</code> (among others) are replaced by their definitions
before being printed.
</p>
<p>LaTeX&rsquo;s usual rules for treating multiple spaces as a single space
-and ignoring spaces after a command name apply to <code>msg</code>. A
-<code>\space</code> command in <code>msg</code> causes a single space to be
-printed, independent of surrounding spaces. A <code>^^J</code> in
-<code>msg</code> prints a newline.
+and ignoring spaces after a command name apply to <code>msg</code>. As above,
+use the command <code>\space</code> to get a single space, independent of
+surrounding spaces. Use <code>^^J</code> to get a newline. Get a percent
+character with <code>\csname @percentchar\endcsname</code>.
+</p>
+<p>This command can be useful for simple debugging, as here:
+</p>
+<div class="example">
+<pre class="example">\newlength{\jhlength}
+\setlength{\jhlength}{5pt}
+\typeout{The length is \the\jhlength.}
+</pre></div>
+
+<p>produces on the command line &lsquo;<samp>The length is 5.0pt</samp>&rsquo;.
</p>
<hr>
<a name="Command-line"></a>
<div class="header">
<p>
-Next: <a href="#Document-templates" accesskey="n" rel="next">Document templates</a>, Previous: <a href="#Terminal-input_002foutput" accesskey="p" rel="prev">Terminal input/output</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Document-templates" accesskey="n" rel="next">Document templates</a>, Previous: <a href="#Terminal-input_002foutput" accesskey="p" rel="prev">Terminal input/output</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Command-line-1"></a>
<h2 class="chapter">28 Command line</h2>
<a name="index-command-line"></a>
-<a name="index-_002etex_002c-default-extension"></a>
-<p>The input file specification indicates the file to be formatted;
-TeX uses <samp>.tex</samp> as a default file extension. If you omit the
-input file entirely, TeX accepts input from the terminal. You can
-also specify arbitrary LaTeX input by starting with a backslash.
-For example, this processes <samp>foo.tex</samp> without pausing after every
-error:
+<p>Synopsis (from a terminal command line):
</p>
<div class="example">
-<pre class="example">latex '\nonstopmode\input foo.tex'
+<pre class="example">pdflatex <var>options</var> <var>argument</var>
</pre></div>
+<p>Run LaTeX on <var>argument</var>. In place of <code>pdflatex</code> you can
+also use <code>xelatex</code>, or <code>lualatex</code>, or <code>dviluatex</code>, or
+<code>latex</code>.
+</p>
+<p>For example, this will run LaTeX on the file <samp>thesis.tex</samp>,
+creating the output <samp>thesis.pdf</samp>.
+</p>
+<div class="example">
+<pre class="example">pdflatex thesis
+</pre></div>
+
+<p><a name="index-_002etex_002c-default-extension"></a>
+Note that <samp>.tex</samp> is the default file extension.
+</p>
+<p>pdfTeX is a development of the original TeX program, as are
+XeTeX and LuaTeX (see <a href="#TeX-engines">TeX engines</a>). They are completely
+backward compatible. But the original program had a custom output
+format, DVI, while the newer ones can output directly to PDF. This
+allows them to take advantage of the extra features in PDF such as
+hyperlinks, support for modern image formats such as JPG and PNG, and
+ubiquitous viewing programs. In short, if you run <code>pdflatex</code> or
+<code>xelatex</code> or <code>lualatex</code> then you will by default get PDF
+and have access to all its modern features. If you run <code>latex</code>,
+or <code>dvilualatex</code>, then you will get DVI. The description here
+assumes pdfLaTeX.
+</p>
+<p>See <a href="#Command-line-options">Command line options</a>, for a selection of the most useful
+command line options. As to <var>argument</var>, the usual case is that it
+does not begin with a backslash, so the system takes it to be the name
+of a file and it compiles that file. If <var>argument</var> begins with a
+backslash then the system will interpret it as a line of LaTeX
+input, which can be used for special effects (see <a href="#Command-line-input">Command line input</a>).
+</p>
+<p>If you gave no arguments or options then <code>pdflatex</code> prompts for
+input from the terminal. You can escape from this by entering
+<code>&lt;control&gt;-D</code>.
+</p>
+<p>If LaTeX finds an error in your document then by default it stops and
+asks you about it. See <a href="#Recovering-from-errors">Recovering from errors</a> for an outline of what
+to do.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">&bull; <a href="#Command-line-options" accesskey="1">Command line options</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Read text from the terminal.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#Command-line-input" accesskey="2">Command line input</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Write text to the terminal.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#Recovering-from-errors" accesskey="3">Recovering from errors</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">When something goes wrong.
+</td></tr>
+</table>
+
+
+<hr>
+<a name="Command-line-options"></a>
+<div class="header">
+<p>
+Next: <a href="#Command-line-input" accesskey="n" rel="next">Command line input</a>, Up: <a href="#Command-line" accesskey="u" rel="up">Command line</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Command-line-options-1"></a>
+<h3 class="section">28.1 Command line options</h3>
+
+<a name="index-options_002c-command-line"></a>
+
+<p>These are the command-line options relevant to ordinary document
+authoring. For a full list, try running &lsquo;<samp>latex --help</samp>&rsquo; from the
+command line.
+</p>
+<p>With many implementations you can specify command line options by
+prefixing them with &lsquo;<samp>-</samp>&rsquo; or &lsquo;<samp>--</samp>&rsquo;. This is the case for
+both TeX Live (and MacTeX) and MiKTeX. We will use both
+conventions interchangeably.
+</p>
+<dl compact="compact">
+<dd><a name="index-_002d_002dversion-command_002dline-option"></a>
+</dd>
+<dt><code>-version</code></dt>
+<dd><p>Show the current version, like &lsquo;<samp>pdfTeX 3.14159265-2.6-1.40.16 (TeX
+Live 2015/Debian)</samp>&rsquo; along with a small amount of additional information,
+and exit.
+</p>
<a name="index-_002d_002dhelp-command_002dline-option"></a>
-<p>With many, but not all, implementations, command-line options can also
-be specified in the usual Unix way, starting with &lsquo;<samp>-</samp>&rsquo; or
-&lsquo;<samp>--</samp>&rsquo;. For a list of those options, try &lsquo;<samp>latex --help</samp>&rsquo;.
+</dd>
+<dt><code>-help</code></dt>
+<dd><p>Give a brief usage message that is useful as a prompt and exit.
+</p>
+<a name="index-_002d_002dinteraction-command_002dline-option"></a>
+</dd>
+<dt><code>-interaction=<var>mode</var></code></dt>
+<dd><p>TeX compiles a document in one of four interaction modes:
+<code>batchmode</code>, <code>nonstopmode</code>, <code>scrollmode</code>,
+<code>errorstopmode</code>. In <em>errorstop mode</em> (the default), TeX
+stops at each error and asks for user intervention. In <em>batch
+mode</em> it prints nothing on the terminal, errors are scrolled as if the
+user hit <code>&lt;return&gt;</code> at every error, and missing files cause the
+job to abort. In <em>nonstop mode</em>, diagnostic message appear on the
+terminal but as in batch mode there is no user interaction. In
+<em>scroll mode</em>, TeX only stops for missing files or keyboard
+input.
+</p>
+<p>For instance, starting LaTeX with this command line
+</p>
+<div class="example">
+<pre class="example">pdflatex -interaction=batchmode <var>filename</var>
+</pre></div>
+
+<p>eliminates most terminal output.
+</p>
+<a name="index-_002d_002djobname-command_002dline-option"></a>
+</dd>
+<dt><code>-jobname=<var>string</var></code></dt>
+<dd><p>Set the value of TeX&rsquo;s <code>jobname</code> to the string. The log file
+and output file will then be named <samp><var>string</var>.log</samp> and
+<samp><var>string</var>.pdf</samp>.
+</p>
+<p>When you run <code><code>pdflatex</code> <var>options</var> <var>argument</var></code>, if
+<var>argument</var> does not start with a backslash then TeX considers it
+the name of a file to input. Otherwise it waits for the first
+<code>\input</code> instruction and the name of the input file will be the job
+name. This is used to name the log file the output file. This option
+overrides that process and directly specifies the name. See <a href="#Command-line-input">Command line input</a> for an example of its use.
+</p>
+<a name="index-_002d_002doutput_002ddirectory-command_002dline-option"></a>
+</dd>
+<dt><code>-output-directory=<var>directory</var></code></dt>
+<dd><p>Write files in the directory <var>directory</var>. It must already exist.
+</p>
+<a name="index-_002d_002dshell_002descape-command_002dline-option"></a>
+<a name="index-_002d_002dno_002dshell_002descape-command_002dline-option"></a>
+<a name="index-_002d_002denable_002dwrite18-command_002dline-option"></a>
+<a name="index-_002d_002ddisable_002dwrite18-command_002dline-option"></a>
+</dd>
+<dt><code>shell-escape</code></dt>
+<dt><code>no-shell-escape</code></dt>
+<dt><code>enable-write18</code></dt>
+<dt><code>disable-write18</code></dt>
+<dd><p>Enable or disable <code>\write18{<var>shell command</var>}</code>. The first two
+options are for with TeX Live or MacTeX while the second two are
+for MiKTeX.
+</p>
+<a name="index-package_002c-sagetex"></a>
+<a name="index-sagetex-package"></a>
+
+<p>Sometimes you want to run external system commands from inside a
+LaTeX file. For instance the package <samp>sagetex</samp> allows you to
+have the mathematics software system <i>Sage</i> do calculations or draw
+graphs and then incorporate that output in your document. For this
+TeX provides the <code>\write18</code> command.
+</p>
+<p>But with this functionality enabled, security issues could happen if you
+compiled a LaTeX file from the Internet. By default <code>\write18</code>
+is disabled. (More precisely, by default TeX Live, MacTeX, and
+MiKTeX only allow the execution of a limited number of TeX-related
+programs, which they distribute.)
+</p>
+<p>If you invoke LaTeX with the option <code>no-shell-escape</code>, and in
+your document you call <code>\write18{ls -l}</code>, then you do not get an
+error but the log file says &lsquo;<samp>runsystem(ls -l)...disabled</samp>&rsquo;.
+</p>
+<a name="index-_002d_002dhalt_002don_002derror-command_002dline-option"></a>
+</dd>
+<dt><code>-halt-on-error</code></dt>
+<dd><p>Stop processing at the first error.
+</p>
+<a name="index-_002d_002dfile_002dline_002derror-command_002dline-option"></a>
+<a name="index-_002d_002dno_002dfile_002dline_002derror-command_002dline-option"></a>
+</dd>
+<dt><code>-file-line-error</code></dt>
+<dt><code>-no-file-line-error</code></dt>
+<dd><p>Enable or disable <code><var>filename</var>:<var>lineno</var>:<var>error</var></code>-style
+error messages. These are only available with TeX Live or MacTeX.
+</p></dd>
+</dl>
+
+
+<hr>
+<a name="Command-line-input"></a>
+<div class="header">
+<p>
+Next: <a href="#Recovering-from-errors" accesskey="n" rel="next">Recovering from errors</a>, Previous: <a href="#Command-line-options" accesskey="p" rel="prev">Command line options</a>, Up: <a href="#Command-line" accesskey="u" rel="up">Command line</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Command-line-input-1"></a>
+<h3 class="section">28.2 Command line input</h3>
+
+<a name="index-input_002c-on-command-line"></a>
+
+<p>As part of the command line invocation <code>pdflatex <var>options</var>
+<var>argument</var></code> you can specify arbitrary LaTeX input by starting
+<var>argument</var> with a backslash. This allows you to do some special
+effects.
+</p>
+<a name="index-package_002c-hyperref-3"></a>
+<a name="index-hyperref-package-3"></a>
+
+<p>For example, this file (which uses the <samp>hyperref</samp> package for
+hyperlinks) can produce two kinds of output, one for paper and one for a
+PDF.
+</p>
+<div class="example">
+<pre class="example">\ifdefined\paperversion % in preamble
+\newcommand{\urlcolor}{black}
+\else
+\newcommand{\urlcolor}{blue}
+\fi
+\usepackage[colorlinks=true,urlcolor=\urlcolor]{hyperref}
+ ...
+\href{https://www.ctan.org}{CTAN} % in body
+ ...
+</pre></div>
+
+<p>Compiling this document <samp>book.tex</samp> with the command line
+<code>pdflatex test</code> will give the &lsquo;<samp>CTAN</samp>&rsquo; link in blue. But
+compiling it with <code>pdflatex &quot;\def\paperversion{}\input test.tex&quot;</code>
+has the link in black. (Note the use of double quotes to prevent
+interpretation of the symbols by the command line shell; your system may
+do this differently.)
+</p>
+<p>In a similar way, from the single file <samp>main.tex</samp> you can compile
+two different versions.
+</p>
+<div class="example">
+<pre class="example">pdflatex -jobname=students &quot;\def\student{}\input{main}&quot;
+pdflatex -jobname=teachers &quot;\def\teachers{}\input{main}&quot;
+</pre></div>
+
+<p>The <code>jobname</code> option is there because otherwise both files would be
+called <samp>main.pdf</samp> and the second would overwrite the first.
+</p>
+<p>A final example. This loads the package <samp>graphicx</samp> with the option
+<code>draft</code>
+</p>
+<div class="example">
+<pre class="example">pdflatex -jobname=aa &quot;\RequirePackage[draft]{graphicx}\input{aa.tex}&quot;
+</pre></div>
+
+<p>so the graphic files are read for their size information but not
+incorporated into the PDF. (The <code>jobname</code> option is needed because
+otherwise the output file would be <samp>graphicx.pdf</samp>, as
+<code>\RequirePackage</code> does an <code>\input</code> of its own.)
+</p>
+
+<hr>
+<a name="Recovering-from-errors"></a>
+<div class="header">
+<p>
+Previous: <a href="#Command-line-input" accesskey="p" rel="prev">Command line input</a>, Up: <a href="#Command-line" accesskey="u" rel="up">Command line</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Recovering-from-errors-1"></a>
+<h3 class="section">28.3 Recovering from errors</h3>
+
+<p>If LaTeX finds an error in your document then it gives you an error
+message and prompts you with a question mark, <code>?</code>. For instance,
+running LaTeX on this file
+</p>
+<div class="example">
+<pre class="example">\newcommand{\NP}{\ensuremath{\textbf{NP}}}
+The \PN{} problem is a million dollar one.
+</pre></div>
+
+<p>causes it show this, and wait for input.
+</p>
+<div class="example">
+<pre class="example">! Undefined control sequence.
+l.5 The \PN
+ {} problem is a million dollar one.
+?
+</pre></div>
+
+<p>The simplest thing is to enter &lsquo;<samp>x</samp>&rsquo; and <code>&lt;return&gt;</code> and fix the
+typo. You could instead enter &lsquo;<samp>?</samp>&rsquo; and <code>&lt;return&gt;</code> to see other
+options.
</p>
<a name="index-_002a-prompt"></a>
<a name="index-prompt_002c-_002a"></a>
<a name="index-_005cstop"></a>
-<p>If LaTeX stops in the middle of the document and gives you a
-&lsquo;<samp>*</samp>&rsquo; prompt, it is waiting for input. You can type <code>\stop</code>
-(and return) and it will prematurely end the document.
+<p>There are two other error scenarios. The first is that you forgot to
+include the <code>\end{document}</code> or misspelled it. In this case
+LaTeX gives you a &lsquo;<samp>*</samp>&rsquo; prompt. You can get back to the command
+line by typing <code>\stop</code> and <code>&lt;return&gt;</code>.
</p>
-<p>See <a href="#TeX-engines">TeX engines</a>, for other system commands invoking LaTeX.
+<p>The last scenario is that you mistyped the file name. For instance,
+instead of <code>pdflatex test</code> you might type <code>pdflatex tste</code>.
+</p>
+<div class="example">
+<pre class="example">! I can't find file `tste'.
+&lt;*&gt; tste
+
+(Press Enter to retry, or Control-D to exit)
+Please type another input file name:
+</pre></div>
+
+<p>The simplest thing is to enter <code>&lt;Contol&gt;</code> and &lsquo;<samp>d</samp>&rsquo; (holding
+them down at the same time), and just fix the command line.
</p>
<hr>
<a name="Document-templates"></a>
<div class="header">
<p>
-Next: <a href="#Concept-Index" accesskey="n" rel="next">Concept Index</a>, Previous: <a href="#Command-line" accesskey="p" rel="prev">Command line</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Command-line" accesskey="p" rel="prev">Command line</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Document-templates-1"></a>
<h2 class="appendix">Appendix A Document templates</h2>
@@ -16403,9 +22003,13 @@ be useful. Additional template resources are listed at
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#beamer-template" accesskey="1">beamer template</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#book-template" accesskey="2">book template</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#article-template" accesskey="2">article template</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#book-template" accesskey="3">book template</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#Larger-book-template" accesskey="4">Larger book template</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tugboat-template" accesskey="3">tugboat template</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tugboat-template" accesskey="5">tugboat template</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>
@@ -16414,7 +22018,7 @@ be useful. Additional template resources are listed at
<a name="beamer-template"></a>
<div class="header">
<p>
-Next: <a href="#book-template" accesskey="n" rel="next">book template</a>, Up: <a href="#Document-templates" accesskey="u" rel="up">Document templates</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#article-template" accesskey="n" rel="next">article template</a>, Up: <a href="#Document-templates" accesskey="u" rel="up">Document templates</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="beamer-template-1"></a>
<h3 class="section">A.1 <code>beamer</code> template</h3>
@@ -16452,16 +22056,47 @@ array of features, but here is a basic template:
</p>
<hr>
+<a name="article-template"></a>
+<div class="header">
+<p>
+Next: <a href="#book-template" accesskey="n" rel="next">book template</a>, Previous: <a href="#beamer-template" accesskey="p" rel="prev">beamer template</a>, Up: <a href="#Document-templates" accesskey="u" rel="up">Document templates</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="article-template-1"></a>
+<h3 class="section">A.2 <code>article</code> template</h3>
+
+<a name="index-template_002c-article"></a>
+
+<pre class="verbatim">\documentclass{article}
+\title{Article Class Template}
+\author{Alex Author}
+
+\begin{document}
+\maketitle
+
+\section{First section}
+Some text.
+
+\subsection{First section, first subsection}
+Additional text.
+
+\section{Second section}
+Some more text.
+\end{document}
+</pre>
+
+<hr>
<a name="book-template"></a>
<div class="header">
<p>
-Next: <a href="#tugboat-template" accesskey="n" rel="next">tugboat template</a>, Previous: <a href="#beamer-template" accesskey="p" rel="prev">beamer template</a>, Up: <a href="#Document-templates" accesskey="u" rel="up">Document templates</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Larger-book-template" accesskey="n" rel="next">Larger book template</a>, Previous: <a href="#article-template" accesskey="p" rel="prev">article template</a>, Up: <a href="#Document-templates" accesskey="u" rel="up">Document templates</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="book-template-1"></a>
-<h3 class="section">A.2 <code>book</code> template</h3>
+<h3 class="section">A.3 <code>book</code> template</h3>
<a name="index-template_002c-book"></a>
+<p>This is a straightforward template for a book. See See <a href="#Larger-book-template">Larger book template</a> for a more elaborate one.
+</p>
<pre class="verbatim">\documentclass{book}
\title{Book Class Template}
\author{Alex Author}
@@ -16481,13 +22116,73 @@ The end.
</pre>
<hr>
+<a name="Larger-book-template"></a>
+<div class="header">
+<p>
+Next: <a href="#tugboat-template" accesskey="n" rel="next">tugboat template</a>, Previous: <a href="#book-template" accesskey="p" rel="prev">book template</a>, Up: <a href="#Document-templates" accesskey="u" rel="up">Document templates</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Larger-book-template-1"></a>
+<h3 class="section">A.4 Larger <code>book</code> template</h3>
+
+<a name="index-template_002c-book-1"></a>
+
+<p>This is a more elaborate template for a book. It has
+<code>\frontmatter</code>, <code>\mainmatter</code>, and <code>\backmatter</code> to
+control the typography of the three main areas of a book
+(see <a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter &amp; \mainmatter &amp; \backmatter</a>). The book has a
+bibliography and an index.
+</p>
+<p>Notable is that it uses <code>\include</code> and <code>\includeonly</code>
+(see <a href="#Splitting-the-input">Splitting the input</a>). While you are working on a chapter you
+can comment out all the other chapter entries from the argument to
+<code>\includeonly</code>. That will speed up compilation without losing any
+information such as cross-references. (Material that does not need to
+come on a new page is brought in with <code>\input</code> instead of
+<code>\include</code>. You don&rsquo;t get the cross-reference benefit this way.)
+</p>
+<pre class="verbatim">\documentclass[titlepage]{book}
+\usepackage{makeidx}\makeindex
+
+\title{Book Class Template}
+\author{Alex Author}
+
+\includeonly{%
+ frontcover,
+ preface,
+ chap1,
+ ...
+ }
+\begin{document}
+\frontmatter
+\include{frontcover}
+ % maybe comment out while drafting:
+\maketitle \input{dedication} \input{copyright}
+\tableofcontents
+\include{preface}
+\mainmatter
+\include{chap1}
+...
+\appendix
+\include{appena}
+...
+\backmatter
+\bibliographystyle{apalike}
+\addcontentsline{toc}{chapter}{Bibliography}
+\bibliography
+\addcontentsline{toc}{chapter}{Index}
+\printindex
+\include{backcover}
+\end{document}
+</pre>
+
+<hr>
<a name="tugboat-template"></a>
<div class="header">
<p>
-Previous: <a href="#book-template" accesskey="p" rel="prev">book template</a>, Up: <a href="#Document-templates" accesskey="u" rel="up">Document templates</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Larger-book-template" accesskey="p" rel="prev">Larger book template</a>, Up: <a href="#Document-templates" accesskey="u" rel="up">Document templates</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="tugboat-template-1"></a>
-<h3 class="section">A.3 <code>tugboat</code> template</h3>
+<h3 class="section">A.5 <code>tugboat</code> template</h3>
<a name="index-template_002c-TUGboat"></a>
<a name="index-TUGboat-template"></a>
@@ -16578,1010 +22273,149 @@ Email \verb|tugboat@tug.org| if problems or questions.
</pre>
<hr>
-<a name="Concept-Index"></a>
+<a name="Index"></a>
<div class="header">
<p>
-Next: <a href="#Command-Index" accesskey="n" rel="next">Command Index</a>, Previous: <a href="#Document-templates" accesskey="p" rel="prev">Document templates</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Document-templates" accesskey="p" rel="prev">Document templates</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Concept-Index-1"></a>
-<h2 class="unnumbered">Concept Index</h2>
+<a name="Index-1"></a>
+<h2 class="unnumbered">Index</h2>
-<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Concept-Index_cp_symbol-1"><b>*</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_symbol-2"><b>.</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_symbol-3"><b>`</b></a>
- &nbsp;
-<br>
-<a class="summary-letter" href="#Concept-Index_cp_letter-A"><b>A</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-B"><b>B</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-C"><b>C</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-D"><b>D</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-E"><b>E</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-F"><b>F</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-G"><b>G</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-H"><b>H</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-I"><b>I</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-J"><b>J</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-K"><b>K</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-L"><b>L</b></a>
+<a name="Command-Index"></a>
+<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>&amp;</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-M"><b>M</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-2"><b>*</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-N"><b>N</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-3"><b>-</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-O"><b>O</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-4"><b>.</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-P"><b>P</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-5"><b>1</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-Q"><b>Q</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-6"><b>:</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-R"><b>R</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-7"><b>[</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-S"><b>S</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-8"><b>\</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-T"><b>T</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-9"><b>^</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-U"><b>U</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-10"><b>_</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-V"><b>V</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-11"><b>`</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-W"><b>W</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-12"><b>{</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-X"><b>X</b></a>
- &nbsp;
-</td></tr></table>
-<table class="index-cp" border="0">
-<tr><td></td><th align="left">Index Entry</th><td>&nbsp;</td><th align="left"> Section</th></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_symbol-1">*</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002a-prompt">&lsquo;<samp>*</samp>&rsquo; prompt</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line">Command line</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002a_002dform-of-environment-commands"><code>*</code>-form of environment commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment &amp; \renewenvironment</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002a_002dform-of-sectioning-commands"><code>*</code>-form of sectioning commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002a_002dform_002c-defining-new-commands">*-form, defining new commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_symbol-2">.</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002eglo-file"><samp>.glo</samp> file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002eidx-file"><samp>.idx</samp> file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002eind-file"><samp>.ind</samp> file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_symbol-3">`</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0060see_0027-and-_0060see-also_0027-index-entries">&lsquo;see&rsquo; and &lsquo;see also&rsquo; index entries</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-A">A</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-abstracts">abstracts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#abstract">abstract</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-accents">accents</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-accents_002c-mathematical">accents, mathematical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-accessing-any-character-of-a-font">accessing any character of a font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Symbols-by-font-position">Symbols by font position</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-acute-accent">acute accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-acute-accent_002c-math">acute accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-additional-packages_002c-loading">additional packages, loading</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ae-ligature">ae ligature</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-algorithm2e-package"><code>algorithm2e</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-align-environment_002c-from-amsmath">align <span class="roman">environment, from <code>amsmath</code></span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-aligning-equations">aligning equations</a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-alignment-via-tabbing">alignment via tabbing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-amsmath-package"><code>amsmath</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-amsmath-package-1"><code>amsmath</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#displaymath">displaymath</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-amsmath-package_002c-replacing-eqnarray">amsmath <span class="roman">package, replacing <code>eqnarray</code></span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-appendix_002c-creating">appendix, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-aring">aring</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-arrays_002c-math">arrays, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-arrow_002c-left_002c-in-text">arrow, left, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-arrow_002c-right_002c-in-text">arrow, right, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ascender-height">ascender height</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ASCII-circumflex_002c-in-text">ASCII circumflex, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ASCII-tilde_002c-in-text">ASCII tilde, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-asterisk_002c-centered_002c-in-text">asterisk, centered, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-at-clause_002c-in-font-definitions">at clause, in font definitions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-author_002c-for-titlepage">author, for titlepage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-auxiliary-file">auxiliary file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-B">B</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-babel-package"><code>babel</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-babel-package-1"><code>babel</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-background_002c-colored">background, colored</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-pages">Colored pages</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-backslash_002c-in-text">backslash, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bar_002c-double-vertical_002c-in-text">bar, double vertical, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bar_002c-vertical_002c-in-text">bar, vertical, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bar_002dover-accent">bar-over accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bar_002dover-accent_002c-math">bar-over accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bar_002dunder-accent">bar-under accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-basics-of-LaTeX">basics of LaTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-beamer-template-and-class"><code>beamer</code> template and class</a>:</td><td>&nbsp;</td><td valign="top"><a href="#beamer-template">beamer template</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-beginning-of-document-hook">beginning of document hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cAtBeginDocument">\AtBeginDocument</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bibliography-format_002c-open">bibliography format, open</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bibliography_002c-creating-_0028automatically_0029">bibliography, creating (automatically)</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-BibTeX">Using BibTeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bibliography_002c-creating-_0028manually_0029">bibliography, creating (manually)</a>:</td><td>&nbsp;</td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bibTeX_002c-using">bibTeX, using</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-BibTeX">Using BibTeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-big-circle-symbols_002c-in-text">big circle symbols, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Big-point">Big point</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-black-boxes_002c-omitting">black boxes, omitting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bold-font">bold font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bold-math">bold math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bold-typewriter_002c-avoiding">bold typewriter, avoiding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#description">description</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-box_002c-allocating-new">box, allocating new</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewsavebox">\newsavebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-box_002c-colored">box, colored</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-boxes">Colored boxes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-boxes">boxes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Boxes">Boxes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-brace_002c-left_002c-in-text">brace, left, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-brace_002c-right_002c-in-text">brace, right, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-breaking-lines">breaking lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Line-breaking">Line breaking</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-breaking-pages">breaking pages</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-breaking">Page breaking</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-breve-accent">breve accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-breve-accent_002c-math">breve accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bug-reporting">bug reporting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bullet-symbol">bullet symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bullet_002c-in-text">bullet, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-bulleted-lists">bulleted lists</a>:</td><td>&nbsp;</td><td valign="top"><a href="#itemize">itemize</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-C">C</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-calligraphic-letters-for-math">calligraphic letters for math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-cap-height">cap height</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-caron-accent">caron accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-catcode">catcode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-category-code_002c-character">category code, character</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-cc-list_002c-in-letters">cc list, in letters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ccc">\cc</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-cedilla-accent">cedilla accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-centered-asterisk_002c-in-text">centered asterisk, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-centered-equations">centered equations</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-centered-period_002c-in-text">centered period, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-centering-text_002c-declaration-for">centering text, declaration for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ccentering">\centering</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-centering-text_002c-environment-for">centering text, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#center">center</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Centimeter">Centimeter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-character-category-code">character category code</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-characters_002c-accented">characters, accented</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-characters_002c-case">characters, case</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-characters_002c-non_002dEnglish">characters, non-English</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-characters_002c-reserved">characters, reserved</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-characters_002c-special">characters, special</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-check-accent">check accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-check-accent_002c-math">check accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Cicero">Cicero</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-circle-symbol_002c-big_002c-in-text">circle symbol, big, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-circled-letter_002c-in-text">circled letter, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-circumflex-accent">circumflex accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-circumflex-accent_002c-math">circumflex accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-circumflex_002c-ASCII_002c-in-text">circumflex, ASCII, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-citation-key">citation key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbibitem">\bibitem</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-class-and-package-commands">class and package commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-class-and-package-difference">class and package difference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-construction">Class and package construction</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-class-and-package-structure">class and package structure</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-class-file-example">class file example</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-class-file-layout">class file layout</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-class-options">class options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-class-options-1">class options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-class-options-2">class options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-classes-of-documents">classes of documents</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-classes">Document classes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-closing-letters">closing letters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclosing">\closing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-closing-quote">closing quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-code_002c-typesetting">code, typesetting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color">color</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Color">Color</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-1">color</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Define-colors">Define colors</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-2">color</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-text">Colored text</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-3">color</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-boxes">Colored boxes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-4">color</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-pages">Colored pages</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-models">color models</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Color-models">Color models</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-package-commands">color package commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Commands-for-color">Commands for color</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color-package-options">color package options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Color-package-options">Color package options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-color_002c-define">color, define</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Define-colors">Define colors</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-colored-boxes">colored boxes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-boxes">Colored boxes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-colored-page">colored page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-pages">Colored pages</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-colored-text">colored text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-text">Colored text</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-command-line">command line</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line">Command line</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-command-syntax">command syntax</a>:</td><td>&nbsp;</td><td valign="top"><a href="#LaTeX-command-syntax">LaTeX command syntax</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-commands_002c-class-and-package">commands, class and package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-commands_002c-defining-new-ones">commands, defining new ones</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-commands_002c-defining-new-ones-1">commands, defining new ones</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprovidecommand">\providecommand</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-commands_002c-document-class">commands, document class</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-construction">Class and package construction</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-commands_002c-graphics-package">commands, graphics package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Commands-for-graphics">Commands for graphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-commands_002c-ignore-spaces">commands, ignore spaces</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cignorespaces-_0026-_005cignorespacesafterend">\ignorespaces &amp; \ignorespacesafterend</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-commands_002c-redefining">commands, redefining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-commands_002c-star_002dvariants">commands, star-variants</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0040ifstar">\@ifstar</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-composite-word-mark_002c-in-text">composite word mark, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-computer-programs_002c-typesetting">computer programs, typesetting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-configuration_002c-graphics-package">configuration, graphics package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-contents-file">contents file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-copyright-symbol">copyright symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-counters_002c-a-list-of">counters, a list of</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Counters">Counters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-counters_002c-defining-new">counters, defining new</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcounter">\newcounter</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-counters_002c-getting-value-of">counters, getting value of</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cvalue">\value</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-counters_002c-printing">counters, printing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-counters_002c-setting">counters, setting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csetcounter">\setcounter</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-creating-pictures">creating pictures</a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-creating-tables">creating tables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#table">table</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-credit-footnote">credit footnote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-cross-references">cross references</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-cross-references_002c-resolving">cross references, resolving</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-cross-referencing-with-page-number">cross referencing with page number</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpageref">\pageref</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-cross-referencing_002c-symbolic">cross referencing, symbolic</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-currency_002c-dollar">currency, dollar</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-currency_002c-euro">currency, euro</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-D">D</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dagger_002c-double_002c-in-text">dagger, double, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dagger_002c-in-text">dagger, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dagger_002c-in-text-1">dagger, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-date_002c-for-titlepage">date, for titlepage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-date_002c-today_0027s">date, today&rsquo;s</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-datetime-package"><code>datetime</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-define-color">define color</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Define-colors">Define colors</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-defining-a-new-command">defining a new command</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-defining-a-new-command-1">defining a new command</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprovidecommand">\providecommand</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-defining-new-environments">defining new environments</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment &amp; \renewenvironment</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-defining-new-fonts">defining new fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-defining-new-theorems">defining new theorems</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewtheorem">\newtheorem</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-definitions">definitions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Definitions">Definitions</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-description-lists_002c-creating">description lists, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#description">description</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-design-size_002c-in-font-definitions">design size, in font definitions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Didot-point">Didot point</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dieresis-accent">dieresis accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-difference-between-class-and-package">difference between class and package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-construction">Class and package construction</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-discretionary-hyphenation">discretionary hyphenation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cdiscretionary">\discretionary</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-discretionary-multiplication">discretionary multiplication</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-displaying-quoted-text-with-paragraph-indentation">displaying quoted text with paragraph indentation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-and-quote">quotation and quote</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-displaying-quoted-text-without-paragraph-indentation">displaying quoted text without paragraph indentation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-and-quote">quotation and quote</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-document-class-commands">document class commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-construction">Class and package construction</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-document-class-options">document class options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-document-class_002c-defined">document class, defined</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-document-classes">document classes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-classes">Document classes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-document-templates">document templates</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-templates">Document templates</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dollar-sign">dollar sign</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dot-accent">dot accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dot-over-accent_002c-math">dot over accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dot_002dover-accent">dot-over accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dot_002dunder-accent">dot-under accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dotless-i">dotless i</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dotless-i_002c-math">dotless i, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dotless-j">dotless j</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dotless-j_002c-math">dotless j, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-double-angle-quotation-marks">double angle quotation marks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-double-dagger_002c-in-text">double dagger, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-double-dagger_002c-in-text-1">double dagger, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-double-dot-accent_002c-math">double dot accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-double-guillemets">double guillemets</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-double-left-quote">double left quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-double-low_002d9-quotation-mark">double low-9 quotation mark</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-double-quote_002c-straight-base">double quote, straight base</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-double-right-quote">double right quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-double-spacing">double spacing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-double-vertical-bar_002c-in-text">double vertical bar, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-E">E</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-e_002ddash">e-dash</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-e_002dTeX">e-TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ellipsis">ellipsis</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-em">em</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-em_002ddash">em-dash</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-em_002ddash_002c-three_002dquarters">em-dash, three-quarters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-em_002ddash_002c-two_002dthirds">em-dash, two-thirds</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-emphasis">emphasis</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-enclosure-list">enclosure list</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cencl">\encl</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-end-of-document-hook">end of document hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cAtEndDocument">\AtEndDocument</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ending-and-starting">ending and starting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-engines_002c-TeX">engines, TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-enlarge-current-page">enlarge current page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cenlargethispage">\enlargethispage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-enumitem-package"><code>enumitem</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-environment">environment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-environment_002c-theorem_002dlike">environment, theorem-like</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewtheorem">\newtheorem</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-environments">environments</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Environments">Environments</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-environments_002c-defining">environments, defining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment &amp; \renewenvironment</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-EPS-files">EPS files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-EPS-files-1">EPS files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-equation-number_002c-cross-referencing">equation number, cross referencing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-equation-numbers_002c-left-vs_002e-right">equation numbers, left vs. right</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-equation-numbers_002c-omitting">equation numbers, omitting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-equations_002c-aligning">equations, aligning</a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-equations_002c-environment-for">equations, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#equation">equation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-equations_002c-flush-left-vs_002e-centered">equations, flush left vs. centered</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-es_002dzet-German-letter">es-zet German letter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-eth_002c-Icelandic-letter">eth, Icelandic letter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-etoolbox-package"><code>etoolbox</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-euro-symbol">euro symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ex">ex</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-exclamation-point_002c-upside_002ddown">exclamation point, upside-down</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-exponent">exponent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts &amp; superscripts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-extended-Latin">extended Latin</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-external-files_002c-writing">external files, writing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#filecontents">filecontents</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-F">F</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-families_002c-of-fonts">families, of fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fancyvrb-package"><code>fancyvrb</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-feminine-ordinal-symbol">feminine ordinal symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-figure-number_002c-cross-referencing">figure number, cross referencing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-figures_002c-footnotes-in">figures, footnotes in</a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-figures_002c-inserting">figures, inserting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#figure">figure</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-file_002c-root">file, root</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-the-input">Splitting the input</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fixed_002dwidth-font">fixed-width font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-flafter-package"><code>flafter</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-float-package"><code>float</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-float-page">float page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-flush-left-equations">flush left equations</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-flushing-floats-and-starting-a-page">flushing floats and starting a page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclearpage">\clearpage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-font-catalogue">font catalogue</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-font-commands_002c-low_002dlevel">font commands, low-level</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-font-size">font size</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-font-sizes">font sizes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-font-styles">font styles</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-font-symbols_002c-by-number">font symbols, by number</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Symbols-by-font-position">Symbols by font position</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts">fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Fonts">Fonts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fonts_002c-new-commands-for">fonts, new commands for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-footer-style">footer style</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-footer_002c-parameters-for">footer, parameters for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-footmisc-package"><code>footmisc</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes-in-section-headings">Footnotes in section headings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-footnote-number_002c-cross-referencing">footnote number, cross referencing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-footnote-parameters">footnote parameters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnote-parameters">Footnote parameters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-footnotes-in-figures">footnotes in figures</a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-footnotes_002c-creating">footnotes, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes">Footnotes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Footnotes_002c-in-a-minipage">Footnotes, in a minipage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Footnotes_002c-in-a-table">Footnotes, in a table</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes-in-a-table">Footnotes in a table</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-footnotes_002c-in-section-headings">footnotes, in section headings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes-in-section-headings">Footnotes in section headings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-footnotes_002c-symbols-instead-of-numbers">footnotes, symbols instead of numbers</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-formulas_002c-environment-for">formulas, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#equation">equation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-formulas_002c-math">formulas, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-forward-reference">forward reference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-forward-references_002c-resolving">forward references, resolving</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-fragile-commands">fragile commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprotect">\protect</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-French-quotation-marks">French quotation marks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-functions_002c-math">functions, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-G">G</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-geometry-package"><code>geometry</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-geometry-package-1"><code>geometry</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-global-options">global options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-global-options-1">global options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-glossaries">glossaries</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-glossary-package">glossary <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-glue-register_002c-plain-TeX">glue register, plain TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewlength">\newlength</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics">graphics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics">Graphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics-1">graphics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics-2">graphics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics-package">graphics package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics">Graphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics-package-1">graphics package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics-package-2">graphics package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics-package-commands">graphics package commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Commands-for-graphics">Commands for graphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics-package-options">graphics package options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-options">Graphics package options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics-packages">graphics packages</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics_002c-resizing">graphics, resizing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics_002c-resizing-1">graphics, resizing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics_002c-scaling">graphics, scaling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-graphics_002c-scaling-1">graphics, scaling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-grave-accent">grave accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-grave-accent_002c-math">grave accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-greater-than-symbol_002c-in-text">greater than symbol, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-greek-letters">greek letters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-group_002c-and-environments">group, and environments</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Environments">Environments</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-H">H</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hacek-accent_002c-math">h&aacute;&#269;ek accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hacek-accent">hacek accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hat-accent">hat accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hat-accent_002c-math">hat accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-header-style">header style</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-header_002c-parameters-for">header, parameters for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hello_002c-world">hello, world</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-here_002c-putting-floats">here, putting floats</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hungarian-umlaut-accent">hungarian umlaut accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-defining">hyphenation, defining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chyphenation">\hyphenation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-discretionary">hyphenation, discretionary</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cdiscretionary">\discretionary</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-forcing">hyphenation, forcing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_002d-_0028hyphenation_0029">\- (hyphenation)</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-preventing">hyphenation, preventing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmbox">\mbox</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-I">I</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Icelandic-eth">Icelandic eth</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Icelandic-thorn">Icelandic thorn</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ij-letter_002c-Dutch">ij letter, Dutch</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-implementations-of-TeX">implementations of TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-importing-graphics">importing graphics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-in_002dline-formulas">in-line formulas</a>:</td><td>&nbsp;</td><td valign="top"><a href="#math">math</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-including-graphics">including graphics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-indent_002c-forcing">indent, forcing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindent">\indent</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-indent_002c-suppressing">indent, suppressing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnoindent">\noindent</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-indentation-of-paragraphs_002c-in-minipage">indentation of paragraphs, in minipage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-index-entries_002c-_0060see_0027-and-_0060see-also_0027">index entries, &lsquo;see&rsquo; and &lsquo;see also&rsquo;</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-indexes">indexes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-infinite-horizontal-stretch">infinite horizontal stretch</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chfill">\hfill</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-infinite-vertical-stretch">infinite vertical stretch</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cvfill">\vfill</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-input-file">input file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-the-input">Splitting the input</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-input_002foutput_002c-to-terminal">input/output, to terminal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Terminal-input_002foutput">Terminal input/output</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-inserting-figures">inserting figures</a>:</td><td>&nbsp;</td><td valign="top"><a href="#figure">figure</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-insertions-of-special-characters">insertions of special characters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Special-insertions">Special insertions</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-italic-correction">italic correction</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_002f">\/</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-italic-font">italic font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-J">J</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-JPEG-files">JPEG files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-JPEG-files-1">JPEG files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-JPG-files">JPG files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-JPG-files-1">JPG files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-justification_002c-ragged-left">justification, ragged left</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedleft">\raggedleft</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-justification_002c-ragged-right">justification, ragged right</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedright">\raggedright</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-K">K</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Knuth_002c-Donald-E_002e">Knuth, Donald E.</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-L">L</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-label">label</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-labelled-lists_002c-creating">labelled lists, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#description">description</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Lamport-TeX">Lamport TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Lamport_002c-Leslie">Lamport, Leslie</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-landscape-orientation">landscape orientation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-LaTeX-logo">LaTeX logo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-LaTeX-overview">LaTeX overview</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-LaTeX-Project-team">LaTeX Project team</a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-LaTeX-vs_002e-LaTeX2e">LaTeX vs. LaTeX2e</a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-LaTeX2e-logo">LaTeX2e logo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Latin-letters_002c-additional">Latin letters, additional</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-layout-commands">layout commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Layout">Layout</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-layout_002c-page-parameters-for">layout, page parameters for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-left-angle-quotation-marks">left angle quotation marks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-left-arrow_002c-in-text">left arrow, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-left-brace_002c-in-text">left brace, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-left-quote">left quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-left-quote_002c-double">left quote, double</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-left-quote_002c-single">left quote, single</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-left_002dhand-equation-numbers">left-hand equation numbers</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-left_002djustifying-text">left-justifying text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedright">\raggedright</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-left_002djustifying-text_002c-environment-for">left-justifying text, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#flushleft">flushleft</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-left_002dto_002dright-mode">left-to-right mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-length-command">length command</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csetlength">\setlength</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lengths_002c-adding-to">lengths, adding to</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005caddtolength">\addtolength</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lengths_002c-allocating-new">lengths, allocating new</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewlength">\newlength</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lengths_002c-defining-and-using">lengths, defining and using</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Lengths">Lengths</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lengths_002c-predefined">lengths, predefined</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Predefined-lengths">Predefined lengths</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lengths_002c-setting">lengths, setting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csetlength">\setlength</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-less-than-symbol_002c-in-text">less than symbol, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-letters_002c-accented">letters, accented</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-letters_002c-additional-Latin">letters, additional Latin</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-letters_002c-ending">letters, ending</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclosing">\closing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-letters_002c-starting">letters, starting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005copening">\opening</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-letters_002c-writing">letters, writing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Letters">Letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-line-break_002c-forcing">line break, forcing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_005c">\\</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-line-breaking">line breaking</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Line-breaking">Line breaking</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-line-breaks_002c-forcing">line breaks, forcing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005clinebreak-_0026-_005cnolinebreak">\linebreak &amp; \nolinebreak</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-line-breaks_002c-preventing">line breaks, preventing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005clinebreak-_0026-_005cnolinebreak">\linebreak &amp; \nolinebreak</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lines-in-tables">lines in tables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabular">tabular</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lining-numerals">lining numerals</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lining-text-up-in-tables">lining text up in tables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabular">tabular</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lining-text-up-using-tab-stops">lining text up using tab stops</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-list-items_002c-specifying-counter">list items, specifying counter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cusecounter">\usecounter</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-list-of-figures-file">list of figures file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-list-of-tables-file">list of tables file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-listings-package"><code>listings</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lists-of-items">lists of items</a>:</td><td>&nbsp;</td><td valign="top"><a href="#itemize">itemize</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lists-of-items_002c-generic">lists of items, generic</a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lists-of-items_002c-numbered">lists of items, numbered</a>:</td><td>&nbsp;</td><td valign="top"><a href="#enumerate">enumerate</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-loading-additional-packages">loading additional packages</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-log-file">log file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-logo_002c-LaTeX">logo, LaTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-logo_002c-LaTeX2e">logo, LaTeX2e</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-logo_002c-TeX">logo, TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-long-command">long command</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-low_002d9-quotation-marks_002c-single-and-double">low-9 quotation marks, single and double</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-low_002dlevel-font-commands">low-level font commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Lower-case">Lower case</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-LR-mode">LR mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ltugboat-class"><code>ltugboat</code> class</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tugboat-template">tugboat template</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-LuaTeX">LuaTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-M">M</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-m_002dwidth">m-width</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-macro-package_002c-LaTeX-as">macro package, LaTeX as</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-macron-accent">macron accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-macron-accent_002c-math">macron accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-macros2e-package"><code>macros2e</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Madsen_002c-Lars">Madsen, Lars</a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-makeidx-package"><code>makeidx</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-makeindex-program"><code>makeindex</code> program</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-making-a-title-page">making a title page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#titlepage">titlepage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-making-paragraphs">making paragraphs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Making-paragraphs">Making paragraphs</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-marginal-notes">marginal notes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Marginal-notes">Marginal notes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-masculine-ordinal-symbol">masculine ordinal symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-math-accents">math accents</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-math-formulas">math formulas</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-math-functions">math functions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-math-miscellany">math miscellany</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-math-mode">math mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-math-mode_002c-entering">math mode, entering</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-math-mode_002c-spacing">math mode, spacing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-math-symbols">math symbols</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-math_002c-bold">math, bold</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-mfirstuc-package"><code>mfirstuc</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Millimeter">Millimeter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-minipage_002c-creating-a">minipage, creating a</a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-minted-package"><code>minted</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-modes">modes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-monospace-font">monospace font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-moving-arguments">moving arguments</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprotect">\protect</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-mpfootnote-counter">mpfootnote counter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-mu_002c-math-unit">mu, math unit</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-multicolumn-text">multicolumn text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctwocolumn">\twocolumn</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-multilingual-support">multilingual support</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-multind-package"><code>multind</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-multiplication-symbol_002c-discretionary-line-break">multiplication symbol, discretionary line break</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-N">N</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-nested-_005cinclude_002c-not-allowed">nested <code>\include</code>, not allowed</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cinclude">\include</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-new-class-commands">new class commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-construction">Class and package construction</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-new-command_002c-check">new command, check</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-new-command_002c-definition">new command, definition</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-new-commands_002c-defining">new commands, defining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-new-commands_002c-defining-1">new commands, defining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprovidecommand">\providecommand</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-new-line_002c-output-as-input">new line, output as input</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cobeycr-_0026-_005crestorecr">\obeycr &amp; \restorecr</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-new-line_002c-starting">new line, starting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_005c">\\</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-new-line_002c-starting-_0028paragraph-mode_0029">new line, starting (paragraph mode)</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewline">\newline</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-new-page_002c-starting">new page, starting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewpage">\newpage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-non_002dEnglish-characters">non-English characters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-notes-in-the-margin">notes in the margin</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Marginal-notes">Marginal notes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-null-delimiter">null delimiter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-numbered-items_002c-specifying-counter">numbered items, specifying counter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cusecounter">\usecounter</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-numerals_002c-old_002dstyle">numerals, old-style</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-O">O</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-oblique-font">oblique font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-oe-ligature">oe ligature</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ogonek">ogonek</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-old_002dstyle-numerals">old-style numerals</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-one_002dcolumn-output">one-column output</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005conecolumn">\onecolumn</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-opening-quote">opening quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-OpenType-fonts">OpenType fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-class">options, class</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-color-package">options, color package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Color-package-options">Color package options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-document-class">options, document class</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-document-class-1">options, document class</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-global">options, global</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-graphics-package">options, graphics package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-options">Graphics package options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-package">options, package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-options_002c-package-1">options, package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ordinals_002c-feminine-and-masculine">ordinals, feminine and masculine</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-oslash">oslash</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-overbar-accent">overbar accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-overdot-accent_002c-math">overdot accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-overview-of-LaTeX">overview of LaTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-P">P</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package-file-layout">package file layout</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package-options">package options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package-options-1">package options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-algorithm2e"><span class="roman">package</span>, <code>algorithm2e</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-amsmath"><span class="roman">package</span>, <code>amsmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-amsmath-1"><span class="roman">package</span>, <code>amsmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#displaymath">displaymath</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-babel"><span class="roman">package</span>, <code>babel</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-babel-1"><span class="roman">package</span>, <code>babel</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-datetime"><span class="roman">package</span>, <code>datetime</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-enumitem"><span class="roman">package</span>, <code>enumitem</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-etoolbox"><span class="roman">package</span>, <code>etoolbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-fancyvrb"><span class="roman">package</span>, <code>fancyvrb</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-flafter"><span class="roman">package</span>, <code>flafter</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-float"><span class="roman">package</span>, <code>float</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-footmisc"><span class="roman">package</span>, <code>footmisc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes-in-section-headings">Footnotes in section headings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-geometry"><span class="roman">package</span>, <code>geometry</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-geometry-1"><span class="roman">package</span>, <code>geometry</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-listings"><span class="roman">package</span>, <code>listings</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-macros2e"><span class="roman">package</span>, <code>macros2e</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-makeidx"><span class="roman">package</span>, <code>makeidx</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-mfirstuc"><span class="roman">package</span>, <code>mfirstuc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-minted"><span class="roman">package</span>, <code>minted</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-multind"><span class="roman">package</span>, <code>multind</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-picture"><span class="roman">package</span>, <code>picture</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-setspace"><span class="roman">package</span>, <code>setspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-showidx"><span class="roman">package</span>, <code>showidx</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-textcase"><span class="roman">package</span>, <code>textcase</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-textcomp"><span class="roman">package</span>, <code>textcomp</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-xspace"><span class="roman">package</span>, <code>xspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0028SPACE_0029-after-control-sequence">\(SPACE) after control sequence</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-packages_002c-loading-additional">packages, loading additional</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page-break_002c-forcing">page break, forcing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagebreak-_0026-_005cnopagebreak">\pagebreak &amp; \nopagebreak</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page-break_002c-preventing">page break, preventing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagebreak-_0026-_005cnopagebreak">\pagebreak &amp; \nopagebreak</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page-breaking">page breaking</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-breaking">Page breaking</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page-layout-parameters">page layout parameters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page-number_002c-cross-referencing">page number, cross referencing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpageref">\pageref</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page-numbering-style">page numbering style</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagenumbering">\pagenumbering</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page-styles">page styles</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-styles">Page styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-page_002c-colored">page, colored</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-pages">Colored pages</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-paragraph-indentation_002c-in-minipage">paragraph indentation, in minipage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-paragraph-indentations-in-quoted-text">paragraph indentations in quoted text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-and-quote">quotation and quote</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-paragraph-indentations-in-quoted-text_002c-omitting">paragraph indentations in quoted text, omitting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-and-quote">quotation and quote</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-paragraph-mode">paragraph mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-paragraph-mode-1">paragraph mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cparbox">\parbox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-paragraph-symbol">paragraph symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-paragraphs">paragraphs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Making-paragraphs">Making paragraphs</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-parameters_002c-for-footnotes">parameters, for footnotes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnote-parameters">Footnote parameters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-parameters_002c-page-layout">parameters, page layout</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PDF-graphic-files">PDF graphic files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PDF-graphic-files-1">PDF graphic files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pdfTeX">pdfTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pdfTeX-engine">pdfTeX engine</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-period_002c-centered_002c-in-text">period, centered, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pica">pica</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pict2e-package"><code>pict2e</code> package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-picture-package"><code>picture</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pictures_002c-creating">pictures, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pilcrow">pilcrow</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-placement-of-floats">placement of floats</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PNG-files">PNG files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-PNG-files-1">PNG files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-poetry_002c-an-environment-for">poetry, an environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#verse">verse</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Point">Point</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-polish-l">polish l</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-portrait-orientation">portrait orientation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-position_002c-in-picture">position, in picture</a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-positional-parameter">positional parameter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-postscript_002c-in-letters">postscript, in letters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cps">\ps</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pounds-symbol">pounds symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-preamble_002c-defined">preamble, defined</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-predefined-lengths">predefined lengths</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Predefined-lengths">Predefined lengths</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-prompt_002c-_002a">prompt, &lsquo;<samp>*</samp>&rsquo;</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line">Command line</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-pronunciation">pronunciation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-Q">Q</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-quad">quad</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-question-mark_002c-upside_002ddown">question mark, upside-down</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-quotation-marks_002c-French">quotation marks, French</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-quote_002c-single-straight">quote, single straight</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-quote_002c-straight-base">quote, straight base</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-quoted-text-with-paragraph-indentation_002c-displaying">quoted text with paragraph indentation, displaying</a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-and-quote">quotation and quote</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-quoted-text-without-paragraph-indentation_002c-displaying">quoted text without paragraph indentation, displaying</a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-and-quote">quotation and quote</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-R">R</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ragged-left-text">ragged left text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedleft">\raggedleft</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ragged-left-text_002c-environment-for">ragged left text, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#flushright">flushright</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ragged-right-text">ragged right text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedright">\raggedright</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ragged-right-text_002c-environment-for">ragged right text, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#flushleft">flushleft</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-redefining-environments">redefining environments</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment &amp; \renewenvironment</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-reference_002c-forward">reference, forward</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-references_002c-resolving-forward">references, resolving forward</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-registered-symbol">registered symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-remarks-in-the-margin">remarks in the margin</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Marginal-notes">Marginal notes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-reporting-bugs">reporting bugs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-reserved-characters">reserved characters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-resizing">resizing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-resizing-1">resizing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-right-angle-quotation-marks">right angle quotation marks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-right-arrow_002c-in-text">right arrow, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-right-brace_002c-in-text">right brace, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-right-quote">right quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-right-quote_002c-double">right quote, double</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-right-quote_002c-single">right quote, single</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-right_002dhand-equation-numbers">right-hand equation numbers</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-right_002djustifying-text">right-justifying text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedleft">\raggedleft</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-right_002djustifying-text_002c-environment-for">right-justifying text, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#flushright">flushright</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ring-accent">ring accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ring-accent_002c-math">ring accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-robust-commands">robust commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprotect">\protect</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-roman-font">roman font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-root-file">root file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-the-input">Splitting the input</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-rotating-graphics">rotating graphics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005crotatebox">\rotatebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-rotating-text">rotating text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005crotatebox">\rotatebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-rotation">rotation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005crotatebox">\rotatebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-row_002c-tabbing">row, <span class="roman">tabbing</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-rubber-lengths_002c-defining-new">rubber lengths, defining new</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewlength">\newlength</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-running-header-and-footer">running header and footer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-running-header-and-footer-style">running header and footer style</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-S">S</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-sans-serif-font">sans serif font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Scaled-point">Scaled point</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-scaling">scaling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-scaling-1">scaling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-script-letters-for-math">script letters for math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-section-number_002c-cross-referencing">section number, cross referencing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-section-numbers_002c-printing">section numbers, printing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-section-symbol">section symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-section_002c-redefining">section, redefining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0040startsection">\@startsection</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-sectioning-commands">sectioning commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-series_002c-of-fonts">series, of fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-setspace-package"><code>setspace</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-setting-counters">setting counters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csetcounter">\setcounter</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-shapes_002c-of-fonts">shapes, of fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-sharp-S-letters">sharp S letters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-showidx-package"><code>showidx</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-simulating-typed-text">simulating typed text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-single-angle-quotation-marks">single angle quotation marks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-single-guillemets">single guillemets</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-single-left-quote">single left quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-single-low_002d9-quotation-mark">single low-9 quotation mark</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-single-quote_002c-straight">single quote, straight</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-single-right-quote">single right quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-sizes-of-text">sizes of text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-skip-register_002c-plain-TeX">skip register, plain TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewlength">\newlength</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-slanted-font">slanted font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-small-caps-font">small caps font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-space_002c-inserting-vertical">space, inserting vertical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005caddvspace">\addvspace</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-space_002c-vertical">space, vertical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cvspace">\vspace</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-spaces">spaces</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spaces">Spaces</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-spaces_002c-ignore-around-commands">spaces, ignore around commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cignorespaces-_0026-_005cignorespacesafterend">\ignorespaces &amp; \ignorespacesafterend</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-spacing-within-math-mode">spacing within math mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-spacing_002c-inter_002dsentence">spacing, inter-sentence</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrenchspacing">\frenchspacing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-spacing_002c-inter_002dsentence-1">spacing, inter-sentence</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnormalsfcodes">\normalsfcodes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Spanish-ordinals_002c-feminine-and-masculine">Spanish ordinals, feminine and masculine</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-special-characters">special characters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-special-characters-1">special characters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-special-insertions">special insertions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Special-insertions">Special insertions</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-specifier_002c-float-placement">specifier, float placement</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-splitting-the-input-file">splitting the input file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-the-input">Splitting the input</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-stable-option-to-footmisc-package"><code>stable</code> option to <code>footmisc</code> package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes-in-section-headings">Footnotes in section headings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-star_002dvariants_002c-commands">star-variants, commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0040ifstar">\@ifstar</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-starred-form_002c-defining-new-commands">starred form, defining new commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-starting-a-new-page">starting a new page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewpage">\newpage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-starting-a-new-page-and-clearing-floats">starting a new page and clearing floats</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclearpage">\clearpage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-starting-and-ending">starting and ending</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-starting-on-a-right_002dhand-page">starting on a right-hand page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ccleardoublepage">\cleardoublepage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-sterling-symbol">sterling symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-straight-double-quote_002c-base">straight double quote, base</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-straight-quote_002c-base">straight quote, base</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-straight-single-quote">straight single quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-stretch_002c-infinite-horizontal">stretch, infinite horizontal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chfill">\hfill</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-stretch_002c-infinite-vertical">stretch, infinite vertical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cvfill">\vfill</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-stretch_002c-omitting-vertical">stretch, omitting vertical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedbottom">\raggedbottom</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-styles-of-text">styles of text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-styles_002c-page">styles, page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-styles">Page styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-subscript">subscript</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts &amp; superscripts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-superscript">superscript</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts &amp; superscripts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-symbols_002c-math">symbols, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-symbols_002c-text">symbols, text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-T">T</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-tab-stops_002c-using">tab stops, using</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-table-of-contents-entry_002c-manually-adding">table of contents entry, manually adding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005caddcontentsline">\addcontentsline</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-table-of-contents-file">table of contents file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-table-of-contents_002c-avoiding-footnotes">table of contents, avoiding footnotes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes-in-section-headings">Footnotes in section headings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-table-of-contents_002c-creating">table of contents, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Tables-of-contents">Tables of contents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-tables_002c-creating">tables, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#table">table</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-template_002c-beamer">template, <code>beamer</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#beamer-template">beamer template</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-template_002c-book">template, <code>book</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#book-template">book template</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-template_002c-TUGboat">template, TUGboat</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tugboat-template">tugboat template</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-templates_002c-document">templates, document</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-templates">Document templates</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-terminal-input_002foutput">terminal input/output</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Terminal-input_002foutput">Terminal input/output</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TeX-logo">TeX logo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-text-symbols">text symbols</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-text_002c-resizing">text, resizing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-text_002c-resizing-1">text, resizing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-text_002c-scaling">text, scaling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-text_002c-scaling-1">text, scaling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-textcase-package"><code>textcase</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-textcomp-package"><code>textcomp</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-thanks_002c-for-titlepage">thanks, for titlepage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-theorem_002dlike-environment">theorem-like environment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewtheorem">\newtheorem</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-theorems_002c-defining">theorems, defining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewtheorem">\newtheorem</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-theorems_002c-typesetting">theorems, typesetting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#theorem">theorem</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-thorn_002c-Icelandic-letter">thorn, Icelandic letter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-three_002dquarters-em_002ddash">three-quarters em-dash</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-tie_002dafter-accent">tie-after accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-tilde-accent">tilde accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-tilde-accent_002c-math">tilde accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-tilde_002c-ASCII_002c-in-text">tilde, ASCII, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-title-page_002c-separate-or-run_002din">title page, separate or run-in</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-title-pages_002c-creating">title pages, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#titlepage">titlepage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-title_002c-for-titlepage">title, for titlepage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-titles_002c-making">titles, making</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-trademark-symbol">trademark symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-transcript-file">transcript file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TrueType-fonts">TrueType fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-TUGboat-template">TUGboat template</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tugboat-template">tugboat template</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-two_002dcolumn-output">two-column output</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctwocolumn">\twocolumn</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-two_002dthirds-em_002ddash">two-thirds em-dash</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-type-styles">type styles</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-typed-text_002c-simulating">typed text, simulating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-typeface-sizes">typeface sizes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-typefaces">typefaces</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Fonts">Fonts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-typewriter-font">typewriter font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-typewriter-labels-in-lists">typewriter labels in lists</a>:</td><td>&nbsp;</td><td valign="top"><a href="#description">description</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-U">U</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-umlaut-accent">umlaut accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-underbar">underbar</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-underscore_002c-in-text">underscore, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Unicode-input_002c-native">Unicode input, native</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-units_002c-of-length">units, of length</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-unofficial-nature-of-this-manual">unofficial nature of this manual</a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-unordered-lists">unordered lists</a>:</td><td>&nbsp;</td><td valign="top"><a href="#itemize">itemize</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Upper-case">Upper case</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-using-BibTeX">using BibTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-BibTeX">Using BibTeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-UTF_002d8">UTF-8</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-V">V</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-variables_002c-a-list-of">variables, a list of</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Counters">Counters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-vector-symbol_002c-math">vector symbol, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-verbatim-text">verbatim text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-verbatim-text_002c-inline">verbatim text, inline</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-vertical-bar_002c-double_002c-in-text">vertical bar, double, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-vertical-bar_002c-in-text">vertical bar, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-vertical-space">vertical space</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005caddvspace">\addvspace</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-vertical-space-1">vertical space</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cvspace">\vspace</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-vertical-space-before-paragraphs">vertical space before paragraphs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cparskip">\parskip</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-visible-space">visible space</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-visible-space-symbol_002c-in-text">visible space symbol, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-W">W</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-weights_002c-of-fonts">weights, of fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-white-space">white space</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spaces">Spaces</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-wide-hat-accent_002c-math">wide hat accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-wide-tilde-accent_002c-math">wide tilde accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-widths_002c-of-fonts">widths, of fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-writing-external-files">writing external files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#filecontents">filecontents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-writing-letters">writing letters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Letters">Letters</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Concept-Index_cp_letter-X">X</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-x_002dheight">x-height</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-XeTeX">XeTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-xindy-program"><code>xindy</code> program</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-xspace-package"><code>xspace</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0028SPACE_0029-after-control-sequence">\(SPACE) after control sequence</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-</table>
-<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Concept-Index_cp_symbol-1"><b>*</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_symbol-2"><b>.</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_symbol-3"><b>`</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-13"><b>~</b></a>
&nbsp;
<br>
-<a class="summary-letter" href="#Concept-Index_cp_letter-A"><b>A</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-B"><b>B</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-C"><b>C</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-D"><b>D</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-E"><b>E</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-F"><b>F</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-G"><b>G</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-H"><b>H</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-I"><b>I</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-J"><b>J</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-K"><b>K</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-L"><b>L</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-M"><b>M</b></a>
- &nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-N"><b>N</b></a>
+<a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-O"><b>O</b></a>
+<a class="summary-letter" href="#Index_cp_letter-B"><b>B</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-P"><b>P</b></a>
+<a class="summary-letter" href="#Index_cp_letter-C"><b>C</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-Q"><b>Q</b></a>
+<a class="summary-letter" href="#Index_cp_letter-D"><b>D</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-R"><b>R</b></a>
+<a class="summary-letter" href="#Index_cp_letter-E"><b>E</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-S"><b>S</b></a>
+<a class="summary-letter" href="#Index_cp_letter-F"><b>F</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-T"><b>T</b></a>
+<a class="summary-letter" href="#Index_cp_letter-G"><b>G</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-U"><b>U</b></a>
+<a class="summary-letter" href="#Index_cp_letter-H"><b>H</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-V"><b>V</b></a>
+<a class="summary-letter" href="#Index_cp_letter-I"><b>I</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-W"><b>W</b></a>
+<a class="summary-letter" href="#Index_cp_letter-J"><b>J</b></a>
&nbsp;
-<a class="summary-letter" href="#Concept-Index_cp_letter-X"><b>X</b></a>
+<a class="summary-letter" href="#Index_cp_letter-K"><b>K</b></a>
&nbsp;
-</td></tr></table>
-
-<hr>
-<a name="Command-Index"></a>
-<div class="header">
-<p>
-Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="Command-Index-1"></a>
-<h2 class="unnumbered">Command Index</h2>
-
-<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Command-Index_fn_symbol-1"><b>$</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-2"><b>&amp;</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-3"><b>-</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-4"><b>.</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-5"><b>1</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-6"><b>[</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-7"><b>\</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-8"><b>^</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-9"><b>_</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-10"><b>{</b></a>
- &nbsp;
-<br>
-<a class="summary-letter" href="#Command-Index_fn_letter-A"><b>A</b></a>
+<a class="summary-letter" href="#Index_cp_letter-L"><b>L</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-B"><b>B</b></a>
+<a class="summary-letter" href="#Index_cp_letter-M"><b>M</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-C"><b>C</b></a>
+<a class="summary-letter" href="#Index_cp_letter-N"><b>N</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-D"><b>D</b></a>
+<a class="summary-letter" href="#Index_cp_letter-O"><b>O</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-E"><b>E</b></a>
+<a class="summary-letter" href="#Index_cp_letter-P"><b>P</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-F"><b>F</b></a>
+<a class="summary-letter" href="#Index_cp_letter-Q"><b>Q</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-H"><b>H</b></a>
+<a class="summary-letter" href="#Index_cp_letter-R"><b>R</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-I"><b>I</b></a>
+<a class="summary-letter" href="#Index_cp_letter-S"><b>S</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-L"><b>L</b></a>
+<a class="summary-letter" href="#Index_cp_letter-T"><b>T</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-M"><b>M</b></a>
+<a class="summary-letter" href="#Index_cp_letter-U"><b>U</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-N"><b>N</b></a>
+<a class="summary-letter" href="#Index_cp_letter-V"><b>V</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-O"><b>O</b></a>
+<a class="summary-letter" href="#Index_cp_letter-W"><b>W</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-P"><b>P</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-Q"><b>Q</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-R"><b>R</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-S"><b>S</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-T"><b>T</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-U"><b>U</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-V"><b>V</b></a>
- &nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-X"><b>X</b></a>
+<a class="summary-letter" href="#Index_cp_letter-X"><b>X</b></a>
&nbsp;
</td></tr></table>
-<table class="index-fn" border="0">
+<table class="index-cp" border="0">
<tr><td></td><th align="left">Index Entry</th><td>&nbsp;</td><th align="left"> Section</th></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_symbol-1">$</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0024"><code>$</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_symbol-2">&amp;</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_symbol-1">&amp;</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0026"><code>&amp;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabular">tabular</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_symbol-3">-</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002d_002dhelp-command_002dline-option"><code>--help <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line">Command line</a></td></tr>
+<tr><th><a name="Index_cp_symbol-2">*</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002a-prompt">&lsquo;<samp>*</samp>&rsquo; prompt</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Recovering-from-errors">Recovering from errors</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002a_002dform-of-environment-commands"><code>*</code>-form of environment commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment &amp; \renewenvironment</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002a_002dform-of-sectioning-commands"><code>*</code>-form of sectioning commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002a_002dform_002c-defining-new-commands">*-form, defining new commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_symbol-4">.</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_symbol-3">-</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002ddisable_002dwrite18-command_002dline-option"><code>--disable-write18 <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002denable_002dwrite18-command_002dline-option"><code>--enable-write18 <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dfile_002dline_002derror-command_002dline-option"><code>--file-line-error <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dhalt_002don_002derror-command_002dline-option"><code>--halt-on-error <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dhelp-command_002dline-option"><code>--help <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dinteraction-command_002dline-option"><code>--interaction <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002djobname-command_002dline-option"><code>--jobname <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dno_002dfile_002dline_002derror-command_002dline-option"><code>--no-file-line-error <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dno_002dshell_002descape-command_002dline-option"><code>--no-shell-escape <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002doutput_002ddirectory-command_002dline-option"><code>--output-directory <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dshell_002descape-command_002dline-option"><code>--shell-escape <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dversion-command_002dline-option"><code>--version <span class="roman">command-line option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th><a name="Index_cp_symbol-4">.</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002eaux-file"><code>.aux <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002edvi-file"><code>.dvi <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002efd-file"><code>.fd <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002eglo-file"><samp>.glo</samp> file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002eidx-file"><samp>.idx</samp> file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002eidx-file-1"><samp>.idx</samp> file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002eind-file"><samp>.ind</samp> file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002eisty-file"><samp>.isty</samp> file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002elof-file"><code>.lof <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002elof-file-1"><code>.lof <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Tables-of-contents">Tables of contents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002elof-file-1"><code>.lof <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002elog-file"><code>.log <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002elot-file"><code>.lot <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002elot-file-1"><code>.lot <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Tables-of-contents">Tables of contents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002elot-file-1"><code>.lot <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002epdf-file"><code>.pdf <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002etex_002c-default-extension"><code>.tex, <span class="roman">default extension</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line">Command line</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002etoc-file"><code>.toc <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002etoc-file-1"><code>.toc <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Tables-of-contents">Tables of contents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002etoc-file-1"><code>.toc <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002exdv-file"><code>.xdv <span class="roman">file</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_symbol-5">1</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_symbol-5">1</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-10pt-option"><code>10pt <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-11pt-option"><code>11pt <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-12pt-option"><code>12pt <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_symbol-6">[</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_symbol-6">:</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_003a">:</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colon-character-_0026-_005ccolon">Colon character &amp; \colon</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_003a-1"><code>:</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colon-character-_0026-_005ccolon">Colon character &amp; \colon</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th><a name="Index_cp_symbol-7">[</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005b_002e_002e_002e_005d-for-optional-arguments"><code>[...] <span class="roman">for optional arguments</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#LaTeX-command-syntax">LaTeX command syntax</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_symbol-7">\</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_symbol-8">\</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c-character-starting-commands"><code>\ <span class="roman">character starting commands</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#LaTeX-command-syntax">LaTeX command syntax</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_0021"><code>\!</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_0022-_0028umlaut-accent_0029"><code>\&quot; <span class="roman">(umlaut accent)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
@@ -17591,10 +22425,7 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005c_0026"><code>\&amp;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_0027-_0028acute-accent_0029"><code>\' <span class="roman">(acute accent)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_0027-_0028tabbing_0029"><code>\' <span class="roman">(tabbing)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005c_0028"><code>\(</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005c_0028SPACE_0029"><code>\(SPACE)</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0028SPACE_0029-and-_005c_0040">\(SPACE) and \@</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005c_0029"><code>\)</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005c_002a"><code>\*</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005c_002a"><code>\*</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_002a">\*</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_002b"><code>\+</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_002c"><code>\,</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_002d"><code>\-</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
@@ -17609,7 +22440,7 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005c_003e"><code>\&gt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_003e-1"><code>\&gt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_003e-_0028tabbing_0029"><code>\&gt; <span class="roman">(tabbing)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005c_0040"><code>\@</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0028SPACE_0029-and-_005c_0040">\(SPACE) and \@</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005c_0040"><code>\@</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0040">\@</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_0040beginparpenalty"><code>\@beginparpenalty</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_0040endparpenalty"><code>\@endparpenalty</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_0040fnsymbol"><code>\@fnsymbol</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
@@ -17635,11 +22466,11 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005calpha"><code>\alpha</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005calph_007bcounter_007d"><code>\alph{<var>counter</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cAlph_007bcounter_007d"><code>\Alph{<var>counter</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005calsoname"><code>\alsoname</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005calsoname"><code>\alsoname</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005camalg"><code>\amalg</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cand-for-_005cauthor"><code>\and <span class="roman">for <code>\author</code></span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cangle"><code>\angle</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cappendix"><code>\appendix</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cappendix"><code>\appendix</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cappendix">\appendix</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005capprox"><code>\approx</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005carabic_007bcounter_007d"><code>\arabic{<var>counter</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005carccos"><code>\arccos</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
@@ -17656,9 +22487,10 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cAtEndDocument"><code>\AtEndDocument</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cAtEndDocument">\AtEndDocument</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cAtEndOfClass"><code>\AtEndOfClass</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cAtEndOfPackage"><code>\AtEndOfPackage</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cauthor_007bname-_005cand-name2_007d"><code>\author{<var>name</var> \and <var>name2</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cauthor_007bname1-_005cand-name2-_005cand-_002e_002e_002e_007d"><code>\author{<var>name1</var> \and <var>name2</var> \and ...}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ca_0060-_0028grave-accent-in-tabbing_0029"><code>\a` <span class="roman">(grave accent in tabbing)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cb-_0028bar_002dunder-accent_0029"><code>\b <span class="roman">(bar-under accent)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cbackmatter"><code>\backmatter</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter &amp; \mainmatter &amp; \backmatter</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbackslash"><code>\backslash</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbar"><code>\bar</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbaselineskip"><code>\baselineskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
@@ -17670,15 +22502,14 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cbibitem"><code>\bibitem</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbibitem">\bibitem</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbibliography"><code>\bibliography</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-BibTeX">Using BibTeX</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbibliographystyle"><code>\bibliographystyle</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-BibTeX">Using BibTeX</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cbibname"><code>\bibname</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigcap"><code>\bigcap</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigcirc"><code>\bigcirc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigcup"><code>\bigcup</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigodot"><code>\bigodot</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigoplus"><code>\bigoplus</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigotimes"><code>\bigotimes</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cbigskip"><code>\bigskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbigskip-_005cmedskip-_005csmallskip">\bigskip \medskip \smallskip</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cbigskipamount"><code>\bigskipamount</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbigskip-_005cmedskip-_005csmallskip">\bigskip \medskip \smallskip</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cbigskip"><code>\bigskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">\bigskip &amp; \medskip &amp; \smallskip</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cbigskipamount"><code>\bigskipamount</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">\bigskip &amp; \medskip &amp; \smallskip</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigsqcup"><code>\bigsqcup</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigtriangledown"><code>\bigtriangledown</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigtriangleup"><code>\bigtriangleup</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -17686,7 +22517,8 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cbigvee"><code>\bigvee</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigwedge"><code>\bigwedge</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbmod"><code>\bmod</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cboldmath"><code>\boldmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cboldmath"><code>\boldmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cboldmath-_0026-_005cunboldmath">\boldmath &amp; \unboldmath</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cboldmath-1"><code>\boldmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cboldmath-_0026-_005cunboldmath">\boldmath &amp; \unboldmath</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbot"><code>\bot</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbottomfraction"><code>\bottomfraction</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbottomfraction-1"><code>\bottomfraction</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
@@ -17716,9 +22548,10 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005ccaption-1"><code>\caption</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#table">table</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccc"><code>\cc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ccc">\cc</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccdot"><code>\cdot</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005ccdots"><code>\cdots</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005ccdots"><code>\cdots</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Dots">Dots</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccentering"><code>\centering</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ccentering">\centering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cchapter"><code>\chapter</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cchapter-1"><code>\chapter</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cchapter">\chapter</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccheck"><code>\check</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cCheckCommand"><code>\CheckCommand</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cCheckCommand_002a"><code>\CheckCommand*</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
@@ -17731,11 +22564,12 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cClassInfoNoLine"><code>\ClassInfoNoLine</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cClassWarning"><code>\ClassWarning</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cClassWarningNoLine"><code>\ClassWarningNoLine</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005ccleardoublepage"><code>\cleardoublepage</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ccleardoublepage">\cleardoublepage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cclearpage"><code>\clearpage</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclearpage">\clearpage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005ccleardoublepage"><code>\cleardoublepage</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cclearpage"><code>\clearpage</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccline"><code>\cline</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ccline">\cline</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cclosing"><code>\closing</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclosing">\closing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cclubsuit"><code>\clubsuit</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005ccolon"><code>\colon</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colon-character-_0026-_005ccolon">Colon character &amp; \colon</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccolumnsep"><code>\columnsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctwocolumn">\twocolumn</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccolumnsep-1"><code>\columnsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccolumnsep-2"><code>\columnsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
@@ -17763,7 +22597,7 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cdashbox"><code>\dashbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cdashbox">\dashbox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdashv"><code>\dashv</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdate_007btext_007d"><code>\date{<var>text</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cday"><code>\day</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cday-_005cmonth-_005cyear">\day \month \year</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cday"><code>\day</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cday-_0026-_005cmonth-_0026-_005cyear">\day &amp; \month &amp; \year</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdblfloatpagefraction"><code>\dblfloatpagefraction</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctwocolumn">\twocolumn</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdblfloatsep"><code>\dblfloatsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctwocolumn">\twocolumn</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdbltextfloatsep"><code>\dbltextfloatsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctwocolumn">\twocolumn</a></td></tr>
@@ -17772,7 +22606,7 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cddag"><code>\ddag</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cddagger"><code>\ddagger</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cddot"><code>\ddot</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cddots"><code>\ddots</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cddots"><code>\ddots</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Dots">Dots</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cDeclareGraphicsExtensions"><code>\DeclareGraphicsExtensions</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cDeclareGraphicsExtensions">\DeclareGraphicsExtensions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cDeclareGraphicsRule"><code>\DeclareGraphicsRule</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cDeclareGraphicsRule">\DeclareGraphicsRule</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cDeclareOption"><code>\DeclareOption</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
@@ -17782,7 +22616,6 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cdeg"><code>\deg</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cDelta"><code>\Delta</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdelta"><code>\delta</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cdepth"><code>\depth</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Predefined-lengths">Predefined lengths</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdet"><code>\det</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdh-_0028d_0029"><code>\dh (&eth;)</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cDH-_0028D_0029"><code>\DH (&ETH;)</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
@@ -17797,7 +22630,7 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cdocumentclass"><code>\documentclass</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-classes">Document classes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdot"><code>\dot</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdoteq"><code>\doteq</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cdotfill"><code>\dotfill</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chrulefill-_005cdotfill">\hrulefill \dotfill</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cdotfill"><code>\dotfill</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chrulefill-_0026-_005cdotfill">\hrulefill &amp; \dotfill</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdots"><code>\dots</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdoublerulesep"><code>\doublerulesep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabular">tabular</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdownarrow"><code>\downarrow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -17807,7 +22640,9 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cemptyset"><code>\emptyset</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cencl"><code>\encl</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cencl">\encl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cend"><code>\end</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cendinput"><code>\endinput</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cendinput">\endinput</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cenlargethispage"><code>\enlargethispage</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cenlargethispage">\enlargethispage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005censpace"><code>\enspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005censpace-_0026-_005cquad-_0026-_005cqquad">\enspace &amp; \quad &amp; \qquad</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cenumi"><code>\enumi</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#enumerate">enumerate</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cenumii"><code>\enumii</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#enumerate">enumerate</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cenumiii"><code>\enumiii</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#enumerate">enumerate</a></td></tr>
@@ -17822,11 +22657,13 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cexists"><code>\exists</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cexp"><code>\exp</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cextracolsep"><code>\extracolsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabular">tabular</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cfbox"><code>\fbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-and-_005cframebox">\fbox and \framebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cfboxrule"><code>\fboxrule</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cframebox-_0028picture_0029">\framebox (picture)</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cfboxrule-1"><code>\fboxrule</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-and-_005cframebox">\fbox and \framebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cfboxsep"><code>\fboxsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cframebox-_0028picture_0029">\framebox (picture)</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cfboxsep-1"><code>\fboxsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-and-_005cframebox">\fbox and \framebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cfbox"><code>\fbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cfboxrule-1"><code>\fboxrule</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cframebox-_0028picture_0029">\framebox (picture)</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cfboxrule">\fboxrule</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cfboxrule-2"><code>\fboxrule</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cfboxsep-1"><code>\fboxsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cframebox-_0028picture_0029">\framebox (picture)</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cfboxsep">\fboxsep</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cfboxsep-2"><code>\fboxsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cfill"><code>\fill</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chfill">\hfill</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cflat"><code>\flat</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cfloatpagefraction"><code>\floatpagefraction</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
@@ -17843,21 +22680,21 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cfontsize"><code>\fontsize</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cfootnote"><code>\footnote</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cfootnotemark"><code>\footnotemark</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cfootnoterule"><code>\footnoterule</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnote-parameters">Footnote parameters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cfootnotesep"><code>\footnotesep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnote-parameters">Footnote parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cfootnoterule"><code>\footnoterule</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cfootnotesep"><code>\footnotesep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cfootnotesize"><code>\footnotesize</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cfootnotetext"><code>\footnotetext</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnotetext">\footnotetext</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cfootskip"><code>\footskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cfootskip-1"><code>\footskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cforall"><code>\forall</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cfrac"><code>\frac</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cfrac_007bnum_007d_007bden_007d"><code>\frac{<var>num</var>}{<var>den</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cfrac"><code>\frac</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrac">\frac</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cframe"><code>\frame</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cframe">\frame</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cframebox"><code>\framebox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cframebox-_0028picture_0029">\framebox (picture)</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cframebox-1"><code>\framebox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-and-_005cframebox">\fbox and \framebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cframebox-1"><code>\framebox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cfrenchspacing"><code>\frenchspacing</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrenchspacing">\frenchspacing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cfrontmatter"><code>\frontmatter</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter &amp; \mainmatter &amp; \backmatter</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cfrown"><code>\frown</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cfussy"><code>\fussy</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfussy">\fussy</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cfussy"><code>\fussy</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfussy-_0026-_005csloppy">\fussy &amp; \sloppy</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cGamma"><code>\Gamma</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cgamma"><code>\gamma</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cgcd"><code>\gcd</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
@@ -17865,9 +22702,9 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cgeq"><code>\geq</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cgets"><code>\gets</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cgg"><code>\gg</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cglossary"><code>\glossary</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cglossaryentry"><code>\glossaryentry</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cgls"><code>\gls</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cgls">\gls</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cgraphicspath"><code>\graphicspath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cgraphicspath">\graphicspath</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cgraphpaper"><code>\graphpaper</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cgraphpaper">\graphpaper</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cgrave"><code>\grave</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cguillemotleft-_0028_00ab_0029"><code>\guillemotleft <span class="roman">(&laquo;)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cguillemotright-_0028_00bb_0029"><code>\guillemotright <span class="roman">(&raquo;)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
@@ -17881,16 +22718,16 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cheadsep"><code>\headsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cheadsep-1"><code>\headsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cheartsuit"><code>\heartsuit</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cheight"><code>\height</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Predefined-lengths">Predefined lengths</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005chfill"><code>\hfill</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chfill">\hfill</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005chline"><code>\hline</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chline">\hline</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005chom"><code>\hom</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005chookleftarrow"><code>\hookleftarrow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005chookrightarrow"><code>\hookrightarrow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005chrulefill"><code>\hrulefill</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chrulefill-_005cdotfill">\hrulefill \dotfill</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005chrulefill"><code>\hrulefill</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chrulefill-_0026-_005cdotfill">\hrulefill &amp; \dotfill</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005chsize"><code>\hsize</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005chsize-1"><code>\hsize</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005chspace"><code>\hspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chspace">\hspace</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005chss"><code>\hss</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chss">\hss</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005chuge"><code>\huge</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cHuge"><code>\Huge</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005chyphenation"><code>\hyphenation</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chyphenation">\hyphenation</a></td></tr>
@@ -17902,15 +22739,16 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cij-_0028ij_0029"><code>\ij (ij)</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cIJ-_0028IJ_0029"><code>\IJ (IJ)</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cIm"><code>\Im</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cimath"><code>\imath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cimath"><code>\imath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cin"><code>\in</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cinclude"><code>\include</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cinclude">\include</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cinclude"><code>\include</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cinclude-_0026-_005cincludeonly">\include &amp; \includeonly</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cincludegraphics"><code>\includegraphics</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cincludeonly"><code>\includeonly</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludeonly">\includeonly</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cindent"><code>\indent</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindent">\indent</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cincludeonly"><code>\includeonly</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cinclude-_0026-_005cincludeonly">\include &amp; \includeonly</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cindent"><code>\indent</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindent-_0026-_005cnoindent">\indent &amp; \noindent</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cindex"><code>\index</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cindexentry"><code>\indexentry</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cindexspace"><code>\indexspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cindex-1"><code>\index</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cindexentry"><code>\indexentry</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cindexspace"><code>\indexspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cinf"><code>\inf</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cinfty"><code>\infty</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cinput"><code>\input</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cinput">\input</a></td></tr>
@@ -17928,7 +22766,7 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005citemsep"><code>\itemsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005citshape"><code>\itshape</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cj-_0028dotless-j_0029"><code>\j <span class="roman">(dotless j)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cjmath"><code>\jmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cjmath"><code>\jmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cJoin"><code>\Join</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ck-_0028ogonek_0029"><code>\k <span class="roman">(ogonek)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ckappa"><code>\kappa</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -17959,10 +22797,11 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005clbrace"><code>\lbrace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005clbrack"><code>\lbrack</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005clceil"><code>\lceil</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cldots"><code>\ldots</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cldots"><code>\ldots</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Dots">Dots</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cldots-1"><code>\ldots</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cle"><code>\le</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cleadsto"><code>\leadsto</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cleft-delim1-_002e_002e_002e-_005cright-delim2"><code>\left <var>delim1</var> ... \right <var>delim2</var></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cleft"><code>\left</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cleft-_0026-_005cright">\left &amp; \right</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cLeftarrow"><code>\Leftarrow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cleftarrow"><code>\leftarrow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005clefteqn"><code>\lefteqn</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
@@ -17991,8 +22830,8 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005clinethickness"><code>\linethickness</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005clinethickness">\linethickness</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005clinewidth"><code>\linewidth</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005clinewidth-1"><code>\linewidth</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005clistoffigures"><code>\listoffigures</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Tables-of-contents">Tables of contents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005clistoftables"><code>\listoftables</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Tables-of-contents">Tables of contents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005clistoffigures"><code>\listoffigures</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005clistoftables"><code>\listoftables</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005clistparindent"><code>\listparindent</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cll"><code>\ll</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cln"><code>\ln</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
@@ -18007,9 +22846,11 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005clongrightarrow"><code>\longrightarrow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005clor"><code>\lor</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005clq"><code>\lq</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmakebox"><code>\makebox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakebox">\makebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmainmatter"><code>\mainmatter</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter &amp; \mainmatter &amp; \backmatter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmakebox"><code>\makebox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmakebox-_0028for-picture_0029"><code>\makebox <span class="roman">(for <code>picture</code>)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakebox-_0028picture_0029">\makebox (picture)</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmakeglossary"><code>\makeglossary</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmakeglossary-1"><code>\makeglossary</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmakeindex"><code>\makeindex</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmakelabel"><code>\makelabel</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmakelabels"><code>\makelabels</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakelabels">\makelabels</a></td></tr>
@@ -18025,34 +22866,32 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cmarginparwidth-2"><code>\marginparwidth</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Marginal-notes">Marginal notes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmarginsep"><code>\marginsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmarginsep-1"><code>\marginsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmarkboth_007bleft_007d_007bright_007d"><code>\markboth{<var>left</var>}{<var>right</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmarkboth_007bleft_002dhead_007d_007bright_002dhead_007d"><code>\markboth{<var>left-head</var>}{<var>right-head</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmarkright_007bright_007d"><code>\markright{<var>right</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmathbf"><code>\mathbf</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmathcal"><code>\mathcal</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmathdollar"><code>\mathdollar</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmathellipsis"><code>\mathellipsis</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmathdollar"><code>\mathdollar</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmathnormal"><code>\mathnormal</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmathparagraph"><code>\mathparagraph</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmathparagraph"><code>\mathparagraph</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmathring"><code>\mathring</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmathrm"><code>\mathrm</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmathsection"><code>\mathsection</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmathsection"><code>\mathsection</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmathsf"><code>\mathsf</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmathsterling"><code>\mathsterling</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmathsterling"><code>\mathsterling</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmathtt"><code>\mathtt</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmathunderscore"><code>\mathunderscore</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmathunderscore"><code>\mathunderscore</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmathversion"><code>\mathversion</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmax"><code>\max</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmbox"><code>\mbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmbox">\mbox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmbox_002c-and-LR-mode"><code>\mbox<span class="roman">, and LR mode</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmbox"><code>\mbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmdseries"><code>\mdseries</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmedskip"><code>\medskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbigskip-_005cmedskip-_005csmallskip">\bigskip \medskip \smallskip</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmedskipamount"><code>\medskipamount</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbigskip-_005cmedskip-_005csmallskip">\bigskip \medskip \smallskip</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmedskip"><code>\medskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">\bigskip &amp; \medskip &amp; \smallskip</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmedskipamount"><code>\medskipamount</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">\bigskip &amp; \medskip &amp; \smallskip</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmedspace"><code>\medspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmho"><code>\mho</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmid"><code>\mid</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmin"><code>\min</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmodels"><code>\models</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cmonth"><code>\month</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cday-_005cmonth-_005cyear">\day \month \year</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cmonth"><code>\month</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cday-_0026-_005cmonth-_0026-_005cyear">\day &amp; \month &amp; \year</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmp"><code>\mp</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmu"><code>\mu</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmulticolumn"><code>\multicolumn</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmulticolumn">\multicolumn</a></td></tr>
@@ -18064,14 +22903,17 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cnearrow"><code>\nearrow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cNeedsTeXFormat"><code>\NeedsTeXFormat</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cneg"><code>\neg</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cnegthinspace"><code>\negthinspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cnegthinspace-1"><code>\negthinspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cthinspace-_0026-_005cnegthinspace">\thinspace &amp; \negthinspace</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cneq"><code>\neq</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnewcommand"><code>\newcommand</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnewcounter"><code>\newcounter</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcounter">\newcounter</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnewenvironment"><code>\newenvironment</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment &amp; \renewenvironment</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnewfont"><code>\newfont</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cnewglossaryentry"><code>\newglossaryentry</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewglossaryentry">\newglossaryentry</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnewlength"><code>\newlength</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewlength">\newlength</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnewline"><code>\newline</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewline">\newline</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cNEWLINE"><code>\NEWLINE</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0028SPACE_0029-and-_005c_0040">\(SPACE) and \@</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cNEWLINE">\NEWLINE</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0028SPACE_0029">\(SPACE)</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnewpage"><code>\newpage</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewpage">\newpage</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnewsavebox"><code>\newsavebox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewsavebox">\newsavebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnewtheorem"><code>\newtheorem</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewtheorem">\newtheorem</a></td></tr>
@@ -18082,8 +22924,8 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cnocite"><code>\nocite</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnocite">\nocite</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnocorr"><code>\nocorr</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnocorrlist"><code>\nocorrlist</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cnofiles"><code>\nofiles</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Tables-of-contents">Tables of contents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cnoindent"><code>\noindent</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnoindent">\noindent</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cnofiles"><code>\nofiles</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnofiles">\nofiles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cnoindent"><code>\noindent</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindent-_0026-_005cnoindent">\indent &amp; \noindent</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnolinebreak"><code>\nolinebreak</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005clinebreak-_0026-_005cnolinebreak">\linebreak &amp; \nolinebreak</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnonfrenchspacing"><code>\nonfrenchspacing</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrenchspacing">\frenchspacing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnonumber"><code>\nonumber</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
@@ -18117,8 +22959,8 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005coslash"><code>\oslash</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cotimes"><code>\otimes</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005coval"><code>\oval</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005coval">\oval</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005coverbrace_007bmath_007d"><code>\overbrace{<var>math</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005coverline_007btext_007d"><code>\overline{<var>text</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005coverbrace_007bmath_007d"><code>\overbrace{<var>math</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Over_002d-and-Underlining">Over- and Underlining</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005coverline_007btext_007d"><code>\overline{<var>text</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Over_002d-and-Underlining">Over- and Underlining</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cowns"><code>\owns</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cP"><code>\P</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cPackageError"><code>\PackageError</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
@@ -18134,15 +22976,19 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cpaperheight-1"><code>\paperheight</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cpaperwidth"><code>\paperwidth</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cpaperwidth-1"><code>\paperwidth</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cpar"><code>\par</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpar">\par</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cparagraph"><code>\paragraph</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cparagraph-1"><code>\paragraph</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection &amp; \paragraph &amp; \subparagraph</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cparallel"><code>\parallel</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cparbox"><code>\parbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cparbox">\parbox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cparindent"><code>\parindent</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cparindent-1"><code>\parindent</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindent">\indent</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cparindent-1"><code>\parindent</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindent-_0026-_005cnoindent">\indent &amp; \noindent</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cparindent-2"><code>\parindent</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cparsep"><code>\parsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cparskip"><code>\parskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cparskip">\parskip</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cparskip"><code>\parskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cparskip-example"><code>\parskip <span class="roman">example</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#itemize">itemize</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cpart"><code>\part</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cpart-1"><code>\part</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpart">\part</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cpartial"><code>\partial</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cpartopsep"><code>\partopsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cPassOptionsToClass"><code>\PassOptionsToClass</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
@@ -18162,7 +23008,10 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cprec"><code>\prec</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cpreceq"><code>\preceq</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cprime"><code>\prime</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cprintindex"><code>\printindex</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cprintglossaries"><code>\printglossaries</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cprintglossaries-1"><code>\printglossaries</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cprintindex"><code>\printindex</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprintindex">\printindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cprintindex-1"><code>\printindex</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprintindex">\printindex</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cProcessOptions"><code>\ProcessOptions</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cProcessOptions_002a"><code>\ProcessOptions*</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cprod"><code>\prod</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -18177,8 +23026,11 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cpsi"><code>\psi</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cpushtabs"><code>\pushtabs</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cput"><code>\put</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cput">\put</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cqbezier"><code>\qbezier</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cqbezier">\qbezier</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cqquad"><code>\qquad</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cqquad-1"><code>\qquad</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005censpace-_0026-_005cquad-_0026-_005cqquad">\enspace &amp; \quad &amp; \qquad</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cquad"><code>\quad</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cquad-1"><code>\quad</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005censpace-_0026-_005cquad-_0026-_005cqquad">\enspace &amp; \quad &amp; \qquad</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cquotedblbase-_0028_201e_0029"><code>\quotedblbase <span class="roman">(&bdquo;)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cquotesinglbase-_0028_201a_0029"><code>\quotesinglbase <span class="roman">(&sbquo;)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cr-_0028ring-accent_0029"><code>\r <span class="roman">(ring accent)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
@@ -18193,7 +23045,6 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cRe"><code>\Re</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cref"><code>\ref</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005creflectbox"><code>\reflectbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005crefname"><code>\refname</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005crefstepcounter"><code>\refstepcounter</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005crefstepcounter">\refstepcounter</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005crenewenvironment"><code>\renewenvironment</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment &amp; \renewenvironment</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cRequirePackage"><code>\RequirePackage</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
@@ -18206,7 +23057,7 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005crfloor"><code>\rfloor</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005crhd"><code>\rhd</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005crho"><code>\rho</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cright"><code>\right</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cright"><code>\right</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cleft-_0026-_005cright">\left &amp; \right</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cRightarrow"><code>\Rightarrow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005crightarrow"><code>\rightarrow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005crightharpoondown"><code>\rightharpoondown</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -18221,8 +23072,8 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005crq"><code>\rq</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005crule"><code>\rule</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005crule">\rule</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cS"><code>\S</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005csavebox"><code>\savebox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csavebox">\savebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005csbox"><code>\sbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csbox">\sbox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005csavebox"><code>\savebox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csbox-_0026-_005csavebox">\sbox &amp; \savebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005csbox"><code>\sbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csbox-_0026-_005csavebox">\sbox &amp; \savebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csc"><code>\sc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cscalebox"><code>\scalebox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cscriptsize"><code>\scriptsize</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
@@ -18230,7 +23081,8 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005csearrow"><code>\searrow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csec"><code>\sec</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csection"><code>\section</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cseename"><code>\seename</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005csection-1"><code>\section</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csection">\section</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cseename"><code>\seename</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cselectfont"><code>\selectfont</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csetcounter"><code>\setcounter</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csetcounter">\setcounter</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csetlength"><code>\setlength</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csetlength">\setlength</a></td></tr>
@@ -18250,33 +23102,37 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005csin"><code>\sin</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csinh"><code>\sinh</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csl"><code>\sl</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005csloppy"><code>\sloppy</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csloppy">\sloppy</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005csloppy"><code>\sloppy</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfussy-_0026-_005csloppy">\fussy &amp; \sloppy</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cslshape"><code>\slshape</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csmall"><code>\small</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csmallint"><code>\smallint</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005csmallskip"><code>\smallskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbigskip-_005cmedskip-_005csmallskip">\bigskip \medskip \smallskip</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005csmallskipamount"><code>\smallskipamount</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbigskip-_005cmedskip-_005csmallskip">\bigskip \medskip \smallskip</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005csmallskip"><code>\smallskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">\bigskip &amp; \medskip &amp; \smallskip</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005csmallskipamount"><code>\smallskipamount</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip">\bigskip &amp; \medskip &amp; \smallskip</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csmile"><code>\smile</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cSPACE">\SPACE</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0028SPACE_0029">\(SPACE)</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cspacefactor"><code>\spacefactor</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cspacefactor">\spacefactor</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cspadesuit"><code>\spadesuit</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csqcap"><code>\sqcap</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csqcup"><code>\sqcup</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005csqrt_005broot_005d_007barg_007d"><code>\sqrt[<var>root</var>]{<var>arg</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005csqrt"><code>\sqrt</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csqrt">\sqrt</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csqsubset"><code>\sqsubset</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csqsubseteq"><code>\sqsubseteq</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csqsupset"><code>\sqsupset</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csqsupseteq"><code>\sqsupseteq</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005css-_0028ss_0029"><code>\ss (&szlig;)</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cSS-_0028SS_0029"><code>\SS (SS)</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cstackrel_007btext_007d_007brelation_007d"><code>\stackrel{<var>text</var>}{<var>relation</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cstackrel"><code>\stackrel</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cstackrel">\stackrel</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cstar"><code>\star</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cstepcounter"><code>\stepcounter</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cstepcounter">\stepcounter</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cstop"><code>\stop</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line">Command line</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cstop"><code>\stop</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Recovering-from-errors">Recovering from errors</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cstrut"><code>\strut</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cstrut">\strut</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csubparagraph"><code>\subparagraph</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005csubparagraph-1"><code>\subparagraph</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection &amp; \paragraph &amp; \subparagraph</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csubsection"><code>\subsection</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005csubsection-1"><code>\subsection</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsection">\subsection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csubset"><code>\subset</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csubseteq"><code>\subseteq</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005csubsubsection"><code>\subsubsection</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005csubsubsection"><code>\subsubsection</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection &amp; \paragraph &amp; \subparagraph</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csucc"><code>\succ</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csucceq"><code>\succeq</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csum"><code>\sum</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -18288,10 +23144,10 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cswarrow"><code>\swarrow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csymbol"><code>\symbol</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Symbols-by-font-position">Symbols by font position</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ct-_0028tie_002dafter-accent_0029"><code>\t <span class="roman">(tie-after accent)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cTAB"><code>\TAB</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0028SPACE_0029-and-_005c_0040">\(SPACE) and \@</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cTAB">\TAB</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0028SPACE_0029">\(SPACE)</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctabbingsep"><code>\tabbingsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctabcolsep"><code>\tabcolsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabular">tabular</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005ctableofcontents"><code>\tableofcontents</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Tables-of-contents">Tables of contents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005ctableofcontents"><code>\tableofcontents</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctan"><code>\tan</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctanh"><code>\tanh</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctau"><code>\tau</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -18350,6 +23206,7 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005ctextrightarrow"><code>\textrightarrow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctextrm"><code>\textrm</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctextsc"><code>\textsc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005ctextsection"><code>\textsection</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctextsf"><code>\textsf</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctextsl"><code>\textsl</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctextsterling"><code>\textsterling</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
@@ -18370,7 +23227,7 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cthickspace"><code>\thickspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cthinlines"><code>\thinlines</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cthinlines">\thinlines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cthinspace"><code>\thinspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cthinspace-1"><code>\thinspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cthinspace">\thinspace</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cthinspace-1"><code>\thinspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cthinspace-_0026-_005cnegthinspace">\thinspace &amp; \negthinspace</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cthispagestyle"><code>\thispagestyle</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cthispagestyle">\thispagestyle</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctilde"><code>\tilde</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctimes"><code>\times</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -18385,7 +23242,6 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005ctopsep"><code>\topsep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctopskip"><code>\topskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctopskip-1"><code>\topskip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005ctotalheight"><code>\totalheight</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Predefined-lengths">Predefined lengths</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctriangle"><code>\triangle</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctriangleleft"><code>\triangleleft</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctriangleright"><code>\triangleright</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -18395,10 +23251,11 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005ctypein"><code>\typein</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctypein">\typein</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctypeout"><code>\typeout</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctypeout">\typeout</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cu-_0028breve-accent_0029"><code>\u <span class="roman">(breve accent)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cunboldmath"><code>\unboldmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cunboldmath"><code>\unboldmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cboldmath-_0026-_005cunboldmath">\boldmath &amp; \unboldmath</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cunboldmath-1"><code>\unboldmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cboldmath-_0026-_005cunboldmath">\boldmath &amp; \unboldmath</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cunderbar"><code>\underbar</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cunderbrace_007bmath_007d"><code>\underbrace{<var>math</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cunderline_007btext_007d"><code>\underline{<var>text</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cunderbrace_007bmath_007d"><code>\underbrace{<var>math</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Over_002d-and-Underlining">Over- and Underlining</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cunderline_007btext_007d"><code>\underline{<var>text</var>}</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Over_002d-and-Underlining">Over- and Underlining</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cunitlength"><code>\unitlength</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cunlhd"><code>\unlhd</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cunrhd"><code>\unrhd</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -18425,7 +23282,7 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cvarsigma"><code>\varsigma</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cvartheta"><code>\vartheta</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cvdash"><code>\vdash</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cvdots"><code>\vdots</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cvdots"><code>\vdots</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Dots">Dots</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cvec"><code>\vec</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cvector"><code>\vector</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cvector">\vector</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cvee"><code>\vee</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -18438,14 +23295,12 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005cwedge"><code>\wedge</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cwidehat"><code>\widehat</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cwidetilde"><code>\widetilde</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cwidth"><code>\width</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Predefined-lengths">Predefined lengths</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cwp"><code>\wp</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cwr"><code>\wr</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cXi"><code>\Xi</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cxi"><code>\xi</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cyear"><code>\year</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cday-_005cmonth-_005cyear">\day \month \year</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cyear"><code>\year</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cday-_0026-_005cmonth-_0026-_005cyear">\day &amp; \month &amp; \year</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005czeta"><code>\zeta</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005c_005b"><code>\[</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_005c-_0028for-center_0029"><code>\\ <span class="roman">(for <code>center</code>)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#center">center</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_005c-_0028for-eqnarray_0029"><code>\\ <span class="roman">(for <code>eqnarray</code>)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_005c-_0028for-flushright_0029"><code>\\ (for <code>flushright</code>)</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#flushright">flushright</a></td></tr>
@@ -18459,7 +23314,6 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005c_005c-for-_005ctitle"><code>\\ <span class="roman">for <code>\title</code></span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_005c-force-line-break"><code>\\ <span class="roman">force line break</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_005c">\\</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_005c_002a-_0028for-eqnarray_0029"><code>\\* <span class="roman">(for <code>eqnarray</code>)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005c_005d"><code>\]</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_005e"><code>\^</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_005e-_0028circumflex-accent_0029"><code>\^ <span class="roman">(circumflex accent)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_005f"><code>\_</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
@@ -18471,51 +23325,321 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-_005c_007e"><code>\~</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_007e-_0028tilde-accent_0029"><code>\~ <span class="roman">(tilde accent)</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_symbol-8">^</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_symbol-9">^</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005e"><code>^</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts &amp; superscripts</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_symbol-9">_</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_symbol-10">_</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005f"><code>_</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts &amp; superscripts</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_symbol-10">{</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_symbol-11">`</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_0060see_0027-and-_0060see-also_0027-index-entries">&lsquo;see&rsquo; and &lsquo;see also&rsquo; index entries</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th><a name="Index_cp_symbol-12">{</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_007b_002e_002e_002e_007d-for-required-arguments"><code>{...} <span class="roman">for required arguments</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#LaTeX-command-syntax">LaTeX command syntax</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-A">A</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_symbol-13">~</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_007e"><code>~</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th><a name="Index_cp_letter-A">A</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-a4paper-option"><code>a4paper <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-a5paper-option"><code>a5paper <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-abstract-environment"><code><code>abstract</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#abstract">abstract</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-abstracts">abstracts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#abstract">abstract</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-accents">accents</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-accents_002c-mathematical">accents, mathematical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-accessing-any-character-of-a-font">accessing any character of a font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Symbols-by-font-position">Symbols by font position</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-acronyms_002c-list-of">acronyms, list of</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-acute-accent">acute accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-acute-accent_002c-math">acute accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-additional-packages_002c-loading">additional packages, loading</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ae-ligature">ae ligature</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-algorithm2e-package"><code>algorithm2e</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-align-environment_002c-from-amsmath">align <span class="roman">environment, from <code>amsmath</code></span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-aligning-equations">aligning equations</a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-alignment-via-tabbing">alignment via tabbing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsfonts-package"><code>amsfonts</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsmath-package"><code>amsmath</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsmath-package-1"><code>amsmath</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsmath-package-2"><code>amsmath</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#displaymath">displaymath</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsmath-package-3"><code>amsmath</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#equation">equation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsmath-package-4"><code>amsmath</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#theorem">theorem</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsmath-package-5"><code>amsmath</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsmath-package-6"><code>amsmath</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Dots">Dots</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsmath-package-7"><code>amsmath</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsmath-package-8"><code>amsmath</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colon-character-_0026-_005ccolon">Colon character &amp; \colon</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsmath-package-9"><code>amsmath</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colon-character-_0026-_005ccolon">Colon character &amp; \colon</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsmath-package_002c-replacing-eqnarray">amsmath <span class="roman">package, replacing <code>eqnarray</code></span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsthm-package"><code>amsthm</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#theorem">theorem</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-amsthm-package-1"><code>amsthm</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005crule">\rule</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-appendices">appendices</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cappendix">\appendix</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-appendix">appendix</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cappendix">\appendix</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-appendix-package"><code>appendix</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cappendix">\appendix</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-aring">aring</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-array-_0028package_0029-package"><code>array (package)</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-array-environment"><code><code>array</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-arrays_002c-math">arrays, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-arrow_002c-left_002c-in-text">arrow, left, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-arrow_002c-right_002c-in-text">arrow, right, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-article-class"><code>article <span class="roman">class</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-classes">Document classes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ascender-height">ascender height</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ASCII-circumflex_002c-in-text">ASCII circumflex, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ASCII-tilde_002c-in-text">ASCII tilde, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-asterisk_002c-centered_002c-in-text">asterisk, centered, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Asymptote-package"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Asymptote-package-1"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cstrut">\strut</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Asymptote-package-2"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-at-clause_002c-in-font-definitions">at clause, in font definitions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-at_002dsign"><code>at-sign</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0040">\@</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-author_002c-for-titlepage">author, for titlepage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-auxiliary-file">auxiliary file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-B">B</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-B">B</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-b5paper-option"><code>b5paper <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-babel-package"><code>babel</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cchapter">\chapter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-babel-package-1"><code>babel</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-babel-package-2"><code>babel</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-babel-package-3"><code>babel</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-babel-package-4"><code>babel</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-babel-package-5"><code>babel</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-background_002c-colored">background, colored</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-pages">Colored pages</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-backslash_002c-in-text">backslash, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bar_002c-double-vertical_002c-in-text">bar, double vertical, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bar_002c-vertical_002c-in-text">bar, vertical, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bar_002dover-accent">bar-over accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bar_002dover-accent_002c-math">bar-over accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bar_002dunder-accent">bar-under accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-basics-of-LaTeX">basics of LaTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-beamer-template-and-class"><code>beamer</code> template and class</a>:</td><td>&nbsp;</td><td valign="top"><a href="#beamer-template">beamer template</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-beginning-of-document-hook">beginning of document hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cAtBeginDocument">\AtBeginDocument</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bibliography-format_002c-open">bibliography format, open</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bibliography_002c-creating-_0028automatically_0029">bibliography, creating (automatically)</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-BibTeX">Using BibTeX</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bibliography_002c-creating-_0028manually_0029">bibliography, creating (manually)</a>:</td><td>&nbsp;</td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bibTeX_002c-using">bibTeX, using</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-BibTeX">Using BibTeX</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-big-circle-symbols_002c-in-text">big circle symbols, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Big-point">Big point</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bigfoot-package"><code>bigfoot</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes-of-footnotes">Footnotes of footnotes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-black-boxes_002c-omitting">black boxes, omitting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-blackboard-bold">blackboard bold</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Blackboard-bold">Blackboard bold</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bm-package"><code>bm</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cboldmath-_0026-_005cunboldmath">\boldmath &amp; \unboldmath</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bold-font">bold font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bold-math">bold math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bold-typewriter_002c-avoiding">bold typewriter, avoiding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#description">description</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-boldface-mathematics">boldface mathematics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cboldmath-_0026-_005cunboldmath">\boldmath &amp; \unboldmath</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-book-class"><code>book <span class="roman">class</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-classes">Document classes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-book_002c-back-matter">book, back matter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter &amp; \mainmatter &amp; \backmatter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-book_002c-end-matter">book, end matter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter &amp; \mainmatter &amp; \backmatter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-book_002c-front-matter">book, front matter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter &amp; \mainmatter &amp; \backmatter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-book_002c-main-matter">book, main matter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter &amp; \mainmatter &amp; \backmatter</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bottomnumber"><code>bottomnumber</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bottomnumber-1"><code>bottomnumber</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-box">box</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-box_002c-allocating-new">box, allocating new</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewsavebox">\newsavebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-box_002c-colored">box, colored</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-boxes">Colored boxes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-box_002c-save">box, save</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csbox-_0026-_005csavebox">\sbox &amp; \savebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-box_002c-use-saved-box">box, use saved box</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cusebox">\usebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-boxes">boxes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Boxes">Boxes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bp"><code>bp</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-brace_002c-left_002c-in-text">brace, left, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-brace_002c-right_002c-in-text">brace, right, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-breaking-lines">breaking lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Line-breaking">Line breaking</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-breaking-pages">breaking pages</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-breaking">Page breaking</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-breaks_002c-multiplication-discretionary">breaks, multiplication discretionary</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_002a">\*</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-breve-accent">breve accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-breve-accent_002c-math">breve accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bug-reporting">bug reporting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bullet-lists">bullet lists</a>:</td><td>&nbsp;</td><td valign="top"><a href="#itemize">itemize</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bullet-symbol">bullet symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bullet_002c-in-text">bullet, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-bulleted-lists">bulleted lists</a>:</td><td>&nbsp;</td><td valign="top"><a href="#itemize">itemize</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-C">C</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-C">C</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-calligraphic-fonts">calligraphic fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Calligraphic">Calligraphic</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-calligraphic-letters-for-math">calligraphic letters for math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cap-height">cap height</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-caron-accent">caron accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-catcode">catcode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-category-code_002c-character">category code, character</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cc"><code>cc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cc-list_002c-in-letters">cc list, in letters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ccc">\cc</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cedilla-accent">cedilla accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-center-environment"><code><code>center</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#center">center</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-centered-asterisk_002c-in-text">centered asterisk, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-centered-equations">centered equations</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-centered-period_002c-in-text">centered period, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-centering-text_002c-declaration-for">centering text, declaration for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ccentering">\centering</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-centering-text_002c-environment-for">centering text, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#center">center</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Centimeter">Centimeter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-chapter">chapter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-chapter-1">chapter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cchapter">\chapter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-character-category-code">character category code</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-characters_002c-accented">characters, accented</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-characters_002c-case-of">characters, case of</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-characters_002c-non_002dEnglish">characters, non-English</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-characters_002c-reserved">characters, reserved</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-characters_002c-special">characters, special</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-check-accent">check accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-check-accent_002c-math">check accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Cicero">Cicero</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-circle-symbol_002c-big_002c-in-text">circle symbol, big, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-circled-letter_002c-in-text">circled letter, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-circumflex-accent">circumflex accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-circumflex-accent_002c-math">circumflex accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-circumflex_002c-ASCII_002c-in-text">circumflex, ASCII, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-citation-key">citation key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cbibitem">\bibitem</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-class-and-package-commands">class and package commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-class-and-package-difference">class and package difference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-construction">Class and package construction</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-class-and-package-structure">class and package structure</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-class-file-example">class file example</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-class-file-layout">class file layout</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-class-options">class options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-class-options-1">class options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-class-options-2">class options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-classes-of-documents">classes of documents</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-classes">Document classes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cleveref-package"><code>cleveref</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cleveref-package-1"><code>cleveref</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cleveref-package-2"><code>cleveref</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-clock-option-to-slides-class"><code>clock <span class="roman">option to <code>slides</code> class</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-closing-letters">closing letters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclosing">\closing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-closing-quote">closing quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cm"><code>cm</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-code_002c-typesetting">code, typesetting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-colon-character">colon character</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colon-character-_0026-_005ccolon">Colon character &amp; \colon</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-color">color</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Color">Color</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-color-1">color</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Define-colors">Define colors</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-color-2">color</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-text">Colored text</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-color-3">color</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-boxes">Colored boxes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-color-4">color</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-pages">Colored pages</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-color-models">color models</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Color-models">Color models</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-color-package-commands">color package commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Commands-for-color">Commands for color</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-color-package-options">color package options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Color-package-options">Color package options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-color_002c-define">color, define</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Define-colors">Define colors</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-colored-boxes">colored boxes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-boxes">Colored boxes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-colored-page">colored page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-pages">Colored pages</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-colored-text">colored text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-text">Colored text</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-command-line">command line</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line">Command line</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-command-syntax">command syntax</a>:</td><td>&nbsp;</td><td valign="top"><a href="#LaTeX-command-syntax">LaTeX command syntax</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-commands_002c-class-and-package">commands, class and package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-commands_002c-defining-new-ones">commands, defining new ones</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-commands_002c-defining-new-ones-1">commands, defining new ones</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprovidecommand">\providecommand</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-commands_002c-document-class">commands, document class</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-construction">Class and package construction</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-commands_002c-graphics-package">commands, graphics package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Commands-for-graphics">Commands for graphics</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-commands_002c-ignore-spaces">commands, ignore spaces</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cignorespaces-_0026-_005cignorespacesafterend">\ignorespaces &amp; \ignorespacesafterend</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-commands_002c-redefining">commands, redefining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-commands_002c-star_002dvariants">commands, star-variants</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0040ifstar">\@ifstar</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-composite-word-mark_002c-in-text">composite word mark, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-computer-programs_002c-typesetting">computer programs, typesetting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-configuration_002c-graphics-package">configuration, graphics package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-contents-file">contents file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-copyright-symbol">copyright symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-counters_002c-a-list-of">counters, a list of</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Counters">Counters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-counters_002c-defining-new">counters, defining new</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcounter">\newcounter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-counters_002c-getting-value-of">counters, getting value of</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cvalue">\value</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-counters_002c-printing">counters, printing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-counters_002c-setting">counters, setting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csetcounter">\setcounter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cprotect-package"><code>cprotect</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cprotect-package-1"><code>cprotect</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-creating-pictures">creating pictures</a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-creating-tables">creating tables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#table">table</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-credit-footnote">credit footnote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cross-references">cross references</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cross-references_002c-resolving">cross references, resolving</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cross-referencing-with-page-number">cross referencing with page number</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpageref">\pageref</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cross-referencing_002c-symbolic">cross referencing, symbolic</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-CTAN">CTAN</a>:</td><td>&nbsp;</td><td valign="top"><a href="#CTAN">CTAN</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-currency_002c-dollar">currency, dollar</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-currency_002c-euro">currency, euro</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-D">D</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-D">D</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dagger_002c-double_002c-in-text">dagger, double, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dagger_002c-in-text">dagger, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dagger_002c-in-text-1">dagger, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-DANTE-e_002eV_002e">DANTE e.V.</a>:</td><td>&nbsp;</td><td valign="top"><a href="#CTAN">CTAN</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-date_002c-for-titlepage">date, for titlepage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-date_002c-today_0027s">date, today&rsquo;s</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-datetime-package"><code>datetime</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dbltopnumber"><code>dbltopnumber</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dbltopnumber-1"><code>dbltopnumber</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dcolumn-package"><code>dcolumn</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dd"><code>dd</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-define-color">define color</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Define-colors">Define colors</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-defining-a-new-command">defining a new command</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-defining-a-new-command-1">defining a new command</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprovidecommand">\providecommand</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-defining-new-environments">defining new environments</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment &amp; \renewenvironment</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-defining-new-fonts">defining new fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-defining-new-theorems">defining new theorems</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewtheorem">\newtheorem</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-definitions">definitions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Definitions">Definitions</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-delimiters_002c-paired">delimiters, paired</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cleft-_0026-_005cright">\left &amp; \right</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-delim_005f0"><code>delim_0</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-delim_005f1"><code>delim_1</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-delim_005f2"><code>delim_2</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-delim_005fn"><code>delim_n</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-delim_005fr"><code>delim_r</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-description"><code>description</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewglossaryentry">\newglossaryentry</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-description-environment"><code><code>description</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#description">description</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-description-lists_002c-creating">description lists, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#description">description</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-design-size_002c-in-font-definitions">design size, in font definitions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Didot-point">Didot point</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dieresis-accent">dieresis accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-difference-between-class-and-package">difference between class and package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-construction">Class and package construction</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-discretionary-breaks_002c-multiplication">discretionary breaks, multiplication</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_002a">\*</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-discretionary-hyphenation">discretionary hyphenation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cdiscretionary">\discretionary</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-display-math-mode">display math mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-displaying-quoted-text-with-paragraph-indentation">displaying quoted text with paragraph indentation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-_0026-quote">quotation &amp; quote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-displaying-quoted-text-without-paragraph-indentation">displaying quoted text without paragraph indentation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-_0026-quote">quotation &amp; quote</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-displaymath-environment"><code><code>displaymath</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#displaymath">displaymath</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-displaymath-environment-1"><code><code>displaymath</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-document-class-commands">document class commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-construction">Class and package construction</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-document-class-options">document class options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-document-class_002c-defined">document class, defined</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-document-classes">document classes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-classes">Document classes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-document-environment"><code><code>document</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#document">document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-document-templates">document templates</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-templates">Document templates</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dollar-sign">dollar sign</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dot-accent">dot accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dot-over-accent_002c-math">dot over accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dot_002dover-accent">dot-over accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dot_002dunder-accent">dot-under accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dotless-i">dotless i</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dotless-i_002c-math">dotless i, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dotless-j">dotless j</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dotless-j_002c-math">dotless j, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dots">dots</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Dots">Dots</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-double-angle-quotation-marks">double angle quotation marks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-double-dagger_002c-in-text">double dagger, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-double-dagger_002c-in-text-1">double dagger, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-double-dot-accent_002c-math">double dot accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-double-guillemets">double guillemets</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-double-left-quote">double left quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-double-low_002d9-quotation-mark">double low-9 quotation mark</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-double-quote_002c-straight-base">double quote, straight base</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-double-right-quote">double right quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-double-spacing">double spacing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-double-vertical-bar_002c-in-text">double vertical bar, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-doublestruck">doublestruck</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Blackboard-bold">Blackboard bold</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-draft-option"><code>draft <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dvipdfmx-command"><code>dvipdfmx <span class="roman">command</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dvips-command"><code>dvips <span class="roman">command</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dvitype-command"><code>dvitype <span class="roman">command</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-E">E</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-E">E</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-e_002ddash">e-dash</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-e_002dTeX">e-TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ellipses">ellipses</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Dots">Dots</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ellipsis">ellipsis</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-em">em</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-em-1"><code>em</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-em_002ddash">em-dash</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-em_002ddash_002c-three_002dquarters">em-dash, three-quarters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-em_002ddash_002c-two_002dthirds">em-dash, two-thirds</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-emphasis">emphasis</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-enclosure-list">enclosure list</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cencl">\encl</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-end-of-document-hook">end of document hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cAtEndDocument">\AtEndDocument</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ending-and-starting">ending and starting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-engines_002c-TeX">engines, TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-enlarge-current-page">enlarge current page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cenlargethispage">\enlargethispage</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-enumerate-environment"><code><code>enumerate</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#enumerate">enumerate</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-enumitem-package"><code>enumitem</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-environment">environment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-abstract"><code><span class="roman">environment</span>, <code>abstract</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#abstract">abstract</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-array"><code><span class="roman">environment</span>, <code>array</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-center"><code><span class="roman">environment</span>, <code>center</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#center">center</a></td></tr>
@@ -18539,182 +23663,920 @@ Previous: <a href="#Concept-Index" accesskey="p" rel="prev">Concept Index</a>, U
<tr><td></td><td valign="top"><a href="#index-environment_002c-math-1"><code><span class="roman">environment</span>, <code>math</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-minipage"><code><span class="roman">environment</span>, <code>minipage</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-picture"><code><span class="roman">environment</span>, <code>picture</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-environment_002c-quotation"><code><span class="roman">environment</span>, <code>quotation</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-and-quote">quotation and quote</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-environment_002c-quote"><code><span class="roman">environment</span>, <code>quote</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-and-quote">quotation and quote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-environment_002c-quotation"><code><span class="roman">environment</span>, <code>quotation</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-_0026-quote">quotation &amp; quote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-environment_002c-quote"><code><span class="roman">environment</span>, <code>quote</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-_0026-quote">quotation &amp; quote</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-tabbing"><code><span class="roman">environment</span>, <code>tabbing</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-table"><code><span class="roman">environment</span>, <code>table</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#table">table</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-tabular"><code><span class="roman">environment</span>, <code>tabular</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabular">tabular</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-thebibliography"><code><span class="roman">environment</span>, <code>thebibliography</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-theorem"><code><span class="roman">environment</span>, <code>theorem</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#theorem">theorem</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-environment_002c-theorem_002dlike">environment, theorem-like</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewtheorem">\newtheorem</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-titlepage"><code><span class="roman">environment</span>, <code>titlepage</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#titlepage">titlepage</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-verbatim"><code><span class="roman">environment</span>, <code>verbatim</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment_002c-verse"><code><span class="roman">environment</span>, <code>verse</code></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verse">verse</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-environments">environments</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-environments_002c-defining">environments, defining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment &amp; \renewenvironment</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-envlab-package"><code>envlab</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakelabels">\makelabels</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-EPS-files">EPS files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-EPS-files-1">EPS files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-eqnarray-environment"><code><code>eqnarray</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-equation-environment"><code><code>equation</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#equation">equation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-equation-environment-1"><code><code>equation</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-equation-number_002c-cross-referencing">equation number, cross referencing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-equation-numbers_002c-left-vs_002e-right">equation numbers, left vs. right</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-equation-numbers_002c-omitting">equation numbers, omitting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-equations_002c-aligning">equations, aligning</a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-equations_002c-environment-for">equations, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#equation">equation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-equations_002c-flush-left-vs_002e-centered">equations, flush left vs. centered</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-es_002dzet-German-letter">es-zet German letter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-etex-command"><code>etex <span class="roman">command</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-eth_002c-Icelandic-letter">eth, Icelandic letter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-etoolbox-package"><code>etoolbox</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-euro-symbol">euro symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-eurosym-package"><code>eurosym</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ex">ex</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ex-1"><code>ex</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-exclamation-point_002c-upside_002ddown">exclamation point, upside-down</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-executivepaper-option"><code>executivepaper <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-exponent">exponent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts &amp; superscripts</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-extended-Latin">extended Latin</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-external-files_002c-writing">external files, writing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#filecontents">filecontents</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-F">F</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-F">F</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-families_002c-of-fonts">families, of fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fancyhdr-package"><code>fancyhdr</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-styles">Page styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fancyhdr-package-1"><code>fancyhdr</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fancyvrb-package"><code>fancyvrb</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fancyvrb-package-1"><code>fancyvrb</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-feminine-ordinal-symbol">feminine ordinal symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-figure-environment"><code><code>figure</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#figure">figure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-figure-number_002c-cross-referencing">figure number, cross referencing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-figures_002c-footnotes-in">figures, footnotes in</a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-figures_002c-inserting">figures, inserting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#figure">figure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-file_002c-root">file, root</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-the-input">Splitting the input</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-filecontents-environment"><code><code>filecontents</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#filecontents">filecontents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-filecontents_002a-environment"><code><code>filecontents*</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#filecontents">filecontents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-final-option"><code>final <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-first_002dlatex_002ddoc-document"><code>first-latex-doc <span class="roman">document</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fixed_002dwidth-font">fixed-width font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-flafter-package"><code>flafter</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fleqn-option"><code>fleqn <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-float-package"><code>float</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-float-page">float page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-flush-left-equations">flush left equations</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-flushing-floats-and-starting-a-page">flushing floats and starting a page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-flushleft-environment"><code><code>flushleft</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#flushleft">flushleft</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-flushright-environment"><code><code>flushright</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#flushright">flushright</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-font-catalogue">font catalogue</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-font-commands_002c-low_002dlevel">font commands, low-level</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-font-size">font size</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-font-sizes">font sizes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-font-styles">font styles</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-font-symbols_002c-by-number">font symbols, by number</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Symbols-by-font-position">Symbols by font position</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fonts">fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Fonts">Fonts</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fonts_002c-new-commands-for">fonts, new commands for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fonts_002c-script">fonts, script</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Calligraphic">Calligraphic</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-footer-style">footer style</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-footer_002c-parameters-for">footer, parameters for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-footnote-number_002c-cross-referencing">footnote number, cross referencing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-footnote-parameters">footnote parameters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-footnote_002c-in-a-table">footnote, in a table</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes-in-a-table">Footnotes in a table</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-footnote_002c-in-section-headings">footnote, in section headings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes-in-section-headings">Footnotes in section headings</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-footnote_002c-of-a-footnote">footnote, of a footnote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes-of-footnotes">Footnotes of footnotes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-footnotes-in-figures">footnotes in figures</a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-footnotes_002c-creating">footnotes, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes">Footnotes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Footnotes_002c-in-a-minipage">Footnotes, in a minipage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-footnotes_002c-symbols-instead-of-numbers">footnotes, symbols instead of numbers</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-formulas_002c-environment-for">formulas, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#equation">equation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-formulas_002c-math">formulas, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-forward-reference">forward reference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-forward-references_002c-resolving">forward references, resolving</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fraction">fraction</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrac">\frac</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fragile-commands">fragile commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprotect">\protect</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-frame-rule-width"><code>frame rule width</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-frame_002c-line-width"><code>frame, line width</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-frame_002c-separation-from-contents"><code>frame, separation from contents</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfbox-_0026-_005cframebox">\fbox &amp; \framebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-French-quotation-marks">French quotation marks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-functions_002c-math">functions, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th><a name="Index_cp_letter-G">G</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-geometry-package"><code>geometry</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-geometry-package-1"><code>geometry</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-global-options">global options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-global-options-1">global options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-glossaries">glossaries</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-glossary">glossary</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossaries">Glossaries</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-glossary_002c-entries">glossary, entries</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewglossaryentry">\newglossaryentry</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-glossary_002c-entry-reference">glossary, entry reference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cgls">\gls</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-glue-register_002c-plain-TeX">glue register, plain TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewlength">\newlength</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics">graphics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics">Graphics</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics-1">graphics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics-2">graphics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics-package">graphics package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics">Graphics</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics-package-1">graphics package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics-package-2">graphics package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics-package-commands">graphics package commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Commands-for-graphics">Commands for graphics</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics-package-options">graphics package options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-options">Graphics package options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics-packages">graphics packages</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics_002c-resizing">graphics, resizing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics_002c-resizing-1">graphics, resizing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics_002c-scaling">graphics, scaling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphics_002c-scaling-1">graphics, scaling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-grave-accent">grave accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-grave-accent_002c-math">grave accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-greater-than-symbol_002c-in-text">greater than symbol, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-greek-letters">greek letters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-group_002c-and-environments">group, and environments</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-group_005fskip"><code>group_skip</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-H">H</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-http_003a_002f_002fpuszcza_002egnu_002eorg_002eua_002fsoftware_002flatexrefman_002f-home-page"><code><a href="http://puszcza.gnu.org.ua/software/latexrefman/">http://puszcza.gnu.org.ua/software/latexrefman/</a> <span class="roman">home page</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
+<tr><th><a name="Index_cp_letter-H">H</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hacek-accent_002c-math">h&aacute;&#269;ek accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hacek-accent">hacek accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Halmos-symbol">Halmos symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005crule">\rule</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hat-accent">hat accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hat-accent_002c-math">hat accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-header-style">header style</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-header_002c-parameters-for">header, parameters for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hello_002c-world">hello, world</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-here_002c-putting-floats">here, putting floats</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-home-page-for-manual">home page for manual</a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-horizontal-space">horizontal space</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chss">\hss</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-horizontal-space_002c-stretchable">horizontal space, stretchable</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chss">\hss</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hungarian-umlaut-accent">hungarian umlaut accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hyperref-package"><code>hyperref</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hyperref-package-1"><code>hyperref</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hyperref-package-2"><code>hyperref</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagenumbering">\pagenumbering</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hyperref-package-3"><code>hyperref</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-input">Command line input</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-defining">hyphenation, defining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chyphenation">\hyphenation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-discretionary">hyphenation, discretionary</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cdiscretionary">\discretionary</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-forcing">hyphenation, forcing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_002d-_0028hyphenation_0029">\- (hyphenation)</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-preventing">hyphenation, preventing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-I">I</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-I">I</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Icelandic-eth">Icelandic eth</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Icelandic-thorn">Icelandic thorn</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-idx-file">idx file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ij-letter_002c-Dutch">ij letter, Dutch</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-implementations-of-TeX">implementations of TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-importing-graphics">importing graphics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-in"><code>in</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-in_002dline-formulas">in-line formulas</a>:</td><td>&nbsp;</td><td valign="top"><a href="#math">math</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-inch"><code>inch</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-including-graphics">including graphics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-indent_002c-forcing">indent, forcing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindent-_0026-_005cnoindent">\indent &amp; \noindent</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-indentation-of-paragraphs_002c-in-minipage">indentation of paragraphs, in minipage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-indentfirst-package"><code>indentfirst</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpart">\part</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-indentfirst-package-1"><code>indentfirst</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cchapter">\chapter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-indentfirst-package-2"><code>indentfirst</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csection">\section</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-indentfirst-package-3"><code>indentfirst</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsection">\subsection</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-indentfirst-package-4"><code>indentfirst</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection &amp; \paragraph &amp; \subparagraph</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-indentfirst-package-5"><code>indentfirst</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindent-_0026-_005cnoindent">\indent &amp; \noindent</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-indent_005flength"><code>indent_length</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-indent_005fspace"><code>indent_space</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-index-entries_002c-_0060see_0027-and-_0060see-also_0027">index entries, &lsquo;see&rsquo; and &lsquo;see also&rsquo;</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-index-entry">index entry</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-index-package"><code>index</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-index_002c-page-range">index, page range</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-index_002c-printing">index, printing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprintindex">\printindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-index_002c-processing">index, processing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-index_002c-style-file"><code>index, style file</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-indexes">indexes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-infinite-horizontal-stretch">infinite horizontal stretch</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chfill">\hfill</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-infinite-vertical-stretch">infinite vertical stretch</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cvfill">\vfill</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-inner-paragraph-mode">inner paragraph mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-input-file">input file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-the-input">Splitting the input</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-input_002c-on-command-line">input, on command line</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-input">Command line input</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-input_002foutput_002c-to-terminal">input/output, to terminal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Terminal-input_002foutput">Terminal input/output</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-inserting-figures">inserting figures</a>:</td><td>&nbsp;</td><td valign="top"><a href="#figure">figure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-insertions-of-special-characters">insertions of special characters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Special-insertions">Special insertions</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-internal-vertical-mode">internal vertical mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-italic-correction">italic correction</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_002f">\/</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-italic-font">italic font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-itemize-environment"><code><code>itemize</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#itemize">itemize</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-item_005f0"><code>item_0</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-item_005f01"><code>item_01</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-item_005f1"><code>item_1</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-item_005f12"><code>item_12</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-item_005f2"><code>item_2</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-item_005fx1"><code>item_x1</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-item_005fx2"><code>item_x2</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-L">L</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-J">J</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-JPEG-files">JPEG files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-JPEG-files-1">JPEG files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-JPG-files">JPG files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-JPG-files-1">JPG files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-justification_002c-ragged-left">justification, ragged left</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedleft">\raggedleft</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-justification_002c-ragged-right">justification, ragged right</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedright">\raggedright</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th><a name="Index_cp_letter-K">K</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Knuth_002c-Donald-E_002e">Knuth, Donald E.</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th><a name="Index_cp_letter-L">L</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-label">label</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-labelled-lists_002c-creating">labelled lists, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#description">description</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Lamport-TeX">Lamport TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Lamport_002c-Leslie">Lamport, Leslie</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-landscape-option"><code>landscape <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-landscape-orientation">landscape orientation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-latex-command"><code>latex <span class="roman">command</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-LaTeX-logo">LaTeX logo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-LaTeX-overview">LaTeX overview</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-LaTeX-Project-team">LaTeX Project team</a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-LaTeX-vs_002e-LaTeX2e">LaTeX vs. LaTeX2e</a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-latex_002ddoc_002dptr-document"><code>latex-doc-ptr <span class="roman">document</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-LaTeX2e-logo">LaTeX2e logo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-latexrefman_0040tug_002eorg-email-address"><code><a href="mailto:latexrefman@tug.org">latexrefman@tug.org</a> <span class="roman">email address</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Latin-letters_002c-additional">Latin letters, additional</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-layout-commands">layout commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Layout">Layout</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-layout_002c-page-parameters-for">layout, page parameters for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-left-angle-quotation-marks">left angle quotation marks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-left-arrow_002c-in-text">left arrow, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-left-brace_002c-in-text">left brace, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-left-quote">left quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-left-quote_002c-double">left quote, double</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-left-quote_002c-single">left quote, single</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-left_002dhand-equation-numbers">left-hand equation numbers</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-left_002djustifying-text">left-justifying text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedright">\raggedright</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-left_002djustifying-text_002c-environment-for">left-justifying text, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#flushleft">flushleft</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-left_002dto_002dright-mode">left-to-right mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-legalpaper-option"><code>legalpaper <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lengths_002c-adding-to">lengths, adding to</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005caddtolength">\addtolength</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lengths_002c-allocating-new">lengths, allocating new</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewlength">\newlength</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lengths_002c-defining-and-using">lengths, defining and using</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Lengths">Lengths</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lengths_002c-setting">lengths, setting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csetlength">\setlength</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-leqno-option"><code>leqno <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-less-than-symbol_002c-in-text">less than symbol, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lethead_005fflag"><code>lethead_flag</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lethead_005fprefix"><code>lethead_prefix</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lethead_005fsuffix"><code>lethead_suffix</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-letter-class"><code>letter <span class="roman">class</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-classes">Document classes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-letter-environment"><code><code>letter</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#letter">letter</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-letterpaper-option"><code>letterpaper <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-letters_002c-accented">letters, accented</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-letters_002c-additional-Latin">letters, additional Latin</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-letters_002c-ending">letters, ending</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclosing">\closing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-letters_002c-starting">letters, starting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005copening">\opening</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-letters_002c-writing">letters, writing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Letters">Letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-line-break_002c-forcing">line break, forcing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_005c">\\</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-line-breaking">line breaking</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Line-breaking">Line breaking</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-line-breaks_002c-changing">line breaks, changing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfussy-_0026-_005csloppy">\fussy &amp; \sloppy</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-line-breaks_002c-forcing">line breaks, forcing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005clinebreak-_0026-_005cnolinebreak">\linebreak &amp; \nolinebreak</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-line-breaks_002c-multiplication-discretionary">line breaks, multiplication discretionary</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_002a">\*</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-line-breaks_002c-preventing">line breaks, preventing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005clinebreak-_0026-_005cnolinebreak">\linebreak &amp; \nolinebreak</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lines-in-tables">lines in tables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabular">tabular</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-line_005fmax"><code>line_max</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lining-numerals">lining numerals</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lining-text-up-in-tables">lining text up in tables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabular">tabular</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lining-text-up-using-tab-stops">lining text up using tab stops</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-list-environment"><code><code>list</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-lR-box"><code>lR box</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-list-items_002c-specifying-counter">list items, specifying counter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cusecounter">\usecounter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-list-of-figures-file">list of figures file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-list-of-tables-file">list of tables file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-listings-package"><code>listings</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-listings-package-1"><code>listings</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-listings-package-2"><code>listings</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lists-of-items">lists of items</a>:</td><td>&nbsp;</td><td valign="top"><a href="#itemize">itemize</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lists-of-items_002c-generic">lists of items, generic</a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lists-of-items_002c-numbered">lists of items, numbered</a>:</td><td>&nbsp;</td><td valign="top"><a href="#enumerate">enumerate</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-loading-additional-packages">loading additional packages</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-log-file">log file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-logo_002c-LaTeX">logo, LaTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-logo_002c-LaTeX2e">logo, LaTeX2e</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-logo_002c-TeX">logo, TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-long-command">long command</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-low_002d9-quotation-marks_002c-single-and-double">low-9 quotation marks, single and double</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-low_002dlevel-font-commands">low-level font commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lowercase">lowercase</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-LR-box"><code>LR box</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-LR-mode">LR mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-lrbox"><code>lrbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#lrbox">lrbox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-lshort-document"><code>lshort <span class="roman">document</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ltugboat-class"><code>ltugboat</code> class</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tugboat-template">tugboat template</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-lualatex-command"><code>lualatex <span class="roman">command</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-LuaTeX">LuaTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-M">M</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-M">M</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-m_002dwidth">m-width</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-macro-package_002c-LaTeX-as">macro package, LaTeX as</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-macron-accent">macron accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-macron-accent_002c-math">macron accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-macros2e-package"><code>macros2e</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Madsen_002c-Lars">Madsen, Lars</a>:</td><td>&nbsp;</td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-make-a-box">make a box</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-makeindex"><code>makeindex</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-makeindex-program"><code>makeindex</code> program</a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-makeindex_002c-style-file"><code>makeindex, style file</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-making-a-title-page">making a title page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#titlepage">titlepage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-making-paragraphs">making paragraphs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Making-paragraphs">Making paragraphs</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-marginal-notes">marginal notes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Marginal-notes">Marginal notes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-masculine-ordinal-symbol">masculine ordinal symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-matching-brackets">matching brackets</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cleft-_0026-_005cright">\left &amp; \right</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-matching-parentheses">matching parentheses</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cleft-_0026-_005cright">\left &amp; \right</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-math-accents">math accents</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-math-environment"><code><code>math</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#math">math</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-math-environment-1"><code><code>math</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-math-formulas">math formulas</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-math-functions">math functions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-math-miscellany">math miscellany</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-miscellany">Math miscellany</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-math-mode">math mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-math-mode_002c-entering">math mode, entering</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-math-mode_002c-spacing">math mode, spacing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-math-symbols">math symbols</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-math_002c-bold">math, bold</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-mathtools-package"><code>mathtools</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-mathtools-package-1"><code>mathtools</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Over_002d-and-Underlining">Over- and Underlining</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-MetaPost-package"><code>MetaPost</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-mfirstuc-package"><code>mfirstuc</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-mhchem-package"><code>mhchem</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts &amp; superscripts</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Millimeter">Millimeter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-minipage-environment"><code><code>minipage</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-minipage_002c-creating-a">minipage, creating a</a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-minted-package"><code>minted</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-minted-package-1"><code>minted</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-minted-package-2"><code>minted</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-mirrors-of-CTAN">mirrors of CTAN</a>:</td><td>&nbsp;</td><td valign="top"><a href="#CTAN">CTAN</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mm"><code>mm</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-modes">modes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-monospace-font">monospace font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-moving-arguments">moving arguments</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprotect">\protect</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-mpfootnote-counter">mpfootnote counter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mu"><code>mu</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-mu_002c-math-unit">mu, math unit</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-multicolumn-text">multicolumn text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctwocolumn">\twocolumn</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-multilingual-support">multilingual support</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-multind-package"><code>multind</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-multiplication_002c-discretionary">multiplication, discretionary</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_002a">\*</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-N">N</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-N">N</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-name"><code>name</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewglossaryentry">\newglossaryentry</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-NBSP">NBSP</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-nested-_005cinclude_002c-not-allowed">nested <code>\include</code>, not allowed</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cinclude-_0026-_005cincludeonly">\include &amp; \includeonly</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-new-class-commands">new class commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-construction">Class and package construction</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-new-command_002c-check">new command, check</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-new-command_002c-definition">new command, definition</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-new-commands_002c-defining">new commands, defining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-new-commands_002c-defining-1">new commands, defining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprovidecommand">\providecommand</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-new-line_002c-output-as-input">new line, output as input</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cobeycr-_0026-_005crestorecr">\obeycr &amp; \restorecr</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-new-line_002c-starting">new line, starting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_005c">\\</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-new-line_002c-starting-_0028paragraph-mode_0029">new line, starting (paragraph mode)</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewline">\newline</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-new-page_002c-starting">new page, starting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewpage">\newpage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-non_002dEnglish-characters">non-English characters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-notes-in-the-margin">notes in the margin</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Marginal-notes">Marginal notes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-notitlepage-option"><code>notitlepage <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-null-delimiter">null delimiter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cleft-_0026-_005cright">\left &amp; \right</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-numbered-items_002c-specifying-counter">numbered items, specifying counter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cusecounter">\usecounter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-numerals_002c-old_002dstyle">numerals, old-style</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-O">O</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-O">O</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-oblique-font">oblique font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-oe-ligature">oe ligature</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ogonek">ogonek</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-old_002dstyle-numerals">old-style numerals</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-one_002dcolumn-output">one-column output</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005conecolumn">\onecolumn</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-onecolumn-option"><code>onecolumn <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-oneside-option"><code>oneside <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-openany-option"><code>openany <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-openbib-option"><code>openbib <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-opening-quote">opening quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-openright-option"><code>openright <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-OpenType-fonts">OpenType fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-options_002c-class">options, class</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-options_002c-color-package">options, color package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Color-package-options">Color package options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-options_002c-command-line">options, command line</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-options_002c-document-class">options, document class</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-options_002c-document-class-1">options, document class</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-options_002c-global">options, global</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-options_002c-graphics-package">options, graphics package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-options">Graphics package options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-options_002c-package">options, package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-options_002c-package-1">options, package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ordinals_002c-feminine-and-masculine">ordinals, feminine and masculine</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-oslash">oslash</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-outer-paragraph-mode">outer paragraph mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-overbar-accent">overbar accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-overdot-accent_002c-math">overdot accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-overlining">overlining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Over_002d-and-Underlining">Over- and Underlining</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-overview-of-LaTeX">overview of LaTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-P">P</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-P">P</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package-file-layout">package file layout</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package-options">package options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package-options-1">package options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-algorithm2e"><span class="roman">package</span>, <code>algorithm2e</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsfonts"><span class="roman">package</span>, <code>amsfonts</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsmath"><span class="roman">package</span>, <code>amsmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsmath-1"><span class="roman">package</span>, <code>amsmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsmath-2"><span class="roman">package</span>, <code>amsmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#displaymath">displaymath</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsmath-3"><span class="roman">package</span>, <code>amsmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#equation">equation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsmath-4"><span class="roman">package</span>, <code>amsmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#theorem">theorem</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsmath-5"><span class="roman">package</span>, <code>amsmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsmath-6"><span class="roman">package</span>, <code>amsmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Dots">Dots</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsmath-7"><span class="roman">package</span>, <code>amsmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsmath-8"><span class="roman">package</span>, <code>amsmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colon-character-_0026-_005ccolon">Colon character &amp; \colon</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsmath-9"><span class="roman">package</span>, <code>amsmath</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colon-character-_0026-_005ccolon">Colon character &amp; \colon</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsthm"><span class="roman">package</span>, <code>amsthm</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#theorem">theorem</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-amsthm-1"><span class="roman">package</span>, <code>amsthm</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005crule">\rule</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-appendix"><span class="roman">package</span>, <code>appendix</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cappendix">\appendix</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-array-_0028package_0029"><span class="roman">package</span>, <code>array (package)</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-Asymptote"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-Asymptote-1"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cstrut">\strut</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-Asymptote-2"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-babel"><span class="roman">package</span>, <code>babel</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cchapter">\chapter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-babel-1"><span class="roman">package</span>, <code>babel</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-babel-2"><span class="roman">package</span>, <code>babel</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-babel-3"><span class="roman">package</span>, <code>babel</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-babel-4"><span class="roman">package</span>, <code>babel</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-babel-5"><span class="roman">package</span>, <code>babel</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-bigfoot"><span class="roman">package</span>, <code>bigfoot</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes-of-footnotes">Footnotes of footnotes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-bm"><span class="roman">package</span>, <code>bm</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cboldmath-_0026-_005cunboldmath">\boldmath &amp; \unboldmath</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-cleveref"><span class="roman">package</span>, <code>cleveref</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-cleveref-1"><span class="roman">package</span>, <code>cleveref</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-cleveref-2"><span class="roman">package</span>, <code>cleveref</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-cprotect"><span class="roman">package</span>, <code>cprotect</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-cprotect-1"><span class="roman">package</span>, <code>cprotect</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-datetime"><span class="roman">package</span>, <code>datetime</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-dcolumn"><span class="roman">package</span>, <code>dcolumn</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#array">array</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-enumitem"><span class="roman">package</span>, <code>enumitem</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#list">list</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-envlab"><span class="roman">package</span>, <code>envlab</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakelabels">\makelabels</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-etoolbox"><span class="roman">package</span>, <code>etoolbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-eurosym"><span class="roman">package</span>, <code>eurosym</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-fancyhdr"><span class="roman">package</span>, <code>fancyhdr</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-styles">Page styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-fancyhdr-1"><span class="roman">package</span>, <code>fancyhdr</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-fancyvrb"><span class="roman">package</span>, <code>fancyvrb</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-fancyvrb-1"><span class="roman">package</span>, <code>fancyvrb</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-flafter"><span class="roman">package</span>, <code>flafter</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-float"><span class="roman">package</span>, <code>float</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-geometry"><span class="roman">package</span>, <code>geometry</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-geometry-1"><span class="roman">package</span>, <code>geometry</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-hyperref"><span class="roman">package</span>, <code>hyperref</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-hyperref-1"><span class="roman">package</span>, <code>hyperref</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-hyperref-2"><span class="roman">package</span>, <code>hyperref</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagenumbering">\pagenumbering</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-hyperref-3"><span class="roman">package</span>, <code>hyperref</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-input">Command line input</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-indentfirst"><span class="roman">package</span>, <code>indentfirst</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpart">\part</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-indentfirst-1"><span class="roman">package</span>, <code>indentfirst</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cchapter">\chapter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-indentfirst-2"><span class="roman">package</span>, <code>indentfirst</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csection">\section</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-indentfirst-3"><span class="roman">package</span>, <code>indentfirst</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsection">\subsection</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-indentfirst-4"><span class="roman">package</span>, <code>indentfirst</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection &amp; \paragraph &amp; \subparagraph</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-indentfirst-5"><span class="roman">package</span>, <code>indentfirst</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindent-_0026-_005cnoindent">\indent &amp; \noindent</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-index"><span class="roman">package</span>, <code>index</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-listings"><span class="roman">package</span>, <code>listings</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-listings-1"><span class="roman">package</span>, <code>listings</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-listings-2"><span class="roman">package</span>, <code>listings</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-macros2e"><span class="roman">package</span>, <code>macros2e</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-mathtools"><span class="roman">package</span>, <code>mathtools</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-mathtools-1"><span class="roman">package</span>, <code>mathtools</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Over_002d-and-Underlining">Over- and Underlining</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-MetaPost"><span class="roman">package</span>, <code>MetaPost</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-mfirstuc"><span class="roman">package</span>, <code>mfirstuc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-mhchem"><span class="roman">package</span>, <code>mhchem</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts &amp; superscripts</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-minted"><span class="roman">package</span>, <code>minted</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-minted-1"><span class="roman">package</span>, <code>minted</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-minted-2"><span class="roman">package</span>, <code>minted</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-multind"><span class="roman">package</span>, <code>multind</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-pict2e"><span class="roman">package</span>, <code>pict2e</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-polyglossia"><span class="roman">package</span>, <code>polyglossia</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-polyglossia-1"><span class="roman">package</span>, <code>polyglossia</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-polyglossia-2"><span class="roman">package</span>, <code>polyglossia</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-polyglossia-3"><span class="roman">package</span>, <code>polyglossia</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-PSTricks"><span class="roman">package</span>, <code>PSTricks</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-sagetex"><span class="roman">package</span>, <code>sagetex</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-setspace"><span class="roman">package</span>, <code>setspace</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-showidx"><span class="roman">package</span>, <code>showidx</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-siunitx"><span class="roman">package</span>, <code>siunitx</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-symbols"><span class="roman">package</span>, <code>symbols</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-textcase"><span class="roman">package</span>, <code>textcase</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-textcomp"><span class="roman">package</span>, <code>textcomp</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-TikZ"><span class="roman">package</span>, <code>TikZ</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-TikZ-1"><span class="roman">package</span>, <code>TikZ</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cstrut">\strut</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-TikZ-2"><span class="roman">package</span>, <code>TikZ</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-titlesec"><span class="roman">package</span>, <code>titlesec</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpart">\part</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-titlesec-1"><span class="roman">package</span>, <code>titlesec</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cchapter">\chapter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-titlesec-2"><span class="roman">package</span>, <code>titlesec</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csection">\section</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-titlesec-3"><span class="roman">package</span>, <code>titlesec</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsection">\subsection</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-titlesec-4"><span class="roman">package</span>, <code>titlesec</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection &amp; \paragraph &amp; \subparagraph</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-tocbibbind"><span class="roman">package</span>, <code>tocbibbind</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-tocloft"><span class="roman">package</span>, <code>tocloft</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-ulem"><span class="roman">package</span>, <code>ulem</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Over_002d-and-Underlining">Over- and Underlining</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-url"><span class="roman">package</span>, <code>url</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-verbatimbox"><span class="roman">package</span>, <code>verbatimbox</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-packages_002c-loading-additional">packages, loading additional</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-page-break_002c-forcing">page break, forcing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagebreak-_0026-_005cnopagebreak">\pagebreak &amp; \nopagebreak</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-page-break_002c-preventing">page break, preventing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagebreak-_0026-_005cnopagebreak">\pagebreak &amp; \nopagebreak</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-page-breaking">page breaking</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-breaking">Page breaking</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-page-layout-parameters">page layout parameters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-page-number_002c-cross-referencing">page number, cross referencing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpageref">\pageref</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-page-numbering-style">page numbering style</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagenumbering">\pagenumbering</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-page-style_002c-this-page">page style, this page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cthispagestyle">\thispagestyle</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-page-styles">page styles</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-styles">Page styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-page_002c-colored">page, colored</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Colored-pages">Colored pages</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-page_005fprecedence"><code>page_precedence</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paired-delimiters">paired delimiters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cleft-_0026-_005cright">\left &amp; \right</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paragraph">paragraph</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paragraph-1">paragraph</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection &amp; \paragraph &amp; \subparagraph</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paragraph-indentation">paragraph indentation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paragraph-indentation_002c-in-minipage">paragraph indentation, in minipage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#minipage">minipage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paragraph-indentations-in-quoted-text">paragraph indentations in quoted text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-_0026-quote">quotation &amp; quote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paragraph-indentations-in-quoted-text_002c-omitting">paragraph indentations in quoted text, omitting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-_0026-quote">quotation &amp; quote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paragraph-mode">paragraph mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paragraph-mode-1">paragraph mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cparbox">\parbox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paragraph-symbol">paragraph symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paragraph_002c-ending">paragraph, ending</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpar">\par</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paragraph_002c-in-a-box">paragraph, in a box</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cparbox">\parbox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-paragraphs">paragraphs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Making-paragraphs">Making paragraphs</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-parameters_002c-for-footnotes">parameters, for footnotes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-parameters_002c-page-layout">parameters, page layout</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-part">part</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-part-1">part</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpart">\part</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pc"><code>pc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-PDF-graphic-files">PDF graphic files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-PDF-graphic-files-1">PDF graphic files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pdflatex-command"><code>pdflatex <span class="roman">command</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-pdfTeX">pdfTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-pdfTeX-engine">pdfTeX engine</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-period_002c-abbreviation_002dending">period, abbreviation-ending</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0040">\@</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-period_002c-centered_002c-in-text">period, centered, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-period_002c-sentence_002dending">period, sentence-ending</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0040">\@</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-period_002c-spacing-after">period, spacing after</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0040">\@</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-pica">pica</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-pict2e-package"><code>pict2e</code> package</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-pict2e-package-1"><code>pict2e</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-picture-environment"><code><code>picture</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-pictures_002c-creating">pictures, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-pilcrow">pilcrow</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-placement-of-floats">placement of floats</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-plural"><code>plural</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewglossaryentry">\newglossaryentry</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-PNG-files">PNG files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-PNG-files-1">PNG files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-poetry_002c-an-environment-for">poetry, an environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#verse">verse</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Point">Point</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-polish-l">polish l</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-polyglossia-package"><code>polyglossia</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-polyglossia-package-1"><code>polyglossia</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-polyglossia-package-2"><code>polyglossia</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-polyglossia-package-3"><code>polyglossia</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cindex">\index</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-portrait-orientation">portrait orientation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-position_002c-in-picture">position, in picture</a>:</td><td>&nbsp;</td><td valign="top"><a href="#picture">picture</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-positional-parameter">positional parameter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-postamble"><code>postamble</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-postscript_002c-in-letters">postscript, in letters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cps">\ps</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-pounds-symbol">pounds symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-preamble"><code>preamble</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-preamble_002c-defined">preamble, defined</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-prompt_002c-_002a">prompt, &lsquo;<samp>*</samp>&rsquo;</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Recovering-from-errors">Recovering from errors</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-pronunciation">pronunciation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview">Overview</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-PSTricks-package"><code>PSTricks</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pt"><code>pt</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-Q">Q</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-quotation-environment"><code><code>quotation</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-and-quote">quotation and quote</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-quote-environment"><code><code>quote</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-and-quote">quotation and quote</a></td></tr>
+<tr><th><a name="Index_cp_letter-Q">Q</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-quad">quad</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-question-mark_002c-upside_002ddown">question mark, upside-down</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-quotation-environment"><code><code>quotation</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-_0026-quote">quotation &amp; quote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-quotation-marks_002c-French">quotation marks, French</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-quote-environment"><code><code>quote</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-_0026-quote">quotation &amp; quote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-quote_002c-single-straight">quote, single straight</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-quote_002c-straight-base">quote, straight base</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-quoted-text-with-paragraph-indentation_002c-displaying">quoted text with paragraph indentation, displaying</a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-_0026-quote">quotation &amp; quote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-quoted-text-without-paragraph-indentation_002c-displaying">quoted text without paragraph indentation, displaying</a>:</td><td>&nbsp;</td><td valign="top"><a href="#quotation-_0026-quote">quotation &amp; quote</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-R">R</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-R">R</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-radical">radical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csqrt">\sqrt</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ragged-left-text">ragged left text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedleft">\raggedleft</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ragged-left-text_002c-environment-for">ragged left text, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#flushright">flushright</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ragged-right-text">ragged right text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedright">\raggedright</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ragged-right-text_002c-environment-for">ragged right text, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#flushleft">flushleft</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-redefining-environments">redefining environments</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment &amp; \renewenvironment</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-reference_002c-forward">reference, forward</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-references_002c-resolving-forward">references, resolving forward</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-registered-symbol">registered symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-relation_002c-text-above">relation, text above</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cstackrel">\stackrel</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-remarks-in-the-margin">remarks in the margin</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Marginal-notes">Marginal notes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-report-class"><code>report <span class="roman">class</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-classes">Document classes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-reporting-bugs">reporting bugs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-reserved-characters">reserved characters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-resizing">resizing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-resizing-1">resizing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-right-angle-quotation-marks">right angle quotation marks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-right-arrow_002c-in-text">right arrow, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-right-brace_002c-in-text">right brace, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-right-quote">right quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-right-quote_002c-double">right quote, double</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-right-quote_002c-single">right quote, single</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-right_002dhand-equation-numbers">right-hand equation numbers</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-right_002djustifying-text">right-justifying text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedleft">\raggedleft</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-right_002djustifying-text_002c-environment-for">right-justifying text, environment for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#flushright">flushright</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ring-accent">ring accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ring-accent_002c-math">ring accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-robust-commands">robust commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cprotect">\protect</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-roman-font">roman font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-root-file">root file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-the-input">Splitting the input</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-roots">roots</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csqrt">\sqrt</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-rotating-graphics">rotating graphics</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005crotatebox">\rotatebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-rotating-text">rotating text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005crotatebox">\rotatebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-rotation">rotation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005crotatebox">\rotatebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-row_002c-tabbing">row, <span class="roman">tabbing</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-rubber-lengths_002c-defining-new">rubber lengths, defining new</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewlength">\newlength</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-running-header-and-footer">running header and footer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-running-header-and-footer-style">running header and footer style</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-S">S</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-S">S</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-sagetex-package"><code>sagetex</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-sans-serif-font">sans serif font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Scaled-point">Scaled point</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-scaling">scaling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-scaling-1">scaling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-script-fonts">script fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Calligraphic">Calligraphic</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-script-letters-for-math">script letters for math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-secnumdepth"><code>secnumdepth</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-secnumdepth-counter"><code>secnumdepth <span class="roman">counter</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-section">section</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-section-1">section</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csection">\section</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-section-number_002c-cross-referencing">section number, cross referencing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-section-numbers_002c-printing">section numbers, printing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-section-symbol">section symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-section_002c-redefining">section, redefining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0040startsection">\@startsection</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-sectioning-commands">sectioning commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-sectioning_002c-part">sectioning, part</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpart">\part</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-series_002c-of-fonts">series, of fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-setspace-package"><code>setspace</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-setting-counters">setting counters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csetcounter">\setcounter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-shapes_002c-of-fonts">shapes, of fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-sharp-S-letters">sharp S letters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-showidx-package"><code>showidx</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-simulating-typed-text">simulating typed text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-single-angle-quotation-marks">single angle quotation marks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-single-guillemets">single guillemets</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-single-left-quote">single left quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-single-low_002d9-quotation-mark">single low-9 quotation mark</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-single-quote_002c-straight">single quote, straight</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-single-right-quote">single right quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-siunitx-package"><code>siunitx</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-sizes-of-text">sizes of text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-skip-register_002c-plain-TeX">skip register, plain TeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewlength">\newlength</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-slanted-font">slanted font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-slides-class"><code>slides <span class="roman">class</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-classes">Document classes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-sloppypar"><code>sloppypar</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#sloppypar">sloppypar</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-sloppypar-environment">sloppypar environment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#sloppypar">sloppypar</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-small-caps-font">small caps font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-sort"><code>sort</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewglossaryentry">\newglossaryentry</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-sp"><code>sp</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-space_002c-hard">space, hard</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-space_002c-inserting-horizontal">space, inserting horizontal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chss">\hss</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-space_002c-inserting-vertical">space, inserting vertical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005caddvspace">\addvspace</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-space_002c-negative-thin">space, negative thin</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cthinspace-_0026-_005cnegthinspace">\thinspace &amp; \negthinspace</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-space_002c-thin">space, thin</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cthinspace-_0026-_005cnegthinspace">\thinspace &amp; \negthinspace</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-space_002c-unbreakable">space, unbreakable</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-space_002c-vertical">space, vertical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cvspace">\vspace</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-spaces">spaces</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spaces">Spaces</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-spaces_002c-ignore-around-commands">spaces, ignore around commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cignorespaces-_0026-_005cignorespacesafterend">\ignorespaces &amp; \ignorespacesafterend</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-spacing-within-math-mode">spacing within math mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-spacing_002c-inter_002dsentence">spacing, inter-sentence</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cfrenchspacing">\frenchspacing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-spacing_002c-inter_002dsentence-1">spacing, inter-sentence</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnormalsfcodes">\normalsfcodes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Spanish-ordinals_002c-feminine-and-masculine">Spanish ordinals, feminine and masculine</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-special-characters">special characters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-special-characters-1">special characters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-special-insertions">special insertions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Special-insertions">Special insertions</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-specifier_002c-float-placement">specifier, float placement</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-splitting-the-input-file">splitting the input file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-the-input">Splitting the input</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-square-root">square root</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csqrt">\sqrt</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-stack-math">stack math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cstackrel">\stackrel</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-star_002dvariants_002c-commands">star-variants, commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005c_0040ifstar">\@ifstar</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-starred-form_002c-defining-new-commands">starred form, defining new commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-starting-a-new-page">starting a new page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewpage">\newpage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-starting-a-new-page-and-clearing-floats">starting a new page and clearing floats</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-starting-and-ending">starting and ending</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-starting-on-a-right_002dhand-page">starting on a right-hand page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-sterling-symbol">sterling symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-straight-double-quote_002c-base">straight double quote, base</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-straight-quote_002c-base">straight quote, base</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-straight-single-quote">straight single quote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-stretch_002c-infinite-horizontal">stretch, infinite horizontal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005chfill">\hfill</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-stretch_002c-infinite-vertical">stretch, infinite vertical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cvfill">\vfill</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-stretch_002c-omitting-vertical">stretch, omitting vertical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005craggedbottom">\raggedbottom</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-strut">strut</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cstrut">\strut</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-styles-of-text">styles of text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-styles_002c-page">styles, page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-styles">Page styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-subparagraph">subparagraph</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-subparagraph-1">subparagraph</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection &amp; \paragraph &amp; \subparagraph</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-subscript">subscript</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts &amp; superscripts</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-subsection">subsection</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-subsection-1">subsection</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsection">\subsection</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-subsubsection">subsubsection</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection &amp; \paragraph &amp; \subparagraph</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-superscript">superscript</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts &amp; superscripts</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-symbol"><code>symbol</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewglossaryentry">\newglossaryentry</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-symbols-package"><code>symbols</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-symbols_002c-boldface">symbols, boldface</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cboldmath-_0026-_005cunboldmath">\boldmath &amp; \unboldmath</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-symbols_002c-math">symbols, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-symbols_002c-text">symbols, text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-T">T</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-T">T</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tab-stops_002c-using">tab stops, using</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tabbing-environment"><code><code>tabbing</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-table-environment"><code><code>table</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#table">table</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-table-of-contents-entry_002c-manually-adding">table of contents entry, manually adding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005caddcontentsline">\addcontentsline</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-table-of-contents-file">table of contents file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-table-of-contents_002c-avoiding-footnotes">table of contents, avoiding footnotes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Footnotes-in-section-headings">Footnotes in section headings</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-table-of-contents_002c-creating">table of contents, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-table-of-contents_002c-sectioning-numbers-printed">table of contents, sectioning numbers printed</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tables_002c-creating">tables, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#table">table</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tabular-environment"><code><code>tabular</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#tabular">tabular</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-template_002c-article">template, <code>article</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#article-template">article template</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-template_002c-beamer">template, <code>beamer</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#beamer-template">beamer template</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-template_002c-book">template, <code>book</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#book-template">book template</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-template_002c-book-1">template, <code>book</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Larger-book-template">Larger book template</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-template_002c-TUGboat">template, TUGboat</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tugboat-template">tugboat template</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-templates_002c-document">templates, document</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-templates">Document templates</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-terminal-input_002foutput">terminal input/output</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Terminal-input_002foutput">Terminal input/output</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-TeX-logo">TeX logo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-text-symbols">text symbols</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-text_002c-resizing">text, resizing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-text_002c-resizing-1">text, resizing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-text_002c-scaling">text, scaling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-text_002c-scaling-1">text, scaling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-textcase-package"><code>textcase</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-textcomp-package"><code>textcomp</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-textcomp-package-1"><code>textcomp <span class="roman">package</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-thanks_002c-for-titlepage">thanks, for titlepage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-thebibliography-environment"><code><code>thebibliography</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-theorem-environment"><code><code>theorem</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#theorem">theorem</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-theorem_002dlike-environment">theorem-like environment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewtheorem">\newtheorem</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-theorems_002c-defining">theorems, defining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cnewtheorem">\newtheorem</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-theorems_002c-typesetting">theorems, typesetting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#theorem">theorem</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-thin-space">thin space</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-thin-space-1">thin space</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cthinspace-_0026-_005cnegthinspace">\thinspace &amp; \negthinspace</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-thin-space_002c-negative">thin space, negative</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spacing-in-math-mode">Spacing in math mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-thin-space_002c-negative-1">thin space, negative</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cthinspace-_0026-_005cnegthinspace">\thinspace &amp; \negthinspace</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-thorn_002c-Icelandic-letter">thorn, Icelandic letter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-three_002dquarters-em_002ddash">three-quarters em-dash</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tie">tie</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tie_002dafter-accent">tie-after accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-TikZ-package"><code>TikZ</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-TikZ-package-1"><code>TikZ</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cstrut">\strut</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-TikZ-package-2"><code>TikZ</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox &amp; \makebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tilde-accent">tilde accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tilde-accent_002c-math">tilde accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tilde_002c-ASCII_002c-in-text">tilde, ASCII, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-title-page_002c-separate-or-run_002din">title page, separate or run-in</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-title-pages_002c-creating">title pages, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#titlepage">titlepage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-title_002c-for-titlepage">title, for titlepage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-titlepage-environment"><code><code>titlepage</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#titlepage">titlepage</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-titlepage-option"><code>titlepage <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-titles_002c-making">titles, making</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-titlesec-package"><code>titlesec</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cpart">\part</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-titlesec-package-1"><code>titlesec</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cchapter">\chapter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-titlesec-package-2"><code>titlesec</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csection">\section</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-titlesec-package-3"><code>titlesec</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsection">\subsection</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-titlesec-package-4"><code>titlesec</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection &amp; \paragraph &amp; \subparagraph</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tocbibbind-package"><code>tocbibbind</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tocdepth"><code>tocdepth</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tocdepth-counter"><code>tocdepth <span class="roman">counter</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tocloft-package"><code>tocloft</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-today_0027s-date">today&rsquo;s date</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-tombstone">tombstone</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005crule">\rule</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-topmargin"><code>topmargin</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-topnumber"><code>topnumber</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-topnumber-1"><code>topnumber</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-totalnumber"><code>totalnumber</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-totalnumber-1"><code>totalnumber</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Floats">Floats</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-trademark-symbol">trademark symbol</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-transcript-file">transcript file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-TrueType-fonts">TrueType fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-TUGboat-template">TUGboat template</a>:</td><td>&nbsp;</td><td valign="top"><a href="#tugboat-template">tugboat template</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-two_002dcolumn-output">two-column output</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005ctwocolumn">\twocolumn</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-two_002dthirds-em_002ddash">two-thirds em-dash</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-twocolumn-option"><code>twocolumn <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-twoside-option"><code>twoside <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-type-styles">type styles</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-typed-text_002c-simulating">typed text, simulating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-typeface-sizes">typeface sizes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-typefaces">typefaces</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Fonts">Fonts</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-typewriter-font">typewriter font</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-typewriter-labels-in-lists">typewriter labels in lists</a>:</td><td>&nbsp;</td><td valign="top"><a href="#description">description</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-U">U</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-U">U</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ulem-package"><code>ulem</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Over_002d-and-Underlining">Over- and Underlining</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-umlaut-accent">umlaut accent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-underbar">underbar</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-underlining">underlining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Over_002d-and-Underlining">Over- and Underlining</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-underscore_002c-in-text">underscore, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Unicode-input_002c-native">Unicode input, native</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-units_002c-of-length">units, of length</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-unofficial-nature-of-this-manual">unofficial nature of this manual</a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-unordered-lists">unordered lists</a>:</td><td>&nbsp;</td><td valign="top"><a href="#itemize">itemize</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-uppercase">uppercase</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-url-package"><code>url</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-using-BibTeX">using BibTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-BibTeX">Using BibTeX</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-usrguide-official-documentation"><code>usrguide <span class="roman">official documentation</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-UTF_002d8">UTF-8</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-V">V</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-V">V</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-variables_002c-a-list-of">variables, a list of</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Counters">Counters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-vector-symbol_002c-math">vector symbol, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-verbatim-environment"><code><code>verbatim</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-verbatim-text">verbatim text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-verbatim-text_002c-inline">verbatim text, inline</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-verbatimbox-package"><code>verbatimbox</code> <span class="roman">package</span></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-verse-environment"><code><code>verse</code> <span class="roman">environment</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#verse">verse</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-vertical-bar_002c-double_002c-in-text">vertical bar, double, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-vertical-bar_002c-in-text">vertical bar, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-vertical-mode">vertical mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modes">Modes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-vertical-space">vertical space</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cvspace">\vspace</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-vertical-space-1">vertical space</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005caddvspace">\addvspace</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-vertical-space-before-paragraphs">vertical space before paragraphs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-visible-space">visible space</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-visible-space-symbol_002c-in-text">visible space symbol, in text</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th><a name="Index_cp_letter-W">W</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-weights_002c-of-fonts">weights, of fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-white-space">white space</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Spaces">Spaces</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-wide-hat-accent_002c-math">wide hat accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-wide-tilde-accent_002c-math">wide tilde accent, math</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-widths_002c-of-fonts">widths, of fonts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-writing-external-files">writing external files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#filecontents">filecontents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-writing-letters">writing letters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Letters">Letters</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Command-Index_fn_letter-X">X</a></th><td></td><td></td></tr>
+<tr><th><a name="Index_cp_letter-X">X</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-x_002dheight">x-height</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xdvi-command"><code>xdvi <span class="roman">command</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xdvipdfmx"><code>xdvipdfmx</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xelatex-command"><code>xelatex <span class="roman">command</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-XeTeX">XeTeX</a>:</td><td>&nbsp;</td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-xindy"><code>xindy</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-xindy-program"><code>xindy</code> program</a>:</td><td>&nbsp;</td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
</table>
-<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Command-Index_fn_symbol-1"><b>$</b></a>
+<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>&amp;</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_symbol-2"><b>*</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_symbol-3"><b>-</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_symbol-4"><b>.</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-2"><b>&amp;</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-5"><b>1</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-3"><b>-</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-6"><b>:</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-4"><b>.</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-7"><b>[</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-5"><b>1</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-8"><b>\</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-6"><b>[</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-9"><b>^</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-7"><b>\</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-10"><b>_</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-8"><b>^</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-11"><b>`</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-9"><b>_</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-12"><b>{</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_symbol-10"><b>{</b></a>
+<a class="summary-letter" href="#Index_cp_symbol-13"><b>~</b></a>
&nbsp;
<br>
-<a class="summary-letter" href="#Command-Index_fn_letter-A"><b>A</b></a>
+<a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_letter-B"><b>B</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_letter-C"><b>C</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_letter-D"><b>D</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_letter-E"><b>E</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-B"><b>B</b></a>
+<a class="summary-letter" href="#Index_cp_letter-F"><b>F</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-C"><b>C</b></a>
+<a class="summary-letter" href="#Index_cp_letter-G"><b>G</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-D"><b>D</b></a>
+<a class="summary-letter" href="#Index_cp_letter-H"><b>H</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-E"><b>E</b></a>
+<a class="summary-letter" href="#Index_cp_letter-I"><b>I</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-F"><b>F</b></a>
+<a class="summary-letter" href="#Index_cp_letter-J"><b>J</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-H"><b>H</b></a>
+<a class="summary-letter" href="#Index_cp_letter-K"><b>K</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-I"><b>I</b></a>
+<a class="summary-letter" href="#Index_cp_letter-L"><b>L</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-L"><b>L</b></a>
+<a class="summary-letter" href="#Index_cp_letter-M"><b>M</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-M"><b>M</b></a>
+<a class="summary-letter" href="#Index_cp_letter-N"><b>N</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-N"><b>N</b></a>
+<a class="summary-letter" href="#Index_cp_letter-O"><b>O</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-O"><b>O</b></a>
+<a class="summary-letter" href="#Index_cp_letter-P"><b>P</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-P"><b>P</b></a>
+<a class="summary-letter" href="#Index_cp_letter-Q"><b>Q</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-Q"><b>Q</b></a>
+<a class="summary-letter" href="#Index_cp_letter-R"><b>R</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-R"><b>R</b></a>
+<a class="summary-letter" href="#Index_cp_letter-S"><b>S</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-S"><b>S</b></a>
+<a class="summary-letter" href="#Index_cp_letter-T"><b>T</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-T"><b>T</b></a>
+<a class="summary-letter" href="#Index_cp_letter-U"><b>U</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-U"><b>U</b></a>
+<a class="summary-letter" href="#Index_cp_letter-V"><b>V</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-V"><b>V</b></a>
+<a class="summary-letter" href="#Index_cp_letter-W"><b>W</b></a>
&nbsp;
-<a class="summary-letter" href="#Command-Index_fn_letter-X"><b>X</b></a>
+<a class="summary-letter" href="#Index_cp_letter-X"><b>X</b></a>
&nbsp;
</td></tr></table>
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.pdf b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.pdf
index 0abfe9be01b..7eb362ad0ec 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.pdf
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.texi b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.texi
index 7cba667c8ed..afd657383e5 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.texi
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.texi
@@ -1,8 +1,8 @@
\input texinfo
-@c $Id: latex2e.texi 613 2018-03-21 18:48:08Z jimhefferon $
+@c $Id: latex2e.texi 678 2018-07-02 20:51:26Z karl $
@comment %**start of header (This is for running Texinfo on a region.)
@setfilename latex2e.info
-@set UPDATED March 2018
+@set UPDATED July 2018
@include common.texi
@settitle @LaTeX{}2e unofficial reference manual (@value{UPDATED})
@comment %**end of header (This is for running Texinfo on a region.)
@@ -11,17 +11,24 @@
@c xx but latex2e stuff is missing.
@c xx random list of a few of the missing items is at the end of this file
@c
-@c xx ending a run with errors
@c xx ctan, distributions, components of TeX
@c xx classes and packages -- required, additional, useful; oberdiek; fonts
@c
-@c xx merge http://ctan.org/pkg/latex-info (CTAN package latex-info)
-@c xx merge http://ctan.org/pkg/latex2e-reference
@c xx merge permuted-index
@c xx merge latex-manual from savannah
@c xx merge display style math
-@c xx vertical mode, horizontal mode
-@c xx JH Discuss restricted execution
+@c xx JH explain nfss somewhere
+@c xx JH expand BiBTeX
+@c xx JH expand theorem, AMS math
+@c xx JH something on code listings
+@c xx JH ligatures
+@c xx JH \xspace
+@c xx JH \stretch
+@c xx JH \mathstrut
+@c xx JH \phantom https://tex.stackexchange.com/questions/4519/how-do-i-create-an-invisible-character
+@c xx JH \baselineskip https://texfaq.org/FAQ-baselinepar
+@c xx JH \contentsline, \@@dottedtocline?
+@c xx JH more on \write18, beyond what's mentioned in Command line.
@c
@c xx The typeset source2e has an index with all kernel
@c xx commands, though some are internal and shouldn't be included.
@@ -71,6 +78,9 @@ into another language, under the above conditions for modified versions.
@comment end of License
@end copying
+@c Merge into one index (arbitrarily chosen to be the concept index).
+@syncodeindex fn cp
+
@dircategory TeX
@direntry
* LaTeX2e: (latex2e). Unofficial LaTeX reference manual.
@@ -136,7 +146,7 @@ This document is an unofficial reference manual (version of
* Document classes:: Some of the various classes available.
* Fonts:: Italic, bold, typewriter, etc.
* Layout:: Controlling the page layout.
-* Sectioning:: How to section properly.
+* Sectioning:: Parts, Chapters, Sections, etc.
* Cross references:: Automatic referencing.
* Environments:: Such as enumerate & itemize.
* Line breaking:: Influencing line breaks.
@@ -160,15 +170,14 @@ This document is an unofficial reference manual (version of
* Terminal input/output:: User interaction.
* Command line:: System-independent command-line behavior.
* Document templates:: Starter templates for various document classes.
-* Concept Index:: General index.
-* Command Index:: Alphabetical list of @LaTeX{} commands.
+* Index:: General index.
@end menu
@node About this document
@chapter About this document
-@findex @url{@value{LTXREFMAN_HOME_PAGE}} @r{home page}
+@cindex home page for manual
This is an unofficial reference manual for the @LaTeX{}2e document
preparation system, which is a macro package for the @TeX{}
typesetting program (@pxref{Overview}). This document's home page is
@@ -259,10 +268,11 @@ produce the logo with @code{\LaTeX}. Where use of the logo is not
sensible, such as in plain text, write it as @samp{LaTeX}.
@menu
-* Starting and ending:: The standard beginning and end of a document.
-* Output files:: Files produced.
+* Starting and ending:: The standard beginning and end of a document.
+* Output files:: Files produced.
* @TeX{} engines:: Programs that can compile @TeX{} and @LaTeX{}.
* @LaTeX{} command syntax:: General syntax of @LaTeX{} commands.
+* CTAN:: Our repository.
@end menu
@@ -275,7 +285,7 @@ sensible, such as in plain text, write it as @samp{LaTeX}.
@cindex hello, world
@LaTeX{} files have a simple global structure, with a standard beginning
-and ending. Here is a ``hello, world'' example:
+and ending. This is a small example.
@example
\documentclass@{article@}
@@ -284,11 +294,15 @@ Hello, \LaTeX\ world.
\end@{document@}
@end example
+@noindent
+Every @LaTeX{} document has a @code{\begin@{document@}} line and an
+@code{\end@{document@}} line.
+
@cindex document class, defined
@noindent
-Here, the @samp{article} is the so-called @dfn{document class},
-implemented in a file @file{article.cls}. Any document class can be
-used. A few document classes are defined by @LaTeX{} itself, and vast
+Here, the @samp{article} is the @dfn{document class}. It is implemented
+in a file @file{article.cls}. You can use any document class on your
+system. A few document classes are defined by @LaTeX{} itself, and vast
array of others are widely available. @xref{Document classes}.
@cindex preamble, defined
@@ -296,12 +310,13 @@ You can include other @LaTeX{} commands between the
@code{\documentclass} and the @code{\begin@{document@}} commands.
This area is called the @dfn{preamble}.
-The @code{\begin@{document@} ... \end@{document@}} is a so-called
+The @code{\begin@{document@}}, @code{\end@{document@}} pair defines an
@cindex environment
@dfn{environment}; the @samp{document} environment (and no others) is
-required in all @LaTeX{} documents (@pxref{document}). @LaTeX{}
-provides many environments itself, and many more are defined separately.
-@xref{Environments}.
+required in all @LaTeX{} documents (@pxref{document}). @LaTeX{} make
+available to you many environments that are documented here
+(@pxref{Environments}). Many more are available to you from external
+packages, most importantly those available at CTAN (@pxref{CTAN}).
The following sections discuss how to produce PDF or other output from
a @LaTeX{} input file.
@@ -310,7 +325,7 @@ a @LaTeX{} input file.
@node Output files
@section Output files
-@LaTeX{} produces a main output file and at least two accessory files.
+@LaTeX{} produces a main output file and at least two auxiliary files.
The main output file's name ends in either @file{.dvi} or @file{.pdf}.
@table @code
@@ -321,6 +336,7 @@ The main output file's name ends in either @file{.dvi} or @file{.pdf}.
@findex dvips @r{command}
@findex dvipdfmx @r{command}
@findex dvitype @r{command}
+@anchor{output files dvi}
If @LaTeX{} is invoked with the system command @command{latex} then it
produces a DeVice Independent file, with extension @file{.dvi}. You
can view this file with a command such as @command{xdvi}, or convert
@@ -334,6 +350,7 @@ available (@url{http://mirror.ctan.org/dviware}).
@findex .pdf @r{file}
@cindex pdf@TeX{}
@findex pdflatex @r{command}
+@anchor{output files pdf}
If @LaTeX{} is invoked via the system command @command{pdflatex},
among other commands (@pxref{@TeX{} engines}), then the main output is
a Portable Document Format (PDF) file. Typically this is a
@@ -348,6 +365,7 @@ self-contained file, with all fonts and images included.
@cindex transcript file
@cindex log file
@findex .log @r{file}
+@anchor{output files log}
This transcript file contains summary information such as a list of
loaded packages. It also includes diagnostic messages and perhaps
additional information for any errors.
@@ -358,6 +376,7 @@ additional information for any errors.
@cindex cross references, resolving
@cindex forward references, resolving
@cindex references, resolving forward
+@anchor{output files aux}
Auxiliary information is used by @LaTeX{} for things such as
cross references. For example, the first time that @LaTeX{} finds a
forward reference---a cross reference to something that has not yet
@@ -379,10 +398,11 @@ location.
@cindex table of contents file
@cindex contents file
@LaTeX{} may produce yet more files, characterized by the filename
-ending. These include a @code{.lof} file that is used to make a list
-of figures, a @code{.lot} file used to make a list of tables, and a
-@code{.toc} file used to make a table of contents. A particular class
-may create others; the list is open-ended.
+ending. These include a @code{.lof} file that is used to make a list of
+figures, a @code{.lot} file used to make a list of tables, and a
+@code{.toc} file used to make a table of contents (@pxref{Table of
+contents etc.}). A particular class may create others; the list is
+open-ended.
@node @TeX{} engines
@@ -397,7 +417,7 @@ may create others; the list is open-ended.
@LaTeX{} is defined to be a set of commands that are run by a @TeX{}
implementation (@pxref{Overview}). This section gives a terse
-overview of the main programs.
+overview of the main programs (see also@tie{}@ref{Command line}).
@table @code
@item latex
@@ -405,6 +425,7 @@ overview of the main programs.
@cindex pdf@TeX{} engine
@findex etex @r{command}
@cindex e-@TeX{}
+@anchor{tex engines latex}
In @TeX{} Live (@url{http://tug.org/texlive}), if @LaTeX{} is invoked
via either the system command @command{latex} or @command{pdflatex},
then the pdf@TeX{} engine is run (@url{http://ctan.org/pkg/pdftex}).
@@ -425,6 +446,7 @@ assumed to be available in @LaTeX{}.
@item lualatex
@findex lualatex @r{command}
@cindex Lua@TeX{}
+@anchor{tex engines lualatex}
If @LaTeX{} is invoked via the system command @command{lualatex}, the
Lua@TeX{} engine is run (@url{http://ctan.org/pkg/luatex}). This
program allows code written in the scripting language Lua
@@ -439,6 +461,7 @@ but this is rarely used.
@cindex Xe@TeX{}
@findex .xdv @r{file}
@findex xdvipdfmx
+@anchor{tex engines xelatex}
If @LaTeX{} is invoked with the system command @command{xelatex}, the
Xe@TeX{} engine is run (@url{http://tug.org/xetex}). Like Lua@TeX{},
Xe@TeX{} natively supports UTF-8 Unicode and TrueType and OpenType
@@ -499,7 +522,7 @@ commands it covers (barring unintentional omissions, a.k.a.@: bugs).
@menu
* Environment:: Area of the source with distinct behavior.
* Declaration:: Change the value or meaning of a command.
-* \makeatletter and \makeatother:: Change the status of the at-sign character.
+* \makeatletter & \makeatother:: Change the status of the at-sign character.
@end menu
@@ -525,7 +548,7 @@ behavior. For instance, for poetry in @LaTeX{} put the lines between
\end@{verse@}
@end example
-See@tie{}@ref{Environments} for a list of environments.
+@xref{Environments} for a list of environments.
The @var{environment name} at the beginning must exactly match that at
the end. This includes the case where @var{environment name} ends in a
@@ -552,8 +575,8 @@ command or parameter. For instance, the @code{\mainmatter} command
changes the setting of page numbers from roman numerals to arabic.
-@node \makeatletter and \makeatother
-@subsection @code{\makeatletter} and @code{\makeatother}
+@node \makeatletter & \makeatother
+@subsection @code{\makeatletter} & @code{\makeatother}
Synopsis:
@@ -598,9 +621,9 @@ For a comprehensive list of macros with an at-sign
in their names see @url{http://ctan.org/pkg/macros2e}. These macros are
mainly intended to package or class authors.
-The example below is typical. In the user's class file is a command
-@code{\thesis@@universityname}. The user wants to change the
-definition. These three lines should go in the preamble, before the
+In this example the class file has a command
+@code{\thesis@@universityname} that the user wants to change. These
+three lines should go in the preamble, before the
@code{\begin@{document@}}.
@example
@@ -625,8 +648,8 @@ Synopsis:
@example
\newcommand@{\mycmd@}@{\@@ifstar@{\mycmd@@star@}@{\mycmd@@nostar@}@}
-\newcommand@{\mycmd@@nostar@}[@var{non-starred command number of args}]@{@var{body of non-starred command}@}
-\newcommand@{\mycmd@@star@}[@var{starred command number of args}]@{@var{body of starred command}@}
+\newcommand@{\mycmd@@nostar@}[@var{nostar-num-args}]@{@var{nostar-body}@}
+\newcommand@{\mycmd@@star@}[@var{star-num-args}]@{@var{star-body}@}
@end example
Many standard @LaTeX{} environments or commands have a variant with the
@@ -647,7 +670,7 @@ are @code{\mycmd@@nostar} and @code{\mycmd@@star}. They could take the
same number of arguments or a different number, or no arguments at all.
As always, in a @LaTeX{} document a command using at-sign@tie{}@code{@@}
must be enclosed inside a @code{\makeatletter ... \makeatother} block
-(@pxref{\makeatletter and \makeatother}).
+(@pxref{\makeatletter & \makeatother}).
This example of @code{\@@ifstar} defines the command @code{\ciel} and a
variant @code{\ciel*}. Both have one required argument. A call to
@@ -661,15 +684,16 @@ variant @code{\ciel*}. Both have one required argument. A call to
@end example
In the next example, the starred variant takes a different number of
-arguments than does the unstarred one. With this definition, Agent
-007's @code{``My name is \agentsecret*@{Bond@},
-\agentsecret@{James@}@{Bond@}.''} is equivalent to @code{``My name is
-\textsc@{Bond@}, \textit@{James@} textsc@{Bond@}.''}
+arguments than the unstarred one. With this definition, Agent 007's
+@code{``My name is \agentsecret*@{Bond@},
+\agentsecret@{James@}@{Bond@}.''} is equivalent to entering the commands
+@code{``My name is \textsc@{Bond@}, \textit@{James@} textsc@{Bond@}.''}
@example
\newcommand*@{\agentsecret@@unstarred@}[2]@{\textit@{#1@} \textsc@{#2@}@}
\newcommand*@{\agentsecret@@starred@}[1]@{\textsc@{#1@}@}
-\newcommand*@{\agentsecret@}@{\@@ifstar@{\agentsecret@@starred@}@{\agentsecret@@unstarred@}@}
+\newcommand*@{\agentsecret@}@{%
+ \@@ifstar@{\agentsecret@@starred@}@{\agentsecret@@unstarred@}@}
@end example
There are two sometimes more convenient ways to accomplish the work of
@@ -686,6 +710,38 @@ There are two sometimes more convenient ways to accomplish the work of
@end example
+@node CTAN
+@section CTAN: Comprehensive @TeX{} Archive Network
+
+@cindex CTAN
+
+The Comprehensive @TeX{} Archive Network, CTAN, is the @TeX{} and
+@LaTeX{} community's repository of free material. It is a set of
+Internet sites around the world that offer material related to @LaTeX{}
+for download. Visit CTAN on the web at @url{https://ctan.org}.
+
+This material is organized into packages, discrete bundles that
+typically offer some coherent functionality and are maintained by one
+person or a small number of people. For instance, many publishers have
+a package that allows authors to format papers to that publisher's
+specifications.
+
+In addition to the massive holdings, the web site offers features such
+as search by name or by functionality.
+
+@cindex DANTE e.V.
+@cindex mirrors of CTAN
+CTAN is not a single site, but instead is a set of sites. One of the
+sites is the core. This site actively manages the material, for
+instance, by accepting uploads of new or updated packages. It is
+hosted by the German @TeX{} group DANTE e.V. Other sites around the
+world help out by mirroring, that is, automatically syncing their
+collections with the core site and then in turn making their copies
+publicly available. This gives users close to their location better
+access and relieves the load on the core site. The list of mirrors is
+at @url{https://ctan.org/mirrors}.
+
+
@node Document classes
@chapter Document classes
@@ -711,22 +767,27 @@ The following document @var{class} names are built into @LaTeX{}.
@table @code
@item article
+@anchor{document classes article}
For a journal article, a presentation, and miscellaneous general use.
@item book
+@anchor{document classes book}
Full-length books, including chapters and possibly including front
matter, such as a preface, and back matter, such as an appendix
(@pxref{Front/back matter}).
@item letter
+@anchor{document classes letter}
Mail, optionally including mailing labels
(@pxref{Letters}).
@item report
+@anchor{document classes report}
For documents of length between an @code{article} and a @code{book},
such as technical reports or theses, which may contain several chapters.
@item slides
+@anchor{document classes slides}
For slide presentations---rarely used today. In its place the
@code{beamer} package is perhaps the most prevalent (@pxref{beamer
template}).
@@ -750,9 +811,9 @@ Standard @var{options} are described in the next section.
@cindex class options
@cindex global options
-You can specify so-called @dfn{global options} or @dfn{class options} to
-the @code{\documentclass} command by enclosing them in square brackets.
-To specify more than one @var{option}, separate them with a comma, as in:
+You can specify @dfn{global options} or @dfn{class options} to the
+@code{\documentclass} command by enclosing them in square brackets. To
+specify more than one @var{option}, separate them with a comma.
@example
\documentclass[@var{option1},@var{option2},...]@{@var{class}@}
@@ -945,7 +1006,7 @@ SMC Math Department} is for a class.
Inside of a class or package file you can use the at-sign @code{@@} as a
character in command names without having to surround the code
containing that command with @code{\makeatletter} and
-@code{\makeatother}. @xref{\makeatletter and \makeatother}. This allow
+@code{\makeatother}. @xref{\makeatletter & \makeatother}. This allow
you to create commands that users will not accidentally redefine.
Another technique is to preface class- or package-specific commands with
some string to prevent your class or package from interfering with
@@ -997,7 +1058,6 @@ most of its work: declaring new variables, commands and fonts, and
loading other files.
@end enumerate
-
Here is a starting class file, which should be saved as @file{stub.cls}
where @LaTeX{} can find it, for example in the same directory as the
@file{.tex} file.
@@ -1011,6 +1071,7 @@ where @LaTeX{} can find it, for example in the same directory as the
@end example
@cindex class file example
+@noindent
It identifies itself, handles the class options via the default of
passing them all to the @code{article} class, and then loads the
@code{article} class to provide the basis for this class's code.
@@ -1021,6 +1082,7 @@ Class Guide, at
of the descriptions here derive from this document), or the tutorial
@url{https://www.tug.org/TUGboat/tb26-3/tb84heff.pdf}.
+
@node Class and package commands
@subsection Class and package commands
@cindex class and package commands
@@ -1112,10 +1174,10 @@ or @code{\DeclareOption*}.
@cindex package options
@cindex options, class
@cindex options, package
-Make an option available to a user, for invoking in their
+Make an option available to a user to invoke in their
@code{\documentclass} command. For example, the @code{smcmemo} class
-could have an option allowing users to put the institutional logo on the
-first page with @code{\documentclass[logo]@{smcmemo@}}. The class file
+could have an option @code{\documentclass[logo]@{smcmemo@}} allowing
+users to put the institutional logo on the first page. The class file
must contain @code{\DeclareOption@{logo@}@{@var{code}@}} (and later,
@code{\ProcessOptions}).
@@ -1162,14 +1224,14 @@ Commands defined this way are a bit less efficient than those defined
using @code{\newcommand} so unless the command's data is fragile and the
command is used within a moving argument, use @code{\newcommand}.
-@PkgIndex{etoolbox}
-The @code{etoolbox} package offers commands @code{\newrobustcmd},
-@code{\newrobustcmd*}, @code{\renewrobustcmd}, @code{\renewrobustcmd*},
-@code{\providerobustcmd}, and @code{\providerobustcmd*} which are similar
-to @code{\newcommand}, @code{\newcommand*}, @code{\renewcommand},
-@code{\renewcommand*}, @code{\providecommand}, and
-@code{\providecommand*}, but define a robust @var{cmd} with two advantages
-as compared to @code{\DeclareRobustCommand}:
+@PkgIndex{etoolbox} The @file{etoolbox} package offers the commands
+@code{\newrobustcmd}, @code{\newrobustcmd*}, as well as the commands
+@code{\renewrobustcmd}, @code{\renewrobustcmd*}, and the commands
+@code{\providerobustcmd}, and @code{\providerobustcmd*}. These are
+similar to @code{\newcommand}, @code{\newcommand*},
+@code{\renewcommand}, @code{\renewcommand*}, @code{\providecommand}, and
+@code{\providecommand*}, but define a robust @var{cmd} with two
+advantages as compared to @code{\DeclareRobustCommand}:
@enumerate
@item
They use the low-level e-@TeX{} protection mechanism rather than the
@@ -1188,12 +1250,18 @@ commands, so they do not just make a log message when you redefine
@item \InputIfFileExists@{@var{file name}@}@{@var{true code}@}@{@var{false code}@}
@findex \IfFileExists
@findex \InputIfFileExists
-Execute @var{true code} if @LaTeX{} can find the file @file{@var{file
-name}} and @var{false code} otherwise. In the second case it inputs the
-file immediately after executing @var{true code}. Thus
-@code{\IfFileExists@{img.pdf@}@{\includegraphics@{img.pdf@}@}@{\typeout@{WARNING:
-img.pdf not found@}@}} will include the graphic @file{img.pdf} if it is
-found but otherwise just give a warning.
+Execute @var{true code} if @LaTeX{} finds the file @file{@var{file
+name}} or @var{false code} otherwise. In the first case it executing
+@var{true code} and then inputs the file. Thus the command
+
+@example
+\IfFileExists@{img.pdf@}@{%
+ \includegraphics@{img.pdf@}@}@{\typeout@{!! img.pdf not found@}
+@end example
+
+@noindent
+will include the graphic @file{img.pdf} if it is found and otherwise
+give a warning.
This command looks for the file in all search paths that @LaTeX{} uses,
not only in the current directory. To look only in the current
@@ -1218,11 +1286,15 @@ The @var{options list}, if present, is a comma-separated list. The
@c and do some actions conditionnally on version later or not to some
@c date.
-If you request a @var{release date} and the date of
-the package installed on your system is earlier, then you get a warning
-on the screen and in the log like @code{You have requested, on input
-line 4, version `2038/01/19' of document class article, but only version
-`2014/09/29 v1.4h Standard LaTeX document class' is available.}
+If you request a @var{release date} and the date of the package
+installed on your system is earlier, then you get a warning on the
+screen and in the log like this.
+
+@example
+You have requested, on input line 4, version `2038/01/19' of
+document class article, but only version `2014/09/29 v1.4h
+Standard LaTeX document class' is available.
+@end example
The command version @code{\LoadClassWithOptions} uses the list of
options for the current class. This means it ignores any options passed
@@ -1255,9 +1327,12 @@ To specify a version of the format that you know to have certain
features, include the optional @var{format date} on which those features
were implemented. If present it must be in the form @code{YYYY/MM/DD}.
If the format version installed on your system is earlier than
-@var{format date} then you get a warning like @samp{You have requested
-release `2038/01/20' of LaTeX, but only release `2016/02/01' is
-available.}
+@var{format date} then you get a warning like this.
+
+@example
+You have requested release `2038/01/20' of LaTeX, but only
+release `2016/02/01' is available.
+@end example
@item \OptionNotUsed
@findex \OptionNotUsed
@@ -1288,17 +1363,23 @@ options.)
If your own code is bringing in a package twice then you can collapse
that to once, for example replacing the two
-@code{\RequirePackage[landscape]@{geometry@}\RequirePackage[margins=1in]@{geometry@}}
-with the single
-@code{\RequirePackage[landscape,margins=1in]@{geometry@}}. But if you
-are loading a package that in turn loads another package then you need
-to queue up the options you desire for this other package. For
-instance, suppose the package @code{foo} loads the package
-@code{geometry}. Instead of
-@code{\RequirePackage@{foo@}\RequirePackage[draft]@{graphics@}} you must
-write @code{\PassOptionsToPackage@{draft@}@{graphics@}
-\RequirePackage@{foo@}}. (If @code{foo.sty} loads an option in conflict
-with what you want then you may have to look into altering its source.)
+@code{\RequirePackage[landscape]@{geometry@}} and
+@code{\RequirePackage[margins=1in]@{geometry@}} with the single command
+@code{\RequirePackage[landscape,margins=1in]@{geometry@}}.
+
+However, imagine that you are loading @file{firstpkg} and inside that
+package it loads @file{secondpkg}, and you need the second package to be
+loaded with option @code{draft}. Then before doing the first package
+you must queue up the options for the second package, like this.
+
+@example
+\PassOptionsToPackage@{draft@}@{secondpkg@}
+\RequirePackage@{firstpkg@}
+@end example
+
+@noindent
+(If @code{firstpkg.sty} loads an option in conflict with what you want
+then you may have to alter its source.)
These commands are useful for general users as well as class and package
writers. For instance, suppose a user wants to load the @code{graphicx}
@@ -1350,41 +1431,42 @@ options in the order specified in the calling commands, rather than in
the order of declaration in the class or package. For a package this
means that the global options are processed first.
-
@item \ProvidesClass@{@var{class name}@}[@var{release date} @var{brief additional information}]
@item \ProvidesClass@{@var{class name}@}[@var{release date}]
@item \ProvidesPackage@{@var{package name}@}[@var{release date} @var{brief additional information}]
@item \ProvidesPackage@{@var{package name}@}[@var{release date}]
@findex \ProvidesClass
@findex \ProvidesPackage
-Identifies the class or package, printing a message to the screen and the log file.
+Identifies the class or package, printing a message to the screen and
+the log file.
-When a user writes @code{\documentclass@{smcmemo@}} then @LaTeX{} loads
-the file @file{smcmemo.cls}. Similarly, a user writing
-@code{\usepackage@{test@}} prompts @LaTeX{} to load the file
-@code{test.sty}. If the name of the file does not match the declared
-class or package name then you get a warning. Thus, if you invoke
+When you load a class or package, for example with
+@code{\documentclass@{smcmemo@}} or @code{\usepackage@{test@}}, @LaTeX{}
+inputs a file. If the name of the file does not match the class or
+package name declared in it then you get a warning. Thus, if you invoke
@code{\documentclass@{smcmemo@}}, and the file @file{smcmemo.cls} has
the statement @code{\ProvidesClass@{xxx@}} then you get a warning like
@code{You have requested document class `smcmemo', but the document
class provides 'xxx'.} This warning does not prevent @LaTeX{} from
processing the rest of the class file normally.
-If you include the optional argument, then you must include the date, before
-the first space if any, and it must have the form @code{YYYY/MM/DD}. The rest
-of the optional argument is free-form, although it traditionally identifies
-the class, and is written to the screen during compilation and to the
-log file. Thus, if your file @file{smcmemo.cls} contains the line
-@code{\ProvidesClass@{smcmemo@}[2008/06/01 v1.0 SMC memo class]} and your
-document's first line is @code{\documentclass@{smcmemo@}} then you will
-see @code{Document Class: smcmemo 2008/06/01 v1.0 SMC memo class}.
+If you include the optional argument then you must include a date,
+before any spaces, of the form @code{YYYY/MM/DD}. The rest of the
+optional argument is free-form, although it traditionally identifies the
+class, and is written to the screen during compilation and to the log
+file. Thus, if your file @file{smcmemo.cls} contains the line
+@code{\ProvidesClass@{smcmemo@}[2008/06/01 v1.0 SMC memo class]} and
+your document's first line is @code{\documentclass@{smcmemo@}} then you
+will see @code{Document Class: smcmemo 2008/06/01 v1.0 SMC memo class}.
The date in the optional argument allows class and package users to ask
-to be warned if the version of the class or package installed on their
-system is earlier than @var{release date}, by using the optional arguments
-such as @code{\documentclass@{smcmemo@}[2018/10/12]} or
-@code{\usepackage@{foo@}[[2017/07/07]]}. (Note that package users only
-rarely include a date, and class users almost never do.)
+to be warned if the version of the class or package is earlier than
+@var{release date}. For instance, a user could enter
+@code{\documentclass@{smcmemo@}[2018/10/12]} or
+@code{\usepackage@{foo@}[[2017/07/07]]} to require a class or package
+with certain features by specifying that it must be released no earlier
+than the given date. (Although, in practice package users only rarely
+include a date, and class users almost never do.)
@item \ProvidesFile@{@var{file name}@}[@var{additional information}]
@findex \ProvidesFile
@@ -1399,11 +1481,11 @@ file and you get in the log a string like @code{File: test.config
@item \RequirePackageWithOptions@{@var{package name}@}[@var{release date}]
@findex \RequirePackage
@findex \RequirePackageWithOptions
-Load a package, like the document author command @code{\usepackage}.
-@xref{Additional packages}. An example is
-@code{\RequirePackage[landscape,margin=1in]@{geometry@}}. Note that the
-@LaTeX{} development team strongly recommends use of these commands over
-Plain@tie{}@TeX{}'s @code{\input}; see the Class Guide.
+Load a package, like the command @code{\usepackage} (@pxref{Additional
+packages}). The @LaTeX{} development team strongly recommends use of
+these commands over Plain@tie{}@TeX{}'s @code{\input}; see the Class
+Guide. An example is
+@code{\RequirePackage[landscape,margin=1in]@{geometry@}}.
The @var{option list}, if present, is a comma-separated list. The
@var{release date}, if present, must have the form @var{YYYY/MM/DD}. If
@@ -1453,30 +1535,28 @@ and a style. The @LaTeX{} commands for doing this are described here.
The following type style commands are supported by @LaTeX{}.
-This first group of commands is typically used with an argument, as in
-@code{\textit@{@var{text}@}}. In the table below, the corresponding
-command in parenthesis is the ``declaration form'', which takes no
-arguments, as in @code{@{\itshape @var{text}@}}. The scope of the
-declaration form lasts until the next type style command or the end of
-the current group.
-
-These commands, in both the argument form and the declaration form,
-are cumulative; e.g., you can say either @code{\sffamily\bfseries} or
-@code{\bfseries\sffamily} to get bold sans serif.
+In the table below the listed commands, the @code{\text...} commands,
+is used with an argument, as in @code{\textit@{@var{text}@}}. This is
+the preferred form. But shown after it, in parenthesis, is the
+corresponding declaration form, which is sometimes useful. This form
+takes no arguments, as in @code{@{\itshape @var{text}@}}. The scope of
+the declaration form lasts until the next type style command or the end
+of the current group. In addition, each has an environment form such as
+@code{\begin@{itshape@}...\end@{itshape@}}.
-You can alternatively use an environment form of the declarations; for
-instance, @code{\begin@{ttfamily@}...\end@{ttfamily@}}.
+These commands, in both the argument form and the declaration form, are
+cumulative; for instance you can get bold sans serif by saying either of
+@code{\sffamily\bfseries} or @code{\bfseries\sffamily}.
@findex \nocorrlist
@findex \nocorr
-These font-switching commands automatically insert italic corrections
-if needed. (@xref{\/}, for the details of italic corrections.)
-Specifically, they insert the italic correction unless the following
-character is in the list @code{\nocorrlist}, which by default consists
-of a period and a comma. To suppress the automatic insertion of
-italic correction, use @code{\nocorr} at the start or end of the
-command argument, such as @code{\textit@{\nocorr text@}} or
-@code{\textsc@{text \nocorr@}}.
+One advantage of these commands is that they automatically insert italic
+corrections if needed (@pxref{\/}). Specifically, they insert the
+italic correction unless the following character is in the list
+@code{\nocorrlist}, which by default consists of a period and a comma.
+To suppress the automatic insertion of italic correction, use
+@code{\nocorr} at the start or end of the command argument, such as
+@code{\textit@{\nocorr text@}} or @code{\textsc@{text \nocorr@}}.
@table @code
@item \textrm (\rmfamily)
@@ -1541,10 +1621,14 @@ text} \emph@{@var{middle text}@} @var{end text}@}} will result in the
will be in roman.
@LaTeX{} also provides the following commands, which unconditionally
-switch to the given style, that is, are @emph{not} cumulative. Also,
-they are used differently than the above commands:
-@code{@{\@var{cmd}...@}} instead of @code{\@var{cmd}@{...@}}. These
-are two unrelated constructs.
+switch to the given style, that is, are @emph{not} cumulative. They are
+used as declarations: @code{@{\@var{cmd}...@}} instead of
+@code{\@var{cmd}@{...@}}.
+
+(The unconditional commands below are an older version of font
+switching. The earlier commands are an improvement in most
+circumstances. But sometimes an unconditional font switch is precisely
+what you want.)
@ftable @code
@item \bf
@@ -1587,13 +1671,6 @@ Typewriter (monospace, fixed-width).
The @code{\em} command is the unconditional version of @code{\emph}.
-(Some people consider the unconditional font-switching commands, such
-as @code{\tt}, obsolete and that only the cumulative commands
-(@code{\texttt}) should be used. Others think that both sets of
-commands have their place and sometimes an unconditional font switch
-is precisely what you want; for one example,
-@pxref{description,,@code{description}}.)
-
The following commands are for use in math mode. They are not
cumulative, so @code{\mathbf@{\mathit@{@var{symbol}@}@}} does not
create a boldface and italic @var{symbol}; instead, it will just be in
@@ -1679,7 +1756,7 @@ options}).
@findex \huge
@findex \Huge
-@multitable {@code{\normalsize} (default)} {24.88} {24.88} {24.88}
+@multitable {@code{\normalsize} (default)@ @ } {24.88@ @ } {24.88@ @ } {24.88}
@headitem Command @tab @code{10pt} @tab @code{11pt} @tab @code{12pt}
@item @code{\tiny}
@tab 5 @tab 6 @tab 6
@@ -1703,10 +1780,22 @@ options}).
@tab 24.88 @tab 24.88 @tab 24.88
@end multitable
-The commands as listed here are ``declaration forms''. The scope of
-the declaration form lasts until the next type style command or the
-end of the current group. You can also use the environment form of
-these commands; for instance, @code{\begin@{tiny@}...\end@{tiny@}}.
+The commands are listed here in declaration forms. You use them by
+declaring them, as with this example.
+
+@example
+\begin@{quotation@} \small
+ The Tao that can be named is not the eternal Tao.
+\end@{quotation@}
+@end example
+
+@noindent
+The scope of the @code{\small} lasts until the end of the
+@code{quotation} environment. It would also end at the next type style
+command or the end of the current group, so you could enclose it in
+extra curly braces @code{@{\small We are here, we are here, we are
+here!@}}. You can instead use the environment form of these commands;
+for instance, @code{\begin@{tiny@}...\end@{tiny@}}.
@node Low-level font commands
@@ -1722,6 +1811,7 @@ ones.
@c xx something about ultimately reading ENCFAM.fd?
@table @code
+@anchor{low level font commands fontencoding}
@item \fontencoding@{@var{encoding}@}
@findex \fontencoding
Select the font encoding, the encoding of the output font. There are a
@@ -1733,6 +1823,7 @@ accented characters used by the most widespread European languages
hyphenate words containing accented letters. For more, see
@url{https://ctan.org/pkg/encguide}.
+@anchor{low level font commands fontfamily}
@item \fontfamily@{@var{family}@}
@findex \fontfamily
@cindex families, of fonts
@@ -1740,9 +1831,9 @@ hyphenate words containing accented letters. For more, see
Select the font family. The web page
@url{http://www.tug.dk/FontCatalogue/} provides one way to browse
through many of the fonts easily used with @LaTeX{}. Here are
-examples of some common families:
+examples of some common families.
-@multitable {font} {Computer Modern Typewriter XXXX}
+@multitable {font} {Computer Modern Typewriter more space}
@item @code{pag}
@tab Avant Garde
@item @code{fvs}
@@ -1786,6 +1877,7 @@ examples of some common families:
@end multitable
+@anchor{low level font commands fontseries}
@item \fontseries@{@var{series}@}
@findex \fontseries
@cindex series, of fonts
@@ -1834,7 +1926,6 @@ The possible values for weight, individually, are:
The possible values for width, individually, are (the meaning and
relationship of these terms varies with individual typefaces):
-
@multitable {xx} {Ultra condensed}
@item @code{uc}
@tab Ultra condensed
@@ -1856,7 +1947,6 @@ relationship of these terms varies with individual typefaces):
@tab Ultra expanded
@end multitable
-
When forming the @var{series} string from the weight and width, drop the
@code{m} that stands for medium weight or medium width, unless both
weight and width are @code{m}, in which case use just one
@@ -1865,6 +1955,7 @@ weight and width are @code{m}, in which case use just one
@item \fontshape@{@var{shape}@}
@findex \fontshape
@cindex shapes, of fonts
+@anchor{low level font commands fontshape}
Select font shape. Valid shapes are:
@multitable {xx} {Slanted (oblique)xx}
@@ -1882,10 +1973,10 @@ Select font shape. Valid shapes are:
@tab Outline
@end multitable
-
The two last shapes are not available for most font families, and
small caps are often missing as well.
+@anchor{low level font commands fontsize}
@item \fontsize@{@var{size}@}@{@var{skip}@}
@findex \fontsize
@cindex font size
@@ -1898,6 +1989,7 @@ the Computer Modern typeface is 1.2 times the @code{\fontsize}.
Changing @code{\baselineskip} directly is inadvisable since its value is
reset every time a size change happens; see @code{\baselinestretch}, next.
+@anchor{low level font commands baselinestretch}
@item \baselinestretch
@findex \baselinestretch
@LaTeX{} multiplies the line spacing by the value of the
@@ -1915,6 +2007,7 @@ options, this package keeps the line spacing single-spaced in places
where that is typically desirable, such as footnotes and figure
captions. See the package documentation.
+@anchor{low level font commands linespread}
@item \linespread@{@var{factor}@}
@findex \linespread
Equivalent to
@@ -1923,6 +2016,7 @@ therefore must be followed by @code{\selectfont} to have any effect.
Best specified in the preamble, or use the @code{setspace} package, as
just described.
+@anchor{low level font commands selectfont}
@item \selectfont
@findex \selectfont
The effects of the font commands described above do not happen until
@@ -1932,6 +2026,7 @@ to put this in a macro:@*
@code{\newcommand*@{\myfont@}@{\fontfamily@{@var{familyname}@}\selectfont@}}@*
(@pxref{\newcommand & \renewcommand}).
+@anchor{low level font commands usefont}
@item \usefont@{@var{enc}@}@{@var{family}@}@{@var{series}@}@{@var{shape}@}
@findex \usefont
The same as invoking @code{\fontencoding}, @code{\fontfamily},
@@ -1968,11 +2063,16 @@ Commands for controlling the general page layout.
@findex \onecolumn
@cindex one-column output
+Synopsis:
+
+@example
+\onecolumn
+@end example
+
Start a new page and produce single-column output. If the document is
given the class option @code{onecolumn} then this is the default
-behavior (@pxref{Document class options}).
-
-This command is fragile (@pxref{\protect}).
+behavior (@pxref{Document class options}). This command is fragile
+(@pxref{\protect}).
@node \twocolumn
@@ -1991,24 +2091,25 @@ Synopses:
Start a new page and produce two-column output. If the document is given
the class option @code{twocolumn} then this is the default
-(@pxref{Document class options}).
+(@pxref{Document class options}). This command is fragile
+(@pxref{\protect}).
If the optional @var{prelim one column text} argument
is present, it is typeset in one-column mode before the two-column
typesetting starts.
-This command is fragile (@pxref{\protect}).
-
These parameters control typesetting in two-column output:
@ftable @code
@item \columnsep
+@anchor{twocolumn columnsep}
The distance between columns. The default is 35pt. Change it with a
command such as @code{\setlength@{\columnsep@}@{40pt@}} You must change
it before the two column environment starts; in the preamble is a good
place.
@item \columnseprule
+@anchor{twocolumn columnseprule}
The width of the rule between columns. The rule appears halfway between
the two columns. The default is 0pt, meaning that there is no rule.
Change it with a command such as
@@ -2016,6 +2117,7 @@ Change it with a command such as
environment starts.
@item \columnwidth
+@anchor{twocolumn columnwidth}
The width of a single column. In one-column mode this is equal to
@code{\textwidth}. In two-column mode by default @LaTeX{} sets the
width of each of the two columns to be half of @code{\textwidth} minus
@@ -2030,6 +2132,7 @@ and @pxref{table}). @LaTeX{} places starred floats at the top of a page.
The following parameters control float behavior of two-column output.
@ftable @code
+@anchor{twocolumn dbltopfraction}
@item \dbltopfraction
The maximum fraction at the top of a two-column page that may be
occupied by two-column wide floats. The default is 0.7, meaning that
@@ -2052,14 +2155,16 @@ Increase the value of @code{\dbltopfraction} to a suitably large number,
to avoid going to float pages so soon.
@end itemize
-You can redefine it, for instance with
+You can redefine it, as with
@code{\renewcommand@{\dbltopfraction@}@{0.9@}}.
+@anchor{twocolumn dblfloatpagefraction}
@item \dblfloatpagefraction
For a float page of two-column wide floats, this is the minimum fraction
that must be occupied by floats, limiting the amount of blank space.
@LaTeX{}'s default is @code{0.5}. Change it with @code{\renewcommand}.
+@anchor{twocolumn dblfloatsep}
@item \dblfloatsep
On a float page of two-column wide floats, this length is the distance
between floats, at both the top and bottom of the page. The default is
@@ -2067,11 +2172,13 @@ between floats, at both the top and bottom of the page. The default is
@code{11pt}, and @code{14pt plus2pt minus4pt} for a document set at
@code{12pt}.
+@anchor{twocolumn dbltextfloatsep}
@item \dbltextfloatsep
This length is the distance between a multi-column float at the top or
bottom of a page and the main text. The default is @code{20pt plus2pt
minus4pt}.
+@anchor{twocolumn dbltopnumber}
@item \dbltopnumber
On a float page of two-column wide floats, this counter gives the
maximum number of floats allowed at the top of the page. The @LaTeX{}
@@ -2160,6 +2267,9 @@ option (@pxref{Document class options}).
@findex \columnsep
@findex \columnseprule
@findex \columnwidth
+@anchor{page layout parameters columnsep}
+@anchor{page layout parameters columnseprule}
+@anchor{page layout parameters columnwidth}
The distance between the two columns, the width of a rule between the
columns, and the width of the columns, when the document class option
@code{twocolumn} is in effect (@pxref{Document class options}).
@@ -2167,12 +2277,14 @@ columns, and the width of the columns, when the document class option
@item \headheight
@findex \headheight
+@anchor{page layout parameters headheight}
Height of the box that contains the running head. The default in the
@code{article}, @code{report}, and @code{book} classes is @samp{12pt},
at all type sizes.
@item \headsep
@findex \headsep
+@anchor{page layout parameters headsep}
Vertical distance between the bottom of the header line and the top of
the main text. The default in the @code{article} and @code{report}
classes is @samp{25pt}. In the @code{book} class the default is: if the
@@ -2181,6 +2293,7 @@ it is @samp{0.275in}.
@item \footskip
@findex \footskip
+@anchor{page layout parameters footskip}
Distance from the baseline of the last line of text to the baseline of
the page footer. The default in the @code{article} and @code{report}
classes is @samp{30pt}. In the @code{book} class the default is: when
@@ -2189,6 +2302,7 @@ the type size is 10pt the default is @samp{0.35in}, while at 11pt it is
@item \linewidth
@findex \linewidth
+@anchor{page layout parameters linewidth}
Width of the current line, decreased for each nested @code{list}
(@pxref{list}). That is, the nominal value for @code{\linewidth} is to
equal @code{\textwidth} but for each nested list the @code{\linewidth}
@@ -2204,6 +2318,9 @@ is decreased by the sum of that list's @code{\leftmargin} and
@findex \marginparpush
@findex \marginsep
@findex \marginparwidth
+@anchor{page layout parameters marginparpush}
+@anchor{page layout parameters marginsep}
+@anchor{page layout parameters marginparwidth}
The minimum vertical space between two marginal notes, the horizontal
space between the text body and the marginal notes, and the horizontal
width of the notes.
@@ -2232,6 +2349,8 @@ distance.
@itemx \evensidemargin
@findex \oddsidemargin
@findex \evensidemargin
+@anchor{page layout parameters oddsidemargin}
+@anchor{page layout parameters evensidemargin}
The @code{\oddsidemargin} is the extra distance between the left side of
the page and the text's left margin, on odd-numbered pages when the
document class option @code{twoside} is chosen and on all pages when
@@ -2245,20 +2364,23 @@ difference between @code{\paperwidth} and @code{\textwidth}, and
@item \paperheight
@findex \paperheight
+@anchor{page layout parameters paperheight}
The height of the paper, as distinct from the height of the print area.
-It is normally set with a document class option, as in
+Normally set with a document class option, as in
@code{\documentclass[a4paper]@{article@}} (@pxref{Document class
options}).
@item \paperwidth
@findex \paperwidth
+@anchor{page layout parameters paperwidth}
The width of the paper, as distinct from the width of the print area.
-It is normally set with a document class option, as in
+Normally set with a document class option, as in
@code{\documentclass[a4paper]@{article@}} (@pxref{Document class
options}).
@item \textheight
@findex \textheight
+@anchor{page layout parameters textheight}
The normal vertical height of the page body. If the document is set at
a nominal type size of 10pt then for an @code{article} or @code{report}
the default is @samp{43\baselineskip}, while for a @code{book} it is
@@ -2268,6 +2390,7 @@ the default is @samp{43\baselineskip}, while for a @code{book} it is
@item \textwidth
@findex \textwidth
+@anchor{page layout parameters textwidth}
The full horizontal width of the entire page body. For an
@code{article} or @code{report} document, the default is @samp{345pt}
when the chosen type size is 10pt, the default is @samp{360pt} at 11pt,
@@ -2288,13 +2411,15 @@ specified width, and revert to their normal values at the end of the
@code{minipage} or @code{\parbox}.
@findex \hsize
-@findex \hsize
+@anchor{page layout parameters hsize}
+@item \hsize
This entry is included for completeness: @code{\hsize} is the @TeX{}
primitive parameter used when text is broken into lines. It should not
be used in normal @LaTeX{} documents.
@item \topmargin
@findex topmargin
+@anchor{page layout parameters topmargin}
Space between the top of the @TeX{} page (one inch from the top of the
paper, by default) and the top of the header. The value is computed
based on many other parameters: @code{\paperheight @minus{} 2in @minus{}
@@ -2303,6 +2428,7 @@ and then divided by two.
@item \topskip
@findex \topskip
+@anchor{page layout parameters topskip}
Minimum distance between the top of the page body and the baseline of
the first line of text. For the standard classes, the default is the
same as the font size, e.g., @samp{10pt} at a type size of 10pt.
@@ -2416,68 +2542,81 @@ non-float text (change them with
@ftable @code
@item \bottomfraction
@findex \bottomfraction
+@anchor{floats bottomfraction}
The maximum fraction of the page allowed to be occupied by floats at
the bottom; default @samp{.3}.
@item \floatpagefraction
@findex \floatpagefraction
+@anchor{floats floatpagefraction}
The minimum fraction of a float page that must be occupied by floats;
default @samp{.5}.
@item \textfraction
@findex \textfraction
+@anchor{floats textfraction}
Minimum fraction of a page that must be text; if floats take up too
much space to preserve this much text, floats will be moved to a
different page. The default is @samp{.2}.
@item \topfraction
@findex \topfraction
+@anchor{floats topfraction}
Maximum fraction at the top of a page that may be occupied before
floats; default @samp{.7}.
@end ftable
-Parameters relating to vertical space around floats (change them with
-@code{\setlength@{@var{parameter}@}@{@var{length expression}@}}):
+Parameters relating to vertical space around floats (change them with a
+command of the form @code{\setlength@{@var{parameter}@}@{@var{length
+expression}@}}):
@ftable @code
@item \floatsep
@findex \floatsep
+@anchor{floats floatsep}
Space between floats at the top or bottom of a page; default
@samp{12pt plus2pt minus2pt}.
@item \intextsep
@findex \intextsep
+@anchor{floats intextsep}
Space above and below a float in the middle of the main text; default
@samp{12pt plus2pt minus2pt} for 10 point and 11 point documents,
and @samp{14pt plus4pt minus4pt} for 12 point documents.
@item \textfloatsep
@findex \textfloatsep
+@anchor{floats textfloatsep}
Space between the last (first) float at the top (bottom) of a page;
default @samp{20pt plus2pt minus4pt}.
@end ftable
-Counters relating to the number of floats on a page (change them with
-@code{\setcounter@{@var{ctrname}@}@{@var{natural number}@}}):
+Counters relating to the number of floats on a page (change them with a
+command of the form @code{\setcounter@{@var{ctrname}@}@{@var{natural
+number}@}}):
@ftable @code
@item bottomnumber
@findex bottomnumber
+@anchor{floats bottomnumber}
Maximum number of floats that can appear at the bottom of a text page;
default 1.
@item dbltopnumber
@findex dbltopnumber
+@anchor{floats dbltopnumber}
Maximum number of full-sized floats that can appear at the top of a
two-column page; default 2.
@item topnumber
@findex topnumber
+@anchor{floats topnumber}
Maximum number of floats that can appear at the top of a text page;
default 2.
@item totalnumber
@findex totalnumber
+@anchor{floats totalnumber}
Maximum number of floats that can appear on a text page; default 3.
@end ftable
@@ -2495,83 +2634,672 @@ influence the position of float environments like figure and table in
@chapter Sectioning
@cindex sectioning commands
+@cindex part
+@cindex chapter
+@cindex section
+@cindex subsection
+@cindex paragraph
+@cindex subparagraph
+@findex \part
+@findex \chapter
+@findex \section
+@findex \subsection
+@findex \paragraph
+@findex \subparagraph
+
+Structure your text into divisions: parts, chapters, sections, etc. All
+sectioning commands have the same form, one of:
+
+@example
+@var{sectioning-command}@{@var{title}@}
+@var{sectioning-command}*@{@var{title}@}
+@var{sectioning-command}[@var{toc-title}]@{@var{title}@}
+@end example
+
+@noindent
+For instance, declare the start of a subsection as with
+@code{\subsection@{Motivation@}}.
+
+The table has each @var{sectioning-command} in @LaTeX{}. All are
+available in all of @LaTeX{}'s standard document classes @code{book},
+@code{report}, and@tie{}@code{article}, except that @code{\chapter} is
+not available in @code{article}.
+
+@multitable @columnfractions .25 .25 .40
+@headitem Sectioning unit @tab Command @tab Level
+@item Part
+@tab @code{\part} @tab -1 (@code{book}, @code{report}), 0 (@code{article})
+@item Chapter
+@tab @code{\chapter} @tab 0
+@item Section
+@tab @code{\section} @tab 1
+@item Subsection
+@tab @code{\subsection} @tab 2
+@item Subsubsection
+@tab @code{\subsubsection} @tab 3
+@item Paragraph
+@tab @code{\paragraph} @tab 4
+@item Subparagraph
+@tab @code{\subparagraph} @tab 5
+@end multitable
-Sectioning commands provide the means to structure your text into units:
+@cindex @code{*}-form of sectioning commands
+All these commands have a @code{*}-form that prints @var{title} as usual
+but is not numbered and does not make an entry in the table of contents.
+An example of using this is for an appendix in an @code{article} . The
+input @code{\appendix\section@{Appendix@}} gives the output @samp{A
+Appendix} (@pxref{\appendix}). You can lose the numbering@tie{}@samp{A}
+by instead entering @code{\section*@{Appendix@}} (articles often omit a
+table of contents and have simple page headers so the other differences
+from the @code{\section} command may not matter).
+
+The section title @var{title} provides the heading in the main text, but
+it may also appear in the table of contents and in the running head or
+foot (@pxref{Page styles}). You may not want the same text in these
+places as in the main text. All of these commands have an optional
+argument @var{toc-title} for these other places.
+
+The level number in the table above determines which sectional units are
+numbered, and which appear in the table of contents. If the sectioning
+command's @var{level} is less than or equal to the value of the counter
+@code{secnumdepth} then the titles for this sectioning command will be
+numbered (@pxref{Sectioning/secnumdepth}). And, if @var{level} is less
+than or equal to the value of the counter @code{tocdepth} then the table
+of contents will have an entry for this sectioning unit
+(@pxref{Sectioning/tocdepth}).
+
+@LaTeX{} expects that before you have a @code{\subsection} you will have
+a @code{\section} and, in a book, that before a @code{\section} you will
+have a @code{\chapter}. Otherwise you can get a something like a
+subsection numbered @samp{3.0.1}.
+
+Two counters relate to the appearance of sectioning commands.
@ftable @code
-@item \part
-@item \chapter
-(@code{report} and @code{book} class only)
-@item \section
-@item \subsection
-@item \subsubsection
-@item \paragraph
-@item \subparagraph
+@item secnumdepth
+@findex secnumdepth @r{counter}
+@cindex section numbers, printing
+@anchor{sectioning secnumdepth}
+@anchor{Sectioning/secnumdepth}
+Controls which sectioning commands are
+numbered. Suppress numbering of sectioning at any depth greater than
+@var{level} @code{\setcounter@{secnumdepth@}@{@var{level}@}}
+(@pxref{\setcounter}). See the above table for the level numbers. For
+instance, if the @code{secnumdepth} is 1 in an @code{article} then a
+@code{\section@{Introduction@}} command will produce output like @samp{1
+Introduction} while @code{\subsection@{Discussion@}} will produce output
+like @samp{Discussion}, without the number. @LaTeX{}'s default
+@code{secnumdepth} is@tie{}3 in @file{article} class and @tie{}2 in the
+@file{book} and @file{report} classes.
+
+@item tocdepth
+@findex tocdepth @r{counter}
+@cindex table of contents, sectioning numbers printed
+@anchor{sectioning tocdepth}
+@anchor{Sectioning/tocdepth}
+Controls which sectioning units are listed in the table of contents.
+The setting @code{\setcounter@{tocdepth@}@{@var{level}@}} makes the
+sectioning units at @var{level} be the smallest ones listed
+(@pxref{\setcounter}). See the above table for the level numbers. For
+instance, if @code{tocdepth} is@tie{}1 then the table of contents will
+list sections but not subsections. @LaTeX{}'s default
+@code{secnumdepth} is@tie{}3 in @file{article} class and @tie{}2 in the
+@file{book} and @file{report} classes.
+
@end ftable
-All sectioning commands take the same general form, e.g.,
+@menu
+* \part:: Start a part.
+* \chapter:: Start a chapter.
+* \section:: Start a section.
+* \subsection:: Start a subsection.
+* \subsubsection & \paragraph & \subparagraph:: Lower divisions.
+* \appendix:: Start appendices.
+* \frontmatter & \mainmatter & \backmatter:: The three parts of a book.
+* \@@startsection:: Layout of sectional units.
+@end menu
+
+
+@node \part
+@section @code{\part}
+
+@findex \part
+@cindex part
+@cindex sectioning, part
+
+Synopsis, one of:
@example
-\chapter[@var{toctitle}]@{@var{title}@}
+\part@{@var{title}@}
+\part*@{@var{title}@}
+\part[@var{toc-title}]@{@var{title}@}
@end example
-In addition to providing the heading @var{title} in the main text, the
-section title can appear in two other places:
+Start a document part. The standard @LaTeX{} classes @code{book},
+@code{report}, and @code{article}, all have this command.
-@enumerate
-@item
-The table of contents.
-@item
-The running head at the top of the page.
-@end enumerate
+This produces a document part, in a book.
+
+@example
+\part@{VOLUME I \\
+ PERSONAL MEMOIRS OF U.\ S.\ GRANT@}
+\chapter@{ANCESTRY--BIRTH--BOYHOOD.@}
+My family is American, and has been for generations,
+in all its branches, direct and collateral.
+@end example
-You may not want the same text in these places as in the main text.
-To handle this, the sectioning commands have an optional argument
-@var{toctitle} that, when given, specifies the text for these other
-places.
+In each standard class the @code{\part} command outputs a part number
+such as @samp{Part I}, alone on its line, in boldface, and in large
+type. Then @LaTeX{} outputs @var{title}, also alone on its line, in
+bold and in even larger type. In class @code{book}, the @LaTeX{}
+default puts each part alone on its own page. If the book is two-sided
+then @LaTeX{} will skip a page if needed to have the new part on an
+odd-numbered page. In @code{report} it is again alone on a page, but
+@LaTeX{} won't force it onto an odd-numbered page. In an @code{article}
+@LaTeX{} does not put it on a fresh page, but instead outputs the part
+number and part title onto the main document page.
-@cindex @code{*}-form of sectioning commands
-Also, all sectioning commands have @code{*}-forms that print
-@var{title} as usual, but do not include a number and do not make an
-entry in the table of contents. For instance:
+The @code{*}@tie{}form shows @var{title}
+but it does not show the part number, does not increment the
+@code{part} counter, and produces no table of contents entry.
+
+The optional argument @var{toc-title} will appear as the part title in
+the table of contents (@pxref{Table of contents etc.}) and in running
+headers (@pxref{Page styles}). If it is not present then @var{title}
+will be there. This example puts a line break in @var{title} but leaves
+out the break in the table of contents.
+
+@example
+\part[Up from the bottom; my life]@{Up from the bottom\\ my life@}
+@end example
+
+For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a part is@tie{}-1
+(@pxref{Sectioning/secnumdepth} and @pxref{Sectioning/tocdepth}).
+
+@PkgIndex{indentfirst}
+In the class @code{article}, if a paragraph immediately follows the part
+title then it is not indented. To get an indent you can use the package
+@file{indentfirst}.
+
+@PkgIndex{titlesec}
+One package to change the behavior of @code{\part} is @file{titlesec}.
+See its documentation on CTAN.
+
+
+@node \chapter
+@section @code{\chapter}
+
+@findex \chapter
+@cindex chapter
+
+Synopsis, one of:
+
+@example
+\chapter@{@var{title}@}
+\chapter*@{@var{title}@}
+\chapter[@var{toc-title}]@{@var{title}@}
+@end example
+
+Start a chapter. The standard @LaTeX{} classes @code{book} and
+@code{report} have this command but @code{article} does not.
+
+This produces a chapter.
+
+@example
+\chapter@{Loomings@}
+Call me Ishmael.
+Some years ago---never mind how long precisely---having little or no
+money in my purse, and nothing particular to interest me on shore, I
+thought I would sail about a little and see the watery part of
+the world.
+@end example
+
+The @LaTeX{} default starts each chapter on a fresh page, an
+odd-numbered page if the document is two-sided. It produces a chapter
+number such as @samp{Chapter 1} in large boldface type (the size is
+@code{\huge}). It then puts @var{title} on a fresh line, in boldface
+type that is still larger (size @code{\Huge}). It also increments the
+@code{chapter} counter, adds an entry to the table of contents
+(@pxref{Table of contents etc.}), and sets the running header
+information (@pxref{Page styles}).
+
+The @code{*}@tie{}form shows @var{title} on a fresh line, in boldface.
+But it does not show the chapter number, does not increment the
+@code{chapter} counter, produces no table of contents entry, and does
+not affect the running header. (If you use the page style
+@code{headings} in a two-sided document then the header will be from the
+prior chapter.) This example illustrates.
+
+@example
+\chapter*@{Preamble@}
+@end example
+
+The optional argument @var{toc-title} will appear as the chapter title
+in the table of contents (@pxref{Table of contents etc.}) and in
+running headers (@pxref{Page styles}). If it is not present then
+@var{title} will be there. This shows the full name in the chapter
+title,
+
+@example
+\chapter[Weyl]@{Hermann Klaus Hugo (Peter) Weyl (1885--1955)@}
+@end example
+
+@noindent
+but only @samp{Weyl} on the contents page. This puts a line break in
+the title but that doesn't work well with running headers so it omits
+the break in the contents
+
+@example
+\chapter[Given it all\\ my story]@{Given it all\\ my story@}
+@end example
+
+For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a chapter is@tie{}0
+(@pxref{Sectioning/secnumdepth} and @pxref{Sectioning/tocdepth}).
+
+@PkgIndex{indentfirst}
+The paragraph that follows the chapter title is not indented, as is a
+standard typographical practice. To get an indent use the package
+@file{indentfirst}.
+
+You can change what is shown for the chapter number. To change it to
+something like @samp{Lecture 1}, put in the preamble either
+@code{\renewcommand@{\chaptername@}@{Lecture@}} or this
+(@pxref{\makeatletter & \makeatother}).
+
+@example
+\makeatletter
+\renewcommand@{\@@chapapp@}@{Lecture@}
+\makeatother
+@end example
+
+@PkgIndex{babel}
+@noindent To make this change because of the primary language for
+the document, see the package @file{babel}.
+
+In a two-sided document @LaTeX{} puts a chapter on odd-numbered page, if
+necessary leaving an even-numbered page that is blank except for any
+running headers. To make that page completely blank,
+see@tie{}@ref{\clearpage & \cleardoublepage}.
+
+@PkgIndex{titlesec}
+To change the behavior of the @code{\chapter} command, you can copy its
+definition from the @LaTeX{} format file and make adjustments. But
+there are also many packages on CTAN that address this. One is
+@file{titlesec}. See its documentation, but the example below gives a
+sense of what it can do.
+
+@example
+\usepackage@{titlesec@} % in preamble
+\titleformat@{\chapter@}
+ @{\Huge\bfseries@} % format of title
+ @{@} % label, such as 1.2 for a subsection
+ @{0pt@} % length of separation between label and title
+ @{@} % before-code hook
+@end example
+
+@noindent
+This omits the chapter number @samp{Chapter 1} from the page but unlike
+@code{\chapter*} it keeps the chapter in the table of contents and the
+running headers.
+
+
+@node \section
+@section @code{\section}
+
+@findex \section
+@cindex section
+
+Synopsis, one of:
+
+@example
+\section@{@var{title}@}
+\section*@{@var{title}@}
+\section[@var{toc-title}]@{@var{title}@}
+@end example
+
+Start a section. The standard @LaTeX{} classes @code{article},
+@code{book}, and @code{report} all have this command.
+
+This produces a section.
+
+@example
+In this Part we tend to be more interested in the function,
+in the input-output behavior,
+than in the details of implementing that behavior.
+
+\section@{Turing machines@}
+Despite this desire to downplay implementation,
+we follow the approach of A~Turing that the
+first step toward defining the set of computable functions
+is to reflect on the details of what mechanisms can do.
+@end example
+
+For the standard @LaTeX{} classes @code{book} and @code{report} the
+default output is like @samp{1.2 @var{title}} (for chapter@tie{}1,
+section@tie{}2), alone on its line and flush left, in boldface and a
+larger type (the type size is @code{\Large}). The same holds in
+@code{article} except that there are no chapters in that class so it
+looks like @samp{2 @var{title}}.
+
+The @code{*}@tie{}form shows @var{title}.
+But it does not show the section number, does not increment the
+@code{section} counter, produces no table of contents entry, and does
+not affect the running header. (If you use the page style
+@code{headings} in a two-sided document then the header will be from the
+prior section.)
+
+The optional argument @var{toc-title} will appear as the section title
+in the table of contents (@pxref{Table of contents etc.}) and in
+running headers (@pxref{Page styles}). If it is not present then
+@var{title} will be there. This shows the full name in the title of the
+section,
+
+@example
+\section[Elizabeth~II]@{Elizabeth the Second,
+ by the Grace of God of the United Kingdom,
+ Canada and Her other Realms and Territories Queen,
+ Head of the Commonwealth, Defender of the Faith.@}
+@end example
+
+@noindent
+but only @samp{Elizabeth II} on the contents page and in the headers.
+This has a line break in @var{title} but that does not work with headers
+so it is omitted from the contents and headers.
+
+@example
+\section[Truth is, I cheated; my life story]@{Truth is,
+ I cheated\\my life story@}
+@end example
+
+For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a section is@tie{}1
+(@pxref{Sectioning/secnumdepth} and @pxref{Sectioning/tocdepth}).
+
+@PkgIndex{indentfirst}
+The paragraph that follows the section title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package @file{indentfirst}.
+
+@PkgIndex{titlesec}
+In general, to change the behavior of the @code{\section} command, there
+are a number of options. One is the @code{\@@startsection} command
+(@pxref{\@@startsection}). There are also many packages on CTAN that
+address this, including @file{titlesec}. See the documentation but the
+example below gives a sense of what they can do.
+
+@c credit: egreg https://groups.google.com/forum/#!topic/comp.text.tex/tvc8oM5P4y4
+@example
+\usepackage@{titlesec@} % in preamble
+\titleformat@{\section@}
+ @{\normalfont\Large\bfseries@} % format of title
+ @{\makebox[1pc][r]@{\thesection\hspace@{1pc@}@}@} % label
+ @{0pt@} % length of separation between label and title
+ @{@} % before-code hook
+\titlespacing*@{\section@}
+ @{-1pc@}@{18pt@}@{10pt@}[10pc]
+@end example
+
+@noindent
+That puts the section number in the margin.
+
+
+@node \subsection
+@section @code{\subsection}
+
+@findex \subsection
+@cindex subsection
+
+Synopsis, one of:
+
+@example
+\subsection@{@var{title}@}
+\subsection*@{@var{title}@}
+\subsection[@var{toc-title}]@{@var{title}@}
+@end example
+
+Start a subsection. The standard @LaTeX{} classes @code{article},
+@code{book}, and @code{report} all have this command.
+
+This produces a subsection.
+
+@example
+We will show that there are more functions than Turing machines and that
+therefore some functions have no associated machine.
+
+\subsection@{Cardinality@} We will begin with two paradoxes that
+dramatize the challenge to our intuition posed by comparing the sizes of
+infinite sets.
+@end example
+
+For the standard @LaTeX{} classes @code{book} and @code{report} the
+default output is like @samp{1.2.3 @var{title}} (for chapter@tie{}1,
+section@tie{}2, subsection@tie{}3), alone on its line and flush left, in
+boldface and a larger type (the type size is @code{\large}). The same
+holds in @code{article} except that there are no chapters in that class
+so it looks like @samp{2.3 @var{title}}.
+
+The @code{*}@tie{}form shows @var{title}.
+But it does not show the section number, does not increment the
+@code{section} counter, and produces no table of contents entry.
+
+The optional argument @var{toc-title} will appear as the section title
+in the table of contents (@pxref{Table of contents etc.}). If it is
+not present then @var{title} will be there. This shows the full name in
+the title of the section,
+
+@example
+\subsection[$\alpha,\beta,\gamma$ paper]@{\textit@{The Origin of
+ Chemical Elements@} by R.A.~Alpher, H.~Bethe, and G.~Gamow@}
+@end example
+
+@noindent
+but only @samp{@BES{03B1,\alpha},@BES{03B2,\beta},@BES{03B3,\gamma}
+paper} on the contents page.
+
+For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a subsection is@tie{}2
+(@pxref{Sectioning/secnumdepth} and @pxref{Sectioning/tocdepth}).
+
+@PkgIndex{indentfirst}
+The paragraph that follows the subsection title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package @file{indentfirst}.
+
+@PkgIndex{titlesec}
+There are a number of ways to change the behavior of the
+@code{\subsection} command. One is the @code{\@@startsection} command
+(@pxref{\@@startsection}). There are also many packages on CTAN that
+address this, including @file{titlesec}. See the documentation but the
+example below gives a sense of what they can do.
+
+@example
+\usepackage@{titlesec@} % in preamble
+\titleformat@{\subsection@}[runin]
+ @{\normalfont\normalsize\bfseries@} % format of the title
+ @{\thesubsection@} % label
+ @{0.6em@} % space between label and title
+ @{@} % before-code hook
+@end example
+
+@noindent
+That puts the subsection number and @var{title} in the first line of
+text.
+
+
+@node \subsubsection & \paragraph & \subparagraph
+
+@section @code{\subsubsection}, @code{\paragraph}, @code{\subparagraph}
+
+@findex \subsubsection
+@cindex subsubsection
+@findex \paragraph
+@cindex paragraph
+@findex \subparagraph
+@cindex subparagraph
+
+Synopsis, one of:
@example
-\section*@{Preamble@}
+\subsubsection@{@var{title}@}
+\subsubsection*@{@var{title}@}
+\subsubsection[@var{toc-title}]@{@var{title}@}
@end example
+@noindent
+or one of:
+
+@example
+\paragraph@{@var{title}@}
+\paragraph*@{@var{title}@}
+\paragraph[@var{toc-title}]@{@var{title}@}
+@end example
+
+@noindent
+or one of:
+
+@example
+\subparagraph@{@var{title}@}
+\subparagraph*@{@var{title}@}
+\subparagraph[@var{toc-title}]@{@var{title}@}
+@end example
+
+Start a subsubsection, paragraph, or subparagraph. The standard
+@LaTeX{} classes @code{article}, @code{book}, and @code{report} all have
+these commands, although they are not commonly used.
+
+This produces a subsubsection.
+
+@example
+\subsubsection@{Piston ring compressors: structural performance@}
+Provide exterior/interior wall cladding assemblies
+capable of withstanding the effects of load and stresses from
+consumer-grade gasoline engine piston rings.
+@end example
+
+The default output of each of the three does not change over the
+standard @LaTeX{} classes @code{article}, @code{book}, and
+@code{report}. For @code{\subsubsection} the @var{title} is alone on
+its line, in boldface and normal size type. For @code{\paragraph} the
+@var{title} is inline with the text, not indented, in boldface and
+normal size type. For @code{\subparagraph} the @var{title} is inline
+with the text, with a paragraph indent, in boldface and normal size type
+(Because an @code{article} has no chapters its subsubsections are
+numbered and so it looks like @samp{1.2.3 @var{title}}, for
+section@tie{}1, subsection@tie{}2, and subsubsection@tie{}3. The other
+two divisions are not numbered.)
+
+The @code{*}@tie{}form shows @var{title}. But it does not increment the
+associated counter and produces no table of contents entry (and does not
+show the number for @code{\subsubsection}).
+
+The optional argument @var{toc-title} will appear as the division title
+in the table of contents (@pxref{Table of contents etc.}). If it is
+not present then @var{title} will be there.
+
+For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a subsubsection is@tie{}3, of
+a paragraph is@tie{}4, and of a subparagraph is@tie{}5
+(@pxref{Sectioning/secnumdepth} and @pxref{Sectioning/tocdepth}).
+
+@PkgIndex{indentfirst}
+The paragraph that follows the subsubsection title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package @file{indentfirst}.
+
+@PkgIndex{titlesec}
+There are a number of ways to change the behavior of the these commands.
+One is the @code{\@@startsection} command (@pxref{\@@startsection}).
+There are also many packages on CTAN that address this, including
+@file{titlesec}. See the documentation on CTAN.
+
+
+@node \appendix
+
+@section @code{\appendix}
+
@findex \appendix
-@cindex appendix, creating
-The @code{\appendix} command changes the way following sectional units
-are numbered. The @code{\appendix} command itself generates no text
-and does not affect the numbering of parts. The normal use of this
-command is something like
+@cindex appendix
+@cindex appendices
+
+Synopsis:
@example
-\chapter@{A Chapter@}
-@dots{}
\appendix
-\chapter@{The First Appendix@}
@end example
-@findex secnumdepth @r{counter}
-@cindex section numbers, printing
-@anchor{Sectioning/secnumdepth}
-The @code{secnumdepth} counter controls printing of section numbers.
-The setting
+This does not directly produce any output. But in a book or report it
+declares that subsequent @code{\chapter} commands start an appendix. In
+an article it does the same, for @code{\section} commands. It also
+resets the @code{chapter} and @code{section} counters to@tie{}0 in a
+book or report, and in an article resets the @code{section} and
+@code{subsection} counters.
+
+In this book
@example
-\setcounter@{secnumdepth@}@{@var{level}@}
+\chapter@{One@} ...
+\chapter@{Two@} ...
+ ...
+\appendix
+\chapter@{Three@} ...
+\chapter@{Four@} ...
@end example
@noindent
-suppresses heading numbers at any depth @math{> @var{level}}, where
-@code{chapter} is level zero. The default @code{secnumdepth} is 3 in
-@LaTeX{}'s @file{article} class and 2 in the @file{book} and
-@file{report} classes. (@xref{\setcounter}.)
+the first two will generate output numbered @samp{Chapter 1} and
+@samp{Chapter 2}. After the @code{\appendix} the numbering will be
+@samp{Appendix A} and @samp{Appendix B}. @xref{Larger book template}
+for another example.
+
+@PkgIndex{appendix} The @file{appendix} package adds the command
+@code{\appendixpage} to put a separate @samp{Appendices} in the document
+body before the first appendix, and the command @code{\addappheadtotoc}
+to do the same in the table of contents. You can reset the name
+@samp{Appendix} with a command like
+@code{\renewcommand@{\appendixname@}@{Specification@}}, as well as a
+number of other features. See the documentation on CTAN.
-@menu
-* \@@startsection:: Redefine layout of start of sections, subsections, etc.
-@end menu
+
+@node \frontmatter & \mainmatter & \backmatter
+
+@section @code{\frontmatter}, @code{\mainmatter}, @code{\backmatter}
+
+@findex \frontmatter
+@cindex book, front matter
+@findex \mainmatter
+@cindex book, main matter
+@findex \backmatter
+@cindex book, back matter
+@cindex book, end matter
+
+Synopsis, one of:
+
+@example
+\frontmatter
+\mainmatter
+\backmatter
+@end example
+
+Format a @code{book} class document differently according to which part
+of the document is being produced. All three commands are optional.
+
+Traditionally, a book's front matter contains such things as the title
+page, an abstract, a table of contents, a preface, a list of notations,
+a list of figures, and a list of tables. (Some of these front matter
+pages, such as the title page, are traditionally not numbered.) The
+back matter may contain such things as a glossary, notes, a
+bibliography, and an index.
+
+The @code{\frontmatter} declaration makes the pages numbered in
+lowercase roman, and makes chapters not numbered, although each
+chapter's title appears in the table of contents; if you use other
+sectioning commands here, use the @code{*}-version (@pxref{Sectioning}).
+The @code{\mainmatter} changes the behavior back to the expected
+version, and resets the page number. The @code{\backmatter} leaves the
+page numbering alone but switches the chapters back to being not
+numbered. @xref{Larger book template} for an example using the three.
@node \@@startsection
@@ -2598,14 +3326,30 @@ make such a command you may want to use the @code{\secdef} command.
@c xx define, and make a cross reference to, secdef.
Technically, @code{\@@startsection} has the form
+
@example
-\@@startsection@{@var{name}@}@{@var{level}@}@{@var{indent}@}@{@var{beforeskip}@}@{@var{afterskip}@}@{@var{style}@}*[@var{toctitle}]@{@var{title}@}
+\@@startsection@{@var{name}@}
+ @{@var{level}@}
+ @{@var{indent}@}
+ @{@var{beforeskip}@}
+ @{@var{afterskip}@}
+ @{@var{style}@}*[@var{toctitle}]@{@var{title}@}
@end example
-@noindent (the star@tie{}@code{*} is optional), so that issuing
+
+@noindent
+so that issuing
+
@example
-\renewcommand@{\section@}@{\@@startsection@{@var{name}@}@{@var{level}@}@{@var{indent}@}@{@var{beforeskip}@}@{@var{afterskip}@}@{@var{style}@}@}
+\renewcommand@{\section@}@{\@@startsection@{@var{name}@}
+ @{@var{level}@}
+ @{@var{indent}@}
+ @{@var{beforeskip}@}
+ @{@var{afterskip}@}
+ @{@var{style}@}@}
@end example
-@noindent redefines @code{\section} to have the form
+
+@noindent
+redefines @code{\section} to have the form
@code{\section*[@var{toctitle}]@{@var{title}@}} (here too, the
star@tie{}@code{*} is optional). @xref{Sectioning}. This implies that
when you write a command like @code{\renewcommand@{section@}@{...@}},
@@ -2615,55 +3359,56 @@ the examples below.
@table @var
@item name
-@anchor{\@@startsection/name} Name of the counter used to number the
-sectioning header. This counter must be defined separately. Most
-commonly this is either @code{section}, @code{subsection}, or
-@code{paragraph}. Although in those three cases the counter name is the
-same as the sectioning command itself, using the same name is not
-required.
+@anchor{startsection name}
+@anchor{\@@startsection/name}
+Name of the counter used to number the sectioning header. This counter
+must be defined separately. Most commonly this is either
+@code{section}, @code{subsection}, or @code{paragraph}. Although in
+those cases the counter name is the same as the sectioning command
+itself, you don't have to use the same name.
Then @code{\the}@var{name} displays the title number and
@code{\}@var{name}@code{mark} is for the page headers. See the third
example below.
@item level
-@anchor{\@@startsection/level} An integer giving the depth of the
-sectioning command: 0 for @code{chapter} (only applies to the standard
-@code{book} and @code{report} classes), 1 for @code{section}, 2 for
-@code{subsection}, 3 for @code{subsubsection}, 4 for @code{paragraph},
-and 5 for @code{subparagraph}. In the @code{book} and @code{report}
-classes @code{part} has level -1, while in the @code{article} class
-@code{part} has level 0.
-
-If @var{level} is less than or equal to the value of @code{secnumdepth}
-then the titles for this sectioning command will be numbered. For
-instance, in an @code{article}, if @code{secnumdepth} is 1 then a
-@code{\section@{Introduction@}} command will produce output like ``1
+@anchor{startsection level}
+@anchor{\@@startsection/level}
+An integer giving the depth of the sectioning command.
+@xref{Sectioning} for the list of standard level numbers.
+
+If @var{level} is less than or equal to the value of the counter
+@code{secnumdepth} then titles for this sectioning command will be
+numbered (@pxref{Sectioning/secnumdepth}). For instance, if
+@code{secnumdepth} is 1 in an @code{article} then the command
+@code{\section@{Introduction@}} will produce output like ``1
Introduction'' while @code{\subsection@{Discussion@}} will produce
output like ``Discussion'', without the number prefix.
-@xref{Sectioning/secnumdepth}.
-If @var{level} is less than or equal to the value of @var{tocdepth} then
-the table of contents will have an entry for this sectioning unit.
-For instance, in an @code{article}, if @var{tocdepth} is 1 then the table of
-contents will list sections but not subsections.
-@c xx add, and cross reference to, tocdepth
+If @var{level} is less than or equal to the value of the counter
+@var{tocdepth} then the table of contents will have an entry for this
+sectioning unit (@pxref{Sectioning/tocdepth}). For instance, in an
+@code{article}, if @var{tocdepth} is 1 then the table of contents will
+list sections but not subsections.
@item indent
-@anchor{\@@startsection/indent} A length giving the indentation of all
-of the title lines with respect to the left margin. To have the title
-flush with the margin use @code{0pt}. A negative indentation such as
-@code{-\parindent} will move the title into the left margin.
+@anchor{startsection indent}
+@anchor{\@@startsection/indent}
+A length giving the indentation of all of the title lines with respect
+to the left margin. To have the title flush with the margin use
+@code{0pt}. A negative indentation such as @code{-\parindent} will move
+the title into the left margin.
@item beforeskip
-@anchor{\@@startsection/beforeskip} The absolute value of this length is
-the amount of vertical space that is inserted before this sectioning
-unit's title. This space will be discarded if the sectioning unit
-happens to start at the top of a fresh page. If this number is negative
-then the first paragraph following the header is not indented, if it is
-non-negative then the first paragraph is indented. (Note that the
-negative of @code{1pt plus 2pt minus 3pt} is @code{-1pt plus -2pt minus
--3pt}.)
+@anchor{startsection beforeskip}
+@anchor{\@@startsection/beforeskip}
+The absolute value of this length is the amount of vertical space that
+is inserted before this sectioning unit's title. This space will be
+discarded if the sectioning unit happens to start at the top of a fresh
+page. If this number is negative then the first paragraph following the
+header is not indented, if it is non-negative then the first paragraph
+is indented. (Note that the negative of @code{1pt plus 2pt minus 3pt}
+is @code{-1pt plus -2pt minus -3pt}.)
For example, if @var{beforeskip} is @code{-3.5ex plus -1ex minus -0.2ex}
then to start the new sectioning unit, @LaTeX{} will add about 3.5 times
@@ -2683,14 +3428,15 @@ where @LaTeX{} would put the baseline of the first text line on that
page.)
@item afterskip
-@anchor{\@@startsection/afterskip} This is a length. If @var{afterskip}
-is non-negative then this is the vertical space inserted after the
-sectioning unit's title header. If it is negative then the title header
-becomes a run-in header, so that it becomes part of the next paragraph.
-In this case the absolute value of the length gives the horizontal space
-between the end of the title and the beginning of the following
-paragraph. (Note that the negative of @code{1pt plus 2pt minus 3pt} is
-@code{-1pt plus -2pt minus -3pt}.)
+@anchor{startsection afterskip}
+@anchor{\@@startsection/afterskip}
+This is a length. If @var{afterskip} is non-negative then this is the
+vertical space inserted after the sectioning unit's title header. If it
+is negative then the title header becomes a run-in header, so that it
+becomes part of the next paragraph. In this case the absolute value of
+the length gives the horizontal space between the end of the title and
+the beginning of the following paragraph. (Note that the negative of
+@code{1pt plus 2pt minus 3pt} is @code{-1pt plus -2pt minus -3pt}.)
As with @var{beforeskip}, using a rubber length, with @code{plus} and
@code{minus} components, is good practice here since it gives @LaTeX{}
@@ -2707,48 +3453,39 @@ header's from standalone to run-in, you cannot use a negative
@code{afterskip} to cancel part of the @code{\parskip}.)
@item style
-@anchor{\@@startsection/style} Controls the styling of the title. See
-the examples below. Typical commands to use here are @code{\centering},
-@code{\raggedright}, @code{\normalfont}, @code{\hrule}, or
-@code{\newpage}. The last command in @var{style} may be one such as
-@code{\MakeUppercase} or @code{\fbox} that takes one argument. The
+@anchor{startsection style}
+@anchor{\@@startsection/style}
+Controls the styling of the title. See the examples below. Typical
+commands to use here are @code{\centering}, @code{\raggedright},
+@code{\normalfont}, @code{\hrule}, or @code{\newpage}. The last command
+in @var{style} may be one that takes one argument, such as
+@code{\MakeUppercase} or @code{\fbox} that takes one argument. The
section title will be supplied as the argument to this command. For
instance, setting @var{style} to @code{\bfseries\MakeUppercase} would
-produce titles that are bold and upper case.
+produce titles that are bold and uppercase.
@end table
These are @LaTeX{}'s defaults for the first three sectioning units that
are defined with @code{\@@startsection}, for the @file{article},
-@file{book}, and @file{report} classes.
-
-@multitable @columnfractions .10 .30 .30 .30
-@headitem @tab @code{section} @tab @code{subsection} @tab @code{subsubsection}
-@item @ref{\@@startsection/name,@var{name},@var{name}}
-@tab section @tab subsection @tab subsubsection
-@item @ref{\@@startsection/level,@var{level},@var{level}}
-@tab 1 @tab 2 @tab 3
-@item @ref{\@@startsection/indent,@var{indent},@var{indent}}
-@tab @code{0pt} @tab @code{0pt} @tab @code{0pt}
-@item @ref{\@@startsection/beforeskip,@var{beforeskip},@var{beforeskip}}
-@tab @code{-3.5ex plus -1ex minus -0.2ex}
-@tab @code{-3.25ex plus -1ex minus -0.2ex}
-@tab @code{-3.25ex plus -1ex minus -0.2ex}
-@item @ref{\@@startsection/afterskip,@var{afterskip},@var{afterskip}}
-@tab @code{2.3ex plus 0.2ex}
-@tab @code{1.5ex plus 0.2ex}
-@tab @code{1.5ex plus 0.2ex}
-@item @ref{\@@startsection/style,@var{style},@var{style}}
-@tab @code{\normalfont\Large\bfseries}
-@tab @code{\normalfont\large\bfseries}
-@tab @code{\normalfont\normalsize\bfseries}
-@end multitable
+@file{book}, and @file{report} classes. For section, the @var{level} is
+1, the @var{indent} is 0@dmn{pt}, the @var{beforeskip} is @code{-3.5ex
+plus -1ex minus -0.2ex}, the @var{afterskip} is @code{2.3ex plus 0.2ex},
+and the @var{style} is @code{\normalfont\Large\bfseries}. For
+subsection, the @var{level} is 2, the @var{indent} is 0@dmn{pt}, the
+@var{beforeskip} is @code{-3.25ex plus -1ex minus -0.2ex}, the
+@var{afterskip} is @code{1.5ex plus 0.2ex}, and the @var{style} is
+@code{\normalfont\large\bfseries}. For subsubsection, the @var{level}
+is 3, the @var{indent} is 0@dmn{pt}, the @var{beforeskip} is
+@code{-3.25ex plus -1ex minus -0.2ex}, the @var{afterskip} is
+@code{1.5ex plus 0.2ex}, and the @var{style} is
+@code{\normalfont\normalsize\bfseries}.
Here are examples. They go either in a package or class file or in the
preamble of a @LaTeX{} document. If you put them in the preamble they
must go between a @code{\makeatletter} command and a
@code{\makeatother}. (Probably the error message @code{You can't use
`\spacefactor' in vertical mode.} means that you forgot this.)
-@xref{\makeatletter and \makeatother}.
+@xref{\makeatletter & \makeatother}.
This will put section titles in large boldface type, centered. It says
@code{\renewcommand} because @LaTeX{}'s standard classes have already
@@ -2780,7 +3517,9 @@ This will put @code{subsection} titles in small caps type, inline with the parag
@}
@end example
-The prior examples redefined existing sectional unit title commands. This defines a new one, illustrating the needed counter and macros to display that counter.
+The prior examples redefined existing sectional unit title commands.
+This defines a new one, illustrating the needed counter and macros to
+display that counter.
@c From https://groups.google.com/forum/#!searchin/comp.text.tex/startsection%7Csort:relevance/comp.text.tex/sB-nTS-oL08/ZZeKYdG0llMJ
@example
@@ -2805,38 +3544,48 @@ The prior examples redefined existing sectional unit title commands. This defin
@cindex cross references
-One reason for numbering things such as figures and equations is to
-refer the reader to them, as in ``See Figure~3 for more details.''
-
@cindex label
-Including the figure number in the source is poor practice since if that
-number changes as the document evolves then you must remember to update
-this reference by hand. Instead, @LaTeX{} has you write a @dfn{label}
-like @code{\label@{eq:GreensThm@}} and refer to it with @code{See
-equation~\ref@{eq:GreensThm@}}.
-
-@LaTeX{} writes the information from the labels to a file with the same
-name as the file containing the @code{\label@{...@}} but with an
-@file{.aux} extension. (The information has the format
-@code{\newlabel@{@var{label}@}@{@{@var{currentlabel}@}@{@var{pagenumber}@}@}}
-where @var{currentlabel} is the current value of the macro
-@code{\@@currentlabel} that is usually updated whenever you call
-@code{\refstepcounter@{@var{counter}@}}.)
+We often want something like @samp{See Theorem~31}. But by-hand typing
+the 31 is poor practice. Instead you should write a @dfn{label} such as
+@code{\label@{eq:GreensThm@}} and then @dfn{reference} it, as with
+@code{See equation~\ref@{eq:GreensThm@}}. @LaTeX{} will automatically
+work out the number, put it into the output, and will change that number
+later if needed.
+
+@example
+We will see this with Theorem~\ref@{th:GreensThm@}. % forward reference
+...
+\begin@{theorem@} \label@{th:GreensThm@}
+ ...
+\end@{theorem@}
+...
+See Theorem~\ref@{th:GreensThm@} on page~\pageref@{th:GreensThm@}.
+@end example
+
+@LaTeX{} tracks cross reference information in a file having the
+extension @file{.aux} and with the same base name as the file containing
+the @code{\label}. So if @code{\label} is in @file{calculus.tex} then
+the information is in @file{calculus.aux}. @LaTeX{} puts the
+information in that file every time it runs across a @code{\label}.
@cindex forward reference
@cindex reference, forward
-The most common side effect of the prior paragraph happens when your
-document has a @dfn{forward reference}, a @code{\ref@{@var{key}@}} that
-appears earlier than the associated @code{\label@{@var{key}@}}; see the
-example in the @code{\pageref@{...@}} description. @LaTeX{} gets the
-information for references from the @file{.aux} file. If this is the
-first time you are compiling the document then you will get a message
-@code{LaTeX Warning: Label(s) may have changed. Rerun to get
-cross references right.} and in the output the reference will appear as
-two question marks@tie{}@samp{??}, in boldface. Or, if you change some
-things so the references change then you get the same warning and the
-output contains the old reference information. The solution in either
-case is just to compile the document a second time.
+The behavior described in the prior paragraph results in a quirk that
+happens when your document has a @dfn{forward reference}, a @code{\ref}
+that appears before the associated @code{\label}. If this is the first
+time that you are compiling the document then you will get @samp{LaTeX
+Warning: Label(s) may have changed. Rerun to get cross references right}
+and in the output the forward reference will appear as two question
+marks@tie{}@samp{??}, in boldface. A similar thing happens if you
+change some things so the references changes; you get the same warning
+and the output contains the old reference information. In both cases,
+resolve this by compiling the document a second time.
+
+@PkgIndex{cleveref} The @code{cleveref} package enhances @LaTeX{}'s
+cross referencing features. You can arrange that if you enter
+@code{\begin@{thm@}\label@{th:Nerode@}...\end@{thm@}} then
+@code{\cref@{th:Nerode@}} will output @samp{Theorem 3.21}, without you
+having to enter the ``Theorem.''
@menu
* \label:: Assign a symbolic name to a piece of text.
@@ -2869,30 +3618,39 @@ punctuation characters. Upper and lowercase letters are
distinguished, as usual.
A common convention is to use labels consisting of a prefix and a suffix
-separated by a colon or period. This helps to avoid accidentally
-creating two labels with the same name, and makes your source more
-readable. Some commonly-used prefixes:
+separated by a colon or period. Thus, @code{\label@{fig:Post@}} is a
+label for a figure with a portrait of Emil Post. This helps to avoid
+accidentally creating two labels with the same name, and makes your
+source more readable. Some commonly-used prefixes:
@table @code
@item ch
for chapters
+
@item sec
+@itemx subsec
for lower-level sectioning commands
+
@item fig
for figures
+
@item tab
for tables
+
@item eq
for equations
@end table
-Thus, @code{\label@{fig:Euler@}} is a label for a figure with a portrait
-of the great man.
+In the auxiliary file the reference information is kept as the text of
+a command of the form
+@code{\newlabel@{@var{label}@}@{@{@var{currentlabel}@}@{@var{pagenumber}@}@}}.
+Here @var{currentlabel} is the current value of the macro
+@code{\@@currentlabel} that is usually updated whenever you call
+@code{\refstepcounter@{@var{counter}@}}.
-In this example below the key @code{sec:test} will get the number of the
-current section and the key @code{fig:test} will get the number of the
-figure. (Incidentally, put labels after captions in figures and
-tables.)
+Below, the key @code{sec:test} will get the number of the current
+section and the key @code{fig:test} will get the number of the figure.
+(Incidentally, put labels after captions in figures and tables.)
@example
\section@{section name@}
@@ -2908,7 +3666,7 @@ See Figure~\ref@{fig:test@}.
@node \pageref
-@section @code{\pageref@{@var{key}@}}
+@section @code{\pageref}
@findex \pageref
@cindex cross referencing with page number
@@ -2923,10 +3681,14 @@ Synopsis:
Produce the page number of the place in the text where the corresponding
@code{\label}@{@var{key}@} command appears.
-In this example the @code{\label@{eq:main@}} is used both for the
-formula number and for the page number. (Note that the two references
-are forward references, so this document would need to be compiled twice
-to resolve those.)
+If there is no @code{\label@{@var{key}@}} then you get something like
+@samp{LaTeX Warning: Reference `th:GrensThm' on page 1 undefined on
+input line 11.}
+
+Below, the @code{\label@{eq:main@}} is used both for the formula number
+and for the page number. (Note that the two references are forward
+references so this document would need to be compiled twice to resolve
+those.)
@example
The main result is formula~\ref@{eq:main@} on page~\pageref@{eq:main@}.
@@ -2938,7 +3700,7 @@ The main result is formula~\ref@{eq:main@} on page~\pageref@{eq:main@}.
@node \ref
-@section @code{\ref@{@var{key}@}}
+@section @code{\ref}
@findex \ref
@cindex cross referencing, symbolic
@@ -2958,9 +3720,13 @@ equation, footnote, figure, @dots{}, of the corresponding
@code{\label} command (@pxref{\label}). It does not produce any text,
such as the word `Section' or `Figure', just the bare number itself.
-In this example, the @code{\ref@{popular@}} produces @samp{2}. Note
-that it is a forward reference since it comes before
-@code{\label@{popular@}}.
+If there is no @code{\label@{@var{key}@}} then you get something like
+@samp{LaTeX Warning: Reference `th:GrensThm' on page 1 undefined on
+input line 11.}
+
+In this example the @code{\ref@{popular@}} produces @samp{2}. Note that
+it is a forward reference since it comes before @code{\label@{popular@}}
+so this document would have to be compiled twice.
@example
The most widely-used format is item number~\ref@{popular@}.
@@ -2971,6 +3737,10 @@ The most widely-used format is item number~\ref@{popular@}.
\end@{enumerate@}
@end example
+@PkgIndex{cleveref}
+The @file{cleveref} package includes text such as @samp{Theorem} in the
+reference. See the documentation on CTAN.
+
@node Environments
@chapter Environments
@@ -3018,11 +3788,11 @@ Environments are executed within a group.
* math:: In-line math.
* minipage:: Miniature page.
* picture:: Picture with text, arrows, lines and circles.
-* quotation and quote:: Include a quotation.
+* quotation & quote:: Include a quotation.
* tabbing:: Align text arbitrarily.
* table:: Floating tables.
* tabular:: Align text in columns.
-* thebibliography:: Bibliography or reference list.
+* thebibliography:: Bibliography or reference list.
* theorem:: Theorems, lemmas, etc.
* titlepage:: For hand crafted title pages.
* verbatim:: Simulating typed input.
@@ -3102,7 +3872,8 @@ Synopsis:
\end@{array@}
@end example
-or
+@noindent
+or:
@example
\begin@{array@}[@var{pos}]@{@var{cols}@}
@@ -3113,26 +3884,44 @@ or
Produce a mathematical array. This environment can only be used in math
mode, and normally appears within a displayed mathematics environment
-such as @code{equation} (@pxref{equation}). Column entries are
-separated by an ampersand@tie{}(@code{&}). Rows are terminated with
-double-backslashes (@pxref{\\}).
+such as @code{equation} (@pxref{equation}). Inside of each row the
+column entries are separated by an ampersand, (@code{&}). Rows are
+terminated with double-backslashes (@pxref{\\}).
+
+This example shows a three by three array.
+
+@example
+\begin@{equation*@}
+ \chi(x) =
+ \left| % vertical bar fence
+ \begin@{array@}@{ccc@}
+ x-a &-b &-c \\
+ -d &x-e &-f \\
+ -g &-h &x-i
+ \end@{array@}
+ \right|
+\end@{equation*@}
+@end example
The required argument @var{cols} describes the number of columns, their
-alignment, and the formatting of the intercolumn regions. See
-@ref{tabular} for the complete description of @var{cols}, and of the
+alignment, and the formatting of the intercolumn regions. For instance,
+@code{\begin@{array@}@{rcl@}...\end@{array@}} gives three columns: the
+first flush right, the second centered, and the third flush left. See
+@ref{tabular} for the complete description of @var{cols} and of the
other common features of the two environments, including the optional
@var{pos} argument.
There are two ways that @code{array} diverges from @code{tabular}. The
first is that @code{array} entries are typeset in math mode, in
-textstyle (except if the @var{cols} definition specifies the column with
-@code{p@{...@}}, which causes the entry to be typeset in text mode).
-The second is that, instead of @code{tabular}'s parameter
-@code{\tabcolsep}, @LaTeX{}'s intercolumn space in an @code{array} is governed
-by
+textstyle (@pxref{Modes}) except if the @var{cols} definition specifies
+the column with @code{p@{...@}}, which causes the entry to be typeset in
+text mode. The second is that, instead of @code{tabular}'s parameter
+@code{\tabcolsep}, @LaTeX{}'s intercolumn space in an @code{array} is
+governed by
@findex \arraycolsep
@code{\arraycolsep}, which gives half the width between columns. The
-default for this is @samp{5pt}.
+default for this is @samp{5pt} so that between two columns comes
+10@dmn{pt} of space.
@PkgIndex{amsmath}
To obtain arrays with braces the standard is to use the @file{amsmath}
@@ -3144,29 +3933,27 @@ an array surrounded by vertical bars@tie{}@code{|...|}, and
@code{Vmatrix} for an array surrounded by double vertical
bars@tie{}@code{||...||}, along with a number of other array constructs.
-Here is an example of an array:
+@PkgIndex{amsmath}
+The next example uses the @file{amsmath} package.
@example
-\begin@{equation@}
- \begin@{array@}@{cr@}
- \sqrt@{y@} &12.3 \\
- x^2 &3.4
- \end@{array@}
-\end@{equation@}
-@end example
+\usepackage@{amsmath@} % in preamble
-The next example works if @code{\usepackage@{amsmath@}} is in the
-preamble:
-
-@example
-\begin@{equation@}
- \begin@{vmatrix@}@{cc@}
+\begin@{equation@}
+ \begin@{vmatrix@}@{cc@} % array with vert lines
a &b \\
c &d
\end@{vmatrix@}=ad-bc
\end@{equation@}
@end example
+@PkgIndex{array (package)}
+@PkgIndex{dcolumn}
+There are many packages concerning arrays. The @file{array} package has
+many useful extensions, including more column types. The @file{dcolumn}
+package adds a column type to center on a decimal point. For both see
+the documentation on CTAN.
+
@node center
@section @code{center}
@@ -3178,17 +3965,19 @@ Synopsis:
@example
\begin@{center@}
- ... text ...
+ @var{line1} \\
+ @var{line2} \\
+ ...
\end@{center@}
@end example
Create a new paragraph consisting of a sequence of lines that are
-centered within the left and right margins on the current page. Use
-double-backslash to get a line break at a particular spot (@pxref{\\}).
+centered within the left and right margins. Use
+double-backslash, @code{\\}, to get a line break (@pxref{\\}).
@findex \\ @r{(for @code{center})}
-If some text environment body is too long to fit on a line, @LaTeX{}
-will insert line breaks that avoid hyphenation and avoid stretching or
-shrinking any interword space.
+If some text is too long to fit on a line then @LaTeX{} will insert line
+breaks that avoid hyphenation and avoid stretching or shrinking any
+interword space.
This environment inserts space above and below the text body. See
@ref{\centering} to avoid such space, for example inside a @code{figure}
@@ -3219,7 +4008,11 @@ ending.
\end@{center@}
@end example
-A double backslash after the final line is optional.
+A double backslash after the final line is optional. If present it
+doesn't add any vertical space.
+
+In a two-column document the text is centered in a column, not in the
+entire page.
@menu
* \centering:: Declaration form of the @code{center} environment.
@@ -3232,12 +4025,42 @@ A double backslash after the final line is optional.
@findex \centering
@cindex centering text, declaration for
-A declaration that causes material in its scope to be centered. It is
-most often used inside an environment such as @code{figure}, or in a
-@code{parbox}.
+
+Synopsis:
+
+@example
+@{\centering ... @}
+@end example
+
+@noindent
+or
+
+@example
+\begin@{group@}
+ \centering ...
+\end@{group@}
+@end example
+
+Center the material in its scope. It is most often used inside an
+environment such as @code{figure}, or in a @code{parbox}.
+
+This example's @code{\centering} declaration causes the graphic to be
+horizontally centered.
+
+@example
+\begin@{figure@}
+ \centering
+ \includegraphics[width=0.6\textwidth]@{ctan_lion.png@}
+ \caption@{CTAN Lion@} \label@{fig:CTANLion@}
+\end@{figure@}
+@end example
+
+@noindent
+The scope of this @code{\centering} ends with the @code{\end@{figure@}}.
Unlike the @code{center} environment, the @code{\centering} command does
-not add vertical space above and below the text.
+not add vertical space above and below the text. That's its advantage
+in the above example; there is not an excess of space.
It also does not start a new paragraph; it simply changes how @LaTeX{}
formats paragraph units. If @code{ww @{\centering xx \\ yy@} zz} is
@@ -3249,20 +4072,7 @@ environment such as @code{figure} or @code{table} that ends the
paragraph unit. Thus, if @code{@{\centering xx \\ yy\par@} zz} is
surrounded by blank lines then it makes a new paragraph with two
centered lines @samp{xx} and @samp{yy}, followed by a new paragraph with
-@samp{zz} that is formatted as usual. See also the following example.
-
-This example's @code{\centering} causes the graphic to be horizontally
-centered.
-
-@example
-\begin@{figure@}
- \centering
- \includegraphics[width=0.6\textwidth]@{ctan_lion.png@}
- \caption@{CTAN Lion@} \label@{fig:CTANLion@}
-\end@{figure@}
-@end example
-
-The scope of the @code{\centering} ends with the @code{\end@{figure@}}.
+@samp{zz} that is formatted as usual.
@node description
@@ -3276,21 +4086,19 @@ Synopsis:
@example
\begin@{description@}
-\item[@var{label of first item}] text of first item
-\item[@var{label of second item}] text of second item
- ...
+ \item[@var{label of first item}] @var{text of first item}
+ \item[@var{label of second item}] @var{text of second item}
+ ...
\end@{description@}
@end example
-Environment to make a labeled list of items. Each item's @var{label} is
-typeset in bold, and is flush left so that long labels continue into the
+Environment to make a list of labeled items. Each item's @var{label} is
+typeset in bold and is flush left, so that long labels continue into the
first line of the item text. There must be at least one item; having
none causes the @LaTeX{} error @samp{Something's wrong--perhaps a
missing \item}.
This example shows the environment used for a sequence of definitions.
-The labels @samp{lama} and @samp{llama} come out in boldface with their
-left edges aligned on the left margin.
@example
\begin@{definition@}
@@ -3299,6 +4107,10 @@ left edges aligned on the left margin.
\end@{definition@}
@end example
+@noindent
+The labels @samp{lama} and @samp{llama} are output in boldface, with the
+left edge on the left margin.
+
@findex \item
Start list items with the @code{\item} command (@pxref{\item}). Use the
optional labels, as in @code{\item[Main point]}, because there is
@@ -3311,10 +4123,10 @@ Since the labels are in bold style, if the label text calls for a font
change given in argument style (see @ref{Font styles}) then it will come
out bold. For instance, if the label text calls for typewriter with
@code{\item[\texttt@{label text@}]} then it will appear in bold
-typewriter, if that is available. The simplest way to get non-bold
-typewriter is to use declarative style: @code{\item[@{\tt label
-text@}]}. Similarly, get the standard roman font with @code{\item[@{\rm
-label text@}]}.
+typewriter, if that is available. The simplest way around this, in this
+example to get non-bold typewriter, is to use declarative style:
+@code{\item[@{\tt label text@}]}. Similarly, get the standard roman
+font with @code{\item[@{\rm label text@}]}.
For other major @LaTeX{} labelled list environments, see @ref{itemize}
and @ref{enumerate}. Unlike those environments, nesting
@@ -3344,7 +4156,7 @@ Synopsis:
@example
\begin@{displaymath@}
-@var{math text}
+ @var{mathematical text}
\end@{displaymath@}
@end example
@@ -3377,11 +4189,14 @@ different vertical spacing, and because the @code{displaymath}
environment honors the @code{fleqn} option.)
The output from this example is centered and alone on its line.
+
@example
\begin@{displaymath@}
\int_1^2 x^2\,dx=7/3
\end@{displaymath@}
@end example
+
+@noindent
Also, the integral sign is larger than the inline version
@code{\( \int_1^2 x^2\,dx=7/3 \)} produces.
@@ -3455,9 +4270,9 @@ Synopsis:
@example
\begin@{enumerate@}
-\item[@var{optional label of first item}] text of first item
-\item[@var{optional label of second item}] text of second item
-...
+ \item[@var{optional label of first item}] @var{text of first item}
+ \item[@var{optional label of second item}] @var{text of second item}
+ ...
\end@{enumerate@}
@end example
@@ -3496,15 +4311,19 @@ the outermost level.
@enumerate
@item arabic number followed by a period: @samp{1.}, @samp{2.},@tie{}@dots{}
-@item lower case letter inside parentheses: @samp{(a)}, @samp{(b)}@tie{}@dots{}
-@item lower case roman numeral followed by a period: @samp{i.}, @samp{ii.},@tie{}@dots{}
-@item upper case letter followed by a period: @samp{A.}, @samp{B.},@tie{}@dots{}
+@item lowercase letter inside parentheses: @samp{(a)}, @samp{(b)}@tie{}@dots{}
+@item lowercase roman numeral followed by a period: @samp{i.}, @samp{ii.},@tie{}@dots{}
+@item uppercase letter followed by a period: @samp{A.}, @samp{B.},@tie{}@dots{}
@end enumerate
@findex \enumi
@findex \enumii
@findex \enumiii
@findex \enumiv
+@anchor{enumerate enumi}
+@anchor{enumerate enumii}
+@anchor{enumerate enumiii}
+@anchor{enumerate enumiv}
The @code{enumerate} environment uses the counters @code{\enumi} through
@code{\enumiv} (@pxref{Counters}).
@@ -3518,6 +4337,10 @@ useful for customizing lists.
@findex \labelenumii
@findex \labelenumiii
@findex \labelenumiv
+@anchor{enumerate labelenumi}
+@anchor{enumerate labelenumii}
+@anchor{enumerate labelenumiii}
+@anchor{enumerate labelenumiv}
To change the format of the label use @code{\renewcommand}
(@pxref{\newcommand & \renewcommand}) on the commands @code{\labelenumi}
through @code{\labelenumiv}. For instance, this first level list will be
@@ -3547,17 +4370,16 @@ For a list of counter-labeling commands see @ref{\alph \Alph \arabic
@cindex align @r{environment, from @code{amsmath}}
@cindex amsmath @r{package, replacing @code{eqnarray}}
@cindex Madsen, Lars
-First, a caveat: the @code{eqnarray} environment is depreciated. It has
-infelicities that cannot be overcome, including spacing that is
-inconsistent with other mathematics elements (see the article ``Avoid
-eqnarray!''@: by Lars Madsen
+The @code{eqnarray} environment is obsolete. It has infelicities,
+including spacing that is inconsistent with other mathematics elements.
+(See ``Avoid eqnarray!''@: by Lars Madsen
@url{http://tug.org/TUGboat/tb33-1/tb103madsen.pdf}). New documents
should include the @file{amsmath} package and use the displayed
mathematics environments provided there, such as the @code{align}
-environment.
+environment. We include a description only for completeness and for
+working with old documents.
-Nevertheless, for completeness and for a reference when working with old
-documents, a synopsis:
+Synopsis:
@example
\begin@{eqnarray@}
@@ -3566,6 +4388,7 @@ documents, a synopsis:
\end@{eqnarray@}
@end example
+@noindent
or
@example
@@ -3622,22 +4445,21 @@ Synopsis:
@example
\begin@{equation@}
- math text
+ @var{mathematical text}
\end@{equation@}
@end example
-Make a @code{displaymath} environment (@pxref{displaymath}) with an
-equation number in the right margin.
-
+The same as a @code{displaymath} environment (@pxref{displaymath})
+except that @LaTeX{} puts an equation number flush to the right margin.
The equation number is generated using the @code{equation} counter.
You should have no blank lines between @code{\begin@{equation@}} and
@code{\begin@{equation@}}, or @LaTeX{} will tell you that there is a
-missing dollar sign,@tie{}$@code{$}.
+missing dollar sign.
-Note that the @file{amsmath} package has extensive displayed equation
-facilities. Those facilities are the best approach for such output in
-new documents.
+@PkgIndex{amsmath}
+The package @file{amsmath} package has extensive displayed equation
+facilities. New documents should include this package.
@node figure
@@ -3651,29 +4473,37 @@ Synopsis:
@example
\begin@{figure@}[@var{placement}]
- figure body
-\caption[@var{loftitle}]@{@var{title}@}
-\label@{@var{label@}}
+ @var{figure body}
+ \caption[@var{loftitle}]@{@var{title}@} % optional
+ \label@{@var{label@}} % optional
\end@{figure@}
@end example
-or
+@noindent
+or:
@example
\begin@{figure*@}[@var{placement}]
- figure body
-\caption[@var{loftitle}]@{@var{title}@}
-\label@{@var{label@}}
+ @var{figure body}
+ \caption[@var{loftitle}]@{@var{title}@} % optional
+ \label@{@var{label@}} % optional
\end@{figure*@}
@end example
-A class of floats (@pxref{Floats}). Because they cannot be split across
-pages, they are not typeset in sequence with the normal text but instead
-are ``floated'' to a convenient place, such as the top of a following
-page.
+Figures are for material that is not part of the normal text. An
+example is material that you cannot have split between two pages, such
+as a graphic. Because of this, @LaTeX{} does not typeset figures in
+sequence with normal text but instead ``floats'' them to a convenient
+place, such as the top of a following page (@pxref{Floats}).
-For the possible values of @var{placement} and their effect on the
-float placement algorithm, see @ref{Floats}.
+The @var{figure body} can consist of imported graphics
+(@pxref{Graphics}), or text, @LaTeX{} commands, etc. It is typeset in a
+@code{parbox} of width @code{\textwidth}.
+
+The possible values of @var{placement} are @code{h} for @samp{here},
+@code{t} for @samp{top}, @code{b} for @samp{bottom}, and @code{p} for
+@samp{on a separate page of floats}. For the effect of these options on
+the float placement algorithm, see @ref{Floats}.
The starred form @code{figure*} is used when a document is in
double-column mode (@pxref{\twocolumn}). It produces a figure that
@@ -3681,23 +4511,21 @@ spans both columns, at the top of the page. To add the possibility of
placing at a page bottom see the discussion of @var{placement} @code{b}
in @ref{Floats}.
-The figure body is typeset in a @code{parbox} of width @code{\textwidth}
-and so it can contain text, commands, etc.
-
The label is optional; it is used for cross references (@pxref{Cross
references}).
@findex \caption
The optional @code{\caption} command specifies caption text for the
figure. By default it is numbered. If @var{loftitle} is present, it is
-used in the list of figures instead of @var{title} (@pxref{Tables of
-contents}).
+used in the list of figures instead of @var{title} (@pxref{Table of
+contents etc.}).
-This example makes a figure out of a graphic. It requires one of the
-packages @file{graphics} or @file{graphicx}. The graphic, with its
-caption, will be placed at the top of a page or, if it is pushed to the
+This example makes a figure out of a graphic. @LaTeX{} will place that
+graphic and its caption at the top of a page or, if it is pushed to the
end of the document, on a page of floats.
@example
+\usepackage@{graphicx@} % in preamble
+ ...
\begin@{figure@}[t]
\centering
\includegraphics[width=0.5\textwidth]@{CTANlion.png@}
@@ -3722,6 +4550,7 @@ Synopsis:
\end@{filecontents@}
@end example
+@noindent
or
@example
@@ -3760,6 +4589,7 @@ Article by \myname.
\end@{document@}
@end example
+@noindent
produces this file @file{JH.sty}.
@example
@@ -3778,18 +4608,37 @@ produces this file @file{JH.sty}.
@cindex left-justifying text, environment for
@cindex ragged right text, environment for
+Synopsis:
+
@example
\begin@{flushleft@}
-@var{line1} \\
-@var{line2} \\
-...
+ @var{line1} \\
+ @var{line2} \\
+ ...
\end@{flushleft@}
@end example
@findex \\ @r{for @code{flushleft}}
-The @code{flushleft} environment allows you to create a paragraph
-consisting of lines that are flush to the left-hand margin and ragged
-right. Each line must be terminated with the string @code{\\}.
+An environment that creates a paragraph whose lines are flush to the
+left-hand margin, and ragged right. If you have lines that are too long
+then @LaTeX{} will linebreak them in a way that avoids hyphenation and
+stretching or shrinking spaces. To force a new line use a double
+backslash, @code{\\}. For the declaration form
+see@tie{}@ref{\raggedright}.
+
+This creates a box of text that is at most 3 inches wide, with the text
+flush left and ragged right.
+
+@example
+\noindent\begin@{minipage@}@{3in@}
+\begin@{flushleft@}
+ A long sentence that will be broken by \LaTeX@{@}
+ at a convenient spot. \\
+ And, a fresh line forced by the double backslash.
+\end@{flushleft@}
+\end@{minipage@}
+@end example
+
@menu
* \raggedright:: Declaration form of the @code{flushleft} environment.
@@ -3804,9 +4653,25 @@ right. Each line must be terminated with the string @code{\\}.
@cindex left-justifying text
@cindex justification, ragged right
-The @code{\raggedright} declaration corresponds to the
-@code{flushleft} environment. This declaration can be used inside an
-environment such as @code{quote} or in a @code{parbox}.
+Synopses:
+
+@example
+@{\raggedright ... @}
+@end example
+
+@noindent
+or
+
+@example
+\begin@{@var{environment}@} \raggedright
+ ...
+\end@{@var{environment}@}
+@end example
+
+A declaration which causes lines to be flush to the left margin and
+ragged right. It can be used inside an environment such as @code{quote}
+or in a @code{parbox}. For the environment form
+see@tie{}@ref{flushleft}.
Unlike the @code{flushleft} environment, the @code{\raggedright}
command does not start a new paragraph; it only changes how @LaTeX{}
@@ -3814,6 +4679,19 @@ formats paragraph units. To affect a paragraph unit's format, the
scope of the declaration must contain the blank line or @code{\end}
command that ends the paragraph unit.
+Here @code{\raggedright} in each second column keeps @LaTeX{} from doing
+very awkward typesetting to fit the text into the narrow column. Note
+that @code{\raggedright} is inside the curly braces @code{@{...@}} to
+delimit its effect.
+
+@example
+\begin@{tabular@}@{rp@{2in@}@}
+ Team alpha &@{\raggedright This team does all the real work.@} \\
+ Team beta &@{\raggedright This team ensures that the water
+ cooler is never empty.@} \\
+\end@{tabular@}
+@end example
+
@node flushright
@section @code{flushright}
@@ -3824,16 +4702,21 @@ command that ends the paragraph unit.
@example
\begin@{flushright@}
-@var{line1} \\
-@var{line2} \\
-...
+ @var{line1} \\
+ @var{line2} \\
+ ...
\end@{flushright@}
@end example
@findex \\ (for @code{flushright})
-The @code{flushright} environment allows you to create a paragraph
-consisting of lines that are flush to the right-hand margin and ragged
-left. Each line must be terminated with the control sequence @code{\\}.
+An environment that creates a paragraph whose lines are flush to the
+right-hand margin and ragged left. If you have lines that are too long
+to fit the margins then @LaTeX{} will linebreak them in a way that
+avoids hyphenation and stretching or shrinking spaces. To force a new
+line use a double backslash, @code{\\}. For the declaration form
+see@tie{}@ref{\raggedleft}.
+
+For an example related to this environment, see@tie{}@ref{flushleft}.
@menu
* \raggedleft:: Declaration form of the @code{flushright} environment.
@@ -3848,9 +4731,25 @@ left. Each line must be terminated with the control sequence @code{\\}.
@cindex justification, ragged left
@cindex right-justifying text
-The @code{\raggedleft} declaration corresponds to the
-@code{flushright} environment. This declaration can be used inside an
-environment such as @code{quote} or in a @code{parbox}.
+Synopses:
+
+@example
+@{\raggedleft ... @}
+@end example
+
+@noindent
+or
+
+@example
+\begin@{@var{environment}@} \raggedleft
+ ...
+\end@{@var{environment}@}
+@end example
+
+A declaration which causes lines to be flush to the right margin and
+ragged left. It can be used inside an environment such as @code{quote}
+or in a @code{parbox}. For the environment form
+see@tie{}@ref{flushright}.
Unlike the @code{flushright} environment, the @code{\raggedleft}
command does not start a new paragraph; it only changes how @LaTeX{}
@@ -3858,6 +4757,8 @@ formats paragraph units. To affect a paragraph unit's format, the
scope of the declaration must contain the blank line or @code{\end}
command that ends the paragraph unit.
+For an example related to this environment, see@tie{}@ref{\raggedright}.
+
@node itemize
@section @code{itemize}
@@ -3867,25 +4768,23 @@ command that ends the paragraph unit.
@cindex lists of items
@cindex unordered lists
@cindex bulleted lists
+@cindex bullet lists
Synopsis:
@example
\begin@{itemize@}
-\item[@var{optional label of first item}] text of first item
-\item[@var{optional label of second item}] text of second item
-...
+ \item[@var{optional label of first item}] @var{text of first item}
+ \item[@var{optional label of second item}] @var{text of second item}
+ ...
\end@{itemize@}
@end example
-The @code{itemize} environment produces an ``unordered'', ``bulleted''
-list. The format of the label numbering depends on the nesting level of
-this environment; see below. Each @code{itemize} list environment must
-have at least one item; having none causes the @LaTeX{} error
-@samp{Something's wrong--perhaps a missing \item}.
+Produce a list that is unordered, sometimes called a bullet list. The
+environment must have at least one @code{\item}; having none causes the
+@LaTeX{} error @samp{Something's wrong--perhaps a missing \item}.
-This example gives a two-item list. As a top-level list each label
-would come out as a bullet, @bullet{}.
+This gives a two-item list.
@example
\begin@{itemize@}
@@ -3894,6 +4793,10 @@ would come out as a bullet, @bullet{}.
\end@{itemize@}
@end example
+@noindent
+As a top-level list each label would come out as a bullet, @bullet{}.
+The format of the labeling depends on the nesting level; see below.
+
@findex \item
Start list items with the @code{\item} command (@pxref{\item}). If you
give @code{\item} an optional argument by following it with square
@@ -3907,11 +4810,15 @@ contain multiple paragraphs.
@findex \labelitemii
@findex \labelitemiii
@findex \labelitemiv
+@anchor{itemize labelitemi}
+@anchor{itemize labelitemii}
+@anchor{itemize labelitemiii}
+@anchor{itemize labelitemiv}
Itemized lists can be nested within one another, up to four levels deep.
They can also be nested within other paragraph-making environments, such
as @code{enumerate} (@pxref{enumerate}). The @code{itemize} environment
uses the commands @code{\labelitemi} through @code{\labelitemiv} to
-produce the default label (this also uses the convention of lower case
+produce the default label (this also uses the convention of lowercase
roman numerals at the end of the command names that signify the nesting
level). These are the default marks at each level.
@@ -3941,10 +4848,17 @@ the first level use diamonds.
@findex \leftmarginiv
@findex \leftmarginv
@findex \leftmarginvi
+@anchor{itemize leftmargin}
+@anchor{itemize leftmargini}
+@anchor{itemize leftmarginii}
+@anchor{itemize leftmarginiii}
+@anchor{itemize leftmarginiv}
+@anchor{itemize leftmarginv}
+@anchor{itemize leftmarginvi}
The distance between the left margin of the enclosing environment and
the left margin of the @code{itemize} list is determined by the
parameters @code{\leftmargini} through @code{\leftmarginvi}. (Note the
-convention of using lower case roman numerals a the end of the command
+convention of using lowercase roman numerals a the end of the command
name to denote the nesting level.) The defaults are: @code{2.5em} in
level 1 (@code{2em} in two-column mode), @code{2.2em} in level 2,
@code{1.87em} in level 3, and @code{1.7em} in level 4, with smaller
@@ -3968,7 +4882,7 @@ Especially for lists with short items, it may be desirable to elide
space between items. Here is an example defining an @code{itemize*}
environment with no extra spacing between items, or between paragraphs
within a single item (@code{\parskip} is not list-specific,
-@pxref{\parskip}):
+@pxref{\parindent & \parskip}):
@example
\newenvironment@{itemize*@}%
@@ -3998,34 +4912,35 @@ Synopsis:
@example
\begin@{list@}@{@var{labeling}@}@{@var{spacing}@}
-\item[@var{optional label of first item}] text of first item
-\item[@var{optional label of second item}] text of second item
-...
+ \item[@var{optional label of first item}] @var{text of first item}
+ \item[@var{optional label of second item}] @var{text of second item}
+ ...
\end@{list@}
@end example
-The @code{list} environment is a generic environment for constructing
-more specialized lists. It is most often used to create lists via the
-@code{description}, @code{enumerate}, and @code{itemize} environments
-(@pxref{description}, @ref{enumerate}, and @ref{itemize}).
+An environment for constructing lists.
-Also, many standard @LaTeX{} environments that are not visually lists
-are constructed using @code{list}, including @code{quotation},
-@code{quote}, @code{center}, @code{verbatim}, and plenty more
-(@pxref{quotation and quote}, @pxref{center}, @pxref{flushright}).
+Note that this environment does not typically appear in the document
+body. Most lists created by @LaTeX{} authors are the ones that come
+standard: the @code{description}, @code{enumerate}, and @code{itemize}
+environments (@pxref{description}, @ref{enumerate}, and @ref{itemize}).
-@PkgIndex{enumitem}
-The third-party package @code{enumitem} is useful for customizing lists.
-Here, we describe the @code{list} environment by defining a new custom
+Instead, the @code{list} environment is most often used in macros. For
+example, many standard @LaTeX{} environments that do not immediately
+appear to be lists are in fact constructed using @code{list}, including
+@code{quotation}, @code{quote}, and @code{center} (@pxref{quotation &
+quote}, @pxref{center}).
+
+This uses the @code{list} environment to define a new custom
environment.
@example
\newcounter@{namedlistcounter@} % number the items
\newenvironment@{named@}
@{\begin@{list@}
- @{Item~\Roman@{namedlistcounter@}.@} % labeling argument
- @{\usecounter@{namedlistcounter@} % spacing argument
- \setlength@{\leftmargin@}@{3.5em@}@} % still spacing arg
+ @{Item~\Roman@{namedlistcounter@}.@} % labeling
+ @{\usecounter@{namedlistcounter@} % set counter
+ \setlength@{\leftmargin@}@{3.5em@}@} % set spacing
@}
@{\end@{list@}@}
@@ -4036,54 +4951,57 @@ environment.
\end@{named@}
@end example
-The @code{list} environment's mandatory first argument,
-@var{labeling}, specifies the default labeling of list items. It can
-contain text and @LaTeX{} commands, as above where it contains both
-@samp{Item} and @samp{\Roman@{...@}}. @LaTeX{} forms the label by
-putting the @var{labeling} argument in a box of width
-@code{\labelwidth}. If the label is wider than that, the additional
-material extends to the right. When making an instance of a list you
-can override the default labeling by giving @code{\item} an optional
-argument by including square braces and the text, as in the above
-@code{\item[Special label.]}; @pxref{\item}.
+The mandatory first argument @var{labeling} specifies the default
+labeling of list items. It can contain text and @LaTeX{} commands, as
+above where it contains both @samp{Item} and @samp{\Roman@{...@}}.
+@LaTeX{} forms the label by putting the @var{labeling} argument in a box
+of width @code{\labelwidth}. If the label is wider than that, the
+additional material extends to the right. When making an instance of a
+list you can override the default labeling by giving @code{\item} an
+optional argument by including square braces and the text, as in the
+above @code{\item[Special label.]}; @pxref{\item}.
+
+The mandatory second argument @var{spacing} has a list of commands.
+This list can be empty. A command that can go in here is
+@code{\usecounter@{@var{countername}@}} (@pxref{\usecounter}). Use this
+to tell @LaTeX{} to number the items using the given counter. The
+counter will be reset to zero each time @LaTeX{} enters the environment,
+and the counter is incremented by one each time @LaTeX{} encounters an
+@code{\item} that does not have an optional argument.
@findex \makelabel
-The label box is constructed by the command @code{\makelabel}. By
-default it positions the contents flush right. It takes one argument,
-the label. It typesets the contents in LR mode. An example of changing
-its definition is that to the above example before the definition of the
-@code{named} environment add
+@anchor{list makelabel} Another command that can go in @var{spacing} is
+@code{\makelabel}, which constructs the label box. By default it puts
+the contents flush right. Its only argument is the label, which it
+typesets in LR mode (@pxref{Modes}). One example of changing its
+definition is that to the above @code{named} example, before the
+definition of the environment add
@code{\newcommand@{\namedmakelabel@}[1]@{\textsc@{#1@}@}}, and between
the @code{\setlength} command and the parenthesis that closes the
@var{spacing} argument also add @code{\let\makelabel\namedmakelabel}.
Then the items will be typeset in small caps. Similarly, changing the
second code line to @code{\let\makelabel\fbox} puts the labels inside a
-framed box. Another example is at the bottom of this entry.
-
-The mandatory second argument @var{spacing} can have a list of
-commands to redefine the spacing parameters for the list, such as
-@code{\setlength@{\labelwidth@}@{2em@}}. If this argument is empty,
-i.e., @code{@{@}}, then the list will have the default spacing given
-below. To number the items using a counter, put
-@code{\usecounter@{@var{countername}@}} in this argument
-(@pxref{\usecounter}).
-
-Below are the spacing parameters for list formatting. See also the
-figure below. Each is a length (@pxref{Lengths}). The vertical
-spaces are normally rubber lengths, with @code{plus} and @code{minus}
-components, to give @TeX{} flexibility in setting the page. Change
-each with a command such as @code{\setlength@{itemsep@}@{2pt plus1pt
-minus1pt@}}. For some effects these lengths should be zero or
-negative. Default values for derived environments such as
-@code{itemize} can be changed from the values shown here for the basic
-@code{list}.
+framed box. Another example of the @code{\makelabel} command is below,
+in the definition of the @code{redlabel} environment.
+
+Also often in @var{spacing} are commands to redefine the spacing for the
+list. Below are the spacing parameters with their default values.
+(Default values for derived environments such as @code{itemize} can be
+different than the values shown here.) See also the figure that follows
+the list. Each is a length (@pxref{Lengths}). The vertical spaces are
+normally rubber lengths, with @code{plus} and @code{minus} components,
+to give @TeX{} flexibility in setting the page. Change each with a
+command such as @code{\setlength@{itemsep@}@{2pt plus1pt minus1pt@}}.
+For some effects these lengths should be zero or negative.
@ftable @code
@item \itemindent
+@anchor{list itemindent}
Extra horizontal space indentation, beyond @code{leftmargin}, of the
first line each item. Its default value is @code{0pt}.
@item \itemsep
+@anchor{list itemsep}
Vertical space between items, beyond the @code{\parsep}. The defaults
for the first three levels in @LaTeX{}'s @samp{article}, @samp{book},
and @samp{report} classes at 10 point size are: @code{4pt plus2pt
@@ -4096,11 +5014,13 @@ minus1pt}, @code{\parsep} (that is, @code{2.5pt plus1pt minus1pt}), and
@code{\topsep} (that is, @code{2.5pt plus1pt minus1pt}).
@item \labelsep
+@anchor{list labelsep}
Horizontal space between the label and text of an item.
The default for @LaTeX{}'s @samp{article}, @samp{book},
and @samp{report} classes is @code{0.5em}.
@item \labelwidth
+@anchor{list labelwidth}
Horizontal width. The box containing the label is nominally this wide.
If @code{\makelabel} returns text that is wider than this then the first
line of the item will be indented to make room for this extra material.
@@ -4122,6 +5042,7 @@ label's left edge coincide with the left margin of the enclosing
environment.
@item \leftmargin
+@anchor{list leftmargin}
Horizontal space between the left margin of the enclosing environment
(or the left margin of the page if this is a top-level list), and the
left margin of this list. It must be non-negative.
@@ -4139,12 +5060,14 @@ The defaults for the first three levels in @LaTeX{}'s @samp{article},
@code{2.2em}, and @code{\leftmarginiii} is @code{1.87em}.
@item \listparindent
+@anchor{list listparindent}
Horizontal space of additional line indentation, beyond
@code{\leftmargin}, for second and subsequent paragraphs within a list
item. A negative value makes this an ``outdent''. Its default value
is @code{0pt}.
@item \parsep
+@anchor{list parsep}
Vertical space between paragraphs within an item. In the @samp{book}
and @samp{article} classes The defaults for the first three levels in
@LaTeX{}'s @samp{article}, @samp{book}, and @samp{report} classes at 10
@@ -4155,6 +5078,7 @@ minus1pt}, and @code{0pt}. The defaults at 11 point size are:
minus1pt}, @code{2.5pt plus1pt minus1pt}, and @code{0pt}.
@item \partopsep
+@anchor{list partopsep}
Vertical space added, beyond @code{\topsep}+@code{\parskip}, to the top
and bottom of the entire environment if the list instance is preceded by
a blank line. (A blank line in the @LaTeX{} source before the list
@@ -4170,20 +5094,22 @@ defaults at 12 point are: @code{3pt plus2pt minus3pt}, @code{3pt plus2pt
minus2pt}, and @code{1pt plus0pt minus1pt}.
@item \rightmargin
+@anchor{list rightmargin}
Horizontal space between the right margin of the list and the right
margin of the enclosing environment. Its default value is @code{0pt}.
It must be non-negative.
@item \topsep
+@anchor{list topsep}
Vertical space added to both the top and bottom of the list, in addition
-to @code{\parskip} (@pxref{\parskip}). The defaults for the first three
-levels in @LaTeX{}'s @samp{article}, @samp{book}, and @samp{report}
-classes at 10 point size are: @code{8pt plus2pt minus4pt}, @code{4pt
-plus2pt minus1pt}, and @code{2pt plus1pt minus1pt}. The defaults at 11
-point are: @code{9pt plus3pt minus5pt}, @code{4.5pt plus2pt minus1pt},
-and @code{2pt plus1pt minus1pt}. The defaults at 12 point are:
-@code{10pt plus4pt minus6pt}, @code{5pt plus2.5pt minus1pt}, and
-@code{2.5pt plus1pt minus1pt}.
+to @code{\parskip} (@pxref{\parindent & \parskip}). The defaults for
+the first three levels in @LaTeX{}'s @samp{article}, @samp{book}, and
+@samp{report} classes at 10 point size are: @code{8pt plus2pt minus4pt},
+@code{4pt plus2pt minus1pt}, and @code{2pt plus1pt minus1pt}. The
+defaults at 11 point are: @code{9pt plus3pt minus5pt}, @code{4.5pt
+plus2pt minus1pt}, and @code{2pt plus1pt minus1pt}. The defaults at 12
+point are: @code{10pt plus4pt minus6pt}, @code{5pt plus2.5pt minus1pt},
+and @code{2.5pt plus1pt minus1pt}.
@end ftable
@@ -4215,6 +5141,9 @@ Same as @var{v0}. (This space is affected by whether a blank line
appears in the source above the environment; whether a blank line
appears in the source below the environment does not matter.)
+@item h0
+@code{\labelwidth}
+
@item h1
@code{\labelsep}
@@ -4250,18 +5179,25 @@ page break.
@ftable @code
@item \@@beginparpenalty
+@anchor{list beginparpenalty}
The page breaking penalty for breaking before the list (default @code{-51}).
@item \@@itempenalty
+@anchor{list itempenalty}
The page breaking penalty for breaking before a list item (default @code{-51}).
@item \@@endparpenalty
+@anchor{list endparpenalty}
The page breaking penalty for breaking after a list (default @code{-51}).
@end ftable
+@PkgIndex{enumitem}
+The package @code{enumitem} is useful for customizing lists.
+
This example has the labels in red. They are numbered, and the left
edge of the label lines up with the left edge of the item text.
+@xref{\usecounter}.
@example
\usepackage@{color@}
@@ -4296,7 +5232,9 @@ Synopsis:
\item text of item
@end example
+@noindent
or
+
@example
\item[@var{optional-label}] text of item
@end example
@@ -4404,26 +5342,131 @@ the running text. @code{\(...\)} and @code{$...$} are synonyms.
@EnvIndex{minipage}
@cindex minipage, creating a
+Synopses:
+
+@example
+\begin@{minipage@}@{@var{width}@}
+ @var{contents}
+\end@{minipage@}
+@end example
+
+@noindent
+or
+
@example
\begin@{minipage@}[@var{position}][@var{height}][@var{inner-pos}]@{@var{width}@}
-@var{text}
+ @var{contents}
+\end@{minipage@}
+@end example
+
+Put @var{contents} into a box that is @var{width} wide. This is like a
+small version of a page; it can contain its own footnotes, itemized
+lists, etc. (There are some restrictions, including that it cannot have
+floats.) This box will not be broken across pages. So @code{minipage}
+is similar to @code{\parbox} (@pxref{\parbox}) but here you can have
+paragraphs.
+
+This example will be 3@tie{}inches wide, and has two paragraphs.
+
+@example
+\begin@{minipage@}@{3in@}
+ Stephen Kleene was a founder of the Theory of Computation.
+
+ He was a student of Church, wrote three influential texts,
+ was President of the Association for Symbolic Logic,
+ and won the National Medal of Science.
+\end@{minipage@}
+@end example
+
+@noindent
+See below for a discussion of the paragraph indent inside a
+@code{minipage}.
+
+The required argument @var{width} is a rigid length (@pxref{Lengths}).
+It gives the width of the box into which @var{contents} are typeset.
+
+There are three optional arguments, @var{position}, @var{height}, and
+@var{inner-pos}. You need not include all three. For example, get the
+default @var{position} and set the @var{height} with
+@code{\begin@{minipage@}[c][2.54cm] @var{contents} \end@{minipage@}}.
+(Get the natural height with an empty argument, @code{[]}.)
+
+The optional argument @var{position} governs how the @code{minipage}
+vertically aligns with the surrounding material.
+
+@table @code
+@item c
+(synonym @code{m}) Default. Positions the @code{minipage} so its
+vertical center lines up with the center of the adjacent text line (what
+Plain @TeX{} calls @code{\vcenter}).
+
+@item t
+Match the top line in the @code{minipage} with the baseline of the
+surrounding text (Plain @TeX{}'s @code{\vtop}.
+
+@item b
+Match the bottom line in the @code{minipage} with the baseline of the
+surrounding text (Plain @TeX{}'s @code{\vbox}.
+@end table
+
+To see the effects of these, contrast running this
+
+@example
+---\begin@{minipage@}[c]@{0.25in@}
+ first\\ second\\ third
\end@{minipage@}
@end example
-The @code{minipage} environment typesets its body @var{text} in a
-block that will not be broken across pages. This is similar to the
-@code{\parbox} command (@pxref{\parbox}), but unlike @code{\parbox},
-other paragraph-making environments can be used inside a minipage.
+@noindent
+with the results of changing @code{c} to @code{b} or@tie{}@code{t}.
+
+The optional argument @var{height} is a rigid length (@pxref{Lengths}).
+It sets the height of the @code{minipage}. You can enter any value
+larger than, or equal to, or smaller than the @code{minipage}'s natural
+height and @LaTeX{} will not give an error or warning. You can also set
+it to a height of zero or a negative value.
+
+The final optional argument @var{inner-pos} controls the placement of
+@var{content} inside the box. These are the possible values are (the
+default is the value of @var{position}).
-@c (xxref positions)
-The arguments are the same as for @code{\parbox} (@pxref{\parbox}).
+@table @code
+@item t
+Place @var{content} at the top of the box.
+
+@item c
+Place it in the vertical center.
+
+@item b
+Place it at the box bottom.
+
+@item s
+Stretch @var{contents} out vertically; it must contain vertically
+stretchable space.
+
+@end table
+
+The @var{inner-pos} argument makes sense when the @var{height} options
+is set to a value larger than the @code{minipage}'s natural height. To
+see the effect of the options, run this example with the various choices
+in place of @code{b}.
+
+@example
+Text before
+\begin@{center@}
+ ---\begin@{minipage@}[c][3in][b]@{0.25\textwidth@}
+ first\\ second\\ third
+ \end@{minipage@}
+\end@{center@}
+Text after
+@end example
@cindex indentation of paragraphs, in minipage
@cindex paragraph indentation, in minipage
@findex \parindent
-By default, paragraphs are not indented in the @code{minipage}
-environment. You can restore indentation with a command such as
-@code{\setlength@{\parindent@}@{1pc@}} command.
+By default paragraphs are not indented in a @code{minipage}. Change
+that with a command such as @code{\setlength@{\parindent@}@{1pc@}} at
+the start of @var{contents}.
@cindex footnotes in figures
@cindex figures, footnotes in
@@ -4434,8 +5477,49 @@ the bottom of the minipage instead of at the bottom of the page, and it
uses the @code{\mpfootnote} counter instead of the ordinary
@code{footnote} counter (@pxref{Counters}).
-However, don't put one minipage inside another if you are using
-footnotes; they may wind up at the bottom of the wrong minipage.
+This puts the footnote at the bottom of the table, not the bottom of the
+page.
+
+@example
+\begin@{center@} % center the minipage on the line
+\begin@{minipage@}@{2.5in@}
+ \begin@{center@} % center the table inside the minipage
+ \begin@{tabular@}@{ll@}
+ \textsc@{Monarch@} &\textsc@{Reign@} \\ \hline
+ Elizabeth II &63 years\footnote@{to date@} \\
+ Victoria &63 years \\
+ George III &59 years
+ \end@{tabular@}
+ \end@{center@}
+\end@{minipage@}
+\end@{center@}
+@end example
+
+If you nest minipages then there is an oddness when using footnotes.
+Footnotes appear at the bottom of the text ended by the next
+@code{\end@{minipage@}} which may not be their logical place.
+
+This puts a table containing data side by side with a map graphic. They
+are vertically centered.
+
+@example
+\newcommand*@{\vcenteredhbox@}[1]@{\begin@{tabular@}@{@@@{@}c@@@{@}@}#1\end@{tabular@}@}
+ ...
+\begin@{center@}
+ \vcenteredhbox@{\includegraphics[width=0.3\textwidth]@{nyc.png@}@}
+ \hspace@{0.1\textwidth@}
+ \begin@{minipage@}@{0.5\textwidth@}
+ \begin@{tabular@}@{r|l@}
+ \multicolumn@{1@}@{r@}@{Borough@} &Pop (million) \\ \hline
+ The Bronx &$1.5$ \\
+ Brooklyn &$2.6$ \\
+ Manhattan &$1.6$ \\
+ Queens &$2.3$ \\
+ Staten Island &$0.5$
+ \end@{tabular@}
+ \end@{minipage@}
+\end@{center@}
+@end example
@node picture
@@ -4445,220 +5529,307 @@ footnotes; they may wind up at the bottom of the wrong minipage.
@cindex creating pictures
@cindex pictures, creating
+Synopses:
+@example
+\begin@{picture@}(@var{width},@var{height})
+ @var{picture commands}
+\end@{picture@}
+@end example
+
+@noindent
+or
+
@example
\begin@{picture@}(@var{width},@var{height})(@var{xoffset},@var{yoffset})
-@dots{} @var{picture commands} @dots{}
+ @var{picture commands}
\end@{picture@}
@end example
+An environment to create simple pictures containing lines, arrows,
+boxes, circles, and text. Note that while this environment is not
+obsolete, new documents typically use much more powerful graphics
+creation systems, such as @code{TikZ}, @code{PSTricks}, @code{MetaPost},
+or @code{Asymptote}. These are not covered in this document; see CTAN.
+
+This shows the parallelogram law for adding vectors.
+
@findex \unitlength
-The @code{picture} environment allows you to create just about any
-kind of picture you want containing text, lines, arrows and circles.
-You tell @LaTeX{} where to put things in the picture by specifying
-their coordinates. A coordinate is a number that may have a decimal
-point and a minus sign---a number like @code{5}, @code{0.3} or
-@code{-3.1416}. A coordinate specifies a length in multiples of the
-unit length @code{\unitlength}, so if @code{\unitlength} has been set
-to @code{1cm}, then the coordinate 2.54 specifies a length of 2.54
-centimeters.
-
-You should only change the value of @code{\unitlength}, using the
-@code{\setlength} command, outside of a @code{picture} environment.
-The default value is @code{1pt}.
-
-@PkgIndex{picture}
-The @code{picture} package redefine the @code{picture} environment so
-that everywhere a number is used in a @var{picture commands} to specify
-a coordinate, one can use alternatively a length. Be aware however that
-this will prevent scaling those lengths by changing @code{\unitlength}.
+@example
+\setlength@{\unitlength@}@{1cm@}
+\begin@{picture@}(6,6) % picture box will be 6cm wide by 6cm tall
+ \put(0,0)@{\vector(2,1)@{4@}@} % for every 2 over this vector goes 1 up
+ \put(2,1)@{\makebox(0,0)[l]@{\ first leg@}@}
+ \put(4,2)@{\vector(1,2)@{2@}@}
+ \put(5,4)@{\makebox(0,0)[l]@{\ second leg@}@}
+ \put(0,0)@{\line(1,1)@{6@}@}
+ \put(3,3)@{\makebox(0,0)[r]@{sum\ @}@}
+\end@{picture@}
+@end example
+You can also use this environment to place arbitrary material at an
+exact location.
-@cindex position, in picture
-A @dfn{position} is a pair of coordinates, such as @code{(2.4,-5)}, specifying
-the point with x-coordinate @code{2.4} and y-coordinate @code{-5}.
-Coordinates are specified in the usual way with respect to an origin,
-which is normally at the lower-left corner of the picture. Note that
-when a position appears as an argument, it is not enclosed in braces;
-the parentheses serve to delimit the argument.
-
-The @code{picture} environment has one mandatory argument which is a
-position (@var{width},@var{height}), which specifies the size of the
-picture. The environment produces a rectangular box with these
-@var{width} and @var{height}.
-
-The @code{picture} environment also has an optional position argument
-(@var{xoffset},@var{yoffset}), following the size argument, that can
-change the origin. (Unlike ordinary optional arguments, this argument
-is not contained in square brackets.) The optional argument gives the
-coordinates of the point at the lower-left corner of the picture
-(thereby determining the origin). For example, if @code{\unitlength}
-has been set to @code{1mm}, the command
+@example
+\usepackage@{color,graphicx@} % in preamble
+ ...
+\begin@{center@}
+\setlength@{\unitlength@}@{\textwidth@}
+\begin@{picture@}(1,1) % leave space, \textwidth wide and tall
+ \put(0,0)@{\includegraphics[width=\textwidth]@{desertedisland.jpg@}@}
+ \put(0.25,0.35)@{\textcolor@{red@}@{X Treasure here@}@}
+\end@{picture@}
+\end@{center@}
+@end example
+
+@noindent
+The red@tie{}X will be precisely a quarter of the @code{\linewidth} from
+the left margin, and @code{0.35\linewidth} up from the bottom. Another
+example of this usage is to put similar code in the page header to get
+repeat material on each of a document's pages.
+
+The @code{picture} environment has one required argument, a pair of
+numbers (@var{width},@var{height}). Multiply these by the value
+@code{\unitlength} to get the nominal size of the output, the space that
+@LaTeX{} reserves on the output page. This nominal size need not be how
+large the picture really is; @LaTeX{} will draw things from the picture
+outside the picture's box.
+
+This environment also has an optional argument
+(@var{xoffset},@var{yoffset}). It is used to shift the origin. Unlike
+most optional arguments, this one is not contained in square brackets.
+As with the required argument, it consists of two real numbers.
+Multiply these by @code{\unitlength} to get the point at the lower-left
+corner of the picture.
+
+For example, if @code{\unitlength} has been set to @code{1mm}, the
+command
@example
\begin@{picture@}(100,200)(10,20)
@end example
-@noindent produces a picture of width 100 millimeters and height 200
-millimeters, whose lower-left corner is the point (10,20) and whose
-upper-right corner is therefore the point (110,220). When you first
-draw a picture, you typically omit the optional argument, leaving the
-origin at the lower-left corner. If you then want to modify your
+@noindent
+produces a box of width 100 millimeters and height 200 millimeters. The
+picture's origin is the point (10mm,20mm) and so the lower-left corner
+is there, and the upper-right corner is at (110mm,220mm). When you
+first draw a picture you typically omit the optional argument, leaving
+the origin at the lower-left corner. If you then want to modify your
picture by shifting everything, you can just add the appropriate
optional argument.
-The environment's mandatory argument determines the nominal size of the
-picture. This need bear no relation to how large the picture really is;
-@LaTeX{} will happily allow you to put things outside the picture, or even
-off the page. The picture's nominal size is used by @LaTeX{} in determining
-how much room to leave for it.
+@cindex position, in picture
+Each @var{picture command} tells @LaTeX{} where to put something by
+naming its position. A @dfn{position} is a pair such as @code{(2.4,-5)}
+giving the x- and y-coordinates. A @dfn{coordinate} is a not a length,
+it is a real number (it may have a decimal point or a minus sign). It
+specifies a length in multiples of the unit length @code{\unitlength},
+so if @code{\unitlength} has been set to @code{1cm}, then the coordinate
+2.54 specifies a length of 2.54 centimeters.
+
+@LaTeX{}'s default for @code{\unitlength} is @code{1pt}. it is a rigid
+length (@pxref{Lengths}). Change it with the @code{\setlength} command
+(@pxref{\setlength}). Make this change only outside of a @code{picture}
+environment.
+
+Coordinates are given with respect to an origin, which is normally at
+the lower-left corner of the picture. Note that when a position appears
+as an argument, as with @code{\put(1,2)@{...@}}, it is not enclosed in
+braces since the parentheses serve to delimit the argument. Also,
+unlike in some computer graphics systems, larger y-coordinates are
+further up the page.
-Everything that appears in a picture is drawn by the @code{\put}
-command. The command
+There are four ways to put things in a picture: @code{\put},
+@code{\multiput}, @code{\qbezier}, and @code{\graphpaper}. The most
+often used is @code{\put}. This
@example
-\put (11.3,-.3)@{...@}
+\put(11.3,-0.3)@{...@}
@end example
-@noindent puts the object specified by @code{...} in the
-picture, with its reference point at coordinates @math{(11.3,-.3)}.
-The reference points for various objects will be described below.
-
-@findex lR box
-The @code{\put} command creates an @dfn{LR box}. You can put anything
-that can go in an @code{\mbox} (@pxref{\mbox}) in the text argument of
-the @code{\put} command. When you do this, the reference point will
-be the lower left corner of the box.
+@noindent
+places the object with its reference point at coordinates
+@math{(11.3,-0.3)}. The reference points for various objects will be
+described below.
+@findex LR box
+The @code{\put} command creates an @dfn{LR box} (@pxref{Modes}).
+Anything that can go in an @code{\mbox} (@pxref{\mbox & \makebox}) can
+go in the text argument of the @code{\put} command. The reference point
+will be the lower left corner of the box. In this picture
+
+@example
+\setlength@{\unitlength@}@{1cm@}
+...\begin@{picture@}(1,1)
+ \put(0,0)@{\line(1,0)@{1@}@}
+ \put(0,0)@{\line(1,1)@{1@}@}
+\end@{picture@}
+@end example
-The @code{picture} commands are described in the following sections.
+@noindent
+the three dots are just slightly left of the point of the angle formed
+by the two lines. (Also, @code{\line(1,1)@{1@}} does not call for a
+line of length one; rather the line has a change in the x coordinate of
+1.)
+
+The @code{\multiput}, @code{qbezier}, and @code{graphpaper} commands are
+described below.
+
+This draws a rectangle with a wavy top, using @code{\qbezier} for
+that curve.
+
+@example
+\begin@{picture@}(3,1.5)
+ \put(0,0)@{\vector(1,0)@{8@}@} % x axis
+ \put(0,0)@{\vector(0,1)@{4@}@} % y axis
+ \put(2,0)@{\line(0,1)@{3@}@} % left side rectangle
+ \put(4,0)@{\line(0,1)@{3.5@}@} % right side
+ \qbezier(2,3)(2.5,2.9)(3,3.25)
+ \qbezier(3,3.25)(3.5,3.6)(4,3.5)
+ \thicklines % below here, lines are twice as thick
+ \put(2,3)@{\line(4,1)@{2@}@}
+ \put(4.5,2.5)@{\framebox@{Trapezoidal Rule@}@}
+\end@{picture@}
+@end example
@menu
+* \put:: Place an object at a specified place.
+* \multiput:: Draw multiple instances of an object.
+* \qbezier:: Draw a quadratic Bezier curve.
+* \graphpaper:: Draw graph paper.
+* \line:: Draw a straight line.
+* \linethickness:: Set thickness of horizontal and vertical lines.
+* \thinlines:: The default line thickness.
+* \thicklines:: A heavier line thickness.
* \circle:: Draw a circle.
+* \oval:: Draw an oval.
+* \shortstack:: Make a stack of objects.
+* \vector:: Draw a line with an arrow.
* \makebox (picture):: Draw a box of the specified size.
* \framebox (picture):: Draw a box with a frame around it.
-* \dashbox:: Draw a dashed box.
* \frame:: Draw a frame around an object.
-* \line:: Draw a straight line.
-* \linethickness:: Set the line thickness.
-* \thicklines:: A heavier line thickness.
-* \thinlines:: The default line thickness.
-* \multiput:: Draw multiple instances of an object.
-* \oval:: Draw an ellipse.
-* \put:: Place an object at a specified place.
-* \shortstack:: Make a pile of objects.
-* \vector:: Draw a line with an arrow.
+* \dashbox:: Draw a dashed box.
@end menu
-@node \circle
-@subsection @code{\circle}
+@node \put
+@subsection @code{\put}
-@findex \circle
+@findex \put
Synopsis:
@example
-\circle[*]@{@var{diameter}@}
+\put(@var{xcoord},@var{ycoord})@{@var{content}@}
@end example
-The @code{\circle} command produces a circle with a diameter as close
-to the specified one as possible. The @code{*}-form of the command
-draws a solid circle.
+Place @var{content} at the coordinate (@var{xcoord},@var{ycoord}). See
+the discussion of coordinates and @code{\unitlength} in @ref{picture}.
+The @var{content} is processed in LR mode (@pxref{Modes}) so it cannot
+contain line breaks.
-Circles up to 40@dmn{pt} can be drawn.
+This includes the text into the @code{picture}.
+@example
+\put(4.5,2.5)@{Apply the \textit@{unpoke@} move@}
+@end example
-@node \makebox (picture)
-@subsection @code{\makebox}
+The reference point, the location (4.5,2.5), is the lower left of the
+text, at the bottom left of the @samp{A}.
-@findex \makebox @r{(for @code{picture})}
+
+@node \multiput
+@subsection @code{\multiput}
+
+@findex \multiput
Synopsis:
@example
-\makebox(@var{width},@var{height})[@var{position}]@{@var{text}@}
+\multiput(@var{x},@var{y})(@var{delta_x},@var{delta_y})@{@var{num-copies}@}@{@var{obj}@}
@end example
-The @code{\makebox} command for the picture environment is similar to
-the normal @code{\makebox} command except that you must specify a
-@var{width} and @var{height} in multiples of @code{\unitlength}.
+Copy @var{obj} a total of @var{num-copies} times, with an increment of
+@var{delta_x,delta_y}. The @var{obj} first appears at position
+@math{(x,y)}, then at @math{(x+\delta_x,y+\delta_y)}, and so on.
-The optional argument, @code{[@var{position}]}, specifies the quadrant that
-your @var{text} appears in. You may select up to two of the following:
+This draws a simple grid with every fifth line in bold (see also
+@ref{\graphpaper}).
-@table @code
-@item t
-Moves the item to the top of the rectangle.
-
-@item b
-Moves the item to the bottom.
-
-@item l
-Moves the item to the left.
+@example
+\begin@{picture@}(10,10)
+ \linethickness@{0.05mm@}
+ \multiput(0,0)(1,0)@{10@}@{\line(0,1)@{10@}@}
+ \multiput(0,0)(0,1)@{10@}@{\line(1,0)@{10@}@}
+ \linethickness@{0.5mm@}
+ \multiput(0,0)(5,0)@{3@}@{\line(0,1)@{10@}@}
+ \multiput(0,0)(0,5)@{3@}@{\line(1,0)@{10@}@}
+\end@{picture@}
+@end example
-@item r
-Moves the item to the right.
-@end table
+@node \qbezier
+@subsection @code{\qbezier}
-@xref{\makebox}.
+@findex \qbezier
+Synopsis:
-@node \framebox (picture)
-@subsection @code{\framebox}
+@example
+\qbezier(@var{x1},@var{y1})(@var{x2},@var{y2})(@var{x3},@var{y3})
+\qbezier[@var{num}](@var{x1},@var{y1})(@var{x2},@var{y2})(@var{x3},@var{y3})
+@end example
-@findex \framebox
+Draw a quadratic Bezier curve whose control points are given by the
+three required arguments @code{(@var{x1},@var{y1})},
+@code{(@var{x2},@var{y2})}, and @code{(@var{x3},@var{y3})}. That is,
+the curve runs from @var{(x1,y1)} to @var{(x3,y3)}, is quadratic, and is
+such that the tangent line at @var{(x1,y1)} passes through
+@var{(x2,y2)}, as does the tangent line at @var{(x3,y3)}.
-Synopsis:
+This draws a curve from the coordinate (1,1) to (1,0).
@example
-\framebox(@var{width},@var{height})[@var{pos}]@{...@}
+\qbezier(1,1)(1.25,0.75)(1,0)
@end example
-The @code{\framebox} command is like @code{\makebox} (see previous
-section), except that it puts a frame around the outside of the box
-that it creates.
-
-@findex \fboxrule
-@findex \fboxsep
-The @code{\framebox} command produces a rule of thickness
-@code{\fboxrule}, and leaves a space @code{\fboxsep} between the rule
-and the contents of the box.
+@noindent
+The curve's tangent line at (1,1) contains (1.25,0.75), as does the
+curve's tangent line at (1,0).
+The optional argument @var{num} gives the number of calculated
+intermediate points. The default is to draw a smooth curve whose
+maximum number of points is @code{\qbeziermax} (change this value with
+@code{\renewcommand}).
-@node \dashbox
-@subsection @code{\dashbox}
-@findex \dashbox
+@node \graphpaper
+@subsection @code{\graphpaper}
-Draws a box with a dashed line. Synopsis:
+@findex \graphpaper
+Synopsis:
@example
-\dashbox@{@var{dlen}@}(@var{rwidth},@var{rheight})[@var{pos}]@{@var{text}@}
+\graphpaper(@var{x_init},@var{y_init})(@var{x_dimen},@var{y_dimen})
+\graphpaper[@var{spacing}](@var{x_init},@var{y_init})(@var{x_dimen},@var{y_dimen})
@end example
-@code{\dashbox} creates a dashed rectangle around @var{text} in a
-@code{picture} environment. Dashes are @var{dlen} units long, and the
-rectangle has overall width @var{rwidth} and height @var{rheight}.
-The @var{text} is positioned at optional @var{pos}. @c xxref positions.
-
-A dashed box looks best when the @var{rwidth} and @var{rheight} are
-multiples of the @var{dlen}.
-
-
-@node \frame
-@subsection @code{\frame}
-
-@findex \frame
+Draw a coordinate grid. Requires the @code{graphpap} package.
+The grid's origin is @code{(@var{x_init},@var{y_init})}.
+Grid lines come every @var{spacing} units (the default is 10).
+The grid extends @var{x_dimen} units to the right and @var{y_dimen} units up.
+All arguments must be positive integers.
-Synopsis:
+This make a grid with seven vertical lines and eleven horizontal lines.
@example
-\frame@{@var{text}@}
+\usepackage@{graphpap@} % in preamble
+ ...
+\begin@{picture@}(6,20) % in document body
+ \graphpaper[2](0,0)(12,20)
+\end@{picture@}
@end example
-The @code{\frame} command puts a rectangular frame around @var{text}.
-The reference point is the bottom left corner of the frame. No extra
-space is put between the frame and the object.
+@noindent
+The lines are numbered every ten units.
@node \line
@@ -4669,18 +5840,59 @@ space is put between the frame and the object.
Synopsis:
@example
-\line(@var{xslope},@var{yslope})@{@var{length}@}
+\line(@var{x_run},@var{y_rise})@{@var{travel}@}
+@end example
+
+Draw a line. It slopes such that it vertically rises @var{y_rise} for
+every horizontal @var{x_run}. The @var{travel} is the total horizontal
+change@tie{}--- it is not the length of the vector, it is the change in
+@math{x}. In the special case of vertical lines, where
+(@var{x_run},@var{y_rise})=(0,1), the @var{travel} gives the change in
+@math{y}.
+
+This draws a line starting at coordinates (1,3).
+
+@example
+\put(1,3)@{\line(2,5)@{4@}@}
@end example
-The @code{\line} command draws a line with the given @var{length} and
-slope @var{xslope}/@var{yslope}.
+@noindent
+For every over 2, this line will go up 5. Because @var{travel}
+specifies that this goes over 4, it must go up@tie{}10. Thus its
+endpoint is @math{(1,3)+(4,10)=(5,13)}. In particular, note that
+@math{@var{travel}=4} is not the length of the line, it is the change in
+@math{x}.
+
+The arguments @var{x_run} and @var{y_rise} are integers that can be
+positive, negative, or zero. (If both are 0 then @LaTeX{} treats the
+second as 1.) With
+@code{\put(@var{x_init},@var{y_init})@{\line(@var{x_run},@var{y_rise})@{@var{travel}@}@}},
+if @var{x_run} is negative then the line's ending point has a first
+coordinate that is less than @var{x_init}. If @var{y_rise} is negative
+then the line's ending point has a second coordinate that is less than
+@var{y_init}.
+
+If @var{travel} is negative then you get @code{LaTeX Error: Bad \line or
+\vector argument.}
@cindex @code{pict2e} package
@cindex graphics packages
-Standard @LaTeX{} can only draw lines with @math{@var{slope} = x/y},
-where @math{x} and @math{y} have integer values from @minus{}6
-through@tie{}6. For lines of any slope, and plenty of other shapes,
-see @code{pict2e} and many other packages on CTAN.
+@PkgIndex{pict2e}
+@PkgIndex{TikZ}
+@PkgIndex{PSTricks}
+@PkgIndex{MetaPost}
+@PkgIndex{Asymptote}
+Standard @LaTeX{} can only draw lines with a limited range of slopes
+because these lines are made by putting together line segments from
+pre-made fonts. The two numbers @var{x_run} and @var{y_rise} must have
+integer values from @minus{}6 through@tie{}6. Also, they must be
+relatively prime, so that @var{(x_run,y_rise)} can be (2,1) but not
+(4,2) (if you choose the latter then instead of lines you get sequences
+of arrowheads; the solution is to switch to the former). To get lines
+of arbitrary slope and plenty of other shapes in a system like
+@code{picture}, see the package @file{pict2e} on CTAN. Another solution
+is to use a full-featured graphics system such as @file{TikZ}, or
+@file{PSTricks}, or @file{MetaPost}, or @file{Asymptote}
@node \linethickness
@@ -4688,12 +5900,28 @@ see @code{pict2e} and many other packages on CTAN.
@findex \linethickness
-The @code{\linethickness@{@var{dim}@}} command declares the thickness
-of horizontal and vertical lines in a picture environment to be
-@var{dim}, which must be a positive length.
+Synopsis:
+
+@example
+\linethickness@{@var{dim}@}
+@end example
+
+Declares the thickness of subsequent horizontal and vertical lines in a
+picture to be @var{dim}, which must be a positive length
+(@pxref{Lengths}). It differs from @code{\thinlines} and
+@code{\thicklines} in that it does not affect the thickness of slanted
+lines, circles, or ovals.
+
+
+@node \thinlines
+@subsection @code{\thinlines}
+
+@findex \thinlines
-@code{\linethickness} does not affect the thickness of slanted lines,
-circles, or the quarter circles drawn by @code{\oval}.
+Declaration to set the thickness of subsequent lines, circles, and ovals
+in a picture environment to be 0.4@dmn{pt}. This is the default
+thickness, so this command is unnecessary unless the thickness has been
+changed with either @ref{\linethickness} or @ref{\thicklines}.
@node \thicklines
@@ -4701,36 +5929,36 @@ circles, or the quarter circles drawn by @code{\oval}.
@findex \thicklines
-The @code{\thicklines} command is an alternate line thickness for
-horizontal and vertical lines in a picture environment;
-cf.@tie{}@ref{\linethickness} and @ref{\thinlines}.
+Declaration to set the thickness of subsequent lines, circles, and ovals
+in a picture environment to be 0.8@dmn{pt}. See also
+@ref{\linethickness} and @ref{\thinlines}. This command is illustrated
+in the Trapezoidal Rule example of @ref{picture}.
-@node \thinlines
-@subsection @code{\thinlines}
+@node \circle
+@subsection @code{\circle}
-@findex \thinlines
+@findex \circle
-The @code{\thinlines} command is the default line thickness for
-horizontal and vertical lines in a picture environment;
-cf.@tie{}@ref{\linethickness} and @ref{\thicklines}.
+Synopsis:
+@example
+\circle@{@var{diameter}@}
+\circle*@{@var{diameter}@}
+@end example
-@node \multiput
-@subsection @code{\multiput}
+Produces a circle with a diameter as close as possible to the specified
+one. The @code{*}@tie{}form produces a filled-in circle.
-@findex \multiput
-
-Synopsis:
+This draws a circle of radius 6, centered at @code{(5,7)}.
@example
-\multiput(@var{x},@var{y})(@var{delta_x},@var{delta_y})@{@var{n}@}@{@var{obj}@}
+\put(5,7)@{\circle@{6@}@}
@end example
-The @code{\multiput} command copies the object @var{obj} in a regular
-pattern across a picture. @var{obj} is first placed at position
-@math{(x,y)}, then at @math{(x+\delta x,y+\delta y)}, and so on,
-@var{n} times.
+The available radii for @code{circle} are, in points, the even
+numbers from 2 to 20, inclusive. For @code{circle*} they are all the
+integers from 1 to 15.
@node \oval
@@ -4741,46 +5969,42 @@ pattern across a picture. @var{obj} is first placed at position
Synopsis:
@example
+\oval(@var{width},@var{height})
\oval(@var{width},@var{height})[@var{portion}]
@end example
-The @code{\oval} command produces a rectangle with rounded corners. The
-optional argument @var{portion} allows you to produce only half of the
-oval via the following:
+Produce a rectangle with rounded corners. The optional argument
+@var{portion} allows you to produce only half or a quarter of the oval.
+For half an oval take @var{portion} to be one of these.
@table @code
@item t
-selects the top half;
+top half
@item b
-selects the bottom half;
+bottom half
@item r
-selects the right half;
+right half
@item l
-selects the left half.
+left half
@end table
-It is also possible to produce only one quarter of the oval by setting
-@var{portion} to @code{tr}, @code{br}, @code{bl}, or @code{tl}.
-
-The ``corners'' of the oval are made with quarter circles with a
-maximum radius of 20@dmn{pt}, so large ``ovals'' will look more like
-boxes with rounded corners.
+Produce only one quarter of the oval by setting @var{portion} to
+@code{tr}, @code{br}, @code{bl}, or @code{tl}.
-
-@node \put
-@subsection @code{\put}
-
-@findex \put
-
-Synopsis:
+This draws the top half of an oval that is 3 wide and 7 tall.
@example
-\put(@var{xcoord},@var{ycoord})@{ ... @}
+\put(5,7)@{\oval(3,7)[t]@}
@end example
-The @code{\put} command places the material specified by the
-(mandatory) argument in braces at the given coordinate,
-(@var{xcoord},@var{ycoord}).
+@noindent
+The (5,7) is the center of the entire oval, not just the center of the
+top half.
+
+These shapes are not ellipses. They are rectangles whose corners are
+made with quarter circles. These circles have a maximum radius of
+20@dmn{pt} (@pxref{\circle} for the sizes). Thus large ovals are just
+boxes with a small amount of corner rounding.
@node \shortstack
@@ -4791,23 +6015,49 @@ The @code{\put} command places the material specified by the
Synopsis:
@example
-\shortstack[@var{position}]@{...\\...\\...@}
+\shortstack[@var{position}]@{@var{line 1} \\ ... @}
+@end example
+
+Produce a vertical stack of objects.
+
+This labels the @math{y} axis.
+
+@example
+\put(0,0)@{\vector(1,0)@{4@}@} % x axis
+\put(0,0)@{\vector(0,1)@{2@}@} % y
+\put(-0.25,2)@{\makebox[0][r]@{\shortstack[r]@{$y$\\ axis@}@}@}
@end example
-The @code{\shortstack} command produces a stack of objects. The valid
-positions are:
+@noindent
+For a short stack, the reference point is the lower left of the stack.
+In the above example the @ref{\mbox & \makebox} puts the stack flush
+right in a zero width box so in total the short stack sits slightly to
+the left of the @math{y}@tie{}axis.
+
+The valid positions are:
@table @code
@item r
-Move the objects to the right of the stack.
+Make objects flush right
@item l
-Move the objects to the left of the stack
+Make objects flush left
@item c
-Move the objects to the centre of the stack (default)
+Center objects (default)
@end table
@findex \\ @r{(for @code{\shortstack} objects)}
-Objects are separated with @code{\\}.
+Separate objects into lines with @code{\\}. These stacks are short in
+that, unlike in a @code{tabular} or @code{array} environment, here the
+rows are not spaced out to be of even heights. Thus, in
+@code{\shortstack@{X\\o\\o\\X@}} the first and last rows are taller than
+the middle two. You can adjust row heights either by putting in the
+usual interline spacing with @code{\shortstack@{X\\ \strut o\\o\\X@}},
+or by hand, via an explicit zero-width box @code{\shortstack@{X \\
+\rule@{0pt@}@{12pt@} o\\o\\X@}} or by using @code{\\}'s optional
+argument @code{\shortstack@{X\\[2pt] o\\o\\X@}}.
+
+The @code{\shortstack} command is also available outside the
+@code{picture} environment.
@node \vector
@@ -4818,16 +6068,178 @@ Objects are separated with @code{\\}.
Synopsis:
@example
-\vector(@var{xslope},@var{yslope})@{@var{length}@}
+\vector(@var{x_run},@var{y_rise})@{@var{travel}@}
+@end example
+
+Draw a line ending in an arrow. The slope of that line is: it
+vertically rises @var{y_rise} for every horizontal @var{x_run}. The
+@var{travel} is the total horizontal change@tie{}--- it is not the
+length of the vector, it is the change in @math{x}. In the special case
+of vertical vectors, if (@var{x_run},@var{y_rise})=(0,1), then
+@var{travel} gives the change in @math{y}.
+
+For an example see @ref{picture}.
+
+For elaboration on @var{x_run} and @var{y_rise} see @ref{\line}. As
+there, the values of @var{x_run} and @var{y_rise} are limited. For
+@code{\vector} you must chooses integers between @minus{}4 and 4,
+inclusive. Also, the two you choose must be relatively prime. Thus,
+@code{\vector(2,1)@{4@}} is acceptable but @code{\vector(4,2)@{4@}} is
+not (if you use the latter then you get a sequence of arrowheads).
+
+
+@node \makebox (picture)
+@subsection @code{\makebox} (picture)
+
+@findex \makebox @r{(for @code{picture})}
+
+Synopsis:
+
+@example
+\makebox(@var{rec-width},@var{rec-height})@{@var{text}@}
+\makebox(@var{rec-width},@var{rec-height})[@var{position}]@{@var{text}@}
+@end example
+
+Make a box to hold @var{text}. This command fits with the
+@code{picture} environment, although you can use it outside of there,
+because @var{rec-width} and @var{rec-height} are numbers specifying
+distances in terms of the @code{\unitlength} (@pxref{picture}). This
+command is similar to the normal @code{\makebox} command (@pxref{\mbox &
+\makebox}) except here that you must specify the width and height. This
+command is fragile (@pxref{\protect}).
+
+This makes a box of length 3.5 times @code{\unitlength} and height 4
+times @code{\unitlength}.
+
+@example
+\put(1,2)@{\makebox(3.5,4)@{...@}@}
+@end example
+
+The optional argument @code{@var{position}} specifies where in the box
+the @var{text} appears. The default is to center it, both horizontally
+and vertically. To place it somewhere else, use a string with one or
+two of these letters.
+
+@table @code
+@item t
+Puts @var{text} the top of the box.
+
+@item b
+Put @var{text} at the bottom.
+
+@item l
+Put @var{text} on the left.
+
+@item r
+Put @var{text} on the right.
+
+@end table
+
+
+@node \framebox (picture)
+@subsection @code{\framebox} (picture)
+
+@findex \framebox
+
+Synopsis:
+
+@example
+\framebox(@var{rec-width},@var{rec-height})@{@var{text}@}
+\framebox(@var{rec-width},@var{rec-height})[@var{position}]@{@var{text}@}
+@end example
+
+This is the same as @ref{\makebox (picture)} except that it puts a frame
+around the outside of the box that it creates. The reference point is
+the bottom left corner of the frame. This command fits with the
+@code{picture} environment, although you can use it outside of there,
+because lengths are numbers specifying the distance in terms of the
+@code{\unitlength} (@pxref{picture}). This command is fragile
+(@pxref{\protect}).
+
+This example creates a frame 2.5@tie{}inches by 3@tie{}inches and puts
+the text in the center.
+
+@example
+\setlength@{\unitlength@}@{1in@}
+\framebox(2.5,3)@{test text@}
@end example
-The @code{\vector} command draws a line with an arrow of the specified
-length and slope. The @math{@var{xslope}} and @math{@var{yslope}}
-values must lie between @minus{}4 and +4, inclusive.
+The required arguments are that the rectangle has overall width
+@var{rect-width} units and height @var{rect-height} units.
+
+The optional argument @var{position} specifies the position of
+@var{text}; see @ref{\makebox (picture)} for the values that it can
+take.
+
+@findex \fboxrule
+@findex \fboxsep
+The rule has thickness @code{\fboxrule} and there is a blank space
+@code{\fboxsep} between the frame and the contents of the box.
+
+For this command, you must specify the @var{width} and @var{height}. If
+you want to just put a frame around some contents whose dimension is
+determined in some other way then either use @code{\fbox} (@pxref{\fbox
+& \framebox}) or @code{\frame} (@pxref{\frame}).
+
+
+@node \frame
+@subsection @code{\frame}
+
+@findex \frame
+
+Synopsis:
+
+@example
+\frame@{@var{contents}@}
+@end example
+Puts a rectangular frame around @var{contents}. The reference point is
+the bottom left corner of the frame. In contrast to @code{\framebox}
+(@pxref{\framebox (picture)}), this command puts no extra space is put
+between the frame and the object. It is fragile (@pxref{\protect}).
-@node quotation and quote
-@section @code{quotation} and @code{quote}
+
+@node \dashbox
+@subsection @code{\dashbox}
+
+@findex \dashbox
+
+Synopsis:
+
+@example
+\dashbox@{@var{dash-len}@}(@var{rect-width},@var{rect-height})@{@var{text}@}
+\dashbox@{@var{dash-len}@}(@var{rect-width},@var{rect-height})[@var{position}]@{@var{text}@}
+@end example
+
+Create a dashed rectangle around @var{text}. This command fits with the
+@code{picture} environment, although you can use it outside of there,
+because lengths are numbers specifying the distance in terms of the
+@code{\unitlength} (@pxref{picture}).
+
+The required arguments are: dashes are @var{dash-len} units long, with
+the same length gap, and the rectangle has overall width
+@var{rect-width} units and height @var{rect-height} units.
+
+The optional argument @var{position} specifies the position of
+@var{text}; see @ref{\makebox (picture)} for the values that it can
+take.
+
+This shows that you can use non-integer value for @var{dash-len}.
+
+@example
+\put(0,0)@{\dashbox@{0.1@}(5,0.5)@{My hovercraft is full of eels.@}@}
+@end example
+
+@noindent
+Each dash will be @code{0.1\unitlength} long, the box's width is
+@code{5\unitlength} and its height is @code{0.5\unitlength}.
+
+As in that example, a dashed box looks best when @var{rect-width} and
+@var{rect-height} are multiples of the @var{dash-len}.
+
+
+@node quotation & quote
+@section @code{quotation} & @code{quote}
@EnvIndex{quotation}
@cindex quoted text with paragraph indentation, displaying
@@ -4842,39 +6254,33 @@ Synopsis:
@example
\begin@{quotation@}
-@var{text}
+ @var{text}
\end@{quotation@}
@end example
+@noindent
or
@example
\begin@{quote@}
-@var{text}
+ @var{text}
\end@{quote@}
@end example
-Include a quotation.
-
-In both environments, margins are indented on both sides by
-@code{\leftmargin} and the text is justified at both. As with the main
-text, leaving a blank line produces a new paragraph.
+Include a quotation. Both environments indent margins on both sides by
+@code{\leftmargin} and the text is right-justified.
-To compare the two: in the @code{quotation} environment, paragraphs are
-indented by 1.5@dmn{em} and the space between paragraphs is small,
-@code{0pt plus 1pt}. In the @code{quote} environment, paragraphs are
-not indented and there is vertical space between paragraphs (it is the
-rubber length @code{\parsep}). Thus, the @code{quotation} environment
-may be more suitable for documents where new paragraphs are marked by an
-indent rather than by a vertical separation. In addition, @code{quote}
-may be more suitable for a short quotation or a sequence of short
-quotations.
+They differ in how they treat paragraphs. In the @code{quotation}
+environment, paragraphs are indented by 1.5@dmn{em} and the space
+between paragraphs is small, @code{0pt plus 1pt}. In the @code{quote}
+environment, paragraphs are not indented and there is vertical space
+between paragraphs (it is the rubber length @code{\parsep}).
@example
-\begin@{quotation@}
-\it Four score and seven years ago
+\begin@{quotation@} \small\it
+ Four score and seven years ago
... shall not perish from the earth.
-\hspace@{1em plus 1fill@}---Abraham Lincoln
+ \hspace@{1em plus 1fill@}---Abraham Lincoln
\end@{quotation@}
@end example
@@ -4897,10 +6303,11 @@ Synopsis:
\end@{tabbing@}
@end example
-The @code{tabbing} environment aligns text in columns. It works by
-setting tab stops and tabbing to them much as was done on a typewriter.
-It is best suited for cases where the width of each column is constant
-and known in advance.
+Align text in columns, by setting tab stops and tabbing to them much as
+was done on a typewriter. This is less often used than the environments
+@code{tabular} (@pxref{tabular}) or @code{array} (@pxref{array}) because
+in those the width of each column need not be constant and need not be
+known in advance.
This example has a first line where the tab stops are set to explicit
widths, ended by a @code{\kill} command (which is described below):
@@ -5037,7 +6444,9 @@ function \= fact(n : integer) : integer;\\
\end@{tabbing@}
@end example
-The output looks like this:
+@noindent
+The output looks like this.
+
@example
function fact(n : integer) : integer;
begin
@@ -5050,13 +6459,12 @@ function fact(n : integer) : integer;
@PkgIndex{algorithm2e} @PkgIndex{listings} @PkgIndex{minted}
@PkgIndex{fancyvrb}
-
-(The above example is just for illustration of the environment. To
-actually typeset computer code in typewriter like this, a verbatim
-environment (@pxref{verbatim}) would normally suffice. For
-pretty-printed code, there are quite a few packages, including
-@code{algorithm2e}, @code{fancyvrb}, @code{listings}, and
-@code{minted}.)
+@noindent
+This example is just for illustration of the environment. To actually
+typeset computer code in typewriter like this, a verbatim environment
+(@pxref{verbatim}) would normally be best. For pretty-printed code,
+there are quite a few packages, including @code{algorithm2e},
+@code{fancyvrb}, @code{listings}, and @code{minted}.
@node table
@@ -5070,30 +6478,50 @@ Synopsis:
@example
\begin@{table@}[@var{placement}]
- table body
-\caption[@var{loftitle}]@{@var{title}@}
-\label@{@var{label@}}
+ @var{table body}
+ \caption[@var{loftitle}]@{@var{title}@} % optional
+ \label@{@var{label@}} % also optional
\end@{table@}
@end example
-A class of floats (@pxref{Floats}). Because they cannot be split across
-pages, they are not typeset in sequence with the normal text but instead
-are ``floated'' to a convenient place, such as the top of a following
-page.
+A class of floats (@pxref{Floats}). They cannot be split across pages
+and so they are not typeset in sequence with the normal text but instead
+are floated to a convenient place, such as the top of a following page.
+
+This example @code{table} environment contains a @code{tabular}
+
+@example
+\begin@{table@}
+ \centering\small
+ \begin@{tabular@}@{ll@}
+ \multicolumn@{1@}@{c@}@{\textit@{Author@}@}
+ &\multicolumn@{1@}@{c@}@{\textit@{Piece@}@} \\ \hline
+ Bach &Cello Suite Number 1 \\
+ Beethoven &Cello Sonata Number 3 \\
+ Brahms &Cello Sonata Number 1
+ \end@{tabular@}
+ \caption@{Top cello pieces@}
+ \label@{tab:cello@}
+\end@{table@}
+@end example
+
+@noindent
+but you can put many different kinds of content in a @code{table},
+including text, @LaTeX{} commands, etc.
For the possible values of @var{placement} and their effect on the
float placement algorithm, see @ref{Floats}.
-The table body is typeset in a @code{parbox} of width @code{\textwidth}
-and so it can contain text, commands, etc.
+The table body is typeset in a @code{parbox} of width @code{\textwidth}.
+It can contain text, commands, graphics, etc.
The label is optional; it is used for cross references (@pxref{Cross
references}).
@findex \caption
-The optional @code{\caption} command specifies caption text for the
-table. By default it is numbered. If @var{lottitle} is present, it is
-used in the list of tables instead of @var{title} (@pxref{Tables of
-contents}).
+The @code{\caption} command is also optional. It specifies caption text
+for the table. By default it is numbered. If its optional
+@var{lottitle} is present then that text is used in the list of tables
+instead of @var{title} (@pxref{Table of contents etc.}).
In this example the table and caption will float to the bottom of a page,
unless it is pushed to a float page at the end.
@@ -5123,7 +6551,7 @@ Synopsis:
@example
\begin@{tabular@}[@var{pos}]@{@var{cols}@}
-column 1 entry &column 2 entry ... &column n entry \\
+ @var{column 1 entry} &@var{column 2 entry} ... &@var{column n entry} \\
...
\end@{tabular@}
@end example
@@ -5133,14 +6561,14 @@ or
@example
\begin@{tabular*@}@{@var{width}@}[@var{pos}]@{@var{cols}@}
-column 1 entry &column 2 entry ... &column n entry \\
+ @var{column 1 entry} &@var{column 2 entry} ... &@var{column n entry} \\
...
\end@{tabular*@}
@end example
-These environments produce a table, a box consisting of a sequence of
-horizontal rows. Each row consists of items that are aligned vertically
-in columns. This illustrates many of the features.
+Produce a table, a box consisting of a sequence of horizontal rows.
+Each row consists of items that are aligned vertically in columns. This
+illustrates many of the features.
@example
\begin@{tabular@}@{l|l@}
@@ -5151,27 +6579,22 @@ in columns. This illustrates many of the features.
\end@{tabular@}
@end example
-The vertical format of two left-aligned columns, with a vertical bar
-between them, is specified in @code{tabular}'s argument @code{@{l|l@}}.
+@noindent
+The output will have two left-aligned columns with a vertical bar
+between them. This is specified in @code{tabular}'s argument
+@code{@{l|l@}}.
@findex &
-Columns are separated with an ampersand @code{&}. A horizontal rule
-between two rows is created with @code{\hline}.
+Put the entries into different columns by separating them with an
+ampersand, @code{&}. The end of each row is marked with a double
+backslash, @code{\\}. Put a horizontal rule below a row, after a double
+backslash, with @code{\hline}.
@findex \\ @r{for @code{tabular}}
-The end of each row is marked with a double backslash@tie{}@code{\\}.
This @code{\\} is optional after the last row unless an @code{\hline}
command follows, to put a rule below the table.
The required and optional arguments to @code{tabular} consist of:
@table @var
-@item width
-Required for @code{tabular*}, not allowed for @code{tabular}. Specifies
-the width of the @code{tabular*} environment. The space between columns
-should be rubber, as with @code{@@@{\extracolsep@{\fill@}@}}, to allow
-the table to stretch or shrink to make the specified width, or else you
-are likely to get the @code{Underfull \hbox (badness 10000) in alignment
-...} warning.
-
@item pos
Optional. Specifies the table's vertical position. The default is to
align the table so its vertical center matches the baseline of the
@@ -5202,25 +6625,28 @@ A column of centered items.
A vertical line the full height and depth of the environment.
@item @@@{@var{text or space}@}
-This inserts @var{text or space} at this location in every row. The
-@var{text or space} material is typeset in LR mode. This text is
-fragile (@pxref{\protect}).
+Insert @var{text or space} at this location in every row. The @var{text
+or space} material is typeset in LR mode. This text is fragile
+(@pxref{\protect}).
-This specifier is optional: with no @@-expression, @LaTeX{}'s
+If between two columns there is no @@-expression then @LaTeX{}'s
@code{book}, @code{article}, and @code{report} classes will put on
-either side of each column a space of length @code{\tabcolsep}, which
-by default is @samp{6pt}. That is, by default adjacent columns are
-separated by 12pt (so @code{\tabcolsep} is misleadingly-named since it
-is not the separation between tabular columns). By implication, a
-space of 6pt also comes before the first column and after the final
-column, unless you put a @code{@@@{...@}} or @code{|} there.
+either side of each column a space of length @code{\tabcolsep}, which by
+default is 6@dmn{pt}. That is, by default adjacent columns are
+separated by 12@dmn{pt} (so @code{\tabcolsep} is misleadingly named
+since it is only half of the separation between tabular columns). In
+addition, a space of 6@dmn{pt} also comes before the first column and
+after the final column, unless you put a @code{@@@{...@}} or @code{|}
+there.
-If you override the default and use an @@-expression then you must
-insert any desired space yourself, as in @code{@@@{\hspace@{1em@}@}}.
+If you override the default and use an @@-expression then @LaTeX{} does
+not insert @code{\tabcolsep} so you must insert any desired space
+yourself, as in @code{@@@{\hspace@{1em@}@}}.
-An empty expression @code{@@@{@}} will eliminate the space, including
-the space at the start or end, as in the example below where the tabular
-lines need to lie on the left margin.
+An empty expression @code{@@@{@}} will eliminate the space. In
+particular, sometimes you want to eliminate the the space before the
+first column or after the last one, as in the example below where the
+tabular lines need to lie on the left margin.
@example
\begin@{flushleft@}
@@ -5230,8 +6656,8 @@ lines need to lie on the left margin.
\end@{flushleft@}
@end example
-This example shows text, a decimal point, between the columns, arranged
-so the numbers in the table are aligned on that decimal point.
+The next example shows text, a decimal point between the columns,
+arranged so the numbers in the table are aligned on it.
@example
\begin@{tabular@}@{r@@@{$.$@}l@}
@@ -5243,20 +6669,18 @@ so the numbers in the table are aligned on that decimal point.
@findex \extracolsep
An @code{\extracolsep@{@var{wd}@}} command in an @@-expression causes an
extra space of width @var{wd} to appear to the left of all subsequent
-columns, until countermanded by another @code{\extracolsep} command.
-Unlike ordinary intercolumn space, this extra space is not suppressed by
-an @@-expression. An @code{\extracolsep} command can be used only in an
+columns, until countermanded by another @code{\extracolsep}. Unlike
+ordinary intercolumn space, this extra space is not suppressed by an
+@@-expression. An @code{\extracolsep} command can be used only in an
@@-expression in the @code{cols} argument. Below, @LaTeX{} inserts the
right amount of intercolumn space to make the entire table 4 inches
wide.
@example
-\begin@{center@}
- \begin@{tabular*@}@{4in@}@{l@@@{\ \ldots\extracolsep@{\fill@}@}l@}
- Seven times down, eight times up
- &such is life!
- \end@{tabular*@}
-\end@{center@}
+\begin@{tabular*@}@{4in@}@{l@@@{\extracolsep@{\fill@}@}l@}
+ Seven times down, eight times up \ldots
+ &such is life!
+\end@{tabular*@}
@end example
To insert commands that are automatically executed before a given
@@ -5265,25 +6689,36 @@ specifier.
@c xx should fully explain array, tabularx, and all other base packages...
@item p@{@var{wd}@}
-Each item in the column is typeset in a parbox of width @var{wd}.
+Each item in the column is typeset in a parbox of width @var{wd}, as if
+it were the argument of a @code{\parbox[t]@{wd@}@{...@}} command.
-Note that a line break double backslash @code{\\} may not appear in the
-item, except inside an environment like @code{minipage}, @code{array},
-or @code{tabular}, or inside an explicit @code{\parbox}, or in the scope
-of a @code{\centering}, @code{\raggedright}, or @code{\raggedleft}
+A line break double backslash @code{\\} may not appear in the item,
+except inside an environment like @code{minipage}, @code{array}, or
+@code{tabular}, or inside an explicit @code{\parbox}, or in the scope of
+a @code{\centering}, @code{\raggedright}, or @code{\raggedleft}
declaration (when used in a @code{p}-column element these declarations
must appear inside braces, as with @code{@{\centering .. \\
..@}}). Otherwise @LaTeX{} will misinterpret the double backslash as
-ending the row.
+ending the row. Instead, to get a line break in there use
+@code{\newline} (@pxref{\newline}).
@item *@{@var{num}@}@{@var{cols}@}
Equivalent to @var{num} copies of @var{cols}, where @var{num} is a
-positive integer and @var{cols} is a list of specifiers. Thus
-@code{\begin@{tabular@}@{|*@{3@}@{l|r@}|@}} is equivalent to
-@code{\begin@{tabular@}@{|l|rl|rl|r|@}}. Note that @var{cols} may
-contain another @code{*}-expression.
+positive integer and @var{cols} is a list of specifiers. Thus the
+specifier @code{\begin@{tabular@}@{|*@{3@}@{l|r@}|@}} is equivalent to
+the specifier @code{\begin@{tabular@}@{|l|rl|rl|r|@}}. Note that
+@var{cols} may contain another @code{*}-expression.
@end table
+
+@item width
+Required for @code{tabular*}, not allowed for @code{tabular}. Specifies
+the width of the @code{tabular*} environment. The space between columns
+should be rubber, as with @code{@@@{\extracolsep@{\fill@}@}}, to allow
+the table to stretch or shrink to make the specified width, or else you
+are likely to get the @code{Underfull \hbox (badness 10000) in alignment
+...} warning.
+
@end table
Parameters that control formatting:
@@ -5291,21 +6726,25 @@ Parameters that control formatting:
@ftable @code
@item \arrayrulewidth
+@anchor{tabular arrayrulewidth}
A length that is the thickness of the rule created by @code{|},
@code{\hline}, and @code{\vline} in the @code{tabular} and @code{array}
environments. The default is @samp{.4pt}. Change it as in
@code{\setlength@{\arrayrulewidth@}@{0.8pt@}}.
@item \arraystretch
+@anchor{tabular arraystrech}
A factor by which the spacing between rows in the @code{tabular} and
@code{array} environments is multiplied. The default is @samp{1}, for
no scaling. Change it as @code{\renewcommand@{\arraystretch@}@{1.2@}}.
@item \doublerulesep
+@anchor{tabular doublerulesep}
A length that is the distance between the vertical rules produced by the
@code{||} specifier. The default is @samp{2pt}.
@item \tabcolsep
+@anchor{tabular tabcolsep}
A length that is half of the space between columns. The default is
@samp{6pt}. Change it with @code{\setlength}.
@@ -5346,8 +6785,9 @@ spanned by the single heading @samp{Name}.
@example
\begin@{tabular@}@{lccl@}
- \textit@{ID@} &\multicolumn@{2@}@{c@}@{\textit@{Name@}@} &\textit@{Age@} \\ \hline % row one
- 978-0-393-03701-2 &O'Brian &Patrick &55 \\ % row two
+ \textit@{ID@} &\multicolumn@{2@}@{c@}@{\textit@{Name@}@} &\textit@{Age@} \\
+ \hline
+ 978-0-393-03701-2 &O'Brian &Patrick &55 \\
...
\end@{tabular@}
@end example
@@ -5376,6 +6816,7 @@ area before it and after it. This table details the exact behavior.
\end@{tabular@}
@end example
+@noindent
Before the first entry the output will not have a vertical rule because
the @code{\multicolumn} has the @var{cols} specifier @samp{r} with no
initial vertical bar. Between entry one and entry two there will be a
@@ -5413,6 +6854,7 @@ range en-dash.
\end@{tabular@}
@end example
+@noindent
Note that although the @code{tabular} specification by default puts a
vertical rule between the first and second columns, because there is no
vertical bar in the @var{cols} of either of the first row's
@@ -5429,24 +6871,24 @@ used in an @@-expression, although its synonym vertical
bar@tie{}@code{|} is more common. This command is rarely used in the
body of a table; typically a table's vertical lines are specified in
@code{tabular}'s @var{cols} argument and overridden as needed with
-@code{\multicolumn}.
+@code{\multicolumn} (@pxref{tabular}).
-This example illustrates some pitfalls. In the first line's second
+The example below illustrates some pitfalls. In the first row's second
entry the @code{\hfill} moves the @code{\vline} to the left edge of the
cell. But that is different than putting it halfway between the two
-columns, so in that row between the first and second columns there are
-two vertical rules, with the one from the @code{@{c|cc@}} specifier
-coming before the one produced by the @code{\vline\hfill}. In contrast,
-the first line's third entry shows the usual way to put a vertical bar
-between two columns. In the second line, the @code{ghi} is the widest
-entry in its column so in the @code{\vline\hfill} the @code{\hfill} has
-no effect and the vertical line in that entry appears immediately next
-to the @code{g}, with no whitespace.
+columns, so between the first and second columns there are two vertical
+rules, with the one from the @code{@{c|cc@}} specifier coming before the
+one produced by the @code{\vline\hfill}. In contrast, the first row's
+third entry shows the usual way to put a vertical bar between two
+columns. In the second row, the @code{ghi} is the widest entry in its
+column so in the @code{\vline\hfill} the @code{\hfill} has no effect and
+the vertical line in that entry appears immediately next to the
+@code{g}, with no whitespace.
@example
\begin@{tabular@}@{c|cc@}
- x &\vline\hfill y &\multicolumn@{1@}@{|r@}@{z@} \\
- abc &def &\vline\hfill ghi
+ x &\vline\hfill y &\multicolumn@{1@}@{|r@}@{z@} \\ % row 1
+ abc &def &\vline\hfill ghi % row 2
\end@{tabular@}
@end example
@@ -5462,10 +6904,10 @@ Synopsis:
\cline@{@var{i}-@var{j}@}
@end example
-Draw a horizontal rule in an @code{array} or @code{tabular} environment
-beginning in column @var{i} and ending in column @var{j}. The
-dash@tie{}@code{-} must appear in the mandatory argument. To span a
-single column use the number twice.
+In an @code{array} or @code{tabular} environment, draw a horizontal rule
+beginning in column@tie{}@var{i} and ending in column@tie{}@var{j}. The
+dash, @code{-}, must appear in the mandatory argument. To span a single
+column use the number twice, as with @code{\cline@{2-2@}}.
This example puts two horizontal lines between the first and second
rows, one line in the first column only, and the other spanning the
@@ -5485,7 +6927,7 @@ height.
@findex \hline
-Draws a horizontal line the width of the enclosing @code{tabular} or
+Draw a horizontal line the width of the enclosing @code{tabular} or
@code{array} environment. It's most commonly used to draw a line at the
top, bottom, and between the rows of a table.
@@ -5513,44 +6955,59 @@ Synopsis:
@example
\begin@{thebibliography@}@{@var{widest-label}@}
-\bibitem[@var{label}]@{@var{cite_key@}}
-...
+ \bibitem[@var{label}]@{@var{cite_key@}}
+ ...
\end@{thebibliography@}
@end example
-The @code{thebibliography} environment produces a bibliography or
-reference list.
-
-In the @code{article} class, this reference list is labelled
-@samp{References} and the label is stored in macro @code{\refname}; in
-the @code{report} class, it is labelled @samp{Bibliography} and the
-label is stored in macro @code{\bibname}.
+Produce a bibliography or reference list. There are two ways to produce
+bibliographic lists. This environment is suitable when you have only a
+few references and can maintain the list by hand. @xref{Using BibTeX}
+for a more sophisticated approach.
-You can change the label by redefining the command @code{\refname} or
-@code{\bibname}, whichever is applicable depending on the class:
+This shows the environment with two entries.
-@itemize
-@item
-@findex \bibname
-For standard classes whose top level sectioning is @code{\chapter}
-(such as @file{book} and @file{report}), the label is in the macro
-@code{\bibname};
+@example
+This work is based on \cite@{latexdps@}.
+Together they are \cite@{latexdps, texbook@}.
+ ...
+\begin@{thebibliography@}@{9@}
+\bibitem@{latexdps@}
+ Leslie Lamport.
+ \textit@{\LaTeX@{@}: a document preparation system@}.
+ Addison-Wesley, Reading, Massachusetts, 1993.
+\bibitem@{texbook@}
+ Donald Ervin Knuth.
+ \textit@{The \TeX book@}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+\end@{thebibliography@}
+@end example
-@item
-@findex \refname
-For standard classes whose the top level sectioning is @code{\section}
-(such as @file{article}), the label is in macro @code{\refname}.
-@end itemize
+@noindent
+This styles the first reference as @samp{[1] Leslie ...}, and so that
+@code{\cite@{latexdps@}} produces the matching @samp{... based on [1]}.
+The second @code{\cite} produces @samp{[1, 2]}. You must compile the
+document twice to resolve these references.
+
+The mandatory argument @var{widest-label} is text that, when typeset, is
+as wide as the widest item label produced by the @code{\bibitem}
+commands. The tradition is to use @code{9} for bibliographies with less
+than 10 references, @code{99} for ones with less than 100, etc.
+
+The bibliographic list is headed by a title such as @samp{Bibliography}.
+To change it there are two cases. In the @file{book} and @file{report}
+classes, where the top level sectioning is @code{\chapter} and the
+default title is @samp{Bibliography}, that title is in the macro
+@code{\bibname}. For @file{article}, where the class's top level
+sectioning is @code{\section} and the default is @samp{References}, the
+title is in macro @code{\refname}. Change it by redefining the command,
+as with @code{\renewcommand@{\refname@}@{Cited references@}} after
+@code{\begin@{document@}}.
@PkgIndex{babel}
-Typically it is neither necessary nor desirable to directly redefine
-@code{\refname} or @code{\bibname}; language support packages like
-@file{babel} do this.
-
-The mandatory @var{widest-label} argument is text that, when typeset,
-is as wide as the widest item label produced by the @code{\bibitem}
-commands. It is typically given as @code{9} for bibliographies with
-less than 10 references, @code{99} for ones with less than 100, etc.
+Language support packages such as @file{babel} will automatically
+redefine @code{\refname} or @code{\bibname} to fit the selected
+language.
@menu
* \bibitem:: Specify a bibliography item.
@@ -5568,22 +7025,69 @@ less than 10 references, @code{99} for ones with less than 100, etc.
Synopsis:
@example
+\bibitem@{@var{cite_key}@}
+@end example
+
+@noindent
+or
+
+@example
\bibitem[@var{label}]@{@var{cite_key}@}
@end example
-The @code{\bibitem} command generates an entry labelled by @var{label}.
-If the @var{label} argument is missing, a number is automatically
-generated using the @code{enumi} counter. The @var{cite_key} is a
+Generate an entry labeled by @var{label}. The default is for @LaTeX{} to
+generates a number using the @code{enumi} counter. The @dfn{citation key}
@cindex citation key
-@dfn{citation key} consisting in any sequence of
-letters, numbers, and punctuation symbols not containing a comma.
+@var{cite_key} is a string of
+letters, numbers, and punctuation symbols (but not comma).
+
+@xref{thebibliography} for an example.
-This command writes an entry to the @file{.aux} file containing the
-item's @var{cite_key} and @var{label}. When the @file{.aux} file is
-read by the @code{\begin@{document@}} command, the item's @var{label} is
-associated with @code{cite_key}, causing references to @var{cite_key}
-with a @code{\cite} command (@pxref{\cite}) to produce the associated
-@var{label}.
+The optional @var{label} changes the default label from an integer to the
+given string. With this
+
+@example
+\begin@{thebibliography@}
+\bibitem[Lamport 1993]@{latexdps@}
+ Leslie Lamport.
+ \textit@{\LaTeX@{@}: a document preparation system@}.
+ Addison-Wesley, Reading, Massachusetts, 1993.
+\bibitem@{texbook@}
+ Donald Ervin Knuth.
+ \textit@{The \TeX book@}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+\end@{thebibliography@}
+@end example
+
+@noindent
+the first entry will be styled as @samp{[Lamport 1993] Leslie ...} (The
+amount of horizontal space that @LaTeX{} leaves for the label depends on
+the @var{widest-label} argument of the @code{thebibliography}
+environment; see @ref{thebibliography}.) Similarly, @code{... based on
+\cite@{latexdps@}} will produce @samp{... based on [Lamport 1994]}.
+
+If you mix @code{\bibitem} entries having a @var{label} with those that
+do not then @LaTeX{} will number the unlabelled ones sequentially. In
+the example above the @code{texbook} entry will appear as @samp{[1]
+Donald ...}, despite that it is the second entry.
+
+If you use the same @var{cite_key} twice then you get @samp{LaTeX
+Warning: There were multiply-defined labels}.
+
+Under the hood, @LaTeX{} remembers the @var{cite_key} and @var{label}
+information because @code{\bibitem} writes it to the auxiliary file
+@file{@var{filename}.aux}. For instance, the above example causes
+@code{\bibcite@{latexdps@}@{Lamport, 1993@}} and
+@code{\bibcite@{texbook@}@{1@}} to appear in that file. The @file{.aux}
+file is read by the @code{\begin@{document@}} command and then the
+information is available for @code{\cite} commands. This explains why
+you need to run @LaTeX{} twice to resolve references: once to write it
+out and once to read it in.
+
+Because of this two-pass algorithm, when you add a @code{\bibitem} or
+change its @var{cite_key} you may get @samp{LaTeX Warning: Label(s) may
+have changed. Rerun to get cross-references right}. Fix it by
+recompiling.
@node \cite
@@ -5594,17 +7098,55 @@ with a @code{\cite} command (@pxref{\cite}) to produce the associated
Synopsis:
@example
+\cite@{@var{keys}@}
+@end example
+
+@noindent
+or
+
+@example
\cite[@var{subcite}]@{@var{keys}@}
@end example
-The @var{keys} argument is a list of one or more citation keys
-(@pxref{\bibitem}), separated by commas. This command generates an
-in-text citation to the references associated with @var{keys} by entries
-in the @file{.aux} file.
+Generate as output a citation to the references associated with
+@var{keys}. The mandatory @var{keys} is a citation key, or a
+comma-separated list of citation keys (@pxref{\bibitem}).
-The text of the optional @var{subcite} argument appears after the
-citation. For example, @code{\cite[p.~314]@{knuth@}} might produce
-@samp{[Knuth, p.@tie{}314]}.
+This
+
+@example
+The ultimate source is \cite@{texbook@}.
+ ...
+\begin@{thebibliography@}
+\bibitem@{texbook@}
+ Donald Ervin Knuth.
+ \textit@{The \TeX book@}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+\end@{thebibliography@}
+@end example
+
+@noindent
+produces the output @samp{... source is [1]}.
+
+The optional argument @var{subcite} is appended to the citation. For
+example, @code{See 14.3 in \cite[p.~314]@{texbook@}} might produce
+@samp{See 14.3 in [1, p.@tie{}314]}.
+
+If @var{keys} is not in your bibliography information then you get
+@samp{LaTeX Warning: There were undefined references}, and in the output
+the citation shows as a boldface question mark between square brackets.
+There are two possible causes. If you have mistyped something, as in
+@code{\cite@{texbok@}} then you need to correct the spelling. On the
+other hand, if you have just added or modified the bibliographic
+information and so changed the @file{.aux} file (@pxref{\bibitem}) then
+the fix may be to just run @LaTeX{} again.
+
+In addition to what appears in the output, @code{\cite} writes
+information to the auxiliary file @file{@var{filename}.aux}. For
+instance, @code{\cite@{latexdps@}} writes @samp{\citation@{latexdps@}}
+to that file. This information is used by Bib@TeX{} to include in your
+reference list only those works that you have actually cited; see
+@ref{\nocite} also.
@node \nocite
@@ -5618,8 +7160,13 @@ Synopsis:
@code{\nocite@{@var{keys}@}}
@end example
-The @code{\nocite} command produces no text, but writes @var{keys},
-which is a list of one or more citation keys, to the @file{.aux} file.
+Produces no output but writes @var{keys} to the auxiliary file
+@file{@var{doc-filename}.aux}.
+
+The mandatory argument @var{keys} is a comma-separated list of one or
+more citation keys (@pxref{\bibitem}). This information is used by
+Bib@TeX{} to include these works in your reference list even though you
+have not cited them (@pxref{\cite}).
@node Using BibTeX
@@ -5631,45 +7178,69 @@ which is a list of one or more citation keys, to the @file{.aux} file.
@findex \bibliographystyle
@findex \bibliography
-If you use the Bib@TeX{} program by Oren Patashnik (highly
-recommended if you need a bibliography of more than a couple of
-titles) to maintain your bibliography, you don't use the
-@code{thebibliography} environment (@pxref{thebibliography}). Instead,
-you include the lines
+As described in @code{thebibliography} (@pxref{thebibliography}), a
+sophisticated approach to managing bibliographies is provided by the
+Bib@TeX{} program. This is only an introduction; see the full
+documentation on CTAN.
+
+With Bib@TeX{}, you don't use @code{thebibliography}
+(@pxref{thebibliography}). Instead, include these lines.
@example
\bibliographystyle@{@var{bibstyle}@}
-\bibliography@{@var{bibfile1},@var{bibfile2}@}
+\bibliography@{@var{bibfile1}, @var{bibfile2}, ...@}
@end example
-The @code{\bibliographystyle} command does not produce any output of
-its own. Rather, it defines the style in which the bibliography will
-be produced: @var{bibstyle} refers to a file
-@var{bibstyle}@file{.bst}, which defines how your citations will look.
-The standard @var{bibstyle} names distributed with Bib@TeX{} are:
+@noindent
+The @var{bibstyle} refers to a file @file{@var{bibstyle}.bst}, which
+defines how your citations will look. The standard @var{bibstyle}'s
+distributed with Bib@TeX{} are:
@table @code
@item alpha
-Sorted alphabetically. Labels are formed from name of author and year of
-publication.
+Labels are formed from name of author and year of publication.
+The bibliographic items are sorted alphabetically.
@item plain
-Sorted alphabetically. Labels are numeric.
+Labels are integers.
+Sort the bibliographic items alphabetically.
@item unsrt
Like @code{plain}, but entries are in order of citation.
@item abbrv
Like @code{plain}, but more compact labels.
@end table
-In addition, numerous other Bib@TeX{} style files exist tailored to
-the demands of various publications. See
+@noindent Many, many other Bib@TeX{} style files exist,
+tailored to the demands of various publications. See CTAN's listing
@url{http://mirror.ctan.org/biblio/bibtex/contrib}.
The @code{\bibliography} command is what actually produces the
-bibliography. The argument to @code{\bibliography} refers to files
-named @file{@var{bibfile1}.bib}, @file{@var{bibfile2}.bib}, @dots{},
-which should contain your database in
-Bib@TeX{} format. Only the entries referred to via @code{\cite} and
-@code{\nocite} will be listed in the bibliography.
+bibliography. Its argument is a comma-separated list, referring to
+files named @file{@var{bibfile1}.bib}, @file{@var{bibfile2}.bib},
+@dots{} These contain your database in Bib@TeX{} format. This shows a
+typical couple of entries in that format.
+
+@example
+@@book@{texbook,
+ title = @{The @{@{\TeX@}@}book@},
+ author = @{D.E. Knuth@},
+ isbn = @{0201134489@},
+ series = @{Computers \& typesetting@},
+ year = @{1983@},
+ publisher = @{Addison-Wesley@}
+@}
+@@book@{sexbook,
+ author = @{W.H. Masters and V.E. Johnson@},
+ title = @{Human Sexual Response@},
+ year = @{1966@},
+ publisher = @{Bantam Books@}
+@}
+@end example
+
+Only the bibliographic entries referred to via @code{\cite} and
+@code{\nocite} will be listed in the document's bibliography. Thus you
+can keep all your sources together in one file, or a small number of
+files, and rely on Bib@TeX{} to include in this document only those that
+you used.
@node theorem
@@ -5682,14 +7253,34 @@ Synopsis:
@example
\begin@{theorem@}
-@var{theorem-text}
+ @var{theorem body}
\end@{theorem@}
@end example
-The @code{theorem} environment produces ``Theorem @var{n}'' in
-boldface followed by @var{theorem-text}, where the numbering
-possibilities for @var{n} are described under @code{\newtheorem}
-(@pxref{\newtheorem}).
+Produces @samp{Theorem @var{n}} in boldface followed by @var{theorem
+body} in italics. The numbering possibilities for @var{n} are described under
+@code{\newtheorem} (@pxref{\newtheorem}).
+
+@example
+\newtheorem@{lem@}@{Lemma@} % in preamble
+\newtheorem@{thm@}@{Theorem@}
+ ...
+\begin@{lem@} % in document body
+ text of lemma
+\end@{lem@}
+
+The next result follows immediately.
+\begin@{thm@}[Gauss] % put `Gauss' in parens after theorem head
+ text of theorem
+\end@{thm@}
+@end example
+
+@PkgIndex{amsmath}
+@PkgIndex{amsthm}
+Most new documents use the packages @code{amsthm} and @code{amsmath}
+from the American Mathematical Society. Among other things these
+packages include a large number of options for theorem environments,
+such as styling options.
@node titlepage
@@ -5707,14 +7298,11 @@ Synopsis:
\end@{titlepage@}
@end example
-Create a title page, a page with no printed page number or heading. The
-following page will be numbered page one.
+Create a title page, a page with no printed page number or heading and
+with succeeding pages numbered starting with page one.
-To instead produce a standard title page without a @code{titlepage}
-environment you can use @code{\maketitle} (@pxref{\maketitle}).
-
-Notice in this example that all formatting, including vertical spacing,
-is left to the author.
+In this example all formatting, including vertical spacing, is left to
+the author.
@example
\begin@{titlepage@}
@@ -5739,6 +7327,9 @@ is left to the author.
\end@{titlepage@}
@end example
+To instead produce a standard title page without a @code{titlepage}
+environment, use @code{\maketitle} (@pxref{\maketitle}).
+
@node verbatim
@section @code{verbatim}
@@ -5758,19 +7349,48 @@ Synopsis:
\end@{verbatim@}
@end example
-The @code{verbatim} environment is a paragraph-making environment in
-which @LaTeX{} produces exactly what you type in; for instance the
-@code{\} character produces a printed @samp{\}. It turns @LaTeX{}
-into a typewriter with carriage returns and blanks having the same
-effect that they would on a typewriter.
-
-The @code{verbatim} environment uses a monospaced typewriter-like font
+A paragraph-making environment in which @LaTeX{} produces as output
+exactly what you type as input. For instance inside @var{literal-text}
+the backslash@tie{}@code{\} character does not start commands, it
+produces a printed @samp{\}, and carriage returns and blanks are taken
+literally. The output appears in a monospaced typewriter-like font
(@code{\tt}).
+@example
+\begin@{verbatim@}
+Symbol swearing: %&$#?@!.
+\end@{verbatim@}
+@end example
+
+The only restriction on @code{literal-text} is that it cannot include
+the string @code{\end@{verbatim@}}.
+
+@PkgIndex{cprotect}
+You cannot use the verbatim environment in the argument to macros, for
+instance in the argument to a @code{\section}. This is not the same as
+commands being fragile (@pxref{\protect}), instead it just cannot appear
+there. (But the @code{cprotect} package can help with this.)
+
+@PkgIndex{listings}
+@PkgIndex{minted}
+One common use of verbatim input is to typeset computer code. There are
+packages that are an improvement the @code{verbatim} environment. For
+instance, one improvement is to allow the verbatim inclusion of external
+files, or parts of those files. Such packages include @code{listings},
+and @code{minted}.
+
+@PkgIndex{fancyvrb}
+@PkgIndex{verbatimbox}
+A package that provides many more options for verbatim environments is
+@code{fancyvrb}. Another is @code{verbatimbox}.
+
+For a list of all the relevant packages, see CTAN.
+
@menu
* \verb:: The macro form of the @code{verbatim} environment.
@end menu
+
@node \verb
@subsection @code{\verb}
@@ -5780,23 +7400,63 @@ The @code{verbatim} environment uses a monospaced typewriter-like font
Synopsis:
@example
-\verb@var{char}@var{literal-text}@var{char}
-\verb*@var{char}@var{literal-text}@var{char}
+\verb @var{char} @var{literal-text} @var{char}
+\verb* @var{char} @var{literal-text} @var{char}
+@end example
+
+Typeset @var{literal-text} as it is input, including special characters
+and spaces, using the typewriter (@code{\tt}) font.
+
+This example shows two different invocations of @code{\verb}.
+
+@example
+This is \verb!literally! the biggest pumpkin ever.
+And this is the best squash, \verb+literally!+
@end example
-The @code{\verb} command typesets @var{literal-text} as it is input,
-including special characters and spaces, using the typewriter
-(@code{\tt}) font. No spaces are allowed between @code{\verb} or
-@code{\verb*} and the delimiter @var{char}, which begins and ends the
-verbatim text. The delimiter must not appear in @var{literal-text}.
+@noindent
+The first @code{\verb} has its @var{literal-text} surrounded with
+exclamation point, @code{!}. The second instead uses plus, @code{+},
+because the exclamation point is part of @code{literal-text}.
+
+The single-character delimiter @var{char} surrounds
+@var{literal-text}@tie{}--- it must be the same character before and
+after. No spaces come between @code{\verb} or @code{\verb*} and
+@var{char}, or between @var{char} and @var{literal-text}, or between
+@var{literal-text} and the second occurrence of @var{char} (the synopsis
+shows a space only to distinguish one component from the other). The
+delimiter must not appear in @var{literal-text}. The @var{literal-text}
+cannot include a line break.
@cindex visible space
-The @code{*}-form differs only in that spaces are printed with a
-``visible space'' character.
+The @code{*}-form differs only in that spaces are printed with a visible
+space character.
@tex
(Namely, {\tt\char`\ }.)
@end tex
+The output from this will include a character showing the spaces.
+
+@example
+The commands's first argument is \verb*!filename with extension! and ...
+@end example
+
+@PkgIndex{url}
+For typesetting Internet addresses, urls, the package @code{url}
+provides an option that is better than the @code{\verb} command, since
+it allows line breaks.
+
+@PkgIndex{listings}
+@PkgIndex{minted}
+For computer code there are many packages with advantages over
+@code{\verb}. One is @file{listings}, another is @file{minted}.
+
+@PkgIndex{cprotect}
+You cannot use @code{\verb} in the argument to a macro, for instance in
+the argument to a @code{\section}. It is not a question of @code{\verb}
+being fragile (@pxref{\protect}), instead it just cannot appear there.
+(But the @code{cprotect} package can help with this.)
+
@node verse
@section @code{verse}
@@ -5808,20 +7468,42 @@ Synopsis:
@example
\begin@{verse@}
-@var{line1} \\
-@var{line2} \\
-...
+ @var{line1} \\
+ @var{line2} \\
+ ...
\end@{verse@}
@end example
-The @code{verse} environment is designed for poetry, though you may find
-other uses for it.
+An environment for poetry.
+
+Here are two lines from Shakespeare's Romeo and Juliet.
+
+@example
+Then plainly know my heart's dear love is set \\
+On the fair daughter of rich Capulet.
+@end example
@findex \\ @r{for @code{verse}}
-The margins are indented on the left and the right, paragraphs are not
-indented, and the text is not justified. Separate the lines of each
-stanza with @code{\\}, and use one or more blank lines to separate the
-stanzas.
+Separate the lines of each stanza with @code{\\}, and use one or more
+blank lines to separate the stanzas.
+
+@example
+\begin@{verse@}
+\makebox[\linewidth][c]@{\textit@{Shut Not Your Doors@} ---Walt Whitman@}
+ \\[1\baselineskip]
+Shut not your doors to me proud libraries, \\
+For that which was lacking on all your well-fill'd shelves, \\
+\qquad yet needed most, I bring, \\
+Forth from the war emerging, a book I have made, \\
+The words of my book nothing, the drift of it every thing, \\
+A book separate, not link'd with the rest nor felt by the intellect, \\
+But you ye untold latencies will thrill to every page.
+\end@{verse@}
+@end example
+
+@noindent
+The output has margins indented on the left and the right, paragraphs
+are not indented, and the text is not right-justified.
@node Line breaking
@@ -5838,14 +7520,19 @@ produce a printed document, this sequence must be broken into lines
@LaTeX{} usually does the line (and page) breaking in the text body for
you but in some environments you manually force line breaks.
+A common workflow is to get a final version of the document content
+before taking a final pass through and considering line breaks (and page
+breaks). This differs from word processing, where you are formatting
+text as you input it. Putting these off until the end prevents a lot of
+fiddling with breaks that will change anyway.
+
@menu
* \\:: Start a new line.
* \obeycr & \restorecr:: Make each input line start a new output line.
* \newline:: Break the line
* \- (hyphenation):: Insert explicit hyphenation.
-* \discretionary:: Insert explicit hyphenation with control of hyphen character.
-* \fussy:: Be fussy about line breaking.
-* \sloppy:: Be sloppy about line breaking.
+* \discretionary:: Explicit control of the hyphen character.
+* \fussy & \sloppy:: Be more or less particular with line breaking.
* \hyphenation:: Tell @LaTeX{} how to hyphenate a word.
* \linebreak & \nolinebreak:: Forcing & avoiding line breaks.
@end menu
@@ -5858,41 +7545,81 @@ you but in some environments you manually force line breaks.
@cindex new line, starting
@cindex line break, forcing
-Synopsis:
+Synopsis, one of:
@example
+\\
\\[@var{morespace}]
@end example
-or
+@noindent
+or one of:
@example
+\\*
\\*[@var{morespace}]
@end example
-Start a new line. The optional argument @var{morespace} specifies extra
-vertical space to be insert before the next line. This can be a
-negative length. The text before the break is set at its normal length,
-that is, it is not stretched to fill out the line width.
-
-Explicit line breaks in the text body are unusual in @LaTeX{}. In
-particular, to start a new paragraph instead leave a blank line. This
-command is mostly used outside of the main flow of text such as in
-a @code{tabular} or @code{array} environment.
-
-Under ordinary circumstances (e.g., outside of a @code{p@{...@}} column
-in a @code{tabular} environment) the @code{\newline} command is a synonym for
-@code{\\} (@pxref{\newline}).
+End the current line. The optional argument @var{morespace} specifies
+extra vertical space to be inserted before the next line. This is a
+rubber length (@pxref{Lengths}) and can be negative. The text before
+the line break is set at its normal length, that is, it is not stretched
+to fill out the line width. This command is fragile (@pxref{\protect}).
-In addition to starting a new line, the starred form @code{\\*} tells
-@LaTeX{} not to start a new page between the two lines, by issuing a
-@code{\nobreak}.
+The starred form, @code{\\*}, tells @LaTeX{} not to start a new page
+between the two lines, by issuing a @code{\nobreak}.
@example
\title@{My story: \\[0.25in]
a tale of woe@}
@end example
+Explicit line breaks in the main text body are unusual in @LaTeX{}. In
+particular, don't start new paragraphs with @code{\\}. Instead leave a
+blank line between the two paragraphs. And don't put in a sequence of
+@code{\\}'s to make vertical space. Instead use
+@code{\vspace@{@var{length}@}}, or
+@code{\leavevmode\vspace@{@var{length}@}}, or
+@code{\vspace*@{@var{length}@}} if you want the space to not be thrown
+out at the top of a new page (@pxref{\vspace}).
+
+The @code{\\} command is mostly used outside of the main flow of text
+such as in a @code{tabular} or @code{array} environment or in an
+equation environment.
+
+The @code{\\} command is a synonym for @code{\newline}
+(@pxref{\newline}) under ordinary circumstances (an example of an
+exception is the @code{p@{...@}} column in a @code{tabular}
+environment; @pxref{tabular}).
+
+@c credit: David Carlisle https://tex.stackexchange.com/a/82666
+The @code{\\} command is a macro, and its definition changes by context
+so that its definition in normal text, a @code{center} environment, a
+@code{flushleft} environment, and a @code{tabular} are all different.
+In normal text when it forces a linebreak it is essentially a shorthand
+for @code{\newline}. It does not end horizontal mode or end the
+paragraph, it just inserts some glue and penalties so that when the
+paragraph does end a linebreak will occur at that point, with the short
+line padded with white space.
+
+You get @samp{LaTeX Error: There's no line here to end} if you use
+@code{\\} to ask for a new line, rather than to end the current line.
+An example is if you have @code{\begin@{document@}\\} or, more likely,
+something like this.
+
+@example
+\begin@{center@}
+ \begin@{minipage@}@{0.5\textwidth@}
+ \\
+ In that vertical space put your mark.
+ \end@{minipage@}
+\end@{center@}
+@end example
+
+@noindent
+Fix it by replacing the double backslash with something like
+@code{\vspace@{\baselineskip@}}.
+
@node \obeycr & \restorecr
@section @code{\obeycr} & @code{\restorecr}
@@ -5901,12 +7628,48 @@ In addition to starting a new line, the starred form @code{\\*} tells
@findex \restorecr
@cindex new line, output as input
-The @code{\obeycr} command makes a return in the input file
-(@samp{^^M}, internally) the same as @code{\\} (followed by
-@code{\relax}). So each new line in the input will also be a new line
-in the output.
+The @code{\obeycr} command makes a return in the input file (@samp{^^M},
+internally) the same as @code{\\}, followed by @code{\relax}. So each
+new line in the input will also be a new line in the output. The
+@code{\restorecr} command restores normal line-breaking behavior.
-@code{\restorecr} restores normal line-breaking behavior.
+This is not the way to show verbatim text or computer code.
+@xref{verbatim} instead.
+
+With @LaTeX{}'s usual defaults, this
+
+@example
+aaa
+bbb
+
+\obeycr
+ccc
+ddd
+ eee
+
+\restorecr
+fff
+ggg
+
+hhh
+iii
+@end example
+
+@noindent
+produces output like this.
+
+@example
+ aaa bbb
+ ccc
+ddd
+eee
+
+fff ggg
+ hhh iii
+@end example
+
+@noindent
+The indents are paragraph indents.
@node \newline
@@ -5915,14 +7678,18 @@ in the output.
@findex \newline
@cindex new line, starting (paragraph mode)
-In ordinary text this is equivalent to double-backslash (@pxref{\\}); it
-breaks a line, with no stretching of the text before it.
+In ordinary text, this ends a line in a way that does not right-justify
+the line, so the prior text is not stretched. That is, in paragraph mode
+(@pxref{Modes}), the @code{\newline} command is equivalent to
+double-backslash (@pxref{\\}). This command is fragile
+(@pxref{\protect}).
-Inside a @code{tabular} or @code{array} environment, in a column with a
-specifier producing a paragraph box, like typically @code{p@{...@}},
-@code{\newline} will insert a line break inside of the column, that is,
-it does not break the entire row. To break the entire row use @code{\\}
-or its equivalent @code{\tabularnewline}.
+However, the two commands are different inside a @code{tabular} or
+@code{array} environment. In a column with a specifier producing a
+paragraph box such as typically @code{p@{...@}}, @code{\newline} will
+insert a line end inside of the column; that is, it does not break the
+entire tabular row. To break the entire row use @code{\\} or its
+equivalent @code{\tabularnewline}.
This will print @samp{Name:} and @samp{Address:} as two lines in a
single cell of the table.
@@ -5933,6 +7700,7 @@ single cell of the table.
\end@{tabular@}
@end example
+@noindent
The @samp{Date:} will be baseline-aligned with @samp{Name:}.
@@ -5942,15 +7710,41 @@ The @samp{Date:} will be baseline-aligned with @samp{Name:}.
@findex \- @r{(hyphenation)}
@cindex hyphenation, forcing
-The @code{\-} command tells @LaTeX{} that it may hyphenate the word at
-that point. @LaTeX{} is pretty good at hyphenating, and usually finds
-most of the correct hyphenation points, while almost never using an
-incorrect one. The @code{\-} command is used for the exceptional
-cases.
+Tell @LaTeX{} that it may hyphenate the word at that point. When you
+insert @code{\-} commands in a word, the word will only be hyphenated at
+those points and not at any of the hyphenation points that @LaTeX{}
+might otherwise have chosen. This command is robust (@pxref{\protect}).
+
+@LaTeX{} is good at hyphenating and usually finds most of the correct
+hyphenation points, while almost never using an incorrect one. The
+@code{\-} command is for exceptional cases.
+
+For example, @LaTeX{} does not ordinarily hyphenate words containing a
+hyphen. Below, the long and hyphenated word means @LaTeX{} has to put
+in unacceptably large spaces to set the narrow column.
+
+@example
+\begin@{tabular@}@{rp@{1.75in@}@}
+ Isaac Asimov &The strain of
+ anti-intellectualism
+ % an\-ti-in\-tel\-lec\-tu\-al\-ism
+ has been a constant thread winding its way through our
+ political and cultural life, nurtured by
+ the false notion that democracy means that
+ `my ignorance is just as good as your knowledge'.
+\end@{tabular@}
+@end example
+
+@noindent
+Commenting out the third line and uncommenting the fourth makes a much
+better fit.
+
+The @code{\-} command only allows @LaTeX{} to break there, it does not
+require that it break there. You can insist on a split with something
+like @code{Hef-\linebreak feron}. Of course, if you later change the
+text then this forced break may look very odd, so this approach requires
+care.
-When you insert @code{\-} commands in a word, the word will only be
-hyphenated at those points and not at any of the hyphenation points
-that @LaTeX{} might otherwise have chosen.
@node \discretionary
@section @code{\discretionary} (generalized hyphenation point)
@@ -5960,34 +7754,86 @@ that @LaTeX{} might otherwise have chosen.
Synopsis:
@example
-\discretionary@{@var{pre-break-text}@}@{@var{post-break-text}@}@{@var{no-break-text}@}
+\discretionary@{@var{pre-break}@}@{@var{post-break}@}@{@var{no-break}@}
@end example
-@c xxx TODO, complete this node, see LaTeX-fr
+Handle word changes around hyphens. This command is not often used in
+@LaTeX{} documents.
-@node \fussy
-@section @code{\fussy}
+If a line break occurs at the point where @code{\discretionary} appears
+then @TeX{} puts @var{pre-break} at the end of the current line and puts
+@var{post-break} at the start of the next line. If there is no line
+break here then @TeX{} puts @var{no-break}
-@findex \fussy
+In @samp{difficult} the three letters @code{ffi} form a ligature. But
+@TeX{} can nonetheless break between the two f's with this.
-The declaration @code{\fussy} (which is the default) makes @TeX{}
-picky about line breaking. This usually avoids too much space between
-words, at the cost of an occasional overfull box.
+@example
+di\discretionary@{f-@}@{fi@}@{ffi@}cult
+@end example
-This command cancels the effect of a previous @code{\sloppy} command
-(@pxref{\sloppy}).
+Note that users do not have to do this. It is typically handled
+automatically by @TeX{}'s hyphenation algorithm.
-@node \sloppy
-@section @code{\sloppy}
+@node \fussy & \sloppy
+@section @code{\fussy} & @code{\sloppy}
+@findex \fussy
@findex \sloppy
+@cindex line breaks, changing
+
+Declarations to make @TeX{} more picky or less picky about line
+breaking. Declaring @code{\fussy} usually avoids too much space between
+words, at the cost of an occasional overfull box. Conversely,
+@code{\sloppy} avoids overfull boxes while suffering loose interword
+spacing.
+
+The default is @code{\fussy}. Line breaking in a paragraph is
+controlled by whichever declaration is current at the blank line, or
+@code{\par}, or displayed equation ending that paragraph. So to affect
+the line breaks, include that paragraph-ending material in the scope of
+the command.
+
+@menu
+* sloppypar:: Environment version of \sloppy command.
+@end menu
+
+
+@node sloppypar
+@subsection @code{sloppypar}
-The declaration @code{\sloppy} makes @TeX{} less fussy about line
-breaking. This will avoid overfull boxes, at the cost of loose
-interword spacing.
+@findex sloppypar
+@cindex sloppypar environment
-Lasts until a @code{\fussy} command is issued (@pxref{\fussy}).
+Synopsis:
+
+@example
+\begin@{sloppypar@}
+ ... paragraphs ...
+\end@{sloppypar@}
+@end example
+
+Typeset the paragraphs with @code{\sloppy} in effect (@pxref{\fussy &
+\sloppy}). Use this to locally adjust line breaking, to avoid
+@samp{Overfull box} or @samp{Underfull box} errors.
+
+The example is simple.
+
+@example
+\begin@{sloppypar@}
+ Her plan for the morning thus settled, she sat quietly down to her
+ book after breakfast, resolving to remain in the same place and the
+ same employment till the clock struck one; and from habitude very
+ little incommoded by the remarks and ejaculations of Mrs.\ Allen,
+ whose vacancy of mind and incapacity for thinking were such, that
+ as she never talked a great deal, so she could never be entirely
+ silent; and, therefore, while she sat at her work, if she lost her
+ needle or broke her thread, if she heard a carriage in the street,
+ or saw a speck upon her gown, she must observe it aloud, whether
+ there were anyone at leisure to answer her or not.
+\end@{sloppypar@}
+@end example
@node \hyphenation
@@ -5999,20 +7845,22 @@ Lasts until a @code{\fussy} command is issued (@pxref{\fussy}).
Synopsis:
@example
-\hyphenation@{@var{word-one} @var{word-two}@}
+\hyphenation@{@var{word1} ...@}
@end example
-The @code{\hyphenation} command declares allowed hyphenation points
-with a @code{-} character in the given words. The words are separated
-by spaces. @TeX{} will only hyphenate if the word matches exactly, no
-inflections are tried. Multiple @code{\hyphenation} commands
-accumulate. Some examples (the default @TeX{} hyphenation patterns
-misses the hyphenations in these words):
+Declares allowed hyphenation points within the words in the list. The
+words in that list are separated by spaces. Show permitted points for
+hyphenation with a dash character, @code{-}.
+
+Here is an example:
@example
-\hyphenation@{ap-pen-dix col-umns data-base data-bases@}
+\hyphenation@{hat-er il-lit-e-ra-ti tru-th-i-ness@}
@end example
+Use lowercase letters. @TeX{} will only hyphenate if the word matches
+exactly. Multiple @code{\hyphenation} commands accumulate.
+
@node \linebreak & \nolinebreak
@section @code{\linebreak} & @code{\nolinebreak}
@@ -6022,21 +7870,42 @@ misses the hyphenations in these words):
@cindex line breaks, forcing
@cindex line breaks, preventing
-Synopses:
+Synopses, one of:
@example
-\linebreak[@var{priority}]
-\nolinebreak[@var{priority}]
+\linebreak
+\linebreak[@var{zero-to-four}]
@end example
-By default, the @code{\linebreak} (@code{\nolinebreak}) command forces
-(prevents) a line break at the current position. For
-@code{\linebreak}, the spaces in the line are stretched out so that it
-extends to the right margin as usual.
+@noindent
+or one of these.
+
+@example
+\nolinebreak
+\nolinebreak[@var{zero-to-four}]
+@end example
+
+Encourage or discourage a line break. The optional @var{zero-to-four}
+is an integer that allows you to soften the instruction. The default is
+4, so that without the optional argument these commands entirely force
+or prevent the break. But for instance, @code{\nolinebreak[1]} is a
+suggestion that another place may be better. The higher the number, the
+more insistent the request. Both commands are fragile
+(@pxref{\protect}).
+
+Here we tell @LaTeX{} that a good place to put a linebreak is after the
+standard legal text.
+
+@example
+\boilerplatelegal@{@} \linebreak[2]
+We especially encourage applications from members of traditionally
+underrepresented groups.
+@end example
+
+When you issue @code{\linebreak}, the spaces in the line are stretched
+out so that it extends to the right margin. @xref{\\}
+and@tie{}@ref{\newline} to have the spaces not stretched out.
-With the optional argument @var{priority}, you can convert the command
-from a demand to a request. The @var{priority} must be a number from
-0 to@tie{}4. The higher the number, the more insistent the request.
@node Page breaking
@@ -6045,42 +7914,100 @@ from a demand to a request. The @var{priority} must be a number from
@cindex page breaking
@cindex breaking pages
-@LaTeX{} starts new pages asynchronously, when enough material has
-accumulated to fill up a page. Usually this happens automatically,
-but sometimes you may want to influence the breaks.
+Ordinarily @LaTeX{} automatically takes care of breaking output into
+pages with its usual aplomb. But if you are writing commands, or
+tweaking the final version of a document, then you may need to
+understand how to influence its actions.
+
+@c credit: H Vogt https://tex.stackexchange.com/a/115563
+@LaTeX{}'s algorithm for splitting a document into pages is more complex
+than just waiting until there is enough material to fill a page and
+outputting the result. Instead, @LaTeX{} typesets more material than
+would fit on the page and then chooses a break that is optimal in some
+way (it has the smallest badness). An example of the advantage of this
+approach is that if the page has some vertical space that can be
+stretched or shrunk, such as with rubber lengths between paragraphs,
+then @LaTeX{} can use that to avoid widow lines (where a new page starts
+with the last line of a paragraph; @LaTeX{} can squeeze the extra line
+onto the first page) and orphans (where the first line of paragraph is
+at the end of a page; @LaTeX{} can stretch the material of the first
+page so the extra line falls on the second page). Another example is
+where @LaTeX{} uses available vertical shrinkage to fit on a page not
+just the header for a new section but also the first two lines of that
+section.
+
+But @LaTeX{} does not optimize over the entire document's set of page
+breaks. So it can happen that the first page break is great but the
+second one is lousy; to break the current page @LaTeX{} doesn't look as
+far ahead as the next page break. So occasionally you may want to
+influence page breaks while preparing a final version of a document.
+
+@xref{Layout} for more material that is relevant to page breaking.
@menu
-* \cleardoublepage:: Start a new right-hand page.
-* \clearpage:: Start a new page.
-* \newpage:: Start a new page.
-* \enlargethispage:: Enlarge the current page a bit.
-* \pagebreak & \nopagebreak:: Forcing & avoiding page breaks.
+* \clearpage & \cleardoublepage:: Start a new page; eject floats.
+* \newpage:: Start a new page.
+* \enlargethispage:: Enlarge the current page a bit.
+* \pagebreak & \nopagebreak:: Forcing & avoiding page breaks.
@end menu
-@node \cleardoublepage
-@section @code{\cleardoublepage}
+@node \clearpage & \cleardoublepage
+@section @code{\clearpage} & @code{\cleardoublepage}
+@findex \clearpage
+@cindex flushing floats and starting a page
+@cindex starting a new page and clearing floats
@findex \cleardoublepage
@cindex starting on a right-hand page
-The @code{\cleardoublepage} command ends the current page and causes all
-the pending floating figures and tables that have so far appeared in the
-input to be printed. In a two-sided printing style, it also makes the
-next page a right-hand (odd-numbered) page, producing a blank page if
-necessary.
+Synopsis:
+@example
+\clearpage
+@end example
-@node \clearpage
-@section @code{\clearpage}
+@noindent
+or
-@findex \clearpage
-@cindex flushing floats and starting a page
-@cindex starting a new page and clearing floats
+@example
+\cleardoublepage
+@end example
+
+End the current page and output all of the pending floating figures and
+tables (@pxref{Floats}). If there are too many floats to fit on the
+page then @LaTeX{} will put in extra pages containing only floats. In
+two-sided printing, @code{\cleardoublepage} also makes the next page of
+content a right-hand page, an odd-numbered page, if necessary inserting
+a blank page. The @code{\clearpage} command is robust while
+@code{\cleardoublepage} is fragile (@pxref{\protect}).
+
+@LaTeX{}'s page breaks are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+
+@c credit: https://www.tex.ac.uk/FAQ-reallyblank.html
+The @code{\cleardoublepage} command will put in a blank page, but it
+will have the running headers and footers. To get a really blank
+page, use this command.
+
+@example
+\let\origdoublepage\cleardoublepage
+\newcommand@{\clearemptydoublepage@}@{%
+ \clearpage
+ @{\pagestyle@{empty@}\origdoublepage@}%
+@}
+@end example
+
+@noindent
+If you want @LaTeX{}'s standard @code{\chapter} command to do this then
+add the line @code{\let\cleardoublepage\clearemptydoublepage}.
+
+The command @code{\newpage} (@pxref{\newpage}) also ends the current
+page, but without clearing pending floats. And, if @LaTeX{} is in
+two-column mode then @code{\newpage} ends the current column while
+@code{\clearpage} and @code{\cleardoublepage} end the current page.
-The @code{\clearpage} command ends the current page and causes all the
-pending floating figures and tables that have so far appeared in the
-input to be printed.
@node \newpage
@@ -6090,8 +8017,41 @@ input to be printed.
@cindex new page, starting
@cindex starting a new page
-The @code{\newpage} command ends the current page, but does not clear
-floats (@pxref{\clearpage}).
+Synopsis:
+
+@example
+\newpage
+@end example
+
+End the current page. This command is robust (@pxref{\protect}).
+
+@LaTeX{}'s page breaks are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+
+While the commands @code{\clearpage} and @code{\cleardoublepage} also
+end the current page, in addition they clear pending floats
+(@pxref{\clearpage & \cleardoublepage}). And, if @LaTeX{} is in
+two-column mode then @code{\clearpage} and @code{\cleardoublepage} end
+the current page, possibly leaving an empty column, while
+@code{\newpage} only ends the current column.
+
+In contrast with @code{\pagebreak} (@pxref{\pagebreak & \nopagebreak}),
+the @code{\newpage} command will cause the new page to start right where
+requested. This
+
+@example
+Four score and seven years ago our fathers brought forth on this
+continent,
+\newpage
+\noindent a new nation, conceived in Liberty, and dedicated to the
+proposition that all men are created equal.
+@end example
+
+@noindent
+makes a new page start after @samp{continent,} and the cut-off line is
+not right justified. In addition, @code{\newpage} does not vertically
+stretch out the page, as @code{\pagebreak} does.
@node \enlargethispage
@@ -6100,17 +8060,31 @@ floats (@pxref{\clearpage}).
@findex \enlargethispage
@cindex enlarge current page
-@code{\enlargethispage@{size@}}
+Synopsis, one of:
+
+@example
+\enlargethispage@{size@}
+\enlargethispage*@{size@}
+@end example
+
+Enlarge the @code{\textheight} for the current page. The required
+argument @var{size} must be a rigid length (@pxref{Lengths}). It may be
+positive or negative. This command is fragile (@pxref{\protect}).
-@code{\enlargethispage*@{size@}}
+A common strategy is to wait until you have the final text of a
+document, and then pass through it tweaking line and page breaks. This
+command allows you some page size leeway.
-Enlarge the @code{\textheight} for the current page by the specified
-amount; e.g., @code{\enlargethispage@{\baselineskip@}} will allow one
-additional line.
+This will allow one extra line on the current page.
-The starred form tries to squeeze the material together on the page as
-much as possible. This is normally used together with an explicit
-@code{\pagebreak}.
+@example
+\enlargethispage@{\baselineskip@}
+@end example
+
+The starred form @code{\enlargesthispage*} tries to squeeze the material
+together on the page as much as possible, for the common use case of
+getting one more line on the page. This is often used together with an
+explicit @code{\pagebreak}.
@node \pagebreak & \nopagebreak
@@ -6124,19 +8098,50 @@ much as possible. This is normally used together with an explicit
Synopses:
@example
-\pagebreak[@var{priority}]
-\nopagebreak[@var{priority}]
+\pagebreak
+\pagebreak[@var{zero-to-four}]
@end example
-By default, the @code{\pagebreak} (@code{\nopagebreak}) command forces
-(prevents) a page break at the current position. With
-@code{\pagebreak}, the vertical space on the page is stretched out
-where possible so that it extends to the normal bottom margin.
+@noindent
+or
-With the optional argument @var{priority}, you can convert the
-@code{\pagebreak} command from a demand to a request. The number must
-be a number from 0 to@tie{}4. The higher the number, the more
-insistent the request is.
+@example
+\nopagebreak
+\nopagebreak[@var{zero-to-four}]
+@end example
+
+Encourage or discourage a page break. The optional @var{zero-to-four}
+is an integer that allows you to soften the request. The default is 4,
+so that without the optional argument these commands entirely force or
+prevent the break. But for instance @code{\nopagebreak[1]} suggests to
+@LaTeX{} that another spot might be preferable. The higher the number,
+the more insistent the request. Both commands are fragile
+(@pxref{\protect}).
+
+@LaTeX{}'s page endings are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+
+If you use these inside a paragraph, they apply to the point following
+the line in which they appear. So this
+
+@example
+Four score and seven years ago our fathers brought forth on this
+continent,
+\pagebreak
+a new nation, conceived in Liberty, and dedicated to the proposition
+that all men are created equal.
+@end example
+
+@noindent
+does not give a page break at @samp{continent,} but instead at
+@samp{nation,} since that is where @LaTeX{} breaks that line. In
+addition, with @code{\pagebreak} the vertical space on the page is
+stretched out where possible so that it extends to the normal bottom
+margin. This can look strange, and if @code{\flushbottom} is in effect
+this can cause you to get @samp{Underfull \vbox (badness 10000) has
+occurred while \output is active}. @xref{\newpage} for a command that
+does not have these effects.
@node Footnotes
@@ -6144,33 +8149,32 @@ insistent the request is.
@cindex footnotes, creating
-Place a numbered footnote at the bottom of the current page, as here.
+Place a footnote at the bottom of the current page, as here.
@example
No@"{e}l Coward quipped that having to read a footnote is like having
to go downstairs to answer the door, while in the midst of making
-love.\footnote@{I wouldn't know, I don't read footnotes.@}
+love.\footnote@{%
+ I wouldn't know, I don't read footnotes.@}
@end example
-You can place multiple footnotes on a page. If the text becomes too long
-it will flow to the next page.
+You can put multiple footnotes on a page. If the footnote text becomes
+too long then it will flow to the next page.
You can also produce footnotes by combining the @code{\footnotemark} and
the @code{\footnotetext} commands, which is useful in special
circumstances.
To make bibliographic references come out as footnotes you need to
-include a bibliographic style with that behavior.
+include a bibliographic style with that behavior (@pxref{Using BibTeX}).
@menu
* \footnote:: Insert a footnote.
* \footnotemark:: Insert footnote mark only.
* \footnotetext:: Insert footnote text only.
-* Footnotes in a table:: Table footnotes.
* Footnotes in section headings:: Chapter or section titles.
+* Footnotes in a table:: Table footnotes.
* Footnotes of footnotes:: Multiple classes of footnotes.
-* Multiple reference to footnotes:: Referring to a footnote more than once.
-* Footnote parameters:: Parameters for footnote formatting.
@end menu
@@ -6179,51 +8183,87 @@ include a bibliographic style with that behavior.
@findex \footnote
-Synopsis:
+Synopsis, one of:
@example
+\footnote@{@var{text}@}
\footnote[@var{number}]@{@var{text}@}
@end example
-Place a numbered footnote @var{text} at the bottom of the current page.
+Place a footnote @var{text} at the bottom of the current page.
@example
There are over a thousand footnotes in Gibbon's
-\textit@{Decline and Fall of the Roman Empire@}.\footnote@{After
-reading an early version with endnotes David Hume complained,
-``One is also plagued with his Notes, according to the present Method
-of printing the Book'' and suggested that they ``only to be printed
-at the Margin or the Bottom of the Page.''@}
+\textit@{Decline and Fall of the Roman Empire@}.\footnote@{%
+ After reading an early version with endnotes David Hume complained,
+ ``One is also plagued with his Notes, according to the present Method
+ of printing the Book'' and suggested that they ``only to be printed
+ at the Margin or the Bottom of the Page.''@}
@end example
-The optional argument @var{number} allows you to specify the footnote
-number. If you use this option then the footnote number counter is not
-incremented, and if you do not use it then the counter is incremented.
+The optional argument @var{number} allows you to specify the number of
+the footnote. If you use this then @LaTeX{} does not increment the
+@code{footnote} counter.
@cindex footnotes, symbols instead of numbers
@findex \fnsymbol@r{, and footnotes}
@findex \@@fnsymbol
-Change how @LaTeX{} shows the footnote counter with something like
+By default, @LaTeX{} uses arabic numbers as footnote markers. Change
+this with something like
@code{\renewcommand@{\thefootnote@}@{\fnsymbol@{footnote@}@}}, which
uses a sequence of symbols (@pxref{\alph \Alph \arabic \roman \Roman
\fnsymbol}). To make this change global put that in the preamble. If
you make the change local then you may want to reset the counter with
-@code{\setcounter@{footnote@}@{0@}}. By default @LaTeX{} uses arabic
-numbers.
+@code{\setcounter@{footnote@}@{0@}}.
+
+@LaTeX{} determines the spacing of footnotes with two parameters.
+
+@cindex footnote parameters
+@cindex parameters, for footnotes
+
+@ftable @code
+@item \footnoterule
+@anchor{footnote footnoterule}
+Produces the rule separating the main text on a page from the page's
+footnotes. Default dimensions in the standard document classes (except
+@code{slides}, where it does not appear) is: vertical thickness of
+@code{0.4pt}, and horizontal size of @code{0.4\columnwidth} long.
+Change the rule with something like this.
+
+@c Credit egreg: https://tex.stackexchange.com/a/21917
+@example
+\renewcommand@{\footnoterule@}@{% Kerns avoid vertical space
+ \kern -3pt % This -3 is negative
+ \hrule width \textwidth height 1pt % of the sum of this 1
+ \kern 2pt@} % and this 2
+@end example
+
+@item \footnotesep
+@anchor{footnote footnotesep}
+The height of the strut placed at the beginning of the footnote
+(@pxref{\strut}). By default, this is set to the normal strut for
+@code{\footnotesize} fonts (@pxref{Font sizes}), therefore there is no
+extra space between footnotes. This is @samp{6.65pt} for @samp{10pt},
+@samp{7.7pt} for @samp{11pt}, and @samp{8.4pt} for @samp{12pt}. Change
+it as with @code{\setlength@{\footnotesep@}@{11pt@}}.
+
+@end ftable
+
+The @code{\footnote} command is fragile (@pxref{\protect}).
@LaTeX{}'s default puts many restrictions on where you can use a
@code{\footnote}; for instance, you cannot use it in an argument to a
sectioning command such as @code{\chapter} (it can only be used in outer
-paragraph mode). There are some workarounds; see following sections.
-@c xx mention packages that fix this
+paragraph mode; @pxref{Modes}). There are some workarounds; see
+following sections.
@cindex Footnotes, in a minipage
@cindex mpfootnote counter
-In a @code{minipage} environment the @code{\footnote}
-command uses the @code{mpfootnote} counter instead of the
-@code{footnote} counter, so they are numbered independently. They are
-shown at the bottom of the environment, not at the bottom of the page.
-And by default they are shown alphabetically. @xref{minipage}.
+In a @code{minipage} environment the @code{\footnote} command uses the
+@code{mpfootnote} counter instead of the @code{footnote} counter, so
+they are numbered independently. They are shown at the bottom of the
+environment, not at the bottom of the page. And by default they are
+shown alphabetically. @xref{minipage} and @ref{Footnotes in a table}.
@node \footnotemark
@@ -6238,14 +8278,27 @@ Synopsis, one of:
\footnotemark[@var{number}]
@end example
-Put the current footnote number in the
-text. (See@tie{}@ref{\footnotetext} for giving the text of the footnote
-separately.) The version with the optional argument @var{number} uses
-that number to determine the mark printed. This command can be used in
-inner paragraph mode.
+Put the current footnote mark in the text. To specify associated text
+for the footnote see@tie{}@ref{\footnotetext}. The optional argument
+@var{number} causes the command to use that number to determine the
+footnote mark. This command can be used in inner paragraph mode
+(@pxref{Modes}).
-This example gives the same institutional affiliation to both the first
-and third authors (@code{\thanks} is a version of @code{footnote}).
+If you use @code{\footnotemark} without the optional argument then it
+increments the footnote counter but if you use the optional @var{number}
+then it does not. The next example produces several consecutive footnote
+markers referring to the same footnote.
+
+@example
+The first theorem\footnote@{Due to Gauss.@}
+and the second theorem\footnotemark[\value@{footnote@}]
+and the third theorem.\footnotemark[\value@{footnote@}]
+@end example
+
+If there are intervening footnotes then you must remember the value of the
+common mark. This example gives the same institutional affiliation to
+both the first and third authors (@code{\thanks} is a version of
+@code{footnote}), by-hand giving the number of the footnote.
@example
\title@{A Treatise on the Binomial Theorem@}
@@ -6256,17 +8309,36 @@ and third authors (@code{\thanks} is a version of @code{footnote}).
\maketitle
@end example
-If you use @code{\footnotemark} without the optional argument then it
-increments the footnote counter but if you use the optional @var{number}
-then it does not. This produces several consecutive footnote markers
-referring to the same footnote.
+This uses a counter to remember the footnote number. The third sentence
+is followed by the same footnote marker as the first.
@example
-The first theorem\footnote@{Due to Gauss.@}
-and the second theorem\footnotemark[\value@{footnote@}]
-and the third theorem.\footnotemark[\value@{footnote@}]
+\newcounter@{footnoteValueSaver@}
+All babies are illogical.\footnote@{%
+ Lewis Carroll.@}\setcounter@{footnoteValueSaver@}@{\value@{footnote@}@}
+Nobody is despised who can manage a crocodile.\footnote@{%
+ Captain Hook.@}
+Illogical persons are despised.\footnotemark[\value@{footnoteValueSaver@}]
+Therefore, anyone who can manage a crocodile is not a baby.
@end example
+@PkgIndex{cleveref}
+@PkgIndex{hyperref}
+This example accomplishes the same by using the package @file{cleveref}.
+
+@c from SE user Jake http://tex.stackexchange.com/a/10116/339
+@example
+\usepackage@{cleveref@}[2012/02/15] % in preamble
+\crefformat@{footnote@}@{#2\footnotemark[#1]#3@}
+...
+The theorem is from Evers.\footnote@{\label@{fn:TE@}Tinker, Evers, 1994.@}
+The corollary is from Chance.\footnote@{Evers, Chance, 1990.@}
+But the key lemma is from Tinker.\cref@{fn:TE@}
+@end example
+
+@PkgIndex{hyperref}
+It will work with the package @file{hyperref}.
+
@node \footnotetext
@section @code{\footnotetext}
@@ -6280,166 +8352,146 @@ Synopsis, one of:
\footnotetext[@var{number}]@{@var{text}@}
@end example
-Place @var{text} at the bottom of the page as a footnote. This command
-can come anywhere after the @code{\footnotemark} command. The optional
-argument @var{number} changes the displayed footnote number. The
-@code{\footnotetext} command must appear in outer paragraph mode.
+Place @var{text} at the bottom of the page as a footnote. It pairs with
+@code{\footnotemark} (@pxref{\footnotemark}) and can come anywhere after
+that command, but must appear in outer paragraph mode (@pxref{Modes}).
+The optional argument @var{number} changes the number of the footnote
+mark.
+
+@xref{\footnotemark} and@tie{}@ref{Footnotes in a table} for usage
+examples.
+
+
+@node Footnotes in section headings
+@section Footnotes in section headings
+
+@cindex footnote, in section headings
+@cindex table of contents, avoiding footnotes
+
+Putting a footnote in a section heading, as in:
+
+@example
+\section@{Full sets\protect\footnote@{This material due to ...@}@}
+@end example
+
+@noindent
+causes the footnote to appear at the bottom of the page where the
+section starts, as usual, but also at the bottom of the table of
+contents, where it is not likely to be desired. The simplest way
+to have it not appear on the table of contents is to use the optional
+argument to @code{\section}
+
+@example
+\section[Please]@{Please\footnote@{%
+ Don't footnote in chapter and section headers!@}@}
+@end example
+
+@noindent
+No @code{\protect} is needed in front of @code{\footnote} here because
+what gets moved to the table of contents is the optional argument.
@node Footnotes in a table
@section Footnotes in a table
-@cindex Footnotes, in a table
+@cindex footnote, in a table
-Inside a @code{table} environment the @code{\footnote} command does not
-work. For instance, if the code below appears on its own then the
-footnote simply disappears; there is a footnote mark in the table cell
-but nothing is set at the bottom of the page.
+Inside a @code{tabular} or @code{array} environment the @code{\footnote}
+command does not work; there is a footnote mark in the table cell but
+the footnote text does not appear. The solution is to use a
+@code{minipage} environment as here (@pxref{minipage}).
@example
\begin@{center@}
+ \begin@{minipage@}@{\textwidth@} \centering
\begin@{tabular@}@{l|l@}
- \textsc@{Ship@} &\textsc@{Book@} \\ \hline
- \textit@{HMS Sophie@} &Master and Commander \\
- \textit@{HMS Polychrest@} &Post Captain \\
- \textit@{HMS Lively@} &Post Captain \\
- \textit@{HMS Surprise@} &A number of books\footnote@{Starting with
- HMS Surprise.@}
+ \textsc@{Ship@} &\textsc@{Book@} \\ \hline
+ \textit@{HMS Sophie@} &Master and Commander \\
+ \textit@{HMS Polychrest@} &Post Captain \\
+ \textit@{HMS Lively@} &Post Captain \\
+ \textit@{HMS Surprise@} &A number of books\footnote@{%
+ Starting with HMS Surprise.@}
\end@{tabular@}
+ \end@{minipage@}
\end@{center@}
@end example
-The solution is to surround the @code{tabular} environment with a
-@code{minipage} environment, as here (@pxref{minipage}).
+Inside a @code{minipage}, footnote marks are lowercase letters. Change
+that with something like
+@code{\renewcommand@{\thempfootnote@}@{\arabic@{mpfootnote@}@}}
+(@pxref{\alph \Alph \arabic \roman \Roman \fnsymbol}).
+
+The footnotes in the prior example appear at the bottom of the
+@code{minipage}. To have them appear at the bottom of the main page, as
+part of the regular footnote sequence, use the @code{\footnotemark} and
+@code{\footnotetext} pair and make a new counter.
@example
+\newcounter@{mpFootnoteValueSaver@}
\begin@{center@}
- \begin@{minipage@}@{.5\textwidth@}
- ... tabular material ...
- \end@{minipage@}
+ \begin@{minipage@}@{\textwidth@}
+ \setcounter@{mpFootnoteValueSaver@}@{\value@{footnote@}@} \centering
+ \begin@{tabular@}@{l|l@}
+ \textsc@{Woman@} &\textsc@{Relationship@} \\ \hline
+ Mona &Attached\footnotemark \\
+ Diana Villiers &Eventual wife \\
+ Christine Hatherleigh Wood &Fiance\footnotemark
+ \end@{tabular@}
+ \end@{minipage@}% percent sign keeps footnote text close to minipage
+ \stepcounter@{mpFootnoteValueSaver@}%
+ \footnotetext[\value@{mpFootnoteValueSaver@}]@{%
+ Little is known other than her death.@}%
+ \stepcounter@{mpFootnoteValueSaver@}%
+ \footnotetext[\value@{mpFootnoteValueSaver@}]@{%
+ Relationship is unresolved in XXI.@}
\end@{center@}
@end example
-The same technique will work inside a floating @code{table} environment
-(@pxref{table}). To get the footnote at the bottom of the page use the
-@file{tablefootnote} package, as illustrated in this example. If you
-put @code{\usepackage@{tablefootnote@}} in the preamble and use the code
-shown then the footnote appears at the bottom and is numbered in
-sequence with other footnotes.
+For a floating @code{table} environment (@pxref{table}), use the
+@file{tablefootnote} package.
@example
+\usepackage@{tablefootnote@} % in preamble
+ ...
\begin@{table@}
\centering
\begin@{tabular@}@{l|l@}
\textsc@{Date@} &\textsc@{Campaign@} \\ \hline
1862 &Fort Donelson \\
1863 &Vicksburg \\
- 1865 &Army of Northern Virginia\footnote@{Ending the war.@}
+ 1865 &Army of Northern Virginia\tablefootnote@{%
+ Ending the war.@}
\end@{tabular@}
\caption@{Forces captured by US Grant@}
\end@{table@}
@end example
-
-@node Footnotes in section headings
-@section Footnotes in section headings
-
-@cindex footnotes, in section headings
-@cindex table of contents, avoiding footnotes
-Putting a footnote in a section heading, as in:
-
-@example
-\section@{Full sets\protect\footnote@{This material due to ...@}@}
-@end example
-
-@PkgIndex{footmisc}
-@cindex @code{stable} option to @code{footmisc} package
@noindent
-causes the footnote to appear at the bottom of the page where the
-section starts, as usual, but also at the bottom of the table of
-contents, where it is not likely to be desired. To have it not appear
-on the table of contents use the package @file{footmisc} with the
-@code{stable} option.
-
-@example
-\usepackage[stable]@{footmisc@}
-...
-\begin@{document@}
-...
-\section@{Full sets\footnote@{This material due to ...@}@}
-@end example
-
-Note that the @code{\protect} is gone; including it would cause the
-footnote to reappear on the table of contents.
+The footnote appears at the page bottom and is numbered in sequence with
+other footnotes.
@node Footnotes of footnotes
@section Footnotes of footnotes
+@cindex footnote, of a footnote
+
+@PkgIndex{bigfoot}
Particularly in the humanities, authors can have multiple classes of
footnotes, including having footnotes of footnotes. The package
@file{bigfoot} extends @LaTeX{}'s default footnote mechanism in many
ways, including allow these two, as in this example.
@example
-\usepackage@{bigfoot@}
+\usepackage@{bigfoot@} % in preamble
\DeclareNewFootnote@{Default@}
\DeclareNewFootnote@{from@}[alph] % create class \footnotefrom@{@}
...
-\begin@{document@}
-...
The third theorem is a partial converse of the
-second.\footnotefrom@{First noted in Wilson.\footnote@{Second edition only.@}@}
-...
-@end example
-
-
-@node Multiple reference to footnotes
-@section Multiple references to footnotes
-
-You can refer to a single footnote more than once. This example
-uses the package @file{cleverref}.
-
-@c from SE user Jake http://tex.stackexchange.com/a/10116/339
-@example
-\usepackage@{cleveref@}[2012/02/15] % this version of package or later
-\crefformat@{footnote@}@{#2\footnotemark[#1]#3@}
-...
-\begin@{document@}
-...
-The theorem is from Evers.\footnote@{\label@{fn:TE@}Tinker and Evers, 1994.@}
-The corollary is from Chance.\footnote@{Evers and Chance, 1990.@}
-But the key lemma is from Tinker.\cref@{fn:TE@}
-...
+second.\footnotefrom@{%
+ First noted in Wilson.\footnote@{Second edition only.@}@}
@end example
-This solution will work with the package @file{hyperref}.
-See@tie{}@ref{\footnotemark} for a simpler solution in the common case
-of multiple authors with the same affiliation.
-
-
-@node Footnote parameters
-@section Footnote parameters
-
-@cindex footnote parameters
-@cindex parameters, for footnotes
-
-@ftable @code
-@item \footnoterule
-Produces the rule separating the main text on a page from the page's
-footnotes. Default dimensions: @code{0.4pt} thick (or wide), and
-@code{0.4\columnwidth} long in the standard document classes (except
-@code{slides}, where it does not appear).
-
-@item \footnotesep
-The height of the strut placed at the beginning of the footnote. By
-default, this is set to the normal strut for @code{\footnotesize}
-fonts (@pxref{Font sizes}), therefore there is no extra space between
-footnotes. This is @samp{6.65pt} for @samp{10pt}, @samp{7.7pt} for
-@samp{11pt}, and @samp{8.4pt} for @samp{12pt}.
-
-@end ftable
-
@node Definitions
@chapter Definitions
@@ -6448,9 +8500,6 @@ footnotes. This is @samp{6.65pt} for @samp{10pt}, @samp{7.7pt} for
@LaTeX{} has support for making new commands of many different kinds.
-@c xx everything in this chapter needs examples.
-@c xx Add DeclareRobustCommand (see clsguide.pdf)
-
@menu
* \newcommand & \renewcommand:: (Re)define a new command.
* \providecommand:: Define a new command, if name not used.
@@ -6474,111 +8523,155 @@ footnotes. This is @samp{6.65pt} for @samp{10pt}, @samp{7.7pt} for
@cindex defining a new command
@cindex new commands, defining
-@code{\newcommand} and @code{\renewcommand} define and redefine a
-command, respectively. Synopses:
+Synopses, one of:
+
+@example
+\newcommand@{\@var{cmd}@}@{@var{defn}@}
+\newcommand@{\@var{cmd}@}[@var{nargs}]@{@var{defn}@}
+\newcommand@{\@var{cmd}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
+\newcommand*@{\@var{cmd}@}@{@var{defn}@}
+\newcommand*@{\@var{cmd}@}[@var{nargs}]@{@var{defn}@}
+\newcommand*@{\@var{cmd}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
+@end example
+
+@noindent
+or one of these.
@example
- \newcommand@{\@var{cmd}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
- \newcommand*@{\@var{cmd}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
+\renewcommand@{\@var{cmd}@}[@var{nargs}]@{@var{defn}@}
+\renewcommand@{\@var{cmd}@}[@var{nargs}]@{@var{defn}@}
\renewcommand@{\@var{cmd}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
+\renewcommand*@{\@var{cmd}@}@{@var{defn}@}
+\renewcommand*@{\@var{cmd}@}[@var{nargs}]@{@var{defn}@}
\renewcommand*@{\@var{cmd}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
@end example
+Define or redefine a command. See also the discussion of
+@code{\DeclareRobustCommand} in @ref{Class and package commands}.
@cindex starred form, defining new commands
@cindex *-form, defining new commands
-The starred form of these two commands requires that the arguments not
-contain multiple paragraphs of text (not @code{\long}, in plain @TeX{}
-terms).
+The starred form of these two requires that the arguments not contain
+multiple paragraphs of text (in plain @TeX{} terms that it not be
+@code{\long}).
+
+These are the parameters:
@table @var
@item cmd
-Required; @code{\@var{cmd}} is the command name. For @code{\newcommand}, it
-must not be already defined and must not begin with @code{\end}. For
-@code{\renewcommand}, it must already be defined.
+
+Required; the command name. It must begin with a backslash, @code{\},
+and must not begin with the four letter string @code{\end}. For
+@code{\newcommand}, it must not be already defined. For
+@code{\renewcommand}, this name must already be defined.
@item nargs
Optional; an integer from 0 to 9, specifying the number of arguments
-that the command can take, including any optional argument. If this
-argument is not present, the default is for the command to have no
-arguments. When redefining a command, the new version can have a
+that the command takes, including any optional argument. Omitting this
+argument is the same as specifying 0, meaning that the command has no
+arguments. If you redefine a command, the new version can have a
different number of arguments than the old version.
@item optargdefault
-Optional; if this argument is present then the first argument of defined
-command @code{\@var{cmd}} is optional, with default value @var{optargdefault}
+Optional; if this argument is present then the first argument of
+@code{\@var{cmd}} is optional, with default value @var{optargdefault}
(which may be the empty string). If this argument is not present then
@code{\@var{cmd}} does not take an optional argument.
@cindex positional parameter
-That is, if @code{\@var{cmd}} is used with square brackets following,
-as in @code{\@var{cmd}[@var{myval}]}, then within @var{defn} the first
-@dfn{positional parameter} @code{#1} expands @var{myval}. On the
-other hand, if @code{\@var{cmd}} is called without square brackets
-following, then within @var{defn} the positional parameter @code{#1}
-expands to the default @var{optargdefault}. In either case, any
-required arguments will be referred to starting with @code{#2}.
-
-Omitting @code{[@var{myval}]} in a call is different from having the
-square brackets with no contents, as in @code{[]}. The former results
-in @code{#1} expanding to @var{optargdefault}; the latter results in
-@code{#1} expanding to the empty string.
+That is, if @code{\@var{cmd}} is used with square brackets, as in
+@code{\@var{cmd}[@var{optval}]@{...@}...}, then within @var{defn} the
+parameter@tie{}@code{#1} is set to the value of @var{optval}. On the
+other hand, if @code{\@var{cmd}} is called without the square brackets
+then within @var{defn} the parameter @code{#1} is set to the value of
+@var{optargdefault}. In either case, the required arguments start with
+@code{#2}.
+
+Omitting @code{[@var{optargdefault}]} is different from having the
+square brackets with no contents, as in @code{[]}. The former sets
+@code{#1} to the value of @var{optargdefault}; the latter sets @code{#1}
+to the empty string.
@item defn
-The text to be substituted for every occurrence of @code{\@var{cmd}}; the
-positional parameter @code{#@var{n}} in @var{defn} is replaced by
-the text of the @var{n}th argument.
+Required; the text to be substituted for every occurrence of
+@code{\@var{cmd}}. The parameters @code{#1}, @code{#2},
+... @code{#@var{nargs}} are replaced by the values that you supply when
+you call the command (or by the default value if there is an optional
+argument and you don't exercise the option).
@end table
@TeX{} ignores spaces in the source following an alphabetic control
sequence, as in @samp{\cmd }. If you actually want a space there, one
-solution is to type @code{@{@}} after the command (@samp{\cmd@{@} };
+solution is to type @code{@{@}} after the command (@samp{\cmd@{@} }, and
another solution is to use an explicit control space (@samp{\cmd\ }).
A simple example of defining a new command:
-@code{\newcommand@{\RS@}@{Robin Smith@}} results in
-@code{\RS} being replaced by the longer text.
-
-Redefining an existing command is similar:
+@code{\newcommand@{\RS@}@{Robin Smith@}} results in @code{\RS} being
+replaced by the longer text. Redefining an existing command is similar:
@code{\renewcommand@{\qedsymbol@}@{@{\small QED@}@}}.
-Here's a command definition with one required argument:
+If you try to define a command and the name has already been used then
+you get something like @samp{LaTeX Error: Command \fred already
+defined. Or name \end... illegal, see p.192 of the manual}. If you try
+to redefine a command and the name has not yet been used then you get
+something like @samp{LaTeX Error: \hank undefined}.
+
+Here the first command definition has no arguments, and the second has
+one required argument.
@example
+\newcommand@{\student@}@{Ms~O'Leary@}
\newcommand@{\defref@}[1]@{Definition~\ref@{#1@}@}
@end example
-@noindent Then, @code{\defref@{def:basis@}} expands to
-@code{Definition~\ref@{def:basis@}}, which will ultimately expand to
+@noindent
+Use the first as in @code{I highly recommend \student@{@} to you}. The
+second has a variable, so that @code{\defref@{def:basis@}} expands to
+@code{Definition~\ref@{def:basis@}}, which ultimately expands to
something like @samp{Definition~3.14}.
-An example with two required arguments:
+Similarly, but with two required arguments:
@code{\newcommand@{\nbym@}[2]@{$#1 \times #2$@}} is invoked as
@code{\nbym@{2@}@{k@}}.
-An example with an optional argument:
+This example has an optional argument.
@example
\newcommand@{\salutation@}[1][Sir or Madam]@{Dear #1:@}
@end example
-@noindent Then, @code{\salutation} gives @samp{Dear Sir or Madam:} while
+@noindent
+Then @code{\salutation} gives @samp{Dear Sir or Madam:} while
@code{\salutation[John]} gives @samp{Dear John:}. And
@code{\salutation[]} gives @samp{Dear :}.
-The braces around @var{defn} do not define a group, that is, they do
-not delimit the scope of the result of expanding @var{defn}. So
-@code{\newcommand@{\shipname@}[1]@{\it #1@}} is problematic; in this
-sentence,
+This example has an optional argument and two required arguments.
+
+@example
+\newcommand@{\lawyers@}[3][company]@{#2, #3, and~#1@}
+I employ \lawyers[Howe]@{Dewey@}@{Cheatem@}.
+@end example
+
+@noindent
+The output is @samp{I employ Dewey, Cheatem, and Howe}. The optional
+argument, the @code{Howe}, is associated with @code{#1}, while
+@code{Dewey} and @code{Cheatem} are associated with @code{#2}
+and@tie{}@code{#3}. Because of the optional argument,
+@code{\lawyers@{Dewey@}@{Cheatem@}} will give the output @samp{I employ
+Dewey, Cheatem, and company}.
+
+The braces around @var{defn} do not define a group, that is, they do not
+delimit the scope of the result of expanding @var{defn}. For example,
+with @code{\newcommand@{\shipname@}[1]@{\it #1@}}, in this sentence,
@example
The \shipname@{Monitor@} met the \shipname@{Merrimac@}.
@end example
-@noindent the words @samp{met the} would incorrectly be in italics. Another
-pair of braces in the definition is needed, like this:
-@code{\newcommand@{\shipname@}[1]@{@{\it #1@}@}}. Those braces are
-part of the definition and thus do define a group.
+@noindent
+the words @samp{met the} would incorrectly be in italics. The solution
+is to put another pair of braces inside the definition:
+@code{\newcommand@{\shipname@}[1]@{@{\it #1@}@}}.
@node \providecommand
@@ -6589,19 +8682,35 @@ part of the definition and thus do define a group.
@cindex defining a new command
@cindex new commands, defining
-Defines a command, as long as no command of this name already exists.
-Synopses:
+Synopses, one of:
@example
+\providecommand@{@var{cmd}@}@{@var{defn}@}
+\providecommand@{@var{cmd}@}[@var{nargs}]@{@var{defn}@}
\providecommand@{@var{cmd}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
+\providecommand*@{@var{cmd}@}@{@var{defn}@}
+\providecommand*@{@var{cmd}@}[@var{nargs}]@{@var{defn}@}
\providecommand*@{@var{cmd}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
@end example
+Defines a command, as long as no command of this name already exists.
If no command of this name already exists then this has the same effect
-as @code{\newcommand} (@pxref{\newcommand & \renewcommand}). If a
-command of this name already exists then this definition does nothing.
-This is particularly useful in a style file, or other file that may be
-loaded more than once.
+as @code{\newcommand}. If a command of this name already exists then
+this definition does nothing. This is particularly useful in a file
+that may be loaded more than once, such as a style file.
+@xref{\newcommand & \renewcommand} for the description of the arguments.
+
+This example
+
+@example
+\providecommand@{\myaffiliation@}@{Saint Michael's College@}
+\providecommand@{\myaffiliation@}@{Saint Michael's College@}
+From \myaffiliation.
+@end example
+
+@noindent
+outputs @samp{From Saint Michael's College}. Unlike @code{\newcommand},
+the repeated use of @code{\providecommand} does not give an error.
@node \newcounter
@@ -6617,26 +8726,47 @@ Synopsis, one of:
\newcounter@{@var{countername}@}[@var{supercounter}]
@end example
-Globally defines a new counter named @var{countername} and initialize
-the new counter to zero.
+Globally defines a new counter named @var{countername} and initialize it
+to zero (@pxref{Counters}).
-The name @var{countername} must consists of letters only, and does not
+The name @var{countername} must consist of letters only. It does not
begin with a backslash. This name must not already be in use by another
counter.
-When you use the optional argument @code{[@var{supercounter}]} then
-@var{countername} will be numbered within, or subsidiary to, the
-existing counter @var{supercounter}. For example, ordinarily
-@code{subsection} is numbered within @code{section} so that any time
-@var{supercounter} is incremented with @code{\stepcounter}
+When you use the optional argument @code{[@var{supercounter}]} then the
+counter @var{countername} will be reset to zero whenever
+@var{supercounter} is incremented. For example, ordinarily
+@code{subsection} is numbered within @code{section} so that any time you
+increment @var{section}, either with @code{\stepcounter}
(@pxref{\stepcounter}) or @code{\refstepcounter}
-(@pxref{\refstepcounter}) then @var{countername} is reset to zero.
+(@pxref{\refstepcounter}), then @LaTeX{} will reset @var{subsection} to
+zero.
+
+This example
+
+@example
+\newcounter@{asuper@} \setcounter@{asuper@}@{1@}
+\newcounter@{asub@}[asuper] \setcounter@{asub@}@{3@} % Note `asuper'
+The value of asuper is \arabic@{asuper@} and of asub is \arabic@{asub@}.
+\stepcounter@{asuper@}
+Now asuper is \arabic@{asuper@} while asub is \arabic@{asub@}.
+@end example
+
+produces @samp{The value of asuper is 1 and that of asub is 3} and
+@samp{Now asuper is 2 while asub is 0}.
-@xref{Counters}, for more information about counters.
+If the counter already exists, for instance by entering @code{asuper}
+twice, then you get something like @samp{LaTeX Error: Command \c@@asuper
+already defined. Or name \end... illegal, see p.192 of the manual.}.
+
+If you use the optional argument then the super counter must already
+exist. Entering @code{\newcounter@{jh@}[lh]} when @code{lh} is not a
+defined counter will get you @samp{LaTeX Error: No counter 'lh'
+defined.}
@node \newlength
-@section @code{\newlength}: Allocating a length
+@section @code{\newlength}
@findex \newlength
@cindex lengths, allocating new
@@ -6644,42 +8774,65 @@ existing counter @var{supercounter}. For example, ordinarily
@cindex skip register, plain @TeX{}
@cindex glue register, plain @TeX{}
-Allocate a new @dfn{length} register. Synopsis:
+Synopsis:
@example
-\newlength@{\@var{arg}@}
+\newlength@{@var{arg}@}
@end example
-This command takes one required argument, which must begin with a
-backslash (@samp{\}). It creates a new length register named
-@code{\@var{arg}}, which is a place to hold (rubber) lengths such as
-@code{1in plus.2in minus.1in} (what plain @TeX{} calls a @code{skip}
-register). The register gets an initial value of zero. The control
-sequence @code{\@var{arg}} must not already be defined.
+Allocate a new length register (@pxref{Lengths}). The required argument
+@var{arg} must begin with a backslash, @code{\}. The new register holds
+rubber lengths such as @code{72.27pt} or @code{1in plus.2in minus.1in}
+(a @LaTeX{} length register is what plain @TeX{} calls a @code{skip}
+register). The initial value is zero. The control sequence
+@code{\@var{arg}} must not be already defined.
+
+An example:
-@xref{Lengths}, for more about lengths.
+@example
+\newlength@{\graphichgt@}
+@end example
+
+If you forget the backslash then you get @samp{Missing control sequence
+inserted}. If the command sequence already exists then you get
+something like @samp{LaTeX Error: Command \graphichgt already defined.
+Or name \end... illegal, see p.192 of the manual}.
@node \newsavebox
-@section @code{\newsavebox}: Allocating a box
+@section @code{\newsavebox}
@findex \newsavebox
@cindex box, allocating new
-Allocate a ``bin'' for holding a box. Synopsis:
+Synopsis:
@example
-\newsavebox@{\@var{cmd}@}
+\newsavebox@{@var{cmd}@}
@end example
-Defines @code{\@var{cmd}} to refer to a new bin for storing boxes.
-Such a box is for holding typeset material, to use multiple times
-(@pxref{Boxes}) or to measure or manipulate. The name
-@code{\@var{cmd}} must start with a backslash (@samp{\}), and must not
-be already defined.
+Define @code{\@var{cmd}} to refer to a new ``bin'' for storing boxes.
+Such a box is for holding typeset material, to use multiple times or to
+measure or manipulate (@pxref{Boxes}). The required bin name
+@code{@var{cmd}} must start with a backslash, @code{\}, and must not
+already be defined. This command is fragile (@pxref{\protect}).
-The allocation of a box is global. This command is fragile
-(@pxref{\protect}).
+The first line here sets you up to save the material for later use.
+
+@example
+\newsavebox@{\logobox@}
+\savebox@{\logobox@}@{LoGo@}
+Our logo is \usebox@{\logobox@}.
+@end example
+
+@noindent
+The output is @samp{Our logo is LoGo}.
+
+If there is an already defined bin then you get something like
+@samp{LaTeX Error: Command \logobox already defined. Or name
+\end... illegal, see p.192 of the manual}.
+
+The allocation of a box is global.
@node \newenvironment & \renewenvironment
@@ -6691,26 +8844,42 @@ The allocation of a box is global. This command is fragile
@cindex defining new environments
@cindex redefining environments
-These commands define or redefine an environment @var{env}, that is,
-@code{\begin@{@var{env}@} @var{body} \end@{@var{env}@}}. Synopses:
+Synopses, one of:
@example
- \newenvironment@{@var{env}@}[@var{nargs}][@var{optargdefault}]@{@var{begdefn}@}@{@var{enddefn}@}
- \newenvironment*@{@var{env}@}[@var{nargs}][@var{optargdefault}]@{@var{begdefn}@}@{@var{enddefn}@}
- \renewenvironment@{@var{env}@}[@var{nargs}][@var{optargdefault}]@{@var{begdefn}@}@{@var{enddefn}@}
-\renewenvironment*@{@var{env}@}[@var{nargs}][@var{optargdefault}]@{@var{begdefn}@}@{@var{enddefn}@}
+\newenvironment@{@var{env}@}@{@var{begdef}@}@{@var{enddef}@}
+\newenvironment@{@var{env}@}[@var{nargs}]@{@var{begdef}@}@{@var{enddef}@}
+\newenvironment@{@var{env}@}[@var{nargs}][@var{optargdefault}]@{@var{begdef}@}@{@var{enddef}@}
+\newenvironment*@{@var{env}@}@{@var{begdef}@}@{@var{enddef}@}
+\newenvironment*@{@var{env}@}[@var{nargs}]@{@var{begdef}@}@{@var{enddef}@}
+\newenvironment*@{@var{env}@}[@var{nargs}][@var{optargdefault}]@{@var{begdef}@}@{@var{enddef}@}
@end example
+@noindent
+or one of these.
+
+@example
+\renewenvironment@{@var{env}@}@{@var{begdef}@}@{@var{enddef}@}
+\renewenvironment@{@var{env}@}[@var{nargs}]@{@var{begdef}@}@{@var{enddef}@}
+\renewenvironment@{@var{env}@}[@var{nargs}][@var{optargdefault}]@{@var{begdef}@}@{@var{enddef}@}
+\renewenvironment*@{@var{env}@}@{@var{begdef}@}@{@var{enddef}@}
+\renewenvironment*@{@var{env}@}[@var{nargs}]@{@var{begdef}@}@{@var{enddef}@}
+\renewenvironment*@{@var{env}@}[@var{nargs}][@var{optargdefault}]@{@var{begdef}@}@{@var{enddef}@}
+@end example
+
+Define or redefine the environment @var{env}, that is, create the
+construct @code{\begin@{@var{env}@} ... @var{body} ... \end@{@var{env}@}}.
+
@cindex @code{*}-form of environment commands
The starred form of these commands requires that the arguments not
-contain multiple paragraphs of text. The body of these environments can
-still contain multiple paragraphs.
+contain multiple paragraphs of text. However, the body of these
+environments can contain multiple paragraphs.
@table @var
@item env
Required; the environment name. It consists only of letters or the
-@code{*} character, and thus does not begin with backslash
-(@code{\}). It must not begin with the string @code{end}. For
+@code{*} character, and thus does not begin with backslash, @code{\}.
+It must not begin with the string @code{end}. For
@code{\newenvironment}, the name @var{env} must not be the name of an
already existing environment, and also the command @code{\@var{env}}
must be undefined. For @code{\renewenvironment}, @var{env} must be the
@@ -6718,55 +8887,61 @@ name of an existing environment.
@item nargs
Optional; an integer from 0 to 9 denoting the number of arguments of
-that the environment will take. When the environment is used these
+that the environment takes. When you use the environment these
arguments appear after the @code{\begin}, as in
-@code{\begin@{@var{env}@}@{@var{arg1}@}@dots{}@{@var{argn}@}}. If this
-argument is not present then the default is for the environment to have
-no arguments. When redefining an environment, the new version can have
-a different number of arguments than the old version.
+@code{\begin@{@var{env}@}@{@var{arg1}@} ... @{@var{argn}@}}. Omitting
+this is equivalent to setting it to 0; the environment will have no
+arguments. When redefining an environment, the new version can have a
+different number of arguments than the old version.
@item optargdefault
-Optional; if this argument is present then the first argument of the
-defined environment is optional, with default value @var{optargdefault}
-(which may be the empty string). If this argument is not present then
-the environment does not take an optional argument.
-
-That is, when @code{[@var{optargdefault}]} is present in the
-environment definition, if @code{\begin@{@var{env}@}} is used with
-square brackets following, as in
-@code{\begin@{@var{env}@}[@var{myval}]}, then, within @var{begdefn},
-the positional parameter @code{#1} expands to @var{myval}. If
-@code{\begin@{@var{env}@}} is called without square brackets
-following, then, within within @var{begdefn}, the positional parameter
-@code{#1} expands to the default @var{optargdefault}. In either case,
-any required arguments will be referred to starting with @code{#2}.
-
-Omitting @code{[@var{myval}]} in the call is different from having the
+Optional; if this is present then the first argument of the defined
+environment is optional, with default value @var{optargdefault} (which
+may be the empty string). If this is not in the definition then the
+environment does not take an optional argument.
+
+That is, when @var{optargdefault} is present in the definition of the
+environment then you can start the environment with square brackets, as
+in @code{\begin@{@var{env}@}[@var{optval}]@{...@} ... \end@{@var{env}@}}.
+In this case, within @var{begdefn} the parameter @code{#1} is set to the
+value of @var{optval}. If you call @code{\begin@{@var{env}@}} without
+square brackets, then within @var{begdefn} the parameter @code{#1} is
+set to the value of the default @var{optargdefault}. In either case,
+any required arguments start with @code{#2}.
+
+Omitting @code{[@var{myval}]} in the call is different than having the
square brackets with no contents, as in @code{[]}. The former results
in @code{#1} expanding to @var{optargdefault}; the latter results in
@code{#1} expanding to the empty string.
-@item begdefn
+@item begdef
Required; the text expanded at every occurrence of
-@code{\begin@{@var{env}@}}. Within @var{begdef}, the @var{n}th
-positional parameter (i.e., @code{#@var{n}}) is replaced by the text
-of the @var{n}th argument.
+@code{\begin@{@var{env}@}}. Within @var{begdef}, the parameters
+@code{#1}, @code{#2}, ... @code{#@var{nargs}}, are replaced by the
+values that you supply when you call the environment; see the examples
+below.
-@item enddefn
+@item enddef
Required; the text expanded at every occurrence of
-@code{\end@{@var{env}@}}. This may not contain any positional
-parameters, so @code{#@var{n}} cannot be used here (but see the final
+@code{\end@{@var{env}@}}. This may not contain any parameters, that is,
+you cannot use @code{#1}, @code{#2}, etc., here (but see the final
example below).
@end table
-All environments, that is to say the @var{begdefn} code, the environment
-body and the @var{enddefn} code, are processed within a group. Thus, in
+All environments, that is to say the @var{begdef} code, the environment
+body, and the @var{enddef} code, are processed within a group. Thus, in
the first example below, the effect of the @code{\small} is limited to
the quote and does not extend to material following the environment.
+If you try to define an environment and the name has already been used
+then you get something like @samp{LaTeX Error: Command \fred already
+defined. Or name \end... illegal, see p.192 of the manual}. If you try
+to redefine an environment and the name has not yet been used then you
+get something like @samp{LaTeX Error: Environment hank undefined.}.
+
This example gives an environment like @LaTeX{}'s @code{quotation}
-except that it will be set in smaller type:
+except that it will be set in smaller type.
@example
\newenvironment@{smallquote@}@{%
@@ -6776,8 +8951,18 @@ except that it will be set in smaller type:
@}
@end example
-This one shows the use of arguments; it gives a quotation environment
-that cites the author:
+This has an argument, which is set in boldface at the start of a
+paragraph.
+
+@example
+\newenvironment@{point@}[1]@{%
+ \noindent\textbf@{#1@}
+@}@{%
+@}
+@end example
+
+This one shows the use of a optional argument; it gives a quotation
+environment that cites the author.
@example
\newenvironment@{citequote@}[1][Shakespeare]@{%
@@ -6788,8 +8973,9 @@ that cites the author:
@}
@end example
-@noindent The author's name is optional, and defaults to @samp{Shakespeare}.
-In the document, use the environment like this:
+@noindent
+The author's name is optional, and defaults to @samp{Shakespeare}. In
+the document, use the environment like this.
@example
\begin@{citequote@}[Lincoln]
@@ -6798,7 +8984,7 @@ In the document, use the environment like this:
@end example
The final example shows how to save the value of an argument to use in
-@var{enddefn}, in this case in a box (@pxref{\sbox}):
+@var{enddef}, in this case in a box (@pxref{\sbox & \savebox}).
@example
\newsavebox@{\quoteauthor@}
@@ -6821,7 +9007,7 @@ The final example shows how to save the value of an argument to use in
@cindex theorem-like environment
@cindex environment, theorem-like
-Define a new theorem-like environment. Synopses:
+Synopses:
@example
\newtheorem@{@var{name}@}@{@var{title}@}
@@ -6829,25 +9015,24 @@ Define a new theorem-like environment. Synopses:
\newtheorem@{@var{name}@}[@var{numbered_like}]@{@var{title}@}
@end example
-Using the first form, @code{\newtheorem@{@var{name}@}@{@var{title}@}}
-creates an environment that will be labelled with @var{title}. See the
-first example below.
+Define a new theorem-like environment. You can specify one of
+@var{numbered_within} and @var{numbered_like}, or neither, but not both.
-The second form
-@code{\newtheorem@{@var{name}@}@{@var{title}@}[@var{numbered_within}]}
-creates an environment whose counter is subordinate to the existing
-counter @var{numbered_within} (its counter will be reset when
-@var{numbered_within} is reset).
+The first form, @code{\newtheorem@{@var{name}@}@{@var{title}@}}, creates
+an environment that will be labelled with @var{title}; see the first
+example below.
+The second form,
+@code{\newtheorem@{@var{name}@}@{@var{title}@}[@var{numbered_within}]},
+creates an environment whose counter is subordinate to the existing
+counter @var{numbered_within}, so this counter will be reset when
+@var{numbered_within} is reset. See the second example below.
The third form
@code{\newtheorem@{@var{name}@}[@var{numbered_like}]@{@var{title}@}},
-with optional argument between the two required arguments, will create
-an environment whose counter will share the previously defined counter
-@var{numbered_like}.
-
-You can specify one of @var{numbered_within} and @var{numbered_like},
-or neither, but not both.
+with optional argument between the two required arguments, creates an
+environment whose counter will share the previously defined counter
+@var{numbered_like}. See the third example.
This command creates a counter named @var{name}. In addition, unless
the optional argument @var{numbered_like} is used, inside of the
@@ -6860,12 +9045,13 @@ Arguments:
@table @var
@item name
-The name of the environment. It must not begin with a backslash
-(@samp{\}). It must not be the name of an existing environment; indeed,
-the command name @code{\@var{name}} must not already be defined as anything.
+The name of the environment. It is a string of letters. It must not
+begin with a backslash, @code{\}. It must not be the name of an
+existing environment, and the command name @code{\@var{name}} must not
+already be defined.
@item title
-The text printed at the beginning of the environment, before the
+The text to be printed at the beginning of the environment, before the
number. For example, @samp{Theorem}.
@item numbered_within
@@ -6902,10 +9088,10 @@ output.
\end@{defn@}
@end example
-Because the next example specifies the optional argument
-@var{numbered_within} to @code{\newtheorem} as @code{section}, the
-example, with the same document body, gives @samp{Definition@tie{}1.1}
-and @samp{Definition@tie{}2.1}.
+This example has the same document body as the prior one. But here
+@code{\newtheorem}'s optional argument @var{numbered_within} is given as
+@code{section}, so the output is like @samp{Definition@tie{}1.1} and
+@samp{Definition@tie{}2.1}.
@example
\newtheorem@{defn@}@{Definition@}[section]
@@ -6947,45 +9133,43 @@ by @samp{Theorem@tie{}2.1} and @samp{Definition@tie{}2.2}.
@node \newfont
-@section @code{\newfont}: Define a new font (obsolete)
+@section @code{\newfont}
@findex \newfont
@cindex fonts, new commands for
@cindex defining new fonts
-@code{\newfont}, now obsolete, defines a command that will switch fonts.
+@c @findex .fd @r{file}
+This command is obsolete. This description is here only to help with old
+documents. New documents should define fonts in families through the
+New Font Selection Scheme which allows you to, for example, associate a
+boldface with a roman (@pxref{Fonts}).
+@c This is done either by using
+@c @file{.fd} files or through the use of an engine that can access system
+@c fonts such as Xe@LaTeX{} (@pxref{@TeX{} engines}).
+
Synopsis:
@example
\newfont@{\@var{cmd}@}@{@var{font description}@}
@end example
-This defines a control sequence @code{\@var{cmd}} that will change the
-current font. @LaTeX{} will look on your system for a file named
-@file{@var{fontname}.tfm}. The control sequence must must not already
-be defined. It must begin with a backslash (@samp{\}).
-
-@findex .fd @r{file}
-This command is obsolete. It is a low-level command for setting up an
-individual font. Today fonts are almost always defined in families
-(which allows you to, for example, associate a boldface with a roman)
-through the so-called ``New Font Selection Scheme'', either by using
-@file{.fd} files or through the use of an engine that can access
-system fonts such as Xe@LaTeX{} (@pxref{@TeX{} engines}).
-@c xx explain nfss somewhere
+Define a command @code{\@var{cmd}} that will change the current font.
+The control sequence must must not already be defined. It must begin
+with a backslash, @code{\}.
@cindex at clause, in font definitions
@cindex design size, in font definitions
-But since it is part of @LaTeX{}, here is an explanation: the
-@var{font description} consists of a @var{fontname} and an optional
-@dfn{at clause}; this can have the form either @code{at @var{dimen}}
-or @code{scaled @var{factor}}, where a @var{factor} of @samp{1000}
-means no scaling. For @LaTeX{}'s purposes, all this does is scale all
-the character and other font dimensions relative to the font's design
-size, which is a value defined in the @file{.tfm} file.
+The @var{font description} consists of a @var{fontname} and an optional
+@dfn{at clause}. @LaTeX{} will look on your system for a file named
+@file{@var{fontname}.tfm}. The at clause can have the form either
+@code{at @var{dimen}} or @code{scaled @var{factor}}, where a
+@var{factor} of @samp{1000} means no scaling. For @LaTeX{}'s purposes,
+all this does is scale all the character and other font dimensions
+relative to the font's design size, which is a value defined in the
+@file{.tfm} file.
-This example defines two equivalent fonts and typesets a few
-characters in each:
+This defines two equivalent fonts and typesets a few characters in each.
@example
\newfont@{\testfontat@}@{cmb10 at 11pt@}
@@ -7074,6 +9258,7 @@ Synopsis:
\ignorespaces
@end example
+@noindent
or
@example
@@ -7095,12 +9280,17 @@ the command and the question text.
\newcommand@{\points@}[1]@{\makebox[0pt]@{\makebox[10em][l]@{#1~pts@}@}
\begin@{enumerate@}
\item\points@{10@}no extra space output here
- \item\points@{15@} extra space output between the number and the word `extra'
+ \item\points@{15@} extra space between the number and the `extra'
\end@{enumerate@}
@end example
-The solution is to change to
-@code{\newcommand@{\points@}[1]@{\makebox[0pt]@{\makebox[10em][l]@{#1~pts@}@}\ignorespaces@}}.
+@noindent
+The solution is to change to this.
+
+@example
+\newcommand@{\points@}[1]@{%
+ \makebox[0pt]@{\makebox[10em][l]@{#1~pts@}@}\ignorespaces@}
+@end example
A second example shows spaces being removed from the front of text. The
commands below allow a user to uniformly attach a title to names. But,
@@ -7110,7 +9300,7 @@ as given, if a title accidentally starts with a space then
@example
\makeatletter
\newcommand@{\honorific@}[1]@{\def\@@honorific@{#1@}@} % remember title
-\newcommand@{\fullname@}[1]@{\@@honorific~#1@} % recall title; put before name
+\newcommand@{\fullname@}[1]@{\@@honorific~#1@} % put title before name
\makeatother
\begin@{tabular@}@{|l|@}
\honorific@{Mr/Ms@} \fullname@{Jones@} \\ % no extra space here
@@ -7118,6 +9308,7 @@ as given, if a title accidentally starts with a space then
\end@{tabular@}
@end example
+@noindent
To fix this, change to
@code{\newcommand@{\fullname@}[1]@{\ignorespaces\@@honorific~#1@}}.
@@ -7179,18 +9370,20 @@ inside of a minipage (@pxref{minipage}). The counters @code{enumi}
through @code{enumiv} are used in the @code{enumerate} environment, for
up to four levels of nesting (@pxref{enumerate}).
+Counters can have any integer value but they are typically positive.
+
New counters are created with @code{\newcounter}. @xref{\newcounter}.
@menu
* \alph \Alph \arabic \roman \Roman \fnsymbol:: Print value of a counter.
-* \usecounter:: Use a specified counter in a list environment.
-* \value:: Use the value of a counter in an expression.
-* \setcounter:: Set the value of a counter.
-* \addtocounter:: Add a quantity to a counter.
-* \refstepcounter:: Add to a counter.
-* \stepcounter:: Add to a counter, resetting subsidiary counters.
-* \day \month \year:: Numeric date values.
+* \usecounter:: Use a specified counter in a list environment.
+* \value:: Use the value of a counter in an expression.
+* \setcounter:: Set the value of a counter.
+* \addtocounter:: Add a quantity to a counter.
+* \refstepcounter:: Add to a counter.
+* \stepcounter:: Add to a counter, resetting subsidiary counters.
+* \day & \month & \year:: Numeric date values.
@end menu
@@ -7201,7 +9394,7 @@ New counters are created with @code{\newcounter}. @xref{\newcounter}.
Print the value of a counter, in a specified style. For instance, if
the counter @var{counter} has the value 1 then a
-@code{\alph@{@var{counter}@}} in your source will result in a lower case
+@code{\alph@{@var{counter}@}} in your source will result in a lowercase
letter@tie{}a appearing in the output.
All of these commands take a single counter as an argument, for
@@ -7210,54 +9403,67 @@ start with a backslash.
@ftable @code
@item \alph@{@var{counter}@}
-Print the value of @var{counter} in lowercase letters: `a', `b', @enddots{}
+Print the value of @var{counter} in lowercase letters: `a', `b',
+@enddots{} If the counter's value is less than 1 or more than 26 then
+you get @samp{LaTeX Error: Counter too large.}
@item \Alph@{@var{counter}@}
-Print in uppercase letters: `A', `B', @enddots{}
+Print in uppercase letters: `A', `B', @enddots{} If the counter's value
+is less than 1 or more than 26 then you get @samp{LaTeX Error: Counter
+too large.}
@item \arabic@{@var{counter}@}
-Print in Arabic numbers: `1', `2', @enddots{}
+Print in Arabic numbers such as @samp{5} or @samp{-2}.
@item \roman@{@var{counter}@}
-Print in lowercase roman numerals: `i', `ii', @enddots{}
+Print in lowercase roman numerals: `i', `ii', @enddots{} If the
+counter's value is less than 1 then you get no warning or error but
+@LaTeX{} does not print anything in the output.
@item \Roman@{@var{counter}@}
-Print in uppercase roman numerals: `I', `II', @enddots{}
+Print in uppercase roman numerals: `I', `II', @enddots{} If the
+counter's value is less than 1 then you get no warning or error but
+@LaTeX{} does not print anything in the output.
@item \fnsymbol@{@var{counter}@}
-Prints the value of @var{counter} in a specific sequence of nine
-symbols (conventionally used for labeling footnotes). The value of
-@var{counter} must be between@tie{}1 and@tie{}9, inclusive.
+Prints the value of @var{counter} using a sequence of nine symbols that
+are traditionally used for labeling footnotes. The value of
+@var{counter} should be between@tie{}1 and@tie{}9, inclusive. If the
+counter's value is less than 0 or more than 9 then you get @samp{LaTeX
+Error: Counter too large}, while if it is 0 then you get no error or
+warning but @LaTeX{} does not output anything.
Here are the symbols:
-@multitable @columnfractions .33 .33 .33
-@headitem Name@tab Command@tab@iftexthenelse{Symbol,Equivalent Unicode symbol and/or numeric code point}
+@multitable @columnfractions .10 .30 .30 .30
+@headitem Number@tab Name@tab Command@tab Symbol
@item
-asterisk@tab@code{\ast}@tab@iftexthenelse{@math{@ast},*}
+1@tab asterisk@tab@code{\ast}@tab@iftexthenelse{@math{@ast},*}
@item
-dagger@tab@code{\dagger}@tab@BES{2020,\dagger}
+2@tab dagger@tab@code{\dagger}@tab@BES{2020,\dagger}
@item
-ddagger@tab@code{\ddagger}@tab@BES{2021,\ddagger}
+3@tab ddagger@tab@code{\ddagger}@tab@BES{2021,\ddagger}
@item
-section-sign@tab@code{\S}@tab@BES{00A7,\S}
+4@tab section-sign@tab@code{\S}@tab@BES{00A7,\S}
@item
-paragraph-sign@tab@code{\P}@tab@BES{00B6,\P}
+5@tab paragraph-sign@tab@code{\P}@tab@BES{00B6,\P}
@item
-double-vert@tab@code{\parallel}@tab@BES{2016,\parallel}
+6@tab double-vert@tab@code{\parallel}@tab@BES{2016,\parallel}
@item
-double-asterisk@tab@code{\ast\ast}@tab@iftexthenelse{@math{@ast@ast},**}
+7@tab double-asterisk@tab@code{\ast\ast}@tab@iftexthenelse{@math{@ast@ast},**}
@item
-double-dagger@tab@code{\dagger\dagger}@tab@BES{2020,\dagger}@BES{2020,\dagger}
+8@tab
+ double-dagger@tab@code{\dagger\dagger}@tab@BES{2020,\dagger}@BES{2020,\dagger}
@item
-double-ddagger@tab@code{\ddagger\ddagger}@tab@BES{2021,\ddagger}@BES{2021,\ddagger}
+9@tab
+ double-ddagger@tab@code{\ddagger\ddagger}@tab@BES{2021,\ddagger}@BES{2021,\ddagger}
@end multitable
@end ftable
@node \usecounter
-@section @code{\usecounter@{@var{counter}@}}
+@section @code{\usecounter}
@findex \usecounter
@cindex list items, specifying counter
@@ -7269,15 +9475,16 @@ Synopsis:
\usecounter@{@var{counter}@}
@end example
-In the @code{list} environment, when used in the second argument, this
-command sets up @var{counter} to number the list items. It initializes
-@var{counter} to zero, and arranges that when @code{\item} is called
-without its optional argument then @var{counter} is incremented by
-@code{\refstepcounter}, making its value be the current @code{ref}
-value. This command is fragile (@pxref{\protect}).
+Used in the second argument of the @code{list} environment
+(@pxref{list}), this declares that list items will be numbered by
+@var{counter}. It initializes @var{counter} to zero, and arranges that
+when @code{\item} is called without its optional argument then
+@var{counter} is incremented by @code{\refstepcounter}, making its value
+be the current @code{ref} value (@pxref{\ref}). This command is fragile
+(@pxref{\protect}).
-Put in the preamble, this makes a new list environment enumerated with
-@var{testcounter}:
+Put in the document preamble, this example makes a new list environment
+enumerated with @var{testcounter}:
@example
\newcounter@{testcounter@}
@@ -7292,7 +9499,7 @@ Put in the preamble, this makes a new list environment enumerated with
@node \value
-@section @code{\value@{@var{counter}@}}
+@section @code{\value}
@findex \value
@cindex counters, getting value of
@@ -7303,13 +9510,8 @@ Synopsis:
\value@{@var{counter}@}
@end example
-This command expands to the value of @var{counter}. It is often used
-in @code{\setcounter} or @code{\addtocounter}, but @code{\value} can
-be used anywhere that @LaTeX{} expects a number. It must not be
-preceded by @code{\protect} (@pxref{\protect}).
-
-The @code{\value} command is not used for typesetting the value of the
-counter. @xref{\alph \Alph \arabic \roman \Roman \fnsymbol}.
+Expands to the value of the counter @var{counter}. (Note that the name
+of a counter does not begin with a backslash.)
This example outputs @samp{Test counter is@tie{}6. Other counter
is@tie{}5.}.
@@ -7323,6 +9525,14 @@ Test counter is \arabic@{test@}.
Other counter is \arabic@{other@}.
@end example
+The @code{\value} command is not used for typesetting the value of the
+counter. For that, see @ref{\alph \Alph \arabic \roman \Roman \fnsymbol}.
+
+It is often used in @code{\setcounter} or @code{\addtocounter} but
+@code{\value} can be used anywhere that @LaTeX{} expects a number, such
+as in @code{\hspace@{\value@{foo@}\parindent@}}. It must not be
+preceded by @code{\protect} (@pxref{\protect}).
+
This example inserts @code{\hspace@{4\parindent@}}.
@example
@@ -7332,7 +9542,7 @@ This example inserts @code{\hspace@{4\parindent@}}.
@node \setcounter
-@section @code{\setcounter@{@var{counter}@}@{@var{value}@}}
+@section @code{\setcounter}
@findex \setcounter
@cindex counters, setting
@@ -7344,25 +9554,33 @@ Synopsis:
\setcounter@{@var{counter}@}@{@var{value}@}
@end example
-The @code{\setcounter} command globally sets the value of @var{counter}
-to the @var{value} argument. Note that the counter name does not start
-with a backslash.
+Globally set the counter @var{counter} to have the value of the
+@var{value} argument, which must be an integer. Thus, you can set a
+counter's value as @code{\setcounter@{section@}@{5@}}. Note that the
+counter name does not start with a backslash.
-In this example the section value appears as @samp{V}.
+In this example if the counter @code{theorem} has value 12 then the
+second line will print @samp{XII}.
@example
-\setcounter@{section@}@{5@}
-Here it is in Roman: \Roman@{section@}.
+\setcounter@{exercise@}@{\value@{theorem@}@}
+Here it is in Roman: \Roman@{exercise@}.
@end example
@node \addtocounter
-@section @code{\addtocounter@{@var{counter}@}@{@var{value}@}}
+@section @code{\addtocounter}
@findex \addtocounter
-The @code{\addtocounter} command globally increments @var{counter} by
-the amount specified by the @var{value} argument, which may be negative.
+Synopsis:
+
+@example
+\addtocounter@{@var{counter}@}@{@var{value}@
+@end example
+
+Globally increment @var{counter} by the amount specified by the
+@var{value} argument, which may be negative.
In this example the section value appears as @samp{VII}.
@@ -7374,15 +9592,20 @@ Here it is in Roman: \Roman@{section@}.
@node \refstepcounter
-@section @code{\refstepcounter@{@var{counter}@}}
+@section @code{\refstepcounter}
@findex \refstepcounter
-The @code{\refstepcounter} command works in the same way as
-@code{\stepcounter} (@pxref{\stepcounter}): it globally increments the
-value of @var{counter} by one and resets the value of any counter
-numbered within it. (For the definition of ``counters numbered
-within'', @pxref{\newcounter}.)
+Synopsis:
+
+@example
+\refstepcounter@{@var{counter}@}
+@end example
+
+Globally increments the value of @var{counter} by one, as does
+@code{\stepcounter} (@pxref{\stepcounter}). The difference is that this
+command resets the value of any counter numbered within it. (For the
+definition of ``counters numbered within'', @pxref{\newcounter}.)
In addition, this command also defines the current @code{\ref} value
to be the result of @code{\thecounter}.
@@ -7392,30 +9615,51 @@ locally, i.e., inside the current group.
@node \stepcounter
-@section @code{\stepcounter@{@var{counter}@}}
+@section @code{\stepcounter}
@findex \stepcounter
-The @code{\stepcounter} command globally adds one to @var{counter} and
-resets all counters numbered within it. (For the definition of
-``counters numbered within'', @pxref{\newcounter}.)
+Synopsis:
+@example
+\stepcounter@{@var{counter}@}
+@end example
-@node \day \month \year
-@section @code{\day \month \year}: Predefined counters
+Globally adds one to @var{counter} and resets all counters numbered
+within it. (For the definition of ``counters numbered within'',
+@pxref{\newcounter}.)
+
+This command differs from @code{\refstepcounter} in that this one does
+not influence references@tie{}--- it does not define the current
+@code{\ref} value to be the result of @code{\thecounter}
+(@pxref{\refstepcounter}).
+
+
+@node \day & \month & \year
+@section @code{\day} & @code{\month} & @code{\year}
@findex \day
@findex \month
@findex \year
-@LaTeX{} defines counters for the day of the month (@code{\day},
-1--31), month of the year (@code{\month}, 1--12), and year
-(@code{\year}, Common Era). When @TeX{} starts up, they are
-set to the current values on the system where @TeX{} is running. They
-are not updated as the job progresses.
+@LaTeX{} defines the counter @code{\day} for the day of the month
+(nominally with value between 1 and 31), @code{\month} for the month of
+the year (nominally with value between 1 and 12), and year @code{\year}.
+When @TeX{} starts up, they are set from the current values on the
+system. The related command @code{\today} produces a string
+representing the current day (@pxref{\today}).
-The related command @code{\today} produces a string representing the
-current day (@pxref{\today}).
+They counters are not updated as the job progresses so in principle they
+could be incorrect by the end. In addition, @TeX{} does no sanity
+check:
+
+@example
+\day=-2 \month=13 \year=-4 \today
+@end example
+
+@noindent
+gives no error or warning and results in the output @samp{-2, -4} (the
+bogus month value produces no output).
@node Lengths
@@ -7426,29 +9670,110 @@ current day (@pxref{\today}).
A @dfn{length} is a measure of distance. Many @LaTeX{} commands take a
length as an argument.
+This shows a box of the given length.
+
+@example
+\newcommand@{\blackbar@}[1]@{\rule@{#1@}@{10pt@}@} % make a bar
+\newcommand@{\showhbox@}[2]@{\fboxsep=0pt\fbox@{\hbox to #1@{#2@}@}@} % box it
+XXX\showhbox@{100pt@}@{\blackbar@{100pt@}@}YYY
+@end example
+
+@noindent
+It produces a black bar 100@tie{}points long between @samp{XXX} and
+@samp{YYY}.
+
Lengths come in two types. A @dfn{rigid length} (what Plain @TeX{}
-calls a @dfn{dimen}) such as @code{10pt} cannot contain a @code{plus} or
-@code{minus} component. A @dfn{rubber length} (what Plain @TeX{} calls
-a @dfn{skip}) can contain those, as with @code{1cm plus0.05cm
-minus0.01cm}. These give the ability to stretch or shrink; the length
-in the prior sentence could appear in the output as long as 1.05@tie{}cm
-or as short as 0.99@tie{}cm, depending on what @TeX{}'s typesetting
-algorithm finds optimum.
+calls a @dfn{dimen}) such as @code{10pt} does not contain a @code{plus}
+or @code{minus} component. The above example shows a rigid length. A
+@dfn{rubber length} (what Plain @TeX{} calls a @dfn{skip}) can contain
+those components, as with @code{1cm plus0.05cm minus0.01cm}. Here the
+@code{1cm} is the @dfn{natural length} while the other two, the
+@code{plus} and @code{minus} components, allow the length to stretch or
+shrink.
+
+Shrinking is simpler: with @code{1cm minus 0.05cm}, the natural length
+is 1@dmn{cm} but if smaller is needed then @TeX{} can shrink it down as
+far as 0.95@dmn{cm}. Beyond that, @TeX{} refuses to shrink any more.
+Thus, below the first one works fine, producing a space of
+98@tie{}points between the two bars.
+
+@example
+XXX\showhbox@{300pt@}@{%
+ \blackbar@{101pt@}\hspace@{100pt minus 2pt@}\blackbar@{101pt@}@}YYY
+
+XXX\showhbox@{300pt@}@{%
+ \blackbar@{105pt@}\hspace@{100pt minus 1pt@}\blackbar@{105pt@}@}YYY
+@end example
+
+@noindent
+But the second one gets a warning like @samp{Overfull \hbox (1.0pt too
+wide) detected at line 17}. In the output the first @samp{Y} is
+overwritten by the end of the black bar, because the box's material is
+wider than the 300@dmn{pt} allocated, as @TeX{} has refused to shrink
+the total to less than 309@tie{}points.
+
+Stretching is like shrinking except that if @TeX{} is asked to stretch
+beyond the given amount, it won't refuse. Here the first line is fine,
+producing a space of 110@tie{}points between the bars.
+
+@example
+XXX\showhbox@{300pt@}@{%
+ \blackbar@{95pt@}\hspace@{100pt plus 10pt@}\blackbar@{95pt@}@}YYY
+
+XXX\showhbox@{300pt@}@{%
+ \blackbar@{95pt@}\hspace@{100pt plus 1pt@}\blackbar@{95pt@}@}YYY
+@end example
+
+@noindent
+In the second line @TeX{} needs a stretch of 10@tie{}points and only
+1@tie{}point was specified. In this situation, @TeX{} stretches the
+space to the required length, but it complains with a warning like
+@samp{Underfull \hbox (badness 10000) detected at line 22}. (We won't
+discuss badness; the point is that the system was not given as much
+stretch as needed.)
+
+You can put both stretch and shrink in the same length, as in
+@code{1ex plus 0.05ex minus 0.02ex}.
+
+If @TeX{} is setting two or more rubber lengths then it allocates the
+stretch or shrink in proportion.
+
+@example
+XXX\showhbox@{300pt@}@{\blackbar@{100pt@}% left
+ \hspace@{0pt plus 50pt@}\blackbar@{80pt@}\hspace@{0pt plus 10pt@}% middle
+ \blackbar@{100pt@}@}YYY % right
+@end example
+
+@noindent
+The outside bars take up 100@tie{}points, so the middle needs another
+100. In the middle the bar takes up 80@tie{}points, so the two
+@code{\hspace}'s must stretch 20@tie{}points. Because the two say
+@code{plus 50pt} and @code{plus 10pt}, @TeX{} gets 5/6 of the
+stretch from the first space and 1/6 from the second.
The @code{plus} or @code{minus} component of a rubber length can contain
a @dfn{fill} component, as in @code{1in plus2fill}. This gives the
-length infinite stretchability or shrinkability, so that the length in
-the prior sentence can be set by @TeX{} to any distance greater than or
-equal to 1@tie{}inch. @TeX{} actually provides three infinite glue
-components @code{fil}, @code{fill}, and @code{filll}, such that the
-later ones overcome the earlier ones, but only the middle value is
-ordinarily used. @xref{\hfill}, @xref{\vfill}.
-
-Multiplying an entire rubber length by a number turns it into a rigid
-length, so that after @code{\setlength@{\ylength@}@{1in plus 0.2in@}}
-and @code{\setlength@{\zlength@}@{3\ylength@}} then the value of
-@code{\zlength} is @code{3in}.
+length infinite stretchability or shrinkability so that @TeX{} could set
+it to any distance. Here the two figures will be equal-spaced across
+the page.
+
+@example
+\begin@{minipage@}@{\linewidth@}
+ \hspace@{0pt plus 1fill@}\includegraphics@{godel.png@}%
+ \hspace@{0pt plus 1fill@}\includegraphics@{einstein.png@}%
+ \hspace@{0pt plus 1fill@}
+\end@{minipage@}
+@end example
+@TeX{} actually has three infinite glue components @code{fil},
+@code{fill}, and @code{filll}. The later ones are more infinite than
+the earlier ones. Ordinarily document authors only use the middle one
+(@pxref{\hfill} and @pxref{\vfill}).
+
+Multiplying a rubber length by a number turns it into a rigid length, so
+that after @code{\setlength@{\ylength@}@{1in plus 0.2in@}} and
+@code{\setlength@{\zlength@}@{3\ylength@}} then the value of
+@code{\zlength} is @code{3in}.
@menu
* Units of length:: The units that @LaTeX{} knows.
@@ -7457,7 +9782,7 @@ and @code{\setlength@{\zlength@}@{3\ylength@}} then the value of
* \settodepth:: Set a length to the depth of something.
* \settoheight:: Set a length to the height of something.
* \settowidth:: Set a length to the width of something.
-* Predefined lengths:: Lengths that are, like, predefined.
+@c * Predefined lengths:: Lengths that are, like, predefined.
@end menu
@@ -7473,48 +9798,57 @@ math mode.
@item pt
@findex pt
@cindex Point
+@anchor{units of length pt}
Point 1/72.27 inch. The conversion to metric units, to two decimal
places, is 1@dmn{point} = 2.85@dmn{mm} = 28.45@dmn{cm}.
@item pc
@cindex pica
@findex pc
+@anchor{units of length pc}
Pica, 12 pt
@item in
@findex in
@findex inch
+@anchor{units of length in}
Inch, 72.27 pt
@item bp
@findex bp
@cindex Big point
+@anchor{units of length bp}
Big point, 1/72 inch. This length is the definition of a point in
PostScript and many desktop publishing systems.
@item cm
@cindex Centimeter
@findex cm
+@anchor{units of length cm}
Centimeter
@item mm
@cindex Millimeter
@findex mm
+@anchor{units of length mm}
Millimeter
@item dd
@cindex Didot point
@findex dd
+@anchor{units of length dd}
Didot point, 1.07 pt
@item cc
@cindex Cicero
@findex cc
+@anchor{units of length cc}
Cicero, 12 dd
@item sp
@cindex Scaled point
@findex sp
+@anchor{units of length sp}
Scaled point, 1/65536 pt
@end table
@@ -7525,9 +9859,15 @@ Scaled point, 1/65536 pt
@cindex m-width
@cindex em
@findex em
+@anchor{Lengths/em}
+@anchor{Lengths/en}
+@anchor{Lengths/ex}
+@anchor{units of length em}
+@anchor{units of length en}
+@anchor{units of length ex}
Two other lengths that are often used are values set by the designer of
the font. The x-height of the current font @dfn{ex}, traditionally the
-height of the lower case letter x, is often used for vertical
+height of the lowercase letter x, is often used for vertical
lengths. Similarly @dfn{em}, traditionally the width of the capital
letter M, is often used for horizontal lengths (there is also
@code{\enspace}, which is @code{0.5em}). Use of these can help make a
@@ -7553,14 +9893,27 @@ math symbols family. @xref{Spacing in math mode}.
Synopsis:
@example
-\setlength@{@var{\len}@}@{@var{amount}@}
+\setlength@{@var{len}@}@{@var{amount}@}
@end example
-The @code{\setlength} sets the value of @dfn{length command}
-@cindex length command
-@code{\@var{len}} to the @var{value} argument which can be expressed in any
-units that @LaTeX{} understands, i.e., inches (@code{in}), millimeters
-(@code{mm}), points (@code{pt}), big points (@code{bp}), etc.
+Set the length @var{len} to @var{amount}. The length name @var{len}
+must begin with a backslash, @code{\}. The @code{amount} can be a
+rubber length (@pxref{Lengths}). It can be positive, negative or zero,
+and can be in any units that @LaTeX{} understands (@pxref{Units of
+length}).
+
+Below, with @LaTeX{}'s defaults the first paragraph will be indented
+while the second will not.
+
+@example
+I told the doctor I broke my leg in two places.
+
+\setlength@{\parindent@}@{0em@}
+He said stop going to those places.
+@end example
+
+If there is no such length @var{len} then you get something like
+@samp{Undefined control sequence. <argument> \praindent}.
@node \addtolength
@@ -7572,13 +9925,32 @@ units that @LaTeX{} understands, i.e., inches (@code{in}), millimeters
Synopsis:
@example
-\addtolength@{@var{\len}@}@{@var{amount}@}
+\addtolength@{@var{len}@}@{@var{amount}@}
@end example
+Increment the length @var{len} by @var{amount}. The length name
+@var{len} begins with a backslash, @code{\}. The @code{amount} is a
+rubber length (@pxref{Lengths}). It can be positive, negative or zero,
+and can be in any units that @LaTeX{} understands (@pxref{Units of
+length}).
+
+Below, if @code{\parskip} starts with the value @code{0pt plus 1pt}
-The @code{\addtolength} command increments a length command @code{\@var{len}}
-by the amount specified in the @var{amount} argument, which may be
-negative.
+@example
+\addtolength@{\parskip@}@{1pt@}
+Doctor: how is the boy who swallowed the silver dollar?
+
+Nurse: no change.
+@end example
+
+@noindent
+then it has the value @code{1pt plus 1pt} for the second paragraph.
+
+If there is no such length @var{len} then you get something like
+@samp{Undefined control sequence. <argument> \praindent}. If you leave
+off the backslash at the start of @var{len}, as in
+@code{\addtolength@{parindent@}@{1pt@}}, then you get something like
+@samp{You can't use `the letter p' after \advance}.
@node \settodepth
@@ -7589,11 +9961,26 @@ negative.
Synopsis:
@example
-\settodepth@{\@var{len}@}@{@var{text}@}
+\settodepth@{@var{len}@}@{@var{text}@}
+@end example
+
+Set the length @var{len} to the depth of box that @LaTeX{} gets on
+typesetting the @var{text} argument. The length name @var{len} must
+begin with a backslash, @code{\}.
+
+This will show how low the character descenders go.
+
+@example
+\newlength@{\alphabetdepth@}
+\settodepth@{\alphabetdepth@}@{abcdefghijklmnopqrstuvwxyz@}
+\the\alphabetdepth
@end example
-The @code{\settodepth} command sets the value of a length command
-@code{\@var{len}} equal to the depth of the @var{text} argument.
+If there is no such length @var{len} then you get something like
+@samp{Undefined control sequence. <argument> \alphabetdepth}. If you
+leave the backslash out of @var{len}, as in
+@code{\settodepth@{alphabetdepth@}@{...@}} then you get something like
+@samp{Missing number, treated as zero. <to be read again> \setbox}.
@node \settoheight
@@ -7604,56 +9991,85 @@ The @code{\settodepth} command sets the value of a length command
Synopsis:
@example
-\settoheight@{\@var{len}@}@{text@}
+\settoheight@{@var{len}@}@{text@}
@end example
-The @code{\settoheight} command sets the value of a length command @code{\@var{len}}
-equal to the height of the @code{text} argument.
+Sets the length @var{len} to the height of box that @LaTeX{} gets on
+typesetting the @code{text} argument. The length name @var{len} must
+begin with a backslash, @code{\}.
+
+This will show how high the characters go.
+
+@example
+\newlength@{\alphabetheight@}
+\settoheight@{\alphabetheight@}@{abcdefghijklmnopqrstuvwxyz@}
+\the\alphabetheight
+@end example
+If there is no such length @var{len} then you get something like
+@samp{Undefined control sequence. <argument> \alphabetheight}. If you
+leave the backslash out of @var{len}, as in
+@code{\settoheight@{alphabetheight@}@{...@}} then you get something like
+@samp{Missing number, treated as zero. <to be read again> \setbox}.
@node \settowidth
-@section @code{\settowidth@{\@var{len}@}@{@var{text}@}}
+@section @code{\settowidth}
@findex \settowidth
Synopsis:
@example
-\settowidth@{\@var{len}@}@{@var{text}@}
+\settowidth@{@var{len}@}@{@var{text}@}
@end example
-The @code{\settowidth} command sets the value of the command @var{\len}
-to the width of the @var{text} argument.
+Set the length @var{len} to the width of the box that @LaTeX{} gets on
+typesetting the @var{text} argument. The length name @var{len} must
+begin with a backslash, @code{\}.
+This measures the width of the lowercase ASCII alphabet.
-@node Predefined lengths
-@section Predefined lengths
+@example
+\newlength@{\alphabetwidth@}
+\settowidth@{\alphabetwidth@}@{abcdefghijklmnopqrstuvwxyz@}
+\the\alphabetwidth
+@end example
-@cindex lengths, predefined
-@cindex predefined lengths
+If there is no such length @var{len} then you get something like
+@samp{Undefined control sequence. <argument> \alphabetwidth}. If you
+leave the backslash out of @var{len}, as in
+@code{\settoheight@{alphabetwidth@}@{...@}} then you get something like
+@samp{Missing number, treated as zero. <to be read again> \setbox}.
-@code{\width}
-@findex \width
-@code{\height}
-@findex \height
+@c @node Predefined lengths
+@c @section Predefined lengths
-@code{\depth}
-@findex \depth
+@c @cindex lengths, predefined
+@c @cindex predefined lengths
-@code{\totalheight}
-@findex \totalheight
+@c @code{\width}
+@c @findex \width
-These length parameters can be used in the arguments of the box-making
-commands (@pxref{Boxes}). They specify the natural width, etc., of
-the text in the box. @code{\totalheight} equals @math{@code{@backslashchar{}height} +
-@code{@backslashchar{}depth}}. To make a box with the text stretched to double the
-natural size, e.g., say
+@c @code{\height}
+@c @findex \height
-@example
-\makebox[2\width]@{Get a stretcher@}
-@end example
+@c @code{\depth}
+@c @findex \depth
+
+@c @code{\totalheight}
+@c @findex \totalheight
+
+@c These length parameters can be used in the arguments of the box-making
+@c commands (@pxref{Boxes}). They specify the natural width, etc., of the
+@c text in the box. @code{\totalheight} equals
+@c @math{@code{@backslashchar{}height} + @code{@backslashchar{}depth}}. To
+@c make a box with the text stretched to double the natural size, e.g., say
+
+@c @example
+@c \makebox[2\width]@{Get a stretcher@}
+@c @end example
@node Making paragraphs
@@ -7662,43 +10078,155 @@ natural size, e.g., say
@cindex making paragraphs
@cindex paragraphs
-A paragraph is ended by one or more completely blank lines---lines not
-containing even a @code{%}. A blank line should not appear where a new
-paragraph cannot be started, such as in math mode or in the argument of
-a sectioning command.
+Once @LaTeX{} has all of a paragraph's contents it divides it into
+lines, in a way that is optimized over the entire paragraph (@pxref{Line
+breaking}). To end the current paragraph, put an empty line.
+
+@example
+It is a truth universally acknowledged, that a single man in possession
+of a good fortune, must be in want of a wife.
+
+However little known the feelings or views of such a man may be on his
+first entering a neighbourhood, this truth is so well fixed in the minds
+of the surrounding families, that he is considered the rightful property
+of some one or other of their daughters.
+
+``My dear Mr. Bennet,'' said his lady to him one day,
+``have you heard that Netherfield Park is let at last?''
+@end example
+
+The separator lines must be empty, including not containing a comment
+character, @code{%}.
+
+There are places where a new paragraph is not permitted. Don't put a
+blank line in math mode (@pxref{Modes}); here the line before the
+@code{\end@{equation@}}
+
+@example
+\begin@{equation@}
+ 2^@{|S|@} > |S|
+
+\end@{equation@}
+@end example
+
+@noindent
+will get you the error @samp{Missing $ inserted}. Similarly, the blank
+line in this @code{section} argument
+
+@example
+\section@{aaa
+
+bbb@}
+@end example
+
+@noindent
+gets @samp{Runaway argument? @{aaa ! Paragraph ended before \@@sect was
+complete}.
+
@menu
-* \indent:: Indent this paragraph.
-* \noindent:: Do not indent this paragraph.
-* \parskip:: Space added before paragraphs.
-* Marginal notes:: Putting remarks in the margin.
+* \par:: End the current paragraph.
+* \indent & \noindent:: Go into horizontal mode, possibly with an indent.
+* \parindent & \parskip:: Space added before paragraphs.
+* Marginal notes:: Put remarks in the margin.
@end menu
-@node \indent
-@section @code{\indent}
+@node \par
+@section @code{\par}
+
+@findex \par
+@cindex paragraph, ending
+
+Synopsis (note that while reading the input @TeX{}, converts two
+consecutive newlines to a @code{\par}):
+
+@example
+\par
+@end example
+
+End the current paragraph. The usual way to separate paragraphs is with
+a blank line but the @code{\par} command is entirely equivalent. This
+command is robust (@pxref{\protect}).
+
+This example uses @code{\par} rather than a blank line simply for
+readability.
+
+@example
+\newcommand@{\syllabusLegalese@}@{%
+ \whatCheatingIs\par\whatHappensWhenICatchYou@}
+@end example
+
+The @code{\par} command does nothing in LR mode or a vertical mode but
+it terminates paragraph mode, bringing @LaTeX{} to vertical mode
+(@pxref{Modes}).
+
+You cannot use the @code{\par} command in math mode or in the argument
+of many commands, such as the @code{\section} command (@pxref{Making
+paragraphs} and @pxref{\newcommand & \renewcommand}).
+
+The @code{\par} command differs from the @code{\paragraph} command in
+that the latter is, like @code{\section} or @code{\subsection}, a
+sectioning unit used by the standard @LaTeX{} documents.
+
+The @code{\par} command differs from @code{\newline} and the line break
+double backslash, @code{\\}, in that \par ends the paragraph not just
+the line. It also triggers the addition of the between-paragraph
+vertical space @code{\parskip} (@pxref{\parindent & \parskip}).
+
+The output from this example
+
+@example
+xyz
+
+\setlength@{\parindent@}@{3in@}
+\setlength@{\parskip@}@{5in@}
+\noindent test\indent test1\par test2
+@end example
+
+@noindent
+is: after @samp{xyz} there is a vertical skip of 5@tie{}inches and then
+@samp{test} appears, aligned with the left margin. On the same line,
+there is an empty horizontal space of 3@tie{}inches and then
+@samp{test1} appears. Finally. there is a vertical space of
+5@tie{}inches, followed by a fresh paragraph with a paragraph indent of
+3@tie{}inches, and then @LaTeX{} puts the text @samp{test2}.
+
+
+@node \indent & \noindent
+@section @code{\indent} & @code{\noindent}
@findex \indent
+@findex \noindent
@findex \parindent
@cindex indent, forcing
-@code{\indent} produces a horizontal space whose width equals to the
-@code{\parindent} length, the normal paragraph indentation. It is used
-to add paragraph indentation where it would otherwise be suppressed.
+Synopsis:
+
+@example
+\indent
+@end example
+
+@noindent or
-The default value for @code{\parindent} is @code{1em} in two-column
-mode, otherwise @code{15pt} for @code{10pt} documents, @code{17pt} for
-@code{11pt}, and @code{1.5em} for @code{12pt}.
+@example
+\noindent
+@end example
+Go into horizontal mode (@pxref{Modes}). The @code{\indent} command
+first outputs an empty box whose width is @code{\parindent}. These
+commands are robust (@pxref{\protect}).
-@node \noindent
-@section @code{\noindent}
+Ordinarily you create a new paragraph by putting in a blank line.
+@xref{\par} for the difference between this command and @code{\par}. To
+start a paragraph without an indent, or to continue an interrupted
+paragraph, use @code{\noindent}.
-@findex \noindent
-@cindex indent, suppressing
+In the middle of a paragraph the @code{\noindent} command has no effect,
+because @LaTeX{} is already in horizontal mode there. The
+@code{\indent} command's only effect is to output a space.
-When used at the beginning of the paragraph, this command suppresses any
-paragraph indentation, as in this example.
+This example starts a fresh paragraph.
@example
... end of the prior paragraph.
@@ -7706,20 +10234,67 @@ paragraph indentation, as in this example.
\noindent This paragraph is not indented.
@end example
-It has no effect when used in the middle of a paragraph.
+@noindent
+and this continues an interrupted paragraph.
-To eliminate paragraph indentation in an entire document, put
-@code{\setlength@{\parindent@}@{0pt@}} in the preamble.
+@example
+The data
+
+\begin@{center@}
+ \begin@{tabular@}@{rl@} ... \end@{tabular@}
+\end@{center@}
+
+\noindent shows this clearly.
+@end example
+To omit indentation in the entire document put
+@code{\setlength@{\parindent@}@{0pt@}} in the preamble. If you do that,
+you may want to also set the length of spaces between paragraphs,
+@code{\parskip} (@pxref{\parindent & \parskip}).
-@node \parskip
-@section @code{\parskip}
+@PkgIndex{indentfirst}
+Default @LaTeX{} styles have the first paragraph after a section that is
+not indented, as is traditional typesetting in English. To change that,
+look on CTAN for the package @code{indentfirst}.
+
+@node \parindent & \parskip
+@section @code{\parindent} & @code{\parskip}
+
+@findex \parindent
@findex \parskip
+@cindex paragraph indentation
@cindex vertical space before paragraphs
-@code{\parskip} is a rubber length defining extra vertical space added
-before each paragraph. The default is @code{0pt plus1pt}.
+Synopsis:
+
+@example
+\setlength@{\parskip@}@{@var{horizontal len}@}
+\setlength@{\parinden@}@{@var{vertical len}@}
+@end example
+
+Both are a rubber lengths (@pxref{Lengths}). They give the indentation
+of ordinary paragraphs, not paragraphs inside minipages
+(@pxref{minipage}), and the vertical space between paragraphs.
+
+This, put in the preamble,
+
+@example
+\setlength@{\parindent@}@{0em@}
+\setlength@{\parskip@}@{1ex@}
+@end example
+
+@noindent
+arranges that the document will have paragraphs that are not indented,
+but instead are vertically separated by about the height of a lowercase
+@samp{x}.
+
+In standard @LaTeX{} documents, the default value for @code{\parindent}
+in one-column documents is @code{15pt} when the default text size is
+@code{10pt} , @code{17pt} for @code{11pt}, and @code{1.5em} for
+@code{12pt}. In two-column documents it is @code{1em}. The default
+value for @code{\parskip} in @LaTeX{}'s standard document styles is
+@code{0pt plus1pt}.
@node Marginal notes
@@ -7730,52 +10305,55 @@ before each paragraph. The default is @code{0pt plus1pt}.
@cindex remarks in the margin
@findex \marginpar
-Synopsis:
+Synopsis, one of:
@example
+\marginpar@{@var{right}@}
\marginpar[@var{left}]@{@var{right}@}
@end example
-The @code{\marginpar} command creates a note in the margin. The first
-line of the note will have the same baseline as the line in the text
-where the @code{\marginpar} occurs.
+Create a note in the margin. The first line of the note will have the
+same baseline as the line in the text where the @code{\marginpar}
+occurs.
-When you only specify the mandatory argument @var{right}, the text
-will be placed
-
-@itemize @bullet
-@item
-in the right margin for one-sided layout (option @code{oneside}, see @ref{Document class options});
-@item
-in the outside margin for two-sided layout (option @code{twoside}, see @ref{Document class options});
-@item
-in the nearest margin for two-column layout (option @code{twocolumn}, see @ref{Document class options}).
-@end itemize
+The margin that @LaTeX{} uses for the note depends on the current layout
+(@pxref{Document class options}) and also on @code{\reversemarginpar}
+(see below). If you are using one-sided layout (document option
+@code{oneside}) then it goes in the right margin. If you are using
+two-sided layout (document option @code{twoside}) then it goes in the
+outside margin. If you are in two-column layout (document option
+@code{twocolumn}) then it goes in the nearest margin.
@findex \reversemarginpar
@findex \normalmarginpar
-The command @code{\reversemarginpar} places subsequent marginal notes
-in the opposite (inside) margin. @code{\normalmarginpar} places them
-in the default position.
+If you declare @code{\reversemarginpar} then @LaTeX{} will place
+subsequent marginal notes in the opposite margin to that given in the
+prior paragraph. Revert that to the default position with
+@code{\normalmarginpar}.
-When you specify both arguments, @var{left} is used for the left
-margin, and @var{right} is used for the right margin.
+When you specify the optional argument @var{left} then it is used for a
+note in the left margin, while the mandatory argument @var{right} is
+used for a note in the the right margin.
-The first word will normally not be hyphenated; you can enable
-hyphenation there by beginning the node with @code{\hspace@{0pt@}}.
+Normally, a note's first word will not be hyphenated. You can enable
+hyphenation there by beginning @var{left} or @var{right} with
+@code{\hspace@{0pt@}}.
These parameters affect the formatting of the note:
@ftable @code
@item \marginparpush
+@anchor{marginal notes marginparpush}
Minimum vertical space between notes; default @samp{7pt} for
@samp{12pt} documents, @samp{5pt} else.
@item \marginparsep
+@anchor{marginal notes marginparsep}
Horizontal space between the main text and the note; default
@samp{11pt} for @samp{10pt} documents, @samp{10pt} else.
@item \marginparwidth
+@anchor{marginal notes marginparwidth}
Width of the note itself; default for a one-sided @samp{10pt} document
is @samp{90pt}, @samp{83pt} for @samp{11pt}, and @samp{68pt} for
@samp{12pt}; @samp{17pt} more in each case for a two-sided document.
@@ -7800,65 +10378,124 @@ notes from falling off the bottom of the page.
@EnvIndex{displaymath}
@EnvIndex{equation}
-There are three environments that put @LaTeX{} in math mode:
+Produce mathematical text by putting @LaTeX{} into math mode or display
+math mode (@pxref{Modes}). This example shows both.
-@table @code
-@item math
-For formulas that appear right in the text.
-@item displaymath
-For formulas that appear on their own line.
-@item equation
-The same as the displaymath environment except that it adds an equation
-number in the right margin.
-@end table
+@example
+The wave equation for \( u \) is
+\begin@{displaymath@}
+ \frac@{\partial^2u@}@{\partial t^2@} = c^2\nabla^2u
+\end@{displaymath@}
+where \( \nabla^2 \) is the spatial Laplacian and \( c \) is constant.
+@end example
-@findex \(
-@findex \)
-@findex \[
-@findex \]
-The @code{math} environment can be used in both paragraph and LR mode,
-but the @code{displaymath} and @code{equation} environments can be used
-only in paragraph mode. The @code{math} and @code{displaymath}
-environments are used so often that they have the following short forms:
+@noindent
+Math mode is for inline mathematics. In the above example it is invoked
+by the starting @code{\(} and finished by the matching ending @code{\)}.
+Display math mode is for displayed equations and here is invoked by the
+@code{displaymath} environment. Note that any mathematical text
+whatever, including mathematical text consisting of just one character,
+is handled in math mode.
+
+When in math mode or display math mode, @LaTeX{} handles many aspects of
+your input text differently than in other text modes. For example,
@example
-\(...\) @r{instead of} \begin@{math@}...\end@{math@}
-\[...\] @r{instead of} \begin@{displaymath@}...\end@{displaymath@}
+contrast x+y with \( x+y \)
@end example
-@findex $
-In fact, the @code{math} environment is so common that it has an even
-shorter form:
+@noindent
+in math mode the letters are in italics and the spacing around the plus
+sign is different.
+
+There are three ways to make inline formulas, to put @LaTeX{} in math
+mode.
@example
-$ ... $ @r{instead of} \(...\)
+\( @var{mathematical material} \)
+$ @var{mathematical material} $
+\begin@{math@} @var{mathematical material} \end@{math@}
@end example
-@findex \boldmath
-@findex \unboldmath
-The @code{\boldmath} command changes math letters and symbols to be in
-a bold font. It is used @emph{outside} of math mode. Conversely, the
-@code{\unboldmath} command changes math glyphs to be in a normal font;
-it too is used @emph{outside} of math mode.
+@noindent
+The first form is preferred and the second is quite common, but the
+third form is rarely used. You can sometimes use one and sometimes
+another, as in @code{\(x\) and $y$}. You can use these in paragraph
+mode or in LR mode (@pxref{Modes}).
-@c xx own section? Math fonts?
-@findex \displaystyle
-The @code{\displaystyle} declaration forces the size and style of the
-formula to be that of @code{displaymath}, e.g., with limits above and
-below summations. For example:
+To make displayed formulas, put @LaTeX{} into display math mode with
+either:
@example
-$\displaystyle \sum_@{n=0@}^\infty x_n $
+\begin@{displaymath@}
+ @var{mathematical material}
+\end@{displaymath@}
@end example
-@c xx see also \cal, \mathcal
+@noindent
+or
+
+@example
+\begin@{equation@}
+ @var{mathematical material}
+\end@{equation@}
+@end example
+
+@noindent
+(@pxref{displaymath}, @pxref{equation}). The only difference is that
+with the @code{equation} environment, @LaTeX{} puts a formula number
+alongside the formula. The construct @code{\[ @var{math} \]} is
+equivalent to @code{\begin@{displaymath@} @var{math}
+\end@{displaymath@}}. These environments can only be used in paragraph
+mode (@pxref{Modes}).
+
+@findex \displaystyle
+The two mathematics modes are similar, but there are some differences.
+One involves the placement of subscripts and superscripts; in display
+math mode they are further apart and in inline math mode they are closer
+together.
+
+Sometimes you want the display math typographical treatment to happen in
+the inline math mode. For this, the @code{\displaystyle} declaration
+forces the size and style of the formula to be that of
+@code{displaymath}. Thus @code{\(\displaystyle \sum_@{n=0@}^\infty
+x_n\)} will have the limits above and below the summation sign, not next
+to it. Another example is that
+
+@example
+\begin@{tabular@}@{r|cc@}
+ \textsc@{Name@} &\textsc@{Series@} &\textsc@{Sum@} \\ \hline
+ Arithmetic &\( a+(a+b)+(a+2b)+\cdots+(a+(n-1)b) \)
+ &\( na+(n-1)n\cdot\frac@{b@}@{2@}\) \\
+ Geometric &\( a+ab+ab^2+\cdots+ab^@{n-1@} \)
+ &\(\displaystyle a\cdot\frac@{1-b^n@}@{1-b@}\) \\
+\end@{tabular@}
+@end example
+
+@noindent
+because it has no @code{\displaystyle}, the @samp{Arithmetic} line's
+fraction will be scrunched. But, because of its @code{\displaystyle},
+the @samp{Geometric} line's fraction will be easy to read, with
+characters the same size as in the rest of the line.
+
+@PkgIndex{amsmath}
+@PkgIndex{amsfonts}
+@PkgIndex{mathtools}
+The American Mathematical Society has made freely available a set of
+packages that greatly expand your options for writing mathematics,
+@file{amsmath} and @file{amssymb} (also be aware of the @file{mathtools}
+package that is an extension to, and loads, @file{amsmath}). New
+documents that will have mathematical text should use these packages.
+Descriptions of these packages is outside the scope of this document;
+see their documentation on CTAN.
@menu
* Subscripts & superscripts:: Also known as exponent or index.
* Math symbols:: Various mathematical squiggles.
* Math functions:: Math function names like sin and exp.
* Math accents:: Accents in math.
-* Spacing in math mode:: Thick, medium, thin and negative spaces.
+* Over- and Underlining:: Things over or under formulas.
+* Spacing in math mode:: Thick, medium, thin, and negative spaces.
* Math miscellany:: Stuff that doesn't fit anywhere else.
@end menu
@@ -7872,42 +10509,79 @@ $\displaystyle \sum_@{n=0@}^\infty x_n $
@findex _
@findex ^
-In math mode, use the caret character@tie{}@code{^} to make the
-@var{exp} appear as a superscript: @code{^@{@var{exp}@}}.
-Similarly, in math mode, underscore@tie{}@code{_@{@var{exp}@}} makes a
-subscript out of @var{exp}.
+Synopsis (in math mode or display math mode), one of:
-In this example the @code{0} and @code{1} appear as subscripts while the
-@code{2} is a superscript.
+@example
+@var{base}^@var{exp}
+@var{base}^@{@var{exp}@}
+@end example
+
+@noindent
+or, one of:
@example
-\( (x_0+x_1)^2 \)
+@var{base}_@var{exp}
+@var{base}_@{@var{exp}@}
@end example
-To have more than one character in @var{exp} use curly braces as in
-@code{e^@{-2x@}}.
+Make @var{exp} appear as a superscript of @var{base} (with the caret
+character,@tie{}@code{^}) or a subscript (with
+underscore,@tie{}@code{_}).
+
+In this example the @code{0}'s and @code{1}'s are subscripts while the
+@code{2}'s are superscripts.
+
+@example
+\( (x_0+x_1)^2 \leq (x_0)^2+(x_1)^2 \)
+@end example
+
+To have the subscript or superscript contain more than one character,
+surround the expression with curly braces, as in @code{e^@{-2x@}}.
+This example's fourth line shows curly braces used to group an expression
+for the exponent.
+
+@example
+\begin@{displaymath@}
+ (3^3)^3=27^3=19\,683
+ \qquad
+ 3^@{(3^3)@}=3^@{27@}=7\,625\,597\,484\,987
+\end@{displaymath@}
+@end example
+
+@LaTeX{} knows how to handle a superscript on a superscript, or a
+subscript on a subscript, or supers on subs, or subs on supers. So,
+expressions such as @code{e^@{x^2@}} and @code{x_@{i_0@}} give correct
+output. Note the use in those expressions of curly braces to give the
+@var{base} a determined @var{exp}. If you enter @code{\(3^3^3\)} then
+you get @samp{Double superscript}.
+
+@LaTeX{} does the right thing when something has both a subscript and a
+superscript. In this example the integral has both. They come out in
+the correct place without any author intervention.
-@LaTeX{} handles superscripts on superscripts, and all of that stuff, in
-the natural way, so expressions such as @code{e^@{x^2@}} and
-@code{x_@{a_0@}} will look right. It also does the right thing when
-something has both a subscript and a superscript. In this example the
-@code{0} appears at the bottom of the integral sign while the @code{10}
-appears at the top.
-
@example
-\int_0^@{10@} x^2 \,dx
+\begin@{displaymath@}
+ \int_@{x=a@}^b f'(x)\,dx = f(b)-f(a)
+\end@{displaymath@}
@end example
-You can put a superscript or subscript before a symbol with a construct
-such as @code{@{@}_t K^2} in math mode (the initial @code{@{@}} prevents
-the prefixed subscript from being attached to any prior symbols in the
-expression).
+@noindent
+Note the parentheses around @code{x=a} to make the entire expression a
+subscript.
+
+To put a superscript or subscript before a symbol, use a construct like
+@code{@{@}_t K^2}. The empty curly braces @code{@{@}} give the
+subscript something to attach to and keeps it from accidentally
+attaching to a prior symbols.
+
+Using the subscript or superscript command outside of math mode or
+display math mode, as in @code{the expression x^2}, will get you
+the error @samp{Missing $ inserted}.
-Outside of math mode, a construct like @code{A
-test$_\textnormal@{subscript@}$} will produce a subscript typeset in
-text mode, not math mode. Note that there are packages specialized for
-writing Chemical formulas such as @file{mhchem}.
-@c xx display mode
+@PkgIndex{mhchem}
+A common reason to want subscripts outside of a mathematics mode is to
+typeset chemical formulas. There are packages for that such as
+@file{mhchem}; see CTAN.
@node Math symbols
@@ -7917,19 +10591,20 @@ writing Chemical formulas such as @file{mhchem}.
@cindex symbols, math
@cindex greek letters
-@LaTeX{} provides almost any mathematical symbol you're likely to need.
-For example, if you include @code{$\pi$} in your source, you will get
-the pi symbol @BES{03C0,\pi}.
-
-Below is a list of commonly-available symbols. It is by no means an
-exhaustive list. Each symbol here is described with a short phrase, and
-its symbol class (which determines the spacing around it) is given in
-parenthesis. Unless said otherwise, the commands for these symbols can
-be used only in math mode.
+@PkgIndex{symbols}
-To redefine a command so that it can be used whatever the current mode,
-see @ref{\ensuremath}.
+@LaTeX{} provides almost any mathematical or technical symbol that
+anyone uses. For example, if you include @code{$\pi$} in your source,
+you will get the pi symbol @BES{03C0,\pi}. See the @file{Comprehensive
+@LaTeX{} Symbol List} at
+@url{https://ctan.org/tex-archive/info/symbols/comprehensive/}.
+Here is a list of commonly-used symbols. It is by no means exhaustive.
+Each symbol is described with a short phrase, and its symbol class,
+which determines the spacing around it, is given in parenthesis. Unless
+said otherwise, the commands for these symbols can be used only in math
+mode. To redefine a command so that it can be used whatever the current
+mode, see @ref{\ensuremath}.
@c xx Add Negation: @code{} for negations of relevant symbols
@c Useful: http://www.w3.org/TR/WD-math-970515/section6.html
@@ -7942,7 +10617,7 @@ see @ref{\ensuremath}.
@BES{2135,\aleph} Aleph, transfinite cardinal (ordinary).
@item \alpha
-@BES{03B1,\alpha} Lower case Greek letter alpha (ordinary).
+@BES{03B1,\alpha} Lowercase Greek letter alpha (ordinary).
@item \amalg
@BES{2A3F,\amalg} Disjoint union (binary)
@@ -7969,7 +10644,7 @@ sometimes reserved for cross-correlation.
@code{\textbackslash} for backslash outside of math mode.
@item \beta
-@BES{03B2,\beta} Lower case Greek letter beta (ordinary).
+@BES{03B2,\beta} Lowercase Greek letter beta (ordinary).
@item \bigcap
@BES{22C2,\bigcap} Variable-sized, or n-ary, intersection (operator). Similar:
@@ -8014,14 +10689,14 @@ union@tie{}@code{\cup}.
@BES{22C0,\bigwedge} Variable-sized, or n-ary, logical-or (operator).
@item \bot
-@BESU{22A5,bot} Up tack, bottom, least element of a partially ordered
+@BES{22A5,} Up tack, bottom, least element of a partially ordered
set, or a contradiction (ordinary). See also@tie{}@code{\top}.
@item \bowtie
@BES{22C8,\bowtie} Natural join of two relations (relation).
@item \Box
-@BESU{25A1,Box} Modal operator for necessity; square open box
+@BES{25A1,} Modal operator for necessity; square open box
(ordinary). @value{NeedsAMSSymb}
@c bb Best Unicode equivalent?
@@ -8039,7 +10714,7 @@ operator@tie{}@code{\bigcap}.
dot@tie{}@code{\bullet}.
@item \chi
-@BES{03C7,\chi} Lower case Greek chi (ordinary).
+@BES{03C7,\chi} Lowercase Greek chi (ordinary).
@item \circ
@BES{2218,\circ} Function composition, ring operator (binary). Similar:
@@ -8049,9 +10724,9 @@ variable-sized operator@tie{}@code{\bigcirc}.
@BES{2663,\clubsuit} Club card suit (ordinary).
@item \complement
-@BESU{2201,complement} Set complement, used as a superscript as in
-@code{$S^\complement$} (ordinary). @value{NeedsAMSSymb} Also
-used: @code{$S^@{\mathsf@{c@}@}$} or@tie{}@code{$\bar@{S@}$}.
+@BES{2201,} Set complement, used as a superscript as in
+@code{$S^\complement$} (ordinary). @value{NeedsAMSSymb} Also used:
+@code{$S^@{\mathsf@{c@}@}$} or@tie{}@code{$\bar@{S@}$}.
@item \cong
@BES{2245,\cong} Congruent (relation).
@@ -8074,17 +10749,16 @@ turnstile@tie{}@code{\vdash}.
@BES{2021,\ddagger} Double dagger relation (binary).
@item \Delta
-@BES{0394,\Delta} Greek upper case delta, used for increment (ordinary).
+@BES{0394,\Delta} Greek uppercase delta, used for increment (ordinary).
@item \delta
-@BES{03B4,\delta} Greek lower case delta (ordinary).
+@BES{03B4,\delta} Greek lowercase delta (ordinary).
@item \Diamond
-@BESU{25C7,Diamond} Large diamond operator (ordinary). @value{NeedsAMSSymb}
-@c bb Best Unicode equivalent?
+@BES{25C7,} Large diamond operator (ordinary). @value{NeedsAMSSymb}
@item \diamond
-@BES{22C4,\diamond} Diamond operator, or diamond bullet (binary). Similar: large
+@BES{22C4,\diamond} Diamond operator (binary). Similar: large
diamond@tie{}@code{\Diamond}, circle bullet@tie{}@code{\bullet}.
@item \diamondsuit
@@ -8098,12 +10772,12 @@ diamond@tie{}@code{\Diamond}, circle bullet@tie{}@code{\bullet}.
to@tie{}@code{\Doteq}.
@item \downarrow
-@BES{2193,\downarrow} Down arrow, converges (relation). Similar: double line down
-arrow@tie{}@code{\Downarrow}.
+@BES{2193,\downarrow} Down arrow, converges (relation). Similar:
+@code{\Downarrow} double line down arrow.
@item \Downarrow
-@BES{21D3,\Downarrow} Double line down arrow (relation). Similar: single line down
-arrow@tie{}@code{\downarrow}.
+@BES{21D3,\Downarrow} Double line down arrow (relation). Similar:
+@code{\downarrow} single line down arrow.
@item \ell
@BES{2113,\ell} Lowercase cursive letter l (ordinary).
@@ -8114,7 +10788,7 @@ arrow@tie{}@code{\downarrow}.
@c bb Why Unicode has \revemptyset but no \emptyset?
@item \epsilon
-@BES{03F5,\epsilon} Lower case lunate epsilon (ordinary). Similar to
+@BES{03F5,\epsilon} Lowercase lunate epsilon (ordinary). Similar to
Greek text letter. More widely used in mathematics is the script small
letter epsilon @code{\varepsilon}@tie{}@BES{03B5,\varepsilon}. Related:
the set membership relation @code{\in}@tie{}@BES{2208,\in}.
@@ -8125,7 +10799,7 @@ the set membership relation @code{\in}@tie{}@BES{2208,\in}.
@BES{2261,\equiv} Equivalence (relation).
@item \eta
-@BES{03B7,\eta} Lower case Greek letter (ordinary).
+@BES{03B7,\eta} Lowercase Greek letter (ordinary).
@item \exists
@BES{2203,\exists} Existential quantifier (ordinary).
@@ -8140,10 +10814,10 @@ the set membership relation @code{\in}@tie{}@BES{2208,\in}.
@BES{2322,\frown} Downward curving arc (ordinary).
@item \Gamma
-@BES{0393,\Gamma} Upper case Greek letter (ordinary).
+@BES{0393,\Gamma} uppercase Greek letter (ordinary).
@item \gamma
-@BES{03B3,\gamma} Lower case Greek letter (ordinary).
+@BES{03B3,\gamma} Lowercase Greek letter (ordinary).
@item \ge
@BES{2265,\ge} Greater than or equal to (relation). This is a synonym
@@ -8180,8 +10854,13 @@ with a @code{\thickmuskip} on either side.
@item \Im
@BES{2111,\Im} Imaginary part (ordinary). See: real part@tie{}@code{\Re}.
+@item \imath
+@cindex dotless i, math
+Dotless i; used when you are putting an accent on an i (@pxref{Math
+accents}).
+
@item \in
-@BES{2208,\in} Set element (relation). See also: lower case lunate
+@BES{2208,\in} Set element (relation). See also: lowercase lunate
epsilon@tie{}@code{\epsilon}@BES{03F5,\epsilon} and small letter script
epsilon@tie{}@code{\varepsilon}.
@@ -8192,20 +10871,25 @@ epsilon@tie{}@code{\varepsilon}.
@BES{222B,\int} Integral (operator).
@item \iota
-@BES{03B9,\iota} Lower case Greek letter (ordinary).
+@BES{03B9,\iota} Lowercase Greek letter (ordinary).
@item \Join
-@BESU{2A1D,Join} Condensed bowtie symbol (relation). Not available in Plain
+@BES{2A1D,} Condensed bowtie symbol (relation). Not available in Plain
@TeX{}.
+@item \jmath
+@cindex dotless j, math
+Dotless j; used when you are putting an accent on a j (@pxref{Math
+accents}).
+
@item \kappa
-@BES{03BA,\kappa} Lower case Greek letter (ordinary).
+@BES{03BA,\kappa} Lowercase Greek letter (ordinary).
@item \Lambda
-@BES{039B,\Lambda} Upper case Greek letter (ordinary).
+@BES{039B,\Lambda} uppercase Greek letter (ordinary).
@item \lambda
-@BES{03BB,\lambda} Lower case Greek letter (ordinary).
+@BES{03BB,\lambda} Lowercase Greek letter (ordinary).
@item \land
@BES{2227,\land} Logical and (binary). This is a synonym for @code{\wedge}.
@@ -8232,7 +10916,7 @@ shaved off (opening). Matches@tie{}@code{\rceil}.
for@tie{}@code{\leq}.
@item \leadsto
-@BESU{21DD,leadsto} Squiggly right arrow (relation). @value{NeedsAMSSymb}
+@BES{21DD,} Squiggly right arrow (relation). @value{NeedsAMSSymb}
To get this symbol outside of math mode you can put
@code{\newcommand*@{\Leadsto@}@{\ensuremath@{\leadsto@}@}} in the
preamble and then use @code{\Leadsto} instead.
@@ -8269,7 +10953,7 @@ for@tie{}@code{\le}.
@BES{230A,\lfloor} Left floor bracket (opening). Matches:@tie{}@code{\floor}.
@item \lhd
-@BESU{25C1,lhd} Arrowhead, that is, triangle, pointing left (binary).
+@BES{25C1,} Arrowhead, that is, triangle, pointing left (binary).
@value{NeedsAMSSymb} For the normal subgroup symbol you should load
@file{amssymb} and use@tie{}@code{\vartriangleleft} (which is a relation
and so gives better spacing).
@@ -8305,7 +10989,7 @@ double-line right arrow@tie{}@code{\Longrightarrow}.
Similar: longer version@tie{}@code{\longmapsto}.
@item \mho
-@BESU{2127,mho} Conductance, half-circle rotated capital omega (ordinary).
+@BES{2127,} Conductance, half-circle rotated capital omega (ordinary).
@value{NeedsAMSSymb}
@item \mid
@@ -8326,7 +11010,7 @@ for@tie{}@code{\vert} and for norm see the entry for@tie{}@code{\Vert}.
@BES{2213,\mp} Minus or plus (relation).
@item \mu
-@BES{03BC,\mu} Lower case Greek letter (ordinary).
+@BES{03BC,\mu} Lowercase Greek letter (ordinary).
@item \nabla
@BES{2207,\nabla} Hamilton's del, or differential, operator (ordinary).
@@ -8354,20 +11038,20 @@ negation:@tie{}@code{\sim}.
of@tie{}@code{\in}.
@item \not
-@BES{0020,\not}@BES{00A0,}@BES{0338,} Long solidus, or slash, used to overstrike a
+@c the "@ "s put in spaces so the not slash doesn't hit the next char.
+@BES{0020,\not}@ @ @ @ Long solidus, or slash, used to overstrike a
following operator (relation).
-@c Need blank space for it to overstrike
-Many negated operators that don't require @code{\not} are available,
+Many negated operators are available that don't require @code{\not},
particularly with the @file{amssymb} package. For example, @code{\notin}
-is probably typographically preferable to @code{\not\in}.
+is typographically preferable to @code{\not\in}.
@item \notin
@BES{2209,\notin} Not an element of (relation). Similar: not subset
of@tie{}@code{\nsubseteq}.
@item \nu
-@BES{03BD,\nu} Lower case Greek letter (ordinary).
+@BES{03BD,\nu} Lowercase Greek letter (ordinary).
@item \nwarrow
@BES{2196,\nwarrow} North-west arrow (relation).
@@ -8377,13 +11061,14 @@ of@tie{}@code{\nsubseteq}.
operator@tie{}@code{\bigodot}.
@item \oint
-@BES{222E,\oint} Contour integral, integral with circle in the middle (operator).
+@BES{222E,\oint} Contour integral, integral with circle in the middle
+(operator).
@item \Omega
-@BES{03A9,\Omega} Upper case Greek letter (ordinary).
+@BES{03A9,\Omega} uppercase Greek letter (ordinary).
@item \omega
-@BES{03C9,\omega} Lower case Greek letter (ordinary).
+@BES{03C9,\omega} Lowercase Greek letter (ordinary).
@item \ominus
@BES{2296,\ominus} Minus sign, or dash, inside a circle (binary).
@@ -8416,14 +11101,14 @@ same glyph but the spacing is different because it is in the class
ordinary.
@item \phi
-@BES{03D5,\phi} Lower case Greek letter (ordinary). The variant form is
+@BES{03D5,\phi} Lowercase Greek letter (ordinary). The variant form is
@code{\varphi}@tie{}@BES{03C6,\varphi}.
@item \Pi
-@BES{03A0,\Pi} Upper case Greek letter (ordinary).
+@BES{03A0,\Pi} uppercase Greek letter (ordinary).
@item \pi
-@BES{03C0,\pi} Lower case Greek letter (ordinary). The variant form is
+@BES{03C0,\pi} Lowercase Greek letter (ordinary). The variant form is
@code{\varpi}@tie{}@BES{03D6,\varpi}.
@item \pm
@@ -8453,14 +11138,14 @@ single quote@tie{}@code{'} in text mode produces a different character
@BES{221D,\propto} Is proportional to (relation)
@item \Psi
-@BES{03A8,\Psi} Upper case Greek letter (ordinary).
+@BES{03A8,\Psi} uppercase Greek letter (ordinary).
@item \psi
-@BES{03C8,\psi} Lower case Greek letter (ordinary).
+@BES{03C8,\psi} Lowercase Greek letter (ordinary).
@item \rangle
-@BES{27E9,\rangle} Right angle, or sequence, bracket (closing). Similar: greater
-than@tie{}@code{>}. Matches:@code{\langle}.
+@BES{27E9,\rangle} Right angle, or sequence, bracket (closing).
+Similar: greater than@tie{}@code{>}. Matches:@code{\langle}.
@item \rbrace
@BES{007D,\rbrace} Right curly brace
@@ -8479,11 +11164,11 @@ double-line, or blackboard bold, R@tie{}@code{\mathbb@{R@}}; to access
this, load the @file{amsfonts} package.
@item \restriction
-@BESU{21BE,restriction} Restriction of a function
-(relation). Synonym:@tie{}@code{\upharpoonright}. @value{NeedsAMSSymb}
+@BES{21BE,} Restriction of a function (relation). Synonym:
+@code{\upharpoonright}. @value{NeedsAMSSymb}
@item \revemptyset
-@BESU{29B0,revemptyset} Reversed empty set symbol (ordinary). Related:
+@BES{29B0,} Reversed empty set symbol (ordinary). Related:
@code{\varnothing}. @value{NeedsSTIX}
@item \rfloor
@@ -8491,47 +11176,52 @@ this, load the @file{amsfonts} package.
off (closing). Matches@tie{}@code{\lfloor}.
@item \rhd
-@BESU{25C1,rhd} Arrowhead, that is, triangle, pointing right (binary).
+@BES{25C1,} Arrowhead, that is, triangle, pointing right (binary).
@value{NeedsAMSSymb} For the normal subgroup symbol you should instead
-load @file{amssymb} and use@tie{}@code{\vartriangleright} (which
-is a relation and so gives better spacing).
+load @file{amssymb} and use@tie{}@code{\vartriangleright} (which is a
+relation and so gives better spacing).
@item \rho
-@BES{03C1,\rho} Lower case Greek letter (ordinary). The variant form is
+@BES{03C1,\rho} Lowercase Greek letter (ordinary). The variant form is
@code{\varrho}@tie{}@BES{03F1,\varrho}.
@item \Rightarrow
-@BES{21D2,\Rightarrow} Implies, right-pointing double line arrow (relation). Similar:
-right single-line arrow@tie{}@code{\rightarrow}.
+@BES{21D2,\Rightarrow} Implies, right-pointing double line arrow
+(relation). Similar: right single-line arrow@tie{}@code{\rightarrow}.
@item \rightarrow
-@BES{2192,\rightarrow} Right-pointing single line arrow (relation). Synonym:@tie{}@code{\to}. Similar: right double line arrow@tie{}@code{\Rightarrow}.
+@BES{2192,\rightarrow} Right-pointing single line arrow (relation).
+Synonym:@tie{}@code{\to}. Similar: right double line
+arrow@tie{}@code{\Rightarrow}.
@item \rightharpoondown
-@BES{21C1,\rightharpoondown} Right-pointing harpoon with barb below the line (relation).
+@BES{21C1,\rightharpoondown} Right-pointing harpoon with barb below
+the line (relation).
@item \rightharpoonup
-@BES{21C0,\rightharpoonup} Right-pointing harpoon with barb above the line (relation).
+@BES{21C0,\rightharpoonup} Right-pointing harpoon with barb above the
+line (relation).
@item \rightleftharpoons
-@BES{21CC,\rightleftharpoons} Right harpoon up above left harpoon down (relation).
+@BES{21CC,\rightleftharpoons} Right harpoon up above left harpoon down
+(relation).
@item \searrow
@BES{2198,\searrow} Arrow pointing southeast (relation).
@item \setminus
-@BES{29F5,\setminus} Set difference, reverse solidus or slash, like \
-(binary). Similar: backslash@tie{}@code{\backslash} and also
+@BES{29F5,\setminus} Set difference, reverse solidus or reverse slash,
+like \ (binary). Similar: backslash@tie{}@code{\backslash} and also
@code{\textbackslash} outside of math mode.
@item \sharp
@BES{266F,\sharp} Musical sharp (ordinary).
@item \Sigma
-@BES{03A3,\Sigma} Upper case Greek letter (ordinary).
+@BES{03A3,\Sigma} uppercase Greek letter (ordinary).
@item \sigma
-@BES{03C3,\sigma} Lower case Greek letter (ordinary). The variant form is
+@BES{03C3,\sigma} Lowercase Greek letter (ordinary). The variant form is
@code{\varsigma}@tie{}@BES{03C2,\varsigma}.
@item \sim
@@ -8560,7 +11250,7 @@ union@tie{}@code{cup}. Related: variable-sized
operator@tie{}@code{\bigsqcup}.
@item \sqsubset
-@BESU{228F,sqsubset} Square subset symbol (relation). Similar:
+@BES{228F,} Square subset symbol (relation). Similar:
subset@tie{}@code{\subset}. @value{NeedsAMSSymb}
@item \sqsubseteq
@@ -8568,19 +11258,19 @@ subset@tie{}@code{\subset}. @value{NeedsAMSSymb}
equal to@tie{}@code{\subseteq}.
@item \sqsupset
-@BESU{2290,sqsupset} Square superset symbol (relation). Similar:
+@BES{2290,} Square superset symbol (relation). Similar:
superset@tie{}@code{\supset}. @value{NeedsAMSSymb}
@item \sqsupseteq
-@BES{2292,\sqsupseteq} Square superset or equal symbol (binary). Similar: superset or
-equal@tie{}@code{\supseteq}.
+@BES{2292,\sqsupseteq} Square superset or equal symbol (binary).
+Similar: superset or equal@tie{}@code{\supseteq}.
@item \star
-@BES{22C6,\star} Five-pointed star, sometimes used as a general binary operation
-but sometimes reserved for cross-correlation (binary). Similar: the
-synonyms asterisk@tie{}@code{*} and @code{\ast}, which are six-pointed,
-and more often appear as a superscript or subscript, as with the Kleene
-star.
+@BES{22C6,\star} Five-pointed star, sometimes used as a general binary
+operation but sometimes reserved for cross-correlation (binary).
+Similar: the synonyms asterisk@tie{}@code{*} and @code{\ast}, which
+are six-pointed, and more often appear as a superscript or subscript,
+as with the Kleene star.
@item \subset
@BES{2282,\subset} Subset (occasionally, is implied by) (relation).
@@ -8615,10 +11305,10 @@ that extends to cover the argument.
@BES{2199,\swarrow} Southwest-pointing arrow (relation).
@item \tau
-@BES{03C4,\tau} Lower case Greek letter (ordinary).
+@BES{03C4,\tau} Lowercase Greek letter (ordinary).
@item \theta
-@BES{03B8,\theta} Lower case Greek letter (ordinary). The variant form is
+@BES{03B8,\theta} Lowercase Greek letter (ordinary). The variant form is
@code{\vartheta}@tie{}@BES{03D1,\vartheta}.
@item \times
@@ -8630,7 +11320,7 @@ also@tie{}@code{\cdot}.
Synonym:@tie{}@code{\rightarrow}.
@item \top
-@BESU{22A4,top} Top, greatest element of a partially ordered set
+@BES{22A4,} Top, greatest element of a partially ordered set
(ordinary). See also@tie{}@code{\bot}.
@item \triangle
@@ -8649,16 +11339,16 @@ is a relation and so gives better spacing).
relation and so gives better spacing).
@item \unlhd
-@BESU{22B4,unlhd} Left-pointing not-filled underlined arrowhead, that
-is, triangle, with a line under (binary). @value{NeedsAMSSymb} For
-the normal subgroup symbol load @file{amssymb} and
+@BES{22B4,} Left-pointing not-filled underlined arrowhead, that is,
+triangle, with a line under (binary). @value{NeedsAMSSymb} For the
+normal subgroup symbol load @file{amssymb} and
use@tie{}@code{\vartrianglelefteq} (which is a relation and so gives
better spacing).
@item \unrhd
-@BESU{22B5,unrhd} Right-pointing not-filled underlined arrowhead, that
-is, triangle, with a line under (binary). @value{NeedsAMSSymb} For
-the normal subgroup symbol load @file{amssymb} and
+@BES{22B5,} Right-pointing not-filled underlined arrowhead, that is,
+triangle, with a line under (binary). @value{NeedsAMSSymb} For the
+normal subgroup symbol load @file{amssymb} and
use@tie{}@code{\vartrianglerighteq} (which is a relation and so gives
better spacing).
@@ -8678,12 +11368,14 @@ arrow@tie{}@code{\Uparrow}.
arrow@tie{}@code{\updownarrow}.
@item \updownarrow
-@BES{2195,\updownarrow} Single-line upward-and-downward-pointing arrow (relation). Similar:
-double-line upward-and-downward-pointing arrow@tie{}@code{\Updownarrow}.
+@BES{2195,\updownarrow} Single-line upward-and-downward-pointing arrow
+(relation). Similar: double-line upward-and-downward-pointing
+arrow@tie{}@code{\Updownarrow}.
@item \upharpoonright
-@BESU{21BE,upharpoonright} Up harpoon, with barb on right side
-(relation). Synonym:@tie{}@code{@backslashchar{}restriction}. @value{NeedsAMSSymb}
+@BES{21BE,} Up harpoon, with barb on right side
+(relation). Synonym:@tie{}@code{@backslashchar{}restriction}.
+@value{NeedsAMSSymb}
@item \uplus
@BES{228E,\uplus} Multiset union, a union symbol with a plus symbol in
@@ -8691,10 +11383,10 @@ the middle (binary). Similar: union@tie{}@code{\cup}. Related:
variable-sized operator@tie{}@code{\biguplus}.
@item \Upsilon
-@BES{03A5,\Upsilon} Upper case Greek letter (ordinary).
+@BES{03A5,\Upsilon} uppercase Greek letter (ordinary).
@item \upsilon
-@BES{03C5,\upsilon} Lower case Greek letter (ordinary).
+@BES{03C5,\upsilon} Lowercase Greek letter (ordinary).
@item \varepsilon
@BES{03B5,\varepsilon} Small letter script epsilon (ordinary). This is
@@ -8703,28 +11395,28 @@ more widely used in mathematics than the non-variant lunate epsilon form
membership@tie{}@code{\in}.
@item \vanothing
-@BESU{2205,varnothing} Empty set symbol. Similar:
-@code{\emptyset}. Related: @code{\revemptyset}. @value{NeedsAMSSymb}
+@BES{2205,} Empty set symbol. Similar: @code{\emptyset}. Related:
+@code{\revemptyset}. @value{NeedsAMSSymb}
@item \varphi
-@BES{03C6,\varphi} Variant on the lower case Greek letter (ordinary).
+@BES{03C6,\varphi} Variant on the lowercase Greek letter (ordinary).
The non-variant form is @code{\phi}@tie{}@BES{03D5,\phi}.
@item \varpi
-@BES{03D6,\varpi} Variant on the lower case Greek letter (ordinary).
+@BES{03D6,\varpi} Variant on the lowercase Greek letter (ordinary).
The non-variant form is @code{\pi}@tie{}@BES{03C0,\pi}.
@item \varrho
-@BES{03F1,\varrho} Variant on the lower case Greek letter (ordinary).
+@BES{03F1,\varrho} Variant on the lowercase Greek letter (ordinary).
The non-variant form is @code{\rho}@tie{}@BES{03C1,\rho}.
@item \varsigma
-@BES{03C2,\varsigma} Variant on the lower case Greek letter
+@BES{03C2,\varsigma} Variant on the lowercase Greek letter
(ordinary). The non-variant form is
@code{\sigma}@tie{}@BES{03C3,\sigma}.
@item \vartheta
-@BES{03D1,\vartheta} Variant on the lower case Greek letter
+@BES{03D1,\vartheta} Variant on the lowercase Greek letter
(ordinary). The non-variant form is
@code{\theta}@tie{}@BES{03B8,\theta}.
@@ -8742,34 +11434,35 @@ operator@tie{}@code{\bigvee}.
@BES{2016,\Vert} Vertical double bar (ordinary). Similar: vertical single
bar@tie{}@code{\vert}.
-For a norm symbol, you can use the @file{mathtools} package and add
-@code{\DeclarePairedDelimiter\norm@{\lVert@}@{\rVert@}} to your
-preamble. This gives you three command variants for double-line
-vertical bars that are correctly horizontally spaced: if in the
-document body you write the starred version @code{$\norm*@{M^\perp@}$}
-then the height of the vertical bars will match the height of the
-argument, whereas with @code{\norm@{M^\perp@}} the bars do not grow
-with the height of the argument but instead are the default height,
-and @code{\norm[@var{size command}]@{M^\perp@}} also gives bars that
-do not grow but are set to the size given in the @var{size command},
-e.g., @code{\Bigg}.
+For a norm symbol, you can use the @file{mathtools} package and put in
+your preamble
+@code{\DeclarePairedDelimiter\norm@{\lVert@}@{\rVert@}}. This gives you
+three command variants for double-line vertical bars that are correctly
+horizontally spaced: if in the document body you write the starred
+version @code{$\norm*@{M^\perp@}$} then the height of the vertical bars
+will match the height of the argument, whereas with
+@code{\norm@{M^\perp@}} the bars do not grow with the height of the
+argument but instead are the default height, and @code{\norm[@var{size
+command}]@{M^\perp@}} also gives bars that do not grow but are set to
+the size given in the @var{size command}, e.g., @code{\Bigg}.
@item \vert
@BES{007C,\vert} Single line vertical bar (ordinary). Similar: double-line
vertical bar@tie{}@code{\Vert}. For such that, as in the definition of a
set, use@tie{}@code{\mid} because it is a relation.
-For absolute value you can use the @file{mathtools} package and add
-@code{\DeclarePairedDelimiter\abs@{\lvert@}@{\rvert@}} to your
-preamble. This gives you three command variants for single-line vertical
-bars that are correctly horizontally spaced: if in the document body you
-write the starred version @code{$\abs*@{\frac@{22@}@{7@}@}$} then the
-height of the vertical bars will match the height of the argument,
-whereas with @code{\abs@{\frac@{22@}@{7@}@}} the bars do not grow with
-the height of the argument but instead are the default height, and
-@code{\abs[@var{size command}]@{\frac@{22@}@{7@}@}} also gives bars
-that do not grow but are set to the size given in the @var{size
-command}, e.g., @code{\Bigg}.
+For absolute value you can use the @file{mathtools} package and in your
+preamble put
+@code{\DeclarePairedDelimiter\abs@{\lvert@}@{\rvert@}}. This gives you
+three command variants for single-line vertical bars that are correctly
+horizontally spaced: if in the document body you write the starred
+version @code{$\abs*@{\frac@{22@}@{7@}@}$} then the height of the
+vertical bars will match the height of the argument, whereas with
+@code{\abs@{\frac@{22@}@{7@}@}} the bars do not grow with the height of
+the argument but instead are the default height, and
+@code{\abs[@var{size command}]@{\frac@{22@}@{7@}@}} also gives bars that
+do not grow but are set to the size given in the @var{size command},
+e.g., @code{\Bigg}.
@item \wedge
@BES{2227,\wedge} Logical and (binary). Synonym:@tie{}@code{\land}. See also
@@ -8783,16 +11476,245 @@ operator@tie{}@code{\bigwedge}.
@BES{2240,\wr} Wreath product (binary).
@item \Xi
-@BES{039E,\Xi} Upper case Greek letter (ordinary).
+@BES{039E,\Xi} uppercase Greek letter (ordinary).
@item \xi
-@BES{03BE,\xi} Lower case Greek letter (ordinary).
+@BES{03BE,\xi} Lowercase Greek letter (ordinary).
@item \zeta
-@BES{03B6,\zeta} Lower case Greek letter (ordinary).
+@BES{03B6,\zeta} Lowercase Greek letter (ordinary).
+
+@end ftable
+
+The following symbols are most often used in plain text but @LaTeX{}
+provides versions to use in mathematical text.
+
+@ftable @code
+@item \mathdollar
+Dollar sign in math mode: $.
+
+@item \mathparagraph
+Paragraph sign (pilcrow) in math mode, @BES{00B6,\P}.
+
+@item \mathsection
+Section sign in math mode @BES{00A7,\S}.
+
+@item \mathsterling
+Sterling sign in math mode: @pounds{}.
+
+@item \mathunderscore
+Underscore in math mode: _.
@end ftable
+@menu
+* Blackboard bold:: Doublestruck characters.
+* Calligraphic:: Cursive characters.
+* \boldmath & \unboldmath:: Symbols in boldface.
+* Dots:: Ellipses, etc.
+@end menu
+
+
+@node Blackboard bold
+@subsection Blackboard bold
+
+@cindex blackboard bold
+@cindex doublestruck
+
+Synopsis:
+
+@example
+\usepackage@{amssymb@} % in preamble
+ ...
+\mathbb@{@var{uppercase-letter}@}
+@end example
+
+Provide blackboard bold symbols, sometimes also known as doublestruck
+letters, used to denote number sets such as the natural numbers, the
+integers, etc.
+
+Here
+
+@example
+\( \forall n \in \mathbb@{N@}, n^2 \geq 0 \)
+@end example
+
+@noindent
+the @code{\mathbb@{N@}} gives blackboard bold symbol @BES{2115,}
+representing the natural numbers.
+
+If you use other than an uppercase letter then you do not get an error
+but you get strange results, including unexpected characters.
+
+There are packages that give access to symbols other than just the
+capital letters; look on CTAN.
+
+
+@node Calligraphic
+@subsection Calligraphic
+
+@cindex calligraphic fonts
+@cindex script fonts
+@cindex fonts, script
+
+Synopsis:
+
+@example
+\mathcal@{@var{uppercase-letters}@}
+@end example
+
+Use a script-like font.
+
+In this example the graph identifier is output in a cursive font.
+
+@example
+Let the graph be \( \mathcal@{G@} \).
+@end example
+
+If you use something other than an uppercase letter then you do not get
+an error. Instead you get unexpected output. For instance,
+@code{\mathcal@{g@}} outputs a close curly brace symbol, while
+@code{\mathcal@{+@}} outputs a plus sign.
+
+
+@node \boldmath & \unboldmath
+@subsection @code{\boldmath} & @code{\unboldmath}
+
+@cindex boldface mathematics
+@cindex symbols, boldface
+@findex \boldmath
+@findex \unboldmath
+
+Synopsis (used in paragraph mode or LR mode):
+
+@example
+\boldmath \( @var{math} \)
+@end example
+
+@noindent
+or
+
+@example
+\unboldmath \( @var{math} \)
+@end example
+
+@findex \boldmath
+@findex \unboldmath
+Declarations to change the letters and symbols in @var{math} to be in
+a bold font, or to countermand that and bring back the regular
+(non-bold) default. They must be used when not in math mode or display
+math mode (@pxref{Modes}). Both commands are fragile
+(@pxref{\protect}).
+
+In this example each @code{\boldmath} command takes place inside an
+@code{\mbox},
+
+@example
+we have $\mbox@{\boldmath \( v \)@} = 5\cdot\mbox@{\boldmath \( u \)$@}$
+@end example
+
+@noindent
+which means @code{\boldmath} is only called in a text mode, here LR
+mode, and explains why @LaTeX{} must switch to math mode to set @code{v}
+and @code{u}.
+
+If you use either command inside math mode, as with @code{Trouble: \(
+\boldmath x \)}, then you get something like @samp{LaTeX Font Warning:
+Command \boldmath invalid in math mode on input line 11} and @samp{LaTeX
+Font Warning: Command \mathversion invalid in math mode on input line
+11}.
+
+@PkgIndex{bm}
+There are many issues with @code{\boldmath}. New documents should use
+the @file{bm} package provided by the @LaTeX{} Project team. A complete
+description is outside the scope of this document (see the full
+documentation on CTAN) but even this small example
+
+@example
+\usepackage@{bm@} % in preamble
+...
+we have $\bm@{v@} = 5\cdot\bm@{u@}$
+@end example
+
+@noindent
+shows that it is an improvement over @code{\boldmath}.
+
+
+@node Dots
+@subsection Dots, horizontal or vertical
+
+@cindex ellipses
+@cindex dots
+
+Ellipses are the three dots (usually three) indicating that a pattern
+continues.
+
+@example
+\begin@{array@}@{cccc@}
+ a_@{0,0@} &a_@{0,1@} &a_@{0,2@} &\ldots \\
+ a_@{1,0@} &\ddots \\
+ \vdots
+\end@{array@}
+@end example
+
+@LaTeX{} provides these.
+
+@ftable @code
+@anchor{ellipses cdots}
+@item \cdots
+Horizontal ellipsis with the dots raised to the center of the line, as
+in @BES{22EF,\cdots}. Used as: @code{\( a_0\cdot a_1\cdots a_@{n-1@}
+\)}.
+
+@anchor{ellipses ddots}
+@item \ddots
+Diagonal ellipsis, @BES{22F1,\ddots}. See the above array example for a
+usage.
+
+@anchor{ellipses ldots}
+@item \ldots
+Ellipsis on the baseline, @BES{2026,\ldots}. Used as: @code{\(
+x_0,\ldots x_@{n-1@} \)}. Another example is the above array example. A
+synonym is @code{\mathellipsis}. A synonym from the @file{amsmath}
+package is @code{\hdots}.
+
+You can also use this command outside of mathematical text, as in
+@code{The gears, brakes, \ldots@{@} are all broken}. (In a paragraph
+mode or LR mode a synonym for @code{\ldots} is @code{\dots}.)
+
+@anchor{ellipses vdots}
+@item \vdots
+Vertical ellipsis, @BES{22EE,\vdots}. See the above array example for a
+usage.
+
+@end ftable
+
+@PkgIndex{amsmath}
+The @file{amsmath} package has the command @code{\dots} to semantically
+mark up ellipses. This example produces two different-looking outputs
+for the first two uses of the @code{\dots} command.
+
+@example
+\usepackage@{amsmath@} % in preamble
+ ...
+Suppose that \( p_0, p_1, \dots, p_@{n-1@} \) lists all of the primes.
+Observe that \( p_0\cdot p_1 \dots \cdot p_@{n-1@} +1 \) is not a
+ multiple of any \( p_i \).
+Conclusion: there are infinitely many primes \( p_0, p_1, \dotsc \).
+@end example
+
+@noindent
+In the first line @LaTeX{} looks to the comma following @code{\dots} to
+determine that it should output an ellipsis on the baseline. The second
+line has a @code{\cdot} following @code{\dots} so @LaTeX{} outputs an
+ellipsis that is on the math axis, vertically centered. However, the
+third usage has no follow-on character so you have to tell @LaTeX{} what
+to do. You can use one of the commands: @code{\dotsc} if you need the
+ellipsis appropriate for a comma following, @code{\dotsb} if you need
+the ellipses that fits when the dots are followed by a binary operator
+or relation symbol, @code{\dotsi} for dots with integrals, or
+@code{\dotso} for others.
+
@node Math functions
@section Math functions
@@ -8805,117 +11727,227 @@ spacing.
@ftable @code
@item \arccos
+Inverse cosine
+@iftex
@math{\arccos}
+@end iftex
@item \arcsin
+Inverse sine
+@iftex
@math{\arcsin}
+@end iftex
@item \arctan
+Inverse tangent
+@iftex
@math{\arctan}
+@end iftex
@item \arg
+Angle between the real axis and a point in the complex plane
+@iftex
@math{\arg}
+@end iftex
@item \bmod
-Binary modulo operator (@math{x \bmod y})
+Binary modulo operator, used as in @code{\( 5\bmod 3=2 \)}
+@iftex
+@math{5 \bmod 3}
+@end iftex
@item \cos
+Cosine
+@iftex
@math{\cos}
+@end iftex
@item \cosh
+Hyperbolic cosine
+@iftex
@math{\cosh}
+@end iftex
@item \cot
+Cotangent
+@iftex
@math{\cot}
+@end iftex
@item \coth
+Hyperbolic cotangent
+@iftex
@math{\coth}
+@end iftex
@item \csc
+Cosecant
+@iftex
@math{\csc}
+@end iftex
@item \deg
+Degrees
+@iftex
@math{\deg}
+@end iftex
@item \det
+Determinant
+@iftex
@math{\det}
+@end iftex
@item \dim
+Dimension
+@iftex
@math{\dim}
+@end iftex
@item \exp
+Exponential
+@iftex
@math{\exp}
+@end iftex
@item \gcd
+Greatest common divisor
+@iftex
@math{\gcd}
+@end iftex
@item \hom
+Homomorphism
+@iftex
@math{\hom}
+@end iftex
@item \inf
+Infinum
+@iftex
@math{\inf}
+@end iftex
@item \ker
+Kernel
+@iftex
@math{\ker}
+@end iftex
@item \lg
+Base 2 logarithm
+@iftex
@math{\lg}
+@end iftex
@item \lim
+Limit
+@iftex
@math{\lim}
+@end iftex
@item \liminf
+Limit inferior
+@iftex
@math{\liminf}
+@end iftex
@item \limsup
+Limit superior
+@iftex
@math{\limsup}
+@end iftex
@item \ln
+Natural logarithm
+@iftex
@math{\ln}
+@end iftex
@item \log
+Logarithm
+@iftex
@math{\log}
+@end iftex
@item \max
+Maximum
+@iftex
@math{\max}
+@end iftex
@item \min
+Minimum
+@iftex
@math{\min}
+@end iftex
@item \pmod
-parenthesized modulus, as in (@math{\pmod 2^n - 1})
+Parenthesized modulus, as used in @code{\( 5\equiv 2\pmod 3 \)}
+@iftex
+@math{5\equiv 2\pmod 3}
+@end iftex
@item \Pr
+Probability
+@iftex
@math{\Pr}
+@end iftex
@item \sec
+Secant
+@iftex
@math{\sec}
+@end iftex
@item \sin
+Sine
+@iftex
@math{\sin}
+@end iftex
@item \sinh
+Hyperbolic sine
+@iftex
@math{\sinh}
+@end iftex
@item \sup
@iftex
+Supremum
+@iftex
@math{\mathop {\rm sup}}
@end iftex
@ifnottex
-@math{\sup}
+sup
@end ifnottex
@c don't try to use \sup with dvi/pdf output since that turned into a
@c Texinfo command and it's not worth hassling with different versions
@c when it's just three roman letters anyway.
@item \tan
+Tangent
+@iftex
@math{\tan}
+@end iftex
@item \tanh
+Hyperbolic tangent
+@iftex
@math{\tanh}
+@end iftex
@end ftable
+@PkgIndex{amsmath}
+The @file{amsmath} package adds improvements on some of these, and also
+allows you to define your own. The full documentation is on CTAN, but
+briefly, you can define an identity operator with
+@code{\DeclareMathOperator@{\identity@}@{id@}} that is like the ones
+above but prints as @samp{id}. The starred form
+@code{\DeclareMathOperator*@{\op@}@{op@}} sets any limits above and
+below, as is traditional with @code{\lim}, @code{\sup}, or @code{\max}.
+
@node Math accents
@section Math accents
@@ -8930,70 +11962,170 @@ in math. These are different from accents in normal text
@ftable @code
@item \acute
@cindex acute accent, math
-Math acute accent: @math{\acute{x}}.
+Math acute accent
+@iftex
+@math{\acute{x}}.
+@end iftex
@item \bar
@cindex bar-over accent, math
@cindex macron accent, math
-Math bar-over accent: @math{\bar{x}}.
+Math bar-over accent
+@iftex
+@math{\bar{x}}
+@end iftex
@item \breve
@cindex breve accent, math
-Math breve accent: @math{\breve{x}}.
+Math breve accent
+@iftex
+@math{\breve{x}}
+@end iftex
@item \check
@cindex check accent, math
@cindex h@'a@v{c}ek accent, math
-Math h@'a@v{c}ek (check) accent: @math{\check{x}}.
+Math h@'a@v{c}ek (check) accent
+@iftex
+@math{\check{x}}
+@end iftex
@item \ddot
@cindex double dot accent, math
-Math dieresis accent: @math{\ddot{x}}.
+Math dieresis accent
+@iftex
+@math{\ddot{x}}
+@end iftex
@item \dot
@cindex overdot accent, math
@cindex dot over accent, math
-Math dot accent: @math{\dot{x}}.
+Math dot accent
+@iftex
+@math{\dot{x}}
+@end iftex
@item \grave
@cindex grave accent, math
-Math grave accent: @math{\grave{x}}.
+Math grave accent
+@iftex
+@math{\grave{x}}
+@end iftex
@item \hat
@cindex hat accent, math
@cindex circumflex accent, math
-Math hat (circumflex) accent: @math{\hat{x}}.
-
-@item \imath
-@cindex dotless i, math
-Math dotless i.
-
-@item \jmath
-@cindex dotless j, math
-Math dotless j.
+Math hat (circumflex) accent
+@iftex
+@math{\hat{x}}
+@end iftex
@item \mathring
@cindex ring accent, math
-Math ring accent: @ringaccent{x}. @c don't bother implementing in texinfo
+Math ring accent @c don't bother implementing in texinfo
+@iftex
+@ringaccent{x}
+@end iftex
@item \tilde
@cindex tilde accent, math
-Math tilde accent: @math{\tilde{x}}.
+Math tilde accent
+@iftex
+@math{\tilde{x}}
+@end iftex
@item \vec
@cindex vector symbol, math
-Math vector symbol: @math{\vec{x}}.
+Math vector symbol
+@iftex
+@math{\vec{x}}
+@end iftex
@item \widehat
@cindex wide hat accent, math
-Math wide hat accent: @math{\widehat{x+y}}.
+Math wide hat accent
+@iftex
+@math{\widehat{x+y}}
+@end iftex
@item \widetilde
@cindex wide tilde accent, math
-Math wide tilde accent: @math{\widetilde{x+y}}.
+Math wide tilde accent
+@iftex
+@math{\widetilde{x+y}}
+@end iftex
@end ftable
+When you are putting an accent on an i or a j, the tradition is to use
+one without a dot, @code{\imath} or @code{jmath} (@pxref{Math symbols}).
+
+
+@node Over- and Underlining
+@section Over- and Underlining
+
+@cindex overlining
+@cindex underlining
+
+@LaTeX{} provides commands for making overlines or underlines, or
+putting braces over or under some material.
+
+@ftable @code
+
+@item \underline@{@var{text}@}
+Underline @var{text}. Works inside math mode, and outside.
+@ifset HAS-MATH
+The result of @code{\underline@{xyz@}} is @math{\underline{xyz}}.
+@end ifset
+The line is always completely below the text, taking account of
+descenders, so in @code{\(\underline@{y@}\)} the line is lower than in
+@code{\(\underline@{x@}\)}. This command is fragile (@pxref{\protect}).
+
+@PkgIndex{ulem}
+Note that the package @file{ulem} does text mode underlining and allows
+line breaking as well as a number of other features. See the
+documentation on CTAN. See also@tie{}@ref{\hrulefill & \dotfill} for
+producing a line, for such things as a signature.
+
+@item \overline@{@var{text}@}
+Put a horizontal line over @var{text}. Works inside math mode, and
+outside. For example, @code{\overline@{x+y@}}.
+@ifset HAS-MATH
+The result looks like: @math{\overline{x+y}}.
+@end ifset
+Note that this differs from the command @code{\bar} (@pxref{Math
+accents}).
+
+@item \underbrace@{@var{math}@}
+Put a brace under @var{math}. For example, this
+@code{(1-\underbrace@{1/2)+(1/2@}-1/3)} emphasizes the telescoping part.
+@ifset HAS-MATH
+The result looks like this: @math{(1-\underbrace{1/2)+(1/2}-1/3)}.
+@end ifset
+Attach text to the brace by using subscript, @code{_}, or superscript,
+@code{^}, as here.
+
+@example
+\begin@{displaymath@}
+ 1+1/2+\underbrace@{1/3+1/4@}_@{>1/2@}+
+ \underbrace@{1/5+1/6+1/7+1/8@}_@{>1/2@}+\cdots
+\end@{displaymath@}
+@end example
+
+The superscript appears on top of the expression, and so can look
+unconnected to the underbrace.
+
+@item \overbrace@{@var{math}@}
+Put a brace over @var{math}, as with
+@code{\overbrace@{x+x+\cdots+x@}^@{\mbox@{\(k\) times@}@}}. See also
+@code{\underbrace}.
+
+@end ftable
+
+@PkgIndex{mathtools}
+The package @file{mathtools} adds an over- and underbrace, as well as
+some improvements on the braces. See the documentation on CTAN.
+
@node Spacing in math mode
@section Spacing in math mode
@@ -9001,43 +12133,77 @@ Math wide tilde accent: @math{\widetilde{x+y}}.
@cindex spacing within math mode
@cindex math mode, spacing
-In a @code{math} environment, @LaTeX{} ignores the spaces that you use
-in the source, and instead puts in the spacing according to the normal
-rules for mathematics texts.
+When typesetting mathematics, @LaTeX{} puts in spacing according to the
+normal rules for mathematics texts. If you enter @code{y=m x} then
+@LaTeX{} ignores the space and in the output the m is next to the x,
+as @math{y=mx}.
-Many math mode spacing definitions are expressed in terms of the math unit
-@dfn{mu} given by 1 em = 18 mu, where the em is taken from the current
-math symbols family (@pxref{Units of length}).
-@LaTeX{} provides the following commands for use in math mode:
+But @LaTeX{}'s rules sometimes need tweaking. For example, in an
+integral the tradition is to put a small extra space between the
+@code{f(x)} and the @code{dx}, here done with the @code{\,} command.
+
+@example
+\int_0^1 f(x)\,dx
+@end example
+
+@LaTeX{} provides the commands that follow for use in math mode. Many
+of these spacing definitions are expressed in terms of the math unit
+@dfn{mu}. It is defined as 1/18@dmn{em}, where the em is taken from the
+current math symbols family (@pxref{Units of length}). Thus, a
+@code{\thickspace} is something like 5/18 times the width of
+a@tie{}@samp{M}.
@table @code
@item \;
@findex \;
@findex \thickspace
-Normally @code{5.0mu plus 5.0mu}. The longer name is
-@code{\thickspace}. Math mode only.
+@anchor{spacing in math mode thickspace}
+Synonym: @code{\thickspace}. Normally @code{5.0mu plus 5.0mu}. Math
+mode only.
@item \:
@itemx \>
@findex \:
@findex \>
@findex \medspace
-Normally @code{4.0mu plus 2.0mu minus 4.0mu}. The longer name is
-@code{\medspace}. Math mode only.
+@anchor{spacing in math mode medspace}
+Synonym: @code{\medspace}. Normally @code{4.0mu plus 2.0mu minus 4.0mu}.
+Math mode only.
@item \,
@findex \,
@findex \thinspace
-Normally @code{3mu}. The longer name is @code{\thinspace}. This can
-be used in both math mode and text mode. @xref{\thinspace}.
+@cindex thin space
+@anchor{Spacing in math mode/\thinspace}
+@anchor{spacing in math mode thinspace}
+Synonym: @code{\thinspace}. Normally @code{3mu}, which is 1/6@dmn{em}.
+Can be used in both math mode and text mode (@pxref{\thinspace &
+\negthinspace}).
+
+This space is widely used, for instance between the function and the
+infinitesimal in an integral @code{\int f(x)\,dx} and, if an author does
+this, before punctuation in a displayed equation.
+
+@example
+The antiderivative is
+\begin@{equation@}
+ 3x^@{-1/2@}+3^@{1/2@}\,.
+\end@{equation@}
+@end example
@item \!
@findex \!
-A negative thin space. Normally @code{-3mu}. Math mode only.
+@findex \negthinspace
+@cindex thin space, negative
+@anchor{spacing in math mode negthinspace}
+A negative thin space. Normally @code{-3mu}. The @code{\!} command is
+math mode only but the @code{\negthinspace} command is available for
+text mode (@pxref{\thinspace & \negthinspace}).
@item \quad
@cindex quad
@findex \quad
+@anchor{spacing in math mode quad}
This is 18@dmn{mu}, that is, 1@dmn{em}. This is often used for space
surrounding equations or expressions, for instance for the space between
two equations inside a @code{displaymath} environment. It is available
@@ -9045,206 +12211,281 @@ in both text and math mode.
@item \qquad
@findex \qquad
+@anchor{spacing in math mode qquad}
A length of 2 quads, that is, 36@dmn{mu} = 2@dmn{em}. It is available in
both text and math mode.
@end table
-In this example a thinspace separates the function from the
-infinitesimal.
+
+@node Math miscellany
+@section Math miscellany
+
+@cindex math miscellany
+
+@LaTeX{} contains a wide variety of mathematics facilities. Here are
+some that don't fit into other categories.
+
+@menu
+* Colon character & \colon:: Colon.
+* \*:: Discretionary multiplication.
+* \frac:: Fraction.
+* \left & \right:: Paired delimiters.
+* \sqrt:: Radicals.
+* \stackrel:: Text over a relation.
+@end menu
+
+
+@node Colon character & \colon
+@subsection Colon character @code{:} & @code{\colon}
+
+@cindex :
+@cindex colon character
+@findex :
+@findex \colon
+
+Synopsis, one of:
@example
-\int_0^1 f(x)\,dx
+:
+\colon
@end example
+In mathematics, the colon character, @code{:}, is a relation.
-@node Math miscellany
-@section Math miscellany
+@example
+With side ratios \( 3:4 \) and \( 4:5 \), the triangle is right.
+@end example
-@cindex math miscellany
+@PkgIndex{amsmath}
+@noindent
+Ordinary @LaTeX{} defines @code{\colon} to produce the colon character
+with the spacing appropriate for punctuation, as in set-builder notation
+@code{\@{x\colon 0\leq x<1\@}}.
-@ftable @code
-@item \*
-@cindex discretionary multiplication
-@cindex multiplication symbol, discretionary line break
-A @dfn{discretionary} multiplication symbol, at which a line break is
-allowed. Without the break multiplication is implicitly indicated by a
-space, while in the case of a break a @BES{00D7,\times} symbol is
-printed immediately before the break. So
+@PkgIndex{amsmath}
+But the widely-used @file{amsmath} package defines @code{\colon} for use
+in the definition of functions @code{f\colon D\to C}. So if you want
+the colon character as a punctuation then use @code{\mathpunct@{:@}}.
+
+
+@node \*
+@subsection @code{\*}
+
+@cindex multiplication, discretionary
+@cindex breaks, multiplication discretionary
+@cindex line breaks, multiplication discretionary
+@cindex discretionary breaks, multiplication
+@findex \*
+
+Synopsis:
@example
-\documentclass@{article@}
-\begin@{document@}
-Now \(A_3 = 0\), hence the product of all terms \(A_1\)
-through \(A_4\), that is \(A_1\* A_2\* A_3 \* A_4\), is
-equal to zero.
-\end@{document@}
+\*
@end example
-will make that sort of output@c
-@ifnottex
-@w{ }(the ellipsis @samp{[@dots{}]} is here to show the line break at
-the same place as in a @TeX{} output)@c
-@end ifnottex
-:
+A multiplication symbol that allows a line break. If there is a break
+then @LaTeX{} puts a @code{\times} symbol, @BES{00D7,\times}, before
+that break.
-@indentedblock
-Now @math{A_3 = 0},
-@iftex
-hence the product of all terms
-@end iftex
-@ifnottex
-[@dots{}]
-@end ifnottex
-@math{A_1}
-through @math{A_4}, that is @math{A_1 A_2 \times}@*@math{A_3 A_4}, is
-equal to zero.
-@end indentedblock
+In @code{\( A_1\* A_2\* A_3\* A_4 \)}, if there is no line break then
+@LaTeX{} outputs it as though it were @code{\( A_1 A_2 A_3 A_4 \)}. If
+a line break does happen, for example between the two middle ones, then
+@LaTeX{} sets it like @code{\( A_1 A_2 \times \)}, followed by the
+break, followed by @code{\( A_3 A_4 \)}.
-@item \cdots
-A horizontal ellipsis with the dots raised to the center of the line.
-@tex
-As in: `$\cdots$'.
-@end tex
-@item \ddots
-A diagonal ellipsis: @math{\ddots}.
+@node \frac
+@subsection @code{\frac}
-@item \frac@{@var{num}@}@{@var{den}@}
+@cindex fraction
@findex \frac
-Produces the fraction @var{num} divided by @var{den}.
-@ifset HAS-MATH
-eg. @math{{1}\over{4}}
-@end ifset
+Synopsis:
-@item \left @var{delim1} ... \right @var{delim2}
-@findex \right
+@example
+\frac@{@var{numerator}@}@{@var{denominator}@}
+@end example
+
+Produces the fraction. Used as: @code{\begin@{displaymath@}
+\frac@{1@}@{\sqrt@{2\pi\sigma@}@} \end@{displaymath@}}. In inline math
+mode it comes out small; see the discussion of @code{\displaystyle}
+(@pxref{Math formulas}).
+
+
+@node \left & \right
+@subsection @code{\left} & @code{\right}
+
+@cindex delimiters, paired
+@cindex paired delimiters
+@cindex matching parentheses
+@cindex matching brackets
@cindex null delimiter
-The two delimiters need not match; @samp{.} acts as a @dfn{null delimiter},
-producing no output. The delimiters are sized according to the math
-in between. Example: @code{\left( \sum_@{i=1@}^@{10@} a_i \right]}.
+@findex \left
+@findex \right
-@item \mathdollar
-Dollar sign in math mode: $.
+Synopsis:
-@item \mathellipsis
-Ellipsis (spaced for text) in math mode: @dots{}.
+@example
+\left @var{delimiter1} ... \right @var{delimiter2}
+@end example
-@item \mathparagraph
-Paragraph sign (pilcrow) in math mode: @BES{00B6,\P}.
+Make matching parentheses, braces, or other delimiters. The delimiters
+are sized according to the math they enclose. This makes a unit vector
+surrounded by appropriate-height parentheses.
-@item \mathsection
-Section sign in math mode.
+@example
+\begin@{equation@}
+ \left(\begin@{array@}@{c@}
+ 1 \\
+ 0 \\
+ \end@{array@}\right)
+@end example
-@item \mathsterling
-Sterling sign in math mode: @pounds{}.
+Every @code{\left} must have a matching @code{\right}. Leaving out the
+@code{\left(} in the above gets @samp{Extra \right}. Leaving off the
+@code{\right)} gets @samp{You can't use `\eqno' in math mode}.
-@item \mathunderscore
-Underscore in math mode: _.
+However, the two delimiters @var{delimiter1} and @var{delimiter2} need
+not match. A common case is that you want an unmatched brace, as
+below. Use a period, @samp{.}, as a null delimiter.
-@item \overbrace@{@var{math}@}
-Generates a brace over @var{math}.
-For example, @code{\overbrace@{x+\cdots+x@}^@{k \;\textrm@{times@}@}}.
-@ifset HAS-MATH
-The result looks like: @math{\overbrace{x+\cdots+x}^{k \rm\;times}}
-@end ifset
-
-@item \overline@{@var{text}@}
-Generates a horizontal line over @var{tex}.
-For example, @code{\overline@{x+y@}}.
-@ifset HAS-MATH
-The result looks like: @math{\overline{x+y}}.
-@end ifset
+@example
+\begin@{equation@}
+ f(n)=\left\@{\begin@{array@}@{ll@}
+ 1 &\mbox@{--if \(n=0\)@} \\
+ f(n-1)+3n^2 &\mbox@{--else@}
+ \end@{array@}\right.
+\end@{equation@}
+@end example
-@item \sqrt[@var{root}]@{@var{arg}@}
-Produces the representation of the square root of @var{arg}. The
-optional argument @var{root} determines what root to produce. For
-example, the cube root of @code{x+y} would be typed as
-@code{\sqrt[3]@{x+y@}}.
-@ifset HAS-MATH
-The result looks like this: @math{\root 3 \of {x+y}}.
-@end ifset
+@noindent
+Note that to get a curly brace as a delimiter you must prefix it with a
+backslash, @code{\@{}.
-@item \stackrel@{@var{text}@}@{@var{relation}@}
-Puts @var{text} above @var{relation}. For example,
-@code{\stackrel@{f@}@{\longrightarrow@}}.
-@ifset HAS-MATH
- The result looks like this: @math{\buildrel f \over \longrightarrow}.
-@end ifset
-@item \underbrace@{@var{math}@}
-Generates @var{math} with a brace underneath. For example, @code{\underbrace@{x+y+z@}_@{>\,0@}}
-@ifset HAS-MATH
-The result looks like this: @math{\underbrace{x+y+z}_{>\,0}}.
-@end ifset
+@node \sqrt
+@subsection @code{\sqrt}
-@item \underline@{@var{text}@}
-Causes @var{text}, which may be either math mode or not, to be
-underlined. The line is always below the text, taking account of
-descenders.
+@cindex square root
+@cindex roots
+@cindex radical
+@findex \sqrt
+
+Synopsis, one of:
+
+@example
+\sqrt@{@var{arg}@}
+\sqrt[@var{root-number}]@{@var{arg}@}
+@end example
+
+The square root, or optionally other roots, of @var{arg}. The optional
+argument @var{root-number} gives the root, i.e., enter the cube root of
+@code{x+y} as @code{\sqrt[3]@{x+y@}}.
@ifset HAS-MATH
-The result looks like this: @math{\underline{xyz}}
+It comes out like this: @math{\root 3 \of {x+y}}.
@end ifset
+The radical grows with the size of @var{arg} (as the height of the
+radical grows, the angle on the leftmost part gets steeper, until for
+a large enough @code{arg}, it is vertical).
-@item \vdots
-Produces a vertical ellipsis.
+@LaTeX{} has a separate @code{\surd} character (@pxref{Math symbols}).
+
+
+@node \stackrel
+@subsection @code{\stackrel}
+
+@cindex stack math
+@cindex relation, text above
+@findex \stackrel
+
+Synopsis, one of:
+
+@example
+\stackrel@{@var{text}@}@{@var{relation}@}
+@end example
+
+Put @var{text} above @var{relation}. To put a function name above an
+arrow enter @code{\stackrel@{f@}@{\longrightarrow@}}.
@ifset HAS-MATH
-The result looks like this: @math{\vdots}.
+ The result looks like this: @math{\buildrel f \over \longrightarrow}.
@end ifset
-@end ftable
-
@node Modes
@chapter Modes
@cindex modes
+
+As @LaTeX{} processes your document, at any point it is in one of six
+modes. They fall into three categories of two each, the horizontal
+modes, the math modes, and the vertical modes. Some commands only work
+in one mode or another (in particular, many commands only work in one of
+the math modes), and error messages will refer to these.
+
+@itemize
+@item
+@anchor{modes paragraph mode}
@cindex paragraph mode
-@cindex math mode
+@dfn{Paragraph mode} is what @LaTeX{} is in when processing ordinary
+text. It breaks the input text into lines and breaks the lines into
+pages. This is the mode @LaTeX{} is in most of the time.
+
@cindex left-to-right mode
@cindex LR mode
+@anchor{modes lr mode}
+@dfn{LR mode} (for left-to-right mode; in plain @TeX{} this is called
+@dfn{restricted horizontal mode}) is in effect when @LaTeX{} starts
+making a box with an @code{\mbox} command. As in paragraph mode,
+@LaTeX{}'s output is a string of words with spaces between them. Unlike
+in paragraph mode, in LR mode @LaTeX{} never starts a new line, it just
+keeps going from left to right. (Although @LaTeX{} will not complain
+that the LR box is too long, when it is finished and next tries to put
+that box into a line, it could very well complain that the finished LR
+box won't fit there.)
-When @LaTeX{} is processing your input text, it is always in one of three
-modes:
-
-@itemize @bullet
@item
-Paragraph mode
-@item
-Math mode
+@cindex math mode
+@anchor{modes math mode} @dfn{Math mode} is when @LaTeX{} is generating
+an inline mathematical formula.
+
+@cindex display math mode
+@dfn{Display math mode} is when @LaTeX{} is generating a displayed
+mathematical formula. (Displayed formulas differ somewhat from inline
+ones. One example is that the placement of the subscript on @code{\int}
+differs in the two situations.)
+
@item
-Left-to-right mode, called LR mode for short
+@cindex vertical mode
+@anchor{modes vertical mode}
+@dfn{Vertical mode} is when @LaTeX{} is building the list of lines and
+other material making the output page. This is the mode @LaTeX{} is in
+when it starts a document.
+
+@cindex internal vertical mode
+@anchor{modes internal vertical mode}
+@dfn{Internal vertical mode} is in effect when @LaTeX{} starts making a
+@code{\vbox}. This is the vertical analogue of LR mode.
+
@end itemize
-Mode changes occur only when entering or leaving an environment, or when
-@LaTeX{} is processing the argument of certain text-producing commands.
-
-@dfn{Paragraph mode} is the most common; it's the one @LaTeX{} is in
-when processing ordinary text. In this mode, @LaTeX{} breaks the
-input text into lines and breaks the lines into pages.
-
-@LaTeX{} is in @dfn{math mode} when it's generating a mathematical
-formula, either displayed math or within a line.
-
-@findex \mbox@r{, and LR mode}
-In @dfn{LR mode}, as in paragraph mode, @LaTeX{} considers the output
-that it produces to be a string of words with spaces between them.
-However, unlike paragraph mode, @LaTeX{} keeps going from left to
-right; it never starts a new line in LR mode. Even if you put a
-hundred words into an @code{\mbox}, @LaTeX{} would keep typesetting
-them from left to right inside a single box (and then most likely
-complain because the resulting box was too wide to fit on the line).
-@LaTeX{} is in LR mode when it starts making a box with an
-@code{\mbox} command. You can get it to enter a different mode inside
-the box---for example, you can make it enter math mode to put a
-formula in the box.
-
-There are also several text-producing commands and environments for
-making a box that put @LaTeX{} into paragraph mode. The box made by
-one of these commands or environments will be called a @code{parbox}.
-When @LaTeX{} is in paragraph mode while making a box, it is said to
-be in ``inner paragraph mode'' (no page breaks). Its normal paragraph
-mode, which it starts out in, is called ``outer paragraph mode''.
+@noindent
+For instance, if you begin a @LaTeX{} article with @samp{Let \( x \) be
+...} then these are the modes: first @LaTeX{} starts every document in
+vertical mode, then it reads the @samp{L} and switches to paragraph
+mode, then the next switch happens at the @samp{\(} where @LaTeX{}
+changes to math mode, and then when it leaves the formula it pops
+back to paragraph mode.
+
+@cindex inner paragraph mode
+@cindex outer paragraph mode
+@anchor{modes inner paragraph mode}
+@anchor{modes outer paragraph mode}
+Paragraph mode has two subcases. If you use a @code{\parbox} command or
+or a @code{minipage} then @LaTeX{} is put into paragraph mode. But it
+will not put a page break here. Inside one of these boxes, called a
+@dfn{parbox}, @LaTeX{} is in @dfn{inner paragraph mode}. Its more usual
+situation, where it can put page breaks, is @dfn{outer paragraph mode}
+(@pxref{Page breaking}).
@menu
* \ensuremath:: Ensure that math mode is active
@@ -9259,37 +12500,27 @@ Synopsis:
\ensuremath@{@var{formula}@}
@end example
-The @code{\ensuremath} command ensures that @var{formula} is typeset in
-math mode whatever the current mode in which the command is used.
+Ensure that @var{formula} is typeset in math mode.
-For instance:
+For instance, you can redefine commands that ordinarily can be used only
+in math mode, so that they can be used both in math and in plain text.
@example
-\documentclass@{report@}
-\newcommand@{\ab@}@{\ensuremath@{(\delta, \varepsilon)@}@}
-\begin@{document@}
-Now, the \ab\ pair is equal to \(\ab = (\frac@{1@}@{\pi@}, 0)\), ...
-\end@{document@}
+\newcommand@{\dx@}@{\ensuremath@{dx@}@}
+In $\int f(x)\, \dx$, the \dx@{@} is an infinitesimal.
@end example
-One can redefine commands that can be used only in math mode so that
-they ca be used in any mode like in the following example given for
-@code{\leadsto}:
+Caution: the @code{\ensuremath} command is useful but not a panacea.
-@c Vincent 2 Karl : "Tous les chemins mènent à Rome" is a French saying
-@c meaning that there are many different ways to get the same result. I
-@c am not sure whether in English the given example is also funny.
@example
-\documentclass@{report@}
-\usepackage@{amssymb@}
-\newcommand@{\originalMeaningOfLeadsTo@}@{@}
-\let\originalMeaningOfLeadsTo\leadsto
-\renewcommand\leadsto@{\ensuremath@{\originalMeaningOfLeadsTo@}@}
-\begin@{document@}
-All roads \leadsto\ Rome.
-\end@{document@}
+\newcommand@{\alf@}@{\ensuremath@{\alpha@}@}
+You get an alpha in text mode: \alf.
+But compare the correct spacing in $\alf+\alf$ with that in \alf+\alf.
@end example
+@noindent
+Best is to typeset math things in a math mode.
+
@node Page styles
@chapter Page styles
@@ -9297,8 +12528,15 @@ All roads \leadsto\ Rome.
@cindex styles, page
@cindex page styles
-The @code{\documentclass} command determines the size and position of
-the page's head and foot. The page style determines what goes in them.
+The style of a page determines where @LaTeX{} places the components of
+that page, such as headers and footers, and the text body. This
+includes pages in the main part of the document but also includes
+special pages such as the title page of a book, a page from an index, or
+the first page of an article.
+
+@PkgIndex{fancyhdr}
+The package @file{fancyhdr} is very helpful for constructing page
+styles. See its documentation on CTAN.
@menu
* \maketitle:: Generate a title page.
@@ -9314,41 +12552,89 @@ the page's head and foot. The page style determines what goes in them.
@cindex titles, making
@findex \maketitle
-The @code{\maketitle} command generates a title on a separate title
-page---except in the @code{article} class, where the title is placed
-at the top of the first page. Information used to produce the title
-is obtained from the following declarations:
+Synopsis:
+
+@example
+\maketitle
+@end example
+
+Generate a title. In the standard classes the title appears on a
+separate page, except in the @code{article} class where it is at the top
+of the first page. (@xref{Document class options} for information about
+the @code{titlepage} document class option.)
+
+This example shows @code{\maketitle} appearing in its usual place,
+immediately after @code{\begin@{document@}}.
+
+@example
+\documentclass@{article@}
+\title@{Constructing a Nuclear Reactor Using Only Coconuts@}
+\author@{Jonas Grumby\thanks@{%
+ With the support of a Ginger Grant from the Roy Hinkley Society.@} \\
+ Skipper, \textit@{Minnow@}
+ \and
+ Willy Gilligan\thanks@{%
+ Thanks to the Mary Ann Summers foundation
+ and to Thurston and Lovey Howell.@} \\
+ Mate, \textit@{Minnow@}
+ @}
+\date@{1964-Sep-26@}
+\begin@{document@}
+\maketitle
+Just sit right back and you'll hear a tale, a tale of a fateful trip.
+That started from this tropic port, aboard this tiny ship. The mate was
+a mighty sailin' man, the Skipper brave and sure. Five passengers set
+sail that day for a three hour tour. A three hour tour.
+ ...
+@end example
+
+You tell @LaTeX{} the information used to produce the title by making
+the following declarations. These must come before the
+@code{\maketitle}, either in the preamble or in the document body.
@ftable @code
-@item \author@{@var{name} \and @var{name2}@}
+@item \author@{@var{name1} \and @var{name2} \and ...@}
@cindex author, for titlepage
@findex \\ @r{for @code{\author}}
@findex \and @r{for @code{\author}}
-The @code{\author} command declares the document author(s), where the
-argument is a list of authors separated by @code{\and} commands. Use
-@code{\\} to separate lines within a single author's entry---for
-example, to give the author's institution or address.
+Required. Declare the document author or authors. The argument is a
+list of authors separated by @code{\and} commands. To separate lines
+within a single author's entry, for instance to give the author's
+institution or address, use a double backslash, @code{\\}. If you omit
+the @code{\author} declaration then you get @samp{LaTeX Warning: No
+\author given}.
@item \date@{@var{text}@}
@cindex date, for titlepage
-The @code{\date} command declares @var{text} to be the document's
-date. With no @code{\date} command, the current date (@pxref{\today})
-is used.
+Optional. Declare @var{text} to be the document's date. The @var{text}
+doesn't need to be in a date format; it can be any text at all. If you
+omit @code{\date} then @LaTeX{} uses the current date (@pxref{\today}).
+To have no date, instead use @code{\date@{@}}.
@item \thanks@{@var{text}@}
@cindex thanks, for titlepage
@cindex credit footnote
-The @code{\thanks} command produces a @code{\footnote} to the title,
-usually used for credit acknowledgements.
+Optional. Produce a footnote. You can use it in the author information
+for acknowledgements, as illustrated below, but you can also use it in
+the title, or any place a footnote makes sense. It can be any text so
+you can use it to print an email address, or for any purpose.
@item \title@{@var{text}@}
@cindex title, for titlepage
@findex \\ @r{for @code{\title}}
-The @code{\title} command declares @var{text} to be the title of the
-document. Use @code{\\} to force a line break, as usual.
+Required. Declare @var{text} to be the title of the document. Get line
+breaks inside @var{text} with a double backslash, @code{\\}. If you
+omit the @code{\title} declaration then you get @samp{LaTeX Error: No
+\title given}.
@end ftable
+Many publishers will provide a class to use in place of @code{article}
+in that example, that formats the title according to their house
+requirements. To make your own, see@tie{}@ref{titlepage}. You can
+either create this as a one-off or you can include it as part of a
+renewed @code{\maketitle} command.
+
@node \pagenumbering
@section @code{\pagenumbering}
@@ -9359,30 +12645,65 @@ document. Use @code{\\} to force a line break, as usual.
Synopsis:
@example
-\pagenumbering@{@var{style}@}
+\pagenumbering@{@var{number-style}@}
+@end example
+
+Specifies the style of page numbers, and resets the page number. The
+numbering style is reflected on the page, and also in the table of
+contents and other page references. This declaration has global scope
+so its effect is not delimited by braces or environments.
+
+In this example, before the Main section the pages are numbered
+@samp{a}, etc. Starting on the page containing that section, the pages
+are numbered @samp{1}, etc.
+
+@example
+\begin@{document@}\pagenumbering@{alph@}
+ ...
+\section@{Main@}\pagenumbering@{arabic@}
+ ...
@end example
-Specifies the style of page numbers, according to @var{style}; also
-resets the page number to 1. The @var{style} argument is one of
-the following:
+The argument @var{number-style} is one of the following (see
+also@tie{}@ref{\alph \Alph \arabic \roman \Roman \fnsymbol}).
@table @code
@item arabic
-arabic numerals
+arabic numerals: 1, 2, @dots{}
@item roman
-lowercase Roman numerals
+lowercase Roman numerals: i, ii, @dots{}
@item Roman
-uppercase Roman numerals
+uppercase Roman numerals: I, II, @dots{}
@item alph
-lowercase letters
+lowercase letters: a, b, @dots{} If you have more than 26 pages then you
+get @samp{LaTeX Error: Counter too large}.
@item Alph
-uppercase letters
+uppercase letters: A, B, @dots{} If you have more than 26 pages then you
+get @samp{LaTeX Error: Counter too large}.
+
+@item gobble
+@PkgIndex{hyperref} @LaTeX{} does not output a page number, although it
+does get reset. References to that page also are blank. (This does not
+work with the popular package @file{hyperref} so to have the page number
+not appear you may want to instead use @code{\pagestyle@{empty@}} or
+@code{\thispagestyle@{empty@}}.)
+
@end table
+Traditionally, if a document has front matter---preface, table of
+contents, etc.---then it is numbered with lowercase Roman numerals. The
+main matter of a document uses arabic. @xref{\frontmatter & \mainmatter
+& \backmatter}.
+
+If you want to address where the page number appears on the page,
+see@tie{}@ref{\pagestyle}. If you want to change the value of page
+number then you will manipulate the @code{page} counter
+(@pxref{Counters}).
+
@node \pagestyle
@section @code{\pagestyle}
@@ -9398,19 +12719,28 @@ Synopsis:
\pagestyle@{@var{style}@}
@end example
-The @code{\pagestyle} command specifies how the headers and footers
-are typeset from the current page onwards. Values for @var{style}:
+Declaration that specifies how the page headers and footers are typeset,
+from the current page onwards.
+
+@PkgIndex{fancyhdr}
+A discussion with an example is below. Note first that the package
+@file{fancyhdr} is now the standard way to manipulate headers and
+footers. New documents that need to do anything other than one of the
+standard options below should use this package. See its documentation
+on CTAN.
+
+Values for @var{style}:
@table @code
@item plain
-Just a plain page number.
+The header is empty. The footer contains only a page number, centered.
@item empty
-Empty headers and footers, e.g., no page numbers.
+The header and footer is empty.
@item headings
-Put running headers on each page. The document style specifies what
-goes in the headers.
+Put running headers and footers on each page. The document style
+specifies what goes in there; see the discussion below.
@item myheadings
Custom headers, specified via the @code{\markboth} or the
@@ -9418,31 +12748,104 @@ Custom headers, specified via the @code{\markboth} or the
@end table
+Some discussion of the motivation for @LaTeX{}'s mechanism will help you
+work with the options @code{headings} or @code{myheadings}. The
+document source below produces an article, two-sided, with the pagestyle
+@code{headings}. On this document's left hand pages, @LaTeX{} wants (in
+addition to the page number) the title of the current section. On its
+right hand pages @LaTeX{} wants the title of the current subsection.
+When it makes up a page, @LaTeX{} gets this information from the
+commands @code{\leftmark} and @code{\rightmark}. So it is up to
+@code{\section} and @code{\subsection} to store that information there.
+
+@example
+\documentclass[twoside]@{article@}
+\pagestyle@{headings@}
+\begin@{document@}
+ ... \section@{Section 1@} ... \subsection@{Subsection 1.1@} ...
+\section@{Section 2@}
+ ...
+\subsection@{Subsection 2.1@}
+ ...
+\subsection@{Subsection 2.2@}
+ ...
+@end example
+
+@noindent
+Suppose that the second section falls on a left page. Although when the
+page starts it is in the first section, @LaTeX{} will put
+@samp{Section@tie{}2} in the left page header. As to the right header,
+if no subsection starts before the end of the right page then @LaTeX{}
+blanks the right hand header. If a subsection does appear before the
+right page finishes then there are two cases. If at least one
+subsection starts on the right hand page then @LaTeX{} will put in the
+right header the title of the first subsection starting on that right
+page. If at least one of 2.1, 2.2, @dots{}, starts on the left page but
+none starts on the right then @LaTeX{} puts in the right hand header the
+title of the last subsection to start, that is, the one in effect during
+the right hand page.
+
+To accomplish this, in a two-sided article, @LaTeX{} has @code{\section}
+issue a command @code{\markboth}, setting @code{\leftmark}
+to @samp{Section@tie{}2} and setting @code{\rightmark} to blank.
+And, @LaTeX{} has @code{\subsection} issue a command @code{\markright},
+setting @code{\rightmark} to @samp{Subsection@tie{}2.1}, etc.
+
Here are the descriptions of @code{\markboth} and @code{\markright}:
@ftable @code
-@item \markboth@{@var{left}@}@{@var{right}@}
-Sets both the left and the right heading. A ``left-hand heading''
-(@var{left}) is generated by the last @code{\markboth} command before
-the end of the page, while a ``right-hand heading'' (@var{right}) is
-generated by the first @code{\markboth} or @code{\markright} that
-comes on the page if there is one, otherwise by the last one before
-the page.
+@item \markboth@{@var{left-head}@}@{@var{right-head}@}
+Sets both the right hand and left hand heading information for either a
+page style of @code{headings} or @code{myheadings}. A left hand page
+heading @var{left-head} is generated by the last @code{\markboth}
+command before the end of the page. A right hand page heading
+@var{right-head} is generated by the first @code{\markboth} or
+@code{\markright} that comes on the page if there is one, otherwise by
+the last one that came before that page.
@item \markright@{@var{right}@}
-Sets the right heading, leaving the left heading unchanged.
+Sets the right hand page heading, leaving the left unchanged.
@end ftable
@node \thispagestyle
-@section @code{\thispagestyle@{@var{style}@}}
+@section @code{\thispagestyle}
@findex \thispagestyle
+@cindex page style, this page
+
+Synopsis:
+
+@example
+\thispagestyle@{@var{style}@}
+@end example
+
+Works in the same way as the @code{\pagestyle} (@pxref{\pagestyle}),
+except that it changes to @var{style} for the current page only. This
+declaration has global scope, so its effect is not delimited by braces
+or environments.
+
+Often the first page of a chapter or section has a different style. For
+example, this @LaTeX{} book document has the first page of the first
+chapter in in @code{plain} style, as is the default (@pxref{Page
+styles}).
+
+@example
+\documentclass@{book@}
+\pagestyle@{headings@}
+\begin@{document@}
+\chapter@{First chapter@}
+ ...
+\chapter@{Second chapter@}\thispagestyle@{empty@}
+ ...
+@end example
-The @code{\thispagestyle} command works in the same manner as the
-@code{\pagestyle} command (see previous section) except that it
-changes to @var{style} for the current page only.
+@noindent
+The @code{plain} style has a page number on it, centered in the footer.
+To make the page entirely empty, the command
+@code{\thispagestyle@{empty@}} immediately follows the second
+@code{\chapter}.
@node Spaces
@@ -9451,59 +12854,131 @@ changes to @var{style} for the current page only.
@cindex spaces
@cindex white space
-@LaTeX{} has many ways to produce white (or filled) space.
+@LaTeX{} has many ways to produce white (or filled) space. Some of
+these are best suited to mathematical text; see@tie{}@ref{Spacing in
+math mode}. Some spacing commands are suitable for both regular text
+and mathematical text; versions of some of these commands are in this
+chapter.
@menu
Horizontal space
-* \hspace:: Fixed horizontal space.
-* \hfill:: Stretchable horizontal space.
-* \spacefactor:: Stretchability of following space
-* \(SPACE) after control sequence:: Space (gobbling) after a control sequence.
-* \thinspace:: One-sixth of an em.
-* \/:: Insert italic correction.
-* \hrulefill \dotfill:: Stretchable horizontal rule or dots.
+* \enspace & \quad & \qquad:: Traditional horizontal spaces.
+* \hspace:: Any horizontal space.
+* \hfill:: Stretchable horizontal space.
+* \hss:: Infinitely stretchable/shrinkable horizontal space.
+* \spacefactor:: Stretchability of following space
+* \(SPACE):: Backslash-space; and explicit space.
+* ~:: Tie, an unbreakable space.
+* \thinspace & \negthinspace:: One-sixth of an em, and negative one-sixth.
+* \/:: Italic correction.
+* \hrulefill & \dotfill:: Stretchable horizontal rule or dots.
Vertical space
-* \addvspace:: Add arbitrary vertical space if needed.
-* \bigskip \medskip \smallskip:: Fixed vertical spaces.
-* \vfill:: Infinitely stretchable vertical space.
-* \vspace:: Add arbitrary vertical space.
+* \bigskip & \medskip & \smallskip:: Inter-paragraph vertical spaces.
+* \bigbreak & \medbreak & \smallbreak:: Inter-paragraph space and page breaks.
+* \strut:: Ensure height of a line.
+* \vspace:: Vertical space.
+* \vfill:: Stretchable vertical space.
+* \addvspace:: Add arbitrary vertical space if needed.
@end menu
+@node \enspace & \quad & \qquad
+@section @code{\enspace} & @code{\quad} & @code{\qquad}
+
+@findex \enspace
+@findex \quad
+@findex \qquad
+
+Synopsis, one of:
+
+@example
+\enspace
+\quad
+\qquad
+@end example
+
+Insert a horizontal space of 1/2@dmn{em}, 1@dmn{em}, or 2@dmn{em}. The
+em is a length defined by a font designer, often thought of as being the
+width of a capital@tie{}M. One advantage of describing space in ems is
+that it can be more portable across documents than an absolute
+measurement such as points (@pxref{Lengths/em}).
+
+This puts a suitable gap between two graphics.
+
+@example
+\begin@{center@}
+ \includegraphics@{womensmile.png@}%
+ \qquad\includegraphics@{mensmile.png@}
+\end@{center@}
+@end example
+
+@noindent
+@xref{Spacing in math mode} for @code{\quad} and @code{\qquad}. These
+are lengths from centuries of typesetting and so may be a better choice
+in many circumstances than arbitrary lengths, such as you get with
+@code{\hspace}.
+
+
@node \hspace
@section @code{\hspace}
@findex \hspace
-Synopsis:
+Synopsis, one of:
@example
\hspace@{@var{length}@}
\hspace*@{@var{length}@}
@end example
-Add the horizontal space given by @var{length}. The @var{length} is a
-rubber length, that is, it may contain a @code{plus} or @code{minus}
-component, in any unit that @LaTeX{} understands (@pxref{Lengths}).
+Insert the horizontal space @var{length}. The @var{length} can be
+positive, negative, or zero; adding negative space is like backspacing.
+It is a rubber length, that is, it may contain a @code{plus} or
+@code{minus} component, or both (@pxref{Lengths}). Because the space is
+stretchable and shrinkable, it is sometimes called @dfn{glue}.
-This command can add both positive and negative space; adding negative
-space is like backspacing.
+This makes a line with @samp{Name:} an inch from the right margin.
-Normally when @TeX{} breaks a paragraph into lines it discards white
-space (glues and kerns) that would come at the start of a line, so you
-get an inter-word space or a line break between words but not both. This
-command's starred version @code{\hspace*@{...@}} puts a non-discardable
-invisible item in front of the space, so the space appears in the
-output.
+@example
+\noindent\makebox[\linewidth][r]@{Name:\hspace@{1in@}@}
+@end example
-This example make a one-line paragraph that puts @samp{Name:} an inch
-from the right margin.
+The @code{*}-version inserts horizontal space that non-discardable.
+More precisely, when @TeX{} breaks a paragraph into lines any white
+space---glues and kerns---that come at a line break are discarded. The
+@code{*}-version avoids that (technically, it adds a non-discardable
+invisible item in front of the space).
+
+In this example
@example
-\noindent\makebox[\linewidth]@{\hspace@{\fill@}Name:\hspace@{1in@}@}
+\parbox@{0.8\linewidth@}@{%
+ Fill in each blank: Four \hspace*@{1in@} and seven years ago our
+ fathers brought forth on this continent, a new \hspace*@{1in@},
+ conceived in \hspace*@{1in@}, and dedicated to the proposition
+ that all men are created \hspace*@{1in@}.@}
@end example
+@noindent
+the 1@tie{}inch blank following @samp{conceived in} falls at the start
+of a line. If you erase the @code{*} then @LaTeX{} discards the blank.
+
+Here, the @code{\hspace} separates the three graphics.
+
+@example
+\begin@{center@}
+ \includegraphics@{lion.png@}% comment keeps out extra space
+ \hspace@{1cm minus 0.25cm@}\includegraphics@{tiger.png@}%
+ \hspace@{1cm minus 0.25cm@}\includegraphics@{bear.png@}
+\end@{center@}
+@end example
+
+@noindent
+Because the argument to each @code{\hspace} has @code{minus 0.25cm},
+each can shrink a little if the three figures are too wide. But each
+space won't shrink more than 0.25@dmn{cm} (@pxref{Lengths}).
+
@node \hfill
@section @code{\hfill}
@@ -9512,14 +12987,77 @@ from the right margin.
@cindex stretch, infinite horizontal
@cindex infinite horizontal stretch
-Produce a rubber length which has
-no natural space but can stretch horizontally as far as
-needed (@pxref{Lengths}).
+
+Synopsis:
+
+@example
+\hfill
+@end example
+
+Produce a rubber length which has no natural space but that can stretch
+horizontally as far as needed (@pxref{Lengths}).
+
+This creates a one-line paragraph with @samp{Name:} on the left side
+of the page and @samp{Quiz One} on the right.
+
+@example
+\noindent Name:\hfill Quiz One
+@end example
@findex \fill
-The command @code{\hfill} is equivalent to @code{\hspace@{\fill@}}. For
-space that does not disappear at line breaks use
-@code{\hspace*@{\fill@}} instead (@pxref{\hspace}).
+The @code{\hfill} command is equivalent to @code{\hspace@{\fill@}} and
+so the space can be discarded at line breaks. To avoid that instead use
+@code{\hspace*@{\fill@}} (@pxref{\hspace}).
+
+Here the graphs are evenly spaced in the middle of the figure.
+
+@example
+\newcommand*@{\vcenteredhbox@}[1]@{\begin@{tabular@}@{@@@{@}c@@@{@}@}#1\end@{tabular@}@}
+ ...
+\begin@{figure@}
+ \hspace*@{\fill@}%
+ \vcenteredhbox@{\includegraphics@{graph0.png@}@}%
+ \hfill\vcenteredhbox@{\includegraphics@{graph1.png@}@}%
+ \hspace*@{\fill@}%
+ \caption@{Comparison of two graphs@} \label@{fig:twographs@}
+\end@{figure@}
+@end example
+
+@noindent
+Note the @code{\hspace*}'s where the space could otherwise be dropped.
+
+
+@node \hss
+@section @code{\hss}
+
+@findex \hss
+@cindex horizontal space
+@cindex horizontal space, stretchable
+@cindex space, inserting horizontal
+
+Synopsis:
+
+@example
+\hss
+@end example
+
+Produce a horizontal space that is infinitely shrinkable as well as
+infinitely stretchable (this command is a @TeX{} primitive). @LaTeX{}
+authors should reach first for the @code{\makebox} command to get the
+effects of @code{\hss} (@pxref{\mbox & \makebox}).
+
+Here, the first line's @code{\hss} makes the Z stick out to the right,
+overwriting the Y. In the second line the Z sticks out to the left,
+overwriting the X.
+
+@example
+X\hbox to 0pt@{Z\hss@}Y
+X\hbox to 0pt@{\hss Z@}Y
+@end example
+
+@noindent
+Without the @code{\hss} you get something like @samp{Overfull \hbox
+(6.11111pt too wide) detected at line 20}.
@node \spacefactor
@@ -9532,24 +13070,26 @@ Synopsis:
@end example
@findex \spacefactor
-While @LaTeX{} is making the page, to give the lines the best appearance
-it may stretch or shrink the gaps between words. The
-@code{\spacefactor} command (from Plain@tie{}@TeX{}) allows you to
-change the @LaTeX{}'s default behavior.
+Influence @LaTeX{}'s glue stretch and shrink behavior. Most user-level
+documents do not use this command.
+
+While @LaTeX{} is laying out the material, it may stretch or shrink the
+gaps between words. (This space is not a character; it is called the
+@dfn{interword glue}; @pxref{\hspace}). The @code{\spacefactor} command
+(from Plain@tie{}@TeX{}) allows you to, for instance, have the space
+after a period stretch more than the space after a word-ending letter.
After @LaTeX{} places each character, or rule or other box, it sets a
parameter called the @dfn{space factor}. If the next thing in the input
-is a space then this parameter affects how much of a horizontal gap
-@LaTeX{} will have it span. (This gap is not a character; it is called
-@dfn{interword glue}.) A larger space factor means that the glue gap
-can stretch more and shrink less.
-
-Normally, the space factor is 1000; this value is in effect following
-most characters, and any non-character box or math formula. But it is
-3000 after a period, exclamation mark, or question mark, it is 2000
-after a colon, 1500 after a semicolon, 1250 after a comma, and 0 after a
-right parenthesis or bracket, or closing double quote or single quote.
-Finally, it is 999 after a capital letter.
+is a space then this parameter affects how much stretching or shrinking
+can happen. A space factor that is larger than the normal value means
+that the glue can stretch more and shrink less. Normally, the space
+factor is 1000. This value is in effect following most characters, and
+any non-character box or math formula. But it is 3000 after a period,
+exclamation mark, or question mark, it is 2000 after a colon, 1500 after
+a semicolon, 1250 after a comma, and 0 after a right parenthesis or
+bracket, or closing double quote or single quote. Finally, it is 999
+after a capital letter.
If the space factor@tie{}@var{f} is 1000 then the glue gap will be the
font's normal space value (for Computer Modern Roman 10 point this is
@@ -9558,65 +13098,103 @@ than 2000 then @TeX{} adds the font's extra space value (for Computer
Modern Roman 10 point this is 1.11111@tie{}points), and then the font's
normal stretch value is multiplied by @math{f /1000} and the normal
shrink value is multiplied by @math{1000/f} (for Computer Modern Roman
-10 point these are 1.66666 and 1.11111@tie{}points). In short, compared
-to a normal space, such as the space following a word ending in a
-lowercase letter, inter-sentence spacing has a fixed extra space added
-and then the space can stretch 3 times as much and shrink 1/3 as much.
-
-The rules for how @TeX{} uses space factors are even more complex
-because they play two more roles. In practice, there are two
-consequences. First, if a period or other punctuation is followed by a
-close parenthesis or close double quote then its effect is still in
-place, that is, the following glue will have increased stretch and
-shrink. Second, conversely, if punctuation comes after a capital letter
-then its effect is not in place so you get an ordinary space. For how
-to adjust to this second case, for instance if an abbreviation does not
-end in a capital letter, @pxref{\(SPACE) and \@@}.
+10 point these are 1.66666 and 1.11111@tie{}points).
+
+For example, consider the period ending @code{A man's best friend is his
+dog.} After it, @TeX{} puts in a fixed extra space, and also allows the
+glue to stretch 3 times as much and shrink 1/3 as much, as the glue
+after @code{friend}, which does not end in a period.
+
+The rules for space factors are even more complex because they play
+additional roles. In practice, there are two consequences. First, if a
+period or other punctuation is followed by a right parenthesis or
+bracket, or right single or double quote then the spacing effect of that
+period carries through those characters (that is, the following glue
+will have increased stretch and shrink). Second, if
+punctuation comes after a capital letter then its effect is not in place
+so you get an ordinary space. This second case also affects abbreviations
+that do not end in a capital letter (@pxref{\@@}).
+
+You can only use @code{\spacefactor} in paragraph mode or LR mode
+(@pxref{Modes}). You can see the current value with
+@code{\the\spacefactor} or @code{\showthe\spacefactor}.
+
+(Comment, not really related to @code{\spacefactor}: if you get errors
+like @samp{You can't use `\spacefactor' in vertical mode}, or @samp{You
+can't use `\spacefactor' in math mode.}, or @samp{Improper \spacefactor}
+then you have probably tried to redefine an internal command.
+@xref{\makeatletter & \makeatother}.)
@menu
-* \(SPACE) and \@@:: Space after a period.
-* \frenchspacing:: Equal interword and inter-sentence space.
-* \normalsfcodes:: Restore space factor settings to the default.
+* \@@:: Distinguish sentence-ending periods from abbreviations.
+* \frenchspacing:: Equal interword and inter-sentence space.
+* \normalsfcodes:: Restore space factor settings to the default.
@end menu
-@node \(SPACE) and \@@
-@subsection @code{\(SPACE)} and @code{\@@}
+@node \@@
+@subsection @code{\@@}
-@findex \(SPACE)
-@findex \TAB
-@findex \NEWLINE
@findex \@@
+@findex at-sign
+@cindex period, sentence-ending
+@cindex period, abbreviation-ending
+@cindex period, spacing after
@anchor{\AT}@c old name
-Here, @code{\(SPACE)} means a backslash followed by a space. These
-commands mark a punctuation character, typically a period, as either
-ending a sentence or as ending an abbreviation.
+Synopsis:
+
+@example
+@var{capital-letter}\@@.
+@end example
-By default, in justifying a line @LaTeX{} adjusts the space after a
-sentence-ending period (or a question mark, exclamation point, comma, or
-colon) more than the space between words. @xref{\spacefactor}. As
-described there, @LaTeX{} assumes that the period ends a sentence unless
-it is preceded by a capital letter, in which case it takes that period
-for part of an abbreviation. Note that if a sentence-ending period is
-immediately followed by a right parenthesis or bracket, or right single
-or double quote, then the space effect of that period follows through
-that parenthesis or quote.
+Treat a period as sentence-ending, where @LaTeX{} would otherwise think
+it is part of an abbreviation. @LaTeX{} thinks that a period ends an
+abbreviation if the period comes after a capital letter, and otherwise
+thinks the period ends the sentence. By default, in justifying a line
+@LaTeX{} adjusts the space after a sentence-ending period (or a question
+mark, exclamation point, comma, or colon) more than it adjusts the space
+between words (@pxref{\spacefactor}).
-So: if you have a period ending an abbreviation whose last letter is not
-a capital letter, and that abbreviation is not the last word in the
-sentence, then follow that period with a backslash-space (@code{\ }) or
-a tie (@code{~}) or a @code{\@@}. Examples are @code{Nat.\ Acad.\
-Science}, and @code{Mr.~Bean}, and @code{(manure, etc.\@@) for sale}
-(note that in the last the @code{\@@} comes before the closing parenthesis).
+This example shows the two cases to remember.
-In the opposite situation, if you have a capital letter followed by a
-period that does end the sentence, then put @code{\@@} before the
-period. For example, @code{book by the MAA\@@.} will have correct
-inter-sentence spacing after the period.
+@example
+The songs \textit@{Red Guitar@}, etc.\ are by Loudon Wainwright~III\@@.
+@end example
-For another use of @code{\(SPACE)}, @pxref{\(SPACE) after control sequence}.
+@noindent
+The second period ends the sentence, despite that it is preceded by a
+capital. We tell @LaTeX{} that it ends the sentence by putting
+@code{\@@} before it. The first period ends the abbreviation
+@samp{etc.} but not the sentence. The backslash-space, @code{\ },
+produces a mid-sentence space.
+
+So: if you have a capital letter followed by a period that ends the
+sentence, then put @code{\@@} before the period. This holds even if
+there is an intervening right parenthesis or bracket, or right single or
+double quote, because the spacing effect of that period carries through
+those characters. For example, this
+
+@example
+Use the \textit@{Instructional Practices Guide@},
+(a book by the MAA)\@@.
+@end example
+
+@noindent
+will have correct inter-sentence spacing after the period.
+
+The @code{\@@} command is only for a text mode. If you use it outside of
+a text mode then you get @samp{You can't use `\spacefactor' in vertical
+mode} (@pxref{Modes}).
+
+Comment: the converse case is a period ending an abbreviation whose last
+letter is not a capital letter, and that abbreviation is not the last
+word in the sentence. For that case follow the period with a
+backslash-space, (@code{\ }), or a tie, (@code{~}), or @code{\@@}.
+Examples are @code{Nat.\ Acad.\ Science}, and @code{Mr.~Bean}, and
+@code{(manure, etc.\@@) for sale} (note in the last one that the
+@code{\@@} comes before the closing parenthesis).
@node \frenchspacing
@@ -9626,15 +13204,24 @@ For another use of @code{\(SPACE)}, @pxref{\(SPACE) after control sequence}.
@findex \nonfrenchspacing
@cindex spacing, inter-sentence
-This declaration (from Plain @TeX{}) causes @LaTeX{} to treat
-inter-sentence spacing in the same way as interword spacing.
+Synopsis, one of:
+
+@example
+\frenchspacing
+\nonfrenchspacing
+@end example
-In justifying the text in a line, some typographic traditions, including
-English, prefer to adjust the space between sentences (or after other
-punctuation marks) more than the space between words. Following this
-declaration, all spaces are instead treated equally.
+The first declaration causes @LaTeX{} to treat spacing between sentences
+in the same way as spacing between words in the middle of a sentence.
+The second causes spacing between sentences to stretch or shrink more
+(@pxref{\spacefactor}); this is the default.
-Revert to the default behavior by declaring @code{\nonfrenchspacing}.
+Some typographic traditions, including English, prefer to adjust the
+space between sentences (or spaces following a question mark,
+exclamation point, comma, or colon) more than the space between words
+that are in the middle of a sentence. Declaring @code{\frenchspacing}
+(the command is from Plain @TeX{}) switches to the tradition that all
+spaces are treated equally.
@node \normalsfcodes
@@ -9643,171 +13230,562 @@ Revert to the default behavior by declaring @code{\nonfrenchspacing}.
@findex \normalsfcodes
@cindex spacing, inter-sentence
-Reset the @LaTeX{} space factor values to the default.
+Synopsis:
+
+@example
+\normalsfcodes
+@end example
+
+Reset the @LaTeX{} space factor values to the default
+(@pxref{\spacefactor}).
-@node \(SPACE) after control sequence
-@section @code{\ } after control sequence
+@node \(SPACE)
+@section Backslash-space, @code{\ }
-The @code{\ } command is often used after control sequences to keep
-them from gobbling the space that follows, as in @samp{\TeX\ is nice}.
-And, under normal circumstances, @code{\}@key{tab} and
-@code{\}@key{newline} are equivalent to @code{\ }. For another use of
-@code{\ }, see also @ref{\(SPACE) and \@@}.
+@cindex \NEWLINE
+@cindex \SPACE
+@cindex \TAB
-Some people prefer to use @code{@{@}} for the same purpose, as in
-@code{\TeX@{@} is nice}. This has the advantage that you can always
-write it the same way, namely @code{\TeX@{@}}, whether it is followed
-by a space or by a punctuation mark. Compare:
+This section refers to the command consisting of two characters, a
+backslash followed by a space. Synopsis:
@example
-\TeX\ is a nice system. \TeX, a nice system.@*
-\TeX@{@} is a nice system. \TeX@{@}, a nice system.
+\
+@end example
+
+Produce a space. By default it produces white space of length
+3.33333@dmn{pt} plus 1.66666@dmn{pt} minus 1.11111@dmn{pt}.
+
+A blank is not a space. When you type a blank between words, @LaTeX{}
+produces white space. That's different from an explicit space. This
+illustrates.
+
+@example
+\begin@{tabular@}@{l@}
+Three blanks: in a row \\
+Three spaces:\ \ \ in a row \\
+\end@{tabular@}
@end example
-@PkgIndex{xspace}
-Some individual commands, notably those defined with the @code{xspace},
-package do not follow the standard behavior.
+@noindent
+On the first line @LaTeX{} collapses the three blanks to output one
+whitespace (it would be the same with a single blank or, for instance,
+with a blank and an tab and a blank, or a blank and a newline and a
+blank). But the second line asks for three spaces so the white area is
+wider. Thus, the backslash-space command will create some horizontal
+space. (But the best way to create horizontal space is with
+@code{\hspace}; @xref{\hspace}.)
+
+The backslash-space command has two main uses. First, it is often used
+after control sequences to keep them from gobbling the space that
+follows, as in @code{\TeX\ is nice}. (But the approach of using curly
+parentheses, as in @code{\TeX@{@} is nice}, has the advantage of still
+working if the next character is a period.)
+
+The second common use is that
+it mark a period as ending an abbreviation instead of ending
+a sentence, as in @code{So says Prof.\ Smith} (@pxref{\@@}).
+
+Under normal circumstances, @code{\}@key{tab} and @code{\}@key{newline}
+are equivalent to backslash-space, @code{\ }.
+
+@c @PkgIndex{xspace}
+@c Some individual commands, notably those defined with the @code{xspace},
+@c package do not follow the standard behavior.
+
+
+@node ~
+@section @code{~}
+
+@findex ~
+@cindex tie
+@cindex space, hard
+@cindex space, unbreakable
+@cindex NBSP
+
+Synopsis:
+
+@example
+@var{before}~@var{after}
+@end example
+
+The tie character, @code{~}, produces a space between @var{before} and
+@var{after} at which the line will not be broken. By default the white
+space has length 3.33333@dmn{pt} plus 1.66666@dmn{pt} minus
+1.11111@dmn{pt} (@pxref{Lengths}).
+
+Here @LaTeX{} will not break the line between the final two words.
+
+@example
+Thanks to Prof.~Lerman.
+@end example
+
+@noindent
+In addition, despite the period, @LaTeX{} does not use the
+end-of-sentence spacing (@pxref{\@@}).
+
+Ties prevent the end of line separation of things where that could cause
+confusion. But they also reduce @LaTeX{}'s options when it breaks lines
+into paragraphs, so you can use too many. They are also matters of
+taste, sometimes alarmingly dogmatic taste, among readers. Nevertheless,
+here are some usage models, many of them from the @TeX{}book.
+
+@itemize @bullet
+@item
+Between an enumerator and its item, such as in references:
+@code{Chapter~12}, or @code{Theorem~\ref@{th:Wilsons@}}, or
+@code{Figure~\ref@{fig:KGraph@}}. When cases are enumerated inline:
+@code{(b)~Show that $f(x)$ is (1)~continuous, and (2)~bounded}.
+
+@PkgIndex{siunitx}
+@item
+Between a number and its unit: @code{$745.7.8$~watts} (the
+@file{siunitx} package has a special facility for this) or
+@code{144~eggs}. This includes between a month and a date:
+@code{October~12} or @code{12~Oct}. In general, in any expressions where
+numbers and abbreviations or symbols are separated by a space:
+@code{AD~565}, or @code{2:50~pm}, or @code{Boeing~747}, or
+@code{268~Plains Road}, or @code{\$$1.4$~billion}.
+
+@item
+When mathematical phrases are rendered in words: @code{equals~$n$}, or
+@code{less than~$\epsilon$}, or @code{given~$X$}, or @code{modulo~$p^e$
+for all large~$n$} (but compare @code{is~$15$} with @code{is $15$~times
+the height}). Between mathematical symbols in apposition with nouns:
+@code{dimension~$d$} or @code{function~$f(x)$} (but compare @code{with
+length $l$~or more}). When a symbol is a tightly bound object of a
+preposition: @code{of~$x$}, or @code{from $0$ to~$1$}, or @code{in
+common with~$m$}.
+
+@item
+Between symbols in series: @code{$1$,~$2$, or~$3$} or @code{$1$,~$2$,
+\ldots,~$n$}.
+
+@item
+Between a person's forenames and between multiple surnames:
+@code{Donald~E. Knuth}, or @code{Luis~I. Trabb~Pardo}, or
+@code{Charles~XII} (but you must give TeX places to break the line so
+you may do @code{Charles Louis Xavier~Joseph de~la Vall\'ee~Poussin}).
+
+@item
+Before a dash: @code{pages 12~--14} or @code{it is~--- it must be
+said~--- plausible}.
+
+@end itemize
-@node \thinspace
-@section @code{\thinspace}: Insert 1/6@dmn{em}
+@node \thinspace & \negthinspace
+@section @code{\thinspace} & @code{\negthinspace}
@findex \thinspace
+@findex \negthinspace
+@cindex thin space
+@cindex space, thin
+@cindex thin space, negative
+@cindex space, negative thin
+
+Synopsis, one of:
+
+@example
+\thinspace
+\negthinspace
+@end example
-@code{\thinspace} produces an unbreakable and unstretchable space that
-is 1/6 of an em. This is the proper space to use between nested
-quotes, as in '@dmn{}''.@c Abuse @dmn, which is a thin space in Texinfo.
+Produce an unbreakable and unstretchable space of 1/6@dmn{em} and
+-1/6@dmn{em}. These are the text mode equivalents of @code{\,} and
+@code{\!} (@pxref{Spacing in math mode/\thinspace}). You can use
+@code{\,} as a synonym for @code{\thinspace} in text mode.
+
+The @code{\negthinspace} command is used in text mode mostly for
+fiddling with spaces. One common use of @code{\thinspace} is as the
+space between nested quotes.
+
+@example
+Killick replied, ``I heard the Captain say, `Ahoy there.'\thinspace''
+@end example
+
+@noindent
+Another use is that some style guides call for a @code{\thinspace}
+between an ellipsis and a sentence ending period (other style guides,
+though, think the three dots are quite enough already). Still another
+use is between initials, as in @code{D.\thinspace E.\ Knuth}.
@node \/
-@section @code{\/}: Insert italic correction
+@section @code{\/}
@findex \/
@cindex italic correction
-The @code{\/} command produces an @dfn{italic correction}. This is a
-small space defined by the font designer for a given character,
-to avoid the character colliding with whatever follows. The italic
-@i{f} character typically has a large italic correction value.
+Synopsis:
-If the following character is a period or comma, it's not necessary to
-insert an italic correction, since those punctuation symbols have a
-very small height. However, with semicolons or colons, as well as
-normal letters, it can help. Compare
-@tex
-{\it f\/: f\/;}
-@end tex
-@ifnottex
-@i{f: f;} (in the @TeX{} output, the `f's are nicely separated)
-@end ifnottex
-with @i{f: f;}.
+@example
+@var{before-character}\/@var{after-character}
+@end example
-When changing fonts with commands such as @code{\textit@{italic
-text@}} or @code{@{\itshape italic text@}}, @LaTeX{} will
-automatically insert an italic correction if appropriate (@pxref{Font
-styles}).
+Insert an @dfn{italic correction}, a small space defined by the font
+designer for each character, to avoid the character colliding with
+whatever follows. When you use @code{\/}, @LaTeX{} takes the correction
+from the font metric file, scales it by any scaling that has been
+applied to the font, and then inserts that much horizontal space.
-Despite the name, roman characters can also have an italic
-correction. Compare
-@tex
-pdf\/\TeX{}
-@end tex
-@ifnottex
-pdf@TeX{} (in the @TeX{} output, there is a small space after the `f')
-@end ifnottex
-with pdf@TeX{}.
+Here, were it not for the @code{\/}, the @var{before-character}
+italic@tie{}f would hit the @var{after-character} roman@tie{}H
+
+@example
+\newcommand@{\companylogo@}@{@{\it f@}\/H@}
+@end example
+
+@noindent
+because the italic letter leans far to the right.
+
+If @var{after-character} is a period or comma then don't insert an
+italic correction since those punctuation symbols have a very small
+height. However, with semicolons or colons as well as with normal
+letters, the italic correction can help.
+
+When you use commands such as @code{\textit} or @code{\itshape} to
+change fonts, @LaTeX{} will automatically insert any needed italic
+correction (@pxref{Font styles}).
+
+Roman characters can also have an italic correction. An example is in
+the name @code{pdf\/\TeX}.
There is no concept of italic correction in math mode; spacing is done
in a different way.
-@node \hrulefill \dotfill
-@section @code{\hrulefill \dotfill}
+@node \hrulefill & \dotfill
+@section @code{\hrulefill} & @code{\dotfill}
@findex \hrulefill
@findex \dotfill
-Produce an infinite rubber length (@pxref{Lengths}) filled with a
-horizontal rule (that is, a line) or with dots, instead of just white
-space.
+Synopsis, one of:
+
+@example
+\hrulefill
+\dotfill
+@end example
+
+Produce an infinite horizontal rubber length (@pxref{Lengths}) that
+@LaTeX{} fills with a rule (that is, a line) or with dots, instead of
+white space.
-When placed between blank lines this example creates a paragraph that is
-left and right justified, where the space in the middle is filled with
-evenly spaced dots.
+This outputs a line 2 inches long.
@example
-\noindent Jack Aubrey\dotfill Melbury Lodge
+Name:~\makebox[2in]@{\hrulefill@}
+@end example
+
+@noindent
+This example, when placed between blank lines, creates a paragraph that
+is left and right justified and where the middle is filled with evenly
+spaced dots.
+
+@example
+\noindent John Aubrey, RN \dotfill@{@} Melbury Lodge
@end example
To make the rule or dots go to the line's end use @code{\null} at the
start or end.
To change the rule's thickness, copy the definition and adjust it, as
-with @code{\renewcommand@{\hrulefill@}@{\leavevmode\leaders\hrule height
-1pt\hfill\kern\z@@@}}, which changes the default thickness of
-0.4@dmn{pt} to 1@dmn{pt}. Similarly, adjust the dot spacing as with
-@code{\renewcommand@{\dotfill@}@{\leavevmode\cleaders\hb@@xt@@
-1.00em@{\hss .\hss @}\hfill\kern\z@@@}}, which changes the default
-length of 0.33@dmn{em} to 1.00@dmn{em}.
+here
+@example
+\renewcommand@{\hrulefill@}@{%
+ \leavevmode\leaders\hrule height 1pt\hfill\kern\z@@@}
+@end example
-@node \addvspace
-@section @code{\addvspace}
+@noindent
+which changes the default thickness of 0.4@dmn{pt} to 1@dmn{pt}.
+Similarly, adjust the dot spacing as with
-@findex \addvspace
-@cindex vertical space
-@cindex space, inserting vertical
+@example
+\renewcommand@{\dotfill@}@{%
+ \leavevmode\cleaders\hb@@xt@@1.00em@{\hss .\hss @}\hfill\kern\z@@@}
+@end example
+
+@noindent
+which changes the default length of 0.33@dmn{em} to 1.00@dmn{em}.
+
+This example produces a line for a signature.
+
+@example
+\begin@{minipage@}@{4cm@}
+ \centering
+ \hrulefill\\
+ Signed
+\end@{minipage@}
+@end example
-@code{\addvspace@{@var{length}@}}
+@noindent
+The line is 4@dmn{cm} long.
+
+
+@node \bigskip & \medskip & \smallskip
+@section @code{\bigskip} & @code{\medskip} & @code{\smallskip}
-Add a vertical space of height @var{length}, which is a rubber length
-(@pxref{Lengths}). However, if vertical space has already been added to
-the same point in the output by a previous @code{\addvspace} command
-then this command will not add more space than what is needed to make
-the natural length of the total vertical space equal to @var{length}.
+Synopsis, one of:
-Use this command to adjust the vertical space above or below an
-environment that starts a new paragraph. For instance, a Theorem
-environment is defined to begin and end with @code{\addvspace@{...@}}
-so that two consecutive Theorem's are separated by one vertical space,
-not two.
+@example
+\bigskip
+\medskip
+\smallskip
+@end example
-This command is fragile (@pxref{\protect}).
+Produce an amount of vertical space, large or medium-sized or
+small. These commands are fragile (@pxref{\protect}).
-The error @samp{Something's wrong--perhaps a missing \item} means that
-you were not in vertical mode when you invoked this command; one way to
-change that is to precede this command with a @code{\par} command.
+Here the skip suggests the passage of time (from @i{The Golden Ocean} by
+O'Brian).
+@example
+Mr Saumarez would have something rude to say to him, no doubt: he
+was at home again, and it was delightful.
-@node \bigskip \medskip \smallskip
-@section @code{\bigskip \medskip \smallskip}
+\bigskip
+``A hundred and fifty-seven miles and one third, in twenty-four hours,''
+said Peter.
+@end example
-These commands produce a given amount of space, specified by the
-document class.
+Each command is associated with a length defined in the document class
+file.
@ftable @code
+@anchor{bigskip}
@item \bigskip
@findex \bigskipamount
The same as @code{\vspace@{\bigskipamount@}}, ordinarily about one line
-space, with stretch and shrink (the default for the @code{book} and
-@code{article} classes is @code{12pt plus 4pt minus 4pt}).
+space, with stretch and shrink. The default for the @code{book} and
+@code{article} classes is @code{12pt plus 4pt minus 4pt}.
+@anchor{medskip}
@item \medskip
@findex \medskipamount
-The same as @code{\vspace@{\medskipamount@}}, ordinarily about half of
-a line space, with stretch and shrink (the default for the @code{book}
-and @code{article} classes is @code{6pt plus 2pt minus 2pt}).
+The same as @code{\vspace@{\medskipamount@}}, ordinarily about half of a
+line space, with stretch and shrink. The default for the @code{book}
+and @code{article} classes is @code{6pt plus 2pt minus 2pt}.
+@anchor{smallskip}
@item \smallskip
@findex \smallskipamount
The same as @code{\vspace@{\smallskipamount@}}, ordinarily about a
-quarter of a line space, with stretch and shrink (the default for the
-@code{book} and @code{article} classes is @code{3pt plus 1pt minus
-1pt}).
+quarter of a line space, with stretch and shrink. The default for the
+@code{book} and @code{article} classes is @code{3pt plus 1pt minus 1pt}.
@end ftable
+Because each command is a @code{\vspace}, if you use on in mid-paragraph
+then it will insert its vertical space between the line in which you use
+it and the next line, not necessarily at the place that you use it. So
+these are best between paragraphs.
+
+The commands @code{\bigbreak}, @code{\medbreak}, and @code{\smallbreak}
+are similar but also suggest to @LaTeX{} that this is a good place to
+put a page break (@pxref{\bigbreak & \medbreak & \smallbreak}.
+
+
+@node \bigbreak & \medbreak & \smallbreak
+@section @code{\bigbreak} & @code{\medbreak} & @code{\smallbreak}
+
+Synopsis, one of:
+
+@example
+\bigbreak
+\medbreak
+\smallbreak
+@end example
+
+Produce a vertical space that is big or medium-sized or small, and
+suggest to @LaTeX{} that this is a good place to break the page. (The
+associated penalties are -200, -100, and -50.)
+
+@xref{\bigskip & \medskip & \smallskip}, for more. These commands
+produce the same vertical space but differ in that they also remove a
+preceding vertical space if it is less than what they would insert (as
+with @code{\addvspace}). In addition, they terminate a paragraph where
+they are used: this example
+
+@example
+abc\bigbreak def ghi
+
+jkl mno pqr
+@end example
+
+@noindent
+will output three paragraphs, the first ending in @samp{abc} and the
+second starting, after an extra vertical space and a paragraph indent,
+with @samp{def}.
+
+
+@node \strut
+@section @code{\strut}
+
+@findex \strut
+@cindex strut
+
+Synopsis:
+
+@example
+\strut
+@end example
+
+Ensure that the current line has height at least @code{0.7\baselineskip}
+and depth at least @code{0.3\baselineskip}. Essentially, @LaTeX{}
+inserts into the line a rectangle having zero width,
+@code{\rule[-0.3\baselineskip]@{0pt@}@{\baselineskip@}} (@pxref{\rule}).
+The @code{\baselineskip} changes with the current font and fontsize.
+
+In this example the @code{\strut} keeps the box inside the frame from
+having zero height.
+
+@example
+\setlength@{\fboxsep@}@{0pt@}\framebox[2in]@{\strut@}
+@end example
+
+This example has four lists. In the first there is a much bigger gap
+between items 2 and@tie{}3 than there is between items 1 and@tie{}2.
+The second list fixes that with a @code{\strut} at the end of its first
+item's second line.
+
+@example
+\setlength@{\fboxsep@}@{0pt@}
+\noindent\begin@{minipage@}[t]@{0.2\linewidth@}
+\begin@{enumerate@}
+ \item \parbox[t]@{15pt@}@{test \\ test@}
+ \item test
+ \item test
+\end@{enumerate@}
+\end@{minipage@}%
+\begin@{minipage@}[t]@{0.2\linewidth@}
+\begin@{enumerate@}
+ \item \parbox[t]@{15pt@}@{test \\ test\strut@}
+ \item test
+ \item test
+\end@{enumerate@}
+\end@{minipage@}%
+\begin@{minipage@}[t]@{0.2\linewidth@}
+\begin@{enumerate@}
+ \item \fbox@{\parbox[t]@{15pt@}@{test \\ test@}@}
+ \item \fbox@{test@}
+ \item \fbox@{test@}
+\end@{enumerate@}
+\end@{minipage@}%
+\begin@{minipage@}[t]@{0.2\linewidth@}
+\begin@{enumerate@}
+ \item \fbox@{\parbox[t]@{15pt@}@{test \\ test\strut@}@}
+ \item \fbox@{test@}
+ \item \fbox@{test@}
+\end@{enumerate@}
+\end@{minipage@}%
+@end example
+
+@noindent
+The final two lists use @code{fbox} to show what's happening. The third
+list's @code{\parbox} goes only to the bottom of its second @samp{test},
+which happens not have any characters that descend below the baseline.
+The fourth list adds the strut that gives the needed extra
+below-baseline space.
+
+@PkgIndex{TikZ} @PkgIndex{Asymptote}
+The @code{\strut} command is often useful in graphics, such as in
+@file{TikZ} or @file{Asymptote}. For instance, you may have a command
+such as @code{\graphnode@{@var{node-name}@}} that fits a circle around
+@var{node-name}. However, unless you are careful the @var{node-name}'s
+@samp{x} and @samp{y} will produce different-diameter circles because
+the characters are different sizes. A careful @code{\graphnode} might
+insert a @code{\strut}, then @var{node-name}, and then draw the circle.
+
+The general approach of using a zero width @code{\rule} is useful in
+many circumstances. In this table, the zero-width rule keeps the top of
+the first integral from hitting the @code{\hline}. Similarly, the
+second rule keeps the second integral from hitting the first.
+
+@example
+\begin@{tabular@}@{rl@}
+ \textsc@{Integral@} &\textsc@{Value@} \\
+ \hline
+ $\int_0^x t\, dt$ &$x^2/2$ \rule@{0em@}@{2.5ex@} \\
+ $\int_0^x t^2\, dt$ &$x^3/3$ \rule@{0em@}@{2.5ex@}
+\end@{tabular@}
+@end example
+
+@noindent
+(Although the line-ending double backslash command has an available
+optional argument to put in more vertical room, that won't work here.
+Changing the first double backslash to something like @code{\\[2.5ex]}
+will put the room between the header line and the @code{\hline}, and the
+integral would still hit the line.)
+
+
+@node \vspace
+@section @code{\vspace}
+
+@findex \vspace
+@cindex vertical space
+@cindex space, vertical
+
+Synopsis, one of:
+
+@example
+\vspace@{@var{length}@}
+\vspace*@{@var{length}@}
+@end example
+
+Add the vertical space @var{length}. The @var{length} can be positive,
+negative, or zero. It is a rubber length---it may contain a @code{plus}
+or @code{minus} component (@pxref{Lengths}).
+
+This puts space between the two paragraphs.
+
+@example
+And I slept.
+
+\vspace@{1ex plus 0.5ex@}
+The new day dawned cold.
+@end example
+
+@noindent
+(@xref{\bigskip & \medskip & \smallskip} for common inter-paragraph
+spaces.)
+
+The @code{*}-version inserts vertical space that non-discardable. More
+precisely, @LaTeX{} discards vertical space at a page break and the
+@code{*}-version causes the space to stay. This example leaves space
+between the two questions.
+
+@example
+Question: Find the integral of \( 5x^4+5 \).
+
+\vspace*@{2cm plus 0.5cm@}
+Question: Find the derivative of \( x^5+5x+9 \).
+@end example
+
+@noindent
+That space will be present even if the page break happens to fall
+between the questions.
+
+If you use @code{\vspace} in the middle of a paragraph (i.e., in
+horizontal mode) then the space is inserted after the line containing
+the @code{\vspace} command; it does not start a new paragraph at the
+@code{\vspace} command.
+
+In this example the two questions will be evenly spaced vertically on
+the page, with at least one inch of space below each.
+
+@example
+\begin@{document@}
+1) Who put the bomp in the bomp bah bomp bah bomp?
+\vspace@{1in plus 1fill@}
+
+2) Who put the ram in the rama lama ding dong?
+\vspace@{1in plus 1fill@}
+\end@{document@}
+@end example
+
@node \vfill
@section @code{\vfill}
@@ -9817,310 +13795,611 @@ quarter of a line space, with stretch and shrink (the default for the
@cindex stretch, infinite vertical
@cindex infinite vertical stretch
-End the current paragraph and insert a vertical rubber length
-(@pxref{Lengths}) that is infinite, so it can stretch or shrink as far
-as needed.
+Synopsis:
+
+@example
+\vfill
+@end example
+
+End the current paragraph and insert a vertical rubber length that is
+infinite, so it can stretch or shrink as far as needed
+(@pxref{Lengths}).
It is often used in the same way as @code{\vspace@{\fill@}}, except that
-@code{\vfill} ends the current paragraph, whereas
-@code{\vspace@{\fill@}} adds the infinite vertical space below its line
-irrespective of the paragraph structure. In both cases that space will
-disappear at a page boundary; to circumvent this see@tie{}@ref{\vspace}.
+@code{\vfill} ends the current paragraph whereas @code{\vspace@{\fill@}}
+adds the infinite vertical space below its line, irrespective of the
+paragraph structure. In both cases that space will disappear at a page
+boundary; to circumvent this see the starred option
+in@tie{}@ref{\vspace}.
In this example the page is filled, so the top and bottom lines contain
-the text @samp{Lost Dog!} and the third @samp{Lost Dog!} is exactly
+the text @samp{Lost Dog!} and the second @samp{Lost Dog!} is exactly
halfway between them.
@example
\begin@{document@}
Lost Dog!
\vfill
-Lost Dog!
+Lost Dog! % perfectly in the middle
\vfill
Lost Dog!
\end@{document@}
@end example
-@node \vspace
-@section @code{\vspace@{@var{length}@}}
+@node \addvspace
+@section @code{\addvspace}
-@findex \vspace
+@findex \addvspace
@cindex vertical space
-@cindex space, vertical
+@cindex space, inserting vertical
-Synopsis, one of these two:
+Synopsis:
@example
-\vspace@{@var{length}@}
-\vspace*@{@var{length}@}
+\addvspace@{@var{vert-length}@}
@end example
-Add the vertical space @var{length}. This can be negative or positive,
-and is a rubber length (@pxref{Lengths}).
+Add a vertical space of @var{vert-length}. However, if there are two or
+more @code{\addvspace}'s in a sequence then together they only add the
+space needed to make the natural length equal to the maximum of the
+@var{vert-length}'s in that sequence. This command is fragile
+(@pxref{\protect}). The @var{vert-length} is a rubber length
+(@pxref{Lengths}).
-@LaTeX{} removes the vertical space from @code{\vspace} at a page
-break, that is, at the top or bottom of a page. The starred version
-@code{\vspace*@{...@}} causes the space to stay.
-
-If @code{\vspace} is used in the middle of a paragraph (i.e., in
-horizontal mode), the space is inserted @emph{after} the line with
-the @code{\vspace} command. A new paragraph is not started.
-
-In this example the two questions will be evenly spaced vertically on
-the page, with at least one inch of space below each.
+This example illustrates. The @code{picture} draws a scale. In a
+standard @LaTeX{} article the length @code{\baselineskip} is 12@dmn{pt}.
+The two rules here are 22@dmn{pt} apart: the sum of the
+@code{\baselineskip} and the 10@dmn{pt} from the first @code{addvspace}.
@example
+\documentclass@{article@}
+\usepackage@{color@}
\begin@{document@}
-1) Who put the bomp in the bomp bah bomp bah bomp?
-\vspace@{1in plus 1fill@}
-
-2) Who put the ram in the rama lama ding dong?
-\vspace@{1in plus 1fill@}
+\setlength@{\unitlength@}@{2pt@}%
+\noindent\begin@{picture@}(0,0)%
+ \multiput(0,0)(0,-1)@{25@}@{@{\color@{blue@}\line(1,0)@{1@}@}@}
+ \multiput(0,0)(0,-5)@{6@}@{@{\color@{red@}\line(1,0)@{2@}@}@}
+\end@{picture@}%
+\rule@{0.25\linewidth@}@{0.1pt@}%
+\par\addvspace@{10pt@}% \addvspace@{20pt@}%
+\par\noindent\rule@{0.25\linewidth@}@{0.1pt@}%
\end@{document@}
@end example
+@noindent
+Now uncomment the second @code{\addvspace}. It does not make the gap
+20@dmn{pt} longer; instead the gap is the sum of @code{\baselineskip}
+and 20@dmn{pt}. So @code{\addvspace} in a sense does the opposite of
+its name --- it makes sure that multiple vertical spaces do not
+accumulate, but instead that only the largest one is used.
+
+@LaTeX{} uses this command to adjust the vertical space above or below
+an environment that starts a new paragraph. For instance, a
+@code{theorem} environment begins and ends with @code{\addvspace} so
+that two consecutive @code{theorem}'s are separated by one vertical
+space, not two.
+
+A error @samp{Something's wrong--perhaps a missing \item} pointing to an
+@code{\addvspace} means that you were not in vertical mode when you hit
+this command. One way to change that is to precede @code{\addvspace}
+with a @code{\par} command (@pxref{\par}), as in the above example.
+
@node Boxes
@chapter Boxes
@cindex boxes
-All the predefined length parameters (@pxref{Predefined lengths}) can be
-used in the arguments of the box-making commands.
+At its core, @LaTeX{} puts things in boxes and then puts the boxes on a
+page. So these commands are central.
+
+There are many packages on CTAN that are useful for manipulating boxes.
+One useful adjunct to the commands here is @file{adjustbox}.
@menu
-* \mbox:: Horizontal boxes.
-* \fbox and \framebox:: Put a frame around a box.
-* lrbox:: An environment like @code{\sbox}.
-* \makebox:: Box, adjustable position.
+* \mbox & \makebox:: Horizontal boxes.
+* \fbox & \framebox:: Put a frame around a box.
* \parbox:: Box with text in paragraph mode.
* \raisebox:: Raise or lower text.
-* \savebox:: Like @code{\makebox}, but save the text for later use.
-* \sbox:: Like @code{\mbox}, but save the text for later use.
+* \sbox & \savebox:: Like @code{\makebox} but save the text for later.
+* lrbox:: Environment version of @code{\sbox}.
* \usebox:: Print saved text.
@end menu
-@node \mbox
-@section @code{\mbox@{@var{text@}}}
+@node \mbox & \makebox
+@section @code{\mbox} & @code{\makebox}
@findex \mbox
-
+@findex \makebox
+@cindex box
+@cindex make a box
@cindex hyphenation, preventing
-The @code{\mbox} command creates a box just wide enough to hold the
-text created by its argument. The @var{text} is not broken into
-lines, so it can be used to prevent hyphenation.
+Synopsis, one of:
-@node \fbox and \framebox
-@section @code{\fbox} and @code{\framebox}
+@example
+\mbox@{@var{text}@}
+\makebox@{@var{text}@}
+\makebox[@var{width}]@{@var{text}@}
+\makebox[@var{width}][@var{position}]@{@var{text}@}
+@end example
-@findex \fbox
-@findex \framebox
+Create a box, a container for material. The @var{text} is is typeset in
+LR mode (@pxref{Modes}) so it is not broken into lines. The
+@code{\mbox} command is robust, while @code{\makebox} is fragile
+(@pxref{\protect}).
-Synopses:
+Because @code{text} is not broken into lines, you can use @code{\mbox}
+to prevent hyphenation. In this example, @LaTeX{} will not hyphenate
+the table name, @samp{T-4}.
@example
-\fbox@{@var{text}@}
-\framebox[@var{width}][@var{position}]@{@var{text}@}
+See Table~\mbox@{T-4@}
@end example
-The @code{\fbox} and @code{\framebox} commands are like @code{\mbox},
-except that they put a frame around the outside of the box being created.
+The first two command versions, @code{\mbox} and @code{\makebox}, are
+roughly equivalent. They create a box just wide enough to contain the
+@var{text}. (They are like plain @TeX{}'s @code{\hbox}.)
-In addition, the @code{\framebox} command allows for explicit
-specification of the box width with the optional @var{width} argument
-(a dimension), and positioning with the optional @var{position}
-argument. @c xxref
+In the third version the optional argument @var{width} specifies the
+width of the box. Note that the space occupied by the text need not
+equal the width of the box. For one thing, @var{text} can be too small;
+this creates a full-line box
-@findex \fboxrule
-@findex \fboxsep
-Both commands produce a rule of thickness @code{\fboxrule} (default
-@code{0.4pt}), and leave a space of @code{\fboxsep} (default @code{3pt})
-between the rule and the contents of the box.
+@example
+\makebox[\linewidth]@{Chapter Exam@}
+@end example
-@xref{\framebox (picture)}, for the @code{\framebox} command in the
-@code{picture} environment.
+@noindent
+with @samp{Chapter Exam} centered. But @var{text} can also be too wide
+for @var{width}. See the example below of zero-width boxes.
+@anchor{mbox makebox depth}
+@anchor{mbox makebox height}
+@anchor{mbox makebox width}
+@anchor{mbox makebox totalheight}
+In the @var{width} argument you can use the following lengths that refer
+to the dimension of the box that @LaTeX{} gets on typesetting
+@var{text}: @code{\depth}, @code{\height}, @code{\width},
+@code{\totalheight} (this is the box's height plus its depth). For
+example, to make a box with the text stretched to double the natural
+size you can say this.
-@node lrbox
-@section @code{lrbox}
+@example
+\makebox[2\width]@{Get a stretcher@}
+@end example
-@findex lrbox
+For the fourth command version the optional argument @var{position}
+gives position of the text within the box. It may take the following
+values:
-Synopsis:
+@table @code
+@item c
+The @var{text} is centered (default).
+
+@item l
+The @var{text} is flush left.
+
+@item r
+Flush right.
+
+@item s
+Stretch the interword space in @var{text} across the entire @var{width}.
+The @var{text} must contain stretchable space for this to work. For
+instance, this could head a press release:
+@code{\noindent\makebox[\textwidth][s]@{\large\hfil IMMEDIATE\hfil
+RELEASE\hfil@}}
+@end table
+
+A common use of @code{\makebox} is to make zero-width text boxes. This
+puts the value of the quiz questions to the left of those questions.
@example
-\begin@{lrbox@}@{\@var{cmd}@}
- @var{text }
-\end@{lrbox@}
+\newcommand@{\pts@}[1]@{\makebox[0em][r]@{#1 points\hspace*@{1em@}@}@}
+\pts@{10@}What is the air-speed velocity of an unladen swallow?
+
+\pts@{90@}An African or European swallow?
@end example
-This is the environment form of @ref{\sbox,@code{\sbox}}.
+@noindent
+@PkgIndex{TikZ}
+@PkgIndex{Asymptote}
+The right edge of the output @samp{10 points } (note the ending space)
+will be just before the @samp{What} (note the space after
+@samp{points}). You can use @code{\makebox} similarly when making
+graphics, such as in @file{TikZ} or @file{Asymptote}, where you put the
+edge of the text at a known location, regardless of the length of that
+text.
-The @var{text} inside the environment is saved in the box @code{\@var{cmd}},
-which must have been declared with @code{\newsavebox}.
+For boxes with frames see@tie{}@ref{\fbox & \framebox}. For colors
+see@tie{}@ref{Colored boxes}.
+There is a related version of @code{\makebox} that is used within the
+@code{picture} environment, where the length is given in terms of
+@code{\unitlength} (@pxref{\makebox (picture)}).
-@node \makebox
-@section @code{\makebox}
+If you put a double-backslash into @var{text} then @LaTeX{} will not
+give you a new line; for instance @code{\makebox@{abc def \\ ghi@}}
+outputs @samp{abc defghi} while @code{\makebox@{abc def \par ghi@}}
+outputs @samp{abc def ghi}, but neither go to a second line. To get
+multiple lines see@tie{}@ref{\parbox} and@tie{}@ref{minipage}.
-@findex \makebox
-Synopsis:
+@node \fbox & \framebox
+@section @code{\fbox} & @code{\framebox}
+
+@findex \fbox
+@findex \framebox
+
+Synopses, one of:
@example
-\makebox[@var{width}][@var{position}]@{@var{text}@}
+\fbox@{@var{text}@}
+\framebox@{@var{text}@}
+\framebox[@var{width}]@{@var{text}@}
+\framebox[@var{width}][@var{position}]@{@var{text}@}
@end example
-The @code{\makebox} command creates a box just wide enough to contain
-the @var{text} specified. The width of the box can be overridden by the
-optional @var{width} argument. The position of the text within the box
-is determined by the optional @var{position} argument, which may take
-the following values:
+Create a box with an enclosing frame, four lines surrounding the space.
+These commands are the same as @code{\mbox} and @code{\makebox} except
+for the frame (@pxref{\mbox & \makebox}). The @code{\fbox} command is
+robust, the @code{\framebox} command is fragile (@pxref{\protect}).
-@table @code
-@item c
-Centered (default).
-@item l
-Flush left.
-@item r
-Flush right.
-@item s
-Stretch (justify) across entire @var{width}; @var{text} must contain
-stretchable space for this to work.
-@end table
+@example
+\fbox@{Warning! No work shown, no credit given.@}
+@end example
-@code{\makebox} is also used within the @code{picture} environment
-@pxref{\makebox (picture)}.
+@noindent
+@LaTeX{} puts the text into a box that cannot be split or hyphenated.
+Around that box, separated from it by a small gap, are four lines making
+a frame.
+The first two command invocations, @code{\fbox@{...@}} and
+@code{\framebox@{...@}}, are roughly the same. As to the third and
+fourth invocations, the optional arguments allow you to specify the box
+width as @var{width} and the position of the text inside that box as
+@var{position}. @xref{\mbox & \makebox} for the full description but
+here is an example creating an empty box that is 1/4@dmn{in} wide.
-@node \parbox
-@section @code{\parbox}
+@example
+\setlength@{\fboxsep@}@{0pt@}\framebox[0.25in]@{\strut@}@}
+@end example
-@findex \parbox
+@noindent
+The @code{\strut} inserts a vertical height of @code{\baselineskip}
+(@pxref{\strut}).
-Synopsis:
+These parameters determine the frame layout.
+
+@ftable @code
+@anchor{fbox framebox fboxrule}
+@item \fboxrule
+@findex frame, line width
+@findex frame rule width
+@cindex \fboxrule
+The thickness of the lines around the enclosed box. The default is
+0.2@dmn{pt}. Change it with a command such as
+@code{\setlength@{\fboxrule@}@{0.8pt@}} (@pxref{\setlength}).
+
+@anchor{fbox framebox fboxsep}
+@item \fboxsep
+@findex frame, separation from contents
+@cindex \fboxsep
+The distance from the frame to the enclosed box. The default is 3@dmn{pt}.
+Change it with a command such as @code{\setlength@{\fboxsep@}@{0pt@}}
+(@pxref{\setlength}). Setting it to 0@dmn{pt} is useful sometimes:
+this will put a frame around the picture with no white border.
+
+@example
+@{\setlength@{\fboxsep@}@{0pt@}
+ \framebox@{%
+ \includegraphics[width=0.5\textwidth]@{prudence.jpg@}@}@}
+@end example
+
+@noindent
+The extra curly braces keep the effect of the @code{\setlength} local.
+
+@end ftable
+
+As with @code{\mbox} and @code{\makebox}, @LaTeX{} will not break lines
+in @var{text}. But this example has @LaTeX{} break lines to make a
+paragraph, and then frame the result.
@example
-\parbox[@var{position}][@var{height}][@var{inner-pos}]@{@var{width}@}@{@var{text}@}
+\framebox@{%
+ \begin@{minipage@}@{0.6\linewidth@}
+ My dear, here we must run as fast as we can, just to stay in place.
+ And if you wish to go anywhere you must run twice as fast as that.
+ \end@{minipage@}@}
@end example
-@cindex paragraph mode
-The @code{\parbox} command produces a box whose contents are created
-in @dfn{paragraph mode}. It should be used to make a box small
-pieces of text, with nothing fancy inside. In particular, you
-shouldn't use any paragraph-making environments inside a
-@code{\parbox} argument. For larger pieces of text, including ones
-containing a paragraph-making environment, you should use a
-@code{minipage} environment (@pxref{minipage}).
+@xref{Colored boxes} for colors other than black and white.
-@code{\parbox} has two mandatory arguments:
+The @code{picture} environment has a version of this command where the
+units depend on @code{picture}'s @code{\unitlength} (@pxref{\framebox
+(picture)}).
-@table @var
-@item width
-the width of the parbox;
-@item text
-the text that goes inside the parbox.
-@end table
-By default @LaTeX{} will position vertically a parbox so its center
-lines up with the center of the surrounding text line. When the
-optional @var{position} argument is present and equal either to @samp{t}
-or @samp{b}, this allows you respectively to align either the top or
-bottom line in the parbox with the baseline of the surrounding text. You
-may also specify @samp{m} for @var{position} to get the default
-behaviour.
+@node \parbox
+@section @code{\parbox}
-The optional @var{height} argument overrides the natural height of the box.
+@findex \parbox
+@cindex paragraph mode
+@cindex paragraph, in a box
-The @var{inner-pos} argument controls the placement of the text inside
-the box, as follows; if it is not specified, @var{position} is used.
+Synopses, one of:
-@table @code
-@item t
-text is placed at the top of the box.
-@item c
-text is centered in the box.
-@item b
-text is placed at the bottom of the box.
-@item s
-stretch vertically; the text must contain vertically stretchable space
-for this to work.
-@end table
+@example
+\parbox@{@var{width}@}@{@var{contents}@}
+\parbox[@var{position}]@{@var{width}@}@{@var{contents}@}
+\parbox[@var{position}][@var{height}]@{@var{width}@}@{@var{contents}@}
+\parbox[@var{position}][@var{height}][@var{inner-pos}]@{@var{width}@}@{@var{contents}@}
+@end example
+
+Produce a box of text that is @var{width} wide. Use this command to make
+a box of small pieces of text, of a single paragraph. This command is
+fragile (@pxref{\protect}).
+
+@example
+\begin@{picture@}(0,0)
+ ...
+ \put(1,2)@{\parbox@{1.75in@}@{\raggedright Because the graph is a line on
+ this semilog paper, the relationship is
+ exponential.@}@}
+\end@{picture@}
+@end example
+The @var{contents} are processed in a text mode (@pxref{Modes}) so
+@LaTeX{} will break lines to make a paragraph. But it won't make
+multiple paragraphs; for that, use a @code{minipage} environment
+(@pxref{minipage}).
+
+The options for @code{\parbox} (except for @var{contents}) are the same
+as those for @code{minipage}. For convenience a summary of the options
+is here but see@tie{}@ref{minipage} for a complete description.
+
+There are two required arguments. The @var{width} is a rigid length
+(@pxref{Lengths}). It sets the width of the box into which @LaTeX{}
+typesets @var{contents}. The @var{contents} is the text that is placed
+in that box. It should not have any paragraph-making components.
+
+There are three optional arguments, @var{position}, @var{height}, and
+@var{inner-pos}. The @var{position} gives the vertical alignment of the
+@code{parbox} with respect to the surrounding material. The possible
+values are @code{c} or @code{m} to make the vertical center of the
+@code{parbox} lines up with the center of the adjacent line (this is the
+default), or @code{t} to match the top line of the @code{parbox} with
+the baseline of the surrounding material, or @code{b} to match the
+bottom line.
+
+The optional argument @var{height} overrides the natural height of the
+box.
+
+The optional argument @var{inner-pos} controls the placement of
+@var{content} inside the @code{parbox}. Its default is the value of
+@var{position}. Its possible values are: @code{t} to put the
+@var{content} at the top of the box, @code{c} to put it in the vertical
+center, @code{b} to put it at the bottom of the box, and @code{s} to
+stretch it out vertically (for this, the text must contain vertically
+stretchable space).
@node \raisebox
@section @code{\raisebox}
@findex \raisebox
-Synopsis:
+Synopsis, one of:
@example
+\raisebox@{@var{distance}@}@{@var{text}@}
+\raisebox@{@var{distance}@}[@var{height}]@{@var{text}@}
\raisebox@{@var{distance}@}[@var{height}][@var{depth}]@{@var{text}@}
@end example
-The @code{\raisebox} command raises or lowers @var{text}. The first
-mandatory argument specifies how high @var{text} is to be raised (or
-lowered if it is a negative amount). @var{text} itself is processed
-in LR mode.
+Raise or lower @var{text}. This command is fragile (@pxref{\protect}).
+
+This example makes a command for the restriction of a function by
+lowering the vertical bar symbol.
+
+@c credit: egreg https://tex.stackexchange.com/a/278631/121234
+@example
+\newcommand\restricted[1]@{\raisebox@{-.5ex@}@{$|$@}_@{#1@}@}
+$f\restricted@{A@}$
+@end example
+
+The first mandatory argument @var{distance} specifies how far to raise
+the second mandatory argument @var{text}. This is a rigid length
+(@pxref{Lengths}). If it is negative then it lowers @var{text}. The
+@var{text} is processed in LR mode so it cannot contain line breaks
+(@pxref{Modes}).
The optional arguments @var{height} and @var{depth} are dimensions. If
-they are specified, @LaTeX{} treats @var{text} as extending a certain
-distance above the baseline (@var{height}) or below (@var{depth}),
-ignoring its natural height and depth.
+they are specified, they override the natural height and depth of the
+box @LaTeX{} gets by typesetting @var{text}.
+
+@anchor{raisebox depth}
+@anchor{raisebox height}
+@anchor{raisebox width}
+@anchor{raisebox totalheight}
+In the arguments @var{distance}, @var{height}, and @var{depth} you can
+use the following lengths that refer to the dimension of the box that
+@LaTeX{} gets on typesetting @var{text}: @code{\depth}, @code{\height},
+@code{\width}, @code{\totalheight} (this is the box's height plus its
+depth).
+
+This will align two graphics on their top (@pxref{Graphics}).
+
+@c credit: FAQ https://texfaq.org/FAQ-topgraph
+@example
+\usepackage@{graphicx@} \usepackage@{calc@} % in preamble
+ ...
+\begin@{center@}
+ \raisebox@{1ex-\height@}@{%
+ \includegraphics[width=0.4\linewidth]@{lion.png@}@}
+ \qquad
+ \raisebox@{1ex-\height@}@{%
+ \includegraphics[width=0.4\linewidth]@{meta.png@}@}
+\end@{center@}
+@end example
+@noindent
+The first @code{\height} is the height of @file{lion.png} while the
+second is the height of @file{meta.png}.
-@node \savebox
-@section @code{\savebox}
+@node \sbox & \savebox
+@section @code{\sbox} & @code{\savebox}
+
+@findex \sbox
@findex \savebox
+@cindex box, save
-Synopsis:
+Synopsis, one of:
@example
-\savebox@{@var{\boxcmd}@}[@var{width}][@var{pos}]@{@var{text}@}
+\sbox@{@var{box-cmd}@}@{@var{text}@}
+\savebox@{@var{box-cmd}@}@{@var{text}@}
+\savebox@{@var{box-cmd}@}[@var{width}]@{@var{text}@}
+\savebox@{@var{box-cmd}@}[@var{width}][@var{pos}]@{@var{text}@}
@end example
-This command typeset @var{text} in a box just as with @code{\makebox}
-(@pxref{\makebox}), except that instead of printing the resulting box,
-it saves it in the box labeled @var{\boxcmd}, which must have been
-declared with @code{\newsavebox} (@pxref{\newsavebox}).
+Typeset @var{text} just as with @code{\makebox} (@pxref{\mbox &
+\makebox}) except that @LaTeX{} does not output it but instead saves it
+in a storage bin named @var{box-cmd}. The bin name @var{box-cmd} begins
+with a backslash, @code{\}. You must have previously allocated the bin
+@var{box-cmd} with @code{\newsavebox} (@pxref{\newsavebox}).The
+@code{\sbox} command is robust while @code{\savebox} is fragile
+(@pxref{\protect}).
+This creates and uses a bin.
-@node \sbox
-@section @code{\sbox@{@var{\boxcmd}@}@{@var{text}@}}
+@example
+\newsavebox@{\fullname@}
+\sbox@{\fullname@}@{John Jacob Jingleheimer Schmidt@}
+ ...
+\usebox@{\fullname@}! His name is my name, too!
+Whenever we go out, the people always shout!
+There goes \\usebox@{\fullname@}! Ya da da da da da da.
+@end example
-@findex \sbox
+@noindent
+One advantage of using and reusing a bin over a @code{\newcommand} is
+efficiency, that @LaTeX{} need not repeatedly retypeset the contents.
+See the example below.
+
+The first two command invocations,
+@code{\sbox@{@var{box-cmd}@}@{@var{text}@}} and
+@code{\savebox@{@var{box-cmd}@}@{@var{text}@}}, are roughly equivalent.
+As to the third and fourth, the optional arguments allow you to specify
+the box width as @var{width}, and the position of the text inside that
+box as @var{position}. @xref{\mbox & \makebox} for the full
+description.
+
+In the @code{\sbox} and @code{\savebox} commands the @var{text} is
+typeset in LR mode so it does not have line breaks (@pxref{Modes}). If
+you use these then @LaTeX{} doesn't give you an error but it ignores
+what you want: if you enter @code{\sbox@{\newbin@}@{test \\ test@}} and
+@code{\usebox@{\newbin@}} then you get @samp{testtest}, while if you
+enter @code{\sbox@{\newbin@}@{test \par test@}} and
+@code{\usebox@{\newbin@}} then you get @samp{test test}, but no error or
+warning. To fix this use a @code{\parbox} or @code{minipage} as here.
+
+@c credit: egreg https://tex.stackexchange.com/a/41668/121234
+@example
+\savebox@{\abin@}@{%
+ \begin@{minipage@}@{\linewidth@}
+ \begin@{enumerate@}
+ \item First item
+ \item Second item
+ \end@{enumerate@}
+ \end@{minipage@}@}
+ ...
+\usebox@{\abin@}
+@end example
+
+As an example of the efficiency of reusing a bin's contents, this puts
+the same picture on each page of the document by putting it in the
+header. @LaTeX{} only typesets it once.
+
+@example
+\usepackage@{graphicx@} % all this in the preamble
+\newsavebox@{\sealbin@}
+\savebox@{\sealbin@}@{%
+ \setlength@{\unitlength@}@{1in@}%
+ \begin@{picture@}(0,0)%
+ \put(1.5,-2.5)@{%
+ \begin@{tabular@}@{c@}
+ \includegraphics[height=2in]@{companylogo.png@} \\
+ Office of the President
+ \end@{tabular@}@}
+ \end@{picture@}%
+@}
+\markright@{\usebox@{\sealbin@}@}
+\pagestyle@{headings@}
+@end example
+
+@noindent
+The @code{picture} environment is good for fine-tuning the placement.
+
+If the bin has not already been defined then you get something like
+@samp{Undefined control sequence. <argument> \nobin}.
+
+
+@node lrbox
+@section @code{lrbox}
+
+@findex lrbox
Synopsis:
@example
-\sbox@{@var{\boxcmd}@}@{@var{text}@}
+\begin@{lrbox@}@{@var{box-cmd}@}
+ @var{text}
+\end@{lrbox@}
@end example
-@code{\sbox} types @var{text} in a box just as with @code{\mbox}
-(@pxref{\mbox}) except that instead of the resulting box being
-included in the normal output, it is saved in the box labeled
-@var{\boxcmd}. @var{\boxcmd} must have been previously declared with
-@code{\newsavebox} (@pxref{\newsavebox}).
+The @var{text} inside the environment is saved in the bin
+@code{@var{box-cmd}}. The @var{box-cmd} must begin with a
+backslash. You must create this bin in advance with @code{\newsavebox}
+(@pxref{\newsavebox}). This is the environment form of the @code{\sbox}
+and @code{\savebox} commands, and is equivalent to them. @xref{\sbox &
+\savebox} for the full information.
+
+In this example the environment is convenient for entering the
+@code{tabular}.
+
+@example
+\newsavebox@{\jhbin@}
+\begin@{lrbox@}@{\jhbin@}
+ \begin@{tabular@}@{c@}
+ \includegraphics[height=1in]@{jh.png@} \\
+ Jim Hef@{@}feron
+ \end@{tabular@}
+\end@{lrbox@}
+ ...
+\usebox@{\jhbin@}
+@end example
@node \usebox
-@section @code{\usebox@{@var{\boxcmd}@}}
+@section @code{\usebox}
@findex \usebox
+@cindex box, use saved box
Synopsis:
@example
-\usebox@{@var{\boxcmd}@}
+\usebox@{@var{box-cmd}@}
@end example
-@code{\usebox} produces the box most recently saved in the bin
-@var{\boxcmd} by a @code{\savebox} command (@pxref{\savebox}).
+Produce the box most recently saved in the bin @var{box-cmd} by the
+commands @code{\sbox} or @code{\savebox}, or the @code{lrbox}
+environment. @xref{\sbox & \savebox} for more information and examples.
+(Note that @var{box-cmd} starts with a backslash.) This command is
+robust (@pxref{\protect}).
@node Color
@@ -10148,7 +14427,7 @@ significantly extends the capabilities described here, including adding
@node Color package options
-@section Color package options
+@section @code{color} package options
@cindex color package options
@cindex options, color package
@@ -10216,6 +14495,7 @@ such as with inks, so that combining full intensity of cyan, magenta,
and yellow makes black.
@table @code
+@anchor{color models cmyk}
@item cmyk
A comma-separated list with four real numbers between 0 and 1,
inclusive. The first number is the intensity of cyan, the second is
@@ -10223,10 +14503,12 @@ magenta, and the others are yellow and black. A number value of 0 means
minimal intensity, while a 1 is for full intensity. This model is often
used in color printing. It is a subtractive model.
+@anchor{color models gray}
@item gray
A single real number between 0 and 1, inclusive. The colors are shades
of grey. The number 0 produces black while 1 gives white.
+@anchor{color models rgb}
@item rgb
A comma-separated list with three real numbers between 0 and 1,
inclusive. The first number is the intensity of the red component, the
@@ -10234,6 +14516,7 @@ second is green, and the third the blue. A number value of 0 means that
none of that component is added in, while a 1 means full intensity.
This is an additive model.
+@anchor{color models RGB}
@item RGB
(@file{pdftex}, @file{xetex}, @file{luatex} drivers) A comma-separated
list with three integers between 0 and 255, inclusive. This model is a
@@ -10242,6 +14525,7 @@ often described in a red-green-blue model using numbers in this range.
The values entered here are converted to the @code{rgb} model by
dividing by 255.
+@anchor{color models named}
@item named
Colors are accessed by name, such as @samp{PrussianBlue}. The list of
names depends on the driver, but all support the names @samp{black},
@@ -10280,9 +14564,15 @@ Synopsis:
\definecolor@{@var{name}@}@{@var{model}@}@{@var{specification}@}
@end example
-Give the name @var{name} to the color. For example, after
-@code{\definecolor@{silver@}@{rgb@}@{0.75,0.75,0.74@}} you can use that
-color name with @code{Hi ho, \textcolor@{silver@}@{Silver@}!}.
+Give the name @var{name} to the color. For example, after this
+
+@example
+\definecolor@{silver@}@{rgb@}@{0.75,0.75,0.74@}
+@end example
+
+@noindent
+you can use that color name with @code{Hi ho,
+\textcolor@{silver@}@{Silver@}!}.
This example gives the color a more abstract name, so it could change and
not be misleading.
@@ -10309,6 +14599,7 @@ Synopses:
\textcolor[@var{color model}]@{@var{color specification}@}@{...@}
@end example
+@noindent
or
@example
@@ -10319,9 +14610,11 @@ or
The affected text gets the color. This line
@example
-\textcolor@{magenta@}@{My name is Ozymandias, king of kings:@} Look on my works, ye Mighty, and despair!
+\textcolor@{magenta@}@{My name is Ozymandias, king of kings:@}
+Look on my works, ye Mighty, and despair!
@end example
+@noindent
causes the first half to be in magenta while the rest is in black. You
can use a color declared with @code{\definecolor} in exactly the same
way that we just used the builtin color @samp{magenta}.
@@ -10349,9 +14642,15 @@ including the vertical and horizontal lines.
\end@{center@}
@end example
-You can use color in equations. A document might have
-@code{\definecolor@{highlightcolor@}@{RGB@}@{225,15,0@}} in the
-preamble, and then contain this equation.
+You can use color in equations. A document might have this definition
+in the preamble
+
+@example
+\definecolor@{highlightcolor@}@{RGB@}@{225,15,0@}
+@end example
+
+@noindent
+and then contain this equation.
@example
\begin@{equation@}
@@ -10364,7 +14663,8 @@ but sometimes you want a one-off. Those are the second forms in the
synopses.
@example
-Colors of \textcolor[rgb]@{0.33,0.14,0.47@}@{Purple@} and @{\color[rgb]@{0.72,0.60,0.37@} Gold@} for the team
+Colors of \textcolor[rgb]@{0.33,0.14,0.47@}@{Purple@} and
+@{\color[rgb]@{0.72,0.60,0.37@} Gold@} for the team.
@end example
The format of @var{color specification } depends on the color model
@@ -10381,6 +14681,7 @@ Colors inside colors do not combine. Thus
\textcolor@{green@}@{kind of \textcolor@{blue@}@{blue@}@}
@end example
+@noindent
has a final word that is blue, not a combination of blue and green.
@c xx address coloring a line of a table?
@@ -10397,14 +14698,15 @@ Synopses:
@example
\colorbox@{@var{name}@}@{...@}
-\colorbox[@var{model name}]@{@var{box background color specification}@}@{...@}
+\colorbox[@var{model name}]@{@var{box background color}@}@{...@}
@end example
+@noindent
or
@example
\fcolorbox@{@var{frame color}@}@{@var{box background color}@}@{...@}
-\fcolorbox[@var{model name}]@{@var{frame color specification}@}@{@var{box background color specification}@}@{...@}
+\fcolorbox[@var{model name}]@{@var{frame color}@}@{@var{box background color}@}@{...@}
@end example
Make a box with the stated background color. The @code{\fcolorbox}
@@ -10414,6 +14716,7 @@ command puts a frame around the box. For instance this
Name:~\colorbox@{cyan@}@{\makebox[5cm][l]@{\strut@}@}
@end example
+@noindent
makes a cyan-colored box that is five centimeters long and gets its
depth and height from the @code{\strut} (so the depth is
@code{-.3\baselineskip} and the height is @code{\baselineskip}). This
@@ -10424,7 +14727,7 @@ puts white text on a blue background.
@end example
The @code{\fcolorbox} commands use the same parameters as @code{\fbox}
-(@pxref{\fbox and \framebox}), @code{\fboxrule} and @code{\fboxsep}, to
+(@pxref{\fbox & \framebox}), @code{\fboxrule} and @code{\fboxsep}, to
set the thickness of the rule and the boundary between the box interior
and the surrounding rule. @LaTeX{}'s defaults are @code{0.4pt} and
@code{3pt}, respectively.
@@ -10511,7 +14814,7 @@ external to @LaTeX{}, that generate a graphic that you include using the
commands of this chapter. Two that use a programming language are
Asymptote and MetaPost. One that uses a graphical interface is Xfig.
Full description of these systems is outside the scope of this document;
-see their documentation.
+see their documentation on CTAN.
@menu
* Graphics package options:: Options when you load the package.
@@ -10521,7 +14824,7 @@ see their documentation.
@node Graphics package options
-@section Graphics package options
+@section @code{graphics} package options
@cindex graphics package options
@cindex options, graphics package
@@ -10532,6 +14835,7 @@ Synopsis (must be in the document preamble):
\usepackage[@var{comma-separated option list}]@{graphics@}
@end example
+@noindent
or
@example
@@ -10600,7 +14904,7 @@ option has @LaTeX{} to read the size from the latter.
@node Graphics package configuration
-@section Graphics package configuration
+@section @code{graphics} package configuration
@cindex graphics
@cindex graphics package
@@ -10615,13 +14919,13 @@ These commands configure the way @LaTeX{} searches the file system for
the graphic.
The behavior of file system search code is necessarily platform
-dependent. In this document we cover Linux, Macintosh, and Windows, as
+dependent. In this document we cover GNU/Linux, Macintosh, and Windows, as
those systems are typically configured. For other situations consult
the documentation in @file{grfguide.pdf}, or the @LaTeX{} source, or your
@TeX{} distribution's documentation.
@menu
-* \graphicspath:: Directories to search.
+* \graphicspath:: Directories to search.
* \DeclareGraphicsExtensions:: File types, such as JPG or EPS.
* \DeclareGraphicsRule:: How to handle file types.
@end menu
@@ -10677,6 +14981,7 @@ current directory,
\usepackage@{lion.png@}
@end example
+@noindent
for each of the listed directories, @LaTeX{} concatenates it with the
file name and searches for the result, checking for @file{pix/lion.png}
and then @file{../pix/lion.png}. This algorithm means that the
@@ -10690,9 +14995,9 @@ these means that the document is not portable. (You could preserve
portability by adjusting your @TeX{} system settings configuration file
parameter @code{TEXINPUTS}; see the documentation of your system.)
-You can use @code{\graphicspath} in the preamble or in the document
-body. You can use it more than once. For debugging, show its value
-with @code{\makeatletter\typeout@{\Ginput@@path@}\makeatother}.
+You can use @code{\graphicspath} anywhere in the document. You can use
+it more than once. Show its value with
+@code{\makeatletter\typeout@{\Ginput@@path@}\makeatother}.
The directories are taken with respect to the base file. That is,
suppose that you are working on a document based on @file{book/book.tex}
@@ -10727,6 +15032,7 @@ files.
\includegraphics@{lion@} % will find @file{lion.png} before @file{lion.pdf}
@end example
+@noindent
Because the file name @file{lion} does not have a period, @LaTeX{} uses
the extension list. For each directory in the graphics path
(@pxref{\graphicspath}), @LaTeX{} will try the extensions in the order
@@ -10735,17 +15041,20 @@ and extensions then it reports @samp{! LaTeX Error: File `@file{lion}'
not found}. Note that you must include the periods at the start of the
extensions.
-Because Linux and Macintosh filenames are case sensitive, the list of
+Because GNU/Linux and Macintosh filenames are case sensitive, the list of
file extensions is case sensitive on those platforms. The Windows
platform is not case sensitive.
You are not required to include @code{\DeclareGraphicsExtensions} in
your document; the printer driver has a sensible default. For example,
-the most recent @file{pdftex.def} has the extension list
-@samp{@code{.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2}}.
+the most recent @file{pdftex.def} has this extension list.
+
+@example
+.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2
+@end example
-You can use this command in the preamble or in the document body. You
-can use it more than once. For debugging, show its value with
+You can use this command anywhere in the document. You can use it more
+than once. Show its value with
@code{\makeatletter\typeout@{\Gin@@extensions@}\makeatother}.
@@ -10777,6 +15086,7 @@ This
\DeclareGraphicsRule@{*@}@{mps@}@{*@}@{@}
@end example
+@noindent
tells @LaTeX{} that it should handle as MetaPost output any file with an
extension not covered by another rule, so it covers @file{filename.1},
@file{filename.2}, etc.
@@ -10898,13 +15208,14 @@ This
\end@{center@}
@end example
+@noindent
will incorporate into the document the graphic in @file{plot.pdf},
centered and at its nominal size. You can also give a path to the file,
as with @code{\includegraphics@{graphics/plot.pdf@}}. To specify a list
of locations to search for the file, @pxref{\graphicspath}.
-If your filename includes spaces then put it in double quotes, as with
-@code{\includegraphics@{"sister picture.jpg"@}}.
+If your filename includes spaces then put it in double quotes. An example
+is @code{\includegraphics@{"sister picture.jpg"@}}.
The @code{\includegraphics@{@var{filename}@}} command decides on the
type of graphic by splitting @var{filename} on the first dot. You can
@@ -10942,7 +15253,7 @@ caption.
...
\begin@{center@}
\includegraphics@{pix/nix.png@}
- \captionof@{figure@}@{The spirit of the night@} \label@{pix:nix@} % if you want a caption
+ \captionof@{figure@}@{The spirit of the night@} \label@{pix:nix@} % optional
\end@{center@}
@end example
@@ -10950,8 +15261,7 @@ This example puts a box with a graphic side by side with one having
text, with the two vertically centered.
@example
-\newcommand*@{\vcenteredhbox@}[1]@{\begingroup
- \setbox0=\hbox@{#1@}\parbox@{\wd0@}@{\box0@}\endgroup@}
+\newcommand*@{\vcenteredhbox@}[1]@{\begin@{tabular@}@{@@@{@}c@@@{@}@}#1\end@{tabular@}@}
...
\begin@{center@}
\vcenteredhbox@{\includegraphics[width=0.4\textwidth]@{plot@}@}
@@ -10988,6 +15298,7 @@ in a key-value form, as here.
\end@{center@}
@end example
+@noindent
The options are read left-to-right. So the first graphic above is made
one inch wide and then rotated, while the second is rotated and then
made one inch wide. Thus, unless the graphic is perfectly square, the
@@ -11003,6 +15314,7 @@ page it puts together boxes and this is the box allocated for the
graphic.
@table @code
+@anchor{includegraphics width}
@item width
The graphic will be shown so its bounding box is this width. An example
is @code{\includegraphics[width=1in]@{plot@}}. You can use the standard
@@ -11014,37 +15326,44 @@ the width of the text with
@code{\includegraphics[width=\linewidth-1.0cm]@{hefferon.jpg@}}.
@item height
+@anchor{includegraphics height}
The graphic will be shown so its bounding box is this height. You can
use the standard @TeX{} dimensions (@pxref{Units of length}), and also
convenient are @code{\pageheight} and @code{\textheight} (@pxref{Page
-layout parameters}). For instance,
+layout parameters}). For instance, the command
@code{\includegraphics[height=0.25\textheight]@{godel@}} will make the
-graphic be a quarter of the height of the text area.
+graphic a quarter of the height of the text area.
@item totalheight
+@anchor{includegraphics totalheght}
The graphic will be shown so its bounding box has this height plus
depth. This differs from the height if the graphic was rotated. For
instance, if it has been rotated by -90 then it will have zero height
but a large depth.
@item keepaspectratio
-If set to @code{true}, or just specified as with
-@code{\includegraphics[...,keepaspectratio,...]@{...@}} and you give as
-options both @code{width} and @code{height} (or @code{totalheight}),
-then @LaTeX{} will make the graphic is as large as possible without
-distortion. That is, @LaTeX{} will ensure that neither is the graphic
-wider than @code{width} nor taller than @code{height} (or
+@anchor{includegraphics keepaspectratio}
+If set to @code{true}, or just specified as here
+
+@example
+@code{\includegraphics[...,keepaspectratio,...]@{...@}}
+@end example
+
+@noindent
+and you give as options both @code{width} and @code{height} (or
+@code{totalheight}), then @LaTeX{} will make the graphic is as large as
+possible without distortion. That is, @LaTeX{} will ensure that neither
+is the graphic wider than @code{width} nor taller than @code{height} (or
@code{totalheight}).
@item scale
-Factor by which to scale the graphic. Specifying
-@code{\includegraphics[scale=2.0]@{...@}} makes the graphic twice its
-nominal size. This number may be any value; a number between 1
-and@tie{}0 will shrink the graphic and a negative number will reflect
-it.
+Factor by which to scale the graphic. To make a graphic twice its
+nominal size, enter @code{\includegraphics[scale=2.0]@{...@}}. This
+number may be any value; a number between 1 and@tie{}0 will shrink the
+graphic and a negative number will reflect it.
@item angle
-Rotate the picture. The angle is taken in degrees and counterclockwise.
+Rotate the graphic. The angle is taken in degrees and counterclockwise.
The graphic is rotated about its @code{origin}; see that option. For a
complete description of how rotated material is typeset,
@pxref{\rotatebox}.
@@ -11053,9 +15372,9 @@ complete description of how rotated material is typeset,
The point of the graphic about which the rotation happens. Possible
values are any string containing one or two of: @code{l} for left,
@code{r} for right, @code{b} for bottom, @code{c} for center, @code{t}
-for top, and @code{B} for baseline. Thus,
+for top, and @code{B} for baseline. Thus, entering the command
@code{\includegraphics[angle=180,origin=c]@{moon@}} will turn the
-picture upside down from the center, while
+picture upside down about that picture's center, while the command
@code{\includegraphics[angle=180,origin=lB]@{LeBateau@}} will turn its
picture upside down about its left baseline. (The character @code{c}
gives the horizontal center in @code{bc} or @code{tc}, but gives the
@@ -11068,6 +15387,7 @@ To rotate about an arbitrary point, @pxref{\rotatebox}.
These are lesser-used options.
@table @code
+@anchor{includegraphics viewport}
@item viewport
Pick out a subregion of the graphic to show. Takes four arguments,
separated by spaces and given in @TeX{} dimensions, as with
@@ -11076,6 +15396,7 @@ dimensions default to big points,@tie{}@code{bp}. They are taken
relative to the origin specified by the bounding box. See also the
@code{trim} option.
+@anchor{includegraphics trim}
@item trim
Gives parts of the graphic to not show. Takes four arguments, separated
by spaces, that are given in @TeX{} dimensions, as with
@@ -11085,17 +15406,25 @@ will crop the picture by 0@tie{}inches on the left, 0.1@tie{}inches on
the bottom, 0.2@tie{}inches on the right, and 0.3@tie{}inches on the
top. See also the @code{viewport} option.
+@anchor{includegraphics clip}
@item clip
-If set to @code{true}, or just specified as with
-@code{\includegraphics[...,clip,...]@{...@}}, then the graphic is
-cropped to the bounding box. You can get this effect by instead using
-the starred form of the command, as
+If set to @code{true}, or just specified as here
+
+@example
+\includegraphics[...,clip,...]@{...@}
+@end example
+
+@noindent
+then the graphic is cropped to the bounding box. This is the same as
+using the starred form of the command,
@code{\includegraphics*[...]@{...@}}.
+@anchor{includegraphics page}
@item page
Give the page number of a multi-page PDF file. The default is
@code{page=1}.
+@anchor{includegraphics pagebox}
@item pagebox
Specifies which bounding box to use for PDF files from among
@code{mediabox}, @code{cropbox}, @code{bleedbox}, @code{trimbox}, or
@@ -11110,22 +15439,33 @@ content. The driver will set the image size based on CropBox if
present, otherwise it will not use one of the others, with a
driver-defined order of preference. MediaBox is always present.
+@anchor{includegraphics interpolate}
@item interpolate
Enable or disable interpolation of raster images by the viewer. Can be
-set with @code{interpolate=true} or just specified as with
-@code{\includegraphics[...,interpolate,...]@{...@}}.
+set with @code{interpolate=true} or just specified as here.
+@example
+\includegraphics[...,interpolate,...]@{...@}
+@end example
+
+@anchor{includegraphics quiet}
@item quiet
Do not write information to the log. You can set it with
@code{quiet=true} or just specified it with
@code{\includegraphics[...,quite,...]@{...@}},
+@anchor{includegraphics draft}
@item draft
-If you set it with @code{draft=true} or just specified it with
-@code{\includegraphics[...,draft,...]@{...@}}, then the graphic will not
-appear in the document, possibly saving color printer ink. Instead,
-@LaTeX{} will put an empty box of the correct size with the filename
-printed in it.
+If you set it with @code{draft=true} or just specify it with
+
+@example
+\includegraphics[...,draft,...]@{...@}
+@end example
+
+@noindent
+then the graphic will not appear in the document, possibly saving color
+printer ink. Instead, @LaTeX{} will put an empty box of the correct
+size with the filename printed in it.
@end table
@@ -11140,6 +15480,7 @@ For example, if an @file{.eps} file has the line @code{%%BoundingBox 10
60/72@tie{}inch tall.
@table @code
+@anchor{includegraphics bb}
@item bb
Specify the bounding box of the displayed region. The argument is four
dimensions separated by spaces, as with @code{\includegraphics[.., bb=
@@ -11148,23 +15489,40 @@ BoundingBox numbers from the EPS file automatically, so this option is
only useful if the bounding box is missing from that file or if you want
to change it.
+@anchor{includegraphics bbllx}
+@anchor{includegraphics bblly}
+@anchor{includegraphics bburx}
+@anchor{includegraphics bbury}
@item bbllx, bblly, bburx, bbury
Set the bounding box. These four are obsolete, but are retained for
compatibility with old packages.
+@anchor{includegraphics natwidth}
+@anchor{includegraphics natheight}
@item natwidth, natheight
An alternative for @code{bb}. Setting
-@code{\includegraphics[...,natwidth=1in,natheight=0.618in,...]@{...@}}
+
+@example
+\includegraphics[...,natwidth=1in,natheight=0.618in,...]@{...@}
+@end example
+
+@noindent
is the same as setting @code{bb=0 0 1in 0.618in}.
+@anchor{includegraphics hiresbb}
@item hiresbb
If set to @code{true}, or just specified as with
-@code{\includegraphics[...,hiresbb,...]@{...@}}, then @LaTeX{} will look
-for @code{%%HiResBoundingBox} lines instead of @code{%%BoundingBox}
-lines. (The @code{BoundingBox} lines use only natural numbers while the
-@code{HiResBoundingBox} lines use decimals; both use units equivalent to
-@TeX{}'s big points, 1/72@tie{}inch.) To override a prior setting of
-@code{true}, you can set it to @code{false}.
+
+@example
+\includegraphics[...,hiresbb,...]@{...@}
+@end example
+
+@noindent
+then @LaTeX{} will look for @code{%%HiResBoundingBox} lines instead of
+@code{%%BoundingBox} lines. (The @code{BoundingBox} lines use only
+natural numbers while the @code{HiResBoundingBox} lines use decimals;
+both use units equivalent to @TeX{}'s big points, 1/72@tie{}inch.) To
+override a prior setting of @code{true}, you can set it to @code{false}.
@end table
@@ -11175,21 +15533,26 @@ will read the file @file{lion.xxx} as though it were
@file{lion.png}. For more on these, @pxref{\DeclareGraphicsRule}.
@table @code
+@anchor{includegraphics type}
@item type
Specify the graphics type.
+@anchor{includegraphics ext}
@item ext
Specify the graphics extension.
Only use this in conjunction with the option @code{type}.
+@anchor{includegraphics read}
@item read
Specify the file extension of the read file.
Only use this in conjunction with the option @code{type}.
+@anchor{includegraphics command}
@item command
-Specify a command to be applied to this file.
-Only use this in conjunction with the option @code{type}.
-@c write18 and restricted execution.
+Specify a command to be applied to this file. Only use this in
+conjunction with the option @code{type}. @xref{Command line options}
+for a discussion of enabling the @code{\write18} functionality to run
+external commands.
@end table
@@ -11215,7 +15578,8 @@ Synopses for @file{graphicx} package:
\rotatebox[@var{key-value list}]@{@var{angle}@}@{@var{material}@}
@end example
-Put @var{material} in a box and rotate it @var{angle} degrees counterclockwise.
+Put @var{material} in a box and rotate it @var{angle} degrees
+counterclockwise.
This example rotates the table column heads forty five degrees.
@@ -11252,15 +15616,21 @@ except for the @code{x} and @code{y} options (@pxref{\includegraphics}).
@table @code
@item origin
The point of the @var{material}'s box about which the rotation happens.
-Possible values are any string containing one or two of: @code{l} for
+Possible value is any string containing one or two of: @code{l} for
left, @code{r} for right, @code{b} for bottom, @code{c} for center,
-@code{t} for top, and @code{B} for baseline. Thus,
-@code{\includegraphics[angle=180,origin=c]@{moon@}} will turn the
-picture upside down from the center, while
-@code{\includegraphics[angle=180,origin=lB]@{LeBateau@}} will turn its
-picture upside down about its left baseline. (The character @code{c}
-gives the horizontal center in @code{bc} or @code{tc} but gives the
-vertical center in @code{lc} or @code{rc}.) The default is @code{lB}.
+@code{t} for top, and @code{B} for baseline. Thus, the first line here
+
+@example
+\includegraphics[angle=180,origin=c]@{moon@}
+\includegraphics[angle=180,origin=lB]@{LeBateau@}
+@end example
+
+@noindent
+will turn the picture upside down from the center while the second will
+turn its picture upside down about its left baseline. (The character
+@code{c} gives the horizontal center in @code{bc} or @code{tc} but gives
+the vertical center in @code{lc} or @code{rc}.) The default is
+@code{lB}.
@item x, y
Specify an arbitrary point of rotation with
@@ -11308,10 +15678,15 @@ first text and doubles the size of the second.
If you do not specify the optional @var{vertical factor} then it
defaults to the same value as the @var{horizontal factor}.
-You can use this command to resize a graphic, as with
-@code{\scalebox@{0.5@}@{\includegraphics@{lion@}@}}. If you use the
-@file{graphicx} package then you can accomplish the same thing with
-optional arguments to @code{\includegraphics}
+You can use this command to resize a graphic, as here.
+
+@example
+\scalebox@{0.5@}@{\includegraphics@{lion@}@}
+@end example
+
+@noindent
+If you use the @file{graphicx} package then you can accomplish the same
+thing with optional arguments to @code{\includegraphics}
(@pxref{\includegraphics}).
The @code{\reflectbox} command abbreviates
@@ -11377,7 +15752,7 @@ special meaning do not correspond to simple characters you can type.
* Symbols by font position:: Inserting font symbols by number.
* Text symbols:: Inserting other non-letter symbols in text.
* Accents:: Inserting accents.
-* Additional Latin letters:: Inserting other non-English characters.
+* Additional Latin letters:: Inserting other non-English characters.
* \rule:: Inserting lines and rectangles.
* \today:: Inserting today's date.
@end menu
@@ -11390,8 +15765,8 @@ special meaning do not correspond to simple characters you can type.
@cindex characters, reserved
@cindex special characters
@cindex characters, special
-@LaTeX{} sets aside the following characters for special purposes (for
-example, the percent sign@tie{}@code{%} is for comments) so they are
+@LaTeX{} sets aside the following characters for special purposes. For
+example, the percent sign@tie{}@code{%} is for comments. They are
called @dfn{reserved characters} or @dfn{special characters}.
@example
@@ -11408,7 +15783,7 @@ called @dfn{reserved characters} or @dfn{special characters}.
If you want a reserved character to be printed as itself, in the text
body font, for all but the final three characters in that list simply
put a backslash@tie{}@code{\} in front of the character. Thus,
-@code{\$1.23} will produce@tie{}@code{$1.23} in your output.
+typing @code{\$1.23} will produce@tie{}@code{$1.23} in your output.
@findex \~
@findex \^
@@ -11416,11 +15791,12 @@ put a backslash@tie{}@code{\} in front of the character. Thus,
As to the last three characters, to get a tilde in the text body font
use @code{\~@{@}} (omitting the curly braces would result in the next
character receiving a tilde accent). Similarly, to get a get a text
-body font circumflex use @code{\^@{@}}. A text body font backslash
-results from @code{\textbackslash@{@}}.
+body font circumflex use @code{\^@{@}}. To get a backslash in the font
+of the text body, enter @code{\textbackslash@{@}}.
To produce the reserved characters in a typewriter font use
-@code{\verb!!}, as below.
+@code{\verb!!} as below (the double backslash@tie{}@code{\\} is only
+there to split the lines).
@example
\begin@{center@}
@@ -11429,16 +15805,13 @@ To produce the reserved characters in a typewriter font use
\end@{center@}
@end example
-In that example the double backslash@tie{}@code{\\} is only there to
-split the lines.
-
@node Upper and lower case
@section Upper and lower case
-@cindex Upper case
-@cindex Lower case
-@cindex characters, case
+@cindex uppercase
+@cindex lowercase
+@cindex characters, case of
Synopsis:
@@ -11516,23 +15889,24 @@ example could also be written as @code{\symbol@{'40@}} or
@cindex symbols, text
@findex textcomp @r{package}
-@LaTeX{} provides commands to generate a number of non-letter symbols
-in running text. Some of these, especially the more obscure ones, are
-not available in OT1; you may need to load the @code{textcomp} package.
+@LaTeX{} provides commands to generate a number of non-letter symbols in
+running text. Some of these, especially the more obscure ones, are not
+available in OT1. Unless you are using Xe@LaTeX{} or Lua@LaTeX{} then
+you may need to load the @code{textcomp} package.
@ftable @code
@item \copyright
@itemx \textcopyright
@cindex copyright symbol
-The copyright symbol, @copyright{}.
+@copyright{} The copyright symbol.
@item \dag
@cindex dagger, in text
-The dagger symbol (in text).
+@BES{2020,@math{\dag}} The dagger symbol (in text).
@item \ddag
@cindex double dagger, in text
-The double dagger symbol (in text).
+@BES{2021,@math{\ddag}} The double dagger symbol (in text).
@item \LaTeX
@cindex @LaTeX{} logo
@@ -11556,50 +15930,50 @@ The @LaTeX{}2e logo.
@cindex single angle quotation marks
@cindex French quotation marks
@cindex quotation marks, French
-Double and single angle quotation marks, commonly used in French:
-@guillemotleft{}, @guillemotright{}, @guilsinglleft{}, @guilsinglright{}.
+@guillemotleft{}, @guillemotright{}, @guilsinglleft{}, @guilsinglright{}
+Double and single angle quotation marks, commonly used in French.
@item \ldots
@itemx \dots
@itemx \textellipsis
@cindex ellipsis
-An ellipsis (three dots at the baseline): `@dots{}'. @code{\ldots}
+@dots{} An ellipsis (three dots at the baseline): @code{\ldots}
and @code{\dots} also work in math mode.
@item \lq
@cindex left quote
@cindex opening quote
-Left (opening) quote: `.
+` Left (opening) quote.
@item \P
@itemx \textparagraph
@cindex paragraph symbol
@cindex pilcrow
-Paragraph sign (pilcrow): @BES{00B6,\P}.
+@BES{00B6,\P} Paragraph sign (pilcrow).
@item \pounds
@itemx \textsterling
@cindex pounds symbol
@cindex sterling symbol
-English pounds sterling: @pounds{}.
+@pounds{} English pounds sterling.
@item \quotedblbase @r{(@quotedblbase{})}
@itemx \quotesinglbase @r{(@quotesinglbase{})}
@cindex double low-9 quotation mark
@cindex single low-9 quotation mark
@cindex low-9 quotation marks, single and double
-Double and single quotation marks on the baseline:
-@quotedblbase{} and @quotesinglbase{}.
+@quotedblbase{} and @quotesinglbase{}
+Double and single quotation marks on the baseline.
@item \rq
@cindex right quote
@cindex closing quote
-Right (closing) quote: '.
+' Right (closing) quote.
@item \S
-\itemx \textsection
+@itemx \textsection
@cindex section symbol
-Section sign: @BES{00A7,\S}.
+@BES{00A7,\S} Section sign.
@item \TeX
@cindex @TeX{} logo
@@ -11609,55 +15983,55 @@ The @TeX{} logo.
@item \textasciicircum
@cindex circumflex, ASCII, in text
@cindex ASCII circumflex, in text
-ASCII circumflex: ^.
+^ ASCII circumflex.
@item \textasciitilde
@cindex tilde, ASCII, in text
@cindex ASCII tilde, in text
-ASCII tilde: ~.
+~ ASCII tilde.
@item \textasteriskcentered
@cindex asterisk, centered, in text
@cindex centered asterisk, in text
-Centered asterisk: *.
+* Centered asterisk.
@item \textbackslash
@cindex backslash, in text
-Backslash: \.
+\ Backslash.
@item \textbar
@cindex vertical bar, in text
@cindex bar, vertical, in text
-Vertical bar: |.
+| Vertical bar.
@item \textbardbl
@cindex vertical bar, double, in text
@cindex bar, double vertical, in text
@cindex double vertical bar, in text
-Double vertical bar.
+@BES{23F8,||} Double vertical bar.
@item \textbigcircle
@cindex big circle symbols, in text
@cindex circle symbol, big, in text
-Big circle symbol.
+@BES{25EF,} Big circle symbol.
@item \textbraceleft
@cindex left brace, in text
@cindex brace, left, in text
-Left brace: @{.
+@{ Left brace.
@item \textbraceright
@cindex right brace, in text
@cindex brace, right, in text
-Right brace: @}.
+@} Right brace.
@item \textbullet
@cindex bullet, in text
-Bullet: @bullet{}.
+@bullet{} Bullet.
@item \textcircled@{@var{letter}@}
@cindex circled letter, in text
-@var{letter} in a circle, as in @registeredsymbol{}.
+@BES{24B6,} Circle around @var{letter}.
@item \textcompwordmark
@itemx \textcapitalcompwordmark
@@ -11665,53 +16039,60 @@ Bullet: @bullet{}.
@cindex composite word mark, in text
@cindex cap height
@cindex ascender height
-Composite word mark (invisible). The @code{\textcapital...} form
-has the cap height of the font, while the @code{\textascender...} form
-has the ascender height.
+Used to separate letters that would normally ligature. For example,
+@code{f\textcompwordmark i} produces @samp{fi} without a ligature. This
+is most useful in non-English languages. The
+@code{\textcapitalcompwordmark} form has the cap height of the font
+while the @code{\textascendercompwordmark} form has the ascender height.
@item \textdagger
@cindex dagger, in text
-Dagger: @math{\dag}.
+@BES{2020,@math{\dag}} Dagger.
@item \textdaggerdbl
@cindex dagger, double, in text
@cindex double dagger, in text
-Double dagger: @math{\ddag}.
+@BES{2021,@math{\ddag}} Double dagger.
@item \textdollar @r{(or @code{\$})}
@cindex dollar sign
@cindex currency, dollar
-Dollar sign: $.
+$ Dollar sign.
@item \textemdash @r{(or @code{---})}
@cindex em-dash
-Em-dash: --- (for punctuation).
+--- Em-dash (used for punctuation, as in
+@code{The playoffs --- if you are fortunate enough to make the playoffs ---
+is more like a sprint.}).
@item \textendash @r{(or @code{--})}
@cindex e-dash
-En-dash: -- (for ranges).
+-- En-dash (used for ranges, as in @code{See pages 12--14}).
@item \texteuro
@cindex euro symbol
@cindex currency, euro
-The Euro symbol: @euro{}.
+@PkgIndex{eurosym}
+The Euro symbol: @euro{}. For an alternative glyph design, try the
+@file{eurosym} package; also, most fonts nowadays come with their own
+Euro symbol (Unicode U+20AC).
@item \textexclamdown @r{(or @code{!`})}
@cindex exclamation point, upside-down
-Upside down exclamation point: @exclamdown{}.
+@exclamdown{} Upside down exclamation point.
@item \textgreater
@cindex greater than symbol, in text
-Greater than: >.
+> Greater than symbol.
@item \textless
@cindex less than symbol, in text
-Less than: <.
+< Less than symbol.
@item \textleftarrow
@cindex arrow, left, in text
@cindex left arrow, in text
-Left arrow.
+@BES{2190,} Left arrow.
@item \textordfeminine
@itemx \textordmasculine
@@ -11719,42 +16100,42 @@ Left arrow.
@cindex masculine ordinal symbol
@cindex ordinals, feminine and masculine
@cindex Spanish ordinals, feminine and masculine
-Feminine and masculine ordinal symbols: @ordf{}, @ordm{}.
+@ordf{}, @ordm{} Feminine and masculine ordinal symbols.
@item \textperiodcentered
@cindex period, centered, in text
@cindex centered period, in text
-Centered period: @BES{00B7,\cdot}.
+@BES{00B7,\cdot} Centered period.
@item \textquestiondown @r{(or @code{?`})}
@cindex question mark, upside-down
-Upside down question mark: @questiondown{}.
+@questiondown{} Upside down question mark.
@item \textquotedblleft @r{(or @code{``})}
@cindex left quote, double
@cindex double left quote
-Double left quote: ``.
+`` Double left quote.
@item \textquotedblright @r{(or @code{''})}
@cindex right quote, double
@cindex double right quote
-Double right quote: ''.
+'' Double right quote.
@item \textquoteleft @r{(or @code{`})}
@cindex left quote, single
@cindex single left quote
-Single left quote: `.
+` Single left quote.
@item \textquoteright @r{(or @code{'})}
@cindex right quote, single
@cindex single right quote
-Single right quote: '.
+' Single right quote.
@item \textquotesingle
@cindex quote, single straight
@cindex straight single quote
@cindex single quote, straight
-Straight single quote. (From TS1 encoding.)
+@BES{0027,} Straight single quote. (From TS1 encoding.)
@item \textquotestraightbase
@itemx \textquotestraightdblbase
@@ -11762,38 +16143,40 @@ Straight single quote. (From TS1 encoding.)
@cindex straight quote, base
@cindex double quote, straight base
@cindex straight double quote, base
+@c Unicode doesn't have these https://en.wikipedia.org/wiki/Quotation_mark
Single and double straight quotes on the baseline.
@item \textregistered
@cindex registered symbol
-Registered symbol: @registeredsymbol{}.
+@registeredsymbol{} Registered symbol.
@item \textrightarrow
@cindex arrow, right, in text
@cindex right arrow, in text
-Right arrow.
+@BES{2192,} Right arrow.
@item \textthreequartersemdash
@cindex three-quarters em-dash
@cindex em-dash, three-quarters
-``Three-quarters'' em-dash, between en-dash and em-dash.
+@BES{FE58,} ``Three-quarters'' em-dash, between en-dash and em-dash.
@item \texttrademark
@cindex trademark symbol
-Trademark symbol: @BES{2122,^{\hbox{TM}}}.
+@BES{2122,^{\hbox{TM}}} Trademark symbol.
+@c ?? Diff from \textthreequartersemdash? In Unicode?
@item \texttwelveudash
@cindex two-thirds em-dash
@cindex em-dash, two-thirds
-``Two-thirds'' em-dash, between en-dash and em-dash.
+@BES{FE58,} ``Two-thirds'' em-dash, between en-dash and em-dash.
@item \textunderscore
@cindex underscore, in text
-Underscore: _.
+_ Underscore.
@item \textvisiblespace
@cindex visible space symbol, in text
-Visible space symbol.
+@BES{2423,} Visible space symbol.
@end ftable
@@ -11806,14 +16189,29 @@ Visible space symbol.
@cindex letters, accented
@PkgIndex{babel}
+@PkgIndex{polyglossia}
@cindex multilingual support
-@LaTeX{} has wide support for many of the world's scripts and
-languages, through the @code{babel} package and related support. This
-section does not attempt to cover all that support. It merely lists
-the core @LaTeX{} commands for creating accented characters.
+@LaTeX{} has wide support for many of the world's scripts and languages,
+through the @code{babel} package and related support if you are using
+pdf@LaTeX{}, or @file{polyglossia} if you are using Xe@LaTeX{} or
+Lua@LaTeX{}. This section does not cover that support. It only lists
+the core @LaTeX{} commands for creating accented characters. The
+@code{\capital...} commands shown here produce alternative forms for use
+with capital letters. These are not available with OT1.
-The @code{\capital...} commands produce alternative forms for use with
-capital letters. These are not available with OT1.
+Below, to make them easier to find, the accents are all illustrated with
+lowercase @samp{o}.
+
+@findex \i @r{(dotless i)}
+@cindex dotless i
+Note that @code{\i} produces a dotless i,
+@c @dotless{i},
+@findex \j @r{(dotless j)}
+@cindex dotless j
+and @code{\j} produces a dotless j.
+@c @dotless{j}.
+These are often used in place of their dotted counterparts when they are
+accented.
@table @code
@item \"
@@ -11822,22 +16220,20 @@ capital letters. These are not available with OT1.
@findex \capitaldieresis
@cindex umlaut accent
@cindex dieresis accent
-Produces an umlaut (dieresis), as in @"{o}.
+@"{o} Umlaut (dieresis).
@item \'
@itemx \capitalacute
@findex \' @r{(acute accent)}
@findex \capitalacute
@cindex acute accent
-Produces an acute accent, as in @'{o}. In the @code{tabbing}
-environment, pushes current column to the right of the previous column
-(@pxref{tabbing}).
+@'{o} Acute accent.
@item \.
@findex \. @r{(dot-over accent)}
@cindex dot accent
@cindex dot-over accent
-Produces a dot accent over the following, as in @dotaccent{o}.
+@dotaccent{o} Dot accent.
@item \=
@itemx \capitalmacron
@@ -11846,7 +16242,7 @@ Produces a dot accent over the following, as in @dotaccent{o}.
@cindex macron accent
@cindex overbar accent
@cindex bar-over accent
-Produces a macron (overbar) accent over the following, as in @={o}.
+@={o} Macron (overbar) accent.
@item \^
@itemx \capitalcircumflex
@@ -11854,75 +16250,69 @@ Produces a macron (overbar) accent over the following, as in @={o}.
@findex \capitalcircumflex
@cindex circumflex accent
@cindex hat accent
-Produces a circumflex (hat) accent over the following, as in @^{o}.
+@^{o} Circumflex (hat) accent.
@item \`
@itemx \capitalgrave
@findex \` @r{(grave accent)}
@findex \capitalgrave
@cindex grave accent
-Produces a grave accent over the following, as in @`{o}. In the
-@code{tabbing} environment, move following text to the right margin
-(@pxref{tabbing}).
+@`{o} Grave accent.
@item \~
@itemx \capitaltilde
@findex \~ @r{(tilde accent)}
@findex \capitaltilde
@cindex tilde accent
-Produces a tilde accent over the following, as in @~{n}.
+@~{n} Tilde accent.
@item \b
@findex \b @r{(bar-under accent)}
@cindex bar-under accent
-Produces a bar accent under the following, as in @ubaraccent{o}. See
-also @code{\underbar} hereinafter.
+@ubaraccent{o} Bar accent underneath.
+
+@findex \underbar
+@cindex underbar
+Related to this, @code{\underbar@{@var{text}@}} produces a bar under
+@var{text}. The argument is always processed in LR mode
+(@pxref{Modes}). The bar is always a fixed position under the baseline,
+thus crossing through descenders. See also @code{\underline} in
+@ref{Math miscellany}.
@item \c
@itemx \capitalcedilla
@findex \c @r{(cedilla accent)}
@findex \capitalcedilla
@cindex cedilla accent
-Produces a cedilla accent under the following, as in @,{c}.
+@,{c} Cedilla accent underneath.
@item \d
@itemx \capitaldotaccent
@findex \d @r{(dot-under accent)}
@findex \capitaldotaccent
@cindex dot-under accent
-Produces a dot accent under the following, as in @udotaccent{o}.
+@udotaccent{o} Dot accent underneath.
@item \H
@itemx \capitalhungarumlaut
@findex \H @r{(Hungarian umlaut accent)}
@findex \capitalhungarumlaut
@cindex hungarian umlaut accent
-Produces a long Hungarian umlaut accent over the following, as in @H{o}.
-
-@item \i
-@findex \i @r{(dotless i)}
-@cindex dotless i
-Produces a dotless i, as in `@dotless{i}'.
-
-@item \j
-@findex \j @r{(dotless j)}
-@cindex dotless j
-Produces a dotless j, as in `@dotless{j}'.
+@H{o} Long Hungarian umlaut accent.
@item \k
@itemx \capitalogonek
@findex \k @r{(ogonek)}
@findex \capitalogonek
@cindex ogonek
-Produces a letter with ogonek, as in `@ogonek{o}'. Not available in
-the OT1 encoding.
+@ogonek{o} Ogonek. Not available in the OT1 encoding.
@item \r
@itemx \capitalring
@findex \r @r{(ring accent)}
@findex \capitalring
@cindex ring accent
-Produces a ring accent, as in `@ringaccent{o}'.
+@ringaccent{o} Ring accent.
@item \t
@itemx \capitaltie
@@ -11933,24 +16323,15 @@ Produces a ring accent, as in `@ringaccent{o}'.
@findex \newtie
@findex \capitalnewtie
@cindex tie-after accent
-Produces a tie-after accent, as in `@tieaccent{oo}'. The
-@code{\newtie} form is centered in its box.
+@tieaccent{oo} Tie-after accent. The @code{\newtie} form is centered in
+its box.
@item \u
@itemx \capitalbreve
@findex \u @r{(breve accent)}
@findex \capitalbreve
@cindex breve accent
-Produces a breve accent, as in `@u{o}'.
-
-@item \underbar
-@findex \underbar
-@cindex underbar
-Not exactly an accent, this produces a bar under the argument text.
-The argument is always processed in horizontal mode. The bar is
-always a fixed position under the baseline, thus crossing through
-descenders. See also @code{\underline} in @ref{Math miscellany}.
-See also @code{\b} above.
+@u{o} Breve accent.
@item \v
@itemx \capitalcaron
@@ -11959,7 +16340,7 @@ See also @code{\b} above.
@cindex hacek accent
@cindex check accent
@cindex caron accent
-Produces a h@'a@v{c}ek (check, caron) accent, as in `@v{o}'.
+@v{o} H@'a@v{c}ek (check, caron) accent.
@end table
@@ -11975,8 +16356,8 @@ Produces a h@'a@v{c}ek (check, caron) accent, as in `@v{o}'.
@cindex non-English characters
@cindex characters, non-English
-Here are the basic @LaTeX{} commands for inserting letters (beyond
-A--Z) extending the Latin alphabet, used primarily in languages other
+Here are the basic @LaTeX{} commands for inserting letters beyond
+A--Z that extend the Latin alphabet, used primarily in languages other
than English.
@table @code
@@ -12072,25 +16453,48 @@ font encoding, such as @sc{T1}.
@findex \rule
-Synopsis:
+Synopsis, one of:
@example
+\rule@{@var{width}@}@{@var{thickness}@}
\rule[@var{raise}]@{@var{width}@}@{@var{thickness}@}
@end example
-The @code{\rule} command produces @dfn{rules}, that is, lines or
-rectangles. The arguments are:
+Produce a @dfn{rule}, a filled-in rectangle.
-@table @var
-@item raise
-How high to raise the rule (optional).
+@cindex Halmos symbol
+@cindex tombstone
+This produces a rectangular blob, sometimes called a Halmos symbol,
+often used to mark the end of a proof.
-@item width
-The length of the rule (mandatory).
+@example
+\newcommand@{\qedsymbol@}@{\rule@{0.4em@}@{2ex@}@}
+@end example
-@item thickness
-The thickness of the rule (mandatory).
-@end table
+@PkgIndex{amsthm}
+@noindent
+The @file{amsthm} package includes this command, with a somewhat
+different-looking symbol.
+
+The mandatory arguments give the horizontal @var{width} and vertical
+@var{thickness} of the rectangle. They are rigid lengths
+(@pxref{Lengths}). The optional argument @var{raise} is also a rigid
+length, and tells @LaTeX{} how much to raise the rule above the
+baseline, or lower it if the length is negative.
+
+This produces a line, a rectangle that is wide but not tall.
+
+@example
+\noindent\rule@{\textwidth@}@{0.4pt@}
+@end example
+
+@noindent
+The line is the width of the page and 0.4@tie{}points tall. This line
+thickness is common in @LaTeX{}.
+
+A rule that has zero width, or zero thickness, will not show up in the
+output, but can cause @LaTeX{} to change the output around it.
+@xref{\strut} for examples.
@node \today
@@ -12098,16 +16502,23 @@ The thickness of the rule (mandatory).
@findex \today
@cindex date, today's
+@cindex today's date
-The @code{\today} command produces today's date, in the format
-@samp{@var{month} @var{dd}, @var{yyyy}}; for example, @samp{July 4, 1976}.
-It uses the predefined counters @code{\day}, @code{\month}, and
-@code{\year} (@pxref{\day \month \year}) to do this. It is not
-updated as the program runs.
+Synopsis:
-Multilingual packages like @file{babel} or classes like @file{lettre},
-among others, will localize @code{\today}. For example, the following
-will output @samp{4 juillet 1976}:
+@example
+\today
+@end example
+
+Produce today's date in the format @samp{@var{month} @var{dd},
+@var{yyyy}}. An example of a date in that format is @samp{July 4,
+1976}.
+
+@PkgIndex{babel}
+@PkgIndex{polyglossia}
+Multilingual packages such as @file{babel} or @file{polyglossia}, or
+classes such as @file{lettre}, will localize @code{\today}. For example,
+the following will output @samp{4 juillet 1976}:
@example
\year=1976 \month=7 \day=4
@@ -12118,9 +16529,16 @@ will output @samp{4 juillet 1976}:
\end@{document@}
@end example
+@noindent
+@code{\today} uses the counters @code{\day}, @code{\month}, and
+@code{\year} (@pxref{\day & \month & \year}).
+
@PkgIndex{datetime}
-The @code{datetime} package, among others, can produce a wide variety
-of other date formats.
+A number of package on CTAN work with dates. One is @file{datetime} package
+which can produce a wide variety of date formats, including ISO standards.
+
+The date is not updated as the @LaTeX{} process runs, so in principle the
+date could be incorrect by the time the program finishes.
@node Splitting the input
@@ -12129,68 +16547,239 @@ of other date formats.
@cindex splitting the input file
@cindex input file
-A large document requires a lot of input. Rather than putting the whole
-input in a single large file, it's more efficient to split it into
-several smaller ones. Regardless of how many separate files you use,
-there is one that is the
+@LaTeX{} lets you split a large document into several smaller ones.
+This can simplify editing or allow multiple authors to work on the
+document. It can also speed processing.
+
+Regardless of how many separate files you use, there is always one
@cindex root file
@cindex file, root
-@dfn{root file}; it is the one whose name you type
-when you run @LaTeX{}.
+@dfn{root file}, on which @LaTeX{} compilation starts. This shows such
+a file with five included files.
-@xref{filecontents}, for an environment that allows bundling an
-external file to be created with the main document.
+@example
+\documentclass@{book@}
+\includeonly@{ % comment out lines below to omit compiling
+ pref,
+ chap1,
+ chap2,
+ append,
+ bib
+ @}
+\begin@{document@}
+\frontmatter
+\include@{pref@}
+\mainmatter
+\include@{chap1@}
+\include@{chap2@}
+\appendix
+\include@{append@}
+\backmatter
+\include@{bib@}
+\end@{document@}
+@end example
+
+@noindent
+This will bring in material from @file{pref.tex}, @file{chap1.tex},
+@file{chap2.tex}, @file{append.tex}, and @file{bib.tex}. If you compile
+this file, and then comment out all of the lines inside
+@code{\includeonly@{...@}} except for @code{chap1,} and compile again,
+then @LaTeX{} will only process the material in the first chapter.
+Thus, your output will appear more quickly and be shorter to print.
+However, the advantage of the @code{\includeonly} command is that
+@LaTeX{} will retain the page numbers and all of the cross reference
+information from the other parts of the document so these will appear in
+your output correctly.
+
+@xref{Larger book template} for another example of @code{\includeonly}.
@menu
-* \include:: Conditionally include a file.
-* \includeonly:: Determine which files are included.
-* \input:: Unconditionally include a file.
+* \endinput:: Stop including material from a file.
+* \include & \includeonly:: Conditionally include files.
+* \input:: Unconditionally include a file.
@end menu
-@node \include
-@section @code{\include}
-@findex \include
+@node \endinput
+@section @code{\endinput}
+
+@findex \endinput
Synopsis:
@example
-\include@{@var{file}@}
+\endinput
@end example
-If no @code{\includeonly} command is present, the @code{\include}
-command executes @code{\clearpage} to start a new page
-(@pxref{\clearpage}), then reads @var{file}, then does another
-@code{\clearpage}.
+When you @code{\include@{filename@}}, inside @file{filename.tex} the
+material after @code{\endinput} will not be included. This command is
+optional; if @file{filename.tex} has no @code{\endinput} then @LaTeX{}
+will read all of the file.
-Given an @code{\includeonly} command, the @code{\include} actions are
-only run if @var{file} is listed as an argument to
-@code{\includeonly}. See @ref{\includeonly}.
+For example, suppose that a document's root file has
+@code{\input@{chap1@}} and this is @file{chap1.tex}.
-@cindex nested @code{\include}, not allowed
-The @code{\include} command may not appear in the preamble or in a file
-read by another @code{\include} command.
+@example
+\chapter@{One@}
+This material will appear in the document.
+\endinput
+This will not appear.
+@end example
+
+This can be useful for putting documentation or comments at the end of a
+file, or for avoiding junk characters that can be added during mailing.
+It is also useful for debugging: one strategy to localize errors is to
+put @code{\endinput} halfway through the included file and see if the
+error disappears. Now, knowing which half contains the error, moving
+@code{\endinput} to halfway through that area further narrows down the
+location. This process rapidly finds the offending line.
+After reading @code{\endinput}, @LaTeX{} continues to read to the end of
+the line, so something can follow this command and be read nonetheless.
+This allows you, for instance, to close an @code{\if...} with a
+@code{\fi}.
-@node \includeonly
-@section @code{\includeonly}
+@node \include & \includeonly
+@section @code{\include} & @code{\includeonly}
+
+@findex \include
@findex \includeonly
Synopsis:
@example
-\includeonly@{@var{file1},@var{file2},...@}
+\includeonly@{ % in document preamble
+ ...
+ @var{filename},
+ ...
+ @}
+ ...
+\include@{@var{filename}@} % in document body
+@end example
+
+Bring material from the external file @file{@var{filename}.tex} into a
+@LaTeX{} document.
+
+The @code{\include} command does three things: it executes
+@code{\clearpage} (@pxref{\clearpage & \cleardoublepage}), then it
+inputs the material from @file{@var{filename}.tex} into the document,
+and then it does another @code{\clearpage}. This command can only
+appear in the document body. The @code{\includeonly} command controls
+which files will be read by @LaTeX{} under subsequent @code{\include}
+commands. Its list of filenames is comma-separated, and it can only
+appear in the preamble.
+
+This example root document, @file{constitution.tex}, brings in
+three files, @file{preamble.tex}, @file{articles.tex}, and
+@file{amendments.tex}.
+
+@example
+\documentclass@{book@}
+\includeonly@{
+ preamble,
+ articles,
+ amendments
+ @}
+\begin@{document@}
+\include@{preamble@}
+\include@{articles@}
+\include@{amendments@}
+\end@{document@}
@end example
-The @code{\includeonly} command controls which files will be read by
-subsequent @code{\include} commands. The list of filenames is
-comma-separated. Each element @var{file1}, @var{file2}, @dots{} must
-exactly match a filename specified in a @code{\include} command for the
-selection to be effective.
+@noindent
+The file @file{preamble.tex} contains no special code; you have just
+excerpted the chapter from @file{consitution.tex} and put it in a
+separate file just for editing convenience.
+
+@example
+\chapter@{Preamble@}
+We the People of the United States,
+in Order to form a more perfect Union, ...
+@end example
-This command can only appear in the preamble.
+@noindent
+Running @LaTeX{} on @file{constitution.tex} makes the material from the
+three files appear in the document but also generates the auxiliary
+files @file{preamble.aux}, @file{articles.aux}, and
+@file{amendments.tex}. These contain information such as page numbers
+and cross-references (@pxref{Cross references}). If you now comment out
+@code{\includeonly}'s lines with @code{preamble} and @code{amendments}
+and run @LaTeX{} again then the resulting document shows only the
+material from @file{articles.tex}, not the material from
+@file{preamble.tex} or @file{amendments.tex}. Nonetheless, all of the
+auxiliary information from the omitted files is still there, including
+the starting page number of the chapter.
+
+If the document preamble does not have @code{\includeonly} then
+@LaTeX{} will include all the files you call for with @code{\include}
+commands.
+
+The @code{\include} command makes a new page. To avoid that, see
+@ref{\input} (which, however, does not retain the auxiliary
+information).
+
+@xref{Larger book template} for another example using @code{\include}
+and @code{\includeonly}. That example also uses @code{\input} for some
+material that will not necessarily start on a new page.
+
+File names can involve paths.
+
+@example
+\documentclass@{book@}
+\includeonly@{
+ chapters/chap1,
+ @}
+\begin@{document@}
+\include@{chapters/chap1@}
+\end@{document@}
+@end example
+
+To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores. Nevertheless, for the name @samp{amo amas amat},
+this works under @TeX{} Live on GNU/Linux:
+
+@example
+\documentclass@{book@}
+\includeonly@{
+ "amo\space amas\space amat"
+ @}
+\begin@{document@}
+\include@{"amo\space amas\space amat"@}
+\end@{document@}
+@end example
+
+and this works under MiK@TeX{} on Windows:
+
+@example
+\documentclass@{book@}
+\includeonly@{
+ @{"amo amas amat"@}
+ @}
+\begin@{document@}
+\include@{@{"amo amas amat"@}@}
+\end@{document@}
+@end example
+
+@cindex nested @code{\include}, not allowed
+You cannot use @code{\include} inside a file that is being included or
+you get @samp{LaTeX Error: \include cannot be nested.} The
+@code{\include} command cannot appear in the document preamble; you will
+get @samp{LaTeX Error: Missing \begin@{document@}}.
+
+If a file that you @code{\include} does not exist, for instance if you
+@code{\include@{athiesm@}} but you meant @code{\include@{atheism@}},
+then @LaTeX{} does not give you an error but will warn you @samp{No file
+athiesm.tex.} (It will also create @file{athiesm.aux}.)
+
+If you @code{\include} the root file in itself then you first get
+@samp{LaTeX Error: Can be used only in preamble.} Later runs get
+@samp{TeX capacity exceeded, sorry [text input levels=15]}. To fix
+this, you must remove the inclusion @code{\include@{root@}} but also
+delete the file @file{@var{root}.aux} and rerun @LaTeX{}.
@node \input
@@ -12201,62 +16790,183 @@ This command can only appear in the preamble.
Synopsis:
@example
-\input@{@var{file}@}
+\input@{@var{filename}@}
+@end example
+
+@LaTeX{} processes the file as if its contents were inserted in the
+current file. For a more sophisticated inclusion mechanism see
+@ref{\include & \includeonly}.
+
+If @var{filename} does not end in @samp{.tex} then @LaTeX{} first tries
+the filename with that extension; this is the usual case. If
+@var{filename} ends with @samp{.tex} then @LaTeX{} looks for the
+filename as it is.
+
+For example, this
+
+@example
+\input@{macros@}
+@end example
+
+@noindent
+will cause @LaTeX{} to first look for @file{macros.tex}. If it finds
+that file then it processes its contents as thought they had been
+copy-pasted in. If there is no file of the name @file{macros.tex} then
+@LaTeX{} tries the name @file{macros}, without an extension. (This may
+vary by distribution.)
+
+To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores. Nevertheless, for the name @samp{amo amas amat},
+this works under @TeX{} Live on GNU/Linux:
+
+@example
+\input@{"amo\space amas\space amat"@}
@end example
-The @code{\input} command causes the specified @var{file} to be read
-and processed, as if its contents had been inserted in the current
-file at that point.
+and this works under MiK@TeX{} on Windows:
-If @var{file} does not end in @samp{.tex} (e.g., @samp{foo} or
-@samp{foo.bar}), it is first tried with that extension (@samp{foo.tex}
-or @samp{foo.bar.tex}). If that is not found, the original @var{file}
-is tried (@samp{foo} or @samp{foo.bar}).
+@example
+\input@{@{"amo amas amat"@}@}
+@end example
@node Front/back matter
@chapter Front/back matter
@menu
-* Tables of contents::
-* Glossaries::
-* Indexes::
+* Table of contents etc.:: Table of contents, list of figures, list of tables.
+* Indexes:: Generate an index.
+* Glossaries:: Generate a glossary.
@end menu
-@node Tables of contents
-@section Tables of contents
+@node Table of contents etc.
+@section Table of contents etc.
@cindex table of contents, creating
@findex \tableofcontents
@findex .toc @r{file}
-A table of contents is produced with the @code{\tableofcontents}
-command. You put the command right where you want the table of
-contents to go; @LaTeX{} does the rest for you. A previous run must
-have generated a @file{.toc} file.
-
-The @code{\tableofcontents} command produces a heading, but it does
-not automatically start a new page. If you want a new page after the
-table of contents, write a @code{\newpage} command after the
-@code{\tableofcontents} command.
-
@findex \listoffigures
@findex \listoftables
@findex .lof @r{file}
@findex .lot @r{file}
-The analogous commands @code{\listoffigures} and @code{\listoftables}
-produce a list of figures and a list of tables (from @file{.lof} and
-@file{.lot} files), respectively. Everything works exactly the same
-as for the table of contents.
-@findex \nofiles
-The command @code{\nofiles} overrides these commands, and
-@emph{prevents} any of these lists from being generated.
+Synopsis, one of:
+
+@example
+\tableofcontents
+\listoffigures
+\listoftables
+@end example
+
+Produce a table of contents, or list of figures, or list of tables. Put
+the command in the input file where you want the table or list to
+go. You do not type the entries; for example, typically the table of
+contents entries are automatically generated from the sectioning
+commands @code{\chapter}, etc.
+
+This example illustrates the first command, @code{\tableofcontents}.
+@LaTeX{} will produce a table of contents on the book's first page.
+
+@example
+\documentclass@{book@}
+% \setcounter@{tocdepth@}@{1@}
+\begin@{document@}
+\tableofcontents\newpage
+ ...
+\chapter@{...@}
+ ...
+\section@{...@}
+ ...
+\subsection@{...@}
+ ...
+\end@{document@}
+@end example
+
+@noindent
+Uncommenting the second line would cause that table to contain chapter
+and section listings but not subsection listings, because the
+@code{\section} command has level@tie{}1. @xref{Sectioning} for level
+numbers of the sectioning units. For more on the @code{tocdepth}
+@pxref{Sectioning/tocdepth}.
+
+Another example of the use of @code{\tableofcontents} is in @ref{Larger
+book template}.
+
+If you want a page break after the table of contents, write a
+@code{\newpage} command after the @code{\tableofcontents} command, as
+above.
+
+To make the table of contents @LaTeX{} stores the information in an
+auxiliary file named @file{@var{root-file}.toc} (@pxref{Splitting the
+input}). For example, this @LaTeX{} file @file{test.tex}
+
+@example
+\documentclass@{article@}
+\begin@{document@}
+\tableofcontents\newpage
+\section@{First section@}
+\subsection@{First subsection@}
+ ...
+@end example
+
+@noindent
+writes the following line to @file{test.toc}.
+
+@example
+\contentsline @{section@}@{\numberline @{1@}First section@}@{2@}
+\contentsline @{subsection@}@{\numberline @{1.1@}First subsection@}@{2@}
+@end example
+
+@noindent
+The @code{section} or @code{subsection} is the sectioning unit. The
+hook @code{\numberline} lets you to change how the information appears
+in the table of contents. Of its two arguments, @code{1} or @code{1.1}
+is the sectioning unit number and @code{First section} or @code{First
+subsection} is the title. Finally, @code{2} is the page number on which
+the sectioning units start.
+
+One consequence of this auxiliary file storage strategy is that to get the
+contents page correct you must run @LaTeX{} twice, once to store the
+information and once to get it. In particular, the first time that you
+run @LaTeX{} on a new document, the table of contents page will be empty
+except for its @samp{Contents} header. Just run it again.
+
+The commands @code{\listoffigures} and @code{\listoftables} produce a
+list of figures and a list of tables. They work the same way as the
+contents commands; for instance, these work with information stored in
+@file{.lof} and @file{.lot} files.
+
+@PkgIndex{babel}
+@PkgIndex{polyglossia}
+To change the header for the table of contents page do something like
+the first line here.
+
+@example
+\renewcommand@{\contentsname@}@{Table of contents@}
+\renewcommand@{\listfigurename@}@{Plots@}
+\renewcommand@{\listtablename@}@{Tables@}
+@end example
+
+@noindent
+Similarly, the other two lines will do the other two.
+Internationalization packages such as @file{babel} or @file{polyglossia}
+will change the headers depending on the chosen base language.
+
+@PkgIndex{tocloft}
+@PkgIndex{tocbibbind}
+CTAN has many packages for the table of contents and lists of figures
+and tables. One convenient one for adjusting some aspects of the
+default, such as spacing, is @file{tocloft}. And, @file{tocbibbind}
+will automatically add the bibliography, index, etc. to the table of
+contents.
@menu
* \addcontentsline:: Add an entry to table of contents, etc.
* \addtocontents:: Add text directly to table of contents file, etc.
+* \nofiles:: Prevent writing to auxiliary files.
@end menu
@@ -12272,39 +16982,94 @@ Synopsis:
\addcontentsline@{@var{ext}@}@{@var{unit}@}@{@var{text}@}
@end example
-The @code{\addcontentsline} command adds an entry to the specified list
-or table where:
+@findex \contentsline
+Add an entry to the file specified by @var{ext}. Usually @var{ext} is
+one of @code{toc} for the table of contents, @code{lof} for the list of
+figures, or @code{lot} for the list of tables.
+
+The following will result in an @samp{Appendices} line in the table of
+contents.
+
+@example
+\addcontentsline@{toc@}@{section@}@{\protect\textbf@{Appendices@}@}
+@end example
+
+@noindent
+It will appear at the same indentation level as the sections, will be in
+boldface, and will be assigned the page number associated with the point
+where it appears in the input file.
+
+The @code{\addcontentsline} command writes information to the file
+@file{@var{root-name}.@var{ext}}. It writes that information as the
+text of the command
+@code{\contentsline@{@var{unit}@}@{@var{text}@}@{@var{num}@}}, where
+@code{@var{num}} is the current value of counter @code{@var{unit}}. The
+most common case is the table of contents and there @var{num} is the
+page number of the first page of @var{unit}.
+
+This command is invoked by the sectioning commands @code{\chapter},
+etc., and also by @code{\caption} inside a float environment. But it is
+also used by authors. For example, in a book to have the preface
+unnumbered, you may use the starred @code{\chapter*}. But that does not
+put in table of contents information, so you can enter it manually, as
+here.
+
+@example
+\chapter*@{Preface@}
+\addcontentsline@{toc@}@{chapter@}@{\protect\numberline@{@}Preface@}
+@end example
+
+@noindent
+In the @file{.toc} file @LaTeX{} will put the line @code{\contentsline
+@{chapter@}@{\numberline @{@}Preface@}@{3@}}; note the page number
+@samp{3}.
+
+@c xx how hardwired are these values? other unit names?
+
+All of the arguments for @code{\addcontentsline} are required.
@table @var
@item ext
-The filename extension of the file on which information is to be written,
-typically one of: @code{toc} (table of contents), @code{lof} (list of
-figures), or @code{lot} (list of tables).
+Typically one of the strings @code{toc} for the table of contents,
+@code{lof} for the list of figures, or @code{lot} for the list of
+tables. The filename extension of the information file.
@item unit
-The name of the sectional unit being added, typically one of the
-following, matching the value of the @var{ext} argument:
+A string that depends on the value of the @var{ext} argument:
@table @code
@item toc
-The name of the sectional unit: @code{part}, @code{chapter},
-@code{section}, @code{subsection}, @code{subsubsection}.
+For the table of contents, this is the name of a sectional unit:
+@code{part}, @code{chapter}, @code{section}, @code{subsection}, etc.
+
@item lof
For the list of figures: @code{figure}.
+
@item lot
For the list of tables: @code{table}.
@end table
@item text
-The text of the entry.
+The text of the entry. You must @code{\protect} any commands that are
+fragile (@pxref{\protect}).
@end table
-@findex \contentsline
-What is written to the @file{.@var{ext}} file is the command
-@code{\contentsline@{@var{unit}@}@{@var{text}@}@{@var{num}@}}, where
-@code{@var{num}} is the current value of counter @code{@var{unit}}.
+The @code{\addcontentsline} command has an interaction with
+@code{\include} (@pxref{\include & \includeonly}). If you use them at
+the same level, as with
+@code{\addcontentsline@{...@}@{...@}@{...@}\include@{...@}} then lines
+in the table of contents can come out in the wrong order. The solution
+is to move @code{\addcontentsline} into the file being included.
-@c xx how hardwired are these values? other unit names?
+If you use a @var{unit} that @LaTeX{} does not recognize, as here
+
+@example
+\addcontentsline@{toc@}@{setcion@}@{\protect\textbf@{Appendices@}@}
+@end example
+
+@noindent
+then you don't get an error but the formatting in the table of contents
+will not make sense.
@node \addtocontents
@@ -12312,42 +17077,84 @@ What is written to the @file{.@var{ext}} file is the command
@findex \addtocontents@{@var{ext}@}@{@var{text}@}
-The @code{\addtocontents}@{@var{ext}@}@{@var{text}@} command adds text
-(or formatting commands) directly to the @file{.@var{ext}} file that
-generates the table of contents or lists of figures or tables.
+Synopsis:
+
+@example
+\addtocontents@{@var{ext}@}@{@var{text}@}
+@end example
+
+Add @var{text}, which may be text or formatting commands, directly to
+the auxiliary file with extension @var{ext}. This is most commonly used
+for the table of contents so that is the discussion here, but this also
+applies to the list of figures and list of tables.
+
+This will put some vertical space in the table of contents after the
+@samp{Contents} header.
+
+@example
+\tableofcontents\newpage
+\addtocontents@{toc@}@{\protect\vspace*@{3ex@}@}
+@end example
+
+The @code{\addtocontents} command has two arguments. Both are
+required.
@table @var
@item ext
-The extension of the file on which information is to be written,
-typically one of: @file{toc} (table of contents), @file{lof} (list of
-figures), or @file{lot} (list of tables).
+Typically one of: @file{toc} for the table of contents, @file{lof} for
+the list of figures, or @file{lot} for the list of tables. The
+extension of the file holding the information.
@item text
-The text to be written.
+The text, and possibly commands, to be written.
@end table
+The sectioning commands such as @code{\chapter} use the
+@code{\addcontentsline} command to store information. This command
+creates lines in the @file{.toc} auxiliary file containing the
+@code{\contentsline} command (@pxref{\addcontentsline}). In contrast,
+the command @code{\addtocontents} puts material directly in that file.
-@node Glossaries
-@section Glossaries
+The @code{\addtocontents} command has an interaction with
+@code{\include} (@pxref{\include & \includeonly}). If you use them at
+the same level, as with
+@code{\addtocontents@{...@}@{...@}\include@{...@}} then lines in the
+table of contents can come out in the wrong order. The solution is to
+move @code{\addtocontents} into the file being included.
-@cindex glossaries
-@findex \makeglossary
-The command @code{\makeglossary} enables creating glossaries.
+@node \nofiles
+@subsection @code{\nofiles}
-@findex \glossary
-@cindex @file{.glo} file
-The command @code{\glossary@{@var{text}@}} writes a glossary entry for
-@var{text} to an auxiliary file with the @file{.glo} extension.
+@findex \nofiles
+
+Synopsis:
-@findex \glossaryentry
-Specifically, what gets written is the command
-@code{\glossaryentry@{@var{text}@}@{@var{pageno}@}}, where
-@var{pageno} is the current @code{\thepage} value.
+@example
+\nofiles
+@end example
+
+Prevent @LaTeX{} from writing any auxiliary files. The only output will
+be the @file{.log} and @file{.pdf} (or @file{.dvi}) files. This command
+must go in the preamble.
+
+Because of the @code{\nofiles} command this example will not produce a
+@file{.toc} file.
+
+@example
+\documentclass@{book@}
+\nofiles
+\begin@{document@}
+\tableofcontents\newpage
+\chapter@{...@}
+ ...
+@end example
-@cindex glossary @r{package}
-The @code{glossary} package on CTAN provides support for fancier
-glossaries.
+@noindent
+@LaTeX{} will not erase any existing auxiliary files, so if you insert
+the @code{\nofiles} command after you have run the file and gotten
+a @file{.toc} then the table of contents page will continue to show
+the old information.
@node Indexes
@@ -12356,61 +17163,608 @@ glossaries.
@cindex indexes
@findex \makeindex
-The command @code{\makeindex} enables creating indexes. Put this in
-the preamble.
-
@findex \index
@cindex @file{.idx} file
-The command @code{\index@{@var{text}@}} writes an index entry for
-@var{text} to an auxiliary file named with the @file{.idx} extension.
-@findex \indexentry
-Specifically, what gets written is the command
-@code{\indexentry@{@var{text}@}@{@var{pageno}@}}, where @var{pageno}
-is the current @code{\thepage} value.
+This document has an index.
+
+@example
+\documentclass@{article@}
+\usepackage@{makeidx@} \makeindex
+ ...
+\begin@{document@}
+ ...
+Recall Wilson's Theorem: \index@{Wilson's Theorem@}
+a number \( n>1 \) is prime if and only if the factorial of \( n-1 \)
+is congruent to \( -1 \) modulo~\( n \).
+ ...
+\printindex
+ ...
+@end example
+
+@noindent
+The @code{\usepackage@{makeidx@}} and @code{\makeindex} in the preamble
+bring in the relevant commands.
+
+Producing an index is a three stage process. First, in the document
+body you declare index entries with the @code{\index} command
+(@pxref{\index}). When you run @LaTeX{}, the @code{\index} writes its
+information to an auxiliary file @file{@var{root-name}.idx}. Next, to
+alphabetize and to do other manipulations you run an external command,
+typically @command{makeindex} or @command{xindy} (@pxref{makeindex}).
+These output a file @file{@var{root-name}.ind}. Finally, you bring the
+information back into your document and typeset it with the
+@code{\printindex} command (@pxref{\printindex}).
+
+@PkgIndex{showidx}
+@PkgIndex{multind}
+There are many packages that apply to indexing commands. The
+@code{showidx} package causes each index entries to be shown in the
+margin on the page where the entry appears. This can help in preparing
+the index. The @code{multind} package supports multiple indexes. See
+also the @TeX{} FAQ entry on this topic,
+@url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind}.
+
+@menu
+* \index:: Declare an index entry.
+* makeindex:: Alphabetize index entries.
+* \printindex:: Put the index here.
+@end menu
+
+
+@node \index
+@subsection @code{\index}
+
+@cindex index entry
+@findex \index
+
+Synopsis:
+
+@example
+\index@{@var{index-entry-string}@}
+@end example
+
+Declare an entry in the index. This command is fragile
+(@pxref{\protect}).
+
+For example, as described in @ref{Indexes}, one way to get an index from
+what's below is to compile the document with @code{pdflatex test}, then
+process the index entries with @code{makeindex test}, and then compile
+again with @code{pdflatex test}.
+
+@example
+W~Ackermann (1896--1962).\index@{Ackermann@}
+ ...
+Ackermann function\index@{Ackermann!function@}
+ ...
+rate of growth\index@{Ackermann!function!growth rate@}
+@end example
+
+@noindent
+All three index entries will get a page number, such as @samp{Ackermann,
+22}. @LaTeX{} will format the second as a subitem of the first, on the
+line below it and indented, and the third as a subitem of the second.
+Three levels deep is as far as you can nest subentries. (If you add
+@code{\index@{Ackermann!function!growth rate!comparison@}} then
+@command{makeindex} says @samp{Scanning input file test.idx....done (4
+entries accepted, 1 rejected)} and nothing appears in the index).
+
+If you enter a second @code{\index} with the same
+@var{index-entry-string} then you will get a single index entry with two
+page numbers (unless they happen to fall on the same page). Thus,
+adding @code{as for Ackermann.\index@{Ackermann@}} later in the same
+document as above will give an index entry like @samp{Ackermann, 22,
+151}. Also, you can enter the index entries in any order, so for
+instance @code{\index@{Ackermann!function@}} could come before
+@code{\index@{Ackermann@}}.
+
+@cindex index, page range
+Get a page range in the output, like @samp{Hilbert, 23--27}, as here.
+
+@example
+W~Ackermann (1896--1962).\index@{Ackermann@}
+ ...
+D~Hilbert (1862--1943)\index@{Ackermann!Hilbert\(@}
+ ...
+disapproved of his marriage.\index@{Ackermann!Hilbert\)@}
+@end example
+
+@noindent
+If the beginning and ending of the page range are equal then the system
+just gives a single page entry, not a range.
+
+If you index subentries but not a main entry, as with
+@code{\index@{Jones!program@}} and @code{\index@{Jones!results@}}, then
+the output is the item @samp{Jones} with no comma or page number,
+followed by two subitems, like @samp{program, 50} and @samp{results,
+51}.
@cindex `see' and `see also' index entries
@cindex index entries, `see' and `see also'
-To generate a index entry for `bar' that says `See foo', use a
-vertical bar: @code{\index@{bar|see@{foo@}@}}. Use @code{seealso}
-instead of @code{see} to make a `See also' entry.
-
@findex \seename
@findex \alsoname
-The text `See' is defined by the macro @code{\seename}, and `See also'
-by the macro @code{\alsoname}. These can be redefined for other
-languages.
+@PkgIndex{babel} @PkgIndex{polyglossia}
+
+Generate a index entry that says @samp{See} by using a vertical bar
+character: @code{\index@{Ackermann!function|see@{P\'eter's
+function@}@}}. You can instead get @samp{See also} with @code{seealso}.
+(The text @samp{See} is defined by @code{\seename}, and @samp{See also}
+by @code{\alsoname}. You can redefine these either by using an
+internationalization package such as @file{babel} or @file{polyglossia},
+or directly as with @code{\renewcommand@{\alsoname@}[1]@{Also see
+#1@}}.)
+
+The @samp{See} feature is part of a more general functionality. After
+the vertical bar you can put the name of a one-input command, as in
+@code{\index@{group|textit@}} (note the missing backslash on the
+@code{\textit} command) and the system will apply that command to the
+page number, here giving something like @code{\textit@{7@}}. You can
+define your own one-input commands, such as
+@code{\newcommand@{\definedpage@}[1]@{@{\color@{blue@}#1@}@}} and then
+@code{\index@{Ackermann!function|definedpage@}} will give a blue page
+number (@pxref{Color}). Another, less practical, example is this,
+
+@c credit Ian Thompson https://tex.stackexchange.com/a/272572/121234
+@example
+\newcommand\indexownpage[1]@{#1, \thepage@}
+ ... Epimenides.\index@{self-reference|indexownpage@}
+@end example
+
+@noindent
+which creates an entry citing the page number of its own index listing.
+
+The two functions just described combine, as here
+@example
+\index@{Ackermann!function|(definedpage@}
+ ...
+\index@{Ackermann!function|)@}
+@end example
+
+@noindent
+which outputs an index entry like @samp{function, 23--27} where the page
+number range is in blue.
+
+Consider an index entry such as @samp{@BES{03B1,\alpha}-ring}. Entering
+it as @code{$\alpha$-ring} will cause it to be alphabetized according to
+the dollar sign. You can instead enter it using an at-sign, as
+@code{\index@{alpha-ring@@$\alpha$-ring@}}. If you specify an entry
+with an at-sign separating two strings, @code{@var{pos}@@@var{text}},
+then @var{pos} gives the alphabetical position of the entry while
+@var{text} produces the text of the entry. Another example is that
+@code{\index@{Saint Michael's College@@SMC@}} produces an index entry
+@samp{SMC} alphabetized into a different location than its spelling
+would naturally give it.
+
+To put a @code{!}, or @code{@@}, or @code{|} character in an index
+entry, preceding it with a double quote, @code{"}. (The double quote
+gets deleted before alphabetization.)
+
+@PkgIndex{index}
+A number of packages on CTAN have additional functionality beyond that
+provided by @file{makeidx}. One is @file{index}, which allows for
+multiple indices and contains a command
+@code{\index*@{@var{index-entry-string}@}} that prints the
+@var{index-entry-string} as well as indexing it.
+
+@findex \indexentry
+@cindex idx file
+The @code{\index} command writes the indexing information to the file
+@file{@var{root-name}.idx} file. Specifically, it writes text of the
+command
+@code{\indexentry@{@var{index-entry-string}@}@{@var{page-num}@}}, where
+where @var{page-num} is the value of the @code{\thepage} counter. On
+occasion, when the @code{\printindex} command is confused, you have to
+delete this file to start with a fresh slate.
+
+If you omit the closing brace of an @code{\index} command then you get a
+message like this.
+
+@example
+Runaway argument? @{Ackermann!function
+! Paragraph ended before \@@wrindex was complete.
+@end example
+
+
+@node makeindex
+@subsection @command{makeindex}
+
+@cindex index, processing
+@findex makeindex
@cindex @command{makeindex} program
-@cindex @command{xindy} program
@cindex @file{.ind} file
-The generated @file{.idx} file is then sorted with an external
-command, usually either @command{makeindex}
-(@url{http://mirror.ctan.org/indexing/makeindex}) or (the
-multi-lingual) @command{xindy} (@url{http://xindy.sourceforge.net}).
-This results in a @file{.ind} file, which can then be read to typeset
-the index.
+@cindex @file{.idx} file
-@findex \printindex
-@PkgIndex{makeidx}
-The index is usually generated with the @code{\printindex} command.
-This is defined in the @code{makeidx} package, so
-@code{\usepackage@{makeidx@}} needs to be in the preamble.
+Synopsis, one of:
+
+@example
+makeindex @var{filename}
+makeindex -s @var{style-file} @var{filename}
+makeindex @var{options} @var{filename0} ...
+@end example
+
+Sort, and otherwise process, the index information in the auxiliary file
+@var{filename}. This is a command line program. It takes one or more
+raw index files, @file{@var{filename}.idx} files, and produces the
+actual index file, the @file{@var{filename}.ind} file that is input by
+@code{\printindex} (@pxref{\printindex}).
+
+@cindex @file{.isty} file
+@findex index, style file
+@findex makeindex, style file
+The first form of the command suffices for many uses. The second allows
+you to format the index by using an @dfn{index style file}, a
+@file{.isty} file. The third form is the most general; see the full
+documentation on CTAN.
+This is a simple @file{.isty} file.
+
+@example
+% book.isty
+% $ makeindex -s book.isty -p odd book.idx
+% creates the index as book.ind, starting on an odd page.
+preamble
+"\\pagestyle@{empty@}
+\\small
+\\begin@{theindex@}
+\\thispagestyle@{empty@}"
+
+postamble
+"\n
+\\end@{theindex@}"
+@end example
+
+The description here covers only some of the index formatting
+possibilities in @var{style-file}. For a full list see the documentation
+on CTAN.
+
+A style file consists of a list of pairs: @var{specifier} and
+@var{attribute}. These can appear in the file in any order. All of the
+@var{attributes} are strings, except where noted. Strings are
+surrounded with double quotes, @code{"}, and the maximum length of a
+string is 144 characters. The @code{\n} is for a newline and @code{\t}
+is for a tab. Backslashes are escaped with another backslash,
+@code{\\}. If a line begins with a percent sign, @code{%}, then it is a
+comment.
+
+@ftable @code
+@anchor{makeindex preamble}
+@item preamble
+Preamble of the output file. Defines the context in which the index is
+formatted. Default: @code{"\\begin@{theindex@}\n"}.
+
+@anchor{makeindex postamble}
+@item postamble
+Postamble of the output file. Default: @code{"\n\n\\end@{theindex@}\n"}.
+
+@anchor{makeindex group skip}
+@item group_skip
@findex \indexspace
-The rubber length @code{\indexspace} is inserted before each new
-letter in the printed index; its default value is @samp{10pt plus5pt
-minus3pt}.
+Traditionally index items are broken into groups, typically a group for
+entries starting with @samp{a}, etc. This specifier gives what is
+inserted when a new group begins. Default: @code{"\n\n \\indexspace\n"}
+(@code{\indexspace} is a rubber length with default value @code{10pt
+plus5pt minus3pt}).
+
+@anchor{makeindex letheadflag}
+@item lethead_flag
+An integer. It governs what is inserted for a new group or letter. If
+it is 0 (which is the default) then other than @code{group_skip} nothing
+will be inserted before the group. If it is is positive then at a new
+letter the @code{lethead_prefix} and @code{lethead_suffix} will be
+inserted, with that letter in uppercase between them. If it is negative
+then what will be inserted is the letter in lowercase. The default
+is@tie{}0.
+
+@anchor{makeindex lethead prefix}
+@item lethead_prefix
+If a new group begins with a different letter then this is the prefix
+inserted before the new letter header. Default: @code{""}
+
+@anchor{makeindex lethead suffix}
+@item lethead_suffix
+If a group begins with a different letter then this is the suffix
+inserted after the new letter header. Default: @code{""}.
+
+@anchor{makeindex item 0}
+@item item_0
+What is put between two level@tie{}0 items. Default: @code{"\n \\item
+"}.
+
+@anchor{makeindex item 1}
+@item item_1
+Put between two level@tie{}1 items. Default: @code{"\n \\subitem "}.
+
+@anchor{makeindex item 2}
+@item item_2
+put between two level@tie{}2 items. Default: @code{"\n \\subsubitem "}.
+
+@anchor{makeindex item 01}
+@item item_01
+What is put between a level@tie{}0 item and a level@tie{}1 item.
+Default: @code{"\n \\subitem "}.
+
+@anchor{makeindex item x1}
+@item item_x1
+What is put between a level@tie{}0 item and a level@tie{}1 item in the
+case that the level@tie{}0 item doesn't have any page numbers (as in
+@code{\index@{aaa|see@{bbb@}@}}). Default: @code{"\n \\subitem "}.
+
+@anchor{makeindex item 12}
+@item item_12
+What is put between a level@tie{}1 item and a level@tie{}2 item.
+Default: @code{"\n \\subsubitem "}.
+
+@anchor{makeindex item x2}
+@item item_x2
+What is put between a level@tie{}1 item and a level@tie{}2 item, if the
+level@tie{}1 item doesn't have page numbers. Default: @code{"\n
+\\subsubitem "}.
+
+@anchor{makeindex delim 0}
+@item delim_0
+Delimiter put between a level@tie{}0 key and its first page
+number. Default: a comma followed by a blank, @code{", "}.
+
+@anchor{makeindex delim 1}
+@item delim_1
+Delimiter put between a level@tie{}1 key and its first page
+number. Default: a comma followed by a blank, @code{", "}.
+
+@anchor{makeindex delim 2}
+@item delim_2
+Delimiter between a level@tie{}2 key and its first page number. Default:
+a comma followed by a blank, @code{", "}.
+
+@anchor{makeindex delim n}
+@item delim_n
+Delimiter between two page numbers for the same key (at any
+level). Default: a comma followed by a blank, @code{", "}.
+
+@anchor{makeindex delim r}
+@item delim_r
+What is put between the starting and ending page numbers of a range.
+Default: @code{"--"}.
+
+@anchor{makeindex line max}
+@item line_max
+An integer. Maximum length of an index entry's line in the output,
+beyond which the line wraps. Default: @code{72}.
+
+@anchor{makeindex indent space}
+@item indent_space
+What is inserted at the start of a wrapped line. Default:
+@code{"\t\t"}.
+
+@anchor{makeindex indent length}
+@item indent_length
+A number. The length of the wrapped line indentation. The default
+@code{indent_space} is two tabs and each tab is eight spaces so the
+default here is @code{16}.
+
+@anchor{makeindex page precedence}
+@item page_precedence
+A document may have pages numbered in different ways. For example, a
+book may have front matter pages numbered in lowercase roman while main
+matter pages are in arabic. This string specifies the order in which
+they will appear in the index. The @command{makeindex} command supports
+five different types of numerals: lowercase roman @code{r}, and numeric
+or arabic @code{n}, and lowercase alphabetic @code{a}, and uppercase
+roman @code{R}, and uppercase alphabetic @code{A}. Default:
+@code{"rnaRA"}.
-@PkgIndex{showidx}
-The @code{showidx} package causes each index entries to be shown in
-the margin on the page where the entry appears. This can help in
-preparing the index.
+@end ftable
-@PkgIndex{multind}
-The @code{multind} package supports multiple indexes. See also the
-@TeX{} FAQ entry on this topic,
-@url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind}.
+@findex xindy
+@cindex @command{xindy} program
+There are a number of other programs that do the job @command{makeindex}
+does. One is @command{xindy}, which does internationalization and can
+process indexes for documents marked up using @LaTeX{} and a number of
+other languages. It is is highly configurable, both in markup terms and
+in terms of the collating order of the text. See the documentation on
+CTAN.
+
+
+@node \printindex
+@subsection @command{\printindex}
+
+@cindex index, printing
+@findex \printindex
+
+Synopsis:
+
+@example
+\printindex
+@end example
+
+@findex \printindex
+Place the index into the output.
+
+To get an index you must first include
+@code{\usepackage@{makeidx@}\makeindex} in the document preamble and
+compile the document, then run the system command @command{makeindex},
+and then compile the document again. @xref{Indexes} for further
+discussion and an example of the use of @code{\printindex}.
+
+
+@node Glossaries
+@section Glossaries
+
+@cindex glossary
+@cindex glossaries
+@cindex acronyms, list of
+@findex \makeglossary
+@findex \printglossaries
+
+Synopsis:
+
+@example
+\usepackage@{glossaries@} \makeglossaries
+ ...
+\newglossaryentry@{@var{label}@}@{@var{settings}@}
+ ...
+\gls@{@var{label}@}.
+ ...
+\printglossaries
+@end example
+
+The @file{glossaries} package allows you to make glossaries, including
+multiple glossaries, as well as lists of acronyms.
+
+To get the output from this example, compile the document (for instance
+with @code{pdflatex filename}), then run the command line command
+@code{makeglossaries filename}, and then compile the document again.
+
+@example
+\documentclass@{...@}
+\usepackage@{glossaries@} \makeglossaries
+\newglossaryentry@{tm@}@{%
+ name=@{Turing machine@},
+ description=@{A model of a machine that computes. The model is simple
+ but can compute anything any existing device can compute.
+ It is the standard model used in Computer Science.@},
+ @}
+\begin@{document@}
+Everything begins with the definition of a \gls@{tm@}.
+ ...
+\printglossaries
+\end@{document@}
+@end example
+
+@noindent
+That gives two things. In the main text it outputs @samp{... definition
+of a Turing machine}. In addition, in a separate sectional unit headed
+@samp{Glossary} there appears a description list. In boldface it says
+@samp{Turing machine} and the rest of the item says in normal type
+@samp{A model of a machine @dots{} Computer Science}.
+
+@findex \makeglossary
+@findex \printglossaries
+@cindex @file{.glo} file
+The command @code{\makeglossary} opens the file that will contain the
+entry information, @file{@var{root-file}.glo}. Put the
+@code{\printglossaries} command where you want the glossaries to appear
+in your document.
+
+The @file{glossaries} package is very powerful. For instance, besides
+the commands @code{\newglossaryentry} and @code{\gls}, there are similar
+commands for a list of acronyms. See the package documentations on
+CTAN.
+
+@menu
+* \newglossaryentry:: Declare the content of a glossary entry.
+* \gls:: Give a page reference for a glossary entry.
+@end menu
+
+
+@node \newglossaryentry
+@subsection @code{\newglossaryentry}
+
+@cindex glossary, entries
+@findex \newglossaryentry
+
+Synopsis, one of:
+
+@example
+\newglossaryentry@{@var{label}@}
+@{
+ name=@{@var{name}@},
+ description=@{@var{description}@},
+ @var{other options}, ...
+@}
+@end example
+
+or
+
+@example
+\longnewglossaryentry@{@var{label}@}
+@{
+ name=@{@var{name}@},
+ @var{other options} ...,
+@}
+@{@var{description}@}
+@end example
+
+Declare a new entry for a glossary. The @var{label} must be unique for
+the document. The settings associated with the label are pairs:
+@code{@var{key}=@var{value}}.
+
+This puts the blackboard bold symbol for the real numbers @BES{211D,} in the
+glossary.
+
+@example
+\newglossaryentry@{R@}
+@{
+ name=@{\ensuremath@{\mathbb@{R@}@}@},
+ description=@{the real numbers@},
+@}
+@end example
+
+Use the second command form if the @var{description} spans more than one
+paragraph.
+
+For a full list of @var{key}s see the package documentation on CTAN but
+here are a few.
+
+@ftable @code
+@item name
+(Required.) The word, phrase, or symbol that you are defining.
+
+@item description
+(Required.) The description that will appear in the glossary.
+If this has more than one paragraph then you must use the second command
+form given in the synopsis.
+
+@item plural
+The plural form of @var{name}. Refer to the plural form using
+@code{\glspl} or @code{\Glspl} (@pxref{\gls}).
+
+@item sort
+How to place this entry in the list of entries that the glossary holds.
+
+@item symbol
+A symbol, such as a mathematical symbol, besides the name.
+
+@end ftable
+
+
+@node \gls
+@subsection @code{\gls}
+
+@cindex glossary, entry reference
+@findex \gls
+
+Synopsis, one of:
+
+@example
+\gls@{@var{label}@}
+\glspl@{@var{label}@}
+\Gls@{@var{label}@}
+\Glspl@{@var{label}@}
+@end example
+
+Refer to a glossary entry. The entries are declared with
+@code{\newglossaryentry} (@pxref{\newglossaryentry}).
+
+This
+
+@example
+\newglossaryentry@{N@}@{%
+ name=@{the natural numbers@},
+ description=@{The numbers $0$, $1$, $2$, $\ldots$\@@@},
+ symbol=@{\ensuremath@{\mathbb@{N@}@}@},
+ @}
+ ...
+Consider \gls@{N@}.
+@end example
+
+@noindent
+gives the output @samp{Consider the natural numbers}.
+
+The second command form @code{\glspl@{@var{label}@}} produces the plural
+of @var{name} (by default it tries adding an @samp{s}). The third form
+capitalizes the first letter of @var{name}, as does the fourth form,
+which also takes the plural.
@node Letters
@@ -12423,7 +17777,7 @@ Synopsis:
@example
\documentclass@{letter@}
-\address@{@var{sender address}@}
+\address@{@var{senders address}@} % return address
\signature@{@var{sender name}@}
\begin@{document@}
\begin@{letter@}@{@var{recipient address}@}
@@ -12431,7 +17785,7 @@ Synopsis:
@var{letter body}
\closing@{@var{closing text}@}
\end@{letter@}
-... more letters ...
+ ...
\end@{document@}
@end example
@@ -12439,12 +17793,11 @@ Produce one or more letters.
Each letter is in a separate @code{letter} environment, whose argument
@var{recipient address} often contains multiple lines separated with a
-double backslash@tie{}(@code{\\}). For example, you might have:
+double backslash,@tie{}(@code{\\}). For example, you might have:
@example
- \begin@{letter@}@{Mr. Joe Smith \\
- 2345 Princess St. \\
- Edinburgh, EH1 1AA@}
+ \begin@{letter@}@{Ninon de l'Enclos \\
+ l'h\^otel Sagonne@}
...
\end@{letter@}
@end example
@@ -12458,15 +17811,15 @@ preamble. As with the recipient address, often @var{sender address}
contains multiple lines separated by a double
backslash@tie{}(@code{\\}). @LaTeX{} will put the @var{sender name}
under the closing, after a vertical space for the traditional
-hand-written signature; it also can contain multiple lines.
+hand-written signature.
-Each @code{letter} environment body begins with a required @code{\opening} command
-such as @code{\opening@{Dear Madam or Sir:@}}. The @var{letter body}
-text is ordinary @LaTeX{} so it can contain everything from
-enumerated lists to displayed math, except that commands such as
-@code{\chapter} that make no sense in a letter are turned off. Each
-@code{letter} environment body typically ends with a @code{\closing}
-command such as @code{\closing@{Yours,@}}.
+Each @code{letter} environment body begins with a required
+@code{\opening} command such as @code{\opening@{Dear Madam or Sir:@}}.
+The @var{letter body} text is ordinary @LaTeX{} so it can contain
+everything from enumerated lists to displayed math, except that commands
+such as @code{\chapter} that make no sense in a letter are turned off.
+Each @code{letter} environment body typically ends with a
+@code{\closing} command such as @code{\closing@{Yours,@}}.
@findex \\ @r{for letters}
Additional material may come after the @code{\closing}. You can say who
@@ -12474,13 +17827,13 @@ is receiving a copy of the letter with a command like @code{\cc@{the
Boss \\ the Boss's Boss@}}. There's a similar @code{\encl} command for
a list of enclosures. And, you can add a postscript with @code{\ps}.
-@LaTeX{}'s default is to indent the signature and the @code{\closing}
-above it by a length of @code{\longindentation}. By default this is
+@LaTeX{}'s default is to indent the sender name and the closing above it
+by a length of @code{\longindentation}. By default this is
@code{0.5\textwidth}. To make them flush left, put
@code{\setlength@{\longindentation@}@{0em@}} in your preamble.
To set a fixed date use something like
-@code{\renewcommand@{\today@}@{2015-Oct-12@}}. If put in your preamble
+@code{\renewcommand@{\today@}@{1958-Oct-12@}}. If put in your preamble
then it will apply to all the letters.
This example shows only one @code{letter} environment. The three lines
@@ -12515,7 +17868,6 @@ These commands are used with the @code{letter} class.
* \opening:: Saying hello.
* \ps:: Adding a postscript.
* \signature:: Sender's signature.
-@c ?Not user-level? * \stopbreaks and \startbreaks:: Disallow and allow page breaks.
* \telephone:: Sender's phone number.
@end menu
@@ -12531,19 +17883,18 @@ Synopsis:
\address@{@var{senders address}@}
@end example
-Specifies the return address as it appears on the letter and on the
+Specify the return address, as it appears on the letter and on the
envelope. Separate multiple lines in @var{senders address} with a
-double backslash@tie{}@code{\\}.
+double backslash,@tie{}@code{\\}.
Because it can apply to multiple letters this declaration is often put
in the preamble. However, it can go anywhere, including inside an
individual @code{letter} environment.
-This command is optional: without the @code{\address} declaration the
-letter is formatted with some blank space on top, for copying onto
-pre-printed letterhead paper. (@xref{Overview}, for details on your
-local implementation.) With the @code{\address} declaration, it is
-formatted as a personal letter.
+This command is optional: if you do not use it then the letter is
+formatted with some blank space on top, for copying onto pre-printed
+letterhead paper. If you do use the @code{\address} declaration then it
+is formatted as a personal letter.
Here is an example.
@@ -12562,14 +17913,14 @@ Here is an example.
Synopsis:
@example
-\cc@{@var{first name} \\
+\cc@{@var{name0} \\
... @}
@end example
Produce a list of names to which copies of the letter were sent. This
command is optional. If it appears then typically it comes after
-@code{\closing}. Separate multiple lines with a double
-backslash@tie{}@code{\\}, as in:
+@code{\closing}. Put the names on different lines by separating them
+with a double backslash, @code{\\}, as in:
@example
\cc@{President \\
@@ -12590,8 +17941,8 @@ Synopsis:
\closing@{@var{text}@}
@end example
-Usually at the end of a letter, above the handwritten signature, there
-is a @code{\closing} (although this command is optional). For example,
+Produce the letter's closing. This is optional, but usual. It appears
+at the end of a letter, above a handwritten signature. For example:
@example
\closing@{Regards,@}
@@ -12613,11 +17964,11 @@ Synopsis:
Produce a list of things included with the letter. This command is
optional; when it is used, it typically is put after @code{\closing}.
-Separate multiple lines with a double backslash@tie{}@code{\\}.
+Separate multiple lines with a double backslash, @code{\\}.
@example
\encl@{License \\
- Passport @}
+ Passport@}
@end example
@@ -12632,7 +17983,7 @@ Synopsis:
\location@{@var{text}@}
@end example
-The @var{text} appears centered at the bottom of the each page. It only
+The @var{text} appears centered at the bottom of the page. It only
appears if the page style is @code{firstpage}.
@@ -12644,26 +17995,64 @@ appears if the page style is @code{firstpage}.
Synopsis:
@example
-\makelabels
+\makelabels % in preamble
@end example
-Create a sheet of address labels from the recipient addresses, one for
-each letter. This sheet will be output before the letters, with the idea
-that you can copy it to a sheet of peel-off labels. This command goes
-in the preamble.
+Optional, for a document that contains @code{letter} environments. If
+you just put @code{\makelabels} in the preamble then at the end of the
+document you will get a sheet with labels for all the recipients, one
+for each letter environment, that you can copy to a sheet of peel-off
+address labels.
Customize the labels by redefining the commands @code{\startlabels},
-@code{\mlabel}, and @code{\returnaddress} in the preamble. The command
-@code{\startlabels} sets the width, height, number of columns, etc., of
-the page onto which the labels are printed. The command
-@code{\mlabel@{@var{sender address}@}@{@var{recipient address}@}}
-produces the two labels (or one, if you choose to ignore the @var{sender
-address}). The @var{sender address} is the value returned by the macro
-@code{\returnaddress} while @var{recipient address} is the value passed
-in the argument to the @code{letter} environment. By default
-@code{\mlabel} ignores the first argument, the @var{sender address}.
-
-@c xxx TODO, align on latex2e-fr.texi, see https://mail.gna.org/public/latexrefman-discuss/2015-10/msg00000.html
+@code{\mlabel}, and @code{\returnaddress} (and perhaps @code{\name}) in
+the preamble. The command @code{\startlabels} sets the width, height,
+number of columns, etc., of the page onto which the labels are printed.
+The command @code{\mlabel@{@var{return address}@}@{@var{recipient
+address}@}} produces the two labels (or one, if you choose to ignore the
+@var{return address}) for each letter environment. The first argument,
+@var{return address}, is the value returned by the macro
+@code{\returnaddress}. The second argument, @var{recipient address}, is
+the value passed in the argument to the @code{letter} environment. By
+default @code{\mlabel} ignores the first argument, the @var{return
+address}, causing the default behavior described in the prior paragraph.
+
+This illustrates customization. Its output includes a page with two
+columns having two labels each.
+
+@example
+\documentclass@{letter@}
+\renewcommand*@{\returnaddress@}@{Fred McGuilicuddy \\
+ Oshkosh, Mineola 12305@}
+\newcommand*\originalMlabel@{@}
+\let\originalMlabel\mlabel
+\def\mlabel#1#2@{\originalMlabel@{@}@{#1@}\originalMlabel@{@}@{#2@}@}
+\makelabels
+ ...
+\begin@{document@}
+\begin@{letter@}@{A Einstein \\
+ 112 Mercer Street \\
+ Princeton, New Jersey, USA 08540@}
+ ...
+\end@{letter@}
+\begin@{letter@}@{K G\"odel \\
+ 145 Linden Lane \\
+ Princeton, New Jersey, USA 08540@}
+ ...
+\end@{letter@}
+\end@{document@}
+@end example
+
+@noindent
+The first column contains the return address twice. The second column
+contains the address for each recipient.
+
+@PkgIndex{envlab}
+The package @code{envlab} makes formatting the labels easier, with
+standard sizes already provided. The preamble lines
+@code{\usepackage[personalenvelope]@{envlab@}} and @code{\makelabels}
+are all that you need to print envelopes.
+
@node \name
@section @code{\name}
@@ -12676,8 +18065,8 @@ Synopsis:
\name@{@var{name}@}
@end example
-Sender's name, used for printing on the envelope together with the
-return address.
+Optional. Sender's name, used for printing on the envelope together
+with the return address.
@node \opening
@@ -12689,12 +18078,11 @@ return address.
Synopsis:
@example
-\opening@{@var{text}@}
+\opening@{@var{salutation}@}
@end example
-This command is required. It starts a letter, following the
-@code{\begin@{letter@}@{...@}}. The mandatory argument @var{text} is the
-text that starts your letter. For instance:
+Required. Follows the @code{\begin@{letter@}@{...@}}. The argument
+@var{salutation} is mandatory. For instance:
@example
\opening@{Dear John:@}
@@ -12735,10 +18123,10 @@ Synopsis:
The sender's name. This command is optional, although its inclusion is
usual.
-The argument text appears at the end of the letter, after the closing
-and after a vertical space for the traditional hand-written
+The argument text appears at the end of the letter, after the closing.
+@LaTeX{} leaves some vertical space for a handwritten
signature. Separate multiple lines with a double
-backslash@tie{}@code{\\}. For example:
+backslash,@tie{}@code{\\}. For example:
@example
\signature@{J Fred Muggs \\
@@ -12747,16 +18135,24 @@ backslash@tie{}@code{\\}. For example:
@LaTeX{}'s default for the vertical space from the @code{\closing} text
down to the @code{\signature} text is @code{6\medskipamount}, which is
-six times 0.7@dmn{em}.
+six times @code{\medskipamount} (where @code{\medskipamount} is equal to
+a @code{\parskip}, which in turn is defined by default here to
+0.7@dmn{em}).
This command is usually in the preamble, to apply to all the letters in
the document. To have it apply to one letter only, put it inside a
@code{letter} environment and before the @code{\closing}.
-You can include a graphic in the signature, for instance with
-@code{\signature@{\vspace@{-6\medskipamount@}\includegraphics@{sig.png@}\\
-My name@}} (this requires writing @code{\usepackage@{graphicx@}} in the
-preamble).
+You can include a graphic in the signature as here.
+
+@example
+\signature@{\vspace@{-6\medskipamount@}\includegraphics@{sig.png@}\\
+ My name@}
+@end example
+
+@noindent
+For this you must put @code{\usepackage@{graphicx@}} in the preamble
+(@pxref{Graphics}).
@c I think this is not a user-level command; it is used to keep from breaking
@@ -12807,27 +18203,69 @@ page.
@node \typein
-@section @code{\typein[@var{cmd}]@{@var{msg}@}}
+@section @code{\typein}
@findex \typein
-Synopsis:
+Synopsis, one of:
+
+@example
+\typein@{@var{prompt-msg}@}
+\typein[@var{cmd}]@{@var{prompt-msg}@}
+@end example
+
+Print @var{prompt-msg} on the terminal and cause @LaTeX{} to stop and
+wait for you to type a line of input. This line of input ends when you
+hit the return key.
+
+For example, this
+
+@example
+As long as I live I shall never forget \typein@{Enter student name:@}
+@end example
+
+@noindent
+coupled with this command line interaction
@example
-\typein[\@var{cmd}]@{@var{msg}@}
+Enter student name:
+
+\@@typein=Aphra Behn
+@end example
+
+@noindent
+gives the output @samp{... never forget Aphra Behn}.
+
+The first command version, @code{\typein@{@var{prompt-msg}@}}, causes
+the input you typed to be processed as if it had been included in the
+input file in place of the @code{\typein} command.
+
+In the second command version the optional argument @code{@var{cmd}}
+argument must be a command name --- it must begin with a backslash, \.
+This command name is then defined or redefined to be the input that you
+typed. For example, this
+
+@example
+\typein[\student]@{Enter student name:@}
+\typeout@{Recommendation for \student .@}
+@end example
+
+@noindent
+gives this output on the command line,
+
+@example
+Enter student name:
+
+\student=John Dee
+Recommendation for John Dee.
@end example
-@code{\typein} prints @var{msg} on the terminal and causes @LaTeX{} to
-stop and wait for you to type a line of input, ending with return. If
-the optional @code{\@var{cmd}} argument is omitted, the typed input is
-processed as if it had been included in the input file in place of the
-@code{\typein} command. If the @code{\@var{cmd}} argument is present, it
-must be a command name. This command name is then defined or
-redefined to be the typed input.
+@noindent
+where the user has entered @samp{John Dee.}
@node \typeout
-@section @code{\typeout@{@var{msg}@}}
+@section @code{\typeout}
@findex \typeout
@@ -12837,16 +18275,37 @@ Synopsis:
\typeout@{@var{msg}@}
@end example
-Prints @code{msg} on the terminal and in the @code{log} file.
-Commands in @code{msg} that are defined with @code{\newcommand} or
+Print @code{msg} on the terminal and in the @code{log} file.
+
+This
+
+@example
+\newcommand@{\student@}@{John Dee@}
+\typeout@{Recommendation for \student .@}
+@end example
+
+@noindent
+outputs @samp{Recommendation for John Dee}. Like what happens here with
+@code{\student}, commands that are defined with @code{\newcommand} or
@code{\renewcommand} (among others) are replaced by their definitions
before being printed.
@LaTeX{}'s usual rules for treating multiple spaces as a single space
-and ignoring spaces after a command name apply to @code{msg}. A
-@code{\space} command in @code{msg} causes a single space to be
-printed, independent of surrounding spaces. A @code{^^J} in
-@code{msg} prints a newline.
+and ignoring spaces after a command name apply to @code{msg}. As above,
+use the command @code{\space} to get a single space, independent of
+surrounding spaces. Use @code{^^J} to get a newline. Get a percent
+character with @code{\csname @@percentchar\endcsname}.
+
+This command can be useful for simple debugging, as here:
+
+@example
+\newlength@{\jhlength@}
+\setlength@{\jhlength@}@{5pt@}
+\typeout@{The length is \the\jhlength.@}
+@end example
+
+@noindent
+produces on the command line @samp{The length is 5.0pt}.
@node Command line
@@ -12854,31 +18313,281 @@ printed, independent of surrounding spaces. A @code{^^J} in
@cindex command line
-@findex .tex, @r{default extension}
-The input file specification indicates the file to be formatted;
-@TeX{} uses @file{.tex} as a default file extension. If you omit the
-input file entirely, @TeX{} accepts input from the terminal. You can
-also specify arbitrary @LaTeX{} input by starting with a backslash.
-For example, this processes @file{foo.tex} without pausing after every
-error:
+Synopsis (from a terminal command line):
+
+@example
+pdflatex @var{options} @var{argument}
+@end example
+
+Run @LaTeX{} on @var{argument}. In place of @command{pdflatex} you can
+also use @command{xelatex}, or @code{lualatex}, or @code{dviluatex}, or
+@code{latex}.
+
+For example, this will run @LaTeX{} on the file @file{thesis.tex},
+creating the output @file{thesis.pdf}.
@example
-latex '\nonstopmode\input foo.tex'
+pdflatex thesis
@end example
+@noindent
+@findex .tex, @r{default extension}
+Note that @file{.tex} is the default file extension.
+
+pdf@TeX{} is a development of the original @TeX{} program, as are
+Xe@TeX{} and Lua@TeX{} (@pxref{@TeX{} engines}). They are completely
+backward compatible. But the original program had a custom output
+format, DVI, while the newer ones can output directly to PDF. This
+allows them to take advantage of the extra features in PDF such as
+hyperlinks, support for modern image formats such as JPG and PNG, and
+ubiquitous viewing programs. In short, if you run @command{pdflatex} or
+@command{xelatex} or @command{lualatex} then you will by default get PDF
+and have access to all its modern features. If you run @command{latex},
+or @code{dvilualatex}, then you will get DVI. The description here
+assumes pdf@LaTeX{}.
+
+@xref{Command line options}, for a selection of the most useful
+command line options. As to @var{argument}, the usual case is that it
+does not begin with a backslash, so the system takes it to be the name
+of a file and it compiles that file. If @var{argument} begins with a
+backslash then the system will interpret it as a line of @LaTeX{}
+input, which can be used for special effects (@pxref{Command line
+input}).
+
+If you gave no arguments or options then @command{pdflatex} prompts for
+input from the terminal. You can escape from this by entering
+@code{<control>-D}.
+
+If @LaTeX{} finds an error in your document then by default it stops and
+asks you about it. @xref{Recovering from errors} for an outline of what
+to do.
+
+@menu
+* Command line options:: Read text from the terminal.
+* Command line input:: Write text to the terminal.
+* Recovering from errors:: When something goes wrong.
+@end menu
+
+
+@node Command line options
+@section Command line options
+
+@cindex options, command line
+
+These are the command-line options relevant to ordinary document
+authoring. For a full list, try running @samp{latex --help} from the
+command line.
+
+With many implementations you can specify command line options by
+prefixing them with @samp{-} or @samp{--}. This is the case for
+both @TeX{} Live (and Mac@TeX{}) and MiK@TeX{}. We will use both
+conventions interchangeably.
+
+@table @code
+@findex --version @r{command-line option}
+@item -version
+Show the current version, like @samp{pdfTeX 3.14159265-2.6-1.40.16 (TeX
+Live 2015/Debian)} along with a small amount of additional information,
+and exit.
+
@findex --help @r{command-line option}
-With many, but not all, implementations, command-line options can also
-be specified in the usual Unix way, starting with @samp{-} or
-@samp{--}. For a list of those options, try @samp{latex --help}.
+@item -help
+Give a brief usage message that is useful as a prompt and exit.
+
+@findex --interaction @r{command-line option}
+@item -interaction=@var{mode}
+@TeX{} compiles a document in one of four interaction modes:
+@code{batchmode}, @code{nonstopmode}, @code{scrollmode},
+@code{errorstopmode}. In @dfn{errorstop mode} (the default), @TeX{}
+stops at each error and asks for user intervention. In @dfn{batch
+mode} it prints nothing on the terminal, errors are scrolled as if the
+user hit @code{<return>} at every error, and missing files cause the
+job to abort. In @dfn{nonstop mode}, diagnostic message appear on the
+terminal but as in batch mode there is no user interaction. In
+@dfn{scroll mode}, @TeX{} only stops for missing files or keyboard
+input.
+
+For instance, starting @LaTeX{} with this command line
+
+@example
+pdflatex -interaction=batchmode @var{filename}
+@end example
+
+@noindent
+eliminates most terminal output.
+
+@findex --jobname @r{command-line option}
+@item -jobname=@var{string}
+Set the value of @TeX{}'s @code{jobname} to the string. The log file
+and output file will then be named @file{@var{string}.log} and
+@file{@var{string}.pdf}.
+
+When you run @code{@command{pdflatex} @var{options} @var{argument}}, if
+@var{argument} does not start with a backslash then @TeX{} considers it
+the name of a file to input. Otherwise it waits for the first
+@code{\input} instruction and the name of the input file will be the job
+name. This is used to name the log file the output file. This option
+overrides that process and directly specifies the name. @xref{Command
+line input} for an example of its use.
+
+@findex --output-directory @r{command-line option}
+@item -output-directory=@var{directory}
+Write files in the directory @var{directory}. It must already exist.
+
+@findex --shell-escape @r{command-line option}
+@findex --no-shell-escape @r{command-line option}
+@findex --enable-write18 @r{command-line option}
+@findex --disable-write18 @r{command-line option}
+@item shell-escape
+@itemx no-shell-escape
+@itemx enable-write18
+@itemx disable-write18
+Enable or disable @code{\write18@{@var{shell command}@}}. The first two
+options are for with @TeX{} Live or Mac@TeX{} while the second two are
+for MiK@TeX{}.
+
+@PkgIndex{sagetex}
+Sometimes you want to run external system commands from inside a
+@LaTeX{} file. For instance the package @file{sagetex} allows you to
+have the mathematics software system @i{Sage} do calculations or draw
+graphs and then incorporate that output in your document. For this
+@TeX{} provides the @code{\write18} command.
+
+But with this functionality enabled, security issues could happen if you
+compiled a @LaTeX{} file from the Internet. By default @code{\write18}
+is disabled. (More precisely, by default @TeX{} Live, Mac@TeX{}, and
+MiK@TeX{} only allow the execution of a limited number of @TeX{}-related
+programs, which they distribute.)
+
+If you invoke @LaTeX{} with the option @code{no-shell-escape}, and in
+your document you call @code{\write18@{ls -l@}}, then you do not get an
+error but the log file says @samp{runsystem(ls -l)...disabled}.
+
+@findex --halt-on-error @r{command-line option}
+@item -halt-on-error
+Stop processing at the first error.
+
+@findex --file-line-error @r{command-line option}
+@findex --no-file-line-error @r{command-line option}
+@item -file-line-error
+@item -no-file-line-error
+Enable or disable @code{@var{filename}:@var{lineno}:@var{error}}-style
+error messages. These are only available with @TeX{} Live or Mac@TeX{}.
+@end table
+
+
+@node Command line input
+@section Command line input
+
+@cindex input, on command line
+
+As part of the command line invocation @code{pdflatex @var{options}
+@var{argument}} you can specify arbitrary @LaTeX{} input by starting
+@var{argument} with a backslash. This allows you to do some special
+effects.
+
+@PkgIndex{hyperref}
+For example, this file (which uses the @file{hyperref} package for
+hyperlinks) can produce two kinds of output, one for paper and one for a
+PDF.
+
+@example
+\ifdefined\paperversion % in preamble
+\newcommand@{\urlcolor@}@{black@}
+\else
+\newcommand@{\urlcolor@}@{blue@}
+\fi
+\usepackage[colorlinks=true,urlcolor=\urlcolor]@{hyperref@}
+ ...
+\href@{https://www.ctan.org@}@{CTAN@} % in body
+ ...
+@end example
+
+@noindent
+Compiling this document @file{book.tex} with the command line
+@code{pdflatex test} will give the @samp{CTAN} link in blue. But
+compiling it with @code{pdflatex "\def\paperversion@{@}\input test.tex"}
+has the link in black. (Note the use of double quotes to prevent
+interpretation of the symbols by the command line shell; your system may
+do this differently.)
+
+In a similar way, from the single file @file{main.tex} you can compile
+two different versions.
+
+@c credit Paul Gaborit: https://tex.stackexchange.com/a/220101/121234
+@example
+pdflatex -jobname=students "\def\student@{@}\input@{main@}"
+pdflatex -jobname=teachers "\def\teachers@{@}\input@{main@}"
+@end example
+
+@noindent
+The @code{jobname} option is there because otherwise both files would be
+called @file{main.pdf} and the second would overwrite the first.
+
+A final example. This loads the package @file{graphicx} with the option
+@code{draft}
+
+@c credit Herbert Voss: https://tex.stackexchange.com/a/17236/121234
+@example
+pdflatex -jobname=aa "\RequirePackage[draft]@{graphicx@}\input@{aa.tex@}"
+@end example
+
+@noindent
+so the graphic files are read for their size information but not
+incorporated into the PDF. (The @code{jobname} option is needed because
+otherwise the output file would be @file{graphicx.pdf}, as
+@code{\RequirePackage} does an @code{\input} of its own.)
+
+
+@node Recovering from errors
+@section Recovering from errors
+
+If @LaTeX{} finds an error in your document then it gives you an error
+message and prompts you with a question mark, @code{?}. For instance,
+running @LaTeX{} on this file
+
+@example
+\newcommand@{\NP@}@{\ensuremath@{\textbf@{NP@}@}@}
+The \PN@{@} problem is a million dollar one.
+@end example
+
+@noindent
+causes it show this, and wait for input.
+
+@example
+! Undefined control sequence.
+l.5 The \PN
+ @{@} problem is a million dollar one.
+?
+@end example
+
+@noindent
+The simplest thing is to enter @samp{x} and @code{<return>} and fix the
+typo. You could instead enter @samp{?} and @code{<return>} to see other
+options.
@cindex @samp{*} prompt
@cindex prompt, @samp{*}
@findex \stop
-If @LaTeX{} stops in the middle of the document and gives you a
-@samp{*} prompt, it is waiting for input. You can type @code{\stop}
-(and return) and it will prematurely end the document.
+There are two other error scenarios. The first is that you forgot to
+include the @code{\end@{document@}} or misspelled it. In this case
+@LaTeX{} gives you a @samp{*} prompt. You can get back to the command
+line by typing @code{\stop} and @code{<return>}.
+
+The last scenario is that you mistyped the file name. For instance,
+instead of @code{pdflatex test} you might type @code{pdflatex tste}.
+
+@example
+! I can't find file `tste'.
+<*> tste
+
+(Press Enter to retry, or Control-D to exit)
+Please type another input file name:
+@end example
-@xref{@TeX{} engines}, for other system commands invoking @LaTeX{}.
+@noindent
+The simplest thing is to enter @code{<Contol>} and @samp{d} (holding
+them down at the same time), and just fix the command line.
@node Document templates
@@ -12893,7 +18602,9 @@ be useful. Additional template resources are listed at
@menu
* beamer template::
+* article template::
* book template::
+* Larger book template::
* tugboat template::
@end menu
@@ -12935,11 +18646,39 @@ One web resource for this:
@url{http://robjhyndman.com/hyndsight/beamer/}.
+@node article template
+@section @code{article} template
+
+@cindex template, @code{article}
+
+@verbatim
+\documentclass{article}
+\title{Article Class Template}
+\author{Alex Author}
+
+\begin{document}
+\maketitle
+
+\section{First section}
+Some text.
+
+\subsection{First section, first subsection}
+Additional text.
+
+\section{Second section}
+Some more text.
+\end{document}
+@end verbatim
+
+
@node book template
@section @code{book} template
@cindex template, @code{book}
+This is a straightforward template for a book. See @xref{Larger book
+template} for a more elaborate one.
+
@verbatim
\documentclass{book}
\title{Book Class Template}
@@ -12960,6 +18699,62 @@ The end.
@end verbatim
+@node Larger book template
+@section Larger @code{book} template
+
+@cindex template, @code{book}
+
+This is a more elaborate template for a book. It has
+@code{\frontmatter}, @code{\mainmatter}, and @code{\backmatter} to
+control the typography of the three main areas of a book
+(@pxref{\frontmatter & \mainmatter & \backmatter}). The book has a
+bibliography and an index.
+
+Notable is that it uses @code{\include} and @code{\includeonly}
+(@pxref{Splitting the input}). While you are working on a chapter you
+can comment out all the other chapter entries from the argument to
+@code{\includeonly}. That will speed up compilation without losing any
+information such as cross-references. (Material that does not need to
+come on a new page is brought in with @code{\input} instead of
+@code{\include}. You don't get the cross-reference benefit this way.)
+
+@verbatim
+\documentclass[titlepage]{book}
+\usepackage{makeidx}\makeindex
+
+\title{Book Class Template}
+\author{Alex Author}
+
+\includeonly{%
+ frontcover,
+ preface,
+ chap1,
+ ...
+ }
+\begin{document}
+\frontmatter
+\include{frontcover}
+ % maybe comment out while drafting:
+\maketitle \input{dedication} \input{copyright}
+\tableofcontents
+\include{preface}
+\mainmatter
+\include{chap1}
+...
+\appendix
+\include{appena}
+...
+\backmatter
+\bibliographystyle{apalike}
+\addcontentsline{toc}{chapter}{Bibliography}
+\bibliography
+\addcontentsline{toc}{chapter}{Index}
+\printindex
+\include{backcover}
+\end{document}
+@end verbatim
+
+
@node tugboat template
@section @code{tugboat} template
@@ -13053,16 +18848,13 @@ Email \verb|tugboat@tug.org| if problems or questions.
@end verbatim
-@node Concept Index
-@unnumbered Concept Index
+@node Index
+@unnumbered Index
-@printindex cp
+@c Keep `Command Index' working for ltx-help.el.
+@anchor{Command Index}
-@c The name of the `Command Index' node must NOT be altered for ltx-help.el.
-@node Command Index
-@unnumbered Command Index
-
-@printindex fn
+@printindex cp
@bye
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.txt b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.txt
index f113d9386bf..ba93e97513a 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.txt
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.txt
@@ -28,8 +28,7 @@ LaTeX2e: An unofficial reference manual
27 Terminal input/output
28 Command line
Appendix A Document templates
-Concept Index
-Command Index
+Index
LaTeX2e: An unofficial reference manual
1 About this document
2 Overview of LaTeX
@@ -39,8 +38,9 @@ LaTeX2e: An unofficial reference manual
2.4 LaTeX command syntax
2.4.1 Environments
2.4.2 Command declarations
- 2.4.3 '\makeatletter' and '\makeatother'
+ 2.4.3 '\makeatletter' & '\makeatother'
2.4.3.1 '\@ifstar'
+ 2.5 CTAN: Comprehensive TeX Archive Network
3 Document classes
3.1 Document class options
3.2 Additional packages
@@ -59,11 +59,18 @@ LaTeX2e: An unofficial reference manual
5.5 Page layout parameters
5.6 Floats
6 Sectioning
- 6.1 '\@startsection'
+ 6.1 '\part'
+ 6.2 '\chapter'
+ 6.3 '\section'
+ 6.4 '\subsection'
+ 6.5 '\subsubsection', '\paragraph', '\subparagraph'
+ 6.6 '\appendix'
+ 6.7 '\frontmatter', '\mainmatter', '\backmatter'
+ 6.8 '\@startsection'
7 Cross references
7.1 '\label'
- 7.2 '\pageref{KEY}'
- 7.3 '\ref{KEY}'
+ 7.2 '\pageref'
+ 7.3 '\ref'
8 Environments
8.1 'abstract'
8.2 'array'
@@ -91,21 +98,23 @@ LaTeX2e: An unofficial reference manual
8.17 'math'
8.18 'minipage'
8.19 'picture'
- 8.19.1 '\circle'
- 8.19.2 '\makebox'
- 8.19.3 '\framebox'
- 8.19.4 '\dashbox'
- 8.19.5 '\frame'
- 8.19.6 '\line'
- 8.19.7 '\linethickness'
+ 8.19.1 '\put'
+ 8.19.2 '\multiput'
+ 8.19.3 '\qbezier'
+ 8.19.4 '\graphpaper'
+ 8.19.5 '\line'
+ 8.19.6 '\linethickness'
+ 8.19.7 '\thinlines'
8.19.8 '\thicklines'
- 8.19.9 '\thinlines'
- 8.19.10 '\multiput'
- 8.19.11 '\oval'
- 8.19.12 '\put'
- 8.19.13 '\shortstack'
- 8.19.14 '\vector'
- 8.20 'quotation' and 'quote'
+ 8.19.9 '\circle'
+ 8.19.10 '\oval'
+ 8.19.11 '\shortstack'
+ 8.19.12 '\vector'
+ 8.19.13 '\makebox' (picture)
+ 8.19.14 '\framebox' (picture)
+ 8.19.15 '\frame'
+ 8.19.16 '\dashbox'
+ 8.20 'quotation' & 'quote'
8.21 'tabbing'
8.22 'table'
8.23 'tabular'
@@ -129,99 +138,109 @@ LaTeX2e: An unofficial reference manual
9.3 '\newline'
9.4 '\-' (discretionary hyphen)
9.5 '\discretionary' (generalized hyphenation point)
- 9.6 '\fussy'
- 9.7 '\sloppy'
- 9.8 '\hyphenation'
- 9.9 '\linebreak' & '\nolinebreak'
+ 9.6 '\fussy' & '\sloppy'
+ 9.6.1 'sloppypar'
+ 9.7 '\hyphenation'
+ 9.8 '\linebreak' & '\nolinebreak'
10 Page breaking
- 10.1 '\cleardoublepage'
- 10.2 '\clearpage'
- 10.3 '\newpage'
- 10.4 '\enlargethispage'
- 10.5 '\pagebreak' & '\nopagebreak'
+ 10.1 '\clearpage' & '\cleardoublepage'
+ 10.2 '\newpage'
+ 10.3 '\enlargethispage'
+ 10.4 '\pagebreak' & '\nopagebreak'
11 Footnotes
11.1 '\footnote'
11.2 '\footnotemark'
11.3 '\footnotetext'
- 11.4 Footnotes in a table
- 11.5 Footnotes in section headings
+ 11.4 Footnotes in section headings
+ 11.5 Footnotes in a table
11.6 Footnotes of footnotes
- 11.7 Multiple references to footnotes
- 11.8 Footnote parameters
12 Definitions
12.1 '\newcommand' & '\renewcommand'
12.2 '\providecommand'
12.3 '\newcounter': Allocating a counter
- 12.4 '\newlength': Allocating a length
- 12.5 '\newsavebox': Allocating a box
+ 12.4 '\newlength'
+ 12.5 '\newsavebox'
12.6 '\newenvironment' & '\renewenvironment'
12.7 '\newtheorem'
- 12.8 '\newfont': Define a new font (obsolete)
+ 12.8 '\newfont'
12.9 '\protect'
12.10 '\ignorespaces & \ignorespacesafterend'
13 Counters
13.1 '\alph \Alph \arabic \roman \Roman \fnsymbol': Printing counters
- 13.2 '\usecounter{COUNTER}'
- 13.3 '\value{COUNTER}'
- 13.4 '\setcounter{COUNTER}{VALUE}'
- 13.5 '\addtocounter{COUNTER}{VALUE}'
- 13.6 '\refstepcounter{COUNTER}'
- 13.7 '\stepcounter{COUNTER}'
- 13.8 '\day \month \year': Predefined counters
+ 13.2 '\usecounter'
+ 13.3 '\value'
+ 13.4 '\setcounter'
+ 13.5 '\addtocounter'
+ 13.6 '\refstepcounter'
+ 13.7 '\stepcounter'
+ 13.8 '\day' & '\month' & '\year'
14 Lengths
14.1 Units of length
14.2 '\setlength'
14.3 '\addtolength'
14.4 '\settodepth'
14.5 '\settoheight'
- 14.6 '\settowidth{\LEN}{TEXT}'
- 14.7 Predefined lengths
+ 14.6 '\settowidth'
15 Making paragraphs
- 15.1 '\indent'
- 15.2 '\noindent'
- 15.3 '\parskip'
+ 15.1 '\par'
+ 15.2 '\indent' & '\noindent'
+ 15.3 '\parindent' & '\parskip'
15.4 Marginal notes
16 Math formulas
16.1 Subscripts & superscripts
16.2 Math symbols
+ 16.2.1 Blackboard bold
+ 16.2.2 Calligraphic
+ 16.2.3 '\boldmath' & '\unboldmath'
+ 16.2.4 Dots, horizontal or vertical
16.3 Math functions
16.4 Math accents
- 16.5 Spacing in math mode
- 16.6 Math miscellany
+ 16.5 Over- and Underlining
+ 16.6 Spacing in math mode
+ 16.7 Math miscellany
+ 16.7.1 Colon character ':' & '\colon'
+ 16.7.2 '\*'
+ 16.7.3 '\frac'
+ 16.7.4 '\left' & '\right'
+ 16.7.5 '\sqrt'
+ 16.7.6 '\stackrel'
17 Modes
17.1 '\ensuremath'
18 Page styles
18.1 '\maketitle'
18.2 '\pagenumbering'
18.3 '\pagestyle'
- 18.4 '\thispagestyle{STYLE}'
+ 18.4 '\thispagestyle'
19 Spaces
- 19.1 '\hspace'
- 19.2 '\hfill'
- 19.3 '\spacefactor'
- 19.3.1 '\(SPACE)' and '\@'
- 19.3.2 '\frenchspacing'
- 19.3.3 '\normalsfcodes'
- 19.4 '\ ' after control sequence
- 19.5 '\thinspace': Insert 1/6em
- 19.6 '\/': Insert italic correction
- 19.7 '\hrulefill \dotfill'
- 19.8 '\addvspace'
- 19.9 '\bigskip \medskip \smallskip'
- 19.10 '\vfill'
- 19.11 '\vspace{LENGTH}'
+ 19.1 '\enspace' & '\quad' & '\qquad'
+ 19.2 '\hspace'
+ 19.3 '\hfill'
+ 19.4 '\hss'
+ 19.5 '\spacefactor'
+ 19.5.1 '\@'
+ 19.5.2 '\frenchspacing'
+ 19.5.3 '\normalsfcodes'
+ 19.6 Backslash-space, '\ '
+ 19.7 '~'
+ 19.8 '\thinspace' & '\negthinspace'
+ 19.9 '\/'
+ 19.10 '\hrulefill' & '\dotfill'
+ 19.11 '\bigskip' & '\medskip' & '\smallskip'
+ 19.12 '\bigbreak' & '\medbreak' & '\smallbreak'
+ 19.13 '\strut'
+ 19.14 '\vspace'
+ 19.15 '\vfill'
+ 19.16 '\addvspace'
20 Boxes
- 20.1 '\mbox{TEXT}'
- 20.2 '\fbox' and '\framebox'
- 20.3 'lrbox'
- 20.4 '\makebox'
- 20.5 '\parbox'
- 20.6 '\raisebox'
- 20.7 '\savebox'
- 20.8 '\sbox{\BOXCMD}{TEXT}'
- 20.9 '\usebox{\BOXCMD}'
+ 20.1 '\mbox' & '\makebox'
+ 20.2 '\fbox' & '\framebox'
+ 20.3 '\parbox'
+ 20.4 '\raisebox'
+ 20.5 '\sbox' & '\savebox'
+ 20.6 'lrbox'
+ 20.7 '\usebox'
21 Color
- 21.1 Color package options
+ 21.1 'color' package options
21.2 Color models
21.3 Commands for color
21.3.1 Define colors
@@ -229,8 +248,8 @@ LaTeX2e: An unofficial reference manual
21.3.3 Colored boxes
21.3.4 Colored pages
22 Graphics
- 22.1 Graphics package options
- 22.2 Graphics package configuration
+ 22.1 'graphics' package options
+ 22.2 'graphics' package configuration
22.2.1 '\graphicspath'
22.2.2 '\DeclareGraphicsExtensions'
22.2.3 '\DeclareGraphicsRule'
@@ -249,15 +268,21 @@ LaTeX2e: An unofficial reference manual
23.7 '\rule'
23.8 '\today'
24 Splitting the input
- 24.1 '\include'
- 24.2 '\includeonly'
+ 24.1 '\endinput'
+ 24.2 '\include' & '\includeonly'
24.3 '\input'
25 Front/back matter
- 25.1 Tables of contents
+ 25.1 Table of contents etc.
25.1.1 '\addcontentsline'
25.1.2 '\addtocontents'
- 25.2 Glossaries
- 25.3 Indexes
+ 25.1.3 '\nofiles'
+ 25.2 Indexes
+ 25.2.1 '\index'
+ 25.2.2 'makeindex'
+ 25.2.3 '\printindex'
+ 25.3 Glossaries
+ 25.3.1 '\newglossaryentry'
+ 25.3.2 '\gls'
26 Letters
26.1 '\address'
26.2 '\cc'
@@ -271,19 +296,23 @@ LaTeX2e: An unofficial reference manual
26.10 '\signature'
26.11 '\telephone'
27 Terminal input/output
- 27.1 '\typein[CMD]{MSG}'
- 27.2 '\typeout{MSG}'
+ 27.1 '\typein'
+ 27.2 '\typeout'
28 Command line
+ 28.1 Command line options
+ 28.2 Command line input
+ 28.3 Recovering from errors
Appendix A Document templates
A.1 'beamer' template
- A.2 'book' template
- A.3 'tugboat' template
-Concept Index
-Command Index
+ A.2 'article' template
+ A.3 'book' template
+ A.4 Larger 'book' template
+ A.5 'tugboat' template
+Index
LaTeX2e: An unofficial reference manual
***************************************
-This document is an unofficial reference manual (version of March 2018)
+This document is an unofficial reference manual (version of July 2018)
for LaTeX2e, a document preparation system.
1 About this document
@@ -292,9 +321,9 @@ for LaTeX2e, a document preparation system.
This is an unofficial reference manual for the LaTeX2e document
preparation system, which is a macro package for the TeX typesetting
program (*note Overview::). This document's home page is
-<http://puszcza.gnu.org.ua/software/latexrefman/>. That page has links
-to the current output in various formats, sources, mailing list archives
-and subscriptions, and other infrastructure.
+<puszcza.gnu.org.ua/software/latexrefman>. That page has links to the
+current output in various formats, sources, mailing list archives and
+subscriptions, and other infrastructure.
In this document, we will mostly just use 'LaTeX' rather than
'LaTeX2e', since the previous version of LaTeX (2.09) was frozen decades
@@ -359,26 +388,30 @@ plain text, write it as 'LaTeX'.
=======================
LaTeX files have a simple global structure, with a standard beginning
-and ending. Here is a "hello, world" example:
+and ending. This is a small example.
\documentclass{article}
\begin{document}
Hello, \LaTeX\ world.
\end{document}
-Here, the 'article' is the so-called "document class", implemented in a
-file 'article.cls'. Any document class can be used. A few document
-classes are defined by LaTeX itself, and vast array of others are widely
-available. *Note Document classes::.
+Every LaTeX document has a '\begin{document}' line and an
+'\end{document}' line.
+
+Here, the 'article' is the "document class". It is implemented in a
+file 'article.cls'. You can use any document class on your system. A
+few document classes are defined by LaTeX itself, and vast array of
+others are widely available. *Note Document classes::.
You can include other LaTeX commands between the '\documentclass' and
the '\begin{document}' commands. This area is called the "preamble".
- The '\begin{document} ... \end{document}' is a so-called
+ The '\begin{document}', '\end{document}' pair defines an
"environment"; the 'document' environment (and no others) is required in
-all LaTeX documents (*note document::). LaTeX provides many
-environments itself, and many more are defined separately. *Note
-Environments::.
+all LaTeX documents (*note document::). LaTeX make available to you
+many environments that are documented here (*note Environments::). Many
+more are available to you from external packages, most importantly those
+available at CTAN (*note CTAN::).
The following sections discuss how to produce PDF or other output
from a LaTeX input file.
@@ -386,7 +419,7 @@ from a LaTeX input file.
2.2 Output files
================
-LaTeX produces a main output file and at least two accessory files. The
+LaTeX produces a main output file and at least two auxiliary files. The
main output file's name ends in either '.dvi' or '.pdf'.
'.dvi'
@@ -426,15 +459,15 @@ main output file's name ends in either '.dvi' or '.pdf'.
LaTeX may produce yet more files, characterized by the filename
ending. These include a '.lof' file that is used to make a list of
figures, a '.lot' file used to make a list of tables, and a '.toc' file
-used to make a table of contents. A particular class may create others;
-the list is open-ended.
+used to make a table of contents (*note Table of contents etc.::). A
+particular class may create others; the list is open-ended.
2.3 TeX engines
===============
LaTeX is defined to be a set of commands that are run by a TeX
implementation (*note Overview::). This section gives a terse overview
-of the main programs.
+of the main programs (see also *note Command line::).
'latex'
'pdflatex'
@@ -530,7 +563,7 @@ behavior. For instance, for poetry in LaTeX put the lines between
...
\end{verse}
- See *note Environments:: for a list of environments.
+ *Note Environments:: for a list of environments.
The ENVIRONMENT NAME at the beginning must exactly match that at the
end. This includes the case where ENVIRONMENT NAME ends in a
@@ -552,8 +585,8 @@ A command that changes the value, or changes the meaning, of some other
command or parameter. For instance, the '\mainmatter' command changes
the setting of page numbers from roman numerals to arabic.
-2.4.3 '\makeatletter' and '\makeatother'
-----------------------------------------
+2.4.3 '\makeatletter' & '\makeatother'
+--------------------------------------
Synopsis:
@@ -590,10 +623,9 @@ a letter.
<http://ctan.org/pkg/macros2e>. These macros are mainly intended to
package or class authors.
- The example below is typical. In the user's class file is a command
-'\thesis@universityname'. The user wants to change the definition.
-These three lines should go in the preamble, before the
-'\begin{document}'.
+ In this example the class file has a command '\thesis@universityname'
+that the user wants to change. These three lines should go in the
+preamble, before the '\begin{document}'.
\makeatletter
\renewcommand{\thesis@universityname}{Saint Michael's College}
@@ -605,8 +637,8 @@ These three lines should go in the preamble, before the
Synopsis:
\newcommand{\mycmd}{\@ifstar{\mycmd@star}{\mycmd@nostar}}
- \newcommand{\mycmd@nostar}[NON-STARRED COMMAND NUMBER OF ARGS]{BODY OF NON-STARRED COMMAND}
- \newcommand{\mycmd@star}[STARRED COMMAND NUMBER OF ARGS]{BODY OF STARRED COMMAND}
+ \newcommand{\mycmd@nostar}[NOSTAR-NUM-ARGS]{NOSTAR-BODY}
+ \newcommand{\mycmd@star}[STAR-NUM-ARGS]{STAR-BODY}
Many standard LaTeX environments or commands have a variant with the
same name but ending with a star character '*', an asterisk. Examples
@@ -625,7 +657,7 @@ the synopsis these two are '\mycmd@nostar' and '\mycmd@star'. They
could take the same number of arguments or a different number, or no
arguments at all. As always, in a LaTeX document a command using
at-sign '@' must be enclosed inside a '\makeatletter ... \makeatother'
-block (*note \makeatletter and \makeatother::).
+block (*note \makeatletter & \makeatother::).
This example of '\@ifstar' defines the command '\ciel' and a variant
'\ciel*'. Both have one required argument. A call to '\ciel{night}'
@@ -637,14 +669,15 @@ not blue sky".
\newcommand*{\ciel}{\@ifstar{\ciel@starred}{\ciel@unstarred}}
In the next example, the starred variant takes a different number of
-arguments than does the unstarred one. With this definition, Agent
-007's '``My name is \agentsecret*{Bond}, \agentsecret{James}{Bond}.'''
-is equivalent to '``My name is \textsc{Bond}, \textit{James}
-textsc{Bond}.'''
+arguments than the unstarred one. With this definition, Agent 007's
+'``My name is \agentsecret*{Bond}, \agentsecret{James}{Bond}.''' is
+equivalent to entering the commands '``My name is \textsc{Bond},
+\textit{James} textsc{Bond}.'''
\newcommand*{\agentsecret@unstarred}[2]{\textit{#1} \textsc{#2}}
\newcommand*{\agentsecret@starred}[1]{\textsc{#1}}
- \newcommand*{\agentsecret}{\@ifstar{\agentsecret@starred}{\agentsecret@unstarred}}
+ \newcommand*{\agentsecret}{%
+ \@ifstar{\agentsecret@starred}{\agentsecret@unstarred}}
There are two sometimes more convenient ways to accomplish the work
of '\@ifstar'. The 'suffix' package allows the construct
@@ -657,6 +690,32 @@ the 'xparse' package that allows this code.
{UNSTARRED VERSION}%
}
+2.5 CTAN: Comprehensive TeX Archive Network
+===========================================
+
+The Comprehensive TeX Archive Network, CTAN, is the TeX and LaTeX
+community's repository of free material. It is a set of Internet sites
+around the world that offer material related to LaTeX for download.
+Visit CTAN on the web at <https://ctan.org>.
+
+ This material is organized into packages, discrete bundles that
+typically offer some coherent functionality and are maintained by one
+person or a small number of people. For instance, many publishers have
+a package that allows authors to format papers to that publisher's
+specifications.
+
+ In addition to the massive holdings, the web site offers features
+such as search by name or by functionality.
+
+ CTAN is not a single site, but instead is a set of sites. One of the
+sites is the core. This site actively manages the material, for
+instance, by accepting uploads of new or updated packages. It is hosted
+by the German TeX group DANTE e.V. Other sites around the world help out
+by mirroring, that is, automatically syncing their collections with the
+core site and then in turn making their copies publicly available. This
+gives users close to their location better access and relieves the load
+on the core site. The list of mirrors is at <https://ctan.org/mirrors>.
+
3 Document classes
******************
@@ -694,9 +753,9 @@ document classes are available as separate packages; *note Overview::.)
3.1 Document class options
==========================
-You can specify so-called "global options" or "class options" to the
+You can specify "global options" or "class options" to the
'\documentclass' command by enclosing them in square brackets. To
-specify more than one OPTION, separate them with a comma, as in:
+specify more than one OPTION, separate them with a comma.
\documentclass[OPTION1,OPTION2,...]{CLASS}
@@ -823,11 +882,11 @@ SMC Math Department' is for a class.
Inside of a class or package file you can use the at-sign '@' as a
character in command names without having to surround the code
containing that command with '\makeatletter' and '\makeatother'. *Note
-\makeatletter and \makeatother::. This allow you to create commands
-that users will not accidentally redefine. Another technique is to
-preface class- or package-specific commands with some string to prevent
-your class or package from interfering with others. For instance, the
-class 'smcmemo' might have commands '\smc@tolist', '\smc@fromlist', etc.
+\makeatletter & \makeatother::. This allow you to create commands that
+users will not accidentally redefine. Another technique is to preface
+class- or package-specific commands with some string to prevent your
+class or package from interfering with others. For instance, the class
+'smcmemo' might have commands '\smc@tolist', '\smc@fromlist', etc.
3.3.1 Class and package structure
---------------------------------
@@ -863,7 +922,7 @@ file.
\ProcessOptions\relax
\LoadClass{article}
- It identifies itself, handles the class options via the default of
+It identifies itself, handles the class options via the default of
passing them all to the 'article' class, and then loads the 'article'
class to provide the basis for this class's code.
@@ -936,11 +995,11 @@ These are the commands designed to help writers of classes or packages.
'\DeclareOption{OPTION}{CODE}'
'\DeclareOption*{CODE}'
- Make an option available to a user, for invoking in their
+ Make an option available to a user to invoke in their
'\documentclass' command. For example, the 'smcmemo' class could
- have an option allowing users to put the institutional logo on the
- first page with '\documentclass[logo]{smcmemo}'. The class file
- must contain '\DeclareOption{logo}{CODE}' (and later,
+ have an option '\documentclass[logo]{smcmemo}' allowing users to
+ put the institutional logo on the first page. The class file must
+ contain '\DeclareOption{logo}{CODE}' (and later,
'\ProcessOptions').
If you request an option that has not been declared, by default
@@ -980,10 +1039,11 @@ These are the commands designed to help writers of classes or packages.
and the command is used within a moving argument, use
'\newcommand'.
- The 'etoolbox' package offers commands '\newrobustcmd',
- '\newrobustcmd*', '\renewrobustcmd', '\renewrobustcmd*',
- '\providerobustcmd', and '\providerobustcmd*' which are similar to
- '\newcommand', '\newcommand*', '\renewcommand', '\renewcommand*',
+ The 'etoolbox' package offers the commands '\newrobustcmd',
+ '\newrobustcmd*', as well as the commands '\renewrobustcmd',
+ '\renewrobustcmd*', and the commands '\providerobustcmd', and
+ '\providerobustcmd*'. These are similar to '\newcommand',
+ '\newcommand*', '\renewcommand', '\renewcommand*',
'\providecommand', and '\providecommand*', but define a robust CMD
with two advantages as compared to '\DeclareRobustCommand':
1. They use the low-level e-TeX protection mechanism rather than
@@ -997,12 +1057,15 @@ These are the commands designed to help writers of classes or packages.
'\IfFileExists{FILE NAME}{TRUE CODE}{FALSE CODE}'
'\InputIfFileExists{FILE NAME}{TRUE CODE}{FALSE CODE}'
- Execute TRUE CODE if LaTeX can find the file 'FILE NAME' and FALSE
- CODE otherwise. In the second case it inputs the file immediately
- after executing TRUE CODE. Thus
- '\IfFileExists{img.pdf}{\includegraphics{img.pdf}}{\typeout{WARNING:
- img.pdf not found}}' will include the graphic 'img.pdf' if it is
- found but otherwise just give a warning.
+ Execute TRUE CODE if LaTeX finds the file 'FILE NAME' or FALSE CODE
+ otherwise. In the first case it executing TRUE CODE and then
+ inputs the file. Thus the command
+
+ \IfFileExists{img.pdf}{%
+ \includegraphics{img.pdf}}{\typeout{!! img.pdf not found}
+
+ will include the graphic 'img.pdf' if it is found and otherwise
+ give a warning.
This command looks for the file in all search paths that LaTeX
uses, not only in the current directory. To look only in the
@@ -1024,9 +1087,11 @@ These are the commands designed to help writers of classes or packages.
If you request a RELEASE DATE and the date of the package installed
on your system is earlier, then you get a warning on the screen and
- in the log like 'You have requested, on input line 4, version
- `2038/01/19' of document class article, but only version
- `2014/09/29 v1.4h Standard LaTeX document class' is available.'
+ in the log like this.
+
+ You have requested, on input line 4, version `2038/01/19' of
+ document class article, but only version `2014/09/29 v1.4h
+ Standard LaTeX document class' is available.
The command version '\LoadClassWithOptions' uses the list of
options for the current class. This means it ignores any options
@@ -1058,8 +1123,10 @@ These are the commands designed to help writers of classes or packages.
features, include the optional FORMAT DATE on which those features
were implemented. If present it must be in the form 'YYYY/MM/DD'.
If the format version installed on your system is earlier than
- FORMAT DATE then you get a warning like 'You have requested release
- `2038/01/20' of LaTeX, but only release `2016/02/01' is available.'
+ FORMAT DATE then you get a warning like this.
+
+ You have requested release `2038/01/20' of LaTeX, but only
+ release `2016/02/01' is available.
'\OptionNotUsed'
Adds the current option to the list of unused options. Can only be
@@ -1081,17 +1148,20 @@ These are the commands designed to help writers of classes or packages.
If your own code is bringing in a package twice then you can
collapse that to once, for example replacing the two
- '\RequirePackage[landscape]{geometry}\RequirePackage[margins=1in]{geometry}'
- with the single '\RequirePackage[landscape,margins=1in]{geometry}'.
- But if you are loading a package that in turn loads another package
- then you need to queue up the options you desire for this other
- package. For instance, suppose the package 'foo' loads the package
- 'geometry'. Instead of
- '\RequirePackage{foo}\RequirePackage[draft]{graphics}' you must
- write '\PassOptionsToPackage{draft}{graphics}
- \RequirePackage{foo}'. (If 'foo.sty' loads an option in conflict
- with what you want then you may have to look into altering its
- source.)
+ '\RequirePackage[landscape]{geometry}' and
+ '\RequirePackage[margins=1in]{geometry}' with the single command
+ '\RequirePackage[landscape,margins=1in]{geometry}'.
+
+ However, imagine that you are loading 'firstpkg' and inside that
+ package it loads 'secondpkg', and you need the second package to be
+ loaded with option 'draft'. Then before doing the first package
+ you must queue up the options for the second package, like this.
+
+ \PassOptionsToPackage{draft}{secondpkg}
+ \RequirePackage{firstpkg}
+
+ (If 'firstpkg.sty' loads an option in conflict with what you want
+ then you may have to alter its source.)
These commands are useful for general users as well as class and
package writers. For instance, suppose a user wants to load the
@@ -1143,31 +1213,33 @@ These are the commands designed to help writers of classes or packages.
Identifies the class or package, printing a message to the screen
and the log file.
- When a user writes '\documentclass{smcmemo}' then LaTeX loads the
- file 'smcmemo.cls'. Similarly, a user writing '\usepackage{test}'
- prompts LaTeX to load the file 'test.sty'. If the name of the file
- does not match the declared class or package name then you get a
- warning. Thus, if you invoke '\documentclass{smcmemo}', and the
- file 'smcmemo.cls' has the statement '\ProvidesClass{xxx}' then you
- get a warning like 'You have requested document class `smcmemo',
- but the document class provides 'xxx'.' This warning does not
- prevent LaTeX from processing the rest of the class file normally.
-
- If you include the optional argument, then you must include the
- date, before the first space if any, and it must have the form
- 'YYYY/MM/DD'. The rest of the optional argument is free-form,
- although it traditionally identifies the class, and is written to
- the screen during compilation and to the log file. Thus, if your
- file 'smcmemo.cls' contains the line
- '\ProvidesClass{smcmemo}[2008/06/01 v1.0 SMC memo class]' and your
- document's first line is '\documentclass{smcmemo}' then you will
- see 'Document Class: smcmemo 2008/06/01 v1.0 SMC memo class'.
+ When you load a class or package, for example with
+ '\documentclass{smcmemo}' or '\usepackage{test}', LaTeX inputs a
+ file. If the name of the file does not match the class or package
+ name declared in it then you get a warning. Thus, if you invoke
+ '\documentclass{smcmemo}', and the file 'smcmemo.cls' has the
+ statement '\ProvidesClass{xxx}' then you get a warning like 'You
+ have requested document class `smcmemo', but the document class
+ provides 'xxx'.' This warning does not prevent LaTeX from
+ processing the rest of the class file normally.
+
+ If you include the optional argument then you must include a date,
+ before any spaces, of the form 'YYYY/MM/DD'. The rest of the
+ optional argument is free-form, although it traditionally
+ identifies the class, and is written to the screen during
+ compilation and to the log file. Thus, if your file 'smcmemo.cls'
+ contains the line '\ProvidesClass{smcmemo}[2008/06/01 v1.0 SMC memo
+ class]' and your document's first line is '\documentclass{smcmemo}'
+ then you will see 'Document Class: smcmemo 2008/06/01 v1.0 SMC memo
+ class'.
The date in the optional argument allows class and package users to
- ask to be warned if the version of the class or package installed
- on their system is earlier than RELEASE DATE, by using the optional
- arguments such as '\documentclass{smcmemo}[2018/10/12]' or
- '\usepackage{foo}[[2017/07/07]]'. (Note that package users only
+ ask to be warned if the version of the class or package is earlier
+ than RELEASE DATE. For instance, a user could enter
+ '\documentclass{smcmemo}[2018/10/12]' or
+ '\usepackage{foo}[[2017/07/07]]' to require a class or package with
+ certain features by specifying that it must be released no earlier
+ than the given date. (Although, in practice package users only
rarely include a date, and class users almost never do.)
'\ProvidesFile{FILE NAME}[ADDITIONAL INFORMATION]'
@@ -1180,11 +1252,10 @@ These are the commands designed to help writers of classes or packages.
'\RequirePackage[OPTION LIST]{PACKAGE NAME}[RELEASE DATE]'
'\RequirePackageWithOptions{PACKAGE NAME}[RELEASE DATE]'
- Load a package, like the document author command '\usepackage'.
- *Note Additional packages::. An example is
- '\RequirePackage[landscape,margin=1in]{geometry}'. Note that the
- LaTeX development team strongly recommends use of these commands
- over Plain TeX's '\input'; see the Class Guide.
+ Load a package, like the command '\usepackage' (*note Additional
+ packages::). The LaTeX development team strongly recommends use of
+ these commands over Plain TeX's '\input'; see the Class Guide. An
+ example is '\RequirePackage[landscape,margin=1in]{geometry}'.
The OPTION LIST, if present, is a comma-separated list. The
RELEASE DATE, if present, must have the form YYYY/MM/DD. If the
@@ -1217,26 +1288,26 @@ style. The LaTeX commands for doing this are described here.
The following type style commands are supported by LaTeX.
- This first group of commands is typically used with an argument, as
-in '\textit{TEXT}'. In the table below, the corresponding command in
-parenthesis is the "declaration form", which takes no arguments, as in
-'{\itshape TEXT}'. The scope of the declaration form lasts until the
-next type style command or the end of the current group.
+ In the table below the listed commands, the '\text...' commands, is
+used with an argument, as in '\textit{TEXT}'. This is the preferred
+form. But shown after it, in parenthesis, is the corresponding
+declaration form, which is sometimes useful. This form takes no
+arguments, as in '{\itshape TEXT}'. The scope of the declaration form
+lasts until the next type style command or the end of the current group.
+In addition, each has an environment form such as
+'\begin{itshape}...\end{itshape}'.
These commands, in both the argument form and the declaration form,
-are cumulative; e.g., you can say either '\sffamily\bfseries' or
-'\bfseries\sffamily' to get bold sans serif.
+are cumulative; for instance you can get bold sans serif by saying
+either of '\sffamily\bfseries' or '\bfseries\sffamily'.
- You can alternatively use an environment form of the declarations;
-for instance, '\begin{ttfamily}...\end{ttfamily}'.
-
- These font-switching commands automatically insert italic corrections
-if needed. (*Note \/::, for the details of italic corrections.)
-Specifically, they insert the italic correction unless the following
-character is in the list '\nocorrlist', which by default consists of a
-period and a comma. To suppress the automatic insertion of italic
-correction, use '\nocorr' at the start or end of the command argument,
-such as '\textit{\nocorr text}' or '\textsc{text \nocorr}'.
+ One advantage of these commands is that they automatically insert
+italic corrections if needed (*note \/::). Specifically, they insert
+the italic correction unless the following character is in the list
+'\nocorrlist', which by default consists of a period and a comma. To
+suppress the automatic insertion of italic correction, use '\nocorr' at
+the start or end of the command argument, such as '\textit{\nocorr
+text}' or '\textsc{text \nocorr}'.
'\textrm (\rmfamily)'
Roman.
@@ -1275,9 +1346,13 @@ TEXT} END TEXT}' will result in the START TEXT and END TEXT in italics,
but MIDDLE TEXT will be in roman.
LaTeX also provides the following commands, which unconditionally
-switch to the given style, that is, are _not_ cumulative. Also, they
-are used differently than the above commands: '{\CMD...}' instead of
-'\CMD{...}'. These are two unrelated constructs.
+switch to the given style, that is, are _not_ cumulative. They are used
+as declarations: '{\CMD...}' instead of '\CMD{...}'.
+
+ (The unconditional commands below are an older version of font
+switching. The earlier commands are an improvement in most
+circumstances. But sometimes an unconditional font switch is precisely
+what you want.)
'\bf'
Switch to bold face.
@@ -1305,12 +1380,6 @@ are used differently than the above commands: '{\CMD...}' instead of
The '\em' command is the unconditional version of '\emph'.
- (Some people consider the unconditional font-switching commands, such
-as '\tt', obsolete and that only the cumulative commands ('\texttt')
-should be used. Others think that both sets of commands have their
-place and sometimes an unconditional font switch is precisely what you
-want; for one example, *note 'description': description.)
-
The following commands are for use in math mode. They are not
cumulative, so '\mathbf{\mathit{SYMBOL}}' does not create a boldface and
italic SYMBOL; instead, it will just be in italics. This is because
@@ -1362,23 +1431,32 @@ table shows the command name and the corresponding actual font size used
(in points) with the '10pt', '11pt', and '12pt' document size options,
respectively (*note Document class options::).
-Command '10pt' '11pt' '12pt'
---------------------------------------------------
-'\tiny' 5 6 6
-'\scriptsize' 7 8 8
-'\footnotesize' 8 9 10
-'\small' 9 10 10.95
-'\normalsize' (default) 10 10.95 12
-'\large' 12 12 14.4
-'\Large' 14.4 14.4 17.28
-'\LARGE' 17.28 17.28 20.74
-'\huge' 20.74 20.74 24.88
-'\Huge' 24.88 24.88 24.88
-
- The commands as listed here are "declaration forms". The scope of
-the declaration form lasts until the next type style command or the end
-of the current group. You can also use the environment form of these
-commands; for instance, '\begin{tiny}...\end{tiny}'.
+Command '10pt' '11pt' '12pt'
+--------------------------------------------------------
+'\tiny' 5 6 6
+'\scriptsize' 7 8 8
+'\footnotesize' 8 9 10
+'\small' 9 10 10.95
+'\normalsize' (default) 10 10.95 12
+'\large' 12 12 14.4
+'\Large' 14.4 14.4 17.28
+'\LARGE' 17.28 17.28 20.74
+'\huge' 20.74 20.74 24.88
+'\Huge' 24.88 24.88 24.88
+
+ The commands are listed here in declaration forms. You use them by
+declaring them, as with this example.
+
+ \begin{quotation} \small
+ The Tao that can be named is not the eternal Tao.
+ \end{quotation}
+
+The scope of the '\small' lasts until the end of the 'quotation'
+environment. It would also end at the next type style command or the
+end of the current group, so you could enclose it in extra curly braces
+'{\small We are here, we are here, we are here!}'. You can instead use
+the environment form of these commands; for instance,
+'\begin{tiny}...\end{tiny}'.
4.3 Low-level font commands
===========================
@@ -1401,7 +1479,7 @@ ones.
Select the font family. The web page
<http://www.tug.dk/FontCatalogue/> provides one way to browse
through many of the fonts easily used with LaTeX. Here are
- examples of some common families:
+ examples of some common families.
'pag' Avant Garde
'fvs' Bitstream Vera Sans
@@ -1530,11 +1608,14 @@ Commands for controlling the general page layout.
5.1 '\onecolumn'
================
-Start a new page and produce single-column output. If the document is
-given the class option 'onecolumn' then this is the default behavior
-(*note Document class options::).
+Synopsis:
+
+ \onecolumn
- This command is fragile (*note \protect::).
+ Start a new page and produce single-column output. If the document
+is given the class option 'onecolumn' then this is the default behavior
+(*note Document class options::). This command is fragile (*note
+\protect::).
5.2 '\twocolumn'
================
@@ -1546,13 +1627,11 @@ Synopses:
Start a new page and produce two-column output. If the document is
given the class option 'twocolumn' then this is the default (*note
-Document class options::).
+Document class options::). This command is fragile (*note \protect::).
If the optional PRELIM ONE COLUMN TEXT argument is present, it is
typeset in one-column mode before the two-column typesetting starts.
- This command is fragile (*note \protect::).
-
These parameters control typesetting in two-column output:
'\columnsep'
@@ -1599,8 +1678,7 @@ following parameters control float behavior of two-column output.
* Increase the value of '\dbltopfraction' to a suitably large
number, to avoid going to float pages so soon.
- You can redefine it, for instance with
- '\renewcommand{\dbltopfraction}{0.9}'.
+ You can redefine it, as with '\renewcommand{\dbltopfraction}{0.9}'.
'\dblfloatpagefraction'
For a float page of two-column wide floats, this is the minimum
@@ -1756,13 +1834,13 @@ option (*note Document class options::).
'\paperheight'
The height of the paper, as distinct from the height of the print
- area. It is normally set with a document class option, as in
+ area. Normally set with a document class option, as in
'\documentclass[a4paper]{article}' (*note Document class
options::).
'\paperwidth'
The width of the paper, as distinct from the width of the print
- area. It is normally set with a document class option, as in
+ area. Normally set with a document class option, as in
'\documentclass[a4paper]{article}' (*note Document class
options::).
@@ -1794,6 +1872,7 @@ option (*note Document class options::).
specified width, and revert to their normal values at the end of
the 'minipage' or '\parbox'.
+'\hsize'
This entry is included for completeness: '\hsize' is the TeX
primitive parameter used when text is broken into lines. It should
not be used in normal LaTeX documents.
@@ -1919,7 +1998,7 @@ BETWEEN 0 AND 1}'):
floats; default '.7'.
Parameters relating to vertical space around floats (change them with
-'\setlength{PARAMETER}{LENGTH EXPRESSION}'):
+a command of the form '\setlength{PARAMETER}{LENGTH EXPRESSION}'):
'\floatsep'
Space between floats at the top or bottom of a page; default '12pt
@@ -1935,7 +2014,7 @@ BETWEEN 0 AND 1}'):
default '20pt plus2pt minus4pt'.
Counters relating to the number of floats on a page (change them with
-'\setcounter{CTRNAME}{NATURAL NUMBER}'):
+a command of the form '\setcounter{CTRNAME}{NATURAL NUMBER}'):
'bottomnumber'
Maximum number of floats that can appear at the bottom of a text
@@ -1963,57 +2042,498 @@ LaTeX?" (<http://latex-project.org/papers/tb111mitt-float.pdf>).
6 Sectioning
************
-Sectioning commands provide the means to structure your text into units:
+Structure your text into divisions: parts, chapters, sections, etc. All
+sectioning commands have the same form, one of:
+
+ SECTIONING-COMMAND{TITLE}
+ SECTIONING-COMMAND*{TITLE}
+ SECTIONING-COMMAND[TOC-TITLE]{TITLE}
+
+For instance, declare the start of a subsection as with
+'\subsection{Motivation}'.
+
+ The table has each SECTIONING-COMMAND in LaTeX. All are available in
+all of LaTeX's standard document classes 'book', 'report',
+and 'article', except that '\chapter' is not available in 'article'.
+
+Sectioning unit Command Level
+--------------------------------------------------------------------
+Part '\part' -1 ('book', 'report'), 0
+ ('article')
+Chapter '\chapter' 0
+Section '\section' 1
+Subsection '\subsection' 2
+Subsubsection '\subsubsection' 3
+Paragraph '\paragraph' 4
+Subparagraph '\subparagraph' 5
+
+ All these commands have a '*'-form that prints TITLE as usual but is
+not numbered and does not make an entry in the table of contents. An
+example of using this is for an appendix in an 'article' . The input
+'\appendix\section{Appendix}' gives the output 'A Appendix' (*note
+\appendix::). You can lose the numbering 'A' by instead entering
+'\section*{Appendix}' (articles often omit a table of contents and have
+simple page headers so the other differences from the '\section' command
+may not matter).
+
+ The section title TITLE provides the heading in the main text, but it
+may also appear in the table of contents and in the running head or foot
+(*note Page styles::). You may not want the same text in these places
+as in the main text. All of these commands have an optional argument
+TOC-TITLE for these other places.
+
+ The level number in the table above determines which sectional units
+are numbered, and which appear in the table of contents. If the
+sectioning command's LEVEL is less than or equal to the value of the
+counter 'secnumdepth' then the titles for this sectioning command will
+be numbered (*note Sectioning/secnumdepth::). And, if LEVEL is less
+than or equal to the value of the counter 'tocdepth' then the table of
+contents will have an entry for this sectioning unit (*note
+Sectioning/tocdepth::).
+
+ LaTeX expects that before you have a '\subsection' you will have a
+'\section' and, in a book, that before a '\section' you will have a
+'\chapter'. Otherwise you can get a something like a subsection
+numbered '3.0.1'.
+
+ Two counters relate to the appearance of sectioning commands.
+
+'secnumdepth'
+ Controls which sectioning commands are numbered. Suppress
+ numbering of sectioning at any depth greater than LEVEL
+ '\setcounter{secnumdepth}{LEVEL}' (*note \setcounter::). See the
+ above table for the level numbers. For instance, if the
+ 'secnumdepth' is 1 in an 'article' then a '\section{Introduction}'
+ command will produce output like '1 Introduction' while
+ '\subsection{Discussion}' will produce output like 'Discussion',
+ without the number. LaTeX's default 'secnumdepth' is 3 in
+ 'article' class and 2 in the 'book' and 'report' classes.
+
+'tocdepth'
+ Controls which sectioning units are listed in the table of
+ contents. The setting '\setcounter{tocdepth}{LEVEL}' makes the
+ sectioning units at LEVEL be the smallest ones listed (*note
+ \setcounter::). See the above table for the level numbers. For
+ instance, if 'tocdepth' is 1 then the table of contents will list
+ sections but not subsections. LaTeX's default 'secnumdepth' is 3
+ in 'article' class and 2 in the 'book' and 'report' classes.
+
+6.1 '\part'
+===========
-'\part'
-'\chapter'
- ('report' and 'book' class only)
-'\section'
-'\subsection'
-'\subsubsection'
-'\paragraph'
-'\subparagraph'
+Synopsis, one of:
- All sectioning commands take the same general form, e.g.,
+ \part{TITLE}
+ \part*{TITLE}
+ \part[TOC-TITLE]{TITLE}
+
+ Start a document part. The standard LaTeX classes 'book', 'report',
+and 'article', all have this command.
+
+ This produces a document part, in a book.
+
+ \part{VOLUME I \\
+ PERSONAL MEMOIRS OF U.\ S.\ GRANT}
+ \chapter{ANCESTRY--BIRTH--BOYHOOD.}
+ My family is American, and has been for generations,
+ in all its branches, direct and collateral.
+
+ In each standard class the '\part' command outputs a part number such
+as 'Part I', alone on its line, in boldface, and in large type. Then
+LaTeX outputs TITLE, also alone on its line, in bold and in even larger
+type. In class 'book', the LaTeX default puts each part alone on its
+own page. If the book is two-sided then LaTeX will skip a page if
+needed to have the new part on an odd-numbered page. In 'report' it is
+again alone on a page, but LaTeX won't force it onto an odd-numbered
+page. In an 'article' LaTeX does not put it on a fresh page, but
+instead outputs the part number and part title onto the main document
+page.
- \chapter[TOCTITLE]{TITLE}
+ The '*' form shows TITLE but it does not show the part number, does
+not increment the 'part' counter, and produces no table of contents
+entry.
- In addition to providing the heading TITLE in the main text, the
-section title can appear in two other places:
+ The optional argument TOC-TITLE will appear as the part title in the
+table of contents (*note Table of contents etc.::) and in running
+headers (*note Page styles::). If it is not present then TITLE will be
+there. This example puts a line break in TITLE but leaves out the break
+in the table of contents.
- 1. The table of contents.
- 2. The running head at the top of the page.
+ \part[Up from the bottom; my life]{Up from the bottom\\ my life}
- You may not want the same text in these places as in the main text.
-To handle this, the sectioning commands have an optional argument
-TOCTITLE that, when given, specifies the text for these other places.
+ For determining which sectional units are numbered and which appear
+in the table of contents, the level number of a part is -1 (*note
+Sectioning/secnumdepth:: and *note Sectioning/tocdepth::).
- Also, all sectioning commands have '*'-forms that print TITLE as
-usual, but do not include a number and do not make an entry in the table
-of contents. For instance:
+ In the class 'article', if a paragraph immediately follows the part
+title then it is not indented. To get an indent you can use the package
+'indentfirst'.
- \section*{Preamble}
+ One package to change the behavior of '\part' is 'titlesec'. See its
+documentation on CTAN.
- The '\appendix' command changes the way following sectional units are
-numbered. The '\appendix' command itself generates no text and does not
-affect the numbering of parts. The normal use of this command is
-something like
+6.2 '\chapter'
+==============
- \chapter{A Chapter}
- ...
+Synopsis, one of:
+
+ \chapter{TITLE}
+ \chapter*{TITLE}
+ \chapter[TOC-TITLE]{TITLE}
+
+ Start a chapter. The standard LaTeX classes 'book' and 'report' have
+this command but 'article' does not.
+
+ This produces a chapter.
+
+ \chapter{Loomings}
+ Call me Ishmael.
+ Some years ago---never mind how long precisely---having little or no
+ money in my purse, and nothing particular to interest me on shore, I
+ thought I would sail about a little and see the watery part of
+ the world.
+
+ The LaTeX default starts each chapter on a fresh page, an
+odd-numbered page if the document is two-sided. It produces a chapter
+number such as 'Chapter 1' in large boldface type (the size is '\huge').
+It then puts TITLE on a fresh line, in boldface type that is still
+larger (size '\Huge'). It also increments the 'chapter' counter, adds
+an entry to the table of contents (*note Table of contents etc.::), and
+sets the running header information (*note Page styles::).
+
+ The '*' form shows TITLE on a fresh line, in boldface. But it does
+not show the chapter number, does not increment the 'chapter' counter,
+produces no table of contents entry, and does not affect the running
+header. (If you use the page style 'headings' in a two-sided document
+then the header will be from the prior chapter.) This example
+illustrates.
+
+ \chapter*{Preamble}
+
+ The optional argument TOC-TITLE will appear as the chapter title in
+the table of contents (*note Table of contents etc.::) and in running
+headers (*note Page styles::). If it is not present then TITLE will be
+there. This shows the full name in the chapter title,
+
+ \chapter[Weyl]{Hermann Klaus Hugo (Peter) Weyl (1885--1955)}
+
+but only 'Weyl' on the contents page. This puts a line break in the
+title but that doesn't work well with running headers so it omits the
+break in the contents
+
+ \chapter[Given it all\\ my story]{Given it all\\ my story}
+
+ For determining which sectional units are numbered and which appear
+in the table of contents, the level number of a chapter is 0 (*note
+Sectioning/secnumdepth:: and *note Sectioning/tocdepth::).
+
+ The paragraph that follows the chapter title is not indented, as is a
+standard typographical practice. To get an indent use the package
+'indentfirst'.
+
+ You can change what is shown for the chapter number. To change it to
+something like 'Lecture 1', put in the preamble either
+'\renewcommand{\chaptername}{Lecture}' or this (*note \makeatletter &
+\makeatother::).
+
+ \makeatletter
+ \renewcommand{\@chapapp}{Lecture}
+ \makeatother
+
+To make this change because of the primary language for the document,
+see the package 'babel'.
+
+ In a two-sided document LaTeX puts a chapter on odd-numbered page, if
+necessary leaving an even-numbered page that is blank except for any
+running headers. To make that page completely blank, see *note
+\clearpage & \cleardoublepage::.
+
+ To change the behavior of the '\chapter' command, you can copy its
+definition from the LaTeX format file and make adjustments. But there
+are also many packages on CTAN that address this. One is 'titlesec'.
+See its documentation, but the example below gives a sense of what it
+can do.
+
+ \usepackage{titlesec} % in preamble
+ \titleformat{\chapter}
+ {\Huge\bfseries} % format of title
+ {} % label, such as 1.2 for a subsection
+ {0pt} % length of separation between label and title
+ {} % before-code hook
+
+This omits the chapter number 'Chapter 1' from the page but unlike
+'\chapter*' it keeps the chapter in the table of contents and the
+running headers.
+
+6.3 '\section'
+==============
+
+Synopsis, one of:
+
+ \section{TITLE}
+ \section*{TITLE}
+ \section[TOC-TITLE]{TITLE}
+
+ Start a section. The standard LaTeX classes 'article', 'book', and
+'report' all have this command.
+
+ This produces a section.
+
+ In this Part we tend to be more interested in the function,
+ in the input-output behavior,
+ than in the details of implementing that behavior.
+
+ \section{Turing machines}
+ Despite this desire to downplay implementation,
+ we follow the approach of A~Turing that the
+ first step toward defining the set of computable functions
+ is to reflect on the details of what mechanisms can do.
+
+ For the standard LaTeX classes 'book' and 'report' the default output
+is like '1.2 TITLE' (for chapter 1, section 2), alone on its line and
+flush left, in boldface and a larger type (the type size is '\Large').
+The same holds in 'article' except that there are no chapters in that
+class so it looks like '2 TITLE'.
+
+ The '*' form shows TITLE. But it does not show the section number,
+does not increment the 'section' counter, produces no table of contents
+entry, and does not affect the running header. (If you use the page
+style 'headings' in a two-sided document then the header will be from
+the prior section.)
+
+ The optional argument TOC-TITLE will appear as the section title in
+the table of contents (*note Table of contents etc.::) and in running
+headers (*note Page styles::). If it is not present then TITLE will be
+there. This shows the full name in the title of the section,
+
+ \section[Elizabeth~II]{Elizabeth the Second,
+ by the Grace of God of the United Kingdom,
+ Canada and Her other Realms and Territories Queen,
+ Head of the Commonwealth, Defender of the Faith.}
+
+but only 'Elizabeth II' on the contents page and in the headers. This
+has a line break in TITLE but that does not work with headers so it is
+omitted from the contents and headers.
+
+ \section[Truth is, I cheated; my life story]{Truth is,
+ I cheated\\my life story}
+
+ For determining which sectional units are numbered and which appear
+in the table of contents, the level number of a section is 1 (*note
+Sectioning/secnumdepth:: and *note Sectioning/tocdepth::).
+
+ The paragraph that follows the section title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package 'indentfirst'.
+
+ In general, to change the behavior of the '\section' command, there
+are a number of options. One is the '\@startsection' command (*note
+\@startsection::). There are also many packages on CTAN that address
+this, including 'titlesec'. See the documentation but the example below
+gives a sense of what they can do.
+
+ \usepackage{titlesec} % in preamble
+ \titleformat{\section}
+ {\normalfont\Large\bfseries} % format of title
+ {\makebox[1pc][r]{\thesection\hspace{1pc}}} % label
+ {0pt} % length of separation between label and title
+ {} % before-code hook
+ \titlespacing*{\section}
+ {-1pc}{18pt}{10pt}[10pc]
+
+That puts the section number in the margin.
+
+6.4 '\subsection'
+=================
+
+Synopsis, one of:
+
+ \subsection{TITLE}
+ \subsection*{TITLE}
+ \subsection[TOC-TITLE]{TITLE}
+
+ Start a subsection. The standard LaTeX classes 'article', 'book',
+and 'report' all have this command.
+
+ This produces a subsection.
+
+ We will show that there are more functions than Turing machines and that
+ therefore some functions have no associated machine.
+
+ \subsection{Cardinality} We will begin with two paradoxes that
+ dramatize the challenge to our intuition posed by comparing the sizes of
+ infinite sets.
+
+ For the standard LaTeX classes 'book' and 'report' the default output
+is like '1.2.3 TITLE' (for chapter 1, section 2, subsection 3), alone on
+its line and flush left, in boldface and a larger type (the type size is
+'\large'). The same holds in 'article' except that there are no
+chapters in that class so it looks like '2.3 TITLE'.
+
+ The '*' form shows TITLE. But it does not show the section number,
+does not increment the 'section' counter, and produces no table of
+contents entry.
+
+ The optional argument TOC-TITLE will appear as the section title in
+the table of contents (*note Table of contents etc.::). If it is not
+present then TITLE will be there. This shows the full name in the title
+of the section,
+
+ \subsection[$\alpha,\beta,\gamma$ paper]{\textit{The Origin of
+ Chemical Elements} by R.A.~Alpher, H.~Bethe, and G.~Gamow}
+
+but only 'U+03B1,U+03B2,U+03B3 paper' on the contents page.
+
+ For determining which sectional units are numbered and which appear
+in the table of contents, the level number of a subsection is 2 (*note
+Sectioning/secnumdepth:: and *note Sectioning/tocdepth::).
+
+ The paragraph that follows the subsection title is not indented, as
+is a standard typographical practice. One way to get an indent is to
+use the package 'indentfirst'.
+
+ There are a number of ways to change the behavior of the
+'\subsection' command. One is the '\@startsection' command (*note
+\@startsection::). There are also many packages on CTAN that address
+this, including 'titlesec'. See the documentation but the example below
+gives a sense of what they can do.
+
+ \usepackage{titlesec} % in preamble
+ \titleformat{\subsection}[runin]
+ {\normalfont\normalsize\bfseries} % format of the title
+ {\thesubsection} % label
+ {0.6em} % space between label and title
+ {} % before-code hook
+
+That puts the subsection number and TITLE in the first line of text.
+
+6.5 '\subsubsection', '\paragraph', '\subparagraph'
+===================================================
+
+Synopsis, one of:
+
+ \subsubsection{TITLE}
+ \subsubsection*{TITLE}
+ \subsubsection[TOC-TITLE]{TITLE}
+
+or one of:
+
+ \paragraph{TITLE}
+ \paragraph*{TITLE}
+ \paragraph[TOC-TITLE]{TITLE}
+
+or one of:
+
+ \subparagraph{TITLE}
+ \subparagraph*{TITLE}
+ \subparagraph[TOC-TITLE]{TITLE}
+
+ Start a subsubsection, paragraph, or subparagraph. The standard
+LaTeX classes 'article', 'book', and 'report' all have these commands,
+although they are not commonly used.
+
+ This produces a subsubsection.
+
+ \subsubsection{Piston ring compressors: structural performance}
+ Provide exterior/interior wall cladding assemblies
+ capable of withstanding the effects of load and stresses from
+ consumer-grade gasoline engine piston rings.
+
+ The default output of each of the three does not change over the
+standard LaTeX classes 'article', 'book', and 'report'. For
+'\subsubsection' the TITLE is alone on its line, in boldface and normal
+size type. For '\paragraph' the TITLE is inline with the text, not
+indented, in boldface and normal size type. For '\subparagraph' the
+TITLE is inline with the text, with a paragraph indent, in boldface and
+normal size type (Because an 'article' has no chapters its
+subsubsections are numbered and so it looks like '1.2.3 TITLE', for
+section 1, subsection 2, and subsubsection 3. The other two divisions
+are not numbered.)
+
+ The '*' form shows TITLE. But it does not increment the associated
+counter and produces no table of contents entry (and does not show the
+number for '\subsubsection').
+
+ The optional argument TOC-TITLE will appear as the division title in
+the table of contents (*note Table of contents etc.::). If it is not
+present then TITLE will be there.
+
+ For determining which sectional units are numbered and which appear
+in the table of contents, the level number of a subsubsection is 3, of a
+paragraph is 4, and of a subparagraph is 5 (*note
+Sectioning/secnumdepth:: and *note Sectioning/tocdepth::).
+
+ The paragraph that follows the subsubsection title is not indented,
+as is a standard typographical practice. One way to get an indent is to
+use the package 'indentfirst'.
+
+ There are a number of ways to change the behavior of the these
+commands. One is the '\@startsection' command (*note \@startsection::).
+There are also many packages on CTAN that address this, including
+'titlesec'. See the documentation on CTAN.
+
+6.6 '\appendix'
+===============
+
+Synopsis:
+
+ \appendix
+
+ This does not directly produce any output. But in a book or report
+it declares that subsequent '\chapter' commands start an appendix. In
+an article it does the same, for '\section' commands. It also resets
+the 'chapter' and 'section' counters to 0 in a book or report, and in an
+article resets the 'section' and 'subsection' counters.
+
+ In this book
+
+ \chapter{One} ...
+ \chapter{Two} ...
+ ...
\appendix
- \chapter{The First Appendix}
+ \chapter{Three} ...
+ \chapter{Four} ...
- The 'secnumdepth' counter controls printing of section numbers. The
-setting
+the first two will generate output numbered 'Chapter 1' and 'Chapter 2'.
+After the '\appendix' the numbering will be 'Appendix A' and 'Appendix
+B'. *Note Larger book template:: for another example.
- \setcounter{secnumdepth}{LEVEL}
+ The 'appendix' package adds the command '\appendixpage' to put a
+separate 'Appendices' in the document body before the first appendix,
+and the command '\addappheadtotoc' to do the same in the table of
+contents. You can reset the name 'Appendix' with a command like
+'\renewcommand{\appendixname}{Specification}', as well as a number of
+other features. See the documentation on CTAN.
-suppresses heading numbers at any depth > LEVEL, where 'chapter' is
-level zero. The default 'secnumdepth' is 3 in LaTeX's 'article' class
-and 2 in the 'book' and 'report' classes. (*Note \setcounter::.)
+6.7 '\frontmatter', '\mainmatter', '\backmatter'
+================================================
+
+Synopsis, one of:
-6.1 '\@startsection'
+ \frontmatter
+ \mainmatter
+ \backmatter
+
+ Format a 'book' class document differently according to which part of
+the document is being produced. All three commands are optional.
+
+ Traditionally, a book's front matter contains such things as the
+title page, an abstract, a table of contents, a preface, a list of
+notations, a list of figures, and a list of tables. (Some of these
+front matter pages, such as the title page, are traditionally not
+numbered.) The back matter may contain such things as a glossary,
+notes, a bibliography, and an index.
+
+ The '\frontmatter' declaration makes the pages numbered in lowercase
+roman, and makes chapters not numbered, although each chapter's title
+appears in the table of contents; if you use other sectioning commands
+here, use the '*'-version (*note Sectioning::). The '\mainmatter'
+changes the behavior back to the expected version, and resets the page
+number. The '\backmatter' leaves the page numbering alone but switches
+the chapters back to being not numbered. *Note Larger book template::
+for an example using the three.
+
+6.8 '\@startsection'
====================
Synopsis:
@@ -2031,9 +2551,23 @@ standard LaTeX 'book' and 'report' classes the commands '\chapter' and
may want to use the '\secdef' command.
Technically, '\@startsection' has the form
- \@startsection{NAME}{LEVEL}{INDENT}{BEFORESKIP}{AFTERSKIP}{STYLE}*[TOCTITLE]{TITLE}
-(the star '*' is optional), so that issuing
- \renewcommand{\section}{\@startsection{NAME}{LEVEL}{INDENT}{BEFORESKIP}{AFTERSKIP}{STYLE}}
+
+ \@startsection{NAME}
+ {LEVEL}
+ {INDENT}
+ {BEFORESKIP}
+ {AFTERSKIP}
+ {STYLE}*[TOCTITLE]{TITLE}
+
+so that issuing
+
+ \renewcommand{\section}{\@startsection{NAME}
+ {LEVEL}
+ {INDENT}
+ {BEFORESKIP}
+ {AFTERSKIP}
+ {STYLE}}
+
redefines '\section' to have the form '\section*[TOCTITLE]{TITLE}' (here
too, the star '*' is optional). *Note Sectioning::. This implies that
when you write a command like '\renewcommand{section}{...}', the
@@ -2043,33 +2577,30 @@ examples below.
NAME
Name of the counter used to number the sectioning header. This
counter must be defined separately. Most commonly this is either
- 'section', 'subsection', or 'paragraph'. Although in those three
- cases the counter name is the same as the sectioning command
- itself, using the same name is not required.
+ 'section', 'subsection', or 'paragraph'. Although in those cases
+ the counter name is the same as the sectioning command itself, you
+ don't have to use the same name.
Then '\the'NAME displays the title number and '\'NAME'mark' is for
the page headers. See the third example below.
LEVEL
- An integer giving the depth of the sectioning command: 0 for
- 'chapter' (only applies to the standard 'book' and 'report'
- classes), 1 for 'section', 2 for 'subsection', 3 for
- 'subsubsection', 4 for 'paragraph', and 5 for 'subparagraph'. In
- the 'book' and 'report' classes 'part' has level -1, while in the
- 'article' class 'part' has level 0.
-
- If LEVEL is less than or equal to the value of 'secnumdepth' then
- the titles for this sectioning command will be numbered. For
- instance, in an 'article', if 'secnumdepth' is 1 then a
- '\section{Introduction}' command will produce output like "1
- Introduction" while '\subsection{Discussion}' will produce output
- like "Discussion", without the number prefix. *Note
- Sectioning/secnumdepth::.
-
- If LEVEL is less than or equal to the value of TOCDEPTH then the
- table of contents will have an entry for this sectioning unit. For
- instance, in an 'article', if TOCDEPTH is 1 then the table of
- contents will list sections but not subsections.
+ An integer giving the depth of the sectioning command. *Note
+ Sectioning:: for the list of standard level numbers.
+
+ If LEVEL is less than or equal to the value of the counter
+ 'secnumdepth' then titles for this sectioning command will be
+ numbered (*note Sectioning/secnumdepth::). For instance, if
+ 'secnumdepth' is 1 in an 'article' then the command
+ '\section{Introduction}' will produce output like "1 Introduction"
+ while '\subsection{Discussion}' will produce output like
+ "Discussion", without the number prefix.
+
+ If LEVEL is less than or equal to the value of the counter TOCDEPTH
+ then the table of contents will have an entry for this sectioning
+ unit (*note Sectioning/tocdepth::). For instance, in an 'article',
+ if TOCDEPTH is 1 then the table of contents will list sections but
+ not subsections.
INDENT
A length giving the indentation of all of the title lines with
@@ -2132,31 +2663,29 @@ STYLE
Controls the styling of the title. See the examples below.
Typical commands to use here are '\centering', '\raggedright',
'\normalfont', '\hrule', or '\newpage'. The last command in STYLE
- may be one such as '\MakeUppercase' or '\fbox' that takes one
- argument. The section title will be supplied as the argument to
- this command. For instance, setting STYLE to
- '\bfseries\MakeUppercase' would produce titles that are bold and
- upper case.
+ may be one that takes one argument, such as '\MakeUppercase' or
+ '\fbox' that takes one argument. The section title will be
+ supplied as the argument to this command. For instance, setting
+ STYLE to '\bfseries\MakeUppercase' would produce titles that are
+ bold and uppercase.
These are LaTeX's defaults for the first three sectioning units that
are defined with '\@startsection', for the 'article', 'book', and
-'report' classes.
-
- 'section' 'subsection' 'subsubsection'
------------------------------------------------------------------------------
-*note NAME: \@startsection/name.sectionsubsection subsubsection
-*note LEVEL: \@startsection/level.12 3
-*note INDENT: \@startsection/indent.'0pt''0pt' '0pt'
-*note BEFORESKIP: \@startsection/beforeskip.'-3.5ex plus -1ex'-3.25ex plus -1ex'-3.25ex plus -1ex
- minus -0.2ex' minus -0.2ex' minus -0.2ex'
-*note AFTERSKIP: \@startsection/afterskip.'2.3ex plus 0.2ex''1.5ex plus 0.2ex''1.5ex plus 0.2ex'
-*note STYLE: \@startsection/style.'\normalfont\Large\bfseries''\normalfont\large\bfseries''\normalfont\normalsize\bfseries'
+'report' classes. For section, the LEVEL is 1, the INDENT is 0pt, the
+BEFORESKIP is '-3.5ex plus -1ex minus -0.2ex', the AFTERSKIP is '2.3ex
+plus 0.2ex', and the STYLE is '\normalfont\Large\bfseries'. For
+subsection, the LEVEL is 2, the INDENT is 0pt, the BEFORESKIP is
+'-3.25ex plus -1ex minus -0.2ex', the AFTERSKIP is '1.5ex plus 0.2ex',
+and the STYLE is '\normalfont\large\bfseries'. For subsubsection, the
+LEVEL is 3, the INDENT is 0pt, the BEFORESKIP is '-3.25ex plus -1ex
+minus -0.2ex', the AFTERSKIP is '1.5ex plus 0.2ex', and the STYLE is
+'\normalfont\normalsize\bfseries'.
Here are examples. They go either in a package or class file or in
the preamble of a LaTeX document. If you put them in the preamble they
must go between a '\makeatletter' command and a '\makeatother'.
(Probably the error message 'You can't use `\spacefactor' in vertical
-mode.' means that you forgot this.) *Note \makeatletter and
+mode.' means that you forgot this.) *Note \makeatletter &
\makeatother::.
This will put section titles in large boldface type, centered. It
@@ -2206,33 +2735,42 @@ display that counter.
7 Cross references
******************
-One reason for numbering things such as figures and equations is to
-refer the reader to them, as in "See Figure~3 for more details."
-
- Including the figure number in the source is poor practice since if
-that number changes as the document evolves then you must remember to
-update this reference by hand. Instead, LaTeX has you write a "label"
-like '\label{eq:GreensThm}' and refer to it with 'See
-equation~\ref{eq:GreensThm}'.
-
- LaTeX writes the information from the labels to a file with the same
-name as the file containing the '\label{...}' but with an '.aux'
-extension. (The information has the format
-'\newlabel{LABEL}{{CURRENTLABEL}{PAGENUMBER}}' where CURRENTLABEL is the
-current value of the macro '\@currentlabel' that is usually updated
-whenever you call '\refstepcounter{COUNTER}'.)
-
- The most common side effect of the prior paragraph happens when your
-document has a "forward reference", a '\ref{KEY}' that appears earlier
-than the associated '\label{KEY}'; see the example in the
-'\pageref{...}' description. LaTeX gets the information for references
-from the '.aux' file. If this is the first time you are compiling the
-document then you will get a message 'LaTeX Warning: Label(s) may have
-changed. Rerun to get cross references right.' and in the output the
-reference will appear as two question marks '??', in boldface. Or, if
-you change some things so the references change then you get the same
-warning and the output contains the old reference information. The
-solution in either case is just to compile the document a second time.
+We often want something like 'See Theorem~31'. But by-hand typing the
+31 is poor practice. Instead you should write a "label" such as
+'\label{eq:GreensThm}' and then "reference" it, as with 'See
+equation~\ref{eq:GreensThm}'. LaTeX will automatically work out the
+number, put it into the output, and will change that number later if
+needed.
+
+ We will see this with Theorem~\ref{th:GreensThm}. % forward reference
+ ...
+ \begin{theorem} \label{th:GreensThm}
+ ...
+ \end{theorem}
+ ...
+ See Theorem~\ref{th:GreensThm} on page~\pageref{th:GreensThm}.
+
+ LaTeX tracks cross reference information in a file having the
+extension '.aux' and with the same base name as the file containing the
+'\label'. So if '\label' is in 'calculus.tex' then the information is
+in 'calculus.aux'. LaTeX puts the information in that file every time
+it runs across a '\label'.
+
+ The behavior described in the prior paragraph results in a quirk that
+happens when your document has a "forward reference", a '\ref' that
+appears before the associated '\label'. If this is the first time that
+you are compiling the document then you will get 'LaTeX Warning:
+Label(s) may have changed. Rerun to get cross references right' and in
+the output the forward reference will appear as two question marks '??',
+in boldface. A similar thing happens if you change some things so the
+references changes; you get the same warning and the output contains the
+old reference information. In both cases, resolve this by compiling the
+document a second time.
+
+ The 'cleveref' package enhances LaTeX's cross referencing features.
+You can arrange that if you enter
+'\begin{thm}\label{th:Nerode}...\end{thm}' then '\cref{th:Nerode}' will
+output 'Theorem 3.21', without you having to enter the "Theorem."
7.1 '\label'
============
@@ -2252,28 +2790,35 @@ punctuation characters. Upper and lowercase letters are distinguished,
as usual.
A common convention is to use labels consisting of a prefix and a
-suffix separated by a colon or period. This helps to avoid accidentally
-creating two labels with the same name, and makes your source more
-readable. Some commonly-used prefixes:
+suffix separated by a colon or period. Thus, '\label{fig:Post}' is a
+label for a figure with a portrait of Emil Post. This helps to avoid
+accidentally creating two labels with the same name, and makes your
+source more readable. Some commonly-used prefixes:
'ch'
for chapters
+
'sec'
+'subsec'
for lower-level sectioning commands
+
'fig'
for figures
+
'tab'
for tables
+
'eq'
for equations
- Thus, '\label{fig:Euler}' is a label for a figure with a portrait of
-the great man.
+ In the auxiliary file the reference information is kept as the text
+of a command of the form '\newlabel{LABEL}{{CURRENTLABEL}{PAGENUMBER}}'.
+Here CURRENTLABEL is the current value of the macro '\@currentlabel'
+that is usually updated whenever you call '\refstepcounter{COUNTER}'.
- In this example below the key 'sec:test' will get the number of the
-current section and the key 'fig:test' will get the number of the
-figure. (Incidentally, put labels after captions in figures and
-tables.)
+ Below, the key 'sec:test' will get the number of the current section
+and the key 'fig:test' will get the number of the figure.
+(Incidentally, put labels after captions in figures and tables.)
\section{section name}
\label{sec:test}
@@ -2285,8 +2830,8 @@ tables.)
\end{figure}
See Figure~\ref{fig:test}.
-7.2 '\pageref{KEY}'
-===================
+7.2 '\pageref'
+==============
Synopsis:
@@ -2295,10 +2840,13 @@ Synopsis:
Produce the page number of the place in the text where the
corresponding '\label'{KEY} command appears.
- In this example the '\label{eq:main}' is used both for the formula
-number and for the page number. (Note that the two references are
-forward references, so this document would need to be compiled twice to
-resolve those.)
+ If there is no '\label{KEY}' then you get something like 'LaTeX
+Warning: Reference `th:GrensThm' on page 1 undefined on input line 11.'
+
+ Below, the '\label{eq:main}' is used both for the formula number and
+for the page number. (Note that the two references are forward
+references so this document would need to be compiled twice to resolve
+those.)
The main result is formula~\ref{eq:main} on page~\pageref{eq:main}.
...
@@ -2306,8 +2854,8 @@ resolve those.)
\mathbf{P}=\mathbf{NP}
\end{equation}
-7.3 '\ref{KEY}'
-===============
+7.3 '\ref'
+==========
Synopsis:
@@ -2318,8 +2866,12 @@ figure, ..., of the corresponding '\label' command (*note \label::). It
does not produce any text, such as the word 'Section' or 'Figure', just
the bare number itself.
- In this example, the '\ref{popular}' produces '2'. Note that it is a
-forward reference since it comes before '\label{popular}'.
+ If there is no '\label{KEY}' then you get something like 'LaTeX
+Warning: Reference `th:GrensThm' on page 1 undefined on input line 11.'
+
+ In this example the '\ref{popular}' produces '2'. Note that it is a
+forward reference since it comes before '\label{popular}' so this
+document would have to be compiled twice.
The most widely-used format is item number~\ref{popular}.
\begin{enumerate}
@@ -2328,6 +2880,9 @@ forward reference since it comes before '\label{popular}'.
\item Con\TeX t
\end{enumerate}
+ The 'cleveref' package includes text such as 'Theorem' in the
+reference. See the documentation on CTAN.
+
8 Environments
**************
@@ -2401,7 +2956,7 @@ Synopsis:
...
\end{array}
- or
+or:
\begin{array}[POS]{COLS}
COLUMN 1 ENTRY &COLUMN 2 ENTRY ... &COLUMN N ENTRY \\
@@ -2410,22 +2965,38 @@ Synopsis:
Produce a mathematical array. This environment can only be used in
math mode, and normally appears within a displayed mathematics
-environment such as 'equation' (*note equation::). Column entries are
-separated by an ampersand ('&'). Rows are terminated with
-double-backslashes (*note \\::).
+environment such as 'equation' (*note equation::). Inside of each row
+the column entries are separated by an ampersand, ('&'). Rows are
+terminated with double-backslashes (*note \\::).
+
+ This example shows a three by three array.
+
+ \begin{equation*}
+ \chi(x) =
+ \left| % vertical bar fence
+ \begin{array}{ccc}
+ x-a &-b &-c \\
+ -d &x-e &-f \\
+ -g &-h &x-i
+ \end{array}
+ \right|
+ \end{equation*}
The required argument COLS describes the number of columns, their
-alignment, and the formatting of the intercolumn regions. See *note
-tabular:: for the complete description of COLS, and of the other common
+alignment, and the formatting of the intercolumn regions. For instance,
+'\begin{array}{rcl}...\end{array}' gives three columns: the first flush
+right, the second centered, and the third flush left. See *note
+tabular:: for the complete description of COLS and of the other common
features of the two environments, including the optional POS argument.
There are two ways that 'array' diverges from 'tabular'. The first
-is that 'array' entries are typeset in math mode, in textstyle (except
-if the COLS definition specifies the column with 'p{...}', which causes
-the entry to be typeset in text mode). The second is that, instead of
-'tabular''s parameter '\tabcolsep', LaTeX's intercolumn space in an
-'array' is governed by '\arraycolsep', which gives half the width
-between columns. The default for this is '5pt'.
+is that 'array' entries are typeset in math mode, in textstyle (*note
+Modes::) except if the COLS definition specifies the column with
+'p{...}', which causes the entry to be typeset in text mode. The second
+is that, instead of 'tabular''s parameter '\tabcolsep', LaTeX's
+intercolumn space in an 'array' is governed by '\arraycolsep', which
+gives half the width between columns. The default for this is '5pt' so
+that between two columns comes 10pt of space.
To obtain arrays with braces the standard is to use the 'amsmath'
package. It comes with environments 'pmatrix' for an array surrounded
@@ -2435,39 +3006,38 @@ braces '{...}', 'vmatrix' for an array surrounded by vertical
bars '|...|', and 'Vmatrix' for an array surrounded by double vertical
bars '||...||', along with a number of other array constructs.
- Here is an example of an array:
+ The next example uses the 'amsmath' package.
- \begin{equation}
- \begin{array}{cr}
- \sqrt{y} &12.3 \\
- x^2 &3.4
- \end{array}
- \end{equation}
-
- The next example works if '\usepackage{amsmath}' is in the preamble:
+ \usepackage{amsmath} % in preamble
\begin{equation}
- \begin{vmatrix}{cc}
+ \begin{vmatrix}{cc} % array with vert lines
a &b \\
c &d
\end{vmatrix}=ad-bc
\end{equation}
+ There are many packages concerning arrays. The 'array' package has
+many useful extensions, including more column types. The 'dcolumn'
+package adds a column type to center on a decimal point. For both see
+the documentation on CTAN.
+
8.3 'center'
============
Synopsis:
\begin{center}
- ... text ...
+ LINE1 \\
+ LINE2 \\
+ ...
\end{center}
Create a new paragraph consisting of a sequence of lines that are
-centered within the left and right margins on the current page. Use
-double-backslash to get a line break at a particular spot (*note \\::).
-If some text environment body is too long to fit on a line, LaTeX will
-insert line breaks that avoid hyphenation and avoid stretching or
-shrinking any interword space.
+centered within the left and right margins. Use double-backslash, '\\',
+to get a line break (*note \\::). If some text is too long to fit on a
+line then LaTeX will insert line breaks that avoid hyphenation and avoid
+stretching or shrinking any interword space.
This environment inserts space above and below the text body. See
*note \centering:: to avoid such space, for example inside a 'figure'
@@ -2494,17 +3064,42 @@ ending.
I grew up in that belief. --Richard Burton
\end{center}
- A double backslash after the final line is optional.
+ A double backslash after the final line is optional. If present it
+doesn't add any vertical space.
+
+ In a two-column document the text is centered in a column, not in the
+entire page.
8.3.1 '\centering'
------------------
-A declaration that causes material in its scope to be centered. It is
-most often used inside an environment such as 'figure', or in a
-'parbox'.
+Synopsis:
+
+ {\centering ... }
+
+or
+
+ \begin{group}
+ \centering ...
+ \end{group}
+
+ Center the material in its scope. It is most often used inside an
+environment such as 'figure', or in a 'parbox'.
+
+ This example's '\centering' declaration causes the graphic to be
+horizontally centered.
+
+ \begin{figure}
+ \centering
+ \includegraphics[width=0.6\textwidth]{ctan_lion.png}
+ \caption{CTAN Lion} \label{fig:CTANLion}
+ \end{figure}
+
+The scope of this '\centering' ends with the '\end{figure}'.
Unlike the 'center' environment, the '\centering' command does not
-add vertical space above and below the text.
+add vertical space above and below the text. That's its advantage in
+the above example; there is not an excess of space.
It also does not start a new paragraph; it simply changes how LaTeX
formats paragraph units. If 'ww {\centering xx \\ yy} zz' is surrounded
@@ -2515,18 +3110,7 @@ blank line or the '\end' command of an environment such as 'figure' or
'table' that ends the paragraph unit. Thus, if '{\centering xx \\
yy\par} zz' is surrounded by blank lines then it makes a new paragraph
with two centered lines 'xx' and 'yy', followed by a new paragraph with
-'zz' that is formatted as usual. See also the following example.
-
- This example's '\centering' causes the graphic to be horizontally
-centered.
-
- \begin{figure}
- \centering
- \includegraphics[width=0.6\textwidth]{ctan_lion.png}
- \caption{CTAN Lion} \label{fig:CTANLion}
- \end{figure}
-
- The scope of the '\centering' ends with the '\end{figure}'.
+'zz' that is formatted as usual.
8.4 'description'
=================
@@ -2534,26 +3118,28 @@ centered.
Synopsis:
\begin{description}
- \item[LABEL OF FIRST ITEM] text of first item
- \item[LABEL OF SECOND ITEM] text of second item
- ...
+ \item[LABEL OF FIRST ITEM] TEXT OF FIRST ITEM
+ \item[LABEL OF SECOND ITEM] TEXT OF SECOND ITEM
+ ...
\end{description}
- Environment to make a labeled list of items. Each item's LABEL is
-typeset in bold, and is flush left so that long labels continue into the
+ Environment to make a list of labeled items. Each item's LABEL is
+typeset in bold and is flush left, so that long labels continue into the
first line of the item text. There must be at least one item; having
none causes the LaTeX error 'Something's wrong--perhaps a missing
\item'.
This example shows the environment used for a sequence of
-definitions. The labels 'lama' and 'llama' come out in boldface with
-their left edges aligned on the left margin.
+definitions.
\begin{definition}
\item[lama] A priest.
\item[llama] A beast.
\end{definition}
+The labels 'lama' and 'llama' are output in boldface, with the left edge
+on the left margin.
+
Start list items with the '\item' command (*note \item::). Use the
optional labels, as in '\item[Main point]', because there is no sensible
default. Following the '\item' is optional text, which may contain
@@ -2563,9 +3149,10 @@ multiple paragraphs.
font change given in argument style (see *note Font styles::) then it
will come out bold. For instance, if the label text calls for
typewriter with '\item[\texttt{label text}]' then it will appear in bold
-typewriter, if that is available. The simplest way to get non-bold
-typewriter is to use declarative style: '\item[{\tt label text}]'.
-Similarly, get the standard roman font with '\item[{\rm label text}]'.
+typewriter, if that is available. The simplest way around this, in this
+example to get non-bold typewriter, is to use declarative style:
+'\item[{\tt label text}]'. Similarly, get the standard roman font with
+'\item[{\rm label text}]'.
For other major LaTeX labelled list environments, see *note itemize::
and *note enumerate::. Unlike those environments, nesting 'description'
@@ -2587,7 +3174,7 @@ list::. The package 'enumitem' is useful for customizing lists.
Synopsis:
\begin{displaymath}
- MATH TEXT
+ MATHEMATICAL TEXT
\end{displaymath}
Environment to typeset the math text on its own line, in display
@@ -2617,11 +3204,13 @@ vertical spacing, and because the 'displaymath' environment honors the
'fleqn' option.)
The output from this example is centered and alone on its line.
+
\begin{displaymath}
\int_1^2 x^2\,dx=7/3
\end{displaymath}
- Also, the integral sign is larger than the inline version '\(
-\int_1^2 x^2\,dx=7/3 \)' produces.
+
+Also, the integral sign is larger than the inline version '\( \int_1^2
+x^2\,dx=7/3 \)' produces.
8.6 'document'
==============
@@ -2667,9 +3256,9 @@ will be executed in the order that you gave them.
Synopsis:
\begin{enumerate}
- \item[OPTIONAL LABEL OF FIRST ITEM] text of first item
- \item[OPTIONAL LABEL OF SECOND ITEM] text of second item
- ...
+ \item[OPTIONAL LABEL OF FIRST ITEM] TEXT OF FIRST ITEM
+ \item[OPTIONAL LABEL OF SECOND ITEM] TEXT OF SECOND ITEM
+ ...
\end{enumerate}
Environment to produce a numbered list of items. The format of the
@@ -2701,9 +3290,9 @@ format at each nesting level, where 1 is the top level, the outermost
level.
1. arabic number followed by a period: '1.', '2.', ...
- 2. lower case letter inside parentheses: '(a)', '(b)' ...
- 3. lower case roman numeral followed by a period: 'i.', 'ii.', ...
- 4. upper case letter followed by a period: 'A.', 'B.', ...
+ 2. lowercase letter inside parentheses: '(a)', '(b)' ...
+ 3. lowercase roman numeral followed by a period: 'i.', 'ii.', ...
+ 4. uppercase letter followed by a period: 'A.', 'B.', ...
The 'enumerate' environment uses the counters '\enumi' through
'\enumiv' (*note Counters::).
@@ -2731,23 +3320,23 @@ with uppercase letters, in boldface, and without a trailing period.
8.8 'eqnarray'
==============
-First, a caveat: the 'eqnarray' environment is depreciated. It has
-infelicities that cannot be overcome, including spacing that is
-inconsistent with other mathematics elements (see the article "Avoid
-eqnarray!" by Lars Madsen
+The 'eqnarray' environment is obsolete. It has infelicities, including
+spacing that is inconsistent with other mathematics elements. (See
+"Avoid eqnarray!" by Lars Madsen
<http://tug.org/TUGboat/tb33-1/tb103madsen.pdf>). New documents should
include the 'amsmath' package and use the displayed mathematics
-environments provided there, such as the 'align' environment.
+environments provided there, such as the 'align' environment. We
+include a description only for completeness and for working with old
+documents.
- Nevertheless, for completeness and for a reference when working with
-old documents, a synopsis:
+ Synopsis:
\begin{eqnarray}
FIRST FORMULA LEFT &FIRST FORMULA MIDDLE &FIRST FORMULA RIGHT \\
...
\end{eqnarray}
- or
+or
\begin{eqnarray*}
FIRST FORMULA LEFT &FIRST FORMULA MIDDLE &FIRST FORMULA RIGHT \\
@@ -2788,21 +3377,19 @@ inequality, while the third line has not entry on the left side.
Synopsis:
\begin{equation}
- math text
+ MATHEMATICAL TEXT
\end{equation}
- Make a 'displaymath' environment (*note displaymath::) with an
-equation number in the right margin.
-
- The equation number is generated using the 'equation' counter.
+ The same as a 'displaymath' environment (*note displaymath::) except
+that LaTeX puts an equation number flush to the right margin. The
+equation number is generated using the 'equation' counter.
You should have no blank lines between '\begin{equation}' and
'\begin{equation}', or LaTeX will tell you that there is a missing
-dollar sign, $'$'.
+dollar sign.
- Note that the 'amsmath' package has extensive displayed equation
-facilities. Those facilities are the best approach for such output in
-new documents.
+ The package 'amsmath' package has extensive displayed equation
+facilities. New documents should include this package.
8.10 'figure'
=============
@@ -2810,26 +3397,33 @@ new documents.
Synopsis:
\begin{figure}[PLACEMENT]
- figure body
- \caption[LOFTITLE]{TITLE}
- \label{LABEL}
+ FIGURE BODY
+ \caption[LOFTITLE]{TITLE} % optional
+ \label{LABEL} % optional
\end{figure}
- or
+or:
\begin{figure*}[PLACEMENT]
- figure body
- \caption[LOFTITLE]{TITLE}
- \label{LABEL}
+ FIGURE BODY
+ \caption[LOFTITLE]{TITLE} % optional
+ \label{LABEL} % optional
\end{figure*}
- A class of floats (*note Floats::). Because they cannot be split
-across pages, they are not typeset in sequence with the normal text but
-instead are "floated" to a convenient place, such as the top of a
-following page.
+ Figures are for material that is not part of the normal text. An
+example is material that you cannot have split between two pages, such
+as a graphic. Because of this, LaTeX does not typeset figures in
+sequence with normal text but instead "floats" them to a convenient
+place, such as the top of a following page (*note Floats::).
- For the possible values of PLACEMENT and their effect on the float
-placement algorithm, see *note Floats::.
+ The FIGURE BODY can consist of imported graphics (*note Graphics::),
+or text, LaTeX commands, etc. It is typeset in a 'parbox' of width
+'\textwidth'.
+
+ The possible values of PLACEMENT are 'h' for 'here', 't' for 'top',
+'b' for 'bottom', and 'p' for 'on a separate page of floats'. For the
+effect of these options on the float placement algorithm, see *note
+Floats::.
The starred form 'figure*' is used when a document is in
double-column mode (*note \twocolumn::). It produces a figure that
@@ -2837,20 +3431,18 @@ spans both columns, at the top of the page. To add the possibility of
placing at a page bottom see the discussion of PLACEMENT 'b' in *note
Floats::.
- The figure body is typeset in a 'parbox' of width '\textwidth' and so
-it can contain text, commands, etc.
-
The label is optional; it is used for cross references (*note Cross
references::). The optional '\caption' command specifies caption text
for the figure. By default it is numbered. If LOFTITLE is present, it
-is used in the list of figures instead of TITLE (*note Tables of
-contents::).
+is used in the list of figures instead of TITLE (*note Table of contents
+etc.::).
- This example makes a figure out of a graphic. It requires one of the
-packages 'graphics' or 'graphicx'. The graphic, with its caption, will
-be placed at the top of a page or, if it is pushed to the end of the
-document, on a page of floats.
+ This example makes a figure out of a graphic. LaTeX will place that
+graphic and its caption at the top of a page or, if it is pushed to the
+end of the document, on a page of floats.
+ \usepackage{graphicx} % in preamble
+ ...
\begin{figure}[t]
\centering
\includegraphics[width=0.5\textwidth]{CTANlion.png}
@@ -2866,7 +3458,7 @@ Synopsis:
TEXT
\end{filecontents}
- or
+or
\begin{filecontents*}{FILENAME}
TEXT
@@ -2900,7 +3492,7 @@ nothing in that case, it will overwrite the existing file.
Article by \myname.
\end{document}
- produces this file 'JH.sty'.
+produces this file 'JH.sty'.
%% LaTeX2e file `JH.sty'
%% generated by the `filecontents' environment
@@ -2911,22 +3503,47 @@ nothing in that case, it will overwrite the existing file.
8.12 'flushleft'
================
+Synopsis:
+
\begin{flushleft}
- LINE1 \\
- LINE2 \\
- ...
+ LINE1 \\
+ LINE2 \\
+ ...
\end{flushleft}
- The 'flushleft' environment allows you to create a paragraph
-consisting of lines that are flush to the left-hand margin and ragged
-right. Each line must be terminated with the string '\\'.
+ An environment that creates a paragraph whose lines are flush to the
+left-hand margin, and ragged right. If you have lines that are too long
+then LaTeX will linebreak them in a way that avoids hyphenation and
+stretching or shrinking spaces. To force a new line use a double
+backslash, '\\'. For the declaration form see *note \raggedright::.
+
+ This creates a box of text that is at most 3 inches wide, with the
+text flush left and ragged right.
+
+ \noindent\begin{minipage}{3in}
+ \begin{flushleft}
+ A long sentence that will be broken by \LaTeX{}
+ at a convenient spot. \\
+ And, a fresh line forced by the double backslash.
+ \end{flushleft}
+ \end{minipage}
8.12.1 '\raggedright'
---------------------
-The '\raggedright' declaration corresponds to the 'flushleft'
-environment. This declaration can be used inside an environment such as
-'quote' or in a 'parbox'.
+Synopses:
+
+ {\raggedright ... }
+
+or
+
+ \begin{ENVIRONMENT} \raggedright
+ ...
+ \end{ENVIRONMENT}
+
+ A declaration which causes lines to be flush to the left margin and
+ragged right. It can be used inside an environment such as 'quote' or
+in a 'parbox'. For the environment form see *note flushleft::.
Unlike the 'flushleft' environment, the '\raggedright' command does
not start a new paragraph; it only changes how LaTeX formats paragraph
@@ -2934,25 +3551,50 @@ units. To affect a paragraph unit's format, the scope of the
declaration must contain the blank line or '\end' command that ends the
paragraph unit.
+ Here '\raggedright' in each second column keeps LaTeX from doing very
+awkward typesetting to fit the text into the narrow column. Note that
+'\raggedright' is inside the curly braces '{...}' to delimit its effect.
+
+ \begin{tabular}{rp{2in}}
+ Team alpha &{\raggedright This team does all the real work.} \\
+ Team beta &{\raggedright This team ensures that the water
+ cooler is never empty.} \\
+ \end{tabular}
+
8.13 'flushright'
=================
\begin{flushright}
- LINE1 \\
- LINE2 \\
- ...
+ LINE1 \\
+ LINE2 \\
+ ...
\end{flushright}
- The 'flushright' environment allows you to create a paragraph
-consisting of lines that are flush to the right-hand margin and ragged
-left. Each line must be terminated with the control sequence '\\'.
+ An environment that creates a paragraph whose lines are flush to the
+right-hand margin and ragged left. If you have lines that are too long
+to fit the margins then LaTeX will linebreak them in a way that avoids
+hyphenation and stretching or shrinking spaces. To force a new line use
+a double backslash, '\\'. For the declaration form see *note
+\raggedleft::.
+
+ For an example related to this environment, see *note flushleft::.
8.13.1 '\raggedleft'
--------------------
-The '\raggedleft' declaration corresponds to the 'flushright'
-environment. This declaration can be used inside an environment such as
-'quote' or in a 'parbox'.
+Synopses:
+
+ {\raggedleft ... }
+
+or
+
+ \begin{ENVIRONMENT} \raggedleft
+ ...
+ \end{ENVIRONMENT}
+
+ A declaration which causes lines to be flush to the right margin and
+ragged left. It can be used inside an environment such as 'quote' or in
+a 'parbox'. For the environment form see *note flushright::.
Unlike the 'flushright' environment, the '\raggedleft' command does
not start a new paragraph; it only changes how LaTeX formats paragraph
@@ -2960,31 +3602,33 @@ units. To affect a paragraph unit's format, the scope of the
declaration must contain the blank line or '\end' command that ends the
paragraph unit.
+ For an example related to this environment, see *note \raggedright::.
+
8.14 'itemize'
==============
Synopsis:
\begin{itemize}
- \item[OPTIONAL LABEL OF FIRST ITEM] text of first item
- \item[OPTIONAL LABEL OF SECOND ITEM] text of second item
- ...
+ \item[OPTIONAL LABEL OF FIRST ITEM] TEXT OF FIRST ITEM
+ \item[OPTIONAL LABEL OF SECOND ITEM] TEXT OF SECOND ITEM
+ ...
\end{itemize}
- The 'itemize' environment produces an "unordered", "bulleted" list.
-The format of the label numbering depends on the nesting level of this
-environment; see below. Each 'itemize' list environment must have at
-least one item; having none causes the LaTeX error 'Something's
-wrong--perhaps a missing \item'.
+ Produce a list that is unordered, sometimes called a bullet list.
+The environment must have at least one '\item'; having none causes the
+LaTeX error 'Something's wrong--perhaps a missing \item'.
- This example gives a two-item list. As a top-level list each label
-would come out as a bullet, *.
+ This gives a two-item list.
\begin{itemize}
\item Pencil and watercolor sketch by Cassandra
\item Rice portrait
\end{itemize}
+As a top-level list each label would come out as a bullet, *. The
+format of the labeling depends on the nesting level; see below.
+
Start list items with the '\item' command (*note \item::). If you
give '\item' an optional argument by following it with square brackets,
as in '\item[Optional label]', then by default it will appear in bold
@@ -2996,7 +3640,7 @@ the '\item' is optional text, which may contain multiple paragraphs.
deep. They can also be nested within other paragraph-making
environments, such as 'enumerate' (*note enumerate::). The 'itemize'
environment uses the commands '\labelitemi' through '\labelitemiv' to
-produce the default label (this also uses the convention of lower case
+produce the default label (this also uses the convention of lowercase
roman numerals at the end of the command names that signify the nesting
level). These are the default marks at each level.
@@ -3014,7 +3658,7 @@ first level use diamonds.
The distance between the left margin of the enclosing environment and
the left margin of the 'itemize' list is determined by the parameters
'\leftmargini' through '\leftmarginvi'. (Note the convention of using
-lower case roman numerals a the end of the command name to denote the
+lowercase roman numerals a the end of the command name to denote the
nesting level.) The defaults are: '2.5em' in level 1 ('2em' in
two-column mode), '2.2em' in level 2, '1.87em' in level 3, and '1.7em'
in level 4, with smaller values for more deeply nested levels.
@@ -3033,8 +3677,8 @@ lists.
Especially for lists with short items, it may be desirable to elide
space between items. Here is an example defining an 'itemize*'
environment with no extra spacing between items, or between paragraphs
-within a single item ('\parskip' is not list-specific, *note
-\parskip::):
+within a single item ('\parskip' is not list-specific, *note \parindent
+& \parskip::):
\newenvironment{itemize*}%
{\begin{itemize}%
@@ -3054,31 +3698,31 @@ This environment is used for creating letters. *Note Letters::.
Synopsis:
\begin{list}{LABELING}{SPACING}
- \item[OPTIONAL LABEL OF FIRST ITEM] text of first item
- \item[OPTIONAL LABEL OF SECOND ITEM] text of second item
- ...
+ \item[OPTIONAL LABEL OF FIRST ITEM] TEXT OF FIRST ITEM
+ \item[OPTIONAL LABEL OF SECOND ITEM] TEXT OF SECOND ITEM
+ ...
\end{list}
- The 'list' environment is a generic environment for constructing more
-specialized lists. It is most often used to create lists via the
-'description', 'enumerate', and 'itemize' environments (*note
-description::, *note enumerate::, and *note itemize::).
+ An environment for constructing lists.
- Also, many standard LaTeX environments that are not visually lists
-are constructed using 'list', including 'quotation', 'quote', 'center',
-'verbatim', and plenty more (*note quotation and quote::, *note
-center::, *note flushright::).
+ Note that this environment does not typically appear in the document
+body. Most lists created by LaTeX authors are the ones that come
+standard: the 'description', 'enumerate', and 'itemize' environments
+(*note description::, *note enumerate::, and *note itemize::).
- The third-party package 'enumitem' is useful for customizing lists.
-Here, we describe the 'list' environment by defining a new custom
-environment.
+ Instead, the 'list' environment is most often used in macros. For
+example, many standard LaTeX environments that do not immediately appear
+to be lists are in fact constructed using 'list', including 'quotation',
+'quote', and 'center' (*note quotation & quote::, *note center::).
+
+ This uses the 'list' environment to define a new custom environment.
\newcounter{namedlistcounter} % number the items
\newenvironment{named}
{\begin{list}
- {Item~\Roman{namedlistcounter}.} % labeling argument
- {\usecounter{namedlistcounter} % spacing argument
- \setlength{\leftmargin}{3.5em}} % still spacing arg
+ {Item~\Roman{namedlistcounter}.} % labeling
+ {\usecounter{namedlistcounter} % set counter
+ \setlength{\leftmargin}{3.5em}} % set spacing
}
{\end{list}}
@@ -3088,42 +3732,45 @@ environment.
\item Shows as ``Item~II.''
\end{named}
- The 'list' environment's mandatory first argument, LABELING,
-specifies the default labeling of list items. It can contain text and
-LaTeX commands, as above where it contains both 'Item' and
-'\Roman{...}'. LaTeX forms the label by putting the LABELING argument
-in a box of width '\labelwidth'. If the label is wider than that, the
-additional material extends to the right. When making an instance of a
-list you can override the default labeling by giving '\item' an optional
-argument by including square braces and the text, as in the above
-'\item[Special label.]'; *note \item::.
-
- The label box is constructed by the command '\makelabel'. By default
-it positions the contents flush right. It takes one argument, the
-label. It typesets the contents in LR mode. An example of changing its
-definition is that to the above example before the definition of the
-'named' environment add '\newcommand{\namedmakelabel}[1]{\textsc{#1}}',
-and between the '\setlength' command and the parenthesis that closes the
-SPACING argument also add '\let\makelabel\namedmakelabel'. Then the
-items will be typeset in small caps. Similarly, changing the second
-code line to '\let\makelabel\fbox' puts the labels inside a framed box.
-Another example is at the bottom of this entry.
-
- The mandatory second argument SPACING can have a list of commands to
-redefine the spacing parameters for the list, such as
-'\setlength{\labelwidth}{2em}'. If this argument is empty, i.e., '{}',
-then the list will have the default spacing given below. To number the
-items using a counter, put '\usecounter{COUNTERNAME}' in this argument
-(*note \usecounter::).
-
- Below are the spacing parameters for list formatting. See also the
-figure below. Each is a length (*note Lengths::). The vertical spaces
-are normally rubber lengths, with 'plus' and 'minus' components, to give
-TeX flexibility in setting the page. Change each with a command such as
+ The mandatory first argument LABELING specifies the default labeling
+of list items. It can contain text and LaTeX commands, as above where
+it contains both 'Item' and '\Roman{...}'. LaTeX forms the label by
+putting the LABELING argument in a box of width '\labelwidth'. If the
+label is wider than that, the additional material extends to the right.
+When making an instance of a list you can override the default labeling
+by giving '\item' an optional argument by including square braces and
+the text, as in the above '\item[Special label.]'; *note \item::.
+
+ The mandatory second argument SPACING has a list of commands. This
+list can be empty. A command that can go in here is
+'\usecounter{COUNTERNAME}' (*note \usecounter::). Use this to tell
+LaTeX to number the items using the given counter. The counter will be
+reset to zero each time LaTeX enters the environment, and the counter is
+incremented by one each time LaTeX encounters an '\item' that does not
+have an optional argument.
+
+ Another command that can go in SPACING is '\makelabel', which
+constructs the label box. By default it puts the contents flush right.
+Its only argument is the label, which it typesets in LR mode (*note
+Modes::). One example of changing its definition is that to the above
+'named' example, before the definition of the environment add
+'\newcommand{\namedmakelabel}[1]{\textsc{#1}}', and between the
+'\setlength' command and the parenthesis that closes the SPACING
+argument also add '\let\makelabel\namedmakelabel'. Then the items will
+be typeset in small caps. Similarly, changing the second code line to
+'\let\makelabel\fbox' puts the labels inside a framed box. Another
+example of the '\makelabel' command is below, in the definition of the
+'redlabel' environment.
+
+ Also often in SPACING are commands to redefine the spacing for the
+list. Below are the spacing parameters with their default values.
+(Default values for derived environments such as 'itemize' can be
+different than the values shown here.) See also the figure that follows
+the list. Each is a length (*note Lengths::). The vertical spaces are
+normally rubber lengths, with 'plus' and 'minus' components, to give TeX
+flexibility in setting the page. Change each with a command such as
'\setlength{itemsep}{2pt plus1pt minus1pt}'. For some effects these
-lengths should be zero or negative. Default values for derived
-environments such as 'itemize' can be changed from the values shown here
-for the basic 'list'.
+lengths should be zero or negative.
'\itemindent'
Extra horizontal space indentation, beyond 'leftmargin', of the
@@ -3220,13 +3867,14 @@ for the basic 'list'.
'\topsep'
Vertical space added to both the top and bottom of the list, in
- addition to '\parskip' (*note \parskip::). The defaults for the
- first three levels in LaTeX's 'article', 'book', and 'report'
- classes at 10 point size are: '8pt plus2pt minus4pt', '4pt plus2pt
- minus1pt', and '2pt plus1pt minus1pt'. The defaults at 11 point
- are: '9pt plus3pt minus5pt', '4.5pt plus2pt minus1pt', and '2pt
- plus1pt minus1pt'. The defaults at 12 point are: '10pt plus4pt
- minus6pt', '5pt plus2.5pt minus1pt', and '2.5pt plus1pt minus1pt'.
+ addition to '\parskip' (*note \parindent & \parskip::). The
+ defaults for the first three levels in LaTeX's 'article', 'book',
+ and 'report' classes at 10 point size are: '8pt plus2pt minus4pt',
+ '4pt plus2pt minus1pt', and '2pt plus1pt minus1pt'. The defaults
+ at 11 point are: '9pt plus3pt minus5pt', '4.5pt plus2pt minus1pt',
+ and '2pt plus1pt minus1pt'. The defaults at 12 point are: '10pt
+ plus4pt minus6pt', '5pt plus2.5pt minus1pt', and '2.5pt plus1pt
+ minus1pt'.
This shows the horizontal and vertical distances.
@@ -3267,6 +3915,9 @@ V3
appears in the source above the environment; whether a blank line
appears in the source below the environment does not matter.)
+H0
+ '\labelwidth'
+
H1
'\labelsep'
@@ -3308,8 +3959,11 @@ of 10000 prohibits a page break.
The page breaking penalty for breaking after a list (default
'-51').
+ The package 'enumitem' is useful for customizing lists.
+
This example has the labels in red. They are numbered, and the left
-edge of the label lines up with the left edge of the item text.
+edge of the label lines up with the left edge of the item text. *Note
+\usecounter::.
\usepackage{color}
\newcounter{cnt}
@@ -3334,7 +3988,8 @@ Synopsis:
\item text of item
- or
+or
+
\item[OPTIONAL-LABEL] text of item
An entry in a list. The entries are prefixed by a label, whose
@@ -3416,20 +4071,107 @@ text. '\(...\)' and '$...$' are synonyms. *Note Math formulas::.
8.18 'minipage'
===============
+Synopses:
+
+ \begin{minipage}{WIDTH}
+ CONTENTS
+ \end{minipage}
+
+or
+
\begin{minipage}[POSITION][HEIGHT][INNER-POS]{WIDTH}
- TEXT
+ CONTENTS
+ \end{minipage}
+
+ Put CONTENTS into a box that is WIDTH wide. This is like a small
+version of a page; it can contain its own footnotes, itemized lists,
+etc. (There are some restrictions, including that it cannot have
+floats.) This box will not be broken across pages. So 'minipage' is
+similar to '\parbox' (*note \parbox::) but here you can have paragraphs.
+
+ This example will be 3 inches wide, and has two paragraphs.
+
+ \begin{minipage}{3in}
+ Stephen Kleene was a founder of the Theory of Computation.
+
+ He was a student of Church, wrote three influential texts,
+ was President of the Association for Symbolic Logic,
+ and won the National Medal of Science.
+ \end{minipage}
+
+See below for a discussion of the paragraph indent inside a 'minipage'.
+
+ The required argument WIDTH is a rigid length (*note Lengths::). It
+gives the width of the box into which CONTENTS are typeset.
+
+ There are three optional arguments, POSITION, HEIGHT, and INNER-POS.
+You need not include all three. For example, get the default POSITION
+and set the HEIGHT with '\begin{minipage}[c][2.54cm] CONTENTS
+\end{minipage}'. (Get the natural height with an empty argument, '[]'.)
+
+ The optional argument POSITION governs how the 'minipage' vertically
+aligns with the surrounding material.
+
+'c'
+ (synonym 'm') Default. Positions the 'minipage' so its vertical
+ center lines up with the center of the adjacent text line (what
+ Plain TeX calls '\vcenter').
+
+'t'
+ Match the top line in the 'minipage' with the baseline of the
+ surrounding text (Plain TeX's '\vtop'.
+
+'b'
+ Match the bottom line in the 'minipage' with the baseline of the
+ surrounding text (Plain TeX's '\vbox'.
+
+ To see the effects of these, contrast running this
+
+ ---\begin{minipage}[c]{0.25in}
+ first\\ second\\ third
\end{minipage}
- The 'minipage' environment typesets its body TEXT in a block that
-will not be broken across pages. This is similar to the '\parbox'
-command (*note \parbox::), but unlike '\parbox', other paragraph-making
-environments can be used inside a minipage.
+with the results of changing 'c' to 'b' or 't'.
+
+ The optional argument HEIGHT is a rigid length (*note Lengths::). It
+sets the height of the 'minipage'. You can enter any value larger than,
+or equal to, or smaller than the 'minipage''s natural height and LaTeX
+will not give an error or warning. You can also set it to a height of
+zero or a negative value.
+
+ The final optional argument INNER-POS controls the placement of
+CONTENT inside the box. These are the possible values are (the default
+is the value of POSITION).
- The arguments are the same as for '\parbox' (*note \parbox::).
+'t'
+ Place CONTENT at the top of the box.
+
+'c'
+ Place it in the vertical center.
+
+'b'
+ Place it at the box bottom.
+
+'s'
+ Stretch CONTENTS out vertically; it must contain vertically
+ stretchable space.
- By default, paragraphs are not indented in the 'minipage'
-environment. You can restore indentation with a command such as
-'\setlength{\parindent}{1pc}' command.
+ The INNER-POS argument makes sense when the HEIGHT options is set to
+a value larger than the 'minipage''s natural height. To see the effect
+of the options, run this example with the various choices in place of
+'b'.
+
+ Text before
+ \begin{center}
+ ---\begin{minipage}[c][3in][b]{0.25\textwidth}
+ first\\ second\\ third
+ \end{minipage}
+ \end{center}
+ Text after
+
+ By default paragraphs are not indented in a 'minipage'. Change that
+with a command such as '\setlength{\parindent}{1pc}' at the start of
+CONTENTS.
Footnotes in a 'minipage' environment are handled in a way that is
particularly useful for putting footnotes in figures or tables. A
@@ -3438,315 +4180,604 @@ of the minipage instead of at the bottom of the page, and it uses the
'\mpfootnote' counter instead of the ordinary 'footnote' counter (*note
Counters::).
- However, don't put one minipage inside another if you are using
-footnotes; they may wind up at the bottom of the wrong minipage.
+ This puts the footnote at the bottom of the table, not the bottom of
+the page.
+
+ \begin{center} % center the minipage on the line
+ \begin{minipage}{2.5in}
+ \begin{center} % center the table inside the minipage
+ \begin{tabular}{ll}
+ \textsc{Monarch} &\textsc{Reign} \\ \hline
+ Elizabeth II &63 years\footnote{to date} \\
+ Victoria &63 years \\
+ George III &59 years
+ \end{tabular}
+ \end{center}
+ \end{minipage}
+ \end{center}
+
+ If you nest minipages then there is an oddness when using footnotes.
+Footnotes appear at the bottom of the text ended by the next
+'\end{minipage}' which may not be their logical place.
+
+ This puts a table containing data side by side with a map graphic.
+They are vertically centered.
+
+ \newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
+ ...
+ \begin{center}
+ \vcenteredhbox{\includegraphics[width=0.3\textwidth]{nyc.png}}
+ \hspace{0.1\textwidth}
+ \begin{minipage}{0.5\textwidth}
+ \begin{tabular}{r|l}
+ \multicolumn{1}{r}{Borough} &Pop (million) \\ \hline
+ The Bronx &$1.5$ \\
+ Brooklyn &$2.6$ \\
+ Manhattan &$1.6$ \\
+ Queens &$2.3$ \\
+ Staten Island &$0.5$
+ \end{tabular}
+ \end{minipage}
+ \end{center}
8.19 'picture'
==============
+Synopses:
+ \begin{picture}(WIDTH,HEIGHT)
+ PICTURE COMMANDS
+ \end{picture}
+
+or
+
\begin{picture}(WIDTH,HEIGHT)(XOFFSET,YOFFSET)
- ... PICTURE COMMANDS ...
+ PICTURE COMMANDS
\end{picture}
- The 'picture' environment allows you to create just about any kind of
-picture you want containing text, lines, arrows and circles. You tell
-LaTeX where to put things in the picture by specifying their
-coordinates. A coordinate is a number that may have a decimal point and
-a minus sign--a number like '5', '0.3' or '-3.1416'. A coordinate
-specifies a length in multiples of the unit length '\unitlength', so if
-'\unitlength' has been set to '1cm', then the coordinate 2.54 specifies
-a length of 2.54 centimeters.
-
- You should only change the value of '\unitlength', using the
-'\setlength' command, outside of a 'picture' environment. The default
-value is '1pt'.
-
- The 'picture' package redefine the 'picture' environment so that
-everywhere a number is used in a PICTURE COMMANDS to specify a
-coordinate, one can use alternatively a length. Be aware however that
-this will prevent scaling those lengths by changing '\unitlength'.
-
- A "position" is a pair of coordinates, such as '(2.4,-5)', specifying
-the point with x-coordinate '2.4' and y-coordinate '-5'. Coordinates
-are specified in the usual way with respect to an origin, which is
-normally at the lower-left corner of the picture. Note that when a
-position appears as an argument, it is not enclosed in braces; the
-parentheses serve to delimit the argument.
-
- The 'picture' environment has one mandatory argument which is a
-position (WIDTH,HEIGHT), which specifies the size of the picture. The
-environment produces a rectangular box with these WIDTH and HEIGHT.
-
- The 'picture' environment also has an optional position argument
-(XOFFSET,YOFFSET), following the size argument, that can change the
-origin. (Unlike ordinary optional arguments, this argument is not
-contained in square brackets.) The optional argument gives the
-coordinates of the point at the lower-left corner of the picture
-(thereby determining the origin). For example, if '\unitlength' has
-been set to '1mm', the command
+ An environment to create simple pictures containing lines, arrows,
+boxes, circles, and text. Note that while this environment is not
+obsolete, new documents typically use much more powerful graphics
+creation systems, such as 'TikZ', 'PSTricks', 'MetaPost', or
+'Asymptote'. These are not covered in this document; see CTAN.
+
+ This shows the parallelogram law for adding vectors.
+
+ \setlength{\unitlength}{1cm}
+ \begin{picture}(6,6) % picture box will be 6cm wide by 6cm tall
+ \put(0,0){\vector(2,1){4}} % for every 2 over this vector goes 1 up
+ \put(2,1){\makebox(0,0)[l]{\ first leg}}
+ \put(4,2){\vector(1,2){2}}
+ \put(5,4){\makebox(0,0)[l]{\ second leg}}
+ \put(0,0){\line(1,1){6}}
+ \put(3,3){\makebox(0,0)[r]{sum\ }}
+ \end{picture}
- \begin{picture}(100,200)(10,20)
+ You can also use this environment to place arbitrary material at an
+exact location.
-produces a picture of width 100 millimeters and height 200 millimeters,
-whose lower-left corner is the point (10,20) and whose upper-right
-corner is therefore the point (110,220). When you first draw a picture,
-you typically omit the optional argument, leaving the origin at the
-lower-left corner. If you then want to modify your picture by shifting
-everything, you can just add the appropriate optional argument.
+ \usepackage{color,graphicx} % in preamble
+ ...
+ \begin{center}
+ \setlength{\unitlength}{\textwidth}
+ \begin{picture}(1,1) % leave space, \textwidth wide and tall
+ \put(0,0){\includegraphics[width=\textwidth]{desertedisland.jpg}}
+ \put(0.25,0.35){\textcolor{red}{X Treasure here}}
+ \end{picture}
+ \end{center}
- The environment's mandatory argument determines the nominal size of
-the picture. This need bear no relation to how large the picture really
-is; LaTeX will happily allow you to put things outside the picture, or
-even off the page. The picture's nominal size is used by LaTeX in
-determining how much room to leave for it.
+The red X will be precisely a quarter of the '\linewidth' from the left
+margin, and '0.35\linewidth' up from the bottom. Another example of
+this usage is to put similar code in the page header to get repeat
+material on each of a document's pages.
- Everything that appears in a picture is drawn by the '\put' command.
-The command
+ The 'picture' environment has one required argument, a pair of
+numbers (WIDTH,HEIGHT). Multiply these by the value '\unitlength' to
+get the nominal size of the output, the space that LaTeX reserves on the
+output page. This nominal size need not be how large the picture really
+is; LaTeX will draw things from the picture outside the picture's box.
- \put (11.3,-.3){...}
+ This environment also has an optional argument (XOFFSET,YOFFSET). It
+is used to shift the origin. Unlike most optional arguments, this one
+is not contained in square brackets. As with the required argument, it
+consists of two real numbers. Multiply these by '\unitlength' to get
+the point at the lower-left corner of the picture.
-puts the object specified by '...' in the picture, with its reference
-point at coordinates (11.3,-.3). The reference points for various
-objects will be described below.
+ For example, if '\unitlength' has been set to '1mm', the command
- The '\put' command creates an "LR box". You can put anything that
-can go in an '\mbox' (*note \mbox::) in the text argument of the '\put'
-command. When you do this, the reference point will be the lower left
-corner of the box.
+ \begin{picture}(100,200)(10,20)
- The 'picture' commands are described in the following sections.
+produces a box of width 100 millimeters and height 200 millimeters. The
+picture's origin is the point (10mm,20mm) and so the lower-left corner
+is there, and the upper-right corner is at (110mm,220mm). When you
+first draw a picture you typically omit the optional argument, leaving
+the origin at the lower-left corner. If you then want to modify your
+picture by shifting everything, you can just add the appropriate
+optional argument.
+
+ Each PICTURE COMMAND tells LaTeX where to put something by naming its
+position. A "position" is a pair such as '(2.4,-5)' giving the x- and
+y-coordinates. A "coordinate" is a not a length, it is a real number
+(it may have a decimal point or a minus sign). It specifies a length in
+multiples of the unit length '\unitlength', so if '\unitlength' has been
+set to '1cm', then the coordinate 2.54 specifies a length of 2.54
+centimeters.
+
+ LaTeX's default for '\unitlength' is '1pt'. it is a rigid length
+(*note Lengths::). Change it with the '\setlength' command (*note
+\setlength::). Make this change only outside of a 'picture'
+environment.
-8.19.1 '\circle'
-----------------
+ Coordinates are given with respect to an origin, which is normally at
+the lower-left corner of the picture. Note that when a position appears
+as an argument, as with '\put(1,2){...}', it is not enclosed in braces
+since the parentheses serve to delimit the argument. Also, unlike in
+some computer graphics systems, larger y-coordinates are further up the
+page.
-Synopsis:
+ There are four ways to put things in a picture: '\put', '\multiput',
+'\qbezier', and '\graphpaper'. The most often used is '\put'. This
- \circle[*]{DIAMETER}
+ \put(11.3,-0.3){...}
- The '\circle' command produces a circle with a diameter as close to
-the specified one as possible. The '*'-form of the command draws a
-solid circle.
+places the object with its reference point at coordinates (11.3,-0.3).
+The reference points for various objects will be described below. The
+'\put' command creates an "LR box" (*note Modes::). Anything that can
+go in an '\mbox' (*note \mbox & \makebox::) can go in the text argument
+of the '\put' command. The reference point will be the lower left
+corner of the box. In this picture
- Circles up to 40pt can be drawn.
+ \setlength{\unitlength}{1cm}
+ ...\begin{picture}(1,1)
+ \put(0,0){\line(1,0){1}}
+ \put(0,0){\line(1,1){1}}
+ \end{picture}
-8.19.2 '\makebox'
------------------
+the three dots are just slightly left of the point of the angle formed
+by the two lines. (Also, '\line(1,1){1}' does not call for a line of
+length one; rather the line has a change in the x coordinate of 1.)
-Synopsis:
+ The '\multiput', 'qbezier', and 'graphpaper' commands are described
+below.
- \makebox(WIDTH,HEIGHT)[POSITION]{TEXT}
+ This draws a rectangle with a wavy top, using '\qbezier' for that
+curve.
+
+ \begin{picture}(3,1.5)
+ \put(0,0){\vector(1,0){8}} % x axis
+ \put(0,0){\vector(0,1){4}} % y axis
+ \put(2,0){\line(0,1){3}} % left side rectangle
+ \put(4,0){\line(0,1){3.5}} % right side
+ \qbezier(2,3)(2.5,2.9)(3,3.25)
+ \qbezier(3,3.25)(3.5,3.6)(4,3.5)
+ \thicklines % below here, lines are twice as thick
+ \put(2,3){\line(4,1){2}}
+ \put(4.5,2.5){\framebox{Trapezoidal Rule}}
+ \end{picture}
- The '\makebox' command for the picture environment is similar to the
-normal '\makebox' command except that you must specify a WIDTH and
-HEIGHT in multiples of '\unitlength'.
+8.19.1 '\put'
+-------------
- The optional argument, '[POSITION]', specifies the quadrant that your
-TEXT appears in. You may select up to two of the following:
+Synopsis:
-'t'
- Moves the item to the top of the rectangle.
+ \put(XCOORD,YCOORD){CONTENT}
-'b'
- Moves the item to the bottom.
+ Place CONTENT at the coordinate (XCOORD,YCOORD). See the discussion
+of coordinates and '\unitlength' in *note picture::. The CONTENT is
+processed in LR mode (*note Modes::) so it cannot contain line breaks.
-'l'
- Moves the item to the left.
+ This includes the text into the 'picture'.
-'r'
- Moves the item to the right.
+ \put(4.5,2.5){Apply the \textit{unpoke} move}
- *Note \makebox::.
+ The reference point, the location (4.5,2.5), is the lower left of the
+text, at the bottom left of the 'A'.
-8.19.3 '\framebox'
+8.19.2 '\multiput'
------------------
Synopsis:
- \framebox(WIDTH,HEIGHT)[POS]{...}
+ \multiput(X,Y)(DELTA_X,DELTA_Y){NUM-COPIES}{OBJ}
+
+ Copy OBJ a total of NUM-COPIES times, with an increment of
+DELTA_X,DELTA_Y. The OBJ first appears at position (x,y), then at
+(x+\delta_x,y+\delta_y), and so on.
- The '\framebox' command is like '\makebox' (see previous section),
-except that it puts a frame around the outside of the box that it
-creates.
+ This draws a simple grid with every fifth line in bold (see also
+*note \graphpaper::).
- The '\framebox' command produces a rule of thickness '\fboxrule', and
-leaves a space '\fboxsep' between the rule and the contents of the box.
+ \begin{picture}(10,10)
+ \linethickness{0.05mm}
+ \multiput(0,0)(1,0){10}{\line(0,1){10}}
+ \multiput(0,0)(0,1){10}{\line(1,0){10}}
+ \linethickness{0.5mm}
+ \multiput(0,0)(5,0){3}{\line(0,1){10}}
+ \multiput(0,0)(0,5){3}{\line(1,0){10}}
+ \end{picture}
-8.19.4 '\dashbox'
+8.19.3 '\qbezier'
-----------------
-Draws a box with a dashed line. Synopsis:
+Synopsis:
+
+ \qbezier(X1,Y1)(X2,Y2)(X3,Y3)
+ \qbezier[NUM](X1,Y1)(X2,Y2)(X3,Y3)
- \dashbox{DLEN}(RWIDTH,RHEIGHT)[POS]{TEXT}
+ Draw a quadratic Bezier curve whose control points are given by the
+three required arguments '(X1,Y1)', '(X2,Y2)', and '(X3,Y3)'. That is,
+the curve runs from (X1,Y1) to (X3,Y3), is quadratic, and is such that
+the tangent line at (X1,Y1) passes through (X2,Y2), as does the tangent
+line at (X3,Y3).
- '\dashbox' creates a dashed rectangle around TEXT in a 'picture'
-environment. Dashes are DLEN units long, and the rectangle has overall
-width RWIDTH and height RHEIGHT. The TEXT is positioned at optional
-POS.
+ This draws a curve from the coordinate (1,1) to (1,0).
- A dashed box looks best when the RWIDTH and RHEIGHT are multiples of
-the DLEN.
+ \qbezier(1,1)(1.25,0.75)(1,0)
-8.19.5 '\frame'
----------------
+The curve's tangent line at (1,1) contains (1.25,0.75), as does the
+curve's tangent line at (1,0).
+
+ The optional argument NUM gives the number of calculated intermediate
+points. The default is to draw a smooth curve whose maximum number of
+points is '\qbeziermax' (change this value with '\renewcommand').
+
+8.19.4 '\graphpaper'
+--------------------
Synopsis:
- \frame{TEXT}
+ \graphpaper(X_INIT,Y_INIT)(X_DIMEN,Y_DIMEN)
+ \graphpaper[SPACING](X_INIT,Y_INIT)(X_DIMEN,Y_DIMEN)
+
+ Draw a coordinate grid. Requires the 'graphpap' package. The grid's
+origin is '(X_INIT,Y_INIT)'. Grid lines come every SPACING units (the
+default is 10). The grid extends X_DIMEN units to the right and Y_DIMEN
+units up. All arguments must be positive integers.
+
+ This make a grid with seven vertical lines and eleven horizontal
+lines.
+
+ \usepackage{graphpap} % in preamble
+ ...
+ \begin{picture}(6,20) % in document body
+ \graphpaper[2](0,0)(12,20)
+ \end{picture}
- The '\frame' command puts a rectangular frame around TEXT. The
-reference point is the bottom left corner of the frame. No extra space
-is put between the frame and the object.
+The lines are numbered every ten units.
-8.19.6 '\line'
+8.19.5 '\line'
--------------
Synopsis:
- \line(XSLOPE,YSLOPE){LENGTH}
+ \line(X_RUN,Y_RISE){TRAVEL}
+
+ Draw a line. It slopes such that it vertically rises Y_RISE for
+every horizontal X_RUN. The TRAVEL is the total horizontal change -- it
+is not the length of the vector, it is the change in x. In the special
+case of vertical lines, where (X_RUN,Y_RISE)=(0,1), the TRAVEL gives the
+change in y.
+
+ This draws a line starting at coordinates (1,3).
+
+ \put(1,3){\line(2,5){4}}
+
+For every over 2, this line will go up 5. Because TRAVEL specifies that
+this goes over 4, it must go up 10. Thus its endpoint is
+(1,3)+(4,10)=(5,13). In particular, note that TRAVEL=4 is not the
+length of the line, it is the change in x.
+
+ The arguments X_RUN and Y_RISE are integers that can be positive,
+negative, or zero. (If both are 0 then LaTeX treats the second as 1.)
+With '\put(X_INIT,Y_INIT){\line(X_RUN,Y_RISE){TRAVEL}}', if X_RUN is
+negative then the line's ending point has a first coordinate that is
+less than X_INIT. If Y_RISE is negative then the line's ending point
+has a second coordinate that is less than Y_INIT.
+
+ If TRAVEL is negative then you get 'LaTeX Error: Bad \line or \vector
+argument.'
+
+ Standard LaTeX can only draw lines with a limited range of slopes
+because these lines are made by putting together line segments from
+pre-made fonts. The two numbers X_RUN and Y_RISE must have integer
+values from -6 through 6. Also, they must be relatively prime, so that
+(X_RUN,Y_RISE) can be (2,1) but not (4,2) (if you choose the latter then
+instead of lines you get sequences of arrowheads; the solution is to
+switch to the former). To get lines of arbitrary slope and plenty of
+other shapes in a system like 'picture', see the package 'pict2e' on
+CTAN. Another solution is to use a full-featured graphics system such as
+'TikZ', or 'PSTricks', or 'MetaPost', or 'Asymptote'
+
+8.19.6 '\linethickness'
+-----------------------
- The '\line' command draws a line with the given LENGTH and slope
-XSLOPE/YSLOPE.
+Synopsis:
- Standard LaTeX can only draw lines with SLOPE = x/y, where x and y
-have integer values from -6 through 6. For lines of any slope, and
-plenty of other shapes, see 'pict2e' and many other packages on CTAN.
+ \linethickness{DIM}
-8.19.7 '\linethickness'
------------------------
+ Declares the thickness of subsequent horizontal and vertical lines in
+a picture to be DIM, which must be a positive length (*note Lengths::).
+It differs from '\thinlines' and '\thicklines' in that it does not
+affect the thickness of slanted lines, circles, or ovals.
-The '\linethickness{DIM}' command declares the thickness of horizontal
-and vertical lines in a picture environment to be DIM, which must be a
-positive length.
+8.19.7 '\thinlines'
+-------------------
- '\linethickness' does not affect the thickness of slanted lines,
-circles, or the quarter circles drawn by '\oval'.
+Declaration to set the thickness of subsequent lines, circles, and ovals
+in a picture environment to be 0.4pt. This is the default thickness, so
+this command is unnecessary unless the thickness has been changed with
+either *note \linethickness:: or *note \thicklines::.
8.19.8 '\thicklines'
--------------------
-The '\thicklines' command is an alternate line thickness for horizontal
-and vertical lines in a picture environment; cf. *note \linethickness::
-and *note \thinlines::.
+Declaration to set the thickness of subsequent lines, circles, and ovals
+in a picture environment to be 0.8pt. See also *note \linethickness::
+and *note \thinlines::. This command is illustrated in the Trapezoidal
+Rule example of *note picture::.
-8.19.9 '\thinlines'
--------------------
+8.19.9 '\circle'
+----------------
-The '\thinlines' command is the default line thickness for horizontal
-and vertical lines in a picture environment; cf. *note \linethickness::
-and *note \thicklines::.
+Synopsis:
-8.19.10 '\multiput'
--------------------
+ \circle{DIAMETER}
+ \circle*{DIAMETER}
-Synopsis:
+ Produces a circle with a diameter as close as possible to the
+specified one. The '*' form produces a filled-in circle.
+
+ This draws a circle of radius 6, centered at '(5,7)'.
- \multiput(X,Y)(DELTA_X,DELTA_Y){N}{OBJ}
+ \put(5,7){\circle{6}}
- The '\multiput' command copies the object OBJ in a regular pattern
-across a picture. OBJ is first placed at position (x,y), then at
-(x+\delta x,y+\delta y), and so on, N times.
+ The available radii for 'circle' are, in points, the even numbers
+from 2 to 20, inclusive. For 'circle*' they are all the integers from 1
+to 15.
-8.19.11 '\oval'
+8.19.10 '\oval'
---------------
Synopsis:
+ \oval(WIDTH,HEIGHT)
\oval(WIDTH,HEIGHT)[PORTION]
- The '\oval' command produces a rectangle with rounded corners. The
-optional argument PORTION allows you to produce only half of the oval
-via the following:
+ Produce a rectangle with rounded corners. The optional argument
+PORTION allows you to produce only half or a quarter of the oval. For
+half an oval take PORTION to be one of these.
't'
- selects the top half;
+ top half
'b'
- selects the bottom half;
+ bottom half
'r'
- selects the right half;
+ right half
'l'
- selects the left half.
+ left half
- It is also possible to produce only one quarter of the oval by
-setting PORTION to 'tr', 'br', 'bl', or 'tl'.
+ Produce only one quarter of the oval by setting PORTION to 'tr',
+'br', 'bl', or 'tl'.
- The "corners" of the oval are made with quarter circles with a
-maximum radius of 20pt, so large "ovals" will look more like boxes with
-rounded corners.
-
-8.19.12 '\put'
---------------
+ This draws the top half of an oval that is 3 wide and 7 tall.
-Synopsis:
+ \put(5,7){\oval(3,7)[t]}
- \put(XCOORD,YCOORD){ ... }
+The (5,7) is the center of the entire oval, not just the center of the
+top half.
- The '\put' command places the material specified by the (mandatory)
-argument in braces at the given coordinate, (XCOORD,YCOORD).
+ These shapes are not ellipses. They are rectangles whose corners are
+made with quarter circles. These circles have a maximum radius of 20pt
+(*note \circle:: for the sizes). Thus large ovals are just boxes with a
+small amount of corner rounding.
-8.19.13 '\shortstack'
+8.19.11 '\shortstack'
---------------------
Synopsis:
- \shortstack[POSITION]{...\\...\\...}
+ \shortstack[POSITION]{LINE 1 \\ ... }
+
+ Produce a vertical stack of objects.
+
+ This labels the y axis.
+
+ \put(0,0){\vector(1,0){4}} % x axis
+ \put(0,0){\vector(0,1){2}} % y
+ \put(-0.25,2){\makebox[0][r]{\shortstack[r]{$y$\\ axis}}}
- The '\shortstack' command produces a stack of objects. The valid
-positions are:
+For a short stack, the reference point is the lower left of the stack.
+In the above example the *note \mbox & \makebox:: puts the stack flush
+right in a zero width box so in total the short stack sits slightly to
+the left of the y axis.
+
+ The valid positions are:
'r'
- Move the objects to the right of the stack.
+ Make objects flush right
'l'
- Move the objects to the left of the stack
+ Make objects flush left
'c'
- Move the objects to the centre of the stack (default)
-
- Objects are separated with '\\'.
+ Center objects (default)
+
+ Separate objects into lines with '\\'. These stacks are short in
+that, unlike in a 'tabular' or 'array' environment, here the rows are
+not spaced out to be of even heights. Thus, in
+'\shortstack{X\\o\\o\\X}' the first and last rows are taller than the
+middle two. You can adjust row heights either by putting in the usual
+interline spacing with '\shortstack{X\\ \strut o\\o\\X}', or by hand,
+via an explicit zero-width box '\shortstack{X \\ \rule{0pt}{12pt}
+o\\o\\X}' or by using '\\''s optional argument '\shortstack{X\\[2pt]
+o\\o\\X}'.
+
+ The '\shortstack' command is also available outside the 'picture'
+environment.
-8.19.14 '\vector'
+8.19.12 '\vector'
-----------------
Synopsis:
- \vector(XSLOPE,YSLOPE){LENGTH}
+ \vector(X_RUN,Y_RISE){TRAVEL}
- The '\vector' command draws a line with an arrow of the specified
-length and slope. The XSLOPE and YSLOPE values must lie between -4 and
-+4, inclusive.
+ Draw a line ending in an arrow. The slope of that line is: it
+vertically rises Y_RISE for every horizontal X_RUN. The TRAVEL is the
+total horizontal change -- it is not the length of the vector, it is the
+change in x. In the special case of vertical vectors, if
+(X_RUN,Y_RISE)=(0,1), then TRAVEL gives the change in y.
-8.20 'quotation' and 'quote'
-============================
+ For an example see *note picture::.
+
+ For elaboration on X_RUN and Y_RISE see *note \line::. As there, the
+values of X_RUN and Y_RISE are limited. For '\vector' you must chooses
+integers between -4 and 4, inclusive. Also, the two you choose must be
+relatively prime. Thus, '\vector(2,1){4}' is acceptable but
+'\vector(4,2){4}' is not (if you use the latter then you get a sequence
+of arrowheads).
+
+8.19.13 '\makebox' (picture)
+----------------------------
+
+Synopsis:
+
+ \makebox(REC-WIDTH,REC-HEIGHT){TEXT}
+ \makebox(REC-WIDTH,REC-HEIGHT)[POSITION]{TEXT}
+
+ Make a box to hold TEXT. This command fits with the 'picture'
+environment, although you can use it outside of there, because REC-WIDTH
+and REC-HEIGHT are numbers specifying distances in terms of the
+'\unitlength' (*note picture::). This command is similar to the normal
+'\makebox' command (*note \mbox & \makebox::) except here that you must
+specify the width and height. This command is fragile (*note
+\protect::).
+
+ This makes a box of length 3.5 times '\unitlength' and height 4 times
+'\unitlength'.
+
+ \put(1,2){\makebox(3.5,4){...}}
+
+ The optional argument 'POSITION' specifies where in the box the TEXT
+appears. The default is to center it, both horizontally and vertically.
+To place it somewhere else, use a string with one or two of these
+letters.
+
+'t'
+ Puts TEXT the top of the box.
+
+'b'
+ Put TEXT at the bottom.
+
+'l'
+ Put TEXT on the left.
+
+'r'
+ Put TEXT on the right.
+
+8.19.14 '\framebox' (picture)
+-----------------------------
+
+Synopsis:
+
+ \framebox(REC-WIDTH,REC-HEIGHT){TEXT}
+ \framebox(REC-WIDTH,REC-HEIGHT)[POSITION]{TEXT}
+
+ This is the same as *note \makebox (picture):: except that it puts a
+frame around the outside of the box that it creates. The reference
+point is the bottom left corner of the frame. This command fits with
+the 'picture' environment, although you can use it outside of there,
+because lengths are numbers specifying the distance in terms of the
+'\unitlength' (*note picture::). This command is fragile (*note
+\protect::).
+
+ This example creates a frame 2.5 inches by 3 inches and puts the text
+in the center.
+
+ \setlength{\unitlength}{1in}
+ \framebox(2.5,3){test text}
+
+ The required arguments are that the rectangle has overall width
+RECT-WIDTH units and height RECT-HEIGHT units.
+
+ The optional argument POSITION specifies the position of TEXT; see
+*note \makebox (picture):: for the values that it can take.
+
+ The rule has thickness '\fboxrule' and there is a blank space
+'\fboxsep' between the frame and the contents of the box.
+
+ For this command, you must specify the WIDTH and HEIGHT. If you want
+to just put a frame around some contents whose dimension is determined
+in some other way then either use '\fbox' (*note \fbox & \framebox::) or
+'\frame' (*note \frame::).
+
+8.19.15 '\frame'
+----------------
+
+Synopsis:
+
+ \frame{CONTENTS}
+
+ Puts a rectangular frame around CONTENTS. The reference point is the
+bottom left corner of the frame. In contrast to '\framebox' (*note
+\framebox (picture)::), this command puts no extra space is put between
+the frame and the object. It is fragile (*note \protect::).
+
+8.19.16 '\dashbox'
+------------------
+
+Synopsis:
+
+ \dashbox{DASH-LEN}(RECT-WIDTH,RECT-HEIGHT){TEXT}
+ \dashbox{DASH-LEN}(RECT-WIDTH,RECT-HEIGHT)[POSITION]{TEXT}
+
+ Create a dashed rectangle around TEXT. This command fits with the
+'picture' environment, although you can use it outside of there, because
+lengths are numbers specifying the distance in terms of the
+'\unitlength' (*note picture::).
+
+ The required arguments are: dashes are DASH-LEN units long, with the
+same length gap, and the rectangle has overall width RECT-WIDTH units
+and height RECT-HEIGHT units.
+
+ The optional argument POSITION specifies the position of TEXT; see
+*note \makebox (picture):: for the values that it can take.
+
+ This shows that you can use non-integer value for DASH-LEN.
+
+ \put(0,0){\dashbox{0.1}(5,0.5){My hovercraft is full of eels.}}
+
+Each dash will be '0.1\unitlength' long, the box's width is
+'5\unitlength' and its height is '0.5\unitlength'.
+
+ As in that example, a dashed box looks best when RECT-WIDTH and
+RECT-HEIGHT are multiples of the DASH-LEN.
+
+8.20 'quotation' & 'quote'
+==========================
Synopsis:
\begin{quotation}
- TEXT
+ TEXT
\end{quotation}
- or
+or
\begin{quote}
- TEXT
+ TEXT
\end{quote}
- Include a quotation.
+ Include a quotation. Both environments indent margins on both sides
+by '\leftmargin' and the text is right-justified.
- In both environments, margins are indented on both sides by
-'\leftmargin' and the text is justified at both. As with the main text,
-leaving a blank line produces a new paragraph.
+ They differ in how they treat paragraphs. In the 'quotation'
+environment, paragraphs are indented by 1.5em and the space between
+paragraphs is small, '0pt plus 1pt'. In the 'quote' environment,
+paragraphs are not indented and there is vertical space between
+paragraphs (it is the rubber length '\parsep').
- To compare the two: in the 'quotation' environment, paragraphs are
-indented by 1.5em and the space between paragraphs is small, '0pt plus
-1pt'. In the 'quote' environment, paragraphs are not indented and there
-is vertical space between paragraphs (it is the rubber length
-'\parsep'). Thus, the 'quotation' environment may be more suitable for
-documents where new paragraphs are marked by an indent rather than by a
-vertical separation. In addition, 'quote' may be more suitable for a
-short quotation or a sequence of short quotations.
-
- \begin{quotation}
- \it Four score and seven years ago
+ \begin{quotation} \small\it
+ Four score and seven years ago
... shall not perish from the earth.
- \hspace{1em plus 1fill}---Abraham Lincoln
+ \hspace{1em plus 1fill}---Abraham Lincoln
\end{quotation}
8.21 'tabbing'
@@ -3760,10 +4791,11 @@ Synopsis:
...
\end{tabbing}
- The 'tabbing' environment aligns text in columns. It works by
-setting tab stops and tabbing to them much as was done on a typewriter.
-It is best suited for cases where the width of each column is constant
-and known in advance.
+ Align text in columns, by setting tab stops and tabbing to them much
+as was done on a typewriter. This is less often used than the
+environments 'tabular' (*note tabular::) or 'array' (*note array::)
+because in those the width of each column need not be constant and need
+not be known in advance.
This example has a first line where the tab stops are set to explicit
widths, ended by a '\kill' command (which is described below):
@@ -3881,7 +4913,8 @@ They are all fragile (*note \protect::).
end;\\
\end{tabbing}
- The output looks like this:
+The output looks like this.
+
function fact(n : integer) : integer;
begin
if n > 1 then
@@ -3890,11 +4923,11 @@ They are all fragile (*note \protect::).
fact := 1;
end;
- (The above example is just for illustration of the environment. To
-actually typeset computer code in typewriter like this, a verbatim
-environment (*note verbatim::) would normally suffice. For
-pretty-printed code, there are quite a few packages, including
-'algorithm2e', 'fancyvrb', 'listings', and 'minted'.)
+This example is just for illustration of the environment. To actually
+typeset computer code in typewriter like this, a verbatim environment
+(*note verbatim::) would normally be best. For pretty-printed code,
+there are quite a few packages, including 'algorithm2e', 'fancyvrb',
+'listings', and 'minted'.
8.22 'table'
============
@@ -3902,27 +4935,45 @@ pretty-printed code, there are quite a few packages, including
Synopsis:
\begin{table}[PLACEMENT]
- table body
- \caption[LOFTITLE]{TITLE}
- \label{LABEL}
+ TABLE BODY
+ \caption[LOFTITLE]{TITLE} % optional
+ \label{LABEL} % also optional
\end{table}
- A class of floats (*note Floats::). Because they cannot be split
-across pages, they are not typeset in sequence with the normal text but
-instead are "floated" to a convenient place, such as the top of a
+ A class of floats (*note Floats::). They cannot be split across
+pages and so they are not typeset in sequence with the normal text but
+instead are floated to a convenient place, such as the top of a
following page.
+ This example 'table' environment contains a 'tabular'
+
+ \begin{table}
+ \centering\small
+ \begin{tabular}{ll}
+ \multicolumn{1}{c}{\textit{Author}}
+ &\multicolumn{1}{c}{\textit{Piece}} \\ \hline
+ Bach &Cello Suite Number 1 \\
+ Beethoven &Cello Sonata Number 3 \\
+ Brahms &Cello Sonata Number 1
+ \end{tabular}
+ \caption{Top cello pieces}
+ \label{tab:cello}
+ \end{table}
+
+but you can put many different kinds of content in a 'table', including
+text, LaTeX commands, etc.
+
For the possible values of PLACEMENT and their effect on the float
placement algorithm, see *note Floats::.
- The table body is typeset in a 'parbox' of width '\textwidth' and so
-it can contain text, commands, etc.
+ The table body is typeset in a 'parbox' of width '\textwidth'. It
+can contain text, commands, graphics, etc.
The label is optional; it is used for cross references (*note Cross
-references::). The optional '\caption' command specifies caption text
-for the table. By default it is numbered. If LOTTITLE is present, it
-is used in the list of tables instead of TITLE (*note Tables of
-contents::).
+references::). The '\caption' command is also optional. It specifies
+caption text for the table. By default it is numbered. If its optional
+LOTTITLE is present then that text is used in the list of tables instead
+of TITLE (*note Table of contents etc.::).
In this example the table and caption will float to the bottom of a
page, unless it is pushed to a float page at the end.
@@ -3944,20 +4995,20 @@ page, unless it is pushed to a float page at the end.
Synopsis:
\begin{tabular}[POS]{COLS}
- column 1 entry &column 2 entry ... &column n entry \\
+ COLUMN 1 ENTRY &COLUMN 2 ENTRY ... &COLUMN N ENTRY \\
...
\end{tabular}
or
\begin{tabular*}{WIDTH}[POS]{COLS}
- column 1 entry &column 2 entry ... &column n entry \\
+ COLUMN 1 ENTRY &COLUMN 2 ENTRY ... &COLUMN N ENTRY \\
...
\end{tabular*}
- These environments produce a table, a box consisting of a sequence of
-horizontal rows. Each row consists of items that are aligned vertically
-in columns. This illustrates many of the features.
+ Produce a table, a box consisting of a sequence of horizontal rows.
+Each row consists of items that are aligned vertically in columns. This
+illustrates many of the features.
\begin{tabular}{l|l}
\textit{Player name} &\textit{Career home runs} \\
@@ -3966,23 +5017,16 @@ in columns. This illustrates many of the features.
Babe Ruth &714
\end{tabular}
- The vertical format of two left-aligned columns, with a vertical bar
-between them, is specified in 'tabular''s argument '{l|l}'. Columns are
-separated with an ampersand '&'. A horizontal rule between two rows is
-created with '\hline'. The end of each row is marked with a double
-backslash '\\'. This '\\' is optional after the last row unless an
-'\hline' command follows, to put a rule below the table.
+The output will have two left-aligned columns with a vertical bar
+between them. This is specified in 'tabular''s argument '{l|l}'. Put
+the entries into different columns by separating them with an ampersand,
+'&'. The end of each row is marked with a double backslash, '\\'. Put
+a horizontal rule below a row, after a double backslash, with '\hline'.
+This '\\' is optional after the last row unless an '\hline' command
+follows, to put a rule below the table.
The required and optional arguments to 'tabular' consist of:
-WIDTH
- Required for 'tabular*', not allowed for 'tabular'. Specifies the
- width of the 'tabular*' environment. The space between columns
- should be rubber, as with '@{\extracolsep{\fill}}', to allow the
- table to stretch or shrink to make the specified width, or else you
- are likely to get the 'Underfull \hbox (badness 10000) in alignment
- ...' warning.
-
POS
Optional. Specifies the table's vertical position. The default is
to align the table so its vertical center matches the baseline of
@@ -4012,27 +5056,29 @@ COLS
A vertical line the full height and depth of the environment.
'@{TEXT OR SPACE}'
- This inserts TEXT OR SPACE at this location in every row. The
- TEXT OR SPACE material is typeset in LR mode. This text is
- fragile (*note \protect::).
+ Insert TEXT OR SPACE at this location in every row. The TEXT
+ OR SPACE material is typeset in LR mode. This text is fragile
+ (*note \protect::).
- This specifier is optional: with no @-expression, LaTeX's
+ If between two columns there is no @-expression then LaTeX's
'book', 'article', and 'report' classes will put on either
side of each column a space of length '\tabcolsep', which by
- default is '6pt'. That is, by default adjacent columns are
- separated by 12pt (so '\tabcolsep' is misleadingly-named since
- it is not the separation between tabular columns). By
- implication, a space of 6pt also comes before the first column
+ default is 6pt. That is, by default adjacent columns are
+ separated by 12pt (so '\tabcolsep' is misleadingly named since
+ it is only half of the separation between tabular columns).
+ In addition, a space of 6pt also comes before the first column
and after the final column, unless you put a '@{...}' or '|'
there.
- If you override the default and use an @-expression then you
- must insert any desired space yourself, as in
- '@{\hspace{1em}}'.
+ If you override the default and use an @-expression then LaTeX
+ does not insert '\tabcolsep' so you must insert any desired
+ space yourself, as in '@{\hspace{1em}}'.
- An empty expression '@{}' will eliminate the space, including
- the space at the start or end, as in the example below where
- the tabular lines need to lie on the left margin.
+ An empty expression '@{}' will eliminate the space. In
+ particular, sometimes you want to eliminate the the space
+ before the first column or after the last one, as in the
+ example below where the tabular lines need to lie on the left
+ margin.
\begin{flushleft}
\begin{tabular}{@{}l}
@@ -4040,9 +5086,9 @@ COLS
\end{tabular}
\end{flushleft}
- This example shows text, a decimal point, between the columns,
- arranged so the numbers in the table are aligned on that
- decimal point.
+ The next example shows text, a decimal point between the
+ columns, arranged so the numbers in the table are aligned on
+ it.
\begin{tabular}{r@{$.$}l}
$3$ &$14$ \\
@@ -4052,42 +5098,50 @@ COLS
An '\extracolsep{WD}' command in an @-expression causes an
extra space of width WD to appear to the left of all
subsequent columns, until countermanded by another
- '\extracolsep' command. Unlike ordinary intercolumn space,
- this extra space is not suppressed by an @-expression. An
- '\extracolsep' command can be used only in an @-expression in
- the 'cols' argument. Below, LaTeX inserts the right amount of
+ '\extracolsep'. Unlike ordinary intercolumn space, this extra
+ space is not suppressed by an @-expression. An '\extracolsep'
+ command can be used only in an @-expression in the 'cols'
+ argument. Below, LaTeX inserts the right amount of
intercolumn space to make the entire table 4 inches wide.
- \begin{center}
- \begin{tabular*}{4in}{l@{\ \ldots\extracolsep{\fill}}l}
- Seven times down, eight times up
- &such is life!
- \end{tabular*}
- \end{center}
+ \begin{tabular*}{4in}{l@{\extracolsep{\fill}}l}
+ Seven times down, eight times up \ldots
+ &such is life!
+ \end{tabular*}
To insert commands that are automatically executed before a
given column, load the 'array' package and use the '>{...}'
specifier.
'p{WD}'
- Each item in the column is typeset in a parbox of width WD.
-
- Note that a line break double backslash '\\' may not appear in
- the item, except inside an environment like 'minipage',
- 'array', or 'tabular', or inside an explicit '\parbox', or in
- the scope of a '\centering', '\raggedright', or '\raggedleft'
- declaration (when used in a 'p'-column element these
- declarations must appear inside braces, as with '{\centering
- .. \\ ..}'). Otherwise LaTeX will misinterpret the double
- backslash as ending the row.
+ Each item in the column is typeset in a parbox of width WD, as
+ if it were the argument of a '\parbox[t]{wd}{...}' command.
+
+ A line break double backslash '\\' may not appear in the item,
+ except inside an environment like 'minipage', 'array', or
+ 'tabular', or inside an explicit '\parbox', or in the scope of
+ a '\centering', '\raggedright', or '\raggedleft' declaration
+ (when used in a 'p'-column element these declarations must
+ appear inside braces, as with '{\centering .. \\ ..}').
+ Otherwise LaTeX will misinterpret the double backslash as
+ ending the row. Instead, to get a line break in there use
+ '\newline' (*note \newline::).
'*{NUM}{COLS}'
Equivalent to NUM copies of COLS, where NUM is a positive
- integer and COLS is a list of specifiers. Thus
- '\begin{tabular}{|*{3}{l|r}|}' is equivalent to
+ integer and COLS is a list of specifiers. Thus the specifier
+ '\begin{tabular}{|*{3}{l|r}|}' is equivalent to the specifier
'\begin{tabular}{|l|rl|rl|r|}'. Note that COLS may contain
another '*'-expression.
+WIDTH
+ Required for 'tabular*', not allowed for 'tabular'. Specifies the
+ width of the 'tabular*' environment. The space between columns
+ should be rubber, as with '@{\extracolsep{\fill}}', to allow the
+ table to stretch or shrink to make the specified width, or else you
+ are likely to get the 'Underfull \hbox (badness 10000) in alignment
+ ...' warning.
+
Parameters that control formatting:
'\arrayrulewidth'
@@ -4130,8 +5184,9 @@ argument TEXT gives the contents of that entry.
spanned by the single heading 'Name'.
\begin{tabular}{lccl}
- \textit{ID} &\multicolumn{2}{c}{\textit{Name}} &\textit{Age} \\ \hline % row one
- 978-0-393-03701-2 &O'Brian &Patrick &55 \\ % row two
+ \textit{ID} &\multicolumn{2}{c}{\textit{Name}} &\textit{Age} \\
+ \hline
+ 978-0-393-03701-2 &O'Brian &Patrick &55 \\
...
\end{tabular}
@@ -4156,12 +5211,12 @@ details the exact behavior.
&z % entry four
\end{tabular}
- Before the first entry the output will not have a vertical rule
-because the '\multicolumn' has the COLS specifier 'r' with no initial
-vertical bar. Between entry one and entry two there will be a vertical
-rule; although the first COLS does not have an ending vertical bar, the
-second COLS does have a starting one. Between entry two and entry three
-there is a single vertical rule; despite that the COLS in both of the
+Before the first entry the output will not have a vertical rule because
+the '\multicolumn' has the COLS specifier 'r' with no initial vertical
+bar. Between entry one and entry two there will be a vertical rule;
+although the first COLS does not have an ending vertical bar, the second
+COLS does have a starting one. Between entry two and entry three there
+is a single vertical rule; despite that the COLS in both of the
surrounding 'multicolumn''s call for a vertical rule, you only get one
rule. Between entry three and entry four there is no vertical rule; the
default calls for one but the COLS in the entry three '\multicolumn'
@@ -4189,7 +5244,7 @@ center those two columns on the page range en-dash.
Impressionistic &1875 &1925
\end{tabular}
- Note that although the 'tabular' specification by default puts a
+Note that although the 'tabular' specification by default puts a
vertical rule between the first and second columns, because there is no
vertical bar in the COLS of either of the first row's '\multicolumn'
commands, no rule appears in the first row.
@@ -4202,22 +5257,22 @@ full height and depth of an entry's row. Can also be used in an
@-expression, although its synonym vertical bar '|' is more common.
This command is rarely used in the body of a table; typically a table's
vertical lines are specified in 'tabular''s COLS argument and overridden
-as needed with '\multicolumn'.
+as needed with '\multicolumn' (*note tabular::).
- This example illustrates some pitfalls. In the first line's second
-entry the '\hfill' moves the '\vline' to the left edge of the cell. But
-that is different than putting it halfway between the two columns, so in
-that row between the first and second columns there are two vertical
+ The example below illustrates some pitfalls. In the first row's
+second entry the '\hfill' moves the '\vline' to the left edge of the
+cell. But that is different than putting it halfway between the two
+columns, so between the first and second columns there are two vertical
rules, with the one from the '{c|cc}' specifier coming before the one
-produced by the '\vline\hfill'. In contrast, the first line's third
+produced by the '\vline\hfill'. In contrast, the first row's third
entry shows the usual way to put a vertical bar between two columns. In
-the second line, the 'ghi' is the widest entry in its column so in the
+the second row, the 'ghi' is the widest entry in its column so in the
'\vline\hfill' the '\hfill' has no effect and the vertical line in that
entry appears immediately next to the 'g', with no whitespace.
\begin{tabular}{c|cc}
- x &\vline\hfill y &\multicolumn{1}{|r}{z} \\
- abc &def &\vline\hfill ghi
+ x &\vline\hfill y &\multicolumn{1}{|r}{z} \\ % row 1
+ abc &def &\vline\hfill ghi % row 2
\end{tabular}
8.23.3 '\cline'
@@ -4227,10 +5282,10 @@ Synopsis:
\cline{I-J}
- Draw a horizontal rule in an 'array' or 'tabular' environment
-beginning in column I and ending in column J. The dash '-' must appear
-in the mandatory argument. To span a single column use the number
-twice.
+ In an 'array' or 'tabular' environment, draw a horizontal rule
+beginning in column I and ending in column J. The dash, '-', must
+appear in the mandatory argument. To span a single column use the
+number twice, as with '\cline{2-2}'.
This example puts two horizontal lines between the first and second
rows, one line in the first column only, and the other spanning the
@@ -4245,7 +5300,7 @@ height.
8.23.4 '\hline'
---------------
-Draws a horizontal line the width of the enclosing 'tabular' or 'array'
+Draw a horizontal line the width of the enclosing 'tabular' or 'array'
environment. It's most commonly used to draw a line at the top, bottom,
and between the rows of a table.
@@ -4265,68 +5320,158 @@ single rule spanning both columns. Because of the '\hline', the
Synopsis:
\begin{thebibliography}{WIDEST-LABEL}
- \bibitem[LABEL]{CITE_KEY}
- ...
+ \bibitem[LABEL]{CITE_KEY}
+ ...
\end{thebibliography}
- The 'thebibliography' environment produces a bibliography or
-reference list.
-
- In the 'article' class, this reference list is labelled 'References'
-and the label is stored in macro '\refname'; in the 'report' class, it
-is labelled 'Bibliography' and the label is stored in macro '\bibname'.
-
- You can change the label by redefining the command '\refname' or
-'\bibname', whichever is applicable depending on the class:
+ Produce a bibliography or reference list. There are two ways to
+produce bibliographic lists. This environment is suitable when you have
+only a few references and can maintain the list by hand. *Note Using
+BibTeX:: for a more sophisticated approach.
- * For standard classes whose top level sectioning is '\chapter' (such
- as 'book' and 'report'), the label is in the macro '\bibname';
+ This shows the environment with two entries.
- * For standard classes whose the top level sectioning is '\section'
- (such as 'article'), the label is in macro '\refname'.
+ This work is based on \cite{latexdps}.
+ Together they are \cite{latexdps, texbook}.
+ ...
+ \begin{thebibliography}{9}
+ \bibitem{latexdps}
+ Leslie Lamport.
+ \textit{\LaTeX{}: a document preparation system}.
+ Addison-Wesley, Reading, Massachusetts, 1993.
+ \bibitem{texbook}
+ Donald Ervin Knuth.
+ \textit{The \TeX book}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+ \end{thebibliography}
- Typically it is neither necessary nor desirable to directly redefine
-'\refname' or '\bibname'; language support packages like 'babel' do
-this.
+This styles the first reference as '[1] Leslie ...', and so that
+'\cite{latexdps}' produces the matching '... based on [1]'. The second
+'\cite' produces '[1, 2]'. You must compile the document twice to
+resolve these references.
+
+ The mandatory argument WIDEST-LABEL is text that, when typeset, is as
+wide as the widest item label produced by the '\bibitem' commands. The
+tradition is to use '9' for bibliographies with less than 10 references,
+'99' for ones with less than 100, etc.
+
+ The bibliographic list is headed by a title such as 'Bibliography'.
+To change it there are two cases. In the 'book' and 'report' classes,
+where the top level sectioning is '\chapter' and the default title is
+'Bibliography', that title is in the macro '\bibname'. For 'article',
+where the class's top level sectioning is '\section' and the default is
+'References', the title is in macro '\refname'. Change it by redefining
+the command, as with '\renewcommand{\refname}{Cited references}' after
+'\begin{document}'.
- The mandatory WIDEST-LABEL argument is text that, when typeset, is as
-wide as the widest item label produced by the '\bibitem' commands. It
-is typically given as '9' for bibliographies with less than 10
-references, '99' for ones with less than 100, etc.
+ Language support packages such as 'babel' will automatically redefine
+'\refname' or '\bibname' to fit the selected language.
8.24.1 '\bibitem'
-----------------
Synopsis:
+ \bibitem{CITE_KEY}
+
+or
+
\bibitem[LABEL]{CITE_KEY}
- The '\bibitem' command generates an entry labelled by LABEL. If the
-LABEL argument is missing, a number is automatically generated using the
-'enumi' counter. The CITE_KEY is a "citation key" consisting in any
-sequence of letters, numbers, and punctuation symbols not containing a
-comma.
+ Generate an entry labeled by LABEL. The default is for LaTeX to
+generates a number using the 'enumi' counter. The "citation key"
+CITE_KEY is a string of letters, numbers, and punctuation symbols (but
+not comma).
+
+ *Note thebibliography:: for an example.
+
+ The optional LABEL changes the default label from an integer to the
+given string. With this
+
+ \begin{thebibliography}
+ \bibitem[Lamport 1993]{latexdps}
+ Leslie Lamport.
+ \textit{\LaTeX{}: a document preparation system}.
+ Addison-Wesley, Reading, Massachusetts, 1993.
+ \bibitem{texbook}
+ Donald Ervin Knuth.
+ \textit{The \TeX book}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+ \end{thebibliography}
- This command writes an entry to the '.aux' file containing the item's
-CITE_KEY and LABEL. When the '.aux' file is read by the
-'\begin{document}' command, the item's LABEL is associated with
-'cite_key', causing references to CITE_KEY with a '\cite' command (*note
-\cite::) to produce the associated LABEL.
+the first entry will be styled as '[Lamport 1993] Leslie ...' (The
+amount of horizontal space that LaTeX leaves for the label depends on
+the WIDEST-LABEL argument of the 'thebibliography' environment; see
+*note thebibliography::.) Similarly, '... based on \cite{latexdps}'
+will produce '... based on [Lamport 1994]'.
+
+ If you mix '\bibitem' entries having a LABEL with those that do not
+then LaTeX will number the unlabelled ones sequentially. In the example
+above the 'texbook' entry will appear as '[1] Donald ...', despite that
+it is the second entry.
+
+ If you use the same CITE_KEY twice then you get 'LaTeX Warning: There
+were multiply-defined labels'.
+
+ Under the hood, LaTeX remembers the CITE_KEY and LABEL information
+because '\bibitem' writes it to the auxiliary file 'FILENAME.aux'. For
+instance, the above example causes '\bibcite{latexdps}{Lamport, 1993}'
+and '\bibcite{texbook}{1}' to appear in that file. The '.aux' file is
+read by the '\begin{document}' command and then the information is
+available for '\cite' commands. This explains why you need to run LaTeX
+twice to resolve references: once to write it out and once to read it
+in.
+
+ Because of this two-pass algorithm, when you add a '\bibitem' or
+change its CITE_KEY you may get 'LaTeX Warning: Label(s) may have
+changed. Rerun to get cross-references right'. Fix it by recompiling.
8.24.2 '\cite'
--------------
Synopsis:
+ \cite{KEYS}
+
+or
+
\cite[SUBCITE]{KEYS}
- The KEYS argument is a list of one or more citation keys (*note
-\bibitem::), separated by commas. This command generates an in-text
-citation to the references associated with KEYS by entries in the '.aux'
-file.
+ Generate as output a citation to the references associated with KEYS.
+The mandatory KEYS is a citation key, or a comma-separated list of
+citation keys (*note \bibitem::).
+
+ This
+
+ The ultimate source is \cite{texbook}.
+ ...
+ \begin{thebibliography}
+ \bibitem{texbook}
+ Donald Ervin Knuth.
+ \textit{The \TeX book}.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+ \end{thebibliography}
- The text of the optional SUBCITE argument appears after the citation.
-For example, '\cite[p.~314]{knuth}' might produce '[Knuth, p. 314]'.
+produces the output '... source is [1]'.
+
+ The optional argument SUBCITE is appended to the citation. For
+example, 'See 14.3 in \cite[p.~314]{texbook}' might produce 'See 14.3 in
+[1, p. 314]'.
+
+ If KEYS is not in your bibliography information then you get 'LaTeX
+Warning: There were undefined references', and in the output the
+citation shows as a boldface question mark between square brackets.
+There are two possible causes. If you have mistyped something, as in
+'\cite{texbok}' then you need to correct the spelling. On the other
+hand, if you have just added or modified the bibliographic information
+and so changed the '.aux' file (*note \bibitem::) then the fix may be to
+just run LaTeX again.
+
+ In addition to what appears in the output, '\cite' writes information
+to the auxiliary file 'FILENAME.aux'. For instance, '\cite{latexdps}'
+writes '\citation{latexdps}' to that file. This information is used by
+BibTeX to include in your reference list only those works that you have
+actually cited; see *note \nocite:: also.
8.24.3 '\nocite'
----------------
@@ -4335,45 +5480,71 @@ Synopsis:
\nocite{KEYS}
- The '\nocite' command produces no text, but writes KEYS, which is a
-list of one or more citation keys, to the '.aux' file.
+ Produces no output but writes KEYS to the auxiliary file
+'DOC-FILENAME.aux'.
+
+ The mandatory argument KEYS is a comma-separated list of one or more
+citation keys (*note \bibitem::). This information is used by BibTeX to
+include these works in your reference list even though you have not
+cited them (*note \cite::).
8.24.4 Using BibTeX
-------------------
-If you use the BibTeX program by Oren Patashnik (highly recommended if
-you need a bibliography of more than a couple of titles) to maintain
-your bibliography, you don't use the 'thebibliography' environment
-(*note thebibliography::). Instead, you include the lines
+As described in 'thebibliography' (*note thebibliography::), a
+sophisticated approach to managing bibliographies is provided by the
+BibTeX program. This is only an introduction; see the full
+documentation on CTAN.
+
+ With BibTeX, you don't use 'thebibliography' (*note
+thebibliography::). Instead, include these lines.
\bibliographystyle{BIBSTYLE}
- \bibliography{BIBFILE1,BIBFILE2}
+ \bibliography{BIBFILE1, BIBFILE2, ...}
- The '\bibliographystyle' command does not produce any output of its
-own. Rather, it defines the style in which the bibliography will be
-produced: BIBSTYLE refers to a file BIBSTYLE'.bst', which defines how
-your citations will look. The standard BIBSTYLE names distributed with
-BibTeX are:
+The BIBSTYLE refers to a file 'BIBSTYLE.bst', which defines how your
+citations will look. The standard BIBSTYLE's distributed with BibTeX
+are:
'alpha'
- Sorted alphabetically. Labels are formed from name of author and
- year of publication.
+ Labels are formed from name of author and year of publication. The
+ bibliographic items are sorted alphabetically.
'plain'
- Sorted alphabetically. Labels are numeric.
+ Labels are integers. Sort the bibliographic items alphabetically.
'unsrt'
Like 'plain', but entries are in order of citation.
'abbrv'
Like 'plain', but more compact labels.
- In addition, numerous other BibTeX style files exist tailored to the
-demands of various publications. See
+Many, many other BibTeX style files exist, tailored to the demands of
+various publications. See CTAN's listing
<http://mirror.ctan.org/biblio/bibtex/contrib>.
The '\bibliography' command is what actually produces the
-bibliography. The argument to '\bibliography' refers to files named
-'BIBFILE1.bib', 'BIBFILE2.bib', ..., which should contain your database
-in BibTeX format. Only the entries referred to via '\cite' and
-'\nocite' will be listed in the bibliography.
+bibliography. Its argument is a comma-separated list, referring to
+files named 'BIBFILE1.bib', 'BIBFILE2.bib', ... These contain your
+database in BibTeX format. This shows a typical couple of entries in
+that format.
+
+ @book{texbook,
+ title = {The {{\TeX}}book},
+ author = {D.E. Knuth},
+ isbn = {0201134489},
+ series = {Computers \& typesetting},
+ year = {1983},
+ publisher = {Addison-Wesley}
+ }
+ @book{sexbook,
+ author = {W.H. Masters and V.E. Johnson},
+ title = {Human Sexual Response},
+ year = {1966},
+ publisher = {Bantam Books}
+ }
+
+ Only the bibliographic entries referred to via '\cite' and '\nocite'
+will be listed in the document's bibliography. Thus you can keep all
+your sources together in one file, or a small number of files, and rely
+on BibTeX to include in this document only those that you used.
8.25 'theorem'
==============
@@ -4381,12 +5552,29 @@ in BibTeX format. Only the entries referred to via '\cite' and
Synopsis:
\begin{theorem}
- THEOREM-TEXT
+ THEOREM BODY
\end{theorem}
- The 'theorem' environment produces "Theorem N" in boldface followed
-by THEOREM-TEXT, where the numbering possibilities for N are described
-under '\newtheorem' (*note \newtheorem::).
+ Produces 'Theorem N' in boldface followed by THEOREM BODY in italics.
+The numbering possibilities for N are described under '\newtheorem'
+(*note \newtheorem::).
+
+ \newtheorem{lem}{Lemma} % in preamble
+ \newtheorem{thm}{Theorem}
+ ...
+ \begin{lem} % in document body
+ text of lemma
+ \end{lem}
+
+ The next result follows immediately.
+ \begin{thm}[Gauss] % put `Gauss' in parens after theorem head
+ text of theorem
+ \end{thm}
+
+ Most new documents use the packages 'amsthm' and 'amsmath' from the
+American Mathematical Society. Among other things these packages
+include a large number of options for theorem environments, such as
+styling options.
8.26 'titlepage'
================
@@ -4397,14 +5585,11 @@ Synopsis:
... text and spacing ...
\end{titlepage}
- Create a title page, a page with no printed page number or heading.
-The following page will be numbered page one.
-
- To instead produce a standard title page without a 'titlepage'
-environment you can use '\maketitle' (*note \maketitle::).
+ Create a title page, a page with no printed page number or heading
+and with succeeding pages numbered starting with page one.
- Notice in this example that all formatting, including vertical
-spacing, is left to the author.
+ In this example all formatting, including vertical spacing, is left
+to the author.
\begin{titlepage}
\vspace*{\stretch{1}}
@@ -4427,6 +5612,9 @@ spacing, is left to the author.
\vspace{\stretch{2}}
\end{titlepage}
+ To instead produce a standard title page without a 'titlepage'
+environment, use '\maketitle' (*note \maketitle::).
+
8.27 'verbatim'
===============
@@ -4436,31 +5624,81 @@ Synopsis:
LITERAL-TEXT
\end{verbatim}
- The 'verbatim' environment is a paragraph-making environment in which
-LaTeX produces exactly what you type in; for instance the '\' character
-produces a printed '\'. It turns LaTeX into a typewriter with carriage
-returns and blanks having the same effect that they would on a
-typewriter.
+ A paragraph-making environment in which LaTeX produces as output
+exactly what you type as input. For instance inside LITERAL-TEXT the
+backslash '\' character does not start commands, it produces a printed
+'\', and carriage returns and blanks are taken literally. The output
+appears in a monospaced typewriter-like font ('\tt').
+
+ \begin{verbatim}
+ Symbol swearing: %&$#?!.
+ \end{verbatim}
+
+ The only restriction on 'literal-text' is that it cannot include the
+string '\end{verbatim}'.
+
+ You cannot use the verbatim environment in the argument to macros,
+for instance in the argument to a '\section'. This is not the same as
+commands being fragile (*note \protect::), instead it just cannot appear
+there. (But the 'cprotect' package can help with this.)
+
+ One common use of verbatim input is to typeset computer code. There
+are packages that are an improvement the 'verbatim' environment. For
+instance, one improvement is to allow the verbatim inclusion of external
+files, or parts of those files. Such packages include 'listings', and
+'minted'.
- The 'verbatim' environment uses a monospaced typewriter-like font
-('\tt').
+ A package that provides many more options for verbatim environments
+is 'fancyvrb'. Another is 'verbatimbox'.
+
+ For a list of all the relevant packages, see CTAN.
8.27.1 '\verb'
--------------
Synopsis:
- \verbCHARLITERAL-TEXTCHAR
- \verb*CHARLITERAL-TEXTCHAR
+ \verb CHAR LITERAL-TEXT CHAR
+ \verb* CHAR LITERAL-TEXT CHAR
+
+ Typeset LITERAL-TEXT as it is input, including special characters and
+spaces, using the typewriter ('\tt') font.
+
+ This example shows two different invocations of '\verb'.
+
+ This is \verb!literally! the biggest pumpkin ever.
+ And this is the best squash, \verb+literally!+
+
+The first '\verb' has its LITERAL-TEXT surrounded with exclamation
+point, '!'. The second instead uses plus, '+', because the exclamation
+point is part of 'literal-text'.
+
+ The single-character delimiter CHAR surrounds LITERAL-TEXT -- it must
+be the same character before and after. No spaces come between '\verb'
+or '\verb*' and CHAR, or between CHAR and LITERAL-TEXT, or between
+LITERAL-TEXT and the second occurrence of CHAR (the synopsis shows a
+space only to distinguish one component from the other). The delimiter
+must not appear in LITERAL-TEXT. The LITERAL-TEXT cannot include a line
+break.
+
+ The '*'-form differs only in that spaces are printed with a visible
+space character.
+
+ The output from this will include a character showing the spaces.
- The '\verb' command typesets LITERAL-TEXT as it is input, including
-special characters and spaces, using the typewriter ('\tt') font. No
-spaces are allowed between '\verb' or '\verb*' and the delimiter CHAR,
-which begins and ends the verbatim text. The delimiter must not appear
-in LITERAL-TEXT.
+ The commands's first argument is \verb*!filename with extension! and ...
- The '*'-form differs only in that spaces are printed with a "visible
-space" character.
+ For typesetting Internet addresses, urls, the package 'url' provides
+an option that is better than the '\verb' command, since it allows line
+breaks.
+
+ For computer code there are many packages with advantages over
+'\verb'. One is 'listings', another is 'minted'.
+
+ You cannot use '\verb' in the argument to a macro, for instance in
+the argument to a '\section'. It is not a question of '\verb' being
+fragile (*note \protect::), instead it just cannot appear there. (But
+the 'cprotect' package can help with this.)
8.28 'verse'
============
@@ -4468,18 +5706,35 @@ space" character.
Synopsis:
\begin{verse}
- LINE1 \\
- LINE2 \\
- ...
+ LINE1 \\
+ LINE2 \\
+ ...
\end{verse}
- The 'verse' environment is designed for poetry, though you may find
-other uses for it.
+ An environment for poetry.
- The margins are indented on the left and the right, paragraphs are
-not indented, and the text is not justified. Separate the lines of each
-stanza with '\\', and use one or more blank lines to separate the
-stanzas.
+ Here are two lines from Shakespeare's Romeo and Juliet.
+
+ Then plainly know my heart's dear love is set \\
+ On the fair daughter of rich Capulet.
+
+ Separate the lines of each stanza with '\\', and use one or more
+blank lines to separate the stanzas.
+
+ \begin{verse}
+ \makebox[\linewidth][c]{\textit{Shut Not Your Doors} ---Walt Whitman}
+ \\[1\baselineskip]
+ Shut not your doors to me proud libraries, \\
+ For that which was lacking on all your well-fill'd shelves, \\
+ \qquad yet needed most, I bring, \\
+ Forth from the war emerging, a book I have made, \\
+ The words of my book nothing, the drift of it every thing, \\
+ A book separate, not link'd with the rest nor felt by the intellect, \\
+ But you ye untold latencies will thrill to every page.
+ \end{verse}
+
+The output has margins indented on the left and the right, paragraphs
+are not indented, and the text is not right-justified.
9 Line breaking
***************
@@ -4492,58 +5747,128 @@ lines must be broken into pages).
LaTeX usually does the line (and page) breaking in the text body for
you but in some environments you manually force line breaks.
+ A common workflow is to get a final version of the document content
+before taking a final pass through and considering line breaks (and page
+breaks). This differs from word processing, where you are formatting
+text as you input it. Putting these off until the end prevents a lot of
+fiddling with breaks that will change anyway.
+
9.1 '\\'
========
-Synopsis:
+Synopsis, one of:
+ \\
\\[MORESPACE]
- or
+or one of:
+ \\*
\\*[MORESPACE]
- Start a new line. The optional argument MORESPACE specifies extra
-vertical space to be insert before the next line. This can be a
-negative length. The text before the break is set at its normal length,
-that is, it is not stretched to fill out the line width.
-
- Explicit line breaks in the text body are unusual in LaTeX. In
-particular, to start a new paragraph instead leave a blank line. This
-command is mostly used outside of the main flow of text such as in a
-'tabular' or 'array' environment.
+ End the current line. The optional argument MORESPACE specifies
+extra vertical space to be inserted before the next line. This is a
+rubber length (*note Lengths::) and can be negative. The text before
+the line break is set at its normal length, that is, it is not stretched
+to fill out the line width. This command is fragile (*note \protect::).
- Under ordinary circumstances (e.g., outside of a 'p{...}' column in a
-'tabular' environment) the '\newline' command is a synonym for '\\'
-(*note \newline::).
-
- In addition to starting a new line, the starred form '\\*' tells
-LaTeX not to start a new page between the two lines, by issuing a
-'\nobreak'.
+ The starred form, '\\*', tells LaTeX not to start a new page between
+the two lines, by issuing a '\nobreak'.
\title{My story: \\[0.25in]
a tale of woe}
+ Explicit line breaks in the main text body are unusual in LaTeX. In
+particular, don't start new paragraphs with '\\'. Instead leave a blank
+line between the two paragraphs. And don't put in a sequence of '\\''s
+to make vertical space. Instead use '\vspace{LENGTH}', or
+'\leavevmode\vspace{LENGTH}', or '\vspace*{LENGTH}' if you want the
+space to not be thrown out at the top of a new page (*note \vspace::).
+
+ The '\\' command is mostly used outside of the main flow of text such
+as in a 'tabular' or 'array' environment or in an equation environment.
+
+ The '\\' command is a synonym for '\newline' (*note \newline::) under
+ordinary circumstances (an example of an exception is the 'p{...}'
+column in a 'tabular' environment; *note tabular::).
+
+ The '\\' command is a macro, and its definition changes by context so
+that its definition in normal text, a 'center' environment, a
+'flushleft' environment, and a 'tabular' are all different. In normal
+text when it forces a linebreak it is essentially a shorthand for
+'\newline'. It does not end horizontal mode or end the paragraph, it
+just inserts some glue and penalties so that when the paragraph does end
+a linebreak will occur at that point, with the short line padded with
+white space.
+
+ You get 'LaTeX Error: There's no line here to end' if you use '\\' to
+ask for a new line, rather than to end the current line. An example is
+if you have '\begin{document}\\' or, more likely, something like this.
+
+ \begin{center}
+ \begin{minipage}{0.5\textwidth}
+ \\
+ In that vertical space put your mark.
+ \end{minipage}
+ \end{center}
+
+Fix it by replacing the double backslash with something like
+'\vspace{\baselineskip}'.
+
9.2 '\obeycr' & '\restorecr'
============================
The '\obeycr' command makes a return in the input file ('^^M',
-internally) the same as '\\' (followed by '\relax'). So each new line
-in the input will also be a new line in the output.
+internally) the same as '\\', followed by '\relax'. So each new line in
+the input will also be a new line in the output. The '\restorecr'
+command restores normal line-breaking behavior.
- '\restorecr' restores normal line-breaking behavior.
+ This is not the way to show verbatim text or computer code. *Note
+verbatim:: instead.
+
+ With LaTeX's usual defaults, this
+
+ aaa
+ bbb
+
+ \obeycr
+ ccc
+ ddd
+ eee
+
+ \restorecr
+ fff
+ ggg
+
+ hhh
+ iii
+
+produces output like this.
+
+ aaa bbb
+ ccc
+ ddd
+ eee
+
+ fff ggg
+ hhh iii
+
+The indents are paragraph indents.
9.3 '\newline'
==============
-In ordinary text this is equivalent to double-backslash (*note \\::); it
-breaks a line, with no stretching of the text before it.
+In ordinary text, this ends a line in a way that does not right-justify
+the line, so the prior text is not stretched. That is, in paragraph
+mode (*note Modes::), the '\newline' command is equivalent to
+double-backslash (*note \\::). This command is fragile (*note
+\protect::).
- Inside a 'tabular' or 'array' environment, in a column with a
-specifier producing a paragraph box, like typically 'p{...}', '\newline'
-will insert a line break inside of the column, that is, it does not
-break the entire row. To break the entire row use '\\' or its
-equivalent '\tabularnewline'.
+ However, the two commands are different inside a 'tabular' or 'array'
+environment. In a column with a specifier producing a paragraph box
+such as typically 'p{...}', '\newline' will insert a line end inside of
+the column; that is, it does not break the entire tabular row. To break
+the entire row use '\\' or its equivalent '\tabularnewline'.
This will print 'Name:' and 'Address:' as two lines in a single cell
of the table.
@@ -4552,194 +5877,411 @@ of the table.
Name: \newline Address: &Date: \\ \hline
\end{tabular}
- The 'Date:' will be baseline-aligned with 'Name:'.
+The 'Date:' will be baseline-aligned with 'Name:'.
9.4 '\-' (discretionary hyphen)
===============================
-The '\-' command tells LaTeX that it may hyphenate the word at that
-point. LaTeX is pretty good at hyphenating, and usually finds most of
-the correct hyphenation points, while almost never using an incorrect
-one. The '\-' command is used for the exceptional cases.
+Tell LaTeX that it may hyphenate the word at that point. When you
+insert '\-' commands in a word, the word will only be hyphenated at
+those points and not at any of the hyphenation points that LaTeX might
+otherwise have chosen. This command is robust (*note \protect::).
+
+ LaTeX is good at hyphenating and usually finds most of the correct
+hyphenation points, while almost never using an incorrect one. The '\-'
+command is for exceptional cases.
+
+ For example, LaTeX does not ordinarily hyphenate words containing a
+hyphen. Below, the long and hyphenated word means LaTeX has to put in
+unacceptably large spaces to set the narrow column.
+
+ \begin{tabular}{rp{1.75in}}
+ Isaac Asimov &The strain of
+ anti-intellectualism
+ % an\-ti-in\-tel\-lec\-tu\-al\-ism
+ has been a constant thread winding its way through our
+ political and cultural life, nurtured by
+ the false notion that democracy means that
+ `my ignorance is just as good as your knowledge'.
+ \end{tabular}
+
+Commenting out the third line and uncommenting the fourth makes a much
+better fit.
- When you insert '\-' commands in a word, the word will only be
-hyphenated at those points and not at any of the hyphenation points that
-LaTeX might otherwise have chosen.
+ The '\-' command only allows LaTeX to break there, it does not
+require that it break there. You can insist on a split with something
+like 'Hef-\linebreak feron'. Of course, if you later change the text
+then this forced break may look very odd, so this approach requires
+care.
9.5 '\discretionary' (generalized hyphenation point)
====================================================
Synopsis:
- \discretionary{PRE-BREAK-TEXT}{POST-BREAK-TEXT}{NO-BREAK-TEXT}
+ \discretionary{PRE-BREAK}{POST-BREAK}{NO-BREAK}
-9.6 '\fussy'
-============
+ Handle word changes around hyphens. This command is not often used
+in LaTeX documents.
-The declaration '\fussy' (which is the default) makes TeX picky about
-line breaking. This usually avoids too much space between words, at the
-cost of an occasional overfull box.
+ If a line break occurs at the point where '\discretionary' appears
+then TeX puts PRE-BREAK at the end of the current line and puts
+POST-BREAK at the start of the next line. If there is no line break
+here then TeX puts NO-BREAK
- This command cancels the effect of a previous '\sloppy' command
-(*note \sloppy::).
+ In 'difficult' the three letters 'ffi' form a ligature. But TeX can
+nonetheless break between the two f's with this.
-9.7 '\sloppy'
-=============
+ di\discretionary{f-}{fi}{ffi}cult
-The declaration '\sloppy' makes TeX less fussy about line breaking.
-This will avoid overfull boxes, at the cost of loose interword spacing.
+ Note that users do not have to do this. It is typically handled
+automatically by TeX's hyphenation algorithm.
- Lasts until a '\fussy' command is issued (*note \fussy::).
+9.6 '\fussy' & '\sloppy'
+========================
-9.8 '\hyphenation'
+Declarations to make TeX more picky or less picky about line breaking.
+Declaring '\fussy' usually avoids too much space between words, at the
+cost of an occasional overfull box. Conversely, '\sloppy' avoids
+overfull boxes while suffering loose interword spacing.
+
+ The default is '\fussy'. Line breaking in a paragraph is controlled
+by whichever declaration is current at the blank line, or '\par', or
+displayed equation ending that paragraph. So to affect the line breaks,
+include that paragraph-ending material in the scope of the command.
+
+9.6.1 'sloppypar'
+-----------------
+
+Synopsis:
+
+ \begin{sloppypar}
+ ... paragraphs ...
+ \end{sloppypar}
+
+ Typeset the paragraphs with '\sloppy' in effect (*note \fussy &
+\sloppy::). Use this to locally adjust line breaking, to avoid
+'Overfull box' or 'Underfull box' errors.
+
+ The example is simple.
+
+ \begin{sloppypar}
+ Her plan for the morning thus settled, she sat quietly down to her
+ book after breakfast, resolving to remain in the same place and the
+ same employment till the clock struck one; and from habitude very
+ little incommoded by the remarks and ejaculations of Mrs.\ Allen,
+ whose vacancy of mind and incapacity for thinking were such, that
+ as she never talked a great deal, so she could never be entirely
+ silent; and, therefore, while she sat at her work, if she lost her
+ needle or broke her thread, if she heard a carriage in the street,
+ or saw a speck upon her gown, she must observe it aloud, whether
+ there were anyone at leisure to answer her or not.
+ \end{sloppypar}
+
+9.7 '\hyphenation'
==================
Synopsis:
- \hyphenation{WORD-ONE WORD-TWO}
+ \hyphenation{WORD1 ...}
+
+ Declares allowed hyphenation points within the words in the list.
+The words in that list are separated by spaces. Show permitted points
+for hyphenation with a dash character, '-'.
+
+ Here is an example:
- The '\hyphenation' command declares allowed hyphenation points with a
-'-' character in the given words. The words are separated by spaces.
-TeX will only hyphenate if the word matches exactly, no inflections are
-tried. Multiple '\hyphenation' commands accumulate. Some examples (the
-default TeX hyphenation patterns misses the hyphenations in these
-words):
+ \hyphenation{hat-er il-lit-e-ra-ti tru-th-i-ness}
- \hyphenation{ap-pen-dix col-umns data-base data-bases}
+ Use lowercase letters. TeX will only hyphenate if the word matches
+exactly. Multiple '\hyphenation' commands accumulate.
-9.9 '\linebreak' & '\nolinebreak'
+9.8 '\linebreak' & '\nolinebreak'
=================================
-Synopses:
+Synopses, one of:
+
+ \linebreak
+ \linebreak[ZERO-TO-FOUR]
+
+or one of these.
+
+ \nolinebreak
+ \nolinebreak[ZERO-TO-FOUR]
- \linebreak[PRIORITY]
- \nolinebreak[PRIORITY]
+ Encourage or discourage a line break. The optional ZERO-TO-FOUR is
+an integer that allows you to soften the instruction. The default is 4,
+so that without the optional argument these commands entirely force or
+prevent the break. But for instance, '\nolinebreak[1]' is a suggestion
+that another place may be better. The higher the number, the more
+insistent the request. Both commands are fragile (*note \protect::).
- By default, the '\linebreak' ('\nolinebreak') command forces
-(prevents) a line break at the current position. For '\linebreak', the
-spaces in the line are stretched out so that it extends to the right
-margin as usual.
+ Here we tell LaTeX that a good place to put a linebreak is after the
+standard legal text.
- With the optional argument PRIORITY, you can convert the command from
-a demand to a request. The PRIORITY must be a number from 0 to 4. The
-higher the number, the more insistent the request.
+ \boilerplatelegal{} \linebreak[2]
+ We especially encourage applications from members of traditionally
+ underrepresented groups.
+
+ When you issue '\linebreak', the spaces in the line are stretched out
+so that it extends to the right margin. *Note \\:: and *note \newline::
+to have the spaces not stretched out.
10 Page breaking
****************
-LaTeX starts new pages asynchronously, when enough material has
-accumulated to fill up a page. Usually this happens automatically, but
-sometimes you may want to influence the breaks.
+Ordinarily LaTeX automatically takes care of breaking output into pages
+with its usual aplomb. But if you are writing commands, or tweaking the
+final version of a document, then you may need to understand how to
+influence its actions.
+
+ LaTeX's algorithm for splitting a document into pages is more complex
+than just waiting until there is enough material to fill a page and
+outputting the result. Instead, LaTeX typesets more material than would
+fit on the page and then chooses a break that is optimal in some way (it
+has the smallest badness). An example of the advantage of this approach
+is that if the page has some vertical space that can be stretched or
+shrunk, such as with rubber lengths between paragraphs, then LaTeX can
+use that to avoid widow lines (where a new page starts with the last
+line of a paragraph; LaTeX can squeeze the extra line onto the first
+page) and orphans (where the first line of paragraph is at the end of a
+page; LaTeX can stretch the material of the first page so the extra line
+falls on the second page). Another example is where LaTeX uses
+available vertical shrinkage to fit on a page not just the header for a
+new section but also the first two lines of that section.
+
+ But LaTeX does not optimize over the entire document's set of page
+breaks. So it can happen that the first page break is great but the
+second one is lousy; to break the current page LaTeX doesn't look as far
+ahead as the next page break. So occasionally you may want to influence
+page breaks while preparing a final version of a document.
+
+ *Note Layout:: for more material that is relevant to page breaking.
+
+10.1 '\clearpage' & '\cleardoublepage'
+======================================
-10.1 '\cleardoublepage'
-=======================
+Synopsis:
-The '\cleardoublepage' command ends the current page and causes all the
-pending floating figures and tables that have so far appeared in the
-input to be printed. In a two-sided printing style, it also makes the
-next page a right-hand (odd-numbered) page, producing a blank page if
-necessary.
+ \clearpage
-10.2 '\clearpage'
-=================
+or
+
+ \cleardoublepage
+
+ End the current page and output all of the pending floating figures
+and tables (*note Floats::). If there are too many floats to fit on the
+page then LaTeX will put in extra pages containing only floats. In
+two-sided printing, '\cleardoublepage' also makes the next page of
+content a right-hand page, an odd-numbered page, if necessary inserting
+a blank page. The '\clearpage' command is robust while
+'\cleardoublepage' is fragile (*note \protect::).
-The '\clearpage' command ends the current page and causes all the
-pending floating figures and tables that have so far appeared in the
-input to be printed.
+ LaTeX's page breaks are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+
+ The '\cleardoublepage' command will put in a blank page, but it will
+have the running headers and footers. To get a really blank page, use
+this command.
+
+ \let\origdoublepage\cleardoublepage
+ \newcommand{\clearemptydoublepage}{%
+ \clearpage
+ {\pagestyle{empty}\origdoublepage}%
+ }
-10.3 '\newpage'
+If you want LaTeX's standard '\chapter' command to do this then add the
+line '\let\cleardoublepage\clearemptydoublepage'.
+
+ The command '\newpage' (*note \newpage::) also ends the current page,
+but without clearing pending floats. And, if LaTeX is in two-column
+mode then '\newpage' ends the current column while '\clearpage' and
+'\cleardoublepage' end the current page.
+
+10.2 '\newpage'
===============
-The '\newpage' command ends the current page, but does not clear floats
-(*note \clearpage::).
+Synopsis:
+
+ \newpage
+
+ End the current page. This command is robust (*note \protect::).
+
+ LaTeX's page breaks are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+
+ While the commands '\clearpage' and '\cleardoublepage' also end the
+current page, in addition they clear pending floats (*note \clearpage &
+\cleardoublepage::). And, if LaTeX is in two-column mode then
+'\clearpage' and '\cleardoublepage' end the current page, possibly
+leaving an empty column, while '\newpage' only ends the current column.
+
+ In contrast with '\pagebreak' (*note \pagebreak & \nopagebreak::),
+the '\newpage' command will cause the new page to start right where
+requested. This
+
+ Four score and seven years ago our fathers brought forth on this
+ continent,
+ \newpage
+ \noindent a new nation, conceived in Liberty, and dedicated to the
+ proposition that all men are created equal.
+
+makes a new page start after 'continent,' and the cut-off line is not
+right justified. In addition, '\newpage' does not vertically stretch
+out the page, as '\pagebreak' does.
-10.4 '\enlargethispage'
+10.3 '\enlargethispage'
=======================
-'\enlargethispage{size}'
+Synopsis, one of:
+
+ \enlargethispage{size}
+ \enlargethispage*{size}
+
+ Enlarge the '\textheight' for the current page. The required
+argument SIZE must be a rigid length (*note Lengths::). It may be
+positive or negative. This command is fragile (*note \protect::).
+
+ A common strategy is to wait until you have the final text of a
+document, and then pass through it tweaking line and page breaks. This
+command allows you some page size leeway.
- '\enlargethispage*{size}'
+ This will allow one extra line on the current page.
- Enlarge the '\textheight' for the current page by the specified
-amount; e.g., '\enlargethispage{\baselineskip}' will allow one
-additional line.
+ \enlargethispage{\baselineskip}
- The starred form tries to squeeze the material together on the page
-as much as possible. This is normally used together with an explicit
-'\pagebreak'.
+ The starred form '\enlargesthispage*' tries to squeeze the material
+together on the page as much as possible, for the common use case of
+getting one more line on the page. This is often used together with an
+explicit '\pagebreak'.
-10.5 '\pagebreak' & '\nopagebreak'
+10.4 '\pagebreak' & '\nopagebreak'
==================================
Synopses:
- \pagebreak[PRIORITY]
- \nopagebreak[PRIORITY]
+ \pagebreak
+ \pagebreak[ZERO-TO-FOUR]
- By default, the '\pagebreak' ('\nopagebreak') command forces
-(prevents) a page break at the current position. With '\pagebreak', the
-vertical space on the page is stretched out where possible so that it
-extends to the normal bottom margin.
+or
+
+ \nopagebreak
+ \nopagebreak[ZERO-TO-FOUR]
+
+ Encourage or discourage a page break. The optional ZERO-TO-FOUR is
+an integer that allows you to soften the request. The default is 4, so
+that without the optional argument these commands entirely force or
+prevent the break. But for instance '\nopagebreak[1]' suggests to LaTeX
+that another spot might be preferable. The higher the number, the more
+insistent the request. Both commands are fragile (*note \protect::).
+
+ LaTeX's page endings are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+
+ If you use these inside a paragraph, they apply to the point
+following the line in which they appear. So this
- With the optional argument PRIORITY, you can convert the '\pagebreak'
-command from a demand to a request. The number must be a number from 0
-to 4. The higher the number, the more insistent the request is.
+ Four score and seven years ago our fathers brought forth on this
+ continent,
+ \pagebreak
+ a new nation, conceived in Liberty, and dedicated to the proposition
+ that all men are created equal.
+
+does not give a page break at 'continent,' but instead at 'nation,'
+since that is where LaTeX breaks that line. In addition, with
+'\pagebreak' the vertical space on the page is stretched out where
+possible so that it extends to the normal bottom margin. This can look
+strange, and if '\flushbottom' is in effect this can cause you to get
+'Underfull \vbox (badness 10000) has occurred while \output is active'.
+*Note \newpage:: for a command that does not have these effects.
11 Footnotes
************
-Place a numbered footnote at the bottom of the current page, as here.
+Place a footnote at the bottom of the current page, as here.
Noe"l Coward quipped that having to read a footnote is like having
to go downstairs to answer the door, while in the midst of making
- love.\footnote{I wouldn't know, I don't read footnotes.}
+ love.\footnote{%
+ I wouldn't know, I don't read footnotes.}
- You can place multiple footnotes on a page. If the text becomes too
-long it will flow to the next page.
+ You can put multiple footnotes on a page. If the footnote text
+becomes too long then it will flow to the next page.
You can also produce footnotes by combining the '\footnotemark' and
the '\footnotetext' commands, which is useful in special circumstances.
To make bibliographic references come out as footnotes you need to
-include a bibliographic style with that behavior.
+include a bibliographic style with that behavior (*note Using BibTeX::).
11.1 '\footnote'
================
-Synopsis:
+Synopsis, one of:
+ \footnote{TEXT}
\footnote[NUMBER]{TEXT}
- Place a numbered footnote TEXT at the bottom of the current page.
+ Place a footnote TEXT at the bottom of the current page.
There are over a thousand footnotes in Gibbon's
- \textit{Decline and Fall of the Roman Empire}.\footnote{After
- reading an early version with endnotes David Hume complained,
- ``One is also plagued with his Notes, according to the present Method
- of printing the Book'' and suggested that they ``only to be printed
- at the Margin or the Bottom of the Page.''}
-
- The optional argument NUMBER allows you to specify the footnote
-number. If you use this option then the footnote number counter is not
-incremented, and if you do not use it then the counter is incremented.
+ \textit{Decline and Fall of the Roman Empire}.\footnote{%
+ After reading an early version with endnotes David Hume complained,
+ ``One is also plagued with his Notes, according to the present Method
+ of printing the Book'' and suggested that they ``only to be printed
+ at the Margin or the Bottom of the Page.''}
+
+ The optional argument NUMBER allows you to specify the number of the
+footnote. If you use this then LaTeX does not increment the 'footnote'
+counter.
- Change how LaTeX shows the footnote counter with something like
+ By default, LaTeX uses arabic numbers as footnote markers. Change
+this with something like
'\renewcommand{\thefootnote}{\fnsymbol{footnote}}', which uses a
sequence of symbols (*note \alph \Alph \arabic \roman \Roman
\fnsymbol::). To make this change global put that in the preamble. If
you make the change local then you may want to reset the counter with
-'\setcounter{footnote}{0}'. By default LaTeX uses arabic numbers.
+'\setcounter{footnote}{0}'.
+
+ LaTeX determines the spacing of footnotes with two parameters.
+
+'\footnoterule'
+ Produces the rule separating the main text on a page from the
+ page's footnotes. Default dimensions in the standard document
+ classes (except 'slides', where it does not appear) is: vertical
+ thickness of '0.4pt', and horizontal size of '0.4\columnwidth'
+ long. Change the rule with something like this.
+
+ \renewcommand{\footnoterule}{% Kerns avoid vertical space
+ \kern -3pt % This -3 is negative
+ \hrule width \textwidth height 1pt % of the sum of this 1
+ \kern 2pt} % and this 2
+
+'\footnotesep'
+ The height of the strut placed at the beginning of the footnote
+ (*note \strut::). By default, this is set to the normal strut for
+ '\footnotesize' fonts (*note Font sizes::), therefore there is no
+ extra space between footnotes. This is '6.65pt' for '10pt',
+ '7.7pt' for '11pt', and '8.4pt' for '12pt'. Change it as with
+ '\setlength{\footnotesep}{11pt}'.
+
+ The '\footnote' command is fragile (*note \protect::).
LaTeX's default puts many restrictions on where you can use a
'\footnote'; for instance, you cannot use it in an argument to a
sectioning command such as '\chapter' (it can only be used in outer
-paragraph mode). There are some workarounds; see following sections.
+paragraph mode; *note Modes::). There are some workarounds; see
+following sections.
In a 'minipage' environment the '\footnote' command uses the
'mpfootnote' counter instead of the 'footnote' counter, so they are
numbered independently. They are shown at the bottom of the
environment, not at the bottom of the page. And by default they are
-shown alphabetically. *Note minipage::.
+shown alphabetically. *Note minipage:: and *note Footnotes in a
+table::.
11.2 '\footnotemark'
====================
@@ -4749,13 +6291,24 @@ Synopsis, one of:
\footnotemark
\footnotemark[NUMBER]
- Put the current footnote number in the text. (See *note
-\footnotetext:: for giving the text of the footnote separately.) The
-version with the optional argument NUMBER uses that number to determine
-the mark printed. This command can be used in inner paragraph mode.
+ Put the current footnote mark in the text. To specify associated
+text for the footnote see *note \footnotetext::. The optional argument
+NUMBER causes the command to use that number to determine the footnote
+mark. This command can be used in inner paragraph mode (*note Modes::).
- This example gives the same institutional affiliation to both the
-first and third authors ('\thanks' is a version of 'footnote').
+ If you use '\footnotemark' without the optional argument then it
+increments the footnote counter but if you use the optional NUMBER then
+it does not. The next example produces several consecutive footnote
+markers referring to the same footnote.
+
+ The first theorem\footnote{Due to Gauss.}
+ and the second theorem\footnotemark[\value{footnote}]
+ and the third theorem.\footnotemark[\value{footnote}]
+
+ If there are intervening footnotes then you must remember the value
+of the common mark. This example gives the same institutional
+affiliation to both the first and third authors ('\thanks' is a version
+of 'footnote'), by-hand giving the number of the footnote.
\title{A Treatise on the Binomial Theorem}
\author{J Moriarty\thanks{University of Leeds}
@@ -4764,14 +6317,27 @@ first and third authors ('\thanks' is a version of 'footnote').
\begin{document}
\maketitle
- If you use '\footnotemark' without the optional argument then it
-increments the footnote counter but if you use the optional NUMBER then
-it does not. This produces several consecutive footnote markers
-referring to the same footnote.
+ This uses a counter to remember the footnote number. The third
+sentence is followed by the same footnote marker as the first.
- The first theorem\footnote{Due to Gauss.}
- and the second theorem\footnotemark[\value{footnote}]
- and the third theorem.\footnotemark[\value{footnote}]
+ \newcounter{footnoteValueSaver}
+ All babies are illogical.\footnote{%
+ Lewis Carroll.}\setcounter{footnoteValueSaver}{\value{footnote}}
+ Nobody is despised who can manage a crocodile.\footnote{%
+ Captain Hook.}
+ Illogical persons are despised.\footnotemark[\value{footnoteValueSaver}]
+ Therefore, anyone who can manage a crocodile is not a baby.
+
+ This example accomplishes the same by using the package 'cleveref'.
+
+ \usepackage{cleveref}[2012/02/15] % in preamble
+ \crefformat{footnote}{#2\footnotemark[#1]#3}
+ ...
+ The theorem is from Evers.\footnote{\label{fn:TE}Tinker, Evers, 1994.}
+ The corollary is from Chance.\footnote{Evers, Chance, 1990.}
+ But the key lemma is from Tinker.\cref{fn:TE}
+
+ It will work with the package 'hyperref'.
11.3 '\footnotetext'
====================
@@ -4781,78 +6347,102 @@ Synopsis, one of:
\footnotetext{TEXT}
\footnotetext[NUMBER]{TEXT}
- Place TEXT at the bottom of the page as a footnote. This command can
-come anywhere after the '\footnotemark' command. The optional argument
-NUMBER changes the displayed footnote number. The '\footnotetext'
-command must appear in outer paragraph mode.
+ Place TEXT at the bottom of the page as a footnote. It pairs with
+'\footnotemark' (*note \footnotemark::) and can come anywhere after that
+command, but must appear in outer paragraph mode (*note Modes::). The
+optional argument NUMBER changes the number of the footnote mark.
-11.4 Footnotes in a table
+ *Note \footnotemark:: and *note Footnotes in a table:: for usage
+examples.
+
+11.4 Footnotes in section headings
+==================================
+
+Putting a footnote in a section heading, as in:
+
+ \section{Full sets\protect\footnote{This material due to ...}}
+
+causes the footnote to appear at the bottom of the page where the
+section starts, as usual, but also at the bottom of the table of
+contents, where it is not likely to be desired. The simplest way to
+have it not appear on the table of contents is to use the optional
+argument to '\section'
+
+ \section[Please]{Please\footnote{%
+ Don't footnote in chapter and section headers!}}
+
+No '\protect' is needed in front of '\footnote' here because what gets
+moved to the table of contents is the optional argument.
+
+11.5 Footnotes in a table
=========================
-Inside a 'table' environment the '\footnote' command does not work. For
-instance, if the code below appears on its own then the footnote simply
-disappears; there is a footnote mark in the table cell but nothing is
-set at the bottom of the page.
+Inside a 'tabular' or 'array' environment the '\footnote' command does
+not work; there is a footnote mark in the table cell but the footnote
+text does not appear. The solution is to use a 'minipage' environment
+as here (*note minipage::).
\begin{center}
+ \begin{minipage}{\textwidth} \centering
\begin{tabular}{l|l}
- \textsc{Ship} &\textsc{Book} \\ \hline
- \textit{HMS Sophie} &Master and Commander \\
- \textit{HMS Polychrest} &Post Captain \\
- \textit{HMS Lively} &Post Captain \\
- \textit{HMS Surprise} &A number of books\footnote{Starting with
- HMS Surprise.}
+ \textsc{Ship} &\textsc{Book} \\ \hline
+ \textit{HMS Sophie} &Master and Commander \\
+ \textit{HMS Polychrest} &Post Captain \\
+ \textit{HMS Lively} &Post Captain \\
+ \textit{HMS Surprise} &A number of books\footnote{%
+ Starting with HMS Surprise.}
\end{tabular}
+ \end{minipage}
\end{center}
- The solution is to surround the 'tabular' environment with a
-'minipage' environment, as here (*note minipage::).
+ Inside a 'minipage', footnote marks are lowercase letters. Change
+that with something like
+'\renewcommand{\thempfootnote}{\arabic{mpfootnote}}' (*note \alph \Alph
+\arabic \roman \Roman \fnsymbol::).
+
+ The footnotes in the prior example appear at the bottom of the
+'minipage'. To have them appear at the bottom of the main page, as part
+of the regular footnote sequence, use the '\footnotemark' and
+'\footnotetext' pair and make a new counter.
+ \newcounter{mpFootnoteValueSaver}
\begin{center}
- \begin{minipage}{.5\textwidth}
- ... tabular material ...
- \end{minipage}
+ \begin{minipage}{\textwidth}
+ \setcounter{mpFootnoteValueSaver}{\value{footnote}} \centering
+ \begin{tabular}{l|l}
+ \textsc{Woman} &\textsc{Relationship} \\ \hline
+ Mona &Attached\footnotemark \\
+ Diana Villiers &Eventual wife \\
+ Christine Hatherleigh Wood &Fiance\footnotemark
+ \end{tabular}
+ \end{minipage}% percent sign keeps footnote text close to minipage
+ \stepcounter{mpFootnoteValueSaver}%
+ \footnotetext[\value{mpFootnoteValueSaver}]{%
+ Little is known other than her death.}%
+ \stepcounter{mpFootnoteValueSaver}%
+ \footnotetext[\value{mpFootnoteValueSaver}]{%
+ Relationship is unresolved in XXI.}
\end{center}
- The same technique will work inside a floating 'table' environment
-(*note table::). To get the footnote at the bottom of the page use the
-'tablefootnote' package, as illustrated in this example. If you put
-'\usepackage{tablefootnote}' in the preamble and use the code shown then
-the footnote appears at the bottom and is numbered in sequence with
-other footnotes.
+ For a floating 'table' environment (*note table::), use the
+'tablefootnote' package.
+ \usepackage{tablefootnote} % in preamble
+ ...
\begin{table}
\centering
\begin{tabular}{l|l}
\textsc{Date} &\textsc{Campaign} \\ \hline
1862 &Fort Donelson \\
1863 &Vicksburg \\
- 1865 &Army of Northern Virginia\footnote{Ending the war.}
+ 1865 &Army of Northern Virginia\tablefootnote{%
+ Ending the war.}
\end{tabular}
\caption{Forces captured by US Grant}
\end{table}
-11.5 Footnotes in section headings
-==================================
-
-Putting a footnote in a section heading, as in:
-
- \section{Full sets\protect\footnote{This material due to ...}}
-
-causes the footnote to appear at the bottom of the page where the
-section starts, as usual, but also at the bottom of the table of
-contents, where it is not likely to be desired. To have it not appear
-on the table of contents use the package 'footmisc' with the 'stable'
-option.
-
- \usepackage[stable]{footmisc}
- ...
- \begin{document}
- ...
- \section{Full sets\footnote{This material due to ...}}
-
- Note that the '\protect' is gone; including it would cause the
-footnote to reappear on the table of contents.
+The footnote appears at the page bottom and is numbered in sequence with
+other footnotes.
11.6 Footnotes of footnotes
===========================
@@ -4862,51 +6452,13 @@ footnotes, including having footnotes of footnotes. The package
'bigfoot' extends LaTeX's default footnote mechanism in many ways,
including allow these two, as in this example.
- \usepackage{bigfoot}
+ \usepackage{bigfoot} % in preamble
\DeclareNewFootnote{Default}
\DeclareNewFootnote{from}[alph] % create class \footnotefrom{}
...
- \begin{document}
- ...
The third theorem is a partial converse of the
- second.\footnotefrom{First noted in Wilson.\footnote{Second edition only.}}
- ...
-
-11.7 Multiple references to footnotes
-=====================================
-
-You can refer to a single footnote more than once. This example uses
-the package 'cleverref'.
-
- \usepackage{cleveref}[2012/02/15] % this version of package or later
- \crefformat{footnote}{#2\footnotemark[#1]#3}
- ...
- \begin{document}
- ...
- The theorem is from Evers.\footnote{\label{fn:TE}Tinker and Evers, 1994.}
- The corollary is from Chance.\footnote{Evers and Chance, 1990.}
- But the key lemma is from Tinker.\cref{fn:TE}
- ...
-
- This solution will work with the package 'hyperref'. See *note
-\footnotemark:: for a simpler solution in the common case of multiple
-authors with the same affiliation.
-
-11.8 Footnote parameters
-========================
-
-'\footnoterule'
- Produces the rule separating the main text on a page from the
- page's footnotes. Default dimensions: '0.4pt' thick (or wide), and
- '0.4\columnwidth' long in the standard document classes (except
- 'slides', where it does not appear).
-
-'\footnotesep'
- The height of the strut placed at the beginning of the footnote.
- By default, this is set to the normal strut for '\footnotesize'
- fonts (*note Font sizes::), therefore there is no extra space
- between footnotes. This is '6.65pt' for '10pt', '7.7pt' for
- '11pt', and '8.4pt' for '12pt'.
+ second.\footnotefrom{%
+ First noted in Wilson.\footnote{Second edition only.}}
12 Definitions
**************
@@ -4916,108 +6468,155 @@ LaTeX has support for making new commands of many different kinds.
12.1 '\newcommand' & '\renewcommand'
====================================
-'\newcommand' and '\renewcommand' define and redefine a command,
-respectively. Synopses:
+Synopses, one of:
+
+ \newcommand{\CMD}{DEFN}
+ \newcommand{\CMD}[NARGS]{DEFN}
+ \newcommand{\CMD}[NARGS][OPTARGDEFAULT]{DEFN}
+ \newcommand*{\CMD}{DEFN}
+ \newcommand*{\CMD}[NARGS]{DEFN}
+ \newcommand*{\CMD}[NARGS][OPTARGDEFAULT]{DEFN}
- \newcommand{\CMD}[NARGS][OPTARGDEFAULT]{DEFN}
- \newcommand*{\CMD}[NARGS][OPTARGDEFAULT]{DEFN}
+or one of these.
+
+ \renewcommand{\CMD}[NARGS]{DEFN}
+ \renewcommand{\CMD}[NARGS]{DEFN}
\renewcommand{\CMD}[NARGS][OPTARGDEFAULT]{DEFN}
+ \renewcommand*{\CMD}{DEFN}
+ \renewcommand*{\CMD}[NARGS]{DEFN}
\renewcommand*{\CMD}[NARGS][OPTARGDEFAULT]{DEFN}
- The starred form of these two commands requires that the arguments
-not contain multiple paragraphs of text (not '\long', in plain TeX
-terms).
+ Define or redefine a command. See also the discussion of
+'\DeclareRobustCommand' in *note Class and package commands::. The
+starred form of these two requires that the arguments not contain
+multiple paragraphs of text (in plain TeX terms that it not be '\long').
+
+ These are the parameters:
CMD
- Required; '\CMD' is the command name. For '\newcommand', it must
- not be already defined and must not begin with '\end'. For
- '\renewcommand', it must already be defined.
+
+ Required; the command name. It must begin with a backslash, '\',
+ and must not begin with the four letter string '\end'. For
+ '\newcommand', it must not be already defined. For
+ '\renewcommand', this name must already be defined.
NARGS
Optional; an integer from 0 to 9, specifying the number of
- arguments that the command can take, including any optional
- argument. If this argument is not present, the default is for the
- command to have no arguments. When redefining a command, the new
+ arguments that the command takes, including any optional argument.
+ Omitting this argument is the same as specifying 0, meaning that
+ the command has no arguments. If you redefine a command, the new
version can have a different number of arguments than the old
version.
OPTARGDEFAULT
Optional; if this argument is present then the first argument of
- defined command '\CMD' is optional, with default value
- OPTARGDEFAULT (which may be the empty string). If this argument is
- not present then '\CMD' does not take an optional argument.
-
- That is, if '\CMD' is used with square brackets following, as in
- '\CMD[MYVAL]', then within DEFN the first "positional parameter"
- '#1' expands MYVAL. On the other hand, if '\CMD' is called without
- square brackets following, then within DEFN the positional
- parameter '#1' expands to the default OPTARGDEFAULT. In either
- case, any required arguments will be referred to starting with
- '#2'.
-
- Omitting '[MYVAL]' in a call is different from having the square
- brackets with no contents, as in '[]'. The former results in '#1'
- expanding to OPTARGDEFAULT; the latter results in '#1' expanding to
- the empty string.
+ '\CMD' is optional, with default value OPTARGDEFAULT (which may be
+ the empty string). If this argument is not present then '\CMD'
+ does not take an optional argument.
+
+ That is, if '\CMD' is used with square brackets, as in
+ '\CMD[OPTVAL]{...}...', then within DEFN the parameter '#1' is set
+ to the value of OPTVAL. On the other hand, if '\CMD' is called
+ without the square brackets then within DEFN the parameter '#1' is
+ set to the value of OPTARGDEFAULT. In either case, the required
+ arguments start with '#2'.
+
+ Omitting '[OPTARGDEFAULT]' is different from having the square
+ brackets with no contents, as in '[]'. The former sets '#1' to the
+ value of OPTARGDEFAULT; the latter sets '#1' to the empty string.
DEFN
- The text to be substituted for every occurrence of '\CMD'; the
- positional parameter '#N' in DEFN is replaced by the text of the
- Nth argument.
+ Required; the text to be substituted for every occurrence of
+ '\CMD'. The parameters '#1', '#2', ... '#NARGS' are replaced by
+ the values that you supply when you call the command (or by the
+ default value if there is an optional argument and you don't
+ exercise the option).
TeX ignores spaces in the source following an alphabetic control
sequence, as in '\cmd '. If you actually want a space there, one
-solution is to type '{}' after the command ('\cmd{} '; another solution
-is to use an explicit control space ('\cmd\ ').
+solution is to type '{}' after the command ('\cmd{} ', and another
+solution is to use an explicit control space ('\cmd\ ').
A simple example of defining a new command: '\newcommand{\RS}{Robin
-Smith}' results in '\RS' being replaced by the longer text.
+Smith}' results in '\RS' being replaced by the longer text. Redefining
+an existing command is similar: '\renewcommand{\qedsymbol}{{\small
+QED}}'.
- Redefining an existing command is similar:
-'\renewcommand{\qedsymbol}{{\small QED}}'.
+ If you try to define a command and the name has already been used
+then you get something like 'LaTeX Error: Command \fred already defined.
+Or name \end... illegal, see p.192 of the manual'. If you try to
+redefine a command and the name has not yet been used then you get
+something like 'LaTeX Error: \hank undefined'.
- Here's a command definition with one required argument:
+ Here the first command definition has no arguments, and the second
+has one required argument.
+ \newcommand{\student}{Ms~O'Leary}
\newcommand{\defref}[1]{Definition~\ref{#1}}
-Then, '\defref{def:basis}' expands to 'Definition~\ref{def:basis}',
-which will ultimately expand to something like 'Definition~3.14'.
+Use the first as in 'I highly recommend \student{} to you'. The second
+has a variable, so that '\defref{def:basis}' expands to
+'Definition~\ref{def:basis}', which ultimately expands to something like
+'Definition~3.14'.
- An example with two required arguments: '\newcommand{\nbym}[2]{$#1
-\times #2$}' is invoked as '\nbym{2}{k}'.
+ Similarly, but with two required arguments:
+'\newcommand{\nbym}[2]{$#1 \times #2$}' is invoked as '\nbym{2}{k}'.
- An example with an optional argument:
+ This example has an optional argument.
\newcommand{\salutation}[1][Sir or Madam]{Dear #1:}
-Then, '\salutation' gives 'Dear Sir or Madam:' while '\salutation[John]'
+Then '\salutation' gives 'Dear Sir or Madam:' while '\salutation[John]'
gives 'Dear John:'. And '\salutation[]' gives 'Dear :'.
+ This example has an optional argument and two required arguments.
+
+ \newcommand{\lawyers}[3][company]{#2, #3, and~#1}
+ I employ \lawyers[Howe]{Dewey}{Cheatem}.
+
+The output is 'I employ Dewey, Cheatem, and Howe'. The optional
+argument, the 'Howe', is associated with '#1', while 'Dewey' and
+'Cheatem' are associated with '#2' and '#3'. Because of the optional
+argument, '\lawyers{Dewey}{Cheatem}' will give the output 'I employ
+Dewey, Cheatem, and company'.
+
The braces around DEFN do not define a group, that is, they do not
-delimit the scope of the result of expanding DEFN. So
-'\newcommand{\shipname}[1]{\it #1}' is problematic; in this sentence,
+delimit the scope of the result of expanding DEFN. For example, with
+'\newcommand{\shipname}[1]{\it #1}', in this sentence,
The \shipname{Monitor} met the \shipname{Merrimac}.
-the words 'met the' would incorrectly be in italics. Another pair of
-braces in the definition is needed, like this:
-'\newcommand{\shipname}[1]{{\it #1}}'. Those braces are part of the
-definition and thus do define a group.
+the words 'met the' would incorrectly be in italics. The solution is to
+put another pair of braces inside the definition:
+'\newcommand{\shipname}[1]{{\it #1}}'.
12.2 '\providecommand'
======================
-Defines a command, as long as no command of this name already exists.
-Synopses:
+Synopses, one of:
+ \providecommand{CMD}{DEFN}
+ \providecommand{CMD}[NARGS]{DEFN}
\providecommand{CMD}[NARGS][OPTARGDEFAULT]{DEFN}
+ \providecommand*{CMD}{DEFN}
+ \providecommand*{CMD}[NARGS]{DEFN}
\providecommand*{CMD}[NARGS][OPTARGDEFAULT]{DEFN}
- If no command of this name already exists then this has the same
-effect as '\newcommand' (*note \newcommand & \renewcommand::). If a
-command of this name already exists then this definition does nothing.
-This is particularly useful in a style file, or other file that may be
-loaded more than once.
+ Defines a command, as long as no command of this name already exists.
+If no command of this name already exists then this has the same effect
+as '\newcommand'. If a command of this name already exists then this
+definition does nothing. This is particularly useful in a file that may
+be loaded more than once, such as a style file. *Note \newcommand &
+\renewcommand:: for the description of the arguments.
+
+ This example
+
+ \providecommand{\myaffiliation}{Saint Michael's College}
+ \providecommand{\myaffiliation}{Saint Michael's College}
+ From \myaffiliation.
+
+outputs 'From Saint Michael's College'. Unlike '\newcommand', the
+repeated use of '\providecommand' does not give an error.
12.3 '\newcounter': Allocating a counter
========================================
@@ -5027,70 +6626,119 @@ Synopsis, one of:
\newcounter{COUNTERNAME}
\newcounter{COUNTERNAME}[SUPERCOUNTER]
- Globally defines a new counter named COUNTERNAME and initialize the
-new counter to zero.
+ Globally defines a new counter named COUNTERNAME and initialize it to
+zero (*note Counters::).
- The name COUNTERNAME must consists of letters only, and does not
-begin with a backslash. This name must not already be in use by another
+ The name COUNTERNAME must consist of letters only. It does not begin
+with a backslash. This name must not already be in use by another
counter.
- When you use the optional argument '[SUPERCOUNTER]' then COUNTERNAME
-will be numbered within, or subsidiary to, the existing counter
-SUPERCOUNTER. For example, ordinarily 'subsection' is numbered within
-'section' so that any time SUPERCOUNTER is incremented with
-'\stepcounter' (*note \stepcounter::) or '\refstepcounter' (*note
-\refstepcounter::) then COUNTERNAME is reset to zero.
+ When you use the optional argument '[SUPERCOUNTER]' then the counter
+COUNTERNAME will be reset to zero whenever SUPERCOUNTER is incremented.
+For example, ordinarily 'subsection' is numbered within 'section' so
+that any time you increment SECTION, either with '\stepcounter' (*note
+\stepcounter::) or '\refstepcounter' (*note \refstepcounter::), then
+LaTeX will reset SUBSECTION to zero.
- *Note Counters::, for more information about counters.
+ This example
-12.4 '\newlength': Allocating a length
-======================================
+ \newcounter{asuper} \setcounter{asuper}{1}
+ \newcounter{asub}[asuper] \setcounter{asub}{3} % Note `asuper'
+ The value of asuper is \arabic{asuper} and of asub is \arabic{asub}.
+ \stepcounter{asuper}
+ Now asuper is \arabic{asuper} while asub is \arabic{asub}.
-Allocate a new "length" register. Synopsis:
+ produces 'The value of asuper is 1 and that of asub is 3' and 'Now
+asuper is 2 while asub is 0'.
- \newlength{\ARG}
+ If the counter already exists, for instance by entering 'asuper'
+twice, then you get something like 'LaTeX Error: Command \c@asuper
+already defined. Or name \end... illegal, see p.192 of the manual.'.
- This command takes one required argument, which must begin with a
-backslash ('\'). It creates a new length register named '\ARG', which
-is a place to hold (rubber) lengths such as '1in plus.2in minus.1in'
-(what plain TeX calls a 'skip' register). The register gets an initial
-value of zero. The control sequence '\ARG' must not already be defined.
+ If you use the optional argument then the super counter must already
+exist. Entering '\newcounter{jh}[lh]' when 'lh' is not a defined
+counter will get you 'LaTeX Error: No counter 'lh' defined.'
- *Note Lengths::, for more about lengths.
+12.4 '\newlength'
+=================
-12.5 '\newsavebox': Allocating a box
-====================================
+Synopsis:
-Allocate a "bin" for holding a box. Synopsis:
+ \newlength{ARG}
- \newsavebox{\CMD}
+ Allocate a new length register (*note Lengths::). The required
+argument ARG must begin with a backslash, '\'. The new register holds
+rubber lengths such as '72.27pt' or '1in plus.2in minus.1in' (a LaTeX
+length register is what plain TeX calls a 'skip' register). The initial
+value is zero. The control sequence '\ARG' must not be already defined.
- Defines '\CMD' to refer to a new bin for storing boxes. Such a box
-is for holding typeset material, to use multiple times (*note Boxes::)
-or to measure or manipulate. The name '\CMD' must start with a
-backslash ('\'), and must not be already defined.
+ An example:
- The allocation of a box is global. This command is fragile (*note
-\protect::).
+ \newlength{\graphichgt}
+
+ If you forget the backslash then you get 'Missing control sequence
+inserted'. If the command sequence already exists then you get
+something like 'LaTeX Error: Command \graphichgt already defined. Or
+name \end... illegal, see p.192 of the manual'.
+
+12.5 '\newsavebox'
+==================
+
+Synopsis:
+
+ \newsavebox{CMD}
+
+ Define '\CMD' to refer to a new "bin" for storing boxes. Such a box
+is for holding typeset material, to use multiple times or to measure or
+manipulate (*note Boxes::). The required bin name 'CMD' must start with
+a backslash, '\', and must not already be defined. This command is
+fragile (*note \protect::).
+
+ The first line here sets you up to save the material for later use.
+
+ \newsavebox{\logobox}
+ \savebox{\logobox}{LoGo}
+ Our logo is \usebox{\logobox}.
+
+The output is 'Our logo is LoGo'.
+
+ If there is an already defined bin then you get something like 'LaTeX
+Error: Command \logobox already defined. Or name \end... illegal, see
+p.192 of the manual'.
+
+ The allocation of a box is global.
12.6 '\newenvironment' & '\renewenvironment'
============================================
-These commands define or redefine an environment ENV, that is,
-'\begin{ENV} BODY \end{ENV}'. Synopses:
+Synopses, one of:
+
+ \newenvironment{ENV}{BEGDEF}{ENDDEF}
+ \newenvironment{ENV}[NARGS]{BEGDEF}{ENDDEF}
+ \newenvironment{ENV}[NARGS][OPTARGDEFAULT]{BEGDEF}{ENDDEF}
+ \newenvironment*{ENV}{BEGDEF}{ENDDEF}
+ \newenvironment*{ENV}[NARGS]{BEGDEF}{ENDDEF}
+ \newenvironment*{ENV}[NARGS][OPTARGDEFAULT]{BEGDEF}{ENDDEF}
+
+or one of these.
+
+ \renewenvironment{ENV}{BEGDEF}{ENDDEF}
+ \renewenvironment{ENV}[NARGS]{BEGDEF}{ENDDEF}
+ \renewenvironment{ENV}[NARGS][OPTARGDEFAULT]{BEGDEF}{ENDDEF}
+ \renewenvironment*{ENV}{BEGDEF}{ENDDEF}
+ \renewenvironment*{ENV}[NARGS]{BEGDEF}{ENDDEF}
+ \renewenvironment*{ENV}[NARGS][OPTARGDEFAULT]{BEGDEF}{ENDDEF}
- \newenvironment{ENV}[NARGS][OPTARGDEFAULT]{BEGDEFN}{ENDDEFN}
- \newenvironment*{ENV}[NARGS][OPTARGDEFAULT]{BEGDEFN}{ENDDEFN}
- \renewenvironment{ENV}[NARGS][OPTARGDEFAULT]{BEGDEFN}{ENDDEFN}
- \renewenvironment*{ENV}[NARGS][OPTARGDEFAULT]{BEGDEFN}{ENDDEFN}
+ Define or redefine the environment ENV, that is, create the construct
+'\begin{ENV} ... BODY ... \end{ENV}'.
The starred form of these commands requires that the arguments not
-contain multiple paragraphs of text. The body of these environments can
-still contain multiple paragraphs.
+contain multiple paragraphs of text. However, the body of these
+environments can contain multiple paragraphs.
ENV
Required; the environment name. It consists only of letters or the
- '*' character, and thus does not begin with backslash ('\'). It
+ '*' character, and thus does not begin with backslash, '\'. It
must not begin with the string 'end'. For '\newenvironment', the
name ENV must not be the name of an already existing environment,
and also the command '\ENV' must be undefined. For
@@ -5099,51 +6747,57 @@ ENV
NARGS
Optional; an integer from 0 to 9 denoting the number of arguments
- of that the environment will take. When the environment is used
- these arguments appear after the '\begin', as in
- '\begin{ENV}{ARG1}...{ARGN}'. If this argument is not present then
- the default is for the environment to have no arguments. When
- redefining an environment, the new version can have a different
- number of arguments than the old version.
+ of that the environment takes. When you use the environment these
+ arguments appear after the '\begin', as in '\begin{ENV}{ARG1} ...
+ {ARGN}'. Omitting this is equivalent to setting it to 0; the
+ environment will have no arguments. When redefining an
+ environment, the new version can have a different number of
+ arguments than the old version.
OPTARGDEFAULT
- Optional; if this argument is present then the first argument of
- the defined environment is optional, with default value
- OPTARGDEFAULT (which may be the empty string). If this argument is
- not present then the environment does not take an optional
- argument.
-
- That is, when '[OPTARGDEFAULT]' is present in the environment
- definition, if '\begin{ENV}' is used with square brackets
- following, as in '\begin{ENV}[MYVAL]', then, within BEGDEFN, the
- positional parameter '#1' expands to MYVAL. If '\begin{ENV}' is
- called without square brackets following, then, within within
- BEGDEFN, the positional parameter '#1' expands to the default
- OPTARGDEFAULT. In either case, any required arguments will be
- referred to starting with '#2'.
-
- Omitting '[MYVAL]' in the call is different from having the square
+ Optional; if this is present then the first argument of the defined
+ environment is optional, with default value OPTARGDEFAULT (which
+ may be the empty string). If this is not in the definition then
+ the environment does not take an optional argument.
+
+ That is, when OPTARGDEFAULT is present in the definition of the
+ environment then you can start the environment with square
+ brackets, as in '\begin{ENV}[OPTVAL]{...} ... \end{ENV}'. In this
+ case, within BEGDEFN the parameter '#1' is set to the value of
+ OPTVAL. If you call '\begin{ENV}' without square brackets, then
+ within BEGDEFN the parameter '#1' is set to the value of the
+ default OPTARGDEFAULT. In either case, any required arguments
+ start with '#2'.
+
+ Omitting '[MYVAL]' in the call is different than having the square
brackets with no contents, as in '[]'. The former results in '#1'
expanding to OPTARGDEFAULT; the latter results in '#1' expanding to
the empty string.
-BEGDEFN
+BEGDEF
Required; the text expanded at every occurrence of '\begin{ENV}'.
- Within BEGDEF, the Nth positional parameter (i.e., '#N') is
- replaced by the text of the Nth argument.
+ Within BEGDEF, the parameters '#1', '#2', ... '#NARGS', are
+ replaced by the values that you supply when you call the
+ environment; see the examples below.
-ENDDEFN
+ENDDEF
Required; the text expanded at every occurrence of '\end{ENV}'.
- This may not contain any positional parameters, so '#N' cannot be
- used here (but see the final example below).
+ This may not contain any parameters, that is, you cannot use '#1',
+ '#2', etc., here (but see the final example below).
- All environments, that is to say the BEGDEFN code, the environment
-body and the ENDDEFN code, are processed within a group. Thus, in the
+ All environments, that is to say the BEGDEF code, the environment
+body, and the ENDDEF code, are processed within a group. Thus, in the
first example below, the effect of the '\small' is limited to the quote
and does not extend to material following the environment.
+ If you try to define an environment and the name has already been
+used then you get something like 'LaTeX Error: Command \fred already
+defined. Or name \end... illegal, see p.192 of the manual'. If you try
+to redefine an environment and the name has not yet been used then you
+get something like 'LaTeX Error: Environment hank undefined.'.
+
This example gives an environment like LaTeX's 'quotation' except
-that it will be set in smaller type:
+that it will be set in smaller type.
\newenvironment{smallquote}{%
\small\begin{quotation}
@@ -5151,8 +6805,16 @@ that it will be set in smaller type:
\end{quotation}
}
- This one shows the use of arguments; it gives a quotation environment
-that cites the author:
+ This has an argument, which is set in boldface at the start of a
+paragraph.
+
+ \newenvironment{point}[1]{%
+ \noindent\textbf{#1}
+ }{%
+ }
+
+ This one shows the use of a optional argument; it gives a quotation
+environment that cites the author.
\newenvironment{citequote}[1][Shakespeare]{%
\begin{quotation}
@@ -5162,14 +6824,14 @@ that cites the author:
}
The author's name is optional, and defaults to 'Shakespeare'. In the
-document, use the environment like this:
+document, use the environment like this.
\begin{citequote}[Lincoln]
...
\end{citequote}
The final example shows how to save the value of an argument to use
-in ENDDEFN, in this case in a box (*note \sbox::):
+in ENDDEF, in this case in a box (*note \sbox & \savebox::).
\newsavebox{\quoteauthor}
\newenvironment{citequote}[1][Shakespeare]{%
@@ -5183,28 +6845,27 @@ in ENDDEFN, in this case in a box (*note \sbox::):
12.7 '\newtheorem'
==================
-Define a new theorem-like environment. Synopses:
+Synopses:
\newtheorem{NAME}{TITLE}
\newtheorem{NAME}{TITLE}[NUMBERED_WITHIN]
\newtheorem{NAME}[NUMBERED_LIKE]{TITLE}
- Using the first form, '\newtheorem{NAME}{TITLE}' creates an
-environment that will be labelled with TITLE. See the first example
-below.
+ Define a new theorem-like environment. You can specify one of
+NUMBERED_WITHIN and NUMBERED_LIKE, or neither, but not both.
+
+ The first form, '\newtheorem{NAME}{TITLE}', creates an environment
+that will be labelled with TITLE; see the first example below.
- The second form '\newtheorem{NAME}{TITLE}[NUMBERED_WITHIN]' creates
+ The second form, '\newtheorem{NAME}{TITLE}[NUMBERED_WITHIN]', creates
an environment whose counter is subordinate to the existing counter
-NUMBERED_WITHIN (its counter will be reset when NUMBERED_WITHIN is
-reset).
+NUMBERED_WITHIN, so this counter will be reset when NUMBERED_WITHIN is
+reset. See the second example below.
The third form '\newtheorem{NAME}[NUMBERED_LIKE]{TITLE}', with
-optional argument between the two required arguments, will create an
+optional argument between the two required arguments, creates an
environment whose counter will share the previously defined counter
-NUMBERED_LIKE.
-
- You can specify one of NUMBERED_WITHIN and NUMBERED_LIKE, or neither,
-but not both.
+NUMBERED_LIKE. See the third example.
This command creates a counter named NAME. In addition, unless the
optional argument NUMBERED_LIKE is used, inside of the theorem-like
@@ -5216,13 +6877,14 @@ environment the current '\ref' value will be that of
Arguments:
NAME
- The name of the environment. It must not begin with a backslash
- ('\'). It must not be the name of an existing environment; indeed,
- the command name '\NAME' must not already be defined as anything.
+ The name of the environment. It is a string of letters. It must
+ not begin with a backslash, '\'. It must not be the name of an
+ existing environment, and the command name '\NAME' must not already
+ be defined.
TITLE
- The text printed at the beginning of the environment, before the
- number. For example, 'Theorem'.
+ The text to be printed at the beginning of the environment, before
+ the number. For example, 'Theorem'.
NUMBERED_WITHIN
Optional; the name of an already defined counter, usually a
@@ -5254,9 +6916,9 @@ results in 'Definition 1' and 'Definition 2' in the output.
Second def
\end{defn}
- Because the next example specifies the optional argument
-NUMBERED_WITHIN to '\newtheorem' as 'section', the example, with the
-same document body, gives 'Definition 1.1' and 'Definition 2.1'.
+ This example has the same document body as the prior one. But here
+'\newtheorem''s optional argument NUMBERED_WITHIN is given as 'section',
+so the output is like 'Definition 1.1' and 'Definition 2.1'.
\newtheorem{defn}{Definition}[section]
\begin{document}
@@ -5292,35 +6954,32 @@ and 'Definition 2.2'.
Second def
\end{defn}
-12.8 '\newfont': Define a new font (obsolete)
-=============================================
+12.8 '\newfont'
+===============
-'\newfont', now obsolete, defines a command that will switch fonts.
-Synopsis:
+This command is obsolete. This description is here only to help with
+old documents. New documents should define fonts in families through
+the New Font Selection Scheme which allows you to, for example,
+associate a boldface with a roman (*note Fonts::).
- \newfont{\CMD}{FONT DESCRIPTION}
+ Synopsis:
- This defines a control sequence '\CMD' that will change the current
-font. LaTeX will look on your system for a file named 'FONTNAME.tfm'.
-The control sequence must must not already be defined. It must begin
-with a backslash ('\').
+ \newfont{\CMD}{FONT DESCRIPTION}
- This command is obsolete. It is a low-level command for setting up
-an individual font. Today fonts are almost always defined in families
-(which allows you to, for example, associate a boldface with a roman)
-through the so-called "New Font Selection Scheme", either by using '.fd'
-files or through the use of an engine that can access system fonts such
-as XeLaTeX (*note TeX engines::).
+ Define a command '\CMD' that will change the current font. The
+control sequence must must not already be defined. It must begin with a
+backslash, '\'.
- But since it is part of LaTeX, here is an explanation: the FONT
-DESCRIPTION consists of a FONTNAME and an optional "at clause"; this can
-have the form either 'at DIMEN' or 'scaled FACTOR', where a FACTOR of
-'1000' means no scaling. For LaTeX's purposes, all this does is scale
-all the character and other font dimensions relative to the font's
-design size, which is a value defined in the '.tfm' file.
+ The FONT DESCRIPTION consists of a FONTNAME and an optional "at
+clause". LaTeX will look on your system for a file named
+'FONTNAME.tfm'. The at clause can have the form either 'at DIMEN' or
+'scaled FACTOR', where a FACTOR of '1000' means no scaling. For LaTeX's
+purposes, all this does is scale all the character and other font
+dimensions relative to the font's design size, which is a value defined
+in the '.tfm' file.
- This example defines two equivalent fonts and typesets a few
-characters in each:
+ This defines two equivalent fonts and typesets a few characters in
+each.
\newfont{\testfontat}{cmb10 at 11pt}
\newfont{\testfontscaled}{cmb10 scaled 1100}
@@ -5386,7 +7045,7 @@ Synopsis:
\ignorespaces
- or
+or
\ignorespacesafterend
@@ -5404,11 +7063,13 @@ the question text.
\newcommand{\points}[1]{\makebox[0pt]{\makebox[10em][l]{#1~pts}}
\begin{enumerate}
\item\points{10}no extra space output here
- \item\points{15} extra space output between the number and the word `extra'
+ \item\points{15} extra space between the number and the `extra'
\end{enumerate}
- The solution is to change to
-'\newcommand{\points}[1]{\makebox[0pt]{\makebox[10em][l]{#1~pts}}\ignorespaces}'.
+The solution is to change to this.
+
+ \newcommand{\points}[1]{%
+ \makebox[0pt]{\makebox[10em][l]{#1~pts}}\ignorespaces}
A second example shows spaces being removed from the front of text.
The commands below allow a user to uniformly attach a title to names.
@@ -5417,14 +7078,14 @@ But, as given, if a title accidentally starts with a space then
\makeatletter
\newcommand{\honorific}[1]{\def\@honorific{#1}} % remember title
- \newcommand{\fullname}[1]{\@honorific~#1} % recall title; put before name
+ \newcommand{\fullname}[1]{\@honorific~#1} % put title before name
\makeatother
\begin{tabular}{|l|}
\honorific{Mr/Ms} \fullname{Jones} \\ % no extra space here
\honorific{ Mr/Ms} \fullname{Jones} % extra space before title
\end{tabular}
- To fix this, change to
+To fix this, change to
'\newcommand{\fullname}[1]{\ignorespaces\@honorific~#1}'.
The '\ignorespaces' is also often used in a '\newenvironment' at the
@@ -5475,6 +7136,8 @@ a minipage (*note minipage::). The counters 'enumi' through 'enumiv'
are used in the 'enumerate' environment, for up to four levels of
nesting (*note enumerate::).
+ Counters can have any integer value but they are typically positive.
+
New counters are created with '\newcounter'. *Note \newcounter::.
13.1 '\alph \Alph \arabic \roman \Roman \fnsymbol': Printing counters
@@ -5482,64 +7145,73 @@ nesting (*note enumerate::).
Print the value of a counter, in a specified style. For instance, if
the counter COUNTER has the value 1 then a '\alph{COUNTER}' in your
-source will result in a lower case letter a appearing in the output.
+source will result in a lowercase letter a appearing in the output.
All of these commands take a single counter as an argument, for
instance, '\alph{enumi}'. Note that the counter name does not start
with a backslash.
'\alph{COUNTER}'
- Print the value of COUNTER in lowercase letters: 'a', 'b', ...
+ Print the value of COUNTER in lowercase letters: 'a', 'b', ... If
+ the counter's value is less than 1 or more than 26 then you get
+ 'LaTeX Error: Counter too large.'
'\Alph{COUNTER}'
- Print in uppercase letters: 'A', 'B', ...
+ Print in uppercase letters: 'A', 'B', ... If the counter's value
+ is less than 1 or more than 26 then you get 'LaTeX Error: Counter
+ too large.'
'\arabic{COUNTER}'
- Print in Arabic numbers: '1', '2', ...
+ Print in Arabic numbers such as '5' or '-2'.
'\roman{COUNTER}'
- Print in lowercase roman numerals: 'i', 'ii', ...
+ Print in lowercase roman numerals: 'i', 'ii', ... If the counter's
+ value is less than 1 then you get no warning or error but LaTeX
+ does not print anything in the output.
'\Roman{COUNTER}'
- Print in uppercase roman numerals: 'I', 'II', ...
+ Print in uppercase roman numerals: 'I', 'II', ... If the counter's
+ value is less than 1 then you get no warning or error but LaTeX
+ does not print anything in the output.
'\fnsymbol{COUNTER}'
- Prints the value of COUNTER in a specific sequence of nine symbols
- (conventionally used for labeling footnotes). The value of COUNTER
- must be between 1 and 9, inclusive.
+ Prints the value of COUNTER using a sequence of nine symbols that
+ are traditionally used for labeling footnotes. The value of
+ COUNTER should be between 1 and 9, inclusive. If the counter's
+ value is less than 0 or more than 9 then you get 'LaTeX Error:
+ Counter too large', while if it is 0 then you get no error or
+ warning but LaTeX does not output anything.
Here are the symbols:
- Name Command Equivalent Unicode
- symbol and/or numeric
- code point
- ---------------------------------------------------------------------------
- asterisk '\ast' *
- dagger '\dagger' U+2020
- ddagger '\ddagger' U+2021
- section-sign '\S' U+00A7
- paragraph-sign '\P' U+00B6
- double-vert '\parallel' U+2016
- double-asterisk '\ast\ast' **
- double-dagger '\dagger\dagger' U+2020U+2020
- double-ddagger '\ddagger\ddagger' U+2021U+2021
-
-13.2 '\usecounter{COUNTER}'
-===========================
+ Number Name Command Symbol
+ -----------------------------------------------------------------------------
+ 1 asterisk '\ast' *
+ 2 dagger '\dagger' U+2020
+ 3 ddagger '\ddagger' U+2021
+ 4 section-sign '\S' U+00A7
+ 5 paragraph-sign '\P' U+00B6
+ 6 double-vert '\parallel' U+2016
+ 7 double-asterisk '\ast\ast' **
+ 8 double-dagger '\dagger\dagger' U+2020U+2020
+ 9 double-ddagger '\ddagger\ddagger' U+2021U+2021
+
+13.2 '\usecounter'
+==================
Synopsis:
\usecounter{COUNTER}
- In the 'list' environment, when used in the second argument, this
-command sets up COUNTER to number the list items. It initializes
-COUNTER to zero, and arranges that when '\item' is called without its
-optional argument then COUNTER is incremented by '\refstepcounter',
-making its value be the current 'ref' value. This command is fragile
-(*note \protect::).
+ Used in the second argument of the 'list' environment (*note list::),
+this declares that list items will be numbered by COUNTER. It
+initializes COUNTER to zero, and arranges that when '\item' is called
+without its optional argument then COUNTER is incremented by
+'\refstepcounter', making its value be the current 'ref' value (*note
+\ref::). This command is fragile (*note \protect::).
- Put in the preamble, this makes a new list environment enumerated
-with TESTCOUNTER:
+ Put in the document preamble, this example makes a new list
+environment enumerated with TESTCOUNTER:
\newcounter{testcounter}
\newenvironment{test}{%
@@ -5550,20 +7222,15 @@ with TESTCOUNTER:
\end{list}
}
-13.3 '\value{COUNTER}'
-======================
+13.3 '\value'
+=============
Synopsis:
\value{COUNTER}
- This command expands to the value of COUNTER. It is often used in
-'\setcounter' or '\addtocounter', but '\value' can be used anywhere that
-LaTeX expects a number. It must not be preceded by '\protect' (*note
-\protect::).
-
- The '\value' command is not used for typesetting the value of the
-counter. *Note \alph \Alph \arabic \roman \Roman \fnsymbol::.
+ Expands to the value of the counter COUNTER. (Note that the name of
+a counter does not begin with a backslash.)
This example outputs 'Test counter is 6. Other counter is 5.'.
@@ -5574,32 +7241,47 @@ counter. *Note \alph \Alph \arabic \roman \Roman \fnsymbol::.
Test counter is \arabic{test}.
Other counter is \arabic{other}.
+ The '\value' command is not used for typesetting the value of the
+counter. For that, see *note \alph \Alph \arabic \roman \Roman
+\fnsymbol::.
+
+ It is often used in '\setcounter' or '\addtocounter' but '\value' can
+be used anywhere that LaTeX expects a number, such as in
+'\hspace{\value{foo}\parindent}'. It must not be preceded by '\protect'
+(*note \protect::).
+
This example inserts '\hspace{4\parindent}'.
\setcounter{myctr}{3} \addtocounter{myctr}{1}
\hspace{\value{myctr}\parindent}
-13.4 '\setcounter{COUNTER}{VALUE}'
-==================================
+13.4 '\setcounter'
+==================
Synopsis:
\setcounter{COUNTER}{VALUE}
- The '\setcounter' command globally sets the value of COUNTER to the
-VALUE argument. Note that the counter name does not start with a
-backslash.
+ Globally set the counter COUNTER to have the value of the VALUE
+argument, which must be an integer. Thus, you can set a counter's value
+as '\setcounter{section}{5}'. Note that the counter name does not start
+with a backslash.
- In this example the section value appears as 'V'.
+ In this example if the counter 'theorem' has value 12 then the second
+line will print 'XII'.
- \setcounter{section}{5}
- Here it is in Roman: \Roman{section}.
+ \setcounter{exercise}{\value{theorem}}
+ Here it is in Roman: \Roman{exercise}.
-13.5 '\addtocounter{COUNTER}{VALUE}'
-====================================
+13.5 '\addtocounter'
+====================
-The '\addtocounter' command globally increments COUNTER by the amount
-specified by the VALUE argument, which may be negative.
+Synopsis:
+
+ \addtocounter{COUNTER}{VALUE
+
+ Globally increment COUNTER by the amount specified by the VALUE
+argument, which may be negative.
In this example the section value appears as 'VII'.
@@ -5607,12 +7289,16 @@ specified by the VALUE argument, which may be negative.
\addtocounter{section}{2}
Here it is in Roman: \Roman{section}.
-13.6 '\refstepcounter{COUNTER}'
-===============================
+13.6 '\refstepcounter'
+======================
+
+Synopsis:
+
+ \refstepcounter{COUNTER}
-The '\refstepcounter' command works in the same way as '\stepcounter'
-(*note \stepcounter::): it globally increments the value of COUNTER by
-one and resets the value of any counter numbered within it. (For the
+ Globally increments the value of COUNTER by one, as does
+'\stepcounter' (*note \stepcounter::). The difference is that this
+command resets the value of any counter numbered within it. (For the
definition of "counters numbered within", *note \newcounter::.)
In addition, this command also defines the current '\ref' value to be
@@ -5621,23 +7307,39 @@ the result of '\thecounter'.
While the counter value is set globally, the '\ref' value is set
locally, i.e., inside the current group.
-13.7 '\stepcounter{COUNTER}'
-============================
+13.7 '\stepcounter'
+===================
-The '\stepcounter' command globally adds one to COUNTER and resets all
-counters numbered within it. (For the definition of "counters numbered
-within", *note \newcounter::.)
+Synopsis:
-13.8 '\day \month \year': Predefined counters
-=============================================
+ \stepcounter{COUNTER}
+
+ Globally adds one to COUNTER and resets all counters numbered within
+it. (For the definition of "counters numbered within", *note
+\newcounter::.)
+
+ This command differs from '\refstepcounter' in that this one does not
+influence references -- it does not define the current '\ref' value to
+be the result of '\thecounter' (*note \refstepcounter::).
+
+13.8 '\day' & '\month' & '\year'
+================================
+
+LaTeX defines the counter '\day' for the day of the month (nominally
+with value between 1 and 31), '\month' for the month of the year
+(nominally with value between 1 and 12), and year '\year'. When TeX
+starts up, they are set from the current values on the system. The
+related command '\today' produces a string representing the current day
+(*note \today::).
-LaTeX defines counters for the day of the month ('\day', 1-31), month of
-the year ('\month', 1-12), and year ('\year', Common Era). When TeX
-starts up, they are set to the current values on the system where TeX is
-running. They are not updated as the job progresses.
+ They counters are not updated as the job progresses so in principle
+they could be incorrect by the end. In addition, TeX does no sanity
+check:
- The related command '\today' produces a string representing the
-current day (*note \today::).
+ \day=-2 \month=13 \year=-4 \today
+
+gives no error or warning and results in the output '-2, -4' (the bogus
+month value produces no output).
14 Lengths
**********
@@ -5645,25 +7347,89 @@ current day (*note \today::).
A "length" is a measure of distance. Many LaTeX commands take a length
as an argument.
+ This shows a box of the given length.
+
+ \newcommand{\blackbar}[1]{\rule{#1}{10pt}} % make a bar
+ \newcommand{\showhbox}[2]{\fboxsep=0pt\fbox{\hbox to #1{#2}}} % box it
+ XXX\showhbox{100pt}{\blackbar{100pt}}YYY
+
+It produces a black bar 100 points long between 'XXX' and 'YYY'.
+
Lengths come in two types. A "rigid length" (what Plain TeX calls a
-"dimen") such as '10pt' cannot contain a 'plus' or 'minus' component. A
-"rubber length" (what Plain TeX calls a "skip") can contain those, as
-with '1cm plus0.05cm minus0.01cm'. These give the ability to stretch or
-shrink; the length in the prior sentence could appear in the output as
-long as 1.05 cm or as short as 0.99 cm, depending on what TeX's
-typesetting algorithm finds optimum.
+"dimen") such as '10pt' does not contain a 'plus' or 'minus' component.
+The above example shows a rigid length. A "rubber length" (what Plain
+TeX calls a "skip") can contain those components, as with '1cm
+plus0.05cm minus0.01cm'. Here the '1cm' is the "natural length" while
+the other two, the 'plus' and 'minus' components, allow the length to
+stretch or shrink.
+
+ Shrinking is simpler: with '1cm minus 0.05cm', the natural length is
+1cm but if smaller is needed then TeX can shrink it down as far as
+0.95cm. Beyond that, TeX refuses to shrink any more. Thus, below the
+first one works fine, producing a space of 98 points between the two
+bars.
+
+ XXX\showhbox{300pt}{%
+ \blackbar{101pt}\hspace{100pt minus 2pt}\blackbar{101pt}}YYY
+
+ XXX\showhbox{300pt}{%
+ \blackbar{105pt}\hspace{100pt minus 1pt}\blackbar{105pt}}YYY
+
+But the second one gets a warning like 'Overfull \hbox (1.0pt too wide)
+detected at line 17'. In the output the first 'Y' is overwritten by the
+end of the black bar, because the box's material is wider than the 300pt
+allocated, as TeX has refused to shrink the total to less than
+309 points.
+
+ Stretching is like shrinking except that if TeX is asked to stretch
+beyond the given amount, it won't refuse. Here the first line is fine,
+producing a space of 110 points between the bars.
+
+ XXX\showhbox{300pt}{%
+ \blackbar{95pt}\hspace{100pt plus 10pt}\blackbar{95pt}}YYY
+
+ XXX\showhbox{300pt}{%
+ \blackbar{95pt}\hspace{100pt plus 1pt}\blackbar{95pt}}YYY
+
+In the second line TeX needs a stretch of 10 points and only 1 point was
+specified. In this situation, TeX stretches the space to the required
+length, but it complains with a warning like 'Underfull \hbox (badness
+10000) detected at line 22'. (We won't discuss badness; the point is
+that the system was not given as much stretch as needed.)
+
+ You can put both stretch and shrink in the same length, as in '1ex
+plus 0.05ex minus 0.02ex'.
+
+ If TeX is setting two or more rubber lengths then it allocates the
+stretch or shrink in proportion.
+
+ XXX\showhbox{300pt}{\blackbar{100pt}% left
+ \hspace{0pt plus 50pt}\blackbar{80pt}\hspace{0pt plus 10pt}% middle
+ \blackbar{100pt}}YYY % right
+
+The outside bars take up 100 points, so the middle needs another 100.
+In the middle the bar takes up 80 points, so the two '\hspace''s must
+stretch 20 points. Because the two say 'plus 50pt' and 'plus 10pt', TeX
+gets 5/6 of the stretch from the first space and 1/6 from the second.
The 'plus' or 'minus' component of a rubber length can contain a
"fill" component, as in '1in plus2fill'. This gives the length infinite
-stretchability or shrinkability, so that the length in the prior
-sentence can be set by TeX to any distance greater than or equal to
-1 inch. TeX actually provides three infinite glue components 'fil',
-'fill', and 'filll', such that the later ones overcome the earlier ones,
-but only the middle value is ordinarily used. *Note \hfill::, *Note
-\vfill::.
-
- Multiplying an entire rubber length by a number turns it into a rigid
-length, so that after '\setlength{\ylength}{1in plus 0.2in}' and
+stretchability or shrinkability so that TeX could set it to any
+distance. Here the two figures will be equal-spaced across the page.
+
+ \begin{minipage}{\linewidth}
+ \hspace{0pt plus 1fill}\includegraphics{godel.png}%
+ \hspace{0pt plus 1fill}\includegraphics{einstein.png}%
+ \hspace{0pt plus 1fill}
+ \end{minipage}
+
+ TeX actually has three infinite glue components 'fil', 'fill', and
+'filll'. The later ones are more infinite than the earlier ones.
+Ordinarily document authors only use the middle one (*note \hfill:: and
+*note \vfill::).
+
+ Multiplying a rubber length by a number turns it into a rigid length,
+so that after '\setlength{\ylength}{1in plus 0.2in}' and
'\setlength{\zlength}{3\ylength}' then the value of '\zlength' is '3in'.
14.1 Units of length
@@ -5703,7 +7469,7 @@ mode.
Two other lengths that are often used are values set by the designer
of the font. The x-height of the current font "ex", traditionally the
-height of the lower case letter x, is often used for vertical lengths.
+height of the lowercase letter x, is often used for vertical lengths.
Similarly "em", traditionally the width of the capital letter M, is
often used for horizontal lengths (there is also '\enspace', which is
'0.5em'). Use of these can help make a definition work better across
@@ -5721,142 +7487,315 @@ math symbols family. *Note Spacing in math mode::.
Synopsis:
- \setlength{\LEN}{AMOUNT}
+ \setlength{LEN}{AMOUNT}
+
+ Set the length LEN to AMOUNT. The length name LEN must begin with a
+backslash, '\'. The 'amount' can be a rubber length (*note Lengths::).
+It can be positive, negative or zero, and can be in any units that LaTeX
+understands (*note Units of length::).
- The '\setlength' sets the value of "length command" '\LEN' to the
-VALUE argument which can be expressed in any units that LaTeX
-understands, i.e., inches ('in'), millimeters ('mm'), points ('pt'), big
-points ('bp'), etc.
+ Below, with LaTeX's defaults the first paragraph will be indented
+while the second will not.
+
+ I told the doctor I broke my leg in two places.
+
+ \setlength{\parindent}{0em}
+ He said stop going to those places.
+
+ If there is no such length LEN then you get something like 'Undefined
+control sequence. <argument> \praindent'.
14.3 '\addtolength'
===================
Synopsis:
- \addtolength{\LEN}{AMOUNT}
+ \addtolength{LEN}{AMOUNT}
+
+ Increment the length LEN by AMOUNT. The length name LEN begins with
+a backslash, '\'. The 'amount' is a rubber length (*note Lengths::).
+It can be positive, negative or zero, and can be in any units that LaTeX
+understands (*note Units of length::).
+
+ Below, if '\parskip' starts with the value '0pt plus 1pt'
+
+ \addtolength{\parskip}{1pt}
+ Doctor: how is the boy who swallowed the silver dollar?
+
+ Nurse: no change.
+
+then it has the value '1pt plus 1pt' for the second paragraph.
- The '\addtolength' command increments a length command '\LEN' by the
-amount specified in the AMOUNT argument, which may be negative.
+ If there is no such length LEN then you get something like 'Undefined
+control sequence. <argument> \praindent'. If you leave off the
+backslash at the start of LEN, as in '\addtolength{parindent}{1pt}',
+then you get something like 'You can't use `the letter p' after
+\advance'.
14.4 '\settodepth'
==================
Synopsis:
- \settodepth{\LEN}{TEXT}
+ \settodepth{LEN}{TEXT}
- The '\settodepth' command sets the value of a length command '\LEN'
-equal to the depth of the TEXT argument.
+ Set the length LEN to the depth of box that LaTeX gets on typesetting
+the TEXT argument. The length name LEN must begin with a backslash,
+'\'.
+
+ This will show how low the character descenders go.
+
+ \newlength{\alphabetdepth}
+ \settodepth{\alphabetdepth}{abcdefghijklmnopqrstuvwxyz}
+ \the\alphabetdepth
+
+ If there is no such length LEN then you get something like 'Undefined
+control sequence. <argument> \alphabetdepth'. If you leave the
+backslash out of LEN, as in '\settodepth{alphabetdepth}{...}' then you
+get something like 'Missing number, treated as zero. <to be read again>
+\setbox'.
14.5 '\settoheight'
===================
Synopsis:
- \settoheight{\LEN}{text}
+ \settoheight{LEN}{text}
- The '\settoheight' command sets the value of a length command '\LEN'
-equal to the height of the 'text' argument.
+ Sets the length LEN to the height of box that LaTeX gets on
+typesetting the 'text' argument. The length name LEN must begin with a
+backslash, '\'.
-14.6 '\settowidth{\LEN}{TEXT}'
-==============================
+ This will show how high the characters go.
-Synopsis:
-
- \settowidth{\LEN}{TEXT}
+ \newlength{\alphabetheight}
+ \settoheight{\alphabetheight}{abcdefghijklmnopqrstuvwxyz}
+ \the\alphabetheight
- The '\settowidth' command sets the value of the command \LEN to the
-width of the TEXT argument.
+ If there is no such length LEN then you get something like 'Undefined
+control sequence. <argument> \alphabetheight'. If you leave the
+backslash out of LEN, as in '\settoheight{alphabetheight}{...}' then you
+get something like 'Missing number, treated as zero. <to be read again>
+\setbox'.
-14.7 Predefined lengths
-=======================
+14.6 '\settowidth'
+==================
-'\width'
+Synopsis:
- '\height'
+ \settowidth{LEN}{TEXT}
- '\depth'
+ Set the length LEN to the width of the box that LaTeX gets on
+typesetting the TEXT argument. The length name LEN must begin with a
+backslash, '\'.
- '\totalheight'
+ This measures the width of the lowercase ASCII alphabet.
- These length parameters can be used in the arguments of the
-box-making commands (*note Boxes::). They specify the natural width,
-etc., of the text in the box. '\totalheight' equals '\height' +
-'\depth'. To make a box with the text stretched to double the natural
-size, e.g., say
+ \newlength{\alphabetwidth}
+ \settowidth{\alphabetwidth}{abcdefghijklmnopqrstuvwxyz}
+ \the\alphabetwidth
- \makebox[2\width]{Get a stretcher}
+ If there is no such length LEN then you get something like 'Undefined
+control sequence. <argument> \alphabetwidth'. If you leave the
+backslash out of LEN, as in '\settoheight{alphabetwidth}{...}' then you
+get something like 'Missing number, treated as zero. <to be read again>
+\setbox'.
15 Making paragraphs
********************
-A paragraph is ended by one or more completely blank lines--lines not
-containing even a '%'. A blank line should not appear where a new
-paragraph cannot be started, such as in math mode or in the argument of
-a sectioning command.
+Once LaTeX has all of a paragraph's contents it divides it into lines,
+in a way that is optimized over the entire paragraph (*note Line
+breaking::). To end the current paragraph, put an empty line.
-15.1 '\indent'
-==============
+ It is a truth universally acknowledged, that a single man in possession
+ of a good fortune, must be in want of a wife.
-'\indent' produces a horizontal space whose width equals to the
-'\parindent' length, the normal paragraph indentation. It is used to
-add paragraph indentation where it would otherwise be suppressed.
+ However little known the feelings or views of such a man may be on his
+ first entering a neighbourhood, this truth is so well fixed in the minds
+ of the surrounding families, that he is considered the rightful property
+ of some one or other of their daughters.
- The default value for '\parindent' is '1em' in two-column mode,
-otherwise '15pt' for '10pt' documents, '17pt' for '11pt', and '1.5em'
-for '12pt'.
+ ``My dear Mr. Bennet,'' said his lady to him one day,
+ ``have you heard that Netherfield Park is let at last?''
-15.2 '\noindent'
-================
+ The separator lines must be empty, including not containing a comment
+character, '%'.
+
+ There are places where a new paragraph is not permitted. Don't put a
+blank line in math mode (*note Modes::); here the line before the
+'\end{equation}'
+
+ \begin{equation}
+ 2^{|S|} > |S|
+
+ \end{equation}
+
+will get you the error 'Missing $ inserted'. Similarly, the blank line
+in this 'section' argument
+
+ \section{aaa
+
+ bbb}
+
+gets 'Runaway argument? {aaa ! Paragraph ended before \@sect was
+complete'.
+
+15.1 '\par'
+===========
+
+Synopsis (note that while reading the input TeX, converts two
+consecutive newlines to a '\par'):
+
+ \par
+
+ End the current paragraph. The usual way to separate paragraphs is
+with a blank line but the '\par' command is entirely equivalent. This
+command is robust (*note \protect::).
+
+ This example uses '\par' rather than a blank line simply for
+readability.
+
+ \newcommand{\syllabusLegalese}{%
+ \whatCheatingIs\par\whatHappensWhenICatchYou}
+
+ The '\par' command does nothing in LR mode or a vertical mode but it
+terminates paragraph mode, bringing LaTeX to vertical mode (*note
+Modes::).
+
+ You cannot use the '\par' command in math mode or in the argument of
+many commands, such as the '\section' command (*note Making paragraphs::
+and *note \newcommand & \renewcommand::).
+
+ The '\par' command differs from the '\paragraph' command in that the
+latter is, like '\section' or '\subsection', a sectioning unit used by
+the standard LaTeX documents.
+
+ The '\par' command differs from '\newline' and the line break double
+backslash, '\\', in that \par ends the paragraph not just the line. It
+also triggers the addition of the between-paragraph vertical space
+'\parskip' (*note \parindent & \parskip::).
+
+ The output from this example
+
+ xyz
+
+ \setlength{\parindent}{3in}
+ \setlength{\parskip}{5in}
+ \noindent test\indent test1\par test2
+
+is: after 'xyz' there is a vertical skip of 5 inches and then 'test'
+appears, aligned with the left margin. On the same line, there is an
+empty horizontal space of 3 inches and then 'test1' appears. Finally.
+there is a vertical space of 5 inches, followed by a fresh paragraph
+with a paragraph indent of 3 inches, and then LaTeX puts the text
+'test2'.
+
+15.2 '\indent' & '\noindent'
+============================
-When used at the beginning of the paragraph, this command suppresses any
-paragraph indentation, as in this example.
+Synopsis:
+
+ \indent
+
+or
+
+ \noindent
+
+ Go into horizontal mode (*note Modes::). The '\indent' command first
+outputs an empty box whose width is '\parindent'. These commands are
+robust (*note \protect::).
+
+ Ordinarily you create a new paragraph by putting in a blank line.
+*Note \par:: for the difference between this command and '\par'. To
+start a paragraph without an indent, or to continue an interrupted
+paragraph, use '\noindent'.
+
+ In the middle of a paragraph the '\noindent' command has no effect,
+because LaTeX is already in horizontal mode there. The '\indent'
+command's only effect is to output a space.
+
+ This example starts a fresh paragraph.
... end of the prior paragraph.
\noindent This paragraph is not indented.
- It has no effect when used in the middle of a paragraph.
+and this continues an interrupted paragraph.
- To eliminate paragraph indentation in an entire document, put
-'\setlength{\parindent}{0pt}' in the preamble.
+ The data
-15.3 '\parskip'
-===============
+ \begin{center}
+ \begin{tabular}{rl} ... \end{tabular}
+ \end{center}
-'\parskip' is a rubber length defining extra vertical space added before
-each paragraph. The default is '0pt plus1pt'.
+ \noindent shows this clearly.
+
+ To omit indentation in the entire document put
+'\setlength{\parindent}{0pt}' in the preamble. If you do that, you may
+want to also set the length of spaces between paragraphs, '\parskip'
+(*note \parindent & \parskip::).
+
+ Default LaTeX styles have the first paragraph after a section that is
+not indented, as is traditional typesetting in English. To change that,
+look on CTAN for the package 'indentfirst'.
+
+15.3 '\parindent' & '\parskip'
+==============================
+
+Synopsis:
+
+ \setlength{\parskip}{HORIZONTAL LEN}
+ \setlength{\parinden}{VERTICAL LEN}
+
+ Both are a rubber lengths (*note Lengths::). They give the
+indentation of ordinary paragraphs, not paragraphs inside minipages
+(*note minipage::), and the vertical space between paragraphs.
+
+ This, put in the preamble,
+
+ \setlength{\parindent}{0em}
+ \setlength{\parskip}{1ex}
+
+arranges that the document will have paragraphs that are not indented,
+but instead are vertically separated by about the height of a lowercase
+'x'.
+
+ In standard LaTeX documents, the default value for '\parindent' in
+one-column documents is '15pt' when the default text size is '10pt' ,
+'17pt' for '11pt', and '1.5em' for '12pt'. In two-column documents it
+is '1em'. The default value for '\parskip' in LaTeX's standard document
+styles is '0pt plus1pt'.
15.4 Marginal notes
===================
-Synopsis:
+Synopsis, one of:
+ \marginpar{RIGHT}
\marginpar[LEFT]{RIGHT}
- The '\marginpar' command creates a note in the margin. The first
-line of the note will have the same baseline as the line in the text
-where the '\marginpar' occurs.
+ Create a note in the margin. The first line of the note will have
+the same baseline as the line in the text where the '\marginpar' occurs.
- When you only specify the mandatory argument RIGHT, the text will be
-placed
+ The margin that LaTeX uses for the note depends on the current layout
+(*note Document class options::) and also on '\reversemarginpar' (see
+below). If you are using one-sided layout (document option 'oneside')
+then it goes in the right margin. If you are using two-sided layout
+(document option 'twoside') then it goes in the outside margin. If you
+are in two-column layout (document option 'twocolumn') then it goes in
+the nearest margin.
- * in the right margin for one-sided layout (option 'oneside', see
- *note Document class options::);
- * in the outside margin for two-sided layout (option 'twoside', see
- *note Document class options::);
- * in the nearest margin for two-column layout (option 'twocolumn',
- see *note Document class options::).
+ If you declare '\reversemarginpar' then LaTeX will place subsequent
+marginal notes in the opposite margin to that given in the prior
+paragraph. Revert that to the default position with '\normalmarginpar'.
- The command '\reversemarginpar' places subsequent marginal notes in
-the opposite (inside) margin. '\normalmarginpar' places them in the
-default position.
+ When you specify the optional argument LEFT then it is used for a
+note in the left margin, while the mandatory argument RIGHT is used for
+a note in the the right margin.
- When you specify both arguments, LEFT is used for the left margin,
-and RIGHT is used for the right margin.
-
- The first word will normally not be hyphenated; you can enable
-hyphenation there by beginning the node with '\hspace{0pt}'.
+ Normally, a note's first word will not be hyphenated. You can enable
+hyphenation there by beginning LEFT or RIGHT with '\hspace{0pt}'.
These parameters affect the formatting of the note:
@@ -5880,88 +7819,171 @@ from falling off the bottom of the page.
16 Math formulas
****************
-There are three environments that put LaTeX in math mode:
+Produce mathematical text by putting LaTeX into math mode or display
+math mode (*note Modes::). This example shows both.
-'math'
- For formulas that appear right in the text.
-'displaymath'
- For formulas that appear on their own line.
-'equation'
- The same as the displaymath environment except that it adds an
- equation number in the right margin.
+ The wave equation for \( u \) is
+ \begin{displaymath}
+ \frac{\partial^2u}{\partial t^2} = c^2\nabla^2u
+ \end{displaymath}
+ where \( \nabla^2 \) is the spatial Laplacian and \( c \) is constant.
+
+Math mode is for inline mathematics. In the above example it is invoked
+by the starting '\(' and finished by the matching ending '\)'. Display
+math mode is for displayed equations and here is invoked by the
+'displaymath' environment. Note that any mathematical text whatever,
+including mathematical text consisting of just one character, is handled
+in math mode.
- The 'math' environment can be used in both paragraph and LR mode, but
-the 'displaymath' and 'equation' environments can be used only in
-paragraph mode. The 'math' and 'displaymath' environments are used so
-often that they have the following short forms:
+ When in math mode or display math mode, LaTeX handles many aspects of
+your input text differently than in other text modes. For example,
- \(...\) instead of \begin{math}...\end{math}
- \[...\] instead of \begin{displaymath}...\end{displaymath}
+ contrast x+y with \( x+y \)
- In fact, the 'math' environment is so common that it has an even
-shorter form:
+in math mode the letters are in italics and the spacing around the plus
+sign is different.
- $ ... $ instead of \(...\)
+ There are three ways to make inline formulas, to put LaTeX in math
+mode.
- The '\boldmath' command changes math letters and symbols to be in a
-bold font. It is used _outside_ of math mode. Conversely, the
-'\unboldmath' command changes math glyphs to be in a normal font; it too
-is used _outside_ of math mode.
+ \( MATHEMATICAL MATERIAL \)
+ $ MATHEMATICAL MATERIAL $
+ \begin{math} MATHEMATICAL MATERIAL \end{math}
- The '\displaystyle' declaration forces the size and style of the
-formula to be that of 'displaymath', e.g., with limits above and below
-summations. For example:
+The first form is preferred and the second is quite common, but the
+third form is rarely used. You can sometimes use one and sometimes
+another, as in '\(x\) and $y$'. You can use these in paragraph mode or
+in LR mode (*note Modes::).
- $\displaystyle \sum_{n=0}^\infty x_n $
+ To make displayed formulas, put LaTeX into display math mode with
+either:
+
+ \begin{displaymath}
+ MATHEMATICAL MATERIAL
+ \end{displaymath}
+
+or
+
+ \begin{equation}
+ MATHEMATICAL MATERIAL
+ \end{equation}
+
+(*note displaymath::, *note equation::). The only difference is that
+with the 'equation' environment, LaTeX puts a formula number alongside
+the formula. The construct '\[ MATH \]' is equivalent to
+'\begin{displaymath} MATH \end{displaymath}'. These environments can
+only be used in paragraph mode (*note Modes::).
+
+ The two mathematics modes are similar, but there are some
+differences. One involves the placement of subscripts and superscripts;
+in display math mode they are further apart and in inline math mode they
+are closer together.
+
+ Sometimes you want the display math typographical treatment to happen
+in the inline math mode. For this, the '\displaystyle' declaration
+forces the size and style of the formula to be that of 'displaymath'.
+Thus '\(\displaystyle \sum_{n=0}^\infty x_n\)' will have the limits
+above and below the summation sign, not next to it. Another example is
+that
+
+ \begin{tabular}{r|cc}
+ \textsc{Name} &\textsc{Series} &\textsc{Sum} \\ \hline
+ Arithmetic &\( a+(a+b)+(a+2b)+\cdots+(a+(n-1)b) \)
+ &\( na+(n-1)n\cdot\frac{b}{2}\) \\
+ Geometric &\( a+ab+ab^2+\cdots+ab^{n-1} \)
+ &\(\displaystyle a\cdot\frac{1-b^n}{1-b}\) \\
+ \end{tabular}
+
+because it has no '\displaystyle', the 'Arithmetic' line's fraction will
+be scrunched. But, because of its '\displaystyle', the 'Geometric'
+line's fraction will be easy to read, with characters the same size as
+in the rest of the line.
+
+ The American Mathematical Society has made freely available a set of
+packages that greatly expand your options for writing mathematics,
+'amsmath' and 'amssymb' (also be aware of the 'mathtools' package that
+is an extension to, and loads, 'amsmath'). New documents that will have
+mathematical text should use these packages. Descriptions of these
+packages is outside the scope of this document; see their documentation
+on CTAN.
16.1 Subscripts & superscripts
==============================
-In math mode, use the caret character '^' to make the EXP appear as a
-superscript: '^{EXP}'. Similarly, in math mode, underscore '_{EXP}'
-makes a subscript out of EXP.
+Synopsis (in math mode or display math mode), one of:
- In this example the '0' and '1' appear as subscripts while the '2' is
-a superscript.
+ BASE^EXP
+ BASE^{EXP}
- \( (x_0+x_1)^2 \)
+or, one of:
- To have more than one character in EXP use curly braces as in
-'e^{-2x}'.
+ BASE_EXP
+ BASE_{EXP}
- LaTeX handles superscripts on superscripts, and all of that stuff, in
-the natural way, so expressions such as 'e^{x^2}' and 'x_{a_0}' will
-look right. It also does the right thing when something has both a
-subscript and a superscript. In this example the '0' appears at the
-bottom of the integral sign while the '10' appears at the top.
+ Make EXP appear as a superscript of BASE (with the caret
+character, '^') or a subscript (with underscore, '_').
- \int_0^{10} x^2 \,dx
+ In this example the '0''s and '1''s are subscripts while the '2''s
+are superscripts.
- You can put a superscript or subscript before a symbol with a
-construct such as '{}_t K^2' in math mode (the initial '{}' prevents the
-prefixed subscript from being attached to any prior symbols in the
-expression).
+ \( (x_0+x_1)^2 \leq (x_0)^2+(x_1)^2 \)
+
+ To have the subscript or superscript contain more than one character,
+surround the expression with curly braces, as in 'e^{-2x}'. This
+example's fourth line shows curly braces used to group an expression for
+the exponent.
+
+ \begin{displaymath}
+ (3^3)^3=27^3=19\,683
+ \qquad
+ 3^{(3^3)}=3^{27}=7\,625\,597\,484\,987
+ \end{displaymath}
- Outside of math mode, a construct like 'A
-test$_\textnormal{subscript}$' will produce a subscript typeset in text
-mode, not math mode. Note that there are packages specialized for
-writing Chemical formulas such as 'mhchem'.
+ LaTeX knows how to handle a superscript on a superscript, or a
+subscript on a subscript, or supers on subs, or subs on supers. So,
+expressions such as 'e^{x^2}' and 'x_{i_0}' give correct output. Note
+the use in those expressions of curly braces to give the BASE a
+determined EXP. If you enter '\(3^3^3\)' then you get 'Double
+superscript'.
+
+ LaTeX does the right thing when something has both a subscript and a
+superscript. In this example the integral has both. They come out in
+the correct place without any author intervention.
+
+ \begin{displaymath}
+ \int_{x=a}^b f'(x)\,dx = f(b)-f(a)
+ \end{displaymath}
+
+Note the parentheses around 'x=a' to make the entire expression a
+subscript.
+
+ To put a superscript or subscript before a symbol, use a construct
+like '{}_t K^2'. The empty curly braces '{}' give the subscript
+something to attach to and keeps it from accidentally attaching to a
+prior symbols.
+
+ Using the subscript or superscript command outside of math mode or
+display math mode, as in 'the expression x^2', will get you the error
+'Missing $ inserted'.
+
+ A common reason to want subscripts outside of a mathematics mode is
+to typeset chemical formulas. There are packages for that such as
+'mhchem'; see CTAN.
16.2 Math symbols
=================
-LaTeX provides almost any mathematical symbol you're likely to need.
-For example, if you include '$\pi$' in your source, you will get the pi
-symbol U+03C0.
+LaTeX provides almost any mathematical or technical symbol that anyone
+uses. For example, if you include '$\pi$' in your source, you will get
+the pi symbol U+03C0. See the 'Comprehensive LaTeX Symbol List' at
+<https://ctan.org/tex-archive/info/symbols/comprehensive/>.
- Below is a list of commonly-available symbols. It is by no means an
-exhaustive list. Each symbol here is described with a short phrase, and
-its symbol class (which determines the spacing around it) is given in
+ Here is a list of commonly-used symbols. It is by no means
+exhaustive. Each symbol is described with a short phrase, and its
+symbol class, which determines the spacing around it, is given in
parenthesis. Unless said otherwise, the commands for these symbols can
-be used only in math mode.
-
- To redefine a command so that it can be used whatever the current
-mode, see *note \ensuremath::.
+be used only in math mode. To redefine a command so that it can be used
+whatever the current mode, see *note \ensuremath::.
'\|'
U+2225 Parallel (relation). Synonym: '\parallel'.
@@ -5970,7 +7992,7 @@ mode, see *note \ensuremath::.
U+2135 Aleph, transfinite cardinal (ordinary).
'\alpha'
- U+03B1 Lower case Greek letter alpha (ordinary).
+ U+03B1 Lowercase Greek letter alpha (ordinary).
'\amalg'
U+2A3F Disjoint union (binary)
@@ -5997,7 +8019,7 @@ mode, see *note \ensuremath::.
'\textbackslash' for backslash outside of math mode.
'\beta'
- U+03B2 Lower case Greek letter beta (ordinary).
+ U+03B2 Lowercase Greek letter beta (ordinary).
'\bigcap'
U+22C2 Variable-sized, or n-ary, intersection (operator). Similar:
@@ -6064,7 +8086,7 @@ mode, see *note \ensuremath::.
U+22C5 Multiplication (binary). Similar: Bullet dot '\bullet'.
'\chi'
- U+03C7 Lower case Greek chi (ordinary).
+ U+03C7 Lowercase Greek chi (ordinary).
'\circ'
U+2218 Function composition, ring operator (binary). Similar:
@@ -6100,18 +8122,18 @@ mode, see *note \ensuremath::.
U+2021 Double dagger relation (binary).
'\Delta'
- U+0394 Greek upper case delta, used for increment (ordinary).
+ U+0394 Greek uppercase delta, used for increment (ordinary).
'\delta'
- U+03B4 Greek lower case delta (ordinary).
+ U+03B4 Greek lowercase delta (ordinary).
'\Diamond'
U+25C7 Large diamond operator (ordinary). Not available in plain
TeX. In LaTeX you need to load the 'amssymb' package.
'\diamond'
- U+22C4 Diamond operator, or diamond bullet (binary). Similar:
- large diamond '\Diamond', circle bullet '\bullet'.
+ U+22C4 Diamond operator (binary). Similar: large
+ diamond '\Diamond', circle bullet '\bullet'.
'\diamondsuit'
U+2662 Diamond card suit (ordinary).
@@ -6124,12 +8146,12 @@ mode, see *note \ensuremath::.
equal to '\Doteq'.
'\downarrow'
- U+2193 Down arrow, converges (relation). Similar: double line down
- arrow '\Downarrow'.
+ U+2193 Down arrow, converges (relation). Similar: '\Downarrow'
+ double line down arrow.
'\Downarrow'
- U+21D3 Double line down arrow (relation). Similar: single line
- down arrow '\downarrow'.
+ U+21D3 Double line down arrow (relation). Similar: '\downarrow'
+ single line down arrow.
'\ell'
U+2113 Lowercase cursive letter l (ordinary).
@@ -6139,7 +8161,7 @@ mode, see *note \ensuremath::.
'\varnothing'.
'\epsilon'
- U+03F5 Lower case lunate epsilon (ordinary). Similar to Greek text
+ U+03F5 Lowercase lunate epsilon (ordinary). Similar to Greek text
letter. More widely used in mathematics is the script small letter
epsilon '\varepsilon' U+03B5. Related: the set membership relation
'\in' U+2208.
@@ -6148,7 +8170,7 @@ mode, see *note \ensuremath::.
U+2261 Equivalence (relation).
'\eta'
- U+03B7 Lower case Greek letter (ordinary).
+ U+03B7 Lowercase Greek letter (ordinary).
'\exists'
U+2203 Existential quantifier (ordinary).
@@ -6163,10 +8185,10 @@ mode, see *note \ensuremath::.
U+2322 Downward curving arc (ordinary).
'\Gamma'
- U+0393 Upper case Greek letter (ordinary).
+ U+0393 uppercase Greek letter (ordinary).
'\gamma'
- U+03B3 Lower case Greek letter (ordinary).
+ U+03B3 Lowercase Greek letter (ordinary).
'\ge'
U+2265 Greater than or equal to (relation). This is a synonym
@@ -6202,8 +8224,12 @@ mode, see *note \ensuremath::.
'\Im'
U+2111 Imaginary part (ordinary). See: real part '\Re'.
+'\imath'
+ Dotless i; used when you are putting an accent on an i (*note Math
+ accents::).
+
'\in'
- U+2208 Set element (relation). See also: lower case lunate
+ U+2208 Set element (relation). See also: lowercase lunate
epsilon '\epsilon'U+03F5 and small letter script
epsilon '\varepsilon'.
@@ -6214,20 +8240,24 @@ mode, see *note \ensuremath::.
U+222B Integral (operator).
'\iota'
- U+03B9 Lower case Greek letter (ordinary).
+ U+03B9 Lowercase Greek letter (ordinary).
'\Join'
U+2A1D Condensed bowtie symbol (relation). Not available in Plain
TeX.
+'\jmath'
+ Dotless j; used when you are putting an accent on a j (*note Math
+ accents::).
+
'\kappa'
- U+03BA Lower case Greek letter (ordinary).
+ U+03BA Lowercase Greek letter (ordinary).
'\Lambda'
- U+039B Upper case Greek letter (ordinary).
+ U+039B uppercase Greek letter (ordinary).
'\lambda'
- U+03BB Lower case Greek letter (ordinary).
+ U+03BB Lowercase Greek letter (ordinary).
'\land'
U+2227 Logical and (binary). This is a synonym for '\wedge'. See
@@ -6349,7 +8379,7 @@ mode, see *note \ensuremath::.
U+2213 Minus or plus (relation).
'\mu'
- U+03BC Lower case Greek letter (ordinary).
+ U+03BC Lowercase Greek letter (ordinary).
'\nabla'
U+2207 Hamilton's del, or differential, operator (ordinary).
@@ -6375,19 +8405,19 @@ mode, see *note \ensuremath::.
Synonym: '\owns'. Similar: is a member of '\in'.
'\not'
- U+0020U+00A0U+0338 Long solidus, or slash, used to overstrike a
- following operator (relation).
+ U+0020 Long solidus, or slash, used to overstrike a following
+ operator (relation).
- Many negated operators that don't require '\not' are available,
+ Many negated operators are available that don't require '\not',
particularly with the 'amssymb' package. For example, '\notin' is
- probably typographically preferable to '\not\in'.
+ typographically preferable to '\not\in'.
'\notin'
U+2209 Not an element of (relation). Similar: not subset
of '\nsubseteq'.
'\nu'
- U+03BD Lower case Greek letter (ordinary).
+ U+03BD Lowercase Greek letter (ordinary).
'\nwarrow'
U+2196 North-west arrow (relation).
@@ -6401,10 +8431,10 @@ mode, see *note \ensuremath::.
(operator).
'\Omega'
- U+03A9 Upper case Greek letter (ordinary).
+ U+03A9 uppercase Greek letter (ordinary).
'\omega'
- U+03C9 Lower case Greek letter (ordinary).
+ U+03C9 Lowercase Greek letter (ordinary).
'\ominus'
U+2296 Minus sign, or dash, inside a circle (binary).
@@ -6436,14 +8466,14 @@ mode, see *note \ensuremath::.
ordinary.
'\phi'
- U+03D5 Lower case Greek letter (ordinary). The variant form is
+ U+03D5 Lowercase Greek letter (ordinary). The variant form is
'\varphi' U+03C6.
'\Pi'
- U+03A0 Upper case Greek letter (ordinary).
+ U+03A0 uppercase Greek letter (ordinary).
'\pi'
- U+03C0 Lower case Greek letter (ordinary). The variant form is
+ U+03C0 Lowercase Greek letter (ordinary). The variant form is
'\varpi' U+03D6.
'\pm'
@@ -6472,10 +8502,10 @@ mode, see *note \ensuremath::.
U+221D Is proportional to (relation)
'\Psi'
- U+03A8 Upper case Greek letter (ordinary).
+ U+03A8 uppercase Greek letter (ordinary).
'\psi'
- U+03C8 Lower case Greek letter (ordinary).
+ U+03C8 Lowercase Greek letter (ordinary).
'\rangle'
U+27E9 Right angle, or sequence, bracket (closing). Similar:
@@ -6498,9 +8528,9 @@ mode, see *note \ensuremath::.
this, load the 'amsfonts' package.
'\restriction'
- U+21BE Restriction of a function (relation).
- Synonym: '\upharpoonright'. Not available in plain TeX. In LaTeX
- you need to load the 'amssymb' package.
+ U+21BE Restriction of a function (relation). Synonym:
+ '\upharpoonright'. Not available in plain TeX. In LaTeX you need
+ to load the 'amssymb' package.
'\revemptyset'
U+29B0 Reversed empty set symbol (ordinary). Related:
@@ -6519,7 +8549,7 @@ mode, see *note \ensuremath::.
gives better spacing).
'\rho'
- U+03C1 Lower case Greek letter (ordinary). The variant form is
+ U+03C1 Lowercase Greek letter (ordinary). The variant form is
'\varrho' U+03F1.
'\Rightarrow'
@@ -6543,18 +8573,18 @@ mode, see *note \ensuremath::.
U+2198 Arrow pointing southeast (relation).
'\setminus'
- U+29F5 Set difference, reverse solidus or slash, like \ (binary).
- Similar: backslash '\backslash' and also '\textbackslash' outside
- of math mode.
+ U+29F5 Set difference, reverse solidus or reverse slash, like \
+ (binary). Similar: backslash '\backslash' and also
+ '\textbackslash' outside of math mode.
'\sharp'
U+266F Musical sharp (ordinary).
'\Sigma'
- U+03A3 Upper case Greek letter (ordinary).
+ U+03A3 uppercase Greek letter (ordinary).
'\sigma'
- U+03C3 Lower case Greek letter (ordinary). The variant form is
+ U+03C3 Lowercase Greek letter (ordinary). The variant form is
'\varsigma' U+03C2.
'\sim'
@@ -6639,10 +8669,10 @@ mode, see *note \ensuremath::.
U+2199 Southwest-pointing arrow (relation).
'\tau'
- U+03C4 Lower case Greek letter (ordinary).
+ U+03C4 Lowercase Greek letter (ordinary).
'\theta'
- U+03B8 Lower case Greek letter (ordinary). The variant form is
+ U+03B8 Lowercase Greek letter (ordinary). The variant form is
'\vartheta' U+03D1.
'\times'
@@ -6715,10 +8745,10 @@ mode, see *note \ensuremath::.
operator '\biguplus'.
'\Upsilon'
- U+03A5 Upper case Greek letter (ordinary).
+ U+03A5 uppercase Greek letter (ordinary).
'\upsilon'
- U+03C5 Lower case Greek letter (ordinary).
+ U+03C5 Lowercase Greek letter (ordinary).
'\varepsilon'
U+03B5 Small letter script epsilon (ordinary). This is more widely
@@ -6731,23 +8761,23 @@ mode, see *note \ensuremath::.
load the 'amssymb' package.
'\varphi'
- U+03C6 Variant on the lower case Greek letter (ordinary). The
+ U+03C6 Variant on the lowercase Greek letter (ordinary). The
non-variant form is '\phi' U+03D5.
'\varpi'
- U+03D6 Variant on the lower case Greek letter (ordinary). The
+ U+03D6 Variant on the lowercase Greek letter (ordinary). The
non-variant form is '\pi' U+03C0.
'\varrho'
- U+03F1 Variant on the lower case Greek letter (ordinary). The
+ U+03F1 Variant on the lowercase Greek letter (ordinary). The
non-variant form is '\rho' U+03C1.
'\varsigma'
- U+03C2 Variant on the lower case Greek letter (ordinary). The
+ U+03C2 Variant on the lowercase Greek letter (ordinary). The
non-variant form is '\sigma' U+03C3.
'\vartheta'
- U+03D1 Variant on the lower case Greek letter (ordinary). The
+ U+03D1 Variant on the lowercase Greek letter (ordinary). The
non-variant form is '\theta' U+03B8.
'\vdash'
@@ -6762,10 +8792,10 @@ mode, see *note \ensuremath::.
U+2016 Vertical double bar (ordinary). Similar: vertical single
bar '\vert'.
- For a norm symbol, you can use the 'mathtools' package and add
- '\DeclarePairedDelimiter\norm{\lVert}{\rVert}' to your preamble.
- This gives you three command variants for double-line vertical bars
- that are correctly horizontally spaced: if in the document body you
+ For a norm symbol, you can use the 'mathtools' package and put in
+ your preamble '\DeclarePairedDelimiter\norm{\lVert}{\rVert}'. This
+ gives you three command variants for double-line vertical bars that
+ are correctly horizontally spaced: if in the document body you
write the starred version '$\norm*{M^\perp}$' then the height of
the vertical bars will match the height of the argument, whereas
with '\norm{M^\perp}' the bars do not grow with the height of the
@@ -6778,10 +8808,10 @@ mode, see *note \ensuremath::.
vertical bar '\Vert'. For such that, as in the definition of a
set, use '\mid' because it is a relation.
- For absolute value you can use the 'mathtools' package and add
- '\DeclarePairedDelimiter\abs{\lvert}{\rvert}' to your preamble.
- This gives you three command variants for single-line vertical bars
- that are correctly horizontally spaced: if in the document body you
+ For absolute value you can use the 'mathtools' package and in your
+ preamble put '\DeclarePairedDelimiter\abs{\lvert}{\rvert}'. This
+ gives you three command variants for single-line vertical bars that
+ are correctly horizontally spaced: if in the document body you
write the starred version '$\abs*{\frac{22}{7}}$' then the height
of the vertical bars will match the height of the argument, whereas
with '\abs{\frac{22}{7}}' the bars do not grow with the height of
@@ -6800,13 +8830,170 @@ mode, see *note \ensuremath::.
U+2240 Wreath product (binary).
'\Xi'
- U+039E Upper case Greek letter (ordinary).
+ U+039E uppercase Greek letter (ordinary).
'\xi'
- U+03BE Lower case Greek letter (ordinary).
+ U+03BE Lowercase Greek letter (ordinary).
'\zeta'
- U+03B6 Lower case Greek letter (ordinary).
+ U+03B6 Lowercase Greek letter (ordinary).
+
+ The following symbols are most often used in plain text but LaTeX
+provides versions to use in mathematical text.
+
+'\mathdollar'
+ Dollar sign in math mode: $.
+
+'\mathparagraph'
+ Paragraph sign (pilcrow) in math mode, U+00B6.
+
+'\mathsection'
+ Section sign in math mode U+00A7.
+
+'\mathsterling'
+ Sterling sign in math mode: #.
+
+'\mathunderscore'
+ Underscore in math mode: _.
+
+16.2.1 Blackboard bold
+----------------------
+
+Synopsis:
+
+ \usepackage{amssymb} % in preamble
+ ...
+ \mathbb{UPPERCASE-LETTER}
+
+ Provide blackboard bold symbols, sometimes also known as doublestruck
+letters, used to denote number sets such as the natural numbers, the
+integers, etc.
+
+ Here
+
+ \( \forall n \in \mathbb{N}, n^2 \geq 0 \)
+
+the '\mathbb{N}' gives blackboard bold symbol U+2115 representing the
+natural numbers.
+
+ If you use other than an uppercase letter then you do not get an
+error but you get strange results, including unexpected characters.
+
+ There are packages that give access to symbols other than just the
+capital letters; look on CTAN.
+
+16.2.2 Calligraphic
+-------------------
+
+Synopsis:
+
+ \mathcal{UPPERCASE-LETTERS}
+
+ Use a script-like font.
+
+ In this example the graph identifier is output in a cursive font.
+
+ Let the graph be \( \mathcal{G} \).
+
+ If you use something other than an uppercase letter then you do not
+get an error. Instead you get unexpected output. For instance,
+'\mathcal{g}' outputs a close curly brace symbol, while '\mathcal{+}'
+outputs a plus sign.
+
+16.2.3 '\boldmath' & '\unboldmath'
+----------------------------------
+
+Synopsis (used in paragraph mode or LR mode):
+
+ \boldmath \( MATH \)
+
+or
+
+ \unboldmath \( MATH \)
+
+ Declarations to change the letters and symbols in MATH to be in a
+bold font, or to countermand that and bring back the regular (non-bold)
+default. They must be used when not in math mode or display math mode
+(*note Modes::). Both commands are fragile (*note \protect::).
+
+ In this example each '\boldmath' command takes place inside an
+'\mbox',
+
+ we have $\mbox{\boldmath \( v \)} = 5\cdot\mbox{\boldmath \( u \)$}$
+
+which means '\boldmath' is only called in a text mode, here LR mode, and
+explains why LaTeX must switch to math mode to set 'v' and 'u'.
+
+ If you use either command inside math mode, as with 'Trouble: \(
+\boldmath x \)', then you get something like 'LaTeX Font Warning:
+Command \boldmath invalid in math mode on input line 11' and 'LaTeX Font
+Warning: Command \mathversion invalid in math mode on input line 11'.
+
+ There are many issues with '\boldmath'. New documents should use the
+'bm' package provided by the LaTeX Project team. A complete description
+is outside the scope of this document (see the full documentation on
+CTAN) but even this small example
+
+ \usepackage{bm} % in preamble
+ ...
+ we have $\bm{v} = 5\cdot\bm{u}$
+
+shows that it is an improvement over '\boldmath'.
+
+16.2.4 Dots, horizontal or vertical
+-----------------------------------
+
+Ellipses are the three dots (usually three) indicating that a pattern
+continues.
+
+ \begin{array}{cccc}
+ a_{0,0} &a_{0,1} &a_{0,2} &\ldots \\
+ a_{1,0} &\ddots \\
+ \vdots
+ \end{array}
+
+ LaTeX provides these.
+
+'\cdots'
+ Horizontal ellipsis with the dots raised to the center of the line,
+ as in U+22EF. Used as: '\( a_0\cdot a_1\cdots a_{n-1} \)'.
+
+'\ddots'
+ Diagonal ellipsis, U+22F1. See the above array example for a
+ usage.
+
+'\ldots'
+ Ellipsis on the baseline, U+2026. Used as: '\( x_0,\ldots x_{n-1}
+ \)'. Another example is the above array example. A synonym is
+ '\mathellipsis'. A synonym from the 'amsmath' package is '\hdots'.
+
+ You can also use this command outside of mathematical text, as in
+ 'The gears, brakes, \ldots{} are all broken'. (In a paragraph mode
+ or LR mode a synonym for '\ldots' is '\dots'.)
+
+'\vdots'
+ Vertical ellipsis, U+22EE. See the above array example for a usage.
+
+ The 'amsmath' package has the command '\dots' to semantically mark up
+ellipses. This example produces two different-looking outputs for the
+first two uses of the '\dots' command.
+
+ \usepackage{amsmath} % in preamble
+ ...
+ Suppose that \( p_0, p_1, \dots, p_{n-1} \) lists all of the primes.
+ Observe that \( p_0\cdot p_1 \dots \cdot p_{n-1} +1 \) is not a
+ multiple of any \( p_i \).
+ Conclusion: there are infinitely many primes \( p_0, p_1, \dotsc \).
+
+In the first line LaTeX looks to the comma following '\dots' to
+determine that it should output an ellipsis on the baseline. The second
+line has a '\cdot' following '\dots' so LaTeX outputs an ellipsis that
+is on the math axis, vertically centered. However, the third usage has
+no follow-on character so you have to tell LaTeX what to do. You can
+use one of the commands: '\dotsc' if you need the ellipsis appropriate
+for a comma following, '\dotsb' if you need the ellipses that fits when
+the dots are followed by a binary operator or relation symbol, '\dotsi'
+for dots with integrals, or '\dotso' for others.
16.3 Math functions
===================
@@ -6815,106 +9002,114 @@ These commands produce roman function names in math mode with proper
spacing.
'\arccos'
- \arccos
+ Inverse cosine
'\arcsin'
- \arcsin
+ Inverse sine
'\arctan'
- \arctan
+ Inverse tangent
'\arg'
- \arg
+ Angle between the real axis and a point in the complex plane
'\bmod'
- Binary modulo operator (x \bmod y)
+ Binary modulo operator, used as in '\( 5\bmod 3=2 \)'
'\cos'
- \cos
+ Cosine
'\cosh'
- \cosh
+ Hyperbolic cosine
'\cot'
- \cot
+ Cotangent
'\coth'
- \coth
+ Hyperbolic cotangent
'\csc'
- \csc
+ Cosecant
'\deg'
- \deg
+ Degrees
'\det'
- \det
+ Determinant
'\dim'
- \dim
+ Dimension
'\exp'
- \exp
+ Exponential
'\gcd'
- \gcd
+ Greatest common divisor
'\hom'
- \hom
+ Homomorphism
'\inf'
- \inf
+ Infinum
'\ker'
- \ker
+ Kernel
'\lg'
- \lg
+ Base 2 logarithm
'\lim'
- \lim
+ Limit
'\liminf'
- \liminf
+ Limit inferior
'\limsup'
- \limsup
+ Limit superior
'\ln'
- \ln
+ Natural logarithm
'\log'
- \log
+ Logarithm
'\max'
- \max
+ Maximum
'\min'
- \min
+ Minimum
'\pmod'
- parenthesized modulus, as in (\pmod 2^n - 1)
+ Parenthesized modulus, as used in '\( 5\equiv 2\pmod 3 \)'
'\Pr'
- \Pr
+ Probability
'\sec'
- \sec
+ Secant
'\sin'
- \sin
+ Sine
'\sinh'
- \sinh
+ Hyperbolic sine
'\sup'
- \sup
+ sup
'\tan'
- \tan
+ Tangent
'\tanh'
- \tanh
+ Hyperbolic tangent
+
+ The 'amsmath' package adds improvements on some of these, and also
+allows you to define your own. The full documentation is on CTAN, but
+briefly, you can define an identity operator with
+'\DeclareMathOperator{\identity}{id}' that is like the ones above but
+prints as 'id'. The starred form '\DeclareMathOperator*{\op}{op}' sets
+any limits above and below, as is traditional with '\lim', '\sup', or
+'\max'.
16.4 Math accents
=================
@@ -6924,77 +9119,137 @@ math. These are different from accents in normal text (*note
Accents::).
'\acute'
- Math acute accent: \acute{x}.
+ Math acute accent
'\bar'
- Math bar-over accent: \bar{x}.
+ Math bar-over accent
'\breve'
- Math breve accent: \breve{x}.
+ Math breve accent
'\check'
- Math ha'c<ek (check) accent: \check{x}.
+ Math ha'c<ek (check) accent
'\ddot'
- Math dieresis accent: \ddot{x}.
+ Math dieresis accent
'\dot'
- Math dot accent: \dot{x}.
+ Math dot accent
'\grave'
- Math grave accent: \grave{x}.
+ Math grave accent
'\hat'
- Math hat (circumflex) accent: \hat{x}.
-
-'\imath'
- Math dotless i.
-
-'\jmath'
- Math dotless j.
+ Math hat (circumflex) accent
'\mathring'
- Math ring accent: x*.
+ Math ring accent
'\tilde'
- Math tilde accent: \tilde{x}.
+ Math tilde accent
'\vec'
- Math vector symbol: \vec{x}.
+ Math vector symbol
'\widehat'
- Math wide hat accent: \widehat{x+y}.
+ Math wide hat accent
'\widetilde'
- Math wide tilde accent: \widetilde{x+y}.
+ Math wide tilde accent
+
+ When you are putting an accent on an i or a j, the tradition is to
+use one without a dot, '\imath' or 'jmath' (*note Math symbols::).
+
+16.5 Over- and Underlining
+==========================
+
+LaTeX provides commands for making overlines or underlines, or putting
+braces over or under some material.
-16.5 Spacing in math mode
+'\underline{TEXT}'
+ Underline TEXT. Works inside math mode, and outside. The line is
+ always completely below the text, taking account of descenders, so
+ in '\(\underline{y}\)' the line is lower than in
+ '\(\underline{x}\)'. This command is fragile (*note \protect::).
+
+ Note that the package 'ulem' does text mode underlining and allows
+ line breaking as well as a number of other features. See the
+ documentation on CTAN. See also *note \hrulefill & \dotfill:: for
+ producing a line, for such things as a signature.
+
+'\overline{TEXT}'
+ Put a horizontal line over TEXT. Works inside math mode, and
+ outside. For example, '\overline{x+y}'. Note that this differs
+ from the command '\bar' (*note Math accents::).
+
+'\underbrace{MATH}'
+ Put a brace under MATH. For example, this
+ '(1-\underbrace{1/2)+(1/2}-1/3)' emphasizes the telescoping part.
+ Attach text to the brace by using subscript, '_', or superscript,
+ '^', as here.
+
+ \begin{displaymath}
+ 1+1/2+\underbrace{1/3+1/4}_{>1/2}+
+ \underbrace{1/5+1/6+1/7+1/8}_{>1/2}+\cdots
+ \end{displaymath}
+
+ The superscript appears on top of the expression, and so can look
+ unconnected to the underbrace.
+
+'\overbrace{MATH}'
+ Put a brace over MATH, as with
+ '\overbrace{x+x+\cdots+x}^{\mbox{\(k\) times}}'. See also
+ '\underbrace'.
+
+ The package 'mathtools' adds an over- and underbrace, as well as some
+improvements on the braces. See the documentation on CTAN.
+
+16.6 Spacing in math mode
=========================
-In a 'math' environment, LaTeX ignores the spaces that you use in the
-source, and instead puts in the spacing according to the normal rules
-for mathematics texts.
+When typesetting mathematics, LaTeX puts in spacing according to the
+normal rules for mathematics texts. If you enter 'y=m x' then LaTeX
+ignores the space and in the output the m is next to the x, as y=mx.
- Many math mode spacing definitions are expressed in terms of the math
-unit "mu" given by 1 em = 18 mu, where the em is taken from the current
-math symbols family (*note Units of length::). LaTeX provides the
-following commands for use in math mode:
+ But LaTeX's rules sometimes need tweaking. For example, in an
+integral the tradition is to put a small extra space between the 'f(x)'
+and the 'dx', here done with the '\,' command.
+
+ \int_0^1 f(x)\,dx
+
+ LaTeX provides the commands that follow for use in math mode. Many
+of these spacing definitions are expressed in terms of the math unit
+"mu". It is defined as 1/18em, where the em is taken from the current
+math symbols family (*note Units of length::). Thus, a '\thickspace' is
+something like 5/18 times the width of a 'M'.
'\;'
- Normally '5.0mu plus 5.0mu'. The longer name is '\thickspace'.
- Math mode only.
+ Synonym: '\thickspace'. Normally '5.0mu plus 5.0mu'. Math mode
+ only.
'\:'
'\>'
- Normally '4.0mu plus 2.0mu minus 4.0mu'. The longer name is
- '\medspace'. Math mode only.
+ Synonym: '\medspace'. Normally '4.0mu plus 2.0mu minus 4.0mu'.
+ Math mode only.
'\,'
- Normally '3mu'. The longer name is '\thinspace'. This can be used
- in both math mode and text mode. *Note \thinspace::.
+ Synonym: '\thinspace'. Normally '3mu', which is 1/6em. Can be
+ used in both math mode and text mode (*note \thinspace &
+ \negthinspace::).
+
+ This space is widely used, for instance between the function and
+ the infinitesimal in an integral '\int f(x)\,dx' and, if an author
+ does this, before punctuation in a displayed equation.
+
+ The antiderivative is
+ \begin{equation}
+ 3x^{-1/2}+3^{1/2}\,.
+ \end{equation}
'\!'
- A negative thin space. Normally '-3mu'. Math mode only.
+ A negative thin space. Normally '-3mu'. The '\!' command is math
+ mode only but the '\negthinspace' command is available for text
+ mode (*note \thinspace & \negthinspace::).
'\quad'
This is 18mu, that is, 1em. This is often used for space
@@ -7006,133 +9261,170 @@ following commands for use in math mode:
A length of 2 quads, that is, 36mu = 2em. It is available in both
text and math mode.
- In this example a thinspace separates the function from the
-infinitesimal.
+16.7 Math miscellany
+====================
- \int_0^1 f(x)\,dx
+LaTeX contains a wide variety of mathematics facilities. Here are some
+that don't fit into other categories.
-16.6 Math miscellany
-====================
+16.7.1 Colon character ':' & '\colon'
+-------------------------------------
-'\*'
- A "discretionary" multiplication symbol, at which a line break is
- allowed. Without the break multiplication is implicitly indicated
- by a space, while in the case of a break a U+00D7 symbol is printed
- immediately before the break. So
+Synopsis, one of:
- \documentclass{article}
- \begin{document}
- Now \(A_3 = 0\), hence the product of all terms \(A_1\)
- through \(A_4\), that is \(A_1\* A_2\* A_3 \* A_4\), is
- equal to zero.
- \end{document}
+ :
+ \colon
- will make that sort of output (the ellipsis '[...]' is here to show
- the line break at the same place as in a TeX output):
+ In mathematics, the colon character, ':', is a relation.
- Now A_3 = 0, [...] A_1 through A_4, that is A_1 A_2 \times
- A_3 A_4, is equal to zero.
+ With side ratios \( 3:4 \) and \( 4:5 \), the triangle is right.
-'\cdots'
- A horizontal ellipsis with the dots raised to the center of the
- line.
+Ordinary LaTeX defines '\colon' to produce the colon character with the
+spacing appropriate for punctuation, as in set-builder notation
+'\{x\colon 0\leq x<1\}'.
-'\ddots'
- A diagonal ellipsis: \ddots.
+ But the widely-used 'amsmath' package defines '\colon' for use in the
+definition of functions 'f\colon D\to C'. So if you want the colon
+character as a punctuation then use '\mathpunct{:}'.
-'\frac{NUM}{DEN}'
- Produces the fraction NUM divided by DEN.
+16.7.2 '\*'
+-----------
-'\left DELIM1 ... \right DELIM2'
- The two delimiters need not match; '.' acts as a "null delimiter",
- producing no output. The delimiters are sized according to the
- math in between. Example: '\left( \sum_{i=1}^{10} a_i \right]'.
+Synopsis:
-'\mathdollar'
- Dollar sign in math mode: $.
+ \*
-'\mathellipsis'
- Ellipsis (spaced for text) in math mode: ....
+ A multiplication symbol that allows a line break. If there is a
+break then LaTeX puts a '\times' symbol, U+00D7, before that break.
-'\mathparagraph'
- Paragraph sign (pilcrow) in math mode: U+00B6.
+ In '\( A_1\* A_2\* A_3\* A_4 \)', if there is no line break then
+LaTeX outputs it as though it were '\( A_1 A_2 A_3 A_4 \)'. If a line
+break does happen, for example between the two middle ones, then LaTeX
+sets it like '\( A_1 A_2 \times \)', followed by the break, followed by
+'\( A_3 A_4 \)'.
-'\mathsection'
- Section sign in math mode.
+16.7.3 '\frac'
+--------------
-'\mathsterling'
- Sterling sign in math mode: #.
+Synopsis:
-'\mathunderscore'
- Underscore in math mode: _.
+ \frac{NUMERATOR}{DENOMINATOR}
-'\overbrace{MATH}'
- Generates a brace over MATH. For example,
- '\overbrace{x+\cdots+x}^{k \;\textrm{times}}'.
+ Produces the fraction. Used as: '\begin{displaymath}
+\frac{1}{\sqrt{2\pi\sigma}} \end{displaymath}'. In inline math mode it
+comes out small; see the discussion of '\displaystyle' (*note Math
+formulas::).
-'\overline{TEXT}'
- Generates a horizontal line over TEX. For example,
- '\overline{x+y}'.
+16.7.4 '\left' & '\right'
+-------------------------
-'\sqrt[ROOT]{ARG}'
- Produces the representation of the square root of ARG. The
- optional argument ROOT determines what root to produce. For
- example, the cube root of 'x+y' would be typed as '\sqrt[3]{x+y}'.
+Synopsis:
-'\stackrel{TEXT}{RELATION}'
- Puts TEXT above RELATION. For example,
- '\stackrel{f}{\longrightarrow}'.
+ \left DELIMITER1 ... \right DELIMITER2
-'\underbrace{MATH}'
- Generates MATH with a brace underneath. For example,
- '\underbrace{x+y+z}_{>\,0}'
+ Make matching parentheses, braces, or other delimiters. The
+delimiters are sized according to the math they enclose. This makes a
+unit vector surrounded by appropriate-height parentheses.
-'\underline{TEXT}'
- Causes TEXT, which may be either math mode or not, to be
- underlined. The line is always below the text, taking account of
- descenders.
+ \begin{equation}
+ \left(\begin{array}{c}
+ 1 \\
+ 0 \\
+ \end{array}\right)
-'\vdots'
- Produces a vertical ellipsis.
+ Every '\left' must have a matching '\right'. Leaving out the
+'\left(' in the above gets 'Extra \right'. Leaving off the '\right)'
+gets 'You can't use `\eqno' in math mode'.
-17 Modes
-********
+ However, the two delimiters DELIMITER1 and DELIMITER2 need not match.
+A common case is that you want an unmatched brace, as below. Use a
+period, '.', as a null delimiter.
-When LaTeX is processing your input text, it is always in one of three
-modes:
+ \begin{equation}
+ f(n)=\left\{\begin{array}{ll}
+ 1 &\mbox{--if \(n=0\)} \\
+ f(n-1)+3n^2 &\mbox{--else}
+ \end{array}\right.
+ \end{equation}
- * Paragraph mode
- * Math mode
- * Left-to-right mode, called LR mode for short
+Note that to get a curly brace as a delimiter you must prefix it with a
+backslash, '\{'.
- Mode changes occur only when entering or leaving an environment, or
-when LaTeX is processing the argument of certain text-producing
-commands.
+16.7.5 '\sqrt'
+--------------
+
+Synopsis, one of:
+
+ \sqrt{ARG}
+ \sqrt[ROOT-NUMBER]{ARG}
+
+ The square root, or optionally other roots, of ARG. The optional
+argument ROOT-NUMBER gives the root, i.e., enter the cube root of 'x+y'
+as '\sqrt[3]{x+y}'. The radical grows with the size of ARG (as the
+height of the radical grows, the angle on the leftmost part gets
+steeper, until for a large enough 'arg', it is vertical).
+
+ LaTeX has a separate '\surd' character (*note Math symbols::).
+
+16.7.6 '\stackrel'
+------------------
+
+Synopsis, one of:
+
+ \stackrel{TEXT}{RELATION}
- "Paragraph mode" is the most common; it's the one LaTeX is in when
-processing ordinary text. In this mode, LaTeX breaks the input text
-into lines and breaks the lines into pages.
-
- LaTeX is in "math mode" when it's generating a mathematical formula,
-either displayed math or within a line.
-
- In "LR mode", as in paragraph mode, LaTeX considers the output that
-it produces to be a string of words with spaces between them. However,
-unlike paragraph mode, LaTeX keeps going from left to right; it never
-starts a new line in LR mode. Even if you put a hundred words into an
-'\mbox', LaTeX would keep typesetting them from left to right inside a
-single box (and then most likely complain because the resulting box was
-too wide to fit on the line). LaTeX is in LR mode when it starts making
-a box with an '\mbox' command. You can get it to enter a different mode
-inside the box--for example, you can make it enter math mode to put a
-formula in the box.
-
- There are also several text-producing commands and environments for
-making a box that put LaTeX into paragraph mode. The box made by one of
-these commands or environments will be called a 'parbox'. When LaTeX is
-in paragraph mode while making a box, it is said to be in "inner
-paragraph mode" (no page breaks). Its normal paragraph mode, which it
-starts out in, is called "outer paragraph mode".
+ Put TEXT above RELATION. To put a function name above an arrow enter
+'\stackrel{f}{\longrightarrow}'.
+
+17 Modes
+********
+
+As LaTeX processes your document, at any point it is in one of six
+modes. They fall into three categories of two each, the horizontal
+modes, the math modes, and the vertical modes. Some commands only work
+in one mode or another (in particular, many commands only work in one of
+the math modes), and error messages will refer to these.
+
+ * "Paragraph mode" is what LaTeX is in when processing ordinary text.
+ It breaks the input text into lines and breaks the lines into
+ pages. This is the mode LaTeX is in most of the time.
+
+ "LR mode" (for left-to-right mode; in plain TeX this is called
+ "restricted horizontal mode") is in effect when LaTeX starts making
+ a box with an '\mbox' command. As in paragraph mode, LaTeX's
+ output is a string of words with spaces between them. Unlike in
+ paragraph mode, in LR mode LaTeX never starts a new line, it just
+ keeps going from left to right. (Although LaTeX will not complain
+ that the LR box is too long, when it is finished and next tries to
+ put that box into a line, it could very well complain that the
+ finished LR box won't fit there.)
+
+ * "Math mode" is when LaTeX is generating an inline mathematical
+ formula.
+
+ "Display math mode" is when LaTeX is generating a displayed
+ mathematical formula. (Displayed formulas differ somewhat from
+ inline ones. One example is that the placement of the subscript on
+ '\int' differs in the two situations.)
+
+ * "Vertical mode" is when LaTeX is building the list of lines and
+ other material making the output page. This is the mode LaTeX is
+ in when it starts a document.
+
+ "Internal vertical mode" is in effect when LaTeX starts making a
+ '\vbox'. This is the vertical analogue of LR mode.
+
+For instance, if you begin a LaTeX article with 'Let \( x \) be ...'
+then these are the modes: first LaTeX starts every document in vertical
+mode, then it reads the 'L' and switches to paragraph mode, then the
+next switch happens at the '\(' where LaTeX changes to math mode, and
+then when it leaves the formula it pops back to paragraph mode.
+
+ Paragraph mode has two subcases. If you use a '\parbox' command or
+or a 'minipage' then LaTeX is put into paragraph mode. But it will not
+put a page break here. Inside one of these boxes, called a "parbox",
+LaTeX is in "inner paragraph mode". Its more usual situation, where it
+can put page breaks, is "outer paragraph mode" (*note Page breaking::).
17.1 '\ensuremath'
==================
@@ -7141,86 +9433,162 @@ Synopsis:
\ensuremath{FORMULA}
- The '\ensuremath' command ensures that FORMULA is typeset in math
-mode whatever the current mode in which the command is used.
+ Ensure that FORMULA is typeset in math mode.
- For instance:
+ For instance, you can redefine commands that ordinarily can be used
+only in math mode, so that they can be used both in math and in plain
+text.
- \documentclass{report}
- \newcommand{\ab}{\ensuremath{(\delta, \varepsilon)}}
- \begin{document}
- Now, the \ab\ pair is equal to \(\ab = (\frac{1}{\pi}, 0)\), ...
- \end{document}
+ \newcommand{\dx}{\ensuremath{dx}}
+ In $\int f(x)\, \dx$, the \dx{} is an infinitesimal.
- One can redefine commands that can be used only in math mode so that
-they ca be used in any mode like in the following example given for
-'\leadsto':
+ Caution: the '\ensuremath' command is useful but not a panacea.
- \documentclass{report}
- \usepackage{amssymb}
- \newcommand{\originalMeaningOfLeadsTo}{}
- \let\originalMeaningOfLeadsTo\leadsto
- \renewcommand\leadsto{\ensuremath{\originalMeaningOfLeadsTo}}
- \begin{document}
- All roads \leadsto\ Rome.
- \end{document}
+ \newcommand{\alf}{\ensuremath{\alpha}}
+ You get an alpha in text mode: \alf.
+ But compare the correct spacing in $\alf+\alf$ with that in \alf+\alf.
+
+Best is to typeset math things in a math mode.
18 Page styles
**************
-The '\documentclass' command determines the size and position of the
-page's head and foot. The page style determines what goes in them.
+The style of a page determines where LaTeX places the components of that
+page, such as headers and footers, and the text body. This includes
+pages in the main part of the document but also includes special pages
+such as the title page of a book, a page from an index, or the first
+page of an article.
+
+ The package 'fancyhdr' is very helpful for constructing page styles.
+See its documentation on CTAN.
18.1 '\maketitle'
=================
-The '\maketitle' command generates a title on a separate title
-page--except in the 'article' class, where the title is placed at the
-top of the first page. Information used to produce the title is
-obtained from the following declarations:
+Synopsis:
+
+ \maketitle
+
+ Generate a title. In the standard classes the title appears on a
+separate page, except in the 'article' class where it is at the top of
+the first page. (*Note Document class options:: for information about
+the 'titlepage' document class option.)
+
+ This example shows '\maketitle' appearing in its usual place,
+immediately after '\begin{document}'.
-'\author{NAME \and NAME2}'
- The '\author' command declares the document author(s), where the
- argument is a list of authors separated by '\and' commands. Use
- '\\' to separate lines within a single author's entry--for example,
- to give the author's institution or address.
+ \documentclass{article}
+ \title{Constructing a Nuclear Reactor Using Only Coconuts}
+ \author{Jonas Grumby\thanks{%
+ With the support of a Ginger Grant from the Roy Hinkley Society.} \\
+ Skipper, \textit{Minnow}
+ \and
+ Willy Gilligan\thanks{%
+ Thanks to the Mary Ann Summers foundation
+ and to Thurston and Lovey Howell.} \\
+ Mate, \textit{Minnow}
+ }
+ \date{1964-Sep-26}
+ \begin{document}
+ \maketitle
+ Just sit right back and you'll hear a tale, a tale of a fateful trip.
+ That started from this tropic port, aboard this tiny ship. The mate was
+ a mighty sailin' man, the Skipper brave and sure. Five passengers set
+ sail that day for a three hour tour. A three hour tour.
+ ...
+
+ You tell LaTeX the information used to produce the title by making
+the following declarations. These must come before the '\maketitle',
+either in the preamble or in the document body.
+
+'\author{NAME1 \and NAME2 \and ...}'
+ Required. Declare the document author or authors. The argument is
+ a list of authors separated by '\and' commands. To separate lines
+ within a single author's entry, for instance to give the author's
+ institution or address, use a double backslash, '\\'. If you omit
+ the '\author' declaration then you get 'LaTeX Warning: No \author
+ given'.
'\date{TEXT}'
- The '\date' command declares TEXT to be the document's date. With
- no '\date' command, the current date (*note \today::) is used.
+ Optional. Declare TEXT to be the document's date. The TEXT
+ doesn't need to be in a date format; it can be any text at all. If
+ you omit '\date' then LaTeX uses the current date (*note \today::).
+ To have no date, instead use '\date{}'.
'\thanks{TEXT}'
- The '\thanks' command produces a '\footnote' to the title, usually
- used for credit acknowledgements.
+ Optional. Produce a footnote. You can use it in the author
+ information for acknowledgements, as illustrated below, but you can
+ also use it in the title, or any place a footnote makes sense. It
+ can be any text so you can use it to print an email address, or for
+ any purpose.
'\title{TEXT}'
- The '\title' command declares TEXT to be the title of the document.
- Use '\\' to force a line break, as usual.
+ Required. Declare TEXT to be the title of the document. Get line
+ breaks inside TEXT with a double backslash, '\\'. If you omit the
+ '\title' declaration then you get 'LaTeX Error: No \title given'.
+
+ Many publishers will provide a class to use in place of 'article' in
+that example, that formats the title according to their house
+requirements. To make your own, see *note titlepage::. You can either
+create this as a one-off or you can include it as part of a renewed
+'\maketitle' command.
18.2 '\pagenumbering'
=====================
Synopsis:
- \pagenumbering{STYLE}
+ \pagenumbering{NUMBER-STYLE}
- Specifies the style of page numbers, according to STYLE; also resets
-the page number to 1. The STYLE argument is one of the following:
+ Specifies the style of page numbers, and resets the page number. The
+numbering style is reflected on the page, and also in the table of
+contents and other page references. This declaration has global scope
+so its effect is not delimited by braces or environments.
+
+ In this example, before the Main section the pages are numbered 'a',
+etc. Starting on the page containing that section, the pages are
+numbered '1', etc.
+
+ \begin{document}\pagenumbering{alph}
+ ...
+ \section{Main}\pagenumbering{arabic}
+ ...
+
+ The argument NUMBER-STYLE is one of the following (see also *note
+\alph \Alph \arabic \roman \Roman \fnsymbol::).
'arabic'
- arabic numerals
+ arabic numerals: 1, 2, ...
'roman'
- lowercase Roman numerals
+ lowercase Roman numerals: i, ii, ...
'Roman'
- uppercase Roman numerals
+ uppercase Roman numerals: I, II, ...
'alph'
- lowercase letters
+ lowercase letters: a, b, ... If you have more than 26 pages then
+ you get 'LaTeX Error: Counter too large'.
'Alph'
- uppercase letters
+ uppercase letters: A, B, ... If you have more than 26 pages then
+ you get 'LaTeX Error: Counter too large'.
+
+'gobble'
+ LaTeX does not output a page number, although it does get reset.
+ References to that page also are blank. (This does not work with
+ the popular package 'hyperref' so to have the page number not
+ appear you may want to instead use '\pagestyle{empty}' or
+ '\thispagestyle{empty}'.)
+
+ Traditionally, if a document has front matter--preface, table of
+contents, etc.--then it is numbered with lowercase Roman numerals. The
+main matter of a document uses arabic. *Note \frontmatter & \mainmatter
+& \backmatter::.
+
+ If you want to address where the page number appears on the page,
+see *note \pagestyle::. If you want to change the value of page number
+then you will manipulate the 'page' counter (*note Counters::).
18.3 '\pagestyle'
=================
@@ -7229,109 +9597,276 @@ Synopsis:
\pagestyle{STYLE}
- The '\pagestyle' command specifies how the headers and footers are
-typeset from the current page onwards. Values for STYLE:
+ Declaration that specifies how the page headers and footers are
+typeset, from the current page onwards.
+
+ A discussion with an example is below. Note first that the package
+'fancyhdr' is now the standard way to manipulate headers and footers.
+New documents that need to do anything other than one of the standard
+options below should use this package. See its documentation on CTAN.
+
+ Values for STYLE:
'plain'
- Just a plain page number.
+ The header is empty. The footer contains only a page number,
+ centered.
'empty'
- Empty headers and footers, e.g., no page numbers.
+ The header and footer is empty.
'headings'
- Put running headers on each page. The document style specifies
- what goes in the headers.
+ Put running headers and footers on each page. The document style
+ specifies what goes in there; see the discussion below.
'myheadings'
Custom headers, specified via the '\markboth' or the '\markright'
commands.
+ Some discussion of the motivation for LaTeX's mechanism will help you
+work with the options 'headings' or 'myheadings'. The document source
+below produces an article, two-sided, with the pagestyle 'headings'. On
+this document's left hand pages, LaTeX wants (in addition to the page
+number) the title of the current section. On its right hand pages LaTeX
+wants the title of the current subsection. When it makes up a page,
+LaTeX gets this information from the commands '\leftmark' and
+'\rightmark'. So it is up to '\section' and '\subsection' to store that
+information there.
+
+ \documentclass[twoside]{article}
+ \pagestyle{headings}
+ \begin{document}
+ ... \section{Section 1} ... \subsection{Subsection 1.1} ...
+ \section{Section 2}
+ ...
+ \subsection{Subsection 2.1}
+ ...
+ \subsection{Subsection 2.2}
+ ...
+
+Suppose that the second section falls on a left page. Although when the
+page starts it is in the first section, LaTeX will put 'Section 2' in
+the left page header. As to the right header, if no subsection starts
+before the end of the right page then LaTeX blanks the right hand
+header. If a subsection does appear before the right page finishes then
+there are two cases. If at least one subsection starts on the right
+hand page then LaTeX will put in the right header the title of the first
+subsection starting on that right page. If at least one of 2.1, 2.2,
+..., starts on the left page but none starts on the right then LaTeX
+puts in the right hand header the title of the last subsection to start,
+that is, the one in effect during the right hand page.
+
+ To accomplish this, in a two-sided article, LaTeX has '\section'
+issue a command '\markboth', setting '\leftmark' to 'Section 2' and
+setting '\rightmark' to blank. And, LaTeX has '\subsection' issue a
+command '\markright', setting '\rightmark' to 'Subsection 2.1', etc.
+
Here are the descriptions of '\markboth' and '\markright':
-'\markboth{LEFT}{RIGHT}'
- Sets both the left and the right heading. A "left-hand heading"
- (LEFT) is generated by the last '\markboth' command before the end
- of the page, while a "right-hand heading" (RIGHT) is generated by
- the first '\markboth' or '\markright' that comes on the page if
- there is one, otherwise by the last one before the page.
+'\markboth{LEFT-HEAD}{RIGHT-HEAD}'
+ Sets both the right hand and left hand heading information for
+ either a page style of 'headings' or 'myheadings'. A left hand
+ page heading LEFT-HEAD is generated by the last '\markboth' command
+ before the end of the page. A right hand page heading RIGHT-HEAD
+ is generated by the first '\markboth' or '\markright' that comes on
+ the page if there is one, otherwise by the last one that came
+ before that page.
'\markright{RIGHT}'
- Sets the right heading, leaving the left heading unchanged.
+ Sets the right hand page heading, leaving the left unchanged.
-18.4 '\thispagestyle{STYLE}'
-============================
+18.4 '\thispagestyle'
+=====================
+
+Synopsis:
+
+ \thispagestyle{STYLE}
+
+ Works in the same way as the '\pagestyle' (*note \pagestyle::),
+except that it changes to STYLE for the current page only. This
+declaration has global scope, so its effect is not delimited by braces
+or environments.
+
+ Often the first page of a chapter or section has a different style.
+For example, this LaTeX book document has the first page of the first
+chapter in in 'plain' style, as is the default (*note Page styles::).
-The '\thispagestyle' command works in the same manner as the
-'\pagestyle' command (see previous section) except that it changes to
-STYLE for the current page only.
+ \documentclass{book}
+ \pagestyle{headings}
+ \begin{document}
+ \chapter{First chapter}
+ ...
+ \chapter{Second chapter}\thispagestyle{empty}
+ ...
+
+The 'plain' style has a page number on it, centered in the footer. To
+make the page entirely empty, the command '\thispagestyle{empty}'
+immediately follows the second '\chapter'.
19 Spaces
*********
-LaTeX has many ways to produce white (or filled) space.
+LaTeX has many ways to produce white (or filled) space. Some of these
+are best suited to mathematical text; see *note Spacing in math mode::.
+Some spacing commands are suitable for both regular text and
+mathematical text; versions of some of these commands are in this
+chapter.
+
+19.1 '\enspace' & '\quad' & '\qquad'
+====================================
+
+Synopsis, one of:
+
+ \enspace
+ \quad
+ \qquad
+
+ Insert a horizontal space of 1/2em, 1em, or 2em. The em is a length
+defined by a font designer, often thought of as being the width of a
+capital M. One advantage of describing space in ems is that it can be
+more portable across documents than an absolute measurement such as
+points (*note Lengths/em::).
+
+ This puts a suitable gap between two graphics.
+
+ \begin{center}
+ \includegraphics{womensmile.png}%
+ \qquad\includegraphics{mensmile.png}
+ \end{center}
-19.1 '\hspace'
+*Note Spacing in math mode:: for '\quad' and '\qquad'. These are
+lengths from centuries of typesetting and so may be a better choice in
+many circumstances than arbitrary lengths, such as you get with
+'\hspace'.
+
+19.2 '\hspace'
==============
-Synopsis:
+Synopsis, one of:
\hspace{LENGTH}
\hspace*{LENGTH}
- Add the horizontal space given by LENGTH. The LENGTH is a rubber
-length, that is, it may contain a 'plus' or 'minus' component, in any
-unit that LaTeX understands (*note Lengths::).
+ Insert the horizontal space LENGTH. The LENGTH can be positive,
+negative, or zero; adding negative space is like backspacing. It is a
+rubber length, that is, it may contain a 'plus' or 'minus' component, or
+both (*note Lengths::). Because the space is stretchable and
+shrinkable, it is sometimes called "glue".
+
+ This makes a line with 'Name:' an inch from the right margin.
+
+ \noindent\makebox[\linewidth][r]{Name:\hspace{1in}}
+
+ The '*'-version inserts horizontal space that non-discardable. More
+precisely, when TeX breaks a paragraph into lines any white space--glues
+and kerns--that come at a line break are discarded. The '*'-version
+avoids that (technically, it adds a non-discardable invisible item in
+front of the space).
- This command can add both positive and negative space; adding
-negative space is like backspacing.
+ In this example
- Normally when TeX breaks a paragraph into lines it discards white
-space (glues and kerns) that would come at the start of a line, so you
-get an inter-word space or a line break between words but not both.
-This command's starred version '\hspace*{...}' puts a non-discardable
-invisible item in front of the space, so the space appears in the
-output.
+ \parbox{0.8\linewidth}{%
+ Fill in each blank: Four \hspace*{1in} and seven years ago our
+ fathers brought forth on this continent, a new \hspace*{1in},
+ conceived in \hspace*{1in}, and dedicated to the proposition
+ that all men are created \hspace*{1in}.}
- This example make a one-line paragraph that puts 'Name:' an inch from
-the right margin.
+the 1 inch blank following 'conceived in' falls at the start of a line.
+If you erase the '*' then LaTeX discards the blank.
+
+ Here, the '\hspace' separates the three graphics.
+
+ \begin{center}
+ \includegraphics{lion.png}% comment keeps out extra space
+ \hspace{1cm minus 0.25cm}\includegraphics{tiger.png}%
+ \hspace{1cm minus 0.25cm}\includegraphics{bear.png}
+ \end{center}
- \noindent\makebox[\linewidth]{\hspace{\fill}Name:\hspace{1in}}
+Because the argument to each '\hspace' has 'minus 0.25cm', each can
+shrink a little if the three figures are too wide. But each space won't
+shrink more than 0.25cm (*note Lengths::).
-19.2 '\hfill'
+19.3 '\hfill'
=============
-Produce a rubber length which has no natural space but can stretch
-horizontally as far as needed (*note Lengths::).
+Synopsis:
+
+ \hfill
+
+ Produce a rubber length which has no natural space but that can
+stretch horizontally as far as needed (*note Lengths::).
+
+ This creates a one-line paragraph with 'Name:' on the left side of
+the page and 'Quiz One' on the right.
+
+ \noindent Name:\hfill Quiz One
+
+ The '\hfill' command is equivalent to '\hspace{\fill}' and so the
+space can be discarded at line breaks. To avoid that instead use
+'\hspace*{\fill}' (*note \hspace::).
+
+ Here the graphs are evenly spaced in the middle of the figure.
- The command '\hfill' is equivalent to '\hspace{\fill}'. For space
-that does not disappear at line breaks use '\hspace*{\fill}' instead
-(*note \hspace::).
+ \newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
+ ...
+ \begin{figure}
+ \hspace*{\fill}%
+ \vcenteredhbox{\includegraphics{graph0.png}}%
+ \hfill\vcenteredhbox{\includegraphics{graph1.png}}%
+ \hspace*{\fill}%
+ \caption{Comparison of two graphs} \label{fig:twographs}
+ \end{figure}
+
+Note the '\hspace*''s where the space could otherwise be dropped.
+
+19.4 '\hss'
+===========
+
+Synopsis:
-19.3 '\spacefactor'
+ \hss
+
+ Produce a horizontal space that is infinitely shrinkable as well as
+infinitely stretchable (this command is a TeX primitive). LaTeX authors
+should reach first for the '\makebox' command to get the effects of
+'\hss' (*note \mbox & \makebox::).
+
+ Here, the first line's '\hss' makes the Z stick out to the right,
+overwriting the Y. In the second line the Z sticks out to the left,
+overwriting the X.
+
+ X\hbox to 0pt{Z\hss}Y
+ X\hbox to 0pt{\hss Z}Y
+
+Without the '\hss' you get something like 'Overfull \hbox (6.11111pt too
+wide) detected at line 20'.
+
+19.5 '\spacefactor'
===================
Synopsis:
\spacefactor=INTEGER
- While LaTeX is making the page, to give the lines the best appearance
-it may stretch or shrink the gaps between words. The '\spacefactor'
-command (from Plain TeX) allows you to change the LaTeX's default
-behavior.
+ Influence LaTeX's glue stretch and shrink behavior. Most user-level
+documents do not use this command.
+
+ While LaTeX is laying out the material, it may stretch or shrink the
+gaps between words. (This space is not a character; it is called the
+"interword glue"; *note \hspace::). The '\spacefactor' command (from
+Plain TeX) allows you to, for instance, have the space after a period
+stretch more than the space after a word-ending letter.
After LaTeX places each character, or rule or other box, it sets a
parameter called the "space factor". If the next thing in the input is
-a space then this parameter affects how much of a horizontal gap LaTeX
-will have it span. (This gap is not a character; it is called
-"interword glue".) A larger space factor means that the glue gap can
-stretch more and shrink less.
-
- Normally, the space factor is 1000; this value is in effect following
-most characters, and any non-character box or math formula. But it is
-3000 after a period, exclamation mark, or question mark, it is 2000
-after a colon, 1500 after a semicolon, 1250 after a comma, and 0 after a
-right parenthesis or bracket, or closing double quote or single quote.
-Finally, it is 999 after a capital letter.
+a space then this parameter affects how much stretching or shrinking can
+happen. A space factor that is larger than the normal value means that
+the glue can stretch more and shrink less. Normally, the space factor
+is 1000. This value is in effect following most characters, and any
+non-character box or math formula. But it is 3000 after a period,
+exclamation mark, or question mark, it is 2000 after a colon, 1500 after
+a semicolon, 1250 after a comma, and 0 after a right parenthesis or
+bracket, or closing double quote or single quote. Finally, it is 999
+after a capital letter.
If the space factor F is 1000 then the glue gap will be the font's
normal space value (for Computer Modern Roman 10 point this is
@@ -7340,232 +9875,514 @@ then TeX adds the font's extra space value (for Computer Modern Roman 10
point this is 1.11111 points), and then the font's normal stretch value
is multiplied by f /1000 and the normal shrink value is multiplied by
1000/f (for Computer Modern Roman 10 point these are 1.66666 and
-1.11111 points). In short, compared to a normal space, such as the
-space following a word ending in a lowercase letter, inter-sentence
-spacing has a fixed extra space added and then the space can stretch 3
-times as much and shrink 1/3 as much.
-
- The rules for how TeX uses space factors are even more complex
-because they play two more roles. In practice, there are two
-consequences. First, if a period or other punctuation is followed by a
-close parenthesis or close double quote then its effect is still in
-place, that is, the following glue will have increased stretch and
-shrink. Second, conversely, if punctuation comes after a capital letter
-then its effect is not in place so you get an ordinary space. For how
-to adjust to this second case, for instance if an abbreviation does not
-end in a capital letter, *note \(SPACE) and \@::.
-
-19.3.1 '\(SPACE)' and '\@'
---------------------------
+1.11111 points).
+
+ For example, consider the period ending 'A man's best friend is his
+dog.' After it, TeX puts in a fixed extra space, and also allows the
+glue to stretch 3 times as much and shrink 1/3 as much, as the glue
+after 'friend', which does not end in a period.
+
+ The rules for space factors are even more complex because they play
+additional roles. In practice, there are two consequences. First, if a
+period or other punctuation is followed by a right parenthesis or
+bracket, or right single or double quote then the spacing effect of that
+period carries through those characters (that is, the following glue
+will have increased stretch and shrink). Second, if punctuation comes
+after a capital letter then its effect is not in place so you get an
+ordinary space. This second case also affects abbreviations that do not
+end in a capital letter (*note \@::).
+
+ You can only use '\spacefactor' in paragraph mode or LR mode (*note
+Modes::). You can see the current value with '\the\spacefactor' or
+'\showthe\spacefactor'.
+
+ (Comment, not really related to '\spacefactor': if you get errors
+like 'You can't use `\spacefactor' in vertical mode', or 'You can't use
+`\spacefactor' in math mode.', or 'Improper \spacefactor' then you have
+probably tried to redefine an internal command. *Note \makeatletter &
+\makeatother::.)
+
+19.5.1 '\@'
+-----------
-Here, '\(SPACE)' means a backslash followed by a space. These commands
-mark a punctuation character, typically a period, as either ending a
-sentence or as ending an abbreviation.
-
- By default, in justifying a line LaTeX adjusts the space after a
-sentence-ending period (or a question mark, exclamation point, comma, or
-colon) more than the space between words. *Note \spacefactor::. As
-described there, LaTeX assumes that the period ends a sentence unless it
-is preceded by a capital letter, in which case it takes that period for
-part of an abbreviation. Note that if a sentence-ending period is
-immediately followed by a right parenthesis or bracket, or right single
-or double quote, then the space effect of that period follows through
-that parenthesis or quote.
-
- So: if you have a period ending an abbreviation whose last letter is
-not a capital letter, and that abbreviation is not the last word in the
-sentence, then follow that period with a backslash-space ('\ ') or a tie
-('~') or a '\@'. Examples are 'Nat.\ Acad.\ Science', and 'Mr.~Bean',
-and '(manure, etc.\@) for sale' (note that in the last the '\@' comes
-before the closing parenthesis).
-
- In the opposite situation, if you have a capital letter followed by a
-period that does end the sentence, then put '\@' before the period. For
-example, 'book by the MAA\@.' will have correct inter-sentence spacing
-after the period.
-
- For another use of '\(SPACE)', *note \(SPACE) after control
-sequence::.
-
-19.3.2 '\frenchspacing'
+Synopsis:
+
+ CAPITAL-LETTER\@.
+
+ Treat a period as sentence-ending, where LaTeX would otherwise think
+it is part of an abbreviation. LaTeX thinks that a period ends an
+abbreviation if the period comes after a capital letter, and otherwise
+thinks the period ends the sentence. By default, in justifying a line
+LaTeX adjusts the space after a sentence-ending period (or a question
+mark, exclamation point, comma, or colon) more than it adjusts the space
+between words (*note \spacefactor::).
+
+ This example shows the two cases to remember.
+
+ The songs \textit{Red Guitar}, etc.\ are by Loudon Wainwright~III\@.
+
+The second period ends the sentence, despite that it is preceded by a
+capital. We tell LaTeX that it ends the sentence by putting '\@' before
+it. The first period ends the abbreviation 'etc.' but not the sentence.
+The backslash-space, '\ ', produces a mid-sentence space.
+
+ So: if you have a capital letter followed by a period that ends the
+sentence, then put '\@' before the period. This holds even if there is
+an intervening right parenthesis or bracket, or right single or double
+quote, because the spacing effect of that period carries through those
+characters. For example, this
+
+ Use the \textit{Instructional Practices Guide},
+ (a book by the MAA)\@.
+
+will have correct inter-sentence spacing after the period.
+
+ The '\@' command is only for a text mode. If you use it outside of a
+text mode then you get 'You can't use `\spacefactor' in vertical mode'
+(*note Modes::).
+
+ Comment: the converse case is a period ending an abbreviation whose
+last letter is not a capital letter, and that abbreviation is not the
+last word in the sentence. For that case follow the period with a
+backslash-space, ('\ '), or a tie, ('~'), or '\@'. Examples are 'Nat.\
+Acad.\ Science', and 'Mr.~Bean', and '(manure, etc.\@) for sale' (note
+in the last one that the '\@' comes before the closing parenthesis).
+
+19.5.2 '\frenchspacing'
-----------------------
-This declaration (from Plain TeX) causes LaTeX to treat inter-sentence
-spacing in the same way as interword spacing.
+Synopsis, one of:
- In justifying the text in a line, some typographic traditions,
-including English, prefer to adjust the space between sentences (or
-after other punctuation marks) more than the space between words.
-Following this declaration, all spaces are instead treated equally.
+ \frenchspacing
+ \nonfrenchspacing
- Revert to the default behavior by declaring '\nonfrenchspacing'.
+ The first declaration causes LaTeX to treat spacing between sentences
+in the same way as spacing between words in the middle of a sentence.
+The second causes spacing between sentences to stretch or shrink more
+(*note \spacefactor::); this is the default.
-19.3.3 '\normalsfcodes'
+ Some typographic traditions, including English, prefer to adjust the
+space between sentences (or spaces following a question mark,
+exclamation point, comma, or colon) more than the space between words
+that are in the middle of a sentence. Declaring '\frenchspacing' (the
+command is from Plain TeX) switches to the tradition that all spaces are
+treated equally.
+
+19.5.3 '\normalsfcodes'
-----------------------
-Reset the LaTeX space factor values to the default.
+Synopsis:
-19.4 '\ ' after control sequence
-================================
+ \normalsfcodes
-The '\ ' command is often used after control sequences to keep them from
-gobbling the space that follows, as in '\TeX\ is nice'. And, under
-normal circumstances, '\'<tab> and '\'<newline> are equivalent to '\ '.
-For another use of '\ ', see also *note \(SPACE) and \@::.
+ Reset the LaTeX space factor values to the default (*note
+\spacefactor::).
- Some people prefer to use '{}' for the same purpose, as in '\TeX{} is
-nice'. This has the advantage that you can always write it the same
-way, namely '\TeX{}', whether it is followed by a space or by a
-punctuation mark. Compare:
+19.6 Backslash-space, '\ '
+==========================
- \TeX\ is a nice system. \TeX, a nice system.
+This section refers to the command consisting of two characters, a
+backslash followed by a space. Synopsis:
- \TeX{} is a nice system. \TeX{}, a nice system.
+ \
- Some individual commands, notably those defined with the 'xspace',
-package do not follow the standard behavior.
+ Produce a space. By default it produces white space of length
+3.33333pt plus 1.66666pt minus 1.11111pt.
-19.5 '\thinspace': Insert 1/6em
-===============================
+ A blank is not a space. When you type a blank between words, LaTeX
+produces white space. That's different from an explicit space. This
+illustrates.
+
+ \begin{tabular}{l}
+ Three blanks: in a row \\
+ Three spaces:\ \ \ in a row \\
+ \end{tabular}
+
+On the first line LaTeX collapses the three blanks to output one
+whitespace (it would be the same with a single blank or, for instance,
+with a blank and an tab and a blank, or a blank and a newline and a
+blank). But the second line asks for three spaces so the white area is
+wider. Thus, the backslash-space command will create some horizontal
+space. (But the best way to create horizontal space is with '\hspace';
+*Note \hspace::.)
+
+ The backslash-space command has two main uses. First, it is often
+used after control sequences to keep them from gobbling the space that
+follows, as in '\TeX\ is nice'. (But the approach of using curly
+parentheses, as in '\TeX{} is nice', has the advantage of still working
+if the next character is a period.)
+
+ The second common use is that it mark a period as ending an
+abbreviation instead of ending a sentence, as in 'So says Prof.\ Smith'
+(*note \@::).
+
+ Under normal circumstances, '\'<tab> and '\'<newline> are equivalent
+to backslash-space, '\ '.
+
+19.7 '~'
+========
+
+Synopsis:
+
+ BEFORE~AFTER
+
+ The tie character, '~', produces a space between BEFORE and AFTER at
+which the line will not be broken. By default the white space has
+length 3.33333pt plus 1.66666pt minus 1.11111pt (*note Lengths::).
+
+ Here LaTeX will not break the line between the final two words.
+
+ Thanks to Prof.~Lerman.
-'\thinspace' produces an unbreakable and unstretchable space that is 1/6
-of an em. This is the proper space to use between nested quotes, as in
-'".
+In addition, despite the period, LaTeX does not use the end-of-sentence
+spacing (*note \@::).
-19.6 '\/': Insert italic correction
+ Ties prevent the end of line separation of things where that could
+cause confusion. But they also reduce LaTeX's options when it breaks
+lines into paragraphs, so you can use too many. They are also matters
+of taste, sometimes alarmingly dogmatic taste, among readers.
+Nevertheless, here are some usage models, many of them from the TeXbook.
+
+ * Between an enumerator and its item, such as in references:
+ 'Chapter~12', or 'Theorem~\ref{th:Wilsons}', or
+ 'Figure~\ref{fig:KGraph}'. When cases are enumerated inline:
+ '(b)~Show that $f(x)$ is (1)~continuous, and (2)~bounded'.
+
+ * Between a number and its unit: '$745.7.8$~watts' (the 'siunitx'
+ package has a special facility for this) or '144~eggs'. This
+ includes between a month and a date: 'October~12' or '12~Oct'. In
+ general, in any expressions where numbers and abbreviations or
+ symbols are separated by a space: 'AD~565', or '2:50~pm', or
+ 'Boeing~747', or '268~Plains Road', or '\$$1.4$~billion'.
+
+ * When mathematical phrases are rendered in words: 'equals~$n$', or
+ 'less than~$\epsilon$', or 'given~$X$', or 'modulo~$p^e$ for all
+ large~$n$' (but compare 'is~$15$' with 'is $15$~times the height').
+ Between mathematical symbols in apposition with nouns:
+ 'dimension~$d$' or 'function~$f(x)$' (but compare 'with length
+ $l$~or more'). When a symbol is a tightly bound object of a
+ preposition: 'of~$x$', or 'from $0$ to~$1$', or 'in common
+ with~$m$'.
+
+ * Between symbols in series: '$1$,~$2$, or~$3$' or '$1$,~$2$,
+ \ldots,~$n$'.
+
+ * Between a person's forenames and between multiple surnames:
+ 'Donald~E. Knuth', or 'Luis~I. Trabb~Pardo', or 'Charles~XII' (but
+ you must give TeX places to break the line so you may do 'Charles
+ Louis Xavier~Joseph de~la Vall\'ee~Poussin').
+
+ * Before a dash: 'pages 12~--14' or 'it is~--- it must be said~---
+ plausible'.
+
+19.8 '\thinspace' & '\negthinspace'
===================================
-The '\/' command produces an "italic correction". This is a small space
-defined by the font designer for a given character, to avoid the
-character colliding with whatever follows. The italic f character
-typically has a large italic correction value.
+Synopsis, one of:
- If the following character is a period or comma, it's not necessary
-to insert an italic correction, since those punctuation symbols have a
-very small height. However, with semicolons or colons, as well as
-normal letters, it can help. Compare f: f; (in the TeX output, the 'f's
-are nicely separated) with f: f;.
+ \thinspace
+ \negthinspace
+
+ Produce an unbreakable and unstretchable space of 1/6em and -1/6em.
+These are the text mode equivalents of '\,' and '\!' (*note Spacing in
+math mode/\thinspace::). You can use '\,' as a synonym for '\thinspace'
+in text mode.
+
+ The '\negthinspace' command is used in text mode mostly for fiddling
+with spaces. One common use of '\thinspace' is as the space between
+nested quotes.
+
+ Killick replied, ``I heard the Captain say, `Ahoy there.'\thinspace''
+
+Another use is that some style guides call for a '\thinspace' between an
+ellipsis and a sentence ending period (other style guides, though, think
+the three dots are quite enough already). Still another use is between
+initials, as in 'D.\thinspace E.\ Knuth'.
+
+19.9 '\/'
+=========
+
+Synopsis:
- When changing fonts with commands such as '\textit{italic text}' or
-'{\itshape italic text}', LaTeX will automatically insert an italic
-correction if appropriate (*note Font styles::).
+ BEFORE-CHARACTER\/AFTER-CHARACTER
- Despite the name, roman characters can also have an italic
-correction. Compare pdfTeX (in the TeX output, there is a small space
-after the 'f') with pdfTeX.
+ Insert an "italic correction", a small space defined by the font
+designer for each character, to avoid the character colliding with
+whatever follows. When you use '\/', LaTeX takes the correction from
+the font metric file, scales it by any scaling that has been applied to
+the font, and then inserts that much horizontal space.
+
+ Here, were it not for the '\/', the BEFORE-CHARACTER italic f would
+hit the AFTER-CHARACTER roman H
+
+ \newcommand{\companylogo}{{\it f}\/H}
+
+because the italic letter leans far to the right.
+
+ If AFTER-CHARACTER is a period or comma then don't insert an italic
+correction since those punctuation symbols have a very small height.
+However, with semicolons or colons as well as with normal letters, the
+italic correction can help.
+
+ When you use commands such as '\textit' or '\itshape' to change
+fonts, LaTeX will automatically insert any needed italic correction
+(*note Font styles::).
+
+ Roman characters can also have an italic correction. An example is
+in the name 'pdf\/\TeX'.
There is no concept of italic correction in math mode; spacing is
done in a different way.
-19.7 '\hrulefill \dotfill'
-==========================
+19.10 '\hrulefill' & '\dotfill'
+===============================
-Produce an infinite rubber length (*note Lengths::) filled with a
-horizontal rule (that is, a line) or with dots, instead of just white
+Synopsis, one of:
+
+ \hrulefill
+ \dotfill
+
+ Produce an infinite horizontal rubber length (*note Lengths::) that
+LaTeX fills with a rule (that is, a line) or with dots, instead of white
space.
- When placed between blank lines this example creates a paragraph that
-is left and right justified, where the space in the middle is filled
-with evenly spaced dots.
+ This outputs a line 2 inches long.
+
+ Name:~\makebox[2in]{\hrulefill}
- \noindent Jack Aubrey\dotfill Melbury Lodge
+This example, when placed between blank lines, creates a paragraph that
+is left and right justified and where the middle is filled with evenly
+spaced dots.
+
+ \noindent John Aubrey, RN \dotfill{} Melbury Lodge
To make the rule or dots go to the line's end use '\null' at the
start or end.
To change the rule's thickness, copy the definition and adjust it, as
-with '\renewcommand{\hrulefill}{\leavevmode\leaders\hrule height
-1pt\hfill\kern\z@}', which changes the default thickness of 0.4pt to
-1pt. Similarly, adjust the dot spacing as with
-'\renewcommand{\dotfill}{\leavevmode\cleaders\hb@xt@ 1.00em{\hss .\hss
-}\hfill\kern\z@}', which changes the default length of 0.33em to 1.00em.
+here
-19.8 '\addvspace'
-=================
+ \renewcommand{\hrulefill}{%
+ \leavevmode\leaders\hrule height 1pt\hfill\kern\z@}
-'\addvspace{LENGTH}'
+which changes the default thickness of 0.4pt to 1pt. Similarly, adjust
+the dot spacing as with
- Add a vertical space of height LENGTH, which is a rubber length
-(*note Lengths::). However, if vertical space has already been added to
-the same point in the output by a previous '\addvspace' command then
-this command will not add more space than what is needed to make the
-natural length of the total vertical space equal to LENGTH.
+ \renewcommand{\dotfill}{%
+ \leavevmode\cleaders\hb@xt@1.00em{\hss .\hss }\hfill\kern\z@}
- Use this command to adjust the vertical space above or below an
-environment that starts a new paragraph. For instance, a Theorem
-environment is defined to begin and end with '\addvspace{...}' so that
-two consecutive Theorem's are separated by one vertical space, not two.
+which changes the default length of 0.33em to 1.00em.
- This command is fragile (*note \protect::).
+ This example produces a line for a signature.
- The error 'Something's wrong--perhaps a missing \item' means that you
-were not in vertical mode when you invoked this command; one way to
-change that is to precede this command with a '\par' command.
+ \begin{minipage}{4cm}
+ \centering
+ \hrulefill\\
+ Signed
+ \end{minipage}
-19.9 '\bigskip \medskip \smallskip'
-===================================
+The line is 4cm long.
+
+19.11 '\bigskip' & '\medskip' & '\smallskip'
+============================================
+
+Synopsis, one of:
+
+ \bigskip
+ \medskip
+ \smallskip
+
+ Produce an amount of vertical space, large or medium-sized or small.
+These commands are fragile (*note \protect::).
+
+ Here the skip suggests the passage of time (from The Golden Ocean by
+O'Brian).
-These commands produce a given amount of space, specified by the
-document class.
+ Mr Saumarez would have something rude to say to him, no doubt: he
+ was at home again, and it was delightful.
+
+ \bigskip
+ ``A hundred and fifty-seven miles and one third, in twenty-four hours,''
+ said Peter.
+
+ Each command is associated with a length defined in the document
+class file.
'\bigskip'
The same as '\vspace{\bigskipamount}', ordinarily about one line
- space, with stretch and shrink (the default for the 'book' and
- 'article' classes is '12pt plus 4pt minus 4pt').
+ space, with stretch and shrink. The default for the 'book' and
+ 'article' classes is '12pt plus 4pt minus 4pt'.
'\medskip'
The same as '\vspace{\medskipamount}', ordinarily about half of a
- line space, with stretch and shrink (the default for the 'book' and
- 'article' classes is '6pt plus 2pt minus 2pt').
+ line space, with stretch and shrink. The default for the 'book'
+ and 'article' classes is '6pt plus 2pt minus 2pt'.
'\smallskip'
The same as '\vspace{\smallskipamount}', ordinarily about a quarter
- of a line space, with stretch and shrink (the default for the
- 'book' and 'article' classes is '3pt plus 1pt minus 1pt').
+ of a line space, with stretch and shrink. The default for the
+ 'book' and 'article' classes is '3pt plus 1pt minus 1pt'.
+
+ Because each command is a '\vspace', if you use on in mid-paragraph
+then it will insert its vertical space between the line in which you use
+it and the next line, not necessarily at the place that you use it. So
+these are best between paragraphs.
+
+ The commands '\bigbreak', '\medbreak', and '\smallbreak' are similar
+but also suggest to LaTeX that this is a good place to put a page break
+(*note \bigbreak & \medbreak & \smallbreak::.
+
+19.12 '\bigbreak' & '\medbreak' & '\smallbreak'
+===============================================
+
+Synopsis, one of:
-19.10 '\vfill'
+ \bigbreak
+ \medbreak
+ \smallbreak
+
+ Produce a vertical space that is big or medium-sized or small, and
+suggest to LaTeX that this is a good place to break the page. (The
+associated penalties are -200, -100, and -50.)
+
+ *Note \bigskip & \medskip & \smallskip::, for more. These commands
+produce the same vertical space but differ in that they also remove a
+preceding vertical space if it is less than what they would insert (as
+with '\addvspace'). In addition, they terminate a paragraph where they
+are used: this example
+
+ abc\bigbreak def ghi
+
+ jkl mno pqr
+
+will output three paragraphs, the first ending in 'abc' and the second
+starting, after an extra vertical space and a paragraph indent, with
+'def'.
+
+19.13 '\strut'
==============
-End the current paragraph and insert a vertical rubber length (*note
-Lengths::) that is infinite, so it can stretch or shrink as far as
-needed.
+Synopsis:
- It is often used in the same way as '\vspace{\fill}', except that
-'\vfill' ends the current paragraph, whereas '\vspace{\fill}' adds the
-infinite vertical space below its line irrespective of the paragraph
-structure. In both cases that space will disappear at a page boundary;
-to circumvent this see *note \vspace::.
+ \strut
- In this example the page is filled, so the top and bottom lines
-contain the text 'Lost Dog!' and the third 'Lost Dog!' is exactly
-halfway between them.
+ Ensure that the current line has height at least '0.7\baselineskip'
+and depth at least '0.3\baselineskip'. Essentially, LaTeX inserts into
+the line a rectangle having zero width,
+'\rule[-0.3\baselineskip]{0pt}{\baselineskip}' (*note \rule::). The
+'\baselineskip' changes with the current font and fontsize.
- \begin{document}
- Lost Dog!
- \vfill
- Lost Dog!
- \vfill
- Lost Dog!
- \end{document}
+ In this example the '\strut' keeps the box inside the frame from
+having zero height.
-19.11 '\vspace{LENGTH}'
-=======================
+ \setlength{\fboxsep}{0pt}\framebox[2in]{\strut}
-Synopsis, one of these two:
+ This example has four lists. In the first there is a much bigger gap
+between items 2 and 3 than there is between items 1 and 2. The second
+list fixes that with a '\strut' at the end of its first item's second
+line.
+
+ \setlength{\fboxsep}{0pt}
+ \noindent\begin{minipage}[t]{0.2\linewidth}
+ \begin{enumerate}
+ \item \parbox[t]{15pt}{test \\ test}
+ \item test
+ \item test
+ \end{enumerate}
+ \end{minipage}%
+ \begin{minipage}[t]{0.2\linewidth}
+ \begin{enumerate}
+ \item \parbox[t]{15pt}{test \\ test\strut}
+ \item test
+ \item test
+ \end{enumerate}
+ \end{minipage}%
+ \begin{minipage}[t]{0.2\linewidth}
+ \begin{enumerate}
+ \item \fbox{\parbox[t]{15pt}{test \\ test}}
+ \item \fbox{test}
+ \item \fbox{test}
+ \end{enumerate}
+ \end{minipage}%
+ \begin{minipage}[t]{0.2\linewidth}
+ \begin{enumerate}
+ \item \fbox{\parbox[t]{15pt}{test \\ test\strut}}
+ \item \fbox{test}
+ \item \fbox{test}
+ \end{enumerate}
+ \end{minipage}%
+
+The final two lists use 'fbox' to show what's happening. The third
+list's '\parbox' goes only to the bottom of its second 'test', which
+happens not have any characters that descend below the baseline. The
+fourth list adds the strut that gives the needed extra below-baseline
+space.
+
+ The '\strut' command is often useful in graphics, such as in 'TikZ'
+or 'Asymptote'. For instance, you may have a command such as
+'\graphnode{NODE-NAME}' that fits a circle around NODE-NAME. However,
+unless you are careful the NODE-NAME's 'x' and 'y' will produce
+different-diameter circles because the characters are different sizes.
+A careful '\graphnode' might insert a '\strut', then NODE-NAME, and then
+draw the circle.
+
+ The general approach of using a zero width '\rule' is useful in many
+circumstances. In this table, the zero-width rule keeps the top of the
+first integral from hitting the '\hline'. Similarly, the second rule
+keeps the second integral from hitting the first.
+
+ \begin{tabular}{rl}
+ \textsc{Integral} &\textsc{Value} \\
+ \hline
+ $\int_0^x t\, dt$ &$x^2/2$ \rule{0em}{2.5ex} \\
+ $\int_0^x t^2\, dt$ &$x^3/3$ \rule{0em}{2.5ex}
+ \end{tabular}
+
+(Although the line-ending double backslash command has an available
+optional argument to put in more vertical room, that won't work here.
+Changing the first double backslash to something like '\\[2.5ex]' will
+put the room between the header line and the '\hline', and the integral
+would still hit the line.)
+
+19.14 '\vspace'
+===============
+
+Synopsis, one of:
\vspace{LENGTH}
\vspace*{LENGTH}
- Add the vertical space LENGTH. This can be negative or positive, and
-is a rubber length (*note Lengths::).
+ Add the vertical space LENGTH. The LENGTH can be positive, negative,
+or zero. It is a rubber length--it may contain a 'plus' or 'minus'
+component (*note Lengths::).
- LaTeX removes the vertical space from '\vspace' at a page break, that
-is, at the top or bottom of a page. The starred version '\vspace*{...}'
-causes the space to stay.
+ This puts space between the two paragraphs.
- If '\vspace' is used in the middle of a paragraph (i.e., in
-horizontal mode), the space is inserted _after_ the line with the
-'\vspace' command. A new paragraph is not started.
+ And I slept.
+
+ \vspace{1ex plus 0.5ex}
+ The new day dawned cold.
+
+(*Note \bigskip & \medskip & \smallskip:: for common inter-paragraph
+spaces.)
+
+ The '*'-version inserts vertical space that non-discardable. More
+precisely, LaTeX discards vertical space at a page break and the
+'*'-version causes the space to stay. This example leaves space between
+the two questions.
+
+ Question: Find the integral of \( 5x^4+5 \).
+
+ \vspace*{2cm plus 0.5cm}
+ Question: Find the derivative of \( x^5+5x+9 \).
+
+That space will be present even if the page break happens to fall
+between the questions.
+
+ If you use '\vspace' in the middle of a paragraph (i.e., in
+horizontal mode) then the space is inserted after the line containing
+the '\vspace' command; it does not start a new paragraph at the
+'\vspace' command.
In this example the two questions will be evenly spaced vertically on
the page, with at least one inch of space below each.
@@ -7578,172 +10395,461 @@ the page, with at least one inch of space below each.
\vspace{1in plus 1fill}
\end{document}
-20 Boxes
-********
+19.15 '\vfill'
+==============
-All the predefined length parameters (*note Predefined lengths::) can be
-used in the arguments of the box-making commands.
+Synopsis:
-20.1 '\mbox{TEXT}'
-==================
+ \vfill
-The '\mbox' command creates a box just wide enough to hold the text
-created by its argument. The TEXT is not broken into lines, so it can
-be used to prevent hyphenation.
+ End the current paragraph and insert a vertical rubber length that is
+infinite, so it can stretch or shrink as far as needed (*note
+Lengths::).
-20.2 '\fbox' and '\framebox'
-============================
+ It is often used in the same way as '\vspace{\fill}', except that
+'\vfill' ends the current paragraph whereas '\vspace{\fill}' adds the
+infinite vertical space below its line, irrespective of the paragraph
+structure. In both cases that space will disappear at a page boundary;
+to circumvent this see the starred option in *note \vspace::.
-Synopses:
+ In this example the page is filled, so the top and bottom lines
+contain the text 'Lost Dog!' and the second 'Lost Dog!' is exactly
+halfway between them.
- \fbox{TEXT}
- \framebox[WIDTH][POSITION]{TEXT}
+ \begin{document}
+ Lost Dog!
+ \vfill
+ Lost Dog! % perfectly in the middle
+ \vfill
+ Lost Dog!
+ \end{document}
- The '\fbox' and '\framebox' commands are like '\mbox', except that
-they put a frame around the outside of the box being created.
+19.16 '\addvspace'
+==================
- In addition, the '\framebox' command allows for explicit
-specification of the box width with the optional WIDTH argument (a
-dimension), and positioning with the optional POSITION argument.
+Synopsis:
- Both commands produce a rule of thickness '\fboxrule' (default
-'0.4pt'), and leave a space of '\fboxsep' (default '3pt') between the
-rule and the contents of the box.
+ \addvspace{VERT-LENGTH}
- *Note \framebox (picture)::, for the '\framebox' command in the
-'picture' environment.
+ Add a vertical space of VERT-LENGTH. However, if there are two or
+more '\addvspace''s in a sequence then together they only add the space
+needed to make the natural length equal to the maximum of the
+VERT-LENGTH's in that sequence. This command is fragile (*note
+\protect::). The VERT-LENGTH is a rubber length (*note Lengths::).
-20.3 'lrbox'
-============
+ This example illustrates. The 'picture' draws a scale. In a
+standard LaTeX article the length '\baselineskip' is 12pt. The two
+rules here are 22pt apart: the sum of the '\baselineskip' and the 10pt
+from the first 'addvspace'.
-Synopsis:
+ \documentclass{article}
+ \usepackage{color}
+ \begin{document}
+ \setlength{\unitlength}{2pt}%
+ \noindent\begin{picture}(0,0)%
+ \multiput(0,0)(0,-1){25}{{\color{blue}\line(1,0){1}}}
+ \multiput(0,0)(0,-5){6}{{\color{red}\line(1,0){2}}}
+ \end{picture}%
+ \rule{0.25\linewidth}{0.1pt}%
+ \par\addvspace{10pt}% \addvspace{20pt}%
+ \par\noindent\rule{0.25\linewidth}{0.1pt}%
+ \end{document}
- \begin{lrbox}{\CMD}
- TEXT
- \end{lrbox}
+Now uncomment the second '\addvspace'. It does not make the gap 20pt
+longer; instead the gap is the sum of '\baselineskip' and 20pt. So
+'\addvspace' in a sense does the opposite of its name -- it makes sure
+that multiple vertical spaces do not accumulate, but instead that only
+the largest one is used.
- This is the environment form of *note '\sbox': \sbox.
+ LaTeX uses this command to adjust the vertical space above or below
+an environment that starts a new paragraph. For instance, a 'theorem'
+environment begins and ends with '\addvspace' so that two consecutive
+'theorem''s are separated by one vertical space, not two.
- The TEXT inside the environment is saved in the box '\CMD', which
-must have been declared with '\newsavebox'.
+ A error 'Something's wrong--perhaps a missing \item' pointing to an
+'\addvspace' means that you were not in vertical mode when you hit this
+command. One way to change that is to precede '\addvspace' with a
+'\par' command (*note \par::), as in the above example.
-20.4 '\makebox'
-===============
+20 Boxes
+********
-Synopsis:
+At its core, LaTeX puts things in boxes and then puts the boxes on a
+page. So these commands are central.
+
+ There are many packages on CTAN that are useful for manipulating
+boxes. One useful adjunct to the commands here is 'adjustbox'.
+
+20.1 '\mbox' & '\makebox'
+=========================
+
+Synopsis, one of:
+ \mbox{TEXT}
+ \makebox{TEXT}
+ \makebox[WIDTH]{TEXT}
\makebox[WIDTH][POSITION]{TEXT}
- The '\makebox' command creates a box just wide enough to contain the
-TEXT specified. The width of the box can be overridden by the optional
-WIDTH argument. The position of the text within the box is determined
-by the optional POSITION argument, which may take the following values:
+ Create a box, a container for material. The TEXT is is typeset in LR
+mode (*note Modes::) so it is not broken into lines. The '\mbox'
+command is robust, while '\makebox' is fragile (*note \protect::).
+
+ Because 'text' is not broken into lines, you can use '\mbox' to
+prevent hyphenation. In this example, LaTeX will not hyphenate the
+table name, 'T-4'.
+
+ See Table~\mbox{T-4}
+
+ The first two command versions, '\mbox' and '\makebox', are roughly
+equivalent. They create a box just wide enough to contain the TEXT.
+(They are like plain TeX's '\hbox'.)
+
+ In the third version the optional argument WIDTH specifies the width
+of the box. Note that the space occupied by the text need not equal the
+width of the box. For one thing, TEXT can be too small; this creates a
+full-line box
+
+ \makebox[\linewidth]{Chapter Exam}
+
+with 'Chapter Exam' centered. But TEXT can also be too wide for WIDTH.
+See the example below of zero-width boxes.
+
+ In the WIDTH argument you can use the following lengths that refer to
+the dimension of the box that LaTeX gets on typesetting TEXT: '\depth',
+'\height', '\width', '\totalheight' (this is the box's height plus its
+depth). For example, to make a box with the text stretched to double
+the natural size you can say this.
+
+ \makebox[2\width]{Get a stretcher}
+
+ For the fourth command version the optional argument POSITION gives
+position of the text within the box. It may take the following values:
'c'
- Centered (default).
+ The TEXT is centered (default).
+
'l'
- Flush left.
+ The TEXT is flush left.
+
'r'
Flush right.
+
's'
- Stretch (justify) across entire WIDTH; TEXT must contain
- stretchable space for this to work.
+ Stretch the interword space in TEXT across the entire WIDTH. The
+ TEXT must contain stretchable space for this to work. For
+ instance, this could head a press release:
+ '\noindent\makebox[\textwidth][s]{\large\hfil IMMEDIATE\hfil
+ RELEASE\hfil}'
- '\makebox' is also used within the 'picture' environment *note
-\makebox (picture)::.
+ A common use of '\makebox' is to make zero-width text boxes. This
+puts the value of the quiz questions to the left of those questions.
-20.5 '\parbox'
-==============
+ \newcommand{\pts}[1]{\makebox[0em][r]{#1 points\hspace*{1em}}}
+ \pts{10}What is the air-speed velocity of an unladen swallow?
-Synopsis:
+ \pts{90}An African or European swallow?
- \parbox[POSITION][HEIGHT][INNER-POS]{WIDTH}{TEXT}
- The '\parbox' command produces a box whose contents are created in
-"paragraph mode". It should be used to make a box small pieces of text,
-with nothing fancy inside. In particular, you shouldn't use any
-paragraph-making environments inside a '\parbox' argument. For larger
-pieces of text, including ones containing a paragraph-making
-environment, you should use a 'minipage' environment (*note minipage::).
+ The right edge of the output '10 points ' (note the ending space)
+will be just before the 'What' (note the space after 'points'). You can
+use '\makebox' similarly when making graphics, such as in 'TikZ' or
+'Asymptote', where you put the edge of the text at a known location,
+regardless of the length of that text.
- '\parbox' has two mandatory arguments:
+ For boxes with frames see *note \fbox & \framebox::. For colors
+see *note Colored boxes::.
-WIDTH
- the width of the parbox;
-TEXT
- the text that goes inside the parbox.
+ There is a related version of '\makebox' that is used within the
+'picture' environment, where the length is given in terms of
+'\unitlength' (*note \makebox (picture)::).
- By default LaTeX will position vertically a parbox so its center
-lines up with the center of the surrounding text line. When the
-optional POSITION argument is present and equal either to 't' or 'b',
-this allows you respectively to align either the top or bottom line in
-the parbox with the baseline of the surrounding text. You may also
-specify 'm' for POSITION to get the default behaviour.
+ If you put a double-backslash into TEXT then LaTeX will not give you
+a new line; for instance '\makebox{abc def \\ ghi}' outputs 'abc defghi'
+while '\makebox{abc def \par ghi}' outputs 'abc def ghi', but neither go
+to a second line. To get multiple lines see *note \parbox:: and *note
+minipage::.
- The optional HEIGHT argument overrides the natural height of the box.
+20.2 '\fbox' & '\framebox'
+==========================
- The INNER-POS argument controls the placement of the text inside the
-box, as follows; if it is not specified, POSITION is used.
+Synopses, one of:
-'t'
- text is placed at the top of the box.
-'c'
- text is centered in the box.
-'b'
- text is placed at the bottom of the box.
-'s'
- stretch vertically; the text must contain vertically stretchable
- space for this to work.
+ \fbox{TEXT}
+ \framebox{TEXT}
+ \framebox[WIDTH]{TEXT}
+ \framebox[WIDTH][POSITION]{TEXT}
+
+ Create a box with an enclosing frame, four lines surrounding the
+space. These commands are the same as '\mbox' and '\makebox' except for
+the frame (*note \mbox & \makebox::). The '\fbox' command is robust,
+the '\framebox' command is fragile (*note \protect::).
+
+ \fbox{Warning! No work shown, no credit given.}
+
+LaTeX puts the text into a box that cannot be split or hyphenated.
+Around that box, separated from it by a small gap, are four lines making
+a frame.
+
+ The first two command invocations, '\fbox{...}' and '\framebox{...}',
+are roughly the same. As to the third and fourth invocations, the
+optional arguments allow you to specify the box width as WIDTH and the
+position of the text inside that box as POSITION. *Note \mbox &
+\makebox:: for the full description but here is an example creating an
+empty box that is 1/4in wide.
+
+ \setlength{\fboxsep}{0pt}\framebox[0.25in]{\strut}}
+
+The '\strut' inserts a vertical height of '\baselineskip' (*note
+\strut::).
+
+ These parameters determine the frame layout.
+
+'\fboxrule'
+ The thickness of the lines around the enclosed box. The default is
+ 0.2pt. Change it with a command such as
+ '\setlength{\fboxrule}{0.8pt}' (*note \setlength::).
+
+'\fboxsep'
+ The distance from the frame to the enclosed box. The default is
+ 3pt. Change it with a command such as '\setlength{\fboxsep}{0pt}'
+ (*note \setlength::). Setting it to 0pt is useful sometimes: this
+ will put a frame around the picture with no white border.
+
+ {\setlength{\fboxsep}{0pt}
+ \framebox{%
+ \includegraphics[width=0.5\textwidth]{prudence.jpg}}}
+
+ The extra curly braces keep the effect of the '\setlength' local.
+
+ As with '\mbox' and '\makebox', LaTeX will not break lines in TEXT.
+But this example has LaTeX break lines to make a paragraph, and then
+frame the result.
+
+ \framebox{%
+ \begin{minipage}{0.6\linewidth}
+ My dear, here we must run as fast as we can, just to stay in place.
+ And if you wish to go anywhere you must run twice as fast as that.
+ \end{minipage}}
+
+ *Note Colored boxes:: for colors other than black and white.
-20.6 '\raisebox'
+ The 'picture' environment has a version of this command where the
+units depend on 'picture''s '\unitlength' (*note \framebox (picture)::).
+
+20.3 '\parbox'
+==============
+
+Synopses, one of:
+
+ \parbox{WIDTH}{CONTENTS}
+ \parbox[POSITION]{WIDTH}{CONTENTS}
+ \parbox[POSITION][HEIGHT]{WIDTH}{CONTENTS}
+ \parbox[POSITION][HEIGHT][INNER-POS]{WIDTH}{CONTENTS}
+
+ Produce a box of text that is WIDTH wide. Use this command to make a
+box of small pieces of text, of a single paragraph. This command is
+fragile (*note \protect::).
+
+ \begin{picture}(0,0)
+ ...
+ \put(1,2){\parbox{1.75in}{\raggedright Because the graph is a line on
+ this semilog paper, the relationship is
+ exponential.}}
+ \end{picture}
+
+ The CONTENTS are processed in a text mode (*note Modes::) so LaTeX
+will break lines to make a paragraph. But it won't make multiple
+paragraphs; for that, use a 'minipage' environment (*note minipage::).
+
+ The options for '\parbox' (except for CONTENTS) are the same as those
+for 'minipage'. For convenience a summary of the options is here but
+see *note minipage:: for a complete description.
+
+ There are two required arguments. The WIDTH is a rigid length (*note
+Lengths::). It sets the width of the box into which LaTeX typesets
+CONTENTS. The CONTENTS is the text that is placed in that box. It
+should not have any paragraph-making components.
+
+ There are three optional arguments, POSITION, HEIGHT, and INNER-POS.
+The POSITION gives the vertical alignment of the 'parbox' with respect
+to the surrounding material. The possible values are 'c' or 'm' to make
+the vertical center of the 'parbox' lines up with the center of the
+adjacent line (this is the default), or 't' to match the top line of the
+'parbox' with the baseline of the surrounding material, or 'b' to match
+the bottom line.
+
+ The optional argument HEIGHT overrides the natural height of the box.
+
+ The optional argument INNER-POS controls the placement of CONTENT
+inside the 'parbox'. Its default is the value of POSITION. Its
+possible values are: 't' to put the CONTENT at the top of the box, 'c'
+to put it in the vertical center, 'b' to put it at the bottom of the
+box, and 's' to stretch it out vertically (for this, the text must
+contain vertically stretchable space).
+
+20.4 '\raisebox'
================
-Synopsis:
+Synopsis, one of:
+ \raisebox{DISTANCE}{TEXT}
+ \raisebox{DISTANCE}[HEIGHT]{TEXT}
\raisebox{DISTANCE}[HEIGHT][DEPTH]{TEXT}
- The '\raisebox' command raises or lowers TEXT. The first mandatory
-argument specifies how high TEXT is to be raised (or lowered if it is a
-negative amount). TEXT itself is processed in LR mode.
+ Raise or lower TEXT. This command is fragile (*note \protect::).
+
+ This example makes a command for the restriction of a function by
+lowering the vertical bar symbol.
+
+ \newcommand\restricted[1]{\raisebox{-.5ex}{$|$}_{#1}}
+ $f\restricted{A}$
+
+ The first mandatory argument DISTANCE specifies how far to raise the
+second mandatory argument TEXT. This is a rigid length (*note
+Lengths::). If it is negative then it lowers TEXT. The TEXT is
+processed in LR mode so it cannot contain line breaks (*note Modes::).
The optional arguments HEIGHT and DEPTH are dimensions. If they are
-specified, LaTeX treats TEXT as extending a certain distance above the
-baseline (HEIGHT) or below (DEPTH), ignoring its natural height and
-depth.
+specified, they override the natural height and depth of the box LaTeX
+gets by typesetting TEXT.
-20.7 '\savebox'
-===============
+ In the arguments DISTANCE, HEIGHT, and DEPTH you can use the
+following lengths that refer to the dimension of the box that LaTeX gets
+on typesetting TEXT: '\depth', '\height', '\width', '\totalheight' (this
+is the box's height plus its depth).
-Synopsis:
+ This will align two graphics on their top (*note Graphics::).
- \savebox{\BOXCMD}[WIDTH][POS]{TEXT}
+ \usepackage{graphicx} \usepackage{calc} % in preamble
+ ...
+ \begin{center}
+ \raisebox{1ex-\height}{%
+ \includegraphics[width=0.4\linewidth]{lion.png}}
+ \qquad
+ \raisebox{1ex-\height}{%
+ \includegraphics[width=0.4\linewidth]{meta.png}}
+ \end{center}
- This command typeset TEXT in a box just as with '\makebox' (*note
-\makebox::), except that instead of printing the resulting box, it saves
-it in the box labeled \BOXCMD, which must have been declared with
-'\newsavebox' (*note \newsavebox::).
+The first '\height' is the height of 'lion.png' while the second is the
+height of 'meta.png'.
-20.8 '\sbox{\BOXCMD}{TEXT}'
-===========================
+20.5 '\sbox' & '\savebox'
+=========================
+
+Synopsis, one of:
+
+ \sbox{BOX-CMD}{TEXT}
+ \savebox{BOX-CMD}{TEXT}
+ \savebox{BOX-CMD}[WIDTH]{TEXT}
+ \savebox{BOX-CMD}[WIDTH][POS]{TEXT}
+
+ Typeset TEXT just as with '\makebox' (*note \mbox & \makebox::)
+except that LaTeX does not output it but instead saves it in a storage
+bin named BOX-CMD. The bin name BOX-CMD begins with a backslash, '\'.
+You must have previously allocated the bin BOX-CMD with '\newsavebox'
+(*note \newsavebox::).The '\sbox' command is robust while '\savebox' is
+fragile (*note \protect::).
+
+ This creates and uses a bin.
+
+ \newsavebox{\fullname}
+ \sbox{\fullname}{John Jacob Jingleheimer Schmidt}
+ ...
+ \usebox{\fullname}! His name is my name, too!
+ Whenever we go out, the people always shout!
+ There goes \\usebox{\fullname}! Ya da da da da da da.
+
+One advantage of using and reusing a bin over a '\newcommand' is
+efficiency, that LaTeX need not repeatedly retypeset the contents. See
+the example below.
+
+ The first two command invocations, '\sbox{BOX-CMD}{TEXT}' and
+'\savebox{BOX-CMD}{TEXT}', are roughly equivalent. As to the third and
+fourth, the optional arguments allow you to specify the box width as
+WIDTH, and the position of the text inside that box as POSITION. *Note
+\mbox & \makebox:: for the full description.
+
+ In the '\sbox' and '\savebox' commands the TEXT is typeset in LR mode
+so it does not have line breaks (*note Modes::). If you use these then
+LaTeX doesn't give you an error but it ignores what you want: if you
+enter '\sbox{\newbin}{test \\ test}' and '\usebox{\newbin}' then you get
+'testtest', while if you enter '\sbox{\newbin}{test \par test}' and
+'\usebox{\newbin}' then you get 'test test', but no error or warning.
+To fix this use a '\parbox' or 'minipage' as here.
+
+ \savebox{\abin}{%
+ \begin{minipage}{\linewidth}
+ \begin{enumerate}
+ \item First item
+ \item Second item
+ \end{enumerate}
+ \end{minipage}}
+ ...
+ \usebox{\abin}
+
+ As an example of the efficiency of reusing a bin's contents, this
+puts the same picture on each page of the document by putting it in the
+header. LaTeX only typesets it once.
+
+ \usepackage{graphicx} % all this in the preamble
+ \newsavebox{\sealbin}
+ \savebox{\sealbin}{%
+ \setlength{\unitlength}{1in}%
+ \begin{picture}(0,0)%
+ \put(1.5,-2.5){%
+ \begin{tabular}{c}
+ \includegraphics[height=2in]{companylogo.png} \\
+ Office of the President
+ \end{tabular}}
+ \end{picture}%
+ }
+ \markright{\usebox{\sealbin}}
+ \pagestyle{headings}
+
+The 'picture' environment is good for fine-tuning the placement.
+
+ If the bin has not already been defined then you get something like
+'Undefined control sequence. <argument> \nobin'.
+
+20.6 'lrbox'
+============
Synopsis:
- \sbox{\BOXCMD}{TEXT}
+ \begin{lrbox}{BOX-CMD}
+ TEXT
+ \end{lrbox}
+
+ The TEXT inside the environment is saved in the bin 'BOX-CMD'. The
+BOX-CMD must begin with a backslash. You must create this bin in
+advance with '\newsavebox' (*note \newsavebox::). This is the
+environment form of the '\sbox' and '\savebox' commands, and is
+equivalent to them. *Note \sbox & \savebox:: for the full information.
- '\sbox' types TEXT in a box just as with '\mbox' (*note \mbox::)
-except that instead of the resulting box being included in the normal
-output, it is saved in the box labeled \BOXCMD. \BOXCMD must have been
-previously declared with '\newsavebox' (*note \newsavebox::).
+ In this example the environment is convenient for entering the
+'tabular'.
-20.9 '\usebox{\BOXCMD}'
-=======================
+ \newsavebox{\jhbin}
+ \begin{lrbox}{\jhbin}
+ \begin{tabular}{c}
+ \includegraphics[height=1in]{jh.png} \\
+ Jim Hef{}feron
+ \end{tabular}
+ \end{lrbox}
+ ...
+ \usebox{\jhbin}
+
+20.7 '\usebox'
+==============
Synopsis:
- \usebox{\BOXCMD}
+ \usebox{BOX-CMD}
- '\usebox' produces the box most recently saved in the bin \BOXCMD by
-a '\savebox' command (*note \savebox::).
+ Produce the box most recently saved in the bin BOX-CMD by the
+commands '\sbox' or '\savebox', or the 'lrbox' environment. *Note \sbox
+& \savebox:: for more information and examples. (Note that BOX-CMD
+starts with a backslash.) This command is robust (*note \protect::).
21 Color
********
@@ -7760,8 +10866,8 @@ Particularly worth mentioning is 'xcolor', which is widely used and
significantly extends the capabilities described here, including adding
'HTML' and 'Hsb' color models.
-21.1 Color package options
-==========================
+21.1 'color' package options
+============================
Synopsis (must be in the document preamble):
@@ -7857,9 +10963,11 @@ Synopsis:
\definecolor{NAME}{MODEL}{SPECIFICATION}
- Give the name NAME to the color. For example, after
-'\definecolor{silver}{rgb}{0.75,0.75,0.74}' you can use that color name
-with 'Hi ho, \textcolor{silver}{Silver}!'.
+ Give the name NAME to the color. For example, after this
+
+ \definecolor{silver}{rgb}{0.75,0.75,0.74}
+
+you can use that color name with 'Hi ho, \textcolor{silver}{Silver}!'.
This example gives the color a more abstract name, so it could change
and not be misleading.
@@ -7878,17 +10986,18 @@ Synopses:
\textcolor{NAME}{...}
\textcolor[COLOR MODEL]{COLOR SPECIFICATION}{...}
- or
+or
\color{NAME}
\color[COLOR MODEL]{SPECIFICATION}
The affected text gets the color. This line
- \textcolor{magenta}{My name is Ozymandias, king of kings:} Look on my works, ye Mighty, and despair!
+ \textcolor{magenta}{My name is Ozymandias, king of kings:}
+ Look on my works, ye Mighty, and despair!
- causes the first half to be in magenta while the rest is in black.
-You can use a color declared with '\definecolor' in exactly the same way
+causes the first half to be in magenta while the rest is in black. You
+can use a color declared with '\definecolor' in exactly the same way
that we just used the builtin color 'magenta'.
\definecolor{MidlifeCrisisRed}{rgb}{1.0,0.11,0.0}
@@ -7910,9 +11019,12 @@ the vertical and horizontal lines.
\end{tabular}
\end{center}
- You can use color in equations. A document might have
-'\definecolor{highlightcolor}{RGB}{225,15,0}' in the preamble, and then
-contain this equation.
+ You can use color in equations. A document might have this
+definition in the preamble
+
+ \definecolor{highlightcolor}{RGB}{225,15,0}
+
+and then contain this equation.
\begin{equation}
\int_a^b \textcolor{highlightcolor}{f'(x)}\,dx=f(b)-f(a)
@@ -7922,7 +11034,8 @@ contain this equation.
style but sometimes you want a one-off. Those are the second forms in
the synopses.
- Colors of \textcolor[rgb]{0.33,0.14,0.47}{Purple} and {\color[rgb]{0.72,0.60,0.37} Gold} for the team
+ Colors of \textcolor[rgb]{0.33,0.14,0.47}{Purple} and
+ {\color[rgb]{0.72,0.60,0.37} Gold} for the team.
The format of COLOR SPECIFICATION depends on the color model (*note
Color models::). For instance, while 'rgb' takes three numbers, 'gray'
@@ -7934,7 +11047,7 @@ takes only one.
\textcolor{green}{kind of \textcolor{blue}{blue}}
- has a final word that is blue, not a combination of blue and green.
+has a final word that is blue, not a combination of blue and green.
21.3.3 Colored boxes
--------------------
@@ -7942,19 +11055,19 @@ takes only one.
Synopses:
\colorbox{NAME}{...}
- \colorbox[MODEL NAME]{BOX BACKGROUND COLOR SPECIFICATION}{...}
+ \colorbox[MODEL NAME]{BOX BACKGROUND COLOR}{...}
- or
+or
\fcolorbox{FRAME COLOR}{BOX BACKGROUND COLOR}{...}
- \fcolorbox[MODEL NAME]{FRAME COLOR SPECIFICATION}{BOX BACKGROUND COLOR SPECIFICATION}{...}
+ \fcolorbox[MODEL NAME]{FRAME COLOR}{BOX BACKGROUND COLOR}{...}
Make a box with the stated background color. The '\fcolorbox'
command puts a frame around the box. For instance this
Name:~\colorbox{cyan}{\makebox[5cm][l]{\strut}}
- makes a cyan-colored box that is five centimeters long and gets its
+makes a cyan-colored box that is five centimeters long and gets its
depth and height from the '\strut' (so the depth is '-.3\baselineskip'
and the height is '\baselineskip'). This puts white text on a blue
background.
@@ -7962,7 +11075,7 @@ background.
\colorbox{blue}{\textcolor{white}{Welcome to the machine.}}
The '\fcolorbox' commands use the same parameters as '\fbox' (*note
-\fbox and \framebox::), '\fboxrule' and '\fboxsep', to set the thickness
+\fbox & \framebox::), '\fboxrule' and '\fboxsep', to set the thickness
of the rule and the boundary between the box interior and the
surrounding rule. LaTeX's defaults are '0.4pt' and '3pt', respectively.
@@ -8029,16 +11142,16 @@ external to LaTeX, that generate a graphic that you include using the
commands of this chapter. Two that use a programming language are
Asymptote and MetaPost. One that uses a graphical interface is Xfig.
Full description of these systems is outside the scope of this document;
-see their documentation.
+see their documentation on CTAN.
-22.1 Graphics package options
-=============================
+22.1 'graphics' package options
+===============================
Synopsis (must be in the document preamble):
\usepackage[COMMA-SEPARATED OPTION LIST]{graphics}
- or
+or
\usepackage[COMMA-SEPARATED OPTION LIST]{graphicx}
@@ -8095,15 +11208,15 @@ with a '.def' extension, such as 'pdftex.def'.
multiples, such as 1.23, in '%%HiResBoundingBox' lines. This
option has LaTeX to read the size from the latter.
-22.2 Graphics package configuration
-===================================
+22.2 'graphics' package configuration
+=====================================
These commands configure the way LaTeX searches the file system for the
graphic.
The behavior of file system search code is necessarily platform
-dependent. In this document we cover Linux, Macintosh, and Windows, as
-those systems are typically configured. For other situations consult
+dependent. In this document we cover GNU/Linux, Macintosh, and Windows,
+as those systems are typically configured. For other situations consult
the documentation in 'grfguide.pdf', or the LaTeX source, or your TeX
distribution's documentation.
@@ -8147,9 +11260,9 @@ the current directory,
...
\usepackage{lion.png}
- for each of the listed directories, LaTeX concatenates it with the
-file name and searches for the result, checking for 'pix/lion.png' and
-then '../pix/lion.png'. This algorithm means that the '\graphicspath'
+for each of the listed directories, LaTeX concatenates it with the file
+name and searches for the result, checking for 'pix/lion.png' and then
+'../pix/lion.png'. This algorithm means that the '\graphicspath'
command does not recursively search subdirectories: if you issue
'\graphicspath{{a/}}' and the graphic is in 'a/b/lion.png' then LaTeX
will not find it. It also means that you can use absolute paths such as
@@ -8159,8 +11272,8 @@ means that the document is not portable. (You could preserve
portability by adjusting your TeX system settings configuration file
parameter 'TEXINPUTS'; see the documentation of your system.)
- You can use '\graphicspath' in the preamble or in the document body.
-You can use it more than once. For debugging, show its value with
+ You can use '\graphicspath' anywhere in the document. You can use it
+more than once. Show its value with
'\makeatletter\typeout{\Ginput@path}\makeatother'.
The directories are taken with respect to the base file. That is,
@@ -8188,24 +11301,25 @@ files.
...
\includegraphics{lion} % will find lion.png before lion.pdf
- Because the file name 'lion' does not have a period, LaTeX uses the
+Because the file name 'lion' does not have a period, LaTeX uses the
extension list. For each directory in the graphics path (*note
\graphicspath::), LaTeX will try the extensions in the order given. If
it does not find such a file after trying all the directories and
extensions then it reports '! LaTeX Error: File `'lion'' not found'.
Note that you must include the periods at the start of the extensions.
- Because Linux and Macintosh filenames are case sensitive, the list of
-file extensions is case sensitive on those platforms. The Windows
-platform is not case sensitive.
+ Because GNU/Linux and Macintosh filenames are case sensitive, the
+list of file extensions is case sensitive on those platforms. The
+Windows platform is not case sensitive.
You are not required to include '\DeclareGraphicsExtensions' in your
document; the printer driver has a sensible default. For example, the
-most recent 'pdftex.def' has the extension list
-''.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2''.
+most recent 'pdftex.def' has this extension list.
- You can use this command in the preamble or in the document body.
-You can use it more than once. For debugging, show its value with
+ .png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2
+
+ You can use this command anywhere in the document. You can use it
+more than once. Show its value with
'\makeatletter\typeout{\Gin@extensions}\makeatother'.
22.2.3 '\DeclareGraphicsRule'
@@ -8228,7 +11342,7 @@ input the file.
\DeclareGraphicsRule{*}{mps}{*}{}
- tells LaTeX that it should handle as MetaPost output any file with an
+tells LaTeX that it should handle as MetaPost output any file with an
extension not covered by another rule, so it covers 'filename.1',
'filename.2', etc.
@@ -8319,13 +11433,13 @@ over-print the surrounding area.
\includegraphics{plot.pdf}
\end{center}
- will incorporate into the document the graphic in 'plot.pdf',
-centered and at its nominal size. You can also give a path to the file,
-as with '\includegraphics{graphics/plot.pdf}'. To specify a list of
-locations to search for the file, *note \graphicspath::.
+will incorporate into the document the graphic in 'plot.pdf', centered
+and at its nominal size. You can also give a path to the file, as with
+'\includegraphics{graphics/plot.pdf}'. To specify a list of locations
+to search for the file, *note \graphicspath::.
- If your filename includes spaces then put it in double quotes, as
-with '\includegraphics{"sister picture.jpg"}'.
+ If your filename includes spaces then put it in double quotes. An
+example is '\includegraphics{"sister picture.jpg"}'.
The '\includegraphics{FILENAME}' command decides on the type of
graphic by splitting FILENAME on the first dot. You can use FILENAME
@@ -8359,14 +11473,13 @@ caption.
...
\begin{center}
\includegraphics{pix/nix.png}
- \captionof{figure}{The spirit of the night} \label{pix:nix} % if you want a caption
+ \captionof{figure}{The spirit of the night} \label{pix:nix} % optional
\end{center}
This example puts a box with a graphic side by side with one having
text, with the two vertically centered.
- \newcommand*{\vcenteredhbox}[1]{\begingroup
- \setbox0=\hbox{#1}\parbox{\wd0}{\box0}\endgroup}
+ \newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
...
\begin{center}
\vcenteredhbox{\includegraphics[width=0.4\textwidth]{plot}}
@@ -8399,10 +11512,10 @@ a key-value form, as here.
\includegraphics[angle=90,width=1in]{lion}
\end{center}
- The options are read left-to-right. So the first graphic above is
-made one inch wide and then rotated, while the second is rotated and
-then made one inch wide. Thus, unless the graphic is perfectly square,
-the two will end with different widths and heights.
+The options are read left-to-right. So the first graphic above is made
+one inch wide and then rotated, while the second is rotated and then
+made one inch wide. Thus, unless the graphic is perfectly square, the
+two will end with different widths and heights.
There are many options. The primary ones are listed first.
@@ -8427,9 +11540,9 @@ graphic.
The graphic will be shown so its bounding box is this height. You
can use the standard TeX dimensions (*note Units of length::), and
also convenient are '\pageheight' and '\textheight' (*note Page
- layout parameters::). For instance,
+ layout parameters::). For instance, the command
'\includegraphics[height=0.25\textheight]{godel}' will make the
- graphic be a quarter of the height of the text area.
+ graphic a quarter of the height of the text area.
'totalheight'
The graphic will be shown so its bounding box has this height plus
@@ -8438,22 +11551,24 @@ graphic.
height but a large depth.
'keepaspectratio'
- If set to 'true', or just specified as with
- '\includegraphics[...,keepaspectratio,...]{...}' and you give as
- options both 'width' and 'height' (or 'totalheight'), then LaTeX
- will make the graphic is as large as possible without distortion.
- That is, LaTeX will ensure that neither is the graphic wider than
- 'width' nor taller than 'height' (or 'totalheight').
+ If set to 'true', or just specified as here
+
+ \includegraphics[...,keepaspectratio,...]{...}
+
+ and you give as options both 'width' and 'height' (or
+ 'totalheight'), then LaTeX will make the graphic is as large as
+ possible without distortion. That is, LaTeX will ensure that
+ neither is the graphic wider than 'width' nor taller than 'height'
+ (or 'totalheight').
'scale'
- Factor by which to scale the graphic. Specifying
- '\includegraphics[scale=2.0]{...}' makes the graphic twice its
- nominal size. This number may be any value; a number between 1
- and 0 will shrink the graphic and a negative number will reflect
- it.
+ Factor by which to scale the graphic. To make a graphic twice its
+ nominal size, enter '\includegraphics[scale=2.0]{...}'. This
+ number may be any value; a number between 1 and 0 will shrink the
+ graphic and a negative number will reflect it.
'angle'
- Rotate the picture. The angle is taken in degrees and
+ Rotate the graphic. The angle is taken in degrees and
counterclockwise. The graphic is rotated about its 'origin'; see
that option. For a complete description of how rotated material is
typeset, *note \rotatebox::.
@@ -8462,9 +11577,9 @@ graphic.
The point of the graphic about which the rotation happens.
Possible values are any string containing one or two of: 'l' for
left, 'r' for right, 'b' for bottom, 'c' for center, 't' for top,
- and 'B' for baseline. Thus,
+ and 'B' for baseline. Thus, entering the command
'\includegraphics[angle=180,origin=c]{moon}' will turn the picture
- upside down from the center, while
+ upside down about that picture's center, while the command
'\includegraphics[angle=180,origin=lB]{LeBateau}' will turn its
picture upside down about its left baseline. (The character 'c'
gives the horizontal center in 'bc' or 'tc', but gives the vertical
@@ -8492,10 +11607,13 @@ graphic.
also the 'viewport' option.
'clip'
- If set to 'true', or just specified as with
- '\includegraphics[...,clip,...]{...}', then the graphic is cropped
- to the bounding box. You can get this effect by instead using the
- starred form of the command, as '\includegraphics*[...]{...}'.
+ If set to 'true', or just specified as here
+
+ \includegraphics[...,clip,...]{...}
+
+ then the graphic is cropped to the bounding box. This is the same
+ as using the starred form of the command,
+ '\includegraphics*[...]{...}'.
'page'
Give the page number of a multi-page PDF file. The default is
@@ -8518,8 +11636,9 @@ graphic.
'interpolate'
Enable or disable interpolation of raster images by the viewer.
- Can be set with 'interpolate=true' or just specified as with
- '\includegraphics[...,interpolate,...]{...}'.
+ Can be set with 'interpolate=true' or just specified as here.
+
+ \includegraphics[...,interpolate,...]{...}
'quiet'
Do not write information to the log. You can set it with
@@ -8527,11 +11646,13 @@ graphic.
'\includegraphics[...,quite,...]{...}',
'draft'
- If you set it with 'draft=true' or just specified it with
- '\includegraphics[...,draft,...]{...}', then the graphic will not
- appear in the document, possibly saving color printer ink.
- Instead, LaTeX will put an empty box of the correct size with the
- filename printed in it.
+ If you set it with 'draft=true' or just specify it with
+
+ \includegraphics[...,draft,...]{...}
+
+ then the graphic will not appear in the document, possibly saving
+ color printer ink. Instead, LaTeX will put an empty box of the
+ correct size with the filename printed in it.
These options address the bounding box for Encapsulated PostScript
graphic files, which have a size specified with a line '%%BoundingBox'
@@ -8556,17 +11677,21 @@ points, 1/72 inch. For example, if an '.eps' file has the line
'natwidth, natheight'
An alternative for 'bb'. Setting
- '\includegraphics[...,natwidth=1in,natheight=0.618in,...]{...}' is
- the same as setting 'bb=0 0 1in 0.618in'.
+
+ \includegraphics[...,natwidth=1in,natheight=0.618in,...]{...}
+
+ is the same as setting 'bb=0 0 1in 0.618in'.
'hiresbb'
If set to 'true', or just specified as with
- '\includegraphics[...,hiresbb,...]{...}', then LaTeX will look for
- '%%HiResBoundingBox' lines instead of '%%BoundingBox' lines. (The
- 'BoundingBox' lines use only natural numbers while the
- 'HiResBoundingBox' lines use decimals; both use units equivalent to
- TeX's big points, 1/72 inch.) To override a prior setting of
- 'true', you can set it to 'false'.
+
+ \includegraphics[...,hiresbb,...]{...}
+
+ then LaTeX will look for '%%HiResBoundingBox' lines instead of
+ '%%BoundingBox' lines. (The 'BoundingBox' lines use only natural
+ numbers while the 'HiResBoundingBox' lines use decimals; both use
+ units equivalent to TeX's big points, 1/72 inch.) To override a
+ prior setting of 'true', you can set it to 'false'.
These following options allow a user to override LaTeX's method of
choosing the graphic type based on the filename extension. An example
@@ -8587,7 +11712,9 @@ the file 'lion.xxx' as though it were 'lion.png'. For more on these,
'command'
Specify a command to be applied to this file. Only use this in
- conjunction with the option 'type'.
+ conjunction with the option 'type'. *Note Command line options::
+ for a discussion of enabling the '\write18' functionality to run
+ external commands.
22.3.2 '\rotatebox'
-------------------
@@ -8633,15 +11760,17 @@ you can get the same effect without needing this package, except for the
'origin'
The point of the MATERIAL's box about which the rotation happens.
- Possible values are any string containing one or two of: 'l' for
+ Possible value is any string containing one or two of: 'l' for
left, 'r' for right, 'b' for bottom, 'c' for center, 't' for top,
- and 'B' for baseline. Thus,
- '\includegraphics[angle=180,origin=c]{moon}' will turn the picture
- upside down from the center, while
- '\includegraphics[angle=180,origin=lB]{LeBateau}' will turn its
- picture upside down about its left baseline. (The character 'c'
- gives the horizontal center in 'bc' or 'tc' but gives the vertical
- center in 'lc' or 'rc'.) The default is 'lB'.
+ and 'B' for baseline. Thus, the first line here
+
+ \includegraphics[angle=180,origin=c]{moon}
+ \includegraphics[angle=180,origin=lB]{LeBateau}
+
+ will turn the picture upside down from the center while the second
+ will turn its picture upside down about its left baseline. (The
+ character 'c' gives the horizontal center in 'bc' or 'tc' but gives
+ the vertical center in 'lc' or 'rc'.) The default is 'lB'.
'x, y'
Specify an arbitrary point of rotation with '\rotatebox[x=TeX
@@ -8673,10 +11802,13 @@ the first text and doubles the size of the second.
If you do not specify the optional VERTICAL FACTOR then it defaults
to the same value as the HORIZONTAL FACTOR.
- You can use this command to resize a graphic, as with
-'\scalebox{0.5}{\includegraphics{lion}}'. If you use the 'graphicx'
-package then you can accomplish the same thing with optional arguments
-to '\includegraphics' (*note \includegraphics::).
+ You can use this command to resize a graphic, as here.
+
+ \scalebox{0.5}{\includegraphics{lion}}
+
+If you use the 'graphicx' package then you can accomplish the same thing
+with optional arguments to '\includegraphics' (*note
+\includegraphics::).
The '\reflectbox' command abbreviates '\scalebox{-1}[1]{MATERIAL}'.
Thus, 'Able was I\reflectbox{Able was I}' will show the phrase 'Able was
@@ -8720,34 +11852,31 @@ meaning do not correspond to simple characters you can type.
23.1 Reserved characters
========================
-LaTeX sets aside the following characters for special purposes (for
-example, the percent sign '%' is for comments) so they are called
+LaTeX sets aside the following characters for special purposes. For
+example, the percent sign '%' is for comments. They are called
"reserved characters" or "special characters".
# $ % & { } _ ~ ^ \
If you want a reserved character to be printed as itself, in the text
body font, for all but the final three characters in that list simply
-put a backslash '\' in front of the character. Thus, '\$1.23' will
-produce '$1.23' in your output.
+put a backslash '\' in front of the character. Thus, typing '\$1.23'
+will produce '$1.23' in your output.
As to the last three characters, to get a tilde in the text body font
use '\~{}' (omitting the curly braces would result in the next character
receiving a tilde accent). Similarly, to get a get a text body font
-circumflex use '\^{}'. A text body font backslash results from
-'\textbackslash{}'.
+circumflex use '\^{}'. To get a backslash in the font of the text body,
+enter '\textbackslash{}'.
- To produce the reserved characters in a typewriter font use
-'\verb!!', as below.
+ To produce the reserved characters in a typewriter font use '\verb!!'
+as below (the double backslash '\\' is only there to split the lines).
\begin{center}
\# \$ \% \& \{ \} \_ \~{} \^{} \textbackslash \\
\verb!# $ % & { } _ ~ ^ \!
\end{center}
- In that example the double backslash '\\' is only there to split the
-lines.
-
23.2 Upper and lower case
=========================
@@ -8809,17 +11938,18 @@ could also be written as '\symbol{'40}' or '\symbol{"20}'.
LaTeX provides commands to generate a number of non-letter symbols in
running text. Some of these, especially the more obscure ones, are not
-available in OT1; you may need to load the 'textcomp' package.
+available in OT1. Unless you are using XeLaTeX or LuaLaTeX then you may
+need to load the 'textcomp' package.
'\copyright'
'\textcopyright'
- The copyright symbol, (C).
+ (C) The copyright symbol.
'\dag'
- The dagger symbol (in text).
+ U+2020 The dagger symbol (in text).
'\ddag'
- The double dagger symbol (in text).
+ U+2021 The double dagger symbol (in text).
'\LaTeX'
The LaTeX logo.
@@ -8831,260 +11961,260 @@ available in OT1; you may need to load the 'textcomp' package.
'\guillemotright (>>)'
'\guilsinglleft (<)'
'\guilsinglright (>)'
- Double and single angle quotation marks, commonly used in French:
- <<, >>, <, >.
+ <<, >>, <, > Double and single angle quotation marks, commonly used
+ in French.
'\ldots'
'\dots'
'\textellipsis'
- An ellipsis (three dots at the baseline): '...'. '\ldots' and
- '\dots' also work in math mode.
+ ... An ellipsis (three dots at the baseline): '\ldots' and '\dots'
+ also work in math mode.
'\lq'
- Left (opening) quote: '.
+ ' Left (opening) quote.
'\P'
'\textparagraph'
- Paragraph sign (pilcrow): U+00B6.
+ U+00B6 Paragraph sign (pilcrow).
'\pounds'
'\textsterling'
- English pounds sterling: #.
+ # English pounds sterling.
'\quotedblbase (,,)'
'\quotesinglbase (,)'
- Double and single quotation marks on the baseline: ,, and ,.
+ ,, and , Double and single quotation marks on the baseline.
'\rq'
- Right (closing) quote: '.
+ ' Right (closing) quote.
'\S'
- \itemx \textsection Section sign: U+00A7.
+'\textsection'
+ U+00A7 Section sign.
'\TeX'
The TeX logo.
'\textasciicircum'
- ASCII circumflex: ^.
+ ^ ASCII circumflex.
'\textasciitilde'
- ASCII tilde: ~.
+ ~ ASCII tilde.
'\textasteriskcentered'
- Centered asterisk: *.
+ * Centered asterisk.
'\textbackslash'
- Backslash: \.
+ \ Backslash.
'\textbar'
- Vertical bar: |.
+ | Vertical bar.
'\textbardbl'
- Double vertical bar.
+ U+23F8 Double vertical bar.
'\textbigcircle'
- Big circle symbol.
+ U+25EF Big circle symbol.
'\textbraceleft'
- Left brace: {.
+ { Left brace.
'\textbraceright'
- Right brace: }.
+ } Right brace.
'\textbullet'
- Bullet: *.
+ * Bullet.
'\textcircled{LETTER}'
- LETTER in a circle, as in (R).
+ U+24B6 Circle around LETTER.
'\textcompwordmark'
'\textcapitalcompwordmark'
'\textascendercompwordmark'
- Composite word mark (invisible). The '\textcapital...' form has
- the cap height of the font, while the '\textascender...' form has
- the ascender height.
+ Used to separate letters that would normally ligature. For
+ example, 'f\textcompwordmark i' produces 'fi' without a ligature.
+ This is most useful in non-English languages. The
+ '\textcapitalcompwordmark' form has the cap height of the font
+ while the '\textascendercompwordmark' form has the ascender height.
'\textdagger'
- Dagger: \dag.
+ U+2020 Dagger.
'\textdaggerdbl'
- Double dagger: \ddag.
+ U+2021 Double dagger.
'\textdollar (or '\$')'
- Dollar sign: $.
+ $ Dollar sign.
'\textemdash (or '---')'
- Em-dash: -- (for punctuation).
+ -- Em-dash (used for punctuation, as in 'The playoffs --- if you
+ are fortunate enough to make the playoffs --- is more like a
+ sprint.').
'\textendash (or '--')'
- En-dash: - (for ranges).
+ - En-dash (used for ranges, as in 'See pages 12--14').
'\texteuro'
- The Euro symbol: Euro.
+
+ The Euro symbol: Euro. For an alternative glyph design, try the
+ 'eurosym' package; also, most fonts nowadays come with their own
+ Euro symbol (Unicode U+20AC).
'\textexclamdown (or '!`')'
- Upside down exclamation point: !.
+ ! Upside down exclamation point.
'\textgreater'
- Greater than: >.
+ > Greater than symbol.
'\textless'
- Less than: <.
+ < Less than symbol.
'\textleftarrow'
- Left arrow.
+ U+2190 Left arrow.
'\textordfeminine'
'\textordmasculine'
- Feminine and masculine ordinal symbols: a, o.
+ a, o Feminine and masculine ordinal symbols.
'\textperiodcentered'
- Centered period: U+00B7.
+ U+00B7 Centered period.
'\textquestiondown (or '?`')'
- Upside down question mark: ?.
+ ? Upside down question mark.
'\textquotedblleft (or '``')'
- Double left quote: ".
+ " Double left quote.
'\textquotedblright (or '''')'
- Double right quote: ".
+ " Double right quote.
'\textquoteleft (or '`')'
- Single left quote: '.
+ ' Single left quote.
'\textquoteright (or ''')'
- Single right quote: '.
+ ' Single right quote.
'\textquotesingle'
- Straight single quote. (From TS1 encoding.)
+ U+0027 Straight single quote. (From TS1 encoding.)
'\textquotestraightbase'
'\textquotestraightdblbase'
Single and double straight quotes on the baseline.
'\textregistered'
- Registered symbol: (R).
+ (R) Registered symbol.
'\textrightarrow'
- Right arrow.
+ U+2192 Right arrow.
'\textthreequartersemdash'
- "Three-quarters" em-dash, between en-dash and em-dash.
+ U+FE58 "Three-quarters" em-dash, between en-dash and em-dash.
'\texttrademark'
- Trademark symbol: U+2122.
+ U+2122 Trademark symbol.
'\texttwelveudash'
- "Two-thirds" em-dash, between en-dash and em-dash.
+ U+FE58 "Two-thirds" em-dash, between en-dash and em-dash.
'\textunderscore'
- Underscore: _.
+ _ Underscore.
'\textvisiblespace'
- Visible space symbol.
+ U+2423 Visible space symbol.
23.5 Accents
============
LaTeX has wide support for many of the world's scripts and languages,
-through the 'babel' package and related support. This section does not
-attempt to cover all that support. It merely lists the core LaTeX
-commands for creating accented characters.
+through the 'babel' package and related support if you are using
+pdfLaTeX, or 'polyglossia' if you are using XeLaTeX or LuaLaTeX. This
+section does not cover that support. It only lists the core LaTeX
+commands for creating accented characters. The '\capital...' commands
+shown here produce alternative forms for use with capital letters.
+These are not available with OT1.
+
+ Below, to make them easier to find, the accents are all illustrated
+with lowercase 'o'.
- The '\capital...' commands produce alternative forms for use with
-capital letters. These are not available with OT1.
+ Note that '\i' produces a dotless i, and '\j' produces a dotless j.
+These are often used in place of their dotted counterparts when they are
+accented.
'\"'
'\capitaldieresis'
- Produces an umlaut (dieresis), as in o".
+ o" Umlaut (dieresis).
'\''
'\capitalacute'
- Produces an acute accent, as in o'. In the 'tabbing' environment,
- pushes current column to the right of the previous column (*note
- tabbing::).
+ o' Acute accent.
'\.'
- Produces a dot accent over the following, as in o..
+ o. Dot accent.
'\='
'\capitalmacron'
- Produces a macron (overbar) accent over the following, as in o=.
+ o= Macron (overbar) accent.
'\^'
'\capitalcircumflex'
- Produces a circumflex (hat) accent over the following, as in o^.
+ o^ Circumflex (hat) accent.
'\`'
'\capitalgrave'
- Produces a grave accent over the following, as in o`. In the
- 'tabbing' environment, move following text to the right margin
- (*note tabbing::).
+ o` Grave accent.
'\~'
'\capitaltilde'
- Produces a tilde accent over the following, as in n~.
+ n~ Tilde accent.
'\b'
- Produces a bar accent under the following, as in o_. See also
- '\underbar' hereinafter.
+ o_ Bar accent underneath.
+
+ Related to this, '\underbar{TEXT}' produces a bar under TEXT. The
+ argument is always processed in LR mode (*note Modes::). The bar
+ is always a fixed position under the baseline, thus crossing
+ through descenders. See also '\underline' in *note Math
+ miscellany::.
'\c'
'\capitalcedilla'
- Produces a cedilla accent under the following, as in c,.
+ c, Cedilla accent underneath.
'\d'
'\capitaldotaccent'
- Produces a dot accent under the following, as in .o.
+ .o Dot accent underneath.
'\H'
'\capitalhungarumlaut'
- Produces a long Hungarian umlaut accent over the following, as in
- o''.
-
-'\i'
- Produces a dotless i, as in 'i'.
-
-'\j'
- Produces a dotless j, as in 'j'.
+ o'' Long Hungarian umlaut accent.
'\k'
'\capitalogonek'
- Produces a letter with ogonek, as in 'o;'. Not available in the
- OT1 encoding.
+ o; Ogonek. Not available in the OT1 encoding.
'\r'
'\capitalring'
- Produces a ring accent, as in 'o*'.
+ o* Ring accent.
'\t'
'\capitaltie'
'\newtie'
'\capitalnewtie'
- Produces a tie-after accent, as in 'oo['. The '\newtie' form is
- centered in its box.
+ oo[ Tie-after accent. The '\newtie' form is centered in its box.
'\u'
'\capitalbreve'
- Produces a breve accent, as in 'o('.
-
-'\underbar'
- Not exactly an accent, this produces a bar under the argument text.
- The argument is always processed in horizontal mode. The bar is
- always a fixed position under the baseline, thus crossing through
- descenders. See also '\underline' in *note Math miscellany::. See
- also '\b' above.
+ o( Breve accent.
'\v'
'\capitalcaron'
- Produces a ha'c<ek (check, caron) accent, as in 'o<'.
+ o< Ha'c<ek (check, caron) accent.
23.6 Additional Latin letters
=============================
-Here are the basic LaTeX commands for inserting letters (beyond A-Z)
-extending the Latin alphabet, used primarily in languages other than
+Here are the basic LaTeX commands for inserting letters beyond A-Z that
+extend the Latin alphabet, used primarily in languages other than
English.
'\aa'
@@ -9140,33 +12270,51 @@ English.
23.7 '\rule'
============
-Synopsis:
+Synopsis, one of:
+ \rule{WIDTH}{THICKNESS}
\rule[RAISE]{WIDTH}{THICKNESS}
- The '\rule' command produces "rules", that is, lines or rectangles.
-The arguments are:
+ Produce a "rule", a filled-in rectangle.
-RAISE
- How high to raise the rule (optional).
+ This produces a rectangular blob, sometimes called a Halmos symbol,
+often used to mark the end of a proof.
-WIDTH
- The length of the rule (mandatory).
+ \newcommand{\qedsymbol}{\rule{0.4em}{2ex}}
+
+The 'amsthm' package includes this command, with a somewhat
+different-looking symbol.
+
+ The mandatory arguments give the horizontal WIDTH and vertical
+THICKNESS of the rectangle. They are rigid lengths (*note Lengths::).
+The optional argument RAISE is also a rigid length, and tells LaTeX how
+much to raise the rule above the baseline, or lower it if the length is
+negative.
-THICKNESS
- The thickness of the rule (mandatory).
+ This produces a line, a rectangle that is wide but not tall.
+
+ \noindent\rule{\textwidth}{0.4pt}
+
+The line is the width of the page and 0.4 points tall. This line
+thickness is common in LaTeX.
+
+ A rule that has zero width, or zero thickness, will not show up in
+the output, but can cause LaTeX to change the output around it. *Note
+\strut:: for examples.
23.8 '\today'
=============
-The '\today' command produces today's date, in the format 'MONTH DD,
-YYYY'; for example, 'July 4, 1976'. It uses the predefined counters
-'\day', '\month', and '\year' (*note \day \month \year::) to do this.
-It is not updated as the program runs.
+Synopsis:
+
+ \today
+
+ Produce today's date in the format 'MONTH DD, YYYY'. An example of a
+date in that format is 'July 4, 1976'.
- Multilingual packages like 'babel' or classes like 'lettre', among
-others, will localize '\today'. For example, the following will output
-'4 juillet 1976':
+ Multilingual packages such as 'babel' or 'polyglossia', or classes
+such as 'lettre', will localize '\today'. For example, the following
+will output '4 juillet 1976':
\year=1976 \month=7 \day=4
\documentclass{minimal}
@@ -9175,92 +12323,337 @@ others, will localize '\today'. For example, the following will output
\today
\end{document}
- The 'datetime' package, among others, can produce a wide variety of
-other date formats.
+'\today' uses the counters '\day', '\month', and '\year' (*note \day &
+\month & \year::).
+
+ A number of package on CTAN work with dates. One is 'datetime'
+package which can produce a wide variety of date formats, including ISO
+standards.
+
+ The date is not updated as the LaTeX process runs, so in principle
+the date could be incorrect by the time the program finishes.
24 Splitting the input
**********************
-A large document requires a lot of input. Rather than putting the whole
-input in a single large file, it's more efficient to split it into
-several smaller ones. Regardless of how many separate files you use,
-there is one that is the "root file"; it is the one whose name you type
-when you run LaTeX.
+LaTeX lets you split a large document into several smaller ones. This
+can simplify editing or allow multiple authors to work on the document.
+It can also speed processing.
+
+ Regardless of how many separate files you use, there is always one
+"root file", on which LaTeX compilation starts. This shows such a file
+with five included files.
+
+ \documentclass{book}
+ \includeonly{ % comment out lines below to omit compiling
+ pref,
+ chap1,
+ chap2,
+ append,
+ bib
+ }
+ \begin{document}
+ \frontmatter
+ \include{pref}
+ \mainmatter
+ \include{chap1}
+ \include{chap2}
+ \appendix
+ \include{append}
+ \backmatter
+ \include{bib}
+ \end{document}
- *Note filecontents::, for an environment that allows bundling an
-external file to be created with the main document.
+This will bring in material from 'pref.tex', 'chap1.tex', 'chap2.tex',
+'append.tex', and 'bib.tex'. If you compile this file, and then comment
+out all of the lines inside '\includeonly{...}' except for 'chap1,' and
+compile again, then LaTeX will only process the material in the first
+chapter. Thus, your output will appear more quickly and be shorter to
+print. However, the advantage of the '\includeonly' command is that
+LaTeX will retain the page numbers and all of the cross reference
+information from the other parts of the document so these will appear in
+your output correctly.
-24.1 '\include'
-===============
+ *Note Larger book template:: for another example of '\includeonly'.
+
+24.1 '\endinput'
+================
Synopsis:
- \include{FILE}
+ \endinput
- If no '\includeonly' command is present, the '\include' command
-executes '\clearpage' to start a new page (*note \clearpage::), then
-reads FILE, then does another '\clearpage'.
+ When you '\include{filename}', inside 'filename.tex' the material
+after '\endinput' will not be included. This command is optional; if
+'filename.tex' has no '\endinput' then LaTeX will read all of the file.
- Given an '\includeonly' command, the '\include' actions are only run
-if FILE is listed as an argument to '\includeonly'. See *note
-\includeonly::.
+ For example, suppose that a document's root file has '\input{chap1}'
+and this is 'chap1.tex'.
- The '\include' command may not appear in the preamble or in a file
-read by another '\include' command.
+ \chapter{One}
+ This material will appear in the document.
+ \endinput
+ This will not appear.
-24.2 '\includeonly'
-===================
+ This can be useful for putting documentation or comments at the end
+of a file, or for avoiding junk characters that can be added during
+mailing. It is also useful for debugging: one strategy to localize
+errors is to put '\endinput' halfway through the included file and see
+if the error disappears. Now, knowing which half contains the error,
+moving '\endinput' to halfway through that area further narrows down the
+location. This process rapidly finds the offending line.
+
+ After reading '\endinput', LaTeX continues to read to the end of the
+line, so something can follow this command and be read nonetheless.
+This allows you, for instance, to close an '\if...' with a '\fi'.
+
+24.2 '\include' & '\includeonly'
+================================
Synopsis:
- \includeonly{FILE1,FILE2,...}
+ \includeonly{ % in document preamble
+ ...
+ FILENAME,
+ ...
+ }
+ ...
+ \include{FILENAME} % in document body
+
+ Bring material from the external file 'FILENAME.tex' into a LaTeX
+document.
+
+ The '\include' command does three things: it executes '\clearpage'
+(*note \clearpage & \cleardoublepage::), then it inputs the material
+from 'FILENAME.tex' into the document, and then it does another
+'\clearpage'. This command can only appear in the document body. The
+'\includeonly' command controls which files will be read by LaTeX under
+subsequent '\include' commands. Its list of filenames is
+comma-separated, and it can only appear in the preamble.
+
+ This example root document, 'constitution.tex', brings in three
+files, 'preamble.tex', 'articles.tex', and 'amendments.tex'.
+
+ \documentclass{book}
+ \includeonly{
+ preamble,
+ articles,
+ amendments
+ }
+ \begin{document}
+ \include{preamble}
+ \include{articles}
+ \include{amendments}
+ \end{document}
+
+The file 'preamble.tex' contains no special code; you have just
+excerpted the chapter from 'consitution.tex' and put it in a separate
+file just for editing convenience.
+
+ \chapter{Preamble}
+ We the People of the United States,
+ in Order to form a more perfect Union, ...
+
+Running LaTeX on 'constitution.tex' makes the material from the three
+files appear in the document but also generates the auxiliary files
+'preamble.aux', 'articles.aux', and 'amendments.tex'. These contain
+information such as page numbers and cross-references (*note Cross
+references::). If you now comment out '\includeonly''s lines with
+'preamble' and 'amendments' and run LaTeX again then the resulting
+document shows only the material from 'articles.tex', not the material
+from 'preamble.tex' or 'amendments.tex'. Nonetheless, all of the
+auxiliary information from the omitted files is still there, including
+the starting page number of the chapter.
+
+ If the document preamble does not have '\includeonly' then LaTeX will
+include all the files you call for with '\include' commands.
+
+ The '\include' command makes a new page. To avoid that, see *note
+\input:: (which, however, does not retain the auxiliary information).
+
+ *Note Larger book template:: for another example using '\include' and
+'\includeonly'. That example also uses '\input' for some material that
+will not necessarily start on a new page.
+
+ File names can involve paths.
+
+ \documentclass{book}
+ \includeonly{
+ chapters/chap1,
+ }
+ \begin{document}
+ \include{chapters/chap1}
+ \end{document}
+
+ To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores. Nevertheless, for the name 'amo amas amat', this
+works under TeX Live on GNU/Linux:
- The '\includeonly' command controls which files will be read by
-subsequent '\include' commands. The list of filenames is
-comma-separated. Each element FILE1, FILE2, ... must exactly match a
-filename specified in a '\include' command for the selection to be
-effective.
+ \documentclass{book}
+ \includeonly{
+ "amo\space amas\space amat"
+ }
+ \begin{document}
+ \include{"amo\space amas\space amat"}
+ \end{document}
- This command can only appear in the preamble.
+ and this works under MiKTeX on Windows:
+
+ \documentclass{book}
+ \includeonly{
+ {"amo amas amat"}
+ }
+ \begin{document}
+ \include{{"amo amas amat"}}
+ \end{document}
+
+ You cannot use '\include' inside a file that is being included or you
+get 'LaTeX Error: \include cannot be nested.' The '\include' command
+cannot appear in the document preamble; you will get 'LaTeX Error:
+Missing \begin{document}'.
+
+ If a file that you '\include' does not exist, for instance if you
+'\include{athiesm}' but you meant '\include{atheism}', then LaTeX does
+not give you an error but will warn you 'No file athiesm.tex.' (It will
+also create 'athiesm.aux'.)
+
+ If you '\include' the root file in itself then you first get 'LaTeX
+Error: Can be used only in preamble.' Later runs get 'TeX capacity
+exceeded, sorry [text input levels=15]'. To fix this, you must remove
+the inclusion '\include{root}' but also delete the file 'ROOT.aux' and
+rerun LaTeX.
24.3 '\input'
=============
Synopsis:
- \input{FILE}
+ \input{FILENAME}
+
+ LaTeX processes the file as if its contents were inserted in the
+current file. For a more sophisticated inclusion mechanism see *note
+\include & \includeonly::.
+
+ If FILENAME does not end in '.tex' then LaTeX first tries the
+filename with that extension; this is the usual case. If FILENAME ends
+with '.tex' then LaTeX looks for the filename as it is.
- The '\input' command causes the specified FILE to be read and
-processed, as if its contents had been inserted in the current file at
-that point.
+ For example, this
- If FILE does not end in '.tex' (e.g., 'foo' or 'foo.bar'), it is
-first tried with that extension ('foo.tex' or 'foo.bar.tex'). If that
-is not found, the original FILE is tried ('foo' or 'foo.bar').
+ \input{macros}
+
+will cause LaTeX to first look for 'macros.tex'. If it finds that file
+then it processes its contents as thought they had been copy-pasted in.
+If there is no file of the name 'macros.tex' then LaTeX tries the name
+'macros', without an extension. (This may vary by distribution.)
+
+ To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores. Nevertheless, for the name 'amo amas amat', this
+works under TeX Live on GNU/Linux:
+
+ \input{"amo\space amas\space amat"}
+
+ and this works under MiKTeX on Windows:
+
+ \input{{"amo amas amat"}}
25 Front/back matter
********************
-25.1 Tables of contents
-=======================
+25.1 Table of contents etc.
+===========================
-A table of contents is produced with the '\tableofcontents' command.
-You put the command right where you want the table of contents to go;
-LaTeX does the rest for you. A previous run must have generated a
-'.toc' file.
+Synopsis, one of:
- The '\tableofcontents' command produces a heading, but it does not
-automatically start a new page. If you want a new page after the table
-of contents, write a '\newpage' command after the '\tableofcontents'
-command.
+ \tableofcontents
+ \listoffigures
+ \listoftables
- The analogous commands '\listoffigures' and '\listoftables' produce a
-list of figures and a list of tables (from '.lof' and '.lot' files),
-respectively. Everything works exactly the same as for the table of
-contents.
+ Produce a table of contents, or list of figures, or list of tables.
+Put the command in the input file where you want the table or list to
+go. You do not type the entries; for example, typically the table of
+contents entries are automatically generated from the sectioning
+commands '\chapter', etc.
+
+ This example illustrates the first command, '\tableofcontents'.
+LaTeX will produce a table of contents on the book's first page.
+
+ \documentclass{book}
+ % \setcounter{tocdepth}{1}
+ \begin{document}
+ \tableofcontents\newpage
+ ...
+ \chapter{...}
+ ...
+ \section{...}
+ ...
+ \subsection{...}
+ ...
+ \end{document}
+
+Uncommenting the second line would cause that table to contain chapter
+and section listings but not subsection listings, because the '\section'
+command has level 1. *Note Sectioning:: for level numbers of the
+sectioning units. For more on the 'tocdepth' *note
+Sectioning/tocdepth::.
+
+ Another example of the use of '\tableofcontents' is in *note Larger
+book template::.
+
+ If you want a page break after the table of contents, write a
+'\newpage' command after the '\tableofcontents' command, as above.
- The command '\nofiles' overrides these commands, and _prevents_ any
-of these lists from being generated.
+ To make the table of contents LaTeX stores the information in an
+auxiliary file named 'ROOT-FILE.toc' (*note Splitting the input::). For
+example, this LaTeX file 'test.tex'
+
+ \documentclass{article}
+ \begin{document}
+ \tableofcontents\newpage
+ \section{First section}
+ \subsection{First subsection}
+ ...
+
+writes the following line to 'test.toc'.
+
+ \contentsline {section}{\numberline {1}First section}{2}
+ \contentsline {subsection}{\numberline {1.1}First subsection}{2}
+
+The 'section' or 'subsection' is the sectioning unit. The hook
+'\numberline' lets you to change how the information appears in the
+table of contents. Of its two arguments, '1' or '1.1' is the sectioning
+unit number and 'First section' or 'First subsection' is the title.
+Finally, '2' is the page number on which the sectioning units start.
+
+ One consequence of this auxiliary file storage strategy is that to
+get the contents page correct you must run LaTeX twice, once to store
+the information and once to get it. In particular, the first time that
+you run LaTeX on a new document, the table of contents page will be
+empty except for its 'Contents' header. Just run it again.
+
+ The commands '\listoffigures' and '\listoftables' produce a list of
+figures and a list of tables. They work the same way as the contents
+commands; for instance, these work with information stored in '.lof' and
+'.lot' files.
+
+ To change the header for the table of contents page do something like
+the first line here.
+
+ \renewcommand{\contentsname}{Table of contents}
+ \renewcommand{\listfigurename}{Plots}
+ \renewcommand{\listtablename}{Tables}
+
+Similarly, the other two lines will do the other two.
+Internationalization packages such as 'babel' or 'polyglossia' will
+change the headers depending on the chosen base language.
+
+ CTAN has many packages for the table of contents and lists of figures
+and tables. One convenient one for adjusting some aspects of the
+default, such as spacing, is 'tocloft'. And, 'tocbibbind' will
+automatically add the bibliography, index, etc. to the table of
+contents.
25.1.1 '\addcontentsline'
-------------------------
@@ -9269,102 +12662,597 @@ Synopsis:
\addcontentsline{EXT}{UNIT}{TEXT}
- The '\addcontentsline' command adds an entry to the specified list or
-table where:
+ Add an entry to the file specified by EXT. Usually EXT is one of
+'toc' for the table of contents, 'lof' for the list of figures, or 'lot'
+for the list of tables.
+
+ The following will result in an 'Appendices' line in the table of
+contents.
+
+ \addcontentsline{toc}{section}{\protect\textbf{Appendices}}
+
+It will appear at the same indentation level as the sections, will be in
+boldface, and will be assigned the page number associated with the point
+where it appears in the input file.
+
+ The '\addcontentsline' command writes information to the file
+'ROOT-NAME.EXT'. It writes that information as the text of the command
+'\contentsline{UNIT}{TEXT}{NUM}', where 'NUM' is the current value of
+counter 'UNIT'. The most common case is the table of contents and there
+NUM is the page number of the first page of UNIT.
+
+ This command is invoked by the sectioning commands '\chapter', etc.,
+and also by '\caption' inside a float environment. But it is also used
+by authors. For example, in a book to have the preface unnumbered, you
+may use the starred '\chapter*'. But that does not put in table of
+contents information, so you can enter it manually, as here.
+
+ \chapter*{Preface}
+ \addcontentsline{toc}{chapter}{\protect\numberline{}Preface}
+
+In the '.toc' file LaTeX will put the line '\contentsline
+{chapter}{\numberline {}Preface}{3}'; note the page number '3'.
+
+ All of the arguments for '\addcontentsline' are required.
EXT
- The filename extension of the file on which information is to be
- written, typically one of: 'toc' (table of contents), 'lof' (list
- of figures), or 'lot' (list of tables).
+ Typically one of the strings 'toc' for the table of contents, 'lof'
+ for the list of figures, or 'lot' for the list of tables. The
+ filename extension of the information file.
UNIT
- The name of the sectional unit being added, typically one of the
- following, matching the value of the EXT argument:
+ A string that depends on the value of the EXT argument:
'toc'
- The name of the sectional unit: 'part', 'chapter', 'section',
- 'subsection', 'subsubsection'.
+ For the table of contents, this is the name of a sectional
+ unit: 'part', 'chapter', 'section', 'subsection', etc.
+
'lof'
For the list of figures: 'figure'.
+
'lot'
For the list of tables: 'table'.
TEXT
- The text of the entry.
+ The text of the entry. You must '\protect' any commands that are
+ fragile (*note \protect::).
- What is written to the '.EXT' file is the command
-'\contentsline{UNIT}{TEXT}{NUM}', where 'NUM' is the current value of
-counter 'UNIT'.
+ The '\addcontentsline' command has an interaction with '\include'
+(*note \include & \includeonly::). If you use them at the same level,
+as with '\addcontentsline{...}{...}{...}\include{...}' then lines in the
+table of contents can come out in the wrong order. The solution is to
+move '\addcontentsline' into the file being included.
+
+ If you use a UNIT that LaTeX does not recognize, as here
+
+ \addcontentsline{toc}{setcion}{\protect\textbf{Appendices}}
+
+then you don't get an error but the formatting in the table of contents
+will not make sense.
25.1.2 '\addtocontents'
-----------------------
-The '\addtocontents'{EXT}{TEXT} command adds text (or formatting
-commands) directly to the '.EXT' file that generates the table of
-contents or lists of figures or tables.
+Synopsis:
+
+ \addtocontents{EXT}{TEXT}
+
+ Add TEXT, which may be text or formatting commands, directly to the
+auxiliary file with extension EXT. This is most commonly used for the
+table of contents so that is the discussion here, but this also applies
+to the list of figures and list of tables.
+
+ This will put some vertical space in the table of contents after the
+'Contents' header.
+
+ \tableofcontents\newpage
+ \addtocontents{toc}{\protect\vspace*{3ex}}
+
+ The '\addtocontents' command has two arguments. Both are required.
EXT
- The extension of the file on which information is to be written,
- typically one of: 'toc' (table of contents), 'lof' (list of
- figures), or 'lot' (list of tables).
+ Typically one of: 'toc' for the table of contents, 'lof' for the
+ list of figures, or 'lot' for the list of tables. The extension of
+ the file holding the information.
TEXT
- The text to be written.
+ The text, and possibly commands, to be written.
-25.2 Glossaries
-===============
+ The sectioning commands such as '\chapter' use the '\addcontentsline'
+command to store information. This command creates lines in the '.toc'
+auxiliary file containing the '\contentsline' command (*note
+\addcontentsline::). In contrast, the command '\addtocontents' puts
+material directly in that file.
-The command '\makeglossary' enables creating glossaries.
+ The '\addtocontents' command has an interaction with '\include'
+(*note \include & \includeonly::). If you use them at the same level,
+as with '\addtocontents{...}{...}\include{...}' then lines in the table
+of contents can come out in the wrong order. The solution is to move
+'\addtocontents' into the file being included.
- The command '\glossary{TEXT}' writes a glossary entry for TEXT to an
-auxiliary file with the '.glo' extension.
+25.1.3 '\nofiles'
+-----------------
- Specifically, what gets written is the command
-'\glossaryentry{TEXT}{PAGENO}', where PAGENO is the current '\thepage'
-value.
+Synopsis:
+
+ \nofiles
- The 'glossary' package on CTAN provides support for fancier
-glossaries.
+ Prevent LaTeX from writing any auxiliary files. The only output will
+be the '.log' and '.pdf' (or '.dvi') files. This command must go in the
+preamble.
-25.3 Indexes
+ Because of the '\nofiles' command this example will not produce a
+'.toc' file.
+
+ \documentclass{book}
+ \nofiles
+ \begin{document}
+ \tableofcontents\newpage
+ \chapter{...}
+ ...
+
+LaTeX will not erase any existing auxiliary files, so if you insert the
+'\nofiles' command after you have run the file and gotten a '.toc' then
+the table of contents page will continue to show the old information.
+
+25.2 Indexes
============
-The command '\makeindex' enables creating indexes. Put this in the
-preamble.
+This document has an index.
- The command '\index{TEXT}' writes an index entry for TEXT to an
-auxiliary file named with the '.idx' extension.
+ \documentclass{article}
+ \usepackage{makeidx} \makeindex
+ ...
+ \begin{document}
+ ...
+ Recall Wilson's Theorem: \index{Wilson's Theorem}
+ a number \( n>1 \) is prime if and only if the factorial of \( n-1 \)
+ is congruent to \( -1 \) modulo~\( n \).
+ ...
+ \printindex
+ ...
- Specifically, what gets written is the command
-'\indexentry{TEXT}{PAGENO}', where PAGENO is the current '\thepage'
-value.
+The '\usepackage{makeidx}' and '\makeindex' in the preamble bring in the
+relevant commands.
+
+ Producing an index is a three stage process. First, in the document
+body you declare index entries with the '\index' command (*note
+\index::). When you run LaTeX, the '\index' writes its information to
+an auxiliary file 'ROOT-NAME.idx'. Next, to alphabetize and to do other
+manipulations you run an external command, typically 'makeindex' or
+'xindy' (*note makeindex::). These output a file 'ROOT-NAME.ind'.
+Finally, you bring the information back into your document and typeset
+it with the '\printindex' command (*note \printindex::).
+
+ There are many packages that apply to indexing commands. The
+'showidx' package causes each index entries to be shown in the margin on
+the page where the entry appears. This can help in preparing the index.
+The 'multind' package supports multiple indexes. See also the TeX FAQ
+entry on this topic,
+<http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind>.
- To generate a index entry for 'bar' that says 'See foo', use a
-vertical bar: '\index{bar|see{foo}}'. Use 'seealso' instead of 'see' to
-make a 'See also' entry.
+25.2.1 '\index'
+---------------
- The text 'See' is defined by the macro '\seename', and 'See also' by
-the macro '\alsoname'. These can be redefined for other languages.
+Synopsis:
- The generated '.idx' file is then sorted with an external command,
-usually either 'makeindex' (<http://mirror.ctan.org/indexing/makeindex>)
-or (the multi-lingual) 'xindy' (<http://xindy.sourceforge.net>). This
-results in a '.ind' file, which can then be read to typeset the index.
+ \index{INDEX-ENTRY-STRING}
- The index is usually generated with the '\printindex' command. This
-is defined in the 'makeidx' package, so '\usepackage{makeidx}' needs to
-be in the preamble.
+ Declare an entry in the index. This command is fragile (*note
+\protect::).
- The rubber length '\indexspace' is inserted before each new letter in
-the printed index; its default value is '10pt plus5pt minus3pt'.
+ For example, as described in *note Indexes::, one way to get an index
+from what's below is to compile the document with 'pdflatex test', then
+process the index entries with 'makeindex test', and then compile again
+with 'pdflatex test'.
- The 'showidx' package causes each index entries to be shown in the
-margin on the page where the entry appears. This can help in preparing
-the index.
+ W~Ackermann (1896--1962).\index{Ackermann}
+ ...
+ Ackermann function\index{Ackermann!function}
+ ...
+ rate of growth\index{Ackermann!function!growth rate}
+
+All three index entries will get a page number, such as 'Ackermann, 22'.
+LaTeX will format the second as a subitem of the first, on the line
+below it and indented, and the third as a subitem of the second. Three
+levels deep is as far as you can nest subentries. (If you add
+'\index{Ackermann!function!growth rate!comparison}' then 'makeindex'
+says 'Scanning input file test.idx....done (4 entries accepted, 1
+rejected)' and nothing appears in the index).
+
+ If you enter a second '\index' with the same INDEX-ENTRY-STRING then
+you will get a single index entry with two page numbers (unless they
+happen to fall on the same page). Thus, adding 'as for
+Ackermann.\index{Ackermann}' later in the same document as above will
+give an index entry like 'Ackermann, 22, 151'. Also, you can enter the
+index entries in any order, so for instance '\index{Ackermann!function}'
+could come before '\index{Ackermann}'.
+
+ Get a page range in the output, like 'Hilbert, 23--27', as here.
+
+ W~Ackermann (1896--1962).\index{Ackermann}
+ ...
+ D~Hilbert (1862--1943)\index{Ackermann!Hilbert\(}
+ ...
+ disapproved of his marriage.\index{Ackermann!Hilbert\)}
- The 'multind' package supports multiple indexes. See also the TeX
-FAQ entry on this topic,
-<http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind>.
+If the beginning and ending of the page range are equal then the system
+just gives a single page entry, not a range.
+
+ If you index subentries but not a main entry, as with
+'\index{Jones!program}' and '\index{Jones!results}', then the output is
+the item 'Jones' with no comma or page number, followed by two subitems,
+like 'program, 50' and 'results, 51'.
+
+ Generate a index entry that says 'See' by using a vertical bar
+character: '\index{Ackermann!function|see{P\'eter's function}}'. You
+can instead get 'See also' with 'seealso'. (The text 'See' is defined
+by '\seename', and 'See also' by '\alsoname'. You can redefine these
+either by using an internationalization package such as 'babel' or
+'polyglossia', or directly as with '\renewcommand{\alsoname}[1]{Also see
+#1}'.)
+
+ The 'See' feature is part of a more general functionality. After the
+vertical bar you can put the name of a one-input command, as in
+'\index{group|textit}' (note the missing backslash on the '\textit'
+command) and the system will apply that command to the page number, here
+giving something like '\textit{7}'. You can define your own one-input
+commands, such as '\newcommand{\definedpage}[1]{{\color{blue}#1}}' and
+then '\index{Ackermann!function|definedpage}' will give a blue page
+number (*note Color::). Another, less practical, example is this,
+
+ \newcommand\indexownpage[1]{#1, \thepage}
+ ... Epimenides.\index{self-reference|indexownpage}
+
+which creates an entry citing the page number of its own index listing.
+
+ The two functions just described combine, as here
+
+ \index{Ackermann!function|(definedpage}
+ ...
+ \index{Ackermann!function|)}
+
+which outputs an index entry like 'function, 23--27' where the page
+number range is in blue.
+
+ Consider an index entry such as 'U+03B1-ring'. Entering it as
+'$\alpha$-ring' will cause it to be alphabetized according to the dollar
+sign. You can instead enter it using an at-sign, as
+'\index{alpha-ring@$\alpha$-ring}'. If you specify an entry with an
+at-sign separating two strings, 'POS@TEXT', then POS gives the
+alphabetical position of the entry while TEXT produces the text of the
+entry. Another example is that '\index{Saint Michael's College@SMC}'
+produces an index entry 'SMC' alphabetized into a different location
+than its spelling would naturally give it.
+
+ To put a '!', or '@', or '|' character in an index entry, preceding
+it with a double quote, '"'. (The double quote gets deleted before
+alphabetization.)
+
+ A number of packages on CTAN have additional functionality beyond
+that provided by 'makeidx'. One is 'index', which allows for multiple
+indices and contains a command '\index*{INDEX-ENTRY-STRING}' that prints
+the INDEX-ENTRY-STRING as well as indexing it.
+
+ The '\index' command writes the indexing information to the file
+'ROOT-NAME.idx' file. Specifically, it writes text of the command
+'\indexentry{INDEX-ENTRY-STRING}{PAGE-NUM}', where where PAGE-NUM is the
+value of the '\thepage' counter. On occasion, when the '\printindex'
+command is confused, you have to delete this file to start with a fresh
+slate.
+
+ If you omit the closing brace of an '\index' command then you get a
+message like this.
+
+ Runaway argument? {Ackermann!function
+ ! Paragraph ended before \@wrindex was complete.
+
+25.2.2 'makeindex'
+------------------
+
+Synopsis, one of:
+
+ makeindex FILENAME
+ makeindex -s STYLE-FILE FILENAME
+ makeindex OPTIONS FILENAME0 ...
+
+ Sort, and otherwise process, the index information in the auxiliary
+file FILENAME. This is a command line program. It takes one or more
+raw index files, 'FILENAME.idx' files, and produces the actual index
+file, the 'FILENAME.ind' file that is input by '\printindex' (*note
+\printindex::).
+
+ The first form of the command suffices for many uses. The second
+allows you to format the index by using an "index style file", a '.isty'
+file. The third form is the most general; see the full documentation on
+CTAN.
+
+ This is a simple '.isty' file.
+
+ % book.isty
+ % $ makeindex -s book.isty -p odd book.idx
+ % creates the index as book.ind, starting on an odd page.
+ preamble
+ "\\pagestyle{empty}
+ \\small
+ \\begin{theindex}
+ \\thispagestyle{empty}"
+
+ postamble
+ "\n
+ \\end{theindex}"
+
+ The description here covers only some of the index formatting
+possibilities in STYLE-FILE. For a full list see the documentation on
+CTAN.
+
+ A style file consists of a list of pairs: SPECIFIER and ATTRIBUTE.
+These can appear in the file in any order. All of the ATTRIBUTES are
+strings, except where noted. Strings are surrounded with double quotes,
+'"', and the maximum length of a string is 144 characters. The '\n' is
+for a newline and '\t' is for a tab. Backslashes are escaped with
+another backslash, '\\'. If a line begins with a percent sign, '%',
+then it is a comment.
+
+'preamble'
+ Preamble of the output file. Defines the context in which the
+ index is formatted. Default: '"\\begin{theindex}\n"'.
+
+'postamble'
+ Postamble of the output file. Default: '"\n\n\\end{theindex}\n"'.
+
+'group_skip'
+ Traditionally index items are broken into groups, typically a group
+ for entries starting with 'a', etc. This specifier gives what is
+ inserted when a new group begins. Default: '"\n\n \\indexspace\n"'
+ ('\indexspace' is a rubber length with default value '10pt plus5pt
+ minus3pt').
+
+'lethead_flag'
+ An integer. It governs what is inserted for a new group or letter.
+ If it is 0 (which is the default) then other than 'group_skip'
+ nothing will be inserted before the group. If it is is positive
+ then at a new letter the 'lethead_prefix' and 'lethead_suffix' will
+ be inserted, with that letter in uppercase between them. If it is
+ negative then what will be inserted is the letter in lowercase.
+ The default is 0.
+
+'lethead_prefix'
+ If a new group begins with a different letter then this is the
+ prefix inserted before the new letter header. Default: '""'
+
+'lethead_suffix'
+ If a group begins with a different letter then this is the suffix
+ inserted after the new letter header. Default: '""'.
+
+'item_0'
+ What is put between two level 0 items. Default: '"\n \\item "'.
+
+'item_1'
+ Put between two level 1 items. Default: '"\n \\subitem "'.
+
+'item_2'
+ put between two level 2 items. Default: '"\n \\subsubitem "'.
+
+'item_01'
+ What is put between a level 0 item and a level 1 item. Default:
+ '"\n \\subitem "'.
+
+'item_x1'
+ What is put between a level 0 item and a level 1 item in the case
+ that the level 0 item doesn't have any page numbers (as in
+ '\index{aaa|see{bbb}}'). Default: '"\n \\subitem "'.
+
+'item_12'
+ What is put between a level 1 item and a level 2 item. Default:
+ '"\n \\subsubitem "'.
+
+'item_x2'
+ What is put between a level 1 item and a level 2 item, if the
+ level 1 item doesn't have page numbers. Default: '"\n \\subsubitem
+ "'.
+
+'delim_0'
+ Delimiter put between a level 0 key and its first page number.
+ Default: a comma followed by a blank, '", "'.
+
+'delim_1'
+ Delimiter put between a level 1 key and its first page number.
+ Default: a comma followed by a blank, '", "'.
+
+'delim_2'
+ Delimiter between a level 2 key and its first page number.
+ Default: a comma followed by a blank, '", "'.
+
+'delim_n'
+ Delimiter between two page numbers for the same key (at any level).
+ Default: a comma followed by a blank, '", "'.
+
+'delim_r'
+ What is put between the starting and ending page numbers of a
+ range. Default: '"--"'.
+
+'line_max'
+ An integer. Maximum length of an index entry's line in the output,
+ beyond which the line wraps. Default: '72'.
+
+'indent_space'
+ What is inserted at the start of a wrapped line. Default:
+ '"\t\t"'.
+
+'indent_length'
+ A number. The length of the wrapped line indentation. The default
+ 'indent_space' is two tabs and each tab is eight spaces so the
+ default here is '16'.
+
+'page_precedence'
+ A document may have pages numbered in different ways. For example,
+ a book may have front matter pages numbered in lowercase roman
+ while main matter pages are in arabic. This string specifies the
+ order in which they will appear in the index. The 'makeindex'
+ command supports five different types of numerals: lowercase roman
+ 'r', and numeric or arabic 'n', and lowercase alphabetic 'a', and
+ uppercase roman 'R', and uppercase alphabetic 'A'. Default:
+ '"rnaRA"'.
+
+ There are a number of other programs that do the job 'makeindex'
+does. One is 'xindy', which does internationalization and can process
+indexes for documents marked up using LaTeX and a number of other
+languages. It is is highly configurable, both in markup terms and in
+terms of the collating order of the text. See the documentation on
+CTAN.
+
+25.2.3 '\printindex'
+--------------------
+
+Synopsis:
+
+ \printindex
+
+ Place the index into the output.
+
+ To get an index you must first include
+'\usepackage{makeidx}\makeindex' in the document preamble and compile
+the document, then run the system command 'makeindex', and then compile
+the document again. *Note Indexes:: for further discussion and an
+example of the use of '\printindex'.
+
+25.3 Glossaries
+===============
+
+Synopsis:
+
+ \usepackage{glossaries} \makeglossaries
+ ...
+ \newglossaryentry{LABEL}{SETTINGS}
+ ...
+ \gls{LABEL}.
+ ...
+ \printglossaries
+
+ The 'glossaries' package allows you to make glossaries, including
+multiple glossaries, as well as lists of acronyms.
+
+ To get the output from this example, compile the document (for
+instance with 'pdflatex filename'), then run the command line command
+'makeglossaries filename', and then compile the document again.
+
+ \documentclass{...}
+ \usepackage{glossaries} \makeglossaries
+ \newglossaryentry{tm}{%
+ name={Turing machine},
+ description={A model of a machine that computes. The model is simple
+ but can compute anything any existing device can compute.
+ It is the standard model used in Computer Science.},
+ }
+ \begin{document}
+ Everything begins with the definition of a \gls{tm}.
+ ...
+ \printglossaries
+ \end{document}
+
+That gives two things. In the main text it outputs '... definition of a
+Turing machine'. In addition, in a separate sectional unit headed
+'Glossary' there appears a description list. In boldface it says
+'Turing machine' and the rest of the item says in normal type 'A model
+of a machine ... Computer Science'.
+
+ The command '\makeglossary' opens the file that will contain the
+entry information, 'ROOT-FILE.glo'. Put the '\printglossaries' command
+where you want the glossaries to appear in your document.
+
+ The 'glossaries' package is very powerful. For instance, besides the
+commands '\newglossaryentry' and '\gls', there are similar commands for
+a list of acronyms. See the package documentations on CTAN.
+
+25.3.1 '\newglossaryentry'
+--------------------------
+
+Synopsis, one of:
+
+ \newglossaryentry{LABEL}
+ {
+ name={NAME},
+ description={DESCRIPTION},
+ OTHER OPTIONS, ...
+ }
+
+ or
+
+ \longnewglossaryentry{LABEL}
+ {
+ name={NAME},
+ OTHER OPTIONS ...,
+ }
+ {DESCRIPTION}
+
+ Declare a new entry for a glossary. The LABEL must be unique for the
+document. The settings associated with the label are pairs:
+'KEY=VALUE'.
+
+ This puts the blackboard bold symbol for the real numbers U+211D in
+the glossary.
+
+ \newglossaryentry{R}
+ {
+ name={\ensuremath{\mathbb{R}}},
+ description={the real numbers},
+ }
+
+ Use the second command form if the DESCRIPTION spans more than one
+paragraph.
+
+ For a full list of KEYs see the package documentation on CTAN but
+here are a few.
+
+'name'
+ (Required.) The word, phrase, or symbol that you are defining.
+
+'description'
+ (Required.) The description that will appear in the glossary. If
+ this has more than one paragraph then you must use the second
+ command form given in the synopsis.
+
+'plural'
+ The plural form of NAME. Refer to the plural form using '\glspl'
+ or '\Glspl' (*note \gls::).
+
+'sort'
+ How to place this entry in the list of entries that the glossary
+ holds.
+
+'symbol'
+ A symbol, such as a mathematical symbol, besides the name.
+
+25.3.2 '\gls'
+-------------
+
+Synopsis, one of:
+
+ \gls{LABEL}
+ \glspl{LABEL}
+ \Gls{LABEL}
+ \Glspl{LABEL}
+
+ Refer to a glossary entry. The entries are declared with
+'\newglossaryentry' (*note \newglossaryentry::).
+
+ This
+
+ \newglossaryentry{N}{%
+ name={the natural numbers},
+ description={The numbers $0$, $1$, $2$, $\ldots$\@},
+ symbol={\ensuremath{\mathbb{N}}},
+ }
+ ...
+ Consider \gls{N}.
+
+gives the output 'Consider the natural numbers'.
+
+ The second command form '\glspl{LABEL}' produces the plural of NAME
+(by default it tries adding an 's'). The third form capitalizes the
+first letter of NAME, as does the fourth form, which also takes the
+plural.
26 Letters
**********
@@ -9372,7 +13260,7 @@ FAQ entry on this topic,
Synopsis:
\documentclass{letter}
- \address{SENDER ADDRESS}
+ \address{SENDERS ADDRESS} % return address
\signature{SENDER NAME}
\begin{document}
\begin{letter}{RECIPIENT ADDRESS}
@@ -9380,18 +13268,17 @@ Synopsis:
LETTER BODY
\closing{CLOSING TEXT}
\end{letter}
- ... more letters ...
+ ...
\end{document}
Produce one or more letters.
Each letter is in a separate 'letter' environment, whose argument
RECIPIENT ADDRESS often contains multiple lines separated with a double
-backslash ('\\'). For example, you might have:
+backslash, ('\\'). For example, you might have:
- \begin{letter}{Mr. Joe Smith \\
- 2345 Princess St. \\
- Edinburgh, EH1 1AA}
+ \begin{letter}{Ninon de l'Enclos \\
+ l'h\^otel Sagonne}
...
\end{letter}
@@ -9403,7 +13290,7 @@ whether there is one or more, so these are best put in the preamble. As
with the recipient address, often SENDER ADDRESS contains multiple lines
separated by a double backslash ('\\'). LaTeX will put the SENDER NAME
under the closing, after a vertical space for the traditional
-hand-written signature; it also can contain multiple lines.
+hand-written signature.
Each 'letter' environment body begins with a required '\opening'
command such as '\opening{Dear Madam or Sir:}'. The LETTER BODY text is
@@ -9417,13 +13304,13 @@ is receiving a copy of the letter with a command like '\cc{the Boss \\
the Boss's Boss}'. There's a similar '\encl' command for a list of
enclosures. And, you can add a postscript with '\ps'.
- LaTeX's default is to indent the signature and the '\closing' above
-it by a length of '\longindentation'. By default this is
-'0.5\textwidth'. To make them flush left, put
-'\setlength{\longindentation}{0em}' in your preamble.
+ LaTeX's default is to indent the sender name and the closing above it
+by a length of '\longindentation'. By default this is '0.5\textwidth'.
+To make them flush left, put '\setlength{\longindentation}{0em}' in your
+preamble.
To set a fixed date use something like
-'\renewcommand{\today}{2015-Oct-12}'. If put in your preamble then it
+'\renewcommand{\today}{1958-Oct-12}'. If put in your preamble then it
will apply to all the letters.
This example shows only one 'letter' environment. The three lines
@@ -9452,19 +13339,18 @@ Synopsis:
\address{SENDERS ADDRESS}
- Specifies the return address as it appears on the letter and on the
+ Specify the return address, as it appears on the letter and on the
envelope. Separate multiple lines in SENDERS ADDRESS with a double
-backslash '\\'.
+backslash, '\\'.
Because it can apply to multiple letters this declaration is often
put in the preamble. However, it can go anywhere, including inside an
individual 'letter' environment.
- This command is optional: without the '\address' declaration the
-letter is formatted with some blank space on top, for copying onto
-pre-printed letterhead paper. (*Note Overview::, for details on your
-local implementation.) With the '\address' declaration, it is formatted
-as a personal letter.
+ This command is optional: if you do not use it then the letter is
+formatted with some blank space on top, for copying onto pre-printed
+letterhead paper. If you do use the '\address' declaration then it is
+formatted as a personal letter.
Here is an example.
@@ -9476,13 +13362,13 @@ as a personal letter.
Synopsis:
- \cc{FIRST NAME \\
+ \cc{NAME0 \\
... }
Produce a list of names to which copies of the letter were sent.
This command is optional. If it appears then typically it comes after
-'\closing'. Separate multiple lines with a double backslash '\\', as
-in:
+'\closing'. Put the names on different lines by separating them with a
+double backslash, '\\', as in:
\cc{President \\
Vice President}
@@ -9494,8 +13380,9 @@ Synopsis:
\closing{TEXT}
- Usually at the end of a letter, above the handwritten signature,
-there is a '\closing' (although this command is optional). For example,
+ Produce the letter's closing. This is optional, but usual. It
+appears at the end of a letter, above a handwritten signature. For
+example:
\closing{Regards,}
@@ -9509,10 +13396,10 @@ Synopsis:
Produce a list of things included with the letter. This command is
optional; when it is used, it typically is put after '\closing'.
-Separate multiple lines with a double backslash '\\'.
+Separate multiple lines with a double backslash, '\\'.
\encl{License \\
- Passport }
+ Passport}
26.5 '\location'
================
@@ -9521,30 +13408,65 @@ Synopsis:
\location{TEXT}
- The TEXT appears centered at the bottom of the each page. It only
-appears if the page style is 'firstpage'.
+ The TEXT appears centered at the bottom of the page. It only appears
+if the page style is 'firstpage'.
26.6 '\makelabels'
==================
Synopsis:
- \makelabels
+ \makelabels % in preamble
- Create a sheet of address labels from the recipient addresses, one
-for each letter. This sheet will be output before the letters, with the
-idea that you can copy it to a sheet of peel-off labels. This command
-goes in the preamble.
+ Optional, for a document that contains 'letter' environments. If you
+just put '\makelabels' in the preamble then at the end of the document
+you will get a sheet with labels for all the recipients, one for each
+letter environment, that you can copy to a sheet of peel-off address
+labels.
Customize the labels by redefining the commands '\startlabels',
-'\mlabel', and '\returnaddress' in the preamble. The command
-'\startlabels' sets the width, height, number of columns, etc., of the
-page onto which the labels are printed. The command '\mlabel{SENDER
-ADDRESS}{RECIPIENT ADDRESS}' produces the two labels (or one, if you
-choose to ignore the SENDER ADDRESS). The SENDER ADDRESS is the value
-returned by the macro '\returnaddress' while RECIPIENT ADDRESS is the
-value passed in the argument to the 'letter' environment. By default
-'\mlabel' ignores the first argument, the SENDER ADDRESS.
+'\mlabel', and '\returnaddress' (and perhaps '\name') in the preamble.
+The command '\startlabels' sets the width, height, number of columns,
+etc., of the page onto which the labels are printed. The command
+'\mlabel{RETURN ADDRESS}{RECIPIENT ADDRESS}' produces the two labels (or
+one, if you choose to ignore the RETURN ADDRESS) for each letter
+environment. The first argument, RETURN ADDRESS, is the value returned
+by the macro '\returnaddress'. The second argument, RECIPIENT ADDRESS,
+is the value passed in the argument to the 'letter' environment. By
+default '\mlabel' ignores the first argument, the RETURN ADDRESS,
+causing the default behavior described in the prior paragraph.
+
+ This illustrates customization. Its output includes a page with two
+columns having two labels each.
+
+ \documentclass{letter}
+ \renewcommand*{\returnaddress}{Fred McGuilicuddy \\
+ Oshkosh, Mineola 12305}
+ \newcommand*\originalMlabel{}
+ \let\originalMlabel\mlabel
+ \def\mlabel#1#2{\originalMlabel{}{#1}\originalMlabel{}{#2}}
+ \makelabels
+ ...
+ \begin{document}
+ \begin{letter}{A Einstein \\
+ 112 Mercer Street \\
+ Princeton, New Jersey, USA 08540}
+ ...
+ \end{letter}
+ \begin{letter}{K G\"odel \\
+ 145 Linden Lane \\
+ Princeton, New Jersey, USA 08540}
+ ...
+ \end{letter}
+ \end{document}
+
+The first column contains the return address twice. The second column
+contains the address for each recipient.
+
+ The package 'envlab' makes formatting the labels easier, with
+standard sizes already provided. The preamble lines
+'\usepackage[personalenvelope]{envlab}' and '\makelabels' are all that
+you need to print envelopes.
26.7 '\name'
============
@@ -9553,19 +13475,18 @@ Synopsis:
\name{NAME}
- Sender's name, used for printing on the envelope together with the
-return address.
+ Optional. Sender's name, used for printing on the envelope together
+with the return address.
26.8 '\opening'
===============
Synopsis:
- \opening{TEXT}
+ \opening{SALUTATION}
- This command is required. It starts a letter, following the
-'\begin{letter}{...}'. The mandatory argument TEXT is the text that
-starts your letter. For instance:
+ Required. Follows the '\begin{letter}{...}'. The argument
+SALUTATION is mandatory. For instance:
\opening{Dear John:}
@@ -9592,23 +13513,29 @@ Synopsis:
The sender's name. This command is optional, although its inclusion
is usual.
- The argument text appears at the end of the letter, after the closing
-and after a vertical space for the traditional hand-written signature.
-Separate multiple lines with a double backslash '\\'. For example:
+ The argument text appears at the end of the letter, after the
+closing. LaTeX leaves some vertical space for a handwritten signature.
+Separate multiple lines with a double backslash, '\\'. For example:
\signature{J Fred Muggs \\
White House}
LaTeX's default for the vertical space from the '\closing' text down
-to the '\signature' text is '6\medskipamount', which is six times 0.7em.
+to the '\signature' text is '6\medskipamount', which is six times
+'\medskipamount' (where '\medskipamount' is equal to a '\parskip', which
+in turn is defined by default here to 0.7em).
This command is usually in the preamble, to apply to all the letters
in the document. To have it apply to one letter only, put it inside a
'letter' environment and before the '\closing'.
- You can include a graphic in the signature, for instance with
-'\signature{\vspace{-6\medskipamount}\includegraphics{sig.png}\\ My
-name}' (this requires writing '\usepackage{graphicx}' in the preamble).
+ You can include a graphic in the signature as here.
+
+ \signature{\vspace{-6\medskipamount}\includegraphics{sig.png}\\
+ My name}
+
+For this you must put '\usepackage{graphicx}' in the preamble (*note
+Graphics::).
26.11 '\telephone'
==================
@@ -9625,56 +13552,291 @@ page.
27 Terminal input/output
************************
-27.1 '\typein[CMD]{MSG}'
-========================
+27.1 '\typein'
+==============
-Synopsis:
+Synopsis, one of:
- \typein[\CMD]{MSG}
+ \typein{PROMPT-MSG}
+ \typein[CMD]{PROMPT-MSG}
- '\typein' prints MSG on the terminal and causes LaTeX to stop and
-wait for you to type a line of input, ending with return. If the
-optional '\CMD' argument is omitted, the typed input is processed as if
-it had been included in the input file in place of the '\typein'
-command. If the '\CMD' argument is present, it must be a command name.
-This command name is then defined or redefined to be the typed input.
+ Print PROMPT-MSG on the terminal and cause LaTeX to stop and wait for
+you to type a line of input. This line of input ends when you hit the
+return key.
-27.2 '\typeout{MSG}'
-====================
+ For example, this
+
+ As long as I live I shall never forget \typein{Enter student name:}
+
+coupled with this command line interaction
+
+ Enter student name:
+
+ \@typein=Aphra Behn
+
+gives the output '... never forget Aphra Behn'.
+
+ The first command version, '\typein{PROMPT-MSG}', causes the input
+you typed to be processed as if it had been included in the input file
+in place of the '\typein' command.
+
+ In the second command version the optional argument 'CMD' argument
+must be a command name -- it must begin with a backslash, \. This
+command name is then defined or redefined to be the input that you
+typed. For example, this
+
+ \typein[\student]{Enter student name:}
+ \typeout{Recommendation for \student .}
+
+gives this output on the command line,
+
+ Enter student name:
+
+ \student=John Dee
+ Recommendation for John Dee.
+
+where the user has entered 'John Dee.'
+
+27.2 '\typeout'
+===============
Synopsis:
\typeout{MSG}
- Prints 'msg' on the terminal and in the 'log' file. Commands in
-'msg' that are defined with '\newcommand' or '\renewcommand' (among
-others) are replaced by their definitions before being printed.
+ Print 'msg' on the terminal and in the 'log' file.
+
+ This
+
+ \newcommand{\student}{John Dee}
+ \typeout{Recommendation for \student .}
+
+outputs 'Recommendation for John Dee'. Like what happens here with
+'\student', commands that are defined with '\newcommand' or
+'\renewcommand' (among others) are replaced by their definitions before
+being printed.
LaTeX's usual rules for treating multiple spaces as a single space
-and ignoring spaces after a command name apply to 'msg'. A '\space'
-command in 'msg' causes a single space to be printed, independent of
-surrounding spaces. A '^^J' in 'msg' prints a newline.
+and ignoring spaces after a command name apply to 'msg'. As above, use
+the command '\space' to get a single space, independent of surrounding
+spaces. Use '^^J' to get a newline. Get a percent character with
+'\csname @percentchar\endcsname'.
+
+ This command can be useful for simple debugging, as here:
+
+ \newlength{\jhlength}
+ \setlength{\jhlength}{5pt}
+ \typeout{The length is \the\jhlength.}
+
+produces on the command line 'The length is 5.0pt'.
28 Command line
***************
-The input file specification indicates the file to be formatted; TeX
-uses '.tex' as a default file extension. If you omit the input file
-entirely, TeX accepts input from the terminal. You can also specify
-arbitrary LaTeX input by starting with a backslash. For example, this
-processes 'foo.tex' without pausing after every error:
+Synopsis (from a terminal command line):
+
+ pdflatex OPTIONS ARGUMENT
+
+ Run LaTeX on ARGUMENT. In place of 'pdflatex' you can also use
+'xelatex', or 'lualatex', or 'dviluatex', or 'latex'.
+
+ For example, this will run LaTeX on the file 'thesis.tex', creating
+the output 'thesis.pdf'.
+
+ pdflatex thesis
+
+Note that '.tex' is the default file extension.
+
+ pdfTeX is a development of the original TeX program, as are XeTeX and
+LuaTeX (*note TeX engines::). They are completely backward compatible.
+But the original program had a custom output format, DVI, while the
+newer ones can output directly to PDF. This allows them to take
+advantage of the extra features in PDF such as hyperlinks, support for
+modern image formats such as JPG and PNG, and ubiquitous viewing
+programs. In short, if you run 'pdflatex' or 'xelatex' or 'lualatex'
+then you will by default get PDF and have access to all its modern
+features. If you run 'latex', or 'dvilualatex', then you will get DVI.
+The description here assumes pdfLaTeX.
+
+ *Note Command line options::, for a selection of the most useful
+command line options. As to ARGUMENT, the usual case is that it does
+not begin with a backslash, so the system takes it to be the name of a
+file and it compiles that file. If ARGUMENT begins with a backslash
+then the system will interpret it as a line of LaTeX input, which can be
+used for special effects (*note Command line input::).
+
+ If you gave no arguments or options then 'pdflatex' prompts for input
+from the terminal. You can escape from this by entering '<control>-D'.
+
+ If LaTeX finds an error in your document then by default it stops and
+asks you about it. *Note Recovering from errors:: for an outline of
+what to do.
+
+28.1 Command line options
+=========================
+
+These are the command-line options relevant to ordinary document
+authoring. For a full list, try running 'latex --help' from the command
+line.
+
+ With many implementations you can specify command line options by
+prefixing them with '-' or '--'. This is the case for both TeX Live
+(and MacTeX) and MiKTeX. We will use both conventions interchangeably.
+
+'-version'
+ Show the current version, like 'pdfTeX 3.14159265-2.6-1.40.16 (TeX
+ Live 2015/Debian)' along with a small amount of additional
+ information, and exit.
+
+'-help'
+ Give a brief usage message that is useful as a prompt and exit.
+
+'-interaction=MODE'
+ TeX compiles a document in one of four interaction modes:
+ 'batchmode', 'nonstopmode', 'scrollmode', 'errorstopmode'. In
+ "errorstop mode" (the default), TeX stops at each error and asks
+ for user intervention. In "batch mode" it prints nothing on the
+ terminal, errors are scrolled as if the user hit '<return>' at
+ every error, and missing files cause the job to abort. In "nonstop
+ mode", diagnostic message appear on the terminal but as in batch
+ mode there is no user interaction. In "scroll mode", TeX only
+ stops for missing files or keyboard input.
+
+ For instance, starting LaTeX with this command line
+
+ pdflatex -interaction=batchmode FILENAME
+
+ eliminates most terminal output.
+
+'-jobname=STRING'
+ Set the value of TeX's 'jobname' to the string. The log file and
+ output file will then be named 'STRING.log' and 'STRING.pdf'.
+
+ When you run 'pdflatex OPTIONS ARGUMENT', if ARGUMENT does not
+ start with a backslash then TeX considers it the name of a file to
+ input. Otherwise it waits for the first '\input' instruction and
+ the name of the input file will be the job name. This is used to
+ name the log file the output file. This option overrides that
+ process and directly specifies the name. *Note Command line
+ input:: for an example of its use.
+
+'-output-directory=DIRECTORY'
+ Write files in the directory DIRECTORY. It must already exist.
+
+'shell-escape'
+'no-shell-escape'
+'enable-write18'
+'disable-write18'
+ Enable or disable '\write18{SHELL COMMAND}'. The first two options
+ are for with TeX Live or MacTeX while the second two are for
+ MiKTeX.
+
+ Sometimes you want to run external system commands from inside a
+ LaTeX file. For instance the package 'sagetex' allows you to have
+ the mathematics software system Sage do calculations or draw graphs
+ and then incorporate that output in your document. For this TeX
+ provides the '\write18' command.
+
+ But with this functionality enabled, security issues could happen
+ if you compiled a LaTeX file from the Internet. By default
+ '\write18' is disabled. (More precisely, by default TeX Live,
+ MacTeX, and MiKTeX only allow the execution of a limited number of
+ TeX-related programs, which they distribute.)
+
+ If you invoke LaTeX with the option 'no-shell-escape', and in your
+ document you call '\write18{ls -l}', then you do not get an error
+ but the log file says 'runsystem(ls -l)...disabled'.
+
+'-halt-on-error'
+ Stop processing at the first error.
+
+'-file-line-error'
+'-no-file-line-error'
+ Enable or disable 'FILENAME:LINENO:ERROR'-style error messages.
+ These are only available with TeX Live or MacTeX.
+
+28.2 Command line input
+=======================
+
+As part of the command line invocation 'pdflatex OPTIONS ARGUMENT' you
+can specify arbitrary LaTeX input by starting ARGUMENT with a backslash.
+This allows you to do some special effects.
+
+ For example, this file (which uses the 'hyperref' package for
+hyperlinks) can produce two kinds of output, one for paper and one for a
+PDF.
+
+ \ifdefined\paperversion % in preamble
+ \newcommand{\urlcolor}{black}
+ \else
+ \newcommand{\urlcolor}{blue}
+ \fi
+ \usepackage[colorlinks=true,urlcolor=\urlcolor]{hyperref}
+ ...
+ \href{https://www.ctan.org}{CTAN} % in body
+ ...
+
+Compiling this document 'book.tex' with the command line 'pdflatex test'
+will give the 'CTAN' link in blue. But compiling it with 'pdflatex
+"\def\paperversion{}\input test.tex"' has the link in black. (Note the
+use of double quotes to prevent interpretation of the symbols by the
+command line shell; your system may do this differently.)
+
+ In a similar way, from the single file 'main.tex' you can compile two
+different versions.
+
+ pdflatex -jobname=students "\def\student{}\input{main}"
+ pdflatex -jobname=teachers "\def\teachers{}\input{main}"
+
+The 'jobname' option is there because otherwise both files would be
+called 'main.pdf' and the second would overwrite the first.
+
+ A final example. This loads the package 'graphicx' with the option
+'draft'
+
+ pdflatex -jobname=aa "\RequirePackage[draft]{graphicx}\input{aa.tex}"
- latex '\nonstopmode\input foo.tex'
+so the graphic files are read for their size information but not
+incorporated into the PDF. (The 'jobname' option is needed because
+otherwise the output file would be 'graphicx.pdf', as '\RequirePackage'
+does an '\input' of its own.)
- With many, but not all, implementations, command-line options can
-also be specified in the usual Unix way, starting with '-' or '--'. For
-a list of those options, try 'latex --help'.
+28.3 Recovering from errors
+===========================
+
+If LaTeX finds an error in your document then it gives you an error
+message and prompts you with a question mark, '?'. For instance,
+running LaTeX on this file
+
+ \newcommand{\NP}{\ensuremath{\textbf{NP}}}
+ The \PN{} problem is a million dollar one.
+
+causes it show this, and wait for input.
+
+ ! Undefined control sequence.
+ l.5 The \PN
+ {} problem is a million dollar one.
+ ?
+
+The simplest thing is to enter 'x' and '<return>' and fix the typo. You
+could instead enter '?' and '<return>' to see other options.
+
+ There are two other error scenarios. The first is that you forgot to
+include the '\end{document}' or misspelled it. In this case LaTeX gives
+you a '*' prompt. You can get back to the command line by typing
+'\stop' and '<return>'.
+
+ The last scenario is that you mistyped the file name. For instance,
+instead of 'pdflatex test' you might type 'pdflatex tste'.
- If LaTeX stops in the middle of the document and gives you a '*'
-prompt, it is waiting for input. You can type '\stop' (and return) and
-it will prematurely end the document.
+ ! I can't find file `tste'.
+ <*> tste
- *Note TeX engines::, for other system commands invoking LaTeX.
+ (Press Enter to retry, or Control-D to exit)
+ Please type another input file name:
+
+The simplest thing is to enter '<Contol>' and 'd' (holding them down at
+the same time), and just fix the command line.
Appendix A Document templates
*****************************
@@ -9714,9 +13876,32 @@ features, but here is a basic template:
One web resource for this:
<http://robjhyndman.com/hyndsight/beamer/>.
-A.2 'book' template
+A.2 'article' template
+======================
+
+\documentclass{article}
+\title{Article Class Template}
+\author{Alex Author}
+
+\begin{document}
+\maketitle
+
+\section{First section}
+Some text.
+
+\subsection{First section, first subsection}
+Additional text.
+
+\section{Second section}
+Some more text.
+\end{document}
+
+A.3 'book' template
===================
+This is a straightforward template for a book. See *Note Larger book
+template:: for a more elaborate one.
+
\documentclass{book}
\title{Book Class Template}
\author{Alex Author}
@@ -9734,7 +13919,57 @@ Some other text.
The end.
\end{document}
-A.3 'tugboat' template
+A.4 Larger 'book' template
+==========================
+
+This is a more elaborate template for a book. It has '\frontmatter',
+'\mainmatter', and '\backmatter' to control the typography of the three
+main areas of a book (*note \frontmatter & \mainmatter & \backmatter::).
+The book has a bibliography and an index.
+
+ Notable is that it uses '\include' and '\includeonly' (*note
+Splitting the input::). While you are working on a chapter you can
+comment out all the other chapter entries from the argument to
+'\includeonly'. That will speed up compilation without losing any
+information such as cross-references. (Material that does not need to
+come on a new page is brought in with '\input' instead of '\include'.
+You don't get the cross-reference benefit this way.)
+
+\documentclass[titlepage]{book}
+\usepackage{makeidx}\makeindex
+
+\title{Book Class Template}
+\author{Alex Author}
+
+\includeonly{%
+ frontcover,
+ preface,
+ chap1,
+ ...
+ }
+\begin{document}
+\frontmatter
+\include{frontcover}
+ % maybe comment out while drafting:
+\maketitle \input{dedication} \input{copyright}
+\tableofcontents
+\include{preface}
+\mainmatter
+\include{chap1}
+...
+\appendix
+\include{appena}
+...
+\backmatter
+\bibliographystyle{apalike}
+\addcontentsline{toc}{chapter}{Bibliography}
+\bibliography
+\addcontentsline{toc}{chapter}{Index}
+\printindex
+\include{backcover}
+\end{document}
+
+A.5 'tugboat' template
======================
'TUGboat' is the journal of the TeX Users Group,
@@ -9820,2162 +14055,2566 @@ Email \verb|tugboat@tug.org| if problems or questions.
\makesignature
\end{document}
-Concept Index
-*************
+Index
+*****
* Menu:
-* * prompt: Command line. (line 9743)
+* &: tabular. (line 5037)
+* * prompt: Recovering from errors.
+ (line 13911)
* *-form of environment commands: \newenvironment & \renewenvironment.
- (line 5102)
-* *-form of sectioning commands: Sectioning. (line 1997)
+ (line 6754)
+* *-form of sectioning commands: Sectioning. (line 2077)
* *-form, defining new commands: \newcommand & \renewcommand.
- (line 4942)
-* .glo file: Glossaries. (line 9386)
-* .idx file: Indexes. (line 9402)
-* .ind file: Indexes. (line 9416)
-* 'see' and 'see also' index entries: Indexes. (line 9409)
-* abstracts: abstract. (line 2357)
-* accents: Accents. (line 9057)
-* accents, mathematical: Math accents. (line 6974)
-* accessing any character of a font: Symbols by font position.
- (line 8865)
-* acute accent: Accents. (line 9071)
-* acute accent, math: Math accents. (line 6979)
-* additional packages, loading: Additional packages.
- (line 802)
-* ae ligature: Additional Latin letters.
- (line 9163)
-* algorithm2e package: tabbing. (line 3906)
-* align environment, from amsmath: eqnarray. (line 2744)
-* aligning equations: eqnarray. (line 2744)
-* alignment via tabbing: tabbing. (line 3768)
-* amsmath package: array. (line 2437)
-* amsmath package <1>: displaymath. (line 2613)
-* amsmath package, replacing eqnarray: eqnarray. (line 2744)
-* appendix, creating: Sectioning. (line 2003)
-* aring: Additional Latin letters.
- (line 9159)
-* arrays, math: array. (line 2403)
-* arrow, left, in text: Text symbols. (line 9002)
-* arrow, right, in text: Text symbols. (line 9037)
-* ascender height: Text symbols. (line 8970)
-* ASCII circumflex, in text: Text symbols. (line 8935)
-* ASCII tilde, in text: Text symbols. (line 8938)
-* asterisk, centered, in text: Text symbols. (line 8941)
-* at clause, in font definitions: \newfont. (line 5330)
-* author, for titlepage: \maketitle. (line 7235)
-* auxiliary file: Output files. (line 416)
-* babel package: thebibliography. (line 4302)
-* babel package <1>: Accents. (line 9057)
-* background, colored: Colored pages. (line 8035)
-* backslash, in text: Text symbols. (line 8944)
-* bar, double vertical, in text: Text symbols. (line 8950)
-* bar, vertical, in text: Text symbols. (line 8947)
-* bar-over accent: Accents. (line 9080)
-* bar-over accent, math: Math accents. (line 6982)
-* bar-under accent: Accents. (line 9097)
-* basics of LaTeX: Overview. (line 335)
-* beamer template and class: beamer template. (line 9759)
-* beginning of document hook: \AtBeginDocument. (line 2645)
-* bibliography format, open: Document class options.
- (line 764)
-* bibliography, creating (automatically): Using BibTeX. (line 4358)
-* bibliography, creating (manually): thebibliography. (line 4279)
-* bibTeX, using: Using BibTeX. (line 4358)
-* big circle symbols, in text: Text symbols. (line 8953)
-* Big point: Units of length. (line 5704)
-* black boxes, omitting: Document class options.
- (line 750)
-* bold font: Font styles. (line 1289)
-* bold math: Font styles. (line 1348)
-* bold typewriter, avoiding: description. (line 2572)
-* box, allocating new: \newsavebox. (line 5079)
-* box, colored: Colored boxes. (line 7998)
-* boxes: Boxes. (line 7640)
-* brace, left, in text: Text symbols. (line 8956)
-* brace, right, in text: Text symbols. (line 8959)
-* breaking lines: Line breaking. (line 4501)
-* breaking pages: Page breaking. (line 4644)
-* breve accent: Accents. (line 9137)
-* breve accent, math: Math accents. (line 6985)
-* bug reporting: About this document.
- (line 306)
-* bullet symbol: Math symbols. (line 6079)
-* bullet, in text: Text symbols. (line 8962)
-* bulleted lists: itemize. (line 2979)
-* calligraphic letters for math: Font styles. (line 1292)
-* cap height: Text symbols. (line 8970)
-* caron accent: Accents. (line 9148)
-* catcode: \makeatletter and \makeatother.
- (line 572)
-* category code, character: \makeatletter and \makeatother.
- (line 572)
-* cc list, in letters: \cc. (line 9546)
-* cedilla accent: Accents. (line 9102)
-* centered asterisk, in text: Text symbols. (line 8941)
-* centered equations: Document class options.
- (line 754)
-* centered period, in text: Text symbols. (line 9009)
-* centering text, declaration for: \centering. (line 2512)
-* centering text, environment for: center. (line 2469)
-* Centimeter: Units of length. (line 5708)
-* character category code: \makeatletter and \makeatother.
- (line 572)
-* characters, accented: Accents. (line 9057)
-* characters, case: Upper and lower case.
- (line 8820)
-* characters, non-English: Additional Latin letters.
- (line 9153)
-* characters, reserved: Reserved characters.
- (line 8786)
-* characters, special: Reserved characters.
- (line 8786)
-* check accent: Accents. (line 9148)
-* check accent, math: Math accents. (line 6988)
-* Cicero: Units of length. (line 5717)
-* circle symbol, big, in text: Text symbols. (line 8953)
-* circled letter, in text: Text symbols. (line 8965)
-* circumflex accent: Accents. (line 9084)
-* circumflex accent, math: Math accents. (line 7000)
-* circumflex, ASCII, in text: Text symbols. (line 8935)
-* citation key: \bibitem. (line 4320)
-* class and package commands: Class and package commands.
- (line 885)
-* class and package difference: Class and package construction.
- (line 827)
-* class and package structure: Class and package structure.
- (line 841)
-* class file example: Class and package structure.
- (line 871)
-* class file layout: Class and package structure.
- (line 841)
-* class options: Document class options.
- (line 703)
-* class options <1>: Class and package structure.
- (line 841)
-* class options <2>: Class and package commands.
- (line 945)
-* classes of documents: Document classes. (line 669)
-* closing letters: \closing. (line 9562)
-* closing quote: Text symbols. (line 8926)
-* code, typesetting: verbatim. (line 4447)
-* color: Color. (line 7807)
-* color <1>: Define colors. (line 7912)
-* color <2>: Colored text. (line 7932)
-* color <3>: Colored boxes. (line 7998)
-* color <4>: Colored pages. (line 8035)
-* color models: Color models. (line 7860)
-* color package commands: Commands for color. (line 7907)
-* color package options: Color package options.
- (line 7822)
-* color, define: Define colors. (line 7912)
-* colored boxes: Colored boxes. (line 7998)
-* colored page: Colored pages. (line 8035)
-* colored text: Colored text. (line 7932)
-* command line: Command line. (line 9731)
-* command syntax: LaTeX command syntax.
- (line 486)
-* commands, class and package: Class and package commands.
- (line 885)
-* commands, defining new ones: \newcommand & \renewcommand.
- (line 4934)
-* commands, defining new ones <1>: \providecommand. (line 5025)
-* commands, document class: Class and package construction.
- (line 818)
-* commands, graphics package: Commands for graphics.
- (line 8343)
-* commands, ignore spaces: \ignorespaces & \ignorespacesafterend.
- (line 5400)
-* commands, redefining: \newcommand & \renewcommand.
- (line 4934)
-* commands, star-variants: \@ifstar. (line 609)
-* composite word mark, in text: Text symbols. (line 8970)
-* computer programs, typesetting: verbatim. (line 4447)
-* configuration, graphics package: Graphics package configuration.
- (line 8157)
-* contents file: Output files. (line 426)
-* copyright symbol: Text symbols. (line 8883)
-* counters, a list of: Counters. (line 5473)
-* counters, defining new: \newcounter. (line 5040)
-* counters, getting value of: \value. (line 5573)
-* counters, printing: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 5499)
-* counters, setting: \setcounter. (line 5602)
-* creating pictures: picture. (line 3460)
-* creating tables: table. (line 3915)
-* credit footnote: \maketitle. (line 7245)
-* cross references: Cross references. (line 2215)
-* cross references, resolving: Output files. (line 416)
-* cross referencing with page number: \pageref. (line 2297)
-* cross referencing, symbolic: \ref. (line 2318)
-* currency, dollar: Text symbols. (line 8981)
-* currency, euro: Text symbols. (line 8990)
-* dagger, double, in text: Text symbols. (line 8978)
-* dagger, in text: Text symbols. (line 8886)
-* dagger, in text <1>: Text symbols. (line 8975)
-* date, for titlepage: \maketitle. (line 7241)
-* date, today's: \today. (line 9229)
-* datetime package: \today. (line 9245)
-* define color: Define colors. (line 7912)
-* defining a new command: \newcommand & \renewcommand.
- (line 4934)
-* defining a new command <1>: \providecommand. (line 5025)
-* defining new environments: \newenvironment & \renewenvironment.
- (line 5094)
-* defining new fonts: \newfont. (line 5313)
-* defining new theorems: \newtheorem. (line 5201)
-* definitions: Definitions. (line 4929)
-* description lists, creating: description. (line 2544)
-* design size, in font definitions: \newfont. (line 5330)
-* Didot point: Units of length. (line 5714)
-* dieresis accent: Accents. (line 9067)
-* difference between class and package: Class and package construction.
- (line 827)
-* discretionary hyphenation: \discretionary. (line 4586)
-* discretionary multiplication: Math miscellany. (line 7070)
-* displaying quoted text with paragraph indentation: quotation and quote.
- (line 3732)
-* displaying quoted text without paragraph indentation: quotation and quote.
- (line 3732)
-* document class commands: Class and package construction.
- (line 818)
-* document class options: Document class options.
- (line 703)
-* document class, defined: Starting and ending.
- (line 369)
-* document classes: Document classes. (line 669)
-* document templates: Document templates. (line 9752)
-* dollar sign: Text symbols. (line 8981)
-* dot accent: Accents. (line 9076)
-* dot over accent, math: Math accents. (line 6994)
-* dot-over accent: Accents. (line 9076)
-* dot-under accent: Accents. (line 9106)
-* dotless i: Accents. (line 9114)
-* dotless i, math: Math accents. (line 7003)
-* dotless j: Accents. (line 9117)
-* dotless j, math: Math accents. (line 7006)
-* double angle quotation marks: Text symbols. (line 8901)
-* double dagger, in text: Text symbols. (line 8889)
-* double dagger, in text <1>: Text symbols. (line 8978)
-* double dot accent, math: Math accents. (line 6991)
-* double guillemets: Text symbols. (line 8901)
-* double left quote: Text symbols. (line 9015)
-* double low-9 quotation mark: Text symbols. (line 8923)
-* double quote, straight base: Text symbols. (line 9031)
-* double right quote: Text symbols. (line 9018)
-* double spacing: Low-level font commands.
- (line 1504)
-* double vertical bar, in text: Text symbols. (line 8950)
-* e-dash: Text symbols. (line 8987)
-* e-TeX: TeX engines. (line 441)
-* ellipsis: Text symbols. (line 8907)
-* em: Units of length. (line 5722)
-* em-dash: Text symbols. (line 8984)
-* em-dash, three-quarters: Text symbols. (line 9040)
-* em-dash, two-thirds: Text symbols. (line 9046)
-* emphasis: Font styles. (line 1277)
-* enclosure list: \encl. (line 9574)
-* end of document hook: \AtEndDocument. (line 2661)
-* ending and starting: Starting and ending.
- (line 361)
-* engines, TeX: TeX engines. (line 435)
-* enlarge current page: \enlargethispage. (line 4673)
-* enumitem package: list. (line 3085)
-* environment: Starting and ending.
- (line 377)
-* environment, theorem-like: \newtheorem. (line 5201)
-* environments: Environments. (line 2340)
-* environments, defining: \newenvironment & \renewenvironment.
- (line 5094)
-* EPS files: Graphics package configuration.
- (line 8157)
-* EPS files <1>: \includegraphics. (line 8349)
-* equation number, cross referencing: \ref. (line 2318)
-* equation numbers, left vs. right: Document class options.
- (line 760)
-* equation numbers, omitting: eqnarray. (line 2779)
-* equations, aligning: eqnarray. (line 2744)
-* equations, environment for: equation. (line 2800)
-* equations, flush left vs. centered: Document class options.
- (line 754)
-* es-zet German letter: Additional Latin letters.
- (line 9199)
-* eth, Icelandic letter: Additional Latin letters.
- (line 9167)
-* etoolbox package: Class and package commands.
- (line 989)
-* euro symbol: Text symbols. (line 8990)
-* ex: Units of length. (line 5722)
-* exclamation point, upside-down: Text symbols. (line 8993)
-* exponent: Subscripts & superscripts.
- (line 5938)
-* extended Latin: Additional Latin letters.
- (line 9153)
-* external files, writing: filecontents. (line 2876)
-* families, of fonts: Low-level font commands.
- (line 1407)
-* fancyvrb package: tabbing. (line 3906)
-* feminine ordinal symbol: Text symbols. (line 9006)
-* figure number, cross referencing: \ref. (line 2318)
-* figures, footnotes in: minipage. (line 3447)
-* figures, inserting: figure. (line 2823)
-* file, root: Splitting the input.
- (line 9254)
-* fixed-width font: Font styles. (line 1310)
-* flafter package: Floats. (line 1898)
-* float package: Floats. (line 1868)
-* float page: Floats. (line 1874)
-* flush left equations: Document class options.
- (line 754)
-* flushing floats and starting a page: \clearpage. (line 4660)
-* font catalogue: Low-level font commands.
- (line 1407)
-* font commands, low-level: Low-level font commands.
- (line 1392)
-* font size: Low-level font commands.
- (line 1487)
-* font sizes: Font sizes. (line 1366)
-* font styles: Font styles. (line 1224)
-* font symbols, by number: Symbols by font position.
- (line 8865)
-* fonts: Fonts. (line 1218)
-* fonts, new commands for: \newfont. (line 5313)
-* footer style: \pagestyle. (line 7280)
-* footer, parameters for: Page layout parameters.
- (line 1690)
-* footmisc package: Footnotes in section headings.
- (line 4857)
-* footnote number, cross referencing: \ref. (line 2318)
-* footnote parameters: Footnote parameters.
- (line 4913)
-* footnotes in figures: minipage. (line 3447)
-* footnotes, creating: Footnotes. (line 4706)
-* Footnotes, in a minipage: \footnote. (line 4753)
-* Footnotes, in a table: Footnotes in a table.
- (line 4807)
-* footnotes, in section headings: Footnotes in section headings.
- (line 4853)
-* footnotes, symbols instead of numbers: \footnote. (line 4741)
-* formulas, environment for: equation. (line 2800)
-* formulas, math: Math formulas. (line 5901)
-* forward reference: Cross references. (line 2231)
-* forward references, resolving: Output files. (line 416)
-* fragile commands: \protect. (line 5348)
-* French quotation marks: Text symbols. (line 8901)
-* functions, math: Math functions. (line 6866)
-* geometry package: Document class options.
- (line 737)
-* geometry package <1>: Document class options.
- (line 741)
-* global options: Document class options.
- (line 703)
-* global options <1>: Additional packages.
- (line 811)
-* glossaries: Glossaries. (line 9384)
-* glossary package: Glossaries. (line 9393)
-* glue register, plain TeX: \newlength. (line 5064)
-* graphics: Graphics. (line 8056)
-* graphics <1>: Graphics package configuration.
- (line 8157)
-* graphics <2>: \includegraphics. (line 8349)
-* graphics package: Graphics. (line 8056)
-* graphics package <1>: Graphics package configuration.
- (line 8157)
-* graphics package <2>: \includegraphics. (line 8349)
-* graphics package commands: Commands for graphics.
- (line 8343)
-* graphics package options: Graphics package options.
- (line 8093)
-* graphics packages: \line. (line 3623)
-* graphics, resizing: \scalebox. (line 8723)
-* graphics, resizing <1>: \resizebox. (line 8751)
-* graphics, scaling: \scalebox. (line 8723)
-* graphics, scaling <1>: \resizebox. (line 8751)
-* grave accent: Accents. (line 9088)
-* grave accent, math: Math accents. (line 6997)
-* greater than symbol, in text: Text symbols. (line 8996)
-* greek letters: Math symbols. (line 5971)
-* group, and environments: Environments. (line 2352)
-* ha'c<ek accent, math: Math accents. (line 6988)
-* hacek accent: Accents. (line 9148)
-* hat accent: Accents. (line 9084)
-* hat accent, math: Math accents. (line 7000)
-* header style: \pagestyle. (line 7280)
-* header, parameters for: Page layout parameters.
- (line 1690)
-* hello, world: Starting and ending.
- (line 361)
-* here, putting floats: Floats. (line 1868)
-* hungarian umlaut accent: Accents. (line 9110)
-* hyphenation, defining: \hyphenation. (line 4611)
-* hyphenation, discretionary: \discretionary. (line 4586)
-* hyphenation, forcing: \- (hyphenation). (line 4574)
-* hyphenation, preventing: \mbox. (line 7646)
-* Icelandic eth: Additional Latin letters.
- (line 9167)
-* Icelandic thorn: Additional Latin letters.
- (line 9203)
-* ij letter, Dutch: Additional Latin letters.
- (line 9179)
-* implementations of TeX: TeX engines. (line 435)
-* importing graphics: \includegraphics. (line 8349)
-* in-line formulas: math. (line 3420)
-* including graphics: \includegraphics. (line 8349)
-* indent, forcing: \indent. (line 5819)
-* indent, suppressing: \noindent. (line 5830)
-* indentation of paragraphs, in minipage: minipage. (line 3443)
-* index entries, 'see' and 'see also': Indexes. (line 9409)
-* indexes: Indexes. (line 9399)
-* infinite horizontal stretch: \hfill. (line 7355)
-* infinite vertical stretch: \vfill. (line 7584)
-* input file: Splitting the input.
- (line 9251)
-* input/output, to terminal: Terminal input/output.
- (line 9698)
-* inserting figures: figure. (line 2823)
-* insertions of special characters: Special insertions. (line 8780)
-* italic correction: \/. (line 7493)
-* italic font: Font styles. (line 1295)
-* JPEG files: Graphics package configuration.
- (line 8157)
-* JPEG files <1>: \includegraphics. (line 8349)
-* JPG files: Graphics package configuration.
- (line 8157)
-* JPG files <1>: \includegraphics. (line 8349)
-* justification, ragged left: \raggedleft. (line 2966)
-* justification, ragged right: \raggedright. (line 2940)
-* Knuth, Donald E.: Overview. (line 335)
-* label: Cross references. (line 2218)
-* labelled lists, creating: description. (line 2544)
-* Lamport TeX: Overview. (line 353)
-* Lamport, Leslie: Overview. (line 335)
-* landscape orientation: Document class options.
- (line 757)
-* LaTeX logo: Text symbols. (line 8892)
-* LaTeX overview: Overview. (line 335)
-* LaTeX Project team: About this document.
- (line 302)
-* LaTeX vs. LaTeX2e: About this document.
- (line 298)
-* LaTeX2e logo: Text symbols. (line 8895)
-* Latin letters, additional: Additional Latin letters.
- (line 9153)
-* layout commands: Layout. (line 1534)
-* layout, page parameters for: Page layout parameters.
- (line 1690)
-* left angle quotation marks: Text symbols. (line 8901)
-* left arrow, in text: Text symbols. (line 9002)
-* left brace, in text: Text symbols. (line 8956)
-* left quote: Text symbols. (line 8911)
-* left quote, double: Text symbols. (line 9015)
-* left quote, single: Text symbols. (line 9021)
-* left-hand equation numbers: Document class options.
- (line 760)
-* left-justifying text: \raggedright. (line 2940)
-* left-justifying text, environment for: flushleft. (line 2927)
-* left-to-right mode: Modes. (line 7153)
-* length command: \setlength. (line 5744)
-* lengths, adding to: \addtolength. (line 5752)
-* lengths, allocating new: \newlength. (line 5064)
-* lengths, defining and using: Lengths. (line 5662)
-* lengths, predefined: Predefined lengths. (line 5792)
-* lengths, setting: \setlength. (line 5740)
-* less than symbol, in text: Text symbols. (line 8999)
-* letters, accented: Accents. (line 9057)
-* letters, additional Latin: Additional Latin letters.
- (line 9153)
-* letters, ending: \closing. (line 9562)
-* letters, starting: \opening. (line 9632)
-* letters, writing: Letters. (line 9439)
-* line break, forcing: \\. (line 4512)
-* line breaking: Line breaking. (line 4501)
-* line breaks, forcing: \linebreak & \nolinebreak.
- (line 4627)
-* line breaks, preventing: \linebreak & \nolinebreak.
- (line 4627)
-* lines in tables: tabular. (line 3957)
-* lining numerals: Font styles. (line 1352)
-* lining text up in tables: tabular. (line 3957)
-* lining text up using tab stops: tabbing. (line 3768)
-* list items, specifying counter: \usecounter. (line 5547)
-* list of figures file: Output files. (line 426)
-* list of tables file: Output files. (line 426)
-* listings package: tabbing. (line 3906)
-* lists of items: itemize. (line 2979)
-* lists of items, generic: list. (line 3067)
-* lists of items, numbered: enumerate. (line 2677)
-* loading additional packages: Additional packages.
- (line 802)
-* log file: Output files. (line 411)
-* logo, LaTeX: Text symbols. (line 8892)
-* logo, LaTeX2e: Text symbols. (line 8895)
-* logo, TeX: Text symbols. (line 8932)
-* long command: Class and package commands.
- (line 902)
-* low-9 quotation marks, single and double: Text symbols. (line 8923)
-* low-level font commands: Low-level font commands.
- (line 1392)
-* Lower case: Upper and lower case.
- (line 8820)
-* LR mode: Modes. (line 7153)
-* ltugboat class: tugboat template. (line 9810)
-* LuaTeX: TeX engines. (line 458)
-* m-width: Units of length. (line 5722)
-* macro package, LaTeX as: Overview. (line 340)
-* macron accent: Accents. (line 9080)
-* macron accent, math: Math accents. (line 6982)
-* macros2e package: \makeatletter and \makeatother.
- (line 593)
-* Madsen, Lars: eqnarray. (line 2744)
-* makeidx package: Indexes. (line 9421)
-* makeindex program: Indexes. (line 9416)
-* making a title page: titlepage. (line 4408)
-* making paragraphs: Making paragraphs. (line 5811)
-* marginal notes: Marginal notes. (line 5851)
-* masculine ordinal symbol: Text symbols. (line 9006)
-* math accents: Math accents. (line 6974)
-* math formulas: Math formulas. (line 5901)
-* math functions: Math functions. (line 6866)
-* math miscellany: Math miscellany. (line 7069)
-* math mode: Modes. (line 7153)
-* math mode, entering: Math formulas. (line 5901)
-* math mode, spacing: Spacing in math mode.
- (line 7026)
-* math symbols: Math symbols. (line 5971)
-* math, bold: Font styles. (line 1348)
-* mfirstuc package: Upper and lower case.
- (line 8859)
-* Millimeter: Units of length. (line 5711)
-* minipage, creating a: minipage. (line 3432)
-* minted package: tabbing. (line 3906)
-* modes: Modes. (line 7153)
-* monospace font: Font styles. (line 1310)
-* moving arguments: \protect. (line 5361)
-* mpfootnote counter: \footnote. (line 4753)
-* mu, math unit: Units of length. (line 5733)
-* multicolumn text: \twocolumn. (line 1548)
-* multilingual support: Accents. (line 9057)
-* multind package: Indexes. (line 9432)
-* multiplication symbol, discretionary line break: Math miscellany.
- (line 7070)
-* nested \include, not allowed: \include. (line 9275)
-* new class commands: Class and package construction.
- (line 818)
-* new command, check: Class and package commands.
- (line 900)
-* new command, definition: Class and package commands.
- (line 975)
-* new commands, defining: \newcommand & \renewcommand.
- (line 4934)
-* new commands, defining <1>: \providecommand. (line 5025)
-* new line, output as input: \obeycr & \restorecr.
- (line 4544)
-* new line, starting: \\. (line 4512)
-* new line, starting (paragraph mode): \newline. (line 4553)
-* new page, starting: \newpage. (line 4667)
-* non-English characters: Additional Latin letters.
- (line 9153)
-* notes in the margin: Marginal notes. (line 5851)
-* null delimiter: Math miscellany. (line 7099)
-* numbered items, specifying counter: \usecounter. (line 5547)
-* numerals, old-style: Font styles. (line 1352)
-* oblique font: Font styles. (line 1307)
-* oe ligature: Additional Latin letters.
- (line 9195)
-* ogonek: Accents. (line 9121)
-* old-style numerals: Font styles. (line 1352)
-* one-column output: \onecolumn. (line 1539)
-* opening quote: Text symbols. (line 8911)
-* OpenType fonts: TeX engines. (line 435)
-* options, class: Class and package commands.
- (line 945)
-* options, color package: Color package options.
- (line 7822)
-* options, document class: Document class options.
- (line 703)
-* options, document class <1>: Class and package structure.
- (line 841)
-* options, global: Additional packages.
- (line 811)
-* options, graphics package: Graphics package options.
- (line 8093)
-* options, package: Class and package structure.
- (line 841)
-* options, package <1>: Class and package commands.
- (line 945)
-* ordinals, feminine and masculine: Text symbols. (line 9006)
-* oslash: Additional Latin letters.
- (line 9191)
-* overbar accent: Accents. (line 9080)
-* overdot accent, math: Math accents. (line 6994)
-* overview of LaTeX: Overview. (line 335)
-* package file layout: Class and package structure.
- (line 841)
-* package options: Class and package structure.
- (line 841)
-* package options <1>: Class and package commands.
- (line 945)
-* package, algorithm2e: tabbing. (line 3906)
-* package, amsmath: array. (line 2437)
-* package, amsmath <1>: displaymath. (line 2613)
-* package, babel: thebibliography. (line 4302)
-* package, babel <1>: Accents. (line 9057)
-* package, datetime: \today. (line 9245)
-* package, enumitem: list. (line 3085)
-* package, etoolbox: Class and package commands.
- (line 989)
-* package, fancyvrb: tabbing. (line 3906)
-* package, flafter: Floats. (line 1898)
-* package, float: Floats. (line 1868)
-* package, footmisc: Footnotes in section headings.
- (line 4857)
-* package, geometry: Document class options.
- (line 737)
-* package, geometry <1>: Document class options.
- (line 741)
-* package, listings: tabbing. (line 3906)
-* package, macros2e: \makeatletter and \makeatother.
- (line 593)
-* package, makeidx: Indexes. (line 9421)
-* package, mfirstuc: Upper and lower case.
- (line 8859)
-* package, minted: tabbing. (line 3906)
-* package, multind: Indexes. (line 9432)
-* package, picture: picture. (line 3477)
-* package, setspace: Low-level font commands.
- (line 1504)
-* package, showidx: Indexes. (line 9428)
-* package, textcase: Upper and lower case.
- (line 8856)
-* package, textcomp: Font styles. (line 1352)
-* package, xspace: \(SPACE) after control sequence.
- (line 7480)
-* packages, loading additional: Additional packages.
- (line 802)
-* page break, forcing: \pagebreak & \nopagebreak.
- (line 4688)
-* page break, preventing: \pagebreak & \nopagebreak.
- (line 4688)
-* page breaking: Page breaking. (line 4644)
-* page layout parameters: Page layout parameters.
- (line 1690)
-* page number, cross referencing: \pageref. (line 2297)
-* page numbering style: \pagenumbering. (line 7255)
-* page styles: Page styles. (line 7223)
-* page, colored: Colored pages. (line 8035)
-* paragraph indentation, in minipage: minipage. (line 3443)
-* paragraph indentations in quoted text: quotation and quote.
- (line 3732)
-* paragraph indentations in quoted text, omitting: quotation and quote.
- (line 3732)
-* paragraph mode: Modes. (line 7153)
-* paragraph mode <1>: \parbox. (line 7718)
-* paragraph symbol: Text symbols. (line 8915)
-* paragraphs: Making paragraphs. (line 5811)
-* parameters, for footnotes: Footnote parameters.
- (line 4913)
-* parameters, page layout: Page layout parameters.
- (line 1690)
-* PDF graphic files: Graphics package configuration.
- (line 8157)
-* PDF graphic files <1>: \includegraphics. (line 8349)
-* pdfTeX: Output files. (line 403)
-* pdfTeX engine: TeX engines. (line 441)
-* period, centered, in text: Text symbols. (line 9009)
-* pica: Units of length. (line 5698)
-* pict2e package: \line. (line 3623)
-* picture package: picture. (line 3477)
-* pictures, creating: picture. (line 3460)
-* pilcrow: Text symbols. (line 8915)
-* placement of floats: Floats. (line 1847)
-* PNG files: Graphics package configuration.
- (line 8157)
-* PNG files <1>: \includegraphics. (line 8349)
-* poetry, an environment for: verse. (line 4482)
-* Point: Units of length. (line 5694)
-* polish l: Additional Latin letters.
- (line 9183)
-* portrait orientation: Document class options.
- (line 757)
-* position, in picture: picture. (line 3482)
-* positional parameter: \newcommand & \renewcommand.
- (line 4965)
-* postscript, in letters: \ps. (line 9645)
-* pounds symbol: Text symbols. (line 8919)
-* preamble, defined: Starting and ending.
- (line 374)
-* predefined lengths: Predefined lengths. (line 5792)
-* prompt, *: Command line. (line 9743)
-* pronunciation: Overview. (line 353)
-* quad: Spacing in math mode.
- (line 7052)
-* question mark, upside-down: Text symbols. (line 9012)
-* quotation marks, French: Text symbols. (line 8901)
-* quote, single straight: Text symbols. (line 9027)
-* quote, straight base: Text symbols. (line 9031)
-* quoted text with paragraph indentation, displaying: quotation and quote.
- (line 3732)
-* quoted text without paragraph indentation, displaying: quotation and quote.
- (line 3732)
-* ragged left text: \raggedleft. (line 2966)
-* ragged left text, environment for: flushright. (line 2953)
-* ragged right text: \raggedright. (line 2940)
-* ragged right text, environment for: flushleft. (line 2927)
-* redefining environments: \newenvironment & \renewenvironment.
- (line 5094)
-* reference, forward: Cross references. (line 2231)
-* references, resolving forward: Output files. (line 416)
-* registered symbol: Text symbols. (line 9034)
-* remarks in the margin: Marginal notes. (line 5851)
-* reporting bugs: About this document.
- (line 306)
-* reserved characters: Reserved characters.
- (line 8786)
-* resizing: \scalebox. (line 8723)
-* resizing <1>: \resizebox. (line 8751)
-* right angle quotation marks: Text symbols. (line 8901)
-* right arrow, in text: Text symbols. (line 9037)
-* right brace, in text: Text symbols. (line 8959)
-* right quote: Text symbols. (line 8926)
-* right quote, double: Text symbols. (line 9018)
-* right quote, single: Text symbols. (line 9024)
-* right-hand equation numbers: Document class options.
- (line 760)
-* right-justifying text: \raggedleft. (line 2966)
-* right-justifying text, environment for: flushright. (line 2953)
-* ring accent: Accents. (line 9126)
-* ring accent, math: Math accents. (line 7009)
-* robust commands: \protect. (line 5348)
-* roman font: Font styles. (line 1298)
-* root file: Splitting the input.
- (line 9254)
-* rotating graphics: \rotatebox. (line 8658)
-* rotating text: \rotatebox. (line 8658)
-* rotation: \rotatebox. (line 8658)
-* row, tabbing: tabbing. (line 3807)
-* rubber lengths, defining new: \newlength. (line 5064)
-* running header and footer: Page layout parameters.
- (line 1690)
-* running header and footer style: \pagestyle. (line 7280)
-* sans serif font: Font styles. (line 1304)
-* Scaled point: Units of length. (line 5720)
-* scaling: \scalebox. (line 8723)
-* scaling <1>: \resizebox. (line 8751)
-* script letters for math: Font styles. (line 1292)
-* section number, cross referencing: \ref. (line 2318)
-* section numbers, printing: Sectioning. (line 2013)
-* section symbol: Text symbols. (line 8929)
-* section, redefining: \@startsection. (line 2025)
-* sectioning commands: Sectioning. (line 1972)
-* series, of fonts: Low-level font commands.
- (line 1434)
-* setspace package: Low-level font commands.
- (line 1504)
-* setting counters: \setcounter. (line 5602)
-* shapes, of fonts: Low-level font commands.
- (line 1474)
-* sharp S letters: Additional Latin letters.
- (line 9199)
-* showidx package: Indexes. (line 9428)
-* simulating typed text: verbatim. (line 4447)
-* single angle quotation marks: Text symbols. (line 8901)
-* single guillemets: Text symbols. (line 8901)
-* single left quote: Text symbols. (line 9021)
-* single low-9 quotation mark: Text symbols. (line 8923)
-* single quote, straight: Text symbols. (line 9027)
-* single right quote: Text symbols. (line 9024)
-* sizes of text: Font sizes. (line 1366)
-* skip register, plain TeX: \newlength. (line 5064)
-* slanted font: Font styles. (line 1307)
-* small caps font: Font styles. (line 1301)
-* space, inserting vertical: \addvspace. (line 7541)
-* space, vertical: \vspace. (line 7610)
-* spaces: Spaces. (line 7323)
-* spaces, ignore around commands: \ignorespaces & \ignorespacesafterend.
- (line 5400)
-* spacing within math mode: Spacing in math mode.
- (line 7026)
-* spacing, inter-sentence: \frenchspacing. (line 7448)
-* spacing, inter-sentence <1>: \normalsfcodes. (line 7461)
-* Spanish ordinals, feminine and masculine: Text symbols. (line 9006)
-* special characters: Reserved characters.
- (line 8786)
-* special characters <1>: Additional Latin letters.
- (line 9153)
-* special insertions: Special insertions. (line 8780)
-* specifier, float placement: Floats. (line 1847)
-* splitting the input file: Splitting the input.
- (line 9251)
-* stable option to footmisc package: Footnotes in section headings.
- (line 4857)
-* star-variants, commands: \@ifstar. (line 609)
-* starred form, defining new commands: \newcommand & \renewcommand.
- (line 4942)
-* starting a new page: \newpage. (line 4667)
-* starting a new page and clearing floats: \clearpage. (line 4660)
-* starting and ending: Starting and ending.
- (line 361)
-* starting on a right-hand page: \cleardoublepage. (line 4651)
-* sterling symbol: Text symbols. (line 8919)
-* straight double quote, base: Text symbols. (line 9031)
-* straight quote, base: Text symbols. (line 9031)
-* straight single quote: Text symbols. (line 9027)
-* stretch, infinite horizontal: \hfill. (line 7355)
-* stretch, infinite vertical: \vfill. (line 7584)
-* stretch, omitting vertical: \raggedbottom. (line 1679)
-* styles of text: Font styles. (line 1224)
-* styles, page: Page styles. (line 7223)
-* subscript: Subscripts & superscripts.
- (line 5938)
-* superscript: Subscripts & superscripts.
- (line 5938)
-* symbols, math: Math symbols. (line 5971)
-* symbols, text: Text symbols. (line 8877)
-* tab stops, using: tabbing. (line 3768)
-* table of contents entry, manually adding: \addcontentsline.
- (line 9335)
-* table of contents file: Output files. (line 426)
-* table of contents, avoiding footnotes: Footnotes in section headings.
- (line 4853)
-* table of contents, creating: Tables of contents. (line 9314)
-* tables, creating: table. (line 3915)
-* template, beamer: beamer template. (line 9759)
-* template, book: book template. (line 9790)
-* template, TUGboat: tugboat template. (line 9810)
-* templates, document: Document templates. (line 9752)
-* terminal input/output: Terminal input/output.
- (line 9698)
-* TeX logo: Text symbols. (line 8932)
-* text symbols: Text symbols. (line 8877)
-* text, resizing: \scalebox. (line 8723)
-* text, resizing <1>: \resizebox. (line 8751)
-* text, scaling: \scalebox. (line 8723)
-* text, scaling <1>: \resizebox. (line 8751)
-* textcase package: Upper and lower case.
- (line 8856)
-* textcomp package: Font styles. (line 1352)
-* thanks, for titlepage: \maketitle. (line 7245)
-* theorem-like environment: \newtheorem. (line 5201)
-* theorems, defining: \newtheorem. (line 5201)
-* theorems, typesetting: theorem. (line 4395)
-* thorn, Icelandic letter: Additional Latin letters.
- (line 9203)
-* three-quarters em-dash: Text symbols. (line 9040)
-* tie-after accent: Accents. (line 9132)
-* tilde accent: Accents. (line 9094)
-* tilde accent, math: Math accents. (line 7012)
-* tilde, ASCII, in text: Text symbols. (line 8938)
-* title page, separate or run-in: Document class options.
- (line 768)
-* title pages, creating: titlepage. (line 4408)
-* title, for titlepage: \maketitle. (line 7249)
-* titles, making: \maketitle. (line 7229)
-* trademark symbol: Text symbols. (line 9043)
-* transcript file: Output files. (line 411)
-* TrueType fonts: TeX engines. (line 435)
-* TUGboat template: tugboat template. (line 9810)
-* two-column output: \twocolumn. (line 1548)
-* two-thirds em-dash: Text symbols. (line 9046)
-* type styles: Font styles. (line 1224)
-* typed text, simulating: verbatim. (line 4447)
-* typeface sizes: Font sizes. (line 1366)
-* typefaces: Fonts. (line 1218)
-* typewriter font: Font styles. (line 1310)
-* typewriter labels in lists: description. (line 2572)
-* umlaut accent: Accents. (line 9067)
-* underbar: Accents. (line 9140)
-* underscore, in text: Text symbols. (line 9049)
-* Unicode input, native: TeX engines. (line 435)
-* units, of length: Units of length. (line 5690)
-* unofficial nature of this manual: About this document.
- (line 302)
-* unordered lists: itemize. (line 2979)
-* Upper case: Upper and lower case.
- (line 8820)
-* using BibTeX: Using BibTeX. (line 4358)
-* UTF-8: TeX engines. (line 435)
-* variables, a list of: Counters. (line 5473)
-* vector symbol, math: Math accents. (line 7015)
-* verbatim text: verbatim. (line 4447)
-* verbatim text, inline: \verb. (line 4465)
-* vertical bar, double, in text: Text symbols. (line 8950)
-* vertical bar, in text: Text symbols. (line 8947)
-* vertical space: \addvspace. (line 7541)
-* vertical space <1>: \vspace. (line 7610)
-* vertical space before paragraphs: \parskip. (line 5845)
-* visible space: \verb. (line 4476)
-* visible space symbol, in text: Text symbols. (line 9052)
-* weights, of fonts: Low-level font commands.
- (line 1444)
-* white space: Spaces. (line 7323)
-* wide hat accent, math: Math accents. (line 7018)
-* wide tilde accent, math: Math accents. (line 7021)
-* widths, of fonts: Low-level font commands.
- (line 1456)
-* writing external files: filecontents. (line 2876)
-* writing letters: Letters. (line 9439)
-* x-height: Units of length. (line 5722)
-* XeTeX: TeX engines. (line 467)
-* xindy program: Indexes. (line 9416)
-* xspace package: \(SPACE) after control sequence.
- (line 7480)
-
-Command Index
-*************
-
-* Menu:
-
-* $: Math formulas. (line 5919)
-* &: tabular. (line 3983)
-* --help command-line option: Command line. (line 9739)
-* .aux file: Output files. (line 416)
-* .dvi file: Output files. (line 393)
-* .fd file: \newfont. (line 5323)
-* .lof file: Output files. (line 426)
-* .lof file <1>: Tables of contents. (line 9324)
-* .log file: Output files. (line 411)
-* .lot file: Output files. (line 426)
-* .lot file <1>: Tables of contents. (line 9324)
-* .pdf file: Output files. (line 403)
-* .tex, default extension: Command line. (line 9731)
-* .toc file: Output files. (line 426)
-* .toc file <1>: Tables of contents. (line 9314)
-* .xdv file: TeX engines. (line 467)
+ (line 6509)
+* --disable-write18 command-line option: Command line options.
+ (line 13813)
+* --enable-write18 command-line option: Command line options.
+ (line 13813)
+* --file-line-error command-line option: Command line options.
+ (line 13840)
+* --halt-on-error command-line option: Command line options.
+ (line 13837)
+* --help command-line option: Command line options.
+ (line 13778)
+* --interaction command-line option: Command line options.
+ (line 13781)
+* --jobname command-line option: Command line options.
+ (line 13798)
+* --no-file-line-error command-line option: Command line options.
+ (line 13840)
+* --no-shell-escape command-line option: Command line options.
+ (line 13813)
+* --output-directory command-line option: Command line options.
+ (line 13810)
+* --shell-escape command-line option: Command line options.
+ (line 13813)
+* --version command-line option: Command line options.
+ (line 13773)
+* .aux file: Output files. (line 449)
+* .dvi file: Output files. (line 426)
+* .glo file: Glossaries. (line 13245)
+* .idx file: Indexes. (line 12884)
+* .idx file <1>: makeindex. (line 13036)
+* .ind file: makeindex. (line 13036)
+* .isty file: makeindex. (line 13048)
+* .lof file: Output files. (line 459)
+* .lof file <1>: Table of contents etc..
+ (line 12650)
+* .log file: Output files. (line 444)
+* .lot file: Output files. (line 459)
+* .lot file <1>: Table of contents etc..
+ (line 12650)
+* .pdf file: Output files. (line 436)
+* .tex, default extension: Command line. (line 13735)
+* .toc file: Output files. (line 459)
+* .toc file <1>: Table of contents etc..
+ (line 12650)
+* .xdv file: TeX engines. (line 501)
* 10pt option: Document class options.
- (line 711)
+ (line 771)
* 11pt option: Document class options.
- (line 711)
+ (line 771)
* 12pt option: Document class options.
- (line 711)
+ (line 771)
+* :: Colon character & \colon.
+ (line 9335)
+* : <1>: Colon character & \colon.
+ (line 9335)
* [...] for optional arguments: LaTeX command syntax.
- (line 486)
+ (line 520)
* \ character starting commands: LaTeX command syntax.
- (line 486)
+ (line 520)
* \!: Spacing in math mode.
- (line 7049)
-* \" (umlaut accent): Accents. (line 9067)
+ (line 9312)
+* \" (umlaut accent): Accents. (line 12227)
* \#: Reserved characters.
- (line 8793)
+ (line 11939)
* \$: Reserved characters.
- (line 8793)
+ (line 11939)
* \%: Reserved characters.
- (line 8793)
+ (line 11939)
* \&: Reserved characters.
- (line 8793)
-* \' (acute accent): Accents. (line 9071)
-* \' (tabbing): tabbing. (line 3848)
-* \(: Math formulas. (line 5911)
-* \(SPACE): \(SPACE) and \@. (line 7416)
-* \): Math formulas. (line 5911)
-* \*: Math miscellany. (line 7069)
-* \+: tabbing. (line 3840)
+ (line 11939)
+* \' (acute accent): Accents. (line 12231)
+* \' (tabbing): tabbing. (line 4883)
+* \*: \*. (line 9355)
+* \+: tabbing. (line 4875)
* \,: Spacing in math mode.
- (line 7045)
-* \-: tabbing. (line 3844)
-* \- (hyphenation): \- (hyphenation). (line 4574)
-* \. (dot-over accent): Accents. (line 9076)
-* \/: \/. (line 7493)
+ (line 9298)
+* \-: tabbing. (line 4879)
+* \- (hyphenation): \- (hyphenation). (line 5904)
+* \. (dot-over accent): Accents. (line 12234)
+* \/: \/. (line 10174)
* \:: Spacing in math mode.
- (line 7041)
+ (line 9294)
* \;: Spacing in math mode.
- (line 7036)
-* \<: tabbing. (line 3836)
-* \= (macron accent): Accents. (line 9080)
-* \= (tabbing): tabbing. (line 3830)
-* \>: tabbing. (line 3834)
+ (line 9289)
+* \<: tabbing. (line 4871)
+* \= (macron accent): Accents. (line 12238)
+* \= (tabbing): tabbing. (line 4865)
+* \>: tabbing. (line 4869)
* \> <1>: Spacing in math mode.
- (line 7041)
-* \> (tabbing): tabbing. (line 3833)
-* \@: \(SPACE) and \@. (line 7416)
-* \@beginparpenalty: list. (line 3312)
-* \@endparpenalty: list. (line 3320)
-* \@fnsymbol: \footnote. (line 4741)
-* \@ifstar: \@ifstar. (line 609)
-* \@itempenalty: list. (line 3316)
-* \@startsection: \@startsection. (line 2025)
-* \a (tabbing): tabbing. (line 3863)
-* \a' (acute accent in tabbing): tabbing. (line 3864)
-* \a= (macron accent in tabbing): tabbing. (line 3864)
+ (line 9294)
+* \> (tabbing): tabbing. (line 4868)
+* \@: \@. (line 9977)
+* \@beginparpenalty: list. (line 3964)
+* \@endparpenalty: list. (line 3972)
+* \@fnsymbol: \footnote. (line 6260)
+* \@ifstar: \@ifstar. (line 642)
+* \@itempenalty: list. (line 3968)
+* \@startsection: \@startsection. (line 2548)
+* \a (tabbing): tabbing. (line 4898)
+* \a' (acute accent in tabbing): tabbing. (line 4899)
+* \a= (macron accent in tabbing): tabbing. (line 4899)
* \aa (aa): Additional Latin letters.
- (line 9159)
+ (line 12304)
* \AA (AA): Additional Latin letters.
- (line 9159)
-* \acute: Math accents. (line 6978)
-* \addcontentsline: \addcontentsline. (line 9335)
-* \address: \address. (line 9519)
-* \addtocontents{EXT}{TEXT}: \addtocontents. (line 9369)
-* \addtocounter: \addtocounter. (line 5618)
-* \addtolength: \addtolength. (line 5752)
-* \addvspace: \addvspace. (line 7541)
+ (line 12304)
+* \acute: Math accents. (line 9182)
+* \addcontentsline: \addcontentsline. (line 12744)
+* \address: \address. (line 13424)
+* \addtocontents{EXT}{TEXT}: \addtocontents. (line 12819)
+* \addtocounter: \addtocounter. (line 7299)
+* \addtolength: \addtolength. (line 7535)
+* \addvspace: \addvspace. (line 10499)
* \ae (ae): Additional Latin letters.
- (line 9163)
+ (line 12308)
* \AE (AE): Additional Latin letters.
- (line 9163)
-* \aleph: Math symbols. (line 5987)
-* \Alph example: enumerate. (line 2732)
-* \alpha: Math symbols. (line 5990)
+ (line 12308)
+* \aleph: Math symbols. (line 8016)
+* \Alph example: enumerate. (line 3323)
+* \alpha: Math symbols. (line 8019)
* \alph{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 5507)
+ (line 7174)
* \Alph{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 5510)
-* \alsoname: Indexes. (line 9413)
-* \amalg: Math symbols. (line 5993)
-* \and for \author: \maketitle. (line 7235)
-* \angle: Math symbols. (line 5996)
-* \appendix: Sectioning. (line 2003)
-* \approx: Math symbols. (line 6001)
+ (line 7179)
+* \alsoname: \index. (line 12970)
+* \amalg: Math symbols. (line 8022)
+* \and for \author: \maketitle. (line 9567)
+* \angle: Math symbols. (line 8025)
+* \appendix: \appendix. (line 2487)
+* \approx: Math symbols. (line 8030)
* \arabic{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 5513)
-* \arccos: Math functions. (line 6869)
-* \arcsin: Math functions. (line 6872)
-* \arctan: Math functions. (line 6875)
-* \arg: Math functions. (line 6878)
-* \arraycolsep: array. (line 2434)
-* \arrayrulewidth: tabular. (line 4107)
-* \arraystretch: tabular. (line 4113)
-* \ast: Math symbols. (line 6004)
-* \asymp: Math symbols. (line 6013)
-* \AtBeginDocument: \AtBeginDocument. (line 2645)
+ (line 7184)
+* \arccos: Math functions. (line 9065)
+* \arcsin: Math functions. (line 9068)
+* \arctan: Math functions. (line 9071)
+* \arg: Math functions. (line 9074)
+* \arraycolsep: array. (line 3006)
+* \arrayrulewidth: tabular. (line 5163)
+* \arraystretch: tabular. (line 5169)
+* \ast: Math symbols. (line 8033)
+* \asymp: Math symbols. (line 8042)
+* \AtBeginDocument: \AtBeginDocument. (line 3236)
* \AtBeginDvi: Class and package commands.
- (line 888)
-* \AtEndDocument: \AtEndDocument. (line 2661)
+ (line 948)
+* \AtEndDocument: \AtEndDocument. (line 3252)
* \AtEndOfClass: Class and package commands.
- (line 893)
+ (line 953)
* \AtEndOfPackage: Class and package commands.
- (line 893)
-* \author{NAME \and NAME2}: \maketitle. (line 7234)
-* \a` (grave accent in tabbing): tabbing. (line 3864)
-* \b (bar-under accent): Accents. (line 9097)
-* \backslash: Math symbols. (line 6016)
-* \bar: Math accents. (line 6981)
+ (line 953)
+* \author{NAME1 \and NAME2 \and ...}: \maketitle. (line 9566)
+* \a` (grave accent in tabbing): tabbing. (line 4899)
+* \b (bar-under accent): Accents. (line 12253)
+* \backmatter: \frontmatter & \mainmatter & \backmatter.
+ (line 2520)
+* \backslash: Math symbols. (line 8045)
+* \bar: Math accents. (line 9185)
* \baselineskip: Low-level font commands.
- (line 1487)
+ (line 1566)
* \baselinestretch: Low-level font commands.
- (line 1497)
-* \begin: Environments. (line 2340)
-* \beta: Math symbols. (line 6020)
-* \bf: Font styles. (line 1288)
-* \bfseries: Font styles. (line 1257)
-* \bibitem: \bibitem. (line 4314)
-* \bibliography: Using BibTeX. (line 4358)
-* \bibliographystyle: Using BibTeX. (line 4358)
-* \bibname: thebibliography. (line 4296)
-* \bigcap: Math symbols. (line 6023)
-* \bigcirc: Math symbols. (line 6027)
-* \bigcup: Math symbols. (line 6031)
-* \bigodot: Math symbols. (line 6035)
-* \bigoplus: Math symbols. (line 6038)
-* \bigotimes: Math symbols. (line 6041)
-* \bigskip: \bigskip \medskip \smallskip.
- (line 7566)
-* \bigskipamount: \bigskip \medskip \smallskip.
- (line 7567)
-* \bigsqcup: Math symbols. (line 6052)
-* \bigtriangledown: Math symbols. (line 6044)
-* \bigtriangleup: Math symbols. (line 6048)
-* \biguplus: Math symbols. (line 6055)
-* \bigvee: Math symbols. (line 6059)
-* \bigwedge: Math symbols. (line 6062)
-* \bmod: Math functions. (line 6881)
-* \boldmath: Math formulas. (line 5924)
-* \bot: Math symbols. (line 6065)
-* \bottomfraction: Floats. (line 1910)
-* \bottomfraction <1>: Floats. (line 1911)
-* \bowtie: Math symbols. (line 6070)
-* \Box: Math symbols. (line 6073)
-* \breve: Math accents. (line 6984)
-* \bullet: Math symbols. (line 6078)
-* \c (cedilla accent): Accents. (line 9102)
-* \cal: Font styles. (line 1291)
-* \cap: Math symbols. (line 6081)
-* \capitalacute: Accents. (line 9071)
-* \capitalbreve: Accents. (line 9137)
-* \capitalcaron: Accents. (line 9148)
-* \capitalcedilla: Accents. (line 9102)
-* \capitalcircumflex: Accents. (line 9084)
-* \capitaldieresis: Accents. (line 9067)
-* \capitaldotaccent: Accents. (line 9106)
-* \capitalgrave: Accents. (line 9088)
-* \capitalhungarumlaut: Accents. (line 9110)
-* \capitalmacron: Accents. (line 9080)
-* \capitalnewtie: Accents. (line 9132)
-* \capitalogonek: Accents. (line 9121)
-* \capitalring: Accents. (line 9126)
-* \capitaltie: Accents. (line 9132)
-* \capitaltilde: Accents. (line 9094)
-* \caption: figure. (line 2857)
-* \caption <1>: table. (line 3935)
-* \cc: \cc. (line 9546)
-* \cdot: Math symbols. (line 6086)
-* \cdots: Math miscellany. (line 7088)
-* \centering: \centering. (line 2512)
-* \chapter: Sectioning. (line 1975)
-* \check: Math accents. (line 6987)
+ (line 1576)
+* \begin: Environments. (line 2898)
+* \beta: Math symbols. (line 8049)
+* \bf: Font styles. (line 1364)
+* \bfseries: Font styles. (line 1329)
+* \bibitem: \bibitem. (line 5390)
+* \bibliography: Using BibTeX. (line 5512)
+* \bibliographystyle: Using BibTeX. (line 5512)
+* \bigcap: Math symbols. (line 8052)
+* \bigcirc: Math symbols. (line 8056)
+* \bigcup: Math symbols. (line 8060)
+* \bigodot: Math symbols. (line 8064)
+* \bigoplus: Math symbols. (line 8067)
+* \bigotimes: Math symbols. (line 8070)
+* \bigskip: \bigskip & \medskip & \smallskip.
+ (line 10280)
+* \bigskipamount: \bigskip & \medskip & \smallskip.
+ (line 10281)
+* \bigsqcup: Math symbols. (line 8081)
+* \bigtriangledown: Math symbols. (line 8073)
+* \bigtriangleup: Math symbols. (line 8077)
+* \biguplus: Math symbols. (line 8084)
+* \bigvee: Math symbols. (line 8088)
+* \bigwedge: Math symbols. (line 8091)
+* \bmod: Math functions. (line 9077)
+* \boldmath: \boldmath & \unboldmath.
+ (line 8967)
+* \boldmath <1>: \boldmath & \unboldmath.
+ (line 8975)
+* \bot: Math symbols. (line 8094)
+* \bottomfraction: Floats. (line 1990)
+* \bottomfraction <1>: Floats. (line 1991)
+* \bowtie: Math symbols. (line 8099)
+* \Box: Math symbols. (line 8102)
+* \breve: Math accents. (line 9188)
+* \bullet: Math symbols. (line 8107)
+* \c (cedilla accent): Accents. (line 12263)
+* \cal: Font styles. (line 1367)
+* \cap: Math symbols. (line 8110)
+* \capitalacute: Accents. (line 12231)
+* \capitalbreve: Accents. (line 12289)
+* \capitalcaron: Accents. (line 12293)
+* \capitalcedilla: Accents. (line 12263)
+* \capitalcircumflex: Accents. (line 12242)
+* \capitaldieresis: Accents. (line 12227)
+* \capitaldotaccent: Accents. (line 12267)
+* \capitalgrave: Accents. (line 12246)
+* \capitalhungarumlaut: Accents. (line 12271)
+* \capitalmacron: Accents. (line 12238)
+* \capitalnewtie: Accents. (line 12285)
+* \capitalogonek: Accents. (line 12275)
+* \capitalring: Accents. (line 12279)
+* \capitaltie: Accents. (line 12285)
+* \capitaltilde: Accents. (line 12250)
+* \caption: figure. (line 3449)
+* \caption <1>: table. (line 4989)
+* \cc: \cc. (line 13450)
+* \cdot: Math symbols. (line 8115)
+* \cdots: Dots. (line 9018)
+* \centering: \centering. (line 3088)
+* \chapter: Sectioning. (line 2052)
+* \chapter <1>: \chapter. (line 2185)
+* \check: Math accents. (line 9191)
* \CheckCommand: Class and package commands.
- (line 900)
+ (line 960)
* \CheckCommand*: Class and package commands.
- (line 900)
-* \chi: Math symbols. (line 6089)
-* \circ: Math symbols. (line 6092)
-* \circle: \circle. (line 3535)
-* \cite: \cite. (line 4333)
+ (line 960)
+* \chi: Math symbols. (line 8118)
+* \circ: Math symbols. (line 8121)
+* \circle: \circle. (line 4536)
+* \cite: \cite. (line 5449)
* \ClassError: Class and package commands.
- (line 920)
+ (line 980)
* \ClassInfo: Class and package commands.
- (line 920)
+ (line 980)
* \ClassInfoNoLine: Class and package commands.
- (line 920)
+ (line 980)
* \ClassWarning: Class and package commands.
- (line 920)
+ (line 980)
* \ClassWarningNoLine: Class and package commands.
- (line 920)
-* \cleardoublepage: \cleardoublepage. (line 4651)
-* \clearpage: \clearpage. (line 4660)
-* \cline: \cline. (line 4240)
-* \closing: \closing. (line 9562)
-* \clubsuit: Math symbols. (line 6097)
-* \columnsep: \twocolumn. (line 1564)
+ (line 980)
+* \cleardoublepage: \clearpage & \cleardoublepage.
+ (line 6083)
+* \clearpage: \clearpage & \cleardoublepage.
+ (line 6083)
+* \cline: \cline. (line 5297)
+* \closing: \closing. (line 13466)
+* \clubsuit: Math symbols. (line 8126)
+* \colon: Colon character & \colon.
+ (line 9335)
+* \columnsep: \twocolumn. (line 1644)
* \columnsep <1>: Page layout parameters.
- (line 1690)
+ (line 1769)
* \columnsep <2>: Page layout parameters.
- (line 1693)
-* \columnseprule: \twocolumn. (line 1570)
+ (line 1772)
+* \columnseprule: \twocolumn. (line 1650)
* \columnseprule <1>: Page layout parameters.
- (line 1691)
+ (line 1770)
* \columnseprule <2>: Page layout parameters.
- (line 1693)
-* \columnwidth: \twocolumn. (line 1577)
+ (line 1772)
+* \columnwidth: \twocolumn. (line 1657)
* \columnwidth <1>: Page layout parameters.
- (line 1692)
+ (line 1771)
* \columnwidth <2>: Page layout parameters.
- (line 1693)
-* \complement: Math symbols. (line 6100)
-* \cong: Math symbols. (line 6106)
-* \contentsline: \addcontentsline. (line 9362)
-* \coprod: Math symbols. (line 6109)
-* \copyright: Text symbols. (line 8881)
-* \cos: Math functions. (line 6884)
-* \cosh: Math functions. (line 6887)
-* \cot: Math functions. (line 6890)
-* \coth: Math functions. (line 6893)
-* \csc: Math functions. (line 6896)
-* \cup: Math symbols. (line 6112)
+ (line 1772)
+* \complement: Math symbols. (line 8129)
+* \cong: Math symbols. (line 8135)
+* \contentsline: \addcontentsline. (line 12748)
+* \coprod: Math symbols. (line 8138)
+* \copyright: Text symbols. (line 12026)
+* \cos: Math functions. (line 9080)
+* \cosh: Math functions. (line 9083)
+* \cot: Math functions. (line 9086)
+* \coth: Math functions. (line 9089)
+* \csc: Math functions. (line 9092)
+* \cup: Math symbols. (line 8141)
* \CurrentOption: Class and package commands.
- (line 939)
-* \d (dot-under accent): Accents. (line 9106)
-* \dag: Text symbols. (line 8885)
-* \dagger: Math symbols. (line 6117)
-* \dashbox: \dashbox. (line 3590)
-* \dashv: Math symbols. (line 6120)
-* \date{TEXT}: \maketitle. (line 7240)
-* \day: \day \month \year. (line 5651)
-* \dblfloatpagefraction: \twocolumn. (line 1611)
-* \dblfloatsep: \twocolumn. (line 1617)
-* \dbltextfloatsep: \twocolumn. (line 1624)
-* \dbltopfraction: \twocolumn. (line 1589)
-* \dbltopnumber: \twocolumn. (line 1629)
-* \ddag: Text symbols. (line 8888)
-* \ddagger: Math symbols. (line 6124)
-* \ddot: Math accents. (line 6990)
-* \ddots: Math miscellany. (line 7092)
+ (line 999)
+* \d (dot-under accent): Accents. (line 12267)
+* \dag: Text symbols. (line 12030)
+* \dagger: Math symbols. (line 8146)
+* \dashbox: \dashbox. (line 4742)
+* \dashv: Math symbols. (line 8149)
+* \date{TEXT}: \maketitle. (line 9574)
+* \day: \day & \month & \year.
+ (line 7349)
+* \dblfloatpagefraction: \twocolumn. (line 1690)
+* \dblfloatsep: \twocolumn. (line 1696)
+* \dbltextfloatsep: \twocolumn. (line 1703)
+* \dbltopfraction: \twocolumn. (line 1669)
+* \dbltopnumber: \twocolumn. (line 1708)
+* \ddag: Text symbols. (line 12033)
+* \ddagger: Math symbols. (line 8153)
+* \ddot: Math accents. (line 9194)
+* \ddots: Dots. (line 9022)
* \DeclareGraphicsExtensions: \DeclareGraphicsExtensions.
- (line 8231)
+ (line 11358)
* \DeclareGraphicsRule: \DeclareGraphicsRule.
- (line 8270)
+ (line 11398)
* \DeclareOption: Class and package commands.
- (line 945)
+ (line 1005)
* \DeclareOption*: Class and package commands.
- (line 945)
+ (line 1005)
* \DeclareRobustCommand: Class and package commands.
- (line 975)
+ (line 1035)
* \DeclareRobustCommand*: Class and package commands.
- (line 975)
-* \deg: Math functions. (line 6899)
-* \Delta: Math symbols. (line 6127)
-* \delta: Math symbols. (line 6130)
-* \depth: Predefined lengths. (line 5796)
-* \det: Math functions. (line 6902)
+ (line 1035)
+* \deg: Math functions. (line 9095)
+* \Delta: Math symbols. (line 8156)
+* \delta: Math symbols. (line 8159)
+* \det: Math functions. (line 9098)
* \dh (d): Additional Latin letters.
- (line 9167)
+ (line 12312)
* \DH (D): Additional Latin letters.
- (line 9167)
-* \Diamond: Math symbols. (line 6133)
-* \diamond: Math symbols. (line 6137)
-* \diamondsuit: Math symbols. (line 6141)
-* \dim: Math functions. (line 6905)
-* \displaystyle: Math formulas. (line 5929)
-* \div: Math symbols. (line 6144)
+ (line 12312)
+* \Diamond: Math symbols. (line 8162)
+* \diamond: Math symbols. (line 8166)
+* \diamondsuit: Math symbols. (line 8170)
+* \dim: Math functions. (line 9101)
+* \displaystyle: Math formulas. (line 7902)
+* \div: Math symbols. (line 8173)
* \dj: Additional Latin letters.
- (line 9173)
+ (line 12318)
* \DJ: Additional Latin letters.
- (line 9173)
-* \documentclass: Document classes. (line 669)
-* \dot: Math accents. (line 6993)
-* \doteq: Math symbols. (line 6147)
-* \dotfill: \hrulefill \dotfill.
- (line 7518)
-* \dots: Text symbols. (line 8905)
-* \doublerulesep: tabular. (line 4118)
-* \downarrow: Math symbols. (line 6151)
-* \Downarrow: Math symbols. (line 6155)
-* \ell: Math symbols. (line 6159)
-* \emph: Font styles. (line 1277)
-* \emptyset: Math symbols. (line 6162)
-* \encl: \encl. (line 9574)
-* \end: Environments. (line 2340)
-* \enlargethispage: \enlargethispage. (line 4673)
-* \enumi: enumerate. (line 2718)
-* \enumii: enumerate. (line 2718)
-* \enumiii: enumerate. (line 2718)
-* \enumiv: enumerate. (line 2718)
-* \epsilon: Math symbols. (line 6166)
-* \equiv: Math symbols. (line 6172)
-* \eta: Math symbols. (line 6175)
+ (line 12318)
+* \documentclass: Document classes. (line 729)
+* \dot: Math accents. (line 9197)
+* \doteq: Math symbols. (line 8176)
+* \dotfill: \hrulefill & \dotfill.
+ (line 10209)
+* \dots: Text symbols. (line 12050)
+* \doublerulesep: tabular. (line 5174)
+* \downarrow: Math symbols. (line 8180)
+* \Downarrow: Math symbols. (line 8184)
+* \ell: Math symbols. (line 8188)
+* \emph: Font styles. (line 1349)
+* \emptyset: Math symbols. (line 8191)
+* \encl: \encl. (line 13479)
+* \end: Environments. (line 2898)
+* \endinput: \endinput. (line 12464)
+* \enlargethispage: \enlargethispage. (line 6157)
+* \enspace: \enspace & \quad & \qquad.
+ (line 9782)
+* \enumi: enumerate. (line 3309)
+* \enumii: enumerate. (line 3309)
+* \enumiii: enumerate. (line 3309)
+* \enumiv: enumerate. (line 3309)
+* \epsilon: Math symbols. (line 8195)
+* \equiv: Math symbols. (line 8201)
+* \eta: Math symbols. (line 8204)
* \evensidemargin: Document class options.
- (line 781)
+ (line 841)
* \evensidemargin <1>: Page layout parameters.
- (line 1751)
+ (line 1830)
* \evensidemargin <2>: Page layout parameters.
- (line 1752)
+ (line 1831)
* \ExecuteOptions: Class and package commands.
- (line 1045)
-* \exists: Math symbols. (line 6178)
-* \exp: Math functions. (line 6908)
-* \extracolsep: tabular. (line 4066)
-* \fbox: \fbox and \framebox.
- (line 7653)
+ (line 1111)
+* \exists: Math symbols. (line 8207)
+* \exp: Math functions. (line 9104)
+* \extracolsep: tabular. (line 5114)
+* \fbox: \fbox & \framebox. (line 10644)
* \fboxrule: \framebox (picture).
- (line 3584)
-* \fboxrule <1>: \fbox and \framebox.
- (line 7665)
+ (line 4719)
+* \fboxrule <1>: \fbox & \framebox. (line 10677)
+* \fboxrule <2>: \fbox & \framebox. (line 10676)
* \fboxsep: \framebox (picture).
- (line 3584)
-* \fboxsep <1>: \fbox and \framebox.
- (line 7665)
-* \fill: \hfill. (line 7358)
-* \flat: Math symbols. (line 6181)
-* \floatpagefraction: Floats. (line 1914)
-* \floatpagefraction <1>: Floats. (line 1915)
-* \floatsep: Floats. (line 1930)
-* \floatsep <1>: Floats. (line 1931)
-* \flushbottom: \flushbottom. (line 1658)
-* \fnsymbol, and footnotes: \footnote. (line 4741)
+ (line 4719)
+* \fboxsep <1>: \fbox & \framebox. (line 10682)
+* \fboxsep <2>: \fbox & \framebox. (line 10681)
+* \fill: \hfill. (line 9869)
+* \flat: Math symbols. (line 8210)
+* \floatpagefraction: Floats. (line 1994)
+* \floatpagefraction <1>: Floats. (line 1995)
+* \floatsep: Floats. (line 2010)
+* \floatsep <1>: Floats. (line 2011)
+* \flushbottom: \flushbottom. (line 1737)
+* \fnsymbol, and footnotes: \footnote. (line 6260)
* \fnsymbol{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 5522)
+ (line 7197)
* \fontencoding: Low-level font commands.
- (line 1397)
+ (line 1476)
* \fontfamily: Low-level font commands.
- (line 1407)
+ (line 1486)
* \fontseries: Low-level font commands.
- (line 1434)
+ (line 1513)
* \fontshape: Low-level font commands.
- (line 1474)
+ (line 1553)
* \fontsize: Low-level font commands.
- (line 1487)
-* \footnote: \footnote. (line 4724)
-* \footnotemark: \footnotemark. (line 4762)
-* \footnoterule: Footnote parameters.
- (line 4913)
-* \footnotesep: Footnote parameters.
- (line 4919)
-* \footnotesize: Font sizes. (line 1371)
-* \footnotetext: \footnotetext. (line 4794)
+ (line 1566)
+* \footnote: \footnote. (line 6242)
+* \footnotemark: \footnotemark. (line 6308)
+* \footnoterule: \footnote. (line 6270)
+* \footnotesep: \footnote. (line 6282)
+* \footnotesize: Font sizes. (line 1441)
+* \footnotetext: \footnotetext. (line 6364)
* \footskip: Page layout parameters.
- (line 1710)
+ (line 1789)
* \footskip <1>: Page layout parameters.
- (line 1711)
-* \forall: Math symbols. (line 6184)
-* \frac: Math miscellany. (line 7096)
-* \frac{NUM}{DEN}: Math miscellany. (line 7095)
-* \frame: \frame. (line 3605)
+ (line 1790)
+* \forall: Math symbols. (line 8213)
+* \frac: \frac. (line 9371)
+* \frame: \frame. (line 4730)
* \framebox: \framebox (picture).
- (line 3576)
-* \framebox <1>: \fbox and \framebox.
- (line 7653)
-* \frenchspacing: \frenchspacing. (line 7448)
-* \frown: Math symbols. (line 6187)
-* \fussy: \fussy. (line 4593)
-* \Gamma: Math symbols. (line 6190)
-* \gamma: Math symbols. (line 6193)
-* \gcd: Math functions. (line 6911)
-* \ge: Math symbols. (line 6196)
-* \geq: Math symbols. (line 6200)
-* \gets: Math symbols. (line 6204)
-* \gg: Math symbols. (line 6207)
-* \glossary: Glossaries. (line 9386)
-* \glossaryentry: Glossaries. (line 9389)
-* \graphicspath: \graphicspath. (line 8169)
-* \grave: Math accents. (line 6996)
-* \guillemotleft (<<): Text symbols. (line 8897)
-* \guillemotright (>>): Text symbols. (line 8898)
-* \guilsinglleft (<): Text symbols. (line 8899)
-* \guilsinglright (>): Text symbols. (line 8900)
-* \H (Hungarian umlaut accent): Accents. (line 9110)
-* \hat: Math accents. (line 6999)
-* \hbar: Math symbols. (line 6211)
+ (line 4694)
+* \framebox <1>: \fbox & \framebox. (line 10644)
+* \frenchspacing: \frenchspacing. (line 10023)
+* \frontmatter: \frontmatter & \mainmatter & \backmatter.
+ (line 2520)
+* \frown: Math symbols. (line 8216)
+* \fussy: \fussy & \sloppy. (line 5962)
+* \Gamma: Math symbols. (line 8219)
+* \gamma: Math symbols. (line 8222)
+* \gcd: Math functions. (line 9107)
+* \ge: Math symbols. (line 8225)
+* \geq: Math symbols. (line 8229)
+* \gets: Math symbols. (line 8233)
+* \gg: Math symbols. (line 8236)
+* \gls: \gls. (line 13315)
+* \graphicspath: \graphicspath. (line 11296)
+* \graphpaper: \graphpaper. (line 4440)
+* \grave: Math accents. (line 9200)
+* \guillemotleft (<<): Text symbols. (line 12042)
+* \guillemotright (>>): Text symbols. (line 12043)
+* \guilsinglleft (<): Text symbols. (line 12044)
+* \guilsinglright (>): Text symbols. (line 12045)
+* \H (Hungarian umlaut accent): Accents. (line 12271)
+* \hat: Math accents. (line 9203)
+* \hbar: Math symbols. (line 8240)
* \headheight: Page layout parameters.
- (line 1698)
+ (line 1777)
* \headheight <1>: Page layout parameters.
- (line 1699)
+ (line 1778)
* \headsep: Page layout parameters.
- (line 1703)
+ (line 1782)
* \headsep <1>: Page layout parameters.
- (line 1704)
-* \heartsuit: Math symbols. (line 6214)
-* \height: Predefined lengths. (line 5794)
-* \hfill: \hfill. (line 7355)
-* \hline: \hline. (line 4262)
-* \hom: Math functions. (line 6914)
-* \hookleftarrow: Math symbols. (line 6217)
-* \hookrightarrow: Math symbols. (line 6220)
-* \hrulefill: \hrulefill \dotfill.
- (line 7518)
+ (line 1783)
+* \heartsuit: Math symbols. (line 8243)
+* \hfill: \hfill. (line 9857)
+* \hline: \hline. (line 5320)
+* \hom: Math functions. (line 9110)
+* \hookleftarrow: Math symbols. (line 8246)
+* \hookrightarrow: Math symbols. (line 8249)
+* \hrulefill: \hrulefill & \dotfill.
+ (line 10209)
* \hsize: Page layout parameters.
- (line 1803)
+ (line 1882)
* \hsize <1>: Page layout parameters.
- (line 1803)
-* \hspace: \hspace. (line 7328)
-* \huge: Font sizes. (line 1371)
-* \Huge: Font sizes. (line 1371)
-* \hyphenation: \hyphenation. (line 4611)
-* \i (dotless i): Accents. (line 9114)
-* \iff: Math symbols. (line 6223)
+ (line 1882)
+* \hspace: \hspace. (line 9810)
+* \hss: \hss. (line 9890)
+* \huge: Font sizes. (line 1441)
+* \Huge: Font sizes. (line 1441)
+* \hyphenation: \hyphenation. (line 6003)
+* \i (dotless i): Accents. (line 12221)
+* \iff: Math symbols. (line 8252)
* \IfFileExists: Class and package commands.
- (line 1006)
+ (line 1067)
* \ignorespaces: \ignorespaces & \ignorespacesafterend.
- (line 5400)
+ (line 7063)
* \ignorespacesafterend: \ignorespaces & \ignorespacesafterend.
- (line 5400)
+ (line 7063)
* \ij (ij): Additional Latin letters.
- (line 9179)
+ (line 12324)
* \IJ (IJ): Additional Latin letters.
- (line 9179)
-* \Im: Math symbols. (line 6227)
-* \imath: Math accents. (line 7002)
-* \in: Math symbols. (line 6230)
-* \include: \include. (line 9263)
-* \includegraphics: \includegraphics. (line 8349)
-* \includeonly: \includeonly. (line 9281)
-* \indent: \indent. (line 5819)
-* \index: Indexes. (line 9402)
-* \indexentry: Indexes. (line 9405)
-* \indexspace: Indexes. (line 9425)
-* \inf: Math functions. (line 6917)
-* \infty: Math symbols. (line 6236)
-* \input: \input. (line 9296)
+ (line 12324)
+* \Im: Math symbols. (line 8256)
+* \imath: Math symbols. (line 8259)
+* \in: Math symbols. (line 8263)
+* \include: \include & \includeonly.
+ (line 12495)
+* \includegraphics: \includegraphics. (line 11477)
+* \includeonly: \include & \includeonly.
+ (line 12495)
+* \indent: \indent & \noindent.
+ (line 7722)
+* \index: Indexes. (line 12884)
+* \index <1>: \index. (line 12920)
+* \indexentry: \index. (line 13020)
+* \indexspace: makeindex. (line 13088)
+* \inf: Math functions. (line 9113)
+* \infty: Math symbols. (line 8268)
+* \input: \input. (line 12612)
* \InputIfFileExists: Class and package commands.
- (line 1006)
-* \int: Math symbols. (line 6239)
-* \intextsep: Floats. (line 1934)
-* \intextsep <1>: Floats. (line 1935)
-* \iota: Math symbols. (line 6242)
-* \it: Font styles. (line 1294)
-* \item: description. (line 2567)
-* \item <1>: enumerate. (line 2700)
-* \item <2>: itemize. (line 2979)
-* \item <3>: itemize. (line 3001)
-* \itemindent: list. (line 3141)
-* \itemsep: list. (line 3145)
-* \itshape: Font styles. (line 1251)
-* \j (dotless j): Accents. (line 9117)
-* \jmath: Math accents. (line 7005)
-* \Join: Math symbols. (line 6245)
-* \k (ogonek): Accents. (line 9121)
-* \kappa: Math symbols. (line 6249)
-* \ker: Math functions. (line 6920)
-* \kill: tabbing. (line 3868)
+ (line 1067)
+* \int: Math symbols. (line 8271)
+* \intextsep: Floats. (line 2014)
+* \intextsep <1>: Floats. (line 2015)
+* \iota: Math symbols. (line 8274)
+* \it: Font styles. (line 1370)
+* \item: description. (line 3155)
+* \item <1>: enumerate. (line 3291)
+* \item <2>: itemize. (line 3624)
+* \item <3>: itemize. (line 3646)
+* \itemindent: list. (line 3789)
+* \itemsep: list. (line 3793)
+* \itshape: Font styles. (line 1323)
+* \j (dotless j): Accents. (line 12221)
+* \jmath: Math symbols. (line 8281)
+* \Join: Math symbols. (line 8277)
+* \k (ogonek): Accents. (line 12275)
+* \kappa: Math symbols. (line 8285)
+* \ker: Math functions. (line 9116)
+* \kill: tabbing. (line 4903)
* \l (/l): Additional Latin letters.
- (line 9183)
+ (line 12328)
* \L (/L): Additional Latin letters.
- (line 9183)
-* \label: \label. (line 2246)
-* \labelenumi: enumerate. (line 2727)
-* \labelenumii: enumerate. (line 2727)
-* \labelenumiii: enumerate. (line 2727)
-* \labelenumiv: enumerate. (line 2727)
-* \labelitemi: itemize. (line 3008)
-* \labelitemii: itemize. (line 3008)
-* \labelitemiii: itemize. (line 3008)
-* \labelitemiv: itemize. (line 3008)
-* \labelsep: list. (line 3157)
-* \labelwidth: list. (line 3162)
-* \Lambda: Math symbols. (line 6252)
-* \lambda: Math symbols. (line 6255)
-* \land: Math symbols. (line 6258)
-* \langle: Math symbols. (line 6263)
-* \large: Font sizes. (line 1371)
-* \Large: Font sizes. (line 1371)
-* \LARGE: Font sizes. (line 1371)
-* \LaTeX: Text symbols. (line 8891)
-* \LaTeXe: Text symbols. (line 8894)
-* \lbrace: Math symbols. (line 6268)
-* \lbrack: Math symbols. (line 6272)
-* \lceil: Math symbols. (line 6276)
-* \ldots: Text symbols. (line 8904)
-* \le: Math symbols. (line 6280)
-* \leadsto: Math symbols. (line 6284)
-* \left DELIM1 ... \right DELIM2: Math miscellany. (line 7098)
-* \Leftarrow: Math symbols. (line 6291)
-* \leftarrow: Math symbols. (line 6296)
-* \lefteqn: eqnarray. (line 2784)
-* \leftharpoondown: Math symbols. (line 6300)
-* \leftharpoonup: Math symbols. (line 6303)
-* \leftmargin: itemize. (line 3027)
-* \leftmargin <1>: list. (line 3182)
-* \leftmargini: itemize. (line 3027)
-* \leftmarginii: itemize. (line 3027)
-* \leftmarginiii: itemize. (line 3027)
-* \leftmarginiv: itemize. (line 3027)
-* \leftmarginv: itemize. (line 3027)
-* \leftmarginvi: itemize. (line 3027)
-* \Leftrightarrow: Math symbols. (line 6306)
-* \leftrightarrow: Math symbols. (line 6311)
-* \leq: Math symbols. (line 6316)
-* \lfloor: Math symbols. (line 6320)
-* \lg: Math functions. (line 6923)
-* \lhd: Math symbols. (line 6323)
-* \lim: Math functions. (line 6926)
-* \liminf: Math functions. (line 6929)
-* \limsup: Math functions. (line 6932)
-* \line: \line. (line 3616)
+ (line 12328)
+* \label: \label. (line 2787)
+* \labelenumi: enumerate. (line 3318)
+* \labelenumii: enumerate. (line 3318)
+* \labelenumiii: enumerate. (line 3318)
+* \labelenumiv: enumerate. (line 3318)
+* \labelitemi: itemize. (line 3653)
+* \labelitemii: itemize. (line 3653)
+* \labelitemiii: itemize. (line 3653)
+* \labelitemiv: itemize. (line 3653)
+* \labelsep: list. (line 3805)
+* \labelwidth: list. (line 3810)
+* \Lambda: Math symbols. (line 8288)
+* \lambda: Math symbols. (line 8291)
+* \land: Math symbols. (line 8294)
+* \langle: Math symbols. (line 8299)
+* \large: Font sizes. (line 1441)
+* \Large: Font sizes. (line 1441)
+* \LARGE: Font sizes. (line 1441)
+* \LaTeX: Text symbols. (line 12036)
+* \LaTeXe: Text symbols. (line 12039)
+* \lbrace: Math symbols. (line 8304)
+* \lbrack: Math symbols. (line 8308)
+* \lceil: Math symbols. (line 8312)
+* \ldots: Dots. (line 9026)
+* \ldots <1>: Text symbols. (line 12049)
+* \le: Math symbols. (line 8316)
+* \leadsto: Math symbols. (line 8320)
+* \left: \left & \right. (line 9383)
+* \Leftarrow: Math symbols. (line 8327)
+* \leftarrow: Math symbols. (line 8332)
+* \lefteqn: eqnarray. (line 3375)
+* \leftharpoondown: Math symbols. (line 8336)
+* \leftharpoonup: Math symbols. (line 8339)
+* \leftmargin: itemize. (line 3672)
+* \leftmargin <1>: list. (line 3830)
+* \leftmargini: itemize. (line 3672)
+* \leftmarginii: itemize. (line 3672)
+* \leftmarginiii: itemize. (line 3672)
+* \leftmarginiv: itemize. (line 3672)
+* \leftmarginv: itemize. (line 3672)
+* \leftmarginvi: itemize. (line 3672)
+* \Leftrightarrow: Math symbols. (line 8342)
+* \leftrightarrow: Math symbols. (line 8347)
+* \leq: Math symbols. (line 8352)
+* \lfloor: Math symbols. (line 8356)
+* \lg: Math functions. (line 9119)
+* \lhd: Math symbols. (line 8359)
+* \lim: Math functions. (line 9122)
+* \liminf: Math functions. (line 9125)
+* \limsup: Math functions. (line 9128)
+* \line: \line. (line 4464)
* \linebreak: \linebreak & \nolinebreak.
- (line 4627)
+ (line 6021)
* \linespread: Low-level font commands.
- (line 1511)
-* \linethickness: \linethickness. (line 3630)
+ (line 1590)
+* \linethickness: \linethickness. (line 4508)
* \linewidth: Page layout parameters.
- (line 1717)
+ (line 1796)
* \linewidth <1>: Page layout parameters.
- (line 1718)
-* \listoffigures: Tables of contents. (line 9324)
-* \listoftables: Tables of contents. (line 9324)
-* \listparindent: list. (line 3199)
-* \ll: Math symbols. (line 6331)
-* \ln: Math functions. (line 6935)
-* \lnot: Math symbols. (line 6335)
+ (line 1797)
+* \listoffigures: Table of contents etc..
+ (line 12650)
+* \listoftables: Table of contents etc..
+ (line 12650)
+* \listparindent: list. (line 3847)
+* \ll: Math symbols. (line 8367)
+* \ln: Math functions. (line 9131)
+* \lnot: Math symbols. (line 8371)
* \LoadClass: Class and package commands.
- (line 1023)
+ (line 1087)
* \LoadClassWithOptions: Class and package commands.
- (line 1023)
-* \location: \location. (line 9590)
-* \log: Math functions. (line 6938)
-* \longleftarrow: Math symbols. (line 6338)
-* \longleftrightarrow: Math symbols. (line 6343)
-* \longmapsto: Math symbols. (line 6347)
-* \longrightarrow: Math symbols. (line 6352)
-* \lor: Math symbols. (line 6357)
-* \lq: Text symbols. (line 8910)
-* \makebox: \makebox. (line 7689)
-* \makebox (for picture): \makebox (picture). (line 3548)
-* \makeglossary: Glossaries. (line 9384)
-* \makeindex: Indexes. (line 9399)
-* \makelabel: list. (line 3114)
-* \makelabels: \makelabels. (line 9600)
-* \maketitle: \maketitle. (line 7229)
-* \mapsto: Math symbols. (line 6360)
-* \marginpar: Marginal notes. (line 5851)
+ (line 1087)
+* \location: \location. (line 13494)
+* \log: Math functions. (line 9134)
+* \longleftarrow: Math symbols. (line 8374)
+* \longleftrightarrow: Math symbols. (line 8379)
+* \longmapsto: Math symbols. (line 8383)
+* \longrightarrow: Math symbols. (line 8388)
+* \lor: Math symbols. (line 8393)
+* \lq: Text symbols. (line 12055)
+* \mainmatter: \frontmatter & \mainmatter & \backmatter.
+ (line 2520)
+* \makebox: \mbox & \makebox. (line 10555)
+* \makebox (for picture): \makebox (picture).
+ (line 4656)
+* \makeglossary: Glossaries. (line 13208)
+* \makeglossary <1>: Glossaries. (line 13245)
+* \makeindex: Indexes. (line 12884)
+* \makelabel: list. (line 3766)
+* \makelabels: \makelabels. (line 13504)
+* \maketitle: \maketitle. (line 9530)
+* \mapsto: Math symbols. (line 8396)
+* \marginpar: Marginal notes. (line 7798)
* \marginparpush: Page layout parameters.
- (line 1724)
+ (line 1803)
* \marginparpush <1>: Page layout parameters.
- (line 1727)
-* \marginparpush <2>: Marginal notes. (line 5881)
-* \marginparsep: Marginal notes. (line 5885)
+ (line 1806)
+* \marginparpush <2>: Marginal notes. (line 7827)
+* \marginparsep: Marginal notes. (line 7831)
* \marginparwidth: Page layout parameters.
- (line 1726)
+ (line 1805)
* \marginparwidth <1>: Page layout parameters.
- (line 1727)
-* \marginparwidth <2>: Marginal notes. (line 5889)
+ (line 1806)
+* \marginparwidth <2>: Marginal notes. (line 7835)
* \marginsep: Page layout parameters.
- (line 1725)
+ (line 1804)
* \marginsep <1>: Page layout parameters.
- (line 1727)
-* \markboth{LEFT}{RIGHT}: \pagestyle. (line 7303)
-* \markright{RIGHT}: \pagestyle. (line 7310)
-* \mathbf: Font styles. (line 1330)
-* \mathcal: Font styles. (line 1346)
-* \mathdollar: Math miscellany. (line 7103)
-* \mathellipsis: Math miscellany. (line 7106)
-* \mathnormal: Font styles. (line 1343)
-* \mathparagraph: Math miscellany. (line 7109)
-* \mathring: Math accents. (line 7008)
-* \mathrm: Font styles. (line 1327)
-* \mathsection: Math miscellany. (line 7112)
-* \mathsf: Font styles. (line 1333)
-* \mathsterling: Math miscellany. (line 7115)
-* \mathtt: Font styles. (line 1336)
-* \mathunderscore: Math miscellany. (line 7118)
-* \mathversion: Font styles. (line 1348)
-* \max: Math functions. (line 6941)
-* \mbox: \mbox. (line 7646)
-* \mbox, and LR mode: Modes. (line 7171)
-* \mdseries: Font styles. (line 1254)
-* \medskip: \bigskip \medskip \smallskip.
- (line 7571)
-* \medskipamount: \bigskip \medskip \smallskip.
- (line 7572)
+ (line 1806)
+* \markboth{LEFT-HEAD}{RIGHT-HEAD}: \pagestyle. (line 9729)
+* \markright{RIGHT}: \pagestyle. (line 9738)
+* \mathbf: Font styles. (line 1400)
+* \mathcal: Font styles. (line 1416)
+* \mathdollar: Math symbols. (line 8905)
+* \mathnormal: Font styles. (line 1413)
+* \mathparagraph: Math symbols. (line 8908)
+* \mathring: Math accents. (line 9206)
+* \mathrm: Font styles. (line 1397)
+* \mathsection: Math symbols. (line 8911)
+* \mathsf: Font styles. (line 1403)
+* \mathsterling: Math symbols. (line 8914)
+* \mathtt: Font styles. (line 1406)
+* \mathunderscore: Math symbols. (line 8917)
+* \mathversion: Font styles. (line 1418)
+* \max: Math functions. (line 9137)
+* \mbox: \mbox & \makebox. (line 10555)
+* \mdseries: Font styles. (line 1326)
+* \medskip: \bigskip & \medskip & \smallskip.
+ (line 10285)
+* \medskipamount: \bigskip & \medskip & \smallskip.
+ (line 10286)
* \medspace: Spacing in math mode.
- (line 7041)
-* \mho: Math symbols. (line 6364)
-* \mid: Math symbols. (line 6369)
-* \min: Math functions. (line 6944)
-* \models: Math symbols. (line 6379)
-* \month: \day \month \year. (line 5651)
-* \mp: Math symbols. (line 6384)
-* \mu: Math symbols. (line 6387)
-* \multicolumn: \multicolumn. (line 4133)
-* \multiput: \multiput. (line 3654)
-* \nabla: Math symbols. (line 6390)
-* \name: \name. (line 9622)
-* \natural: Math symbols. (line 6393)
-* \ne: Math symbols. (line 6396)
-* \nearrow: Math symbols. (line 6399)
+ (line 9294)
+* \mho: Math symbols. (line 8400)
+* \mid: Math symbols. (line 8405)
+* \min: Math functions. (line 9140)
+* \models: Math symbols. (line 8415)
+* \month: \day & \month & \year.
+ (line 7349)
+* \mp: Math symbols. (line 8420)
+* \mu: Math symbols. (line 8423)
+* \multicolumn: \multicolumn. (line 5189)
+* \multiput: \multiput. (line 4392)
+* \nabla: Math symbols. (line 8426)
+* \name: \name. (line 13561)
+* \natural: Math symbols. (line 8429)
+* \ne: Math symbols. (line 8432)
+* \nearrow: Math symbols. (line 8435)
* \NeedsTeXFormat: Class and package commands.
- (line 1055)
-* \neg: Math symbols. (line 6402)
-* \neq: Math symbols. (line 6406)
+ (line 1121)
+* \neg: Math symbols. (line 8438)
+* \negthinspace: Spacing in math mode.
+ (line 9312)
+* \negthinspace <1>: \thinspace & \negthinspace.
+ (line 10150)
+* \neq: Math symbols. (line 8442)
* \newcommand: \newcommand & \renewcommand.
- (line 4934)
-* \newcounter: \newcounter. (line 5040)
+ (line 6490)
+* \newcounter: \newcounter. (line 6643)
* \newenvironment: \newenvironment & \renewenvironment.
- (line 5094)
-* \newfont: \newfont. (line 5313)
-* \newlength: \newlength. (line 5064)
-* \newline: \newline. (line 4553)
-* \NEWLINE: \(SPACE) and \@. (line 7416)
-* \newpage: \newpage. (line 4667)
-* \newsavebox: \newsavebox. (line 5079)
-* \newtheorem: \newtheorem. (line 5201)
-* \newtie: Accents. (line 9132)
+ (line 6733)
+* \newfont: \newfont. (line 6979)
+* \newglossaryentry: \newglossaryentry. (line 13256)
+* \newlength: \newlength. (line 6684)
+* \newline: \newline. (line 5880)
+* \NEWLINE: \(SPACE). (line 10053)
+* \newpage: \newpage. (line 6124)
+* \newsavebox: \newsavebox. (line 6706)
+* \newtheorem: \newtheorem. (line 6867)
+* \newtie: Accents. (line 12285)
* \ng: Additional Latin letters.
- (line 9187)
+ (line 12332)
* \NG: Additional Latin letters.
- (line 9187)
-* \ni: Math symbols. (line 6409)
-* \nocite: \nocite. (line 4348)
-* \nocorr: Font styles. (line 1239)
-* \nocorrlist: Font styles. (line 1239)
-* \nofiles: Tables of contents. (line 9329)
-* \noindent: \noindent. (line 5830)
+ (line 12332)
+* \ni: Math symbols. (line 8445)
+* \nocite: \nocite. (line 5497)
+* \nocorr: Font styles. (line 1311)
+* \nocorrlist: Font styles. (line 1311)
+* \nofiles: \nofiles. (line 12859)
+* \noindent: \indent & \noindent.
+ (line 7722)
* \nolinebreak: \linebreak & \nolinebreak.
- (line 4627)
-* \nonfrenchspacing: \frenchspacing. (line 7448)
-* \nonumber: eqnarray. (line 2779)
+ (line 6021)
+* \nonfrenchspacing: \frenchspacing. (line 10023)
+* \nonumber: eqnarray. (line 3370)
* \nopagebreak: \pagebreak & \nopagebreak.
- (line 4688)
-* \normalfont: Font styles. (line 1275)
-* \normalmarginpar: Marginal notes. (line 5869)
-* \normalsfcodes: \normalsfcodes. (line 7461)
-* \normalsize: Font sizes. (line 1371)
-* \not: Math symbols. (line 6414)
-* \notin: Math symbols. (line 6422)
-* \nu: Math symbols. (line 6426)
-* \nwarrow: Math symbols. (line 6429)
+ (line 6182)
+* \normalfont: Font styles. (line 1347)
+* \normalmarginpar: Marginal notes. (line 7814)
+* \normalsfcodes: \normalsfcodes. (line 10043)
+* \normalsize: Font sizes. (line 1441)
+* \not: Math symbols. (line 8450)
+* \notin: Math symbols. (line 8458)
+* \nu: Math symbols. (line 8462)
+* \nwarrow: Math symbols. (line 8465)
* \o (/o): Additional Latin letters.
- (line 9191)
+ (line 12336)
* \O (/O): Additional Latin letters.
- (line 9191)
+ (line 12336)
* \obeycr: \obeycr & \restorecr.
- (line 4544)
+ (line 5840)
* \oddsidemargin: Document class options.
- (line 781)
+ (line 841)
* \oddsidemargin <1>: Page layout parameters.
- (line 1750)
+ (line 1829)
* \oddsidemargin <2>: Page layout parameters.
- (line 1752)
-* \odot: Math symbols. (line 6432)
+ (line 1831)
+* \odot: Math symbols. (line 8468)
* \oe (oe): Additional Latin letters.
- (line 9195)
+ (line 12340)
* \OE (OE): Additional Latin letters.
- (line 9195)
-* \oint: Math symbols. (line 6437)
-* \oldstylenums: Font styles. (line 1352)
-* \Omega: Math symbols. (line 6441)
-* \omega: Math symbols. (line 6444)
-* \ominus: Math symbols. (line 6447)
-* \onecolumn: \onecolumn. (line 1539)
-* \opening: \opening. (line 9632)
-* \oplus: Math symbols. (line 6450)
+ (line 12340)
+* \oint: Math symbols. (line 8473)
+* \oldstylenums: Font styles. (line 1422)
+* \Omega: Math symbols. (line 8477)
+* \omega: Math symbols. (line 8480)
+* \ominus: Math symbols. (line 8483)
+* \onecolumn: \onecolumn. (line 1618)
+* \opening: \opening. (line 13571)
+* \oplus: Math symbols. (line 8486)
* \OptionNotUsed: Class and package commands.
- (line 1071)
-* \oslash: Math symbols. (line 6454)
-* \otimes: Math symbols. (line 6457)
-* \oval: \oval. (line 3665)
-* \overbrace{MATH}: Math miscellany. (line 7121)
-* \overline{TEXT}: Math miscellany. (line 7125)
-* \owns: Math symbols. (line 6462)
-* \P: Text symbols. (line 8913)
+ (line 1139)
+* \oslash: Math symbols. (line 8490)
+* \otimes: Math symbols. (line 8493)
+* \oval: \oval. (line 4555)
+* \overbrace{MATH}: Over- and Underlining.
+ (line 9261)
+* \overline{TEXT}: Over- and Underlining.
+ (line 9242)
+* \owns: Math symbols. (line 8498)
+* \P: Text symbols. (line 12058)
* \PackageError: Class and package commands.
- (line 920)
+ (line 980)
* \PackageInfo: Class and package commands.
- (line 920)
+ (line 980)
* \PackageInfoNoLine: Class and package commands.
- (line 920)
+ (line 980)
* \PackageWarning: Class and package commands.
- (line 920)
+ (line 980)
* \PackageWarningNoLine: Class and package commands.
- (line 920)
+ (line 980)
* \pagebreak: \pagebreak & \nopagebreak.
- (line 4688)
-* \pagenumbering: \pagenumbering. (line 7255)
-* \pageref: \pageref. (line 2297)
-* \pagestyle: \pagestyle. (line 7280)
+ (line 6182)
+* \pagenumbering: \pagenumbering. (line 9602)
+* \pageref: \pageref. (line 2845)
+* \pagestyle: \pagestyle. (line 9660)
* \paperheight: Page layout parameters.
- (line 1763)
+ (line 1842)
* \paperheight <1>: Page layout parameters.
- (line 1764)
+ (line 1843)
* \paperwidth: Page layout parameters.
- (line 1769)
+ (line 1848)
* \paperwidth <1>: Page layout parameters.
- (line 1770)
-* \paragraph: Sectioning. (line 1980)
-* \parallel: Math symbols. (line 6467)
-* \parbox: \parbox. (line 7714)
-* \parindent: minipage. (line 3443)
-* \parindent <1>: \indent. (line 5819)
-* \parsep: list. (line 3205)
-* \parskip: \parskip. (line 5845)
-* \parskip example: itemize. (line 3046)
-* \part: Sectioning. (line 1974)
-* \partial: Math symbols. (line 6470)
-* \partopsep: list. (line 3214)
+ (line 1849)
+* \par: \par. (line 7671)
+* \paragraph: Sectioning. (line 2052)
+* \paragraph <1>: \subsubsection & \paragraph & \subparagraph.
+ (line 2420)
+* \parallel: Math symbols. (line 8503)
+* \parbox: \parbox. (line 10711)
+* \parindent: minipage. (line 4186)
+* \parindent <1>: \indent & \noindent.
+ (line 7722)
+* \parindent <2>: \parindent & \parskip.
+ (line 7771)
+* \parsep: list. (line 3853)
+* \parskip: \parindent & \parskip.
+ (line 7771)
+* \parskip example: itemize. (line 3691)
+* \part: Sectioning. (line 2052)
+* \part <1>: \part. (line 2131)
+* \partial: Math symbols. (line 8506)
+* \partopsep: list. (line 3862)
* \PassOptionsToClass: Class and package commands.
- (line 1077)
+ (line 1145)
* \PassOptionsToPackage: Class and package commands.
- (line 1077)
+ (line 1145)
* \pdfpageheight: Document class options.
- (line 737)
+ (line 797)
* \pdfpagewidth: Document class options.
- (line 737)
-* \perp: Math symbols. (line 6473)
-* \phi: Math symbols. (line 6478)
-* \Pi: Math symbols. (line 6482)
-* \pi: Math symbols. (line 6485)
-* \pm: Math symbols. (line 6489)
-* \pmod: Math functions. (line 6947)
-* \poptabs: tabbing. (line 3874)
-* \poptabs <1>: tabbing. (line 3875)
-* \pounds: Text symbols. (line 8917)
-* \Pr: Math functions. (line 6950)
-* \prec: Math symbols. (line 6492)
-* \preceq: Math symbols. (line 6495)
-* \prime: Math symbols. (line 6500)
-* \printindex: Indexes. (line 9421)
+ (line 797)
+* \perp: Math symbols. (line 8509)
+* \phi: Math symbols. (line 8514)
+* \Pi: Math symbols. (line 8518)
+* \pi: Math symbols. (line 8521)
+* \pm: Math symbols. (line 8525)
+* \pmod: Math functions. (line 9143)
+* \poptabs: tabbing. (line 4909)
+* \poptabs <1>: tabbing. (line 4910)
+* \pounds: Text symbols. (line 12062)
+* \Pr: Math functions. (line 9146)
+* \prec: Math symbols. (line 8528)
+* \preceq: Math symbols. (line 8531)
+* \prime: Math symbols. (line 8536)
+* \printglossaries: Glossaries. (line 13208)
+* \printglossaries <1>: Glossaries. (line 13245)
+* \printindex: \printindex. (line 13193)
+* \printindex <1>: \printindex. (line 13197)
* \ProcessOptions: Class and package commands.
- (line 1111)
+ (line 1182)
* \ProcessOptions*: Class and package commands.
- (line 1111)
-* \prod: Math symbols. (line 6509)
-* \propto: Math symbols. (line 6512)
-* \protect: \protect. (line 5348)
-* \providecommand: \providecommand. (line 5025)
+ (line 1182)
+* \prod: Math symbols. (line 8545)
+* \propto: Math symbols. (line 8548)
+* \protect: \protect. (line 7011)
+* \providecommand: \providecommand. (line 6615)
* \ProvidesClass: Class and package commands.
- (line 1149)
+ (line 1220)
* \ProvidesFile: Class and package commands.
- (line 1180)
+ (line 1253)
* \ProvidesPackage: Class and package commands.
- (line 1149)
-* \ps: \ps. (line 9645)
-* \Psi: Math symbols. (line 6515)
-* \psi: Math symbols. (line 6518)
-* \pushtabs: tabbing. (line 3877)
-* \put: \put. (line 3692)
+ (line 1220)
+* \ps: \ps. (line 13583)
+* \Psi: Math symbols. (line 8551)
+* \psi: Math symbols. (line 8554)
+* \pushtabs: tabbing. (line 4912)
+* \put: \put. (line 4374)
+* \qbezier: \qbezier. (line 4415)
* \qquad: Spacing in math mode.
- (line 7058)
+ (line 9323)
+* \qquad <1>: \enspace & \quad & \qquad.
+ (line 9782)
* \quad: Spacing in math mode.
- (line 7052)
-* \quotedblbase (,,): Text symbols. (line 8921)
-* \quotesinglbase (,): Text symbols. (line 8922)
-* \r (ring accent): Accents. (line 9126)
-* \raggedbottom: \raggedbottom. (line 1679)
-* \raggedleft: \raggedleft. (line 2966)
-* \raggedright: \raggedright. (line 2940)
-* \raisebox: \raisebox. (line 7757)
-* \rangle: Math symbols. (line 6521)
-* \rbrace: Math symbols. (line 6525)
-* \rbrack: Math symbols. (line 6529)
-* \rceil: Math symbols. (line 6533)
-* \Re: Math symbols. (line 6536)
-* \ref: \ref. (line 2318)
-* \reflectbox: \scalebox. (line 8723)
-* \refname: thebibliography. (line 4299)
-* \refstepcounter: \refstepcounter. (line 5630)
+ (line 9317)
+* \quad <1>: \enspace & \quad & \qquad.
+ (line 9782)
+* \quotedblbase (,,): Text symbols. (line 12066)
+* \quotesinglbase (,): Text symbols. (line 12067)
+* \r (ring accent): Accents. (line 12279)
+* \raggedbottom: \raggedbottom. (line 1758)
+* \raggedleft: \raggedleft. (line 3599)
+* \raggedright: \raggedright. (line 3548)
+* \raisebox: \raisebox. (line 10763)
+* \rangle: Math symbols. (line 8557)
+* \rbrace: Math symbols. (line 8562)
+* \rbrack: Math symbols. (line 8566)
+* \rceil: Math symbols. (line 8570)
+* \Re: Math symbols. (line 8573)
+* \ref: \ref. (line 2869)
+* \reflectbox: \scalebox. (line 11866)
+* \refstepcounter: \refstepcounter. (line 7315)
* \renewenvironment: \newenvironment & \renewenvironment.
- (line 5094)
+ (line 6733)
* \RequirePackage: Class and package commands.
- (line 1189)
+ (line 1262)
* \RequirePackageWithOptions: Class and package commands.
- (line 1189)
-* \resizebox: \resizebox. (line 8751)
+ (line 1262)
+* \resizebox: \resizebox. (line 11897)
* \restorecr: \obeycr & \restorecr.
- (line 4544)
-* \restriction: Math symbols. (line 6541)
-* \revemptyset: Math symbols. (line 6546)
-* \reversemarginpar: Marginal notes. (line 5869)
-* \rfloor: Math symbols. (line 6551)
-* \rhd: Math symbols. (line 6555)
-* \rho: Math symbols. (line 6562)
-* \right: Math miscellany. (line 7099)
-* \Rightarrow: Math symbols. (line 6566)
-* \rightarrow: Math symbols. (line 6570)
-* \rightharpoondown: Math symbols. (line 6575)
-* \rightharpoonup: Math symbols. (line 6578)
-* \rightleftharpoons: Math symbols. (line 6581)
-* \rightmargin: list. (line 3229)
-* \rm: Font styles. (line 1297)
-* \rmfamily: Font styles. (line 1248)
+ (line 5840)
+* \restriction: Math symbols. (line 8578)
+* \revemptyset: Math symbols. (line 8583)
+* \reversemarginpar: Marginal notes. (line 7814)
+* \rfloor: Math symbols. (line 8588)
+* \rhd: Math symbols. (line 8592)
+* \rho: Math symbols. (line 8599)
+* \right: \left & \right. (line 9383)
+* \Rightarrow: Math symbols. (line 8603)
+* \rightarrow: Math symbols. (line 8608)
+* \rightharpoondown: Math symbols. (line 8612)
+* \rightharpoonup: Math symbols. (line 8615)
+* \rightleftharpoons: Math symbols. (line 8618)
+* \rightmargin: list. (line 3877)
+* \rm: Font styles. (line 1373)
+* \rmfamily: Font styles. (line 1320)
* \roman{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 5516)
+ (line 7187)
* \Roman{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 5519)
-* \rotatebox: \rotatebox. (line 8658)
-* \rq: Text symbols. (line 8925)
-* \rule: \rule. (line 9210)
-* \S: Text symbols. (line 8928)
-* \savebox: \savebox. (line 7773)
-* \sbox: \sbox. (line 7785)
-* \sc: Font styles. (line 1300)
-* \scalebox: \scalebox. (line 8723)
-* \scriptsize: Font sizes. (line 1371)
-* \scshape: Font styles. (line 1269)
-* \searrow: Math symbols. (line 6584)
-* \sec: Math functions. (line 6953)
-* \section: Sectioning. (line 1977)
-* \seename: Indexes. (line 9413)
+ (line 7192)
+* \rotatebox: \rotatebox. (line 11799)
+* \rq: Text symbols. (line 12070)
+* \rule: \rule. (line 12355)
+* \S: Text symbols. (line 12073)
+* \savebox: \sbox & \savebox. (line 10809)
+* \sbox: \sbox & \savebox. (line 10809)
+* \sc: Font styles. (line 1376)
+* \scalebox: \scalebox. (line 11866)
+* \scriptsize: Font sizes. (line 1441)
+* \scshape: Font styles. (line 1341)
+* \searrow: Math symbols. (line 8621)
+* \sec: Math functions. (line 9149)
+* \section: Sectioning. (line 2052)
+* \section <1>: \section. (line 2278)
+* \seename: \index. (line 12970)
* \selectfont: Low-level font commands.
- (line 1517)
-* \setcounter: \setcounter. (line 5602)
-* \setlength: \setlength. (line 5740)
-* \setminus: Math symbols. (line 6587)
-* \settodepth: \settodepth. (line 5762)
-* \settoheight: \settoheight. (line 5772)
-* \settowidth: \settowidth. (line 5782)
-* \sf: Font styles. (line 1303)
-* \sffamily: Font styles. (line 1266)
-* \sharp: Math symbols. (line 6593)
-* \shortstack: \shortstack. (line 3702)
-* \Sigma: Math symbols. (line 6596)
-* \sigma: Math symbols. (line 6599)
-* \signature: \signature. (line 9662)
-* \sim: Math symbols. (line 6603)
-* \simeq: Math symbols. (line 6606)
-* \sin: Math functions. (line 6956)
-* \sinh: Math functions. (line 6959)
-* \sl: Font styles. (line 1306)
-* \sloppy: \sloppy. (line 4603)
-* \slshape: Font styles. (line 1263)
-* \small: Font sizes. (line 1371)
-* \smallint: Math symbols. (line 6609)
-* \smallskip: \bigskip \medskip \smallskip.
- (line 7576)
-* \smallskipamount: \bigskip \medskip \smallskip.
- (line 7577)
-* \smile: Math symbols. (line 6613)
-* \spacefactor: \spacefactor. (line 7369)
-* \spadesuit: Math symbols. (line 6616)
-* \sqcap: Math symbols. (line 6619)
-* \sqcup: Math symbols. (line 6623)
-* \sqrt[ROOT]{ARG}: Math miscellany. (line 7129)
-* \sqsubset: Math symbols. (line 6627)
-* \sqsubseteq: Math symbols. (line 6632)
-* \sqsupset: Math symbols. (line 6637)
-* \sqsupseteq: Math symbols. (line 6642)
+ (line 1596)
+* \setcounter: \setcounter. (line 7281)
+* \setlength: \setlength. (line 7512)
+* \setminus: Math symbols. (line 8624)
+* \settodepth: \settodepth. (line 7562)
+* \settoheight: \settoheight. (line 7585)
+* \settowidth: \settowidth. (line 7608)
+* \sf: Font styles. (line 1379)
+* \sffamily: Font styles. (line 1338)
+* \sharp: Math symbols. (line 8630)
+* \shortstack: \shortstack. (line 4591)
+* \Sigma: Math symbols. (line 8633)
+* \sigma: Math symbols. (line 8636)
+* \signature: \signature. (line 13600)
+* \sim: Math symbols. (line 8640)
+* \simeq: Math symbols. (line 8643)
+* \sin: Math functions. (line 9152)
+* \sinh: Math functions. (line 9155)
+* \sl: Font styles. (line 1382)
+* \sloppy: \fussy & \sloppy. (line 5962)
+* \slshape: Font styles. (line 1335)
+* \small: Font sizes. (line 1441)
+* \smallint: Math symbols. (line 8646)
+* \smallskip: \bigskip & \medskip & \smallskip.
+ (line 10290)
+* \smallskipamount: \bigskip & \medskip & \smallskip.
+ (line 10291)
+* \smile: Math symbols. (line 8650)
+* \SPACE: \(SPACE). (line 10053)
+* \spacefactor: \spacefactor. (line 9916)
+* \spadesuit: Math symbols. (line 8653)
+* \sqcap: Math symbols. (line 8656)
+* \sqcup: Math symbols. (line 8660)
+* \sqrt: \sqrt. (line 9418)
+* \sqsubset: Math symbols. (line 8664)
+* \sqsubseteq: Math symbols. (line 8669)
+* \sqsupset: Math symbols. (line 8674)
+* \sqsupseteq: Math symbols. (line 8679)
* \ss (ss): Additional Latin letters.
- (line 9199)
+ (line 12344)
* \SS (SS): Additional Latin letters.
- (line 9199)
-* \stackrel{TEXT}{RELATION}: Math miscellany. (line 7134)
-* \star: Math symbols. (line 6646)
-* \stepcounter: \stepcounter. (line 5644)
-* \stop: Command line. (line 9743)
-* \subparagraph: Sectioning. (line 1981)
-* \subsection: Sectioning. (line 1978)
-* \subset: Math symbols. (line 6653)
-* \subseteq: Math symbols. (line 6656)
-* \subsubsection: Sectioning. (line 1979)
-* \succ: Math symbols. (line 6659)
-* \succeq: Math symbols. (line 6663)
-* \sum: Math symbols. (line 6668)
-* \sup: Math functions. (line 6962)
-* \suppressfloats: Floats. (line 1903)
-* \supset: Math symbols. (line 6672)
-* \supseteq: Math symbols. (line 6675)
-* \surd: Math symbols. (line 6678)
-* \swarrow: Math symbols. (line 6683)
+ (line 12344)
+* \stackrel: \stackrel. (line 9434)
+* \star: Math symbols. (line 8684)
+* \stepcounter: \stepcounter. (line 7333)
+* \stop: Recovering from errors.
+ (line 13911)
+* \strut: \strut. (line 10334)
+* \subparagraph: Sectioning. (line 2052)
+* \subparagraph <1>: \subsubsection & \paragraph & \subparagraph.
+ (line 2420)
+* \subsection: Sectioning. (line 2052)
+* \subsection <1>: \subsection. (line 2356)
+* \subset: Math symbols. (line 8692)
+* \subseteq: Math symbols. (line 8695)
+* \subsubsection: \subsubsection & \paragraph & \subparagraph.
+ (line 2420)
+* \succ: Math symbols. (line 8698)
+* \succeq: Math symbols. (line 8702)
+* \sum: Math symbols. (line 8707)
+* \sup: Math functions. (line 9158)
+* \suppressfloats: Floats. (line 1983)
+* \supset: Math symbols. (line 8711)
+* \supseteq: Math symbols. (line 8714)
+* \surd: Math symbols. (line 8717)
+* \swarrow: Math symbols. (line 8722)
* \symbol: Symbols by font position.
- (line 8865)
-* \t (tie-after accent): Accents. (line 9132)
-* \TAB: \(SPACE) and \@. (line 7416)
-* \tabbingsep: tabbing. (line 3882)
-* \tabcolsep: tabular. (line 4122)
-* \tableofcontents: Tables of contents. (line 9314)
-* \tan: Math functions. (line 6965)
-* \tanh: Math functions. (line 6968)
-* \tau: Math symbols. (line 6686)
-* \telephone: \telephone. (line 9686)
-* \TeX: Text symbols. (line 8931)
-* \textascendercompwordmark: Text symbols. (line 8969)
-* \textasciicircum: Text symbols. (line 8934)
-* \textasciitilde: Text symbols. (line 8937)
-* \textasteriskcentered: Text symbols. (line 8940)
+ (line 12009)
+* \t (tie-after accent): Accents. (line 12285)
+* \TAB: \(SPACE). (line 10053)
+* \tabbingsep: tabbing. (line 4917)
+* \tabcolsep: tabular. (line 5178)
+* \tableofcontents: Table of contents etc..
+ (line 12650)
+* \tan: Math functions. (line 9161)
+* \tanh: Math functions. (line 9164)
+* \tau: Math symbols. (line 8725)
+* \telephone: \telephone. (line 13630)
+* \TeX: Text symbols. (line 12077)
+* \textascendercompwordmark: Text symbols. (line 12115)
+* \textasciicircum: Text symbols. (line 12080)
+* \textasciitilde: Text symbols. (line 12083)
+* \textasteriskcentered: Text symbols. (line 12086)
* \textbackslash: Reserved characters.
- (line 8800)
-* \textbackslash <1>: Text symbols. (line 8943)
-* \textbar: Text symbols. (line 8946)
-* \textbardbl: Text symbols. (line 8949)
-* \textbf: Font styles. (line 1257)
-* \textbigcircle: Text symbols. (line 8952)
-* \textbraceleft: Text symbols. (line 8955)
-* \textbraceright: Text symbols. (line 8958)
-* \textbullet: Text symbols. (line 8961)
-* \textcapitalcompwordmark: Text symbols. (line 8968)
-* \textcircled{LETTER}: Text symbols. (line 8964)
-* \textcompwordmark: Text symbols. (line 8967)
-* \textcopyright: Text symbols. (line 8882)
-* \textdagger: Text symbols. (line 8974)
-* \textdaggerdbl: Text symbols. (line 8977)
-* \textdollar (or \$): Text symbols. (line 8980)
-* \textellipsis: Text symbols. (line 8906)
-* \textemdash (or ---): Text symbols. (line 8983)
-* \textendash (or --): Text symbols. (line 8986)
-* \texteuro: Text symbols. (line 8989)
-* \textexclamdown (or !`): Text symbols. (line 8992)
-* \textfloatsep: Floats. (line 1939)
-* \textfloatsep <1>: Floats. (line 1940)
-* \textfraction: Floats. (line 1918)
-* \textfraction <1>: Floats. (line 1919)
-* \textgreater: Text symbols. (line 8995)
+ (line 11946)
+* \textbackslash <1>: Text symbols. (line 12089)
+* \textbar: Text symbols. (line 12092)
+* \textbardbl: Text symbols. (line 12095)
+* \textbf: Font styles. (line 1329)
+* \textbigcircle: Text symbols. (line 12098)
+* \textbraceleft: Text symbols. (line 12101)
+* \textbraceright: Text symbols. (line 12104)
+* \textbullet: Text symbols. (line 12107)
+* \textcapitalcompwordmark: Text symbols. (line 12114)
+* \textcircled{LETTER}: Text symbols. (line 12110)
+* \textcompwordmark: Text symbols. (line 12113)
+* \textcopyright: Text symbols. (line 12027)
+* \textdagger: Text symbols. (line 12122)
+* \textdaggerdbl: Text symbols. (line 12125)
+* \textdollar (or \$): Text symbols. (line 12128)
+* \textellipsis: Text symbols. (line 12051)
+* \textemdash (or ---): Text symbols. (line 12131)
+* \textendash (or --): Text symbols. (line 12136)
+* \texteuro: Text symbols. (line 12139)
+* \textexclamdown (or !`): Text symbols. (line 12145)
+* \textfloatsep: Floats. (line 2019)
+* \textfloatsep <1>: Floats. (line 2020)
+* \textfraction: Floats. (line 1998)
+* \textfraction <1>: Floats. (line 1999)
+* \textgreater: Text symbols. (line 12148)
* \textheight: Page layout parameters.
- (line 1775)
+ (line 1854)
* \textheight <1>: Page layout parameters.
- (line 1776)
-* \textit: Font styles. (line 1251)
-* \textleftarrow: Text symbols. (line 9001)
-* \textless: Text symbols. (line 8998)
-* \textmd: Font styles. (line 1254)
-* \textnormal: Font styles. (line 1275)
-* \textordfeminine: Text symbols. (line 9004)
-* \textordmasculine: Text symbols. (line 9005)
-* \textparagraph: Text symbols. (line 8914)
-* \textperiodcentered: Text symbols. (line 9008)
-* \textquestiondown (or ?`): Text symbols. (line 9011)
-* \textquotedblleft (or ``): Text symbols. (line 9014)
-* \textquotedblright (or ''): Text symbols. (line 9017)
-* \textquoteleft (or `): Text symbols. (line 9020)
-* \textquoteright (or '): Text symbols. (line 9023)
-* \textquotesingle: Text symbols. (line 9026)
-* \textquotestraightbase: Text symbols. (line 9029)
-* \textquotestraightdblbase: Text symbols. (line 9030)
-* \textregistered: Text symbols. (line 9033)
-* \textrightarrow: Text symbols. (line 9036)
-* \textrm: Font styles. (line 1248)
-* \textsc: Font styles. (line 1269)
-* \textsf: Font styles. (line 1266)
-* \textsl: Font styles. (line 1263)
-* \textsterling: Text symbols. (line 8918)
-* \textthreequartersemdash: Text symbols. (line 9039)
-* \texttrademark: Text symbols. (line 9042)
-* \texttt: Font styles. (line 1272)
-* \texttwelveudash: Text symbols. (line 9045)
-* \textunderscore: Text symbols. (line 9048)
-* \textup: Font styles. (line 1260)
-* \textvisiblespace: Text symbols. (line 9051)
+ (line 1855)
+* \textit: Font styles. (line 1323)
+* \textleftarrow: Text symbols. (line 12154)
+* \textless: Text symbols. (line 12151)
+* \textmd: Font styles. (line 1326)
+* \textnormal: Font styles. (line 1347)
+* \textordfeminine: Text symbols. (line 12157)
+* \textordmasculine: Text symbols. (line 12158)
+* \textparagraph: Text symbols. (line 12059)
+* \textperiodcentered: Text symbols. (line 12161)
+* \textquestiondown (or ?`): Text symbols. (line 12164)
+* \textquotedblleft (or ``): Text symbols. (line 12167)
+* \textquotedblright (or ''): Text symbols. (line 12170)
+* \textquoteleft (or `): Text symbols. (line 12173)
+* \textquoteright (or '): Text symbols. (line 12176)
+* \textquotesingle: Text symbols. (line 12179)
+* \textquotestraightbase: Text symbols. (line 12182)
+* \textquotestraightdblbase: Text symbols. (line 12183)
+* \textregistered: Text symbols. (line 12186)
+* \textrightarrow: Text symbols. (line 12189)
+* \textrm: Font styles. (line 1320)
+* \textsc: Font styles. (line 1341)
+* \textsection: Text symbols. (line 12074)
+* \textsf: Font styles. (line 1338)
+* \textsl: Font styles. (line 1335)
+* \textsterling: Text symbols. (line 12063)
+* \textthreequartersemdash: Text symbols. (line 12192)
+* \texttrademark: Text symbols. (line 12195)
+* \texttt: Font styles. (line 1344)
+* \texttwelveudash: Text symbols. (line 12198)
+* \textunderscore: Text symbols. (line 12201)
+* \textup: Font styles. (line 1332)
+* \textvisiblespace: Text symbols. (line 12204)
* \textwidth: Page layout parameters.
- (line 1783)
+ (line 1862)
* \textwidth <1>: Page layout parameters.
- (line 1784)
+ (line 1863)
* \th (th): Additional Latin letters.
- (line 9203)
+ (line 12348)
* \TH (TH): Additional Latin letters.
- (line 9203)
-* \thanks{TEXT}: \maketitle. (line 7244)
-* \theta: Math symbols. (line 6689)
-* \thicklines: \thicklines. (line 3640)
+ (line 12348)
+* \thanks{TEXT}: \maketitle. (line 9580)
+* \theta: Math symbols. (line 8728)
+* \thicklines: \thicklines. (line 4528)
* \thickspace: Spacing in math mode.
- (line 7036)
-* \thinlines: \thinlines. (line 3647)
+ (line 9289)
+* \thinlines: \thinlines. (line 4520)
* \thinspace: Spacing in math mode.
- (line 7045)
-* \thinspace <1>: \thinspace. (line 7486)
-* \thispagestyle: \thispagestyle. (line 7316)
-* \tilde: Math accents. (line 7011)
-* \times: Math symbols. (line 6693)
-* \tiny: Font sizes. (line 1371)
-* \title{TEXT}: \maketitle. (line 7248)
-* \to: Math symbols. (line 6697)
-* \today: \today. (line 9229)
-* \top: Math symbols. (line 6701)
-* \topfraction: Floats. (line 1923)
-* \topfraction <1>: Floats. (line 1924)
+ (line 9298)
+* \thinspace <1>: \thinspace & \negthinspace.
+ (line 10150)
+* \thispagestyle: \thispagestyle. (line 9744)
+* \tilde: Math accents. (line 9209)
+* \times: Math symbols. (line 8732)
+* \tiny: Font sizes. (line 1441)
+* \title{TEXT}: \maketitle. (line 9587)
+* \to: Math symbols. (line 8736)
+* \today: \today. (line 12390)
+* \top: Math symbols. (line 8740)
+* \topfraction: Floats. (line 2003)
+* \topfraction <1>: Floats. (line 2004)
* \topmargin: Page layout parameters.
- (line 1807)
-* \topsep: list. (line 3234)
+ (line 1887)
+* \topsep: list. (line 3882)
* \topskip: Page layout parameters.
- (line 1814)
+ (line 1894)
* \topskip <1>: Page layout parameters.
- (line 1815)
-* \totalheight: Predefined lengths. (line 5798)
-* \triangle: Math symbols. (line 6706)
-* \triangleleft: Math symbols. (line 6709)
-* \triangleright: Math symbols. (line 6715)
-* \tt: Font styles. (line 1309)
-* \ttfamily: Font styles. (line 1272)
-* \twocolumn: \twocolumn. (line 1548)
-* \typein: \typein. (line 9701)
-* \typeout: \typeout. (line 9715)
-* \u (breve accent): Accents. (line 9137)
-* \unboldmath: Math formulas. (line 5924)
-* \underbar: Accents. (line 9140)
-* \underbrace{MATH}: Math miscellany. (line 7138)
-* \underline{TEXT}: Math miscellany. (line 7142)
-* \unitlength: picture. (line 3464)
-* \unlhd: Math symbols. (line 6721)
-* \unrhd: Math symbols. (line 6728)
-* \Uparrow: Math symbols. (line 6735)
-* \uparrow: Math symbols. (line 6739)
-* \Updownarrow: Math symbols. (line 6743)
-* \updownarrow: Math symbols. (line 6748)
-* \upharpoonright: Math symbols. (line 6753)
-* \uplus: Math symbols. (line 6758)
-* \upshape: Font styles. (line 1260)
-* \Upsilon: Math symbols. (line 6765)
-* \upsilon: Math symbols. (line 6768)
-* \usebox: \usebox. (line 7797)
-* \usecounter: \usecounter. (line 5547)
+ (line 1895)
+* \triangle: Math symbols. (line 8745)
+* \triangleleft: Math symbols. (line 8748)
+* \triangleright: Math symbols. (line 8754)
+* \tt: Font styles. (line 1385)
+* \ttfamily: Font styles. (line 1344)
+* \twocolumn: \twocolumn. (line 1630)
+* \typein: \typein. (line 13645)
+* \typeout: \typeout. (line 13690)
+* \u (breve accent): Accents. (line 12289)
+* \unboldmath: \boldmath & \unboldmath.
+ (line 8967)
+* \unboldmath <1>: \boldmath & \unboldmath.
+ (line 8975)
+* \underbar: Accents. (line 12255)
+* \underbrace{MATH}: Over- and Underlining.
+ (line 9247)
+* \underline{TEXT}: Over- and Underlining.
+ (line 9230)
+* \unitlength: picture. (line 4259)
+* \unlhd: Math symbols. (line 8760)
+* \unrhd: Math symbols. (line 8767)
+* \Uparrow: Math symbols. (line 8774)
+* \uparrow: Math symbols. (line 8778)
+* \Updownarrow: Math symbols. (line 8782)
+* \updownarrow: Math symbols. (line 8787)
+* \upharpoonright: Math symbols. (line 8792)
+* \uplus: Math symbols. (line 8797)
+* \upshape: Font styles. (line 1332)
+* \Upsilon: Math symbols. (line 8804)
+* \upsilon: Math symbols. (line 8807)
+* \usebox: \usebox. (line 10915)
+* \usecounter: \usecounter. (line 7222)
* \usefont: Low-level font commands.
- (line 1525)
+ (line 1604)
* \usepackage: Additional packages.
- (line 802)
-* \v (breve accent): Accents. (line 9148)
-* \value: \value. (line 5573)
-* \vanothing: Math symbols. (line 6776)
-* \varepsilon: Math symbols. (line 6771)
-* \varphi: Math symbols. (line 6781)
-* \varpi: Math symbols. (line 6785)
-* \varrho: Math symbols. (line 6789)
-* \varsigma: Math symbols. (line 6793)
-* \vartheta: Math symbols. (line 6797)
-* \vdash: Math symbols. (line 6801)
-* \vdots: Math miscellany. (line 7147)
-* \vec: Math accents. (line 7014)
-* \vector: \vector. (line 3721)
-* \vee: Math symbols. (line 6805)
-* \verb: \verb. (line 4465)
-* \Vert: Math symbols. (line 6810)
-* \vert: Math symbols. (line 6826)
-* \vfill: \vfill. (line 7584)
-* \vline: \vline. (line 4214)
-* \vspace: \vspace. (line 7610)
-* \wedge: Math symbols. (line 6844)
-* \widehat: Math accents. (line 7017)
-* \widetilde: Math accents. (line 7020)
-* \width: Predefined lengths. (line 5792)
-* \wp: Math symbols. (line 6848)
-* \wr: Math symbols. (line 6851)
-* \Xi: Math symbols. (line 6854)
-* \xi: Math symbols. (line 6857)
-* \year: \day \month \year. (line 5651)
-* \zeta: Math symbols. (line 6860)
-* \[: Math formulas. (line 5911)
-* \\ (for center): center. (line 2477)
-* \\ (for eqnarray): eqnarray. (line 2767)
-* \\ (for flushright): flushright. (line 2959)
-* \\ (for \shortstack objects): \shortstack. (line 3716)
-* \\ (tabbing): tabbing. (line 3827)
-* \\ for flushleft: flushleft. (line 2933)
-* \\ for letters: Letters. (line 9483)
-* \\ for tabular: tabular. (line 3985)
-* \\ for verse: verse. (line 4493)
-* \\ for \author: \maketitle. (line 7235)
-* \\ for \title: \maketitle. (line 7249)
-* \\ force line break: \\. (line 4512)
-* \\* (for eqnarray): eqnarray. (line 2775)
-* \]: Math formulas. (line 5911)
+ (line 862)
+* \v (breve accent): Accents. (line 12293)
+* \value: \value. (line 7248)
+* \vanothing: Math symbols. (line 8815)
+* \varepsilon: Math symbols. (line 8810)
+* \varphi: Math symbols. (line 8820)
+* \varpi: Math symbols. (line 8824)
+* \varrho: Math symbols. (line 8828)
+* \varsigma: Math symbols. (line 8832)
+* \vartheta: Math symbols. (line 8836)
+* \vdash: Math symbols. (line 8840)
+* \vdots: Dots. (line 9035)
+* \vec: Math accents. (line 9212)
+* \vector: \vector. (line 4633)
+* \vee: Math symbols. (line 8844)
+* \verb: \verb. (line 5678)
+* \Vert: Math symbols. (line 8849)
+* \vert: Math symbols. (line 8865)
+* \vfill: \vfill. (line 10470)
+* \vline: \vline. (line 5271)
+* \vspace: \vspace. (line 10419)
+* \wedge: Math symbols. (line 8883)
+* \widehat: Math accents. (line 9215)
+* \widetilde: Math accents. (line 9218)
+* \wp: Math symbols. (line 8887)
+* \wr: Math symbols. (line 8890)
+* \Xi: Math symbols. (line 8893)
+* \xi: Math symbols. (line 8896)
+* \year: \day & \month & \year.
+ (line 7349)
+* \zeta: Math symbols. (line 8899)
+* \\ (for center): center. (line 3050)
+* \\ (for eqnarray): eqnarray. (line 3358)
+* \\ (for flushright): flushright. (line 3587)
+* \\ (for \shortstack objects): \shortstack. (line 4617)
+* \\ (tabbing): tabbing. (line 4862)
+* \\ for flushleft: flushleft. (line 3528)
+* \\ for letters: Letters. (line 13388)
+* \\ for tabular: tabular. (line 5040)
+* \\ for verse: verse. (line 5740)
+* \\ for \author: \maketitle. (line 9567)
+* \\ for \title: \maketitle. (line 9588)
+* \\ force line break: \\. (line 5778)
+* \\* (for eqnarray): eqnarray. (line 3366)
* \^: Reserved characters.
- (line 8800)
-* \^ (circumflex accent): Accents. (line 9084)
+ (line 11946)
+* \^ (circumflex accent): Accents. (line 12242)
* \_: Reserved characters.
- (line 8793)
-* \` (grave accent): Accents. (line 9088)
-* \` (tabbing): tabbing. (line 3854)
+ (line 11939)
+* \` (grave accent): Accents. (line 12246)
+* \` (tabbing): tabbing. (line 4889)
* \{: Reserved characters.
- (line 8793)
-* \|: Math symbols. (line 5984)
+ (line 11939)
+* \|: Math symbols. (line 8013)
* \}: Reserved characters.
- (line 8793)
+ (line 11939)
* \~: Reserved characters.
- (line 8800)
-* \~ (tilde accent): Accents. (line 9094)
+ (line 11946)
+* \~ (tilde accent): Accents. (line 12250)
* ^: Subscripts & superscripts.
- (line 5938)
+ (line 7938)
* _: Subscripts & superscripts.
- (line 5938)
+ (line 7938)
+* 'see' and 'see also' index entries: \index. (line 12970)
* {...} for required arguments: LaTeX command syntax.
- (line 486)
+ (line 520)
+* ~: ~. (line 10094)
* a4paper option: Document class options.
- (line 716)
+ (line 776)
* a5paper option: Document class options.
- (line 716)
-* abstract environment: abstract. (line 2357)
-* array environment: array. (line 2403)
-* article class: Document classes. (line 674)
+ (line 776)
+* abstract environment: abstract. (line 2915)
+* abstracts: abstract. (line 2915)
+* accents: Accents. (line 12210)
+* accents, mathematical: Math accents. (line 9178)
+* accessing any character of a font: Symbols by font position.
+ (line 12009)
+* acronyms, list of: Glossaries. (line 13208)
+* acute accent: Accents. (line 12231)
+* acute accent, math: Math accents. (line 9183)
+* additional packages, loading: Additional packages.
+ (line 862)
+* ae ligature: Additional Latin letters.
+ (line 12308)
+* algorithm2e package: tabbing. (line 4942)
+* align environment, from amsmath: eqnarray. (line 3335)
+* aligning equations: eqnarray. (line 3335)
+* alignment via tabbing: tabbing. (line 4802)
+* amsfonts package: Math formulas. (line 7927)
+* amsmath package: array. (line 3010)
+* amsmath package <1>: array. (line 3021)
+* amsmath package <2>: displaymath. (line 3202)
+* amsmath package <3>: equation. (line 3405)
+* amsmath package <4>: theorem. (line 5592)
+* amsmath package <5>: Math formulas. (line 7927)
+* amsmath package <6>: Dots. (line 9038)
+* amsmath package <7>: Math functions. (line 9167)
+* amsmath package <8>: Colon character & \colon.
+ (line 9344)
+* amsmath package <9>: Colon character & \colon.
+ (line 9348)
+* amsmath package, replacing eqnarray: eqnarray. (line 3335)
+* amsthm package: theorem. (line 5592)
+* amsthm package <1>: \rule. (line 12367)
+* appendices: \appendix. (line 2487)
+* appendix: \appendix. (line 2487)
+* appendix package: \appendix. (line 2510)
+* aring: Additional Latin letters.
+ (line 12304)
+* array (package) package: array. (line 3032)
+* array environment: array. (line 2961)
+* arrays, math: array. (line 2961)
+* arrow, left, in text: Text symbols. (line 12155)
+* arrow, right, in text: Text symbols. (line 12190)
+* article class: Document classes. (line 734)
+* ascender height: Text symbols. (line 12116)
+* ASCII circumflex, in text: Text symbols. (line 12081)
+* ASCII tilde, in text: Text symbols. (line 12084)
+* asterisk, centered, in text: Text symbols. (line 12087)
+* Asymptote package: \line. (line 4494)
+* Asymptote package <1>: \strut. (line 10390)
+* Asymptote package <2>: \mbox & \makebox. (line 10622)
+* at clause, in font definitions: \newfont. (line 6992)
+* at-sign: \@. (line 9977)
+* author, for titlepage: \maketitle. (line 9567)
+* auxiliary file: Output files. (line 449)
* b5paper option: Document class options.
- (line 716)
-* book class: Document classes. (line 674)
-* bottomnumber: Floats. (line 1946)
-* bottomnumber <1>: Floats. (line 1947)
-* bp: Units of length. (line 5704)
-* cc: Units of length. (line 5717)
-* center environment: center. (line 2469)
+ (line 776)
+* babel package: \chapter. (line 2250)
+* babel package <1>: thebibliography. (line 5384)
+* babel package <2>: Accents. (line 12210)
+* babel package <3>: \today. (line 12397)
+* babel package <4>: Table of contents etc..
+ (line 12724)
+* babel package <5>: \index. (line 12970)
+* background, colored: Colored pages. (line 11162)
+* backslash, in text: Text symbols. (line 12090)
+* bar, double vertical, in text: Text symbols. (line 12096)
+* bar, vertical, in text: Text symbols. (line 12093)
+* bar-over accent: Accents. (line 12238)
+* bar-over accent, math: Math accents. (line 9186)
+* bar-under accent: Accents. (line 12253)
+* basics of LaTeX: Overview. (line 364)
+* beamer template and class: beamer template. (line 13938)
+* beginning of document hook: \AtBeginDocument. (line 3236)
+* bibliography format, open: Document class options.
+ (line 824)
+* bibliography, creating (automatically): Using BibTeX. (line 5512)
+* bibliography, creating (manually): thebibliography. (line 5337)
+* bibTeX, using: Using BibTeX. (line 5512)
+* big circle symbols, in text: Text symbols. (line 12099)
+* Big point: Units of length. (line 7476)
+* bigfoot package: Footnotes of footnotes.
+ (line 6469)
+* black boxes, omitting: Document class options.
+ (line 810)
+* blackboard bold: Blackboard bold. (line 8923)
+* bm package: \boldmath & \unboldmath.
+ (line 8993)
+* bold font: Font styles. (line 1365)
+* bold math: Font styles. (line 1418)
+* bold typewriter, avoiding: description. (line 3160)
+* boldface mathematics: \boldmath & \unboldmath.
+ (line 8967)
+* book class: Document classes. (line 734)
+* book, back matter: \frontmatter & \mainmatter & \backmatter.
+ (line 2520)
+* book, end matter: \frontmatter & \mainmatter & \backmatter.
+ (line 2520)
+* book, front matter: \frontmatter & \mainmatter & \backmatter.
+ (line 2520)
+* book, main matter: \frontmatter & \mainmatter & \backmatter.
+ (line 2520)
+* bottomnumber: Floats. (line 2026)
+* bottomnumber <1>: Floats. (line 2027)
+* box: \mbox & \makebox. (line 10555)
+* box, allocating new: \newsavebox. (line 6706)
+* box, colored: Colored boxes. (line 11125)
+* box, save: \sbox & \savebox. (line 10809)
+* box, use saved box: \usebox. (line 10915)
+* boxes: Boxes. (line 10546)
+* bp: Units of length. (line 7476)
+* brace, left, in text: Text symbols. (line 12102)
+* brace, right, in text: Text symbols. (line 12105)
+* breaking lines: Line breaking. (line 5761)
+* breaking pages: Page breaking. (line 6052)
+* breaks, multiplication discretionary: \*. (line 9355)
+* breve accent: Accents. (line 12289)
+* breve accent, math: Math accents. (line 9189)
+* bug reporting: About this document.
+ (line 335)
+* bullet lists: itemize. (line 3624)
+* bullet symbol: Math symbols. (line 8108)
+* bullet, in text: Text symbols. (line 12108)
+* bulleted lists: itemize. (line 3624)
+* calligraphic fonts: Calligraphic. (line 8949)
+* calligraphic letters for math: Font styles. (line 1368)
+* cap height: Text symbols. (line 12116)
+* caron accent: Accents. (line 12293)
+* catcode: \makeatletter & \makeatother.
+ (line 606)
+* category code, character: \makeatletter & \makeatother.
+ (line 606)
+* cc: Units of length. (line 7489)
+* cc list, in letters: \cc. (line 13450)
+* cedilla accent: Accents. (line 12263)
+* center environment: center. (line 3040)
+* centered asterisk, in text: Text symbols. (line 12087)
+* centered equations: Document class options.
+ (line 814)
+* centered period, in text: Text symbols. (line 12162)
+* centering text, declaration for: \centering. (line 3088)
+* centering text, environment for: center. (line 3040)
+* Centimeter: Units of length. (line 7480)
+* chapter: Sectioning. (line 2052)
+* chapter <1>: \chapter. (line 2185)
+* character category code: \makeatletter & \makeatother.
+ (line 606)
+* characters, accented: Accents. (line 12210)
+* characters, case of: Upper and lower case.
+ (line 11964)
+* characters, non-English: Additional Latin letters.
+ (line 12298)
+* characters, reserved: Reserved characters.
+ (line 11932)
+* characters, special: Reserved characters.
+ (line 11932)
+* check accent: Accents. (line 12293)
+* check accent, math: Math accents. (line 9192)
+* Cicero: Units of length. (line 7489)
+* circle symbol, big, in text: Text symbols. (line 12099)
+* circled letter, in text: Text symbols. (line 12111)
+* circumflex accent: Accents. (line 12242)
+* circumflex accent, math: Math accents. (line 9204)
+* circumflex, ASCII, in text: Text symbols. (line 12081)
+* citation key: \bibitem. (line 5399)
+* class and package commands: Class and package commands.
+ (line 945)
+* class and package difference: Class and package construction.
+ (line 887)
+* class and package structure: Class and package structure.
+ (line 901)
+* class file example: Class and package structure.
+ (line 931)
+* class file layout: Class and package structure.
+ (line 901)
+* class options: Document class options.
+ (line 763)
+* class options <1>: Class and package structure.
+ (line 901)
+* class options <2>: Class and package commands.
+ (line 1005)
+* classes of documents: Document classes. (line 729)
+* cleveref package: Cross references. (line 2779)
+* cleveref package <1>: \ref. (line 2892)
+* cleveref package <2>: \footnotemark. (line 6350)
* clock option to slides class: Document class options.
- (line 796)
-* cm: Units of length. (line 5708)
-* dbltopnumber: Floats. (line 1950)
-* dbltopnumber <1>: Floats. (line 1951)
-* dd: Units of length. (line 5714)
-* description environment: description. (line 2544)
-* displaymath environment: displaymath. (line 2597)
-* displaymath environment <1>: Math formulas. (line 5901)
-* document environment: document. (line 2639)
+ (line 856)
+* closing letters: \closing. (line 13466)
+* closing quote: Text symbols. (line 12071)
+* cm: Units of length. (line 7480)
+* code, typesetting: verbatim. (line 5639)
+* colon character: Colon character & \colon.
+ (line 9335)
+* color: Color. (line 10927)
+* color <1>: Define colors. (line 11032)
+* color <2>: Colored text. (line 11054)
+* color <3>: Colored boxes. (line 11125)
+* color <4>: Colored pages. (line 11162)
+* color models: Color models. (line 10980)
+* color package commands: Commands for color.
+ (line 11027)
+* color package options: Color package options.
+ (line 10942)
+* color, define: Define colors. (line 11032)
+* colored boxes: Colored boxes. (line 11125)
+* colored page: Colored pages. (line 11162)
+* colored text: Colored text. (line 11054)
+* command line: Command line. (line 13723)
+* command syntax: LaTeX command syntax.
+ (line 520)
+* commands, class and package: Class and package commands.
+ (line 945)
+* commands, defining new ones: \newcommand & \renewcommand.
+ (line 6490)
+* commands, defining new ones <1>: \providecommand. (line 6615)
+* commands, document class: Class and package construction.
+ (line 878)
+* commands, graphics package: Commands for graphics.
+ (line 11471)
+* commands, ignore spaces: \ignorespaces & \ignorespacesafterend.
+ (line 7063)
+* commands, redefining: \newcommand & \renewcommand.
+ (line 6490)
+* commands, star-variants: \@ifstar. (line 642)
+* composite word mark, in text: Text symbols. (line 12116)
+* computer programs, typesetting: verbatim. (line 5639)
+* configuration, graphics package: Graphics package configuration.
+ (line 11284)
+* contents file: Output files. (line 459)
+* copyright symbol: Text symbols. (line 12028)
+* counters, a list of: Counters. (line 7138)
+* counters, defining new: \newcounter. (line 6643)
+* counters, getting value of: \value. (line 7248)
+* counters, printing: \alph \Alph \arabic \roman \Roman \fnsymbol.
+ (line 7166)
+* counters, setting: \setcounter. (line 7281)
+* cprotect package: verbatim. (line 5659)
+* cprotect package <1>: \verb. (line 5717)
+* creating pictures: picture. (line 4240)
+* creating tables: table. (line 4951)
+* credit footnote: \maketitle. (line 9581)
+* cross references: Cross references. (line 2747)
+* cross references, resolving: Output files. (line 449)
+* cross referencing with page number: \pageref. (line 2845)
+* cross referencing, symbolic: \ref. (line 2869)
+* CTAN: CTAN. (line 703)
+* currency, dollar: Text symbols. (line 12129)
+* currency, euro: Text symbols. (line 12140)
+* dagger, double, in text: Text symbols. (line 12126)
+* dagger, in text: Text symbols. (line 12031)
+* dagger, in text <1>: Text symbols. (line 12123)
+* DANTE e.V.: CTAN. (line 717)
+* date, for titlepage: \maketitle. (line 9575)
+* date, today's: \today. (line 12390)
+* datetime package: \today. (line 12411)
+* dbltopnumber: Floats. (line 2030)
+* dbltopnumber <1>: Floats. (line 2031)
+* dcolumn package: array. (line 3032)
+* dd: Units of length. (line 7486)
+* define color: Define colors. (line 11032)
+* defining a new command: \newcommand & \renewcommand.
+ (line 6490)
+* defining a new command <1>: \providecommand. (line 6615)
+* defining new environments: \newenvironment & \renewenvironment.
+ (line 6733)
+* defining new fonts: \newfont. (line 6979)
+* defining new theorems: \newtheorem. (line 6867)
+* definitions: Definitions. (line 6485)
+* delimiters, paired: \left & \right. (line 9383)
+* delim_0: makeindex. (line 13140)
+* delim_1: makeindex. (line 13144)
+* delim_2: makeindex. (line 13148)
+* delim_n: makeindex. (line 13152)
+* delim_r: makeindex. (line 13156)
+* description: \newglossaryentry. (line 13296)
+* description environment: description. (line 3130)
+* description lists, creating: description. (line 3130)
+* design size, in font definitions: \newfont. (line 6992)
+* Didot point: Units of length. (line 7486)
+* dieresis accent: Accents. (line 12227)
+* difference between class and package: Class and package construction.
+ (line 887)
+* discretionary breaks, multiplication: \*. (line 9355)
+* discretionary hyphenation: \discretionary. (line 5939)
+* display math mode: Modes. (line 9467)
+* displaying quoted text with paragraph indentation: quotation & quote.
+ (line 4772)
+* displaying quoted text without paragraph indentation: quotation & quote.
+ (line 4772)
+* displaymath environment: displaymath. (line 3186)
+* displaymath environment <1>: Math formulas. (line 7847)
+* document class commands: Class and package construction.
+ (line 878)
+* document class options: Document class options.
+ (line 763)
+* document class, defined: Starting and ending.
+ (line 401)
+* document classes: Document classes. (line 729)
+* document environment: document. (line 3230)
+* document templates: Document templates.
+ (line 13931)
+* dollar sign: Text symbols. (line 12129)
+* dot accent: Accents. (line 12234)
+* dot over accent, math: Math accents. (line 9198)
+* dot-over accent: Accents. (line 12234)
+* dot-under accent: Accents. (line 12267)
+* dotless i: Accents. (line 12221)
+* dotless i, math: Math symbols. (line 8260)
+* dotless j: Accents. (line 12221)
+* dotless j, math: Math symbols. (line 8282)
+* dots: Dots. (line 9007)
+* double angle quotation marks: Text symbols. (line 12046)
+* double dagger, in text: Text symbols. (line 12034)
+* double dagger, in text <1>: Text symbols. (line 12126)
+* double dot accent, math: Math accents. (line 9195)
+* double guillemets: Text symbols. (line 12046)
+* double left quote: Text symbols. (line 12168)
+* double low-9 quotation mark: Text symbols. (line 12068)
+* double quote, straight base: Text symbols. (line 12184)
+* double right quote: Text symbols. (line 12171)
+* double spacing: Low-level font commands.
+ (line 1583)
+* double vertical bar, in text: Text symbols. (line 12096)
+* doublestruck: Blackboard bold. (line 8923)
* draft option: Document class options.
- (line 746)
-* dvipdfmx command: Output files. (line 393)
-* dvips command: Output files. (line 393)
-* dvitype command: Output files. (line 393)
-* em: Units of length. (line 5722)
-* enumerate environment: enumerate. (line 2677)
-* environment, abstract: abstract. (line 2357)
-* environment, array: array. (line 2403)
-* environment, center: center. (line 2469)
-* environment, description: description. (line 2544)
-* environment, displaymath: displaymath. (line 2597)
-* environment, displaymath <1>: Math formulas. (line 5901)
-* environment, document: document. (line 2639)
-* environment, enumerate: enumerate. (line 2677)
-* environment, eqnarray: eqnarray. (line 2744)
-* environment, equation: equation. (line 2800)
-* environment, equation <1>: Math formulas. (line 5901)
-* environment, figure: figure. (line 2823)
-* environment, filecontents: filecontents. (line 2876)
-* environment, filecontents*: filecontents. (line 2876)
-* environment, flushleft: flushleft. (line 2927)
-* environment, flushright: flushright. (line 2953)
-* environment, itemize: itemize. (line 2979)
-* environment, letter: letter. (line 3062)
-* environment, list: list. (line 3067)
-* environment, math: math. (line 3420)
-* environment, math <1>: Math formulas. (line 5901)
-* environment, minipage: minipage. (line 3432)
-* environment, picture: picture. (line 3460)
-* environment, quotation: quotation and quote.
- (line 3732)
-* environment, quote: quotation and quote.
- (line 3732)
-* environment, tabbing: tabbing. (line 3768)
-* environment, table: table. (line 3915)
-* environment, tabular: tabular. (line 3957)
-* environment, thebibliography: thebibliography. (line 4279)
-* environment, theorem: theorem. (line 4395)
-* environment, titlepage: titlepage. (line 4408)
-* environment, verbatim: verbatim. (line 4447)
-* environment, verse: verse. (line 4482)
-* eqnarray environment: eqnarray. (line 2744)
-* equation environment: equation. (line 2800)
-* equation environment <1>: Math formulas. (line 5901)
-* etex command: TeX engines. (line 441)
-* ex: Units of length. (line 5722)
+ (line 806)
+* dvipdfmx command: Output files. (line 426)
+* dvips command: Output files. (line 426)
+* dvitype command: Output files. (line 426)
+* e-dash: Text symbols. (line 12137)
+* e-TeX: TeX engines. (line 475)
+* ellipses: Dots. (line 9007)
+* ellipsis: Text symbols. (line 12052)
+* em: Units of length. (line 7494)
+* em <1>: Units of length. (line 7494)
+* em-dash: Text symbols. (line 12132)
+* em-dash, three-quarters: Text symbols. (line 12193)
+* em-dash, two-thirds: Text symbols. (line 12199)
+* emphasis: Font styles. (line 1349)
+* enclosure list: \encl. (line 13479)
+* end of document hook: \AtEndDocument. (line 3252)
+* ending and starting: Starting and ending.
+ (line 390)
+* engines, TeX: TeX engines. (line 468)
+* enlarge current page: \enlargethispage. (line 6157)
+* enumerate environment: enumerate. (line 3268)
+* enumitem package: list. (line 3976)
+* environment: Starting and ending.
+ (line 409)
+* environment, abstract: abstract. (line 2915)
+* environment, array: array. (line 2961)
+* environment, center: center. (line 3040)
+* environment, description: description. (line 3130)
+* environment, displaymath: displaymath. (line 3186)
+* environment, displaymath <1>: Math formulas. (line 7847)
+* environment, document: document. (line 3230)
+* environment, enumerate: enumerate. (line 3268)
+* environment, eqnarray: eqnarray. (line 3335)
+* environment, equation: equation. (line 3391)
+* environment, equation <1>: Math formulas. (line 7847)
+* environment, figure: figure. (line 3411)
+* environment, filecontents: filecontents. (line 3469)
+* environment, filecontents*: filecontents. (line 3469)
+* environment, flushleft: flushleft. (line 3520)
+* environment, flushright: flushright. (line 3581)
+* environment, itemize: itemize. (line 3624)
+* environment, letter: letter. (line 3707)
+* environment, list: list. (line 3712)
+* environment, math: math. (line 4076)
+* environment, math <1>: Math formulas. (line 7847)
+* environment, minipage: minipage. (line 4088)
+* environment, picture: picture. (line 4240)
+* environment, quotation: quotation & quote. (line 4772)
+* environment, quote: quotation & quote. (line 4772)
+* environment, tabbing: tabbing. (line 4802)
+* environment, table: table. (line 4951)
+* environment, tabular: tabular. (line 5011)
+* environment, thebibliography: thebibliography. (line 5337)
+* environment, theorem: theorem. (line 5570)
+* environment, theorem-like: \newtheorem. (line 6867)
+* environment, titlepage: titlepage. (line 5600)
+* environment, verbatim: verbatim. (line 5639)
+* environment, verse: verse. (line 5725)
+* environments: Environments. (line 2898)
+* environments, defining: \newenvironment & \renewenvironment.
+ (line 6733)
+* envlab package: \makelabels. (line 13553)
+* EPS files: Graphics package configuration.
+ (line 11284)
+* EPS files <1>: \includegraphics. (line 11477)
+* eqnarray environment: eqnarray. (line 3335)
+* equation environment: equation. (line 3391)
+* equation environment <1>: Math formulas. (line 7847)
+* equation number, cross referencing: \ref. (line 2869)
+* equation numbers, left vs. right: Document class options.
+ (line 820)
+* equation numbers, omitting: eqnarray. (line 3370)
+* equations, aligning: eqnarray. (line 3335)
+* equations, environment for: equation. (line 3391)
+* equations, flush left vs. centered: Document class options.
+ (line 814)
+* es-zet German letter: Additional Latin letters.
+ (line 12344)
+* etex command: TeX engines. (line 475)
+* eth, Icelandic letter: Additional Latin letters.
+ (line 12312)
+* etoolbox package: Class and package commands.
+ (line 1049)
+* euro symbol: Text symbols. (line 12140)
+* eurosym package: Text symbols. (line 12140)
+* ex: Units of length. (line 7494)
+* ex <1>: Units of length. (line 7494)
+* exclamation point, upside-down: Text symbols. (line 12146)
* executivepaper option: Document class options.
- (line 716)
-* figure environment: figure. (line 2823)
-* filecontents environment: filecontents. (line 2876)
-* filecontents* environment: filecontents. (line 2876)
+ (line 776)
+* exponent: Subscripts & superscripts.
+ (line 7938)
+* extended Latin: Additional Latin letters.
+ (line 12298)
+* external files, writing: filecontents. (line 3469)
+* families, of fonts: Low-level font commands.
+ (line 1486)
+* fancyhdr package: Page styles. (line 9524)
+* fancyhdr package <1>: \pagestyle. (line 9667)
+* fancyvrb package: tabbing. (line 4942)
+* fancyvrb package <1>: verbatim. (line 5670)
+* feminine ordinal symbol: Text symbols. (line 12159)
+* figure environment: figure. (line 3411)
+* figure number, cross referencing: \ref. (line 2869)
+* figures, footnotes in: minipage. (line 4190)
+* figures, inserting: figure. (line 3411)
+* file, root: Splitting the input.
+ (line 12425)
+* filecontents environment: filecontents. (line 3469)
+* filecontents* environment: filecontents. (line 3469)
* final option: Document class options.
- (line 746)
+ (line 806)
* first-latex-doc document: About this document.
- (line 318)
+ (line 347)
+* fixed-width font: Font styles. (line 1386)
+* flafter package: Floats. (line 1978)
* fleqn option: Document class options.
- (line 746)
-* flushleft environment: flushleft. (line 2927)
-* flushright environment: flushright. (line 2953)
-* <http://puszcza.gnu.org.ua/software/latexrefman/> home page: About this document.
- (line 291)
-* in: Units of length. (line 5701)
-* inch: Units of length. (line 5701)
-* itemize environment: itemize. (line 2979)
+ (line 806)
+* float package: Floats. (line 1948)
+* float page: Floats. (line 1954)
+* flush left equations: Document class options.
+ (line 814)
+* flushing floats and starting a page: \clearpage & \cleardoublepage.
+ (line 6083)
+* flushleft environment: flushleft. (line 3520)
+* flushright environment: flushright. (line 3581)
+* font catalogue: Low-level font commands.
+ (line 1486)
+* font commands, low-level: Low-level font commands.
+ (line 1471)
+* font size: Low-level font commands.
+ (line 1566)
+* font sizes: Font sizes. (line 1436)
+* font styles: Font styles. (line 1296)
+* font symbols, by number: Symbols by font position.
+ (line 12009)
+* fonts: Fonts. (line 1290)
+* fonts, new commands for: \newfont. (line 6979)
+* fonts, script: Calligraphic. (line 8949)
+* footer style: \pagestyle. (line 9660)
+* footer, parameters for: Page layout parameters.
+ (line 1769)
+* footnote number, cross referencing: \ref. (line 2869)
+* footnote parameters: \footnote. (line 6270)
+* footnote, in a table: Footnotes in a table.
+ (line 6399)
+* footnote, in section headings: Footnotes in section headings.
+ (line 6380)
+* footnote, of a footnote: Footnotes of footnotes.
+ (line 6469)
+* footnotes in figures: minipage. (line 4190)
+* footnotes, creating: Footnotes. (line 6223)
+* Footnotes, in a minipage: \footnote. (line 6298)
+* footnotes, symbols instead of numbers: \footnote. (line 6260)
+* formulas, environment for: equation. (line 3391)
+* formulas, math: Math formulas. (line 7847)
+* forward reference: Cross references. (line 2768)
+* forward references, resolving: Output files. (line 449)
+* fraction: \frac. (line 9371)
+* fragile commands: \protect. (line 7011)
+* frame rule width: \fbox & \framebox. (line 10677)
+* frame, line width: \fbox & \framebox. (line 10677)
+* frame, separation from contents: \fbox & \framebox. (line 10682)
+* French quotation marks: Text symbols. (line 12046)
+* functions, math: Math functions. (line 9062)
+* geometry package: Document class options.
+ (line 797)
+* geometry package <1>: Document class options.
+ (line 801)
+* global options: Document class options.
+ (line 763)
+* global options <1>: Additional packages.
+ (line 871)
+* glossaries: Glossaries. (line 13208)
+* glossary: Glossaries. (line 13208)
+* glossary, entries: \newglossaryentry. (line 13256)
+* glossary, entry reference: \gls. (line 13315)
+* glue register, plain TeX: \newlength. (line 6684)
+* graphics: Graphics. (line 11183)
+* graphics <1>: Graphics package configuration.
+ (line 11284)
+* graphics <2>: \includegraphics. (line 11477)
+* graphics package: Graphics. (line 11183)
+* graphics package <1>: Graphics package configuration.
+ (line 11284)
+* graphics package <2>: \includegraphics. (line 11477)
+* graphics package commands: Commands for graphics.
+ (line 11471)
+* graphics package options: Graphics package options.
+ (line 11220)
+* graphics packages: \line. (line 4494)
+* graphics, resizing: \scalebox. (line 11866)
+* graphics, resizing <1>: \resizebox. (line 11897)
+* graphics, scaling: \scalebox. (line 11866)
+* graphics, scaling <1>: \resizebox. (line 11897)
+* grave accent: Accents. (line 12246)
+* grave accent, math: Math accents. (line 9201)
+* greater than symbol, in text: Text symbols. (line 12149)
+* greek letters: Math symbols. (line 8001)
+* group, and environments: Environments. (line 2910)
+* group_skip: makeindex. (line 13087)
+* ha'c<ek accent, math: Math accents. (line 9192)
+* hacek accent: Accents. (line 12293)
+* Halmos symbol: \rule. (line 12362)
+* hat accent: Accents. (line 12242)
+* hat accent, math: Math accents. (line 9204)
+* header style: \pagestyle. (line 9660)
+* header, parameters for: Page layout parameters.
+ (line 1769)
+* hello, world: Starting and ending.
+ (line 390)
+* here, putting floats: Floats. (line 1948)
+* home page for manual: About this document.
+ (line 320)
+* horizontal space: \hss. (line 9890)
+* horizontal space, stretchable: \hss. (line 9890)
+* hungarian umlaut accent: Accents. (line 12271)
+* hyperref package: \footnotemark. (line 6350)
+* hyperref package <1>: \footnotemark. (line 6359)
+* hyperref package <2>: \pagenumbering. (line 9641)
+* hyperref package <3>: Command line input.
+ (line 13852)
+* hyphenation, defining: \hyphenation. (line 6003)
+* hyphenation, discretionary: \discretionary. (line 5939)
+* hyphenation, forcing: \- (hyphenation). (line 5904)
+* hyphenation, preventing: \mbox & \makebox. (line 10555)
+* Icelandic eth: Additional Latin letters.
+ (line 12312)
+* Icelandic thorn: Additional Latin letters.
+ (line 12348)
+* idx file: \index. (line 13020)
+* ij letter, Dutch: Additional Latin letters.
+ (line 12324)
+* implementations of TeX: TeX engines. (line 468)
+* importing graphics: \includegraphics. (line 11477)
+* in: Units of length. (line 7473)
+* in-line formulas: math. (line 4076)
+* inch: Units of length. (line 7473)
+* including graphics: \includegraphics. (line 11477)
+* indent, forcing: \indent & \noindent.
+ (line 7722)
+* indentation of paragraphs, in minipage: minipage. (line 4186)
+* indentfirst package: \part. (line 2175)
+* indentfirst package <1>: \chapter. (line 2237)
+* indentfirst package <2>: \section. (line 2332)
+* indentfirst package <3>: \subsection. (line 2398)
+* indentfirst package <4>: \subsubsection & \paragraph & \subparagraph.
+ (line 2475)
+* indentfirst package <5>: \indent & \noindent.
+ (line 7764)
+* indent_length: makeindex. (line 13168)
+* indent_space: makeindex. (line 13164)
+* index entries, 'see' and 'see also': \index. (line 12970)
+* index entry: \index. (line 12920)
+* index package: \index. (line 13015)
+* index, page range: \index. (line 12954)
+* index, printing: \printindex. (line 13193)
+* index, processing: makeindex. (line 13036)
+* index, style file: makeindex. (line 13048)
+* indexes: Indexes. (line 12884)
+* infinite horizontal stretch: \hfill. (line 9857)
+* infinite vertical stretch: \vfill. (line 10470)
+* inner paragraph mode: Modes. (line 9485)
+* input file: Splitting the input.
+ (line 12421)
+* input, on command line: Command line input.
+ (line 13848)
+* input/output, to terminal: Terminal input/output.
+ (line 13642)
+* inserting figures: figure. (line 3411)
+* insertions of special characters: Special insertions.
+ (line 11926)
+* internal vertical mode: Modes. (line 9476)
+* italic correction: \/. (line 10174)
+* italic font: Font styles. (line 1371)
+* itemize environment: itemize. (line 3624)
+* item_0: makeindex. (line 13111)
+* item_01: makeindex. (line 13120)
+* item_1: makeindex. (line 13114)
+* item_12: makeindex. (line 13130)
+* item_2: makeindex. (line 13117)
+* item_x1: makeindex. (line 13124)
+* item_x2: makeindex. (line 13134)
+* JPEG files: Graphics package configuration.
+ (line 11284)
+* JPEG files <1>: \includegraphics. (line 11477)
+* JPG files: Graphics package configuration.
+ (line 11284)
+* JPG files <1>: \includegraphics. (line 11477)
+* justification, ragged left: \raggedleft. (line 3599)
+* justification, ragged right: \raggedright. (line 3548)
+* Knuth, Donald E.: Overview. (line 364)
+* label: Cross references. (line 2747)
+* labelled lists, creating: description. (line 3130)
+* Lamport TeX: Overview. (line 382)
+* Lamport, Leslie: Overview. (line 364)
* landscape option: Document class options.
- (line 746)
-* latex command: Output files. (line 393)
+ (line 806)
+* landscape orientation: Document class options.
+ (line 817)
+* latex command: Output files. (line 426)
+* LaTeX logo: Text symbols. (line 12037)
+* LaTeX overview: Overview. (line 364)
+* LaTeX Project team: About this document.
+ (line 331)
+* LaTeX vs. LaTeX2e: About this document.
+ (line 327)
* latex-doc-ptr document: About this document.
- (line 315)
+ (line 344)
+* LaTeX2e logo: Text symbols. (line 12040)
* <latexrefman@tug.org> email address: About this document.
- (line 302)
+ (line 331)
+* Latin letters, additional: Additional Latin letters.
+ (line 12298)
+* layout commands: Layout. (line 1613)
+* layout, page parameters for: Page layout parameters.
+ (line 1769)
+* left angle quotation marks: Text symbols. (line 12046)
+* left arrow, in text: Text symbols. (line 12155)
+* left brace, in text: Text symbols. (line 12102)
+* left quote: Text symbols. (line 12056)
+* left quote, double: Text symbols. (line 12168)
+* left quote, single: Text symbols. (line 12174)
+* left-hand equation numbers: Document class options.
+ (line 820)
+* left-justifying text: \raggedright. (line 3548)
+* left-justifying text, environment for: flushleft. (line 3520)
+* left-to-right mode: Modes. (line 9454)
* legalpaper option: Document class options.
- (line 716)
+ (line 776)
+* lengths, adding to: \addtolength. (line 7535)
+* lengths, allocating new: \newlength. (line 6684)
+* lengths, defining and using: Lengths. (line 7368)
+* lengths, setting: \setlength. (line 7512)
* leqno option: Document class options.
- (line 746)
-* letter class: Document classes. (line 674)
-* letter environment: letter. (line 3062)
+ (line 806)
+* less than symbol, in text: Text symbols. (line 12152)
+* lethead_flag: makeindex. (line 13094)
+* lethead_prefix: makeindex. (line 13103)
+* lethead_suffix: makeindex. (line 13107)
+* letter class: Document classes. (line 734)
+* letter environment: letter. (line 3707)
* letterpaper option: Document class options.
- (line 716)
-* list environment: list. (line 3067)
-* lR box: picture. (line 3525)
-* lrbox: lrbox. (line 7675)
+ (line 776)
+* letters, accented: Accents. (line 12210)
+* letters, additional Latin: Additional Latin letters.
+ (line 12298)
+* letters, ending: \closing. (line 13466)
+* letters, starting: \opening. (line 13571)
+* letters, writing: Letters. (line 13345)
+* line break, forcing: \\. (line 5778)
+* line breaking: Line breaking. (line 5761)
+* line breaks, changing: \fussy & \sloppy. (line 5962)
+* line breaks, forcing: \linebreak & \nolinebreak.
+ (line 6021)
+* line breaks, multiplication discretionary: \*. (line 9355)
+* line breaks, preventing: \linebreak & \nolinebreak.
+ (line 6021)
+* lines in tables: tabular. (line 5011)
+* line_max: makeindex. (line 13160)
+* lining numerals: Font styles. (line 1422)
+* lining text up in tables: tabular. (line 5011)
+* lining text up using tab stops: tabbing. (line 4802)
+* list environment: list. (line 3712)
+* list items, specifying counter: \usecounter. (line 7222)
+* list of figures file: Output files. (line 459)
+* list of tables file: Output files. (line 459)
+* listings package: tabbing. (line 4942)
+* listings package <1>: verbatim. (line 5664)
+* listings package <2>: \verb. (line 5714)
+* lists of items: itemize. (line 3624)
+* lists of items, generic: list. (line 3712)
+* lists of items, numbered: enumerate. (line 3268)
+* loading additional packages: Additional packages.
+ (line 862)
+* log file: Output files. (line 444)
+* logo, LaTeX: Text symbols. (line 12037)
+* logo, LaTeX2e: Text symbols. (line 12040)
+* logo, TeX: Text symbols. (line 12078)
+* long command: Class and package commands.
+ (line 962)
+* low-9 quotation marks, single and double: Text symbols. (line 12068)
+* low-level font commands: Low-level font commands.
+ (line 1471)
+* lowercase: Upper and lower case.
+ (line 11964)
+* LR box: picture. (line 4337)
+* LR mode: Modes. (line 9454)
+* lrbox: lrbox. (line 10887)
* lshort document: About this document.
- (line 326)
-* lualatex command: TeX engines. (line 458)
-* math environment: math. (line 3420)
-* math environment <1>: Math formulas. (line 5901)
-* minipage environment: minipage. (line 3432)
-* mm: Units of length. (line 5711)
-* mu: Units of length. (line 5733)
+ (line 355)
+* ltugboat class: tugboat template. (line 14062)
+* lualatex command: TeX engines. (line 492)
+* LuaTeX: TeX engines. (line 492)
+* m-width: Units of length. (line 7494)
+* macro package, LaTeX as: Overview. (line 369)
+* macron accent: Accents. (line 12238)
+* macron accent, math: Math accents. (line 9186)
+* macros2e package: \makeatletter & \makeatother.
+ (line 627)
+* Madsen, Lars: eqnarray. (line 3335)
+* make a box: \mbox & \makebox. (line 10555)
+* makeindex: makeindex. (line 13036)
+* makeindex program: makeindex. (line 13036)
+* makeindex, style file: makeindex. (line 13048)
+* making a title page: titlepage. (line 5600)
+* making paragraphs: Making paragraphs. (line 7631)
+* marginal notes: Marginal notes. (line 7798)
+* masculine ordinal symbol: Text symbols. (line 12159)
+* matching brackets: \left & \right. (line 9383)
+* matching parentheses: \left & \right. (line 9383)
+* math accents: Math accents. (line 9178)
+* math environment: math. (line 4076)
+* math environment <1>: Math formulas. (line 7847)
+* math formulas: Math formulas. (line 7847)
+* math functions: Math functions. (line 9062)
+* math miscellany: Math miscellany. (line 9329)
+* math mode: Modes. (line 9464)
+* math mode, entering: Math formulas. (line 7847)
+* math mode, spacing: Spacing in math mode.
+ (line 9272)
+* math symbols: Math symbols. (line 8001)
+* math, bold: Font styles. (line 1418)
+* mathtools package: Math formulas. (line 7927)
+* mathtools package <1>: Over- and Underlining.
+ (line 9266)
+* MetaPost package: \line. (line 4494)
+* mfirstuc package: Upper and lower case.
+ (line 12003)
+* mhchem package: Subscripts & superscripts.
+ (line 7994)
+* Millimeter: Units of length. (line 7483)
+* minipage environment: minipage. (line 4088)
+* minipage, creating a: minipage. (line 4088)
+* minted package: tabbing. (line 4942)
+* minted package <1>: verbatim. (line 5664)
+* minted package <2>: \verb. (line 5714)
+* mirrors of CTAN: CTAN. (line 717)
+* mm: Units of length. (line 7483)
+* modes: Modes. (line 9444)
+* monospace font: Font styles. (line 1386)
+* moving arguments: \protect. (line 7024)
+* mpfootnote counter: \footnote. (line 6298)
+* mu: Units of length. (line 7505)
+* mu, math unit: Units of length. (line 7505)
+* multicolumn text: \twocolumn. (line 1630)
+* multilingual support: Accents. (line 12210)
+* multind package: Indexes. (line 12910)
+* multiplication, discretionary: \*. (line 9355)
+* name: \newglossaryentry. (line 13293)
+* NBSP: ~. (line 10094)
+* nested \include, not allowed: \include & \includeonly.
+ (line 12593)
+* new class commands: Class and package construction.
+ (line 878)
+* new command, check: Class and package commands.
+ (line 960)
+* new command, definition: Class and package commands.
+ (line 1035)
+* new commands, defining: \newcommand & \renewcommand.
+ (line 6490)
+* new commands, defining <1>: \providecommand. (line 6615)
+* new line, output as input: \obeycr & \restorecr.
+ (line 5840)
+* new line, starting: \\. (line 5778)
+* new line, starting (paragraph mode): \newline. (line 5880)
+* new page, starting: \newpage. (line 6124)
+* non-English characters: Additional Latin letters.
+ (line 12298)
+* notes in the margin: Marginal notes. (line 7798)
* notitlepage option: Document class options.
- (line 746)
+ (line 806)
+* null delimiter: \left & \right. (line 9383)
+* numbered items, specifying counter: \usecounter. (line 7222)
+* numerals, old-style: Font styles. (line 1422)
+* oblique font: Font styles. (line 1383)
+* oe ligature: Additional Latin letters.
+ (line 12340)
+* ogonek: Accents. (line 12275)
+* old-style numerals: Font styles. (line 1422)
+* one-column output: \onecolumn. (line 1618)
* onecolumn option: Document class options.
- (line 775)
+ (line 835)
* oneside option: Document class options.
- (line 775)
+ (line 835)
* openany option: Document class options.
- (line 775)
+ (line 835)
* openbib option: Document class options.
- (line 746)
+ (line 806)
+* opening quote: Text symbols. (line 12056)
* openright option: Document class options.
- (line 775)
-* pc: Units of length. (line 5698)
-* pdflatex command: Output files. (line 403)
-* picture environment: picture. (line 3460)
-* pt: Units of length. (line 5694)
-* quotation environment: quotation and quote.
- (line 3732)
-* quote environment: quotation and quote.
- (line 3732)
-* report class: Document classes. (line 674)
-* secnumdepth counter: Sectioning. (line 2013)
-* slides class: Document classes. (line 674)
-* sp: Units of length. (line 5720)
-* tabbing environment: tabbing. (line 3768)
-* table environment: table. (line 3915)
-* tabular environment: tabular. (line 3957)
-* textcomp package: Text symbols. (line 8877)
-* thebibliography environment: thebibliography. (line 4279)
-* theorem environment: theorem. (line 4395)
-* titlepage environment: titlepage. (line 4408)
+ (line 835)
+* OpenType fonts: TeX engines. (line 468)
+* options, class: Class and package commands.
+ (line 1005)
+* options, color package: Color package options.
+ (line 10942)
+* options, command line: Command line options.
+ (line 13765)
+* options, document class: Document class options.
+ (line 763)
+* options, document class <1>: Class and package structure.
+ (line 901)
+* options, global: Additional packages.
+ (line 871)
+* options, graphics package: Graphics package options.
+ (line 11220)
+* options, package: Class and package structure.
+ (line 901)
+* options, package <1>: Class and package commands.
+ (line 1005)
+* ordinals, feminine and masculine: Text symbols. (line 12159)
+* oslash: Additional Latin letters.
+ (line 12336)
+* outer paragraph mode: Modes. (line 9485)
+* overbar accent: Accents. (line 12238)
+* overdot accent, math: Math accents. (line 9198)
+* overlining: Over- and Underlining.
+ (line 9227)
+* overview of LaTeX: Overview. (line 364)
+* package file layout: Class and package structure.
+ (line 901)
+* package options: Class and package structure.
+ (line 901)
+* package options <1>: Class and package commands.
+ (line 1005)
+* package, algorithm2e: tabbing. (line 4942)
+* package, amsfonts: Math formulas. (line 7927)
+* package, amsmath: array. (line 3010)
+* package, amsmath <1>: array. (line 3021)
+* package, amsmath <2>: displaymath. (line 3202)
+* package, amsmath <3>: equation. (line 3405)
+* package, amsmath <4>: theorem. (line 5592)
+* package, amsmath <5>: Math formulas. (line 7927)
+* package, amsmath <6>: Dots. (line 9038)
+* package, amsmath <7>: Math functions. (line 9167)
+* package, amsmath <8>: Colon character & \colon.
+ (line 9344)
+* package, amsmath <9>: Colon character & \colon.
+ (line 9348)
+* package, amsthm: theorem. (line 5592)
+* package, amsthm <1>: \rule. (line 12367)
+* package, appendix: \appendix. (line 2510)
+* package, array (package): array. (line 3032)
+* package, Asymptote: \line. (line 4494)
+* package, Asymptote <1>: \strut. (line 10390)
+* package, Asymptote <2>: \mbox & \makebox. (line 10622)
+* package, babel: \chapter. (line 2250)
+* package, babel <1>: thebibliography. (line 5384)
+* package, babel <2>: Accents. (line 12210)
+* package, babel <3>: \today. (line 12397)
+* package, babel <4>: Table of contents etc..
+ (line 12724)
+* package, babel <5>: \index. (line 12970)
+* package, bigfoot: Footnotes of footnotes.
+ (line 6469)
+* package, bm: \boldmath & \unboldmath.
+ (line 8993)
+* package, cleveref: Cross references. (line 2779)
+* package, cleveref <1>: \ref. (line 2892)
+* package, cleveref <2>: \footnotemark. (line 6350)
+* package, cprotect: verbatim. (line 5659)
+* package, cprotect <1>: \verb. (line 5717)
+* package, datetime: \today. (line 12411)
+* package, dcolumn: array. (line 3032)
+* package, enumitem: list. (line 3976)
+* package, envlab: \makelabels. (line 13553)
+* package, etoolbox: Class and package commands.
+ (line 1049)
+* package, eurosym: Text symbols. (line 12140)
+* package, fancyhdr: Page styles. (line 9524)
+* package, fancyhdr <1>: \pagestyle. (line 9667)
+* package, fancyvrb: tabbing. (line 4942)
+* package, fancyvrb <1>: verbatim. (line 5670)
+* package, flafter: Floats. (line 1978)
+* package, float: Floats. (line 1948)
+* package, geometry: Document class options.
+ (line 797)
+* package, geometry <1>: Document class options.
+ (line 801)
+* package, hyperref: \footnotemark. (line 6350)
+* package, hyperref <1>: \footnotemark. (line 6359)
+* package, hyperref <2>: \pagenumbering. (line 9641)
+* package, hyperref <3>: Command line input.
+ (line 13852)
+* package, indentfirst: \part. (line 2175)
+* package, indentfirst <1>: \chapter. (line 2237)
+* package, indentfirst <2>: \section. (line 2332)
+* package, indentfirst <3>: \subsection. (line 2398)
+* package, indentfirst <4>: \subsubsection & \paragraph & \subparagraph.
+ (line 2475)
+* package, indentfirst <5>: \indent & \noindent.
+ (line 7764)
+* package, index: \index. (line 13015)
+* package, listings: tabbing. (line 4942)
+* package, listings <1>: verbatim. (line 5664)
+* package, listings <2>: \verb. (line 5714)
+* package, macros2e: \makeatletter & \makeatother.
+ (line 627)
+* package, mathtools: Math formulas. (line 7927)
+* package, mathtools <1>: Over- and Underlining.
+ (line 9266)
+* package, MetaPost: \line. (line 4494)
+* package, mfirstuc: Upper and lower case.
+ (line 12003)
+* package, mhchem: Subscripts & superscripts.
+ (line 7994)
+* package, minted: tabbing. (line 4942)
+* package, minted <1>: verbatim. (line 5664)
+* package, minted <2>: \verb. (line 5714)
+* package, multind: Indexes. (line 12910)
+* package, pict2e: \line. (line 4494)
+* package, polyglossia: Accents. (line 12210)
+* package, polyglossia <1>: \today. (line 12397)
+* package, polyglossia <2>: Table of contents etc..
+ (line 12724)
+* package, polyglossia <3>: \index. (line 12970)
+* package, PSTricks: \line. (line 4494)
+* package, sagetex: Command line options.
+ (line 13821)
+* package, setspace: Low-level font commands.
+ (line 1583)
+* package, showidx: Indexes. (line 12910)
+* package, siunitx: ~. (line 10120)
+* package, symbols: Math symbols. (line 8001)
+* package, textcase: Upper and lower case.
+ (line 12000)
+* package, textcomp: Font styles. (line 1422)
+* package, TikZ: \line. (line 4494)
+* package, TikZ <1>: \strut. (line 10390)
+* package, TikZ <2>: \mbox & \makebox. (line 10621)
+* package, titlesec: \part. (line 2179)
+* package, titlesec <1>: \chapter. (line 2258)
+* package, titlesec <2>: \section. (line 2336)
+* package, titlesec <3>: \subsection. (line 2402)
+* package, titlesec <4>: \subsubsection & \paragraph & \subparagraph.
+ (line 2479)
+* package, tocbibbind: Table of contents etc..
+ (line 12735)
+* package, tocloft: Table of contents etc..
+ (line 12735)
+* package, ulem: Over- and Underlining.
+ (line 9236)
+* package, url: \verb. (line 5710)
+* package, verbatimbox: verbatim. (line 5670)
+* packages, loading additional: Additional packages.
+ (line 862)
+* page break, forcing: \pagebreak & \nopagebreak.
+ (line 6182)
+* page break, preventing: \pagebreak & \nopagebreak.
+ (line 6182)
+* page breaking: Page breaking. (line 6052)
+* page layout parameters: Page layout parameters.
+ (line 1769)
+* page number, cross referencing: \pageref. (line 2845)
+* page numbering style: \pagenumbering. (line 9602)
+* page style, this page: \thispagestyle. (line 9744)
+* page styles: Page styles. (line 9518)
+* page, colored: Colored pages. (line 11162)
+* page_precedence: makeindex. (line 13173)
+* paired delimiters: \left & \right. (line 9383)
+* paragraph: Sectioning. (line 2052)
+* paragraph <1>: \subsubsection & \paragraph & \subparagraph.
+ (line 2420)
+* paragraph indentation: \parindent & \parskip.
+ (line 7771)
+* paragraph indentation, in minipage: minipage. (line 4186)
+* paragraph indentations in quoted text: quotation & quote. (line 4772)
+* paragraph indentations in quoted text, omitting: quotation & quote.
+ (line 4772)
+* paragraph mode: Modes. (line 9450)
+* paragraph mode <1>: \parbox. (line 10711)
+* paragraph symbol: Text symbols. (line 12060)
+* paragraph, ending: \par. (line 7671)
+* paragraph, in a box: \parbox. (line 10711)
+* paragraphs: Making paragraphs. (line 7631)
+* parameters, for footnotes: \footnote. (line 6270)
+* parameters, page layout: Page layout parameters.
+ (line 1769)
+* part: Sectioning. (line 2052)
+* part <1>: \part. (line 2131)
+* pc: Units of length. (line 7470)
+* PDF graphic files: Graphics package configuration.
+ (line 11284)
+* PDF graphic files <1>: \includegraphics. (line 11477)
+* pdflatex command: Output files. (line 436)
+* pdfTeX: Output files. (line 436)
+* pdfTeX engine: TeX engines. (line 475)
+* period, abbreviation-ending: \@. (line 9977)
+* period, centered, in text: Text symbols. (line 12162)
+* period, sentence-ending: \@. (line 9977)
+* period, spacing after: \@. (line 9977)
+* pica: Units of length. (line 7470)
+* pict2e package: \line. (line 4494)
+* pict2e package <1>: \line. (line 4494)
+* picture environment: picture. (line 4240)
+* pictures, creating: picture. (line 4240)
+* pilcrow: Text symbols. (line 12060)
+* placement of floats: Floats. (line 1927)
+* plural: \newglossaryentry. (line 13301)
+* PNG files: Graphics package configuration.
+ (line 11284)
+* PNG files <1>: \includegraphics. (line 11477)
+* poetry, an environment for: verse. (line 5725)
+* Point: Units of length. (line 7466)
+* polish l: Additional Latin letters.
+ (line 12328)
+* polyglossia package: Accents. (line 12210)
+* polyglossia package <1>: \today. (line 12397)
+* polyglossia package <2>: Table of contents etc..
+ (line 12724)
+* polyglossia package <3>: \index. (line 12970)
+* portrait orientation: Document class options.
+ (line 817)
+* position, in picture: picture. (line 4311)
+* positional parameter: \newcommand & \renewcommand.
+ (line 6536)
+* postamble: makeindex. (line 13084)
+* postscript, in letters: \ps. (line 13583)
+* pounds symbol: Text symbols. (line 12064)
+* preamble: makeindex. (line 13080)
+* preamble, defined: Starting and ending.
+ (line 406)
+* prompt, *: Recovering from errors.
+ (line 13911)
+* pronunciation: Overview. (line 382)
+* PSTricks package: \line. (line 4494)
+* pt: Units of length. (line 7466)
+* quad: Spacing in math mode.
+ (line 9317)
+* question mark, upside-down: Text symbols. (line 12165)
+* quotation environment: quotation & quote. (line 4772)
+* quotation marks, French: Text symbols. (line 12046)
+* quote environment: quotation & quote. (line 4772)
+* quote, single straight: Text symbols. (line 12180)
+* quote, straight base: Text symbols. (line 12184)
+* quoted text with paragraph indentation, displaying: quotation & quote.
+ (line 4772)
+* quoted text without paragraph indentation, displaying: quotation & quote.
+ (line 4772)
+* radical: \sqrt. (line 9418)
+* ragged left text: \raggedleft. (line 3599)
+* ragged left text, environment for: flushright. (line 3581)
+* ragged right text: \raggedright. (line 3548)
+* ragged right text, environment for: flushleft. (line 3520)
+* redefining environments: \newenvironment & \renewenvironment.
+ (line 6733)
+* reference, forward: Cross references. (line 2768)
+* references, resolving forward: Output files. (line 449)
+* registered symbol: Text symbols. (line 12187)
+* relation, text above: \stackrel. (line 9434)
+* remarks in the margin: Marginal notes. (line 7798)
+* report class: Document classes. (line 734)
+* reporting bugs: About this document.
+ (line 335)
+* reserved characters: Reserved characters.
+ (line 11932)
+* resizing: \scalebox. (line 11866)
+* resizing <1>: \resizebox. (line 11897)
+* right angle quotation marks: Text symbols. (line 12046)
+* right arrow, in text: Text symbols. (line 12190)
+* right brace, in text: Text symbols. (line 12105)
+* right quote: Text symbols. (line 12071)
+* right quote, double: Text symbols. (line 12171)
+* right quote, single: Text symbols. (line 12177)
+* right-hand equation numbers: Document class options.
+ (line 820)
+* right-justifying text: \raggedleft. (line 3599)
+* right-justifying text, environment for: flushright. (line 3581)
+* ring accent: Accents. (line 12279)
+* ring accent, math: Math accents. (line 9207)
+* robust commands: \protect. (line 7011)
+* roman font: Font styles. (line 1374)
+* root file: Splitting the input.
+ (line 12425)
+* roots: \sqrt. (line 9418)
+* rotating graphics: \rotatebox. (line 11799)
+* rotating text: \rotatebox. (line 11799)
+* rotation: \rotatebox. (line 11799)
+* row, tabbing: tabbing. (line 4842)
+* rubber lengths, defining new: \newlength. (line 6684)
+* running header and footer: Page layout parameters.
+ (line 1769)
+* running header and footer style: \pagestyle. (line 9660)
+* sagetex package: Command line options.
+ (line 13821)
+* sans serif font: Font styles. (line 1380)
+* Scaled point: Units of length. (line 7492)
+* scaling: \scalebox. (line 11866)
+* scaling <1>: \resizebox. (line 11897)
+* script fonts: Calligraphic. (line 8949)
+* script letters for math: Font styles. (line 1368)
+* secnumdepth: Sectioning. (line 2108)
+* secnumdepth counter: Sectioning. (line 2109)
+* section: Sectioning. (line 2052)
+* section <1>: \section. (line 2278)
+* section number, cross referencing: \ref. (line 2869)
+* section numbers, printing: Sectioning. (line 2109)
+* section symbol: Text symbols. (line 12075)
+* section, redefining: \@startsection. (line 2548)
+* sectioning commands: Sectioning. (line 2052)
+* sectioning, part: \part. (line 2131)
+* series, of fonts: Low-level font commands.
+ (line 1513)
+* setspace package: Low-level font commands.
+ (line 1583)
+* setting counters: \setcounter. (line 7281)
+* shapes, of fonts: Low-level font commands.
+ (line 1553)
+* sharp S letters: Additional Latin letters.
+ (line 12344)
+* showidx package: Indexes. (line 12910)
+* simulating typed text: verbatim. (line 5639)
+* single angle quotation marks: Text symbols. (line 12046)
+* single guillemets: Text symbols. (line 12046)
+* single left quote: Text symbols. (line 12174)
+* single low-9 quotation mark: Text symbols. (line 12068)
+* single quote, straight: Text symbols. (line 12180)
+* single right quote: Text symbols. (line 12177)
+* siunitx package: ~. (line 10120)
+* sizes of text: Font sizes. (line 1436)
+* skip register, plain TeX: \newlength. (line 6684)
+* slanted font: Font styles. (line 1383)
+* slides class: Document classes. (line 734)
+* sloppypar: sloppypar. (line 5975)
+* sloppypar environment: sloppypar. (line 5975)
+* small caps font: Font styles. (line 1377)
+* sort: \newglossaryentry. (line 13305)
+* sp: Units of length. (line 7492)
+* space, hard: ~. (line 10094)
+* space, inserting horizontal: \hss. (line 9890)
+* space, inserting vertical: \addvspace. (line 10499)
+* space, negative thin: \thinspace & \negthinspace.
+ (line 10150)
+* space, thin: \thinspace & \negthinspace.
+ (line 10150)
+* space, unbreakable: ~. (line 10094)
+* space, vertical: \vspace. (line 10419)
+* spaces: Spaces. (line 9772)
+* spaces, ignore around commands: \ignorespaces & \ignorespacesafterend.
+ (line 7063)
+* spacing within math mode: Spacing in math mode.
+ (line 9272)
+* spacing, inter-sentence: \frenchspacing. (line 10023)
+* spacing, inter-sentence <1>: \normalsfcodes. (line 10043)
+* Spanish ordinals, feminine and masculine: Text symbols. (line 12159)
+* special characters: Reserved characters.
+ (line 11932)
+* special characters <1>: Additional Latin letters.
+ (line 12298)
+* special insertions: Special insertions.
+ (line 11926)
+* specifier, float placement: Floats. (line 1927)
+* splitting the input file: Splitting the input.
+ (line 12421)
+* square root: \sqrt. (line 9418)
+* stack math: \stackrel. (line 9434)
+* star-variants, commands: \@ifstar. (line 642)
+* starred form, defining new commands: \newcommand & \renewcommand.
+ (line 6509)
+* starting a new page: \newpage. (line 6124)
+* starting a new page and clearing floats: \clearpage & \cleardoublepage.
+ (line 6083)
+* starting and ending: Starting and ending.
+ (line 390)
+* starting on a right-hand page: \clearpage & \cleardoublepage.
+ (line 6083)
+* sterling symbol: Text symbols. (line 12064)
+* straight double quote, base: Text symbols. (line 12184)
+* straight quote, base: Text symbols. (line 12184)
+* straight single quote: Text symbols. (line 12180)
+* stretch, infinite horizontal: \hfill. (line 9857)
+* stretch, infinite vertical: \vfill. (line 10470)
+* stretch, omitting vertical: \raggedbottom. (line 1758)
+* strut: \strut. (line 10334)
+* styles of text: Font styles. (line 1296)
+* styles, page: Page styles. (line 9518)
+* subparagraph: Sectioning. (line 2052)
+* subparagraph <1>: \subsubsection & \paragraph & \subparagraph.
+ (line 2420)
+* subscript: Subscripts & superscripts.
+ (line 7938)
+* subsection: Sectioning. (line 2052)
+* subsection <1>: \subsection. (line 2356)
+* subsubsection: \subsubsection & \paragraph & \subparagraph.
+ (line 2420)
+* superscript: Subscripts & superscripts.
+ (line 7938)
+* symbol: \newglossaryentry. (line 13309)
+* symbols package: Math symbols. (line 8001)
+* symbols, boldface: \boldmath & \unboldmath.
+ (line 8967)
+* symbols, math: Math symbols. (line 8001)
+* symbols, text: Text symbols. (line 12021)
+* tab stops, using: tabbing. (line 4802)
+* tabbing environment: tabbing. (line 4802)
+* table environment: table. (line 4951)
+* table of contents entry, manually adding: \addcontentsline.
+ (line 12744)
+* table of contents file: Output files. (line 459)
+* table of contents, avoiding footnotes: Footnotes in section headings.
+ (line 6380)
+* table of contents, creating: Table of contents etc..
+ (line 12650)
+* table of contents, sectioning numbers printed: Sectioning.
+ (line 2120)
+* tables, creating: table. (line 4951)
+* tabular environment: tabular. (line 5011)
+* template, article: article template. (line 13969)
+* template, beamer: beamer template. (line 13938)
+* template, book: book template. (line 13989)
+* template, book <1>: Larger book template.
+ (line 14012)
+* template, TUGboat: tugboat template. (line 14062)
+* templates, document: Document templates.
+ (line 13931)
+* terminal input/output: Terminal input/output.
+ (line 13642)
+* TeX logo: Text symbols. (line 12078)
+* text symbols: Text symbols. (line 12021)
+* text, resizing: \scalebox. (line 11866)
+* text, resizing <1>: \resizebox. (line 11897)
+* text, scaling: \scalebox. (line 11866)
+* text, scaling <1>: \resizebox. (line 11897)
+* textcase package: Upper and lower case.
+ (line 12000)
+* textcomp package: Font styles. (line 1422)
+* textcomp package <1>: Text symbols. (line 12021)
+* thanks, for titlepage: \maketitle. (line 9581)
+* thebibliography environment: thebibliography. (line 5337)
+* theorem environment: theorem. (line 5570)
+* theorem-like environment: \newtheorem. (line 6867)
+* theorems, defining: \newtheorem. (line 6867)
+* theorems, typesetting: theorem. (line 5570)
+* thin space: Spacing in math mode.
+ (line 9298)
+* thin space <1>: \thinspace & \negthinspace.
+ (line 10150)
+* thin space, negative: Spacing in math mode.
+ (line 9312)
+* thin space, negative <1>: \thinspace & \negthinspace.
+ (line 10150)
+* thorn, Icelandic letter: Additional Latin letters.
+ (line 12348)
+* three-quarters em-dash: Text symbols. (line 12193)
+* tie: ~. (line 10094)
+* tie-after accent: Accents. (line 12285)
+* TikZ package: \line. (line 4494)
+* TikZ package <1>: \strut. (line 10390)
+* TikZ package <2>: \mbox & \makebox. (line 10621)
+* tilde accent: Accents. (line 12250)
+* tilde accent, math: Math accents. (line 9210)
+* tilde, ASCII, in text: Text symbols. (line 12084)
+* title page, separate or run-in: Document class options.
+ (line 828)
+* title pages, creating: titlepage. (line 5600)
+* title, for titlepage: \maketitle. (line 9588)
+* titlepage environment: titlepage. (line 5600)
* titlepage option: Document class options.
- (line 746)
+ (line 806)
+* titles, making: \maketitle. (line 9530)
+* titlesec package: \part. (line 2179)
+* titlesec package <1>: \chapter. (line 2258)
+* titlesec package <2>: \section. (line 2336)
+* titlesec package <3>: \subsection. (line 2402)
+* titlesec package <4>: \subsubsection & \paragraph & \subparagraph.
+ (line 2479)
+* tocbibbind package: Table of contents etc..
+ (line 12735)
+* tocdepth: Sectioning. (line 2119)
+* tocdepth counter: Sectioning. (line 2120)
+* tocloft package: Table of contents etc..
+ (line 12735)
+* today's date: \today. (line 12390)
+* tombstone: \rule. (line 12362)
* topmargin: Page layout parameters.
- (line 1808)
-* topnumber: Floats. (line 1954)
-* topnumber <1>: Floats. (line 1955)
-* totalnumber: Floats. (line 1958)
-* totalnumber <1>: Floats. (line 1959)
+ (line 1888)
+* topnumber: Floats. (line 2034)
+* topnumber <1>: Floats. (line 2035)
+* totalnumber: Floats. (line 2038)
+* totalnumber <1>: Floats. (line 2039)
+* trademark symbol: Text symbols. (line 12196)
+* transcript file: Output files. (line 444)
+* TrueType fonts: TeX engines. (line 468)
+* TUGboat template: tugboat template. (line 14062)
+* two-column output: \twocolumn. (line 1630)
+* two-thirds em-dash: Text symbols. (line 12199)
* twocolumn option: Document class options.
- (line 775)
+ (line 835)
* twoside option: Document class options.
- (line 775)
+ (line 835)
+* type styles: Font styles. (line 1296)
+* typed text, simulating: verbatim. (line 5639)
+* typeface sizes: Font sizes. (line 1436)
+* typefaces: Fonts. (line 1290)
+* typewriter font: Font styles. (line 1386)
+* typewriter labels in lists: description. (line 3160)
+* ulem package: Over- and Underlining.
+ (line 9236)
+* umlaut accent: Accents. (line 12227)
+* underbar: Accents. (line 12255)
+* underlining: Over- and Underlining.
+ (line 9227)
+* underscore, in text: Text symbols. (line 12202)
+* Unicode input, native: TeX engines. (line 468)
+* units, of length: Units of length. (line 7462)
+* unofficial nature of this manual: About this document.
+ (line 331)
+* unordered lists: itemize. (line 3624)
+* uppercase: Upper and lower case.
+ (line 11964)
+* url package: \verb. (line 5710)
+* using BibTeX: Using BibTeX. (line 5512)
* usrguide official documentation: About this document.
- (line 321)
-* verbatim environment: verbatim. (line 4447)
-* verse environment: verse. (line 4482)
-* xdvi command: Output files. (line 393)
-* xdvipdfmx: TeX engines. (line 467)
-* xelatex command: TeX engines. (line 467)
+ (line 350)
+* UTF-8: TeX engines. (line 468)
+* variables, a list of: Counters. (line 7138)
+* vector symbol, math: Math accents. (line 9213)
+* verbatim environment: verbatim. (line 5639)
+* verbatim text: verbatim. (line 5639)
+* verbatim text, inline: \verb. (line 5678)
+* verbatimbox package: verbatim. (line 5670)
+* verse environment: verse. (line 5725)
+* vertical bar, double, in text: Text symbols. (line 12096)
+* vertical bar, in text: Text symbols. (line 12093)
+* vertical mode: Modes. (line 9472)
+* vertical space: \vspace. (line 10419)
+* vertical space <1>: \addvspace. (line 10499)
+* vertical space before paragraphs: \parindent & \parskip.
+ (line 7771)
+* visible space: \verb. (line 5703)
+* visible space symbol, in text: Text symbols. (line 12205)
+* weights, of fonts: Low-level font commands.
+ (line 1523)
+* white space: Spaces. (line 9772)
+* wide hat accent, math: Math accents. (line 9216)
+* wide tilde accent, math: Math accents. (line 9219)
+* widths, of fonts: Low-level font commands.
+ (line 1535)
+* writing external files: filecontents. (line 3469)
+* writing letters: Letters. (line 13345)
+* x-height: Units of length. (line 7494)
+* xdvi command: Output files. (line 426)
+* xdvipdfmx: TeX engines. (line 501)
+* xelatex command: TeX engines. (line 501)
+* XeTeX: TeX engines. (line 501)
+* xindy: makeindex. (line 13183)
+* xindy program: makeindex. (line 13183)
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.xml b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.xml
index 2658617dce8..b8bafbf5b69 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.xml
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.xml
@@ -3,39 +3,44 @@
<texinfo xml:lang="en">
<filename file="latex2e.xml"></filename>
<preamble>\input texinfo
-</preamble><!-- c $Id: latex2e.texi 613 2018-03-21 18:48:08Z jimhefferon $ -->
+</preamble><!-- c $Id: latex2e.texi 678 2018-07-02 20:51:26Z karl $ -->
<!-- comment %**start of header (This is for running Texinfo on a region.) -->
<setfilename file="latex2e.info" spaces=" ">latex2e.info</setfilename>
-<set name="UPDATED" line=" UPDATED March 2018">March 2018</set>
-<set name="LTXREFMAN_HOME_PAGE" line=" LTXREFMAN_HOME_PAGE http://puszcza.gnu.org.ua/software/latexrefman/
-">http://puszcza.gnu.org.ua/software/latexrefman/</set>
-<set name="LTXREFMAN_BUGS" line=" LTXREFMAN_BUGS latexrefman@@tug.org
-">latexrefman@@tug.org</set>
-<clear name="HAS-MATH" line=" HAS-MATH
-"></clear>
-<macro name="iftexthenelse" line=" iftexthenelse {then,else}
-"><formalarg>then</formalarg><formalarg>else</formalarg>\else\@c
+<set name="UPDATED" line=" UPDATED July 2018">July 2018</set>
+<!-- c $Id$ -->
+<!-- c Public domain. -->
+<set name="LTXREFMAN_HOME_PAGE" line=" LTXREFMAN_HOME_PAGE puszcza.gnu.org.ua/software/latexrefman">puszcza.gnu.org.ua/software/latexrefman</set>
+<set name="LTXREFMAN_BUGS" line=" LTXREFMAN_BUGS latexrefman@@tug.org">latexrefman@@tug.org</set>
+<clear name="HAS-MATH" line=" HAS-MATH "></clear>
+<macro name="iftexthenelse" line=" iftexthenelse {then,else}"><formalarg>then</formalarg><formalarg>else</formalarg>\else\@c
</macro>
-<settitle spaces=" ">&latex;2e unofficial reference manual (March 2018)</settitle>
+<settitle spaces=" ">&latex;2e unofficial reference manual (July 2018)</settitle>
<!-- comment %**end of header (This is for running Texinfo on a region.) -->
<!-- c latex 2.09 commands should all be present now, -->
<!-- c xx but latex2e stuff is missing. -->
<!-- c xx random list of a few of the missing items is at the end of this file -->
<!-- c -->
-<!-- c xx ending a run with errors -->
<!-- c xx ctan, distributions, components of TeX -->
<!-- c xx classes and packages - required, additional, useful; oberdiek; fonts -->
<!-- c -->
-<!-- c xx merge http://ctan.org/pkg/latex-info (CTAN package latex-info) -->
-<!-- c xx merge http://ctan.org/pkg/latex2e-reference -->
<!-- c xx merge permuted-index -->
<!-- c xx merge latex-manual from savannah -->
<!-- c xx merge display style math -->
-<!-- c xx vertical mode, horizontal mode -->
-<!-- c xx JH Discuss restricted execution -->
+<!-- c xx JH explain nfss somewhere -->
+<!-- c xx JH expand BiBTeX -->
+<!-- c xx JH expand theorem, AMS math -->
+<!-- c xx JH something on code listings -->
+<!-- c xx JH ligatures -->
+<!-- c xx JH \xspace -->
+<!-- c xx JH \stretch -->
+<!-- c xx JH \mathstrut -->
+<!-- c xx JH \phantom https://tex.stackexchange.com/questions/4519/how-do-i-create-an-invisible-character -->
+<!-- c xx JH \baselineskip https://texfaq.org/FAQ-baselinepar -->
+<!-- c xx JH \contentsline, \@@dottedtocline? -->
+<!-- c xx JH more on \write18, beyond what's mentioned in Command line. -->
<!-- c -->
<!-- c xx The typeset source2e has an index with all kernel -->
<!-- c xx commands, though some are internal and shouldn't be included. -->
@@ -44,7 +49,7 @@
<copying endspaces=" ">
<para>This document is an unofficial reference manual for &latex;, a
-document preparation system, version of March 2018.
+document preparation system, version of July 2018.
</para>
<para>This manual was originally translated from <file>LATEX.HLP</file> v1.0a in
the VMS Help Library. The pre-translation version was written by
@@ -85,6 +90,9 @@ into another language, under the above conditions for modified versions.
<!-- comment end of License -->
</para></copying>
+<!-- c Merge into one index (arbitrarily chosen to be the concept index). -->
+<syncodeindex from="fn" to="cp" line=" fn cp"></syncodeindex>
+
<dircategory spaces=" ">TeX</dircategory>
<direntry endspaces=" ">
<menuentry leadingtext="* "><menutitle separator=": ">LaTeX2e</menutitle><menunode separator=". ">(latex2e)</menunode><menudescription><pre xml:space="preserve">Unofficial LaTeX reference manual.
@@ -95,8 +103,8 @@ into another language, under the above conditions for modified versions.
<titlepage endspaces=" ">
<title spaces=" ">&latex;2e: An unofficial reference manual</title>
-<subtitle spaces=" ">March 2018</subtitle>
-<author spaces=" "><url><urefurl>http://puszcza.gnu.org.ua/software/latexrefman/</urefurl></url></author>
+<subtitle spaces=" ">July 2018</subtitle>
+<author spaces=" "><url><urefurl>puszcza.gnu.org.ua/software/latexrefman</urefurl></url></author>
<page></page>
<vskip> 0pt plus 1filll</vskip>
<insertcopying></insertcopying>
@@ -127,7 +135,7 @@ into another language, under the above conditions for modified versions.
<top spaces=" "><sectiontitle>&latex;2e: An unofficial reference manual</sectiontitle>
<para>This document is an unofficial reference manual (version of
-March 2018) for &latex;2e, a document preparation system.
+July 2018) for &latex;2e, a document preparation system.
</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">About this document</menunode><menudescription><pre xml:space="preserve">Bug reporting, etc.
@@ -135,7 +143,7 @@ March 2018) for &latex;2e, a document preparation system.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Document classes</menunode><menudescription><pre xml:space="preserve">Some of the various classes available.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Fonts</menunode><menudescription><pre xml:space="preserve">Italic, bold, typewriter, etc.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Layout</menunode><menudescription><pre xml:space="preserve">Controlling the page layout.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Sectioning</menunode><menudescription><pre xml:space="preserve">How to section properly.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Sectioning</menunode><menudescription><pre xml:space="preserve">Parts, Chapters, Sections, etc.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Cross references</menunode><menudescription><pre xml:space="preserve">Automatic referencing.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Environments</menunode><menudescription><pre xml:space="preserve">Such as enumerate &amp; itemize.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Line breaking</menunode><menudescription><pre xml:space="preserve">Influencing line breaks.
@@ -159,8 +167,7 @@ March 2018) for &latex;2e, a document preparation system.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Terminal input/output</menunode><menudescription><pre xml:space="preserve">User interaction.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Command line</menunode><menudescription><pre xml:space="preserve">System-independent command-line behavior.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Document templates</menunode><menudescription><pre xml:space="preserve">Starter templates for various document classes.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Concept Index</menunode><menudescription><pre xml:space="preserve">General index.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Command Index</menunode><menudescription><pre xml:space="preserve">Alphabetical list of &latex; commands.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Index</menunode><menudescription><pre xml:space="preserve">General index.
</pre></menudescription></menuentry></menu>
@@ -168,29 +175,29 @@ March 2018) for &latex;2e, a document preparation system.
<node name="About-this-document" spaces=" "><nodename>About this document</nodename><nodenext automatic="on">Overview</nodenext><nodeprev automatic="on">Top</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>About this document</sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1"><url><urefurl>http://puszcza.gnu.org.ua/software/latexrefman/</urefurl></url> <r>home page</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="1">home page for manual</indexterm></cindex>
<para>This is an unofficial reference manual for the &latex;2e document
preparation system, which is a macro package for the &tex;
typesetting program (<pxref label="Overview"><xrefnodename>Overview</xrefnodename></pxref>). This document&textrsquo;s home page is
-<url><urefurl>http://puszcza.gnu.org.ua/software/latexrefman/</urefurl></url>. That page has links to the
+<url><urefurl>puszcza.gnu.org.ua/software/latexrefman</urefurl></url>. That page has links to the
current output in various formats, sources, mailing list archives and
subscriptions, and other infrastructure.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="1">&latex; vs.&noeos; &latex;2e</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="2">&latex; vs.&noeos; &latex;2e</indexterm></cindex>
<para>In this document, we will mostly just use &textlsquo;&latex;&textrsquo; rather than
&textlsquo;&latex;2e&textrsquo;, since the previous version of &latex;&nbsp;(2.09) was
frozen decades ago.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="2">unofficial nature of this manual</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="3">&latex; Project team</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="2"><email><emailaddress>latexrefman&arobase;tug.org</emailaddress></email> <r>email address</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="3">unofficial nature of this manual</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="4">&latex; Project team</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1" mergedindex="cp"><email><emailaddress>latexrefman&arobase;tug.org</emailaddress></email> <r>email address</r></indexterm></findex>
<para>&latex; is currently maintained by a group of volunteers
(<url><urefurl>http://latex-project.org</urefurl></url>). The official documentation written by
the &latex; project is available from their web site. This document is
completely unofficial and has not been reviewed by the &latex;
maintainers.
-<cindex index="cp" spaces=" "><indexterm index="cp" number="4">bug reporting</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="5">reporting bugs</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="5">bug reporting</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="6">reporting bugs</indexterm></cindex>
Do not send bug reports or anything else about this document to them.
Instead, please send all comments to <email><emailaddress>latexrefman&arobase;tug.org</emailaddress></email>.
</para>
@@ -200,21 +207,21 @@ introductions.
</para>
<table commandarg="url" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="url">http://ctan.org/pkg/latex-doc-ptr</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="3">latex-doc-ptr <r>document</r></indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="2" mergedindex="cp">latex-doc-ptr <r>document</r></indexterm></findex>
<para>Two pages of recommended references to &latex; documentation.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="url">http://ctan.org/pkg/first-latex-doc</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="4">first-latex-doc <r>document</r></indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="3" mergedindex="cp">first-latex-doc <r>document</r></indexterm></findex>
<para>Writing your first document, with a bit of both text and math.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="url">http://ctan.org/pkg/usrguide</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="5">usrguide <r>official documentation</r></indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="4" mergedindex="cp">usrguide <r>official documentation</r></indexterm></findex>
<para>The guide for document authors that is maintained as part of &latex;.
Many other guides by many other people are also available, independent
of &latex; itself; one such is the next item:
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="url">http://ctan.org/pkg/lshort</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="6">lshort <r>document</r></indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="5" mergedindex="cp">lshort <r>document</r></indexterm></findex>
<para>A short introduction to &latex;, translated to many languages.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="url">http://tug.org/begin.html</itemformat></item>
@@ -228,18 +235,18 @@ references.
<node name="Overview" spaces=" "><nodename>Overview</nodename><nodenext automatic="on">Document classes</nodenext><nodeprev automatic="on">About this document</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Overview of &latex;</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="6">overview of &latex;</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="7">basics of &latex;</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="8">Knuth, Donald E.</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="9">Lamport, Leslie</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="10">&latex; overview</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="7">overview of &latex;</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="8">basics of &latex;</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="9">Knuth, Donald E.</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="10">Lamport, Leslie</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="11">&latex; overview</indexterm></cindex>
<para>&latex; is a system for typesetting documents. It was originally
created by Leslie Lamport and is now maintained by a group of volunteers
(<url><urefurl>http://latex-project.org</urefurl></url>). It is widely used, particularly for
complex and technical documents, such as those involving mathematics.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="11">macro package, &latex; as</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="12">macro package, &latex; as</indexterm></cindex>
<para>A &latex; user writes an input file containing text along with
interspersed commands, for instance commands describing how the text
should be formatted. It is implemented as a set of related commands
@@ -252,18 +259,19 @@ input file to the &tex; engine.
the document is marked up, that is, to mean the set of commands
available to a &latex; user.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="12">Lamport &tex;</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="13">pronunciation</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="13">Lamport &tex;</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="14">pronunciation</indexterm></cindex>
<para>The name &latex; is short for &textldquo;Lamport &tex;&textrdquo;. It is pronounced
LAH-teck or LAY-teck, or sometimes LAY-tecks. Inside a document,
produce the logo with <code>\LaTeX</code>. Where use of the logo is not
sensible, such as in plain text, write it as <samp>LaTeX</samp>.
</para>
<menu endspaces=" ">
-<menuentry leadingtext="* "><menunode separator=":: ">Starting and ending</menunode><menudescription><pre xml:space="preserve">The standard beginning and end of a document.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Output files</menunode><menudescription><pre xml:space="preserve">Files produced.
+<menuentry leadingtext="* "><menunode separator=":: ">Starting and ending</menunode><menudescription><pre xml:space="preserve">The standard beginning and end of a document.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Output files</menunode><menudescription><pre xml:space="preserve">Files produced.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">&tex; engines</menunode><menudescription><pre xml:space="preserve">Programs that can compile &tex; and &latex;.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">&latex; command syntax</menunode><menudescription><pre xml:space="preserve">General syntax of &latex; commands.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">CTAN</menunode><menudescription><pre xml:space="preserve">Our repository.
</pre></menudescription></menuentry></menu>
@@ -271,12 +279,12 @@ sensible, such as in plain text, write it as <samp>LaTeX</samp>.
<section spaces=" "><sectiontitle>Starting and ending</sectiontitle>
<anchor name="Starting-_0026-ending">Starting &amp; ending</anchor><!-- c old name -->
-<cindex index="cp" spaces=" "><indexterm index="cp" number="14">starting and ending</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="15">ending and starting</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="16">hello, world</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="15">starting and ending</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="16">ending and starting</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="17">hello, world</indexterm></cindex>
<para>&latex; files have a simple global structure, with a standard beginning
-and ending. Here is a &textldquo;hello, world&textrdquo; example:
+and ending. This is a small example.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\documentclass&lbrace;article&rbrace;
@@ -285,24 +293,29 @@ Hello, \LaTeX\ world.
\end&lbrace;document&rbrace;
</pre></example>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="17">document class, defined</indexterm></cindex>
<noindent></noindent>
-<para>Here, the <samp>article</samp> is the so-called <dfn>document class</dfn>,
-implemented in a file <file>article.cls</file>. Any document class can be
-used. A few document classes are defined by &latex; itself, and vast
+<para>Every &latex; document has a <code>\begin&lbrace;document&rbrace;</code> line and an
+<code>\end&lbrace;document&rbrace;</code> line.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="18">document class, defined</indexterm></cindex>
+<noindent></noindent>
+<para>Here, the <samp>article</samp> is the <dfn>document class</dfn>. It is implemented
+in a file <file>article.cls</file>. You can use any document class on your
+system. A few document classes are defined by &latex; itself, and vast
array of others are widely available. <xref label="Document-classes"><xrefnodename>Document classes</xrefnodename></xref>.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="18">preamble, defined</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="19">preamble, defined</indexterm></cindex>
<para>You can include other &latex; commands between the
<code>\documentclass</code> and the <code>\begin&lbrace;document&rbrace;</code> commands.
This area is called the <dfn>preamble</dfn>.
</para>
-<para>The <code>\begin&lbrace;document&rbrace; ... \end&lbrace;document&rbrace;</code> is a so-called
-<cindex index="cp" spaces=" "><indexterm index="cp" number="19">environment</indexterm></cindex>
+<para>The <code>\begin&lbrace;document&rbrace;</code>, <code>\end&lbrace;document&rbrace;</code> pair defines an
+<cindex index="cp" spaces=" "><indexterm index="cp" number="20">environment</indexterm></cindex>
<dfn>environment</dfn>; the <samp>document</samp> environment (and no others) is
-required in all &latex; documents (<pxref label="document"><xrefnodename>document</xrefnodename></pxref>). &latex;
-provides many environments itself, and many more are defined separately.
-<xref label="Environments"><xrefnodename>Environments</xrefnodename></xref>.
+required in all &latex; documents (<pxref label="document"><xrefnodename>document</xrefnodename></pxref>). &latex; make
+available to you many environments that are documented here
+(<pxref label="Environments"><xrefnodename>Environments</xrefnodename></pxref>). Many more are available to you from external
+packages, most importantly those available at CTAN (<pxref label="CTAN"><xrefnodename>CTAN</xrefnodename></pxref>).
</para>
<para>The following sections discuss how to produce PDF or other output from
a &latex; input file.
@@ -312,17 +325,18 @@ a &latex; input file.
<node name="Output-files" spaces=" "><nodename>Output files</nodename><nodenext automatic="on">&tex; engines</nodenext><nodeprev automatic="on">Starting and ending</nodeprev><nodeup automatic="on">Overview</nodeup></node>
<section spaces=" "><sectiontitle>Output files</sectiontitle>
-<para>&latex; produces a main output file and at least two accessory files.
+<para>&latex; produces a main output file and at least two auxiliary files.
The main output file&textrsquo;s name ends in either <file>.dvi</file> or <file>.pdf</file>.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">.dvi</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="7">.dvi <r>file</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="8">latex <r>command</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="9">xdvi <r>command</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="10">dvips <r>command</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="11">dvipdfmx <r>command</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="12">dvitype <r>command</r></indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="6" mergedindex="cp">.dvi <r>file</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="7" mergedindex="cp">latex <r>command</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="8" mergedindex="cp">xdvi <r>command</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="9" mergedindex="cp">dvips <r>command</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="10" mergedindex="cp">dvipdfmx <r>command</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="11" mergedindex="cp">dvitype <r>command</r></indexterm></findex>
+<anchor name="output-files-dvi">output files dvi</anchor>
<para>If &latex; is invoked with the system command <command>latex</command> then it
produces a DeVice Independent file, with extension <file>.dvi</file>. You
can view this file with a command such as <command>xdvi</command>, or convert
@@ -333,9 +347,10 @@ The contents of the file can be dumped in human-readable form with
available (<url><urefurl>http://mirror.ctan.org/dviware</urefurl></url>).
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">.pdf</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="13">.pdf <r>file</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="20">pdf&tex;</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="14">pdflatex <r>command</r></indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="12" mergedindex="cp">.pdf <r>file</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="21">pdf&tex;</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="13" mergedindex="cp">pdflatex <r>command</r></indexterm></findex>
+<anchor name="output-files-pdf">output files pdf</anchor>
<para>If &latex; is invoked via the system command <command>pdflatex</command>,
among other commands (<pxref label="TeX-engines"><xrefnodename>&tex; engines</xrefnodename></pxref>), then the main output is
a Portable Document Format (PDF) file. Typically this is a
@@ -347,19 +362,21 @@ self-contained file, with all fonts and images included.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">.log</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="21">transcript file</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="22">log file</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="15">.log <r>file</r></indexterm></findex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="22">transcript file</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="23">log file</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="14" mergedindex="cp">.log <r>file</r></indexterm></findex>
+<anchor name="output-files-log">output files log</anchor>
<para>This transcript file contains summary information such as a list of
loaded packages. It also includes diagnostic messages and perhaps
additional information for any errors.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">.aux</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="23">auxiliary file</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="16">.aux <r>file</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="24">cross references, resolving</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="25">forward references, resolving</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="26">references, resolving forward</indexterm></cindex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="24">auxiliary file</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="15" mergedindex="cp">.aux <r>file</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="25">cross references, resolving</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="26">forward references, resolving</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="27">references, resolving forward</indexterm></cindex>
+<anchor name="output-files-aux">output files aux</anchor>
<para>Auxiliary information is used by &latex; for things such as
cross references. For example, the first time that &latex; finds a
forward reference&textmdash;a cross reference to something that has not yet
@@ -373,41 +390,43 @@ location.
</para>
</tableitem></tableentry></table>
-<findex index="fn" spaces=" "><indexterm index="fn" number="17">.lof <r>file</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="27">list of figures file</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="18">.lot <r>file</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="28">list of tables file</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="19">.toc <r>file</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="29">table of contents file</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="30">contents file</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="16" mergedindex="cp">.lof <r>file</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="28">list of figures file</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="17" mergedindex="cp">.lot <r>file</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="29">list of tables file</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="18" mergedindex="cp">.toc <r>file</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="30">table of contents file</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="31">contents file</indexterm></cindex>
<para>&latex; may produce yet more files, characterized by the filename
-ending. These include a <code>.lof</code> file that is used to make a list
-of figures, a <code>.lot</code> file used to make a list of tables, and a
-<code>.toc</code> file used to make a table of contents. A particular class
-may create others; the list is open-ended.
+ending. These include a <code>.lof</code> file that is used to make a list of
+figures, a <code>.lot</code> file used to make a list of tables, and a
+<code>.toc</code> file used to make a table of contents (<pxref label="Table-of-contents-etc_002e"><xrefnodename>Table of
+contents etc.</xrefnodename></pxref>). A particular class may create others; the list is
+open-ended.
</para>
</section>
<node name="TeX-engines" spaces=" "><nodename>&tex; engines</nodename><nodenext automatic="on">&latex; command syntax</nodenext><nodeprev automatic="on">Output files</nodeprev><nodeup automatic="on">Overview</nodeup></node>
<section spaces=" "><sectiontitle>&tex; engines</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="31">engines, &tex;</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="32">implementations of &tex;</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="33">UTF-8</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="34">Unicode input, native</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="35">TrueType fonts</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="36">OpenType fonts</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="32">engines, &tex;</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="33">implementations of &tex;</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="34">UTF-8</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="35">Unicode input, native</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="36">TrueType fonts</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="37">OpenType fonts</indexterm></cindex>
<para>&latex; is defined to be a set of commands that are run by a &tex;
implementation (<pxref label="Overview"><xrefnodename>Overview</xrefnodename></pxref>). This section gives a terse
-overview of the main programs.
+overview of the main programs (see also&nbsp;<ref label="Command-line"><xrefnodename>Command line</xrefnodename></ref>).
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">latex</itemformat></item>
<itemx spaces=" "><itemformat command="code">pdflatex</itemformat></itemx>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="37">pdf&tex; engine</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="20">etex <r>command</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="38">e-&tex;</indexterm></cindex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="38">pdf&tex; engine</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="19" mergedindex="cp">etex <r>command</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="39">e-&tex;</indexterm></cindex>
+<anchor name="tex-engines-latex">tex engines latex</anchor>
<para>In &tex; Live (<url><urefurl>http://tug.org/texlive</urefurl></url>), if &latex; is invoked
via either the system command <command>latex</command> or <command>pdflatex</command>,
then the pdf&tex; engine is run (<url><urefurl>http://ctan.org/pkg/pdftex</urefurl></url>).
@@ -426,8 +445,9 @@ rather than pdf&tex;. In any case, the e-&tex; extensions can be
assumed to be available in &latex;.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">lualatex</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="21">lualatex <r>command</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="39">Lua&tex;</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="20" mergedindex="cp">lualatex <r>command</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="40">Lua&tex;</indexterm></cindex>
+<anchor name="tex-engines-lualatex">tex engines lualatex</anchor>
<para>If &latex; is invoked via the system command <command>lualatex</command>, the
Lua&tex; engine is run (<url><urefurl>http://ctan.org/pkg/luatex</urefurl></url>). This
program allows code written in the scripting language Lua
@@ -438,10 +458,11 @@ There is also <command>dvilualatex</command> to produce a <file>.dvi</file> file
but this is rarely used.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">xelatex</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="22">xelatex <r>command</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="40">Xe&tex;</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="23">.xdv <r>file</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="24">xdvipdfmx</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="21" mergedindex="cp">xelatex <r>command</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="41">Xe&tex;</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="22" mergedindex="cp">.xdv <r>file</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="23" mergedindex="cp">xdvipdfmx</indexterm></findex>
+<anchor name="tex-engines-xelatex">tex engines xelatex</anchor>
<para>If &latex; is invoked with the system command <command>xelatex</command>, the
Xe&tex; engine is run (<url><urefurl>http://tug.org/xetex</urefurl></url>). Like Lua&tex;,
Xe&tex; natively supports UTF-8 Unicode and TrueType and OpenType
@@ -462,13 +483,13 @@ additional support for Japanese and other languages ([u]p&tex;,
</para>
</section>
-<node name="LaTeX-command-syntax" spaces=" "><nodename>&latex; command syntax</nodename><nodeprev automatic="on">&tex; engines</nodeprev><nodeup automatic="on">Overview</nodeup></node>
+<node name="LaTeX-command-syntax" spaces=" "><nodename>&latex; command syntax</nodename><nodenext automatic="on">CTAN</nodenext><nodeprev automatic="on">&tex; engines</nodeprev><nodeup automatic="on">Overview</nodeup></node>
<section spaces=" "><sectiontitle>&latex; command syntax</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="41">command syntax</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="25">\ <r>character starting commands</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="26">[...] <r>for optional arguments</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="27">&lbrace;...&rbrace; <r>for required arguments</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="42">command syntax</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="24" mergedindex="cp">\ <r>character starting commands</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="25" mergedindex="cp">[...] <r>for optional arguments</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="26" mergedindex="cp">&lbrace;...&rbrace; <r>for required arguments</r></indexterm></findex>
<para>In the &latex; input file, a command name starts with a backslash
character, <code>\</code>. The name itself then consists of either
(a)&nbsp;a string of letters or (b)&nbsp;a single non-letter.
@@ -503,7 +524,7 @@ commands it covers (barring unintentional omissions, a.k.a.&noeos; bugs).
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">Environment</menunode><menudescription><pre xml:space="preserve">Area of the source with distinct behavior.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Declaration</menunode><menudescription><pre xml:space="preserve">Change the value or meaning of a command.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\makeatletter and \makeatother</menunode><menudescription><pre xml:space="preserve">Change the status of the at-sign character.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\makeatletter &amp; \makeatother</menunode><menudescription><pre xml:space="preserve">Change the status of the at-sign character.
</pre></menudescription></menuentry></menu>
@@ -529,7 +550,7 @@ behavior. For instance, for poetry in &latex; put the lines between
\end&lbrace;verse&rbrace;
</pre></example>
-<para>See&nbsp;<ref label="Environments"><xrefnodename>Environments</xrefnodename></ref> for a list of environments.
+<para><xref label="Environments"><xrefnodename>Environments</xrefnodename></xref> for a list of environments.
</para>
<para>The <var>environment name</var> at the beginning must exactly match that at
the end. This includes the case where <var>environment name</var> ends in a
@@ -549,7 +570,7 @@ required (it specifies the formatting of columns).
</subsection>
-<node name="Declaration" spaces=" "><nodename>Declaration</nodename><nodenext automatic="on">\makeatletter and \makeatother</nodenext><nodeprev automatic="on">Environment</nodeprev><nodeup automatic="on">&latex; command syntax</nodeup></node>
+<node name="Declaration" spaces=" "><nodename>Declaration</nodename><nodenext automatic="on">\makeatletter &amp; \makeatother</nodenext><nodeprev automatic="on">Environment</nodeprev><nodeup automatic="on">&latex; command syntax</nodeup></node>
<subsection spaces=" "><sectiontitle>Command declarations</sectiontitle>
<para>A command that changes the value, or changes the meaning, of some other
@@ -558,8 +579,8 @@ changes the setting of page numbers from roman numerals to arabic.
</para>
</subsection>
-<node name="_005cmakeatletter-and-_005cmakeatother" spaces=" "><nodename>\makeatletter and \makeatother</nodename><nodeprev automatic="on">Declaration</nodeprev><nodeup automatic="on">&latex; command syntax</nodeup></node>
-<subsection spaces=" "><sectiontitle><code>\makeatletter</code> and <code>\makeatother</code></sectiontitle>
+<node name="_005cmakeatletter-_0026-_005cmakeatother" spaces=" "><nodename>\makeatletter &amp; \makeatother</nodename><nodeprev automatic="on">Declaration</nodeprev><nodeup automatic="on">&latex; command syntax</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\makeatletter</code> &amp; <code>\makeatother</code></sectiontitle>
<para>Synopsis:
</para>
@@ -576,9 +597,9 @@ its original value.
</para>
<para>As each character is read by &tex; for &latex;, it is assigned a
character category code, or
-<cindex index="cp" spaces=" "><indexterm index="cp" number="42">catcode</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="43">character category code</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="44">category code, character</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="43">catcode</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="44">character category code</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="45">category code, character</indexterm></cindex>
<dfn>catcode</dfn> for short. For instance, the backslash&nbsp;<code>\</code> is
assigned the catcode 0, for characters that start a command. These two
commands alter the catcode assigned to <code>&arobase;</code>.
@@ -599,16 +620,16 @@ them inside <file>.sty</file> or <file>.cls</file> files since the
<code>\usepackage</code> and <code>\documentclass</code> commands set the at sign to
have the character code of a letter.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="45"><r>package</r>, <code>macros2e</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="46"><code>macros2e</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="46"><r>package</r>, <code>macros2e</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="47"><code>macros2e</code> <r>package</r></indexterm></cindex>
<para>For a comprehensive list of macros with an at-sign
in their names see <url><urefurl>http://ctan.org/pkg/macros2e</urefurl></url>. These macros are
mainly intended to package or class authors.
</para>
-<para>The example below is typical. In the user&textrsquo;s class file is a command
-<code>\thesis&arobase;universityname</code>. The user wants to change the
-definition. These three lines should go in the preamble, before the
+<para>In this example the class file has a command
+<code>\thesis&arobase;universityname</code> that the user wants to change. These
+three lines should go in the preamble, before the
<code>\begin&lbrace;document&rbrace;</code>.
</para>
<example endspaces=" ">
@@ -622,19 +643,19 @@ definition. These three lines should go in the preamble, before the
</pre></menudescription></menuentry></menu>
-<node name="_005c_0040ifstar" spaces=" "><nodename>\&arobase;ifstar</nodename><nodeup automatic="on">\makeatletter and \makeatother</nodeup></node>
+<node name="_005c_0040ifstar" spaces=" "><nodename>\&arobase;ifstar</nodename><nodeup automatic="on">\makeatletter &amp; \makeatother</nodeup></node>
<subsubsection spaces=" "><sectiontitle><code>\&arobase;ifstar</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="28">\&arobase;ifstar</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="47">commands, star-variants</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="48">star-variants, commands</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="27" mergedindex="cp">\&arobase;ifstar</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="48">commands, star-variants</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="49">star-variants, commands</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newcommand&lbrace;\mycmd&rbrace;&lbrace;\&arobase;ifstar&lbrace;\mycmd&arobase;star&rbrace;&lbrace;\mycmd&arobase;nostar&rbrace;&rbrace;
-\newcommand&lbrace;\mycmd&arobase;nostar&rbrace;[<var>non-starred command number of args</var>]&lbrace;<var>body of non-starred command</var>&rbrace;
-\newcommand&lbrace;\mycmd&arobase;star&rbrace;[<var>starred command number of args</var>]&lbrace;<var>body of starred command</var>&rbrace;
+\newcommand&lbrace;\mycmd&arobase;nostar&rbrace;[<var>nostar-num-args</var>]&lbrace;<var>nostar-body</var>&rbrace;
+\newcommand&lbrace;\mycmd&arobase;star&rbrace;[<var>star-num-args</var>]&lbrace;<var>star-body</var>&rbrace;
</pre></example>
<para>Many standard &latex; environments or commands have a variant with the
@@ -655,7 +676,7 @@ are <code>\mycmd&arobase;nostar</code> and <code>\mycmd&arobase;star</code>. Th
same number of arguments or a different number, or no arguments at all.
As always, in a &latex; document a command using at-sign&nbsp;<code>&arobase;</code>
must be enclosed inside a <code>\makeatletter ... \makeatother</code> block
-(<pxref label="_005cmakeatletter-and-_005cmakeatother"><xrefnodename>\makeatletter and \makeatother</xrefnodename></pxref>).
+(<pxref label="_005cmakeatletter-_0026-_005cmakeatother"><xrefnodename>\makeatletter &amp; \makeatother</xrefnodename></pxref>).
</para>
<para>This example of <code>\&arobase;ifstar</code> defines the command <code>\ciel</code> and a
variant <code>\ciel*</code>. Both have one required argument. A call to
@@ -669,15 +690,16 @@ variant <code>\ciel*</code>. Both have one required argument. A call to
</pre></example>
<para>In the next example, the starred variant takes a different number of
-arguments than does the unstarred one. With this definition, Agent
-007&textrsquo;s <code>``My name is \agentsecret*&lbrace;Bond&rbrace;,
-\agentsecret&lbrace;James&rbrace;&lbrace;Bond&rbrace;.''</code> is equivalent to <code>``My name is
-\textsc&lbrace;Bond&rbrace;, \textit&lbrace;James&rbrace; textsc&lbrace;Bond&rbrace;.''</code>
+arguments than the unstarred one. With this definition, Agent 007&textrsquo;s
+<code>``My name is \agentsecret*&lbrace;Bond&rbrace;,
+\agentsecret&lbrace;James&rbrace;&lbrace;Bond&rbrace;.''</code> is equivalent to entering the commands
+<code>``My name is \textsc&lbrace;Bond&rbrace;, \textit&lbrace;James&rbrace; textsc&lbrace;Bond&rbrace;.''</code>
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newcommand*&lbrace;\agentsecret&arobase;unstarred&rbrace;[2]&lbrace;\textit&lbrace;#1&rbrace; \textsc&lbrace;#2&rbrace;&rbrace;
\newcommand*&lbrace;\agentsecret&arobase;starred&rbrace;[1]&lbrace;\textsc&lbrace;#1&rbrace;&rbrace;
-\newcommand*&lbrace;\agentsecret&rbrace;&lbrace;\&arobase;ifstar&lbrace;\agentsecret&arobase;starred&rbrace;&lbrace;\agentsecret&arobase;unstarred&rbrace;&rbrace;
+\newcommand*&lbrace;\agentsecret&rbrace;&lbrace;%
+ \&arobase;ifstar&lbrace;\agentsecret&arobase;starred&rbrace;&lbrace;\agentsecret&arobase;unstarred&rbrace;&rbrace;
</pre></example>
<para>There are two sometimes more convenient ways to accomplish the work of
@@ -697,13 +719,46 @@ arguments than does the unstarred one. With this definition, Agent
</subsubsection>
</subsection>
</section>
+<node name="CTAN" spaces=" "><nodename>CTAN</nodename><nodeprev automatic="on">&latex; command syntax</nodeprev><nodeup automatic="on">Overview</nodeup></node>
+<section spaces=" "><sectiontitle>CTAN: Comprehensive &tex; Archive Network</sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="50">CTAN</indexterm></cindex>
+
+<para>The Comprehensive &tex; Archive Network, CTAN, is the &tex; and
+&latex; community&textrsquo;s repository of free material. It is a set of
+Internet sites around the world that offer material related to &latex;
+for download. Visit CTAN on the web at <url><urefurl>https://ctan.org</urefurl></url>.
+</para>
+<para>This material is organized into packages, discrete bundles that
+typically offer some coherent functionality and are maintained by one
+person or a small number of people. For instance, many publishers have
+a package that allows authors to format papers to that publisher&textrsquo;s
+specifications.
+</para>
+<para>In addition to the massive holdings, the web site offers features such
+as search by name or by functionality.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="51">DANTE e.V.</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="52">mirrors of CTAN</indexterm></cindex>
+<para>CTAN is not a single site, but instead is a set of sites. One of the
+sites is the core. This site actively manages the material, for
+instance, by accepting uploads of new or updated packages. It is
+hosted by the German &tex; group DANTE e.V. Other sites around the
+world help out by mirroring, that is, automatically syncing their
+collections with the core site and then in turn making their copies
+publicly available. This gives users close to their location better
+access and relieves the load on the core site. The list of mirrors is
+at <url><urefurl>https://ctan.org/mirrors</urefurl></url>.
+</para>
+
+</section>
</chapter>
<node name="Document-classes" spaces=" "><nodename>Document classes</nodename><nodenext automatic="on">Fonts</nodenext><nodeprev automatic="on">Overview</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Document classes</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="49">document classes</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="50">classes of documents</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="29">\documentclass</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="53">document classes</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="54">classes of documents</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="28" mergedindex="cp">\documentclass</indexterm></findex>
<para>The document&textrsquo;s overall class is defined with this command, which is
normally the first command in a &latex; source file.
@@ -712,34 +767,39 @@ normally the first command in a &latex; source file.
<pre xml:space="preserve">\documentclass[<var>options</var>]&lbrace;<var>class</var>&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="30">article <r>class</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="31">report <r>class</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="32">book <r>class</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="33">letter <r>class</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="34">slides <r>class</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="29" mergedindex="cp">article <r>class</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="30" mergedindex="cp">report <r>class</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="31" mergedindex="cp">book <r>class</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="32" mergedindex="cp">letter <r>class</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="33" mergedindex="cp">slides <r>class</r></indexterm></findex>
<para>The following document <var>class</var> names are built into &latex;.
(Many other document classes are available as separate packages;
<pxref label="Overview"><xrefnodename>Overview</xrefnodename></pxref>.)
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">article</itemformat></item>
-</tableterm><tableitem><para>For a journal article, a presentation, and miscellaneous general use.
+</tableterm><tableitem><anchor name="document-classes-article">document classes article</anchor>
+<para>For a journal article, a presentation, and miscellaneous general use.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">book</itemformat></item>
-</tableterm><tableitem><para>Full-length books, including chapters and possibly including front
+</tableterm><tableitem><anchor name="document-classes-book">document classes book</anchor>
+<para>Full-length books, including chapters and possibly including front
matter, such as a preface, and back matter, such as an appendix
(<pxref label="Front_002fback-matter"><xrefnodename>Front/back matter</xrefnodename></pxref>).
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">letter</itemformat></item>
-</tableterm><tableitem><para>Mail, optionally including mailing labels
+</tableterm><tableitem><anchor name="document-classes-letter">document classes letter</anchor>
+<para>Mail, optionally including mailing labels
(<pxref label="Letters"><xrefnodename>Letters</xrefnodename></pxref>).
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">report</itemformat></item>
-</tableterm><tableitem><para>For documents of length between an <code>article</code> and a <code>book</code>,
+</tableterm><tableitem><anchor name="document-classes-report">document classes report</anchor>
+<para>For documents of length between an <code>article</code> and a <code>book</code>,
such as technical reports or theses, which may contain several chapters.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">slides</itemformat></item>
-</tableterm><tableitem><para>For slide presentations&textmdash;rarely used today. In its place the
+</tableterm><tableitem><anchor name="document-classes-slides">document classes slides</anchor>
+<para>For slide presentations&textmdash;rarely used today. In its place the
<code>beamer</code> package is perhaps the most prevalent (<pxref label="beamer-template"><xrefnodename>beamer
template</xrefnodename></pxref>).
</para>
@@ -757,14 +817,14 @@ template</xrefnodename></pxref>).
<node name="Document-class-options" spaces=" "><nodename>Document class options</nodename><nodenext automatic="on">Additional packages</nodenext><nodeup automatic="on">Document classes</nodeup></node>
<section spaces=" "><sectiontitle>Document class options</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="51">document class options</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="52">options, document class</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="53">class options</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="54">global options</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="55">document class options</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="56">options, document class</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="57">class options</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="58">global options</indexterm></cindex>
-<para>You can specify so-called <dfn>global options</dfn> or <dfn>class options</dfn> to
-the <code>\documentclass</code> command by enclosing them in square brackets.
-To specify more than one <var>option</var>, separate them with a comma, as in:
+<para>You can specify <dfn>global options</dfn> or <dfn>class options</dfn> to the
+<code>\documentclass</code> command by enclosing them in square brackets. To
+specify more than one <var>option</var>, separate them with a comma.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\documentclass[<var>option1</var>,<var>option2</var>,...]&lbrace;<var>class</var>&rbrace;
@@ -772,9 +832,9 @@ To specify more than one <var>option</var>, separate them with a comma, as in:
<para>Here is the list of the standard class options.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="35">10pt <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="36">11pt <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="37">12pt <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="34" mergedindex="cp">10pt <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="35" mergedindex="cp">11pt <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="36" mergedindex="cp">12pt <r>option</r></indexterm></findex>
<para>All of the standard classes except <code>slides</code> accept the following
options for selecting the typeface size (default is <code>10pt</code>):
</para>
@@ -782,12 +842,12 @@ options for selecting the typeface size (default is <code>10pt</code>):
<pre xml:space="preserve">10pt 11pt 12pt
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="38">a4paper <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="39">a5paper <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="40">b5paper <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="41">executivepaper <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="42">legalpaper <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="43">letterpaper <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="37" mergedindex="cp">a4paper <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="38" mergedindex="cp">a5paper <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="39" mergedindex="cp">b5paper <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="40" mergedindex="cp">executivepaper <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="41" mergedindex="cp">legalpaper <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="42" mergedindex="cp">letterpaper <r>option</r></indexterm></findex>
<para>All of the standard classes accept these options for selecting the paper
size (these show height by width):
</para>
@@ -811,63 +871,63 @@ size (these show height by width):
</tableterm><tableitem><para>8.5 by 11&nbsp;inches (the default)
</para></tableitem></tableentry></table>
-<findex index="fn" spaces=" "><indexterm index="fn" number="44">\pdfpagewidth</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="45">\pdfpageheight</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="55"><r>package</r>, <code>geometry</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="56"><code>geometry</code> <r>package</r></indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="43" mergedindex="cp">\pdfpagewidth</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="44" mergedindex="cp">\pdfpageheight</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="59"><r>package</r>, <code>geometry</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="60"><code>geometry</code> <r>package</r></indexterm></cindex>
<para>When using one of the engines pdf&latex;, Lua&latex;, or Xe&latex;
(<pxref label="TeX-engines"><xrefnodename>&tex; engines</xrefnodename></pxref>), options other than <code>letterpaper</code> set
the print area but you must also set the physical paper size. One way
to do that is to put <code>\pdfpagewidth=\paperwidth</code> and
<code>\pdfpageheight=\paperheight</code> in your document&textrsquo;s preamble.
-<cindex index="cp" spaces=" "><indexterm index="cp" number="57"><r>package</r>, <code>geometry</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="58"><code>geometry</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="61"><r>package</r>, <code>geometry</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="62"><code>geometry</code> <r>package</r></indexterm></cindex>
</para>
<para>The <code>geometry</code> package provides flexible ways of setting the print
area and physical page size.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="46">draft <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="47">final <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="48">fleqn <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="49">landscape <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="50">leqno <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="51">openbib <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="52">titlepage <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="53">notitlepage <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="45" mergedindex="cp">draft <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="46" mergedindex="cp">final <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="47" mergedindex="cp">fleqn <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="48" mergedindex="cp">landscape <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="49" mergedindex="cp">leqno <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="50" mergedindex="cp">openbib <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="51" mergedindex="cp">titlepage <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="52" mergedindex="cp">notitlepage <r>option</r></indexterm></findex>
<para>Miscellaneous other options:
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">draft</itemformat></item>
<itemx spaces=" "><itemformat command="code">final</itemformat></itemx>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="59">black boxes, omitting</indexterm></cindex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="63">black boxes, omitting</indexterm></cindex>
<para>Mark (<code>draft</code>) or do not mark (<code>final</code>) overfull boxes with a
black box in the margin; default is <code>final</code>.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">fleqn</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="60">flush left equations</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="61">centered equations</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="62">equations, flush left vs.&noeos; centered</indexterm></cindex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="64">flush left equations</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="65">centered equations</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="66">equations, flush left vs.&noeos; centered</indexterm></cindex>
<para>Put displayed formulas flush left; default is centered.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">landscape</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="63">landscape orientation</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="64">portrait orientation</indexterm></cindex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="67">landscape orientation</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="68">portrait orientation</indexterm></cindex>
<para>Selects landscape format; default is portrait.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">leqno</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="65">left-hand equation numbers</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="66">right-hand equation numbers</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="67">equation numbers, left vs.&noeos; right</indexterm></cindex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="69">left-hand equation numbers</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="70">right-hand equation numbers</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="71">equation numbers, left vs.&noeos; right</indexterm></cindex>
<para>Put equation numbers on the left side of equations; default is the right side.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">openbib</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="68">bibliography format, open</indexterm></cindex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="72">bibliography format, open</indexterm></cindex>
<para>Use &textldquo;open&textrdquo; bibliography format.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">titlepage</itemformat></item>
<itemx spaces=" "><itemformat command="code">notitlepage</itemformat></itemx>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="69">title page, separate or run-in</indexterm></cindex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="73">title page, separate or run-in</indexterm></cindex>
<para>Specifies whether there is a separate page for the title information and
for the abstract also, if there is one. The default for the
<code>report</code> class is <code>titlepage</code>, for the other classes it is
@@ -876,12 +936,12 @@ for the abstract also, if there is one. The default for the
<para>The following options are not available with the <code>slides</code> class.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="54">onecolumn <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="55">twocolumn <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="56">oneside <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="57">twoside <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="58">openright <r>option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="59">openany <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="53" mergedindex="cp">onecolumn <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="54" mergedindex="cp">twocolumn <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="55" mergedindex="cp">oneside <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="56" mergedindex="cp">twoside <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="57" mergedindex="cp">openright <r>option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="58" mergedindex="cp">openany <r>option</r></indexterm></findex>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">onecolumn</itemformat></item>
<itemx spaces=" "><itemformat command="code">twocolumn</itemformat></itemx>
@@ -889,8 +949,8 @@ for the abstract also, if there is one. The default for the
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">oneside</itemformat></item>
<itemx spaces=" "><itemformat command="code">twoside</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="60">\evensidemargin</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="61">\oddsidemargin</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="59" mergedindex="cp">\evensidemargin</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="60" mergedindex="cp">\oddsidemargin</indexterm></findex>
<para>Selects one- or two-sided layout; default is <code>oneside</code>, except
that in the <code>book</code> class the default is <code>twoside</code>.
</para>
@@ -907,7 +967,7 @@ being 40% of the difference between <code>\paperwidth</code> and
<code>openright</code> for <code>book</code>, and <code>openany</code> for <code>report</code>.
</para></tableitem></tableentry></table>
-<findex index="fn" spaces=" "><indexterm index="fn" number="62">clock <r>option to <code>slides</code> class</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="61" mergedindex="cp">clock <r>option to <code>slides</code> class</r></indexterm></findex>
<para>The <code>slides</code> class offers the option <code>clock</code> for printing
the time at the bottom of each note.
</para>
@@ -916,10 +976,10 @@ the time at the bottom of each note.
<node name="Additional-packages" spaces=" "><nodename>Additional packages</nodename><nodenext automatic="on">Class and package construction</nodenext><nodeprev automatic="on">Document class options</nodeprev><nodeup automatic="on">Document classes</nodeup></node>
<section spaces=" "><sectiontitle>Additional packages</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="70">loading additional packages</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="71">packages, loading additional</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="72">additional packages, loading</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="63">\usepackage</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="74">loading additional packages</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="75">packages, loading additional</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="76">additional packages, loading</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="62" mergedindex="cp">\usepackage</indexterm></findex>
<para>Load a package <var>pkg</var>, with the package options given in the comma-separated
list <var>options</var>, as here.
</para>
@@ -931,8 +991,8 @@ list <var>options</var>, as here.
as in <code>\usepackage&lbrace;<var>pkg1</var>,<var>pkg2</var>,...&rbrace;</code>, or use multiple
<code>\usepackage</code> commands.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="73">global options</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="74">options, global</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="77">global options</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="78">options, global</indexterm></cindex>
<para>Any options given in the <code>\documentclass</code> command that are unknown
to the selected document class are passed on to the packages loaded with
<code>\usepackage</code>.
@@ -942,9 +1002,9 @@ to the selected document class are passed on to the packages loaded with
<node name="Class-and-package-construction" spaces=" "><nodename>Class and package construction</nodename><nodeprev automatic="on">Additional packages</nodeprev><nodeup automatic="on">Document classes</nodeup></node>
<section spaces=" "><sectiontitle>Class and package construction</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="75">document class commands</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="76">commands, document class</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="77">new class commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="79">document class commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="80">commands, document class</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="81">new class commands</indexterm></cindex>
<para>You can create new document classes and new packages. For instance, if
your memos must satisfy some local requirements, such as a
@@ -957,13 +1017,13 @@ package are useful across classes while those in a document class are
specific to that class. Thus, a command to set page headers is for a
package while a command to make the page headers say <code>Memo from the
SMC Math Department</code> is for a class.
-<cindex index="cp" spaces=" "><indexterm index="cp" number="78">class and package difference</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="79">difference between class and package</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="82">class and package difference</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="83">difference between class and package</indexterm></cindex>
</para>
<para>Inside of a class or package file you can use the at-sign <code>&arobase;</code> as a
character in command names without having to surround the code
containing that command with <code>\makeatletter</code> and
-<code>\makeatother</code>. <xref label="_005cmakeatletter-and-_005cmakeatother"><xrefnodename>\makeatletter and \makeatother</xrefnodename></xref>. This allow
+<code>\makeatother</code>. <xref label="_005cmakeatletter-_0026-_005cmakeatother"><xrefnodename>\makeatletter &amp; \makeatother</xrefnodename></xref>. This allow
you to create commands that users will not accidentally redefine.
Another technique is to preface class- or package-specific commands with
some string to prevent your class or package from interfering with
@@ -980,13 +1040,13 @@ others. For instance, the class <code>smcmemo</code> might have commands
<node name="Class-and-package-structure" spaces=" "><nodename>Class and package structure</nodename><nodenext automatic="on">Class and package commands</nodenext><nodeup automatic="on">Class and package construction</nodeup></node>
<subsection spaces=" "><sectiontitle>Class and package structure</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="80">class and package structure</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="81">class file layout</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="82">package file layout</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="83">options, document class</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="84">options, package</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="85">class options</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="86">package options</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="84">class and package structure</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="85">class file layout</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="86">package file layout</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="87">options, document class</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="88">options, package</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="89">class options</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="90">package options</indexterm></cindex>
<para>A class file or package file typically has four parts.
</para><enumerate first="1" endspaces=" ">
@@ -1015,7 +1075,6 @@ most of its work: declaring new variables, commands and fonts, and
loading other files.
</para></listitem></enumerate>
-
<para>Here is a starting class file, which should be saved as <file>stub.cls</file>
where &latex; can find it, for example in the same directory as the
<file>.tex</file> file.
@@ -1027,8 +1086,9 @@ where &latex; can find it, for example in the same directory as the
\ProcessOptions\relax
\LoadClass&lbrace;article&rbrace;
</pre></example>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="87">class file example</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="91">class file example</indexterm></cindex>
+<noindent></noindent>
<para>It identifies itself, handles the class options via the default of
passing them all to the <code>article</code> class, and then loads the
<code>article</code> class to provide the basis for this class&textrsquo;s code.
@@ -1039,24 +1099,25 @@ Class Guide, at
of the descriptions here derive from this document), or the tutorial
<url><urefurl>https://www.tug.org/TUGboat/tb26-3/tb84heff.pdf</urefurl></url>.
</para>
+
</subsection>
<node name="Class-and-package-commands" spaces=" "><nodename>Class and package commands</nodename><nodeprev automatic="on">Class and package structure</nodeprev><nodeup automatic="on">Class and package construction</nodeup></node>
<subsection spaces=" "><sectiontitle>Class and package commands</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="88">class and package commands</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="89">commands, class and package</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="92">class and package commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="93">commands, class and package</indexterm></cindex>
<para>These are the commands designed to help writers of classes or packages.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">\AtBeginDvi&lbrace;specials&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="64">\AtBeginDvi</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="63" mergedindex="cp">\AtBeginDvi</indexterm></findex>
<para>Save in a box register things that are written to the <file>.dvi</file> file
at the beginning of the shipout of the first page of the document.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\AtEndOfClass&lbrace;<var>code</var>&rbrace;</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\AtEndOfPackage&lbrace;<var>code</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="65">\AtEndOfClass</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="66">\AtEndOfPackage</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="64" mergedindex="cp">\AtEndOfClass</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="65" mergedindex="cp">\AtEndOfPackage</indexterm></findex>
<para>Hook to insert <var>code</var> to be executed when &latex; finishes
processing the current class or package. You can use these hooks
multiple times; the <code>code</code> will be executed in the order that you
@@ -1064,13 +1125,13 @@ called it. See also <ref label="_005cAtBeginDocument"><xrefnodename>\AtBeginDoc
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\CheckCommand&lbrace;<var>cmd</var>&rbrace;[<var>num</var>][<var>default</var>]&lbrace;<var>definition</var>&rbrace;</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\CheckCommand*&lbrace;<var>cmd</var>&rbrace;[<var>num</var>][<var>default</var>]&lbrace;<var>definition</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="67">\CheckCommand</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="68">\CheckCommand*</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="90">new command, check</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="66" mergedindex="cp">\CheckCommand</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="67" mergedindex="cp">\CheckCommand*</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="94">new command, check</indexterm></cindex>
<para>Like <code>\newcommand</code> (<pxref label="_005cnewcommand-_0026-_005crenewcommand"><xrefnodename>\newcommand &amp; \renewcommand</xrefnodename></pxref>) but does
not define <var>cmd</var>; instead it checks that the current definition of
<var>cmd</var> is exactly as given by <var>definition</var> and is or is not
-<cindex index="cp" spaces=" "><indexterm index="cp" number="91">long command</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="95">long command</indexterm></cindex>
<dfn>long</dfn> as expected. A long command is a command that accepts
<code>\par</code> within an argument. The <var>cmd</var> command is expected to be
long with the unstarred version of <code>\CheckCommand</code>. Raises an
@@ -1088,16 +1149,16 @@ redefined this command.
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\PackageInfo&lbrace;<var>package name</var>&rbrace;&lbrace;<var>info text</var>&rbrace;</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ClassInfoNoLine&lbrace;<var>class name</var>&rbrace;&lbrace;<var>info text</var>&rbrace;</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\PackageInfoNoLine&lbrace;<var>package name</var>&rbrace;&lbrace;<var>info text</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="69">\ClassError</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="70">\PackageError</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="71">\ClassWarning</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="72">\PackageWarning</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="73">\ClassWarningNoLine</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="74">\PackageWarningNoLine</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="75">\ClassInfo</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="76">\PackageInfo</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="77">\ClassInfoNoLine</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="78">\PackageInfoNoLine</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="68" mergedindex="cp">\ClassError</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="69" mergedindex="cp">\PackageError</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="70" mergedindex="cp">\ClassWarning</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="71" mergedindex="cp">\PackageWarning</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="72" mergedindex="cp">\ClassWarningNoLine</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="73" mergedindex="cp">\PackageWarningNoLine</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="74" mergedindex="cp">\ClassInfo</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="75" mergedindex="cp">\PackageInfo</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="76" mergedindex="cp">\ClassInfoNoLine</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="77" mergedindex="cp">\PackageInfoNoLine</indexterm></findex>
<para>Produce an error message, or warning or informational messages.
</para>
<para>For <code>\ClassError</code> and <code>\PackageError</code> the message is
@@ -1118,23 +1179,23 @@ character does not allow it, like after a command. Note that &latex;
appends a period to the messages.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\CurrentOption</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="79">\CurrentOption</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="78" mergedindex="cp">\CurrentOption</indexterm></findex>
<para>Expands to the name of the currently-being-processed option. Can only
be used within the <var>code</var> argument of either <code>\DeclareOption</code>
or <code>\DeclareOption*</code>.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\DeclareOption&lbrace;<var>option</var>&rbrace;&lbrace;<var>code</var>&rbrace;</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\DeclareOption*&lbrace;<var>code</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="80">\DeclareOption</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="81">\DeclareOption*</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="92">class options</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="93">package options</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="94">options, class</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="95">options, package</indexterm></cindex>
-<para>Make an option available to a user, for invoking in their
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="79" mergedindex="cp">\DeclareOption</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="80" mergedindex="cp">\DeclareOption*</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="96">class options</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="97">package options</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="98">options, class</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="99">options, package</indexterm></cindex>
+<para>Make an option available to a user to invoke in their
<code>\documentclass</code> command. For example, the <code>smcmemo</code> class
-could have an option allowing users to put the institutional logo on the
-first page with <code>\documentclass[logo]&lbrace;smcmemo&rbrace;</code>. The class file
+could have an option <code>\documentclass[logo]&lbrace;smcmemo&rbrace;</code> allowing
+users to put the institutional logo on the first page. The class file
must contain <code>\DeclareOption&lbrace;logo&rbrace;&lbrace;<var>code</var>&rbrace;</code> (and later,
<code>\ProcessOptions</code>).
</para>
@@ -1165,9 +1226,9 @@ passes the option to the <code>article</code> class.
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\DeclareRobustCommand&lbrace;<var>cmd</var>&rbrace;[<var>num</var>][<var>default</var>]&lbrace;<var>definition</var>&rbrace; </itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\DeclareRobustCommand*&lbrace;<var>cmd</var>&rbrace;[<var>num</var>][<var>default</var>]&lbrace;<var>definition</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="82">\DeclareRobustCommand</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="83">\DeclareRobustCommand*</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="96">new command, definition</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="81" mergedindex="cp">\DeclareRobustCommand</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="82" mergedindex="cp">\DeclareRobustCommand*</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="100">new command, definition</indexterm></cindex>
<para>Like <code>\newcommand</code> and <code>\newcommand*</code> (<pxref label="_005cnewcommand-_0026-_005crenewcommand"><xrefnodename>\newcommand &amp;
\renewcommand</xrefnodename></pxref>) but these declare a robust command, even if some code
within the <var>definition</var> is fragile. (For a discussion of robust and
@@ -1181,16 +1242,16 @@ transcript file if a command is redefined.
using <code>\newcommand</code> so unless the command&textrsquo;s data is fragile and the
command is used within a moving argument, use <code>\newcommand</code>.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="97"><r>package</r>, <code>etoolbox</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="98"><code>etoolbox</code> <r>package</r></indexterm></cindex>
-
-<para>The <code>etoolbox</code> package offers commands <code>\newrobustcmd</code>,
-<code>\newrobustcmd*</code>, <code>\renewrobustcmd</code>, <code>\renewrobustcmd*</code>,
-<code>\providerobustcmd</code>, and <code>\providerobustcmd*</code> which are similar
-to <code>\newcommand</code>, <code>\newcommand*</code>, <code>\renewcommand</code>,
-<code>\renewcommand*</code>, <code>\providecommand</code>, and
-<code>\providecommand*</code>, but define a robust <var>cmd</var> with two advantages
-as compared to <code>\DeclareRobustCommand</code>:
+<cindex index="cp" spaces=" "><indexterm index="cp" number="101"><r>package</r>, <code>etoolbox</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="102"><code>etoolbox</code> <r>package</r></indexterm></cindex>
+ <para>The <file>etoolbox</file> package offers the commands
+<code>\newrobustcmd</code>, <code>\newrobustcmd*</code>, as well as the commands
+<code>\renewrobustcmd</code>, <code>\renewrobustcmd*</code>, and the commands
+<code>\providerobustcmd</code>, and <code>\providerobustcmd*</code>. These are
+similar to <code>\newcommand</code>, <code>\newcommand*</code>,
+<code>\renewcommand</code>, <code>\renewcommand*</code>, <code>\providecommand</code>, and
+<code>\providecommand*</code>, but define a robust <var>cmd</var> with two
+advantages as compared to <code>\DeclareRobustCommand</code>:
</para><enumerate first="1" endspaces=" ">
<listitem>
<para>They use the low-level e-&tex; protection mechanism rather than the
@@ -1207,14 +1268,20 @@ commands, so they do not just make a log message when you redefine
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\IfFileExists&lbrace;<var>file name</var>&rbrace;&lbrace;<var>true code</var>&rbrace;&lbrace;<var>false code</var>&rbrace;</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\InputIfFileExists&lbrace;<var>file name</var>&rbrace;&lbrace;<var>true code</var>&rbrace;&lbrace;<var>false code</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="84">\IfFileExists</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="85">\InputIfFileExists</indexterm></findex>
-<para>Execute <var>true code</var> if &latex; can find the file <file><var>file
-name</var></file> and <var>false code</var> otherwise. In the second case it inputs the
-file immediately after executing <var>true code</var>. Thus
-<code>\IfFileExists&lbrace;img.pdf&rbrace;&lbrace;\includegraphics&lbrace;img.pdf&rbrace;&rbrace;&lbrace;\typeout&lbrace;WARNING:
-img.pdf not found&rbrace;&rbrace;</code> will include the graphic <file>img.pdf</file> if it is
-found but otherwise just give a warning.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="83" mergedindex="cp">\IfFileExists</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="84" mergedindex="cp">\InputIfFileExists</indexterm></findex>
+<para>Execute <var>true code</var> if &latex; finds the file <file><var>file
+name</var></file> or <var>false code</var> otherwise. In the first case it executing
+<var>true code</var> and then inputs the file. Thus the command
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\IfFileExists&lbrace;img.pdf&rbrace;&lbrace;%
+ \includegraphics&lbrace;img.pdf&rbrace;&rbrace;&lbrace;\typeout&lbrace;!! img.pdf not found&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>will include the graphic <file>img.pdf</file> if it is found and otherwise
+give a warning.
</para>
<para>This command looks for the file in all search paths that &latex; uses,
not only in the current directory. To look only in the current
@@ -1226,8 +1293,8 @@ extensions see <ref label="_005cinput"><xrefnodename>\input</xrefnodename></ref>
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\LoadClass[<var>options list</var>]&lbrace;<var>class name</var>&rbrace;[<var>release date</var>]</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\LoadClassWithOptions&lbrace;<var>class name</var>&rbrace;[<var>release date</var>]</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="86">\LoadClass</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="87">\LoadClassWithOptions</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="85" mergedindex="cp">\LoadClass</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="86" mergedindex="cp">\LoadClassWithOptions</indexterm></findex>
<para>Load a class, as with <code>\documentclass[<var>options
list</var>]&lbrace;<var>class name</var>&rbrace;[<var>release info</var>]</code>. An example is
<code>\LoadClass[twoside]&lbrace;article&rbrace;</code>.
@@ -1239,12 +1306,16 @@ list</var>]&lbrace;<var>class name</var>&rbrace;[<var>release info</var>]</code>
<!-- c and do some actions conditionnally on version later or not to some -->
<!-- c date. -->
</para>
-<para>If you request a <var>release date</var> and the date of
-the package installed on your system is earlier, then you get a warning
-on the screen and in the log like <code>You have requested, on input
-line 4, version `2038/01/19' of document class article, but only version
-`2014/09/29 v1.4h Standard LaTeX document class' is available.</code>
+<para>If you request a <var>release date</var> and the date of the package
+installed on your system is earlier, then you get a warning on the
+screen and in the log like this.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">You have requested, on input line 4, version `2038/01/19' of
+document class article, but only version `2014/09/29 v1.4h
+Standard LaTeX document class' is available.
+</pre></example>
+
<para>The command version <code>\LoadClassWithOptions</code> uses the list of
options for the current class. This means it ignores any options passed
to it via <code>\PassOptionsToClass</code>. This is a convenience command
@@ -1252,7 +1323,7 @@ that lets you build classes on existing ones, such as the standard
<code>article</code> class, without having to track which options were passed.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ExecuteOptions&lbrace;<var>options-list</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="88">\ExecuteOptions</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="87" mergedindex="cp">\ExecuteOptions</indexterm></findex>
<para>For each option <var>option</var> in the <var>options-list</var>, in order, this command
executes the command <code>\ds&arobase;<var>option</var></code>. If this command is not
defined then that option is silently ignored.
@@ -1263,7 +1334,7 @@ default to be 11pt fonts then you could specify
<code>\ExecuteOptions&lbrace;11pt&rbrace;\ProcessOptions\relax</code>.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\NeedsTeXFormat&lbrace;<var>format</var>&rbrace;[<var>format date</var>]</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="89">\NeedsTeXFormat</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="88" mergedindex="cp">\NeedsTeXFormat</indexterm></findex>
<para>Specifies the format that this class must be run under. Often issued
as the first line of a class file, and most often used as:
<code>\NeedsTeXFormat&lbrace;LaTeX2e&rbrace;</code>. When a document using that class is
@@ -1276,12 +1347,15 @@ like <samp>This file needs format `LaTeX2e' but this is `xxx'.</samp>
features, include the optional <var>format date</var> on which those features
were implemented. If present it must be in the form <code>YYYY/MM/DD</code>.
If the format version installed on your system is earlier than
-<var>format date</var> then you get a warning like <samp>You have requested
-release `2038/01/20' of LaTeX, but only release `2016/02/01' is
-available.</samp>
+<var>format date</var> then you get a warning like this.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">You have requested release `2038/01/20' of LaTeX, but only
+release `2016/02/01' is available.
+</pre></example>
+
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\OptionNotUsed</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="90">\OptionNotUsed</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="89" mergedindex="cp">\OptionNotUsed</indexterm></findex>
<para>Adds the current option to the list of unused options. Can only be used
within the <var>code</var> argument of either <code>\DeclareOption</code> or
<code>\DeclareOption*</code>.
@@ -1294,8 +1368,8 @@ within the <var>code</var> argument of either <code>\DeclareOption</code> or
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\PassOptionsToClass&lbrace;<var>option list</var>&rbrace;&lbrace;<var>class name</var>&rbrace;</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\PassOptionsToPackage&lbrace;<var>option list</var>&rbrace;&lbrace;<var>package name</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="91">\PassOptionsToClass</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="92">\PassOptionsToPackage</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="90" mergedindex="cp">\PassOptionsToClass</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="91" mergedindex="cp">\PassOptionsToPackage</indexterm></findex>
<para>Adds the options in the comma-separated list <var>option list</var> to the
options used by any future <code>\RequirePackage</code> or <code>\usepackage</code>
command for package <var>package name</var> or the class <var>class name</var>.
@@ -1309,17 +1383,23 @@ options.)
</para>
<para>If your own code is bringing in a package twice then you can collapse
that to once, for example replacing the two
-<code>\RequirePackage[landscape]&lbrace;geometry&rbrace;\RequirePackage[margins=1in]&lbrace;geometry&rbrace;</code>
-with the single
-<code>\RequirePackage[landscape,margins=1in]&lbrace;geometry&rbrace;</code>. But if you
-are loading a package that in turn loads another package then you need
-to queue up the options you desire for this other package. For
-instance, suppose the package <code>foo</code> loads the package
-<code>geometry</code>. Instead of
-<code>\RequirePackage&lbrace;foo&rbrace;\RequirePackage[draft]&lbrace;graphics&rbrace;</code> you must
-write <code>\PassOptionsToPackage&lbrace;draft&rbrace;&lbrace;graphics&rbrace;
-\RequirePackage&lbrace;foo&rbrace;</code>. (If <code>foo.sty</code> loads an option in conflict
-with what you want then you may have to look into altering its source.)
+<code>\RequirePackage[landscape]&lbrace;geometry&rbrace;</code> and
+<code>\RequirePackage[margins=1in]&lbrace;geometry&rbrace;</code> with the single command
+<code>\RequirePackage[landscape,margins=1in]&lbrace;geometry&rbrace;</code>.
+</para>
+<para>However, imagine that you are loading <file>firstpkg</file> and inside that
+package it loads <file>secondpkg</file>, and you need the second package to be
+loaded with option <code>draft</code>. Then before doing the first package
+you must queue up the options for the second package, like this.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\PassOptionsToPackage&lbrace;draft&rbrace;&lbrace;secondpkg&rbrace;
+\RequirePackage&lbrace;firstpkg&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>(If <code>firstpkg.sty</code> loads an option in conflict with what you want
+then you may have to alter its source.)
</para>
<para>These commands are useful for general users as well as class and package
writers. For instance, suppose a user wants to load the <code>graphicx</code>
@@ -1330,8 +1410,8 @@ option. The user could start their &latex; file with
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ProcessOptions</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ProcessOptions*<var>\&arobase;options</var></itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="93">\ProcessOptions</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="94">\ProcessOptions*</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="92" mergedindex="cp">\ProcessOptions</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="93" mergedindex="cp">\ProcessOptions*</indexterm></findex>
<para>Execute the code for each option that the user has invoked. Include it
in the class file as <code>\ProcessOptions\relax</code> (because of the
existence of the starred command).
@@ -1371,44 +1451,45 @@ options in the order specified in the calling commands, rather than in
the order of declaration in the class or package. For a package this
means that the global options are processed first.
</para>
-
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ProvidesClass&lbrace;<var>class name</var>&rbrace;[<var>release date</var> <var>brief additional information</var>]</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ProvidesClass&lbrace;<var>class name</var>&rbrace;[<var>release date</var>]</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ProvidesPackage&lbrace;<var>package name</var>&rbrace;[<var>release date</var> <var>brief additional information</var>]</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ProvidesPackage&lbrace;<var>package name</var>&rbrace;[<var>release date</var>]</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="95">\ProvidesClass</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="96">\ProvidesPackage</indexterm></findex>
-<para>Identifies the class or package, printing a message to the screen and the log file.
-</para>
-<para>When a user writes <code>\documentclass&lbrace;smcmemo&rbrace;</code> then &latex; loads
-the file <file>smcmemo.cls</file>. Similarly, a user writing
-<code>\usepackage&lbrace;test&rbrace;</code> prompts &latex; to load the file
-<code>test.sty</code>. If the name of the file does not match the declared
-class or package name then you get a warning. Thus, if you invoke
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="94" mergedindex="cp">\ProvidesClass</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="95" mergedindex="cp">\ProvidesPackage</indexterm></findex>
+<para>Identifies the class or package, printing a message to the screen and
+the log file.
+</para>
+<para>When you load a class or package, for example with
+<code>\documentclass&lbrace;smcmemo&rbrace;</code> or <code>\usepackage&lbrace;test&rbrace;</code>, &latex;
+inputs a file. If the name of the file does not match the class or
+package name declared in it then you get a warning. Thus, if you invoke
<code>\documentclass&lbrace;smcmemo&rbrace;</code>, and the file <file>smcmemo.cls</file> has
the statement <code>\ProvidesClass&lbrace;xxx&rbrace;</code> then you get a warning like
<code>You have requested document class `smcmemo', but the document
class provides 'xxx'.</code> This warning does not prevent &latex; from
processing the rest of the class file normally.
</para>
-<para>If you include the optional argument, then you must include the date, before
-the first space if any, and it must have the form <code>YYYY/MM/DD</code>. The rest
-of the optional argument is free-form, although it traditionally identifies
-the class, and is written to the screen during compilation and to the
-log file. Thus, if your file <file>smcmemo.cls</file> contains the line
-<code>\ProvidesClass&lbrace;smcmemo&rbrace;[2008/06/01 v1.0 SMC memo class]</code> and your
-document&textrsquo;s first line is <code>\documentclass&lbrace;smcmemo&rbrace;</code> then you will
-see <code>Document Class: smcmemo 2008/06/01 v1.0 SMC memo class</code>.
+<para>If you include the optional argument then you must include a date,
+before any spaces, of the form <code>YYYY/MM/DD</code>. The rest of the
+optional argument is free-form, although it traditionally identifies the
+class, and is written to the screen during compilation and to the log
+file. Thus, if your file <file>smcmemo.cls</file> contains the line
+<code>\ProvidesClass&lbrace;smcmemo&rbrace;[2008/06/01 v1.0 SMC memo class]</code> and
+your document&textrsquo;s first line is <code>\documentclass&lbrace;smcmemo&rbrace;</code> then you
+will see <code>Document Class: smcmemo 2008/06/01 v1.0 SMC memo class</code>.
</para>
<para>The date in the optional argument allows class and package users to ask
-to be warned if the version of the class or package installed on their
-system is earlier than <var>release date</var>, by using the optional arguments
-such as <code>\documentclass&lbrace;smcmemo&rbrace;[2018/10/12]</code> or
-<code>\usepackage&lbrace;foo&rbrace;[[2017/07/07]]</code>. (Note that package users only
-rarely include a date, and class users almost never do.)
+to be warned if the version of the class or package is earlier than
+<var>release date</var>. For instance, a user could enter
+<code>\documentclass&lbrace;smcmemo&rbrace;[2018/10/12]</code> or
+<code>\usepackage&lbrace;foo&rbrace;[[2017/07/07]]</code> to require a class or package
+with certain features by specifying that it must be released no earlier
+than the given date. (Although, in practice package users only rarely
+include a date, and class users almost never do.)
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ProvidesFile&lbrace;<var>file name</var>&rbrace;[<var>additional information</var>]</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="97">\ProvidesFile</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="96" mergedindex="cp">\ProvidesFile</indexterm></findex>
<para>Declare a file other than the main class and package files, such as
configuration files or font definition files. Put this command in that
file and you get in the log a string like <code>File: test.config
@@ -1418,13 +1499,13 @@ file and you get in the log a string like <code>File: test.config
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\RequirePackage[<var>option list</var>]&lbrace;<var>package name</var>&rbrace;[<var>release date</var>]</itemformat></item>
</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\RequirePackageWithOptions&lbrace;<var>package name</var>&rbrace;[<var>release date</var>]</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="98">\RequirePackage</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="99">\RequirePackageWithOptions</indexterm></findex>
-<para>Load a package, like the document author command <code>\usepackage</code>.
-<xref label="Additional-packages"><xrefnodename>Additional packages</xrefnodename></xref>. An example is
-<code>\RequirePackage[landscape,margin=1in]&lbrace;geometry&rbrace;</code>. Note that the
-&latex; development team strongly recommends use of these commands over
-Plain&nbsp;&tex;&textrsquo;s <code>\input</code>; see the Class Guide.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="97" mergedindex="cp">\RequirePackage</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="98" mergedindex="cp">\RequirePackageWithOptions</indexterm></findex>
+<para>Load a package, like the command <code>\usepackage</code> (<pxref label="Additional-packages"><xrefnodename>Additional
+packages</xrefnodename></pxref>). The &latex; development team strongly recommends use of
+these commands over Plain&nbsp;&tex;&textrsquo;s <code>\input</code>; see the Class
+Guide. An example is
+<code>\RequirePackage[landscape,margin=1in]&lbrace;geometry&rbrace;</code>.
</para>
<para>The <var>option list</var>, if present, is a comma-separated list. The
<var>release date</var>, if present, must have the form <var>YYYY/MM/DD</var>. If
@@ -1455,8 +1536,8 @@ causes &latex; to give error like <code>\usepackage before
<chapter spaces=" "><sectiontitle>Fonts</sectiontitle>
<anchor name="Typefaces">Typefaces</anchor><!-- c old name -->
-<cindex index="cp" spaces=" "><indexterm index="cp" number="99">typefaces</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="100">fonts</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="103">typefaces</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="104">fonts</indexterm></cindex>
<para>Two important aspects of selecting a <dfn>font</dfn> are specifying a size
and a style. The &latex; commands for doing this are described here.
@@ -1471,92 +1552,90 @@ and a style. The &latex; commands for doing this are described here.
<node name="Font-styles" spaces=" "><nodename>Font styles</nodename><nodenext automatic="on">Font sizes</nodenext><nodeup automatic="on">Fonts</nodeup></node>
<section spaces=" "><sectiontitle>Font styles</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="101">font styles</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="102">type styles</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="103">styles of text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="105">font styles</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="106">type styles</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="107">styles of text</indexterm></cindex>
<para>The following type style commands are supported by &latex;.
</para>
-<para>This first group of commands is typically used with an argument, as in
-<code>\textit&lbrace;<var>text</var>&rbrace;</code>. In the table below, the corresponding
-command in parenthesis is the &textldquo;declaration form&textrdquo;, which takes no
-arguments, as in <code>&lbrace;\itshape <var>text</var>&rbrace;</code>. The scope of the
-declaration form lasts until the next type style command or the end of
-the current group.
-</para>
-<para>These commands, in both the argument form and the declaration form,
-are cumulative; e.g., you can say either <code>\sffamily\bfseries</code> or
-<code>\bfseries\sffamily</code> to get bold sans serif.
-</para>
-<para>You can alternatively use an environment form of the declarations; for
-instance, <code>\begin&lbrace;ttfamily&rbrace;...\end&lbrace;ttfamily&rbrace;</code>.
-</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="100">\nocorrlist</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="101">\nocorr</indexterm></findex>
-<para>These font-switching commands automatically insert italic corrections
-if needed. (<xref label="_005c_002f"><xrefnodename>\/</xrefnodename></xref>, for the details of italic corrections.)
-Specifically, they insert the italic correction unless the following
-character is in the list <code>\nocorrlist</code>, which by default consists
-of a period and a comma. To suppress the automatic insertion of
-italic correction, use <code>\nocorr</code> at the start or end of the
-command argument, such as <code>\textit&lbrace;\nocorr text&rbrace;</code> or
-<code>\textsc&lbrace;text \nocorr&rbrace;</code>.
+<para>In the table below the listed commands, the <code>\text...</code> commands,
+is used with an argument, as in <code>\textit&lbrace;<var>text</var>&rbrace;</code>. This is
+the preferred form. But shown after it, in parenthesis, is the
+corresponding declaration form, which is sometimes useful. This form
+takes no arguments, as in <code>&lbrace;\itshape <var>text</var>&rbrace;</code>. The scope of
+the declaration form lasts until the next type style command or the end
+of the current group. In addition, each has an environment form such as
+<code>\begin&lbrace;itshape&rbrace;...\end&lbrace;itshape&rbrace;</code>.
+</para>
+<para>These commands, in both the argument form and the declaration form, are
+cumulative; for instance you can get bold sans serif by saying either of
+<code>\sffamily\bfseries</code> or <code>\bfseries\sffamily</code>.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="99" mergedindex="cp">\nocorrlist</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="100" mergedindex="cp">\nocorr</indexterm></findex>
+<para>One advantage of these commands is that they automatically insert italic
+corrections if needed (<pxref label="_005c_002f"><xrefnodename>\/</xrefnodename></pxref>). Specifically, they insert the
+italic correction unless the following character is in the list
+<code>\nocorrlist</code>, which by default consists of a period and a comma.
+To suppress the automatic insertion of italic correction, use
+<code>\nocorr</code> at the start or end of the command argument, such as
+<code>\textit&lbrace;\nocorr text&rbrace;</code> or <code>\textsc&lbrace;text \nocorr&rbrace;</code>.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">\textrm (\rmfamily)</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="102">\textrm</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="103">\rmfamily</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="101" mergedindex="cp">\textrm</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="102" mergedindex="cp">\rmfamily</indexterm></findex>
<para>Roman.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\textit (\itshape)</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="104">\textit</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="105">\itshape</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="103" mergedindex="cp">\textit</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="104" mergedindex="cp">\itshape</indexterm></findex>
<para>Italics.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\textmd (\mdseries)</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="106">\textmd</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="107">\mdseries</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="105" mergedindex="cp">\textmd</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="106" mergedindex="cp">\mdseries</indexterm></findex>
<para>Medium weight (default).
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\textbf (\bfseries)</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="108">\textbf</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="109">\bfseries</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="107" mergedindex="cp">\textbf</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="108" mergedindex="cp">\bfseries</indexterm></findex>
<para>Boldface.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\textup (\upshape)</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="110">\textup</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="111">\upshape</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="109" mergedindex="cp">\textup</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="110" mergedindex="cp">\upshape</indexterm></findex>
<para>Upright (default).
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\textsl (\slshape)</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="112">\textsl</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="113">\slshape</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="111" mergedindex="cp">\textsl</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="112" mergedindex="cp">\slshape</indexterm></findex>
<para>Slanted.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\textsf (\sffamily)</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="114">\textsf</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="115">\sffamily</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="113" mergedindex="cp">\textsf</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="114" mergedindex="cp">\sffamily</indexterm></findex>
<para>Sans serif.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\textsc (\scshape)</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="116">\textsc</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="117">\scshape</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="115" mergedindex="cp">\textsc</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="116" mergedindex="cp">\scshape</indexterm></findex>
<para>Small caps.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\texttt (\ttfamily)</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="118">\texttt</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="119">\ttfamily</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="117" mergedindex="cp">\texttt</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="118" mergedindex="cp">\ttfamily</indexterm></findex>
<para>Typewriter.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\textnormal (\normalfont)</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="120">\textnormal</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="121">\normalfont</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="119" mergedindex="cp">\textnormal</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="120" mergedindex="cp">\normalfont</indexterm></findex>
<para>Main document font.
</para>
</tableitem></tableentry></table>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="104">emphasis</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="122">\emph</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="108">emphasis</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="121" mergedindex="cp">\emph</indexterm></findex>
<para>Although it also changes fonts, the <code>\emph&lbrace;<var>text</var>&rbrace;</code> command
is semantic, for text to be emphasized, and should not be used as a
substitute for <code>\textit</code>. For example, <code>\emph&lbrace;<var>start
@@ -1565,59 +1644,56 @@ text</var> \emph&lbrace;<var>middle text</var>&rbrace; <var>end text</var>&rbrac
will be in roman.
</para>
<para>&latex; also provides the following commands, which unconditionally
-switch to the given style, that is, are <emph>not</emph> cumulative. Also,
-they are used differently than the above commands:
-<code>&lbrace;\<var>cmd</var>...&rbrace;</code> instead of <code>\<var>cmd</var>&lbrace;...&rbrace;</code>. These
-are two unrelated constructs.
+switch to the given style, that is, are <emph>not</emph> cumulative. They are
+used as declarations: <code>&lbrace;\<var>cmd</var>...&rbrace;</code> instead of
+<code>\<var>cmd</var>&lbrace;...&rbrace;</code>.
+</para>
+<para>(The unconditional commands below are an older version of font
+switching. The earlier commands are an improvement in most
+circumstances. But sometimes an unconditional font switch is precisely
+what you want.)
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="123">\bf</indexterm>\bf</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="105">bold font</indexterm></cindex>
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="122" mergedindex="cp">\bf</indexterm>\bf</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="109">bold font</indexterm></cindex>
<para>Switch to bold face.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="124">\cal</indexterm>\cal</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="106">script letters for math</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="107">calligraphic letters for math</indexterm></cindex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="123" mergedindex="cp">\cal</indexterm>\cal</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="110">script letters for math</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="111">calligraphic letters for math</indexterm></cindex>
<para>Switch to calligraphic letters for math.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="125">\it</indexterm>\it</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="108">italic font</indexterm></cindex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="124" mergedindex="cp">\it</indexterm>\it</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="112">italic font</indexterm></cindex>
<para>Italics.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="126">\rm</indexterm>\rm</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="109">roman font</indexterm></cindex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="125" mergedindex="cp">\rm</indexterm>\rm</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="113">roman font</indexterm></cindex>
<para>Roman.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="127">\sc</indexterm>\sc</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="110">small caps font</indexterm></cindex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="126" mergedindex="cp">\sc</indexterm>\sc</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="114">small caps font</indexterm></cindex>
<para>Small caps.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="128">\sf</indexterm>\sf</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="111">sans serif font</indexterm></cindex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="127" mergedindex="cp">\sf</indexterm>\sf</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="115">sans serif font</indexterm></cindex>
<para>Sans serif.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="129">\sl</indexterm>\sl</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="112">slanted font</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="113">oblique font</indexterm></cindex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="128" mergedindex="cp">\sl</indexterm>\sl</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="116">slanted font</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="117">oblique font</indexterm></cindex>
<para>Slanted (oblique).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="130">\tt</indexterm>\tt</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="114">typewriter font</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="115">monospace font</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="116">fixed-width font</indexterm></cindex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="129" mergedindex="cp">\tt</indexterm>\tt</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="118">typewriter font</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="119">monospace font</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="120">fixed-width font</indexterm></cindex>
<para>Typewriter (monospace, fixed-width).
</para>
</tableitem></tableentry></ftable>
<para>The <code>\em</code> command is the unconditional version of <code>\emph</code>.
</para>
-<para>(Some people consider the unconditional font-switching commands, such
-as <code>\tt</code>, obsolete and that only the cumulative commands
-(<code>\texttt</code>) should be used. Others think that both sets of
-commands have their place and sometimes an unconditional font switch
-is precisely what you want; for one example,
-<pxref label="description"><xrefnodename>description</xrefnodename><xrefprinteddesc><code>description</code></xrefprinteddesc></pxref>.)
-</para>
<para>The following commands are for use in math mode. They are not
cumulative, so <code>\mathbf&lbrace;\mathit&lbrace;<var>symbol</var>&rbrace;&rbrace;</code> does not
create a boldface and italic <var>symbol</var>; instead, it will just be in
@@ -1626,19 +1702,19 @@ typographic treatment, regardless of the surrounding environment.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">\mathrm</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="131">\mathrm</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="130" mergedindex="cp">\mathrm</indexterm></findex>
<para>Roman, for use in math mode.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\mathbf</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="132">\mathbf</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="131" mergedindex="cp">\mathbf</indexterm></findex>
<para>Boldface, for use in math mode.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\mathsf</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="133">\mathsf</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="132" mergedindex="cp">\mathsf</indexterm></findex>
<para>Sans serif, for use in math mode.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\mathtt</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="134">\mathtt</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="133" mergedindex="cp">\mathtt</indexterm></findex>
<para>Typewriter, for use in math mode.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\mathit</itemformat></item>
@@ -1646,28 +1722,28 @@ typographic treatment, regardless of the surrounding environment.
</tableterm><tableitem><para>Italics, for use in math mode.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\mathnormal</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="135">\mathnormal</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="134" mergedindex="cp">\mathnormal</indexterm></findex>
<para>For use in math mode, e.g., inside another type style declaration.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\mathcal</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="136">\mathcal</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="135" mergedindex="cp">\mathcal</indexterm></findex>
<para>Calligraphic letters, for use in math mode.
</para>
</tableitem></tableentry></table>
-<findex index="fn" spaces=" "><indexterm index="fn" number="137">\mathversion</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="117">math, bold</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="118">bold math</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="136" mergedindex="cp">\mathversion</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="121">math, bold</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="122">bold math</indexterm></cindex>
<para>In addition, the command <code>\mathversion&lbrace;bold&rbrace;</code> can be used for
switching to bold letters and symbols in
formulas. <code>\mathversion&lbrace;normal&rbrace;</code> restores the default.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="138">\oldstylenums</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="119">numerals, old-style</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="120">old-style numerals</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="121">lining numerals</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="122"><r>package</r>, <code>textcomp</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="123"><code>textcomp</code> <r>package</r></indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="137" mergedindex="cp">\oldstylenums</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="123">numerals, old-style</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="124">old-style numerals</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="125">lining numerals</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="126"><r>package</r>, <code>textcomp</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="127"><code>textcomp</code> <r>package</r></indexterm></cindex>
<para>Finally, the command <code>\oldstylenums&lbrace;<var>numerals</var>&rbrace;</code> will typeset
so-called &textldquo;old-style&textrdquo; numerals, which have differing heights and
@@ -1685,9 +1761,9 @@ are provided to make them the default. FAQ entry:
<node name="Font-sizes" spaces=" "><nodename>Font sizes</nodename><nodenext automatic="on">Low-level font commands</nodenext><nodeprev automatic="on">Font styles</nodeprev><nodeup automatic="on">Fonts</nodeup></node>
<section spaces=" "><sectiontitle>Font sizes</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="124">font sizes</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="125">typeface sizes</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="126">sizes of text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="128">font sizes</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="129">typeface sizes</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="130">sizes of text</indexterm></cindex>
<para>The following standard type size commands are supported by &latex;.
The table shows the command name and the corresponding actual font
@@ -1695,18 +1771,18 @@ size used (in points) with the <samp>10pt</samp>, <samp>11pt</samp>, and
<samp>12pt</samp> document size options, respectively (<pxref label="Document-class-options"><xrefnodename>Document class
options</xrefnodename></pxref>).
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="139">\tiny</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="140">\scriptsize</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="141">\footnotesize</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="142">\small</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="143">\normalsize</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="144">\large</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="145">\Large</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="146">\LARGE</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="147">\huge</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="148">\Huge</indexterm></findex>
-
-<multitable spaces=" " endspaces=" "><columnprototypes><columnprototype bracketed="on"><code>\normalsize</code> (default)</columnprototype> <columnprototype bracketed="on">24.88</columnprototype> <columnprototype bracketed="on">24.88</columnprototype> <columnprototype bracketed="on">24.88</columnprototype></columnprototypes>
+<findex index="fn" spaces=" "><indexterm index="fn" number="138" mergedindex="cp">\tiny</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="139" mergedindex="cp">\scriptsize</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="140" mergedindex="cp">\footnotesize</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="141" mergedindex="cp">\small</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="142" mergedindex="cp">\normalsize</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="143" mergedindex="cp">\large</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="144" mergedindex="cp">\Large</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="145" mergedindex="cp">\LARGE</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="146" mergedindex="cp">\huge</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="147" mergedindex="cp">\Huge</indexterm></findex>
+
+<multitable spaces=" " endspaces=" "><columnprototypes><columnprototype bracketed="on"><code>\normalsize</code> (default)<spacecmd type="spc"/><spacecmd type="spc"/></columnprototype> <columnprototype bracketed="on">24.88<spacecmd type="spc"/><spacecmd type="spc"/></columnprototype> <columnprototype bracketed="on">24.88<spacecmd type="spc"/><spacecmd type="spc"/></columnprototype> <columnprototype bracketed="on">24.88</columnprototype></columnprototypes>
<thead><row><entry command="headitem" spaces=" "><para>Command </para></entry><entry command="tab" spaces=" "><para><code>10pt</code> </para></entry><entry command="tab" spaces=" "><para><code>11pt</code> </para></entry><entry command="tab" spaces=" "><para><code>12pt</code>
</para></entry></row></thead><tbody><row><entry command="item" spaces=" "><para><code>\tiny</code>
</para></entry><entry command="tab" spaces=" "><para>5 </para></entry><entry command="tab" spaces=" "><para>6 </para></entry><entry command="tab" spaces=" "><para>6
@@ -1730,18 +1806,30 @@ options</xrefnodename></pxref>).
</para></entry><entry command="tab" spaces=" "><para>24.88 </para></entry><entry command="tab" spaces=" "><para>24.88 </para></entry><entry command="tab" spaces=" "><para>24.88
</para></entry></row></tbody></multitable>
-<para>The commands as listed here are &textldquo;declaration forms&textrdquo;. The scope of
-the declaration form lasts until the next type style command or the
-end of the current group. You can also use the environment form of
-these commands; for instance, <code>\begin&lbrace;tiny&rbrace;...\end&lbrace;tiny&rbrace;</code>.
+<para>The commands are listed here in declaration forms. You use them by
+declaring them, as with this example.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;quotation&rbrace; \small
+ The Tao that can be named is not the eternal Tao.
+\end&lbrace;quotation&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>The scope of the <code>\small</code> lasts until the end of the
+<code>quotation</code> environment. It would also end at the next type style
+command or the end of the current group, so you could enclose it in
+extra curly braces <code>&lbrace;\small We are here, we are here, we are
+here!&rbrace;</code>. You can instead use the environment form of these commands;
+for instance, <code>\begin&lbrace;tiny&rbrace;...\end&lbrace;tiny&rbrace;</code>.
</para>
</section>
<node name="Low_002dlevel-font-commands" spaces=" "><nodename>Low-level font commands</nodename><nodeprev automatic="on">Font sizes</nodeprev><nodeup automatic="on">Fonts</nodeup></node>
<section spaces=" "><sectiontitle>Low-level font commands</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="127">low-level font commands</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="128">font commands, low-level</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="131">low-level font commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="132">font commands, low-level</indexterm></cindex>
<para>These commands are primarily intended for writers of macros and
packages. The commands listed here are only a subset of the available
@@ -1750,8 +1838,9 @@ ones.
<!-- c xx something about ultimately reading ENCFAM.fd? -->
</para>
<table commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code">\fontencoding&lbrace;<var>encoding</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="149">\fontencoding</indexterm></findex>
+<beforefirstitem><anchor name="low-level-font-commands-fontencoding">low level font commands fontencoding</anchor>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code">\fontencoding&lbrace;<var>encoding</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="148" mergedindex="cp">\fontencoding</indexterm></findex>
<para>Select the font encoding, the encoding of the output font. There are a
large number of valid encodings. The most common are <code>OT1</code>,
Knuth&textrsquo;s original encoding for Computer Modern (the default), and
@@ -1761,16 +1850,17 @@ accented characters used by the most widespread European languages
hyphenate words containing accented letters. For more, see
<url><urefurl>https://ctan.org/pkg/encguide</urefurl></url>.
</para>
+<anchor name="low-level-font-commands-fontfamily">low level font commands fontfamily</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\fontfamily&lbrace;<var>family</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="150">\fontfamily</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="129">families, of fonts</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="130">font catalogue</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="149" mergedindex="cp">\fontfamily</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="133">families, of fonts</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="134">font catalogue</indexterm></cindex>
<para>Select the font family. The web page
<url><urefurl>http://www.tug.dk/FontCatalogue/</urefurl></url> provides one way to browse
through many of the fonts easily used with &latex;. Here are
-examples of some common families:
+examples of some common families.
</para>
-<multitable spaces=" " endspaces=" "><columnprototypes><columnprototype bracketed="on">font</columnprototype> <columnprototype bracketed="on">Computer Modern Typewriter XXXX</columnprototype></columnprototypes>
+<multitable spaces=" " endspaces=" "><columnprototypes><columnprototype bracketed="on">font</columnprototype> <columnprototype bracketed="on">Computer Modern Typewriter more space</columnprototype></columnprototypes>
<tbody><row><entry command="item" spaces=" "><para><code>pag</code>
</para></entry><entry command="tab" spaces=" "><para>Avant Garde
</para></entry></row><row><entry command="item" spaces=" "><para><code>fvs</code>
@@ -1814,9 +1904,10 @@ examples of some common families:
</para></entry></row></tbody></multitable>
+<anchor name="low-level-font-commands-fontseries">low level font commands fontseries</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\fontseries&lbrace;<var>series</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="151">\fontseries</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="131">series, of fonts</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="150" mergedindex="cp">\fontseries</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="135">series, of fonts</indexterm></cindex>
<para>Select the font series. A <dfn>series</dfn> combines a <dfn>weight</dfn> and a
<dfn>width</dfn>. Typically, a font supports only a few of the possible
combinations. Some common combined series values include:
@@ -1834,7 +1925,7 @@ combinations. Some common combined series values include:
</para></entry><entry command="tab" spaces=" "><para>Bold extended
</para></entry></row></tbody></multitable>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="132">weights, of fonts</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="136">weights, of fonts</indexterm></cindex>
<para>The possible values for weight, individually, are:
</para>
<multitable spaces=" " endspaces=" "><columnprototypes><columnprototype bracketed="on">xx</columnprototype> <columnprototype bracketed="on">Medium (normal) xx</columnprototype></columnprototypes>
@@ -1858,11 +1949,10 @@ combinations. Some common combined series values include:
</para></entry><entry command="tab" spaces=" "><para>Ultra bold
</para></entry></row></tbody></multitable>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="133">widths, of fonts</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="137">widths, of fonts</indexterm></cindex>
<para>The possible values for width, individually, are (the meaning and
relationship of these terms varies with individual typefaces):
</para>
-
<multitable spaces=" " endspaces=" "><columnprototypes><columnprototype bracketed="on">xx</columnprototype> <columnprototype bracketed="on">Ultra condensed</columnprototype></columnprototypes>
<tbody><row><entry command="item" spaces=" "><para><code>uc</code>
</para></entry><entry command="tab" spaces=" "><para>Ultra condensed
@@ -1884,15 +1974,15 @@ relationship of these terms varies with individual typefaces):
</para></entry><entry command="tab" spaces=" "><para>Ultra expanded
</para></entry></row></tbody></multitable>
-
<para>When forming the <var>series</var> string from the weight and width, drop the
<code>m</code> that stands for medium weight or medium width, unless both
weight and width are <code>m</code>, in which case use just one
(<samp><code>m</code></samp>).
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\fontshape&lbrace;<var>shape</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="152">\fontshape</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="134">shapes, of fonts</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="151" mergedindex="cp">\fontshape</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="138">shapes, of fonts</indexterm></cindex>
+<anchor name="low-level-font-commands-fontshape">low level font commands fontshape</anchor>
<para>Select font shape. Valid shapes are:
</para>
<multitable spaces=" " endspaces=" "><columnprototypes><columnprototype bracketed="on">xx</columnprototype> <columnprototype bracketed="on">Slanted (oblique)xx</columnprototype></columnprototypes>
@@ -1910,14 +2000,14 @@ weight and width are <code>m</code>, in which case use just one
</para></entry><entry command="tab" spaces=" "><para>Outline
</para></entry></row></tbody></multitable>
-
<para>The two last shapes are not available for most font families, and
small caps are often missing as well.
</para>
+<anchor name="low-level-font-commands-fontsize">low level font commands fontsize</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\fontsize&lbrace;<var>size</var>&rbrace;&lbrace;<var>skip</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="153">\fontsize</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="135">font size</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="154">\baselineskip</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="152" mergedindex="cp">\fontsize</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="139">font size</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="153" mergedindex="cp">\baselineskip</indexterm></findex>
<para>Set the font size and the line spacing. The unit of both parameters
defaults to points (<code>pt</code>). The line spacing is the nominal
vertical space between lines, baseline to baseline. It is stored in the
@@ -1926,8 +2016,9 @@ the Computer Modern typeface is 1.2 times the <code>\fontsize</code>.
Changing <code>\baselineskip</code> directly is inadvisable since its value is
reset every time a size change happens; see <code>\baselinestretch</code>, next.
</para>
+<anchor name="low-level-font-commands-baselinestretch">low level font commands baselinestretch</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\baselinestretch</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="155">\baselinestretch</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="154" mergedindex="cp">\baselinestretch</indexterm></findex>
<para>&latex; multiplies the line spacing by the value of the
<code>\baselinestretch</code> parameter; the default factor is 1. A change
takes effect when <code>\selectfont</code> (see below) is called. You can
@@ -1935,26 +2026,28 @@ make a line skip change happen for the entire document, for instance
doubling it, by doing <code>\renewcommand&lbrace;\baselinestretch&rbrace;&lbrace;2.0&rbrace;</code> in
the preamble.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="136"><r>package</r>, <code>setspace</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="137"><code>setspace</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="140"><r>package</r>, <code>setspace</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="141"><code>setspace</code> <r>package</r></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="138">double spacing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="142">double spacing</indexterm></cindex>
<para>However, the best way to double-space a document is to use the
<file>setspace</file> package. In addition to offering a number of spacing
options, this package keeps the line spacing single-spaced in places
where that is typically desirable, such as footnotes and figure
captions. See the package documentation.
</para>
+<anchor name="low-level-font-commands-linespread">low level font commands linespread</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\linespread&lbrace;<var>factor</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="156">\linespread</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="155" mergedindex="cp">\linespread</indexterm></findex>
<para>Equivalent to
<code>\renewcommand&lbrace;\baselinestretch&rbrace;&lbrace;<var>factor</var>&rbrace;</code>, and
therefore must be followed by <code>\selectfont</code> to have any effect.
Best specified in the preamble, or use the <code>setspace</code> package, as
just described.
</para>
+<anchor name="low-level-font-commands-selectfont">low level font commands selectfont</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\selectfont</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="157">\selectfont</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="156" mergedindex="cp">\selectfont</indexterm></findex>
<para>The effects of the font commands described above do not happen until
<code>\selectfont</code> is called, as in
<code>\fontfamily&lbrace;<var>familyname</var>&rbrace;\selectfont</code>. It is often useful
@@ -1962,8 +2055,9 @@ to put this in a macro:&linebreak;
<code>\newcommand*&lbrace;\myfont&rbrace;&lbrace;\fontfamily&lbrace;<var>familyname</var>&rbrace;\selectfont&rbrace;</code>&linebreak;
(<pxref label="_005cnewcommand-_0026-_005crenewcommand"><xrefnodename>\newcommand &amp; \renewcommand</xrefnodename></pxref>).
</para>
+<anchor name="low-level-font-commands-usefont">low level font commands usefont</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\usefont&lbrace;<var>enc</var>&rbrace;&lbrace;<var>family</var>&rbrace;&lbrace;<var>series</var>&rbrace;&lbrace;<var>shape</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="158">\usefont</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="157" mergedindex="cp">\usefont</indexterm></findex>
<para>The same as invoking <code>\fontencoding</code>, <code>\fontfamily</code>,
<code>\fontseries</code> and <code>\fontshape</code> with the given parameters,
followed by <code>\selectfont</code>. For example:
@@ -1980,7 +2074,7 @@ followed by <code>\selectfont</code>. For example:
<node name="Layout" spaces=" "><nodename>Layout</nodename><nodenext automatic="on">Sectioning</nodenext><nodeprev automatic="on">Fonts</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Layout</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="139">layout commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="143">layout commands</indexterm></cindex>
<para>Commands for controlling the general page layout.
</para>
@@ -1997,23 +2091,28 @@ followed by <code>\selectfont</code>. For example:
<node name="_005conecolumn" spaces=" "><nodename>\onecolumn</nodename><nodenext automatic="on">\twocolumn</nodenext><nodeup automatic="on">Layout</nodeup></node>
<section spaces=" "><sectiontitle><code>\onecolumn</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="159">\onecolumn</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="140">one-column output</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="158" mergedindex="cp">\onecolumn</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="144">one-column output</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\onecolumn
+</pre></example>
<para>Start a new page and produce single-column output. If the document is
given the class option <code>onecolumn</code> then this is the default
-behavior (<pxref label="Document-class-options"><xrefnodename>Document class options</xrefnodename></pxref>).
-</para>
-<para>This command is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+behavior (<pxref label="Document-class-options"><xrefnodename>Document class options</xrefnodename></pxref>). This command is fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
</section>
<node name="_005ctwocolumn" spaces=" "><nodename>\twocolumn</nodename><nodenext automatic="on">\flushbottom</nodenext><nodeprev automatic="on">\onecolumn</nodeprev><nodeup automatic="on">Layout</nodeup></node>
<section spaces=" "><sectiontitle><code>\twocolumn</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="160">\twocolumn</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="141">multicolumn text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="142">two-column output</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="159" mergedindex="cp">\twocolumn</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="145">multicolumn text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="146">two-column output</indexterm></cindex>
<para>Synopses:
</para>
@@ -2024,32 +2123,34 @@ behavior (<pxref label="Document-class-options"><xrefnodename>Document class opt
<para>Start a new page and produce two-column output. If the document is given
the class option <code>twocolumn</code> then this is the default
-(<pxref label="Document-class-options"><xrefnodename>Document class options</xrefnodename></pxref>).
+(<pxref label="Document-class-options"><xrefnodename>Document class options</xrefnodename></pxref>). This command is fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
<para>If the optional <var>prelim one column text</var> argument
is present, it is typeset in one-column mode before the two-column
typesetting starts.
</para>
-<para>This command is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
-</para>
<para>These parameters control typesetting in two-column output:
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="161">\columnsep</indexterm>\columnsep</itemformat></item>
-</tableterm><tableitem><para>The distance between columns. The default is 35pt. Change it with a
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="160" mergedindex="cp">\columnsep</indexterm>\columnsep</itemformat></item>
+</tableterm><tableitem><anchor name="twocolumn-columnsep">twocolumn columnsep</anchor>
+<para>The distance between columns. The default is 35pt. Change it with a
command such as <code>\setlength&lbrace;\columnsep&rbrace;&lbrace;40pt&rbrace;</code> You must change
it before the two column environment starts; in the preamble is a good
place.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="162">\columnseprule</indexterm>\columnseprule</itemformat></item>
-</tableterm><tableitem><para>The width of the rule between columns. The rule appears halfway between
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="161" mergedindex="cp">\columnseprule</indexterm>\columnseprule</itemformat></item>
+</tableterm><tableitem><anchor name="twocolumn-columnseprule">twocolumn columnseprule</anchor>
+<para>The width of the rule between columns. The rule appears halfway between
the two columns. The default is 0pt, meaning that there is no rule.
Change it with a command such as
<code>\setlength&lbrace;\columnseprule&rbrace;&lbrace;0.4pt&rbrace;</code>, before the two-column
environment starts.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="163">\columnwidth</indexterm>\columnwidth</itemformat></item>
-</tableterm><tableitem><para>The width of a single column. In one-column mode this is equal to
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="162" mergedindex="cp">\columnwidth</indexterm>\columnwidth</itemformat></item>
+</tableterm><tableitem><anchor name="twocolumn-columnwidth">twocolumn columnwidth</anchor>
+<para>The width of a single column. In one-column mode this is equal to
<code>\textwidth</code>. In two-column mode by default &latex; sets the
width of each of the two columns to be half of <code>\textwidth</code> minus
<code>\columnsep</code>.
@@ -2063,7 +2164,8 @@ and <pxref label="table"><xrefnodename>table</xrefnodename></pxref>). &latex; pl
The following parameters control float behavior of two-column output.
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="164">\dbltopfraction</indexterm>\dbltopfraction</itemformat></item>
+<beforefirstitem><anchor name="twocolumn-dbltopfraction">twocolumn dbltopfraction</anchor>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="163" mergedindex="cp">\dbltopfraction</indexterm>\dbltopfraction</itemformat></item>
</tableterm><tableitem><para>The maximum fraction at the top of a two-column page that may be
occupied by two-column wide floats. The default is 0.7, meaning that
the height of a <code>table*</code> or <code>figure*</code> environment must not
@@ -2085,27 +2187,31 @@ the bulky float on a page by itself, as well as at the top of a page.
to avoid going to float pages so soon.
</para></listitem></itemize>
-<para>You can redefine it, for instance with
+<para>You can redefine it, as with
<code>\renewcommand&lbrace;\dbltopfraction&rbrace;&lbrace;0.9&rbrace;</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="165">\dblfloatpagefraction</indexterm>\dblfloatpagefraction</itemformat></item>
+<anchor name="twocolumn-dblfloatpagefraction">twocolumn dblfloatpagefraction</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="164" mergedindex="cp">\dblfloatpagefraction</indexterm>\dblfloatpagefraction</itemformat></item>
</tableterm><tableitem><para>For a float page of two-column wide floats, this is the minimum fraction
that must be occupied by floats, limiting the amount of blank space.
&latex;&textrsquo;s default is <code>0.5</code>. Change it with <code>\renewcommand</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="166">\dblfloatsep</indexterm>\dblfloatsep</itemformat></item>
+<anchor name="twocolumn-dblfloatsep">twocolumn dblfloatsep</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="165" mergedindex="cp">\dblfloatsep</indexterm>\dblfloatsep</itemformat></item>
</tableterm><tableitem><para>On a float page of two-column wide floats, this length is the distance
between floats, at both the top and bottom of the page. The default is
<code>12pt plus2pt minus2pt</code> for a document set at <code>10pt</code> or
<code>11pt</code>, and <code>14pt plus2pt minus4pt</code> for a document set at
<code>12pt</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="167">\dbltextfloatsep</indexterm>\dbltextfloatsep</itemformat></item>
+<anchor name="twocolumn-dbltextfloatsep">twocolumn dbltextfloatsep</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="166" mergedindex="cp">\dbltextfloatsep</indexterm>\dbltextfloatsep</itemformat></item>
</tableterm><tableitem><para>This length is the distance between a multi-column float at the top or
bottom of a page and the main text. The default is <code>20pt plus2pt
minus4pt</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="168">\dbltopnumber</indexterm>\dbltopnumber</itemformat></item>
+<anchor name="twocolumn-dbltopnumber">twocolumn dbltopnumber</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="167" mergedindex="cp">\dbltopnumber</indexterm>\dbltopnumber</itemformat></item>
</tableterm><tableitem><para>On a float page of two-column wide floats, this counter gives the
maximum number of floats allowed at the top of the page. The &latex;
default is <code>2</code>.
@@ -2141,7 +2247,7 @@ Two column text here.
<node name="_005cflushbottom" spaces=" "><nodename>\flushbottom</nodename><nodenext automatic="on">\raggedbottom</nodenext><nodeprev automatic="on">\twocolumn</nodeprev><nodeup automatic="on">Layout</nodeup></node>
<section spaces=" "><sectiontitle><code>\flushbottom</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="169">\flushbottom</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="168" mergedindex="cp">\flushbottom</indexterm></findex>
<para>Make all pages in the documents after this declaration have the same
height, by stretching the vertical space where necessary to fill out the
@@ -2166,8 +2272,8 @@ is to, in a final editing stage, adjust the height of individual pages
<node name="_005craggedbottom" spaces=" "><nodename>\raggedbottom</nodename><nodenext automatic="on">Page layout parameters</nodenext><nodeprev automatic="on">\flushbottom</nodeprev><nodeup automatic="on">Layout</nodeup></node>
<section spaces=" "><sectiontitle><code>\raggedbottom</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="170">\raggedbottom</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="143">stretch, omitting vertical</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="169" mergedindex="cp">\raggedbottom</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="147">stretch, omitting vertical</indexterm></cindex>
<para>Make all later pages the natural height of the material on that page; no
rubber vertical lengths will be stretched. Thus, in a two-sided
@@ -2182,49 +2288,56 @@ option (<pxref label="Document-class-options"><xrefnodename>Document class optio
<node name="Page-layout-parameters" spaces=" "><nodename>Page layout parameters</nodename><nodenext automatic="on">Floats</nodenext><nodeprev automatic="on">\raggedbottom</nodeprev><nodeup automatic="on">Layout</nodeup></node>
<section spaces=" "><sectiontitle>Page layout parameters</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="144">page layout parameters</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="145">parameters, page layout</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="146">layout, page parameters for</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="147">header, parameters for</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="148">footer, parameters for</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="149">running header and footer</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="148">page layout parameters</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="149">parameters, page layout</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="150">layout, page parameters for</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="151">header, parameters for</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="152">footer, parameters for</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="153">running header and footer</indexterm></cindex>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="171">\columnsep</indexterm>\columnsep</itemformat></item>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="172">\columnseprule</indexterm>\columnseprule</itemformat></itemx>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="173">\columnwidth</indexterm>\columnwidth</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="174">\columnsep</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="175">\columnseprule</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="176">\columnwidth</indexterm></findex>
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="170" mergedindex="cp">\columnsep</indexterm>\columnsep</itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="171" mergedindex="cp">\columnseprule</indexterm>\columnseprule</itemformat></itemx>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="172" mergedindex="cp">\columnwidth</indexterm>\columnwidth</itemformat></itemx>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="173" mergedindex="cp">\columnsep</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="174" mergedindex="cp">\columnseprule</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="175" mergedindex="cp">\columnwidth</indexterm></findex>
+<anchor name="page-layout-parameters-columnsep">page layout parameters columnsep</anchor>
+<anchor name="page-layout-parameters-columnseprule">page layout parameters columnseprule</anchor>
+<anchor name="page-layout-parameters-columnwidth">page layout parameters columnwidth</anchor>
<para>The distance between the two columns, the width of a rule between the
columns, and the width of the columns, when the document class option
<code>twocolumn</code> is in effect (<pxref label="Document-class-options"><xrefnodename>Document class options</xrefnodename></pxref>).
<xref label="_005ctwocolumn"><xrefnodename>\twocolumn</xrefnodename></xref>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="177">\headheight</indexterm>\headheight</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="178">\headheight</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="176" mergedindex="cp">\headheight</indexterm>\headheight</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="177" mergedindex="cp">\headheight</indexterm></findex>
+<anchor name="page-layout-parameters-headheight">page layout parameters headheight</anchor>
<para>Height of the box that contains the running head. The default in the
<code>article</code>, <code>report</code>, and <code>book</code> classes is <samp>12pt</samp>,
at all type sizes.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="179">\headsep</indexterm>\headsep</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="180">\headsep</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="178" mergedindex="cp">\headsep</indexterm>\headsep</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="179" mergedindex="cp">\headsep</indexterm></findex>
+<anchor name="page-layout-parameters-headsep">page layout parameters headsep</anchor>
<para>Vertical distance between the bottom of the header line and the top of
the main text. The default in the <code>article</code> and <code>report</code>
classes is <samp>25pt</samp>. In the <code>book</code> class the default is: if the
document is set at 10pt then it is <samp>0.25in</samp>, and at 11pt and 12pt
it is <samp>0.275in</samp>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="181">\footskip</indexterm>\footskip</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="182">\footskip</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="180" mergedindex="cp">\footskip</indexterm>\footskip</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="181" mergedindex="cp">\footskip</indexterm></findex>
+<anchor name="page-layout-parameters-footskip">page layout parameters footskip</anchor>
<para>Distance from the baseline of the last line of text to the baseline of
the page footer. The default in the <code>article</code> and <code>report</code>
classes is <samp>30pt</samp>. In the <code>book</code> class the default is: when
the type size is 10pt the default is <samp>0.35in</samp>, while at 11pt it is
<samp>0.38in</samp>, and at 12pt it is <samp>30pt</samp>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="183">\linewidth</indexterm>\linewidth</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="184">\linewidth</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="182" mergedindex="cp">\linewidth</indexterm>\linewidth</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="183" mergedindex="cp">\linewidth</indexterm></findex>
+<anchor name="page-layout-parameters-linewidth">page layout parameters linewidth</anchor>
<para>Width of the current line, decreased for each nested <code>list</code>
(<pxref label="list"><xrefnodename>list</xrefnodename></pxref>). That is, the nominal value for <code>\linewidth</code> is to
equal <code>\textwidth</code> but for each nested list the <code>\linewidth</code>
@@ -2234,12 +2347,15 @@ is decreased by the sum of that list&textrsquo;s <code>\leftmargin</code> and
<!-- c etc. For an @code{article} document set in 10pt, the default is -->
<!-- c @samp{345pt}, while in two-column mode that becomes @samp{229.5pt}. -->
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="185">\marginparpush</indexterm>\marginparpush</itemformat></item>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="186">\marginsep</indexterm>\marginsep</itemformat></itemx>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="187">\marginparwidth</indexterm>\marginparwidth</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="188">\marginparpush</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="189">\marginsep</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="190">\marginparwidth</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="184" mergedindex="cp">\marginparpush</indexterm>\marginparpush</itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="185" mergedindex="cp">\marginsep</indexterm>\marginsep</itemformat></itemx>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="186" mergedindex="cp">\marginparwidth</indexterm>\marginparwidth</itemformat></itemx>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="187" mergedindex="cp">\marginparpush</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="188" mergedindex="cp">\marginsep</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="189" mergedindex="cp">\marginparwidth</indexterm></findex>
+<anchor name="page-layout-parameters-marginparpush">page layout parameters marginparpush</anchor>
+<anchor name="page-layout-parameters-marginsep">page layout parameters marginsep</anchor>
+<anchor name="page-layout-parameters-marginparwidth">page layout parameters marginparwidth</anchor>
<para>The minimum vertical space between two marginal notes, the horizontal
space between the text body and the marginal notes, and the horizontal
width of the notes.
@@ -2264,10 +2380,12 @@ classes, in two-column mode the default is 60% of <code>\paperwidth
&minus; \textwidth</code>, while in one-column mode it is 50% of that
distance.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="191">\oddsidemargin</indexterm>\oddsidemargin</itemformat></item>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="192">\evensidemargin</indexterm>\evensidemargin</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="193">\oddsidemargin</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="194">\evensidemargin</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="190" mergedindex="cp">\oddsidemargin</indexterm>\oddsidemargin</itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="191" mergedindex="cp">\evensidemargin</indexterm>\evensidemargin</itemformat></itemx>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="192" mergedindex="cp">\oddsidemargin</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="193" mergedindex="cp">\evensidemargin</indexterm></findex>
+<anchor name="page-layout-parameters-oddsidemargin">page layout parameters oddsidemargin</anchor>
+<anchor name="page-layout-parameters-evensidemargin">page layout parameters evensidemargin</anchor>
<para>The <code>\oddsidemargin</code> is the extra distance between the left side of
the page and the text&textrsquo;s left margin, on odd-numbered pages when the
document class option <code>twoside</code> is chosen and on all pages when
@@ -2279,22 +2397,25 @@ even-numbered pages the extra distance on the left is
difference between <code>\paperwidth</code> and <code>\textwidth</code>, and
<code>\evensidemargin</code> is the remainder.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="195">\paperheight</indexterm>\paperheight</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="196">\paperheight</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="194" mergedindex="cp">\paperheight</indexterm>\paperheight</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="195" mergedindex="cp">\paperheight</indexterm></findex>
+<anchor name="page-layout-parameters-paperheight">page layout parameters paperheight</anchor>
<para>The height of the paper, as distinct from the height of the print area.
-It is normally set with a document class option, as in
+Normally set with a document class option, as in
<code>\documentclass[a4paper]&lbrace;article&rbrace;</code> (<pxref label="Document-class-options"><xrefnodename>Document class
options</xrefnodename></pxref>).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="197">\paperwidth</indexterm>\paperwidth</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="198">\paperwidth</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="196" mergedindex="cp">\paperwidth</indexterm>\paperwidth</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="197" mergedindex="cp">\paperwidth</indexterm></findex>
+<anchor name="page-layout-parameters-paperwidth">page layout parameters paperwidth</anchor>
<para>The width of the paper, as distinct from the width of the print area.
-It is normally set with a document class option, as in
+Normally set with a document class option, as in
<code>\documentclass[a4paper]&lbrace;article&rbrace;</code> (<pxref label="Document-class-options"><xrefnodename>Document class
options</xrefnodename></pxref>).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="199">\textheight</indexterm>\textheight</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="200">\textheight</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="198" mergedindex="cp">\textheight</indexterm>\textheight</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="199" mergedindex="cp">\textheight</indexterm></findex>
+<anchor name="page-layout-parameters-textheight">page layout parameters textheight</anchor>
<para>The normal vertical height of the page body. If the document is set at
a nominal type size of 10pt then for an <code>article</code> or <code>report</code>
the default is <samp>43\baselineskip</samp>, while for a <code>book</code> it is
@@ -2302,8 +2423,9 @@ the default is <samp>43\baselineskip</samp>, while for a <code>book</code> it is
<samp>38\baselineskip</samp> for all document classes. At 12pt it is
<samp>36\baselineskip</samp> for all classes.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="201">\textwidth</indexterm>\textwidth</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="202">\textwidth</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="200" mergedindex="cp">\textwidth</indexterm>\textwidth</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="201" mergedindex="cp">\textwidth</indexterm></findex>
+<anchor name="page-layout-parameters-textwidth">page layout parameters textwidth</anchor>
<para>The full horizontal width of the entire page body. For an
<code>article</code> or <code>report</code> document, the default is <samp>345pt</samp>
when the chosen type size is 10pt, the default is <samp>360pt</samp> at 11pt,
@@ -2323,22 +2445,25 @@ column), while <code>\linewidth</code> may decrease for nested lists.
specified width, and revert to their normal values at the end of the
<code>minipage</code> or <code>\parbox</code>.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="203">\hsize</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="204">\hsize</indexterm></findex>
-<para>This entry is included for completeness: <code>\hsize</code> is the &tex;
+<findex index="fn" spaces=" "><indexterm index="fn" number="202" mergedindex="cp">\hsize</indexterm></findex>
+<anchor name="page-layout-parameters-hsize">page layout parameters hsize</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="203" mergedindex="cp">\hsize</indexterm>\hsize</itemformat></item>
+</tableterm><tableitem><para>This entry is included for completeness: <code>\hsize</code> is the &tex;
primitive parameter used when text is broken into lines. It should not
be used in normal &latex; documents.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="205">\topmargin</indexterm>\topmargin</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="206">topmargin</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="204" mergedindex="cp">\topmargin</indexterm>\topmargin</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="205" mergedindex="cp">topmargin</indexterm></findex>
+<anchor name="page-layout-parameters-topmargin">page layout parameters topmargin</anchor>
<para>Space between the top of the &tex; page (one inch from the top of the
paper, by default) and the top of the header. The value is computed
based on many other parameters: <code>\paperheight &minus; 2in &minus;
\headheight &minus; \headsep &minus; \textheight &minus; \footskip</code>,
and then divided by two.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="207">\topskip</indexterm>\topskip</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="208">\topskip</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="206" mergedindex="cp">\topskip</indexterm>\topskip</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="207" mergedindex="cp">\topskip</indexterm></findex>
+<anchor name="page-layout-parameters-topskip">page layout parameters topskip</anchor>
<para>Minimum distance between the top of the page body and the baseline of
the first line of text. For the standard classes, the default is the
same as the font size, e.g., <samp>10pt</samp> at a type size of 10pt.
@@ -2375,8 +2500,8 @@ float that is big may migrate to the end of the document. In which
event, because all floats in a class must appear in sequential order,
every following float in that class also appears at the end.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="150">placement of floats</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="151">specifier, float placement</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="154">placement of floats</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="155">specifier, float placement</indexterm></cindex>
<para>In addition to changing the parameters, for each float you can tweak
where the float placement algorithm tries to place it by using its
<var>placement</var> argument. The possible values are a sequence of the
@@ -2399,9 +2524,9 @@ FAQ: <url><urefurl>http://www.tex.ac.uk/cgi-bin/texfaq2html?label=2colfloat</ure
appears. However, <code>h</code> is not allowed by itself; <code>t</code> is
automatically added.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="152">here, putting floats</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="153"><r>package</r>, <code>float</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="154"><code>float</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="156">here, putting floats</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="157"><r>package</r>, <code>float</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="158"><code>float</code> <r>package</r></indexterm></cindex>
<para>To absolutely force a float to appear &textldquo;here&textrdquo;, you can
<code>\usepackage&lbrace;float&rbrace;</code> and use the <code>H</code> specifier which it
@@ -2409,7 +2534,7 @@ defines. For further discussion, see the FAQ entry at
<url><urefurl>http://www.tex.ac.uk/cgi-bin/texfaq2html?label=figurehere</urefurl></url>.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">p</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="155">float page</indexterm></cindex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="159">float page</indexterm></cindex>
<para>(Page of floats)&textmdash;on a separate <dfn>float page</dfn>, which is a page
containing no text, only floats.
</para>
@@ -2437,8 +2562,8 @@ use the <file>afterpage</file> package and issue
<code>\afterpage&lbrace;\clearpage&rbrace;</code>. This will wait until the current page
is finished and then flush all outstanding floats.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="156"><r>package</r>, <code>flafter</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="157"><code>flafter</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="160"><r>package</r>, <code>flafter</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="161"><code>flafter</code> <r>package</r></indexterm></cindex>
<para>&latex; can typeset a float before where it appears in the source
(although on the same output page) if there is a <code>t</code> specifier in
@@ -2446,7 +2571,7 @@ the <var>placement</var> parameter. If this is not desired, and deleting
the <code>t</code> is not acceptable as it keeps the float from being placed
at the top of the next page, then you can prevent it by either using
the <file>flafter</file> package or using the command
-<findex index="fn" spaces=" "><indexterm index="fn" number="209">\suppressfloats</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="208" mergedindex="cp">\suppressfloats</indexterm></findex>
<code>\suppressfloats[t]</code>, which causes floats for the top position on
this page to moved to the next page.
</para>
@@ -2455,70 +2580,83 @@ non-float text (change them with
<code>\renewcommand&lbrace;<var>parameter</var>&rbrace;&lbrace;<var>decimal between 0 and 1</var>&rbrace;</code>):
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="210">\bottomfraction</indexterm>\bottomfraction</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="211">\bottomfraction</indexterm></findex>
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="209" mergedindex="cp">\bottomfraction</indexterm>\bottomfraction</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="210" mergedindex="cp">\bottomfraction</indexterm></findex>
+<anchor name="floats-bottomfraction">floats bottomfraction</anchor>
<para>The maximum fraction of the page allowed to be occupied by floats at
the bottom; default <samp>.3</samp>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="212">\floatpagefraction</indexterm>\floatpagefraction</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="213">\floatpagefraction</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="211" mergedindex="cp">\floatpagefraction</indexterm>\floatpagefraction</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="212" mergedindex="cp">\floatpagefraction</indexterm></findex>
+<anchor name="floats-floatpagefraction">floats floatpagefraction</anchor>
<para>The minimum fraction of a float page that must be occupied by floats;
default <samp>.5</samp>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="214">\textfraction</indexterm>\textfraction</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="215">\textfraction</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="213" mergedindex="cp">\textfraction</indexterm>\textfraction</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="214" mergedindex="cp">\textfraction</indexterm></findex>
+<anchor name="floats-textfraction">floats textfraction</anchor>
<para>Minimum fraction of a page that must be text; if floats take up too
much space to preserve this much text, floats will be moved to a
different page. The default is <samp>.2</samp>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="216">\topfraction</indexterm>\topfraction</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="217">\topfraction</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="215" mergedindex="cp">\topfraction</indexterm>\topfraction</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="216" mergedindex="cp">\topfraction</indexterm></findex>
+<anchor name="floats-topfraction">floats topfraction</anchor>
<para>Maximum fraction at the top of a page that may be occupied before
floats; default <samp>.7</samp>.
</para></tableitem></tableentry></ftable>
-<para>Parameters relating to vertical space around floats (change them with
-<code>\setlength&lbrace;<var>parameter</var>&rbrace;&lbrace;<var>length expression</var>&rbrace;</code>):
+<para>Parameters relating to vertical space around floats (change them with a
+command of the form <code>\setlength&lbrace;<var>parameter</var>&rbrace;&lbrace;<var>length
+expression</var>&rbrace;</code>):
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="218">\floatsep</indexterm>\floatsep</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="219">\floatsep</indexterm></findex>
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="217" mergedindex="cp">\floatsep</indexterm>\floatsep</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="218" mergedindex="cp">\floatsep</indexterm></findex>
+<anchor name="floats-floatsep">floats floatsep</anchor>
<para>Space between floats at the top or bottom of a page; default
<samp>12pt plus2pt minus2pt</samp>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="220">\intextsep</indexterm>\intextsep</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="221">\intextsep</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="219" mergedindex="cp">\intextsep</indexterm>\intextsep</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="220" mergedindex="cp">\intextsep</indexterm></findex>
+<anchor name="floats-intextsep">floats intextsep</anchor>
<para>Space above and below a float in the middle of the main text; default
<samp>12pt plus2pt minus2pt</samp> for 10 point and 11 point documents,
and <samp>14pt plus4pt minus4pt</samp> for 12 point documents.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="222">\textfloatsep</indexterm>\textfloatsep</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="223">\textfloatsep</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="221" mergedindex="cp">\textfloatsep</indexterm>\textfloatsep</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="222" mergedindex="cp">\textfloatsep</indexterm></findex>
+<anchor name="floats-textfloatsep">floats textfloatsep</anchor>
<para>Space between the last (first) float at the top (bottom) of a page;
default <samp>20pt plus2pt minus4pt</samp>.
</para></tableitem></tableentry></ftable>
-<para>Counters relating to the number of floats on a page (change them with
-<code>\setcounter&lbrace;<var>ctrname</var>&rbrace;&lbrace;<var>natural number</var>&rbrace;</code>):
+<para>Counters relating to the number of floats on a page (change them with a
+command of the form <code>\setcounter&lbrace;<var>ctrname</var>&rbrace;&lbrace;<var>natural
+number</var>&rbrace;</code>):
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="224">bottomnumber</indexterm>bottomnumber</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="225">bottomnumber</indexterm></findex>
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="223" mergedindex="cp">bottomnumber</indexterm>bottomnumber</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="224" mergedindex="cp">bottomnumber</indexterm></findex>
+<anchor name="floats-bottomnumber">floats bottomnumber</anchor>
<para>Maximum number of floats that can appear at the bottom of a text page;
default 1.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="226">dbltopnumber</indexterm>dbltopnumber</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="227">dbltopnumber</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="225" mergedindex="cp">dbltopnumber</indexterm>dbltopnumber</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="226" mergedindex="cp">dbltopnumber</indexterm></findex>
+<anchor name="floats-dbltopnumber">floats dbltopnumber</anchor>
<para>Maximum number of full-sized floats that can appear at the top of a
two-column page; default 2.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="228">topnumber</indexterm>topnumber</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="229">topnumber</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="227" mergedindex="cp">topnumber</indexterm>topnumber</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="228" mergedindex="cp">topnumber</indexterm></findex>
+<anchor name="floats-topnumber">floats topnumber</anchor>
<para>Maximum number of floats that can appear at the top of a text page;
default 2.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="230">totalnumber</indexterm>totalnumber</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="231">totalnumber</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="229" mergedindex="cp">totalnumber</indexterm>totalnumber</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="230" mergedindex="cp">totalnumber</indexterm></findex>
+<anchor name="floats-totalnumber">floats totalnumber</anchor>
<para>Maximum number of floats that can appear on a text page; default 3.
</para></tableitem></tableentry></ftable>
@@ -2537,91 +2675,711 @@ influence the position of float environments like figure and table in
<node name="Sectioning" spaces=" "><nodename>Sectioning</nodename><nodenext automatic="on">Cross references</nodenext><nodeprev automatic="on">Layout</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Sectioning</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="158">sectioning commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="162">sectioning commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="163">part</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="164">chapter</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="165">section</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="166">subsection</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="167">paragraph</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="168">subparagraph</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="231" mergedindex="cp">\part</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="232" mergedindex="cp">\chapter</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="233" mergedindex="cp">\section</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="234" mergedindex="cp">\subsection</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="235" mergedindex="cp">\paragraph</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="236" mergedindex="cp">\subparagraph</indexterm></findex>
+
+<para>Structure your text into divisions: parts, chapters, sections, etc. All
+sectioning commands have the same form, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve"><var>sectioning-command</var>&lbrace;<var>title</var>&rbrace;
+<var>sectioning-command</var>*&lbrace;<var>title</var>&rbrace;
+<var>sectioning-command</var>[<var>toc-title</var>]&lbrace;<var>title</var>&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>For instance, declare the start of a subsection as with
+<code>\subsection&lbrace;Motivation&rbrace;</code>.
+</para>
+<para>The table has each <var>sectioning-command</var> in &latex;. All are
+available in all of &latex;&textrsquo;s standard document classes <code>book</code>,
+<code>report</code>, and&nbsp;<code>article</code>, except that <code>\chapter</code> is
+not available in <code>article</code>.
+</para>
+<multitable spaces=" " endspaces=" "><columnfractions line=" .25 .25 .40 "><columnfraction value=".25"></columnfraction><columnfraction value=".25"></columnfraction><columnfraction value=".40"></columnfraction></columnfractions>
+<thead><row><entry command="headitem" spaces=" "><para>Sectioning unit </para></entry><entry command="tab" spaces=" "><para>Command </para></entry><entry command="tab" spaces=" "><para>Level
+</para></entry></row></thead><tbody><row><entry command="item" spaces=" "><para>Part
+</para></entry><entry command="tab" spaces=" "><para><code>\part</code> </para></entry><entry command="tab" spaces=" "><para>-1 (<code>book</code>, <code>report</code>), 0 (<code>article</code>)
+</para></entry></row><row><entry command="item" spaces=" "><para>Chapter
+</para></entry><entry command="tab" spaces=" "><para><code>\chapter</code> </para></entry><entry command="tab" spaces=" "><para>0
+</para></entry></row><row><entry command="item" spaces=" "><para>Section
+</para></entry><entry command="tab" spaces=" "><para><code>\section</code> </para></entry><entry command="tab" spaces=" "><para>1
+</para></entry></row><row><entry command="item" spaces=" "><para>Subsection
+</para></entry><entry command="tab" spaces=" "><para><code>\subsection</code> </para></entry><entry command="tab" spaces=" "><para>2
+</para></entry></row><row><entry command="item" spaces=" "><para>Subsubsection
+</para></entry><entry command="tab" spaces=" "><para><code>\subsubsection</code> </para></entry><entry command="tab" spaces=" "><para>3
+</para></entry></row><row><entry command="item" spaces=" "><para>Paragraph
+</para></entry><entry command="tab" spaces=" "><para><code>\paragraph</code> </para></entry><entry command="tab" spaces=" "><para>4
+</para></entry></row><row><entry command="item" spaces=" "><para>Subparagraph
+</para></entry><entry command="tab" spaces=" "><para><code>\subparagraph</code> </para></entry><entry command="tab" spaces=" "><para>5
+</para></entry></row></tbody></multitable>
-<para>Sectioning commands provide the means to structure your text into units:
+<cindex index="cp" spaces=" "><indexterm index="cp" number="169"><code>*</code>-form of sectioning commands</indexterm></cindex>
+<para>All these commands have a <code>*</code>-form that prints <var>title</var> as usual
+but is not numbered and does not make an entry in the table of contents.
+An example of using this is for an appendix in an <code>article</code> . The
+input <code>\appendix\section&lbrace;Appendix&rbrace;</code> gives the output <samp>A
+Appendix</samp> (<pxref label="_005cappendix"><xrefnodename>\appendix</xrefnodename></pxref>). You can lose the numbering&nbsp;<samp>A</samp>
+by instead entering <code>\section*&lbrace;Appendix&rbrace;</code> (articles often omit a
+table of contents and have simple page headers so the other differences
+from the <code>\section</code> command may not matter).
+</para>
+<para>The section title <var>title</var> provides the heading in the main text, but
+it may also appear in the table of contents and in the running head or
+foot (<pxref label="Page-styles"><xrefnodename>Page styles</xrefnodename></pxref>). You may not want the same text in these
+places as in the main text. All of these commands have an optional
+argument <var>toc-title</var> for these other places.
+</para>
+<para>The level number in the table above determines which sectional units are
+numbered, and which appear in the table of contents. If the sectioning
+command&textrsquo;s <var>level</var> is less than or equal to the value of the counter
+<code>secnumdepth</code> then the titles for this sectioning command will be
+numbered (<pxref label="Sectioning_002fsecnumdepth"><xrefnodename>Sectioning/secnumdepth</xrefnodename></pxref>). And, if <var>level</var> is less
+than or equal to the value of the counter <code>tocdepth</code> then the table
+of contents will have an entry for this sectioning unit
+(<pxref label="Sectioning_002ftocdepth"><xrefnodename>Sectioning/tocdepth</xrefnodename></pxref>).
+</para>
+<para>&latex; expects that before you have a <code>\subsection</code> you will have
+a <code>\section</code> and, in a book, that before a <code>\section</code> you will
+have a <code>\chapter</code>. Otherwise you can get a something like a
+subsection numbered <samp>3.0.1</samp>.
+</para>
+<para>Two counters relate to the appearance of sectioning commands.
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="232">\part</indexterm>\part</itemformat></item>
-</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="233">\chapter</indexterm>\chapter</itemformat></item>
-</tableterm><tableitem><para>(<code>report</code> and <code>book</code> class only)
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="234">\section</indexterm>\section</itemformat></item>
-</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="235">\subsection</indexterm>\subsection</itemformat></item>
-</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="236">\subsubsection</indexterm>\subsubsection</itemformat></item>
-</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="237">\paragraph</indexterm>\paragraph</itemformat></item>
-</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="238">\subparagraph</indexterm>\subparagraph</itemformat></item>
-</tableterm></tableentry></ftable>
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="237" mergedindex="cp">secnumdepth</indexterm>secnumdepth</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="238" mergedindex="cp">secnumdepth <r>counter</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="170">section numbers, printing</indexterm></cindex>
+<anchor name="sectioning-secnumdepth">sectioning secnumdepth</anchor>
+<anchor name="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</anchor>
+<para>Controls which sectioning commands are
+numbered. Suppress numbering of sectioning at any depth greater than
+<var>level</var> <code>\setcounter&lbrace;secnumdepth&rbrace;&lbrace;<var>level</var>&rbrace;</code>
+(<pxref label="_005csetcounter"><xrefnodename>\setcounter</xrefnodename></pxref>). See the above table for the level numbers. For
+instance, if the <code>secnumdepth</code> is 1 in an <code>article</code> then a
+<code>\section&lbrace;Introduction&rbrace;</code> command will produce output like <samp>1
+Introduction</samp> while <code>\subsection&lbrace;Discussion&rbrace;</code> will produce output
+like <samp>Discussion</samp>, without the number. &latex;&textrsquo;s default
+<code>secnumdepth</code> is&nbsp;3 in <file>article</file> class and &nbsp;2 in the
+<file>book</file> and <file>report</file> classes.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="239" mergedindex="cp">tocdepth</indexterm>tocdepth</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="240" mergedindex="cp">tocdepth <r>counter</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="171">table of contents, sectioning numbers printed</indexterm></cindex>
+<anchor name="sectioning-tocdepth">sectioning tocdepth</anchor>
+<anchor name="Sectioning_002ftocdepth">Sectioning/tocdepth</anchor>
+<para>Controls which sectioning units are listed in the table of contents.
+The setting <code>\setcounter&lbrace;tocdepth&rbrace;&lbrace;<var>level</var>&rbrace;</code> makes the
+sectioning units at <var>level</var> be the smallest ones listed
+(<pxref label="_005csetcounter"><xrefnodename>\setcounter</xrefnodename></pxref>). See the above table for the level numbers. For
+instance, if <code>tocdepth</code> is&nbsp;1 then the table of contents will
+list sections but not subsections. &latex;&textrsquo;s default
+<code>secnumdepth</code> is&nbsp;3 in <file>article</file> class and &nbsp;2 in the
+<file>book</file> and <file>report</file> classes.
+</para>
+</tableitem></tableentry></ftable>
+
+<menu endspaces=" ">
+<menuentry leadingtext="* "><menunode separator=":: ">\part</menunode><menudescription><pre xml:space="preserve">Start a part.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\chapter</menunode><menudescription><pre xml:space="preserve">Start a chapter.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\section</menunode><menudescription><pre xml:space="preserve">Start a section.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\subsection</menunode><menudescription><pre xml:space="preserve">Start a subsection.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\subsubsection &amp; \paragraph &amp; \subparagraph</menunode><menudescription><pre xml:space="preserve">Lower divisions.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\appendix</menunode><menudescription><pre xml:space="preserve">Start appendices.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\frontmatter &amp; \mainmatter &amp; \backmatter</menunode><menudescription><pre xml:space="preserve">The three parts of a book.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\&arobase;startsection</menunode><menudescription><pre xml:space="preserve">Layout of sectional units.
+</pre></menudescription></menuentry></menu>
-<para>All sectioning commands take the same general form, e.g.,
+
+<node name="_005cpart" spaces=" "><nodename>\part</nodename><nodenext automatic="on">\chapter</nodenext><nodeup automatic="on">Sectioning</nodeup></node>
+<section spaces=" "><sectiontitle><code>\part</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="241" mergedindex="cp">\part</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="172">part</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="173">sectioning, part</indexterm></cindex>
+
+<para>Synopsis, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\chapter[<var>toctitle</var>]&lbrace;<var>title</var>&rbrace;
+<pre xml:space="preserve">\part&lbrace;<var>title</var>&rbrace;
+\part*&lbrace;<var>title</var>&rbrace;
+\part[<var>toc-title</var>]&lbrace;<var>title</var>&rbrace;
</pre></example>
-<para>In addition to providing the heading <var>title</var> in the main text, the
-section title can appear in two other places:
+<para>Start a document part. The standard &latex; classes <code>book</code>,
+<code>report</code>, and <code>article</code>, all have this command.
</para>
-<enumerate first="1" endspaces=" ">
-<listitem>
-<para>The table of contents.
-</para></listitem><listitem>
-<para>The running head at the top of the page.
-</para></listitem></enumerate>
+<para>This produces a document part, in a book.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\part&lbrace;VOLUME I \\
+ PERSONAL MEMOIRS OF U.\ S.\ GRANT&rbrace;
+\chapter&lbrace;ANCESTRY--BIRTH--BOYHOOD.&rbrace;
+My family is American, and has been for generations,
+in all its branches, direct and collateral.
+</pre></example>
-<para>You may not want the same text in these places as in the main text.
-To handle this, the sectioning commands have an optional argument
-<var>toctitle</var> that, when given, specifies the text for these other
-places.
+<para>In each standard class the <code>\part</code> command outputs a part number
+such as <samp>Part I</samp>, alone on its line, in boldface, and in large
+type. Then &latex; outputs <var>title</var>, also alone on its line, in
+bold and in even larger type. In class <code>book</code>, the &latex;
+default puts each part alone on its own page. If the book is two-sided
+then &latex; will skip a page if needed to have the new part on an
+odd-numbered page. In <code>report</code> it is again alone on a page, but
+&latex; won&textrsquo;t force it onto an odd-numbered page. In an <code>article</code>
+&latex; does not put it on a fresh page, but instead outputs the part
+number and part title onto the main document page.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="159"><code>*</code>-form of sectioning commands</indexterm></cindex>
-<para>Also, all sectioning commands have <code>*</code>-forms that print
-<var>title</var> as usual, but do not include a number and do not make an
-entry in the table of contents. For instance:
+<para>The <code>*</code>&nbsp;form shows <var>title</var>
+but it does not show the part number, does not increment the
+<code>part</code> counter, and produces no table of contents entry.
+</para>
+<para>The optional argument <var>toc-title</var> will appear as the part title in
+the table of contents (<pxref label="Table-of-contents-etc_002e"><xrefnodename>Table of contents etc.</xrefnodename></pxref>) and in running
+headers (<pxref label="Page-styles"><xrefnodename>Page styles</xrefnodename></pxref>). If it is not present then <var>title</var>
+will be there. This example puts a line break in <var>title</var> but leaves
+out the break in the table of contents.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\section*&lbrace;Preamble&rbrace;
+<pre xml:space="preserve">\part[Up from the bottom; my life]&lbrace;Up from the bottom\\ my life&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="239">\appendix</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="160">appendix, creating</indexterm></cindex>
-<para>The <code>\appendix</code> command changes the way following sectional units
-are numbered. The <code>\appendix</code> command itself generates no text
-and does not affect the numbering of parts. The normal use of this
-command is something like
+<para>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a part is&nbsp;-1
+(<pxref label="Sectioning_002fsecnumdepth"><xrefnodename>Sectioning/secnumdepth</xrefnodename></pxref> and <pxref label="Sectioning_002ftocdepth"><xrefnodename>Sectioning/tocdepth</xrefnodename></pxref>).
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="174"><r>package</r>, <code>indentfirst</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="175"><code>indentfirst</code> <r>package</r></indexterm></cindex>
+
+<para>In the class <code>article</code>, if a paragraph immediately follows the part
+title then it is not indented. To get an indent you can use the package
+<file>indentfirst</file>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="176"><r>package</r>, <code>titlesec</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="177"><code>titlesec</code> <r>package</r></indexterm></cindex>
+
+<para>One package to change the behavior of <code>\part</code> is <file>titlesec</file>.
+See its documentation on CTAN.
+</para>
+
+</section>
+<node name="_005cchapter" spaces=" "><nodename>\chapter</nodename><nodenext automatic="on">\section</nodenext><nodeprev automatic="on">\part</nodeprev><nodeup automatic="on">Sectioning</nodeup></node>
+<section spaces=" "><sectiontitle><code>\chapter</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="242" mergedindex="cp">\chapter</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="178">chapter</indexterm></cindex>
+
+<para>Synopsis, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\chapter&lbrace;A Chapter&rbrace;
-&dots;
-\appendix
-\chapter&lbrace;The First Appendix&rbrace;
+<pre xml:space="preserve">\chapter&lbrace;<var>title</var>&rbrace;
+\chapter*&lbrace;<var>title</var>&rbrace;
+\chapter[<var>toc-title</var>]&lbrace;<var>title</var>&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="240">secnumdepth <r>counter</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="161">section numbers, printing</indexterm></cindex>
-<anchor name="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</anchor>
-<para>The <code>secnumdepth</code> counter controls printing of section numbers.
-The setting
+<para>Start a chapter. The standard &latex; classes <code>book</code> and
+<code>report</code> have this command but <code>article</code> does not.
+</para>
+<para>This produces a chapter.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\chapter&lbrace;Loomings&rbrace;
+Call me Ishmael.
+Some years ago---never mind how long precisely---having little or no
+money in my purse, and nothing particular to interest me on shore, I
+thought I would sail about a little and see the watery part of
+the world.
+</pre></example>
+
+<para>The &latex; default starts each chapter on a fresh page, an
+odd-numbered page if the document is two-sided. It produces a chapter
+number such as <samp>Chapter 1</samp> in large boldface type (the size is
+<code>\huge</code>). It then puts <var>title</var> on a fresh line, in boldface
+type that is still larger (size <code>\Huge</code>). It also increments the
+<code>chapter</code> counter, adds an entry to the table of contents
+(<pxref label="Table-of-contents-etc_002e"><xrefnodename>Table of contents etc.</xrefnodename></pxref>), and sets the running header
+information (<pxref label="Page-styles"><xrefnodename>Page styles</xrefnodename></pxref>).
+</para>
+<para>The <code>*</code>&nbsp;form shows <var>title</var> on a fresh line, in boldface.
+But it does not show the chapter number, does not increment the
+<code>chapter</code> counter, produces no table of contents entry, and does
+not affect the running header. (If you use the page style
+<code>headings</code> in a two-sided document then the header will be from the
+prior chapter.) This example illustrates.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\setcounter&lbrace;secnumdepth&rbrace;&lbrace;<var>level</var>&rbrace;
+<pre xml:space="preserve">\chapter*&lbrace;Preamble&rbrace;
+</pre></example>
+
+<para>The optional argument <var>toc-title</var> will appear as the chapter title
+in the table of contents (<pxref label="Table-of-contents-etc_002e"><xrefnodename>Table of contents etc.</xrefnodename></pxref>) and in
+running headers (<pxref label="Page-styles"><xrefnodename>Page styles</xrefnodename></pxref>). If it is not present then
+<var>title</var> will be there. This shows the full name in the chapter
+title,
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\chapter[Weyl]&lbrace;Hermann Klaus Hugo (Peter) Weyl (1885--1955)&rbrace;
</pre></example>
<noindent></noindent>
-<para>suppresses heading numbers at any depth <math>&gt; <var>level</var></math>, where
-<code>chapter</code> is level zero. The default <code>secnumdepth</code> is 3 in
-&latex;&textrsquo;s <file>article</file> class and 2 in the <file>book</file> and
-<file>report</file> classes. (<xref label="_005csetcounter"><xrefnodename>\setcounter</xrefnodename></xref>.)
+<para>but only <samp>Weyl</samp> on the contents page. This puts a line break in
+the title but that doesn&textrsquo;t work well with running headers so it omits
+the break in the contents
</para>
-<menu endspaces=" ">
-<menuentry leadingtext="* "><menunode separator=":: ">\&arobase;startsection</menunode><menudescription><pre xml:space="preserve">Redefine layout of start of sections, subsections, etc.
-</pre></menudescription></menuentry></menu>
+<example endspaces=" ">
+<pre xml:space="preserve">\chapter[Given it all\\ my story]&lbrace;Given it all\\ my story&rbrace;
+</pre></example>
+
+<para>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a chapter is&nbsp;0
+(<pxref label="Sectioning_002fsecnumdepth"><xrefnodename>Sectioning/secnumdepth</xrefnodename></pxref> and <pxref label="Sectioning_002ftocdepth"><xrefnodename>Sectioning/tocdepth</xrefnodename></pxref>).
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="179"><r>package</r>, <code>indentfirst</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="180"><code>indentfirst</code> <r>package</r></indexterm></cindex>
+
+<para>The paragraph that follows the chapter title is not indented, as is a
+standard typographical practice. To get an indent use the package
+<file>indentfirst</file>.
+</para>
+<para>You can change what is shown for the chapter number. To change it to
+something like <samp>Lecture 1</samp>, put in the preamble either
+<code>\renewcommand&lbrace;\chaptername&rbrace;&lbrace;Lecture&rbrace;</code> or this
+(<pxref label="_005cmakeatletter-_0026-_005cmakeatother"><xrefnodename>\makeatletter &amp; \makeatother</xrefnodename></pxref>).
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\makeatletter
+\renewcommand&lbrace;\&arobase;chapapp&rbrace;&lbrace;Lecture&rbrace;
+\makeatother
+</pre></example>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="181"><r>package</r>, <code>babel</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="182"><code>babel</code> <r>package</r></indexterm></cindex>
+
+<noindent></noindent> <para>To make this change because of the primary language for
+the document, see the package <file>babel</file>.
+</para>
+<para>In a two-sided document &latex; puts a chapter on odd-numbered page, if
+necessary leaving an even-numbered page that is blank except for any
+running headers. To make that page completely blank,
+see&nbsp;<ref label="_005cclearpage-_0026-_005ccleardoublepage"><xrefnodename>\clearpage &amp; \cleardoublepage</xrefnodename></ref>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="183"><r>package</r>, <code>titlesec</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="184"><code>titlesec</code> <r>package</r></indexterm></cindex>
+
+<para>To change the behavior of the <code>\chapter</code> command, you can copy its
+definition from the &latex; format file and make adjustments. But
+there are also many packages on CTAN that address this. One is
+<file>titlesec</file>. See its documentation, but the example below gives a
+sense of what it can do.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\usepackage&lbrace;titlesec&rbrace; % in preamble
+\titleformat&lbrace;\chapter&rbrace;
+ &lbrace;\Huge\bfseries&rbrace; % format of title
+ &lbrace;&rbrace; % label, such as 1.2 for a subsection
+ &lbrace;0pt&rbrace; % length of separation between label and title
+ &lbrace;&rbrace; % before-code hook
+</pre></example>
+
+<noindent></noindent>
+<para>This omits the chapter number <samp>Chapter 1</samp> from the page but unlike
+<code>\chapter*</code> it keeps the chapter in the table of contents and the
+running headers.
+</para>
+
+</section>
+<node name="_005csection" spaces=" "><nodename>\section</nodename><nodenext automatic="on">\subsection</nodenext><nodeprev automatic="on">\chapter</nodeprev><nodeup automatic="on">Sectioning</nodeup></node>
+<section spaces=" "><sectiontitle><code>\section</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="243" mergedindex="cp">\section</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="185">section</indexterm></cindex>
+
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\section&lbrace;<var>title</var>&rbrace;
+\section*&lbrace;<var>title</var>&rbrace;
+\section[<var>toc-title</var>]&lbrace;<var>title</var>&rbrace;
+</pre></example>
+
+<para>Start a section. The standard &latex; classes <code>article</code>,
+<code>book</code>, and <code>report</code> all have this command.
+</para>
+<para>This produces a section.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">In this Part we tend to be more interested in the function,
+in the input-output behavior,
+than in the details of implementing that behavior.
+
+\section&lbrace;Turing machines&rbrace;
+Despite this desire to downplay implementation,
+we follow the approach of A~Turing that the
+first step toward defining the set of computable functions
+is to reflect on the details of what mechanisms can do.
+</pre></example>
+
+<para>For the standard &latex; classes <code>book</code> and <code>report</code> the
+default output is like <samp>1.2 <var>title</var></samp> (for chapter&nbsp;1,
+section&nbsp;2), alone on its line and flush left, in boldface and a
+larger type (the type size is <code>\Large</code>). The same holds in
+<code>article</code> except that there are no chapters in that class so it
+looks like <samp>2 <var>title</var></samp>.
+</para>
+<para>The <code>*</code>&nbsp;form shows <var>title</var>.
+But it does not show the section number, does not increment the
+<code>section</code> counter, produces no table of contents entry, and does
+not affect the running header. (If you use the page style
+<code>headings</code> in a two-sided document then the header will be from the
+prior section.)
+</para>
+<para>The optional argument <var>toc-title</var> will appear as the section title
+in the table of contents (<pxref label="Table-of-contents-etc_002e"><xrefnodename>Table of contents etc.</xrefnodename></pxref>) and in
+running headers (<pxref label="Page-styles"><xrefnodename>Page styles</xrefnodename></pxref>). If it is not present then
+<var>title</var> will be there. This shows the full name in the title of the
+section,
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\section[Elizabeth~II]&lbrace;Elizabeth the Second,
+ by the Grace of God of the United Kingdom,
+ Canada and Her other Realms and Territories Queen,
+ Head of the Commonwealth, Defender of the Faith.&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>but only <samp>Elizabeth II</samp> on the contents page and in the headers.
+This has a line break in <var>title</var> but that does not work with headers
+so it is omitted from the contents and headers.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\section[Truth is, I cheated; my life story]&lbrace;Truth is,
+ I cheated\\my life story&rbrace;
+</pre></example>
+
+<para>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a section is&nbsp;1
+(<pxref label="Sectioning_002fsecnumdepth"><xrefnodename>Sectioning/secnumdepth</xrefnodename></pxref> and <pxref label="Sectioning_002ftocdepth"><xrefnodename>Sectioning/tocdepth</xrefnodename></pxref>).
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="186"><r>package</r>, <code>indentfirst</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="187"><code>indentfirst</code> <r>package</r></indexterm></cindex>
+
+<para>The paragraph that follows the section title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package <file>indentfirst</file>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="188"><r>package</r>, <code>titlesec</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="189"><code>titlesec</code> <r>package</r></indexterm></cindex>
+
+<para>In general, to change the behavior of the <code>\section</code> command, there
+are a number of options. One is the <code>\&arobase;startsection</code> command
+(<pxref label="_005c_0040startsection"><xrefnodename>\&arobase;startsection</xrefnodename></pxref>). There are also many packages on CTAN that
+address this, including <file>titlesec</file>. See the documentation but the
+example below gives a sense of what they can do.
+</para>
+<!-- c credit: egreg https://groups.google.com/forum/#!topic/comp.text.tex/tvc8oM5P4y4 -->
+<example endspaces=" ">
+<pre xml:space="preserve">\usepackage&lbrace;titlesec&rbrace; % in preamble
+\titleformat&lbrace;\section&rbrace;
+ &lbrace;\normalfont\Large\bfseries&rbrace; % format of title
+ &lbrace;\makebox[1pc][r]&lbrace;\thesection\hspace&lbrace;1pc&rbrace;&rbrace;&rbrace; % label
+ &lbrace;0pt&rbrace; % length of separation between label and title
+ &lbrace;&rbrace; % before-code hook
+\titlespacing*&lbrace;\section&rbrace;
+ &lbrace;-1pc&rbrace;&lbrace;18pt&rbrace;&lbrace;10pt&rbrace;[10pc]
+</pre></example>
+
+<noindent></noindent>
+<para>That puts the section number in the margin.
+</para>
+
+</section>
+<node name="_005csubsection" spaces=" "><nodename>\subsection</nodename><nodenext automatic="on">\subsubsection &amp; \paragraph &amp; \subparagraph</nodenext><nodeprev automatic="on">\section</nodeprev><nodeup automatic="on">Sectioning</nodeup></node>
+<section spaces=" "><sectiontitle><code>\subsection</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="244" mergedindex="cp">\subsection</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="190">subsection</indexterm></cindex>
+
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\subsection&lbrace;<var>title</var>&rbrace;
+\subsection*&lbrace;<var>title</var>&rbrace;
+\subsection[<var>toc-title</var>]&lbrace;<var>title</var>&rbrace;
+</pre></example>
+
+<para>Start a subsection. The standard &latex; classes <code>article</code>,
+<code>book</code>, and <code>report</code> all have this command.
+</para>
+<para>This produces a subsection.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">We will show that there are more functions than Turing machines and that
+therefore some functions have no associated machine.
+
+\subsection&lbrace;Cardinality&rbrace; We will begin with two paradoxes that
+dramatize the challenge to our intuition posed by comparing the sizes of
+infinite sets.
+</pre></example>
+
+<para>For the standard &latex; classes <code>book</code> and <code>report</code> the
+default output is like <samp>1.2.3 <var>title</var></samp> (for chapter&nbsp;1,
+section&nbsp;2, subsection&nbsp;3), alone on its line and flush left, in
+boldface and a larger type (the type size is <code>\large</code>). The same
+holds in <code>article</code> except that there are no chapters in that class
+so it looks like <samp>2.3 <var>title</var></samp>.
+</para>
+<para>The <code>*</code>&nbsp;form shows <var>title</var>.
+But it does not show the section number, does not increment the
+<code>section</code> counter, and produces no table of contents entry.
+</para>
+<para>The optional argument <var>toc-title</var> will appear as the section title
+in the table of contents (<pxref label="Table-of-contents-etc_002e"><xrefnodename>Table of contents etc.</xrefnodename></pxref>). If it is
+not present then <var>title</var> will be there. This shows the full name in
+the title of the section,
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\subsection[$\alpha,\beta,\gamma$ paper]&lbrace;\textit&lbrace;The Origin of
+ Chemical Elements&rbrace; by R.A.~Alpher, H.~Bethe, and G.~Gamow&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>but only <samp><U>03B1</U>,<U>03B2</U>,<U>03B3</U>
+paper</samp> on the contents page.
+</para>
+<para>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a subsection is&nbsp;2
+(<pxref label="Sectioning_002fsecnumdepth"><xrefnodename>Sectioning/secnumdepth</xrefnodename></pxref> and <pxref label="Sectioning_002ftocdepth"><xrefnodename>Sectioning/tocdepth</xrefnodename></pxref>).
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="191"><r>package</r>, <code>indentfirst</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="192"><code>indentfirst</code> <r>package</r></indexterm></cindex>
+
+<para>The paragraph that follows the subsection title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package <file>indentfirst</file>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="193"><r>package</r>, <code>titlesec</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="194"><code>titlesec</code> <r>package</r></indexterm></cindex>
+
+<para>There are a number of ways to change the behavior of the
+<code>\subsection</code> command. One is the <code>\&arobase;startsection</code> command
+(<pxref label="_005c_0040startsection"><xrefnodename>\&arobase;startsection</xrefnodename></pxref>). There are also many packages on CTAN that
+address this, including <file>titlesec</file>. See the documentation but the
+example below gives a sense of what they can do.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\usepackage&lbrace;titlesec&rbrace; % in preamble
+\titleformat&lbrace;\subsection&rbrace;[runin]
+ &lbrace;\normalfont\normalsize\bfseries&rbrace; % format of the title
+ &lbrace;\thesubsection&rbrace; % label
+ &lbrace;0.6em&rbrace; % space between label and title
+ &lbrace;&rbrace; % before-code hook
+</pre></example>
+
+<noindent></noindent>
+<para>That puts the subsection number and <var>title</var> in the first line of
+text.
+</para>
+
+</section>
+<node name="_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph" spaces=" "><nodename>\subsubsection &amp; \paragraph &amp; \subparagraph</nodename><nodenext automatic="on">\appendix</nodenext><nodeprev automatic="on">\subsection</nodeprev><nodeup automatic="on">Sectioning</nodeup></node>
+
+<section spaces=" "><sectiontitle><code>\subsubsection</code>, <code>\paragraph</code>, <code>\subparagraph</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="245" mergedindex="cp">\subsubsection</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="195">subsubsection</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="246" mergedindex="cp">\paragraph</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="196">paragraph</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="247" mergedindex="cp">\subparagraph</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="197">subparagraph</indexterm></cindex>
+
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\subsubsection&lbrace;<var>title</var>&rbrace;
+\subsubsection*&lbrace;<var>title</var>&rbrace;
+\subsubsection[<var>toc-title</var>]&lbrace;<var>title</var>&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>or one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\paragraph&lbrace;<var>title</var>&rbrace;
+\paragraph*&lbrace;<var>title</var>&rbrace;
+\paragraph[<var>toc-title</var>]&lbrace;<var>title</var>&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>or one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\subparagraph&lbrace;<var>title</var>&rbrace;
+\subparagraph*&lbrace;<var>title</var>&rbrace;
+\subparagraph[<var>toc-title</var>]&lbrace;<var>title</var>&rbrace;
+</pre></example>
+<para>Start a subsubsection, paragraph, or subparagraph. The standard
+&latex; classes <code>article</code>, <code>book</code>, and <code>report</code> all have
+these commands, although they are not commonly used.
+</para>
+<para>This produces a subsubsection.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\subsubsection&lbrace;Piston ring compressors: structural performance&rbrace;
+Provide exterior/interior wall cladding assemblies
+capable of withstanding the effects of load and stresses from
+consumer-grade gasoline engine piston rings.
+</pre></example>
+
+<para>The default output of each of the three does not change over the
+standard &latex; classes <code>article</code>, <code>book</code>, and
+<code>report</code>. For <code>\subsubsection</code> the <var>title</var> is alone on
+its line, in boldface and normal size type. For <code>\paragraph</code> the
+<var>title</var> is inline with the text, not indented, in boldface and
+normal size type. For <code>\subparagraph</code> the <var>title</var> is inline
+with the text, with a paragraph indent, in boldface and normal size type
+(Because an <code>article</code> has no chapters its subsubsections are
+numbered and so it looks like <samp>1.2.3 <var>title</var></samp>, for
+section&nbsp;1, subsection&nbsp;2, and subsubsection&nbsp;3. The other
+two divisions are not numbered.)
+</para>
+<para>The <code>*</code>&nbsp;form shows <var>title</var>. But it does not increment the
+associated counter and produces no table of contents entry (and does not
+show the number for <code>\subsubsection</code>).
+</para>
+<para>The optional argument <var>toc-title</var> will appear as the division title
+in the table of contents (<pxref label="Table-of-contents-etc_002e"><xrefnodename>Table of contents etc.</xrefnodename></pxref>). If it is
+not present then <var>title</var> will be there.
+</para>
+<para>For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a subsubsection is&nbsp;3, of
+a paragraph is&nbsp;4, and of a subparagraph is&nbsp;5
+(<pxref label="Sectioning_002fsecnumdepth"><xrefnodename>Sectioning/secnumdepth</xrefnodename></pxref> and <pxref label="Sectioning_002ftocdepth"><xrefnodename>Sectioning/tocdepth</xrefnodename></pxref>).
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="198"><r>package</r>, <code>indentfirst</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="199"><code>indentfirst</code> <r>package</r></indexterm></cindex>
+
+<para>The paragraph that follows the subsubsection title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package <file>indentfirst</file>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="200"><r>package</r>, <code>titlesec</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="201"><code>titlesec</code> <r>package</r></indexterm></cindex>
-<node name="_005c_0040startsection" spaces=" "><nodename>\&arobase;startsection</nodename><nodeup automatic="on">Sectioning</nodeup></node>
+<para>There are a number of ways to change the behavior of the these commands.
+One is the <code>\&arobase;startsection</code> command (<pxref label="_005c_0040startsection"><xrefnodename>\&arobase;startsection</xrefnodename></pxref>).
+There are also many packages on CTAN that address this, including
+<file>titlesec</file>. See the documentation on CTAN.
+</para>
+
+</section>
+<node name="_005cappendix" spaces=" "><nodename>\appendix</nodename><nodenext automatic="on">\frontmatter &amp; \mainmatter &amp; \backmatter</nodenext><nodeprev automatic="on">\subsubsection &amp; \paragraph &amp; \subparagraph</nodeprev><nodeup automatic="on">Sectioning</nodeup></node>
+
+<section spaces=" "><sectiontitle><code>\appendix</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="248" mergedindex="cp">\appendix</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="202">appendix</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="203">appendices</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\appendix
+</pre></example>
+
+<para>This does not directly produce any output. But in a book or report it
+declares that subsequent <code>\chapter</code> commands start an appendix. In
+an article it does the same, for <code>\section</code> commands. It also
+resets the <code>chapter</code> and <code>section</code> counters to&nbsp;0 in a
+book or report, and in an article resets the <code>section</code> and
+<code>subsection</code> counters.
+</para>
+<para>In this book
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\chapter&lbrace;One&rbrace; ...
+\chapter&lbrace;Two&rbrace; ...
+ ...
+\appendix
+\chapter&lbrace;Three&rbrace; ...
+\chapter&lbrace;Four&rbrace; ...
+</pre></example>
+
+<noindent></noindent>
+<para>the first two will generate output numbered <samp>Chapter 1</samp> and
+<samp>Chapter 2</samp>. After the <code>\appendix</code> the numbering will be
+<samp>Appendix A</samp> and <samp>Appendix B</samp>. <xref label="Larger-book-template"><xrefnodename>Larger book template</xrefnodename></xref>
+for another example.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="204"><r>package</r>, <code>appendix</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="205"><code>appendix</code> <r>package</r></indexterm></cindex>
+ <para>The <file>appendix</file> package adds the command
+<code>\appendixpage</code> to put a separate <samp>Appendices</samp> in the document
+body before the first appendix, and the command <code>\addappheadtotoc</code>
+to do the same in the table of contents. You can reset the name
+<samp>Appendix</samp> with a command like
+<code>\renewcommand&lbrace;\appendixname&rbrace;&lbrace;Specification&rbrace;</code>, as well as a
+number of other features. See the documentation on CTAN.
+</para>
+
+</section>
+<node name="_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter" spaces=" "><nodename>\frontmatter &amp; \mainmatter &amp; \backmatter</nodename><nodenext automatic="on">\&arobase;startsection</nodenext><nodeprev automatic="on">\appendix</nodeprev><nodeup automatic="on">Sectioning</nodeup></node>
+
+<section spaces=" "><sectiontitle><code>\frontmatter</code>, <code>\mainmatter</code>, <code>\backmatter</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="249" mergedindex="cp">\frontmatter</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="206">book, front matter</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="250" mergedindex="cp">\mainmatter</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="207">book, main matter</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="251" mergedindex="cp">\backmatter</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="208">book, back matter</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="209">book, end matter</indexterm></cindex>
+
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\frontmatter
+\mainmatter
+\backmatter
+</pre></example>
+
+<para>Format a <code>book</code> class document differently according to which part
+of the document is being produced. All three commands are optional.
+</para>
+<para>Traditionally, a book&textrsquo;s front matter contains such things as the title
+page, an abstract, a table of contents, a preface, a list of notations,
+a list of figures, and a list of tables. (Some of these front matter
+pages, such as the title page, are traditionally not numbered.) The
+back matter may contain such things as a glossary, notes, a
+bibliography, and an index.
+</para>
+<para>The <code>\frontmatter</code> declaration makes the pages numbered in
+lowercase roman, and makes chapters not numbered, although each
+chapter&textrsquo;s title appears in the table of contents; if you use other
+sectioning commands here, use the <code>*</code>-version (<pxref label="Sectioning"><xrefnodename>Sectioning</xrefnodename></pxref>).
+The <code>\mainmatter</code> changes the behavior back to the expected
+version, and resets the page number. The <code>\backmatter</code> leaves the
+page numbering alone but switches the chapters back to being not
+numbered. <xref label="Larger-book-template"><xrefnodename>Larger book template</xrefnodename></xref> for an example using the three.
+</para>
+
+</section>
+<node name="_005c_0040startsection" spaces=" "><nodename>\&arobase;startsection</nodename><nodeprev automatic="on">\frontmatter &amp; \mainmatter &amp; \backmatter</nodeprev><nodeup automatic="on">Sectioning</nodeup></node>
<section spaces=" "><sectiontitle><code>\&arobase;startsection</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="241">\&arobase;startsection</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="162">section, redefining</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="252" mergedindex="cp">\&arobase;startsection</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="210">section, redefining</indexterm></cindex>
<para>Synopsis:
</para>
@@ -2641,14 +3399,30 @@ make such a command you may want to use the <code>\secdef</code> command.
<!-- c xx define, and make a cross reference to, secdef. -->
</para>
<para>Technically, <code>\&arobase;startsection</code> has the form
-</para><example endspaces=" ">
-<pre xml:space="preserve">\&arobase;startsection&lbrace;<var>name</var>&rbrace;&lbrace;<var>level</var>&rbrace;&lbrace;<var>indent</var>&rbrace;&lbrace;<var>beforeskip</var>&rbrace;&lbrace;<var>afterskip</var>&rbrace;&lbrace;<var>style</var>&rbrace;*[<var>toctitle</var>]&lbrace;<var>title</var>&rbrace;
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\&arobase;startsection&lbrace;<var>name</var>&rbrace;
+ &lbrace;<var>level</var>&rbrace;
+ &lbrace;<var>indent</var>&rbrace;
+ &lbrace;<var>beforeskip</var>&rbrace;
+ &lbrace;<var>afterskip</var>&rbrace;
+ &lbrace;<var>style</var>&rbrace;*[<var>toctitle</var>]&lbrace;<var>title</var>&rbrace;
</pre></example>
-<noindent></noindent> <para>(the star&nbsp;<code>*</code> is optional), so that issuing
-</para><example endspaces=" ">
-<pre xml:space="preserve">\renewcommand&lbrace;\section&rbrace;&lbrace;\&arobase;startsection&lbrace;<var>name</var>&rbrace;&lbrace;<var>level</var>&rbrace;&lbrace;<var>indent</var>&rbrace;&lbrace;<var>beforeskip</var>&rbrace;&lbrace;<var>afterskip</var>&rbrace;&lbrace;<var>style</var>&rbrace;&rbrace;
+
+<noindent></noindent>
+<para>so that issuing
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\renewcommand&lbrace;\section&rbrace;&lbrace;\&arobase;startsection&lbrace;<var>name</var>&rbrace;
+ &lbrace;<var>level</var>&rbrace;
+ &lbrace;<var>indent</var>&rbrace;
+ &lbrace;<var>beforeskip</var>&rbrace;
+ &lbrace;<var>afterskip</var>&rbrace;
+ &lbrace;<var>style</var>&rbrace;&rbrace;
</pre></example>
-<noindent></noindent> <para>redefines <code>\section</code> to have the form
+
+<noindent></noindent>
+<para>redefines <code>\section</code> to have the form
<code>\section*[<var>toctitle</var>]&lbrace;<var>title</var>&rbrace;</code> (here too, the
star&nbsp;<code>*</code> is optional). <xref label="Sectioning"><xrefnodename>Sectioning</xrefnodename></xref>. This implies that
when you write a command like <code>\renewcommand&lbrace;section&rbrace;&lbrace;...&rbrace;</code>,
@@ -2658,55 +3432,56 @@ the examples below.
<table commandarg="var" spaces=" " endspaces=" ">
<beforefirstitem>
</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="var">name</itemformat></item>
-</tableterm><tableitem><anchor name="_005c_0040startsection_002fname">\&arobase;startsection/name</anchor> <para>Name of the counter used to number the
-sectioning header. This counter must be defined separately. Most
-commonly this is either <code>section</code>, <code>subsection</code>, or
-<code>paragraph</code>. Although in those three cases the counter name is the
-same as the sectioning command itself, using the same name is not
-required.
+</tableterm><tableitem><anchor name="startsection-name">startsection name</anchor>
+<anchor name="_005c_0040startsection_002fname">\&arobase;startsection/name</anchor>
+<para>Name of the counter used to number the sectioning header. This counter
+must be defined separately. Most commonly this is either
+<code>section</code>, <code>subsection</code>, or <code>paragraph</code>. Although in
+those cases the counter name is the same as the sectioning command
+itself, you don&textrsquo;t have to use the same name.
</para>
<para>Then <code>\the</code><var>name</var> displays the title number and
<code>\</code><var>name</var><code>mark</code> is for the page headers. See the third
example below.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">level</itemformat></item>
-</tableterm><tableitem><anchor name="_005c_0040startsection_002flevel">\&arobase;startsection/level</anchor> <para>An integer giving the depth of the
-sectioning command: 0 for <code>chapter</code> (only applies to the standard
-<code>book</code> and <code>report</code> classes), 1 for <code>section</code>, 2 for
-<code>subsection</code>, 3 for <code>subsubsection</code>, 4 for <code>paragraph</code>,
-and 5 for <code>subparagraph</code>. In the <code>book</code> and <code>report</code>
-classes <code>part</code> has level -1, while in the <code>article</code> class
-<code>part</code> has level 0.
-</para>
-<para>If <var>level</var> is less than or equal to the value of <code>secnumdepth</code>
-then the titles for this sectioning command will be numbered. For
-instance, in an <code>article</code>, if <code>secnumdepth</code> is 1 then a
-<code>\section&lbrace;Introduction&rbrace;</code> command will produce output like &textldquo;1
+</tableterm><tableitem><anchor name="startsection-level">startsection level</anchor>
+<anchor name="_005c_0040startsection_002flevel">\&arobase;startsection/level</anchor>
+<para>An integer giving the depth of the sectioning command.
+<xref label="Sectioning"><xrefnodename>Sectioning</xrefnodename></xref> for the list of standard level numbers.
+</para>
+<para>If <var>level</var> is less than or equal to the value of the counter
+<code>secnumdepth</code> then titles for this sectioning command will be
+numbered (<pxref label="Sectioning_002fsecnumdepth"><xrefnodename>Sectioning/secnumdepth</xrefnodename></pxref>). For instance, if
+<code>secnumdepth</code> is 1 in an <code>article</code> then the command
+<code>\section&lbrace;Introduction&rbrace;</code> will produce output like &textldquo;1
Introduction&textrdquo; while <code>\subsection&lbrace;Discussion&rbrace;</code> will produce
output like &textldquo;Discussion&textrdquo;, without the number prefix.
-<xref label="Sectioning_002fsecnumdepth"><xrefnodename>Sectioning/secnumdepth</xrefnodename></xref>.
</para>
-<para>If <var>level</var> is less than or equal to the value of <var>tocdepth</var> then
-the table of contents will have an entry for this sectioning unit.
-For instance, in an <code>article</code>, if <var>tocdepth</var> is 1 then the table of
-contents will list sections but not subsections.
-<!-- c xx add, and cross reference to, tocdepth -->
+<para>If <var>level</var> is less than or equal to the value of the counter
+<var>tocdepth</var> then the table of contents will have an entry for this
+sectioning unit (<pxref label="Sectioning_002ftocdepth"><xrefnodename>Sectioning/tocdepth</xrefnodename></pxref>). For instance, in an
+<code>article</code>, if <var>tocdepth</var> is 1 then the table of contents will
+list sections but not subsections.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">indent</itemformat></item>
-</tableterm><tableitem><anchor name="_005c_0040startsection_002findent">\&arobase;startsection/indent</anchor> <para>A length giving the indentation of all
-of the title lines with respect to the left margin. To have the title
-flush with the margin use <code>0pt</code>. A negative indentation such as
-<code>-\parindent</code> will move the title into the left margin.
+</tableterm><tableitem><anchor name="startsection-indent">startsection indent</anchor>
+<anchor name="_005c_0040startsection_002findent">\&arobase;startsection/indent</anchor>
+<para>A length giving the indentation of all of the title lines with respect
+to the left margin. To have the title flush with the margin use
+<code>0pt</code>. A negative indentation such as <code>-\parindent</code> will move
+the title into the left margin.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">beforeskip</itemformat></item>
-</tableterm><tableitem><anchor name="_005c_0040startsection_002fbeforeskip">\&arobase;startsection/beforeskip</anchor> <para>The absolute value of this length is
-the amount of vertical space that is inserted before this sectioning
-unit&textrsquo;s title. This space will be discarded if the sectioning unit
-happens to start at the top of a fresh page. If this number is negative
-then the first paragraph following the header is not indented, if it is
-non-negative then the first paragraph is indented. (Note that the
-negative of <code>1pt plus 2pt minus 3pt</code> is <code>-1pt plus -2pt minus
--3pt</code>.)
+</tableterm><tableitem><anchor name="startsection-beforeskip">startsection beforeskip</anchor>
+<anchor name="_005c_0040startsection_002fbeforeskip">\&arobase;startsection/beforeskip</anchor>
+<para>The absolute value of this length is the amount of vertical space that
+is inserted before this sectioning unit&textrsquo;s title. This space will be
+discarded if the sectioning unit happens to start at the top of a fresh
+page. If this number is negative then the first paragraph following the
+header is not indented, if it is non-negative then the first paragraph
+is indented. (Note that the negative of <code>1pt plus 2pt minus 3pt</code>
+is <code>-1pt plus -2pt minus -3pt</code>.)
</para>
<para>For example, if <var>beforeskip</var> is <code>-3.5ex plus -1ex minus -0.2ex</code>
then to start the new sectioning unit, &latex; will add about 3.5 times
@@ -2726,14 +3501,15 @@ where &latex; would put the baseline of the first text line on that
page.)
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">afterskip</itemformat></item>
-</tableterm><tableitem><anchor name="_005c_0040startsection_002fafterskip">\&arobase;startsection/afterskip</anchor> <para>This is a length. If <var>afterskip</var>
-is non-negative then this is the vertical space inserted after the
-sectioning unit&textrsquo;s title header. If it is negative then the title header
-becomes a run-in header, so that it becomes part of the next paragraph.
-In this case the absolute value of the length gives the horizontal space
-between the end of the title and the beginning of the following
-paragraph. (Note that the negative of <code>1pt plus 2pt minus 3pt</code> is
-<code>-1pt plus -2pt minus -3pt</code>.)
+</tableterm><tableitem><anchor name="startsection-afterskip">startsection afterskip</anchor>
+<anchor name="_005c_0040startsection_002fafterskip">\&arobase;startsection/afterskip</anchor>
+<para>This is a length. If <var>afterskip</var> is non-negative then this is the
+vertical space inserted after the sectioning unit&textrsquo;s title header. If it
+is negative then the title header becomes a run-in header, so that it
+becomes part of the next paragraph. In this case the absolute value of
+the length gives the horizontal space between the end of the title and
+the beginning of the following paragraph. (Note that the negative of
+<code>1pt plus 2pt minus 3pt</code> is <code>-1pt plus -2pt minus -3pt</code>.)
</para>
<para>As with <var>beforeskip</var>, using a rubber length, with <code>plus</code> and
<code>minus</code> components, is good practice here since it gives &latex;
@@ -2750,48 +3526,39 @@ header&textrsquo;s from standalone to run-in, you cannot use a negative
<code>afterskip</code> to cancel part of the <code>\parskip</code>.)
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">style</itemformat></item>
-</tableterm><tableitem><anchor name="_005c_0040startsection_002fstyle">\&arobase;startsection/style</anchor> <para>Controls the styling of the title. See
-the examples below. Typical commands to use here are <code>\centering</code>,
-<code>\raggedright</code>, <code>\normalfont</code>, <code>\hrule</code>, or
-<code>\newpage</code>. The last command in <var>style</var> may be one such as
-<code>\MakeUppercase</code> or <code>\fbox</code> that takes one argument. The
+</tableterm><tableitem><anchor name="startsection-style">startsection style</anchor>
+<anchor name="_005c_0040startsection_002fstyle">\&arobase;startsection/style</anchor>
+<para>Controls the styling of the title. See the examples below. Typical
+commands to use here are <code>\centering</code>, <code>\raggedright</code>,
+<code>\normalfont</code>, <code>\hrule</code>, or <code>\newpage</code>. The last command
+in <var>style</var> may be one that takes one argument, such as
+<code>\MakeUppercase</code> or <code>\fbox</code> that takes one argument. The
section title will be supplied as the argument to this command. For
instance, setting <var>style</var> to <code>\bfseries\MakeUppercase</code> would
-produce titles that are bold and upper case.
+produce titles that are bold and uppercase.
</para></tableitem></tableentry></table>
<para>These are &latex;&textrsquo;s defaults for the first three sectioning units that
are defined with <code>\&arobase;startsection</code>, for the <file>article</file>,
-<file>book</file>, and <file>report</file> classes.
-</para>
-<multitable spaces=" " endspaces=" "><columnfractions line=" .10 .30 .30 .30"><columnfraction value=".10"></columnfraction><columnfraction value=".30"></columnfraction><columnfraction value=".30"></columnfraction><columnfraction value=".30"></columnfraction></columnfractions>
-<thead><row><entry command="headitem" spaces=" "></entry><entry command="tab" spaces=" "><para><code>section</code> </para></entry><entry command="tab" spaces=" "><para><code>subsection</code> </para></entry><entry command="tab" spaces=" "><para><code>subsubsection</code>
-</para></entry></row></thead><tbody><row><entry command="item" spaces=" "><para><ref label="_005c_0040startsection_002fname"><xrefnodename>\&arobase;startsection/name</xrefnodename><xrefinfoname><var>name</var></xrefinfoname><xrefprinteddesc><var>name</var></xrefprinteddesc></ref>
-</para></entry><entry command="tab" spaces=" "><para>section </para></entry><entry command="tab" spaces=" "><para>subsection </para></entry><entry command="tab" spaces=" "><para>subsubsection
-</para></entry></row><row><entry command="item" spaces=" "><para><ref label="_005c_0040startsection_002flevel"><xrefnodename>\&arobase;startsection/level</xrefnodename><xrefinfoname><var>level</var></xrefinfoname><xrefprinteddesc><var>level</var></xrefprinteddesc></ref>
-</para></entry><entry command="tab" spaces=" "><para>1 </para></entry><entry command="tab" spaces=" "><para>2 </para></entry><entry command="tab" spaces=" "><para>3
-</para></entry></row><row><entry command="item" spaces=" "><para><ref label="_005c_0040startsection_002findent"><xrefnodename>\&arobase;startsection/indent</xrefnodename><xrefinfoname><var>indent</var></xrefinfoname><xrefprinteddesc><var>indent</var></xrefprinteddesc></ref>
-</para></entry><entry command="tab" spaces=" "><para><code>0pt</code> </para></entry><entry command="tab" spaces=" "><para><code>0pt</code> </para></entry><entry command="tab" spaces=" "><para><code>0pt</code>
-</para></entry></row><row><entry command="item" spaces=" "><para><ref label="_005c_0040startsection_002fbeforeskip"><xrefnodename>\&arobase;startsection/beforeskip</xrefnodename><xrefinfoname><var>beforeskip</var></xrefinfoname><xrefprinteddesc><var>beforeskip</var></xrefprinteddesc></ref>
-</para></entry><entry command="tab" spaces=" "><para><code>-3.5ex plus -1ex minus -0.2ex</code>
-</para></entry><entry command="tab" spaces=" "><para><code>-3.25ex plus -1ex minus -0.2ex</code>
-</para></entry><entry command="tab" spaces=" "><para><code>-3.25ex plus -1ex minus -0.2ex</code>
-</para></entry></row><row><entry command="item" spaces=" "><para><ref label="_005c_0040startsection_002fafterskip"><xrefnodename>\&arobase;startsection/afterskip</xrefnodename><xrefinfoname><var>afterskip</var></xrefinfoname><xrefprinteddesc><var>afterskip</var></xrefprinteddesc></ref>
-</para></entry><entry command="tab" spaces=" "><para><code>2.3ex plus 0.2ex</code>
-</para></entry><entry command="tab" spaces=" "><para><code>1.5ex plus 0.2ex</code>
-</para></entry><entry command="tab" spaces=" "><para><code>1.5ex plus 0.2ex</code>
-</para></entry></row><row><entry command="item" spaces=" "><para><ref label="_005c_0040startsection_002fstyle"><xrefnodename>\&arobase;startsection/style</xrefnodename><xrefinfoname><var>style</var></xrefinfoname><xrefprinteddesc><var>style</var></xrefprinteddesc></ref>
-</para></entry><entry command="tab" spaces=" "><para><code>\normalfont\Large\bfseries</code>
-</para></entry><entry command="tab" spaces=" "><para><code>\normalfont\large\bfseries</code>
-</para></entry><entry command="tab" spaces=" "><para><code>\normalfont\normalsize\bfseries</code>
-</para></entry></row></tbody></multitable>
-
+<file>book</file>, and <file>report</file> classes. For section, the <var>level</var> is
+1, the <var>indent</var> is 0<dmn>pt</dmn>, the <var>beforeskip</var> is <code>-3.5ex
+plus -1ex minus -0.2ex</code>, the <var>afterskip</var> is <code>2.3ex plus 0.2ex</code>,
+and the <var>style</var> is <code>\normalfont\Large\bfseries</code>. For
+subsection, the <var>level</var> is 2, the <var>indent</var> is 0<dmn>pt</dmn>, the
+<var>beforeskip</var> is <code>-3.25ex plus -1ex minus -0.2ex</code>, the
+<var>afterskip</var> is <code>1.5ex plus 0.2ex</code>, and the <var>style</var> is
+<code>\normalfont\large\bfseries</code>. For subsubsection, the <var>level</var>
+is 3, the <var>indent</var> is 0<dmn>pt</dmn>, the <var>beforeskip</var> is
+<code>-3.25ex plus -1ex minus -0.2ex</code>, the <var>afterskip</var> is
+<code>1.5ex plus 0.2ex</code>, and the <var>style</var> is
+<code>\normalfont\normalsize\bfseries</code>.
+</para>
<para>Here are examples. They go either in a package or class file or in the
preamble of a &latex; document. If you put them in the preamble they
must go between a <code>\makeatletter</code> command and a
<code>\makeatother</code>. (Probably the error message <code>You can't use
`\spacefactor' in vertical mode.</code> means that you forgot this.)
-<xref label="_005cmakeatletter-and-_005cmakeatother"><xrefnodename>\makeatletter and \makeatother</xrefnodename></xref>.
+<xref label="_005cmakeatletter-_0026-_005cmakeatother"><xrefnodename>\makeatletter &amp; \makeatother</xrefnodename></xref>.
</para>
<para>This will put section titles in large boldface type, centered. It says
<code>\renewcommand</code> because &latex;&textrsquo;s standard classes have already
@@ -2823,7 +3590,9 @@ defined a <code>\section</code>. For the same reason it does not define a
&rbrace;
</pre></example>
-<para>The prior examples redefined existing sectional unit title commands. This defines a new one, illustrating the needed counter and macros to display that counter.
+<para>The prior examples redefined existing sectional unit title commands.
+This defines a new one, illustrating the needed counter and macros to
+display that counter.
</para>
<!-- c From https://groups.google.com/forum/#!searchin/comp.text.tex/startsection%7Csort:relevance/comp.text.tex/sB-nTS-oL08/ZZeKYdG0llMJ -->
<example endspaces=" ">
@@ -2848,40 +3617,52 @@ defined a <code>\section</code>. For the same reason it does not define a
<node name="Cross-references" spaces=" "><nodename>Cross references</nodename><nodenext automatic="on">Environments</nodenext><nodeprev automatic="on">Sectioning</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Cross references</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="163">cross references</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="211">cross references</indexterm></cindex>
-<para>One reason for numbering things such as figures and equations is to
-refer the reader to them, as in &textldquo;See Figure~3 for more details.&textrdquo;
+<cindex index="cp" spaces=" "><indexterm index="cp" number="212">label</indexterm></cindex>
+<para>We often want something like <samp>See Theorem~31</samp>. But by-hand typing
+the 31 is poor practice. Instead you should write a <dfn>label</dfn> such as
+<code>\label&lbrace;eq:GreensThm&rbrace;</code> and then <dfn>reference</dfn> it, as with
+<code>See equation~\ref&lbrace;eq:GreensThm&rbrace;</code>. &latex; will automatically
+work out the number, put it into the output, and will change that number
+later if needed.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="164">label</indexterm></cindex>
-<para>Including the figure number in the source is poor practice since if that
-number changes as the document evolves then you must remember to update
-this reference by hand. Instead, &latex; has you write a <dfn>label</dfn>
-like <code>\label&lbrace;eq:GreensThm&rbrace;</code> and refer to it with <code>See
-equation~\ref&lbrace;eq:GreensThm&rbrace;</code>.
-</para>
-<para>&latex; writes the information from the labels to a file with the same
-name as the file containing the <code>\label&lbrace;...&rbrace;</code> but with an
-<file>.aux</file> extension. (The information has the format
-<code>\newlabel&lbrace;<var>label</var>&rbrace;&lbrace;&lbrace;<var>currentlabel</var>&rbrace;&lbrace;<var>pagenumber</var>&rbrace;&rbrace;</code>
-where <var>currentlabel</var> is the current value of the macro
-<code>\&arobase;currentlabel</code> that is usually updated whenever you call
-<code>\refstepcounter&lbrace;<var>counter</var>&rbrace;</code>.)
-</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="165">forward reference</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="166">reference, forward</indexterm></cindex>
-<para>The most common side effect of the prior paragraph happens when your
-document has a <dfn>forward reference</dfn>, a <code>\ref&lbrace;<var>key</var>&rbrace;</code> that
-appears earlier than the associated <code>\label&lbrace;<var>key</var>&rbrace;</code>; see the
-example in the <code>\pageref&lbrace;...&rbrace;</code> description. &latex; gets the
-information for references from the <file>.aux</file> file. If this is the
-first time you are compiling the document then you will get a message
-<code>LaTeX Warning: Label(s) may have changed. Rerun to get
-cross references right.</code> and in the output the reference will appear as
-two question marks&nbsp;<samp>??</samp>, in boldface. Or, if you change some
-things so the references change then you get the same warning and the
-output contains the old reference information. The solution in either
-case is just to compile the document a second time.
+<example endspaces=" ">
+<pre xml:space="preserve">We will see this with Theorem~\ref&lbrace;th:GreensThm&rbrace;. % forward reference
+...
+\begin&lbrace;theorem&rbrace; \label&lbrace;th:GreensThm&rbrace;
+ ...
+\end&lbrace;theorem&rbrace;
+...
+See Theorem~\ref&lbrace;th:GreensThm&rbrace; on page~\pageref&lbrace;th:GreensThm&rbrace;.
+</pre></example>
+
+<para>&latex; tracks cross reference information in a file having the
+extension <file>.aux</file> and with the same base name as the file containing
+the <code>\label</code>. So if <code>\label</code> is in <file>calculus.tex</file> then
+the information is in <file>calculus.aux</file>. &latex; puts the
+information in that file every time it runs across a <code>\label</code>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="213">forward reference</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="214">reference, forward</indexterm></cindex>
+<para>The behavior described in the prior paragraph results in a quirk that
+happens when your document has a <dfn>forward reference</dfn>, a <code>\ref</code>
+that appears before the associated <code>\label</code>. If this is the first
+time that you are compiling the document then you will get <samp>LaTeX
+Warning: Label(s) may have changed. Rerun to get cross references right</samp>
+and in the output the forward reference will appear as two question
+marks&nbsp;<samp>??</samp>, in boldface. A similar thing happens if you
+change some things so the references changes; you get the same warning
+and the output contains the old reference information. In both cases,
+resolve this by compiling the document a second time.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="215"><r>package</r>, <code>cleveref</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="216"><code>cleveref</code> <r>package</r></indexterm></cindex>
+ <para>The <code>cleveref</code> package enhances &latex;&textrsquo;s
+cross referencing features. You can arrange that if you enter
+<code>\begin&lbrace;thm&rbrace;\label&lbrace;th:Nerode&rbrace;...\end&lbrace;thm&rbrace;</code> then
+<code>\cref&lbrace;th:Nerode&rbrace;</code> will output <samp>Theorem 3.21</samp>, without you
+having to enter the &textldquo;Theorem.&textrdquo;
</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\label</menunode><menudescription><pre xml:space="preserve">Assign a symbolic name to a piece of text.
@@ -2893,7 +3674,7 @@ case is just to compile the document a second time.
<node name="_005clabel" spaces=" "><nodename>\label</nodename><nodenext automatic="on">\pageref</nodenext><nodeup automatic="on">Cross references</nodeup></node>
<section spaces=" "><sectiontitle><code>\label</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="242">\label</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="253" mergedindex="cp">\label</indexterm></findex>
<para>Synopsis:
</para>
@@ -2914,30 +3695,39 @@ punctuation characters. Upper and lowercase letters are
distinguished, as usual.
</para>
<para>A common convention is to use labels consisting of a prefix and a suffix
-separated by a colon or period. This helps to avoid accidentally
-creating two labels with the same name, and makes your source more
-readable. Some commonly-used prefixes:
+separated by a colon or period. Thus, <code>\label&lbrace;fig:Post&rbrace;</code> is a
+label for a figure with a portrait of Emil Post. This helps to avoid
+accidentally creating two labels with the same name, and makes your
+source more readable. Some commonly-used prefixes:
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">ch</itemformat></item>
</tableterm><tableitem><para>for chapters
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">sec</itemformat></item>
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">sec</itemformat></item>
+<itemx spaces=" "><itemformat command="code">subsec</itemformat></itemx>
</tableterm><tableitem><para>for lower-level sectioning commands
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">fig</itemformat></item>
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">fig</itemformat></item>
</tableterm><tableitem><para>for figures
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">tab</itemformat></item>
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">tab</itemformat></item>
</tableterm><tableitem><para>for tables
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">eq</itemformat></item>
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">eq</itemformat></item>
</tableterm><tableitem><para>for equations
</para></tableitem></tableentry></table>
-<para>Thus, <code>\label&lbrace;fig:Euler&rbrace;</code> is a label for a figure with a portrait
-of the great man.
+<para>In the auxiliary file the reference information is kept as the text of
+a command of the form
+<code>\newlabel&lbrace;<var>label</var>&rbrace;&lbrace;&lbrace;<var>currentlabel</var>&rbrace;&lbrace;<var>pagenumber</var>&rbrace;&rbrace;</code>.
+Here <var>currentlabel</var> is the current value of the macro
+<code>\&arobase;currentlabel</code> that is usually updated whenever you call
+<code>\refstepcounter&lbrace;<var>counter</var>&rbrace;</code>.
</para>
-<para>In this example below the key <code>sec:test</code> will get the number of the
-current section and the key <code>fig:test</code> will get the number of the
-figure. (Incidentally, put labels after captions in figures and
-tables.)
+<para>Below, the key <code>sec:test</code> will get the number of the current
+section and the key <code>fig:test</code> will get the number of the figure.
+(Incidentally, put labels after captions in figures and tables.)
</para>
<example endspaces=" ">
<pre xml:space="preserve">\section&lbrace;section name&rbrace;
@@ -2954,11 +3744,11 @@ See Figure~\ref&lbrace;fig:test&rbrace;.
</section>
<node name="_005cpageref" spaces=" "><nodename>\pageref</nodename><nodenext automatic="on">\ref</nodenext><nodeprev automatic="on">\label</nodeprev><nodeup automatic="on">Cross references</nodeup></node>
-<section spaces=" "><sectiontitle><code>\pageref&lbrace;<var>key</var>&rbrace;</code></sectiontitle>
+<section spaces=" "><sectiontitle><code>\pageref</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="243">\pageref</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="167">cross referencing with page number</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="168">page number, cross referencing</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="254" mergedindex="cp">\pageref</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="217">cross referencing with page number</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="218">page number, cross referencing</indexterm></cindex>
<para>Synopsis:
</para>
@@ -2969,10 +3759,14 @@ See Figure~\ref&lbrace;fig:test&rbrace;.
<para>Produce the page number of the place in the text where the corresponding
<code>\label</code>&lbrace;<var>key</var>&rbrace; command appears.
</para>
-<para>In this example the <code>\label&lbrace;eq:main&rbrace;</code> is used both for the
-formula number and for the page number. (Note that the two references
-are forward references, so this document would need to be compiled twice
-to resolve those.)
+<para>If there is no <code>\label&lbrace;<var>key</var>&rbrace;</code> then you get something like
+<samp>LaTeX Warning: Reference `th:GrensThm' on page 1 undefined on
+input line 11.</samp>
+</para>
+<para>Below, the <code>\label&lbrace;eq:main&rbrace;</code> is used both for the formula number
+and for the page number. (Note that the two references are forward
+references so this document would need to be compiled twice to resolve
+those.)
</para>
<example endspaces=" ">
<pre xml:space="preserve">The main result is formula~\ref&lbrace;eq:main&rbrace; on page~\pageref&lbrace;eq:main&rbrace;.
@@ -2985,14 +3779,14 @@ to resolve those.)
</section>
<node name="_005cref" spaces=" "><nodename>\ref</nodename><nodeprev automatic="on">\pageref</nodeprev><nodeup automatic="on">Cross references</nodeup></node>
-<section spaces=" "><sectiontitle><code>\ref&lbrace;<var>key</var>&rbrace;</code></sectiontitle>
+<section spaces=" "><sectiontitle><code>\ref</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="244">\ref</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="169">cross referencing, symbolic</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="170">section number, cross referencing</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="171">equation number, cross referencing</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="172">figure number, cross referencing</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="173">footnote number, cross referencing</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="255" mergedindex="cp">\ref</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="219">cross referencing, symbolic</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="220">section number, cross referencing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="221">equation number, cross referencing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="222">figure number, cross referencing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="223">footnote number, cross referencing</indexterm></cindex>
<para>Synopsis:
</para>
@@ -3005,9 +3799,13 @@ equation, footnote, figure, &dots;, of the corresponding
<code>\label</code> command (<pxref label="_005clabel"><xrefnodename>\label</xrefnodename></pxref>). It does not produce any text,
such as the word &textlsquo;Section&textrsquo; or &textlsquo;Figure&textrsquo;, just the bare number itself.
</para>
-<para>In this example, the <code>\ref&lbrace;popular&rbrace;</code> produces <samp>2</samp>. Note
-that it is a forward reference since it comes before
-<code>\label&lbrace;popular&rbrace;</code>.
+<para>If there is no <code>\label&lbrace;<var>key</var>&rbrace;</code> then you get something like
+<samp>LaTeX Warning: Reference `th:GrensThm' on page 1 undefined on
+input line 11.</samp>
+</para>
+<para>In this example the <code>\ref&lbrace;popular&rbrace;</code> produces <samp>2</samp>. Note that
+it is a forward reference since it comes before <code>\label&lbrace;popular&rbrace;</code>
+so this document would have to be compiled twice.
</para>
<example endspaces=" ">
<pre xml:space="preserve">The most widely-used format is item number~\ref&lbrace;popular&rbrace;.
@@ -3018,15 +3816,21 @@ that it is a forward reference since it comes before
\end&lbrace;enumerate&rbrace;
</pre></example>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="224"><r>package</r>, <code>cleveref</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="225"><code>cleveref</code> <r>package</r></indexterm></cindex>
+
+<para>The <file>cleveref</file> package includes text such as <samp>Theorem</samp> in the
+reference. See the documentation on CTAN.
+</para>
</section>
</chapter>
<node name="Environments" spaces=" "><nodename>Environments</nodename><nodenext automatic="on">Line breaking</nodenext><nodeprev automatic="on">Cross references</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Environments</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="174">environments</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="245">\begin</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="246">\end</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="226">environments</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="256" mergedindex="cp">\begin</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="257" mergedindex="cp">\end</indexterm></findex>
<para>&latex; provides many environments for delimiting certain behavior.
An environment begins with <code>\begin</code> and ends with <code>\end</code>,
@@ -3044,7 +3848,7 @@ the end. For instance, the input
<samp>! LaTeX Error: \begin&lbrace;table*&rbrace; on input line 5 ended by
\end&lbrace;table&rbrace;.</samp>
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="175">group, and environments</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="227">group, and environments</indexterm></cindex>
<para>Environments are executed within a group.
</para>
<menu endspaces=" ">
@@ -3067,11 +3871,11 @@ the end. For instance, the input
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">math</menunode><menudescription><pre xml:space="preserve">In-line math.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">minipage</menunode><menudescription><pre xml:space="preserve">Miniature page.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">picture</menunode><menudescription><pre xml:space="preserve">Picture with text, arrows, lines and circles.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">quotation and quote</menunode><menudescription><pre xml:space="preserve">Include a quotation.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">quotation &amp; quote</menunode><menudescription><pre xml:space="preserve">Include a quotation.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">tabbing</menunode><menudescription><pre xml:space="preserve">Align text arbitrarily.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">table</menunode><menudescription><pre xml:space="preserve">Floating tables.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">tabular</menunode><menudescription><pre xml:space="preserve">Align text in columns.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">thebibliography</menunode><menudescription><pre xml:space="preserve">Bibliography or reference list.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">thebibliography</menunode><menudescription><pre xml:space="preserve">Bibliography or reference list.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">theorem</menunode><menudescription><pre xml:space="preserve">Theorems, lemmas, etc.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">titlepage</menunode><menudescription><pre xml:space="preserve">For hand crafted title pages.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">verbatim</menunode><menudescription><pre xml:space="preserve">Simulating typed input.
@@ -3082,10 +3886,10 @@ the end. For instance, the input
<node name="abstract" spaces=" "><nodename>abstract</nodename><nodenext automatic="on">array</nodenext><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>abstract</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="247"><r>environment</r>, <code>abstract</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="248"><code>abstract</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="258" mergedindex="cp"><r>environment</r>, <code>abstract</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="259" mergedindex="cp"><code>abstract</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="176">abstracts</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="228">abstracts</indexterm></cindex>
<para>Synopsis:
</para>
@@ -3142,10 +3946,10 @@ a more flexible solution, use the package <file>abstract</file>).
<node name="array" spaces=" "><nodename>array</nodename><nodenext automatic="on">center</nodenext><nodeprev automatic="on">abstract</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>array</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="249"><r>environment</r>, <code>array</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="250"><code>array</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="260" mergedindex="cp"><r>environment</r>, <code>array</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="261" mergedindex="cp"><code>array</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="177">arrays, math</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="229">arrays, math</indexterm></cindex>
<para>Synopsis:
</para>
@@ -3156,7 +3960,8 @@ a more flexible solution, use the package <file>abstract</file>).
\end&lbrace;array&rbrace;
</pre></example>
-<para>or
+<noindent></noindent>
+<para>or:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;array&rbrace;[<var>pos</var>]&lbrace;<var>cols</var>&rbrace;
@@ -3167,29 +3972,47 @@ a more flexible solution, use the package <file>abstract</file>).
<para>Produce a mathematical array. This environment can only be used in math
mode, and normally appears within a displayed mathematics environment
-such as <code>equation</code> (<pxref label="equation"><xrefnodename>equation</xrefnodename></pxref>). Column entries are
-separated by an ampersand&nbsp;(<code>&amp;</code>). Rows are terminated with
-double-backslashes (<pxref label="_005c_005c"><xrefnodename>\\</xrefnodename></pxref>).
+such as <code>equation</code> (<pxref label="equation"><xrefnodename>equation</xrefnodename></pxref>). Inside of each row the
+column entries are separated by an ampersand, (<code>&amp;</code>). Rows are
+terminated with double-backslashes (<pxref label="_005c_005c"><xrefnodename>\\</xrefnodename></pxref>).
+</para>
+<para>This example shows a three by three array.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;equation*&rbrace;
+ \chi(x) =
+ \left| % vertical bar fence
+ \begin&lbrace;array&rbrace;&lbrace;ccc&rbrace;
+ x-a &amp;-b &amp;-c \\
+ -d &amp;x-e &amp;-f \\
+ -g &amp;-h &amp;x-i
+ \end&lbrace;array&rbrace;
+ \right|
+\end&lbrace;equation*&rbrace;
+</pre></example>
+
<para>The required argument <var>cols</var> describes the number of columns, their
-alignment, and the formatting of the intercolumn regions. See
-<ref label="tabular"><xrefnodename>tabular</xrefnodename></ref> for the complete description of <var>cols</var>, and of the
+alignment, and the formatting of the intercolumn regions. For instance,
+<code>\begin&lbrace;array&rbrace;&lbrace;rcl&rbrace;...\end&lbrace;array&rbrace;</code> gives three columns: the
+first flush right, the second centered, and the third flush left. See
+<ref label="tabular"><xrefnodename>tabular</xrefnodename></ref> for the complete description of <var>cols</var> and of the
other common features of the two environments, including the optional
<var>pos</var> argument.
</para>
<para>There are two ways that <code>array</code> diverges from <code>tabular</code>. The
first is that <code>array</code> entries are typeset in math mode, in
-textstyle (except if the <var>cols</var> definition specifies the column with
-<code>p&lbrace;...&rbrace;</code>, which causes the entry to be typeset in text mode).
-The second is that, instead of <code>tabular</code>&textrsquo;s parameter
-<code>\tabcolsep</code>, &latex;&textrsquo;s intercolumn space in an <code>array</code> is governed
-by
-<findex index="fn" spaces=" "><indexterm index="fn" number="251">\arraycolsep</indexterm></findex>
+textstyle (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>) except if the <var>cols</var> definition specifies
+the column with <code>p&lbrace;...&rbrace;</code>, which causes the entry to be typeset in
+text mode. The second is that, instead of <code>tabular</code>&textrsquo;s parameter
+<code>\tabcolsep</code>, &latex;&textrsquo;s intercolumn space in an <code>array</code> is
+governed by
+<findex index="fn" spaces=" "><indexterm index="fn" number="262" mergedindex="cp">\arraycolsep</indexterm></findex>
<code>\arraycolsep</code>, which gives half the width between columns. The
-default for this is <samp>5pt</samp>.
+default for this is <samp>5pt</samp> so that between two columns comes
+10<dmn>pt</dmn> of space.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="178"><r>package</r>, <code>amsmath</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="179"><code>amsmath</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="230"><r>package</r>, <code>amsmath</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="231"><code>amsmath</code> <r>package</r></indexterm></cindex>
<para>To obtain arrays with braces the standard is to use the <file>amsmath</file>
package. It comes with environments <code>pmatrix</code> for an array
@@ -3200,54 +4023,60 @@ an array surrounded by vertical bars&nbsp;<code>|...|</code>, and
<code>Vmatrix</code> for an array surrounded by double vertical
bars&nbsp;<code>||...||</code>, along with a number of other array constructs.
</para>
-<para>Here is an example of an array:
-</para>
-<example endspaces=" ">
-<pre xml:space="preserve">\begin&lbrace;equation&rbrace;
- \begin&lbrace;array&rbrace;&lbrace;cr&rbrace;
- \sqrt&lbrace;y&rbrace; &amp;12.3 \\
- x^2 &amp;3.4
- \end&lbrace;array&rbrace;
-\end&lbrace;equation&rbrace;
-</pre></example>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="232"><r>package</r>, <code>amsmath</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="233"><code>amsmath</code> <r>package</r></indexterm></cindex>
-<para>The next example works if <code>\usepackage&lbrace;amsmath&rbrace;</code> is in the
-preamble:
+<para>The next example uses the <file>amsmath</file> package.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\begin&lbrace;equation&rbrace;
- \begin&lbrace;vmatrix&rbrace;&lbrace;cc&rbrace;
+<pre xml:space="preserve">\usepackage&lbrace;amsmath&rbrace; % in preamble
+
+\begin&lbrace;equation&rbrace;
+ \begin&lbrace;vmatrix&rbrace;&lbrace;cc&rbrace; % array with vert lines
a &amp;b \\
c &amp;d
\end&lbrace;vmatrix&rbrace;=ad-bc
\end&lbrace;equation&rbrace;
</pre></example>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="234"><r>package</r>, <code>array (package)</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="235"><code>array (package)</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="236"><r>package</r>, <code>dcolumn</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="237"><code>dcolumn</code> <r>package</r></indexterm></cindex>
+
+<para>There are many packages concerning arrays. The <file>array</file> package has
+many useful extensions, including more column types. The <file>dcolumn</file>
+package adds a column type to center on a decimal point. For both see
+the documentation on CTAN.
+</para>
</section>
<node name="center" spaces=" "><nodename>center</nodename><nodenext automatic="on">description</nodenext><nodeprev automatic="on">array</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>center</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="252"><r>environment</r>, <code>center</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="253"><code>center</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="263" mergedindex="cp"><r>environment</r>, <code>center</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="264" mergedindex="cp"><code>center</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="180">centering text, environment for</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="238">centering text, environment for</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;center&rbrace;
- ... text ...
+ <var>line1</var> \\
+ <var>line2</var> \\
+ ...
\end&lbrace;center&rbrace;
</pre></example>
<para>Create a new paragraph consisting of a sequence of lines that are
-centered within the left and right margins on the current page. Use
-double-backslash to get a line break at a particular spot (<pxref label="_005c_005c"><xrefnodename>\\</xrefnodename></pxref>).
-<findex index="fn" spaces=" "><indexterm index="fn" number="254">\\ <r>(for <code>center</code>)</r></indexterm></findex>
-If some text environment body is too long to fit on a line, &latex;
-will insert line breaks that avoid hyphenation and avoid stretching or
-shrinking any interword space.
+centered within the left and right margins. Use
+double-backslash, <code>\\</code>, to get a line break (<pxref label="_005c_005c"><xrefnodename>\\</xrefnodename></pxref>).
+<findex index="fn" spaces=" "><indexterm index="fn" number="265" mergedindex="cp">\\ <r>(for <code>center</code>)</r></indexterm></findex>
+If some text is too long to fit on a line then &latex; will insert line
+breaks that avoid hyphenation and avoid stretching or shrinking any
+interword space.
</para>
<para>This environment inserts space above and below the text body. See
<ref label="_005ccentering"><xrefnodename>\centering</xrefnodename></ref> to avoid such space, for example inside a <code>figure</code>
@@ -3278,7 +4107,11 @@ ending.
\end&lbrace;center&rbrace;
</pre></example>
-<para>A double backslash after the final line is optional.
+<para>A double backslash after the final line is optional. If present it
+doesn&textrsquo;t add any vertical space.
+</para>
+<para>In a two-column document the text is centered in a column, not in the
+entire page.
</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\centering</menunode><menudescription><pre xml:space="preserve">Declaration form of the <code>center</code> environment.
@@ -3288,15 +4121,45 @@ ending.
<node name="_005ccentering" spaces=" "><nodename>\centering</nodename><nodeup automatic="on">center</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\centering</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="255">\centering</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="181">centering text, declaration for</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="266" mergedindex="cp">\centering</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="239">centering text, declaration for</indexterm></cindex>
+
-<para>A declaration that causes material in its scope to be centered. It is
-most often used inside an environment such as <code>figure</code>, or in a
-<code>parbox</code>.
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">&lbrace;\centering ... &rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>or
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;group&rbrace;
+ \centering ...
+\end&lbrace;group&rbrace;
+</pre></example>
+
+<para>Center the material in its scope. It is most often used inside an
+environment such as <code>figure</code>, or in a <code>parbox</code>.
+</para>
+<para>This example&textrsquo;s <code>\centering</code> declaration causes the graphic to be
+horizontally centered.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;figure&rbrace;
+ \centering
+ \includegraphics[width=0.6\textwidth]&lbrace;ctan_lion.png&rbrace;
+ \caption&lbrace;CTAN Lion&rbrace; \label&lbrace;fig:CTANLion&rbrace;
+\end&lbrace;figure&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>The scope of this <code>\centering</code> ends with the <code>\end&lbrace;figure&rbrace;</code>.
</para>
<para>Unlike the <code>center</code> environment, the <code>\centering</code> command does
-not add vertical space above and below the text.
+not add vertical space above and below the text. That&textrsquo;s its advantage
+in the above example; there is not an excess of space.
</para>
<para>It also does not start a new paragraph; it simply changes how &latex;
formats paragraph units. If <code>ww &lbrace;\centering xx \\ yy&rbrace; zz</code> is
@@ -3308,20 +4171,7 @@ environment such as <code>figure</code> or <code>table</code> that ends the
paragraph unit. Thus, if <code>&lbrace;\centering xx \\ yy\par&rbrace; zz</code> is
surrounded by blank lines then it makes a new paragraph with two
centered lines <samp>xx</samp> and <samp>yy</samp>, followed by a new paragraph with
-<samp>zz</samp> that is formatted as usual. See also the following example.
-</para>
-<para>This example&textrsquo;s <code>\centering</code> causes the graphic to be horizontally
-centered.
-</para>
-<example endspaces=" ">
-<pre xml:space="preserve">\begin&lbrace;figure&rbrace;
- \centering
- \includegraphics[width=0.6\textwidth]&lbrace;ctan_lion.png&rbrace;
- \caption&lbrace;CTAN Lion&rbrace; \label&lbrace;fig:CTANLion&rbrace;
-\end&lbrace;figure&rbrace;
-</pre></example>
-
-<para>The scope of the <code>\centering</code> ends with the <code>\end&lbrace;figure&rbrace;</code>.
+<samp>zz</samp> that is formatted as usual.
</para>
</subsection>
@@ -3329,31 +4179,29 @@ centered.
<node name="description" spaces=" "><nodename>description</nodename><nodenext automatic="on">displaymath</nodenext><nodeprev automatic="on">center</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>description</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="256"><r>environment</r>, <code>description</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="257"><code>description</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="267" mergedindex="cp"><r>environment</r>, <code>description</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="268" mergedindex="cp"><code>description</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="182">labelled lists, creating</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="183">description lists, creating</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="240">labelled lists, creating</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="241">description lists, creating</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;description&rbrace;
-\item[<var>label of first item</var>] text of first item
-\item[<var>label of second item</var>] text of second item
- ...
+ \item[<var>label of first item</var>] <var>text of first item</var>
+ \item[<var>label of second item</var>] <var>text of second item</var>
+ ...
\end&lbrace;description&rbrace;
</pre></example>
-<para>Environment to make a labeled list of items. Each item&textrsquo;s <var>label</var> is
-typeset in bold, and is flush left so that long labels continue into the
+<para>Environment to make a list of labeled items. Each item&textrsquo;s <var>label</var> is
+typeset in bold and is flush left, so that long labels continue into the
first line of the item text. There must be at least one item; having
none causes the &latex; error <samp>Something's wrong--perhaps a
missing \item</samp>.
</para>
<para>This example shows the environment used for a sequence of definitions.
-The labels <samp>lama</samp> and <samp>llama</samp> come out in boldface with their
-left edges aligned on the left margin.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;definition&rbrace;
@@ -3362,22 +4210,26 @@ left edges aligned on the left margin.
\end&lbrace;definition&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="258">\item</indexterm></findex>
+<noindent></noindent>
+<para>The labels <samp>lama</samp> and <samp>llama</samp> are output in boldface, with the
+left edge on the left margin.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="269" mergedindex="cp">\item</indexterm></findex>
<para>Start list items with the <code>\item</code> command (<pxref label="_005citem"><xrefnodename>\item</xrefnodename></pxref>). Use the
optional labels, as in <code>\item[Main point]</code>, because there is
no sensible default. Following the <code>\item</code> is optional text, which
may contain multiple paragraphs.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="184">bold typewriter, avoiding</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="185">typewriter labels in lists</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="242">bold typewriter, avoiding</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="243">typewriter labels in lists</indexterm></cindex>
<para>Since the labels are in bold style, if the label text calls for a font
change given in argument style (see <ref label="Font-styles"><xrefnodename>Font styles</xrefnodename></ref>) then it will come
out bold. For instance, if the label text calls for typewriter with
<code>\item[\texttt&lbrace;label text&rbrace;]</code> then it will appear in bold
-typewriter, if that is available. The simplest way to get non-bold
-typewriter is to use declarative style: <code>\item[&lbrace;\tt label
-text&rbrace;]</code>. Similarly, get the standard roman font with <code>\item[&lbrace;\rm
-label text&rbrace;]</code>.
+typewriter, if that is available. The simplest way around this, in this
+example to get non-bold typewriter, is to use declarative style:
+<code>\item[&lbrace;\tt label text&rbrace;]</code>. Similarly, get the standard roman
+font with <code>\item[&lbrace;\rm label text&rbrace;]</code>.
</para>
<para>For other major &latex; labelled list environments, see <ref label="itemize"><xrefnodename>itemize</xrefnodename></ref>
and <ref label="enumerate"><xrefnodename>enumerate</xrefnodename></ref>. Unlike those environments, nesting
@@ -3402,15 +4254,15 @@ lists.
<section spaces=" "><sectiontitle><code>displaymath</code></sectiontitle>
<!-- c http://tex.stackexchange.com/questions/40492/what-are-the-differences-between-align-equation-and-displaymath -->
-<findex index="fn" spaces=" "><indexterm index="fn" number="259"><r>environment</r>, <code>displaymath</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="260"><code>displaymath</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="270" mergedindex="cp"><r>environment</r>, <code>displaymath</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="271" mergedindex="cp"><code>displaymath</code> <r>environment</r></indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;displaymath&rbrace;
-<var>math text</var>
+ <var>mathematical text</var>
\end&lbrace;displaymath&rbrace;
</pre></example>
@@ -3424,8 +4276,8 @@ math text. One way to get an equation number is to use the
</para>
<para>&latex; will not break the <var>math text</var> across lines.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="186"><r>package</r>, <code>amsmath</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="187"><code>amsmath</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="244"><r>package</r>, <code>amsmath</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="245"><code>amsmath</code> <r>package</r></indexterm></cindex>
<para>Note that the <file>amsmath</file> package has significantly more extensive
displayed equation facilities. For example, there are a number of
@@ -3445,11 +4297,14 @@ different vertical spacing, and because the <code>displaymath</code>
environment honors the <code>fleqn</code> option.)
</para>
<para>The output from this example is centered and alone on its line.
-</para><example endspaces=" ">
+</para>
+<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;displaymath&rbrace;
\int_1^2 x^2\,dx=7/3
\end&lbrace;displaymath&rbrace;
</pre></example>
+
+<noindent></noindent>
<para>Also, the integral sign is larger than the inline version
<code>\( \int_1^2 x^2\,dx=7/3 \)</code> produces.
</para>
@@ -3458,8 +4313,8 @@ environment honors the <code>fleqn</code> option.)
<node name="document" spaces=" "><nodename>document</nodename><nodenext automatic="on">enumerate</nodenext><nodeprev automatic="on">displaymath</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>document</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="261"><r>environment</r>, <code>document</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="262"><code>document</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="272" mergedindex="cp"><r>environment</r>, <code>document</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="273" mergedindex="cp"><code>document</code> <r>environment</r></indexterm></findex>
<para>The <code>document</code> environment encloses the entire body of a document.
@@ -3474,8 +4329,8 @@ It is required in every &latex; document. <xref label="Starting-and-ending"><xr
<node name="_005cAtBeginDocument" spaces=" "><nodename>\AtBeginDocument</nodename><nodenext automatic="on">\AtEndDocument</nodenext><nodeup automatic="on">document</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\AtBeginDocument</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="263">\AtBeginDocument</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="188">beginning of document hook</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="274" mergedindex="cp">\AtBeginDocument</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="246">beginning of document hook</indexterm></cindex>
<para>Synopsis:
</para>
@@ -3497,8 +4352,8 @@ will be executed in the order that you gave them.
<node name="_005cAtEndDocument" spaces=" "><nodename>\AtEndDocument</nodename><nodeprev automatic="on">\AtBeginDocument</nodeprev><nodeup automatic="on">document</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\AtEndDocument</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="264">\AtEndDocument</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="189">end of document hook</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="275" mergedindex="cp">\AtEndDocument</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="247">end of document hook</indexterm></cindex>
<para>Synopsis:
</para>
@@ -3522,18 +4377,18 @@ will be executed in the order that you gave them.
<node name="enumerate" spaces=" "><nodename>enumerate</nodename><nodenext automatic="on">eqnarray</nodenext><nodeprev automatic="on">document</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>enumerate</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="265"><r>environment</r>, <code>enumerate</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="266"><code>enumerate</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="276" mergedindex="cp"><r>environment</r>, <code>enumerate</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="277" mergedindex="cp"><code>enumerate</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="190">lists of items, numbered</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="248">lists of items, numbered</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;enumerate&rbrace;
-\item[<var>optional label of first item</var>] text of first item
-\item[<var>optional label of second item</var>] text of second item
-...
+ \item[<var>optional label of first item</var>] <var>text of first item</var>
+ \item[<var>optional label of second item</var>] <var>text of second item</var>
+ ...
\end&lbrace;enumerate&rbrace;
</pre></example>
@@ -3555,7 +4410,7 @@ As a top-level list the labels would come out as <samp>1.</samp> and
\end&lbrace;enumerate&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="267">\item</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="278" mergedindex="cp">\item</indexterm></findex>
<para>Start list items with the <code>\item</code> command (<pxref label="_005citem"><xrefnodename>\item</xrefnodename></pxref>). If you
give <code>\item</code> an optional argument by following it with square
brackets, as in <code>\item[Interstitial label]</code>, then the next item
@@ -3572,15 +4427,19 @@ the outermost level.
</para>
<enumerate first="1" endspaces=" ">
<listitem spaces=" "><para>arabic number followed by a period: <samp>1.</samp>, <samp>2.</samp>,&nbsp;&dots;
-</para></listitem><listitem spaces=" "><para>lower case letter inside parentheses: <samp>(a)</samp>, <samp>(b)</samp>&nbsp;&dots;
-</para></listitem><listitem spaces=" "><para>lower case roman numeral followed by a period: <samp>i.</samp>, <samp>ii.</samp>,&nbsp;&dots;
-</para></listitem><listitem spaces=" "><para>upper case letter followed by a period: <samp>A.</samp>, <samp>B.</samp>,&nbsp;&dots;
+</para></listitem><listitem spaces=" "><para>lowercase letter inside parentheses: <samp>(a)</samp>, <samp>(b)</samp>&nbsp;&dots;
+</para></listitem><listitem spaces=" "><para>lowercase roman numeral followed by a period: <samp>i.</samp>, <samp>ii.</samp>,&nbsp;&dots;
+</para></listitem><listitem spaces=" "><para>uppercase letter followed by a period: <samp>A.</samp>, <samp>B.</samp>,&nbsp;&dots;
</para></listitem></enumerate>
-<findex index="fn" spaces=" "><indexterm index="fn" number="268">\enumi</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="269">\enumii</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="270">\enumiii</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="271">\enumiv</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="279" mergedindex="cp">\enumi</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="280" mergedindex="cp">\enumii</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="281" mergedindex="cp">\enumiii</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="282" mergedindex="cp">\enumiv</indexterm></findex>
+<anchor name="enumerate-enumi">enumerate enumi</anchor>
+<anchor name="enumerate-enumii">enumerate enumii</anchor>
+<anchor name="enumerate-enumiii">enumerate enumiii</anchor>
+<anchor name="enumerate-enumiv">enumerate enumiv</anchor>
<para>The <code>enumerate</code> environment uses the counters <code>\enumi</code> through
<code>\enumiv</code> (<pxref label="Counters"><xrefnodename>Counters</xrefnodename></pxref>).
</para>
@@ -3590,17 +4449,21 @@ parameters, including the default values, and for information about
customizing list layout, see <ref label="list"><xrefnodename>list</xrefnodename></ref>. The package <file>enumitem</file> is
useful for customizing lists.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="272">\labelenumi</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="273">\labelenumii</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="274">\labelenumiii</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="275">\labelenumiv</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="283" mergedindex="cp">\labelenumi</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="284" mergedindex="cp">\labelenumii</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="285" mergedindex="cp">\labelenumiii</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="286" mergedindex="cp">\labelenumiv</indexterm></findex>
+<anchor name="enumerate-labelenumi">enumerate labelenumi</anchor>
+<anchor name="enumerate-labelenumii">enumerate labelenumii</anchor>
+<anchor name="enumerate-labelenumiii">enumerate labelenumiii</anchor>
+<anchor name="enumerate-labelenumiv">enumerate labelenumiv</anchor>
<para>To change the format of the label use <code>\renewcommand</code>
(<pxref label="_005cnewcommand-_0026-_005crenewcommand"><xrefnodename>\newcommand &amp; \renewcommand</xrefnodename></pxref>) on the commands <code>\labelenumi</code>
through <code>\labelenumiv</code>. For instance, this first level list will be
labelled with uppercase letters, in boldface, and without a trailing
period.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="276">\Alph <r>example</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="287" mergedindex="cp">\Alph <r>example</r></indexterm></findex>
<example endspaces=" ">
<pre xml:space="preserve">\renewcommand&lbrace;\labelenumi&rbrace;&lbrace;\textbf&lbrace;\Alph&lbrace;enumi&rbrace;&rbrace;&rbrace;
\begin&lbrace;enumerate&rbrace;
@@ -3617,26 +4480,25 @@ period.
<node name="eqnarray" spaces=" "><nodename>eqnarray</nodename><nodenext automatic="on">equation</nodenext><nodeprev automatic="on">enumerate</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>eqnarray</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="277"><r>environment</r>, <code>eqnarray</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="278"><code>eqnarray</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="288" mergedindex="cp"><r>environment</r>, <code>eqnarray</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="289" mergedindex="cp"><code>eqnarray</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="191">equations, aligning</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="192">aligning equations</indexterm></cindex>
-
-<cindex index="cp" spaces=" "><indexterm index="cp" number="193">align <r>environment, from <code>amsmath</code></r></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="194">amsmath <r>package, replacing <code>eqnarray</code></r></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="195">Madsen, Lars</indexterm></cindex>
-<para>First, a caveat: the <code>eqnarray</code> environment is depreciated. It has
-infelicities that cannot be overcome, including spacing that is
-inconsistent with other mathematics elements (see the article &textldquo;Avoid
-eqnarray!&textrdquo;&noeos; by Lars Madsen
+<cindex index="cp" spaces=" "><indexterm index="cp" number="249">equations, aligning</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="250">aligning equations</indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="251">align <r>environment, from <code>amsmath</code></r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="252">amsmath <r>package, replacing <code>eqnarray</code></r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="253">Madsen, Lars</indexterm></cindex>
+<para>The <code>eqnarray</code> environment is obsolete. It has infelicities,
+including spacing that is inconsistent with other mathematics elements.
+(See &textldquo;Avoid eqnarray!&textrdquo;&noeos; by Lars Madsen
<url><urefurl>http://tug.org/TUGboat/tb33-1/tb103madsen.pdf</urefurl></url>). New documents
should include the <file>amsmath</file> package and use the displayed
mathematics environments provided there, such as the <code>align</code>
-environment.
+environment. We include a description only for completeness and for
+working with old documents.
</para>
-<para>Nevertheless, for completeness and for a reference when working with old
-documents, a synopsis:
+<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;eqnarray&rbrace;
@@ -3645,6 +4507,7 @@ documents, a synopsis:
\end&lbrace;eqnarray&rbrace;
</pre></example>
+<noindent></noindent>
<para>or
</para>
<example endspaces=" ">
@@ -3654,7 +4517,7 @@ documents, a synopsis:
\end&lbrace;eqnarray*&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="279">\\ <r>(for <code>eqnarray</code>)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="290" mergedindex="cp">\\ <r>(for <code>eqnarray</code>)</r></indexterm></findex>
<para>Display a sequence of equations or inequalities. The left and right
sides are typeset in display mode, while the middle is typeset in text
mode.
@@ -3662,18 +4525,18 @@ mode.
<para>It is similar to a three-column <code>array</code> environment, with items
within a row separated by an ampersand&nbsp;(<code>&amp;</code>), and with rows
separated by double backslash&nbsp; <code>\\</code>).
-<findex index="fn" spaces=" "><indexterm index="fn" number="280">\\* <r>(for <code>eqnarray</code>)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="291" mergedindex="cp">\\* <r>(for <code>eqnarray</code>)</r></indexterm></findex>
The starred form of line break (<code>\\*</code>) can also be used to separate
equations, and will disallow a page break there (<pxref label="_005c_005c"><xrefnodename>\\</xrefnodename></pxref>).
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="281">\nonumber</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="196">equation numbers, omitting</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="292" mergedindex="cp">\nonumber</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="254">equation numbers, omitting</indexterm></cindex>
<para>The unstarred form <code>eqnarray</code> places an equation number on every
line (using the <code>equation</code> counter), unless that line contains a
<code>\nonumber</code> command. The starred form <code>eqnarray*</code> omits
equation numbering, while otherwise being the same.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="282">\lefteqn</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="293" mergedindex="cp">\lefteqn</indexterm></findex>
<para>The command <code>\lefteqn</code> is used for splitting long formulas across
lines. It typesets its argument in display style flush left in a box of
zero width.
@@ -3694,71 +4557,80 @@ while the third line has not entry on the left side.
<node name="equation" spaces=" "><nodename>equation</nodename><nodenext automatic="on">figure</nodenext><nodeprev automatic="on">eqnarray</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>equation</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="283"><r>environment</r>, <code>equation</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="284"><code>equation</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="294" mergedindex="cp"><r>environment</r>, <code>equation</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="295" mergedindex="cp"><code>equation</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="197">equations, environment for</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="198">formulas, environment for</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="255">equations, environment for</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="256">formulas, environment for</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;equation&rbrace;
- math text
+ <var>mathematical text</var>
\end&lbrace;equation&rbrace;
</pre></example>
-<para>Make a <code>displaymath</code> environment (<pxref label="displaymath"><xrefnodename>displaymath</xrefnodename></pxref>) with an
-equation number in the right margin.
-</para>
-<para>The equation number is generated using the <code>equation</code> counter.
+<para>The same as a <code>displaymath</code> environment (<pxref label="displaymath"><xrefnodename>displaymath</xrefnodename></pxref>)
+except that &latex; puts an equation number flush to the right margin.
+The equation number is generated using the <code>equation</code> counter.
</para>
<para>You should have no blank lines between <code>\begin&lbrace;equation&rbrace;</code> and
<code>\begin&lbrace;equation&rbrace;</code>, or &latex; will tell you that there is a
-missing dollar sign,&nbsp;$<code>$</code>.
+missing dollar sign.
</para>
-<para>Note that the <file>amsmath</file> package has extensive displayed equation
-facilities. Those facilities are the best approach for such output in
-new documents.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="257"><r>package</r>, <code>amsmath</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="258"><code>amsmath</code> <r>package</r></indexterm></cindex>
+
+<para>The package <file>amsmath</file> package has extensive displayed equation
+facilities. New documents should include this package.
</para>
</section>
<node name="figure" spaces=" "><nodename>figure</nodename><nodenext automatic="on">filecontents</nodenext><nodeprev automatic="on">equation</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>figure</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="285"><r>environment</r>, <code>figure</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="286"><code>figure</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="296" mergedindex="cp"><r>environment</r>, <code>figure</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="297" mergedindex="cp"><code>figure</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="199">inserting figures</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="200">figures, inserting</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="259">inserting figures</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="260">figures, inserting</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;figure&rbrace;[<var>placement</var>]
- figure body
-\caption[<var>loftitle</var>]&lbrace;<var>title</var>&rbrace;
-\label&lbrace;<var>label&rbrace;</var>
+ <var>figure body</var>
+ \caption[<var>loftitle</var>]&lbrace;<var>title</var>&rbrace; % optional
+ \label&lbrace;<var>label&rbrace;</var> % optional
\end&lbrace;figure&rbrace;
</pre></example>
-<para>or
+<noindent></noindent>
+<para>or:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;figure*&rbrace;[<var>placement</var>]
- figure body
-\caption[<var>loftitle</var>]&lbrace;<var>title</var>&rbrace;
-\label&lbrace;<var>label&rbrace;</var>
+ <var>figure body</var>
+ \caption[<var>loftitle</var>]&lbrace;<var>title</var>&rbrace; % optional
+ \label&lbrace;<var>label&rbrace;</var> % optional
\end&lbrace;figure*&rbrace;
</pre></example>
-<para>A class of floats (<pxref label="Floats"><xrefnodename>Floats</xrefnodename></pxref>). Because they cannot be split across
-pages, they are not typeset in sequence with the normal text but instead
-are &textldquo;floated&textrdquo; to a convenient place, such as the top of a following
-page.
+<para>Figures are for material that is not part of the normal text. An
+example is material that you cannot have split between two pages, such
+as a graphic. Because of this, &latex; does not typeset figures in
+sequence with normal text but instead &textldquo;floats&textrdquo; them to a convenient
+place, such as the top of a following page (<pxref label="Floats"><xrefnodename>Floats</xrefnodename></pxref>).
</para>
-<para>For the possible values of <var>placement</var> and their effect on the
-float placement algorithm, see <ref label="Floats"><xrefnodename>Floats</xrefnodename></ref>.
+<para>The <var>figure body</var> can consist of imported graphics
+(<pxref label="Graphics"><xrefnodename>Graphics</xrefnodename></pxref>), or text, &latex; commands, etc. It is typeset in a
+<code>parbox</code> of width <code>\textwidth</code>.
+</para>
+<para>The possible values of <var>placement</var> are <code>h</code> for <samp>here</samp>,
+<code>t</code> for <samp>top</samp>, <code>b</code> for <samp>bottom</samp>, and <code>p</code> for
+<samp>on a separate page of floats</samp>. For the effect of these options on
+the float placement algorithm, see <ref label="Floats"><xrefnodename>Floats</xrefnodename></ref>.
</para>
<para>The starred form <code>figure*</code> is used when a document is in
double-column mode (<pxref label="_005ctwocolumn"><xrefnodename>\twocolumn</xrefnodename></pxref>). It produces a figure that
@@ -3766,24 +4638,22 @@ spans both columns, at the top of the page. To add the possibility of
placing at a page bottom see the discussion of <var>placement</var> <code>b</code>
in <ref label="Floats"><xrefnodename>Floats</xrefnodename></ref>.
</para>
-<para>The figure body is typeset in a <code>parbox</code> of width <code>\textwidth</code>
-and so it can contain text, commands, etc.
-</para>
<para>The label is optional; it is used for cross references (<pxref label="Cross-references"><xrefnodename>Cross
references</xrefnodename></pxref>).
-<findex index="fn" spaces=" "><indexterm index="fn" number="287">\caption</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="298" mergedindex="cp">\caption</indexterm></findex>
The optional <code>\caption</code> command specifies caption text for the
figure. By default it is numbered. If <var>loftitle</var> is present, it is
-used in the list of figures instead of <var>title</var> (<pxref label="Tables-of-contents"><xrefnodename>Tables of
-contents</xrefnodename></pxref>).
+used in the list of figures instead of <var>title</var> (<pxref label="Table-of-contents-etc_002e"><xrefnodename>Table of
+contents etc.</xrefnodename></pxref>).
</para>
-<para>This example makes a figure out of a graphic. It requires one of the
-packages <file>graphics</file> or <file>graphicx</file>. The graphic, with its
-caption, will be placed at the top of a page or, if it is pushed to the
+<para>This example makes a figure out of a graphic. &latex; will place that
+graphic and its caption at the top of a page or, if it is pushed to the
end of the document, on a page of floats.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\begin&lbrace;figure&rbrace;[t]
+<pre xml:space="preserve">\usepackage&lbrace;graphicx&rbrace; % in preamble
+ ...
+\begin&lbrace;figure&rbrace;[t]
\centering
\includegraphics[width=0.5\textwidth]&lbrace;CTANlion.png&rbrace;
\caption&lbrace;The CTAN lion, by Duane Bibby&rbrace;
@@ -3795,14 +4665,14 @@ end of the document, on a page of floats.
<node name="filecontents" spaces=" "><nodename>filecontents</nodename><nodenext automatic="on">flushleft</nodenext><nodeprev automatic="on">figure</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>filecontents</code>: Write an external file</sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="288"><r>environment</r>, <code>filecontents</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="289"><code>filecontents</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="299" mergedindex="cp"><r>environment</r>, <code>filecontents</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="300" mergedindex="cp"><code>filecontents</code> <r>environment</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="290"><r>environment</r>, <code>filecontents*</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="291"><code>filecontents*</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="301" mergedindex="cp"><r>environment</r>, <code>filecontents*</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="302" mergedindex="cp"><code>filecontents*</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="201">external files, writing</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="202">writing external files</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="261">external files, writing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="262">writing external files</indexterm></cindex>
<para>Synopsis:
</para>
@@ -3812,6 +4682,7 @@ end of the document, on a page of floats.
\end&lbrace;filecontents&rbrace;
</pre></example>
+<noindent></noindent>
<para>or
</para>
<example endspaces=" ">
@@ -3850,6 +4721,7 @@ Article by \myname.
\end&lbrace;document&rbrace;
</pre></example>
+<noindent></noindent>
<para>produces this file <file>JH.sty</file>.
</para>
<example endspaces=" ">
@@ -3865,25 +4737,44 @@ Article by \myname.
<node name="flushleft" spaces=" "><nodename>flushleft</nodename><nodenext automatic="on">flushright</nodenext><nodeprev automatic="on">filecontents</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>flushleft</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="292"><r>environment</r>, <code>flushleft</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="293"><code>flushleft</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="303" mergedindex="cp"><r>environment</r>, <code>flushleft</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="304" mergedindex="cp"><code>flushleft</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="203">left-justifying text, environment for</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="204">ragged right text, environment for</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="263">left-justifying text, environment for</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="264">ragged right text, environment for</indexterm></cindex>
+<para>Synopsis:
+</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;flushleft&rbrace;
-<var>line1</var> \\
-<var>line2</var> \\
-...
+ <var>line1</var> \\
+ <var>line2</var> \\
+ ...
\end&lbrace;flushleft&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="294">\\ <r>for <code>flushleft</code></r></indexterm></findex>
-<para>The <code>flushleft</code> environment allows you to create a paragraph
-consisting of lines that are flush to the left-hand margin and ragged
-right. Each line must be terminated with the string <code>\\</code>.
+<findex index="fn" spaces=" "><indexterm index="fn" number="305" mergedindex="cp">\\ <r>for <code>flushleft</code></r></indexterm></findex>
+<para>An environment that creates a paragraph whose lines are flush to the
+left-hand margin, and ragged right. If you have lines that are too long
+then &latex; will linebreak them in a way that avoids hyphenation and
+stretching or shrinking spaces. To force a new line use a double
+backslash, <code>\\</code>. For the declaration form
+see&nbsp;<ref label="_005craggedright"><xrefnodename>\raggedright</xrefnodename></ref>.
</para>
+<para>This creates a box of text that is at most 3 inches wide, with the text
+flush left and ragged right.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\noindent\begin&lbrace;minipage&rbrace;&lbrace;3in&rbrace;
+\begin&lbrace;flushleft&rbrace;
+ A long sentence that will be broken by \LaTeX&lbrace;&rbrace;
+ at a convenient spot. \\
+ And, a fresh line forced by the double backslash.
+\end&lbrace;flushleft&rbrace;
+\end&lbrace;minipage&rbrace;
+</pre></example>
+
+
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\raggedright</menunode><menudescription><pre xml:space="preserve">Declaration form of the <code>flushleft</code> environment.
</pre></menudescription></menuentry></menu>
@@ -3892,14 +4783,30 @@ right. Each line must be terminated with the string <code>\\</code>.
<node name="_005craggedright" spaces=" "><nodename>\raggedright</nodename><nodeup automatic="on">flushleft</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\raggedright</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="295">\raggedright</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="205">ragged right text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="206">left-justifying text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="207">justification, ragged right</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="306" mergedindex="cp">\raggedright</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="265">ragged right text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="266">left-justifying text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="267">justification, ragged right</indexterm></cindex>
+
+<para>Synopses:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">&lbrace;\raggedright ... &rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>or
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;<var>environment</var>&rbrace; \raggedright
+ ...
+\end&lbrace;<var>environment</var>&rbrace;
+</pre></example>
-<para>The <code>\raggedright</code> declaration corresponds to the
-<code>flushleft</code> environment. This declaration can be used inside an
-environment such as <code>quote</code> or in a <code>parbox</code>.
+<para>A declaration which causes lines to be flush to the left margin and
+ragged right. It can be used inside an environment such as <code>quote</code>
+or in a <code>parbox</code>. For the environment form
+see&nbsp;<ref label="flushleft"><xrefnodename>flushleft</xrefnodename></ref>.
</para>
<para>Unlike the <code>flushleft</code> environment, the <code>\raggedright</code>
command does not start a new paragraph; it only changes how &latex;
@@ -3907,30 +4814,48 @@ formats paragraph units. To affect a paragraph unit&textrsquo;s format, the
scope of the declaration must contain the blank line or <code>\end</code>
command that ends the paragraph unit.
</para>
+<para>Here <code>\raggedright</code> in each second column keeps &latex; from doing
+very awkward typesetting to fit the text into the narrow column. Note
+that <code>\raggedright</code> is inside the curly braces <code>&lbrace;...&rbrace;</code> to
+delimit its effect.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;tabular&rbrace;&lbrace;rp&lbrace;2in&rbrace;&rbrace;
+ Team alpha &amp;&lbrace;\raggedright This team does all the real work.&rbrace; \\
+ Team beta &amp;&lbrace;\raggedright This team ensures that the water
+ cooler is never empty.&rbrace; \\
+\end&lbrace;tabular&rbrace;
+</pre></example>
+
</subsection>
</section>
<node name="flushright" spaces=" "><nodename>flushright</nodename><nodenext automatic="on">itemize</nodenext><nodeprev automatic="on">flushleft</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>flushright</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="296"><r>environment</r>, <code>flushright</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="297"><code>flushright</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="307" mergedindex="cp"><r>environment</r>, <code>flushright</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="308" mergedindex="cp"><code>flushright</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="208">ragged left text, environment for</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="209">right-justifying text, environment for</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="268">ragged left text, environment for</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="269">right-justifying text, environment for</indexterm></cindex>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;flushright&rbrace;
-<var>line1</var> \\
-<var>line2</var> \\
-...
+ <var>line1</var> \\
+ <var>line2</var> \\
+ ...
\end&lbrace;flushright&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="298">\\ (for <code>flushright</code>)</indexterm></findex>
-<para>The <code>flushright</code> environment allows you to create a paragraph
-consisting of lines that are flush to the right-hand margin and ragged
-left. Each line must be terminated with the control sequence <code>\\</code>.
+<findex index="fn" spaces=" "><indexterm index="fn" number="309" mergedindex="cp">\\ (for <code>flushright</code>)</indexterm></findex>
+<para>An environment that creates a paragraph whose lines are flush to the
+right-hand margin and ragged left. If you have lines that are too long
+to fit the margins then &latex; will linebreak them in a way that
+avoids hyphenation and stretching or shrinking spaces. To force a new
+line use a double backslash, <code>\\</code>. For the declaration form
+see&nbsp;<ref label="_005craggedleft"><xrefnodename>\raggedleft</xrefnodename></ref>.
+</para>
+<para>For an example related to this environment, see&nbsp;<ref label="flushleft"><xrefnodename>flushleft</xrefnodename></ref>.
</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\raggedleft</menunode><menudescription><pre xml:space="preserve">Declaration form of the <code>flushright</code> environment.
@@ -3940,14 +4865,30 @@ left. Each line must be terminated with the control sequence <code>\\</code>.
<node name="_005craggedleft" spaces=" "><nodename>\raggedleft</nodename><nodeup automatic="on">flushright</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\raggedleft</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="299">\raggedleft</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="210">ragged left text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="211">justification, ragged left</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="212">right-justifying text</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="310" mergedindex="cp">\raggedleft</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="270">ragged left text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="271">justification, ragged left</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="272">right-justifying text</indexterm></cindex>
-<para>The <code>\raggedleft</code> declaration corresponds to the
-<code>flushright</code> environment. This declaration can be used inside an
-environment such as <code>quote</code> or in a <code>parbox</code>.
+<para>Synopses:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">&lbrace;\raggedleft ... &rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>or
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;<var>environment</var>&rbrace; \raggedleft
+ ...
+\end&lbrace;<var>environment</var>&rbrace;
+</pre></example>
+
+<para>A declaration which causes lines to be flush to the right margin and
+ragged left. It can be used inside an environment such as <code>quote</code>
+or in a <code>parbox</code>. For the environment form
+see&nbsp;<ref label="flushright"><xrefnodename>flushright</xrefnodename></ref>.
</para>
<para>Unlike the <code>flushright</code> environment, the <code>\raggedleft</code>
command does not start a new paragraph; it only changes how &latex;
@@ -3955,38 +4896,38 @@ formats paragraph units. To affect a paragraph unit&textrsquo;s format, the
scope of the declaration must contain the blank line or <code>\end</code>
command that ends the paragraph unit.
</para>
+<para>For an example related to this environment, see&nbsp;<ref label="_005craggedright"><xrefnodename>\raggedright</xrefnodename></ref>.
+</para>
</subsection>
</section>
<node name="itemize" spaces=" "><nodename>itemize</nodename><nodenext automatic="on">letter</nodenext><nodeprev automatic="on">flushright</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>itemize</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="300"><r>environment</r>, <code>itemize</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="301"><code>itemize</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="311" mergedindex="cp"><r>environment</r>, <code>itemize</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="312" mergedindex="cp"><code>itemize</code> <r>environment</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="302">\item</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="213">lists of items</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="214">unordered lists</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="215">bulleted lists</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="313" mergedindex="cp">\item</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="273">lists of items</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="274">unordered lists</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="275">bulleted lists</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="276">bullet lists</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;itemize&rbrace;
-\item[<var>optional label of first item</var>] text of first item
-\item[<var>optional label of second item</var>] text of second item
-...
+ \item[<var>optional label of first item</var>] <var>text of first item</var>
+ \item[<var>optional label of second item</var>] <var>text of second item</var>
+ ...
\end&lbrace;itemize&rbrace;
</pre></example>
-<para>The <code>itemize</code> environment produces an &textldquo;unordered&textrdquo;, &textldquo;bulleted&textrdquo;
-list. The format of the label numbering depends on the nesting level of
-this environment; see below. Each <code>itemize</code> list environment must
-have at least one item; having none causes the &latex; error
-<samp>Something's wrong--perhaps a missing \item</samp>.
+<para>Produce a list that is unordered, sometimes called a bullet list. The
+environment must have at least one <code>\item</code>; having none causes the
+&latex; error <samp>Something's wrong--perhaps a missing \item</samp>.
</para>
-<para>This example gives a two-item list. As a top-level list each label
-would come out as a bullet, &bullet;.
+<para>This gives a two-item list.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;itemize&rbrace;
@@ -3995,7 +4936,11 @@ would come out as a bullet, &bullet;.
\end&lbrace;itemize&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="303">\item</indexterm></findex>
+<noindent></noindent>
+<para>As a top-level list each label would come out as a bullet, &bullet;.
+The format of the labeling depends on the nesting level; see below.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="314" mergedindex="cp">\item</indexterm></findex>
<para>Start list items with the <code>\item</code> command (<pxref label="_005citem"><xrefnodename>\item</xrefnodename></pxref>). If you
give <code>\item</code> an optional argument by following it with square
brackets, as in <code>\item[Optional label]</code>, then by default it will
@@ -4004,15 +4949,19 @@ margin. For labels that are flush left see the <ref label="description"><xrefno
environment. Following the <code>\item</code> is optional text, which may
contain multiple paragraphs.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="304">\labelitemi</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="305">\labelitemii</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="306">\labelitemiii</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="307">\labelitemiv</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="315" mergedindex="cp">\labelitemi</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="316" mergedindex="cp">\labelitemii</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="317" mergedindex="cp">\labelitemiii</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="318" mergedindex="cp">\labelitemiv</indexterm></findex>
+<anchor name="itemize-labelitemi">itemize labelitemi</anchor>
+<anchor name="itemize-labelitemii">itemize labelitemii</anchor>
+<anchor name="itemize-labelitemiii">itemize labelitemiii</anchor>
+<anchor name="itemize-labelitemiv">itemize labelitemiv</anchor>
<para>Itemized lists can be nested within one another, up to four levels deep.
They can also be nested within other paragraph-making environments, such
as <code>enumerate</code> (<pxref label="enumerate"><xrefnodename>enumerate</xrefnodename></pxref>). The <code>itemize</code> environment
uses the commands <code>\labelitemi</code> through <code>\labelitemiv</code> to
-produce the default label (this also uses the convention of lower case
+produce the default label (this also uses the convention of lowercase
roman numerals at the end of the command names that signify the nesting
level). These are the default marks at each level.
</para>
@@ -4030,17 +4979,24 @@ the first level use diamonds.
<pre xml:space="preserve">\renewcommand&lbrace;\labelitemi&rbrace;&lbrace;$\diamond$&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="308">\leftmargin</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="309">\leftmargini</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="310">\leftmarginii</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="311">\leftmarginiii</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="312">\leftmarginiv</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="313">\leftmarginv</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="314">\leftmarginvi</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="319" mergedindex="cp">\leftmargin</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="320" mergedindex="cp">\leftmargini</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="321" mergedindex="cp">\leftmarginii</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="322" mergedindex="cp">\leftmarginiii</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="323" mergedindex="cp">\leftmarginiv</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="324" mergedindex="cp">\leftmarginv</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="325" mergedindex="cp">\leftmarginvi</indexterm></findex>
+<anchor name="itemize-leftmargin">itemize leftmargin</anchor>
+<anchor name="itemize-leftmargini">itemize leftmargini</anchor>
+<anchor name="itemize-leftmarginii">itemize leftmarginii</anchor>
+<anchor name="itemize-leftmarginiii">itemize leftmarginiii</anchor>
+<anchor name="itemize-leftmarginiv">itemize leftmarginiv</anchor>
+<anchor name="itemize-leftmarginv">itemize leftmarginv</anchor>
+<anchor name="itemize-leftmarginvi">itemize leftmarginvi</anchor>
<para>The distance between the left margin of the enclosing environment and
the left margin of the <code>itemize</code> list is determined by the
parameters <code>\leftmargini</code> through <code>\leftmarginvi</code>. (Note the
-convention of using lower case roman numerals a the end of the command
+convention of using lowercase roman numerals a the end of the command
name to denote the nesting level.) The defaults are: <code>2.5em</code> in
level 1 (<code>2em</code> in two-column mode), <code>2.2em</code> in level 2,
<code>1.87em</code> in level 3, and <code>1.7em</code> in level 4, with smaller
@@ -4059,12 +5015,12 @@ lists.
<pre xml:space="preserve">\setlength&lbrace;\leftmargini&rbrace;&lbrace;1.25em&rbrace; % default 2.5em
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="315">\parskip <r>example</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="326" mergedindex="cp">\parskip <r>example</r></indexterm></findex>
<para>Especially for lists with short items, it may be desirable to elide
space between items. Here is an example defining an <code>itemize*</code>
environment with no extra spacing between items, or between paragraphs
within a single item (<code>\parskip</code> is not list-specific,
-<pxref label="_005cparskip"><xrefnodename>\parskip</xrefnodename></pxref>):
+<pxref label="_005cparindent-_0026-_005cparskip"><xrefnodename>\parindent &amp; \parskip</xrefnodename></pxref>):
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newenvironment&lbrace;itemize*&rbrace;%
@@ -4080,8 +5036,8 @@ within a single item (<code>\parskip</code> is not list-specific,
<node name="letter" spaces=" "><nodename>letter</nodename><nodenext automatic="on">list</nodenext><nodeprev automatic="on">itemize</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>letter</code> environment: writing letters</sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="316"><r>environment</r>, <code>letter</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="317"><code>letter</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="327" mergedindex="cp"><r>environment</r>, <code>letter</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="328" mergedindex="cp"><code>letter</code> <r>environment</r></indexterm></findex>
<para>This environment is used for creating letters. <xref label="Letters"><xrefnodename>Letters</xrefnodename></xref>.
@@ -4091,45 +5047,44 @@ within a single item (<code>\parskip</code> is not list-specific,
<node name="list" spaces=" "><nodename>list</nodename><nodenext automatic="on">math</nodenext><nodeprev automatic="on">letter</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>list</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="318"><r>environment</r>, <code>list</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="319"><code>list</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="329" mergedindex="cp"><r>environment</r>, <code>list</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="330" mergedindex="cp"><code>list</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="216">lists of items, generic</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="277">lists of items, generic</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;list&rbrace;&lbrace;<var>labeling</var>&rbrace;&lbrace;<var>spacing</var>&rbrace;
-\item[<var>optional label of first item</var>] text of first item
-\item[<var>optional label of second item</var>] text of second item
-...
+ \item[<var>optional label of first item</var>] <var>text of first item</var>
+ \item[<var>optional label of second item</var>] <var>text of second item</var>
+ ...
\end&lbrace;list&rbrace;
</pre></example>
-<para>The <code>list</code> environment is a generic environment for constructing
-more specialized lists. It is most often used to create lists via the
-<code>description</code>, <code>enumerate</code>, and <code>itemize</code> environments
-(<pxref label="description"><xrefnodename>description</xrefnodename></pxref>, <ref label="enumerate"><xrefnodename>enumerate</xrefnodename></ref>, and <ref label="itemize"><xrefnodename>itemize</xrefnodename></ref>).
+<para>An environment for constructing lists.
</para>
-<para>Also, many standard &latex; environments that are not visually lists
-are constructed using <code>list</code>, including <code>quotation</code>,
-<code>quote</code>, <code>center</code>, <code>verbatim</code>, and plenty more
-(<pxref label="quotation-and-quote"><xrefnodename>quotation and quote</xrefnodename></pxref>, <pxref label="center"><xrefnodename>center</xrefnodename></pxref>, <pxref label="flushright"><xrefnodename>flushright</xrefnodename></pxref>).
+<para>Note that this environment does not typically appear in the document
+body. Most lists created by &latex; authors are the ones that come
+standard: the <code>description</code>, <code>enumerate</code>, and <code>itemize</code>
+environments (<pxref label="description"><xrefnodename>description</xrefnodename></pxref>, <ref label="enumerate"><xrefnodename>enumerate</xrefnodename></ref>, and <ref label="itemize"><xrefnodename>itemize</xrefnodename></ref>).
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="217"><r>package</r>, <code>enumitem</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="218"><code>enumitem</code> <r>package</r></indexterm></cindex>
-
-<para>The third-party package <code>enumitem</code> is useful for customizing lists.
-Here, we describe the <code>list</code> environment by defining a new custom
+<para>Instead, the <code>list</code> environment is most often used in macros. For
+example, many standard &latex; environments that do not immediately
+appear to be lists are in fact constructed using <code>list</code>, including
+<code>quotation</code>, <code>quote</code>, and <code>center</code> (<pxref label="quotation-_0026-quote"><xrefnodename>quotation &amp;
+quote</xrefnodename></pxref>, <pxref label="center"><xrefnodename>center</xrefnodename></pxref>).
+</para>
+<para>This uses the <code>list</code> environment to define a new custom
environment.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newcounter&lbrace;namedlistcounter&rbrace; % number the items
\newenvironment&lbrace;named&rbrace;
&lbrace;\begin&lbrace;list&rbrace;
- &lbrace;Item~\Roman&lbrace;namedlistcounter&rbrace;.&rbrace; % labeling argument
- &lbrace;\usecounter&lbrace;namedlistcounter&rbrace; % spacing argument
- \setlength&lbrace;\leftmargin&rbrace;&lbrace;3.5em&rbrace;&rbrace; % still spacing arg
+ &lbrace;Item~\Roman&lbrace;namedlistcounter&rbrace;.&rbrace; % labeling
+ &lbrace;\usecounter&lbrace;namedlistcounter&rbrace; % set counter
+ \setlength&lbrace;\leftmargin&rbrace;&lbrace;3.5em&rbrace;&rbrace; % set spacing
&rbrace;
&lbrace;\end&lbrace;list&rbrace;&rbrace;
@@ -4140,55 +5095,58 @@ environment.
\end&lbrace;named&rbrace;
</pre></example>
-<para>The <code>list</code> environment&textrsquo;s mandatory first argument,
-<var>labeling</var>, specifies the default labeling of list items. It can
-contain text and &latex; commands, as above where it contains both
-<samp>Item</samp> and <samp>\Roman&lbrace;...&rbrace;</samp>. &latex; forms the label by
-putting the <var>labeling</var> argument in a box of width
-<code>\labelwidth</code>. If the label is wider than that, the additional
-material extends to the right. When making an instance of a list you
-can override the default labeling by giving <code>\item</code> an optional
-argument by including square braces and the text, as in the above
-<code>\item[Special label.]</code>; <pxref label="_005citem"><xrefnodename>\item</xrefnodename></pxref>.
-</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="320">\makelabel</indexterm></findex>
-<para>The label box is constructed by the command <code>\makelabel</code>. By
-default it positions the contents flush right. It takes one argument,
-the label. It typesets the contents in LR mode. An example of changing
-its definition is that to the above example before the definition of the
-<code>named</code> environment add
+<para>The mandatory first argument <var>labeling</var> specifies the default
+labeling of list items. It can contain text and &latex; commands, as
+above where it contains both <samp>Item</samp> and <samp>\Roman&lbrace;...&rbrace;</samp>.
+&latex; forms the label by putting the <var>labeling</var> argument in a box
+of width <code>\labelwidth</code>. If the label is wider than that, the
+additional material extends to the right. When making an instance of a
+list you can override the default labeling by giving <code>\item</code> an
+optional argument by including square braces and the text, as in the
+above <code>\item[Special label.]</code>; <pxref label="_005citem"><xrefnodename>\item</xrefnodename></pxref>.
+</para>
+<para>The mandatory second argument <var>spacing</var> has a list of commands.
+This list can be empty. A command that can go in here is
+<code>\usecounter&lbrace;<var>countername</var>&rbrace;</code> (<pxref label="_005cusecounter"><xrefnodename>\usecounter</xrefnodename></pxref>). Use this
+to tell &latex; to number the items using the given counter. The
+counter will be reset to zero each time &latex; enters the environment,
+and the counter is incremented by one each time &latex; encounters an
+<code>\item</code> that does not have an optional argument.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="331" mergedindex="cp">\makelabel</indexterm></findex>
+<anchor name="list-makelabel">list makelabel</anchor> <para>Another command that can go in <var>spacing</var> is
+<code>\makelabel</code>, which constructs the label box. By default it puts
+the contents flush right. Its only argument is the label, which it
+typesets in LR mode (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>). One example of changing its
+definition is that to the above <code>named</code> example, before the
+definition of the environment add
<code>\newcommand&lbrace;\namedmakelabel&rbrace;[1]&lbrace;\textsc&lbrace;#1&rbrace;&rbrace;</code>, and between
the <code>\setlength</code> command and the parenthesis that closes the
<var>spacing</var> argument also add <code>\let\makelabel\namedmakelabel</code>.
Then the items will be typeset in small caps. Similarly, changing the
second code line to <code>\let\makelabel\fbox</code> puts the labels inside a
-framed box. Another example is at the bottom of this entry.
-</para>
-<para>The mandatory second argument <var>spacing</var> can have a list of
-commands to redefine the spacing parameters for the list, such as
-<code>\setlength&lbrace;\labelwidth&rbrace;&lbrace;2em&rbrace;</code>. If this argument is empty,
-i.e., <code>&lbrace;&rbrace;</code>, then the list will have the default spacing given
-below. To number the items using a counter, put
-<code>\usecounter&lbrace;<var>countername</var>&rbrace;</code> in this argument
-(<pxref label="_005cusecounter"><xrefnodename>\usecounter</xrefnodename></pxref>).
-</para>
-<para>Below are the spacing parameters for list formatting. See also the
-figure below. Each is a length (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). The vertical
-spaces are normally rubber lengths, with <code>plus</code> and <code>minus</code>
-components, to give &tex; flexibility in setting the page. Change
-each with a command such as <code>\setlength&lbrace;itemsep&rbrace;&lbrace;2pt plus1pt
-minus1pt&rbrace;</code>. For some effects these lengths should be zero or
-negative. Default values for derived environments such as
-<code>itemize</code> can be changed from the values shown here for the basic
-<code>list</code>.
+framed box. Another example of the <code>\makelabel</code> command is below,
+in the definition of the <code>redlabel</code> environment.
+</para>
+<para>Also often in <var>spacing</var> are commands to redefine the spacing for the
+list. Below are the spacing parameters with their default values.
+(Default values for derived environments such as <code>itemize</code> can be
+different than the values shown here.) See also the figure that follows
+the list. Each is a length (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). The vertical spaces are
+normally rubber lengths, with <code>plus</code> and <code>minus</code> components,
+to give &tex; flexibility in setting the page. Change each with a
+command such as <code>\setlength&lbrace;itemsep&rbrace;&lbrace;2pt plus1pt minus1pt&rbrace;</code>.
+For some effects these lengths should be zero or negative.
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="321">\itemindent</indexterm>\itemindent</itemformat></item>
-</tableterm><tableitem><para>Extra horizontal space indentation, beyond <code>leftmargin</code>, of the
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="332" mergedindex="cp">\itemindent</indexterm>\itemindent</itemformat></item>
+</tableterm><tableitem><anchor name="list-itemindent">list itemindent</anchor>
+<para>Extra horizontal space indentation, beyond <code>leftmargin</code>, of the
first line each item. Its default value is <code>0pt</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="322">\itemsep</indexterm>\itemsep</itemformat></item>
-</tableterm><tableitem><para>Vertical space between items, beyond the <code>\parsep</code>. The defaults
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="333" mergedindex="cp">\itemsep</indexterm>\itemsep</itemformat></item>
+</tableterm><tableitem><anchor name="list-itemsep">list itemsep</anchor>
+<para>Vertical space between items, beyond the <code>\parsep</code>. The defaults
for the first three levels in &latex;&textrsquo;s <samp>article</samp>, <samp>book</samp>,
and <samp>report</samp> classes at 10 point size are: <code>4pt plus2pt
minus1pt</code>, <code>\parsep</code> (that is, <code>2pt plus1pt minus1pt</code>), and
@@ -4199,13 +5157,15 @@ plus1pt minus1pt</code>). The defaults at 12 point are: <code>5pt plus2.5pt
minus1pt</code>, <code>\parsep</code> (that is, <code>2.5pt plus1pt minus1pt</code>), and
<code>\topsep</code> (that is, <code>2.5pt plus1pt minus1pt</code>).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="323">\labelsep</indexterm>\labelsep</itemformat></item>
-</tableterm><tableitem><para>Horizontal space between the label and text of an item.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="334" mergedindex="cp">\labelsep</indexterm>\labelsep</itemformat></item>
+</tableterm><tableitem><anchor name="list-labelsep">list labelsep</anchor>
+<para>Horizontal space between the label and text of an item.
The default for &latex;&textrsquo;s <samp>article</samp>, <samp>book</samp>,
and <samp>report</samp> classes is <code>0.5em</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="324">\labelwidth</indexterm>\labelwidth</itemformat></item>
-</tableterm><tableitem><para>Horizontal width. The box containing the label is nominally this wide.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="335" mergedindex="cp">\labelwidth</indexterm>\labelwidth</itemformat></item>
+</tableterm><tableitem><anchor name="list-labelwidth">list labelwidth</anchor>
+<para>Horizontal width. The box containing the label is nominally this wide.
If <code>\makelabel</code> returns text that is wider than this then the first
line of the item will be indented to make room for this extra material.
If <code>\makelabel</code> returns text of width less than or equal to
@@ -4225,8 +5185,9 @@ mode and <code>1.5em</code> in two column mode). At the second level it is
label&textrsquo;s left edge coincide with the left margin of the enclosing
environment.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="325">\leftmargin</indexterm>\leftmargin</itemformat></item>
-</tableterm><tableitem><para>Horizontal space between the left margin of the enclosing environment
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="336" mergedindex="cp">\leftmargin</indexterm>\leftmargin</itemformat></item>
+</tableterm><tableitem><anchor name="list-leftmargin">list leftmargin</anchor>
+<para>Horizontal space between the left margin of the enclosing environment
(or the left margin of the page if this is a top-level list), and the
left margin of this list. It must be non-negative.
</para>
@@ -4242,14 +5203,16 @@ error message <samp>Too deeply nested</samp>.)
<code>2.5em</code> (in two column mode, <code>2em</code>), <code>\leftmarginii</code> is
<code>2.2em</code>, and <code>\leftmarginiii</code> is <code>1.87em</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="326">\listparindent</indexterm>\listparindent</itemformat></item>
-</tableterm><tableitem><para>Horizontal space of additional line indentation, beyond
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="337" mergedindex="cp">\listparindent</indexterm>\listparindent</itemformat></item>
+</tableterm><tableitem><anchor name="list-listparindent">list listparindent</anchor>
+<para>Horizontal space of additional line indentation, beyond
<code>\leftmargin</code>, for second and subsequent paragraphs within a list
item. A negative value makes this an &textldquo;outdent&textrdquo;. Its default value
is <code>0pt</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="327">\parsep</indexterm>\parsep</itemformat></item>
-</tableterm><tableitem><para>Vertical space between paragraphs within an item. In the <samp>book</samp>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="338" mergedindex="cp">\parsep</indexterm>\parsep</itemformat></item>
+</tableterm><tableitem><anchor name="list-parsep">list parsep</anchor>
+<para>Vertical space between paragraphs within an item. In the <samp>book</samp>
and <samp>article</samp> classes The defaults for the first three levels in
&latex;&textrsquo;s <samp>article</samp>, <samp>book</samp>, and <samp>report</samp> classes at 10
point size are: <code>4pt plus2pt minus1pt</code>, <code>2pt plus1pt
@@ -4258,8 +5221,9 @@ minus1pt</code>, and <code>0pt</code>. The defaults at 11 point size are:
<code>0pt</code>. The defaults at 12 point size are: <code>5pt plus2.5pt
minus1pt</code>, <code>2.5pt plus1pt minus1pt</code>, and <code>0pt</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="328">\partopsep</indexterm>\partopsep</itemformat></item>
-</tableterm><tableitem><para>Vertical space added, beyond <code>\topsep</code>+<code>\parskip</code>, to the top
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="339" mergedindex="cp">\partopsep</indexterm>\partopsep</itemformat></item>
+</tableterm><tableitem><anchor name="list-partopsep">list partopsep</anchor>
+<para>Vertical space added, beyond <code>\topsep</code>+<code>\parskip</code>, to the top
and bottom of the entire environment if the list instance is preceded by
a blank line. (A blank line in the &latex; source before the list
changes spacing at both the top and bottom of the list; whether the line
@@ -4273,21 +5237,23 @@ minus1pt</code>. The defaults at 11 point are: <code>3pt plus1pt minus1pt</code
defaults at 12 point are: <code>3pt plus2pt minus3pt</code>, <code>3pt plus2pt
minus2pt</code>, and <code>1pt plus0pt minus1pt</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="329">\rightmargin</indexterm>\rightmargin</itemformat></item>
-</tableterm><tableitem><para>Horizontal space between the right margin of the list and the right
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="340" mergedindex="cp">\rightmargin</indexterm>\rightmargin</itemformat></item>
+</tableterm><tableitem><anchor name="list-rightmargin">list rightmargin</anchor>
+<para>Horizontal space between the right margin of the list and the right
margin of the enclosing environment. Its default value is <code>0pt</code>.
It must be non-negative.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="330">\topsep</indexterm>\topsep</itemformat></item>
-</tableterm><tableitem><para>Vertical space added to both the top and bottom of the list, in addition
-to <code>\parskip</code> (<pxref label="_005cparskip"><xrefnodename>\parskip</xrefnodename></pxref>). The defaults for the first three
-levels in &latex;&textrsquo;s <samp>article</samp>, <samp>book</samp>, and <samp>report</samp>
-classes at 10 point size are: <code>8pt plus2pt minus4pt</code>, <code>4pt
-plus2pt minus1pt</code>, and <code>2pt plus1pt minus1pt</code>. The defaults at 11
-point are: <code>9pt plus3pt minus5pt</code>, <code>4.5pt plus2pt minus1pt</code>,
-and <code>2pt plus1pt minus1pt</code>. The defaults at 12 point are:
-<code>10pt plus4pt minus6pt</code>, <code>5pt plus2.5pt minus1pt</code>, and
-<code>2.5pt plus1pt minus1pt</code>.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="341" mergedindex="cp">\topsep</indexterm>\topsep</itemformat></item>
+</tableterm><tableitem><anchor name="list-topsep">list topsep</anchor>
+<para>Vertical space added to both the top and bottom of the list, in addition
+to <code>\parskip</code> (<pxref label="_005cparindent-_0026-_005cparskip"><xrefnodename>\parindent &amp; \parskip</xrefnodename></pxref>). The defaults for
+the first three levels in &latex;&textrsquo;s <samp>article</samp>, <samp>book</samp>, and
+<samp>report</samp> classes at 10 point size are: <code>8pt plus2pt minus4pt</code>,
+<code>4pt plus2pt minus1pt</code>, and <code>2pt plus1pt minus1pt</code>. The
+defaults at 11 point are: <code>9pt plus3pt minus5pt</code>, <code>4.5pt
+plus2pt minus1pt</code>, and <code>2pt plus1pt minus1pt</code>. The defaults at 12
+point are: <code>10pt plus4pt minus6pt</code>, <code>5pt plus2.5pt minus1pt</code>,
+and <code>2.5pt plus1pt minus1pt</code>.
</para>
</tableitem></tableentry></ftable>
@@ -4319,6 +5285,9 @@ the list environment does not start a new paragraph, and
appears in the source above the environment; whether a blank line
appears in the source below the environment does not matter.)
</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">h0</itemformat></item>
+</tableterm><tableitem><para><code>\labelwidth</code>
+</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">h1</itemformat></item>
</tableterm><tableitem><para><code>\labelsep</code>
</para>
@@ -4353,19 +5322,28 @@ e.g., <code>\&arobase;beginparpenalty=9999</code>; a value of 10000 prohibits a
page break.
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="331">\&arobase;beginparpenalty</indexterm>\&arobase;beginparpenalty</itemformat></item>
-</tableterm><tableitem><para>The page breaking penalty for breaking before the list (default <code>-51</code>).
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="342" mergedindex="cp">\&arobase;beginparpenalty</indexterm>\&arobase;beginparpenalty</itemformat></item>
+</tableterm><tableitem><anchor name="list-beginparpenalty">list beginparpenalty</anchor>
+<para>The page breaking penalty for breaking before the list (default <code>-51</code>).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="332">\&arobase;itempenalty</indexterm>\&arobase;itempenalty</itemformat></item>
-</tableterm><tableitem><para>The page breaking penalty for breaking before a list item (default <code>-51</code>).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="343" mergedindex="cp">\&arobase;itempenalty</indexterm>\&arobase;itempenalty</itemformat></item>
+</tableterm><tableitem><anchor name="list-itempenalty">list itempenalty</anchor>
+<para>The page breaking penalty for breaking before a list item (default <code>-51</code>).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="333">\&arobase;endparpenalty</indexterm>\&arobase;endparpenalty</itemformat></item>
-</tableterm><tableitem><para>The page breaking penalty for breaking after a list (default <code>-51</code>).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="344" mergedindex="cp">\&arobase;endparpenalty</indexterm>\&arobase;endparpenalty</itemformat></item>
+</tableterm><tableitem><anchor name="list-endparpenalty">list endparpenalty</anchor>
+<para>The page breaking penalty for breaking after a list (default <code>-51</code>).
</para>
</tableitem></tableentry></ftable>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="278"><r>package</r>, <code>enumitem</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="279"><code>enumitem</code> <r>package</r></indexterm></cindex>
+
+<para>The package <code>enumitem</code> is useful for customizing lists.
+</para>
<para>This example has the labels in red. They are numbered, and the left
edge of the label lines up with the left edge of the item text.
+<xref label="_005cusecounter"><xrefnodename>\usecounter</xrefnodename></xref>.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\usepackage&lbrace;color&rbrace;
@@ -4400,8 +5378,10 @@ edge of the label lines up with the left edge of the item text.
<pre xml:space="preserve">\item text of item
</pre></example>
+<noindent></noindent>
<para>or
-</para><example endspaces=" ">
+</para>
+<example endspaces=" ">
<pre xml:space="preserve">\item[<var>optional-label</var>] text of item
</pre></example>
@@ -4489,10 +5469,10 @@ default) they have no paragraph indent and are vertically separated.
<node name="math" spaces=" "><nodename>math</nodename><nodenext automatic="on">minipage</nodenext><nodeprev automatic="on">list</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>math</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="334"><r>environment</r>, <code>math</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="335"><code>math</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="345" mergedindex="cp"><r>environment</r>, <code>math</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="346" mergedindex="cp"><code>math</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="219">in-line formulas</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="280">in-line formulas</indexterm></cindex>
<para>Synopsis:
</para>
@@ -4511,34 +5491,139 @@ the running text. <code>\(...\)</code> and <code>$...$</code> are synonyms.
<node name="minipage" spaces=" "><nodename>minipage</nodename><nodenext automatic="on">picture</nodenext><nodeprev automatic="on">math</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>minipage</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="336"><r>environment</r>, <code>minipage</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="337"><code>minipage</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="347" mergedindex="cp"><r>environment</r>, <code>minipage</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="348" mergedindex="cp"><code>minipage</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="220">minipage, creating a</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="281">minipage, creating a</indexterm></cindex>
+<para>Synopses:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;minipage&rbrace;&lbrace;<var>width</var>&rbrace;
+ <var>contents</var>
+\end&lbrace;minipage&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>or
+</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;minipage&rbrace;[<var>position</var>][<var>height</var>][<var>inner-pos</var>]&lbrace;<var>width</var>&rbrace;
-<var>text</var>
+ <var>contents</var>
+\end&lbrace;minipage&rbrace;
+</pre></example>
+
+<para>Put <var>contents</var> into a box that is <var>width</var> wide. This is like a
+small version of a page; it can contain its own footnotes, itemized
+lists, etc. (There are some restrictions, including that it cannot have
+floats.) This box will not be broken across pages. So <code>minipage</code>
+is similar to <code>\parbox</code> (<pxref label="_005cparbox"><xrefnodename>\parbox</xrefnodename></pxref>) but here you can have
+paragraphs.
+</para>
+<para>This example will be 3&nbsp;inches wide, and has two paragraphs.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;minipage&rbrace;&lbrace;3in&rbrace;
+ Stephen Kleene was a founder of the Theory of Computation.
+
+ He was a student of Church, wrote three influential texts,
+ was President of the Association for Symbolic Logic,
+ and won the National Medal of Science.
+\end&lbrace;minipage&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>See below for a discussion of the paragraph indent inside a
+<code>minipage</code>.
+</para>
+<para>The required argument <var>width</var> is a rigid length (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>).
+It gives the width of the box into which <var>contents</var> are typeset.
+</para>
+<para>There are three optional arguments, <var>position</var>, <var>height</var>, and
+<var>inner-pos</var>. You need not include all three. For example, get the
+default <var>position</var> and set the <var>height</var> with
+<code>\begin&lbrace;minipage&rbrace;[c][2.54cm] <var>contents</var> \end&lbrace;minipage&rbrace;</code>.
+(Get the natural height with an empty argument, <code>[]</code>.)
+</para>
+<para>The optional argument <var>position</var> governs how the <code>minipage</code>
+vertically aligns with the surrounding material.
+</para>
+<table commandarg="code" spaces=" " endspaces=" ">
+<tableentry><tableterm><item spaces=" "><itemformat command="code">c</itemformat></item>
+</tableterm><tableitem><para>(synonym <code>m</code>) Default. Positions the <code>minipage</code> so its
+vertical center lines up with the center of the adjacent text line (what
+Plain &tex; calls <code>\vcenter</code>).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">t</itemformat></item>
+</tableterm><tableitem><para>Match the top line in the <code>minipage</code> with the baseline of the
+surrounding text (Plain &tex;&textrsquo;s <code>\vtop</code>.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">b</itemformat></item>
+</tableterm><tableitem><para>Match the bottom line in the <code>minipage</code> with the baseline of the
+surrounding text (Plain &tex;&textrsquo;s <code>\vbox</code>.
+</para></tableitem></tableentry></table>
+
+<para>To see the effects of these, contrast running this
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">---\begin&lbrace;minipage&rbrace;[c]&lbrace;0.25in&rbrace;
+ first\\ second\\ third
\end&lbrace;minipage&rbrace;
</pre></example>
-<para>The <code>minipage</code> environment typesets its body <var>text</var> in a
-block that will not be broken across pages. This is similar to the
-<code>\parbox</code> command (<pxref label="_005cparbox"><xrefnodename>\parbox</xrefnodename></pxref>), but unlike <code>\parbox</code>,
-other paragraph-making environments can be used inside a minipage.
+<noindent></noindent>
+<para>with the results of changing <code>c</code> to <code>b</code> or&nbsp;<code>t</code>.
+</para>
+<para>The optional argument <var>height</var> is a rigid length (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>).
+It sets the height of the <code>minipage</code>. You can enter any value
+larger than, or equal to, or smaller than the <code>minipage</code>&textrsquo;s natural
+height and &latex; will not give an error or warning. You can also set
+it to a height of zero or a negative value.
+</para>
+<para>The final optional argument <var>inner-pos</var> controls the placement of
+<var>content</var> inside the box. These are the possible values are (the
+default is the value of <var>position</var>).
+</para>
+<table commandarg="code" spaces=" " endspaces=" ">
+<tableentry><tableterm><item spaces=" "><itemformat command="code">t</itemformat></item>
+</tableterm><tableitem><para>Place <var>content</var> at the top of the box.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">c</itemformat></item>
+</tableterm><tableitem><para>Place it in the vertical center.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">b</itemformat></item>
+</tableterm><tableitem><para>Place it at the box bottom.
</para>
-<!-- c (xxref positions) -->
-<para>The arguments are the same as for <code>\parbox</code> (<pxref label="_005cparbox"><xrefnodename>\parbox</xrefnodename></pxref>).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">s</itemformat></item>
+</tableterm><tableitem><para>Stretch <var>contents</var> out vertically; it must contain vertically
+stretchable space.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="221">indentation of paragraphs, in minipage</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="222">paragraph indentation, in minipage</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="338">\parindent</indexterm></findex>
-<para>By default, paragraphs are not indented in the <code>minipage</code>
-environment. You can restore indentation with a command such as
-<code>\setlength&lbrace;\parindent&rbrace;&lbrace;1pc&rbrace;</code> command.
+</tableitem></tableentry></table>
+
+<para>The <var>inner-pos</var> argument makes sense when the <var>height</var> options
+is set to a value larger than the <code>minipage</code>&textrsquo;s natural height. To
+see the effect of the options, run this example with the various choices
+in place of <code>b</code>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">Text before
+\begin&lbrace;center&rbrace;
+ ---\begin&lbrace;minipage&rbrace;[c][3in][b]&lbrace;0.25\textwidth&rbrace;
+ first\\ second\\ third
+ \end&lbrace;minipage&rbrace;
+\end&lbrace;center&rbrace;
+Text after
+</pre></example>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="282">indentation of paragraphs, in minipage</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="283">paragraph indentation, in minipage</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="349" mergedindex="cp">\parindent</indexterm></findex>
+<para>By default paragraphs are not indented in a <code>minipage</code>. Change
+that with a command such as <code>\setlength&lbrace;\parindent&rbrace;&lbrace;1pc&rbrace;</code> at
+the start of <var>contents</var>.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="223">footnotes in figures</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="224">figures, footnotes in</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="284">footnotes in figures</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="285">figures, footnotes in</indexterm></cindex>
<para>Footnotes in a <code>minipage</code> environment are handled in a way that is
particularly useful for putting footnotes in figures or tables. A
<code>\footnote</code> or <code>\footnotetext</code> command puts the footnote at
@@ -4546,485 +5631,858 @@ the bottom of the minipage instead of at the bottom of the page, and it
uses the <code>\mpfootnote</code> counter instead of the ordinary
<code>footnote</code> counter (<pxref label="Counters"><xrefnodename>Counters</xrefnodename></pxref>).
</para>
-<para>However, don&textrsquo;t put one minipage inside another if you are using
-footnotes; they may wind up at the bottom of the wrong minipage.
+<para>This puts the footnote at the bottom of the table, not the bottom of the
+page.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;center&rbrace; % center the minipage on the line
+\begin&lbrace;minipage&rbrace;&lbrace;2.5in&rbrace;
+ \begin&lbrace;center&rbrace; % center the table inside the minipage
+ \begin&lbrace;tabular&rbrace;&lbrace;ll&rbrace;
+ \textsc&lbrace;Monarch&rbrace; &amp;\textsc&lbrace;Reign&rbrace; \\ \hline
+ Elizabeth II &amp;63 years\footnote&lbrace;to date&rbrace; \\
+ Victoria &amp;63 years \\
+ George III &amp;59 years
+ \end&lbrace;tabular&rbrace;
+ \end&lbrace;center&rbrace;
+\end&lbrace;minipage&rbrace;
+\end&lbrace;center&rbrace;
+</pre></example>
+
+<para>If you nest minipages then there is an oddness when using footnotes.
+Footnotes appear at the bottom of the text ended by the next
+<code>\end&lbrace;minipage&rbrace;</code> which may not be their logical place.
+</para>
+<para>This puts a table containing data side by side with a map graphic. They
+are vertically centered.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand*&lbrace;\vcenteredhbox&rbrace;[1]&lbrace;\begin&lbrace;tabular&rbrace;&lbrace;&arobase;&lbrace;&rbrace;c&arobase;&lbrace;&rbrace;&rbrace;#1\end&lbrace;tabular&rbrace;&rbrace;
+ ...
+\begin&lbrace;center&rbrace;
+ \vcenteredhbox&lbrace;\includegraphics[width=0.3\textwidth]&lbrace;nyc.png&rbrace;&rbrace;
+ \hspace&lbrace;0.1\textwidth&rbrace;
+ \begin&lbrace;minipage&rbrace;&lbrace;0.5\textwidth&rbrace;
+ \begin&lbrace;tabular&rbrace;&lbrace;r|l&rbrace;
+ \multicolumn&lbrace;1&rbrace;&lbrace;r&rbrace;&lbrace;Borough&rbrace; &amp;Pop (million) \\ \hline
+ The Bronx &amp;$1.5$ \\
+ Brooklyn &amp;$2.6$ \\
+ Manhattan &amp;$1.6$ \\
+ Queens &amp;$2.3$ \\
+ Staten Island &amp;$0.5$
+ \end&lbrace;tabular&rbrace;
+ \end&lbrace;minipage&rbrace;
+\end&lbrace;center&rbrace;
+</pre></example>
+
</section>
-<node name="picture" spaces=" "><nodename>picture</nodename><nodenext automatic="on">quotation and quote</nodenext><nodeprev automatic="on">minipage</nodeprev><nodeup automatic="on">Environments</nodeup></node>
+<node name="picture" spaces=" "><nodename>picture</nodename><nodenext automatic="on">quotation &amp; quote</nodenext><nodeprev automatic="on">minipage</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>picture</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="339"><r>environment</r>, <code>picture</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="340"><code>picture</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="350" mergedindex="cp"><r>environment</r>, <code>picture</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="351" mergedindex="cp"><code>picture</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="225">creating pictures</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="226">pictures, creating</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="286">creating pictures</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="287">pictures, creating</indexterm></cindex>
+<para>Synopses:
+</para><example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;picture&rbrace;(<var>width</var>,<var>height</var>)
+ <var>picture commands</var>
+\end&lbrace;picture&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>or
+</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;picture&rbrace;(<var>width</var>,<var>height</var>)(<var>xoffset</var>,<var>yoffset</var>)
-&dots; <var>picture commands</var> &dots;
+ <var>picture commands</var>
\end&lbrace;picture&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="341">\unitlength</indexterm></findex>
-<para>The <code>picture</code> environment allows you to create just about any
-kind of picture you want containing text, lines, arrows and circles.
-You tell &latex; where to put things in the picture by specifying
-their coordinates. A coordinate is a number that may have a decimal
-point and a minus sign&textmdash;a number like <code>5</code>, <code>0.3</code> or
-<code>-3.1416</code>. A coordinate specifies a length in multiples of the
-unit length <code>\unitlength</code>, so if <code>\unitlength</code> has been set
-to <code>1cm</code>, then the coordinate 2.54 specifies a length of 2.54
-centimeters.
-</para>
-<para>You should only change the value of <code>\unitlength</code>, using the
-<code>\setlength</code> command, outside of a <code>picture</code> environment.
-The default value is <code>1pt</code>.
-</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="227"><r>package</r>, <code>picture</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="228"><code>picture</code> <r>package</r></indexterm></cindex>
-
-<para>The <code>picture</code> package redefine the <code>picture</code> environment so
-that everywhere a number is used in a <var>picture commands</var> to specify
-a coordinate, one can use alternatively a length. Be aware however that
-this will prevent scaling those lengths by changing <code>\unitlength</code>.
-</para>
-
-<cindex index="cp" spaces=" "><indexterm index="cp" number="229">position, in picture</indexterm></cindex>
-<para>A <dfn>position</dfn> is a pair of coordinates, such as <code>(2.4,-5)</code>, specifying
-the point with x-coordinate <code>2.4</code> and y-coordinate <code>-5</code>.
-Coordinates are specified in the usual way with respect to an origin,
-which is normally at the lower-left corner of the picture. Note that
-when a position appears as an argument, it is not enclosed in braces;
-the parentheses serve to delimit the argument.
-</para>
-<para>The <code>picture</code> environment has one mandatory argument which is a
-position (<var>width</var>,<var>height</var>), which specifies the size of the
-picture. The environment produces a rectangular box with these
-<var>width</var> and <var>height</var>.
-</para>
-<para>The <code>picture</code> environment also has an optional position argument
-(<var>xoffset</var>,<var>yoffset</var>), following the size argument, that can
-change the origin. (Unlike ordinary optional arguments, this argument
-is not contained in square brackets.) The optional argument gives the
-coordinates of the point at the lower-left corner of the picture
-(thereby determining the origin). For example, if <code>\unitlength</code>
-has been set to <code>1mm</code>, the command
+<para>An environment to create simple pictures containing lines, arrows,
+boxes, circles, and text. Note that while this environment is not
+obsolete, new documents typically use much more powerful graphics
+creation systems, such as <code>TikZ</code>, <code>PSTricks</code>, <code>MetaPost</code>,
+or <code>Asymptote</code>. These are not covered in this document; see CTAN.
+</para>
+<para>This shows the parallelogram law for adding vectors.
</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="352" mergedindex="cp">\unitlength</indexterm></findex>
<example endspaces=" ">
-<pre xml:space="preserve">\begin&lbrace;picture&rbrace;(100,200)(10,20)
+<pre xml:space="preserve">\setlength&lbrace;\unitlength&rbrace;&lbrace;1cm&rbrace;
+\begin&lbrace;picture&rbrace;(6,6) % picture box will be 6cm wide by 6cm tall
+ \put(0,0)&lbrace;\vector(2,1)&lbrace;4&rbrace;&rbrace; % for every 2 over this vector goes 1 up
+ \put(2,1)&lbrace;\makebox(0,0)[l]&lbrace;\ first leg&rbrace;&rbrace;
+ \put(4,2)&lbrace;\vector(1,2)&lbrace;2&rbrace;&rbrace;
+ \put(5,4)&lbrace;\makebox(0,0)[l]&lbrace;\ second leg&rbrace;&rbrace;
+ \put(0,0)&lbrace;\line(1,1)&lbrace;6&rbrace;&rbrace;
+ \put(3,3)&lbrace;\makebox(0,0)[r]&lbrace;sum\ &rbrace;&rbrace;
+\end&lbrace;picture&rbrace;
</pre></example>
-<noindent></noindent> <para>produces a picture of width 100 millimeters and height 200
-millimeters, whose lower-left corner is the point (10,20) and whose
-upper-right corner is therefore the point (110,220). When you first
-draw a picture, you typically omit the optional argument, leaving the
-origin at the lower-left corner. If you then want to modify your
-picture by shifting everything, you can just add the appropriate
-optional argument.
+<para>You can also use this environment to place arbitrary material at an
+exact location.
</para>
-<para>The environment&textrsquo;s mandatory argument determines the nominal size of the
-picture. This need bear no relation to how large the picture really is;
-&latex; will happily allow you to put things outside the picture, or even
-off the page. The picture&textrsquo;s nominal size is used by &latex; in determining
-how much room to leave for it.
+<example endspaces=" ">
+<pre xml:space="preserve">\usepackage&lbrace;color,graphicx&rbrace; % in preamble
+ ...
+\begin&lbrace;center&rbrace;
+\setlength&lbrace;\unitlength&rbrace;&lbrace;\textwidth&rbrace;
+\begin&lbrace;picture&rbrace;(1,1) % leave space, \textwidth wide and tall
+ \put(0,0)&lbrace;\includegraphics[width=\textwidth]&lbrace;desertedisland.jpg&rbrace;&rbrace;
+ \put(0.25,0.35)&lbrace;\textcolor&lbrace;red&rbrace;&lbrace;X Treasure here&rbrace;&rbrace;
+\end&lbrace;picture&rbrace;
+\end&lbrace;center&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>The red&nbsp;X will be precisely a quarter of the <code>\linewidth</code> from
+the left margin, and <code>0.35\linewidth</code> up from the bottom. Another
+example of this usage is to put similar code in the page header to get
+repeat material on each of a document&textrsquo;s pages.
+</para>
+<para>The <code>picture</code> environment has one required argument, a pair of
+numbers (<var>width</var>,<var>height</var>). Multiply these by the value
+<code>\unitlength</code> to get the nominal size of the output, the space that
+&latex; reserves on the output page. This nominal size need not be how
+large the picture really is; &latex; will draw things from the picture
+outside the picture&textrsquo;s box.
+</para>
+<para>This environment also has an optional argument
+(<var>xoffset</var>,<var>yoffset</var>). It is used to shift the origin. Unlike
+most optional arguments, this one is not contained in square brackets.
+As with the required argument, it consists of two real numbers.
+Multiply these by <code>\unitlength</code> to get the point at the lower-left
+corner of the picture.
</para>
-<para>Everything that appears in a picture is drawn by the <code>\put</code>
-command. The command
+<para>For example, if <code>\unitlength</code> has been set to <code>1mm</code>, the
+command
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\put (11.3,-.3)&lbrace;...&rbrace;
+<pre xml:space="preserve">\begin&lbrace;picture&rbrace;(100,200)(10,20)
</pre></example>
-<noindent></noindent> <para>puts the object specified by <code>...</code> in the
-picture, with its reference point at coordinates <math>(11.3,-.3)</math>.
-The reference points for various objects will be described below.
+<noindent></noindent>
+<para>produces a box of width 100 millimeters and height 200 millimeters. The
+picture&textrsquo;s origin is the point (10mm,20mm) and so the lower-left corner
+is there, and the upper-right corner is at (110mm,220mm). When you
+first draw a picture you typically omit the optional argument, leaving
+the origin at the lower-left corner. If you then want to modify your
+picture by shifting everything, you can just add the appropriate
+optional argument.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="342">lR box</indexterm></findex>
-<para>The <code>\put</code> command creates an <dfn>LR box</dfn>. You can put anything
-that can go in an <code>\mbox</code> (<pxref label="_005cmbox"><xrefnodename>\mbox</xrefnodename></pxref>) in the text argument of
-the <code>\put</code> command. When you do this, the reference point will
-be the lower left corner of the box.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="288">position, in picture</indexterm></cindex>
+<para>Each <var>picture command</var> tells &latex; where to put something by
+naming its position. A <dfn>position</dfn> is a pair such as <code>(2.4,-5)</code>
+giving the x- and y-coordinates. A <dfn>coordinate</dfn> is a not a length,
+it is a real number (it may have a decimal point or a minus sign). It
+specifies a length in multiples of the unit length <code>\unitlength</code>,
+so if <code>\unitlength</code> has been set to <code>1cm</code>, then the coordinate
+2.54 specifies a length of 2.54 centimeters.
+</para>
+<para>&latex;&textrsquo;s default for <code>\unitlength</code> is <code>1pt</code>. it is a rigid
+length (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). Change it with the <code>\setlength</code> command
+(<pxref label="_005csetlength"><xrefnodename>\setlength</xrefnodename></pxref>). Make this change only outside of a <code>picture</code>
+environment.
</para>
-<para>The <code>picture</code> commands are described in the following sections.
+<para>Coordinates are given with respect to an origin, which is normally at
+the lower-left corner of the picture. Note that when a position appears
+as an argument, as with <code>\put(1,2)&lbrace;...&rbrace;</code>, it is not enclosed in
+braces since the parentheses serve to delimit the argument. Also,
+unlike in some computer graphics systems, larger y-coordinates are
+further up the page.
</para>
+<para>There are four ways to put things in a picture: <code>\put</code>,
+<code>\multiput</code>, <code>\qbezier</code>, and <code>\graphpaper</code>. The most
+often used is <code>\put</code>. This
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\put(11.3,-0.3)&lbrace;...&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>places the object with its reference point at coordinates
+<math>(11.3,-0.3)</math>. The reference points for various objects will be
+described below.
+<findex index="fn" spaces=" "><indexterm index="fn" number="353" mergedindex="cp">LR box</indexterm></findex>
+The <code>\put</code> command creates an <dfn>LR box</dfn> (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>).
+Anything that can go in an <code>\mbox</code> (<pxref label="_005cmbox-_0026-_005cmakebox"><xrefnodename>\mbox &amp; \makebox</xrefnodename></pxref>) can
+go in the text argument of the <code>\put</code> command. The reference point
+will be the lower left corner of the box. In this picture
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\setlength&lbrace;\unitlength&rbrace;&lbrace;1cm&rbrace;
+...\begin&lbrace;picture&rbrace;(1,1)
+ \put(0,0)&lbrace;\line(1,0)&lbrace;1&rbrace;&rbrace;
+ \put(0,0)&lbrace;\line(1,1)&lbrace;1&rbrace;&rbrace;
+\end&lbrace;picture&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>the three dots are just slightly left of the point of the angle formed
+by the two lines. (Also, <code>\line(1,1)&lbrace;1&rbrace;</code> does not call for a
+line of length one; rather the line has a change in the x coordinate of
+1.)
+</para>
+<para>The <code>\multiput</code>, <code>qbezier</code>, and <code>graphpaper</code> commands are
+described below.
+</para>
+<para>This draws a rectangle with a wavy top, using <code>\qbezier</code> for
+that curve.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;picture&rbrace;(3,1.5)
+ \put(0,0)&lbrace;\vector(1,0)&lbrace;8&rbrace;&rbrace; % x axis
+ \put(0,0)&lbrace;\vector(0,1)&lbrace;4&rbrace;&rbrace; % y axis
+ \put(2,0)&lbrace;\line(0,1)&lbrace;3&rbrace;&rbrace; % left side rectangle
+ \put(4,0)&lbrace;\line(0,1)&lbrace;3.5&rbrace;&rbrace; % right side
+ \qbezier(2,3)(2.5,2.9)(3,3.25)
+ \qbezier(3,3.25)(3.5,3.6)(4,3.5)
+ \thicklines % below here, lines are twice as thick
+ \put(2,3)&lbrace;\line(4,1)&lbrace;2&rbrace;&rbrace;
+ \put(4.5,2.5)&lbrace;\framebox&lbrace;Trapezoidal Rule&rbrace;&rbrace;
+\end&lbrace;picture&rbrace;
+</pre></example>
+
<menu endspaces=" ">
-<menuentry leadingtext="* "><menunode separator=":: ">\circle</menunode><menudescription><pre xml:space="preserve">Draw a circle.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\makebox (picture)</menunode><menudescription><pre xml:space="preserve">Draw a box of the specified size.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\framebox (picture)</menunode><menudescription><pre xml:space="preserve">Draw a box with a frame around it.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\dashbox</menunode><menudescription><pre xml:space="preserve">Draw a dashed box.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\frame</menunode><menudescription><pre xml:space="preserve">Draw a frame around an object.
+<menuentry leadingtext="* "><menunode separator=":: ">\put</menunode><menudescription><pre xml:space="preserve">Place an object at a specified place.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\multiput</menunode><menudescription><pre xml:space="preserve">Draw multiple instances of an object.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\qbezier</menunode><menudescription><pre xml:space="preserve">Draw a quadratic Bezier curve.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\graphpaper</menunode><menudescription><pre xml:space="preserve">Draw graph paper.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\line</menunode><menudescription><pre xml:space="preserve">Draw a straight line.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\linethickness</menunode><menudescription><pre xml:space="preserve">Set the line thickness.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\thicklines</menunode><menudescription><pre xml:space="preserve">A heavier line thickness.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\linethickness</menunode><menudescription><pre xml:space="preserve">Set thickness of horizontal and vertical lines.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\thinlines</menunode><menudescription><pre xml:space="preserve">The default line thickness.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\multiput</menunode><menudescription><pre xml:space="preserve">Draw multiple instances of an object.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\oval</menunode><menudescription><pre xml:space="preserve">Draw an ellipse.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\put</menunode><menudescription><pre xml:space="preserve">Place an object at a specified place.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\shortstack</menunode><menudescription><pre xml:space="preserve">Make a pile of objects.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\thicklines</menunode><menudescription><pre xml:space="preserve">A heavier line thickness.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\circle</menunode><menudescription><pre xml:space="preserve">Draw a circle.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\oval</menunode><menudescription><pre xml:space="preserve">Draw an oval.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\shortstack</menunode><menudescription><pre xml:space="preserve">Make a stack of objects.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\vector</menunode><menudescription><pre xml:space="preserve">Draw a line with an arrow.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\makebox (picture)</menunode><menudescription><pre xml:space="preserve">Draw a box of the specified size.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\framebox (picture)</menunode><menudescription><pre xml:space="preserve">Draw a box with a frame around it.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\frame</menunode><menudescription><pre xml:space="preserve">Draw a frame around an object.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\dashbox</menunode><menudescription><pre xml:space="preserve">Draw a dashed box.
</pre></menudescription></menuentry></menu>
-<node name="_005ccircle" spaces=" "><nodename>\circle</nodename><nodenext automatic="on">\makebox (picture)</nodenext><nodeup automatic="on">picture</nodeup></node>
-<subsection spaces=" "><sectiontitle><code>\circle</code></sectiontitle>
+<node name="_005cput" spaces=" "><nodename>\put</nodename><nodenext automatic="on">\multiput</nodenext><nodeup automatic="on">picture</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\put</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="343">\circle</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="354" mergedindex="cp">\put</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\circle[*]&lbrace;<var>diameter</var>&rbrace;
+<pre xml:space="preserve">\put(<var>xcoord</var>,<var>ycoord</var>)&lbrace;<var>content</var>&rbrace;
</pre></example>
-<para>The <code>\circle</code> command produces a circle with a diameter as close
-to the specified one as possible. The <code>*</code>-form of the command
-draws a solid circle.
+<para>Place <var>content</var> at the coordinate (<var>xcoord</var>,<var>ycoord</var>). See
+the discussion of coordinates and <code>\unitlength</code> in <ref label="picture"><xrefnodename>picture</xrefnodename></ref>.
+The <var>content</var> is processed in LR mode (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>) so it cannot
+contain line breaks.
</para>
-<para>Circles up to 40<dmn>pt</dmn> can be drawn.
+<para>This includes the text into the <code>picture</code>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\put(4.5,2.5)&lbrace;Apply the \textit&lbrace;unpoke&rbrace; move&rbrace;
+</pre></example>
+
+<para>The reference point, the location (4.5,2.5), is the lower left of the
+text, at the bottom left of the <samp>A</samp>.
</para>
</subsection>
-<node name="_005cmakebox-_0028picture_0029" spaces=" "><nodename>\makebox (picture)</nodename><nodenext automatic="on">\framebox (picture)</nodenext><nodeprev automatic="on">\circle</nodeprev><nodeup automatic="on">picture</nodeup></node>
-<subsection spaces=" "><sectiontitle><code>\makebox</code></sectiontitle>
+<node name="_005cmultiput" spaces=" "><nodename>\multiput</nodename><nodenext automatic="on">\qbezier</nodenext><nodeprev automatic="on">\put</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\multiput</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="344">\makebox <r>(for <code>picture</code>)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="355" mergedindex="cp">\multiput</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\makebox(<var>width</var>,<var>height</var>)[<var>position</var>]&lbrace;<var>text</var>&rbrace;
+<pre xml:space="preserve">\multiput(<var>x</var>,<var>y</var>)(<var>delta_x</var>,<var>delta_y</var>)&lbrace;<var>num-copies</var>&rbrace;&lbrace;<var>obj</var>&rbrace;
</pre></example>
-<para>The <code>\makebox</code> command for the picture environment is similar to
-the normal <code>\makebox</code> command except that you must specify a
-<var>width</var> and <var>height</var> in multiples of <code>\unitlength</code>.
-</para>
-<para>The optional argument, <code>[<var>position</var>]</code>, specifies the quadrant that
-your <var>text</var> appears in. You may select up to two of the following:
+<para>Copy <var>obj</var> a total of <var>num-copies</var> times, with an increment of
+<var>delta_x,delta_y</var>. The <var>obj</var> first appears at position
+<math>(x,y)</math>, then at <math>(x+\delta_x,y+\delta_y)</math>, and so on.
</para>
-<table commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code">t</itemformat></item>
-</tableterm><tableitem><para>Moves the item to the top of the rectangle.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">b</itemformat></item>
-</tableterm><tableitem><para>Moves the item to the bottom.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">l</itemformat></item>
-</tableterm><tableitem><para>Moves the item to the left.
+<para>This draws a simple grid with every fifth line in bold (see also
+<ref label="_005cgraphpaper"><xrefnodename>\graphpaper</xrefnodename></ref>).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">r</itemformat></item>
-</tableterm><tableitem><para>Moves the item to the right.
-</para>
-</tableitem></tableentry></table>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;picture&rbrace;(10,10)
+ \linethickness&lbrace;0.05mm&rbrace;
+ \multiput(0,0)(1,0)&lbrace;10&rbrace;&lbrace;\line(0,1)&lbrace;10&rbrace;&rbrace;
+ \multiput(0,0)(0,1)&lbrace;10&rbrace;&lbrace;\line(1,0)&lbrace;10&rbrace;&rbrace;
+ \linethickness&lbrace;0.5mm&rbrace;
+ \multiput(0,0)(5,0)&lbrace;3&rbrace;&lbrace;\line(0,1)&lbrace;10&rbrace;&rbrace;
+ \multiput(0,0)(0,5)&lbrace;3&rbrace;&lbrace;\line(1,0)&lbrace;10&rbrace;&rbrace;
+\end&lbrace;picture&rbrace;
+</pre></example>
-<para><xref label="_005cmakebox"><xrefnodename>\makebox</xrefnodename></xref>.
-</para>
</subsection>
-<node name="_005cframebox-_0028picture_0029" spaces=" "><nodename>\framebox (picture)</nodename><nodenext automatic="on">\dashbox</nodenext><nodeprev automatic="on">\makebox (picture)</nodeprev><nodeup automatic="on">picture</nodeup></node>
-<subsection spaces=" "><sectiontitle><code>\framebox</code></sectiontitle>
+<node name="_005cqbezier" spaces=" "><nodename>\qbezier</nodename><nodenext automatic="on">\graphpaper</nodenext><nodeprev automatic="on">\multiput</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\qbezier</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="345">\framebox</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="356" mergedindex="cp">\qbezier</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\framebox(<var>width</var>,<var>height</var>)[<var>pos</var>]&lbrace;...&rbrace;
+<pre xml:space="preserve">\qbezier(<var>x1</var>,<var>y1</var>)(<var>x2</var>,<var>y2</var>)(<var>x3</var>,<var>y3</var>)
+\qbezier[<var>num</var>](<var>x1</var>,<var>y1</var>)(<var>x2</var>,<var>y2</var>)(<var>x3</var>,<var>y3</var>)
</pre></example>
-<para>The <code>\framebox</code> command is like <code>\makebox</code> (see previous
-section), except that it puts a frame around the outside of the box
-that it creates.
+<para>Draw a quadratic Bezier curve whose control points are given by the
+three required arguments <code>(<var>x1</var>,<var>y1</var>)</code>,
+<code>(<var>x2</var>,<var>y2</var>)</code>, and <code>(<var>x3</var>,<var>y3</var>)</code>. That is,
+the curve runs from <var>(x1,y1)</var> to <var>(x3,y3)</var>, is quadratic, and is
+such that the tangent line at <var>(x1,y1)</var> passes through
+<var>(x2,y2)</var>, as does the tangent line at <var>(x3,y3)</var>.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="346">\fboxrule</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="347">\fboxsep</indexterm></findex>
-<para>The <code>\framebox</code> command produces a rule of thickness
-<code>\fboxrule</code>, and leaves a space <code>\fboxsep</code> between the rule
-and the contents of the box.
-</para>
-
-</subsection>
-<node name="_005cdashbox" spaces=" "><nodename>\dashbox</nodename><nodenext automatic="on">\frame</nodenext><nodeprev automatic="on">\framebox (picture)</nodeprev><nodeup automatic="on">picture</nodeup></node>
-<subsection spaces=" "><sectiontitle><code>\dashbox</code></sectiontitle>
-
-<findex index="fn" spaces=" "><indexterm index="fn" number="348">\dashbox</indexterm></findex>
-
-<para>Draws a box with a dashed line. Synopsis:
+<para>This draws a curve from the coordinate (1,1) to (1,0).
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\dashbox&lbrace;<var>dlen</var>&rbrace;(<var>rwidth</var>,<var>rheight</var>)[<var>pos</var>]&lbrace;<var>text</var>&rbrace;
+<pre xml:space="preserve">\qbezier(1,1)(1.25,0.75)(1,0)
</pre></example>
-<para><code>\dashbox</code> creates a dashed rectangle around <var>text</var> in a
-<code>picture</code> environment. Dashes are <var>dlen</var> units long, and the
-rectangle has overall width <var>rwidth</var> and height <var>rheight</var>.
-The <var>text</var> is positioned at optional <var>pos</var>. <!-- c xxref positions. -->
+<noindent></noindent>
+<para>The curve&textrsquo;s tangent line at (1,1) contains (1.25,0.75), as does the
+curve&textrsquo;s tangent line at (1,0).
</para>
-<para>A dashed box looks best when the <var>rwidth</var> and <var>rheight</var> are
-multiples of the <var>dlen</var>.
+<para>The optional argument <var>num</var> gives the number of calculated
+intermediate points. The default is to draw a smooth curve whose
+maximum number of points is <code>\qbeziermax</code> (change this value with
+<code>\renewcommand</code>).
</para>
</subsection>
-<node name="_005cframe" spaces=" "><nodename>\frame</nodename><nodenext automatic="on">\line</nodenext><nodeprev automatic="on">\dashbox</nodeprev><nodeup automatic="on">picture</nodeup></node>
-<subsection spaces=" "><sectiontitle><code>\frame</code></sectiontitle>
-
-<findex index="fn" spaces=" "><indexterm index="fn" number="349">\frame</indexterm></findex>
+<node name="_005cgraphpaper" spaces=" "><nodename>\graphpaper</nodename><nodenext automatic="on">\line</nodenext><nodeprev automatic="on">\qbezier</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\graphpaper</code></sectiontitle>
+<findex index="fn" spaces=" "><indexterm index="fn" number="357" mergedindex="cp">\graphpaper</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\frame&lbrace;<var>text</var>&rbrace;
+<pre xml:space="preserve">\graphpaper(<var>x_init</var>,<var>y_init</var>)(<var>x_dimen</var>,<var>y_dimen</var>)
+\graphpaper[<var>spacing</var>](<var>x_init</var>,<var>y_init</var>)(<var>x_dimen</var>,<var>y_dimen</var>)
</pre></example>
-<para>The <code>\frame</code> command puts a rectangular frame around <var>text</var>.
-The reference point is the bottom left corner of the frame. No extra
-space is put between the frame and the object.
+<para>Draw a coordinate grid. Requires the <code>graphpap</code> package.
+The grid&textrsquo;s origin is <code>(<var>x_init</var>,<var>y_init</var>)</code>.
+Grid lines come every <var>spacing</var> units (the default is 10).
+The grid extends <var>x_dimen</var> units to the right and <var>y_dimen</var> units up.
+All arguments must be positive integers.
+</para>
+<para>This make a grid with seven vertical lines and eleven horizontal lines.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\usepackage&lbrace;graphpap&rbrace; % in preamble
+ ...
+\begin&lbrace;picture&rbrace;(6,20) % in document body
+ \graphpaper[2](0,0)(12,20)
+\end&lbrace;picture&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>The lines are numbered every ten units.
</para>
</subsection>
-<node name="_005cline" spaces=" "><nodename>\line</nodename><nodenext automatic="on">\linethickness</nodenext><nodeprev automatic="on">\frame</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<node name="_005cline" spaces=" "><nodename>\line</nodename><nodenext automatic="on">\linethickness</nodenext><nodeprev automatic="on">\graphpaper</nodeprev><nodeup automatic="on">picture</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\line</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="350">\line</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="358" mergedindex="cp">\line</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\line(<var>xslope</var>,<var>yslope</var>)&lbrace;<var>length</var>&rbrace;
+<pre xml:space="preserve">\line(<var>x_run</var>,<var>y_rise</var>)&lbrace;<var>travel</var>&rbrace;
</pre></example>
-<para>The <code>\line</code> command draws a line with the given <var>length</var> and
-slope <var>xslope</var>/<var>yslope</var>.
+<para>Draw a line. It slopes such that it vertically rises <var>y_rise</var> for
+every horizontal <var>x_run</var>. The <var>travel</var> is the total horizontal
+change&nbsp;&textmdash; it is not the length of the vector, it is the change in
+<math>x</math>. In the special case of vertical lines, where
+(<var>x_run</var>,<var>y_rise</var>)=(0,1), the <var>travel</var> gives the change in
+<math>y</math>.
+</para>
+<para>This draws a line starting at coordinates (1,3).
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="230"><code>pict2e</code> package</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="231">graphics packages</indexterm></cindex>
-<para>Standard &latex; can only draw lines with <math><var>slope</var> = x/y</math>,
-where <math>x</math> and <math>y</math> have integer values from &minus;6
-through&nbsp;6. For lines of any slope, and plenty of other shapes,
-see <code>pict2e</code> and many other packages on CTAN.
+<example endspaces=" ">
+<pre xml:space="preserve">\put(1,3)&lbrace;\line(2,5)&lbrace;4&rbrace;&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>For every over 2, this line will go up 5. Because <var>travel</var>
+specifies that this goes over 4, it must go up&nbsp;10. Thus its
+endpoint is <math>(1,3)+(4,10)=(5,13)</math>. In particular, note that
+<math><var>travel</var>=4</math> is not the length of the line, it is the change in
+<math>x</math>.
+</para>
+<para>The arguments <var>x_run</var> and <var>y_rise</var> are integers that can be
+positive, negative, or zero. (If both are 0 then &latex; treats the
+second as 1.) With
+<code>\put(<var>x_init</var>,<var>y_init</var>)&lbrace;\line(<var>x_run</var>,<var>y_rise</var>)&lbrace;<var>travel</var>&rbrace;&rbrace;</code>,
+if <var>x_run</var> is negative then the line&textrsquo;s ending point has a first
+coordinate that is less than <var>x_init</var>. If <var>y_rise</var> is negative
+then the line&textrsquo;s ending point has a second coordinate that is less than
+<var>y_init</var>.
+</para>
+<para>If <var>travel</var> is negative then you get <code>LaTeX Error: Bad \line or
+\vector argument.</code>
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="289"><code>pict2e</code> package</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="290">graphics packages</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="291"><r>package</r>, <code>pict2e</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="292"><code>pict2e</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="293"><r>package</r>, <code>TikZ</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="294"><code>TikZ</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="295"><r>package</r>, <code>PSTricks</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="296"><code>PSTricks</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="297"><r>package</r>, <code>MetaPost</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="298"><code>MetaPost</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="299"><r>package</r>, <code>Asymptote</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="300"><code>Asymptote</code> <r>package</r></indexterm></cindex>
+
+<para>Standard &latex; can only draw lines with a limited range of slopes
+because these lines are made by putting together line segments from
+pre-made fonts. The two numbers <var>x_run</var> and <var>y_rise</var> must have
+integer values from &minus;6 through&nbsp;6. Also, they must be
+relatively prime, so that <var>(x_run,y_rise)</var> can be (2,1) but not
+(4,2) (if you choose the latter then instead of lines you get sequences
+of arrowheads; the solution is to switch to the former). To get lines
+of arbitrary slope and plenty of other shapes in a system like
+<code>picture</code>, see the package <file>pict2e</file> on CTAN. Another solution
+is to use a full-featured graphics system such as <file>TikZ</file>, or
+<file>PSTricks</file>, or <file>MetaPost</file>, or <file>Asymptote</file>
</para>
</subsection>
-<node name="_005clinethickness" spaces=" "><nodename>\linethickness</nodename><nodenext automatic="on">\thicklines</nodenext><nodeprev automatic="on">\line</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<node name="_005clinethickness" spaces=" "><nodename>\linethickness</nodename><nodenext automatic="on">\thinlines</nodenext><nodeprev automatic="on">\line</nodeprev><nodeup automatic="on">picture</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\linethickness</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="351">\linethickness</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="359" mergedindex="cp">\linethickness</indexterm></findex>
-<para>The <code>\linethickness&lbrace;<var>dim</var>&rbrace;</code> command declares the thickness
-of horizontal and vertical lines in a picture environment to be
-<var>dim</var>, which must be a positive length.
+<para>Synopsis:
</para>
-<para><code>\linethickness</code> does not affect the thickness of slanted lines,
-circles, or the quarter circles drawn by <code>\oval</code>.
+<example endspaces=" ">
+<pre xml:space="preserve">\linethickness&lbrace;<var>dim</var>&rbrace;
+</pre></example>
+
+<para>Declares the thickness of subsequent horizontal and vertical lines in a
+picture to be <var>dim</var>, which must be a positive length
+(<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). It differs from <code>\thinlines</code> and
+<code>\thicklines</code> in that it does not affect the thickness of slanted
+lines, circles, or ovals.
</para>
</subsection>
-<node name="_005cthicklines" spaces=" "><nodename>\thicklines</nodename><nodenext automatic="on">\thinlines</nodenext><nodeprev automatic="on">\linethickness</nodeprev><nodeup automatic="on">picture</nodeup></node>
-<subsection spaces=" "><sectiontitle><code>\thicklines</code></sectiontitle>
+<node name="_005cthinlines" spaces=" "><nodename>\thinlines</nodename><nodenext automatic="on">\thicklines</nodenext><nodeprev automatic="on">\linethickness</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\thinlines</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="352">\thicklines</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="360" mergedindex="cp">\thinlines</indexterm></findex>
-<para>The <code>\thicklines</code> command is an alternate line thickness for
-horizontal and vertical lines in a picture environment;
-cf.&nbsp;<ref label="_005clinethickness"><xrefnodename>\linethickness</xrefnodename></ref> and <ref label="_005cthinlines"><xrefnodename>\thinlines</xrefnodename></ref>.
+<para>Declaration to set the thickness of subsequent lines, circles, and ovals
+in a picture environment to be 0.4<dmn>pt</dmn>. This is the default
+thickness, so this command is unnecessary unless the thickness has been
+changed with either <ref label="_005clinethickness"><xrefnodename>\linethickness</xrefnodename></ref> or <ref label="_005cthicklines"><xrefnodename>\thicklines</xrefnodename></ref>.
</para>
</subsection>
-<node name="_005cthinlines" spaces=" "><nodename>\thinlines</nodename><nodenext automatic="on">\multiput</nodenext><nodeprev automatic="on">\thicklines</nodeprev><nodeup automatic="on">picture</nodeup></node>
-<subsection spaces=" "><sectiontitle><code>\thinlines</code></sectiontitle>
+<node name="_005cthicklines" spaces=" "><nodename>\thicklines</nodename><nodenext automatic="on">\circle</nodenext><nodeprev automatic="on">\thinlines</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\thicklines</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="353">\thinlines</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="361" mergedindex="cp">\thicklines</indexterm></findex>
-<para>The <code>\thinlines</code> command is the default line thickness for
-horizontal and vertical lines in a picture environment;
-cf.&nbsp;<ref label="_005clinethickness"><xrefnodename>\linethickness</xrefnodename></ref> and <ref label="_005cthicklines"><xrefnodename>\thicklines</xrefnodename></ref>.
+<para>Declaration to set the thickness of subsequent lines, circles, and ovals
+in a picture environment to be 0.8<dmn>pt</dmn>. See also
+<ref label="_005clinethickness"><xrefnodename>\linethickness</xrefnodename></ref> and <ref label="_005cthinlines"><xrefnodename>\thinlines</xrefnodename></ref>. This command is illustrated
+in the Trapezoidal Rule example of <ref label="picture"><xrefnodename>picture</xrefnodename></ref>.
</para>
</subsection>
-<node name="_005cmultiput" spaces=" "><nodename>\multiput</nodename><nodenext automatic="on">\oval</nodenext><nodeprev automatic="on">\thinlines</nodeprev><nodeup automatic="on">picture</nodeup></node>
-<subsection spaces=" "><sectiontitle><code>\multiput</code></sectiontitle>
+<node name="_005ccircle" spaces=" "><nodename>\circle</nodename><nodenext automatic="on">\oval</nodenext><nodeprev automatic="on">\thicklines</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\circle</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="354">\multiput</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="362" mergedindex="cp">\circle</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\multiput(<var>x</var>,<var>y</var>)(<var>delta_x</var>,<var>delta_y</var>)&lbrace;<var>n</var>&rbrace;&lbrace;<var>obj</var>&rbrace;
+<pre xml:space="preserve">\circle&lbrace;<var>diameter</var>&rbrace;
+\circle*&lbrace;<var>diameter</var>&rbrace;
+</pre></example>
+
+<para>Produces a circle with a diameter as close as possible to the specified
+one. The <code>*</code>&nbsp;form produces a filled-in circle.
+</para>
+<para>This draws a circle of radius 6, centered at <code>(5,7)</code>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\put(5,7)&lbrace;\circle&lbrace;6&rbrace;&rbrace;
</pre></example>
-<para>The <code>\multiput</code> command copies the object <var>obj</var> in a regular
-pattern across a picture. <var>obj</var> is first placed at position
-<math>(x,y)</math>, then at <math>(x+\delta x,y+\delta y)</math>, and so on,
-<var>n</var> times.
+<para>The available radii for <code>circle</code> are, in points, the even
+numbers from 2 to 20, inclusive. For <code>circle*</code> they are all the
+integers from 1 to 15.
</para>
</subsection>
-<node name="_005coval" spaces=" "><nodename>\oval</nodename><nodenext automatic="on">\put</nodenext><nodeprev automatic="on">\multiput</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<node name="_005coval" spaces=" "><nodename>\oval</nodename><nodenext automatic="on">\shortstack</nodenext><nodeprev automatic="on">\circle</nodeprev><nodeup automatic="on">picture</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\oval</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="355">\oval</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="363" mergedindex="cp">\oval</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\oval(<var>width</var>,<var>height</var>)[<var>portion</var>]
+<pre xml:space="preserve">\oval(<var>width</var>,<var>height</var>)
+\oval(<var>width</var>,<var>height</var>)[<var>portion</var>]
</pre></example>
-<para>The <code>\oval</code> command produces a rectangle with rounded corners. The
-optional argument <var>portion</var> allows you to produce only half of the
-oval via the following:
+<para>Produce a rectangle with rounded corners. The optional argument
+<var>portion</var> allows you to produce only half or a quarter of the oval.
+For half an oval take <var>portion</var> to be one of these.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">t</itemformat></item>
-</tableterm><tableitem><para>selects the top half;
+</tableterm><tableitem><para>top half
</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">b</itemformat></item>
-</tableterm><tableitem><para>selects the bottom half;
+</tableterm><tableitem><para>bottom half
</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">r</itemformat></item>
-</tableterm><tableitem><para>selects the right half;
+</tableterm><tableitem><para>right half
</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">l</itemformat></item>
-</tableterm><tableitem><para>selects the left half.
+</tableterm><tableitem><para>left half
</para></tableitem></tableentry></table>
-<para>It is also possible to produce only one quarter of the oval by setting
-<var>portion</var> to <code>tr</code>, <code>br</code>, <code>bl</code>, or <code>tl</code>.
+<para>Produce only one quarter of the oval by setting <var>portion</var> to
+<code>tr</code>, <code>br</code>, <code>bl</code>, or <code>tl</code>.
</para>
-<para>The &textldquo;corners&textrdquo; of the oval are made with quarter circles with a
-maximum radius of 20<dmn>pt</dmn>, so large &textldquo;ovals&textrdquo; will look more like
-boxes with rounded corners.
-</para>
-
-</subsection>
-<node name="_005cput" spaces=" "><nodename>\put</nodename><nodenext automatic="on">\shortstack</nodenext><nodeprev automatic="on">\oval</nodeprev><nodeup automatic="on">picture</nodeup></node>
-<subsection spaces=" "><sectiontitle><code>\put</code></sectiontitle>
-
-<findex index="fn" spaces=" "><indexterm index="fn" number="356">\put</indexterm></findex>
-
-<para>Synopsis:
+<para>This draws the top half of an oval that is 3 wide and 7 tall.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\put(<var>xcoord</var>,<var>ycoord</var>)&lbrace; ... &rbrace;
+<pre xml:space="preserve">\put(5,7)&lbrace;\oval(3,7)[t]&rbrace;
</pre></example>
-<para>The <code>\put</code> command places the material specified by the
-(mandatory) argument in braces at the given coordinate,
-(<var>xcoord</var>,<var>ycoord</var>).
+<noindent></noindent>
+<para>The (5,7) is the center of the entire oval, not just the center of the
+top half.
+</para>
+<para>These shapes are not ellipses. They are rectangles whose corners are
+made with quarter circles. These circles have a maximum radius of
+20<dmn>pt</dmn> (<pxref label="_005ccircle"><xrefnodename>\circle</xrefnodename></pxref> for the sizes). Thus large ovals are just
+boxes with a small amount of corner rounding.
</para>
</subsection>
-<node name="_005cshortstack" spaces=" "><nodename>\shortstack</nodename><nodenext automatic="on">\vector</nodenext><nodeprev automatic="on">\put</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<node name="_005cshortstack" spaces=" "><nodename>\shortstack</nodename><nodenext automatic="on">\vector</nodenext><nodeprev automatic="on">\oval</nodeprev><nodeup automatic="on">picture</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\shortstack</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="357">\shortstack</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="364" mergedindex="cp">\shortstack</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\shortstack[<var>position</var>]&lbrace;...\\...\\...&rbrace;
+<pre xml:space="preserve">\shortstack[<var>position</var>]&lbrace;<var>line 1</var> \\ ... &rbrace;
+</pre></example>
+
+<para>Produce a vertical stack of objects.
+</para>
+<para>This labels the <math>y</math> axis.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\put(0,0)&lbrace;\vector(1,0)&lbrace;4&rbrace;&rbrace; % x axis
+\put(0,0)&lbrace;\vector(0,1)&lbrace;2&rbrace;&rbrace; % y
+\put(-0.25,2)&lbrace;\makebox[0][r]&lbrace;\shortstack[r]&lbrace;$y$\\ axis&rbrace;&rbrace;&rbrace;
</pre></example>
-<para>The <code>\shortstack</code> command produces a stack of objects. The valid
-positions are:
+<noindent></noindent>
+<para>For a short stack, the reference point is the lower left of the stack.
+In the above example the <ref label="_005cmbox-_0026-_005cmakebox"><xrefnodename>\mbox &amp; \makebox</xrefnodename></ref> puts the stack flush
+right in a zero width box so in total the short stack sits slightly to
+the left of the <math>y</math>&nbsp;axis.
+</para>
+<para>The valid positions are:
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">r</itemformat></item>
-</tableterm><tableitem><para>Move the objects to the right of the stack.
+</tableterm><tableitem><para>Make objects flush right
</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">l</itemformat></item>
-</tableterm><tableitem><para>Move the objects to the left of the stack
+</tableterm><tableitem><para>Make objects flush left
</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">c</itemformat></item>
-</tableterm><tableitem><para>Move the objects to the centre of the stack (default)
+</tableterm><tableitem><para>Center objects (default)
</para></tableitem></tableentry></table>
-<findex index="fn" spaces=" "><indexterm index="fn" number="358">\\ <r>(for <code>\shortstack</code> objects)</r></indexterm></findex>
-<para>Objects are separated with <code>\\</code>.
+<findex index="fn" spaces=" "><indexterm index="fn" number="365" mergedindex="cp">\\ <r>(for <code>\shortstack</code> objects)</r></indexterm></findex>
+<para>Separate objects into lines with <code>\\</code>. These stacks are short in
+that, unlike in a <code>tabular</code> or <code>array</code> environment, here the
+rows are not spaced out to be of even heights. Thus, in
+<code>\shortstack&lbrace;X\\o\\o\\X&rbrace;</code> the first and last rows are taller than
+the middle two. You can adjust row heights either by putting in the
+usual interline spacing with <code>\shortstack&lbrace;X\\ \strut o\\o\\X&rbrace;</code>,
+or by hand, via an explicit zero-width box <code>\shortstack&lbrace;X \\
+\rule&lbrace;0pt&rbrace;&lbrace;12pt&rbrace; o\\o\\X&rbrace;</code> or by using <code>\\</code>&textrsquo;s optional
+argument <code>\shortstack&lbrace;X\\[2pt] o\\o\\X&rbrace;</code>.
+</para>
+<para>The <code>\shortstack</code> command is also available outside the
+<code>picture</code> environment.
</para>
</subsection>
-<node name="_005cvector" spaces=" "><nodename>\vector</nodename><nodeprev automatic="on">\shortstack</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<node name="_005cvector" spaces=" "><nodename>\vector</nodename><nodenext automatic="on">\makebox (picture)</nodenext><nodeprev automatic="on">\shortstack</nodeprev><nodeup automatic="on">picture</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\vector</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="359">\vector</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="366" mergedindex="cp">\vector</indexterm></findex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\vector(<var>x_run</var>,<var>y_rise</var>)&lbrace;<var>travel</var>&rbrace;
+</pre></example>
+
+<para>Draw a line ending in an arrow. The slope of that line is: it
+vertically rises <var>y_rise</var> for every horizontal <var>x_run</var>. The
+<var>travel</var> is the total horizontal change&nbsp;&textmdash; it is not the
+length of the vector, it is the change in <math>x</math>. In the special case
+of vertical vectors, if (<var>x_run</var>,<var>y_rise</var>)=(0,1), then
+<var>travel</var> gives the change in <math>y</math>.
+</para>
+<para>For an example see <ref label="picture"><xrefnodename>picture</xrefnodename></ref>.
+</para>
+<para>For elaboration on <var>x_run</var> and <var>y_rise</var> see <ref label="_005cline"><xrefnodename>\line</xrefnodename></ref>. As
+there, the values of <var>x_run</var> and <var>y_rise</var> are limited. For
+<code>\vector</code> you must chooses integers between &minus;4 and 4,
+inclusive. Also, the two you choose must be relatively prime. Thus,
+<code>\vector(2,1)&lbrace;4&rbrace;</code> is acceptable but <code>\vector(4,2)&lbrace;4&rbrace;</code> is
+not (if you use the latter then you get a sequence of arrowheads).
+</para>
+
+</subsection>
+<node name="_005cmakebox-_0028picture_0029" spaces=" "><nodename>\makebox (picture)</nodename><nodenext automatic="on">\framebox (picture)</nodenext><nodeprev automatic="on">\vector</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\makebox</code> (picture)</sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="367" mergedindex="cp">\makebox <r>(for <code>picture</code>)</r></indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\vector(<var>xslope</var>,<var>yslope</var>)&lbrace;<var>length</var>&rbrace;
+<pre xml:space="preserve">\makebox(<var>rec-width</var>,<var>rec-height</var>)&lbrace;<var>text</var>&rbrace;
+\makebox(<var>rec-width</var>,<var>rec-height</var>)[<var>position</var>]&lbrace;<var>text</var>&rbrace;
</pre></example>
-<para>The <code>\vector</code> command draws a line with an arrow of the specified
-length and slope. The <math><var>xslope</var></math> and <math><var>yslope</var></math>
-values must lie between &minus;4 and +4, inclusive.
+<para>Make a box to hold <var>text</var>. This command fits with the
+<code>picture</code> environment, although you can use it outside of there,
+because <var>rec-width</var> and <var>rec-height</var> are numbers specifying
+distances in terms of the <code>\unitlength</code> (<pxref label="picture"><xrefnodename>picture</xrefnodename></pxref>). This
+command is similar to the normal <code>\makebox</code> command (<pxref label="_005cmbox-_0026-_005cmakebox"><xrefnodename>\mbox &amp;
+\makebox</xrefnodename></pxref>) except here that you must specify the width and height. This
+command is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<para>This makes a box of length 3.5 times <code>\unitlength</code> and height 4
+times <code>\unitlength</code>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\put(1,2)&lbrace;\makebox(3.5,4)&lbrace;...&rbrace;&rbrace;
+</pre></example>
+
+<para>The optional argument <code><var>position</var></code> specifies where in the box
+the <var>text</var> appears. The default is to center it, both horizontally
+and vertically. To place it somewhere else, use a string with one or
+two of these letters.
+</para>
+<table commandarg="code" spaces=" " endspaces=" ">
+<tableentry><tableterm><item spaces=" "><itemformat command="code">t</itemformat></item>
+</tableterm><tableitem><para>Puts <var>text</var> the top of the box.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">b</itemformat></item>
+</tableterm><tableitem><para>Put <var>text</var> at the bottom.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">l</itemformat></item>
+</tableterm><tableitem><para>Put <var>text</var> on the left.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">r</itemformat></item>
+</tableterm><tableitem><para>Put <var>text</var> on the right.
+</para>
+</tableitem></tableentry></table>
+
+
+</subsection>
+<node name="_005cframebox-_0028picture_0029" spaces=" "><nodename>\framebox (picture)</nodename><nodenext automatic="on">\frame</nodenext><nodeprev automatic="on">\makebox (picture)</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\framebox</code> (picture)</sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="368" mergedindex="cp">\framebox</indexterm></findex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\framebox(<var>rec-width</var>,<var>rec-height</var>)&lbrace;<var>text</var>&rbrace;
+\framebox(<var>rec-width</var>,<var>rec-height</var>)[<var>position</var>]&lbrace;<var>text</var>&rbrace;
+</pre></example>
+
+<para>This is the same as <ref label="_005cmakebox-_0028picture_0029"><xrefnodename>\makebox (picture)</xrefnodename></ref> except that it puts a frame
+around the outside of the box that it creates. The reference point is
+the bottom left corner of the frame. This command fits with the
+<code>picture</code> environment, although you can use it outside of there,
+because lengths are numbers specifying the distance in terms of the
+<code>\unitlength</code> (<pxref label="picture"><xrefnodename>picture</xrefnodename></pxref>). This command is fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<para>This example creates a frame 2.5&nbsp;inches by 3&nbsp;inches and puts
+the text in the center.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\setlength&lbrace;\unitlength&rbrace;&lbrace;1in&rbrace;
+\framebox(2.5,3)&lbrace;test text&rbrace;
+</pre></example>
+
+<para>The required arguments are that the rectangle has overall width
+<var>rect-width</var> units and height <var>rect-height</var> units.
+</para>
+<para>The optional argument <var>position</var> specifies the position of
+<var>text</var>; see <ref label="_005cmakebox-_0028picture_0029"><xrefnodename>\makebox (picture)</xrefnodename></ref> for the values that it can
+take.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="369" mergedindex="cp">\fboxrule</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="370" mergedindex="cp">\fboxsep</indexterm></findex>
+<para>The rule has thickness <code>\fboxrule</code> and there is a blank space
+<code>\fboxsep</code> between the frame and the contents of the box.
+</para>
+<para>For this command, you must specify the <var>width</var> and <var>height</var>. If
+you want to just put a frame around some contents whose dimension is
+determined in some other way then either use <code>\fbox</code> (<pxref label="_005cfbox-_0026-_005cframebox"><xrefnodename>\fbox
+&amp; \framebox</xrefnodename></pxref>) or <code>\frame</code> (<pxref label="_005cframe"><xrefnodename>\frame</xrefnodename></pxref>).
+</para>
+
+</subsection>
+<node name="_005cframe" spaces=" "><nodename>\frame</nodename><nodenext automatic="on">\dashbox</nodenext><nodeprev automatic="on">\framebox (picture)</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\frame</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="371" mergedindex="cp">\frame</indexterm></findex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\frame&lbrace;<var>contents</var>&rbrace;
+</pre></example>
+
+<para>Puts a rectangular frame around <var>contents</var>. The reference point is
+the bottom left corner of the frame. In contrast to <code>\framebox</code>
+(<pxref label="_005cframebox-_0028picture_0029"><xrefnodename>\framebox (picture)</xrefnodename></pxref>), this command puts no extra space is put
+between the frame and the object. It is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+
+</subsection>
+<node name="_005cdashbox" spaces=" "><nodename>\dashbox</nodename><nodeprev automatic="on">\frame</nodeprev><nodeup automatic="on">picture</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\dashbox</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="372" mergedindex="cp">\dashbox</indexterm></findex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\dashbox&lbrace;<var>dash-len</var>&rbrace;(<var>rect-width</var>,<var>rect-height</var>)&lbrace;<var>text</var>&rbrace;
+\dashbox&lbrace;<var>dash-len</var>&rbrace;(<var>rect-width</var>,<var>rect-height</var>)[<var>position</var>]&lbrace;<var>text</var>&rbrace;
+</pre></example>
+
+<para>Create a dashed rectangle around <var>text</var>. This command fits with the
+<code>picture</code> environment, although you can use it outside of there,
+because lengths are numbers specifying the distance in terms of the
+<code>\unitlength</code> (<pxref label="picture"><xrefnodename>picture</xrefnodename></pxref>).
+</para>
+<para>The required arguments are: dashes are <var>dash-len</var> units long, with
+the same length gap, and the rectangle has overall width
+<var>rect-width</var> units and height <var>rect-height</var> units.
+</para>
+<para>The optional argument <var>position</var> specifies the position of
+<var>text</var>; see <ref label="_005cmakebox-_0028picture_0029"><xrefnodename>\makebox (picture)</xrefnodename></ref> for the values that it can
+take.
+</para>
+<para>This shows that you can use non-integer value for <var>dash-len</var>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\put(0,0)&lbrace;\dashbox&lbrace;0.1&rbrace;(5,0.5)&lbrace;My hovercraft is full of eels.&rbrace;&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>Each dash will be <code>0.1\unitlength</code> long, the box&textrsquo;s width is
+<code>5\unitlength</code> and its height is <code>0.5\unitlength</code>.
+</para>
+<para>As in that example, a dashed box looks best when <var>rect-width</var> and
+<var>rect-height</var> are multiples of the <var>dash-len</var>.
</para>
</subsection>
</section>
-<node name="quotation-and-quote" spaces=" "><nodename>quotation and quote</nodename><nodenext automatic="on">tabbing</nodenext><nodeprev automatic="on">picture</nodeprev><nodeup automatic="on">Environments</nodeup></node>
-<section spaces=" "><sectiontitle><code>quotation</code> and <code>quote</code></sectiontitle>
+<node name="quotation-_0026-quote" spaces=" "><nodename>quotation &amp; quote</nodename><nodenext automatic="on">tabbing</nodenext><nodeprev automatic="on">picture</nodeprev><nodeup automatic="on">Environments</nodeup></node>
+<section spaces=" "><sectiontitle><code>quotation</code> &amp; <code>quote</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="360"><r>environment</r>, <code>quotation</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="361"><code>quotation</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="373" mergedindex="cp"><r>environment</r>, <code>quotation</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="374" mergedindex="cp"><code>quotation</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="232">quoted text with paragraph indentation, displaying</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="233">displaying quoted text with paragraph indentation</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="234">paragraph indentations in quoted text</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="362"><r>environment</r>, <code>quote</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="363"><code>quote</code> <r>environment</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="301">quoted text with paragraph indentation, displaying</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="302">displaying quoted text with paragraph indentation</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="303">paragraph indentations in quoted text</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="375" mergedindex="cp"><r>environment</r>, <code>quote</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="376" mergedindex="cp"><code>quote</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="235">quoted text without paragraph indentation, displaying</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="236">displaying quoted text without paragraph indentation</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="237">paragraph indentations in quoted text, omitting</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="304">quoted text without paragraph indentation, displaying</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="305">displaying quoted text without paragraph indentation</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="306">paragraph indentations in quoted text, omitting</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;quotation&rbrace;
-<var>text</var>
+ <var>text</var>
\end&lbrace;quotation&rbrace;
</pre></example>
+<noindent></noindent>
<para>or
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;quote&rbrace;
-<var>text</var>
+ <var>text</var>
\end&lbrace;quote&rbrace;
</pre></example>
-<para>Include a quotation.
-</para>
-<para>In both environments, margins are indented on both sides by
-<code>\leftmargin</code> and the text is justified at both. As with the main
-text, leaving a blank line produces a new paragraph.
+<para>Include a quotation. Both environments indent margins on both sides by
+<code>\leftmargin</code> and the text is right-justified.
</para>
-<para>To compare the two: in the <code>quotation</code> environment, paragraphs are
-indented by 1.5<dmn>em</dmn> and the space between paragraphs is small,
-<code>0pt plus 1pt</code>. In the <code>quote</code> environment, paragraphs are
-not indented and there is vertical space between paragraphs (it is the
-rubber length <code>\parsep</code>). Thus, the <code>quotation</code> environment
-may be more suitable for documents where new paragraphs are marked by an
-indent rather than by a vertical separation. In addition, <code>quote</code>
-may be more suitable for a short quotation or a sequence of short
-quotations.
+<para>They differ in how they treat paragraphs. In the <code>quotation</code>
+environment, paragraphs are indented by 1.5<dmn>em</dmn> and the space
+between paragraphs is small, <code>0pt plus 1pt</code>. In the <code>quote</code>
+environment, paragraphs are not indented and there is vertical space
+between paragraphs (it is the rubber length <code>\parsep</code>).
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\begin&lbrace;quotation&rbrace;
-\it Four score and seven years ago
+<pre xml:space="preserve">\begin&lbrace;quotation&rbrace; \small\it
+ Four score and seven years ago
... shall not perish from the earth.
-\hspace&lbrace;1em plus 1fill&rbrace;---Abraham Lincoln
+ \hspace&lbrace;1em plus 1fill&rbrace;---Abraham Lincoln
\end&lbrace;quotation&rbrace;
</pre></example>
</section>
-<node name="tabbing" spaces=" "><nodename>tabbing</nodename><nodenext automatic="on">table</nodenext><nodeprev automatic="on">quotation and quote</nodeprev><nodeup automatic="on">Environments</nodeup></node>
+<node name="tabbing" spaces=" "><nodename>tabbing</nodename><nodenext automatic="on">table</nodenext><nodeprev automatic="on">quotation &amp; quote</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>tabbing</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="364"><r>environment</r>, <code>tabbing</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="365"><code>tabbing</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="377" mergedindex="cp"><r>environment</r>, <code>tabbing</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="378" mergedindex="cp"><code>tabbing</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="238">tab stops, using</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="239">lining text up using tab stops</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="240">alignment via tabbing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="307">tab stops, using</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="308">lining text up using tab stops</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="309">alignment via tabbing</indexterm></cindex>
<para>Synopsis:
</para>
@@ -5036,10 +6494,11 @@ quotations.
\end&lbrace;tabbing&rbrace;
</pre></example>
-<para>The <code>tabbing</code> environment aligns text in columns. It works by
-setting tab stops and tabbing to them much as was done on a typewriter.
-It is best suited for cases where the width of each column is constant
-and known in advance.
+<para>Align text in columns, by setting tab stops and tabbing to them much as
+was done on a typewriter. This is less often used than the environments
+<code>tabular</code> (<pxref label="tabular"><xrefnodename>tabular</xrefnodename></pxref>) or <code>array</code> (<pxref label="array"><xrefnodename>array</xrefnodename></pxref>) because
+in those the width of each column need not be constant and need not be
+known in advance.
</para>
<para>This example has a first line where the tab stops are set to explicit
widths, ended by a <code>\kill</code> command (which is described below):
@@ -5071,7 +6530,7 @@ of a tabbed row. The right margin of the <code>tabbing</code> environment is
the end of line, so that the width of the environment is
<code>\linewidth</code>.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="241">row, <r>tabbing</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="310">row, <r>tabbing</r></indexterm></cindex>
<para>The <code>tabbing</code> environment contains a sequence of <dfn>tabbed
rows</dfn>. The first tabbed row begins immediately after
<code>\begin&lbrace;tabbing&rbrace;</code> and each row ends with <code>\\</code> or
@@ -5095,37 +6554,37 @@ done in LR mode (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>
They are all fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="366">\\ <r>(tabbing)</r></indexterm>\\ <r>(tabbing)</r></itemformat></item>
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="379" mergedindex="cp">\\ <r>(tabbing)</r></indexterm>\\ <r>(tabbing)</r></itemformat></item>
</tableterm><tableitem><para>End a tabbed line and typeset it.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="367">\= <r>(tabbing)</r></indexterm>\= <r>(tabbing)</r></itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="380" mergedindex="cp">\= <r>(tabbing)</r></indexterm>\= <r>(tabbing)</r></itemformat></item>
</tableterm><tableitem><para>Sets a tab stop at the current position.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="368">\&gt; <r>(tabbing)</r></indexterm>\&gt; <r>(tabbing)</r></itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="369">\&gt;</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="381" mergedindex="cp">\&gt; <r>(tabbing)</r></indexterm>\&gt; <r>(tabbing)</r></itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="382" mergedindex="cp">\&gt;</indexterm></findex>
<para>Advances to the next tab stop.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="370">\&lt;</indexterm>\&lt;</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="383" mergedindex="cp">\&lt;</indexterm>\&lt;</itemformat></item>
</tableterm><tableitem><para>Put following text to the left of the local margin (without changing
the margin). Can only be used at the start of the line.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="371">\+</indexterm>\+</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="384" mergedindex="cp">\+</indexterm>\+</itemformat></item>
</tableterm><tableitem><para>Moves the left margin of the next and all the
following commands one tab stop to the right, beginning tabbed line if
necessary.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="372">\-</indexterm>\-</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="385" mergedindex="cp">\-</indexterm>\-</itemformat></item>
</tableterm><tableitem><para>Moves the left margin of the next and all the
following commands one tab stop to the left, beginning tabbed line if
necessary.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="373">\' <r>(tabbing)</r></indexterm>\' <r>(tabbing)</r></itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="386" mergedindex="cp">\' <r>(tabbing)</r></indexterm>\' <r>(tabbing)</r></itemformat></item>
</tableterm><tableitem><para>Moves everything that you have typed so far in the current column, i.e.,
everything from the most recent <code>\&gt;</code>, <code>\&lt;</code>, <code>\'</code>,
<code>\\</code>, or <code>\kill</code> command, to the previous column and aligned
to the right, flush against the current column&textrsquo;s tab stop.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="374">\` <r>(tabbing)</r></indexterm>\` <r>(tabbing)</r></itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="387" mergedindex="cp">\` <r>(tabbing)</r></indexterm>\` <r>(tabbing)</r></itemformat></item>
</tableterm><tableitem><para>Allows you to put text flush right against any tab stop, including tab
stop&nbsp;0. However, it can&textrsquo;t move text to the right of the last
column because there&textrsquo;s no tab stop there. The <code>\`</code> command moves
@@ -5135,29 +6594,29 @@ of the <code>tabbing</code> environment. There must be no <code>\&gt;</code> or
<code>\'</code> command between the <code>\`</code> and the <code>\\</code> or
<code>\end&lbrace;tabbing&rbrace;</code> command that ends the line.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="375">\a <r>(tabbing)</r></indexterm>\a <r>(tabbing)</r></itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="376">\a' <r>(acute accent in tabbing)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="377">\a` <r>(grave accent in tabbing)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="378">\a= <r>(macron accent in tabbing)</r></indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="388" mergedindex="cp">\a <r>(tabbing)</r></indexterm>\a <r>(tabbing)</r></itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="389" mergedindex="cp">\a' <r>(acute accent in tabbing)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="390" mergedindex="cp">\a` <r>(grave accent in tabbing)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="391" mergedindex="cp">\a= <r>(macron accent in tabbing)</r></indexterm></findex>
<para>In a <code>tabbing</code> environment, the commands <code>\=</code>, <code>\'</code> and
<code>\`</code> do not produce accents as usual (<pxref label="Accents"><xrefnodename>Accents</xrefnodename></pxref>). Instead,
use the commands <code>\a=</code>, <code>\a'</code> and <code>\a`</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="379">\kill</indexterm>\kill</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="392" mergedindex="cp">\kill</indexterm>\kill</itemformat></item>
</tableterm><tableitem><para>Sets tab stops without producing text. Works just like <code>\\</code> except
that it throws away the current line instead of producing output for it.
Any <code>\=</code>, <code>\+</code> or <code>\-</code> commands in that line remain in
effect.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="380">\poptabs</indexterm>\poptabs</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="381">\poptabs</indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="393" mergedindex="cp">\poptabs</indexterm>\poptabs</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="394" mergedindex="cp">\poptabs</indexterm></findex>
<para>Restores the tab stop positions saved by the last <code>\pushtabs</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="382">\pushtabs</indexterm>\pushtabs</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="395" mergedindex="cp">\pushtabs</indexterm>\pushtabs</itemformat></item>
</tableterm><tableitem><para>Saves all current tab stop positions. Useful for temporarily changing
tab stop positions in the middle of a <code>tabbing</code> environment.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="383">\tabbingsep</indexterm>\tabbingsep</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="396" mergedindex="cp">\tabbingsep</indexterm>\tabbingsep</itemformat></item>
</tableterm><tableitem><para>Distance of the text moved by <code>\'</code> to left of current tab stop.
</para>
</tableitem></tableentry></ftable>
@@ -5176,8 +6635,10 @@ function \= fact(n : integer) : integer;\\
\end&lbrace;tabbing&rbrace;
</pre></example>
-<para>The output looks like this:
-</para><example endspaces=" ">
+<noindent></noindent>
+<para>The output looks like this.
+</para>
+<example endspaces=" ">
<pre xml:space="preserve">function fact(n : integer) : integer;
begin
if n &gt; 1 then
@@ -5187,63 +6648,82 @@ function \= fact(n : integer) : integer;\\
end;
</pre></example>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="242"><r>package</r>, <code>algorithm2e</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="243"><code>algorithm2e</code> <r>package</r></indexterm></cindex>
- <cindex index="cp" spaces=" "><indexterm index="cp" number="244"><r>package</r>, <code>listings</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="245"><code>listings</code> <r>package</r></indexterm></cindex>
- <cindex index="cp" spaces=" "><indexterm index="cp" number="246"><r>package</r>, <code>minted</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="247"><code>minted</code> <r>package</r></indexterm></cindex>
-
-<cindex index="cp" spaces=" "><indexterm index="cp" number="248"><r>package</r>, <code>fancyvrb</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="249"><code>fancyvrb</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="311"><r>package</r>, <code>algorithm2e</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="312"><code>algorithm2e</code> <r>package</r></indexterm></cindex>
+ <cindex index="cp" spaces=" "><indexterm index="cp" number="313"><r>package</r>, <code>listings</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="314"><code>listings</code> <r>package</r></indexterm></cindex>
+ <cindex index="cp" spaces=" "><indexterm index="cp" number="315"><r>package</r>, <code>minted</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="316"><code>minted</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="317"><r>package</r>, <code>fancyvrb</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="318"><code>fancyvrb</code> <r>package</r></indexterm></cindex>
-<para>(The above example is just for illustration of the environment. To
-actually typeset computer code in typewriter like this, a verbatim
-environment (<pxref label="verbatim"><xrefnodename>verbatim</xrefnodename></pxref>) would normally suffice. For
-pretty-printed code, there are quite a few packages, including
-<code>algorithm2e</code>, <code>fancyvrb</code>, <code>listings</code>, and
-<code>minted</code>.)
+<noindent></noindent>
+<para>This example is just for illustration of the environment. To actually
+typeset computer code in typewriter like this, a verbatim environment
+(<pxref label="verbatim"><xrefnodename>verbatim</xrefnodename></pxref>) would normally be best. For pretty-printed code,
+there are quite a few packages, including <code>algorithm2e</code>,
+<code>fancyvrb</code>, <code>listings</code>, and <code>minted</code>.
</para>
</section>
<node name="table" spaces=" "><nodename>table</nodename><nodenext automatic="on">tabular</nodenext><nodeprev automatic="on">tabbing</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>table</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="384"><r>environment</r>, <code>table</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="385"><code>table</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="397" mergedindex="cp"><r>environment</r>, <code>table</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="398" mergedindex="cp"><code>table</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="250">tables, creating</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="251">creating tables</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="319">tables, creating</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="320">creating tables</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;table&rbrace;[<var>placement</var>]
- table body
-\caption[<var>loftitle</var>]&lbrace;<var>title</var>&rbrace;
-\label&lbrace;<var>label&rbrace;</var>
+ <var>table body</var>
+ \caption[<var>loftitle</var>]&lbrace;<var>title</var>&rbrace; % optional
+ \label&lbrace;<var>label&rbrace;</var> % also optional
\end&lbrace;table&rbrace;
</pre></example>
-<para>A class of floats (<pxref label="Floats"><xrefnodename>Floats</xrefnodename></pxref>). Because they cannot be split across
-pages, they are not typeset in sequence with the normal text but instead
-are &textldquo;floated&textrdquo; to a convenient place, such as the top of a following
-page.
+<para>A class of floats (<pxref label="Floats"><xrefnodename>Floats</xrefnodename></pxref>). They cannot be split across pages
+and so they are not typeset in sequence with the normal text but instead
+are floated to a convenient place, such as the top of a following page.
+</para>
+<para>This example <code>table</code> environment contains a <code>tabular</code>
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;table&rbrace;
+ \centering\small
+ \begin&lbrace;tabular&rbrace;&lbrace;ll&rbrace;
+ \multicolumn&lbrace;1&rbrace;&lbrace;c&rbrace;&lbrace;\textit&lbrace;Author&rbrace;&rbrace;
+ &amp;\multicolumn&lbrace;1&rbrace;&lbrace;c&rbrace;&lbrace;\textit&lbrace;Piece&rbrace;&rbrace; \\ \hline
+ Bach &amp;Cello Suite Number 1 \\
+ Beethoven &amp;Cello Sonata Number 3 \\
+ Brahms &amp;Cello Sonata Number 1
+ \end&lbrace;tabular&rbrace;
+ \caption&lbrace;Top cello pieces&rbrace;
+ \label&lbrace;tab:cello&rbrace;
+\end&lbrace;table&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>but you can put many different kinds of content in a <code>table</code>,
+including text, &latex; commands, etc.
</para>
<para>For the possible values of <var>placement</var> and their effect on the
float placement algorithm, see <ref label="Floats"><xrefnodename>Floats</xrefnodename></ref>.
</para>
-<para>The table body is typeset in a <code>parbox</code> of width <code>\textwidth</code>
-and so it can contain text, commands, etc.
+<para>The table body is typeset in a <code>parbox</code> of width <code>\textwidth</code>.
+It can contain text, commands, graphics, etc.
</para>
<para>The label is optional; it is used for cross references (<pxref label="Cross-references"><xrefnodename>Cross
references</xrefnodename></pxref>).
-<findex index="fn" spaces=" "><indexterm index="fn" number="386">\caption</indexterm></findex>
-The optional <code>\caption</code> command specifies caption text for the
-table. By default it is numbered. If <var>lottitle</var> is present, it is
-used in the list of tables instead of <var>title</var> (<pxref label="Tables-of-contents"><xrefnodename>Tables of
-contents</xrefnodename></pxref>).
+<findex index="fn" spaces=" "><indexterm index="fn" number="399" mergedindex="cp">\caption</indexterm></findex>
+The <code>\caption</code> command is also optional. It specifies caption text
+for the table. By default it is numbered. If its optional
+<var>lottitle</var> is present then that text is used in the list of tables
+instead of <var>title</var> (<pxref label="Table-of-contents-etc_002e"><xrefnodename>Table of contents etc.</xrefnodename></pxref>).
</para>
<para>In this example the table and caption will float to the bottom of a page,
unless it is pushed to a float page at the end.
@@ -5266,17 +6746,17 @@ unless it is pushed to a float page at the end.
<node name="tabular" spaces=" "><nodename>tabular</nodename><nodenext automatic="on">thebibliography</nodenext><nodeprev automatic="on">table</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>tabular</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="387"><r>environment</r>, <code>tabular</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="388"><code>tabular</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="400" mergedindex="cp"><r>environment</r>, <code>tabular</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="401" mergedindex="cp"><code>tabular</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="252">lines in tables</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="253">lining text up in tables</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="321">lines in tables</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="322">lining text up in tables</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;tabular&rbrace;[<var>pos</var>]&lbrace;<var>cols</var>&rbrace;
-column 1 entry &amp;column 2 entry ... &amp;column n entry \\
+ <var>column 1 entry</var> &amp;<var>column 2 entry</var> ... &amp;<var>column n entry</var> \\
...
\end&lbrace;tabular&rbrace;
</pre></example>
@@ -5286,14 +6766,14 @@ column 1 entry &amp;column 2 entry ... &amp;column n entry \\
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;tabular*&rbrace;&lbrace;<var>width</var>&rbrace;[<var>pos</var>]&lbrace;<var>cols</var>&rbrace;
-column 1 entry &amp;column 2 entry ... &amp;column n entry \\
+ <var>column 1 entry</var> &amp;<var>column 2 entry</var> ... &amp;<var>column n entry</var> \\
...
\end&lbrace;tabular*&rbrace;
</pre></example>
-<para>These environments produce a table, a box consisting of a sequence of
-horizontal rows. Each row consists of items that are aligned vertically
-in columns. This illustrates many of the features.
+<para>Produce a table, a box consisting of a sequence of horizontal rows.
+Each row consists of items that are aligned vertically in columns. This
+illustrates many of the features.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;tabular&rbrace;&lbrace;l|l&rbrace;
@@ -5304,28 +6784,23 @@ in columns. This illustrates many of the features.
\end&lbrace;tabular&rbrace;
</pre></example>
-<para>The vertical format of two left-aligned columns, with a vertical bar
-between them, is specified in <code>tabular</code>&textrsquo;s argument <code>&lbrace;l|l&rbrace;</code>.
-<findex index="fn" spaces=" "><indexterm index="fn" number="389">&amp;</indexterm></findex>
-Columns are separated with an ampersand <code>&amp;</code>. A horizontal rule
-between two rows is created with <code>\hline</code>.
-<findex index="fn" spaces=" "><indexterm index="fn" number="390">\\ <r>for <code>tabular</code></r></indexterm></findex>
-The end of each row is marked with a double backslash&nbsp;<code>\\</code>.
+<noindent></noindent>
+<para>The output will have two left-aligned columns with a vertical bar
+between them. This is specified in <code>tabular</code>&textrsquo;s argument
+<code>&lbrace;l|l&rbrace;</code>.
+<findex index="fn" spaces=" "><indexterm index="fn" number="402" mergedindex="cp">&amp;</indexterm></findex>
+Put the entries into different columns by separating them with an
+ampersand, <code>&amp;</code>. The end of each row is marked with a double
+backslash, <code>\\</code>. Put a horizontal rule below a row, after a double
+backslash, with <code>\hline</code>.
+<findex index="fn" spaces=" "><indexterm index="fn" number="403" mergedindex="cp">\\ <r>for <code>tabular</code></r></indexterm></findex>
This <code>\\</code> is optional after the last row unless an <code>\hline</code>
command follows, to put a rule below the table.
</para>
<para>The required and optional arguments to <code>tabular</code> consist of:
</para>
<table commandarg="var" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="var">width</itemformat></item>
-</tableterm><tableitem><para>Required for <code>tabular*</code>, not allowed for <code>tabular</code>. Specifies
-the width of the <code>tabular*</code> environment. The space between columns
-should be rubber, as with <code>&arobase;&lbrace;\extracolsep&lbrace;\fill&rbrace;&rbrace;</code>, to allow
-the table to stretch or shrink to make the specified width, or else you
-are likely to get the <code>Underfull \hbox (badness 10000) in alignment
-...</code> warning.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">pos</itemformat></item>
+<tableentry><tableterm><item spaces=" "><itemformat command="var">pos</itemformat></item>
</tableterm><tableitem><para>Optional. Specifies the table&textrsquo;s vertical position. The default is to
align the table so its vertical center matches the baseline of the
surrounding text. There are two other possible alignments: <code>t</code>
@@ -5355,25 +6830,28 @@ column and intercolumn material.
</tableterm><tableitem><para>A vertical line the full height and depth of the environment.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">&arobase;&lbrace;<var>text or space</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>This inserts <var>text or space</var> at this location in every row. The
-<var>text or space</var> material is typeset in LR mode. This text is
-fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</tableterm><tableitem><para>Insert <var>text or space</var> at this location in every row. The <var>text
+or space</var> material is typeset in LR mode. This text is fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
-<para>This specifier is optional: with no &arobase;-expression, &latex;&textrsquo;s
+<para>If between two columns there is no &arobase;-expression then &latex;&textrsquo;s
<code>book</code>, <code>article</code>, and <code>report</code> classes will put on
-either side of each column a space of length <code>\tabcolsep</code>, which
-by default is <samp>6pt</samp>. That is, by default adjacent columns are
-separated by 12pt (so <code>\tabcolsep</code> is misleadingly-named since it
-is not the separation between tabular columns). By implication, a
-space of 6pt also comes before the first column and after the final
-column, unless you put a <code>&arobase;&lbrace;...&rbrace;</code> or <code>|</code> there.
+either side of each column a space of length <code>\tabcolsep</code>, which by
+default is 6<dmn>pt</dmn>. That is, by default adjacent columns are
+separated by 12<dmn>pt</dmn> (so <code>\tabcolsep</code> is misleadingly named
+since it is only half of the separation between tabular columns). In
+addition, a space of 6<dmn>pt</dmn> also comes before the first column and
+after the final column, unless you put a <code>&arobase;&lbrace;...&rbrace;</code> or <code>|</code>
+there.
</para>
-<para>If you override the default and use an &arobase;-expression then you must
-insert any desired space yourself, as in <code>&arobase;&lbrace;\hspace&lbrace;1em&rbrace;&rbrace;</code>.
+<para>If you override the default and use an &arobase;-expression then &latex; does
+not insert <code>\tabcolsep</code> so you must insert any desired space
+yourself, as in <code>&arobase;&lbrace;\hspace&lbrace;1em&rbrace;&rbrace;</code>.
</para>
-<para>An empty expression <code>&arobase;&lbrace;&rbrace;</code> will eliminate the space, including
-the space at the start or end, as in the example below where the tabular
-lines need to lie on the left margin.
+<para>An empty expression <code>&arobase;&lbrace;&rbrace;</code> will eliminate the space. In
+particular, sometimes you want to eliminate the the space before the
+first column or after the last one, as in the example below where the
+tabular lines need to lie on the left margin.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;flushleft&rbrace;
@@ -5383,8 +6861,8 @@ lines need to lie on the left margin.
\end&lbrace;flushleft&rbrace;
</pre></example>
-<para>This example shows text, a decimal point, between the columns, arranged
-so the numbers in the table are aligned on that decimal point.
+<para>The next example shows text, a decimal point between the columns,
+arranged so the numbers in the table are aligned on it.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;tabular&rbrace;&lbrace;r&arobase;&lbrace;$.$&rbrace;l&rbrace;
@@ -5393,23 +6871,21 @@ so the numbers in the table are aligned on that decimal point.
\end&lbrace;tabular&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="391">\extracolsep</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="404" mergedindex="cp">\extracolsep</indexterm></findex>
<para>An <code>\extracolsep&lbrace;<var>wd</var>&rbrace;</code> command in an &arobase;-expression causes an
extra space of width <var>wd</var> to appear to the left of all subsequent
-columns, until countermanded by another <code>\extracolsep</code> command.
-Unlike ordinary intercolumn space, this extra space is not suppressed by
-an &arobase;-expression. An <code>\extracolsep</code> command can be used only in an
+columns, until countermanded by another <code>\extracolsep</code>. Unlike
+ordinary intercolumn space, this extra space is not suppressed by an
+&arobase;-expression. An <code>\extracolsep</code> command can be used only in an
&arobase;-expression in the <code>cols</code> argument. Below, &latex; inserts the
right amount of intercolumn space to make the entire table 4 inches
wide.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\begin&lbrace;center&rbrace;
- \begin&lbrace;tabular*&rbrace;&lbrace;4in&rbrace;&lbrace;l&arobase;&lbrace;\ \ldots\extracolsep&lbrace;\fill&rbrace;&rbrace;l&rbrace;
- Seven times down, eight times up
- &amp;such is life!
- \end&lbrace;tabular*&rbrace;
-\end&lbrace;center&rbrace;
+<pre xml:space="preserve">\begin&lbrace;tabular*&rbrace;&lbrace;4in&rbrace;&lbrace;l&arobase;&lbrace;\extracolsep&lbrace;\fill&rbrace;&rbrace;l&rbrace;
+ Seven times down, eight times up \ldots
+ &amp;such is life!
+\end&lbrace;tabular*&rbrace;
</pre></example>
<para>To insert commands that are automatically executed before a given
@@ -5418,48 +6894,63 @@ specifier.
<!-- c xx should fully explain array, tabularx, and all other base packages... -->
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">p&lbrace;<var>wd</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Each item in the column is typeset in a parbox of width <var>wd</var>.
+</tableterm><tableitem><para>Each item in the column is typeset in a parbox of width <var>wd</var>, as if
+it were the argument of a <code>\parbox[t]&lbrace;wd&rbrace;&lbrace;...&rbrace;</code> command.
</para>
-<para>Note that a line break double backslash <code>\\</code> may not appear in the
-item, except inside an environment like <code>minipage</code>, <code>array</code>,
-or <code>tabular</code>, or inside an explicit <code>\parbox</code>, or in the scope
-of a <code>\centering</code>, <code>\raggedright</code>, or <code>\raggedleft</code>
+<para>A line break double backslash <code>\\</code> may not appear in the item,
+except inside an environment like <code>minipage</code>, <code>array</code>, or
+<code>tabular</code>, or inside an explicit <code>\parbox</code>, or in the scope of
+a <code>\centering</code>, <code>\raggedright</code>, or <code>\raggedleft</code>
declaration (when used in a <code>p</code>-column element these declarations
must appear inside braces, as with <code>&lbrace;\centering .. \\
..&rbrace;</code>). Otherwise &latex; will misinterpret the double backslash as
-ending the row.
+ending the row. Instead, to get a line break in there use
+<code>\newline</code> (<pxref label="_005cnewline"><xrefnodename>\newline</xrefnodename></pxref>).
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">*&lbrace;<var>num</var>&rbrace;&lbrace;<var>cols</var>&rbrace;</itemformat></item>
</tableterm><tableitem><para>Equivalent to <var>num</var> copies of <var>cols</var>, where <var>num</var> is a
-positive integer and <var>cols</var> is a list of specifiers. Thus
-<code>\begin&lbrace;tabular&rbrace;&lbrace;|*&lbrace;3&rbrace;&lbrace;l|r&rbrace;|&rbrace;</code> is equivalent to
-<code>\begin&lbrace;tabular&rbrace;&lbrace;|l|rl|rl|r|&rbrace;</code>. Note that <var>cols</var> may
-contain another <code>*</code>-expression.
+positive integer and <var>cols</var> is a list of specifiers. Thus the
+specifier <code>\begin&lbrace;tabular&rbrace;&lbrace;|*&lbrace;3&rbrace;&lbrace;l|r&rbrace;|&rbrace;</code> is equivalent to
+the specifier <code>\begin&lbrace;tabular&rbrace;&lbrace;|l|rl|rl|r|&rbrace;</code>. Note that
+<var>cols</var> may contain another <code>*</code>-expression.
</para>
</tableitem></tableentry></table>
+
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">width</itemformat></item>
+</tableterm><tableitem><para>Required for <code>tabular*</code>, not allowed for <code>tabular</code>. Specifies
+the width of the <code>tabular*</code> environment. The space between columns
+should be rubber, as with <code>&arobase;&lbrace;\extracolsep&lbrace;\fill&rbrace;&rbrace;</code>, to allow
+the table to stretch or shrink to make the specified width, or else you
+are likely to get the <code>Underfull \hbox (badness 10000) in alignment
+...</code> warning.
+</para>
</tableitem></tableentry></table>
<para>Parameters that control formatting:
<!-- c xx defaults, own node (xref from array)? -->
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="392">\arrayrulewidth</indexterm>\arrayrulewidth</itemformat></item>
-</tableterm><tableitem><para>A length that is the thickness of the rule created by <code>|</code>,
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="405" mergedindex="cp">\arrayrulewidth</indexterm>\arrayrulewidth</itemformat></item>
+</tableterm><tableitem><anchor name="tabular-arrayrulewidth">tabular arrayrulewidth</anchor>
+<para>A length that is the thickness of the rule created by <code>|</code>,
<code>\hline</code>, and <code>\vline</code> in the <code>tabular</code> and <code>array</code>
environments. The default is <samp>.4pt</samp>. Change it as in
<code>\setlength&lbrace;\arrayrulewidth&rbrace;&lbrace;0.8pt&rbrace;</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="393">\arraystretch</indexterm>\arraystretch</itemformat></item>
-</tableterm><tableitem><para>A factor by which the spacing between rows in the <code>tabular</code> and
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="406" mergedindex="cp">\arraystretch</indexterm>\arraystretch</itemformat></item>
+</tableterm><tableitem><anchor name="tabular-arraystrech">tabular arraystrech</anchor>
+<para>A factor by which the spacing between rows in the <code>tabular</code> and
<code>array</code> environments is multiplied. The default is <samp>1</samp>, for
no scaling. Change it as <code>\renewcommand&lbrace;\arraystretch&rbrace;&lbrace;1.2&rbrace;</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="394">\doublerulesep</indexterm>\doublerulesep</itemformat></item>
-</tableterm><tableitem><para>A length that is the distance between the vertical rules produced by the
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="407" mergedindex="cp">\doublerulesep</indexterm>\doublerulesep</itemformat></item>
+</tableterm><tableitem><anchor name="tabular-doublerulesep">tabular doublerulesep</anchor>
+<para>A length that is the distance between the vertical rules produced by the
<code>||</code> specifier. The default is <samp>2pt</samp>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="395">\tabcolsep</indexterm>\tabcolsep</itemformat></item>
-</tableterm><tableitem><para>A length that is half of the space between columns. The default is
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="408" mergedindex="cp">\tabcolsep</indexterm>\tabcolsep</itemformat></item>
+</tableterm><tableitem><anchor name="tabular-tabcolsep">tabular tabcolsep</anchor>
+<para>A length that is half of the space between columns. The default is
<samp>6pt</samp>. Change it with <code>\setlength</code>.
</para>
</tableitem></tableentry></ftable>
@@ -5479,7 +6970,7 @@ lines:
<node name="_005cmulticolumn" spaces=" "><nodename>\multicolumn</nodename><nodenext automatic="on">\vline</nodenext><nodeup automatic="on">tabular</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\multicolumn</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="396">\multicolumn</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="409" mergedindex="cp">\multicolumn</indexterm></findex>
<para>Synopsis:
</para>
@@ -5499,8 +6990,9 @@ spanned by the single heading <samp>Name</samp>.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;tabular&rbrace;&lbrace;lccl&rbrace;
- \textit&lbrace;ID&rbrace; &amp;\multicolumn&lbrace;2&rbrace;&lbrace;c&rbrace;&lbrace;\textit&lbrace;Name&rbrace;&rbrace; &amp;\textit&lbrace;Age&rbrace; \\ \hline % row one
- 978-0-393-03701-2 &amp;O'Brian &amp;Patrick &amp;55 \\ % row two
+ \textit&lbrace;ID&rbrace; &amp;\multicolumn&lbrace;2&rbrace;&lbrace;c&rbrace;&lbrace;\textit&lbrace;Name&rbrace;&rbrace; &amp;\textit&lbrace;Age&rbrace; \\
+ \hline
+ 978-0-393-03701-2 &amp;O'Brian &amp;Patrick &amp;55 \\
...
\end&lbrace;tabular&rbrace;
</pre></example>
@@ -5529,6 +7021,7 @@ area before it and after it. This table details the exact behavior.
\end&lbrace;tabular&rbrace;
</pre></example>
+<noindent></noindent>
<para>Before the first entry the output will not have a vertical rule because
the <code>\multicolumn</code> has the <var>cols</var> specifier <samp>r</samp> with no
initial vertical bar. Between entry one and entry two there will be a
@@ -5566,6 +7059,7 @@ range en-dash.
\end&lbrace;tabular&rbrace;
</pre></example>
+<noindent></noindent>
<para>Note that although the <code>tabular</code> specification by default puts a
vertical rule between the first and second columns, because there is no
vertical bar in the <var>cols</var> of either of the first row&textrsquo;s
@@ -5576,31 +7070,31 @@ vertical bar in the <var>cols</var> of either of the first row&textrsquo;s
<node name="_005cvline" spaces=" "><nodename>\vline</nodename><nodenext automatic="on">\cline</nodenext><nodeprev automatic="on">\multicolumn</nodeprev><nodeup automatic="on">tabular</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\vline</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="397">\vline</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="410" mergedindex="cp">\vline</indexterm></findex>
<para>Draw a vertical line in a <code>tabular</code> or <code>array</code> environment
extending the full height and depth of an entry&textrsquo;s row. Can also be
used in an &arobase;-expression, although its synonym vertical
bar&nbsp;<code>|</code> is more common. This command is rarely used in the
body of a table; typically a table&textrsquo;s vertical lines are specified in
<code>tabular</code>&textrsquo;s <var>cols</var> argument and overridden as needed with
-<code>\multicolumn</code>.
+<code>\multicolumn</code> (<pxref label="tabular"><xrefnodename>tabular</xrefnodename></pxref>).
</para>
-<para>This example illustrates some pitfalls. In the first line&textrsquo;s second
+<para>The example below illustrates some pitfalls. In the first row&textrsquo;s second
entry the <code>\hfill</code> moves the <code>\vline</code> to the left edge of the
cell. But that is different than putting it halfway between the two
-columns, so in that row between the first and second columns there are
-two vertical rules, with the one from the <code>&lbrace;c|cc&rbrace;</code> specifier
-coming before the one produced by the <code>\vline\hfill</code>. In contrast,
-the first line&textrsquo;s third entry shows the usual way to put a vertical bar
-between two columns. In the second line, the <code>ghi</code> is the widest
-entry in its column so in the <code>\vline\hfill</code> the <code>\hfill</code> has
-no effect and the vertical line in that entry appears immediately next
-to the <code>g</code>, with no whitespace.
+columns, so between the first and second columns there are two vertical
+rules, with the one from the <code>&lbrace;c|cc&rbrace;</code> specifier coming before the
+one produced by the <code>\vline\hfill</code>. In contrast, the first row&textrsquo;s
+third entry shows the usual way to put a vertical bar between two
+columns. In the second row, the <code>ghi</code> is the widest entry in its
+column so in the <code>\vline\hfill</code> the <code>\hfill</code> has no effect and
+the vertical line in that entry appears immediately next to the
+<code>g</code>, with no whitespace.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;tabular&rbrace;&lbrace;c|cc&rbrace;
- x &amp;\vline\hfill y &amp;\multicolumn&lbrace;1&rbrace;&lbrace;|r&rbrace;&lbrace;z&rbrace; \\
- abc &amp;def &amp;\vline\hfill ghi
+ x &amp;\vline\hfill y &amp;\multicolumn&lbrace;1&rbrace;&lbrace;|r&rbrace;&lbrace;z&rbrace; \\ % row 1
+ abc &amp;def &amp;\vline\hfill ghi % row 2
\end&lbrace;tabular&rbrace;
</pre></example>
@@ -5609,7 +7103,7 @@ to the <code>g</code>, with no whitespace.
<node name="_005ccline" spaces=" "><nodename>\cline</nodename><nodenext automatic="on">\hline</nodenext><nodeprev automatic="on">\vline</nodeprev><nodeup automatic="on">tabular</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\cline</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="398">\cline</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="411" mergedindex="cp">\cline</indexterm></findex>
<para>Synopsis:
</para>
@@ -5617,10 +7111,10 @@ to the <code>g</code>, with no whitespace.
<pre xml:space="preserve">\cline&lbrace;<var>i</var>-<var>j</var>&rbrace;
</pre></example>
-<para>Draw a horizontal rule in an <code>array</code> or <code>tabular</code> environment
-beginning in column <var>i</var> and ending in column <var>j</var>. The
-dash&nbsp;<code>-</code> must appear in the mandatory argument. To span a
-single column use the number twice.
+<para>In an <code>array</code> or <code>tabular</code> environment, draw a horizontal rule
+beginning in column&nbsp;<var>i</var> and ending in column&nbsp;<var>j</var>. The
+dash, <code>-</code>, must appear in the mandatory argument. To span a single
+column use the number twice, as with <code>\cline&lbrace;2-2&rbrace;</code>.
</para>
<para>This example puts two horizontal lines between the first and second
rows, one line in the first column only, and the other spanning the
@@ -5639,9 +7133,9 @@ height.
<node name="_005chline" spaces=" "><nodename>\hline</nodename><nodeprev automatic="on">\cline</nodeprev><nodeup automatic="on">tabular</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\hline</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="399">\hline</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="412" mergedindex="cp">\hline</indexterm></findex>
-<para>Draws a horizontal line the width of the enclosing <code>tabular</code> or
+<para>Draw a horizontal line the width of the enclosing <code>tabular</code> or
<code>array</code> environment. It&textrsquo;s most commonly used to draw a line at the
top, bottom, and between the rows of a table.
</para>
@@ -5664,55 +7158,70 @@ is required.
<node name="thebibliography" spaces=" "><nodename>thebibliography</nodename><nodenext automatic="on">theorem</nodenext><nodeprev automatic="on">tabular</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>thebibliography</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="400"><r>environment</r>, <code>thebibliography</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="401"><code>thebibliography</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="413" mergedindex="cp"><r>environment</r>, <code>thebibliography</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="414" mergedindex="cp"><code>thebibliography</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="254">bibliography, creating (manually)</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="323">bibliography, creating (manually)</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;thebibliography&rbrace;&lbrace;<var>widest-label</var>&rbrace;
-\bibitem[<var>label</var>]&lbrace;<var>cite_key&rbrace;</var>
-...
+ \bibitem[<var>label</var>]&lbrace;<var>cite_key&rbrace;</var>
+ ...
\end&lbrace;thebibliography&rbrace;
</pre></example>
-<para>The <code>thebibliography</code> environment produces a bibliography or
-reference list.
-</para>
-<para>In the <code>article</code> class, this reference list is labelled
-<samp>References</samp> and the label is stored in macro <code>\refname</code>; in
-the <code>report</code> class, it is labelled <samp>Bibliography</samp> and the
-label is stored in macro <code>\bibname</code>.
+<para>Produce a bibliography or reference list. There are two ways to produce
+bibliographic lists. This environment is suitable when you have only a
+few references and can maintain the list by hand. <xref label="Using-BibTeX"><xrefnodename>Using BibTeX</xrefnodename></xref>
+for a more sophisticated approach.
</para>
-<para>You can change the label by redefining the command <code>\refname</code> or
-<code>\bibname</code>, whichever is applicable depending on the class:
+<para>This shows the environment with two entries.
</para>
-<itemize commandarg="bullet" endspaces=" ">
-<listitem><prepend>&bullet;</prepend>
-<findex index="fn" spaces=" "><indexterm index="fn" number="402">\bibname</indexterm></findex>
-<para>For standard classes whose top level sectioning is <code>\chapter</code>
-(such as <file>book</file> and <file>report</file>), the label is in the macro
-<code>\bibname</code>;
-</para>
-</listitem><listitem><prepend>&bullet;</prepend>
-<findex index="fn" spaces=" "><indexterm index="fn" number="403">\refname</indexterm></findex>
-<para>For standard classes whose the top level sectioning is <code>\section</code>
-(such as <file>article</file>), the label is in macro <code>\refname</code>.
-</para></listitem></itemize>
-
-<cindex index="cp" spaces=" "><indexterm index="cp" number="255"><r>package</r>, <code>babel</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="256"><code>babel</code> <r>package</r></indexterm></cindex>
+<example endspaces=" ">
+<pre xml:space="preserve">This work is based on \cite&lbrace;latexdps&rbrace;.
+Together they are \cite&lbrace;latexdps, texbook&rbrace;.
+ ...
+\begin&lbrace;thebibliography&rbrace;&lbrace;9&rbrace;
+\bibitem&lbrace;latexdps&rbrace;
+ Leslie Lamport.
+ \textit&lbrace;\LaTeX&lbrace;&rbrace;: a document preparation system&rbrace;.
+ Addison-Wesley, Reading, Massachusetts, 1993.
+\bibitem&lbrace;texbook&rbrace;
+ Donald Ervin Knuth.
+ \textit&lbrace;The \TeX book&rbrace;.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+\end&lbrace;thebibliography&rbrace;
+</pre></example>
-<para>Typically it is neither necessary nor desirable to directly redefine
-<code>\refname</code> or <code>\bibname</code>; language support packages like
-<file>babel</file> do this.
+<noindent></noindent>
+<para>This styles the first reference as <samp>[1] Leslie ...</samp>, and so that
+<code>\cite&lbrace;latexdps&rbrace;</code> produces the matching <samp>... based on [1]</samp>.
+The second <code>\cite</code> produces <samp>[1, 2]</samp>. You must compile the
+document twice to resolve these references.
+</para>
+<para>The mandatory argument <var>widest-label</var> is text that, when typeset, is
+as wide as the widest item label produced by the <code>\bibitem</code>
+commands. The tradition is to use <code>9</code> for bibliographies with less
+than 10 references, <code>99</code> for ones with less than 100, etc.
+</para>
+<para>The bibliographic list is headed by a title such as <samp>Bibliography</samp>.
+To change it there are two cases. In the <file>book</file> and <file>report</file>
+classes, where the top level sectioning is <code>\chapter</code> and the
+default title is <samp>Bibliography</samp>, that title is in the macro
+<code>\bibname</code>. For <file>article</file>, where the class&textrsquo;s top level
+sectioning is <code>\section</code> and the default is <samp>References</samp>, the
+title is in macro <code>\refname</code>. Change it by redefining the command,
+as with <code>\renewcommand&lbrace;\refname&rbrace;&lbrace;Cited references&rbrace;</code> after
+<code>\begin&lbrace;document&rbrace;</code>.
</para>
-<para>The mandatory <var>widest-label</var> argument is text that, when typeset,
-is as wide as the widest item label produced by the <code>\bibitem</code>
-commands. It is typically given as <code>9</code> for bibliographies with
-less than 10 references, <code>99</code> for ones with less than 100, etc.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="324"><r>package</r>, <code>babel</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="325"><code>babel</code> <r>package</r></indexterm></cindex>
+
+<para>Language support packages such as <file>babel</file> will automatically
+redefine <code>\refname</code> or <code>\bibname</code> to fit the selected
+language.
</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\bibitem</menunode><menudescription><pre xml:space="preserve">Specify a bibliography item.
@@ -5725,56 +7234,141 @@ less than 10 references, <code>99</code> for ones with less than 100, etc.
<node name="_005cbibitem" spaces=" "><nodename>\bibitem</nodename><nodenext automatic="on">\cite</nodenext><nodeup automatic="on">thebibliography</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\bibitem</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="404">\bibitem</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="415" mergedindex="cp">\bibitem</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
+<pre xml:space="preserve">\bibitem&lbrace;<var>cite_key</var>&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>or
+</para>
+<example endspaces=" ">
<pre xml:space="preserve">\bibitem[<var>label</var>]&lbrace;<var>cite_key</var>&rbrace;
</pre></example>
-<para>The <code>\bibitem</code> command generates an entry labelled by <var>label</var>.
-If the <var>label</var> argument is missing, a number is automatically
-generated using the <code>enumi</code> counter. The <var>cite_key</var> is a
-<cindex index="cp" spaces=" "><indexterm index="cp" number="257">citation key</indexterm></cindex>
-<dfn>citation key</dfn> consisting in any sequence of
-letters, numbers, and punctuation symbols not containing a comma.
+<para>Generate an entry labeled by <var>label</var>. The default is for &latex; to
+generates a number using the <code>enumi</code> counter. The <dfn>citation key</dfn>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="326">citation key</indexterm></cindex>
+<var>cite_key</var> is a string of
+letters, numbers, and punctuation symbols (but not comma).
</para>
-<para>This command writes an entry to the <file>.aux</file> file containing the
-item&textrsquo;s <var>cite_key</var> and <var>label</var>. When the <file>.aux</file> file is
-read by the <code>\begin&lbrace;document&rbrace;</code> command, the item&textrsquo;s <var>label</var> is
-associated with <code>cite_key</code>, causing references to <var>cite_key</var>
-with a <code>\cite</code> command (<pxref label="_005ccite"><xrefnodename>\cite</xrefnodename></pxref>) to produce the associated
-<var>label</var>.
+<para><xref label="thebibliography"><xrefnodename>thebibliography</xrefnodename></xref> for an example.
+</para>
+<para>The optional <var>label</var> changes the default label from an integer to the
+given string. With this
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;thebibliography&rbrace;
+\bibitem[Lamport 1993]&lbrace;latexdps&rbrace;
+ Leslie Lamport.
+ \textit&lbrace;\LaTeX&lbrace;&rbrace;: a document preparation system&rbrace;.
+ Addison-Wesley, Reading, Massachusetts, 1993.
+\bibitem&lbrace;texbook&rbrace;
+ Donald Ervin Knuth.
+ \textit&lbrace;The \TeX book&rbrace;.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+\end&lbrace;thebibliography&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>the first entry will be styled as <samp>[Lamport 1993] Leslie ...</samp> (The
+amount of horizontal space that &latex; leaves for the label depends on
+the <var>widest-label</var> argument of the <code>thebibliography</code>
+environment; see <ref label="thebibliography"><xrefnodename>thebibliography</xrefnodename></ref>.) Similarly, <code>... based on
+\cite&lbrace;latexdps&rbrace;</code> will produce <samp>... based on [Lamport 1994]</samp>.
+</para>
+<para>If you mix <code>\bibitem</code> entries having a <var>label</var> with those that
+do not then &latex; will number the unlabelled ones sequentially. In
+the example above the <code>texbook</code> entry will appear as <samp>[1]
+Donald ...</samp>, despite that it is the second entry.
+</para>
+<para>If you use the same <var>cite_key</var> twice then you get <samp>LaTeX
+Warning: There were multiply-defined labels</samp>.
+</para>
+<para>Under the hood, &latex; remembers the <var>cite_key</var> and <var>label</var>
+information because <code>\bibitem</code> writes it to the auxiliary file
+<file><var>filename</var>.aux</file>. For instance, the above example causes
+<code>\bibcite&lbrace;latexdps&rbrace;&lbrace;Lamport, 1993&rbrace;</code> and
+<code>\bibcite&lbrace;texbook&rbrace;&lbrace;1&rbrace;</code> to appear in that file. The <file>.aux</file>
+file is read by the <code>\begin&lbrace;document&rbrace;</code> command and then the
+information is available for <code>\cite</code> commands. This explains why
+you need to run &latex; twice to resolve references: once to write it
+out and once to read it in.
+</para>
+<para>Because of this two-pass algorithm, when you add a <code>\bibitem</code> or
+change its <var>cite_key</var> you may get <samp>LaTeX Warning: Label(s) may
+have changed. Rerun to get cross-references right</samp>. Fix it by
+recompiling.
</para>
</subsection>
<node name="_005ccite" spaces=" "><nodename>\cite</nodename><nodenext automatic="on">\nocite</nodenext><nodeprev automatic="on">\bibitem</nodeprev><nodeup automatic="on">thebibliography</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\cite</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="405">\cite</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="416" mergedindex="cp">\cite</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
+<pre xml:space="preserve">\cite&lbrace;<var>keys</var>&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>or
+</para>
+<example endspaces=" ">
<pre xml:space="preserve">\cite[<var>subcite</var>]&lbrace;<var>keys</var>&rbrace;
</pre></example>
-<para>The <var>keys</var> argument is a list of one or more citation keys
-(<pxref label="_005cbibitem"><xrefnodename>\bibitem</xrefnodename></pxref>), separated by commas. This command generates an
-in-text citation to the references associated with <var>keys</var> by entries
-in the <file>.aux</file> file.
+<para>Generate as output a citation to the references associated with
+<var>keys</var>. The mandatory <var>keys</var> is a citation key, or a
+comma-separated list of citation keys (<pxref label="_005cbibitem"><xrefnodename>\bibitem</xrefnodename></pxref>).
</para>
-<para>The text of the optional <var>subcite</var> argument appears after the
-citation. For example, <code>\cite[p.~314]&lbrace;knuth&rbrace;</code> might produce
-<samp>[Knuth, p.&nbsp;314]</samp>.
+<para>This
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">The ultimate source is \cite&lbrace;texbook&rbrace;.
+ ...
+\begin&lbrace;thebibliography&rbrace;
+\bibitem&lbrace;texbook&rbrace;
+ Donald Ervin Knuth.
+ \textit&lbrace;The \TeX book&rbrace;.
+ Addison-Wesley, Reading, Massachusetts, 1983.
+\end&lbrace;thebibliography&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>produces the output <samp>... source is [1]</samp>.
+</para>
+<para>The optional argument <var>subcite</var> is appended to the citation. For
+example, <code>See 14.3 in \cite[p.~314]&lbrace;texbook&rbrace;</code> might produce
+<samp>See 14.3 in [1, p.&nbsp;314]</samp>.
+</para>
+<para>If <var>keys</var> is not in your bibliography information then you get
+<samp>LaTeX Warning: There were undefined references</samp>, and in the output
+the citation shows as a boldface question mark between square brackets.
+There are two possible causes. If you have mistyped something, as in
+<code>\cite&lbrace;texbok&rbrace;</code> then you need to correct the spelling. On the
+other hand, if you have just added or modified the bibliographic
+information and so changed the <file>.aux</file> file (<pxref label="_005cbibitem"><xrefnodename>\bibitem</xrefnodename></pxref>) then
+the fix may be to just run &latex; again.
+</para>
+<para>In addition to what appears in the output, <code>\cite</code> writes
+information to the auxiliary file <file><var>filename</var>.aux</file>. For
+instance, <code>\cite&lbrace;latexdps&rbrace;</code> writes <samp>\citation&lbrace;latexdps&rbrace;</samp>
+to that file. This information is used by Bib&tex; to include in your
+reference list only those works that you have actually cited; see
+<ref label="_005cnocite"><xrefnodename>\nocite</xrefnodename></ref> also.
</para>
</subsection>
<node name="_005cnocite" spaces=" "><nodename>\nocite</nodename><nodenext automatic="on">Using BibTeX</nodenext><nodeprev automatic="on">\cite</nodeprev><nodeup automatic="on">thebibliography</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\nocite</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="406">\nocite</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="417" mergedindex="cp">\nocite</indexterm></findex>
<para>Synopsis:
</para>
@@ -5782,59 +7376,88 @@ citation. For example, <code>\cite[p.~314]&lbrace;knuth&rbrace;</code> might pr
<pre xml:space="preserve"><code>\nocite&lbrace;<var>keys</var>&rbrace;</code>
</pre></example>
-<para>The <code>\nocite</code> command produces no text, but writes <var>keys</var>,
-which is a list of one or more citation keys, to the <file>.aux</file> file.
+<para>Produces no output but writes <var>keys</var> to the auxiliary file
+<file><var>doc-filename</var>.aux</file>.
+</para>
+<para>The mandatory argument <var>keys</var> is a comma-separated list of one or
+more citation keys (<pxref label="_005cbibitem"><xrefnodename>\bibitem</xrefnodename></pxref>). This information is used by
+Bib&tex; to include these works in your reference list even though you
+have not cited them (<pxref label="_005ccite"><xrefnodename>\cite</xrefnodename></pxref>).
</para>
</subsection>
<node name="Using-BibTeX" spaces=" "><nodename>Using BibTeX</nodename><nodeprev automatic="on">\nocite</nodeprev><nodeup automatic="on">thebibliography</nodeup></node>
<subsection spaces=" "><sectiontitle>Using Bib&tex;</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="258">using Bib&tex;</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="259">bib&tex;, using</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="260">bibliography, creating (automatically)</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="407">\bibliographystyle</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="408">\bibliography</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="327">using Bib&tex;</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="328">bib&tex;, using</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="329">bibliography, creating (automatically)</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="418" mergedindex="cp">\bibliographystyle</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="419" mergedindex="cp">\bibliography</indexterm></findex>
-<para>If you use the Bib&tex; program by Oren Patashnik (highly
-recommended if you need a bibliography of more than a couple of
-titles) to maintain your bibliography, you don&textrsquo;t use the
-<code>thebibliography</code> environment (<pxref label="thebibliography"><xrefnodename>thebibliography</xrefnodename></pxref>). Instead,
-you include the lines
+<para>As described in <code>thebibliography</code> (<pxref label="thebibliography"><xrefnodename>thebibliography</xrefnodename></pxref>), a
+sophisticated approach to managing bibliographies is provided by the
+Bib&tex; program. This is only an introduction; see the full
+documentation on CTAN.
+</para>
+<para>With Bib&tex;, you don&textrsquo;t use <code>thebibliography</code>
+(<pxref label="thebibliography"><xrefnodename>thebibliography</xrefnodename></pxref>). Instead, include these lines.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\bibliographystyle&lbrace;<var>bibstyle</var>&rbrace;
-\bibliography&lbrace;<var>bibfile1</var>,<var>bibfile2</var>&rbrace;
+\bibliography&lbrace;<var>bibfile1</var>, <var>bibfile2</var>, ...&rbrace;
</pre></example>
-<para>The <code>\bibliographystyle</code> command does not produce any output of
-its own. Rather, it defines the style in which the bibliography will
-be produced: <var>bibstyle</var> refers to a file
-<var>bibstyle</var><file>.bst</file>, which defines how your citations will look.
-The standard <var>bibstyle</var> names distributed with Bib&tex; are:
+<noindent></noindent>
+<para>The <var>bibstyle</var> refers to a file <file><var>bibstyle</var>.bst</file>, which
+defines how your citations will look. The standard <var>bibstyle</var>&textrsquo;s
+distributed with Bib&tex; are:
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">alpha</itemformat></item>
-</tableterm><tableitem><para>Sorted alphabetically. Labels are formed from name of author and year of
-publication.
+</tableterm><tableitem><para>Labels are formed from name of author and year of publication.
+The bibliographic items are sorted alphabetically.
</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">plain</itemformat></item>
-</tableterm><tableitem><para>Sorted alphabetically. Labels are numeric.
+</tableterm><tableitem><para>Labels are integers.
+Sort the bibliographic items alphabetically.
</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">unsrt</itemformat></item>
</tableterm><tableitem><para>Like <code>plain</code>, but entries are in order of citation.
</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">abbrv</itemformat></item>
</tableterm><tableitem><para>Like <code>plain</code>, but more compact labels.
</para></tableitem></tableentry></table>
-<para>In addition, numerous other Bib&tex; style files exist tailored to
-the demands of various publications. See
+<noindent></noindent> <para>Many, many other Bib&tex; style files exist,
+tailored to the demands of various publications. See CTAN&textrsquo;s listing
<url><urefurl>http://mirror.ctan.org/biblio/bibtex/contrib</urefurl></url>.
</para>
<para>The <code>\bibliography</code> command is what actually produces the
-bibliography. The argument to <code>\bibliography</code> refers to files
-named <file><var>bibfile1</var>.bib</file>, <file><var>bibfile2</var>.bib</file>, &dots;,
-which should contain your database in
-Bib&tex; format. Only the entries referred to via <code>\cite</code> and
-<code>\nocite</code> will be listed in the bibliography.
+bibliography. Its argument is a comma-separated list, referring to
+files named <file><var>bibfile1</var>.bib</file>, <file><var>bibfile2</var>.bib</file>,
+&dots; These contain your database in Bib&tex; format. This shows a
+typical couple of entries in that format.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">&arobase;book&lbrace;texbook,
+ title = &lbrace;The &lbrace;&lbrace;\TeX&rbrace;&rbrace;book&rbrace;,
+ author = &lbrace;D.E. Knuth&rbrace;,
+ isbn = &lbrace;0201134489&rbrace;,
+ series = &lbrace;Computers \&amp; typesetting&rbrace;,
+ year = &lbrace;1983&rbrace;,
+ publisher = &lbrace;Addison-Wesley&rbrace;
+&rbrace;
+&arobase;book&lbrace;sexbook,
+ author = &lbrace;W.H. Masters and V.E. Johnson&rbrace;,
+ title = &lbrace;Human Sexual Response&rbrace;,
+ year = &lbrace;1966&rbrace;,
+ publisher = &lbrace;Bantam Books&rbrace;
+&rbrace;
+</pre></example>
+
+<para>Only the bibliographic entries referred to via <code>\cite</code> and
+<code>\nocite</code> will be listed in the document&textrsquo;s bibliography. Thus you
+can keep all your sources together in one file, or a small number of
+files, and rely on Bib&tex; to include in this document only those that
+you used.
</para>
</subsection>
@@ -5842,34 +7465,58 @@ Bib&tex; format. Only the entries referred to via <code>\cite</code> and
<node name="theorem" spaces=" "><nodename>theorem</nodename><nodenext automatic="on">titlepage</nodenext><nodeprev automatic="on">thebibliography</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>theorem</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="409"><r>environment</r>, <code>theorem</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="410"><code>theorem</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="420" mergedindex="cp"><r>environment</r>, <code>theorem</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="421" mergedindex="cp"><code>theorem</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="261">theorems, typesetting</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="330">theorems, typesetting</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;theorem&rbrace;
-<var>theorem-text</var>
+ <var>theorem body</var>
\end&lbrace;theorem&rbrace;
</pre></example>
-<para>The <code>theorem</code> environment produces &textldquo;Theorem <var>n</var>&textrdquo; in
-boldface followed by <var>theorem-text</var>, where the numbering
-possibilities for <var>n</var> are described under <code>\newtheorem</code>
-(<pxref label="_005cnewtheorem"><xrefnodename>\newtheorem</xrefnodename></pxref>).
+<para>Produces <samp>Theorem <var>n</var></samp> in boldface followed by <var>theorem
+body</var> in italics. The numbering possibilities for <var>n</var> are described under
+<code>\newtheorem</code> (<pxref label="_005cnewtheorem"><xrefnodename>\newtheorem</xrefnodename></pxref>).
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newtheorem&lbrace;lem&rbrace;&lbrace;Lemma&rbrace; % in preamble
+\newtheorem&lbrace;thm&rbrace;&lbrace;Theorem&rbrace;
+ ...
+\begin&lbrace;lem&rbrace; % in document body
+ text of lemma
+\end&lbrace;lem&rbrace;
+
+The next result follows immediately.
+\begin&lbrace;thm&rbrace;[Gauss] % put `Gauss' in parens after theorem head
+ text of theorem
+\end&lbrace;thm&rbrace;
+</pre></example>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="331"><r>package</r>, <code>amsmath</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="332"><code>amsmath</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="333"><r>package</r>, <code>amsthm</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="334"><code>amsthm</code> <r>package</r></indexterm></cindex>
+
+<para>Most new documents use the packages <code>amsthm</code> and <code>amsmath</code>
+from the American Mathematical Society. Among other things these
+packages include a large number of options for theorem environments,
+such as styling options.
</para>
</section>
<node name="titlepage" spaces=" "><nodename>titlepage</nodename><nodenext automatic="on">verbatim</nodenext><nodeprev automatic="on">theorem</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>titlepage</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="411"><r>environment</r>, <code>titlepage</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="412"><code>titlepage</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="422" mergedindex="cp"><r>environment</r>, <code>titlepage</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="423" mergedindex="cp"><code>titlepage</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="262">making a title page</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="263">title pages, creating</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="335">making a title page</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="336">title pages, creating</indexterm></cindex>
<para>Synopsis:
</para>
@@ -5879,14 +7526,11 @@ possibilities for <var>n</var> are described under <code>\newtheorem</code>
\end&lbrace;titlepage&rbrace;
</pre></example>
-<para>Create a title page, a page with no printed page number or heading. The
-following page will be numbered page one.
+<para>Create a title page, a page with no printed page number or heading and
+with succeeding pages numbered starting with page one.
</para>
-<para>To instead produce a standard title page without a <code>titlepage</code>
-environment you can use <code>\maketitle</code> (<pxref label="_005cmaketitle"><xrefnodename>\maketitle</xrefnodename></pxref>).
-</para>
-<para>Notice in this example that all formatting, including vertical spacing,
-is left to the author.
+<para>In this example all formatting, including vertical spacing, is left to
+the author.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;titlepage&rbrace;
@@ -5911,19 +7555,22 @@ is left to the author.
\end&lbrace;titlepage&rbrace;
</pre></example>
+<para>To instead produce a standard title page without a <code>titlepage</code>
+environment, use <code>\maketitle</code> (<pxref label="_005cmaketitle"><xrefnodename>\maketitle</xrefnodename></pxref>).
+</para>
</section>
<node name="verbatim" spaces=" "><nodename>verbatim</nodename><nodenext automatic="on">verse</nodenext><nodeprev automatic="on">titlepage</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>verbatim</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="413"><r>environment</r>, <code>verbatim</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="414"><code>verbatim</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="424" mergedindex="cp"><r>environment</r>, <code>verbatim</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="425" mergedindex="cp"><code>verbatim</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="264">verbatim text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="265">simulating typed text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="266">typed text, simulating</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="267">code, typesetting</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="268">computer programs, typesetting</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="337">verbatim text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="338">simulating typed text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="339">typed text, simulating</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="340">code, typesetting</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="341">computer programs, typesetting</indexterm></cindex>
<para>Synopsis:
</para>
@@ -5933,73 +7580,182 @@ is left to the author.
\end&lbrace;verbatim&rbrace;
</pre></example>
-<para>The <code>verbatim</code> environment is a paragraph-making environment in
-which &latex; produces exactly what you type in; for instance the
-<code>\</code> character produces a printed <samp>\</samp>. It turns &latex;
-into a typewriter with carriage returns and blanks having the same
-effect that they would on a typewriter.
-</para>
-<para>The <code>verbatim</code> environment uses a monospaced typewriter-like font
+<para>A paragraph-making environment in which &latex; produces as output
+exactly what you type as input. For instance inside <var>literal-text</var>
+the backslash&nbsp;<code>\</code> character does not start commands, it
+produces a printed <samp>\</samp>, and carriage returns and blanks are taken
+literally. The output appears in a monospaced typewriter-like font
(<code>\tt</code>).
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;verbatim&rbrace;
+Symbol swearing: %&amp;$#?&eosexcl;.
+\end&lbrace;verbatim&rbrace;
+</pre></example>
+
+<para>The only restriction on <code>literal-text</code> is that it cannot include
+the string <code>\end&lbrace;verbatim&rbrace;</code>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="342"><r>package</r>, <code>cprotect</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="343"><code>cprotect</code> <r>package</r></indexterm></cindex>
+
+<para>You cannot use the verbatim environment in the argument to macros, for
+instance in the argument to a <code>\section</code>. This is not the same as
+commands being fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>), instead it just cannot appear
+there. (But the <code>cprotect</code> package can help with this.)
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="344"><r>package</r>, <code>listings</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="345"><code>listings</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="346"><r>package</r>, <code>minted</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="347"><code>minted</code> <r>package</r></indexterm></cindex>
+
+<para>One common use of verbatim input is to typeset computer code. There are
+packages that are an improvement the <code>verbatim</code> environment. For
+instance, one improvement is to allow the verbatim inclusion of external
+files, or parts of those files. Such packages include <code>listings</code>,
+and <code>minted</code>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="348"><r>package</r>, <code>fancyvrb</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="349"><code>fancyvrb</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="350"><r>package</r>, <code>verbatimbox</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="351"><code>verbatimbox</code> <r>package</r></indexterm></cindex>
+
+<para>A package that provides many more options for verbatim environments is
+<code>fancyvrb</code>. Another is <code>verbatimbox</code>.
+</para>
+<para>For a list of all the relevant packages, see CTAN.
+</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\verb</menunode><menudescription><pre xml:space="preserve">The macro form of the <code>verbatim</code> environment.
</pre></menudescription></menuentry></menu>
+
<node name="_005cverb" spaces=" "><nodename>\verb</nodename><nodeup automatic="on">verbatim</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\verb</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="415">\verb</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="269">verbatim text, inline</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="426" mergedindex="cp">\verb</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="352">verbatim text, inline</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\verb<var>char</var><var>literal-text</var><var>char</var>
-\verb*<var>char</var><var>literal-text</var><var>char</var>
+<pre xml:space="preserve">\verb <var>char</var> <var>literal-text</var> <var>char</var>
+\verb* <var>char</var> <var>literal-text</var> <var>char</var>
</pre></example>
-<para>The <code>\verb</code> command typesets <var>literal-text</var> as it is input,
-including special characters and spaces, using the typewriter
-(<code>\tt</code>) font. No spaces are allowed between <code>\verb</code> or
-<code>\verb*</code> and the delimiter <var>char</var>, which begins and ends the
-verbatim text. The delimiter must not appear in <var>literal-text</var>.
+<para>Typeset <var>literal-text</var> as it is input, including special characters
+and spaces, using the typewriter (<code>\tt</code>) font.
+</para>
+<para>This example shows two different invocations of <code>\verb</code>.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="270">visible space</indexterm></cindex>
-<para>The <code>*</code>-form differs only in that spaces are printed with a
-&textldquo;visible space&textrdquo; character.
+<example endspaces=" ">
+<pre xml:space="preserve">This is \verb!literally! the biggest pumpkin ever.
+And this is the best squash, \verb+literally!+
+</pre></example>
+
+<noindent></noindent>
+<para>The first <code>\verb</code> has its <var>literal-text</var> surrounded with
+exclamation point, <code>!</code>. The second instead uses plus, <code>+</code>,
+because the exclamation point is part of <code>literal-text</code>.
+</para>
+<para>The single-character delimiter <var>char</var> surrounds
+<var>literal-text</var>&nbsp;&textmdash; it must be the same character before and
+after. No spaces come between <code>\verb</code> or <code>\verb*</code> and
+<var>char</var>, or between <var>char</var> and <var>literal-text</var>, or between
+<var>literal-text</var> and the second occurrence of <var>char</var> (the synopsis
+shows a space only to distinguish one component from the other). The
+delimiter must not appear in <var>literal-text</var>. The <var>literal-text</var>
+cannot include a line break.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="353">visible space</indexterm></cindex>
+<para>The <code>*</code>-form differs only in that spaces are printed with a visible
+space character.
<tex endspaces=" ">
</tex>
</para>
+<para>The output from this will include a character showing the spaces.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">The commands's first argument is \verb*!filename with extension! and ...
+</pre></example>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="354"><r>package</r>, <code>url</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="355"><code>url</code> <r>package</r></indexterm></cindex>
+
+<para>For typesetting Internet addresses, urls, the package <code>url</code>
+provides an option that is better than the <code>\verb</code> command, since
+it allows line breaks.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="356"><r>package</r>, <code>listings</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="357"><code>listings</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="358"><r>package</r>, <code>minted</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="359"><code>minted</code> <r>package</r></indexterm></cindex>
+
+<para>For computer code there are many packages with advantages over
+<code>\verb</code>. One is <file>listings</file>, another is <file>minted</file>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="360"><r>package</r>, <code>cprotect</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="361"><code>cprotect</code> <r>package</r></indexterm></cindex>
+
+<para>You cannot use <code>\verb</code> in the argument to a macro, for instance in
+the argument to a <code>\section</code>. It is not a question of <code>\verb</code>
+being fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>), instead it just cannot appear there.
+(But the <code>cprotect</code> package can help with this.)
+</para>
</subsection>
</section>
<node name="verse" spaces=" "><nodename>verse</nodename><nodeprev automatic="on">verbatim</nodeprev><nodeup automatic="on">Environments</nodeup></node>
<section spaces=" "><sectiontitle><code>verse</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="416"><r>environment</r>, <code>verse</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="417"><code>verse</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="427" mergedindex="cp"><r>environment</r>, <code>verse</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="428" mergedindex="cp"><code>verse</code> <r>environment</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="271">poetry, an environment for</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="362">poetry, an environment for</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;verse&rbrace;
-<var>line1</var> \\
-<var>line2</var> \\
-...
+ <var>line1</var> \\
+ <var>line2</var> \\
+ ...
\end&lbrace;verse&rbrace;
</pre></example>
-<para>The <code>verse</code> environment is designed for poetry, though you may find
-other uses for it.
+<para>An environment for poetry.
+</para>
+<para>Here are two lines from Shakespeare&textrsquo;s Romeo and Juliet.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">Then plainly know my heart's dear love is set \\
+On the fair daughter of rich Capulet.
+</pre></example>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="429" mergedindex="cp">\\ <r>for <code>verse</code></r></indexterm></findex>
+<para>Separate the lines of each stanza with <code>\\</code>, and use one or more
+blank lines to separate the stanzas.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="418">\\ <r>for <code>verse</code></r></indexterm></findex>
-<para>The margins are indented on the left and the right, paragraphs are not
-indented, and the text is not justified. Separate the lines of each
-stanza with <code>\\</code>, and use one or more blank lines to separate the
-stanzas.
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;verse&rbrace;
+\makebox[\linewidth][c]&lbrace;\textit&lbrace;Shut Not Your Doors&rbrace; ---Walt Whitman&rbrace;
+ \\[1\baselineskip]
+Shut not your doors to me proud libraries, \\
+For that which was lacking on all your well-fill'd shelves, \\
+\qquad yet needed most, I bring, \\
+Forth from the war emerging, a book I have made, \\
+The words of my book nothing, the drift of it every thing, \\
+A book separate, not link'd with the rest nor felt by the intellect, \\
+But you ye untold latencies will thrill to every page.
+\end&lbrace;verse&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>The output has margins indented on the left and the right, paragraphs
+are not indented, and the text is not right-justified.
</para>
</section>
@@ -6007,8 +7763,8 @@ stanzas.
<node name="Line-breaking" spaces=" "><nodename>Line breaking</nodename><nodenext automatic="on">Page breaking</nodenext><nodeprev automatic="on">Environments</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Line breaking</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="272">line breaking</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="273">breaking lines</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="363">line breaking</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="364">breaking lines</indexterm></cindex>
<para>The first thing &latex; does when processing ordinary text is to
translate your input file into a sequence of glyphs and spaces. To
@@ -6018,14 +7774,19 @@ produce a printed document, this sequence must be broken into lines
<para>&latex; usually does the line (and page) breaking in the text body for
you but in some environments you manually force line breaks.
</para>
+<para>A common workflow is to get a final version of the document content
+before taking a final pass through and considering line breaks (and page
+breaks). This differs from word processing, where you are formatting
+text as you input it. Putting these off until the end prevents a lot of
+fiddling with breaks that will change anyway.
+</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\\</menunode><menudescription><pre xml:space="preserve">Start a new line.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\obeycr &amp; \restorecr</menunode><menudescription><pre xml:space="preserve">Make each input line start a new output line.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\newline</menunode><menudescription><pre xml:space="preserve">Break the line
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\- (hyphenation)</menunode><menudescription><pre xml:space="preserve">Insert explicit hyphenation.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\discretionary</menunode><menudescription><pre xml:space="preserve">Insert explicit hyphenation with control of hyphen character.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\fussy</menunode><menudescription><pre xml:space="preserve">Be fussy about line breaking.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\sloppy</menunode><menudescription><pre xml:space="preserve">Be sloppy about line breaking.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\discretionary</menunode><menudescription><pre xml:space="preserve">Explicit control of the hyphen character.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\fussy &amp; \sloppy</menunode><menudescription><pre xml:space="preserve">Be more or less particular with line breaking.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\hyphenation</menunode><menudescription><pre xml:space="preserve">Tell &latex; how to hyphenate a word.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\linebreak &amp; \nolinebreak</menunode><menudescription><pre xml:space="preserve">Forcing &amp; avoiding line breaks.
</pre></menudescription></menuentry></menu>
@@ -6034,77 +7795,157 @@ you but in some environments you manually force line breaks.
<node name="_005c_005c" spaces=" "><nodename>\\</nodename><nodenext automatic="on">\obeycr &amp; \restorecr</nodenext><nodeup automatic="on">Line breaking</nodeup></node>
<section spaces=" "><sectiontitle><code>\\</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="419">\\ <r>force line break</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="274">new line, starting</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="275">line break, forcing</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="430" mergedindex="cp">\\ <r>force line break</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="365">new line, starting</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="366">line break, forcing</indexterm></cindex>
-<para>Synopsis:
+<para>Synopsis, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\\[<var>morespace</var>]
+<pre xml:space="preserve">\\
+\\[<var>morespace</var>]
</pre></example>
-<para>or
+<noindent></noindent>
+<para>or one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\\*[<var>morespace</var>]
+<pre xml:space="preserve">\\*
+\\*[<var>morespace</var>]
</pre></example>
-<para>Start a new line. The optional argument <var>morespace</var> specifies extra
-vertical space to be insert before the next line. This can be a
-negative length. The text before the break is set at its normal length,
-that is, it is not stretched to fill out the line width.
+<para>End the current line. The optional argument <var>morespace</var> specifies
+extra vertical space to be inserted before the next line. This is a
+rubber length (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>) and can be negative. The text before
+the line break is set at its normal length, that is, it is not stretched
+to fill out the line width. This command is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
-<para>Explicit line breaks in the text body are unusual in &latex;. In
-particular, to start a new paragraph instead leave a blank line. This
-command is mostly used outside of the main flow of text such as in
-a <code>tabular</code> or <code>array</code> environment.
-</para>
-<para>Under ordinary circumstances (e.g., outside of a <code>p&lbrace;...&rbrace;</code> column
-in a <code>tabular</code> environment) the <code>\newline</code> command is a synonym for
-<code>\\</code> (<pxref label="_005cnewline"><xrefnodename>\newline</xrefnodename></pxref>).
-</para>
-<para>In addition to starting a new line, the starred form <code>\\*</code> tells
-&latex; not to start a new page between the two lines, by issuing a
-<code>\nobreak</code>.
+<para>The starred form, <code>\\*</code>, tells &latex; not to start a new page
+between the two lines, by issuing a <code>\nobreak</code>.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\title&lbrace;My story: \\[0.25in]
a tale of woe&rbrace;
</pre></example>
+<para>Explicit line breaks in the main text body are unusual in &latex;. In
+particular, don&textrsquo;t start new paragraphs with <code>\\</code>. Instead leave a
+blank line between the two paragraphs. And don&textrsquo;t put in a sequence of
+<code>\\</code>&textrsquo;s to make vertical space. Instead use
+<code>\vspace&lbrace;<var>length</var>&rbrace;</code>, or
+<code>\leavevmode\vspace&lbrace;<var>length</var>&rbrace;</code>, or
+<code>\vspace*&lbrace;<var>length</var>&rbrace;</code> if you want the space to not be thrown
+out at the top of a new page (<pxref label="_005cvspace"><xrefnodename>\vspace</xrefnodename></pxref>).
+</para>
+<para>The <code>\\</code> command is mostly used outside of the main flow of text
+such as in a <code>tabular</code> or <code>array</code> environment or in an
+equation environment.
+</para>
+<para>The <code>\\</code> command is a synonym for <code>\newline</code>
+(<pxref label="_005cnewline"><xrefnodename>\newline</xrefnodename></pxref>) under ordinary circumstances (an example of an
+exception is the <code>p&lbrace;...&rbrace;</code> column in a <code>tabular</code>
+environment; <pxref label="tabular"><xrefnodename>tabular</xrefnodename></pxref>).
+</para>
+<!-- c credit: David Carlisle https://tex.stackexchange.com/a/82666 -->
+<para>The <code>\\</code> command is a macro, and its definition changes by context
+so that its definition in normal text, a <code>center</code> environment, a
+<code>flushleft</code> environment, and a <code>tabular</code> are all different.
+In normal text when it forces a linebreak it is essentially a shorthand
+for <code>\newline</code>. It does not end horizontal mode or end the
+paragraph, it just inserts some glue and penalties so that when the
+paragraph does end a linebreak will occur at that point, with the short
+line padded with white space.
+</para>
+<para>You get <samp>LaTeX Error: There's no line here to end</samp> if you use
+<code>\\</code> to ask for a new line, rather than to end the current line.
+An example is if you have <code>\begin&lbrace;document&rbrace;\\</code> or, more likely,
+something like this.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;center&rbrace;
+ \begin&lbrace;minipage&rbrace;&lbrace;0.5\textwidth&rbrace;
+ \\
+ In that vertical space put your mark.
+ \end&lbrace;minipage&rbrace;
+\end&lbrace;center&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>Fix it by replacing the double backslash with something like
+<code>\vspace&lbrace;\baselineskip&rbrace;</code>.
+</para>
</section>
<node name="_005cobeycr-_0026-_005crestorecr" spaces=" "><nodename>\obeycr &amp; \restorecr</nodename><nodenext automatic="on">\newline</nodenext><nodeprev automatic="on">\\</nodeprev><nodeup automatic="on">Line breaking</nodeup></node>
<section spaces=" "><sectiontitle><code>\obeycr</code> &amp; <code>\restorecr</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="420">\obeycr</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="421">\restorecr</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="276">new line, output as input</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="431" mergedindex="cp">\obeycr</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="432" mergedindex="cp">\restorecr</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="367">new line, output as input</indexterm></cindex>
+
+<para>The <code>\obeycr</code> command makes a return in the input file (<samp>^^M</samp>,
+internally) the same as <code>\\</code>, followed by <code>\relax</code>. So each
+new line in the input will also be a new line in the output. The
+<code>\restorecr</code> command restores normal line-breaking behavior.
+</para>
+<para>This is not the way to show verbatim text or computer code.
+<xref label="verbatim"><xrefnodename>verbatim</xrefnodename></xref> instead.
+</para>
+<para>With &latex;&textrsquo;s usual defaults, this
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">aaa
+bbb
+
+\obeycr
+ccc
+ddd
+ eee
+
+\restorecr
+fff
+ggg
-<para>The <code>\obeycr</code> command makes a return in the input file
-(<samp>^^M</samp>, internally) the same as <code>\\</code> (followed by
-<code>\relax</code>). So each new line in the input will also be a new line
-in the output.
+hhh
+iii
+</pre></example>
+
+<noindent></noindent>
+<para>produces output like this.
</para>
-<para><code>\restorecr</code> restores normal line-breaking behavior.
+<example endspaces=" ">
+<pre xml:space="preserve"> aaa bbb
+ ccc
+ddd
+eee
+
+fff ggg
+ hhh iii
+</pre></example>
+
+<noindent></noindent>
+<para>The indents are paragraph indents.
</para>
</section>
<node name="_005cnewline" spaces=" "><nodename>\newline</nodename><nodenext automatic="on">\- (hyphenation)</nodenext><nodeprev automatic="on">\obeycr &amp; \restorecr</nodeprev><nodeup automatic="on">Line breaking</nodeup></node>
<section spaces=" "><sectiontitle><code>\newline</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="422">\newline</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="277">new line, starting (paragraph mode)</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="433" mergedindex="cp">\newline</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="368">new line, starting (paragraph mode)</indexterm></cindex>
-<para>In ordinary text this is equivalent to double-backslash (<pxref label="_005c_005c"><xrefnodename>\\</xrefnodename></pxref>); it
-breaks a line, with no stretching of the text before it.
+<para>In ordinary text, this ends a line in a way that does not right-justify
+the line, so the prior text is not stretched. That is, in paragraph mode
+(<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>), the <code>\newline</code> command is equivalent to
+double-backslash (<pxref label="_005c_005c"><xrefnodename>\\</xrefnodename></pxref>). This command is fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
-<para>Inside a <code>tabular</code> or <code>array</code> environment, in a column with a
-specifier producing a paragraph box, like typically <code>p&lbrace;...&rbrace;</code>,
-<code>\newline</code> will insert a line break inside of the column, that is,
-it does not break the entire row. To break the entire row use <code>\\</code>
-or its equivalent <code>\tabularnewline</code>.
+<para>However, the two commands are different inside a <code>tabular</code> or
+<code>array</code> environment. In a column with a specifier producing a
+paragraph box such as typically <code>p&lbrace;...&rbrace;</code>, <code>\newline</code> will
+insert a line end inside of the column; that is, it does not break the
+entire tabular row. To break the entire row use <code>\\</code> or its
+equivalent <code>\tabularnewline</code>.
</para>
<para>This will print <samp>Name:</samp> and <samp>Address:</samp> as two lines in a
single cell of the table.
@@ -6115,6 +7956,7 @@ single cell of the table.
\end&lbrace;tabular&rbrace;
</pre></example>
+<noindent></noindent>
<para>The <samp>Date:</samp> will be baseline-aligned with <samp>Name:</samp>.
</para>
@@ -6122,215 +7964,451 @@ single cell of the table.
<node name="_005c_002d-_0028hyphenation_0029" spaces=" "><nodename>\- (hyphenation)</nodename><nodenext automatic="on">\discretionary</nodenext><nodeprev automatic="on">\newline</nodeprev><nodeup automatic="on">Line breaking</nodeup></node>
<section spaces=" "><sectiontitle><code>\-</code> (discretionary hyphen)</sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="423">\- <r>(hyphenation)</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="278">hyphenation, forcing</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="434" mergedindex="cp">\- <r>(hyphenation)</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="369">hyphenation, forcing</indexterm></cindex>
+
+<para>Tell &latex; that it may hyphenate the word at that point. When you
+insert <code>\-</code> commands in a word, the word will only be hyphenated at
+those points and not at any of the hyphenation points that &latex;
+might otherwise have chosen. This command is robust (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<para>&latex; is good at hyphenating and usually finds most of the correct
+hyphenation points, while almost never using an incorrect one. The
+<code>\-</code> command is for exceptional cases.
+</para>
+<para>For example, &latex; does not ordinarily hyphenate words containing a
+hyphen. Below, the long and hyphenated word means &latex; has to put
+in unacceptably large spaces to set the narrow column.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;tabular&rbrace;&lbrace;rp&lbrace;1.75in&rbrace;&rbrace;
+ Isaac Asimov &amp;The strain of
+ anti-intellectualism
+ % an\-ti-in\-tel\-lec\-tu\-al\-ism
+ has been a constant thread winding its way through our
+ political and cultural life, nurtured by
+ the false notion that democracy means that
+ `my ignorance is just as good as your knowledge'.
+\end&lbrace;tabular&rbrace;
+</pre></example>
-<para>The <code>\-</code> command tells &latex; that it may hyphenate the word at
-that point. &latex; is pretty good at hyphenating, and usually finds
-most of the correct hyphenation points, while almost never using an
-incorrect one. The <code>\-</code> command is used for the exceptional
-cases.
+<noindent></noindent>
+<para>Commenting out the third line and uncommenting the fourth makes a much
+better fit.
</para>
-<para>When you insert <code>\-</code> commands in a word, the word will only be
-hyphenated at those points and not at any of the hyphenation points
-that &latex; might otherwise have chosen.
+<para>The <code>\-</code> command only allows &latex; to break there, it does not
+require that it break there. You can insist on a split with something
+like <code>Hef-\linebreak feron</code>. Of course, if you later change the
+text then this forced break may look very odd, so this approach requires
+care.
</para>
+
</section>
-<node name="_005cdiscretionary" spaces=" "><nodename>\discretionary</nodename><nodenext automatic="on">\fussy</nodenext><nodeprev automatic="on">\- (hyphenation)</nodeprev><nodeup automatic="on">Line breaking</nodeup></node>
+<node name="_005cdiscretionary" spaces=" "><nodename>\discretionary</nodename><nodenext automatic="on">\fussy &amp; \sloppy</nodenext><nodeprev automatic="on">\- (hyphenation)</nodeprev><nodeup automatic="on">Line breaking</nodeup></node>
<section spaces=" "><sectiontitle><code>\discretionary</code> (generalized hyphenation point)</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="279">hyphenation, discretionary</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="280">discretionary hyphenation</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="370">hyphenation, discretionary</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="371">discretionary hyphenation</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\discretionary&lbrace;<var>pre-break-text</var>&rbrace;&lbrace;<var>post-break-text</var>&rbrace;&lbrace;<var>no-break-text</var>&rbrace;
+<pre xml:space="preserve">\discretionary&lbrace;<var>pre-break</var>&rbrace;&lbrace;<var>post-break</var>&rbrace;&lbrace;<var>no-break</var>&rbrace;
+</pre></example>
+
+<para>Handle word changes around hyphens. This command is not often used in
+&latex; documents.
+</para>
+<para>If a line break occurs at the point where <code>\discretionary</code> appears
+then &tex; puts <var>pre-break</var> at the end of the current line and puts
+<var>post-break</var> at the start of the next line. If there is no line
+break here then &tex; puts <var>no-break</var>
+</para>
+<para>In <samp>difficult</samp> the three letters <code>ffi</code> form a ligature. But
+&tex; can nonetheless break between the two f&textrsquo;s with this.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">di\discretionary&lbrace;f-&rbrace;&lbrace;fi&rbrace;&lbrace;ffi&rbrace;cult
</pre></example>
-<!-- c xxx TODO, complete this node, see LaTeX-fr -->
+<para>Note that users do not have to do this. It is typically handled
+automatically by &tex;&textrsquo;s hyphenation algorithm.
+</para>
</section>
-<node name="_005cfussy" spaces=" "><nodename>\fussy</nodename><nodenext automatic="on">\sloppy</nodenext><nodeprev automatic="on">\discretionary</nodeprev><nodeup automatic="on">Line breaking</nodeup></node>
-<section spaces=" "><sectiontitle><code>\fussy</code></sectiontitle>
+<node name="_005cfussy-_0026-_005csloppy" spaces=" "><nodename>\fussy &amp; \sloppy</nodename><nodenext automatic="on">\hyphenation</nodenext><nodeprev automatic="on">\discretionary</nodeprev><nodeup automatic="on">Line breaking</nodeup></node>
+<section spaces=" "><sectiontitle><code>\fussy</code> &amp; <code>\sloppy</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="424">\fussy</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="435" mergedindex="cp">\fussy</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="436" mergedindex="cp">\sloppy</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="372">line breaks, changing</indexterm></cindex>
-<para>The declaration <code>\fussy</code> (which is the default) makes &tex;
-picky about line breaking. This usually avoids too much space between
-words, at the cost of an occasional overfull box.
+<para>Declarations to make &tex; more picky or less picky about line
+breaking. Declaring <code>\fussy</code> usually avoids too much space between
+words, at the cost of an occasional overfull box. Conversely,
+<code>\sloppy</code> avoids overfull boxes while suffering loose interword
+spacing.
</para>
-<para>This command cancels the effect of a previous <code>\sloppy</code> command
-(<pxref label="_005csloppy"><xrefnodename>\sloppy</xrefnodename></pxref>).
+<para>The default is <code>\fussy</code>. Line breaking in a paragraph is
+controlled by whichever declaration is current at the blank line, or
+<code>\par</code>, or displayed equation ending that paragraph. So to affect
+the line breaks, include that paragraph-ending material in the scope of
+the command.
</para>
+<menu endspaces=" ">
+<menuentry leadingtext="* "><menunode separator=":: ">sloppypar</menunode><menudescription><pre xml:space="preserve">Environment version of \sloppy command.
+</pre></menudescription></menuentry></menu>
-</section>
-<node name="_005csloppy" spaces=" "><nodename>\sloppy</nodename><nodenext automatic="on">\hyphenation</nodenext><nodeprev automatic="on">\fussy</nodeprev><nodeup automatic="on">Line breaking</nodeup></node>
-<section spaces=" "><sectiontitle><code>\sloppy</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="425">\sloppy</indexterm></findex>
+<node name="sloppypar" spaces=" "><nodename>sloppypar</nodename><nodeup automatic="on">\fussy &amp; \sloppy</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>sloppypar</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="437" mergedindex="cp">sloppypar</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="373">sloppypar environment</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;sloppypar&rbrace;
+ ... paragraphs ...
+\end&lbrace;sloppypar&rbrace;
+</pre></example>
-<para>The declaration <code>\sloppy</code> makes &tex; less fussy about line
-breaking. This will avoid overfull boxes, at the cost of loose
-interword spacing.
+<para>Typeset the paragraphs with <code>\sloppy</code> in effect (<pxref label="_005cfussy-_0026-_005csloppy"><xrefnodename>\fussy &amp;
+\sloppy</xrefnodename></pxref>). Use this to locally adjust line breaking, to avoid
+<samp>Overfull box</samp> or <samp>Underfull box</samp> errors.
</para>
-<para>Lasts until a <code>\fussy</code> command is issued (<pxref label="_005cfussy"><xrefnodename>\fussy</xrefnodename></pxref>).
+<para>The example is simple.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;sloppypar&rbrace;
+ Her plan for the morning thus settled, she sat quietly down to her
+ book after breakfast, resolving to remain in the same place and the
+ same employment till the clock struck one; and from habitude very
+ little incommoded by the remarks and ejaculations of Mrs.\ Allen,
+ whose vacancy of mind and incapacity for thinking were such, that
+ as she never talked a great deal, so she could never be entirely
+ silent; and, therefore, while she sat at her work, if she lost her
+ needle or broke her thread, if she heard a carriage in the street,
+ or saw a speck upon her gown, she must observe it aloud, whether
+ there were anyone at leisure to answer her or not.
+\end&lbrace;sloppypar&rbrace;
+</pre></example>
+
+</subsection>
</section>
-<node name="_005chyphenation" spaces=" "><nodename>\hyphenation</nodename><nodenext automatic="on">\linebreak &amp; \nolinebreak</nodenext><nodeprev automatic="on">\sloppy</nodeprev><nodeup automatic="on">Line breaking</nodeup></node>
+<node name="_005chyphenation" spaces=" "><nodename>\hyphenation</nodename><nodenext automatic="on">\linebreak &amp; \nolinebreak</nodenext><nodeprev automatic="on">\fussy &amp; \sloppy</nodeprev><nodeup automatic="on">Line breaking</nodeup></node>
<section spaces=" "><sectiontitle><code>\hyphenation</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="426">\hyphenation</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="281">hyphenation, defining</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="438" mergedindex="cp">\hyphenation</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="374">hyphenation, defining</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\hyphenation&lbrace;<var>word-one</var> <var>word-two</var>&rbrace;
+<pre xml:space="preserve">\hyphenation&lbrace;<var>word1</var> ...&rbrace;
</pre></example>
-<para>The <code>\hyphenation</code> command declares allowed hyphenation points
-with a <code>-</code> character in the given words. The words are separated
-by spaces. &tex; will only hyphenate if the word matches exactly, no
-inflections are tried. Multiple <code>\hyphenation</code> commands
-accumulate. Some examples (the default &tex; hyphenation patterns
-misses the hyphenations in these words):
+<para>Declares allowed hyphenation points within the words in the list. The
+words in that list are separated by spaces. Show permitted points for
+hyphenation with a dash character, <code>-</code>.
+</para>
+<para>Here is an example:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\hyphenation&lbrace;ap-pen-dix col-umns data-base data-bases&rbrace;
+<pre xml:space="preserve">\hyphenation&lbrace;hat-er il-lit-e-ra-ti tru-th-i-ness&rbrace;
</pre></example>
+<para>Use lowercase letters. &tex; will only hyphenate if the word matches
+exactly. Multiple <code>\hyphenation</code> commands accumulate.
+</para>
</section>
<node name="_005clinebreak-_0026-_005cnolinebreak" spaces=" "><nodename>\linebreak &amp; \nolinebreak</nodename><nodeprev automatic="on">\hyphenation</nodeprev><nodeup automatic="on">Line breaking</nodeup></node>
<section spaces=" "><sectiontitle><code>\linebreak</code> &amp; <code>\nolinebreak</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="427">\linebreak</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="428">\nolinebreak</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="282">line breaks, forcing</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="283">line breaks, preventing</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="439" mergedindex="cp">\linebreak</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="440" mergedindex="cp">\nolinebreak</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="375">line breaks, forcing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="376">line breaks, preventing</indexterm></cindex>
-<para>Synopses:
+<para>Synopses, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\linebreak[<var>priority</var>]
-\nolinebreak[<var>priority</var>]
+<pre xml:space="preserve">\linebreak
+\linebreak[<var>zero-to-four</var>]
</pre></example>
-<para>By default, the <code>\linebreak</code> (<code>\nolinebreak</code>) command forces
-(prevents) a line break at the current position. For
-<code>\linebreak</code>, the spaces in the line are stretched out so that it
-extends to the right margin as usual.
+<noindent></noindent>
+<para>or one of these.
</para>
-<para>With the optional argument <var>priority</var>, you can convert the command
-from a demand to a request. The <var>priority</var> must be a number from
-0 to&nbsp;4. The higher the number, the more insistent the request.
+<example endspaces=" ">
+<pre xml:space="preserve">\nolinebreak
+\nolinebreak[<var>zero-to-four</var>]
+</pre></example>
+
+<para>Encourage or discourage a line break. The optional <var>zero-to-four</var>
+is an integer that allows you to soften the instruction. The default is
+4, so that without the optional argument these commands entirely force
+or prevent the break. But for instance, <code>\nolinebreak[1]</code> is a
+suggestion that another place may be better. The higher the number, the
+more insistent the request. Both commands are fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<para>Here we tell &latex; that a good place to put a linebreak is after the
+standard legal text.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\boilerplatelegal&lbrace;&rbrace; \linebreak[2]
+We especially encourage applications from members of traditionally
+underrepresented groups.
+</pre></example>
+
+<para>When you issue <code>\linebreak</code>, the spaces in the line are stretched
+out so that it extends to the right margin. <xref label="_005c_005c"><xrefnodename>\\</xrefnodename></xref>
+and&nbsp;<ref label="_005cnewline"><xrefnodename>\newline</xrefnodename></ref> to have the spaces not stretched out.
</para>
+
</section>
</chapter>
<node name="Page-breaking" spaces=" "><nodename>Page breaking</nodename><nodenext automatic="on">Footnotes</nodenext><nodeprev automatic="on">Line breaking</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Page breaking</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="284">page breaking</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="285">breaking pages</indexterm></cindex>
-
-<para>&latex; starts new pages asynchronously, when enough material has
-accumulated to fill up a page. Usually this happens automatically,
-but sometimes you may want to influence the breaks.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="377">page breaking</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="378">breaking pages</indexterm></cindex>
+
+<para>Ordinarily &latex; automatically takes care of breaking output into
+pages with its usual aplomb. But if you are writing commands, or
+tweaking the final version of a document, then you may need to
+understand how to influence its actions.
+</para>
+<!-- c credit: H Vogt https://tex.stackexchange.com/a/115563 -->
+<para>&latex;&textrsquo;s algorithm for splitting a document into pages is more complex
+than just waiting until there is enough material to fill a page and
+outputting the result. Instead, &latex; typesets more material than
+would fit on the page and then chooses a break that is optimal in some
+way (it has the smallest badness). An example of the advantage of this
+approach is that if the page has some vertical space that can be
+stretched or shrunk, such as with rubber lengths between paragraphs,
+then &latex; can use that to avoid widow lines (where a new page starts
+with the last line of a paragraph; &latex; can squeeze the extra line
+onto the first page) and orphans (where the first line of paragraph is
+at the end of a page; &latex; can stretch the material of the first
+page so the extra line falls on the second page). Another example is
+where &latex; uses available vertical shrinkage to fit on a page not
+just the header for a new section but also the first two lines of that
+section.
+</para>
+<para>But &latex; does not optimize over the entire document&textrsquo;s set of page
+breaks. So it can happen that the first page break is great but the
+second one is lousy; to break the current page &latex; doesn&textrsquo;t look as
+far ahead as the next page break. So occasionally you may want to
+influence page breaks while preparing a final version of a document.
+</para>
+<para><xref label="Layout"><xrefnodename>Layout</xrefnodename></xref> for more material that is relevant to page breaking.
</para>
<menu endspaces=" ">
-<menuentry leadingtext="* "><menunode separator=":: ">\cleardoublepage</menunode><menudescription><pre xml:space="preserve">Start a new right-hand page.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\clearpage</menunode><menudescription><pre xml:space="preserve">Start a new page.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\newpage</menunode><menudescription><pre xml:space="preserve">Start a new page.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\enlargethispage</menunode><menudescription><pre xml:space="preserve">Enlarge the current page a bit.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\pagebreak &amp; \nopagebreak</menunode><menudescription><pre xml:space="preserve">Forcing &amp; avoiding page breaks.
+<menuentry leadingtext="* "><menunode separator=":: ">\clearpage &amp; \cleardoublepage</menunode><menudescription><pre xml:space="preserve">Start a new page; eject floats.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\newpage</menunode><menudescription><pre xml:space="preserve">Start a new page.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\enlargethispage</menunode><menudescription><pre xml:space="preserve">Enlarge the current page a bit.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\pagebreak &amp; \nopagebreak</menunode><menudescription><pre xml:space="preserve">Forcing &amp; avoiding page breaks.
</pre></menudescription></menuentry></menu>
-<node name="_005ccleardoublepage" spaces=" "><nodename>\cleardoublepage</nodename><nodenext automatic="on">\clearpage</nodenext><nodeup automatic="on">Page breaking</nodeup></node>
-<section spaces=" "><sectiontitle><code>\cleardoublepage</code></sectiontitle>
+<node name="_005cclearpage-_0026-_005ccleardoublepage" spaces=" "><nodename>\clearpage &amp; \cleardoublepage</nodename><nodenext automatic="on">\newpage</nodenext><nodeup automatic="on">Page breaking</nodeup></node>
+<section spaces=" "><sectiontitle><code>\clearpage</code> &amp; <code>\cleardoublepage</code> </sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="429">\cleardoublepage</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="286">starting on a right-hand page</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="441" mergedindex="cp">\clearpage</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="379">flushing floats and starting a page</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="380">starting a new page and clearing floats</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="442" mergedindex="cp">\cleardoublepage</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="381">starting on a right-hand page</indexterm></cindex>
-<para>The <code>\cleardoublepage</code> command ends the current page and causes all
-the pending floating figures and tables that have so far appeared in the
-input to be printed. In a two-sided printing style, it also makes the
-next page a right-hand (odd-numbered) page, producing a blank page if
-necessary.
+<para>Synopsis:
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\clearpage
+</pre></example>
-</section>
-<node name="_005cclearpage" spaces=" "><nodename>\clearpage</nodename><nodenext automatic="on">\newpage</nodenext><nodeprev automatic="on">\cleardoublepage</nodeprev><nodeup automatic="on">Page breaking</nodeup></node>
-<section spaces=" "><sectiontitle><code>\clearpage</code></sectiontitle>
+<noindent></noindent>
+<para>or
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\cleardoublepage
+</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="430">\clearpage</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="287">flushing floats and starting a page</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="288">starting a new page and clearing floats</indexterm></cindex>
+<para>End the current page and output all of the pending floating figures and
+tables (<pxref label="Floats"><xrefnodename>Floats</xrefnodename></pxref>). If there are too many floats to fit on the
+page then &latex; will put in extra pages containing only floats. In
+two-sided printing, <code>\cleardoublepage</code> also makes the next page of
+content a right-hand page, an odd-numbered page, if necessary inserting
+a blank page. The <code>\clearpage</code> command is robust while
+<code>\cleardoublepage</code> is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<para>&latex;&textrsquo;s page breaks are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+</para>
+<!-- c credit: https://www.tex.ac.uk/FAQ-reallyblank.html -->
+<para>The <code>\cleardoublepage</code> command will put in a blank page, but it
+will have the running headers and footers. To get a really blank
+page, use this command.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\let\origdoublepage\cleardoublepage
+\newcommand&lbrace;\clearemptydoublepage&rbrace;&lbrace;%
+ \clearpage
+ &lbrace;\pagestyle&lbrace;empty&rbrace;\origdoublepage&rbrace;%
+&rbrace;
+</pre></example>
-<para>The <code>\clearpage</code> command ends the current page and causes all the
-pending floating figures and tables that have so far appeared in the
-input to be printed.
+<noindent></noindent>
+<para>If you want &latex;&textrsquo;s standard <code>\chapter</code> command to do this then
+add the line <code>\let\cleardoublepage\clearemptydoublepage</code>.
</para>
+<para>The command <code>\newpage</code> (<pxref label="_005cnewpage"><xrefnodename>\newpage</xrefnodename></pxref>) also ends the current
+page, but without clearing pending floats. And, if &latex; is in
+two-column mode then <code>\newpage</code> ends the current column while
+<code>\clearpage</code> and <code>\cleardoublepage</code> end the current page.
+</para>
+
</section>
-<node name="_005cnewpage" spaces=" "><nodename>\newpage</nodename><nodenext automatic="on">\enlargethispage</nodenext><nodeprev automatic="on">\clearpage</nodeprev><nodeup automatic="on">Page breaking</nodeup></node>
+<node name="_005cnewpage" spaces=" "><nodename>\newpage</nodename><nodenext automatic="on">\enlargethispage</nodenext><nodeprev automatic="on">\clearpage &amp; \cleardoublepage</nodeprev><nodeup automatic="on">Page breaking</nodeup></node>
<section spaces=" "><sectiontitle><code>\newpage</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="431">\newpage</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="289">new page, starting</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="290">starting a new page</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="443" mergedindex="cp">\newpage</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="382">new page, starting</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="383">starting a new page</indexterm></cindex>
-<para>The <code>\newpage</code> command ends the current page, but does not clear
-floats (<pxref label="_005cclearpage"><xrefnodename>\clearpage</xrefnodename></pxref>).
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newpage
+</pre></example>
+
+<para>End the current page. This command is robust (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<para>&latex;&textrsquo;s page breaks are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
+</para>
+<para>While the commands <code>\clearpage</code> and <code>\cleardoublepage</code> also
+end the current page, in addition they clear pending floats
+(<pxref label="_005cclearpage-_0026-_005ccleardoublepage"><xrefnodename>\clearpage &amp; \cleardoublepage</xrefnodename></pxref>). And, if &latex; is in
+two-column mode then <code>\clearpage</code> and <code>\cleardoublepage</code> end
+the current page, possibly leaving an empty column, while
+<code>\newpage</code> only ends the current column.
+</para>
+<para>In contrast with <code>\pagebreak</code> (<pxref label="_005cpagebreak-_0026-_005cnopagebreak"><xrefnodename>\pagebreak &amp; \nopagebreak</xrefnodename></pxref>),
+the <code>\newpage</code> command will cause the new page to start right where
+requested. This
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">Four score and seven years ago our fathers brought forth on this
+continent,
+\newpage
+\noindent a new nation, conceived in Liberty, and dedicated to the
+proposition that all men are created equal.
+</pre></example>
+
+<noindent></noindent>
+<para>makes a new page start after <samp>continent,</samp> and the cut-off line is
+not right justified. In addition, <code>\newpage</code> does not vertically
+stretch out the page, as <code>\pagebreak</code> does.
</para>
</section>
<node name="_005cenlargethispage" spaces=" "><nodename>\enlargethispage</nodename><nodenext automatic="on">\pagebreak &amp; \nopagebreak</nodenext><nodeprev automatic="on">\newpage</nodeprev><nodeup automatic="on">Page breaking</nodeup></node>
<section spaces=" "><sectiontitle><code>\enlargethispage</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="432">\enlargethispage</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="291">enlarge current page</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="444" mergedindex="cp">\enlargethispage</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="384">enlarge current page</indexterm></cindex>
-<para><code>\enlargethispage&lbrace;size&rbrace;</code>
+<para>Synopsis, one of:
</para>
-<para><code>\enlargethispage*&lbrace;size&rbrace;</code>
+<example endspaces=" ">
+<pre xml:space="preserve">\enlargethispage&lbrace;size&rbrace;
+\enlargethispage*&lbrace;size&rbrace;
+</pre></example>
+
+<para>Enlarge the <code>\textheight</code> for the current page. The required
+argument <var>size</var> must be a rigid length (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). It may be
+positive or negative. This command is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
-<para>Enlarge the <code>\textheight</code> for the current page by the specified
-amount; e.g., <code>\enlargethispage&lbrace;\baselineskip&rbrace;</code> will allow one
-additional line.
+<para>A common strategy is to wait until you have the final text of a
+document, and then pass through it tweaking line and page breaks. This
+command allows you some page size leeway.
</para>
-<para>The starred form tries to squeeze the material together on the page as
-much as possible. This is normally used together with an explicit
-<code>\pagebreak</code>.
+<para>This will allow one extra line on the current page.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\enlargethispage&lbrace;\baselineskip&rbrace;
+</pre></example>
+
+<para>The starred form <code>\enlargesthispage*</code> tries to squeeze the material
+together on the page as much as possible, for the common use case of
+getting one more line on the page. This is often used together with an
+explicit <code>\pagebreak</code>.
</para>
</section>
<node name="_005cpagebreak-_0026-_005cnopagebreak" spaces=" "><nodename>\pagebreak &amp; \nopagebreak</nodename><nodeprev automatic="on">\enlargethispage</nodeprev><nodeup automatic="on">Page breaking</nodeup></node>
<section spaces=" "><sectiontitle><code>\pagebreak</code> &amp; <code>\nopagebreak</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="433">\pagebreak</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="434">\nopagebreak</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="292">page break, forcing</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="293">page break, preventing</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="445" mergedindex="cp">\pagebreak</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="446" mergedindex="cp">\nopagebreak</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="385">page break, forcing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="386">page break, preventing</indexterm></cindex>
<para>Synopses:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\pagebreak[<var>priority</var>]
-\nopagebreak[<var>priority</var>]
+<pre xml:space="preserve">\pagebreak
+\pagebreak[<var>zero-to-four</var>]
+</pre></example>
+
+<noindent></noindent>
+<para>or
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\nopagebreak
+\nopagebreak[<var>zero-to-four</var>]
</pre></example>
-<para>By default, the <code>\pagebreak</code> (<code>\nopagebreak</code>) command forces
-(prevents) a page break at the current position. With
-<code>\pagebreak</code>, the vertical space on the page is stretched out
-where possible so that it extends to the normal bottom margin.
+<para>Encourage or discourage a page break. The optional <var>zero-to-four</var>
+is an integer that allows you to soften the request. The default is 4,
+so that without the optional argument these commands entirely force or
+prevent the break. But for instance <code>\nopagebreak[1]</code> suggests to
+&latex; that another spot might be preferable. The higher the number,
+the more insistent the request. Both commands are fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<para>&latex;&textrsquo;s page endings are optimized so ordinarily you only use this
+command in a document body to polish the final version, or inside
+commands.
</para>
-<para>With the optional argument <var>priority</var>, you can convert the
-<code>\pagebreak</code> command from a demand to a request. The number must
-be a number from 0 to&nbsp;4. The higher the number, the more
-insistent the request is.
+<para>If you use these inside a paragraph, they apply to the point following
+the line in which they appear. So this
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">Four score and seven years ago our fathers brought forth on this
+continent,
+\pagebreak
+a new nation, conceived in Liberty, and dedicated to the proposition
+that all men are created equal.
+</pre></example>
+
+<noindent></noindent>
+<para>does not give a page break at <samp>continent,</samp> but instead at
+<samp>nation,</samp> since that is where &latex; breaks that line. In
+addition, with <code>\pagebreak</code> the vertical space on the page is
+stretched out where possible so that it extends to the normal bottom
+margin. This can look strange, and if <code>\flushbottom</code> is in effect
+this can cause you to get <samp>Underfull \vbox (badness 10000) has
+occurred while \output is active</samp>. <xref label="_005cnewpage"><xrefnodename>\newpage</xrefnodename></xref> for a command that
+does not have these effects.
</para>
</section>
@@ -6338,95 +8416,130 @@ insistent the request is.
<node name="Footnotes" spaces=" "><nodename>Footnotes</nodename><nodenext automatic="on">Definitions</nodenext><nodeprev automatic="on">Page breaking</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Footnotes</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="294">footnotes, creating</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="387">footnotes, creating</indexterm></cindex>
-<para>Place a numbered footnote at the bottom of the current page, as here.
+<para>Place a footnote at the bottom of the current page, as here.
</para>
<example endspaces=" ">
<pre xml:space="preserve">No<accent type="uml">e</accent>l Coward quipped that having to read a footnote is like having
to go downstairs to answer the door, while in the midst of making
-love.\footnote&lbrace;I wouldn't know, I don't read footnotes.&rbrace;
+love.\footnote&lbrace;%
+ I wouldn't know, I don't read footnotes.&rbrace;
</pre></example>
-<para>You can place multiple footnotes on a page. If the text becomes too long
-it will flow to the next page.
+<para>You can put multiple footnotes on a page. If the footnote text becomes
+too long then it will flow to the next page.
</para>
<para>You can also produce footnotes by combining the <code>\footnotemark</code> and
the <code>\footnotetext</code> commands, which is useful in special
circumstances.
</para>
<para>To make bibliographic references come out as footnotes you need to
-include a bibliographic style with that behavior.
+include a bibliographic style with that behavior (<pxref label="Using-BibTeX"><xrefnodename>Using BibTeX</xrefnodename></pxref>).
</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\footnote</menunode><menudescription><pre xml:space="preserve">Insert a footnote.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\footnotemark</menunode><menudescription><pre xml:space="preserve">Insert footnote mark only.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\footnotetext</menunode><menudescription><pre xml:space="preserve">Insert footnote text only.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Footnotes in a table</menunode><menudescription><pre xml:space="preserve">Table footnotes.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Footnotes in section headings</menunode><menudescription><pre xml:space="preserve">Chapter or section titles.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Footnotes in a table</menunode><menudescription><pre xml:space="preserve">Table footnotes.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Footnotes of footnotes</menunode><menudescription><pre xml:space="preserve">Multiple classes of footnotes.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Multiple reference to footnotes</menunode><menudescription><pre xml:space="preserve">Referring to a footnote more than once.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Footnote parameters</menunode><menudescription><pre xml:space="preserve">Parameters for footnote formatting.
</pre></menudescription></menuentry></menu>
<node name="_005cfootnote" spaces=" "><nodename>\footnote</nodename><nodenext automatic="on">\footnotemark</nodenext><nodeup automatic="on">Footnotes</nodeup></node>
<section spaces=" "><sectiontitle><code>\footnote</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="435">\footnote</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="447" mergedindex="cp">\footnote</indexterm></findex>
-<para>Synopsis:
+<para>Synopsis, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\footnote[<var>number</var>]&lbrace;<var>text</var>&rbrace;
+<pre xml:space="preserve">\footnote&lbrace;<var>text</var>&rbrace;
+\footnote[<var>number</var>]&lbrace;<var>text</var>&rbrace;
</pre></example>
-<para>Place a numbered footnote <var>text</var> at the bottom of the current page.
+<para>Place a footnote <var>text</var> at the bottom of the current page.
</para>
<example endspaces=" ">
<pre xml:space="preserve">There are over a thousand footnotes in Gibbon's
-\textit&lbrace;Decline and Fall of the Roman Empire&rbrace;.\footnote&lbrace;After
-reading an early version with endnotes David Hume complained,
-``One is also plagued with his Notes, according to the present Method
-of printing the Book'' and suggested that they ``only to be printed
-at the Margin or the Bottom of the Page.''&rbrace;
-</pre></example>
-
-<para>The optional argument <var>number</var> allows you to specify the footnote
-number. If you use this option then the footnote number counter is not
-incremented, and if you do not use it then the counter is incremented.
-</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="295">footnotes, symbols instead of numbers</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="436">\fnsymbol<r>, and footnotes</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="437">\&arobase;fnsymbol</indexterm></findex>
-<para>Change how &latex; shows the footnote counter with something like
+\textit&lbrace;Decline and Fall of the Roman Empire&rbrace;.\footnote&lbrace;%
+ After reading an early version with endnotes David Hume complained,
+ ``One is also plagued with his Notes, according to the present Method
+ of printing the Book'' and suggested that they ``only to be printed
+ at the Margin or the Bottom of the Page.''&rbrace;
+</pre></example>
+
+<para>The optional argument <var>number</var> allows you to specify the number of
+the footnote. If you use this then &latex; does not increment the
+<code>footnote</code> counter.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="388">footnotes, symbols instead of numbers</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="448" mergedindex="cp">\fnsymbol<r>, and footnotes</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="449" mergedindex="cp">\&arobase;fnsymbol</indexterm></findex>
+<para>By default, &latex; uses arabic numbers as footnote markers. Change
+this with something like
<code>\renewcommand&lbrace;\thefootnote&rbrace;&lbrace;\fnsymbol&lbrace;footnote&rbrace;&rbrace;</code>, which
uses a sequence of symbols (<pxref label="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol"><xrefnodename>\alph \Alph \arabic \roman \Roman
\fnsymbol</xrefnodename></pxref>). To make this change global put that in the preamble. If
you make the change local then you may want to reset the counter with
-<code>\setcounter&lbrace;footnote&rbrace;&lbrace;0&rbrace;</code>. By default &latex; uses arabic
-numbers.
+<code>\setcounter&lbrace;footnote&rbrace;&lbrace;0&rbrace;</code>.
+</para>
+<para>&latex; determines the spacing of footnotes with two parameters.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="389">footnote parameters</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="390">parameters, for footnotes</indexterm></cindex>
+
+<ftable commandarg="code" spaces=" " endspaces=" ">
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="450" mergedindex="cp">\footnoterule</indexterm>\footnoterule</itemformat></item>
+</tableterm><tableitem><anchor name="footnote-footnoterule">footnote footnoterule</anchor>
+<para>Produces the rule separating the main text on a page from the page&textrsquo;s
+footnotes. Default dimensions in the standard document classes (except
+<code>slides</code>, where it does not appear) is: vertical thickness of
+<code>0.4pt</code>, and horizontal size of <code>0.4\columnwidth</code> long.
+Change the rule with something like this.
+</para>
+<!-- c Credit egreg: https://tex.stackexchange.com/a/21917 -->
+<example endspaces=" ">
+<pre xml:space="preserve">\renewcommand&lbrace;\footnoterule&rbrace;&lbrace;% Kerns avoid vertical space
+ \kern -3pt % This -3 is negative
+ \hrule width \textwidth height 1pt % of the sum of this 1
+ \kern 2pt&rbrace; % and this 2
+</pre></example>
+
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="451" mergedindex="cp">\footnotesep</indexterm>\footnotesep</itemformat></item>
+</tableterm><tableitem><anchor name="footnote-footnotesep">footnote footnotesep</anchor>
+<para>The height of the strut placed at the beginning of the footnote
+(<pxref label="_005cstrut"><xrefnodename>\strut</xrefnodename></pxref>). By default, this is set to the normal strut for
+<code>\footnotesize</code> fonts (<pxref label="Font-sizes"><xrefnodename>Font sizes</xrefnodename></pxref>), therefore there is no
+extra space between footnotes. This is <samp>6.65pt</samp> for <samp>10pt</samp>,
+<samp>7.7pt</samp> for <samp>11pt</samp>, and <samp>8.4pt</samp> for <samp>12pt</samp>. Change
+it as with <code>\setlength&lbrace;\footnotesep&rbrace;&lbrace;11pt&rbrace;</code>.
+</para>
+</tableitem></tableentry></ftable>
+
+<para>The <code>\footnote</code> command is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
<para>&latex;&textrsquo;s default puts many restrictions on where you can use a
<code>\footnote</code>; for instance, you cannot use it in an argument to a
sectioning command such as <code>\chapter</code> (it can only be used in outer
-paragraph mode). There are some workarounds; see following sections.
-<!-- c xx mention packages that fix this -->
+paragraph mode; <pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>). There are some workarounds; see
+following sections.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="296">Footnotes, in a minipage</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="297">mpfootnote counter</indexterm></cindex>
-<para>In a <code>minipage</code> environment the <code>\footnote</code>
-command uses the <code>mpfootnote</code> counter instead of the
-<code>footnote</code> counter, so they are numbered independently. They are
-shown at the bottom of the environment, not at the bottom of the page.
-And by default they are shown alphabetically. <xref label="minipage"><xrefnodename>minipage</xrefnodename></xref>.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="391">Footnotes, in a minipage</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="392">mpfootnote counter</indexterm></cindex>
+<para>In a <code>minipage</code> environment the <code>\footnote</code> command uses the
+<code>mpfootnote</code> counter instead of the <code>footnote</code> counter, so
+they are numbered independently. They are shown at the bottom of the
+environment, not at the bottom of the page. And by default they are
+shown alphabetically. <xref label="minipage"><xrefnodename>minipage</xrefnodename></xref> and <ref label="Footnotes-in-a-table"><xrefnodename>Footnotes in a table</xrefnodename></ref>.
</para>
</section>
<node name="_005cfootnotemark" spaces=" "><nodename>\footnotemark</nodename><nodenext automatic="on">\footnotetext</nodenext><nodeprev automatic="on">\footnote</nodeprev><nodeup automatic="on">Footnotes</nodeup></node>
<section spaces=" "><sectiontitle><code>\footnotemark</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="438">\footnotemark</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="452" mergedindex="cp">\footnotemark</indexterm></findex>
<para>Synopsis, one of:
</para>
@@ -6435,14 +8548,27 @@ And by default they are shown alphabetically. <xref label="minipage"><xrefnodena
\footnotemark[<var>number</var>]
</pre></example>
-<para>Put the current footnote number in the
-text. (See&nbsp;<ref label="_005cfootnotetext"><xrefnodename>\footnotetext</xrefnodename></ref> for giving the text of the footnote
-separately.) The version with the optional argument <var>number</var> uses
-that number to determine the mark printed. This command can be used in
-inner paragraph mode.
+<para>Put the current footnote mark in the text. To specify associated text
+for the footnote see&nbsp;<ref label="_005cfootnotetext"><xrefnodename>\footnotetext</xrefnodename></ref>. The optional argument
+<var>number</var> causes the command to use that number to determine the
+footnote mark. This command can be used in inner paragraph mode
+(<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>).
+</para>
+<para>If you use <code>\footnotemark</code> without the optional argument then it
+increments the footnote counter but if you use the optional <var>number</var>
+then it does not. The next example produces several consecutive footnote
+markers referring to the same footnote.
</para>
-<para>This example gives the same institutional affiliation to both the first
-and third authors (<code>\thanks</code> is a version of <code>footnote</code>).
+<example endspaces=" ">
+<pre xml:space="preserve">The first theorem\footnote&lbrace;Due to Gauss.&rbrace;
+and the second theorem\footnotemark[\value&lbrace;footnote&rbrace;]
+and the third theorem.\footnotemark[\value&lbrace;footnote&rbrace;]
+</pre></example>
+
+<para>If there are intervening footnotes then you must remember the value of the
+common mark. This example gives the same institutional affiliation to
+both the first and third authors (<code>\thanks</code> is a version of
+<code>footnote</code>), by-hand giving the number of the footnote.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\title&lbrace;A Treatise on the Binomial Theorem&rbrace;
@@ -6453,23 +8579,48 @@ and third authors (<code>\thanks</code> is a version of <code>footnote</code>).
\maketitle
</pre></example>
-<para>If you use <code>\footnotemark</code> without the optional argument then it
-increments the footnote counter but if you use the optional <var>number</var>
-then it does not. This produces several consecutive footnote markers
-referring to the same footnote.
+<para>This uses a counter to remember the footnote number. The third sentence
+is followed by the same footnote marker as the first.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">The first theorem\footnote&lbrace;Due to Gauss.&rbrace;
-and the second theorem\footnotemark[\value&lbrace;footnote&rbrace;]
-and the third theorem.\footnotemark[\value&lbrace;footnote&rbrace;]
+<pre xml:space="preserve">\newcounter&lbrace;footnoteValueSaver&rbrace;
+All babies are illogical.\footnote&lbrace;%
+ Lewis Carroll.&rbrace;\setcounter&lbrace;footnoteValueSaver&rbrace;&lbrace;\value&lbrace;footnote&rbrace;&rbrace;
+Nobody is despised who can manage a crocodile.\footnote&lbrace;%
+ Captain Hook.&rbrace;
+Illogical persons are despised.\footnotemark[\value&lbrace;footnoteValueSaver&rbrace;]
+Therefore, anyone who can manage a crocodile is not a baby.
+</pre></example>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="393"><r>package</r>, <code>cleveref</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="394"><code>cleveref</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="395"><r>package</r>, <code>hyperref</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="396"><code>hyperref</code> <r>package</r></indexterm></cindex>
+
+<para>This example accomplishes the same by using the package <file>cleveref</file>.
+</para>
+<!-- c from SE user Jake http://tex.stackexchange.com/a/10116/339 -->
+<example endspaces=" ">
+<pre xml:space="preserve">\usepackage&lbrace;cleveref&rbrace;[2012/02/15] % in preamble
+\crefformat&lbrace;footnote&rbrace;&lbrace;#2\footnotemark[#1]#3&rbrace;
+...
+The theorem is from Evers.\footnote&lbrace;\label&lbrace;fn:TE&rbrace;Tinker, Evers, 1994.&rbrace;
+The corollary is from Chance.\footnote&lbrace;Evers, Chance, 1990.&rbrace;
+But the key lemma is from Tinker.\cref&lbrace;fn:TE&rbrace;
</pre></example>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="397"><r>package</r>, <code>hyperref</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="398"><code>hyperref</code> <r>package</r></indexterm></cindex>
+
+<para>It will work with the package <file>hyperref</file>.
+</para>
</section>
-<node name="_005cfootnotetext" spaces=" "><nodename>\footnotetext</nodename><nodenext automatic="on">Footnotes in a table</nodenext><nodeprev automatic="on">\footnotemark</nodeprev><nodeup automatic="on">Footnotes</nodeup></node>
+<node name="_005cfootnotetext" spaces=" "><nodename>\footnotetext</nodename><nodenext automatic="on">Footnotes in section headings</nodenext><nodeprev automatic="on">\footnotemark</nodeprev><nodeup automatic="on">Footnotes</nodeup></node>
<section spaces=" "><sectiontitle><code>\footnotetext</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="439">\footnotetext</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="453" mergedindex="cp">\footnotetext</indexterm></findex>
<para>Synopsis, one of:
</para>
@@ -6478,186 +8629,161 @@ and the third theorem.\footnotemark[\value&lbrace;footnote&rbrace;]
\footnotetext[<var>number</var>]&lbrace;<var>text</var>&rbrace;
</pre></example>
-<para>Place <var>text</var> at the bottom of the page as a footnote. This command
-can come anywhere after the <code>\footnotemark</code> command. The optional
-argument <var>number</var> changes the displayed footnote number. The
-<code>\footnotetext</code> command must appear in outer paragraph mode.
+<para>Place <var>text</var> at the bottom of the page as a footnote. It pairs with
+<code>\footnotemark</code> (<pxref label="_005cfootnotemark"><xrefnodename>\footnotemark</xrefnodename></pxref>) and can come anywhere after
+that command, but must appear in outer paragraph mode (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>).
+The optional argument <var>number</var> changes the number of the footnote
+mark.
+</para>
+<para><xref label="_005cfootnotemark"><xrefnodename>\footnotemark</xrefnodename></xref> and&nbsp;<ref label="Footnotes-in-a-table"><xrefnodename>Footnotes in a table</xrefnodename></ref> for usage
+examples.
</para>
</section>
-<node name="Footnotes-in-a-table" spaces=" "><nodename>Footnotes in a table</nodename><nodenext automatic="on">Footnotes in section headings</nodenext><nodeprev automatic="on">\footnotetext</nodeprev><nodeup automatic="on">Footnotes</nodeup></node>
+<node name="Footnotes-in-section-headings" spaces=" "><nodename>Footnotes in section headings</nodename><nodenext automatic="on">Footnotes in a table</nodenext><nodeprev automatic="on">\footnotetext</nodeprev><nodeup automatic="on">Footnotes</nodeup></node>
+<section spaces=" "><sectiontitle>Footnotes in section headings</sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="399">footnote, in section headings</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="400">table of contents, avoiding footnotes</indexterm></cindex>
+
+<para>Putting a footnote in a section heading, as in:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\section&lbrace;Full sets\protect\footnote&lbrace;This material due to ...&rbrace;&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>causes the footnote to appear at the bottom of the page where the
+section starts, as usual, but also at the bottom of the table of
+contents, where it is not likely to be desired. The simplest way
+to have it not appear on the table of contents is to use the optional
+argument to <code>\section</code>
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\section[Please]&lbrace;Please\footnote&lbrace;%
+ Don't footnote in chapter and section headers!&rbrace;&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>No <code>\protect</code> is needed in front of <code>\footnote</code> here because
+what gets moved to the table of contents is the optional argument.
+</para>
+
+</section>
+<node name="Footnotes-in-a-table" spaces=" "><nodename>Footnotes in a table</nodename><nodenext automatic="on">Footnotes of footnotes</nodenext><nodeprev automatic="on">Footnotes in section headings</nodeprev><nodeup automatic="on">Footnotes</nodeup></node>
<section spaces=" "><sectiontitle>Footnotes in a table</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="298">Footnotes, in a table</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="401">footnote, in a table</indexterm></cindex>
-<para>Inside a <code>table</code> environment the <code>\footnote</code> command does not
-work. For instance, if the code below appears on its own then the
-footnote simply disappears; there is a footnote mark in the table cell
-but nothing is set at the bottom of the page.
+<para>Inside a <code>tabular</code> or <code>array</code> environment the <code>\footnote</code>
+command does not work; there is a footnote mark in the table cell but
+the footnote text does not appear. The solution is to use a
+<code>minipage</code> environment as here (<pxref label="minipage"><xrefnodename>minipage</xrefnodename></pxref>).
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;center&rbrace;
+ \begin&lbrace;minipage&rbrace;&lbrace;\textwidth&rbrace; \centering
\begin&lbrace;tabular&rbrace;&lbrace;l|l&rbrace;
- \textsc&lbrace;Ship&rbrace; &amp;\textsc&lbrace;Book&rbrace; \\ \hline
- \textit&lbrace;HMS Sophie&rbrace; &amp;Master and Commander \\
- \textit&lbrace;HMS Polychrest&rbrace; &amp;Post Captain \\
- \textit&lbrace;HMS Lively&rbrace; &amp;Post Captain \\
- \textit&lbrace;HMS Surprise&rbrace; &amp;A number of books\footnote&lbrace;Starting with
- HMS Surprise.&rbrace;
+ \textsc&lbrace;Ship&rbrace; &amp;\textsc&lbrace;Book&rbrace; \\ \hline
+ \textit&lbrace;HMS Sophie&rbrace; &amp;Master and Commander \\
+ \textit&lbrace;HMS Polychrest&rbrace; &amp;Post Captain \\
+ \textit&lbrace;HMS Lively&rbrace; &amp;Post Captain \\
+ \textit&lbrace;HMS Surprise&rbrace; &amp;A number of books\footnote&lbrace;%
+ Starting with HMS Surprise.&rbrace;
\end&lbrace;tabular&rbrace;
+ \end&lbrace;minipage&rbrace;
\end&lbrace;center&rbrace;
</pre></example>
-<para>The solution is to surround the <code>tabular</code> environment with a
-<code>minipage</code> environment, as here (<pxref label="minipage"><xrefnodename>minipage</xrefnodename></pxref>).
+<para>Inside a <code>minipage</code>, footnote marks are lowercase letters. Change
+that with something like
+<code>\renewcommand&lbrace;\thempfootnote&rbrace;&lbrace;\arabic&lbrace;mpfootnote&rbrace;&rbrace;</code>
+(<pxref label="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol"><xrefnodename>\alph \Alph \arabic \roman \Roman \fnsymbol</xrefnodename></pxref>).
+</para>
+<para>The footnotes in the prior example appear at the bottom of the
+<code>minipage</code>. To have them appear at the bottom of the main page, as
+part of the regular footnote sequence, use the <code>\footnotemark</code> and
+<code>\footnotetext</code> pair and make a new counter.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\begin&lbrace;center&rbrace;
- \begin&lbrace;minipage&rbrace;&lbrace;.5\textwidth&rbrace;
- ... tabular material ...
- \end&lbrace;minipage&rbrace;
+<pre xml:space="preserve">\newcounter&lbrace;mpFootnoteValueSaver&rbrace;
+\begin&lbrace;center&rbrace;
+ \begin&lbrace;minipage&rbrace;&lbrace;\textwidth&rbrace;
+ \setcounter&lbrace;mpFootnoteValueSaver&rbrace;&lbrace;\value&lbrace;footnote&rbrace;&rbrace; \centering
+ \begin&lbrace;tabular&rbrace;&lbrace;l|l&rbrace;
+ \textsc&lbrace;Woman&rbrace; &amp;\textsc&lbrace;Relationship&rbrace; \\ \hline
+ Mona &amp;Attached\footnotemark \\
+ Diana Villiers &amp;Eventual wife \\
+ Christine Hatherleigh Wood &amp;Fiance\footnotemark
+ \end&lbrace;tabular&rbrace;
+ \end&lbrace;minipage&rbrace;% percent sign keeps footnote text close to minipage
+ \stepcounter&lbrace;mpFootnoteValueSaver&rbrace;%
+ \footnotetext[\value&lbrace;mpFootnoteValueSaver&rbrace;]&lbrace;%
+ Little is known other than her death.&rbrace;%
+ \stepcounter&lbrace;mpFootnoteValueSaver&rbrace;%
+ \footnotetext[\value&lbrace;mpFootnoteValueSaver&rbrace;]&lbrace;%
+ Relationship is unresolved in XXI.&rbrace;
\end&lbrace;center&rbrace;
</pre></example>
-<para>The same technique will work inside a floating <code>table</code> environment
-(<pxref label="table"><xrefnodename>table</xrefnodename></pxref>). To get the footnote at the bottom of the page use the
-<file>tablefootnote</file> package, as illustrated in this example. If you
-put <code>\usepackage&lbrace;tablefootnote&rbrace;</code> in the preamble and use the code
-shown then the footnote appears at the bottom and is numbered in
-sequence with other footnotes.
+<para>For a floating <code>table</code> environment (<pxref label="table"><xrefnodename>table</xrefnodename></pxref>), use the
+<file>tablefootnote</file> package.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\begin&lbrace;table&rbrace;
+<pre xml:space="preserve">\usepackage&lbrace;tablefootnote&rbrace; % in preamble
+ ...
+\begin&lbrace;table&rbrace;
\centering
\begin&lbrace;tabular&rbrace;&lbrace;l|l&rbrace;
\textsc&lbrace;Date&rbrace; &amp;\textsc&lbrace;Campaign&rbrace; \\ \hline
1862 &amp;Fort Donelson \\
1863 &amp;Vicksburg \\
- 1865 &amp;Army of Northern Virginia\footnote&lbrace;Ending the war.&rbrace;
+ 1865 &amp;Army of Northern Virginia\tablefootnote&lbrace;%
+ Ending the war.&rbrace;
\end&lbrace;tabular&rbrace;
\caption&lbrace;Forces captured by US Grant&rbrace;
\end&lbrace;table&rbrace;
</pre></example>
-
-</section>
-<node name="Footnotes-in-section-headings" spaces=" "><nodename>Footnotes in section headings</nodename><nodenext automatic="on">Footnotes of footnotes</nodenext><nodeprev automatic="on">Footnotes in a table</nodeprev><nodeup automatic="on">Footnotes</nodeup></node>
-<section spaces=" "><sectiontitle>Footnotes in section headings</sectiontitle>
-
-<cindex index="cp" spaces=" "><indexterm index="cp" number="299">footnotes, in section headings</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="300">table of contents, avoiding footnotes</indexterm></cindex>
-<para>Putting a footnote in a section heading, as in:
-</para>
-<example endspaces=" ">
-<pre xml:space="preserve">\section&lbrace;Full sets\protect\footnote&lbrace;This material due to ...&rbrace;&rbrace;
-</pre></example>
-
-<cindex index="cp" spaces=" "><indexterm index="cp" number="301"><r>package</r>, <code>footmisc</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="302"><code>footmisc</code> <r>package</r></indexterm></cindex>
-
-<cindex index="cp" spaces=" "><indexterm index="cp" number="303"><code>stable</code> option to <code>footmisc</code> package</indexterm></cindex>
<noindent></noindent>
-<para>causes the footnote to appear at the bottom of the page where the
-section starts, as usual, but also at the bottom of the table of
-contents, where it is not likely to be desired. To have it not appear
-on the table of contents use the package <file>footmisc</file> with the
-<code>stable</code> option.
-</para>
-<example endspaces=" ">
-<pre xml:space="preserve">\usepackage[stable]&lbrace;footmisc&rbrace;
-...
-\begin&lbrace;document&rbrace;
-...
-\section&lbrace;Full sets\footnote&lbrace;This material due to ...&rbrace;&rbrace;
-</pre></example>
-
-<para>Note that the <code>\protect</code> is gone; including it would cause the
-footnote to reappear on the table of contents.
+<para>The footnote appears at the page bottom and is numbered in sequence with
+other footnotes.
</para>
</section>
-<node name="Footnotes-of-footnotes" spaces=" "><nodename>Footnotes of footnotes</nodename><nodenext automatic="on">Multiple reference to footnotes</nodenext><nodeprev automatic="on">Footnotes in section headings</nodeprev><nodeup automatic="on">Footnotes</nodeup></node>
+<node name="Footnotes-of-footnotes" spaces=" "><nodename>Footnotes of footnotes</nodename><nodeprev automatic="on">Footnotes in a table</nodeprev><nodeup automatic="on">Footnotes</nodeup></node>
<section spaces=" "><sectiontitle>Footnotes of footnotes</sectiontitle>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="402">footnote, of a footnote</indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="403"><r>package</r>, <code>bigfoot</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="404"><code>bigfoot</code> <r>package</r></indexterm></cindex>
+
<para>Particularly in the humanities, authors can have multiple classes of
footnotes, including having footnotes of footnotes. The package
<file>bigfoot</file> extends &latex;&textrsquo;s default footnote mechanism in many
ways, including allow these two, as in this example.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\usepackage&lbrace;bigfoot&rbrace;
+<pre xml:space="preserve">\usepackage&lbrace;bigfoot&rbrace; % in preamble
\DeclareNewFootnote&lbrace;Default&rbrace;
\DeclareNewFootnote&lbrace;from&rbrace;[alph] % create class \footnotefrom&lbrace;&rbrace;
...
-\begin&lbrace;document&rbrace;
-...
The third theorem is a partial converse of the
-second.\footnotefrom&lbrace;First noted in Wilson.\footnote&lbrace;Second edition only.&rbrace;&rbrace;
-...
-</pre></example>
-
-
-</section>
-<node name="Multiple-reference-to-footnotes" spaces=" "><nodename>Multiple reference to footnotes</nodename><nodenext automatic="on">Footnote parameters</nodenext><nodeprev automatic="on">Footnotes of footnotes</nodeprev><nodeup automatic="on">Footnotes</nodeup></node>
-<section spaces=" "><sectiontitle>Multiple references to footnotes</sectiontitle>
-
-<para>You can refer to a single footnote more than once. This example
-uses the package <file>cleverref</file>.
-</para>
-<!-- c from SE user Jake http://tex.stackexchange.com/a/10116/339 -->
-<example endspaces=" ">
-<pre xml:space="preserve">\usepackage&lbrace;cleveref&rbrace;[2012/02/15] % this version of package or later
-\crefformat&lbrace;footnote&rbrace;&lbrace;#2\footnotemark[#1]#3&rbrace;
-...
-\begin&lbrace;document&rbrace;
-...
-The theorem is from Evers.\footnote&lbrace;\label&lbrace;fn:TE&rbrace;Tinker and Evers, 1994.&rbrace;
-The corollary is from Chance.\footnote&lbrace;Evers and Chance, 1990.&rbrace;
-But the key lemma is from Tinker.\cref&lbrace;fn:TE&rbrace;
-...
+second.\footnotefrom&lbrace;%
+ First noted in Wilson.\footnote&lbrace;Second edition only.&rbrace;&rbrace;
</pre></example>
-<para>This solution will work with the package <file>hyperref</file>.
-See&nbsp;<ref label="_005cfootnotemark"><xrefnodename>\footnotemark</xrefnodename></ref> for a simpler solution in the common case
-of multiple authors with the same affiliation.
-</para>
-
-</section>
-<node name="Footnote-parameters" spaces=" "><nodename>Footnote parameters</nodename><nodeprev automatic="on">Multiple reference to footnotes</nodeprev><nodeup automatic="on">Footnotes</nodeup></node>
-<section spaces=" "><sectiontitle>Footnote parameters</sectiontitle>
-
-<cindex index="cp" spaces=" "><indexterm index="cp" number="304">footnote parameters</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="305">parameters, for footnotes</indexterm></cindex>
-
-<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="440">\footnoterule</indexterm>\footnoterule</itemformat></item>
-</tableterm><tableitem><para>Produces the rule separating the main text on a page from the page&textrsquo;s
-footnotes. Default dimensions: <code>0.4pt</code> thick (or wide), and
-<code>0.4\columnwidth</code> long in the standard document classes (except
-<code>slides</code>, where it does not appear).
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="441">\footnotesep</indexterm>\footnotesep</itemformat></item>
-</tableterm><tableitem><para>The height of the strut placed at the beginning of the footnote. By
-default, this is set to the normal strut for <code>\footnotesize</code>
-fonts (<pxref label="Font-sizes"><xrefnodename>Font sizes</xrefnodename></pxref>), therefore there is no extra space between
-footnotes. This is <samp>6.65pt</samp> for <samp>10pt</samp>, <samp>7.7pt</samp> for
-<samp>11pt</samp>, and <samp>8.4pt</samp> for <samp>12pt</samp>.
-</para>
-</tableitem></tableentry></ftable>
-
</section>
</chapter>
<node name="Definitions" spaces=" "><nodename>Definitions</nodename><nodenext automatic="on">Counters</nodenext><nodeprev automatic="on">Footnotes</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Definitions</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="306">definitions</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="405">definitions</indexterm></cindex>
<para>&latex; has support for making new commands of many different kinds.
</para>
-<!-- c xx everything in this chapter needs examples. -->
-<!-- c xx Add DeclareRobustCommand (see clsguide.pdf) -->
-
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\newcommand &amp; \renewcommand</menunode><menudescription><pre xml:space="preserve">(Re)define a new command.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\providecommand</menunode><menudescription><pre xml:space="preserve">Define a new command, if name not used.
@@ -6675,149 +8801,209 @@ footnotes. This is <samp>6.65pt</samp> for <samp>10pt</samp>, <samp>7.7pt</samp
<node name="_005cnewcommand-_0026-_005crenewcommand" spaces=" "><nodename>\newcommand &amp; \renewcommand</nodename><nodenext automatic="on">\providecommand</nodenext><nodeup automatic="on">Definitions</nodeup></node>
<section spaces=" "><sectiontitle><code>\newcommand</code> &amp; <code>\renewcommand</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="442">\newcommand</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="307">commands, defining new ones</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="308">commands, redefining</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="309">defining a new command</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="310">new commands, defining</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="454" mergedindex="cp">\newcommand</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="406">commands, defining new ones</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="407">commands, redefining</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="408">defining a new command</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="409">new commands, defining</indexterm></cindex>
+
+<para>Synopses, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand&lbrace;\<var>cmd</var>&rbrace;&lbrace;<var>defn</var>&rbrace;
+\newcommand&lbrace;\<var>cmd</var>&rbrace;[<var>nargs</var>]&lbrace;<var>defn</var>&rbrace;
+\newcommand&lbrace;\<var>cmd</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>defn</var>&rbrace;
+\newcommand*&lbrace;\<var>cmd</var>&rbrace;&lbrace;<var>defn</var>&rbrace;
+\newcommand*&lbrace;\<var>cmd</var>&rbrace;[<var>nargs</var>]&lbrace;<var>defn</var>&rbrace;
+\newcommand*&lbrace;\<var>cmd</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>defn</var>&rbrace;
+</pre></example>
-<para><code>\newcommand</code> and <code>\renewcommand</code> define and redefine a
-command, respectively. Synopses:
+<noindent></noindent>
+<para>or one of these.
</para>
<example endspaces=" ">
-<pre xml:space="preserve"> \newcommand&lbrace;\<var>cmd</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>defn</var>&rbrace;
- \newcommand*&lbrace;\<var>cmd</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>defn</var>&rbrace;
+<pre xml:space="preserve">\renewcommand&lbrace;\<var>cmd</var>&rbrace;[<var>nargs</var>]&lbrace;<var>defn</var>&rbrace;
+\renewcommand&lbrace;\<var>cmd</var>&rbrace;[<var>nargs</var>]&lbrace;<var>defn</var>&rbrace;
\renewcommand&lbrace;\<var>cmd</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>defn</var>&rbrace;
+\renewcommand*&lbrace;\<var>cmd</var>&rbrace;&lbrace;<var>defn</var>&rbrace;
+\renewcommand*&lbrace;\<var>cmd</var>&rbrace;[<var>nargs</var>]&lbrace;<var>defn</var>&rbrace;
\renewcommand*&lbrace;\<var>cmd</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>defn</var>&rbrace;
</pre></example>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="311">starred form, defining new commands</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="312">*-form, defining new commands</indexterm></cindex>
-<para>The starred form of these two commands requires that the arguments not
-contain multiple paragraphs of text (not <code>\long</code>, in plain &tex;
-terms).
+<para>Define or redefine a command. See also the discussion of
+<code>\DeclareRobustCommand</code> in <ref label="Class-and-package-commands"><xrefnodename>Class and package commands</xrefnodename></ref>.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="410">starred form, defining new commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="411">*-form, defining new commands</indexterm></cindex>
+The starred form of these two requires that the arguments not contain
+multiple paragraphs of text (in plain &tex; terms that it not be
+<code>\long</code>).
+</para>
+<para>These are the parameters:
</para>
<table commandarg="var" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="var">cmd</itemformat></item>
-</tableterm><tableitem><para>Required; <code>\<var>cmd</var></code> is the command name. For <code>\newcommand</code>, it
-must not be already defined and must not begin with <code>\end</code>. For
-<code>\renewcommand</code>, it must already be defined.
+</tableterm><tableitem>
+<para>Required; the command name. It must begin with a backslash, <code>\</code>,
+and must not begin with the four letter string <code>\end</code>. For
+<code>\newcommand</code>, it must not be already defined. For
+<code>\renewcommand</code>, this name must already be defined.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">nargs</itemformat></item>
</tableterm><tableitem><para>Optional; an integer from 0 to 9, specifying the number of arguments
-that the command can take, including any optional argument. If this
-argument is not present, the default is for the command to have no
-arguments. When redefining a command, the new version can have a
+that the command takes, including any optional argument. Omitting this
+argument is the same as specifying 0, meaning that the command has no
+arguments. If you redefine a command, the new version can have a
different number of arguments than the old version.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">optargdefault</itemformat></item>
-</tableterm><tableitem><para>Optional; if this argument is present then the first argument of defined
-command <code>\<var>cmd</var></code> is optional, with default value <var>optargdefault</var>
+</tableterm><tableitem><para>Optional; if this argument is present then the first argument of
+<code>\<var>cmd</var></code> is optional, with default value <var>optargdefault</var>
(which may be the empty string). If this argument is not present then
<code>\<var>cmd</var></code> does not take an optional argument.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="313">positional parameter</indexterm></cindex>
-<para>That is, if <code>\<var>cmd</var></code> is used with square brackets following,
-as in <code>\<var>cmd</var>[<var>myval</var>]</code>, then within <var>defn</var> the first
-<dfn>positional parameter</dfn> <code>#1</code> expands <var>myval</var>. On the
-other hand, if <code>\<var>cmd</var></code> is called without square brackets
-following, then within <var>defn</var> the positional parameter <code>#1</code>
-expands to the default <var>optargdefault</var>. In either case, any
-required arguments will be referred to starting with <code>#2</code>.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="412">positional parameter</indexterm></cindex>
+<para>That is, if <code>\<var>cmd</var></code> is used with square brackets, as in
+<code>\<var>cmd</var>[<var>optval</var>]&lbrace;...&rbrace;...</code>, then within <var>defn</var> the
+parameter&nbsp;<code>#1</code> is set to the value of <var>optval</var>. On the
+other hand, if <code>\<var>cmd</var></code> is called without the square brackets
+then within <var>defn</var> the parameter <code>#1</code> is set to the value of
+<var>optargdefault</var>. In either case, the required arguments start with
+<code>#2</code>.
</para>
-<para>Omitting <code>[<var>myval</var>]</code> in a call is different from having the
-square brackets with no contents, as in <code>[]</code>. The former results
-in <code>#1</code> expanding to <var>optargdefault</var>; the latter results in
-<code>#1</code> expanding to the empty string.
+<para>Omitting <code>[<var>optargdefault</var>]</code> is different from having the
+square brackets with no contents, as in <code>[]</code>. The former sets
+<code>#1</code> to the value of <var>optargdefault</var>; the latter sets <code>#1</code>
+to the empty string.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">defn</itemformat></item>
-</tableterm><tableitem><para>The text to be substituted for every occurrence of <code>\<var>cmd</var></code>; the
-positional parameter <code>#<var>n</var></code> in <var>defn</var> is replaced by
-the text of the <var>n</var>th argument.
+</tableterm><tableitem><para>Required; the text to be substituted for every occurrence of
+<code>\<var>cmd</var></code>. The parameters <code>#1</code>, <code>#2</code>,
+... <code>#<var>nargs</var></code> are replaced by the values that you supply when
+you call the command (or by the default value if there is an optional
+argument and you don&textrsquo;t exercise the option).
</para>
</tableitem></tableentry></table>
<para>&tex; ignores spaces in the source following an alphabetic control
sequence, as in <samp>\cmd </samp>. If you actually want a space there, one
-solution is to type <code>&lbrace;&rbrace;</code> after the command (<samp>\cmd&lbrace;&rbrace; </samp>;
+solution is to type <code>&lbrace;&rbrace;</code> after the command (<samp>\cmd&lbrace;&rbrace; </samp>, and
another solution is to use an explicit control space (<samp>\cmd\ </samp>).
</para>
<para>A simple example of defining a new command:
-<code>\newcommand&lbrace;\RS&rbrace;&lbrace;Robin Smith&rbrace;</code> results in
-<code>\RS</code> being replaced by the longer text.
-</para>
-<para>Redefining an existing command is similar:
+<code>\newcommand&lbrace;\RS&rbrace;&lbrace;Robin Smith&rbrace;</code> results in <code>\RS</code> being
+replaced by the longer text. Redefining an existing command is similar:
<code>\renewcommand&lbrace;\qedsymbol&rbrace;&lbrace;&lbrace;\small QED&rbrace;&rbrace;</code>.
</para>
-<para>Here&textrsquo;s a command definition with one required argument:
+<para>If you try to define a command and the name has already been used then
+you get something like <samp>LaTeX Error: Command \fred already
+defined. Or name \end... illegal, see p.192 of the manual</samp>. If you try
+to redefine a command and the name has not yet been used then you get
+something like <samp>LaTeX Error: \hank undefined</samp>.
+</para>
+<para>Here the first command definition has no arguments, and the second has
+one required argument.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\newcommand&lbrace;\defref&rbrace;[1]&lbrace;Definition~\ref&lbrace;#1&rbrace;&rbrace;
+<pre xml:space="preserve">\newcommand&lbrace;\student&rbrace;&lbrace;Ms~O'Leary&rbrace;
+\newcommand&lbrace;\defref&rbrace;[1]&lbrace;Definition~\ref&lbrace;#1&rbrace;&rbrace;
</pre></example>
-<noindent></noindent> <para>Then, <code>\defref&lbrace;def:basis&rbrace;</code> expands to
-<code>Definition~\ref&lbrace;def:basis&rbrace;</code>, which will ultimately expand to
+<noindent></noindent>
+<para>Use the first as in <code>I highly recommend \student&lbrace;&rbrace; to you</code>. The
+second has a variable, so that <code>\defref&lbrace;def:basis&rbrace;</code> expands to
+<code>Definition~\ref&lbrace;def:basis&rbrace;</code>, which ultimately expands to
something like <samp>Definition~3.14</samp>.
</para>
-<para>An example with two required arguments:
+<para>Similarly, but with two required arguments:
<code>\newcommand&lbrace;\nbym&rbrace;[2]&lbrace;$#1 \times #2$&rbrace;</code> is invoked as
<code>\nbym&lbrace;2&rbrace;&lbrace;k&rbrace;</code>.
</para>
-<para>An example with an optional argument:
+<para>This example has an optional argument.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newcommand&lbrace;\salutation&rbrace;[1][Sir or Madam]&lbrace;Dear #1:&rbrace;
</pre></example>
-<noindent></noindent> <para>Then, <code>\salutation</code> gives <samp>Dear Sir or Madam:</samp> while
+<noindent></noindent>
+<para>Then <code>\salutation</code> gives <samp>Dear Sir or Madam:</samp> while
<code>\salutation[John]</code> gives <samp>Dear John:</samp>. And
<code>\salutation[]</code> gives <samp>Dear :</samp>.
</para>
-<para>The braces around <var>defn</var> do not define a group, that is, they do
-not delimit the scope of the result of expanding <var>defn</var>. So
-<code>\newcommand&lbrace;\shipname&rbrace;[1]&lbrace;\it #1&rbrace;</code> is problematic; in this
-sentence,
+<para>This example has an optional argument and two required arguments.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand&lbrace;\lawyers&rbrace;[3][company]&lbrace;#2, #3, and~#1&rbrace;
+I employ \lawyers[Howe]&lbrace;Dewey&rbrace;&lbrace;Cheatem&rbrace;.
+</pre></example>
+
+<noindent></noindent>
+<para>The output is <samp>I employ Dewey, Cheatem, and Howe</samp>. The optional
+argument, the <code>Howe</code>, is associated with <code>#1</code>, while
+<code>Dewey</code> and <code>Cheatem</code> are associated with <code>#2</code>
+and&nbsp;<code>#3</code>. Because of the optional argument,
+<code>\lawyers&lbrace;Dewey&rbrace;&lbrace;Cheatem&rbrace;</code> will give the output <samp>I employ
+Dewey, Cheatem, and company</samp>.
+</para>
+<para>The braces around <var>defn</var> do not define a group, that is, they do not
+delimit the scope of the result of expanding <var>defn</var>. For example,
+with <code>\newcommand&lbrace;\shipname&rbrace;[1]&lbrace;\it #1&rbrace;</code>, in this sentence,
</para>
<example endspaces=" ">
<pre xml:space="preserve">The \shipname&lbrace;Monitor&rbrace; met the \shipname&lbrace;Merrimac&rbrace;.
</pre></example>
-<noindent></noindent> <para>the words <samp>met the</samp> would incorrectly be in italics. Another
-pair of braces in the definition is needed, like this:
-<code>\newcommand&lbrace;\shipname&rbrace;[1]&lbrace;&lbrace;\it #1&rbrace;&rbrace;</code>. Those braces are
-part of the definition and thus do define a group.
+<noindent></noindent>
+<para>the words <samp>met the</samp> would incorrectly be in italics. The solution
+is to put another pair of braces inside the definition:
+<code>\newcommand&lbrace;\shipname&rbrace;[1]&lbrace;&lbrace;\it #1&rbrace;&rbrace;</code>.
</para>
</section>
<node name="_005cprovidecommand" spaces=" "><nodename trailingspaces=" ">\providecommand</nodename><nodenext automatic="on">\newcounter</nodenext><nodeprev automatic="on">\newcommand &amp; \renewcommand</nodeprev><nodeup automatic="on">Definitions</nodeup></node>
<section spaces=" "><sectiontitle><code>\providecommand</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="443">\providecommand</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="314">commands, defining new ones</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="315">defining a new command</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="316">new commands, defining</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="455" mergedindex="cp">\providecommand</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="413">commands, defining new ones</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="414">defining a new command</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="415">new commands, defining</indexterm></cindex>
-<para>Defines a command, as long as no command of this name already exists.
-Synopses:
+<para>Synopses, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\providecommand&lbrace;<var>cmd</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>defn</var>&rbrace;
+<pre xml:space="preserve">\providecommand&lbrace;<var>cmd</var>&rbrace;&lbrace;<var>defn</var>&rbrace;
+\providecommand&lbrace;<var>cmd</var>&rbrace;[<var>nargs</var>]&lbrace;<var>defn</var>&rbrace;
+\providecommand&lbrace;<var>cmd</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>defn</var>&rbrace;
+\providecommand*&lbrace;<var>cmd</var>&rbrace;&lbrace;<var>defn</var>&rbrace;
+\providecommand*&lbrace;<var>cmd</var>&rbrace;[<var>nargs</var>]&lbrace;<var>defn</var>&rbrace;
\providecommand*&lbrace;<var>cmd</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>defn</var>&rbrace;
</pre></example>
-<para>If no command of this name already exists then this has the same effect
-as <code>\newcommand</code> (<pxref label="_005cnewcommand-_0026-_005crenewcommand"><xrefnodename>\newcommand &amp; \renewcommand</xrefnodename></pxref>). If a
-command of this name already exists then this definition does nothing.
-This is particularly useful in a style file, or other file that may be
-loaded more than once.
+<para>Defines a command, as long as no command of this name already exists.
+If no command of this name already exists then this has the same effect
+as <code>\newcommand</code>. If a command of this name already exists then
+this definition does nothing. This is particularly useful in a file
+that may be loaded more than once, such as a style file.
+<xref label="_005cnewcommand-_0026-_005crenewcommand"><xrefnodename>\newcommand &amp; \renewcommand</xrefnodename></xref> for the description of the arguments.
+</para>
+<para>This example
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\providecommand&lbrace;\myaffiliation&rbrace;&lbrace;Saint Michael's College&rbrace;
+\providecommand&lbrace;\myaffiliation&rbrace;&lbrace;Saint Michael's College&rbrace;
+From \myaffiliation.
+</pre></example>
+
+<noindent></noindent>
+<para>outputs <samp>From Saint Michael's College</samp>. Unlike <code>\newcommand</code>,
+the repeated use of <code>\providecommand</code> does not give an error.
</para>
</section>
<node name="_005cnewcounter" spaces=" "><nodename>\newcounter</nodename><nodenext automatic="on">\newlength</nodenext><nodeprev automatic="on">\providecommand</nodeprev><nodeup automatic="on">Definitions</nodeup></node>
<section spaces=" "><sectiontitle><code>\newcounter</code>: Allocating a counter</sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="444">\newcounter</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="317">counters, defining new</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="456" mergedindex="cp">\newcounter</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="416">counters, defining new</indexterm></cindex>
<para>Synopsis, one of:
</para>
@@ -6826,103 +9012,163 @@ loaded more than once.
\newcounter&lbrace;<var>countername</var>&rbrace;[<var>supercounter</var>]
</pre></example>
-<para>Globally defines a new counter named <var>countername</var> and initialize
-the new counter to zero.
+<para>Globally defines a new counter named <var>countername</var> and initialize it
+to zero (<pxref label="Counters"><xrefnodename>Counters</xrefnodename></pxref>).
</para>
-<para>The name <var>countername</var> must consists of letters only, and does not
+<para>The name <var>countername</var> must consist of letters only. It does not
begin with a backslash. This name must not already be in use by another
counter.
</para>
-<para>When you use the optional argument <code>[<var>supercounter</var>]</code> then
-<var>countername</var> will be numbered within, or subsidiary to, the
-existing counter <var>supercounter</var>. For example, ordinarily
-<code>subsection</code> is numbered within <code>section</code> so that any time
-<var>supercounter</var> is incremented with <code>\stepcounter</code>
+<para>When you use the optional argument <code>[<var>supercounter</var>]</code> then the
+counter <var>countername</var> will be reset to zero whenever
+<var>supercounter</var> is incremented. For example, ordinarily
+<code>subsection</code> is numbered within <code>section</code> so that any time you
+increment <var>section</var>, either with <code>\stepcounter</code>
(<pxref label="_005cstepcounter"><xrefnodename>\stepcounter</xrefnodename></pxref>) or <code>\refstepcounter</code>
-(<pxref label="_005crefstepcounter"><xrefnodename>\refstepcounter</xrefnodename></pxref>) then <var>countername</var> is reset to zero.
+(<pxref label="_005crefstepcounter"><xrefnodename>\refstepcounter</xrefnodename></pxref>), then &latex; will reset <var>subsection</var> to
+zero.
+</para>
+<para>This example
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newcounter&lbrace;asuper&rbrace; \setcounter&lbrace;asuper&rbrace;&lbrace;1&rbrace;
+\newcounter&lbrace;asub&rbrace;[asuper] \setcounter&lbrace;asub&rbrace;&lbrace;3&rbrace; % Note `asuper'
+The value of asuper is \arabic&lbrace;asuper&rbrace; and of asub is \arabic&lbrace;asub&rbrace;.
+\stepcounter&lbrace;asuper&rbrace;
+Now asuper is \arabic&lbrace;asuper&rbrace; while asub is \arabic&lbrace;asub&rbrace;.
+</pre></example>
+
+<para>produces <samp>The value of asuper is 1 and that of asub is 3</samp> and
+<samp>Now asuper is 2 while asub is 0</samp>.
</para>
-<para><xref label="Counters"><xrefnodename>Counters</xrefnodename></xref>, for more information about counters.
+<para>If the counter already exists, for instance by entering <code>asuper</code>
+twice, then you get something like <samp>LaTeX Error: Command \c&arobase;asuper
+already defined. Or name \end... illegal, see p.192 of the manual.</samp>.
+</para>
+<para>If you use the optional argument then the super counter must already
+exist. Entering <code>\newcounter&lbrace;jh&rbrace;[lh]</code> when <code>lh</code> is not a
+defined counter will get you <samp>LaTeX Error: No counter 'lh'
+defined.</samp>
</para>
</section>
<node name="_005cnewlength" spaces=" "><nodename>\newlength</nodename><nodenext automatic="on">\newsavebox</nodenext><nodeprev automatic="on">\newcounter</nodeprev><nodeup automatic="on">Definitions</nodeup></node>
-<section spaces=" "><sectiontitle><code>\newlength</code>: Allocating a length</sectiontitle>
+<section spaces=" "><sectiontitle><code>\newlength</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="445">\newlength</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="318">lengths, allocating new</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="319">rubber lengths, defining new</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="320">skip register, plain &tex;</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="321">glue register, plain &tex;</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="457" mergedindex="cp">\newlength</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="417">lengths, allocating new</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="418">rubber lengths, defining new</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="419">skip register, plain &tex;</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="420">glue register, plain &tex;</indexterm></cindex>
-<para>Allocate a new <dfn>length</dfn> register. Synopsis:
+<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\newlength&lbrace;\<var>arg</var>&rbrace;
+<pre xml:space="preserve">\newlength&lbrace;<var>arg</var>&rbrace;
</pre></example>
-<para>This command takes one required argument, which must begin with a
-backslash (<samp>\</samp>). It creates a new length register named
-<code>\<var>arg</var></code>, which is a place to hold (rubber) lengths such as
-<code>1in plus.2in minus.1in</code> (what plain &tex; calls a <code>skip</code>
-register). The register gets an initial value of zero. The control
-sequence <code>\<var>arg</var></code> must not already be defined.
+<para>Allocate a new length register (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). The required argument
+<var>arg</var> must begin with a backslash, <code>\</code>. The new register holds
+rubber lengths such as <code>72.27pt</code> or <code>1in plus.2in minus.1in</code>
+(a &latex; length register is what plain &tex; calls a <code>skip</code>
+register). The initial value is zero. The control sequence
+<code>\<var>arg</var></code> must not be already defined.
</para>
-<para><xref label="Lengths"><xrefnodename>Lengths</xrefnodename></xref>, for more about lengths.
+<para>An example:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newlength&lbrace;\graphichgt&rbrace;
+</pre></example>
+
+<para>If you forget the backslash then you get <samp>Missing control sequence
+inserted</samp>. If the command sequence already exists then you get
+something like <samp>LaTeX Error: Command \graphichgt already defined.
+Or name \end... illegal, see p.192 of the manual</samp>.
</para>
</section>
<node name="_005cnewsavebox" spaces=" "><nodename>\newsavebox</nodename><nodenext automatic="on">\newenvironment &amp; \renewenvironment</nodenext><nodeprev automatic="on">\newlength</nodeprev><nodeup automatic="on">Definitions</nodeup></node>
-<section spaces=" "><sectiontitle><code>\newsavebox</code>: Allocating a box</sectiontitle>
+<section spaces=" "><sectiontitle><code>\newsavebox</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="446">\newsavebox</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="322">box, allocating new</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="458" mergedindex="cp">\newsavebox</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="421">box, allocating new</indexterm></cindex>
-<para>Allocate a &textldquo;bin&textrdquo; for holding a box. Synopsis:
+<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\newsavebox&lbrace;\<var>cmd</var>&rbrace;
+<pre xml:space="preserve">\newsavebox&lbrace;<var>cmd</var>&rbrace;
</pre></example>
-<para>Defines <code>\<var>cmd</var></code> to refer to a new bin for storing boxes.
-Such a box is for holding typeset material, to use multiple times
-(<pxref label="Boxes"><xrefnodename>Boxes</xrefnodename></pxref>) or to measure or manipulate. The name
-<code>\<var>cmd</var></code> must start with a backslash (<samp>\</samp>), and must not
-be already defined.
+<para>Define <code>\<var>cmd</var></code> to refer to a new &textldquo;bin&textrdquo; for storing boxes.
+Such a box is for holding typeset material, to use multiple times or to
+measure or manipulate (<pxref label="Boxes"><xrefnodename>Boxes</xrefnodename></pxref>). The required bin name
+<code><var>cmd</var></code> must start with a backslash, <code>\</code>, and must not
+already be defined. This command is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
-<para>The allocation of a box is global. This command is fragile
-(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+<para>The first line here sets you up to save the material for later use.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newsavebox&lbrace;\logobox&rbrace;
+\savebox&lbrace;\logobox&rbrace;&lbrace;LoGo&rbrace;
+Our logo is \usebox&lbrace;\logobox&rbrace;.
+</pre></example>
+
+<noindent></noindent>
+<para>The output is <samp>Our logo is LoGo</samp>.
+</para>
+<para>If there is an already defined bin then you get something like
+<samp>LaTeX Error: Command \logobox already defined. Or name
+\end... illegal, see p.192 of the manual</samp>.
+</para>
+<para>The allocation of a box is global.
</para>
</section>
<node name="_005cnewenvironment-_0026-_005crenewenvironment" spaces=" "><nodename>\newenvironment &amp; \renewenvironment</nodename><nodenext automatic="on">\newtheorem</nodenext><nodeprev automatic="on">\newsavebox</nodeprev><nodeup automatic="on">Definitions</nodeup></node>
<section spaces=" "><sectiontitle><code>\newenvironment</code> &amp; <code>\renewenvironment</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="447">\newenvironment</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="448">\renewenvironment</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="323">environments, defining</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="324">defining new environments</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="325">redefining environments</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="459" mergedindex="cp">\newenvironment</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="460" mergedindex="cp">\renewenvironment</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="422">environments, defining</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="423">defining new environments</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="424">redefining environments</indexterm></cindex>
-<para>These commands define or redefine an environment <var>env</var>, that is,
-<code>\begin&lbrace;<var>env</var>&rbrace; <var>body</var> \end&lbrace;<var>env</var>&rbrace;</code>. Synopses:
+<para>Synopses, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve"> \newenvironment&lbrace;<var>env</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>begdefn</var>&rbrace;&lbrace;<var>enddefn</var>&rbrace;
- \newenvironment*&lbrace;<var>env</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>begdefn</var>&rbrace;&lbrace;<var>enddefn</var>&rbrace;
- \renewenvironment&lbrace;<var>env</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>begdefn</var>&rbrace;&lbrace;<var>enddefn</var>&rbrace;
-\renewenvironment*&lbrace;<var>env</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>begdefn</var>&rbrace;&lbrace;<var>enddefn</var>&rbrace;
+<pre xml:space="preserve">\newenvironment&lbrace;<var>env</var>&rbrace;&lbrace;<var>begdef</var>&rbrace;&lbrace;<var>enddef</var>&rbrace;
+\newenvironment&lbrace;<var>env</var>&rbrace;[<var>nargs</var>]&lbrace;<var>begdef</var>&rbrace;&lbrace;<var>enddef</var>&rbrace;
+\newenvironment&lbrace;<var>env</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>begdef</var>&rbrace;&lbrace;<var>enddef</var>&rbrace;
+\newenvironment*&lbrace;<var>env</var>&rbrace;&lbrace;<var>begdef</var>&rbrace;&lbrace;<var>enddef</var>&rbrace;
+\newenvironment*&lbrace;<var>env</var>&rbrace;[<var>nargs</var>]&lbrace;<var>begdef</var>&rbrace;&lbrace;<var>enddef</var>&rbrace;
+\newenvironment*&lbrace;<var>env</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>begdef</var>&rbrace;&lbrace;<var>enddef</var>&rbrace;
</pre></example>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="326"><code>*</code>-form of environment commands</indexterm></cindex>
+<noindent></noindent>
+<para>or one of these.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\renewenvironment&lbrace;<var>env</var>&rbrace;&lbrace;<var>begdef</var>&rbrace;&lbrace;<var>enddef</var>&rbrace;
+\renewenvironment&lbrace;<var>env</var>&rbrace;[<var>nargs</var>]&lbrace;<var>begdef</var>&rbrace;&lbrace;<var>enddef</var>&rbrace;
+\renewenvironment&lbrace;<var>env</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>begdef</var>&rbrace;&lbrace;<var>enddef</var>&rbrace;
+\renewenvironment*&lbrace;<var>env</var>&rbrace;&lbrace;<var>begdef</var>&rbrace;&lbrace;<var>enddef</var>&rbrace;
+\renewenvironment*&lbrace;<var>env</var>&rbrace;[<var>nargs</var>]&lbrace;<var>begdef</var>&rbrace;&lbrace;<var>enddef</var>&rbrace;
+\renewenvironment*&lbrace;<var>env</var>&rbrace;[<var>nargs</var>][<var>optargdefault</var>]&lbrace;<var>begdef</var>&rbrace;&lbrace;<var>enddef</var>&rbrace;
+</pre></example>
+
+<para>Define or redefine the environment <var>env</var>, that is, create the
+construct <code>\begin&lbrace;<var>env</var>&rbrace; ... <var>body</var> ... \end&lbrace;<var>env</var>&rbrace;</code>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="425"><code>*</code>-form of environment commands</indexterm></cindex>
<para>The starred form of these commands requires that the arguments not
-contain multiple paragraphs of text. The body of these environments can
-still contain multiple paragraphs.
+contain multiple paragraphs of text. However, the body of these
+environments can contain multiple paragraphs.
</para>
<table commandarg="var" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="var">env</itemformat></item>
</tableterm><tableitem><para>Required; the environment name. It consists only of letters or the
-<code>*</code> character, and thus does not begin with backslash
-(<code>\</code>). It must not begin with the string <code>end</code>. For
+<code>*</code> character, and thus does not begin with backslash, <code>\</code>.
+It must not begin with the string <code>end</code>. For
<code>\newenvironment</code>, the name <var>env</var> must not be the name of an
already existing environment, and also the command <code>\<var>env</var></code>
must be undefined. For <code>\renewenvironment</code>, <var>env</var> must be the
@@ -6930,55 +9176,61 @@ name of an existing environment.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">nargs</itemformat></item>
</tableterm><tableitem><para>Optional; an integer from 0 to 9 denoting the number of arguments of
-that the environment will take. When the environment is used these
+that the environment takes. When you use the environment these
arguments appear after the <code>\begin</code>, as in
-<code>\begin&lbrace;<var>env</var>&rbrace;&lbrace;<var>arg1</var>&rbrace;&dots;&lbrace;<var>argn</var>&rbrace;</code>. If this
-argument is not present then the default is for the environment to have
-no arguments. When redefining an environment, the new version can have
-a different number of arguments than the old version.
+<code>\begin&lbrace;<var>env</var>&rbrace;&lbrace;<var>arg1</var>&rbrace; ... &lbrace;<var>argn</var>&rbrace;</code>. Omitting
+this is equivalent to setting it to 0; the environment will have no
+arguments. When redefining an environment, the new version can have a
+different number of arguments than the old version.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">optargdefault</itemformat></item>
-</tableterm><tableitem><para>Optional; if this argument is present then the first argument of the
-defined environment is optional, with default value <var>optargdefault</var>
-(which may be the empty string). If this argument is not present then
-the environment does not take an optional argument.
-</para>
-<para>That is, when <code>[<var>optargdefault</var>]</code> is present in the
-environment definition, if <code>\begin&lbrace;<var>env</var>&rbrace;</code> is used with
-square brackets following, as in
-<code>\begin&lbrace;<var>env</var>&rbrace;[<var>myval</var>]</code>, then, within <var>begdefn</var>,
-the positional parameter <code>#1</code> expands to <var>myval</var>. If
-<code>\begin&lbrace;<var>env</var>&rbrace;</code> is called without square brackets
-following, then, within within <var>begdefn</var>, the positional parameter
-<code>#1</code> expands to the default <var>optargdefault</var>. In either case,
-any required arguments will be referred to starting with <code>#2</code>.
-</para>
-<para>Omitting <code>[<var>myval</var>]</code> in the call is different from having the
+</tableterm><tableitem><para>Optional; if this is present then the first argument of the defined
+environment is optional, with default value <var>optargdefault</var> (which
+may be the empty string). If this is not in the definition then the
+environment does not take an optional argument.
+</para>
+<para>That is, when <var>optargdefault</var> is present in the definition of the
+environment then you can start the environment with square brackets, as
+in <code>\begin&lbrace;<var>env</var>&rbrace;[<var>optval</var>]&lbrace;...&rbrace; ... \end&lbrace;<var>env</var>&rbrace;</code>.
+In this case, within <var>begdefn</var> the parameter <code>#1</code> is set to the
+value of <var>optval</var>. If you call <code>\begin&lbrace;<var>env</var>&rbrace;</code> without
+square brackets, then within <var>begdefn</var> the parameter <code>#1</code> is
+set to the value of the default <var>optargdefault</var>. In either case,
+any required arguments start with <code>#2</code>.
+</para>
+<para>Omitting <code>[<var>myval</var>]</code> in the call is different than having the
square brackets with no contents, as in <code>[]</code>. The former results
in <code>#1</code> expanding to <var>optargdefault</var>; the latter results in
<code>#1</code> expanding to the empty string.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">begdefn</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">begdef</itemformat></item>
</tableterm><tableitem><para>Required; the text expanded at every occurrence of
-<code>\begin&lbrace;<var>env</var>&rbrace;</code>. Within <var>begdef</var>, the <var>n</var>th
-positional parameter (i.e., <code>#<var>n</var></code>) is replaced by the text
-of the <var>n</var>th argument.
+<code>\begin&lbrace;<var>env</var>&rbrace;</code>. Within <var>begdef</var>, the parameters
+<code>#1</code>, <code>#2</code>, ... <code>#<var>nargs</var></code>, are replaced by the
+values that you supply when you call the environment; see the examples
+below.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">enddefn</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">enddef</itemformat></item>
</tableterm><tableitem><para>Required; the text expanded at every occurrence of
-<code>\end&lbrace;<var>env</var>&rbrace;</code>. This may not contain any positional
-parameters, so <code>#<var>n</var></code> cannot be used here (but see the final
+<code>\end&lbrace;<var>env</var>&rbrace;</code>. This may not contain any parameters, that is,
+you cannot use <code>#1</code>, <code>#2</code>, etc., here (but see the final
example below).
</para>
</tableitem></tableentry></table>
-<para>All environments, that is to say the <var>begdefn</var> code, the environment
-body and the <var>enddefn</var> code, are processed within a group. Thus, in
+<para>All environments, that is to say the <var>begdef</var> code, the environment
+body, and the <var>enddef</var> code, are processed within a group. Thus, in
the first example below, the effect of the <code>\small</code> is limited to
the quote and does not extend to material following the environment.
</para>
+<para>If you try to define an environment and the name has already been used
+then you get something like <samp>LaTeX Error: Command \fred already
+defined. Or name \end... illegal, see p.192 of the manual</samp>. If you try
+to redefine an environment and the name has not yet been used then you
+get something like <samp>LaTeX Error: Environment hank undefined.</samp>.
+</para>
<para>This example gives an environment like &latex;&textrsquo;s <code>quotation</code>
-except that it will be set in smaller type:
+except that it will be set in smaller type.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newenvironment&lbrace;smallquote&rbrace;&lbrace;%
@@ -6988,8 +9240,18 @@ except that it will be set in smaller type:
&rbrace;
</pre></example>
-<para>This one shows the use of arguments; it gives a quotation environment
-that cites the author:
+<para>This has an argument, which is set in boldface at the start of a
+paragraph.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newenvironment&lbrace;point&rbrace;[1]&lbrace;%
+ \noindent\textbf&lbrace;#1&rbrace;
+&rbrace;&lbrace;%
+&rbrace;
+</pre></example>
+
+<para>This one shows the use of a optional argument; it gives a quotation
+environment that cites the author.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newenvironment&lbrace;citequote&rbrace;[1][Shakespeare]&lbrace;%
@@ -7000,8 +9262,9 @@ that cites the author:
&rbrace;
</pre></example>
-<noindent></noindent> <para>The author&textrsquo;s name is optional, and defaults to <samp>Shakespeare</samp>.
-In the document, use the environment like this:
+<noindent></noindent>
+<para>The author&textrsquo;s name is optional, and defaults to <samp>Shakespeare</samp>. In
+the document, use the environment like this.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;citequote&rbrace;[Lincoln]
@@ -7010,7 +9273,7 @@ In the document, use the environment like this:
</pre></example>
<para>The final example shows how to save the value of an argument to use in
-<var>enddefn</var>, in this case in a box (<pxref label="_005csbox"><xrefnodename>\sbox</xrefnodename></pxref>):
+<var>enddef</var>, in this case in a box (<pxref label="_005csbox-_0026-_005csavebox"><xrefnodename>\sbox &amp; \savebox</xrefnodename></pxref>).
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newsavebox&lbrace;\quoteauthor&rbrace;
@@ -7028,13 +9291,13 @@ In the document, use the environment like this:
<node name="_005cnewtheorem" spaces=" "><nodename>\newtheorem</nodename><nodenext automatic="on">\newfont</nodenext><nodeprev automatic="on">\newenvironment &amp; \renewenvironment</nodeprev><nodeup automatic="on">Definitions</nodeup></node>
<section spaces=" "><sectiontitle><code>\newtheorem</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="449">\newtheorem</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="327">theorems, defining</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="328">defining new theorems</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="461" mergedindex="cp">\newtheorem</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="426">theorems, defining</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="427">defining new theorems</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="329">theorem-like environment</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="330">environment, theorem-like</indexterm></cindex>
-<para>Define a new theorem-like environment. Synopses:
+<cindex index="cp" spaces=" "><indexterm index="cp" number="428">theorem-like environment</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="429">environment, theorem-like</indexterm></cindex>
+<para>Synopses:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newtheorem&lbrace;<var>name</var>&rbrace;&lbrace;<var>title</var>&rbrace;
@@ -7042,25 +9305,24 @@ In the document, use the environment like this:
\newtheorem&lbrace;<var>name</var>&rbrace;[<var>numbered_like</var>]&lbrace;<var>title</var>&rbrace;
</pre></example>
-<para>Using the first form, <code>\newtheorem&lbrace;<var>name</var>&rbrace;&lbrace;<var>title</var>&rbrace;</code>
-creates an environment that will be labelled with <var>title</var>. See the
-first example below.
+<para>Define a new theorem-like environment. You can specify one of
+<var>numbered_within</var> and <var>numbered_like</var>, or neither, but not both.
</para>
-<para>The second form
-<code>\newtheorem&lbrace;<var>name</var>&rbrace;&lbrace;<var>title</var>&rbrace;[<var>numbered_within</var>]</code>
+<para>The first form, <code>\newtheorem&lbrace;<var>name</var>&rbrace;&lbrace;<var>title</var>&rbrace;</code>, creates
+an environment that will be labelled with <var>title</var>; see the first
+example below.
+</para>
+<para>The second form,
+<code>\newtheorem&lbrace;<var>name</var>&rbrace;&lbrace;<var>title</var>&rbrace;[<var>numbered_within</var>]</code>,
creates an environment whose counter is subordinate to the existing
-counter <var>numbered_within</var> (its counter will be reset when
-<var>numbered_within</var> is reset).
+counter <var>numbered_within</var>, so this counter will be reset when
+<var>numbered_within</var> is reset. See the second example below.
</para>
-
<para>The third form
<code>\newtheorem&lbrace;<var>name</var>&rbrace;[<var>numbered_like</var>]&lbrace;<var>title</var>&rbrace;</code>,
-with optional argument between the two required arguments, will create
-an environment whose counter will share the previously defined counter
-<var>numbered_like</var>.
-</para>
-<para>You can specify one of <var>numbered_within</var> and <var>numbered_like</var>,
-or neither, but not both.
+with optional argument between the two required arguments, creates an
+environment whose counter will share the previously defined counter
+<var>numbered_like</var>. See the third example.
</para>
<para>This command creates a counter named <var>name</var>. In addition, unless
the optional argument <var>numbered_like</var> is used, inside of the
@@ -7073,12 +9335,13 @@ theorem-like environment the current <code>\ref</code> value will be that of
</para>
<table commandarg="var" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="var">name</itemformat></item>
-</tableterm><tableitem><para>The name of the environment. It must not begin with a backslash
-(<samp>\</samp>). It must not be the name of an existing environment; indeed,
-the command name <code>\<var>name</var></code> must not already be defined as anything.
+</tableterm><tableitem><para>The name of the environment. It is a string of letters. It must not
+begin with a backslash, <code>\</code>. It must not be the name of an
+existing environment, and the command name <code>\<var>name</var></code> must not
+already be defined.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">title</itemformat></item>
-</tableterm><tableitem><para>The text printed at the beginning of the environment, before the
+</tableterm><tableitem><para>The text to be printed at the beginning of the environment, before the
number. For example, <samp>Theorem</samp>.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">numbered_within</itemformat></item>
@@ -7115,10 +9378,10 @@ output.
\end&lbrace;defn&rbrace;
</pre></example>
-<para>Because the next example specifies the optional argument
-<var>numbered_within</var> to <code>\newtheorem</code> as <code>section</code>, the
-example, with the same document body, gives <samp>Definition&nbsp;1.1</samp>
-and <samp>Definition&nbsp;2.1</samp>.
+<para>This example has the same document body as the prior one. But here
+<code>\newtheorem</code>&textrsquo;s optional argument <var>numbered_within</var> is given as
+<code>section</code>, so the output is like <samp>Definition&nbsp;1.1</samp> and
+<samp>Definition&nbsp;2.1</samp>.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newtheorem&lbrace;defn&rbrace;&lbrace;Definition&rbrace;[section]
@@ -7161,45 +9424,43 @@ by <samp>Theorem&nbsp;2.1</samp> and <samp>Definition&nbsp;2.2</samp>.
</section>
<node name="_005cnewfont" spaces=" "><nodename>\newfont</nodename><nodenext automatic="on">\protect</nodenext><nodeprev automatic="on">\newtheorem</nodeprev><nodeup automatic="on">Definitions</nodeup></node>
-<section spaces=" "><sectiontitle><code>\newfont</code>: Define a new font (obsolete)</sectiontitle>
+<section spaces=" "><sectiontitle><code>\newfont</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="450">\newfont</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="331">fonts, new commands for</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="332">defining new fonts</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="462" mergedindex="cp">\newfont</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="430">fonts, new commands for</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="431">defining new fonts</indexterm></cindex>
-<para><code>\newfont</code>, now obsolete, defines a command that will switch fonts.
-Synopsis:
+<!-- c @findex .fd @r{file} -->
+<para>This command is obsolete. This description is here only to help with old
+documents. New documents should define fonts in families through the
+New Font Selection Scheme which allows you to, for example, associate a
+boldface with a roman (<pxref label="Fonts"><xrefnodename>Fonts</xrefnodename></pxref>).
+<!-- c This is done either by using -->
+<!-- c @file{.fd} files or through the use of an engine that can access system -->
+<!-- c fonts such as Xe@LaTeX{} (@pxref{@TeX{} engines}). -->
+</para>
+<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newfont&lbrace;\<var>cmd</var>&rbrace;&lbrace;<var>font description</var>&rbrace;
</pre></example>
-<para>This defines a control sequence <code>\<var>cmd</var></code> that will change the
-current font. &latex; will look on your system for a file named
-<file><var>fontname</var>.tfm</file>. The control sequence must must not already
-be defined. It must begin with a backslash (<samp>\</samp>).
+<para>Define a command <code>\<var>cmd</var></code> that will change the current font.
+The control sequence must must not already be defined. It must begin
+with a backslash, <code>\</code>.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="451">.fd <r>file</r></indexterm></findex>
-<para>This command is obsolete. It is a low-level command for setting up an
-individual font. Today fonts are almost always defined in families
-(which allows you to, for example, associate a boldface with a roman)
-through the so-called &textldquo;New Font Selection Scheme&textrdquo;, either by using
-<file>.fd</file> files or through the use of an engine that can access
-system fonts such as Xe&latex; (<pxref label="TeX-engines"><xrefnodename>&tex; engines</xrefnodename></pxref>).
-<!-- c xx explain nfss somewhere -->
+<cindex index="cp" spaces=" "><indexterm index="cp" number="432">at clause, in font definitions</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="433">design size, in font definitions</indexterm></cindex>
+<para>The <var>font description</var> consists of a <var>fontname</var> and an optional
+<dfn>at clause</dfn>. &latex; will look on your system for a file named
+<file><var>fontname</var>.tfm</file>. The at clause can have the form either
+<code>at <var>dimen</var></code> or <code>scaled <var>factor</var></code>, where a
+<var>factor</var> of <samp>1000</samp> means no scaling. For &latex;&textrsquo;s purposes,
+all this does is scale all the character and other font dimensions
+relative to the font&textrsquo;s design size, which is a value defined in the
+<file>.tfm</file> file.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="333">at clause, in font definitions</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="334">design size, in font definitions</indexterm></cindex>
-<para>But since it is part of &latex;, here is an explanation: the
-<var>font description</var> consists of a <var>fontname</var> and an optional
-<dfn>at clause</dfn>; this can have the form either <code>at <var>dimen</var></code>
-or <code>scaled <var>factor</var></code>, where a <var>factor</var> of <samp>1000</samp>
-means no scaling. For &latex;&textrsquo;s purposes, all this does is scale all
-the character and other font dimensions relative to the font&textrsquo;s design
-size, which is a value defined in the <file>.tfm</file> file.
-</para>
-<para>This example defines two equivalent fonts and typesets a few
-characters in each:
+<para>This defines two equivalent fonts and typesets a few characters in each.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newfont&lbrace;\testfontat&rbrace;&lbrace;cmb10 at 11pt&rbrace;
@@ -7213,9 +9474,9 @@ characters in each:
<node name="_005cprotect" spaces=" "><nodename>\protect</nodename><nodenext automatic="on">\ignorespaces &amp; \ignorespacesafterend</nodenext><nodeprev automatic="on">\newfont</nodeprev><nodeup automatic="on">Definitions</nodeup></node>
<section spaces=" "><sectiontitle><code>\protect</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="452">\protect</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="335">fragile commands</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="336">robust commands</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="463" mergedindex="cp">\protect</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="434">fragile commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="435">robust commands</indexterm></cindex>
<para>All &latex; commands are either <dfn>fragile</dfn> or <dfn>robust</dfn>. A
fragile command can break when it is used in the argument to certain
@@ -7233,7 +9494,7 @@ name</var>&rbrace;</code> command it writes the <var>section name</var> text to
document such as in the table of contents. Any argument that is
internally expanded by &latex; without typesetting it directly is
referred to as a
-<cindex index="cp" spaces=" "><indexterm index="cp" number="337">moving arguments</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="436">moving arguments</indexterm></cindex>
<dfn>moving argument</dfn>. A command is fragile if it can
expand during this process into invalid &tex; code. Some examples of
moving arguments are those that appear in the <code>\caption&lbrace;...&rbrace;</code>
@@ -7279,10 +9540,10 @@ to <code>\protect\(..\protect\)</code>.
<node name="_005cignorespaces-_0026-_005cignorespacesafterend" spaces=" "><nodename>\ignorespaces &amp; \ignorespacesafterend</nodename><nodeprev automatic="on">\protect</nodeprev><nodeup automatic="on">Definitions</nodeup></node>
<section spaces=" "><sectiontitle><code>\ignorespaces &amp; \ignorespacesafterend</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="453">\ignorespaces</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="454">\ignorespacesafterend</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="338">spaces, ignore around commands</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="339">commands, ignore spaces</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="464" mergedindex="cp">\ignorespaces</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="465" mergedindex="cp">\ignorespacesafterend</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="437">spaces, ignore around commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="438">commands, ignore spaces</indexterm></cindex>
<para>Synopsis:
</para>
@@ -7290,6 +9551,7 @@ to <code>\protect\(..\protect\)</code>.
<pre xml:space="preserve">\ignorespaces
</pre></example>
+<noindent></noindent>
<para>or
</para>
<example endspaces=" ">
@@ -7311,13 +9573,18 @@ the command and the question text.
<pre xml:space="preserve">\newcommand&lbrace;\points&rbrace;[1]&lbrace;\makebox[0pt]&lbrace;\makebox[10em][l]&lbrace;#1~pts&rbrace;&rbrace;
\begin&lbrace;enumerate&rbrace;
\item\points&lbrace;10&rbrace;no extra space output here
- \item\points&lbrace;15&rbrace; extra space output between the number and the word `extra'
+ \item\points&lbrace;15&rbrace; extra space between the number and the `extra'
\end&lbrace;enumerate&rbrace;
</pre></example>
-<para>The solution is to change to
-<code>\newcommand&lbrace;\points&rbrace;[1]&lbrace;\makebox[0pt]&lbrace;\makebox[10em][l]&lbrace;#1~pts&rbrace;&rbrace;\ignorespaces&rbrace;</code>.
+<noindent></noindent>
+<para>The solution is to change to this.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand&lbrace;\points&rbrace;[1]&lbrace;%
+ \makebox[0pt]&lbrace;\makebox[10em][l]&lbrace;#1~pts&rbrace;&rbrace;\ignorespaces&rbrace;
+</pre></example>
+
<para>A second example shows spaces being removed from the front of text. The
commands below allow a user to uniformly attach a title to names. But,
as given, if a title accidentally starts with a space then
@@ -7326,7 +9593,7 @@ as given, if a title accidentally starts with a space then
<example endspaces=" ">
<pre xml:space="preserve">\makeatletter
\newcommand&lbrace;\honorific&rbrace;[1]&lbrace;\def\&arobase;honorific&lbrace;#1&rbrace;&rbrace; % remember title
-\newcommand&lbrace;\fullname&rbrace;[1]&lbrace;\&arobase;honorific~#1&rbrace; % recall title; put before name
+\newcommand&lbrace;\fullname&rbrace;[1]&lbrace;\&arobase;honorific~#1&rbrace; % put title before name
\makeatother
\begin&lbrace;tabular&rbrace;&lbrace;|l|&rbrace;
\honorific&lbrace;Mr/Ms&rbrace; \fullname&lbrace;Jones&rbrace; \\ % no extra space here
@@ -7334,6 +9601,7 @@ as given, if a title accidentally starts with a space then
\end&lbrace;tabular&rbrace;
</pre></example>
+<noindent></noindent>
<para>To fix this, change to
<code>\newcommand&lbrace;\fullname&rbrace;[1]&lbrace;\ignorespaces\&arobase;honorific~#1&rbrace;</code>.
</para>
@@ -7371,8 +9639,8 @@ inconvenient. The solution is to change to
<node name="Counters" spaces=" "><nodename>Counters</nodename><nodenext automatic="on">Lengths</nodenext><nodeprev automatic="on">Definitions</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Counters</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="340">counters, a list of</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="341">variables, a list of</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="439">counters, a list of</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="440">variables, a list of</indexterm></cindex>
<para>Everything &latex; numbers for you has a counter associated with
it. The name of the counter is often the same as the name of the
@@ -7397,29 +9665,31 @@ inside of a minipage (<pxref label="minipage"><xrefnodename>minipage</xrefnodena
through <code>enumiv</code> are used in the <code>enumerate</code> environment, for
up to four levels of nesting (<pxref label="enumerate"><xrefnodename>enumerate</xrefnodename></pxref>).
</para>
+<para>Counters can have any integer value but they are typically positive.
+</para>
<para>New counters are created with <code>\newcounter</code>. <xref label="_005cnewcounter"><xrefnodename>\newcounter</xrefnodename></xref>.
</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\alph \Alph \arabic \roman \Roman \fnsymbol</menunode><menudescription><pre xml:space="preserve">Print value of a counter.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\usecounter</menunode><menudescription><pre xml:space="preserve">Use a specified counter in a list environment.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\value</menunode><menudescription><pre xml:space="preserve">Use the value of a counter in an expression.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\setcounter</menunode><menudescription><pre xml:space="preserve">Set the value of a counter.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\addtocounter</menunode><menudescription><pre xml:space="preserve">Add a quantity to a counter.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\refstepcounter</menunode><menudescription><pre xml:space="preserve">Add to a counter.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\stepcounter</menunode><menudescription><pre xml:space="preserve">Add to a counter, resetting subsidiary counters.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\day \month \year</menunode><menudescription><pre xml:space="preserve">Numeric date values.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\usecounter</menunode><menudescription><pre xml:space="preserve">Use a specified counter in a list environment.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\value</menunode><menudescription><pre xml:space="preserve">Use the value of a counter in an expression.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\setcounter</menunode><menudescription><pre xml:space="preserve">Set the value of a counter.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\addtocounter</menunode><menudescription><pre xml:space="preserve">Add a quantity to a counter.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\refstepcounter</menunode><menudescription><pre xml:space="preserve">Add to a counter.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\stepcounter</menunode><menudescription><pre xml:space="preserve">Add to a counter, resetting subsidiary counters.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\day &amp; \month &amp; \year</menunode><menudescription><pre xml:space="preserve">Numeric date values.
</pre></menudescription></menuentry></menu>
<node name="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol" spaces=" "><nodename>\alph \Alph \arabic \roman \Roman \fnsymbol</nodename><nodenext automatic="on">\usecounter</nodenext><nodeup automatic="on">Counters</nodeup></node>
<section spaces=" "><sectiontitle><code>\alph \Alph \arabic \roman \Roman \fnsymbol</code>: Printing counters</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="342">counters, printing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="441">counters, printing</indexterm></cindex>
<para>Print the value of a counter, in a specified style. For instance, if
the counter <var>counter</var> has the value 1 then a
-<code>\alph&lbrace;<var>counter</var>&rbrace;</code> in your source will result in a lower case
+<code>\alph&lbrace;<var>counter</var>&rbrace;</code> in your source will result in a lowercase
letter&nbsp;a appearing in the output.
</para>
<para>All of these commands take a single counter as an argument, for
@@ -7427,51 +9697,61 @@ instance, <code>\alph&lbrace;enumi&rbrace;</code>. Note that the counter name d
start with a backslash.
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="455">\alph&lbrace;<var>counter</var>&rbrace;</indexterm>\alph&lbrace;<var>counter</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Print the value of <var>counter</var> in lowercase letters: &textlsquo;a&textrsquo;, &textlsquo;b&textrsquo;, &enddots;
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="456">\Alph&lbrace;<var>counter</var>&rbrace;</indexterm>\Alph&lbrace;<var>counter</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Print in uppercase letters: &textlsquo;A&textrsquo;, &textlsquo;B&textrsquo;, &enddots;
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="457">\arabic&lbrace;<var>counter</var>&rbrace;</indexterm>\arabic&lbrace;<var>counter</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Print in Arabic numbers: &textlsquo;1&textrsquo;, &textlsquo;2&textrsquo;, &enddots;
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="458">\roman&lbrace;<var>counter</var>&rbrace;</indexterm>\roman&lbrace;<var>counter</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Print in lowercase roman numerals: &textlsquo;i&textrsquo;, &textlsquo;ii&textrsquo;, &enddots;
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="459">\Roman&lbrace;<var>counter</var>&rbrace;</indexterm>\Roman&lbrace;<var>counter</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Print in uppercase roman numerals: &textlsquo;I&textrsquo;, &textlsquo;II&textrsquo;, &enddots;
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="460">\fnsymbol&lbrace;<var>counter</var>&rbrace;</indexterm>\fnsymbol&lbrace;<var>counter</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Prints the value of <var>counter</var> in a specific sequence of nine
-symbols (conventionally used for labeling footnotes). The value of
-<var>counter</var> must be between&nbsp;1 and&nbsp;9, inclusive.
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="466" mergedindex="cp">\alph&lbrace;<var>counter</var>&rbrace;</indexterm>\alph&lbrace;<var>counter</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><para>Print the value of <var>counter</var> in lowercase letters: &textlsquo;a&textrsquo;, &textlsquo;b&textrsquo;,
+&enddots; If the counter&textrsquo;s value is less than 1 or more than 26 then
+you get <samp>LaTeX Error: Counter too large.</samp>
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="467" mergedindex="cp">\Alph&lbrace;<var>counter</var>&rbrace;</indexterm>\Alph&lbrace;<var>counter</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><para>Print in uppercase letters: &textlsquo;A&textrsquo;, &textlsquo;B&textrsquo;, &enddots; If the counter&textrsquo;s value
+is less than 1 or more than 26 then you get <samp>LaTeX Error: Counter
+too large.</samp>
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="468" mergedindex="cp">\arabic&lbrace;<var>counter</var>&rbrace;</indexterm>\arabic&lbrace;<var>counter</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><para>Print in Arabic numbers such as <samp>5</samp> or <samp>-2</samp>.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="469" mergedindex="cp">\roman&lbrace;<var>counter</var>&rbrace;</indexterm>\roman&lbrace;<var>counter</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><para>Print in lowercase roman numerals: &textlsquo;i&textrsquo;, &textlsquo;ii&textrsquo;, &enddots; If the
+counter&textrsquo;s value is less than 1 then you get no warning or error but
+&latex; does not print anything in the output.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="470" mergedindex="cp">\Roman&lbrace;<var>counter</var>&rbrace;</indexterm>\Roman&lbrace;<var>counter</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><para>Print in uppercase roman numerals: &textlsquo;I&textrsquo;, &textlsquo;II&textrsquo;, &enddots; If the
+counter&textrsquo;s value is less than 1 then you get no warning or error but
+&latex; does not print anything in the output.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="471" mergedindex="cp">\fnsymbol&lbrace;<var>counter</var>&rbrace;</indexterm>\fnsymbol&lbrace;<var>counter</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><para>Prints the value of <var>counter</var> using a sequence of nine symbols that
+are traditionally used for labeling footnotes. The value of
+<var>counter</var> should be between&nbsp;1 and&nbsp;9, inclusive. If the
+counter&textrsquo;s value is less than 0 or more than 9 then you get <samp>LaTeX
+Error: Counter too large</samp>, while if it is 0 then you get no error or
+warning but &latex; does not output anything.
</para>
<para>Here are the symbols:
</para>
-<multitable spaces=" " endspaces=" "><columnfractions line=" .33 .33 .33"><columnfraction value=".33"></columnfraction><columnfraction value=".33"></columnfraction><columnfraction value=".33"></columnfraction></columnfractions>
-<thead><row><entry command="headitem" spaces=" "><para>Name</para></entry><entry command="tab" spaces=" "><para>Command</para></entry><entry command="tab"><para>Equivalent Unicode symbol and/or numeric code point<!-- c
- -->
+<multitable spaces=" " endspaces=" "><columnfractions line=" .10 .30 .30 .30"><columnfraction value=".10"></columnfraction><columnfraction value=".30"></columnfraction><columnfraction value=".30"></columnfraction><columnfraction value=".30"></columnfraction></columnfractions>
+<thead><row><entry command="headitem" spaces=" "><para>Number</para></entry><entry command="tab" spaces=" "><para>Name</para></entry><entry command="tab" spaces=" "><para>Command</para></entry><entry command="tab" spaces=" "><para>Symbol
</para></entry></row></thead><tbody><row><entry command="item">
-<para>asterisk</para></entry><entry command="tab"><para><code>\ast</code></para></entry><entry command="tab"><para>*<!-- c
- -->
+<para>1</para></entry><entry command="tab" spaces=" "><para>asterisk</para></entry><entry command="tab"><para><code>\ast</code></para></entry><entry command="tab"><para>*<!-- c -->
</para></entry></row><row><entry command="item">
-<para>dagger</para></entry><entry command="tab"><para><code>\dagger</code></para></entry><entry command="tab"><para><U>2020</U>
+<para>2</para></entry><entry command="tab" spaces=" "><para>dagger</para></entry><entry command="tab"><para><code>\dagger</code></para></entry><entry command="tab"><para><U>2020</U>
</para></entry></row><row><entry command="item">
-<para>ddagger</para></entry><entry command="tab"><para><code>\ddagger</code></para></entry><entry command="tab"><para><U>2021</U>
+<para>3</para></entry><entry command="tab" spaces=" "><para>ddagger</para></entry><entry command="tab"><para><code>\ddagger</code></para></entry><entry command="tab"><para><U>2021</U>
</para></entry></row><row><entry command="item">
-<para>section-sign</para></entry><entry command="tab"><para><code>\S</code></para></entry><entry command="tab"><para><U>00A7</U>
+<para>4</para></entry><entry command="tab" spaces=" "><para>section-sign</para></entry><entry command="tab"><para><code>\S</code></para></entry><entry command="tab"><para><U>00A7</U>
</para></entry></row><row><entry command="item">
-<para>paragraph-sign</para></entry><entry command="tab"><para><code>\P</code></para></entry><entry command="tab"><para><U>00B6</U>
+<para>5</para></entry><entry command="tab" spaces=" "><para>paragraph-sign</para></entry><entry command="tab"><para><code>\P</code></para></entry><entry command="tab"><para><U>00B6</U>
</para></entry></row><row><entry command="item">
-<para>double-vert</para></entry><entry command="tab"><para><code>\parallel</code></para></entry><entry command="tab"><para><U>2016</U>
+<para>6</para></entry><entry command="tab" spaces=" "><para>double-vert</para></entry><entry command="tab"><para><code>\parallel</code></para></entry><entry command="tab"><para><U>2016</U>
</para></entry></row><row><entry command="item">
-<para>double-asterisk</para></entry><entry command="tab"><para><code>\ast\ast</code></para></entry><entry command="tab"><para>**<!-- c
- -->
+<para>7</para></entry><entry command="tab" spaces=" "><para>double-asterisk</para></entry><entry command="tab"><para><code>\ast\ast</code></para></entry><entry command="tab"><para>**<!-- c -->
</para></entry></row><row><entry command="item">
-<para>double-dagger</para></entry><entry command="tab"><para><code>\dagger\dagger</code></para></entry><entry command="tab"><para><U>2020</U><U>2020</U>
+<para>8</para></entry><entry command="tab">
+ <para>double-dagger</para></entry><entry command="tab"><para><code>\dagger\dagger</code></para></entry><entry command="tab"><para><U>2020</U><U>2020</U>
</para></entry></row><row><entry command="item">
-<para>double-ddagger</para></entry><entry command="tab"><para><code>\ddagger\ddagger</code></para></entry><entry command="tab"><para><U>2021</U><U>2021</U>
+<para>9</para></entry><entry command="tab">
+ <para>double-ddagger</para></entry><entry command="tab"><para><code>\ddagger\ddagger</code></para></entry><entry command="tab"><para><U>2021</U><U>2021</U>
</para></entry></row></tbody></multitable>
</tableitem></tableentry></ftable>
@@ -7479,11 +9759,11 @@ symbols (conventionally used for labeling footnotes). The value of
</section>
<node name="_005cusecounter" spaces=" "><nodename>\usecounter</nodename><nodenext automatic="on">\value</nodenext><nodeprev automatic="on">\alph \Alph \arabic \roman \Roman \fnsymbol</nodeprev><nodeup automatic="on">Counters</nodeup></node>
-<section spaces=" "><sectiontitle><code>\usecounter&lbrace;<var>counter</var>&rbrace;</code></sectiontitle>
+<section spaces=" "><sectiontitle><code>\usecounter</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="461">\usecounter</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="343">list items, specifying counter</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="344">numbered items, specifying counter</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="472" mergedindex="cp">\usecounter</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="442">list items, specifying counter</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="443">numbered items, specifying counter</indexterm></cindex>
<para>Synopsis:
</para>
@@ -7491,15 +9771,16 @@ symbols (conventionally used for labeling footnotes). The value of
<pre xml:space="preserve">\usecounter&lbrace;<var>counter</var>&rbrace;
</pre></example>
-<para>In the <code>list</code> environment, when used in the second argument, this
-command sets up <var>counter</var> to number the list items. It initializes
-<var>counter</var> to zero, and arranges that when <code>\item</code> is called
-without its optional argument then <var>counter</var> is incremented by
-<code>\refstepcounter</code>, making its value be the current <code>ref</code>
-value. This command is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+<para>Used in the second argument of the <code>list</code> environment
+(<pxref label="list"><xrefnodename>list</xrefnodename></pxref>), this declares that list items will be numbered by
+<var>counter</var>. It initializes <var>counter</var> to zero, and arranges that
+when <code>\item</code> is called without its optional argument then
+<var>counter</var> is incremented by <code>\refstepcounter</code>, making its value
+be the current <code>ref</code> value (<pxref label="_005cref"><xrefnodename>\ref</xrefnodename></pxref>). This command is fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
-<para>Put in the preamble, this makes a new list environment enumerated with
-<var>testcounter</var>:
+<para>Put in the document preamble, this example makes a new list environment
+enumerated with <var>testcounter</var>:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\newcounter&lbrace;testcounter&rbrace;
@@ -7515,10 +9796,10 @@ value. This command is fragile (<pxref label="_005cprotect"><xrefnodename>\prot
</section>
<node name="_005cvalue" spaces=" "><nodename>\value</nodename><nodenext automatic="on">\setcounter</nodenext><nodeprev automatic="on">\usecounter</nodeprev><nodeup automatic="on">Counters</nodeup></node>
-<section spaces=" "><sectiontitle><code>\value&lbrace;<var>counter</var>&rbrace;</code></sectiontitle>
+<section spaces=" "><sectiontitle><code>\value</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="462">\value</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="345">counters, getting value of</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="473" mergedindex="cp">\value</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="444">counters, getting value of</indexterm></cindex>
<para>Synopsis:
</para>
@@ -7526,13 +9807,8 @@ value. This command is fragile (<pxref label="_005cprotect"><xrefnodename>\prot
<pre xml:space="preserve">\value&lbrace;<var>counter</var>&rbrace;
</pre></example>
-<para>This command expands to the value of <var>counter</var>. It is often used
-in <code>\setcounter</code> or <code>\addtocounter</code>, but <code>\value</code> can
-be used anywhere that &latex; expects a number. It must not be
-preceded by <code>\protect</code> (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
-</para>
-<para>The <code>\value</code> command is not used for typesetting the value of the
-counter. <xref label="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol"><xrefnodename>\alph \Alph \arabic \roman \Roman \fnsymbol</xrefnodename></xref>.
+<para>Expands to the value of the counter <var>counter</var>. (Note that the name
+of a counter does not begin with a backslash.)
</para>
<para>This example outputs <samp>Test counter is&nbsp;6. Other counter
is&nbsp;5.</samp>.
@@ -7546,6 +9822,14 @@ Test counter is \arabic&lbrace;test&rbrace;.
Other counter is \arabic&lbrace;other&rbrace;.
</pre></example>
+<para>The <code>\value</code> command is not used for typesetting the value of the
+counter. For that, see <ref label="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol"><xrefnodename>\alph \Alph \arabic \roman \Roman \fnsymbol</xrefnodename></ref>.
+</para>
+<para>It is often used in <code>\setcounter</code> or <code>\addtocounter</code> but
+<code>\value</code> can be used anywhere that &latex; expects a number, such
+as in <code>\hspace&lbrace;\value&lbrace;foo&rbrace;\parindent&rbrace;</code>. It must not be
+preceded by <code>\protect</code> (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
<para>This example inserts <code>\hspace&lbrace;4\parindent&rbrace;</code>.
</para>
<example endspaces=" ">
@@ -7556,11 +9840,11 @@ Other counter is \arabic&lbrace;other&rbrace;.
</section>
<node name="_005csetcounter" spaces=" "><nodename>\setcounter</nodename><nodenext automatic="on">\addtocounter</nodenext><nodeprev automatic="on">\value</nodeprev><nodeup automatic="on">Counters</nodeup></node>
-<section spaces=" "><sectiontitle><code>\setcounter&lbrace;<var>counter</var>&rbrace;&lbrace;<var>value</var>&rbrace;</code></sectiontitle>
+<section spaces=" "><sectiontitle><code>\setcounter</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="463">\setcounter</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="346">counters, setting</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="347">setting counters</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="474" mergedindex="cp">\setcounter</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="445">counters, setting</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="446">setting counters</indexterm></cindex>
<para>Synopsis:
</para>
@@ -7568,26 +9852,33 @@ Other counter is \arabic&lbrace;other&rbrace;.
<pre xml:space="preserve">\setcounter&lbrace;<var>counter</var>&rbrace;&lbrace;<var>value</var>&rbrace;
</pre></example>
-<para>The <code>\setcounter</code> command globally sets the value of <var>counter</var>
-to the <var>value</var> argument. Note that the counter name does not start
-with a backslash.
+<para>Globally set the counter <var>counter</var> to have the value of the
+<var>value</var> argument, which must be an integer. Thus, you can set a
+counter&textrsquo;s value as <code>\setcounter&lbrace;section&rbrace;&lbrace;5&rbrace;</code>. Note that the
+counter name does not start with a backslash.
</para>
-<para>In this example the section value appears as <samp>V</samp>.
+<para>In this example if the counter <code>theorem</code> has value 12 then the
+second line will print <samp>XII</samp>.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\setcounter&lbrace;section&rbrace;&lbrace;5&rbrace;
-Here it is in Roman: \Roman&lbrace;section&rbrace;.
+<pre xml:space="preserve">\setcounter&lbrace;exercise&rbrace;&lbrace;\value&lbrace;theorem&rbrace;&rbrace;
+Here it is in Roman: \Roman&lbrace;exercise&rbrace;.
</pre></example>
</section>
<node name="_005caddtocounter" spaces=" "><nodename>\addtocounter</nodename><nodenext automatic="on">\refstepcounter</nodenext><nodeprev automatic="on">\setcounter</nodeprev><nodeup automatic="on">Counters</nodeup></node>
-<section spaces=" "><sectiontitle><code>\addtocounter&lbrace;<var>counter</var>&rbrace;&lbrace;<var>value</var>&rbrace;</code></sectiontitle>
+<section spaces=" "><sectiontitle><code>\addtocounter</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="464">\addtocounter</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="475" mergedindex="cp">\addtocounter</indexterm></findex>
-<para>The <code>\addtocounter</code> command globally increments <var>counter</var> by
-the amount specified by the <var>value</var> argument, which may be negative.
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\addtocounter&lbrace;<var>counter</var>&rbrace;&lbrace;<var>value</var><spacecmd type="nl"/></pre></example>
+
+<para>Globally increment <var>counter</var> by the amount specified by the
+<var>value</var> argument, which may be negative.
</para>
<para>In this example the section value appears as <samp>VII</samp>.
</para>
@@ -7600,15 +9891,20 @@ Here it is in Roman: \Roman&lbrace;section&rbrace;.
</section>
<node name="_005crefstepcounter" spaces=" "><nodename>\refstepcounter</nodename><nodenext automatic="on">\stepcounter</nodenext><nodeprev automatic="on">\addtocounter</nodeprev><nodeup automatic="on">Counters</nodeup></node>
-<section spaces=" "><sectiontitle><code>\refstepcounter&lbrace;<var>counter</var>&rbrace;</code></sectiontitle>
+<section spaces=" "><sectiontitle><code>\refstepcounter</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="465">\refstepcounter</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="476" mergedindex="cp">\refstepcounter</indexterm></findex>
-<para>The <code>\refstepcounter</code> command works in the same way as
-<code>\stepcounter</code> (<pxref label="_005cstepcounter"><xrefnodename>\stepcounter</xrefnodename></pxref>): it globally increments the
-value of <var>counter</var> by one and resets the value of any counter
-numbered within it. (For the definition of &textldquo;counters numbered
-within&textrdquo;, <pxref label="_005cnewcounter"><xrefnodename>\newcounter</xrefnodename></pxref>.)
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\refstepcounter&lbrace;<var>counter</var>&rbrace;
+</pre></example>
+
+<para>Globally increments the value of <var>counter</var> by one, as does
+<code>\stepcounter</code> (<pxref label="_005cstepcounter"><xrefnodename>\stepcounter</xrefnodename></pxref>). The difference is that this
+command resets the value of any counter numbered within it. (For the
+definition of &textldquo;counters numbered within&textrdquo;, <pxref label="_005cnewcounter"><xrefnodename>\newcounter</xrefnodename></pxref>.)
</para>
<para>In addition, this command also defines the current <code>\ref</code> value
to be the result of <code>\thecounter</code>.
@@ -7618,32 +9914,53 @@ locally, i.e., inside the current group.
</para>
</section>
-<node name="_005cstepcounter" spaces=" "><nodename>\stepcounter</nodename><nodenext automatic="on">\day \month \year</nodenext><nodeprev automatic="on">\refstepcounter</nodeprev><nodeup automatic="on">Counters</nodeup></node>
-<section spaces=" "><sectiontitle><code>\stepcounter&lbrace;<var>counter</var>&rbrace;</code></sectiontitle>
+<node name="_005cstepcounter" spaces=" "><nodename>\stepcounter</nodename><nodenext automatic="on">\day &amp; \month &amp; \year</nodenext><nodeprev automatic="on">\refstepcounter</nodeprev><nodeup automatic="on">Counters</nodeup></node>
+<section spaces=" "><sectiontitle><code>\stepcounter</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="466">\stepcounter</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="477" mergedindex="cp">\stepcounter</indexterm></findex>
-<para>The <code>\stepcounter</code> command globally adds one to <var>counter</var> and
-resets all counters numbered within it. (For the definition of
-&textldquo;counters numbered within&textrdquo;, <pxref label="_005cnewcounter"><xrefnodename>\newcounter</xrefnodename></pxref>.)
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\stepcounter&lbrace;<var>counter</var>&rbrace;
+</pre></example>
+
+<para>Globally adds one to <var>counter</var> and resets all counters numbered
+within it. (For the definition of &textldquo;counters numbered within&textrdquo;,
+<pxref label="_005cnewcounter"><xrefnodename>\newcounter</xrefnodename></pxref>.)
+</para>
+<para>This command differs from <code>\refstepcounter</code> in that this one does
+not influence references&nbsp;&textmdash; it does not define the current
+<code>\ref</code> value to be the result of <code>\thecounter</code>
+(<pxref label="_005crefstepcounter"><xrefnodename>\refstepcounter</xrefnodename></pxref>).
</para>
</section>
-<node name="_005cday-_005cmonth-_005cyear" spaces=" "><nodename>\day \month \year</nodename><nodeprev automatic="on">\stepcounter</nodeprev><nodeup automatic="on">Counters</nodeup></node>
-<section spaces=" "><sectiontitle><code>\day \month \year</code>: Predefined counters</sectiontitle>
+<node name="_005cday-_0026-_005cmonth-_0026-_005cyear" spaces=" "><nodename>\day &amp; \month &amp; \year</nodename><nodeprev automatic="on">\stepcounter</nodeprev><nodeup automatic="on">Counters</nodeup></node>
+<section spaces=" "><sectiontitle><code>\day</code> &amp; <code>\month</code> &amp; <code>\year</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="467">\day</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="468">\month</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="469">\year</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="478" mergedindex="cp">\day</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="479" mergedindex="cp">\month</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="480" mergedindex="cp">\year</indexterm></findex>
-<para>&latex; defines counters for the day of the month (<code>\day</code>,
-1&textndash;31), month of the year (<code>\month</code>, 1&textndash;12), and year
-(<code>\year</code>, Common Era). When &tex; starts up, they are
-set to the current values on the system where &tex; is running. They
-are not updated as the job progresses.
+<para>&latex; defines the counter <code>\day</code> for the day of the month
+(nominally with value between 1 and 31), <code>\month</code> for the month of
+the year (nominally with value between 1 and 12), and year <code>\year</code>.
+When &tex; starts up, they are set from the current values on the
+system. The related command <code>\today</code> produces a string
+representing the current day (<pxref label="_005ctoday"><xrefnodename>\today</xrefnodename></pxref>).
</para>
-<para>The related command <code>\today</code> produces a string representing the
-current day (<pxref label="_005ctoday"><xrefnodename>\today</xrefnodename></pxref>).
+<para>They counters are not updated as the job progresses so in principle they
+could be incorrect by the end. In addition, &tex; does no sanity
+check:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\day=-2 \month=13 \year=-4 \today
+</pre></example>
+
+<noindent></noindent>
+<para>gives no error or warning and results in the output <samp>-2, -4</samp> (the
+bogus month value produces no output).
</para>
</section>
@@ -7651,35 +9968,116 @@ current day (<pxref label="_005ctoday"><xrefnodename>\today</xrefnodename></pxre
<node name="Lengths" spaces=" "><nodename>Lengths</nodename><nodenext automatic="on">Making paragraphs</nodenext><nodeprev automatic="on">Counters</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Lengths</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="348">lengths, defining and using</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="447">lengths, defining and using</indexterm></cindex>
<para>A <dfn>length</dfn> is a measure of distance. Many &latex; commands take a
length as an argument.
</para>
+<para>This shows a box of the given length.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand&lbrace;\blackbar&rbrace;[1]&lbrace;\rule&lbrace;#1&rbrace;&lbrace;10pt&rbrace;&rbrace; % make a bar
+\newcommand&lbrace;\showhbox&rbrace;[2]&lbrace;\fboxsep=0pt\fbox&lbrace;\hbox to #1&lbrace;#2&rbrace;&rbrace;&rbrace; % box it
+XXX\showhbox&lbrace;100pt&rbrace;&lbrace;\blackbar&lbrace;100pt&rbrace;&rbrace;YYY
+</pre></example>
+
+<noindent></noindent>
+<para>It produces a black bar 100&nbsp;points long between <samp>XXX</samp> and
+<samp>YYY</samp>.
+</para>
<para>Lengths come in two types. A <dfn>rigid length</dfn> (what Plain &tex;
-calls a <dfn>dimen</dfn>) such as <code>10pt</code> cannot contain a <code>plus</code> or
-<code>minus</code> component. A <dfn>rubber length</dfn> (what Plain &tex; calls
-a <dfn>skip</dfn>) can contain those, as with <code>1cm plus0.05cm
-minus0.01cm</code>. These give the ability to stretch or shrink; the length
-in the prior sentence could appear in the output as long as 1.05&nbsp;cm
-or as short as 0.99&nbsp;cm, depending on what &tex;&textrsquo;s typesetting
-algorithm finds optimum.
+calls a <dfn>dimen</dfn>) such as <code>10pt</code> does not contain a <code>plus</code>
+or <code>minus</code> component. The above example shows a rigid length. A
+<dfn>rubber length</dfn> (what Plain &tex; calls a <dfn>skip</dfn>) can contain
+those components, as with <code>1cm plus0.05cm minus0.01cm</code>. Here the
+<code>1cm</code> is the <dfn>natural length</dfn> while the other two, the
+<code>plus</code> and <code>minus</code> components, allow the length to stretch or
+shrink.
+</para>
+<para>Shrinking is simpler: with <code>1cm minus 0.05cm</code>, the natural length
+is 1<dmn>cm</dmn> but if smaller is needed then &tex; can shrink it down as
+far as 0.95<dmn>cm</dmn>. Beyond that, &tex; refuses to shrink any more.
+Thus, below the first one works fine, producing a space of
+98&nbsp;points between the two bars.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">XXX\showhbox&lbrace;300pt&rbrace;&lbrace;%
+ \blackbar&lbrace;101pt&rbrace;\hspace&lbrace;100pt minus 2pt&rbrace;\blackbar&lbrace;101pt&rbrace;&rbrace;YYY
+
+XXX\showhbox&lbrace;300pt&rbrace;&lbrace;%
+ \blackbar&lbrace;105pt&rbrace;\hspace&lbrace;100pt minus 1pt&rbrace;\blackbar&lbrace;105pt&rbrace;&rbrace;YYY
+</pre></example>
+
+<noindent></noindent>
+<para>But the second one gets a warning like <samp>Overfull \hbox (1.0pt too
+wide) detected at line 17</samp>. In the output the first <samp>Y</samp> is
+overwritten by the end of the black bar, because the box&textrsquo;s material is
+wider than the 300<dmn>pt</dmn> allocated, as &tex; has refused to shrink
+the total to less than 309&nbsp;points.
+</para>
+<para>Stretching is like shrinking except that if &tex; is asked to stretch
+beyond the given amount, it won&textrsquo;t refuse. Here the first line is fine,
+producing a space of 110&nbsp;points between the bars.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">XXX\showhbox&lbrace;300pt&rbrace;&lbrace;%
+ \blackbar&lbrace;95pt&rbrace;\hspace&lbrace;100pt plus 10pt&rbrace;\blackbar&lbrace;95pt&rbrace;&rbrace;YYY
+
+XXX\showhbox&lbrace;300pt&rbrace;&lbrace;%
+ \blackbar&lbrace;95pt&rbrace;\hspace&lbrace;100pt plus 1pt&rbrace;\blackbar&lbrace;95pt&rbrace;&rbrace;YYY
+</pre></example>
+
+<noindent></noindent>
+<para>In the second line &tex; needs a stretch of 10&nbsp;points and only
+1&nbsp;point was specified. In this situation, &tex; stretches the
+space to the required length, but it complains with a warning like
+<samp>Underfull \hbox (badness 10000) detected at line 22</samp>. (We won&textrsquo;t
+discuss badness; the point is that the system was not given as much
+stretch as needed.)
+</para>
+<para>You can put both stretch and shrink in the same length, as in
+<code>1ex plus 0.05ex minus 0.02ex</code>.
+</para>
+<para>If &tex; is setting two or more rubber lengths then it allocates the
+stretch or shrink in proportion.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">XXX\showhbox&lbrace;300pt&rbrace;&lbrace;\blackbar&lbrace;100pt&rbrace;% left
+ \hspace&lbrace;0pt plus 50pt&rbrace;\blackbar&lbrace;80pt&rbrace;\hspace&lbrace;0pt plus 10pt&rbrace;% middle
+ \blackbar&lbrace;100pt&rbrace;&rbrace;YYY % right
+</pre></example>
+
+<noindent></noindent>
+<para>The outside bars take up 100&nbsp;points, so the middle needs another
+100. In the middle the bar takes up 80&nbsp;points, so the two
+<code>\hspace</code>&textrsquo;s must stretch 20&nbsp;points. Because the two say
+<code>plus 50pt</code> and <code>plus 10pt</code>, &tex; gets 5/6 of the
+stretch from the first space and 1/6 from the second.
</para>
<para>The <code>plus</code> or <code>minus</code> component of a rubber length can contain
a <dfn>fill</dfn> component, as in <code>1in plus2fill</code>. This gives the
-length infinite stretchability or shrinkability, so that the length in
-the prior sentence can be set by &tex; to any distance greater than or
-equal to 1&nbsp;inch. &tex; actually provides three infinite glue
-components <code>fil</code>, <code>fill</code>, and <code>filll</code>, such that the
-later ones overcome the earlier ones, but only the middle value is
-ordinarily used. <xref label="_005chfill"><xrefnodename>\hfill</xrefnodename></xref>, <xref label="_005cvfill"><xrefnodename>\vfill</xrefnodename></xref>.
-</para>
-<para>Multiplying an entire rubber length by a number turns it into a rigid
-length, so that after <code>\setlength&lbrace;\ylength&rbrace;&lbrace;1in plus 0.2in&rbrace;</code>
-and <code>\setlength&lbrace;\zlength&rbrace;&lbrace;3\ylength&rbrace;</code> then the value of
-<code>\zlength</code> is <code>3in</code>.
+length infinite stretchability or shrinkability so that &tex; could set
+it to any distance. Here the two figures will be equal-spaced across
+the page.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;minipage&rbrace;&lbrace;\linewidth&rbrace;
+ \hspace&lbrace;0pt plus 1fill&rbrace;\includegraphics&lbrace;godel.png&rbrace;%
+ \hspace&lbrace;0pt plus 1fill&rbrace;\includegraphics&lbrace;einstein.png&rbrace;%
+ \hspace&lbrace;0pt plus 1fill&rbrace;
+\end&lbrace;minipage&rbrace;
+</pre></example>
+<para>&tex; actually has three infinite glue components <code>fil</code>,
+<code>fill</code>, and <code>filll</code>. The later ones are more infinite than
+the earlier ones. Ordinarily document authors only use the middle one
+(<pxref label="_005chfill"><xrefnodename>\hfill</xrefnodename></pxref> and <pxref label="_005cvfill"><xrefnodename>\vfill</xrefnodename></pxref>).
+</para>
+<para>Multiplying a rubber length by a number turns it into a rigid length, so
+that after <code>\setlength&lbrace;\ylength&rbrace;&lbrace;1in plus 0.2in&rbrace;</code> and
+<code>\setlength&lbrace;\zlength&rbrace;&lbrace;3\ylength&rbrace;</code> then the value of
+<code>\zlength</code> is <code>3in</code>.
+</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">Units of length</menunode><menudescription><pre xml:space="preserve">The units that &latex; knows.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\setlength</menunode><menudescription><pre xml:space="preserve">Set the value of a length.
@@ -7687,77 +10085,92 @@ and <code>\setlength&lbrace;\zlength&rbrace;&lbrace;3\ylength&rbrace;</code> the
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\settodepth</menunode><menudescription><pre xml:space="preserve">Set a length to the depth of something.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\settoheight</menunode><menudescription><pre xml:space="preserve">Set a length to the height of something.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\settowidth</menunode><menudescription><pre xml:space="preserve">Set a length to the width of something.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Predefined lengths</menunode><menudescription><pre xml:space="preserve">Lengths that are, like, predefined.
+<!-- c * Predefined lengths:: Lengths that are, like, predefined. -->
</pre></menudescription></menuentry></menu>
<node name="Units-of-length" spaces=" "><nodename>Units of length</nodename><nodenext automatic="on">\setlength</nodenext><nodeup automatic="on">Lengths</nodeup></node>
<section spaces=" "><sectiontitle>Units of length</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="349">units, of length</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="448">units, of length</indexterm></cindex>
<para>&tex; and &latex; know about these units both inside and outside of
math mode.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">pt </itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="470">pt</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="350">Point</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="481" mergedindex="cp">pt</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="449">Point</indexterm></cindex>
+<anchor name="units-of-length-pt">units of length pt</anchor>
<para>Point 1/72.27 inch. The conversion to metric units, to two decimal
places, is 1<dmn>point</dmn> = 2.85<dmn>mm</dmn> = 28.45<dmn>cm</dmn>.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">pc</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="351">pica</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="471">pc</indexterm></findex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="450">pica</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="482" mergedindex="cp">pc</indexterm></findex>
+<anchor name="units-of-length-pc">units of length pc</anchor>
<para>Pica, 12 pt
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">in </itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="472">in</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="473">inch</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="483" mergedindex="cp">in</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="484" mergedindex="cp">inch</indexterm></findex>
+<anchor name="units-of-length-in">units of length in</anchor>
<para>Inch, 72.27 pt
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">bp </itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="474">bp</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="352">Big point</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="485" mergedindex="cp">bp</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="451">Big point</indexterm></cindex>
+<anchor name="units-of-length-bp">units of length bp</anchor>
<para>Big point, 1/72 inch. This length is the definition of a point in
PostScript and many desktop publishing systems.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">cm </itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="353">Centimeter</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="475">cm</indexterm></findex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="452">Centimeter</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="486" mergedindex="cp">cm</indexterm></findex>
+<anchor name="units-of-length-cm">units of length cm</anchor>
<para>Centimeter
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">mm </itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="354">Millimeter</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="476">mm</indexterm></findex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="453">Millimeter</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="487" mergedindex="cp">mm</indexterm></findex>
+<anchor name="units-of-length-mm">units of length mm</anchor>
<para>Millimeter
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">dd </itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="355">Didot point</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="477">dd</indexterm></findex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="454">Didot point</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="488" mergedindex="cp">dd</indexterm></findex>
+<anchor name="units-of-length-dd">units of length dd</anchor>
<para>Didot point, 1.07 pt
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">cc </itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="356">Cicero</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="478">cc</indexterm></findex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="455">Cicero</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="489" mergedindex="cp">cc</indexterm></findex>
+<anchor name="units-of-length-cc">units of length cc</anchor>
<para>Cicero, 12 dd
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">sp </itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="357">Scaled point</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="479">sp</indexterm></findex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="456">Scaled point</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="490" mergedindex="cp">sp</indexterm></findex>
+<anchor name="units-of-length-sp">units of length sp</anchor>
<para>Scaled point, 1/65536 pt
</para>
</tableitem></tableentry></table>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="358">ex</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="359">x-height</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="480">ex</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="360">m-width</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="361">em</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="481">em</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="457">ex</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="458">x-height</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="491" mergedindex="cp">ex</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="459">m-width</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="460">em</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="492" mergedindex="cp">em</indexterm></findex>
+<anchor name="Lengths_002fem">Lengths/em</anchor>
+<anchor name="Lengths_002fen">Lengths/en</anchor>
+<anchor name="Lengths_002fex">Lengths/ex</anchor>
+<anchor name="units-of-length-em">units of length em</anchor>
+<anchor name="units-of-length-en">units of length en</anchor>
+<anchor name="units-of-length-ex">units of length ex</anchor>
<para>Two other lengths that are often used are values set by the designer of
the font. The x-height of the current font <dfn>ex</dfn>, traditionally the
-height of the lower case letter x, is often used for vertical
+height of the lowercase letter x, is often used for vertical
lengths. Similarly <dfn>em</dfn>, traditionally the width of the capital
letter M, is often used for horizontal lengths (there is also
<code>\enspace</code>, which is <code>0.5em</code>). Use of these can help make a
@@ -7767,8 +10180,8 @@ of the vertical space between list items given as
likely to still be reasonable if the font is changed than a definition
given in points.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="362">mu, math unit</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="482">mu</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="461">mu, math unit</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="493" mergedindex="cp">mu</indexterm></findex>
<para>In math mode, many definitions are expressed in terms of the math unit
<dfn>mu</dfn> given by 1 em = 18 mu, where the em is taken from the current
math symbols family. <xref label="Spacing-in-math-mode"><xrefnodename>Spacing in math mode</xrefnodename></xref>.
@@ -7778,166 +10191,353 @@ math symbols family. <xref label="Spacing-in-math-mode"><xrefnodename>Spacing i
<node name="_005csetlength" spaces=" "><nodename>\setlength</nodename><nodenext automatic="on">\addtolength</nodenext><nodeprev automatic="on">Units of length</nodeprev><nodeup automatic="on">Lengths</nodeup></node>
<section spaces=" "><sectiontitle><code>\setlength</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="483">\setlength</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="363">lengths, setting</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="494" mergedindex="cp">\setlength</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="462">lengths, setting</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\setlength&lbrace;<var>\len</var>&rbrace;&lbrace;<var>amount</var>&rbrace;
+<pre xml:space="preserve">\setlength&lbrace;<var>len</var>&rbrace;&lbrace;<var>amount</var>&rbrace;
+</pre></example>
+
+<para>Set the length <var>len</var> to <var>amount</var>. The length name <var>len</var>
+must begin with a backslash, <code>\</code>. The <code>amount</code> can be a
+rubber length (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). It can be positive, negative or zero,
+and can be in any units that &latex; understands (<pxref label="Units-of-length"><xrefnodename>Units of
+length</xrefnodename></pxref>).
+</para>
+<para>Below, with &latex;&textrsquo;s defaults the first paragraph will be indented
+while the second will not.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">I told the doctor I broke my leg in two places.
+
+\setlength&lbrace;\parindent&rbrace;&lbrace;0em&rbrace;
+He said stop going to those places.
</pre></example>
-<para>The <code>\setlength</code> sets the value of <dfn>length command</dfn>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="364">length command</indexterm></cindex>
-<code>\<var>len</var></code> to the <var>value</var> argument which can be expressed in any
-units that &latex; understands, i.e., inches (<code>in</code>), millimeters
-(<code>mm</code>), points (<code>pt</code>), big points (<code>bp</code>), etc.
+<para>If there is no such length <var>len</var> then you get something like
+<samp>Undefined control sequence. &lt;argument&gt; \praindent</samp>.
</para>
</section>
<node name="_005caddtolength" spaces=" "><nodename>\addtolength</nodename><nodenext automatic="on">\settodepth</nodenext><nodeprev automatic="on">\setlength</nodeprev><nodeup automatic="on">Lengths</nodeup></node>
<section spaces=" "><sectiontitle><code>\addtolength</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="484">\addtolength</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="365">lengths, adding to</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="495" mergedindex="cp">\addtolength</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="463">lengths, adding to</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\addtolength&lbrace;<var>\len</var>&rbrace;&lbrace;<var>amount</var>&rbrace;
+<pre xml:space="preserve">\addtolength&lbrace;<var>len</var>&rbrace;&lbrace;<var>amount</var>&rbrace;
</pre></example>
+<para>Increment the length <var>len</var> by <var>amount</var>. The length name
+<var>len</var> begins with a backslash, <code>\</code>. The <code>amount</code> is a
+rubber length (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). It can be positive, negative or zero,
+and can be in any units that &latex; understands (<pxref label="Units-of-length"><xrefnodename>Units of
+length</xrefnodename></pxref>).
+</para>
+<para>Below, if <code>\parskip</code> starts with the value <code>0pt plus 1pt</code>
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\addtolength&lbrace;\parskip&rbrace;&lbrace;1pt&rbrace;
+Doctor: how is the boy who swallowed the silver dollar?
-<para>The <code>\addtolength</code> command increments a length command <code>\<var>len</var></code>
-by the amount specified in the <var>amount</var> argument, which may be
-negative.
+Nurse: no change.
+</pre></example>
+
+<noindent></noindent>
+<para>then it has the value <code>1pt plus 1pt</code> for the second paragraph.
+</para>
+<para>If there is no such length <var>len</var> then you get something like
+<samp>Undefined control sequence. &lt;argument&gt; \praindent</samp>. If you leave
+off the backslash at the start of <var>len</var>, as in
+<code>\addtolength&lbrace;parindent&rbrace;&lbrace;1pt&rbrace;</code>, then you get something like
+<samp>You can't use `the letter p' after \advance</samp>.
</para>
</section>
<node name="_005csettodepth" spaces=" "><nodename>\settodepth</nodename><nodenext automatic="on">\settoheight</nodenext><nodeprev automatic="on">\addtolength</nodeprev><nodeup automatic="on">Lengths</nodeup></node>
<section spaces=" "><sectiontitle><code>\settodepth</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="485">\settodepth</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="496" mergedindex="cp">\settodepth</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\settodepth&lbrace;\<var>len</var>&rbrace;&lbrace;<var>text</var>&rbrace;
+<pre xml:space="preserve">\settodepth&lbrace;<var>len</var>&rbrace;&lbrace;<var>text</var>&rbrace;
</pre></example>
-<para>The <code>\settodepth</code> command sets the value of a length command
-<code>\<var>len</var></code> equal to the depth of the <var>text</var> argument.
+<para>Set the length <var>len</var> to the depth of box that &latex; gets on
+typesetting the <var>text</var> argument. The length name <var>len</var> must
+begin with a backslash, <code>\</code>.
+</para>
+<para>This will show how low the character descenders go.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newlength&lbrace;\alphabetdepth&rbrace;
+\settodepth&lbrace;\alphabetdepth&rbrace;&lbrace;abcdefghijklmnopqrstuvwxyz&rbrace;
+\the\alphabetdepth
+</pre></example>
+
+<para>If there is no such length <var>len</var> then you get something like
+<samp>Undefined control sequence. &lt;argument&gt; \alphabetdepth</samp>. If you
+leave the backslash out of <var>len</var>, as in
+<code>\settodepth&lbrace;alphabetdepth&rbrace;&lbrace;...&rbrace;</code> then you get something like
+<samp>Missing number, treated as zero. &lt;to be read again&gt; \setbox</samp>.
</para>
</section>
<node name="_005csettoheight" spaces=" "><nodename>\settoheight</nodename><nodenext automatic="on">\settowidth</nodenext><nodeprev automatic="on">\settodepth</nodeprev><nodeup automatic="on">Lengths</nodeup></node>
<section spaces=" "><sectiontitle><code>\settoheight</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="486">\settoheight</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="497" mergedindex="cp">\settoheight</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\settoheight&lbrace;\<var>len</var>&rbrace;&lbrace;text&rbrace;
+<pre xml:space="preserve">\settoheight&lbrace;<var>len</var>&rbrace;&lbrace;text&rbrace;
</pre></example>
-<para>The <code>\settoheight</code> command sets the value of a length command <code>\<var>len</var></code>
-equal to the height of the <code>text</code> argument.
+<para>Sets the length <var>len</var> to the height of box that &latex; gets on
+typesetting the <code>text</code> argument. The length name <var>len</var> must
+begin with a backslash, <code>\</code>.
+</para>
+<para>This will show how high the characters go.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newlength&lbrace;\alphabetheight&rbrace;
+\settoheight&lbrace;\alphabetheight&rbrace;&lbrace;abcdefghijklmnopqrstuvwxyz&rbrace;
+\the\alphabetheight
+</pre></example>
+<para>If there is no such length <var>len</var> then you get something like
+<samp>Undefined control sequence. &lt;argument&gt; \alphabetheight</samp>. If you
+leave the backslash out of <var>len</var>, as in
+<code>\settoheight&lbrace;alphabetheight&rbrace;&lbrace;...&rbrace;</code> then you get something like
+<samp>Missing number, treated as zero. &lt;to be read again&gt; \setbox</samp>.
+</para>
</section>
-<node name="_005csettowidth" spaces=" "><nodename>\settowidth</nodename><nodenext automatic="on">Predefined lengths</nodenext><nodeprev automatic="on">\settoheight</nodeprev><nodeup automatic="on">Lengths</nodeup></node>
-<section spaces=" "><sectiontitle><code>\settowidth&lbrace;\<var>len</var>&rbrace;&lbrace;<var>text</var>&rbrace;</code></sectiontitle>
+<node name="_005csettowidth" spaces=" "><nodename>\settowidth</nodename><nodeprev automatic="on">\settoheight</nodeprev><nodeup automatic="on">Lengths</nodeup></node>
+<section spaces=" "><sectiontitle><code>\settowidth</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="487">\settowidth</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="498" mergedindex="cp">\settowidth</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\settowidth&lbrace;\<var>len</var>&rbrace;&lbrace;<var>text</var>&rbrace;
+<pre xml:space="preserve">\settowidth&lbrace;<var>len</var>&rbrace;&lbrace;<var>text</var>&rbrace;
</pre></example>
-<para>The <code>\settowidth</code> command sets the value of the command <var>\len</var>
-to the width of the <var>text</var> argument.
+<para>Set the length <var>len</var> to the width of the box that &latex; gets on
+typesetting the <var>text</var> argument. The length name <var>len</var> must
+begin with a backslash, <code>\</code>.
+</para>
+<para>This measures the width of the lowercase ASCII alphabet.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newlength&lbrace;\alphabetwidth&rbrace;
+\settowidth&lbrace;\alphabetwidth&rbrace;&lbrace;abcdefghijklmnopqrstuvwxyz&rbrace;
+\the\alphabetwidth
+</pre></example>
+
+<para>If there is no such length <var>len</var> then you get something like
+<samp>Undefined control sequence. &lt;argument&gt; \alphabetwidth</samp>. If you
+leave the backslash out of <var>len</var>, as in
+<code>\settoheight&lbrace;alphabetwidth&rbrace;&lbrace;...&rbrace;</code> then you get something like
+<samp>Missing number, treated as zero. &lt;to be read again&gt; \setbox</samp>.
+</para>
+
+<!-- c @node Predefined lengths -->
+<!-- c @section Predefined lengths -->
+
+<!-- c @cindex lengths, predefined -->
+<!-- c @cindex predefined lengths -->
+
+<!-- c @code{\width} -->
+<!-- c @findex \width -->
+
+<!-- c @code{\height} -->
+<!-- c @findex \height -->
+
+<!-- c @code{\depth} -->
+<!-- c @findex \depth -->
+
+<!-- c @code{\totalheight} -->
+<!-- c @findex \totalheight -->
+
+<!-- c These length parameters can be used in the arguments of the box-making -->
+<!-- c commands (@pxref{Boxes}). They specify the natural width, etc., of the -->
+<!-- c text in the box. @code{\totalheight} equals -->
+<!-- c @math{@code{@backslashchar{}height} + @code{@backslashchar{}depth}}. To -->
+<!-- c make a box with the text stretched to double the natural size, e.g., say -->
+
+<!-- c @example -->
+<!-- c \makebox[2\width]@{Get a stretcher@} -->
+<!-- c @end example -->
+
</section>
-<node name="Predefined-lengths" spaces=" "><nodename>Predefined lengths</nodename><nodeprev automatic="on">\settowidth</nodeprev><nodeup automatic="on">Lengths</nodeup></node>
-<section spaces=" "><sectiontitle>Predefined lengths</sectiontitle>
+</chapter>
+<node name="Making-paragraphs" spaces=" "><nodename>Making paragraphs</nodename><nodenext automatic="on">Math formulas</nodenext><nodeprev automatic="on">Lengths</nodeprev><nodeup automatic="on">Top</nodeup></node>
+<chapter spaces=" "><sectiontitle>Making paragraphs</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="366">lengths, predefined</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="367">predefined lengths</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="464">making paragraphs</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="465">paragraphs</indexterm></cindex>
-<para><code>\width</code>
-<findex index="fn" spaces=" "><indexterm index="fn" number="488">\width</indexterm></findex>
-</para>
-<para><code>\height</code>
-<findex index="fn" spaces=" "><indexterm index="fn" number="489">\height</indexterm></findex>
-</para>
-<para><code>\depth</code>
-<findex index="fn" spaces=" "><indexterm index="fn" number="490">\depth</indexterm></findex>
+<para>Once &latex; has all of a paragraph&textrsquo;s contents it divides it into
+lines, in a way that is optimized over the entire paragraph (<pxref label="Line-breaking"><xrefnodename>Line
+breaking</xrefnodename></pxref>). To end the current paragraph, put an empty line.
</para>
-<para><code>\totalheight</code>
-<findex index="fn" spaces=" "><indexterm index="fn" number="491">\totalheight</indexterm></findex>
+<example endspaces=" ">
+<pre xml:space="preserve">It is a truth universally acknowledged, that a single man in possession
+of a good fortune, must be in want of a wife.
+
+However little known the feelings or views of such a man may be on his
+first entering a neighbourhood, this truth is so well fixed in the minds
+of the surrounding families, that he is considered the rightful property
+of some one or other of their daughters.
+
+``My dear Mr. Bennet,'' said his lady to him one day,
+``have you heard that Netherfield Park is let at last?''
+</pre></example>
+
+<para>The separator lines must be empty, including not containing a comment
+character, <code>%</code>.
</para>
-<para>These length parameters can be used in the arguments of the box-making
-commands (<pxref label="Boxes"><xrefnodename>Boxes</xrefnodename></pxref>). They specify the natural width, etc., of
-the text in the box. <code>\totalheight</code> equals <math><code>&backslashchar;height</code> +
-<code>&backslashchar;depth</code></math>. To make a box with the text stretched to double the
-natural size, e.g., say
+<para>There are places where a new paragraph is not permitted. Don&textrsquo;t put a
+blank line in math mode (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>); here the line before the
+<code>\end&lbrace;equation&rbrace;</code>
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\makebox[2\width]&lbrace;Get a stretcher&rbrace;
-</pre></example>
+<pre xml:space="preserve">\begin&lbrace;equation&rbrace;
+ 2^&lbrace;|S|&rbrace; &gt; |S|
+\end&lbrace;equation&rbrace;
+</pre></example>
-</section>
-</chapter>
-<node name="Making-paragraphs" spaces=" "><nodename>Making paragraphs</nodename><nodenext automatic="on">Math formulas</nodenext><nodeprev automatic="on">Lengths</nodeprev><nodeup automatic="on">Top</nodeup></node>
-<chapter spaces=" "><sectiontitle>Making paragraphs</sectiontitle>
+<noindent></noindent>
+<para>will get you the error <samp>Missing $ inserted</samp>. Similarly, the blank
+line in this <code>section</code> argument
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\section&lbrace;aaa
-<cindex index="cp" spaces=" "><indexterm index="cp" number="368">making paragraphs</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="369">paragraphs</indexterm></cindex>
+bbb&rbrace;
+</pre></example>
-<para>A paragraph is ended by one or more completely blank lines&textmdash;lines not
-containing even a <code>%</code>. A blank line should not appear where a new
-paragraph cannot be started, such as in math mode or in the argument of
-a sectioning command.
+<noindent></noindent>
+<para>gets <samp>Runaway argument? &lbrace;aaa ! Paragraph ended before \&arobase;sect was
+complete</samp>.
</para>
+
<menu endspaces=" ">
-<menuentry leadingtext="* "><menunode separator=":: ">\indent</menunode><menudescription><pre xml:space="preserve">Indent this paragraph.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\noindent</menunode><menudescription><pre xml:space="preserve">Do not indent this paragraph.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\parskip</menunode><menudescription><pre xml:space="preserve">Space added before paragraphs.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Marginal notes</menunode><menudescription><pre xml:space="preserve">Putting remarks in the margin.
+<menuentry leadingtext="* "><menunode separator=":: ">\par</menunode><menudescription><pre xml:space="preserve">End the current paragraph.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\indent &amp; \noindent</menunode><menudescription><pre xml:space="preserve">Go into horizontal mode, possibly with an indent.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\parindent &amp; \parskip</menunode><menudescription><pre xml:space="preserve">Space added before paragraphs.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Marginal notes</menunode><menudescription><pre xml:space="preserve">Put remarks in the margin.
</pre></menudescription></menuentry></menu>
-<node name="_005cindent" spaces=" "><nodename>\indent</nodename><nodenext automatic="on">\noindent</nodenext><nodeup automatic="on">Making paragraphs</nodeup></node>
-<section spaces=" "><sectiontitle><code>\indent</code></sectiontitle>
+<node name="_005cpar" spaces=" "><nodename>\par</nodename><nodenext automatic="on">\indent &amp; \noindent</nodenext><nodeup automatic="on">Making paragraphs</nodeup></node>
+<section spaces=" "><sectiontitle><code>\par</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="499" mergedindex="cp">\par</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="466">paragraph, ending</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="492">\indent</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="493">\parindent</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="370">indent, forcing</indexterm></cindex>
+<para>Synopsis (note that while reading the input &tex;, converts two
+consecutive newlines to a <code>\par</code>):
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\par
+</pre></example>
+
+<para>End the current paragraph. The usual way to separate paragraphs is with
+a blank line but the <code>\par</code> command is entirely equivalent. This
+command is robust (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<para>This example uses <code>\par</code> rather than a blank line simply for
+readability.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand&lbrace;\syllabusLegalese&rbrace;&lbrace;%
+ \whatCheatingIs\par\whatHappensWhenICatchYou&rbrace;
+</pre></example>
-<para><code>\indent</code> produces a horizontal space whose width equals to the
-<code>\parindent</code> length, the normal paragraph indentation. It is used
-to add paragraph indentation where it would otherwise be suppressed.
+<para>The <code>\par</code> command does nothing in LR mode or a vertical mode but
+it terminates paragraph mode, bringing &latex; to vertical mode
+(<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>).
</para>
-<para>The default value for <code>\parindent</code> is <code>1em</code> in two-column
-mode, otherwise <code>15pt</code> for <code>10pt</code> documents, <code>17pt</code> for
-<code>11pt</code>, and <code>1.5em</code> for <code>12pt</code>.
+<para>You cannot use the <code>\par</code> command in math mode or in the argument
+of many commands, such as the <code>\section</code> command (<pxref label="Making-paragraphs"><xrefnodename>Making
+paragraphs</xrefnodename></pxref> and <pxref label="_005cnewcommand-_0026-_005crenewcommand"><xrefnodename>\newcommand &amp; \renewcommand</xrefnodename></pxref>).
+</para>
+<para>The <code>\par</code> command differs from the <code>\paragraph</code> command in
+that the latter is, like <code>\section</code> or <code>\subsection</code>, a
+sectioning unit used by the standard &latex; documents.
+</para>
+<para>The <code>\par</code> command differs from <code>\newline</code> and the line break
+double backslash, <code>\\</code>, in that \par ends the paragraph not just
+the line. It also triggers the addition of the between-paragraph
+vertical space <code>\parskip</code> (<pxref label="_005cparindent-_0026-_005cparskip"><xrefnodename>\parindent &amp; \parskip</xrefnodename></pxref>).
+</para>
+<para>The output from this example
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">xyz
+
+\setlength&lbrace;\parindent&rbrace;&lbrace;3in&rbrace;
+\setlength&lbrace;\parskip&rbrace;&lbrace;5in&rbrace;
+\noindent test\indent test1\par test2
+</pre></example>
+
+<noindent></noindent>
+<para>is: after <samp>xyz</samp> there is a vertical skip of 5&nbsp;inches and then
+<samp>test</samp> appears, aligned with the left margin. On the same line,
+there is an empty horizontal space of 3&nbsp;inches and then
+<samp>test1</samp> appears. Finally. there is a vertical space of
+5&nbsp;inches, followed by a fresh paragraph with a paragraph indent of
+3&nbsp;inches, and then &latex; puts the text <samp>test2</samp>.
</para>
</section>
-<node name="_005cnoindent" spaces=" "><nodename>\noindent</nodename><nodenext automatic="on">\parskip</nodenext><nodeprev automatic="on">\indent</nodeprev><nodeup automatic="on">Making paragraphs</nodeup></node>
-<section spaces=" "><sectiontitle><code>\noindent</code></sectiontitle>
+<node name="_005cindent-_0026-_005cnoindent" spaces=" "><nodename>\indent &amp; \noindent</nodename><nodenext automatic="on">\parindent &amp; \parskip</nodenext><nodeprev automatic="on">\par</nodeprev><nodeup automatic="on">Making paragraphs</nodeup></node>
+<section spaces=" "><sectiontitle><code>\indent</code> &amp; <code>\noindent</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="500" mergedindex="cp">\indent</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="501" mergedindex="cp">\noindent</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="502" mergedindex="cp">\parindent</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="467">indent, forcing</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\indent
+</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="494">\noindent</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="371">indent, suppressing</indexterm></cindex>
+<noindent></noindent> <para>or
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\noindent
+</pre></example>
-<para>When used at the beginning of the paragraph, this command suppresses any
-paragraph indentation, as in this example.
+<para>Go into horizontal mode (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>). The <code>\indent</code> command
+first outputs an empty box whose width is <code>\parindent</code>. These
+commands are robust (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<para>Ordinarily you create a new paragraph by putting in a blank line.
+<xref label="_005cpar"><xrefnodename>\par</xrefnodename></xref> for the difference between this command and <code>\par</code>. To
+start a paragraph without an indent, or to continue an interrupted
+paragraph, use <code>\noindent</code>.
+</para>
+<para>In the middle of a paragraph the <code>\noindent</code> command has no effect,
+because &latex; is already in horizontal mode there. The
+<code>\indent</code> command&textrsquo;s only effect is to output a space.
+</para>
+<para>This example starts a fresh paragraph.
</para>
<example endspaces=" ">
<pre xml:space="preserve">... end of the prior paragraph.
@@ -7945,79 +10545,131 @@ paragraph indentation, as in this example.
\noindent This paragraph is not indented.
</pre></example>
-<para>It has no effect when used in the middle of a paragraph.
+<noindent></noindent>
+<para>and this continues an interrupted paragraph.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">The data
+
+\begin&lbrace;center&rbrace;
+ \begin&lbrace;tabular&rbrace;&lbrace;rl&rbrace; ... \end&lbrace;tabular&rbrace;
+\end&lbrace;center&rbrace;
+
+\noindent shows this clearly.
+</pre></example>
+
+<para>To omit indentation in the entire document put
+<code>\setlength&lbrace;\parindent&rbrace;&lbrace;0pt&rbrace;</code> in the preamble. If you do that,
+you may want to also set the length of spaces between paragraphs,
+<code>\parskip</code> (<pxref label="_005cparindent-_0026-_005cparskip"><xrefnodename>\parindent &amp; \parskip</xrefnodename></pxref>).
</para>
-<para>To eliminate paragraph indentation in an entire document, put
-<code>\setlength&lbrace;\parindent&rbrace;&lbrace;0pt&rbrace;</code> in the preamble.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="468"><r>package</r>, <code>indentfirst</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="469"><code>indentfirst</code> <r>package</r></indexterm></cindex>
+
+<para>Default &latex; styles have the first paragraph after a section that is
+not indented, as is traditional typesetting in English. To change that,
+look on CTAN for the package <code>indentfirst</code>.
</para>
</section>
-<node name="_005cparskip" spaces=" "><nodename>\parskip</nodename><nodenext automatic="on">Marginal notes</nodenext><nodeprev automatic="on">\noindent</nodeprev><nodeup automatic="on">Making paragraphs</nodeup></node>
-<section spaces=" "><sectiontitle><code>\parskip</code></sectiontitle>
+<node name="_005cparindent-_0026-_005cparskip" spaces=" "><nodename>\parindent &amp; \parskip</nodename><nodenext automatic="on">Marginal notes</nodenext><nodeprev automatic="on">\indent &amp; \noindent</nodeprev><nodeup automatic="on">Making paragraphs</nodeup></node>
+<section spaces=" "><sectiontitle><code>\parindent</code> &amp; <code>\parskip</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="495">\parskip</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="372">vertical space before paragraphs</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="503" mergedindex="cp">\parindent</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="504" mergedindex="cp">\parskip</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="470">paragraph indentation</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="471">vertical space before paragraphs</indexterm></cindex>
-<para><code>\parskip</code> is a rubber length defining extra vertical space added
-before each paragraph. The default is <code>0pt plus1pt</code>.
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\setlength&lbrace;\parskip&rbrace;&lbrace;<var>horizontal len</var>&rbrace;
+\setlength&lbrace;\parinden&rbrace;&lbrace;<var>vertical len</var>&rbrace;
+</pre></example>
+
+<para>Both are a rubber lengths (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). They give the indentation
+of ordinary paragraphs, not paragraphs inside minipages
+(<pxref label="minipage"><xrefnodename>minipage</xrefnodename></pxref>), and the vertical space between paragraphs.
+</para>
+<para>This, put in the preamble,
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\setlength&lbrace;\parindent&rbrace;&lbrace;0em&rbrace;
+\setlength&lbrace;\parskip&rbrace;&lbrace;1ex&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>arranges that the document will have paragraphs that are not indented,
+but instead are vertically separated by about the height of a lowercase
+<samp>x</samp>.
+</para>
+<para>In standard &latex; documents, the default value for <code>\parindent</code>
+in one-column documents is <code>15pt</code> when the default text size is
+<code>10pt</code> , <code>17pt</code> for <code>11pt</code>, and <code>1.5em</code> for
+<code>12pt</code>. In two-column documents it is <code>1em</code>. The default
+value for <code>\parskip</code> in &latex;&textrsquo;s standard document styles is
+<code>0pt plus1pt</code>.
</para>
</section>
-<node name="Marginal-notes" spaces=" "><nodename>Marginal notes</nodename><nodeprev automatic="on">\parskip</nodeprev><nodeup automatic="on">Making paragraphs</nodeup></node>
+<node name="Marginal-notes" spaces=" "><nodename>Marginal notes</nodename><nodeprev automatic="on">\parindent &amp; \parskip</nodeprev><nodeup automatic="on">Making paragraphs</nodeup></node>
<section spaces=" "><sectiontitle>Marginal notes</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="373">marginal notes</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="374">notes in the margin</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="375">remarks in the margin</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="496">\marginpar</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="472">marginal notes</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="473">notes in the margin</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="474">remarks in the margin</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="505" mergedindex="cp">\marginpar</indexterm></findex>
-<para>Synopsis:
+<para>Synopsis, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\marginpar[<var>left</var>]&lbrace;<var>right</var>&rbrace;
+<pre xml:space="preserve">\marginpar&lbrace;<var>right</var>&rbrace;
+\marginpar[<var>left</var>]&lbrace;<var>right</var>&rbrace;
</pre></example>
-<para>The <code>\marginpar</code> command creates a note in the margin. The first
-line of the note will have the same baseline as the line in the text
-where the <code>\marginpar</code> occurs.
+<para>Create a note in the margin. The first line of the note will have the
+same baseline as the line in the text where the <code>\marginpar</code>
+occurs.
</para>
-<para>When you only specify the mandatory argument <var>right</var>, the text
-will be placed
+<para>The margin that &latex; uses for the note depends on the current layout
+(<pxref label="Document-class-options"><xrefnodename>Document class options</xrefnodename></pxref>) and also on <code>\reversemarginpar</code>
+(see below). If you are using one-sided layout (document option
+<code>oneside</code>) then it goes in the right margin. If you are using
+two-sided layout (document option <code>twoside</code>) then it goes in the
+outside margin. If you are in two-column layout (document option
+<code>twocolumn</code>) then it goes in the nearest margin.
</para>
-<itemize commandarg="bullet" spaces=" " endspaces=" "><itemprepend><formattingcommand command="bullet"/></itemprepend>
-<listitem><prepend>&bullet;</prepend>
-<para>in the right margin for one-sided layout (option <code>oneside</code>, see <ref label="Document-class-options"><xrefnodename>Document class options</xrefnodename></ref>);
-</para></listitem><listitem><prepend>&bullet;</prepend>
-<para>in the outside margin for two-sided layout (option <code>twoside</code>, see <ref label="Document-class-options"><xrefnodename>Document class options</xrefnodename></ref>);
-</para></listitem><listitem><prepend>&bullet;</prepend>
-<para>in the nearest margin for two-column layout (option <code>twocolumn</code>, see <ref label="Document-class-options"><xrefnodename>Document class options</xrefnodename></ref>).
-</para></listitem></itemize>
-
-<findex index="fn" spaces=" "><indexterm index="fn" number="497">\reversemarginpar</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="498">\normalmarginpar</indexterm></findex>
-<para>The command <code>\reversemarginpar</code> places subsequent marginal notes
-in the opposite (inside) margin. <code>\normalmarginpar</code> places them
-in the default position.
+<findex index="fn" spaces=" "><indexterm index="fn" number="506" mergedindex="cp">\reversemarginpar</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="507" mergedindex="cp">\normalmarginpar</indexterm></findex>
+<para>If you declare <code>\reversemarginpar</code> then &latex; will place
+subsequent marginal notes in the opposite margin to that given in the
+prior paragraph. Revert that to the default position with
+<code>\normalmarginpar</code>.
</para>
-<para>When you specify both arguments, <var>left</var> is used for the left
-margin, and <var>right</var> is used for the right margin.
+<para>When you specify the optional argument <var>left</var> then it is used for a
+note in the left margin, while the mandatory argument <var>right</var> is
+used for a note in the the right margin.
</para>
-<para>The first word will normally not be hyphenated; you can enable
-hyphenation there by beginning the node with <code>\hspace&lbrace;0pt&rbrace;</code>.
+<para>Normally, a note&textrsquo;s first word will not be hyphenated. You can enable
+hyphenation there by beginning <var>left</var> or <var>right</var> with
+<code>\hspace&lbrace;0pt&rbrace;</code>.
</para>
<para>These parameters affect the formatting of the note:
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="499">\marginparpush</indexterm>\marginparpush</itemformat></item>
-</tableterm><tableitem><para>Minimum vertical space between notes; default <samp>7pt</samp> for
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="508" mergedindex="cp">\marginparpush</indexterm>\marginparpush</itemformat></item>
+</tableterm><tableitem><anchor name="marginal-notes-marginparpush">marginal notes marginparpush</anchor>
+<para>Minimum vertical space between notes; default <samp>7pt</samp> for
<samp>12pt</samp> documents, <samp>5pt</samp> else.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="500">\marginparsep</indexterm>\marginparsep</itemformat></item>
-</tableterm><tableitem><para>Horizontal space between the main text and the note; default
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="509" mergedindex="cp">\marginparsep</indexterm>\marginparsep</itemformat></item>
+</tableterm><tableitem><anchor name="marginal-notes-marginparsep">marginal notes marginparsep</anchor>
+<para>Horizontal space between the main text and the note; default
<samp>11pt</samp> for <samp>10pt</samp> documents, <samp>10pt</samp> else.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="501">\marginparwidth</indexterm>\marginparwidth</itemformat></item>
-</tableterm><tableitem><para>Width of the note itself; default for a one-sided <samp>10pt</samp> document
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="510" mergedindex="cp">\marginparwidth</indexterm>\marginparwidth</itemformat></item>
+</tableterm><tableitem><anchor name="marginal-notes-marginparwidth">marginal notes marginparwidth</anchor>
+<para>Width of the note itself; default for a one-sided <samp>10pt</samp> document
is <samp>90pt</samp>, <samp>83pt</samp> for <samp>11pt</samp>, and <samp>68pt</samp> for
<samp>12pt</samp>; <samp>17pt</samp> more in each case for a two-sided document.
In two column mode, the default is <samp>48pt</samp>.
@@ -8036,78 +10688,143 @@ notes from falling off the bottom of the page.
<node name="Math-formulas" spaces=" "><nodename>Math formulas</nodename><nodenext automatic="on">Modes</nodenext><nodeprev automatic="on">Making paragraphs</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Math formulas</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="376">math formulas</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="377">formulas, math</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="378">math mode, entering</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="502"><r>environment</r>, <code>math</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="503"><code>math</code> <r>environment</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="475">math formulas</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="476">formulas, math</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="477">math mode, entering</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="511" mergedindex="cp"><r>environment</r>, <code>math</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="512" mergedindex="cp"><code>math</code> <r>environment</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="504"><r>environment</r>, <code>displaymath</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="505"><code>displaymath</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="513" mergedindex="cp"><r>environment</r>, <code>displaymath</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="514" mergedindex="cp"><code>displaymath</code> <r>environment</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="506"><r>environment</r>, <code>equation</code></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="507"><code>equation</code> <r>environment</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="515" mergedindex="cp"><r>environment</r>, <code>equation</code></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="516" mergedindex="cp"><code>equation</code> <r>environment</r></indexterm></findex>
-<para>There are three environments that put &latex; in math mode:
+<para>Produce mathematical text by putting &latex; into math mode or display
+math mode (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>). This example shows both.
</para>
-<table commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code">math</itemformat></item>
-</tableterm><tableitem><para>For formulas that appear right in the text.
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">displaymath</itemformat></item>
-</tableterm><tableitem><para>For formulas that appear on their own line.
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">equation</itemformat></item>
-</tableterm><tableitem><para>The same as the displaymath environment except that it adds an equation
-number in the right margin.
-</para></tableitem></tableentry></table>
+<example endspaces=" ">
+<pre xml:space="preserve">The wave equation for \( u \) is
+\begin&lbrace;displaymath&rbrace;
+ \frac&lbrace;\partial^2u&rbrace;&lbrace;\partial t^2&rbrace; = c^2\nabla^2u
+\end&lbrace;displaymath&rbrace;
+where \( \nabla^2 \) is the spatial Laplacian and \( c \) is constant.
+</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="508">\(</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="509">\)</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="510">\[</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="511">\]</indexterm></findex>
-<para>The <code>math</code> environment can be used in both paragraph and LR mode,
-but the <code>displaymath</code> and <code>equation</code> environments can be used
-only in paragraph mode. The <code>math</code> and <code>displaymath</code>
-environments are used so often that they have the following short forms:
+<noindent></noindent>
+<para>Math mode is for inline mathematics. In the above example it is invoked
+by the starting <code>\(</code> and finished by the matching ending <code>\)</code>.
+Display math mode is for displayed equations and here is invoked by the
+<code>displaymath</code> environment. Note that any mathematical text
+whatever, including mathematical text consisting of just one character,
+is handled in math mode.
+</para>
+<para>When in math mode or display math mode, &latex; handles many aspects of
+your input text differently than in other text modes. For example,
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\(...\) <r>instead of</r> \begin&lbrace;math&rbrace;...\end&lbrace;math&rbrace;
-\[...\] <r>instead of</r> \begin&lbrace;displaymath&rbrace;...\end&lbrace;displaymath&rbrace;
+<pre xml:space="preserve">contrast x+y with \( x+y \)
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="512">$</indexterm></findex>
-<para>In fact, the <code>math</code> environment is so common that it has an even
-shorter form:
+<noindent></noindent>
+<para>in math mode the letters are in italics and the spacing around the plus
+sign is different.
+</para>
+<para>There are three ways to make inline formulas, to put &latex; in math
+mode.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">$ ... $ <r>instead of</r> \(...\)
+<pre xml:space="preserve">\( <var>mathematical material</var> \)
+$ <var>mathematical material</var> $
+\begin&lbrace;math&rbrace; <var>mathematical material</var> \end&lbrace;math&rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="513">\boldmath</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="514">\unboldmath</indexterm></findex>
-<para>The <code>\boldmath</code> command changes math letters and symbols to be in
-a bold font. It is used <emph>outside</emph> of math mode. Conversely, the
-<code>\unboldmath</code> command changes math glyphs to be in a normal font;
-it too is used <emph>outside</emph> of math mode.
+<noindent></noindent>
+<para>The first form is preferred and the second is quite common, but the
+third form is rarely used. You can sometimes use one and sometimes
+another, as in <code>\(x\) and $y$</code>. You can use these in paragraph
+mode or in LR mode (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>).
</para>
-<!-- c xx own section? Math fonts? -->
-<findex index="fn" spaces=" "><indexterm index="fn" number="515">\displaystyle</indexterm></findex>
-<para>The <code>\displaystyle</code> declaration forces the size and style of the
-formula to be that of <code>displaymath</code>, e.g., with limits above and
-below summations. For example:
+<para>To make displayed formulas, put &latex; into display math mode with
+either:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">$\displaystyle \sum_&lbrace;n=0&rbrace;^\infty x_n $
+<pre xml:space="preserve">\begin&lbrace;displaymath&rbrace;
+ <var>mathematical material</var>
+\end&lbrace;displaymath&rbrace;
</pre></example>
-<!-- c xx see also \cal, \mathcal -->
+<noindent></noindent>
+<para>or
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;equation&rbrace;
+ <var>mathematical material</var>
+\end&lbrace;equation&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>(<pxref label="displaymath"><xrefnodename>displaymath</xrefnodename></pxref>, <pxref label="equation"><xrefnodename>equation</xrefnodename></pxref>). The only difference is that
+with the <code>equation</code> environment, &latex; puts a formula number
+alongside the formula. The construct <code>\[ <var>math</var> \]</code> is
+equivalent to <code>\begin&lbrace;displaymath&rbrace; <var>math</var>
+\end&lbrace;displaymath&rbrace;</code>. These environments can only be used in paragraph
+mode (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>).
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="517" mergedindex="cp">\displaystyle</indexterm></findex>
+<para>The two mathematics modes are similar, but there are some differences.
+One involves the placement of subscripts and superscripts; in display
+math mode they are further apart and in inline math mode they are closer
+together.
+</para>
+<para>Sometimes you want the display math typographical treatment to happen in
+the inline math mode. For this, the <code>\displaystyle</code> declaration
+forces the size and style of the formula to be that of
+<code>displaymath</code>. Thus <code>\(\displaystyle \sum_&lbrace;n=0&rbrace;^\infty
+x_n\)</code> will have the limits above and below the summation sign, not next
+to it. Another example is that
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;tabular&rbrace;&lbrace;r|cc&rbrace;
+ \textsc&lbrace;Name&rbrace; &amp;\textsc&lbrace;Series&rbrace; &amp;\textsc&lbrace;Sum&rbrace; \\ \hline
+ Arithmetic &amp;\( a+(a+b)+(a+2b)+\cdots+(a+(n-1)b) \)
+ &amp;\( na+(n-1)n\cdot\frac&lbrace;b&rbrace;&lbrace;2&rbrace;\) \\
+ Geometric &amp;\( a+ab+ab^2+\cdots+ab^&lbrace;n-1&rbrace; \)
+ &amp;\(\displaystyle a\cdot\frac&lbrace;1-b^n&rbrace;&lbrace;1-b&rbrace;\) \\
+\end&lbrace;tabular&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>because it has no <code>\displaystyle</code>, the <samp>Arithmetic</samp> line&textrsquo;s
+fraction will be scrunched. But, because of its <code>\displaystyle</code>,
+the <samp>Geometric</samp> line&textrsquo;s fraction will be easy to read, with
+characters the same size as in the rest of the line.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="478"><r>package</r>, <code>amsmath</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="479"><code>amsmath</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="480"><r>package</r>, <code>amsfonts</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="481"><code>amsfonts</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="482"><r>package</r>, <code>mathtools</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="483"><code>mathtools</code> <r>package</r></indexterm></cindex>
+<para>The American Mathematical Society has made freely available a set of
+packages that greatly expand your options for writing mathematics,
+<file>amsmath</file> and <file>amssymb</file> (also be aware of the <file>mathtools</file>
+package that is an extension to, and loads, <file>amsmath</file>). New
+documents that will have mathematical text should use these packages.
+Descriptions of these packages is outside the scope of this document;
+see their documentation on CTAN.
+</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">Subscripts &amp; superscripts</menunode><menudescription><pre xml:space="preserve">Also known as exponent or index.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Math symbols</menunode><menudescription><pre xml:space="preserve">Various mathematical squiggles.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Math functions</menunode><menudescription><pre xml:space="preserve">Math function names like sin and exp.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Math accents</menunode><menudescription><pre xml:space="preserve">Accents in math.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Spacing in math mode</menunode><menudescription><pre xml:space="preserve">Thick, medium, thin and negative spaces.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Over- and Underlining</menunode><menudescription><pre xml:space="preserve">Things over or under formulas.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Spacing in math mode</menunode><menudescription><pre xml:space="preserve">Thick, medium, thin, and negative spaces.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Math miscellany</menunode><menudescription><pre xml:space="preserve">Stuff that doesn&textrsquo;t fit anywhere else.
</pre></menudescription></menuentry></menu>
@@ -8115,450 +10832,501 @@ below summations. For example:
<node name="Subscripts-_0026-superscripts" spaces=" "><nodename>Subscripts &amp; superscripts</nodename><nodenext automatic="on">Math symbols</nodenext><nodeup automatic="on">Math formulas</nodeup></node>
<section spaces=" "><sectiontitle>Subscripts &amp; superscripts</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="379">superscript</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="380">subscript</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="381">exponent</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="516">_</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="517">^</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="484">superscript</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="485">subscript</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="486">exponent</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="518" mergedindex="cp">_</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="519" mergedindex="cp">^</indexterm></findex>
-<para>In math mode, use the caret character&nbsp;<code>^</code> to make the
-<var>exp</var> appear as a superscript: <code>^&lbrace;<var>exp</var>&rbrace;</code>.
-Similarly, in math mode, underscore&nbsp;<code>_&lbrace;<var>exp</var>&rbrace;</code> makes a
-subscript out of <var>exp</var>.
+<para>Synopsis (in math mode or display math mode), one of:
</para>
-<para>In this example the <code>0</code> and <code>1</code> appear as subscripts while the
-<code>2</code> is a superscript.
+<example endspaces=" ">
+<pre xml:space="preserve"><var>base</var>^<var>exp</var>
+<var>base</var>^&lbrace;<var>exp</var>&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>or, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\( (x_0+x_1)^2 \)
+<pre xml:space="preserve"><var>base</var>_<var>exp</var>
+<var>base</var>_&lbrace;<var>exp</var>&rbrace;
</pre></example>
-<para>To have more than one character in <var>exp</var> use curly braces as in
-<code>e^&lbrace;-2x&rbrace;</code>.
+<para>Make <var>exp</var> appear as a superscript of <var>base</var> (with the caret
+character,&nbsp;<code>^</code>) or a subscript (with
+underscore,&nbsp;<code>_</code>).
+</para>
+<para>In this example the <code>0</code>&textrsquo;s and <code>1</code>&textrsquo;s are subscripts while the
+<code>2</code>&textrsquo;s are superscripts.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\( (x_0+x_1)^2 \leq (x_0)^2+(x_1)^2 \)
+</pre></example>
+
+<para>To have the subscript or superscript contain more than one character,
+surround the expression with curly braces, as in <code>e^&lbrace;-2x&rbrace;</code>.
+This example&textrsquo;s fourth line shows curly braces used to group an expression
+for the exponent.
</para>
-<para>&latex; handles superscripts on superscripts, and all of that stuff, in
-the natural way, so expressions such as <code>e^&lbrace;x^2&rbrace;</code> and
-<code>x_&lbrace;a_0&rbrace;</code> will look right. It also does the right thing when
-something has both a subscript and a superscript. In this example the
-<code>0</code> appears at the bottom of the integral sign while the <code>10</code>
-appears at the top.
-</para>
<example endspaces=" ">
-<pre xml:space="preserve">\int_0^&lbrace;10&rbrace; x^2 \,dx
+<pre xml:space="preserve">\begin&lbrace;displaymath&rbrace;
+ (3^3)^3=27^3=19\,683
+ \qquad
+ 3^&lbrace;(3^3)&rbrace;=3^&lbrace;27&rbrace;=7\,625\,597\,484\,987
+\end&lbrace;displaymath&rbrace;
+</pre></example>
+
+<para>&latex; knows how to handle a superscript on a superscript, or a
+subscript on a subscript, or supers on subs, or subs on supers. So,
+expressions such as <code>e^&lbrace;x^2&rbrace;</code> and <code>x_&lbrace;i_0&rbrace;</code> give correct
+output. Note the use in those expressions of curly braces to give the
+<var>base</var> a determined <var>exp</var>. If you enter <code>\(3^3^3\)</code> then
+you get <samp>Double superscript</samp>.
+</para>
+<para>&latex; does the right thing when something has both a subscript and a
+superscript. In this example the integral has both. They come out in
+the correct place without any author intervention.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;displaymath&rbrace;
+ \int_&lbrace;x=a&rbrace;^b f'(x)\,dx = f(b)-f(a)
+\end&lbrace;displaymath&rbrace;
</pre></example>
-<para>You can put a superscript or subscript before a symbol with a construct
-such as <code>&lbrace;&rbrace;_t K^2</code> in math mode (the initial <code>&lbrace;&rbrace;</code> prevents
-the prefixed subscript from being attached to any prior symbols in the
-expression).
+<noindent></noindent>
+<para>Note the parentheses around <code>x=a</code> to make the entire expression a
+subscript.
+</para>
+<para>To put a superscript or subscript before a symbol, use a construct like
+<code>&lbrace;&rbrace;_t K^2</code>. The empty curly braces <code>&lbrace;&rbrace;</code> give the
+subscript something to attach to and keeps it from accidentally
+attaching to a prior symbols.
+</para>
+<para>Using the subscript or superscript command outside of math mode or
+display math mode, as in <code>the expression x^2</code>, will get you
+the error <samp>Missing $ inserted</samp>.
</para>
-<para>Outside of math mode, a construct like <code>A
-test$_\textnormal&lbrace;subscript&rbrace;$</code> will produce a subscript typeset in
-text mode, not math mode. Note that there are packages specialized for
-writing Chemical formulas such as <file>mhchem</file>.
-<!-- c xx display mode -->
+<cindex index="cp" spaces=" "><indexterm index="cp" number="487"><r>package</r>, <code>mhchem</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="488"><code>mhchem</code> <r>package</r></indexterm></cindex>
+
+<para>A common reason to want subscripts outside of a mathematics mode is to
+typeset chemical formulas. There are packages for that such as
+<file>mhchem</file>; see CTAN.
</para>
</section>
<node name="Math-symbols" spaces=" "><nodename>Math symbols</nodename><nodenext automatic="on">Math functions</nodenext><nodeprev automatic="on">Subscripts &amp; superscripts</nodeprev><nodeup automatic="on">Math formulas</nodeup></node>
<section spaces=" "><sectiontitle>Math symbols</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="382">math symbols</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="383">symbols, math</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="384">greek letters</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="489">math symbols</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="490">symbols, math</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="491">greek letters</indexterm></cindex>
-<para>&latex; provides almost any mathematical symbol you&textrsquo;re likely to need.
-For example, if you include <code>$\pi$</code> in your source, you will get
-the pi symbol <U>03C0</U>.
-</para>
-<para>Below is a list of commonly-available symbols. It is by no means an
-exhaustive list. Each symbol here is described with a short phrase, and
-its symbol class (which determines the spacing around it) is given in
-parenthesis. Unless said otherwise, the commands for these symbols can
-be used only in math mode.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="492"><r>package</r>, <code>symbols</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="493"><code>symbols</code> <r>package</r></indexterm></cindex>
+
+
+<para>&latex; provides almost any mathematical or technical symbol that
+anyone uses. For example, if you include <code>$\pi$</code> in your source,
+you will get the pi symbol <U>03C0</U>. See the <file>Comprehensive
+&latex; Symbol List</file> at
+<url><urefurl>https://ctan.org/tex-archive/info/symbols/comprehensive/</urefurl></url>.
</para>
-<para>To redefine a command so that it can be used whatever the current mode,
-see <ref label="_005censuremath"><xrefnodename>\ensuremath</xrefnodename></ref>.
+<para>Here is a list of commonly-used symbols. It is by no means exhaustive.
+Each symbol is described with a short phrase, and its symbol class,
+which determines the spacing around it, is given in parenthesis. Unless
+said otherwise, the commands for these symbols can be used only in math
+mode. To redefine a command so that it can be used whatever the current
+mode, see <ref label="_005censuremath"><xrefnodename>\ensuremath</xrefnodename></ref>.
</para>
-
<!-- c xx Add Negation: @code{} for negations of relevant symbols -->
<!-- c Useful: http://www.w3.org/TR/WD-math-970515/section6.html -->
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="518">\|</indexterm>\|</itemformat></item>
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="520" mergedindex="cp">\|</indexterm>\|</itemformat></item>
</tableterm><tableitem><para><U>2225</U> Parallel (relation). Synonym:&nbsp;<code>\parallel</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="519">\aleph</indexterm>\aleph</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="521" mergedindex="cp">\aleph</indexterm>\aleph</itemformat></item>
</tableterm><tableitem><para><U>2135</U> Aleph, transfinite cardinal (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="520">\alpha</indexterm>\alpha</itemformat></item>
-</tableterm><tableitem><para><U>03B1</U> Lower case Greek letter alpha (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="522" mergedindex="cp">\alpha</indexterm>\alpha</itemformat></item>
+</tableterm><tableitem><para><U>03B1</U> Lowercase Greek letter alpha (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="521">\amalg</indexterm>\amalg</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="523" mergedindex="cp">\amalg</indexterm>\amalg</itemformat></item>
</tableterm><tableitem><para><U>2A3F</U> Disjoint union (binary)
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="522">\angle</indexterm>\angle</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="524" mergedindex="cp">\angle</indexterm>\angle</itemformat></item>
</tableterm><tableitem><para><U>2220</U> Geometric angle (ordinary). Similar: less-than
sign&nbsp;<code>&lt;</code> and angle bracket&nbsp;<code>\langle</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="523">\approx</indexterm>\approx</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="525" mergedindex="cp">\approx</indexterm>\approx</itemformat></item>
</tableterm><tableitem><para><U>2248</U> Almost equal to (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="524">\ast</indexterm>\ast</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="526" mergedindex="cp">\ast</indexterm>\ast</itemformat></item>
</tableterm><tableitem><para><U>2217</U> Asterisk operator, convolution, six-pointed
(binary). Synonym:&nbsp;<code>*</code>, which is often a superscript or
subscript, as in the Kleene star. Similar:&nbsp;<code>\star</code>, which is
five-pointed, and is sometimes used as a general binary operation, and
sometimes reserved for cross-correlation.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="525">\asymp</indexterm>\asymp</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="527" mergedindex="cp">\asymp</indexterm>\asymp</itemformat></item>
</tableterm><tableitem><para><U>224D</U> Asymptotically equivalent (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="526">\backslash</indexterm>\backslash</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="528" mergedindex="cp">\backslash</indexterm>\backslash</itemformat></item>
</tableterm><tableitem><para>\ Backslash (ordinary). Similar: set minus&nbsp;<code>\setminus</code>, and
<code>\textbackslash</code> for backslash outside of math mode.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="527">\beta</indexterm>\beta</itemformat></item>
-</tableterm><tableitem><para><U>03B2</U> Lower case Greek letter beta (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="529" mergedindex="cp">\beta</indexterm>\beta</itemformat></item>
+</tableterm><tableitem><para><U>03B2</U> Lowercase Greek letter beta (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="528">\bigcap</indexterm>\bigcap</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="530" mergedindex="cp">\bigcap</indexterm>\bigcap</itemformat></item>
</tableterm><tableitem><para><U>22C2</U> Variable-sized, or n-ary, intersection (operator). Similar:
binary intersection&nbsp;<code>\cap</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="529">\bigcirc</indexterm>\bigcirc</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="531" mergedindex="cp">\bigcirc</indexterm>\bigcirc</itemformat></item>
</tableterm><tableitem><para><U>26AA</U> Circle, larger (binary). Similar: function
composition&nbsp;<code>\circ</code>.
<!-- c bb Best unicode symbol for this? -->
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="530">\bigcup</indexterm>\bigcup</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="532" mergedindex="cp">\bigcup</indexterm>\bigcup</itemformat></item>
</tableterm><tableitem><para><U>22C3</U> Variable-sized, or n-ary, union (operator). Similar: binary
union&nbsp;<code>\cup</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="531">\bigodot</indexterm>\bigodot</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="533" mergedindex="cp">\bigodot</indexterm>\bigodot</itemformat></item>
</tableterm><tableitem><para><U>2A00</U> Variable-sized, or n-ary, circled dot operator (operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="532">\bigoplus</indexterm>\bigoplus</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="534" mergedindex="cp">\bigoplus</indexterm>\bigoplus</itemformat></item>
</tableterm><tableitem><para><U>2A01</U> Variable-sized, or n-ary, circled plus operator (operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="533">\bigotimes</indexterm>\bigotimes</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="535" mergedindex="cp">\bigotimes</indexterm>\bigotimes</itemformat></item>
</tableterm><tableitem><para><U>2A02</U> Variable-sized, or n-ary, circled times operator (operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="534">\bigtriangledown</indexterm>\bigtriangledown</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="536" mergedindex="cp">\bigtriangledown</indexterm>\bigtriangledown</itemformat></item>
</tableterm><tableitem><para><U>25BD</U> Variable-sized, or n-ary, open triangle pointing down
(operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="535">\bigtriangleup</indexterm>\bigtriangleup</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="537" mergedindex="cp">\bigtriangleup</indexterm>\bigtriangleup</itemformat></item>
</tableterm><tableitem><para><U>25B3</U> Variable-sized, or n-ary, open triangle pointing up (operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="536">\bigsqcup</indexterm>\bigsqcup</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="538" mergedindex="cp">\bigsqcup</indexterm>\bigsqcup</itemformat></item>
</tableterm><tableitem><para><U>2A06</U> Variable-sized, or n-ary, square union (operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="537">\biguplus</indexterm>\biguplus</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="539" mergedindex="cp">\biguplus</indexterm>\biguplus</itemformat></item>
</tableterm><tableitem><para><U>2A04</U> Variable-sized, or n-ary, union operator with a plus
(operator). (Note that the name has only one p.)
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="538">\bigvee</indexterm>\bigvee</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="540" mergedindex="cp">\bigvee</indexterm>\bigvee</itemformat></item>
</tableterm><tableitem><para><U>22C1</U> Variable-sized, or n-ary, logical-and (operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="539">\bigwedge</indexterm>\bigwedge</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="541" mergedindex="cp">\bigwedge</indexterm>\bigwedge</itemformat></item>
</tableterm><tableitem><para><U>22C0</U> Variable-sized, or n-ary, logical-or (operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="540">\bot</indexterm>\bot</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="542" mergedindex="cp">\bot</indexterm>\bot</itemformat></item>
</tableterm><tableitem><para><U>22A5</U> Up tack, bottom, least element of a partially ordered
set, or a contradiction (ordinary). See also&nbsp;<code>\top</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="541">\bowtie</indexterm>\bowtie</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="543" mergedindex="cp">\bowtie</indexterm>\bowtie</itemformat></item>
</tableterm><tableitem><para><U>22C8</U> Natural join of two relations (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="542">\Box</indexterm>\Box</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="544" mergedindex="cp">\Box</indexterm>\Box</itemformat></item>
</tableterm><tableitem><para><U>25A1</U> Modal operator for necessity; square open box
(ordinary). Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package.
<!-- c bb Best Unicode equivalent? -->
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="543">\bullet</indexterm>\bullet</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="385">bullet symbol</indexterm></cindex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="545" mergedindex="cp">\bullet</indexterm>\bullet</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="494">bullet symbol</indexterm></cindex>
<para><U>2022</U> Bullet (binary). Similar: multiplication
dot&nbsp;<code>\cdot</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="544">\cap</indexterm>\cap</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="546" mergedindex="cp">\cap</indexterm>\cap</itemformat></item>
</tableterm><tableitem><para><U>2229</U> Intersection of two sets (binary). Similar: variable-sized
operator&nbsp;<code>\bigcap</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="545">\cdot</indexterm>\cdot</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="547" mergedindex="cp">\cdot</indexterm>\cdot</itemformat></item>
</tableterm><tableitem><para><U>22C5</U> Multiplication (binary). Similar: Bullet
dot&nbsp;<code>\bullet</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="546">\chi</indexterm>\chi</itemformat></item>
-</tableterm><tableitem><para><U>03C7</U> Lower case Greek chi (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="548" mergedindex="cp">\chi</indexterm>\chi</itemformat></item>
+</tableterm><tableitem><para><U>03C7</U> Lowercase Greek chi (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="547">\circ</indexterm>\circ</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="549" mergedindex="cp">\circ</indexterm>\circ</itemformat></item>
</tableterm><tableitem><para><U>2218</U> Function composition, ring operator (binary). Similar:
variable-sized operator&nbsp;<code>\bigcirc</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="548">\clubsuit</indexterm>\clubsuit</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="550" mergedindex="cp">\clubsuit</indexterm>\clubsuit</itemformat></item>
</tableterm><tableitem><para><U>2663</U> Club card suit (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="549">\complement</indexterm>\complement</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="551" mergedindex="cp">\complement</indexterm>\complement</itemformat></item>
</tableterm><tableitem><para><U>2201</U> Set complement, used as a superscript as in
-<code>$S^\complement$</code> (ordinary). Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package. Also
-used: <code>$S^&lbrace;\mathsf&lbrace;c&rbrace;&rbrace;$</code> or&nbsp;<code>$\bar&lbrace;S&rbrace;$</code>.
+<code>$S^\complement$</code> (ordinary). Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package. Also used:
+<code>$S^&lbrace;\mathsf&lbrace;c&rbrace;&rbrace;$</code> or&nbsp;<code>$\bar&lbrace;S&rbrace;$</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="550">\cong</indexterm>\cong</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="552" mergedindex="cp">\cong</indexterm>\cong</itemformat></item>
</tableterm><tableitem><para><U>2245</U> Congruent (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="551">\coprod</indexterm>\coprod</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="553" mergedindex="cp">\coprod</indexterm>\coprod</itemformat></item>
</tableterm><tableitem><para><U>2210</U> Coproduct (operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="552">\cup</indexterm>\cup</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="554" mergedindex="cp">\cup</indexterm>\cup</itemformat></item>
</tableterm><tableitem><para><U>222A</U> Union of two sets (binary). Similar: variable-sized
operator&nbsp;<code>\bigcup</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="553">\dagger</indexterm>\dagger</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="555" mergedindex="cp">\dagger</indexterm>\dagger</itemformat></item>
</tableterm><tableitem><para><U>2020</U> Dagger relation (binary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="554">\dashv</indexterm>\dashv</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="556" mergedindex="cp">\dashv</indexterm>\dashv</itemformat></item>
</tableterm><tableitem><para><U>22A3</U> Dash with vertical, reversed turnstile (relation). Similar:
turnstile&nbsp;<code>\vdash</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="555">\ddagger</indexterm>\ddagger</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="557" mergedindex="cp">\ddagger</indexterm>\ddagger</itemformat></item>
</tableterm><tableitem><para><U>2021</U> Double dagger relation (binary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="556">\Delta</indexterm>\Delta</itemformat></item>
-</tableterm><tableitem><para><U>0394</U> Greek upper case delta, used for increment (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="558" mergedindex="cp">\Delta</indexterm>\Delta</itemformat></item>
+</tableterm><tableitem><para><U>0394</U> Greek uppercase delta, used for increment (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="557">\delta</indexterm>\delta</itemformat></item>
-</tableterm><tableitem><para><U>03B4</U> Greek lower case delta (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="559" mergedindex="cp">\delta</indexterm>\delta</itemformat></item>
+</tableterm><tableitem><para><U>03B4</U> Greek lowercase delta (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="558">\Diamond</indexterm>\Diamond</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="560" mergedindex="cp">\Diamond</indexterm>\Diamond</itemformat></item>
</tableterm><tableitem><para><U>25C7</U> Large diamond operator (ordinary). Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package.
-<!-- c bb Best Unicode equivalent? -->
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="559">\diamond</indexterm>\diamond</itemformat></item>
-</tableterm><tableitem><para><U>22C4</U> Diamond operator, or diamond bullet (binary). Similar: large
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="561" mergedindex="cp">\diamond</indexterm>\diamond</itemformat></item>
+</tableterm><tableitem><para><U>22C4</U> Diamond operator (binary). Similar: large
diamond&nbsp;<code>\Diamond</code>, circle bullet&nbsp;<code>\bullet</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="560">\diamondsuit</indexterm>\diamondsuit</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="562" mergedindex="cp">\diamondsuit</indexterm>\diamondsuit</itemformat></item>
</tableterm><tableitem><para><U>2662</U> Diamond card suit (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="561">\div</indexterm>\div</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="563" mergedindex="cp">\div</indexterm>\div</itemformat></item>
</tableterm><tableitem><para><U>00F7</U> Division sign (binary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="562">\doteq</indexterm>\doteq</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="564" mergedindex="cp">\doteq</indexterm>\doteq</itemformat></item>
</tableterm><tableitem><para><U>2250</U> Approaches the limit (relation). Similar: geometrically equal
to&nbsp;<code>\Doteq</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="563">\downarrow</indexterm>\downarrow</itemformat></item>
-</tableterm><tableitem><para><U>2193</U> Down arrow, converges (relation). Similar: double line down
-arrow&nbsp;<code>\Downarrow</code>.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="565" mergedindex="cp">\downarrow</indexterm>\downarrow</itemformat></item>
+</tableterm><tableitem><para><U>2193</U> Down arrow, converges (relation). Similar:
+<code>\Downarrow</code> double line down arrow.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="564">\Downarrow</indexterm>\Downarrow</itemformat></item>
-</tableterm><tableitem><para><U>21D3</U> Double line down arrow (relation). Similar: single line down
-arrow&nbsp;<code>\downarrow</code>.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="566" mergedindex="cp">\Downarrow</indexterm>\Downarrow</itemformat></item>
+</tableterm><tableitem><para><U>21D3</U> Double line down arrow (relation). Similar:
+<code>\downarrow</code> single line down arrow.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="565">\ell</indexterm>\ell</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="567" mergedindex="cp">\ell</indexterm>\ell</itemformat></item>
</tableterm><tableitem><para><U>2113</U> Lowercase cursive letter l (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="566">\emptyset</indexterm>\emptyset</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="568" mergedindex="cp">\emptyset</indexterm>\emptyset</itemformat></item>
</tableterm><tableitem><para><U>2205</U> Empty set symbol (ordinary). The variant form is
<code>\varnothing</code>.
<!-- c bb Why Unicode has \revemptyset but no \emptyset? -->
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="567">\epsilon</indexterm>\epsilon</itemformat></item>
-</tableterm><tableitem><para><U>03F5</U> Lower case lunate epsilon (ordinary). Similar to
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="569" mergedindex="cp">\epsilon</indexterm>\epsilon</itemformat></item>
+</tableterm><tableitem><para><U>03F5</U> Lowercase lunate epsilon (ordinary). Similar to
Greek text letter. More widely used in mathematics is the script small
letter epsilon <code>\varepsilon</code>&nbsp;<U>03B5</U>. Related:
the set membership relation <code>\in</code>&nbsp;<U>2208</U>.
<!-- c src: David Carlisle http://tex.stackexchange.com/a/98018/339 and -->
<!-- c Unicode referenced there asserts varepsilon is much more widely used. -->
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="568">\equiv</indexterm>\equiv</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="570" mergedindex="cp">\equiv</indexterm>\equiv</itemformat></item>
</tableterm><tableitem><para><U>2261</U> Equivalence (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="569">\eta</indexterm>\eta</itemformat></item>
-</tableterm><tableitem><para><U>03B7</U> Lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="571" mergedindex="cp">\eta</indexterm>\eta</itemformat></item>
+</tableterm><tableitem><para><U>03B7</U> Lowercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="570">\exists</indexterm>\exists</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="572" mergedindex="cp">\exists</indexterm>\exists</itemformat></item>
</tableterm><tableitem><para><U>2203</U> Existential quantifier (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="571">\flat</indexterm>\flat</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="573" mergedindex="cp">\flat</indexterm>\flat</itemformat></item>
</tableterm><tableitem><para><U>266D</U> Musical flat (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="572">\forall</indexterm>\forall</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="574" mergedindex="cp">\forall</indexterm>\forall</itemformat></item>
</tableterm><tableitem><para><U>2200</U> Universal quantifier (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="573">\frown</indexterm>\frown</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="575" mergedindex="cp">\frown</indexterm>\frown</itemformat></item>
</tableterm><tableitem><para><U>2322</U> Downward curving arc (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="574">\Gamma</indexterm>\Gamma</itemformat></item>
-</tableterm><tableitem><para><U>0393</U> Upper case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="576" mergedindex="cp">\Gamma</indexterm>\Gamma</itemformat></item>
+</tableterm><tableitem><para><U>0393</U> uppercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="575">\gamma</indexterm>\gamma</itemformat></item>
-</tableterm><tableitem><para><U>03B3</U> Lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="577" mergedindex="cp">\gamma</indexterm>\gamma</itemformat></item>
+</tableterm><tableitem><para><U>03B3</U> Lowercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="576">\ge</indexterm>\ge</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="578" mergedindex="cp">\ge</indexterm>\ge</itemformat></item>
</tableterm><tableitem><para><U>2265</U> Greater than or equal to (relation). This is a synonym
for&nbsp;<code>\geq</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="577">\geq</indexterm>\geq</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="579" mergedindex="cp">\geq</indexterm>\geq</itemformat></item>
</tableterm><tableitem><para><U>2265</U> Greater than or equal to (relation). This is a synonym
for&nbsp;<code>\ge</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="578">\gets</indexterm>\gets</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="580" mergedindex="cp">\gets</indexterm>\gets</itemformat></item>
</tableterm><tableitem><para><U>2190</U> Is assigned the value (relation).
Synonym:&nbsp;<code>\leftarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="579">\gg</indexterm>\gg</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="581" mergedindex="cp">\gg</indexterm>\gg</itemformat></item>
</tableterm><tableitem><para><U>226B</U> Much greater than (relation). Similar: much less
than&nbsp;<code>\ll</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="580">\hbar</indexterm>\hbar</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="582" mergedindex="cp">\hbar</indexterm>\hbar</itemformat></item>
</tableterm><tableitem><para><U>210F</U> Planck constant over two pi (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="581">\heartsuit</indexterm>\heartsuit</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="583" mergedindex="cp">\heartsuit</indexterm>\heartsuit</itemformat></item>
</tableterm><tableitem><para><U>2661</U> Heart card suit (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="582">\hookleftarrow</indexterm>\hookleftarrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="584" mergedindex="cp">\hookleftarrow</indexterm>\hookleftarrow</itemformat></item>
</tableterm><tableitem><para><U>21A9</U> Hooked left arrow (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="583">\hookrightarrow</indexterm>\hookrightarrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="585" mergedindex="cp">\hookrightarrow</indexterm>\hookrightarrow</itemformat></item>
</tableterm><tableitem><para><U>21AA</U> Hooked right arrow (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="584">\iff</indexterm>\iff</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="586" mergedindex="cp">\iff</indexterm>\iff</itemformat></item>
</tableterm><tableitem><para><U>27F7</U> If and only if (relation). It is <code>\Longleftrightarrow</code>
with a <code>\thickmuskip</code> on either side.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="585">\Im</indexterm>\Im</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="587" mergedindex="cp">\Im</indexterm>\Im</itemformat></item>
</tableterm><tableitem><para><U>2111</U> Imaginary part (ordinary). See: real part&nbsp;<code>\Re</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="586">\in</indexterm>\in</itemformat></item>
-</tableterm><tableitem><para><U>2208</U> Set element (relation). See also: lower case lunate
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="588" mergedindex="cp">\imath</indexterm>\imath</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="495">dotless i, math</indexterm></cindex>
+<para>Dotless i; used when you are putting an accent on an i (<pxref label="Math-accents"><xrefnodename>Math
+accents</xrefnodename></pxref>).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="589" mergedindex="cp">\in</indexterm>\in</itemformat></item>
+</tableterm><tableitem><para><U>2208</U> Set element (relation). See also: lowercase lunate
epsilon&nbsp;<code>\epsilon</code><U>03F5</U> and small letter script
epsilon&nbsp;<code>\varepsilon</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="587">\infty</indexterm>\infty</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="590" mergedindex="cp">\infty</indexterm>\infty</itemformat></item>
</tableterm><tableitem><para><U>221E</U> Infinity (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="588">\int</indexterm>\int</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="591" mergedindex="cp">\int</indexterm>\int</itemformat></item>
</tableterm><tableitem><para><U>222B</U> Integral (operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="589">\iota</indexterm>\iota</itemformat></item>
-</tableterm><tableitem><para><U>03B9</U> Lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="592" mergedindex="cp">\iota</indexterm>\iota</itemformat></item>
+</tableterm><tableitem><para><U>03B9</U> Lowercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="590">\Join</indexterm>\Join</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="593" mergedindex="cp">\Join</indexterm>\Join</itemformat></item>
</tableterm><tableitem><para><U>2A1D</U> Condensed bowtie symbol (relation). Not available in Plain
&tex;.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="591">\kappa</indexterm>\kappa</itemformat></item>
-</tableterm><tableitem><para><U>03BA</U> Lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="594" mergedindex="cp">\jmath</indexterm>\jmath</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="496">dotless j, math</indexterm></cindex>
+<para>Dotless j; used when you are putting an accent on a j (<pxref label="Math-accents"><xrefnodename>Math
+accents</xrefnodename></pxref>).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="595" mergedindex="cp">\kappa</indexterm>\kappa</itemformat></item>
+</tableterm><tableitem><para><U>03BA</U> Lowercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="592">\Lambda</indexterm>\Lambda</itemformat></item>
-</tableterm><tableitem><para><U>039B</U> Upper case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="596" mergedindex="cp">\Lambda</indexterm>\Lambda</itemformat></item>
+</tableterm><tableitem><para><U>039B</U> uppercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="593">\lambda</indexterm>\lambda</itemformat></item>
-</tableterm><tableitem><para><U>03BB</U> Lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="597" mergedindex="cp">\lambda</indexterm>\lambda</itemformat></item>
+</tableterm><tableitem><para><U>03BB</U> Lowercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="594">\land</indexterm>\land</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="598" mergedindex="cp">\land</indexterm>\land</itemformat></item>
</tableterm><tableitem><para><U>2227</U> Logical and (binary). This is a synonym for <code>\wedge</code>.
See also logical or&nbsp;<code>\lor</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="595">\langle</indexterm>\langle</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="599" mergedindex="cp">\langle</indexterm>\langle</itemformat></item>
</tableterm><tableitem><para><U>27E8</U> Left angle, or sequence, bracket (opening). Similar:
less-than&nbsp;<code>&lt;</code>. Matches&nbsp;<code>\rangle</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="596">\lbrace</indexterm>\lbrace</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="600" mergedindex="cp">\lbrace</indexterm>\lbrace</itemformat></item>
</tableterm><tableitem><para><U>007B</U> Left curly brace
(opening). Synonym:&nbsp;<code>\&lbrace;</code>. Matches&nbsp;<code>\rbrace</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="597">\lbrack</indexterm>\lbrack</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="601" mergedindex="cp">\lbrack</indexterm>\lbrack</itemformat></item>
</tableterm><tableitem><para><U>005B</U> Left square bracket (opening).
Synonym:&nbsp;<code>[</code>. Matches&nbsp;<code>\rbrack</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="598">\lceil</indexterm>\lceil</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="602" mergedindex="cp">\lceil</indexterm>\lceil</itemformat></item>
</tableterm><tableitem><para><U>2308</U> Left ceiling bracket, like a square bracket but with the bottom
shaved off (opening). Matches&nbsp;<code>\rceil</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="599">\le</indexterm>\le</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="603" mergedindex="cp">\le</indexterm>\le</itemformat></item>
</tableterm><tableitem><para><U>2264</U> Less than or equal to (relation). This is a synonym
for&nbsp;<code>\leq</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="600">\leadsto</indexterm>\leadsto</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="604" mergedindex="cp">\leadsto</indexterm>\leadsto</itemformat></item>
</tableterm><tableitem><para><U>21DD</U> Squiggly right arrow (relation). Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package.
To get this symbol outside of math mode you can put
<code>\newcommand*&lbrace;\Leadsto&rbrace;&lbrace;\ensuremath&lbrace;\leadsto&rbrace;&rbrace;</code> in the
preamble and then use <code>\Leadsto</code> instead.
<!-- c bb Best Unicode equivalent? -->
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="601">\Leftarrow</indexterm>\Leftarrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="605" mergedindex="cp">\Leftarrow</indexterm>\Leftarrow</itemformat></item>
</tableterm><tableitem><para><U>21D0</U> Is implied by, double-line left arrow (relation). Similar:
single-line left arrow&nbsp;<code>\leftarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="602">\leftarrow</indexterm>\leftarrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="606" mergedindex="cp">\leftarrow</indexterm>\leftarrow</itemformat></item>
</tableterm><tableitem><para><U>2190</U> Single-line left arrow (relation).
Synonym:&nbsp;<code>\gets</code>. Similar: double-line left
arrow&nbsp;<code>\Leftarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="603">\leftharpoondown</indexterm>\leftharpoondown</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="607" mergedindex="cp">\leftharpoondown</indexterm>\leftharpoondown</itemformat></item>
</tableterm><tableitem><para><U>21BD</U> Single-line left harpoon, barb under bar (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="604">\leftharpoonup</indexterm>\leftharpoonup</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="608" mergedindex="cp">\leftharpoonup</indexterm>\leftharpoonup</itemformat></item>
</tableterm><tableitem><para><U>21BC</U> Single-line left harpoon, barb over bar (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="605">\Leftrightarrow</indexterm>\Leftrightarrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="609" mergedindex="cp">\Leftrightarrow</indexterm>\Leftrightarrow</itemformat></item>
</tableterm><tableitem><para><U>21D4</U> Bi-implication; double-line double-headed arrow (relation).
Similar: single-line double headed arrow&nbsp;<code>\leftrightarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="606">\leftrightarrow</indexterm>\leftrightarrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="610" mergedindex="cp">\leftrightarrow</indexterm>\leftrightarrow</itemformat></item>
</tableterm><tableitem><para><U>2194</U> Single-line double-headed arrow (relation). Similar:
double-line double headed arrow&nbsp;<code>\Leftrightarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="607">\leq</indexterm>\leq</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="611" mergedindex="cp">\leq</indexterm>\leq</itemformat></item>
</tableterm><tableitem><para><U>2264</U> Less than or equal to (relation). This is a synonym
for&nbsp;<code>\le</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="608">\lfloor</indexterm>\lfloor</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="612" mergedindex="cp">\lfloor</indexterm>\lfloor</itemformat></item>
</tableterm><tableitem><para><U>230A</U> Left floor bracket (opening). Matches:&nbsp;<code>\floor</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="609">\lhd</indexterm>\lhd</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="613" mergedindex="cp">\lhd</indexterm>\lhd</itemformat></item>
</tableterm><tableitem><para><U>25C1</U> Arrowhead, that is, triangle, pointing left (binary).
Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package. For the normal subgroup symbol you should load
<file>amssymb</file> and use&nbsp;<code>\vartriangleleft</code> (which is a relation
and so gives better spacing).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="610">\ll</indexterm>\ll</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="614" mergedindex="cp">\ll</indexterm>\ll</itemformat></item>
</tableterm><tableitem><para><U>226A</U> Much less than (relation). Similar: much greater
than&nbsp;<code>\gg</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="611">\lnot</indexterm>\lnot</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="615" mergedindex="cp">\lnot</indexterm>\lnot</itemformat></item>
</tableterm><tableitem><para><U>00AC</U> Logical negation (ordinary). Synonym:&nbsp;<code>\neg</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="612">\longleftarrow</indexterm>\longleftarrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="616" mergedindex="cp">\longleftarrow</indexterm>\longleftarrow</itemformat></item>
</tableterm><tableitem><para><U>27F5</U> Long single-line left arrow (relation). Similar: long
double-line left arrow&nbsp;<code>\Longleftarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="613">\longleftrightarrow</indexterm>\longleftrightarrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="617" mergedindex="cp">\longleftrightarrow</indexterm>\longleftrightarrow</itemformat></item>
</tableterm><tableitem><para><U>27F7</U> Long single-line double-headed arrow (relation). Similar: long
double-line double-headed arrow&nbsp;<code>\Longleftrightarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="614">\longmapsto</indexterm>\longmapsto</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="618" mergedindex="cp">\longmapsto</indexterm>\longmapsto</itemformat></item>
</tableterm><tableitem><para><U>27FC</U> Long single-line left arrow starting with vertical bar
(relation). Similar: shorter version&nbsp;<code>\mapsto</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="615">\longrightarrow</indexterm>\longrightarrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="619" mergedindex="cp">\longrightarrow</indexterm>\longrightarrow</itemformat></item>
</tableterm><tableitem><para><U>27F6</U> Long single-line right arrow (relation). Similar: long
double-line right arrow&nbsp;<code>\Longrightarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="616">\lor</indexterm>\lor</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="620" mergedindex="cp">\lor</indexterm>\lor</itemformat></item>
</tableterm><tableitem><para><U>2228</U> Logical or (binary). Synonym: wedge&nbsp;<code>\wedge</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="617">\mapsto</indexterm>\mapsto</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="621" mergedindex="cp">\mapsto</indexterm>\mapsto</itemformat></item>
</tableterm><tableitem><para><U>21A6</U> Single-line left arrow starting with vertical bar (relation).
Similar: longer version&nbsp;<code>\longmapsto</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="618">\mho</indexterm>\mho</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="622" mergedindex="cp">\mho</indexterm>\mho</itemformat></item>
</tableterm><tableitem><para><U>2127</U> Conductance, half-circle rotated capital omega (ordinary).
Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="619">\mid</indexterm>\mid</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="623" mergedindex="cp">\mid</indexterm>\mid</itemformat></item>
</tableterm><tableitem><para><U>2223</U> Single-line vertical bar (relation). A typical use of
<code>\mid</code> is for a set <code>\&lbrace;\, x \mid x\geq 5 \,\&rbrace;</code>.
</para>
@@ -8568,125 +11336,126 @@ ordinary) and you should not use them as relations but instead only as
ordinals, i.e., footnote symbols. For absolute value, see the entry
for&nbsp;<code>\vert</code> and for norm see the entry for&nbsp;<code>\Vert</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="620">\models</indexterm>\models</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="624" mergedindex="cp">\models</indexterm>\models</itemformat></item>
</tableterm><tableitem><para><U>22A8</U> Entails, or satisfies; double turnstile, short double dash
(relation). Similar: long double dash&nbsp;<code>\vDash</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="621">\mp</indexterm>\mp</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="625" mergedindex="cp">\mp</indexterm>\mp</itemformat></item>
</tableterm><tableitem><para><U>2213</U> Minus or plus (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="622">\mu</indexterm>\mu</itemformat></item>
-</tableterm><tableitem><para><U>03BC</U> Lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="626" mergedindex="cp">\mu</indexterm>\mu</itemformat></item>
+</tableterm><tableitem><para><U>03BC</U> Lowercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="623">\nabla</indexterm>\nabla</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="627" mergedindex="cp">\nabla</indexterm>\nabla</itemformat></item>
</tableterm><tableitem><para><U>2207</U> Hamilton&textrsquo;s del, or differential, operator (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="624">\natural</indexterm>\natural</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="628" mergedindex="cp">\natural</indexterm>\natural</itemformat></item>
</tableterm><tableitem><para><U>266E</U> Musical natural notation (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="625">\ne</indexterm>\ne</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="629" mergedindex="cp">\ne</indexterm>\ne</itemformat></item>
</tableterm><tableitem><para><U>2260</U> Not equal (relation). Synonym:&nbsp;<code>\neq</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="626">\nearrow</indexterm>\nearrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="630" mergedindex="cp">\nearrow</indexterm>\nearrow</itemformat></item>
</tableterm><tableitem><para><U>2197</U> North-east arrow (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="627">\neg</indexterm>\neg</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="631" mergedindex="cp">\neg</indexterm>\neg</itemformat></item>
</tableterm><tableitem><para><U>00AC</U> Logical negation (ordinary).
Synonym:&nbsp;<code>\lnot</code>. Sometimes instead used for
negation:&nbsp;<code>\sim</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="628">\neq</indexterm>\neq</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="632" mergedindex="cp">\neq</indexterm>\neq</itemformat></item>
</tableterm><tableitem><para><U>2260</U> Not equal (relation). Synonym:&nbsp;<code>\ne</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="629">\ni</indexterm>\ni</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="633" mergedindex="cp">\ni</indexterm>\ni</itemformat></item>
</tableterm><tableitem><para><U>220B</U> Reflected membership epsilon; has the member
(relation). Synonym:&nbsp;<code>\owns</code>. Similar: is a member
of&nbsp;<code>\in</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="630">\not</indexterm>\not</itemformat></item>
-</tableterm><tableitem><para><U>0020</U><U>00A0</U><U>0338</U> Long solidus, or slash, used to overstrike a
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="634" mergedindex="cp">\not</indexterm>\not</itemformat></item>
+</tableterm><tableitem><!-- c the "@ "s put in spaces so the not slash doesn't hit the next char. -->
+<para><U>0020</U><spacecmd type="spc"/><spacecmd type="spc"/><spacecmd type="spc"/><spacecmd type="spc"/>Long solidus, or slash, used to overstrike a
following operator (relation).
-<!-- c Need blank space for it to overstrike -->
</para>
-<para>Many negated operators that don&textrsquo;t require <code>\not</code> are available,
+<para>Many negated operators are available that don&textrsquo;t require <code>\not</code>,
particularly with the <file>amssymb</file> package. For example, <code>\notin</code>
-is probably typographically preferable to <code>\not\in</code>.
+is typographically preferable to <code>\not\in</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="631">\notin</indexterm>\notin</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="635" mergedindex="cp">\notin</indexterm>\notin</itemformat></item>
</tableterm><tableitem><para><U>2209</U> Not an element of (relation). Similar: not subset
of&nbsp;<code>\nsubseteq</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="632">\nu</indexterm>\nu</itemformat></item>
-</tableterm><tableitem><para><U>03BD</U> Lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="636" mergedindex="cp">\nu</indexterm>\nu</itemformat></item>
+</tableterm><tableitem><para><U>03BD</U> Lowercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="633">\nwarrow</indexterm>\nwarrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="637" mergedindex="cp">\nwarrow</indexterm>\nwarrow</itemformat></item>
</tableterm><tableitem><para><U>2196</U> North-west arrow (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="634">\odot</indexterm>\odot</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="638" mergedindex="cp">\odot</indexterm>\odot</itemformat></item>
</tableterm><tableitem><para><U>2299</U> Dot inside a circle (binary). Similar: variable-sized
operator&nbsp;<code>\bigodot</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="635">\oint</indexterm>\oint</itemformat></item>
-</tableterm><tableitem><para><U>222E</U> Contour integral, integral with circle in the middle (operator).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="639" mergedindex="cp">\oint</indexterm>\oint</itemformat></item>
+</tableterm><tableitem><para><U>222E</U> Contour integral, integral with circle in the middle
+(operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="636">\Omega</indexterm>\Omega</itemformat></item>
-</tableterm><tableitem><para><U>03A9</U> Upper case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="640" mergedindex="cp">\Omega</indexterm>\Omega</itemformat></item>
+</tableterm><tableitem><para><U>03A9</U> uppercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="637">\omega</indexterm>\omega</itemformat></item>
-</tableterm><tableitem><para><U>03C9</U> Lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="641" mergedindex="cp">\omega</indexterm>\omega</itemformat></item>
+</tableterm><tableitem><para><U>03C9</U> Lowercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="638">\ominus</indexterm>\ominus</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="642" mergedindex="cp">\ominus</indexterm>\ominus</itemformat></item>
</tableterm><tableitem><para><U>2296</U> Minus sign, or dash, inside a circle (binary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="639">\oplus</indexterm>\oplus</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="643" mergedindex="cp">\oplus</indexterm>\oplus</itemformat></item>
</tableterm><tableitem><para><U>2295</U> Plus sign inside a circle (binary). Similar: variable-sized
operator&nbsp;<code>\bigoplus</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="640">\oslash</indexterm>\oslash</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="644" mergedindex="cp">\oslash</indexterm>\oslash</itemformat></item>
</tableterm><tableitem><para><U>2298</U> Solidus, or slash, inside a circle (binary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="641">\otimes</indexterm>\otimes</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="645" mergedindex="cp">\otimes</indexterm>\otimes</itemformat></item>
</tableterm><tableitem><para><U>2297</U> Times sign, or cross, inside a circle (binary). Similar:
variable-sized operator&nbsp;<code>\bigotimes</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="642">\owns</indexterm>\owns</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="646" mergedindex="cp">\owns</indexterm>\owns</itemformat></item>
</tableterm><tableitem><para><U>220B</U> Reflected membership epsilon; has the member
(relation). Synonym:&nbsp;<code>\ni</code>. Similar: is a member
of&nbsp;<code>\in</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="643">\parallel</indexterm>\parallel</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="647" mergedindex="cp">\parallel</indexterm>\parallel</itemformat></item>
</tableterm><tableitem><para><U>2225</U> Parallel (relation). Synonym:&nbsp;<code>\|</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="644">\partial</indexterm>\partial</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="648" mergedindex="cp">\partial</indexterm>\partial</itemformat></item>
</tableterm><tableitem><para><U>2202</U> Partial differential (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="645">\perp</indexterm>\perp</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="649" mergedindex="cp">\perp</indexterm>\perp</itemformat></item>
</tableterm><tableitem><para><U>27C2</U> Perpendicular (relation). Similar:&nbsp;<code>\bot</code> uses the
same glyph but the spacing is different because it is in the class
ordinary.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="646">\phi</indexterm>\phi</itemformat></item>
-</tableterm><tableitem><para><U>03D5</U> Lower case Greek letter (ordinary). The variant form is
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="650" mergedindex="cp">\phi</indexterm>\phi</itemformat></item>
+</tableterm><tableitem><para><U>03D5</U> Lowercase Greek letter (ordinary). The variant form is
<code>\varphi</code>&nbsp;<U>03C6</U>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="647">\Pi</indexterm>\Pi</itemformat></item>
-</tableterm><tableitem><para><U>03A0</U> Upper case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="651" mergedindex="cp">\Pi</indexterm>\Pi</itemformat></item>
+</tableterm><tableitem><para><U>03A0</U> uppercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="648">\pi</indexterm>\pi</itemformat></item>
-</tableterm><tableitem><para><U>03C0</U> Lower case Greek letter (ordinary). The variant form is
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="652" mergedindex="cp">\pi</indexterm>\pi</itemformat></item>
+</tableterm><tableitem><para><U>03C0</U> Lowercase Greek letter (ordinary). The variant form is
<code>\varpi</code>&nbsp;<U>03D6</U>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="649">\pm</indexterm>\pm</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="653" mergedindex="cp">\pm</indexterm>\pm</itemformat></item>
</tableterm><tableitem><para><U>00B1</U> Plus or minus (binary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="650">\prec</indexterm>\prec</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="654" mergedindex="cp">\prec</indexterm>\prec</itemformat></item>
</tableterm><tableitem><para><U>227A</U> Precedes (relation). Similar: less than&nbsp;<code>&lt;</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="651">\preceq</indexterm>\preceq</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="655" mergedindex="cp">\preceq</indexterm>\preceq</itemformat></item>
</tableterm><tableitem><para><U>2AAF</U> Precedes or equals (relation). Similar: less than or
equals&nbsp;<code>\leq</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="652">\prime</indexterm>\prime</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="656" mergedindex="cp">\prime</indexterm>\prime</itemformat></item>
</tableterm><tableitem><para><U>2032</U> Prime, or minute in a time expression (ordinary).
Typically used as a superscript: <code>$f^\prime$</code>; <code>$f^\prime$</code>
and <code>$f'$</code> produce the same result. An advantage of the second
@@ -8696,774 +11465,1232 @@ typing. You can only use <code>\prime</code> in math mode. Using the right
single quote&nbsp;<code>'</code> in text mode produces a different character
(apostrophe).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="653">\prod</indexterm>\prod</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="657" mergedindex="cp">\prod</indexterm>\prod</itemformat></item>
</tableterm><tableitem><para><U>220F</U> Product (operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="654">\propto</indexterm>\propto</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="658" mergedindex="cp">\propto</indexterm>\propto</itemformat></item>
</tableterm><tableitem><para><U>221D</U> Is proportional to (relation)
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="655">\Psi</indexterm>\Psi</itemformat></item>
-</tableterm><tableitem><para><U>03A8</U> Upper case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="659" mergedindex="cp">\Psi</indexterm>\Psi</itemformat></item>
+</tableterm><tableitem><para><U>03A8</U> uppercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="656">\psi</indexterm>\psi</itemformat></item>
-</tableterm><tableitem><para><U>03C8</U> Lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="660" mergedindex="cp">\psi</indexterm>\psi</itemformat></item>
+</tableterm><tableitem><para><U>03C8</U> Lowercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="657">\rangle</indexterm>\rangle</itemformat></item>
-</tableterm><tableitem><para><U>27E9</U> Right angle, or sequence, bracket (closing). Similar: greater
-than&nbsp;<code>&gt;</code>. Matches:<code>\langle</code>.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="661" mergedindex="cp">\rangle</indexterm>\rangle</itemformat></item>
+</tableterm><tableitem><para><U>27E9</U> Right angle, or sequence, bracket (closing).
+Similar: greater than&nbsp;<code>&gt;</code>. Matches:<code>\langle</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="658">\rbrace</indexterm>\rbrace</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="662" mergedindex="cp">\rbrace</indexterm>\rbrace</itemformat></item>
</tableterm><tableitem><para><U>007D</U> Right curly brace
(closing). Synonym:&nbsp;<code>\&rbrace;</code>. Matches&nbsp;<code>\lbrace</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="659">\rbrack</indexterm>\rbrack</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="663" mergedindex="cp">\rbrack</indexterm>\rbrack</itemformat></item>
</tableterm><tableitem><para><U>005D</U> Right square bracket
(closing). Synonym:&nbsp;<code>]</code>. Matches&nbsp;<code>\lbrack</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="660">\rceil</indexterm>\rceil</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="664" mergedindex="cp">\rceil</indexterm>\rceil</itemformat></item>
</tableterm><tableitem><para><U>2309</U> Right ceiling bracket (closing). Matches&nbsp;<code>\lceil</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="661">\Re</indexterm>\Re</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="665" mergedindex="cp">\Re</indexterm>\Re</itemformat></item>
</tableterm><tableitem><para><U>211C</U> Real part, real numbers, cursive capital R (ordinary). Related:
double-line, or blackboard bold, R&nbsp;<code>\mathbb&lbrace;R&rbrace;</code>; to access
this, load the <file>amsfonts</file> package.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="662">\restriction</indexterm>\restriction</itemformat></item>
-</tableterm><tableitem><para><U>21BE</U> Restriction of a function
-(relation). Synonym:&nbsp;<code>\upharpoonright</code>. Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="666" mergedindex="cp">\restriction</indexterm>\restriction</itemformat></item>
+</tableterm><tableitem><para><U>21BE</U> Restriction of a function (relation). Synonym:
+<code>\upharpoonright</code>. Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="663">\revemptyset</indexterm>\revemptyset</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="667" mergedindex="cp">\revemptyset</indexterm>\revemptyset</itemformat></item>
</tableterm><tableitem><para><U>29B0</U> Reversed empty set symbol (ordinary). Related:
<code>\varnothing</code>. Not available in plain &tex;. In &latex; you need to load the <file>stix</file> package.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="664">\rfloor</indexterm>\rfloor</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="668" mergedindex="cp">\rfloor</indexterm>\rfloor</itemformat></item>
</tableterm><tableitem><para><U>230B</U> Right floor bracket, a right square bracket with the top cut
off (closing). Matches&nbsp;<code>\lfloor</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="665">\rhd</indexterm>\rhd</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="669" mergedindex="cp">\rhd</indexterm>\rhd</itemformat></item>
</tableterm><tableitem><para><U>25C1</U> Arrowhead, that is, triangle, pointing right (binary).
Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package. For the normal subgroup symbol you should instead
-load <file>amssymb</file> and use&nbsp;<code>\vartriangleright</code> (which
-is a relation and so gives better spacing).
+load <file>amssymb</file> and use&nbsp;<code>\vartriangleright</code> (which is a
+relation and so gives better spacing).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="666">\rho</indexterm>\rho</itemformat></item>
-</tableterm><tableitem><para><U>03C1</U> Lower case Greek letter (ordinary). The variant form is
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="670" mergedindex="cp">\rho</indexterm>\rho</itemformat></item>
+</tableterm><tableitem><para><U>03C1</U> Lowercase Greek letter (ordinary). The variant form is
<code>\varrho</code>&nbsp;<U>03F1</U>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="667">\Rightarrow</indexterm>\Rightarrow</itemformat></item>
-</tableterm><tableitem><para><U>21D2</U> Implies, right-pointing double line arrow (relation). Similar:
-right single-line arrow&nbsp;<code>\rightarrow</code>.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="671" mergedindex="cp">\Rightarrow</indexterm>\Rightarrow</itemformat></item>
+</tableterm><tableitem><para><U>21D2</U> Implies, right-pointing double line arrow
+(relation). Similar: right single-line arrow&nbsp;<code>\rightarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="668">\rightarrow</indexterm>\rightarrow</itemformat></item>
-</tableterm><tableitem><para><U>2192</U> Right-pointing single line arrow (relation). Synonym:&nbsp;<code>\to</code>. Similar: right double line arrow&nbsp;<code>\Rightarrow</code>.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="672" mergedindex="cp">\rightarrow</indexterm>\rightarrow</itemformat></item>
+</tableterm><tableitem><para><U>2192</U> Right-pointing single line arrow (relation).
+Synonym:&nbsp;<code>\to</code>. Similar: right double line
+arrow&nbsp;<code>\Rightarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="669">\rightharpoondown</indexterm>\rightharpoondown</itemformat></item>
-</tableterm><tableitem><para><U>21C1</U> Right-pointing harpoon with barb below the line (relation).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="673" mergedindex="cp">\rightharpoondown</indexterm>\rightharpoondown</itemformat></item>
+</tableterm><tableitem><para><U>21C1</U> Right-pointing harpoon with barb below
+the line (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="670">\rightharpoonup</indexterm>\rightharpoonup</itemformat></item>
-</tableterm><tableitem><para><U>21C0</U> Right-pointing harpoon with barb above the line (relation).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="674" mergedindex="cp">\rightharpoonup</indexterm>\rightharpoonup</itemformat></item>
+</tableterm><tableitem><para><U>21C0</U> Right-pointing harpoon with barb above the
+line (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="671">\rightleftharpoons</indexterm>\rightleftharpoons</itemformat></item>
-</tableterm><tableitem><para><U>21CC</U> Right harpoon up above left harpoon down (relation).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="675" mergedindex="cp">\rightleftharpoons</indexterm>\rightleftharpoons</itemformat></item>
+</tableterm><tableitem><para><U>21CC</U> Right harpoon up above left harpoon down
+(relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="672">\searrow</indexterm>\searrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="676" mergedindex="cp">\searrow</indexterm>\searrow</itemformat></item>
</tableterm><tableitem><para><U>2198</U> Arrow pointing southeast (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="673">\setminus</indexterm>\setminus</itemformat></item>
-</tableterm><tableitem><para><U>29F5</U> Set difference, reverse solidus or slash, like \
-(binary). Similar: backslash&nbsp;<code>\backslash</code> and also
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="677" mergedindex="cp">\setminus</indexterm>\setminus</itemformat></item>
+</tableterm><tableitem><para><U>29F5</U> Set difference, reverse solidus or reverse slash,
+like \ (binary). Similar: backslash&nbsp;<code>\backslash</code> and also
<code>\textbackslash</code> outside of math mode.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="674">\sharp</indexterm>\sharp</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="678" mergedindex="cp">\sharp</indexterm>\sharp</itemformat></item>
</tableterm><tableitem><para><U>266F</U> Musical sharp (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="675">\Sigma</indexterm>\Sigma</itemformat></item>
-</tableterm><tableitem><para><U>03A3</U> Upper case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="679" mergedindex="cp">\Sigma</indexterm>\Sigma</itemformat></item>
+</tableterm><tableitem><para><U>03A3</U> uppercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="676">\sigma</indexterm>\sigma</itemformat></item>
-</tableterm><tableitem><para><U>03C3</U> Lower case Greek letter (ordinary). The variant form is
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="680" mergedindex="cp">\sigma</indexterm>\sigma</itemformat></item>
+</tableterm><tableitem><para><U>03C3</U> Lowercase Greek letter (ordinary). The variant form is
<code>\varsigma</code>&nbsp;<U>03C2</U>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="677">\sim</indexterm>\sim</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="681" mergedindex="cp">\sim</indexterm>\sim</itemformat></item>
</tableterm><tableitem><para><U>223C</U> Similar, in a relation (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="678">\simeq</indexterm>\simeq</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="682" mergedindex="cp">\simeq</indexterm>\simeq</itemformat></item>
</tableterm><tableitem><para><U>2243</U> Similar or equal to, in a relation (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="679">\smallint</indexterm>\smallint</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="683" mergedindex="cp">\smallint</indexterm>\smallint</itemformat></item>
</tableterm><tableitem><para><U>222B</U> Integral sign that does not change to a larger size in a
display (operator).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="680">\smile</indexterm>\smile</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="684" mergedindex="cp">\smile</indexterm>\smile</itemformat></item>
</tableterm><tableitem><para><U>2323</U> Upward curving arc, smile (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="681">\spadesuit</indexterm>\spadesuit</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="685" mergedindex="cp">\spadesuit</indexterm>\spadesuit</itemformat></item>
</tableterm><tableitem><para><U>2660</U> Spade card suit (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="682">\sqcap</indexterm>\sqcap</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="686" mergedindex="cp">\sqcap</indexterm>\sqcap</itemformat></item>
</tableterm><tableitem><para><U>2293</U> Square intersection symbol (binary). Similar:
intersection&nbsp;<code>cap</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="683">\sqcup</indexterm>\sqcup</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="687" mergedindex="cp">\sqcup</indexterm>\sqcup</itemformat></item>
</tableterm><tableitem><para><U>2294</U> Square union symbol (binary). Similar:
union&nbsp;<code>cup</code>. Related: variable-sized
operator&nbsp;<code>\bigsqcup</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="684">\sqsubset</indexterm>\sqsubset</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="688" mergedindex="cp">\sqsubset</indexterm>\sqsubset</itemformat></item>
</tableterm><tableitem><para><U>228F</U> Square subset symbol (relation). Similar:
subset&nbsp;<code>\subset</code>. Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="685">\sqsubseteq</indexterm>\sqsubseteq</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="689" mergedindex="cp">\sqsubseteq</indexterm>\sqsubseteq</itemformat></item>
</tableterm><tableitem><para><U>2291</U> Square subset or equal symbol (binary). Similar: subset or
equal to&nbsp;<code>\subseteq</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="686">\sqsupset</indexterm>\sqsupset</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="690" mergedindex="cp">\sqsupset</indexterm>\sqsupset</itemformat></item>
</tableterm><tableitem><para><U>2290</U> Square superset symbol (relation). Similar:
superset&nbsp;<code>\supset</code>. Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="687">\sqsupseteq</indexterm>\sqsupseteq</itemformat></item>
-</tableterm><tableitem><para><U>2292</U> Square superset or equal symbol (binary). Similar: superset or
-equal&nbsp;<code>\supseteq</code>.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="691" mergedindex="cp">\sqsupseteq</indexterm>\sqsupseteq</itemformat></item>
+</tableterm><tableitem><para><U>2292</U> Square superset or equal symbol (binary).
+Similar: superset or equal&nbsp;<code>\supseteq</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="688">\star</indexterm>\star</itemformat></item>
-</tableterm><tableitem><para><U>22C6</U> Five-pointed star, sometimes used as a general binary operation
-but sometimes reserved for cross-correlation (binary). Similar: the
-synonyms asterisk&nbsp;<code>*</code> and <code>\ast</code>, which are six-pointed,
-and more often appear as a superscript or subscript, as with the Kleene
-star.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="692" mergedindex="cp">\star</indexterm>\star</itemformat></item>
+</tableterm><tableitem><para><U>22C6</U> Five-pointed star, sometimes used as a general binary
+operation but sometimes reserved for cross-correlation (binary).
+Similar: the synonyms asterisk&nbsp;<code>*</code> and <code>\ast</code>, which
+are six-pointed, and more often appear as a superscript or subscript,
+as with the Kleene star.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="689">\subset</indexterm>\subset</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="693" mergedindex="cp">\subset</indexterm>\subset</itemformat></item>
</tableterm><tableitem><para><U>2282</U> Subset (occasionally, is implied by) (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="690">\subseteq</indexterm>\subseteq</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="694" mergedindex="cp">\subseteq</indexterm>\subseteq</itemformat></item>
</tableterm><tableitem><para><U>2286</U> Subset or equal to (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="691">\succ</indexterm>\succ</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="695" mergedindex="cp">\succ</indexterm>\succ</itemformat></item>
</tableterm><tableitem><para><U>227B</U> Comes after, succeeds (relation). Similar: is less
than&nbsp;<code>&gt;</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="692">\succeq</indexterm>\succeq</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="696" mergedindex="cp">\succeq</indexterm>\succeq</itemformat></item>
</tableterm><tableitem><para><U>2AB0</U> Succeeds or is equal to (relation). Similar: less
than or equal to&nbsp;<code>\leq</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="693">\sum</indexterm>\sum</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="697" mergedindex="cp">\sum</indexterm>\sum</itemformat></item>
</tableterm><tableitem><para><U>2211</U> Summation (operator). Similar: Greek capital
sigma&nbsp;<code>\Sigma</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="694">\supset</indexterm>\supset</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="698" mergedindex="cp">\supset</indexterm>\supset</itemformat></item>
</tableterm><tableitem><para><U>2283</U> Superset (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="695">\supseteq</indexterm>\supseteq</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="699" mergedindex="cp">\supseteq</indexterm>\supseteq</itemformat></item>
</tableterm><tableitem><para><U>2287</U> Superset or equal to (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="696">\surd</indexterm>\surd</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="700" mergedindex="cp">\surd</indexterm>\surd</itemformat></item>
</tableterm><tableitem><para><U>221A</U> Radical symbol (ordinary). The &latex; command
<code>\sqrt&lbrace;...&rbrace;</code> typesets the square root of the argument, with a bar
that extends to cover the argument.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="697">\swarrow</indexterm>\swarrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="701" mergedindex="cp">\swarrow</indexterm>\swarrow</itemformat></item>
</tableterm><tableitem><para><U>2199</U> Southwest-pointing arrow (relation).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="698">\tau</indexterm>\tau</itemformat></item>
-</tableterm><tableitem><para><U>03C4</U> Lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="702" mergedindex="cp">\tau</indexterm>\tau</itemformat></item>
+</tableterm><tableitem><para><U>03C4</U> Lowercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="699">\theta</indexterm>\theta</itemformat></item>
-</tableterm><tableitem><para><U>03B8</U> Lower case Greek letter (ordinary). The variant form is
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="703" mergedindex="cp">\theta</indexterm>\theta</itemformat></item>
+</tableterm><tableitem><para><U>03B8</U> Lowercase Greek letter (ordinary). The variant form is
<code>\vartheta</code>&nbsp;<U>03D1</U>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="700">\times</indexterm>\times</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="704" mergedindex="cp">\times</indexterm>\times</itemformat></item>
</tableterm><tableitem><para><U>00D7</U> Primary school multiplication sign (binary). See
also&nbsp;<code>\cdot</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="701">\to</indexterm>\to</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="705" mergedindex="cp">\to</indexterm>\to</itemformat></item>
</tableterm><tableitem><para><U>2192</U> Right-pointing single line arrow (relation).
Synonym:&nbsp;<code>\rightarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="702">\top</indexterm>\top</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="706" mergedindex="cp">\top</indexterm>\top</itemformat></item>
</tableterm><tableitem><para><U>22A4</U> Top, greatest element of a partially ordered set
(ordinary). See also&nbsp;<code>\bot</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="703">\triangle</indexterm>\triangle</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="707" mergedindex="cp">\triangle</indexterm>\triangle</itemformat></item>
</tableterm><tableitem><para><U>25B3</U> Triangle (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="704">\triangleleft</indexterm>\triangleleft</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="708" mergedindex="cp">\triangleleft</indexterm>\triangleleft</itemformat></item>
</tableterm><tableitem><para><U>25C1</U> Not-filled triangle pointing left
(binary). Similar:&nbsp;<code>\lhd</code>. For the normal subgroup symbol you
should load <file>amssymb</file> and use&nbsp;<code>\vartriangleleft</code> (which
is a relation and so gives better spacing).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="705">\triangleright</indexterm>\triangleright</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="709" mergedindex="cp">\triangleright</indexterm>\triangleright</itemformat></item>
</tableterm><tableitem><para><U>25B7</U> Not-filled triangle pointing right
(binary). For the normal subgroup symbol you should instead load
<file>amssymb</file> and use&nbsp;<code>\vartriangleright</code> (which is a
relation and so gives better spacing).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="706">\unlhd</indexterm>\unlhd</itemformat></item>
-</tableterm><tableitem><para><U>22B4</U> Left-pointing not-filled underlined arrowhead, that
-is, triangle, with a line under (binary). Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package. For
-the normal subgroup symbol load <file>amssymb</file> and
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="710" mergedindex="cp">\unlhd</indexterm>\unlhd</itemformat></item>
+</tableterm><tableitem><para><U>22B4</U> Left-pointing not-filled underlined arrowhead, that is,
+triangle, with a line under (binary). Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package. For the
+normal subgroup symbol load <file>amssymb</file> and
use&nbsp;<code>\vartrianglelefteq</code> (which is a relation and so gives
better spacing).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="707">\unrhd</indexterm>\unrhd</itemformat></item>
-</tableterm><tableitem><para><U>22B5</U> Right-pointing not-filled underlined arrowhead, that
-is, triangle, with a line under (binary). Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package. For
-the normal subgroup symbol load <file>amssymb</file> and
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="711" mergedindex="cp">\unrhd</indexterm>\unrhd</itemformat></item>
+</tableterm><tableitem><para><U>22B5</U> Right-pointing not-filled underlined arrowhead, that is,
+triangle, with a line under (binary). Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package. For the
+normal subgroup symbol load <file>amssymb</file> and
use&nbsp;<code>\vartrianglerighteq</code> (which is a relation and so gives
better spacing).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="708">\Uparrow</indexterm>\Uparrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="712" mergedindex="cp">\Uparrow</indexterm>\Uparrow</itemformat></item>
</tableterm><tableitem><para><U>21D1</U> Double-line upward-pointing arrow
(relation). Similar: single-line up-pointing
arrow&nbsp;<code>\uparrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="709">\uparrow</indexterm>\uparrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="713" mergedindex="cp">\uparrow</indexterm>\uparrow</itemformat></item>
</tableterm><tableitem><para><U>2191</U> Single-line upward-pointing arrow, diverges
(relation). Similar: double-line up-pointing
arrow&nbsp;<code>\Uparrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="710">\Updownarrow</indexterm>\Updownarrow</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="714" mergedindex="cp">\Updownarrow</indexterm>\Updownarrow</itemformat></item>
</tableterm><tableitem><para><U>21D5</U> Double-line upward-and-downward-pointing arrow
(relation). Similar: single-line upward-and-downward-pointing
arrow&nbsp;<code>\updownarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="711">\updownarrow</indexterm>\updownarrow</itemformat></item>
-</tableterm><tableitem><para><U>2195</U> Single-line upward-and-downward-pointing arrow (relation). Similar:
-double-line upward-and-downward-pointing arrow&nbsp;<code>\Updownarrow</code>.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="715" mergedindex="cp">\updownarrow</indexterm>\updownarrow</itemformat></item>
+</tableterm><tableitem><para><U>2195</U> Single-line upward-and-downward-pointing arrow
+(relation). Similar: double-line upward-and-downward-pointing
+arrow&nbsp;<code>\Updownarrow</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="712">\upharpoonright</indexterm>\upharpoonright</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="716" mergedindex="cp">\upharpoonright</indexterm>\upharpoonright</itemformat></item>
</tableterm><tableitem><para><U>21BE</U> Up harpoon, with barb on right side
-(relation). Synonym:&nbsp;<code>&backslashchar;restriction</code>. Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package.
+(relation). Synonym:&nbsp;<code>&backslashchar;restriction</code>.
+Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="713">\uplus</indexterm>\uplus</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="717" mergedindex="cp">\uplus</indexterm>\uplus</itemformat></item>
</tableterm><tableitem><para><U>228E</U> Multiset union, a union symbol with a plus symbol in
the middle (binary). Similar: union&nbsp;<code>\cup</code>. Related:
variable-sized operator&nbsp;<code>\biguplus</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="714">\Upsilon</indexterm>\Upsilon</itemformat></item>
-</tableterm><tableitem><para><U>03A5</U> Upper case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="718" mergedindex="cp">\Upsilon</indexterm>\Upsilon</itemformat></item>
+</tableterm><tableitem><para><U>03A5</U> uppercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="715">\upsilon</indexterm>\upsilon</itemformat></item>
-</tableterm><tableitem><para><U>03C5</U> Lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="719" mergedindex="cp">\upsilon</indexterm>\upsilon</itemformat></item>
+</tableterm><tableitem><para><U>03C5</U> Lowercase Greek letter (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="716">\varepsilon</indexterm>\varepsilon</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="720" mergedindex="cp">\varepsilon</indexterm>\varepsilon</itemformat></item>
</tableterm><tableitem><para><U>03B5</U> Small letter script epsilon (ordinary). This is
more widely used in mathematics than the non-variant lunate epsilon form
<code>\epsilon</code>&nbsp;<U>03F5</U>. Related: set
membership&nbsp;<code>\in</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="717">\vanothing</indexterm>\vanothing</itemformat></item>
-</tableterm><tableitem><para><U>2205</U> Empty set symbol. Similar:
-<code>\emptyset</code>. Related: <code>\revemptyset</code>. Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="721" mergedindex="cp">\vanothing</indexterm>\vanothing</itemformat></item>
+</tableterm><tableitem><para><U>2205</U> Empty set symbol. Similar: <code>\emptyset</code>. Related:
+<code>\revemptyset</code>. Not available in plain &tex;. In &latex; you need to load the <file>amssymb</file> package.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="718">\varphi</indexterm>\varphi</itemformat></item>
-</tableterm><tableitem><para><U>03C6</U> Variant on the lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="722" mergedindex="cp">\varphi</indexterm>\varphi</itemformat></item>
+</tableterm><tableitem><para><U>03C6</U> Variant on the lowercase Greek letter (ordinary).
The non-variant form is <code>\phi</code>&nbsp;<U>03D5</U>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="719">\varpi</indexterm>\varpi</itemformat></item>
-</tableterm><tableitem><para><U>03D6</U> Variant on the lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="723" mergedindex="cp">\varpi</indexterm>\varpi</itemformat></item>
+</tableterm><tableitem><para><U>03D6</U> Variant on the lowercase Greek letter (ordinary).
The non-variant form is <code>\pi</code>&nbsp;<U>03C0</U>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="720">\varrho</indexterm>\varrho</itemformat></item>
-</tableterm><tableitem><para><U>03F1</U> Variant on the lower case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="724" mergedindex="cp">\varrho</indexterm>\varrho</itemformat></item>
+</tableterm><tableitem><para><U>03F1</U> Variant on the lowercase Greek letter (ordinary).
The non-variant form is <code>\rho</code>&nbsp;<U>03C1</U>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="721">\varsigma</indexterm>\varsigma</itemformat></item>
-</tableterm><tableitem><para><U>03C2</U> Variant on the lower case Greek letter
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="725" mergedindex="cp">\varsigma</indexterm>\varsigma</itemformat></item>
+</tableterm><tableitem><para><U>03C2</U> Variant on the lowercase Greek letter
(ordinary). The non-variant form is
<code>\sigma</code>&nbsp;<U>03C3</U>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="722">\vartheta</indexterm>\vartheta</itemformat></item>
-</tableterm><tableitem><para><U>03D1</U> Variant on the lower case Greek letter
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="726" mergedindex="cp">\vartheta</indexterm>\vartheta</itemformat></item>
+</tableterm><tableitem><para><U>03D1</U> Variant on the lowercase Greek letter
(ordinary). The non-variant form is
<code>\theta</code>&nbsp;<U>03B8</U>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="723">\vdash</indexterm>\vdash</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="727" mergedindex="cp">\vdash</indexterm>\vdash</itemformat></item>
</tableterm><tableitem><para><U>22A2</U> Provable; turnstile, vertical and a dash
(relation). Similar: turnstile rotated a
half-circle&nbsp;<code>\dashv</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="724">\vee</indexterm>\vee</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="728" mergedindex="cp">\vee</indexterm>\vee</itemformat></item>
</tableterm><tableitem><para><U>2228</U> Logical or; a downwards v shape (binary). Related:
logical and&nbsp;<code>\wedge</code>. Similar: variable-sized
operator&nbsp;<code>\bigvee</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="725">\Vert</indexterm>\Vert</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="729" mergedindex="cp">\Vert</indexterm>\Vert</itemformat></item>
</tableterm><tableitem><para><U>2016</U> Vertical double bar (ordinary). Similar: vertical single
bar&nbsp;<code>\vert</code>.
</para>
-<para>For a norm symbol, you can use the <file>mathtools</file> package and add
-<code>\DeclarePairedDelimiter\norm&lbrace;\lVert&rbrace;&lbrace;\rVert&rbrace;</code> to your
-preamble. This gives you three command variants for double-line
-vertical bars that are correctly horizontally spaced: if in the
-document body you write the starred version <code>$\norm*&lbrace;M^\perp&rbrace;$</code>
-then the height of the vertical bars will match the height of the
-argument, whereas with <code>\norm&lbrace;M^\perp&rbrace;</code> the bars do not grow
-with the height of the argument but instead are the default height,
-and <code>\norm[<var>size command</var>]&lbrace;M^\perp&rbrace;</code> also gives bars that
-do not grow but are set to the size given in the <var>size command</var>,
-e.g., <code>\Bigg</code>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="726">\vert</indexterm>\vert</itemformat></item>
+<para>For a norm symbol, you can use the <file>mathtools</file> package and put in
+your preamble
+<code>\DeclarePairedDelimiter\norm&lbrace;\lVert&rbrace;&lbrace;\rVert&rbrace;</code>. This gives you
+three command variants for double-line vertical bars that are correctly
+horizontally spaced: if in the document body you write the starred
+version <code>$\norm*&lbrace;M^\perp&rbrace;$</code> then the height of the vertical bars
+will match the height of the argument, whereas with
+<code>\norm&lbrace;M^\perp&rbrace;</code> the bars do not grow with the height of the
+argument but instead are the default height, and <code>\norm[<var>size
+command</var>]&lbrace;M^\perp&rbrace;</code> also gives bars that do not grow but are set to
+the size given in the <var>size command</var>, e.g., <code>\Bigg</code>.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="730" mergedindex="cp">\vert</indexterm>\vert</itemformat></item>
</tableterm><tableitem><para><U>007C</U> Single line vertical bar (ordinary). Similar: double-line
vertical bar&nbsp;<code>\Vert</code>. For such that, as in the definition of a
set, use&nbsp;<code>\mid</code> because it is a relation.
</para>
-<para>For absolute value you can use the <file>mathtools</file> package and add
-<code>\DeclarePairedDelimiter\abs&lbrace;\lvert&rbrace;&lbrace;\rvert&rbrace;</code> to your
-preamble. This gives you three command variants for single-line vertical
-bars that are correctly horizontally spaced: if in the document body you
-write the starred version <code>$\abs*&lbrace;\frac&lbrace;22&rbrace;&lbrace;7&rbrace;&rbrace;$</code> then the
-height of the vertical bars will match the height of the argument,
-whereas with <code>\abs&lbrace;\frac&lbrace;22&rbrace;&lbrace;7&rbrace;&rbrace;</code> the bars do not grow with
-the height of the argument but instead are the default height, and
-<code>\abs[<var>size command</var>]&lbrace;\frac&lbrace;22&rbrace;&lbrace;7&rbrace;&rbrace;</code> also gives bars
-that do not grow but are set to the size given in the <var>size
-command</var>, e.g., <code>\Bigg</code>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="727">\wedge</indexterm>\wedge</itemformat></item>
+<para>For absolute value you can use the <file>mathtools</file> package and in your
+preamble put
+<code>\DeclarePairedDelimiter\abs&lbrace;\lvert&rbrace;&lbrace;\rvert&rbrace;</code>. This gives you
+three command variants for single-line vertical bars that are correctly
+horizontally spaced: if in the document body you write the starred
+version <code>$\abs*&lbrace;\frac&lbrace;22&rbrace;&lbrace;7&rbrace;&rbrace;$</code> then the height of the
+vertical bars will match the height of the argument, whereas with
+<code>\abs&lbrace;\frac&lbrace;22&rbrace;&lbrace;7&rbrace;&rbrace;</code> the bars do not grow with the height of
+the argument but instead are the default height, and
+<code>\abs[<var>size command</var>]&lbrace;\frac&lbrace;22&rbrace;&lbrace;7&rbrace;&rbrace;</code> also gives bars that
+do not grow but are set to the size given in the <var>size command</var>,
+e.g., <code>\Bigg</code>.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="731" mergedindex="cp">\wedge</indexterm>\wedge</itemformat></item>
</tableterm><tableitem><para><U>2227</U> Logical and (binary). Synonym:&nbsp;<code>\land</code>. See also
logical or <code>\vee</code>. Similar: variable-sized
operator&nbsp;<code>\bigwedge</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="728">\wp</indexterm>\wp</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="732" mergedindex="cp">\wp</indexterm>\wp</itemformat></item>
</tableterm><tableitem><para><U>2118</U> Weierstrass p (ordinary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="729">\wr</indexterm>\wr</itemformat></item>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="733" mergedindex="cp">\wr</indexterm>\wr</itemformat></item>
</tableterm><tableitem><para><U>2240</U> Wreath product (binary).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="730">\Xi</indexterm>\Xi</itemformat></item>
-</tableterm><tableitem><para><U>039E</U> Upper case Greek letter (ordinary).
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="734" mergedindex="cp">\Xi</indexterm>\Xi</itemformat></item>
+</tableterm><tableitem><para><U>039E</U> uppercase Greek letter (ordinary).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="735" mergedindex="cp">\xi</indexterm>\xi</itemformat></item>
+</tableterm><tableitem><para><U>03BE</U> Lowercase Greek letter (ordinary).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="736" mergedindex="cp">\zeta</indexterm>\zeta</itemformat></item>
+</tableterm><tableitem><para><U>03B6</U> Lowercase Greek letter (ordinary).
+</para>
+</tableitem></tableentry></ftable>
+
+<para>The following symbols are most often used in plain text but &latex;
+provides versions to use in mathematical text.
+</para>
+<ftable commandarg="code" spaces=" " endspaces=" ">
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="737" mergedindex="cp">\mathdollar</indexterm>\mathdollar</itemformat></item>
+</tableterm><tableitem><para>Dollar sign in math mode: $.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="738" mergedindex="cp">\mathparagraph</indexterm>\mathparagraph</itemformat></item>
+</tableterm><tableitem><para>Paragraph sign (pilcrow) in math mode, <U>00B6</U>.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="739" mergedindex="cp">\mathsection</indexterm>\mathsection</itemformat></item>
+</tableterm><tableitem><para>Section sign in math mode <U>00A7</U>.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="740" mergedindex="cp">\mathsterling</indexterm>\mathsterling</itemformat></item>
+</tableterm><tableitem><para>Sterling sign in math mode: &pound;.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="741" mergedindex="cp">\mathunderscore</indexterm>\mathunderscore</itemformat></item>
+</tableterm><tableitem><para>Underscore in math mode: _.
+</para>
+</tableitem></tableentry></ftable>
+
+<menu endspaces=" ">
+<menuentry leadingtext="* "><menunode separator=":: ">Blackboard bold</menunode><menudescription><pre xml:space="preserve">Doublestruck characters.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Calligraphic</menunode><menudescription><pre xml:space="preserve">Cursive characters.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\boldmath &amp; \unboldmath</menunode><menudescription><pre xml:space="preserve">Symbols in boldface.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Dots</menunode><menudescription><pre xml:space="preserve">Ellipses, etc.
+</pre></menudescription></menuentry></menu>
+
+
+<node name="Blackboard-bold" spaces=" "><nodename>Blackboard bold</nodename><nodenext automatic="on">Calligraphic</nodenext><nodeup automatic="on">Math symbols</nodeup></node>
+<subsection spaces=" "><sectiontitle>Blackboard bold</sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="497">blackboard bold</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="498">doublestruck</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\usepackage&lbrace;amssymb&rbrace; % in preamble
+ ...
+\mathbb&lbrace;<var>uppercase-letter</var>&rbrace;
+</pre></example>
+
+<para>Provide blackboard bold symbols, sometimes also known as doublestruck
+letters, used to denote number sets such as the natural numbers, the
+integers, etc.
+</para>
+<para>Here
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\( \forall n \in \mathbb&lbrace;N&rbrace;, n^2 \geq 0 \)
+</pre></example>
+
+<noindent></noindent>
+<para>the <code>\mathbb&lbrace;N&rbrace;</code> gives blackboard bold symbol <U>2115</U>
+representing the natural numbers.
+</para>
+<para>If you use other than an uppercase letter then you do not get an error
+but you get strange results, including unexpected characters.
+</para>
+<para>There are packages that give access to symbols other than just the
+capital letters; look on CTAN.
+</para>
+
+</subsection>
+<node name="Calligraphic" spaces=" "><nodename>Calligraphic</nodename><nodenext automatic="on">\boldmath &amp; \unboldmath</nodenext><nodeprev automatic="on">Blackboard bold</nodeprev><nodeup automatic="on">Math symbols</nodeup></node>
+<subsection spaces=" "><sectiontitle>Calligraphic</sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="499">calligraphic fonts</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="500">script fonts</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="501">fonts, script</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\mathcal&lbrace;<var>uppercase-letters</var>&rbrace;
+</pre></example>
+
+<para>Use a script-like font.
+</para>
+<para>In this example the graph identifier is output in a cursive font.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">Let the graph be \( \mathcal&lbrace;G&rbrace; \).
+</pre></example>
+
+<para>If you use something other than an uppercase letter then you do not get
+an error. Instead you get unexpected output. For instance,
+<code>\mathcal&lbrace;g&rbrace;</code> outputs a close curly brace symbol, while
+<code>\mathcal&lbrace;+&rbrace;</code> outputs a plus sign.
+</para>
+
+</subsection>
+<node name="_005cboldmath-_0026-_005cunboldmath" spaces=" "><nodename>\boldmath &amp; \unboldmath</nodename><nodenext automatic="on">Dots</nodenext><nodeprev automatic="on">Calligraphic</nodeprev><nodeup automatic="on">Math symbols</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\boldmath</code> &amp; <code>\unboldmath</code></sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="502">boldface mathematics</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="503">symbols, boldface</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="742" mergedindex="cp">\boldmath</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="743" mergedindex="cp">\unboldmath</indexterm></findex>
+
+<para>Synopsis (used in paragraph mode or LR mode):
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\boldmath \( <var>math</var> \)
+</pre></example>
+
+<noindent></noindent>
+<para>or
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\unboldmath \( <var>math</var> \)
+</pre></example>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="744" mergedindex="cp">\boldmath</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="745" mergedindex="cp">\unboldmath</indexterm></findex>
+<para>Declarations to change the letters and symbols in <var>math</var> to be in
+a bold font, or to countermand that and bring back the regular
+(non-bold) default. They must be used when not in math mode or display
+math mode (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>). Both commands are fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<para>In this example each <code>\boldmath</code> command takes place inside an
+<code>\mbox</code>,
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">we have $\mbox&lbrace;\boldmath \( v \)&rbrace; = 5\cdot\mbox&lbrace;\boldmath \( u \)$&rbrace;$
+</pre></example>
+
+<noindent></noindent>
+<para>which means <code>\boldmath</code> is only called in a text mode, here LR
+mode, and explains why &latex; must switch to math mode to set <code>v</code>
+and <code>u</code>.
+</para>
+<para>If you use either command inside math mode, as with <code>Trouble: \(
+\boldmath x \)</code>, then you get something like <samp>LaTeX Font Warning:
+Command \boldmath invalid in math mode on input line 11</samp> and <samp>LaTeX
+Font Warning: Command \mathversion invalid in math mode on input line
+11</samp>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="504"><r>package</r>, <code>bm</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="505"><code>bm</code> <r>package</r></indexterm></cindex>
+
+<para>There are many issues with <code>\boldmath</code>. New documents should use
+the <file>bm</file> package provided by the &latex; Project team. A complete
+description is outside the scope of this document (see the full
+documentation on CTAN) but even this small example
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="731">\xi</indexterm>\xi</itemformat></item>
-</tableterm><tableitem><para><U>03BE</U> Lower case Greek letter (ordinary).
+<example endspaces=" ">
+<pre xml:space="preserve">\usepackage&lbrace;bm&rbrace; % in preamble
+...
+we have $\bm&lbrace;v&rbrace; = 5\cdot\bm&lbrace;u&rbrace;$
+</pre></example>
+
+<noindent></noindent>
+<para>shows that it is an improvement over <code>\boldmath</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="732">\zeta</indexterm>\zeta</itemformat></item>
-</tableterm><tableitem><para><U>03B6</U> Lower case Greek letter (ordinary).
+
+</subsection>
+<node name="Dots" spaces=" "><nodename>Dots</nodename><nodeprev automatic="on">\boldmath &amp; \unboldmath</nodeprev><nodeup automatic="on">Math symbols</nodeup></node>
+<subsection spaces=" "><sectiontitle>Dots, horizontal or vertical</sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="506">ellipses</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="507">dots</indexterm></cindex>
+
+<para>Ellipses are the three dots (usually three) indicating that a pattern
+continues.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;array&rbrace;&lbrace;cccc&rbrace;
+ a_&lbrace;0,0&rbrace; &amp;a_&lbrace;0,1&rbrace; &amp;a_&lbrace;0,2&rbrace; &amp;\ldots \\
+ a_&lbrace;1,0&rbrace; &amp;\ddots \\
+ \vdots
+\end&lbrace;array&rbrace;
+</pre></example>
+
+<para>&latex; provides these.
+</para>
+<ftable commandarg="code" spaces=" " endspaces=" ">
+<beforefirstitem><anchor name="ellipses-cdots">ellipses cdots</anchor>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="746" mergedindex="cp">\cdots</indexterm>\cdots</itemformat></item>
+</tableterm><tableitem><para>Horizontal ellipsis with the dots raised to the center of the line, as
+in <U>22EF</U>. Used as: <code>\( a_0\cdot a_1\cdots a_&lbrace;n-1&rbrace;
+\)</code>.
+</para>
+<anchor name="ellipses-ddots">ellipses ddots</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="747" mergedindex="cp">\ddots</indexterm>\ddots</itemformat></item>
+</tableterm><tableitem><para>Diagonal ellipsis, <U>22F1</U>. See the above array example for a
+usage.
+</para>
+<anchor name="ellipses-ldots">ellipses ldots</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="748" mergedindex="cp">\ldots</indexterm>\ldots</itemformat></item>
+</tableterm><tableitem><para>Ellipsis on the baseline, <U>2026</U>. Used as: <code>\(
+x_0,\ldots x_&lbrace;n-1&rbrace; \)</code>. Another example is the above array example. A
+synonym is <code>\mathellipsis</code>. A synonym from the <file>amsmath</file>
+package is <code>\hdots</code>.
+</para>
+<para>You can also use this command outside of mathematical text, as in
+<code>The gears, brakes, \ldots&lbrace;&rbrace; are all broken</code>. (In a paragraph
+mode or LR mode a synonym for <code>\ldots</code> is <code>\dots</code>.)
+</para>
+<anchor name="ellipses-vdots">ellipses vdots</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="749" mergedindex="cp">\vdots</indexterm>\vdots</itemformat></item>
+</tableterm><tableitem><para>Vertical ellipsis, <U>22EE</U>. See the above array example for a
+usage.
</para>
</tableitem></tableentry></ftable>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="508"><r>package</r>, <code>amsmath</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="509"><code>amsmath</code> <r>package</r></indexterm></cindex>
+
+<para>The <file>amsmath</file> package has the command <code>\dots</code> to semantically
+mark up ellipses. This example produces two different-looking outputs
+for the first two uses of the <code>\dots</code> command.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\usepackage&lbrace;amsmath&rbrace; % in preamble
+ ...
+Suppose that \( p_0, p_1, \dots, p_&lbrace;n-1&rbrace; \) lists all of the primes.
+Observe that \( p_0\cdot p_1 \dots \cdot p_&lbrace;n-1&rbrace; +1 \) is not a
+ multiple of any \( p_i \).
+Conclusion: there are infinitely many primes \( p_0, p_1, \dotsc \).
+</pre></example>
+
+<noindent></noindent>
+<para>In the first line &latex; looks to the comma following <code>\dots</code> to
+determine that it should output an ellipsis on the baseline. The second
+line has a <code>\cdot</code> following <code>\dots</code> so &latex; outputs an
+ellipsis that is on the math axis, vertically centered. However, the
+third usage has no follow-on character so you have to tell &latex; what
+to do. You can use one of the commands: <code>\dotsc</code> if you need the
+ellipsis appropriate for a comma following, <code>\dotsb</code> if you need
+the ellipses that fits when the dots are followed by a binary operator
+or relation symbol, <code>\dotsi</code> for dots with integrals, or
+<code>\dotso</code> for others.
+</para>
+</subsection>
</section>
<node name="Math-functions" spaces=" "><nodename>Math functions</nodename><nodenext automatic="on">Math accents</nodenext><nodeprev automatic="on">Math symbols</nodeprev><nodeup automatic="on">Math formulas</nodeup></node>
<section spaces=" "><sectiontitle>Math functions</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="386">math functions</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="387">functions, math</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="510">math functions</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="511">functions, math</indexterm></cindex>
<para>These commands produce roman function names in math mode with proper
spacing.
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="733">\arccos</indexterm>\arccos</itemformat></item>
-</tableterm><tableitem><para><math>\arccos</math>
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="750" mergedindex="cp">\arccos</indexterm>\arccos</itemformat></item>
+</tableterm><tableitem><para>Inverse cosine
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="734">\arcsin</indexterm>\arcsin</itemformat></item>
-</tableterm><tableitem><para><math>\arcsin</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="751" mergedindex="cp">\arcsin</indexterm>\arcsin</itemformat></item>
+</tableterm><tableitem><para>Inverse sine
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="735">\arctan</indexterm>\arctan</itemformat></item>
-</tableterm><tableitem><para><math>\arctan</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="752" mergedindex="cp">\arctan</indexterm>\arctan</itemformat></item>
+</tableterm><tableitem><para>Inverse tangent
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="736">\arg</indexterm>\arg</itemformat></item>
-</tableterm><tableitem><para><math>\arg</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="753" mergedindex="cp">\arg</indexterm>\arg</itemformat></item>
+</tableterm><tableitem><para>Angle between the real axis and a point in the complex plane
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="737">\bmod</indexterm>\bmod</itemformat></item>
-</tableterm><tableitem><para>Binary modulo operator (<math>x \bmod y</math>)
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="754" mergedindex="cp">\bmod</indexterm>\bmod</itemformat></item>
+</tableterm><tableitem><para>Binary modulo operator, used as in <code>\( 5\bmod 3=2 \)</code>
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="738">\cos</indexterm>\cos</itemformat></item>
-</tableterm><tableitem><para><math>\cos</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="755" mergedindex="cp">\cos</indexterm>\cos</itemformat></item>
+</tableterm><tableitem><para>Cosine
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="739">\cosh</indexterm>\cosh</itemformat></item>
-</tableterm><tableitem><para><math>\cosh</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="756" mergedindex="cp">\cosh</indexterm>\cosh</itemformat></item>
+</tableterm><tableitem><para>Hyperbolic cosine
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="740">\cot</indexterm>\cot</itemformat></item>
-</tableterm><tableitem><para><math>\cot</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="757" mergedindex="cp">\cot</indexterm>\cot</itemformat></item>
+</tableterm><tableitem><para>Cotangent
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="741">\coth</indexterm>\coth</itemformat></item>
-</tableterm><tableitem><para><math>\coth</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="758" mergedindex="cp">\coth</indexterm>\coth</itemformat></item>
+</tableterm><tableitem><para>Hyperbolic cotangent
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="742">\csc</indexterm>\csc</itemformat></item>
-</tableterm><tableitem><para><math>\csc</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="759" mergedindex="cp">\csc</indexterm>\csc</itemformat></item>
+</tableterm><tableitem><para>Cosecant
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="743">\deg</indexterm>\deg</itemformat></item>
-</tableterm><tableitem><para><math>\deg</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="760" mergedindex="cp">\deg</indexterm>\deg</itemformat></item>
+</tableterm><tableitem><para>Degrees
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="744">\det</indexterm>\det</itemformat></item>
-</tableterm><tableitem><para><math>\det</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="761" mergedindex="cp">\det</indexterm>\det</itemformat></item>
+</tableterm><tableitem><para>Determinant
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="745">\dim</indexterm>\dim</itemformat></item>
-</tableterm><tableitem><para><math>\dim</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="762" mergedindex="cp">\dim</indexterm>\dim</itemformat></item>
+</tableterm><tableitem><para>Dimension
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="746">\exp</indexterm>\exp</itemformat></item>
-</tableterm><tableitem><para><math>\exp</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="763" mergedindex="cp">\exp</indexterm>\exp</itemformat></item>
+</tableterm><tableitem><para>Exponential
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="747">\gcd</indexterm>\gcd</itemformat></item>
-</tableterm><tableitem><para><math>\gcd</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="764" mergedindex="cp">\gcd</indexterm>\gcd</itemformat></item>
+</tableterm><tableitem><para>Greatest common divisor
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="748">\hom</indexterm>\hom</itemformat></item>
-</tableterm><tableitem><para><math>\hom</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="765" mergedindex="cp">\hom</indexterm>\hom</itemformat></item>
+</tableterm><tableitem><para>Homomorphism
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="749">\inf</indexterm>\inf</itemformat></item>
-</tableterm><tableitem><para><math>\inf</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="766" mergedindex="cp">\inf</indexterm>\inf</itemformat></item>
+</tableterm><tableitem><para>Infinum
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="750">\ker</indexterm>\ker</itemformat></item>
-</tableterm><tableitem><para><math>\ker</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="767" mergedindex="cp">\ker</indexterm>\ker</itemformat></item>
+</tableterm><tableitem><para>Kernel
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="751">\lg</indexterm>\lg</itemformat></item>
-</tableterm><tableitem><para><math>\lg</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="768" mergedindex="cp">\lg</indexterm>\lg</itemformat></item>
+</tableterm><tableitem><para>Base 2 logarithm
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="752">\lim</indexterm>\lim</itemformat></item>
-</tableterm><tableitem><para><math>\lim</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="769" mergedindex="cp">\lim</indexterm>\lim</itemformat></item>
+</tableterm><tableitem><para>Limit
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="753">\liminf</indexterm>\liminf</itemformat></item>
-</tableterm><tableitem><para><math>\liminf</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="770" mergedindex="cp">\liminf</indexterm>\liminf</itemformat></item>
+</tableterm><tableitem><para>Limit inferior
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="754">\limsup</indexterm>\limsup</itemformat></item>
-</tableterm><tableitem><para><math>\limsup</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="771" mergedindex="cp">\limsup</indexterm>\limsup</itemformat></item>
+</tableterm><tableitem><para>Limit superior
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="755">\ln</indexterm>\ln</itemformat></item>
-</tableterm><tableitem><para><math>\ln</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="772" mergedindex="cp">\ln</indexterm>\ln</itemformat></item>
+</tableterm><tableitem><para>Natural logarithm
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="756">\log</indexterm>\log</itemformat></item>
-</tableterm><tableitem><para><math>\log</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="773" mergedindex="cp">\log</indexterm>\log</itemformat></item>
+</tableterm><tableitem><para>Logarithm
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="757">\max</indexterm>\max</itemformat></item>
-</tableterm><tableitem><para><math>\max</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="774" mergedindex="cp">\max</indexterm>\max</itemformat></item>
+</tableterm><tableitem><para>Maximum
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="758">\min</indexterm>\min</itemformat></item>
-</tableterm><tableitem><para><math>\min</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="775" mergedindex="cp">\min</indexterm>\min</itemformat></item>
+</tableterm><tableitem><para>Minimum
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="759">\pmod</indexterm>\pmod</itemformat></item>
-</tableterm><tableitem><para>parenthesized modulus, as in (<math>\pmod 2^n - 1</math>)
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="776" mergedindex="cp">\pmod</indexterm>\pmod</itemformat></item>
+</tableterm><tableitem><para>Parenthesized modulus, as used in <code>\( 5\equiv 2\pmod 3 \)</code>
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="760">\Pr</indexterm>\Pr</itemformat></item>
-</tableterm><tableitem><para><math>\Pr</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="777" mergedindex="cp">\Pr</indexterm>\Pr</itemformat></item>
+</tableterm><tableitem><para>Probability
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="761">\sec</indexterm>\sec</itemformat></item>
-</tableterm><tableitem><para><math>\sec</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="778" mergedindex="cp">\sec</indexterm>\sec</itemformat></item>
+</tableterm><tableitem><para>Secant
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="762">\sin</indexterm>\sin</itemformat></item>
-</tableterm><tableitem><para><math>\sin</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="779" mergedindex="cp">\sin</indexterm>\sin</itemformat></item>
+</tableterm><tableitem><para>Sine
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="763">\sinh</indexterm>\sinh</itemformat></item>
-</tableterm><tableitem><para><math>\sinh</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="780" mergedindex="cp">\sinh</indexterm>\sinh</itemformat></item>
+</tableterm><tableitem><para>Hyperbolic sine
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="764">\sup</indexterm>\sup</itemformat></item>
-</tableterm><tableitem><para><math>\sup</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="781" mergedindex="cp">\sup</indexterm>\sup</itemformat></item>
+</tableterm><tableitem><para>sup
<!-- c don't try to use \sup with dvi/pdf output since that turned into a -->
<!-- c Texinfo command and it's not worth hassling with different versions -->
<!-- c when it's just three roman letters anyway. -->
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="765">\tan</indexterm>\tan</itemformat></item>
-</tableterm><tableitem><para><math>\tan</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="782" mergedindex="cp">\tan</indexterm>\tan</itemformat></item>
+</tableterm><tableitem><para>Tangent
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="766">\tanh</indexterm>\tanh</itemformat></item>
-</tableterm><tableitem><para><math>\tanh</math>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="783" mergedindex="cp">\tanh</indexterm>\tanh</itemformat></item>
+</tableterm><tableitem><para>Hyperbolic tangent
</para>
</tableitem></tableentry></ftable>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="512"><r>package</r>, <code>amsmath</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="513"><code>amsmath</code> <r>package</r></indexterm></cindex>
+
+<para>The <file>amsmath</file> package adds improvements on some of these, and also
+allows you to define your own. The full documentation is on CTAN, but
+briefly, you can define an identity operator with
+<code>\DeclareMathOperator&lbrace;\identity&rbrace;&lbrace;id&rbrace;</code> that is like the ones
+above but prints as <samp>id</samp>. The starred form
+<code>\DeclareMathOperator*&lbrace;\op&rbrace;&lbrace;op&rbrace;</code> sets any limits above and
+below, as is traditional with <code>\lim</code>, <code>\sup</code>, or <code>\max</code>.
+</para>
</section>
-<node name="Math-accents" spaces=" "><nodename>Math accents</nodename><nodenext automatic="on">Spacing in math mode</nodenext><nodeprev automatic="on">Math functions</nodeprev><nodeup automatic="on">Math formulas</nodeup></node>
+<node name="Math-accents" spaces=" "><nodename>Math accents</nodename><nodenext automatic="on">Over- and Underlining</nodenext><nodeprev automatic="on">Math functions</nodeprev><nodeup automatic="on">Math formulas</nodeup></node>
<section spaces=" "><sectiontitle>Math accents</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="388">math accents</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="389">accents, mathematical</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="514">math accents</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="515">accents, mathematical</indexterm></cindex>
<para>&latex; provides a variety of commands for producing accented letters
in math. These are different from accents in normal text
(<pxref label="Accents"><xrefnodename>Accents</xrefnodename></pxref>).
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="767">\acute</indexterm>\acute</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="390">acute accent, math</indexterm></cindex>
-<para>Math acute accent: <math>\acute{x}</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="768">\bar</indexterm>\bar</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="391">bar-over accent, math</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="392">macron accent, math</indexterm></cindex>
-<para>Math bar-over accent: <math>\bar{x}</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="769">\breve</indexterm>\breve</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="393">breve accent, math</indexterm></cindex>
-<para>Math breve accent: <math>\breve{x}</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="770">\check</indexterm>\check</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="394">check accent, math</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="395">h<accent type="acute" bracketed="off">a</accent><accent type="caron">c</accent>ek accent, math</indexterm></cindex>
-<para>Math h<accent type="acute" bracketed="off">a</accent><accent type="caron">c</accent>ek (check) accent: <math>\check{x}</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="771">\ddot</indexterm>\ddot</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="396">double dot accent, math</indexterm></cindex>
-<para>Math dieresis accent: <math>\ddot{x}</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="772">\dot</indexterm>\dot</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="397">overdot accent, math</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="398">dot over accent, math</indexterm></cindex>
-<para>Math dot accent: <math>\dot{x}</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="773">\grave</indexterm>\grave</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="399">grave accent, math</indexterm></cindex>
-<para>Math grave accent: <math>\grave{x}</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="774">\hat</indexterm>\hat</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="400">hat accent, math</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="401">circumflex accent, math</indexterm></cindex>
-<para>Math hat (circumflex) accent: <math>\hat{x}</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="775">\imath</indexterm>\imath</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="402">dotless i, math</indexterm></cindex>
-<para>Math dotless i.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="776">\jmath</indexterm>\jmath</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="403">dotless j, math</indexterm></cindex>
-<para>Math dotless j.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="777">\mathring</indexterm>\mathring</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="404">ring accent, math</indexterm></cindex>
-<para>Math ring accent: <accent type="ring">x</accent>. <!-- c don't bother implementing in texinfo -->
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="778">\tilde</indexterm>\tilde</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="405">tilde accent, math</indexterm></cindex>
-<para>Math tilde accent: <math>\tilde{x}</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="779">\vec</indexterm>\vec</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="406">vector symbol, math</indexterm></cindex>
-<para>Math vector symbol: <math>\vec{x}</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="780">\widehat</indexterm>\widehat</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="407">wide hat accent, math</indexterm></cindex>
-<para>Math wide hat accent: <math>\widehat{x+y}</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="781">\widetilde</indexterm>\widetilde</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="408">wide tilde accent, math</indexterm></cindex>
-<para>Math wide tilde accent: <math>\widetilde{x+y}</math>.
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="784" mergedindex="cp">\acute</indexterm>\acute</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="516">acute accent, math</indexterm></cindex>
+<para>Math acute accent
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="785" mergedindex="cp">\bar</indexterm>\bar</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="517">bar-over accent, math</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="518">macron accent, math</indexterm></cindex>
+<para>Math bar-over accent
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="786" mergedindex="cp">\breve</indexterm>\breve</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="519">breve accent, math</indexterm></cindex>
+<para>Math breve accent
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="787" mergedindex="cp">\check</indexterm>\check</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="520">check accent, math</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="521">h<accent type="acute" bracketed="off">a</accent><accent type="caron">c</accent>ek accent, math</indexterm></cindex>
+<para>Math h<accent type="acute" bracketed="off">a</accent><accent type="caron">c</accent>ek (check) accent
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="788" mergedindex="cp">\ddot</indexterm>\ddot</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="522">double dot accent, math</indexterm></cindex>
+<para>Math dieresis accent
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="789" mergedindex="cp">\dot</indexterm>\dot</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="523">overdot accent, math</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="524">dot over accent, math</indexterm></cindex>
+<para>Math dot accent
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="790" mergedindex="cp">\grave</indexterm>\grave</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="525">grave accent, math</indexterm></cindex>
+<para>Math grave accent
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="791" mergedindex="cp">\hat</indexterm>\hat</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="526">hat accent, math</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="527">circumflex accent, math</indexterm></cindex>
+<para>Math hat (circumflex) accent
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="792" mergedindex="cp">\mathring</indexterm>\mathring</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="528">ring accent, math</indexterm></cindex>
+<para>Math ring accent <!-- c don't bother implementing in texinfo -->
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="793" mergedindex="cp">\tilde</indexterm>\tilde</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="529">tilde accent, math</indexterm></cindex>
+<para>Math tilde accent
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="794" mergedindex="cp">\vec</indexterm>\vec</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="530">vector symbol, math</indexterm></cindex>
+<para>Math vector symbol
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="795" mergedindex="cp">\widehat</indexterm>\widehat</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="531">wide hat accent, math</indexterm></cindex>
+<para>Math wide hat accent
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="796" mergedindex="cp">\widetilde</indexterm>\widetilde</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="532">wide tilde accent, math</indexterm></cindex>
+<para>Math wide tilde accent
</para>
</tableitem></tableentry></ftable>
+<para>When you are putting an accent on an i or a j, the tradition is to use
+one without a dot, <code>\imath</code> or <code>jmath</code> (<pxref label="Math-symbols"><xrefnodename>Math symbols</xrefnodename></pxref>).
+</para>
</section>
-<node name="Spacing-in-math-mode" spaces=" "><nodename>Spacing in math mode</nodename><nodenext automatic="on">Math miscellany</nodenext><nodeprev automatic="on">Math accents</nodeprev><nodeup automatic="on">Math formulas</nodeup></node>
+<node name="Over_002d-and-Underlining" spaces=" "><nodename>Over- and Underlining</nodename><nodenext automatic="on">Spacing in math mode</nodenext><nodeprev automatic="on">Math accents</nodeprev><nodeup automatic="on">Math formulas</nodeup></node>
+<section spaces=" "><sectiontitle>Over- and Underlining</sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="533">overlining</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="534">underlining</indexterm></cindex>
+
+<para>&latex; provides commands for making overlines or underlines, or
+putting braces over or under some material.
+</para>
+<ftable commandarg="code" spaces=" " endspaces=" ">
+<beforefirstitem>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="797" mergedindex="cp">\underline&lbrace;<var>text</var>&rbrace;</indexterm>\underline&lbrace;<var>text</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><para>Underline <var>text</var>. Works inside math mode, and outside.
+The line is always completely below the text, taking account of
+descenders, so in <code>\(\underline&lbrace;y&rbrace;\)</code> the line is lower than in
+<code>\(\underline&lbrace;x&rbrace;\)</code>. This command is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="535"><r>package</r>, <code>ulem</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="536"><code>ulem</code> <r>package</r></indexterm></cindex>
+
+<para>Note that the package <file>ulem</file> does text mode underlining and allows
+line breaking as well as a number of other features. See the
+documentation on CTAN. See also&nbsp;<ref label="_005chrulefill-_0026-_005cdotfill"><xrefnodename>\hrulefill &amp; \dotfill</xrefnodename></ref> for
+producing a line, for such things as a signature.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="798" mergedindex="cp">\overline&lbrace;<var>text</var>&rbrace;</indexterm>\overline&lbrace;<var>text</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><para>Put a horizontal line over <var>text</var>. Works inside math mode, and
+outside. For example, <code>\overline&lbrace;x+y&rbrace;</code>.
+Note that this differs from the command <code>\bar</code> (<pxref label="Math-accents"><xrefnodename>Math
+accents</xrefnodename></pxref>).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="799" mergedindex="cp">\underbrace&lbrace;<var>math</var>&rbrace;</indexterm>\underbrace&lbrace;<var>math</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><para>Put a brace under <var>math</var>. For example, this
+<code>(1-\underbrace&lbrace;1/2)+(1/2&rbrace;-1/3)</code> emphasizes the telescoping part.
+Attach text to the brace by using subscript, <code>_</code>, or superscript,
+<code>^</code>, as here.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;displaymath&rbrace;
+ 1+1/2+\underbrace&lbrace;1/3+1/4&rbrace;_&lbrace;&gt;1/2&rbrace;+
+ \underbrace&lbrace;1/5+1/6+1/7+1/8&rbrace;_&lbrace;&gt;1/2&rbrace;+\cdots
+\end&lbrace;displaymath&rbrace;
+</pre></example>
+
+<para>The superscript appears on top of the expression, and so can look
+unconnected to the underbrace.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="800" mergedindex="cp">\overbrace&lbrace;<var>math</var>&rbrace;</indexterm>\overbrace&lbrace;<var>math</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><para>Put a brace over <var>math</var>, as with
+<code>\overbrace&lbrace;x+x+\cdots+x&rbrace;^&lbrace;\mbox&lbrace;\(k\) times&rbrace;&rbrace;</code>. See also
+<code>\underbrace</code>.
+</para>
+</tableitem></tableentry></ftable>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="537"><r>package</r>, <code>mathtools</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="538"><code>mathtools</code> <r>package</r></indexterm></cindex>
+
+<para>The package <file>mathtools</file> adds an over- and underbrace, as well as
+some improvements on the braces. See the documentation on CTAN.
+</para>
+
+</section>
+<node name="Spacing-in-math-mode" spaces=" "><nodename>Spacing in math mode</nodename><nodenext automatic="on">Math miscellany</nodenext><nodeprev automatic="on">Over- and Underlining</nodeprev><nodeup automatic="on">Math formulas</nodeup></node>
<section spaces=" "><sectiontitle>Spacing in math mode</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="409">spacing within math mode</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="410">math mode, spacing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="539">spacing within math mode</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="540">math mode, spacing</indexterm></cindex>
-<para>In a <code>math</code> environment, &latex; ignores the spaces that you use
-in the source, and instead puts in the spacing according to the normal
-rules for mathematics texts.
+<para>When typesetting mathematics, &latex; puts in spacing according to the
+normal rules for mathematics texts. If you enter <code>y=m x</code> then
+&latex; ignores the space and in the output the m is next to the x,
+as <math>y=mx</math>.
</para>
-<para>Many math mode spacing definitions are expressed in terms of the math unit
-<dfn>mu</dfn> given by 1 em = 18 mu, where the em is taken from the current
-math symbols family (<pxref label="Units-of-length"><xrefnodename>Units of length</xrefnodename></pxref>).
-&latex; provides the following commands for use in math mode:
+<para>But &latex;&textrsquo;s rules sometimes need tweaking. For example, in an
+integral the tradition is to put a small extra space between the
+<code>f(x)</code> and the <code>dx</code>, here done with the <code>\,</code> command.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\int_0^1 f(x)\,dx
+</pre></example>
+
+<para>&latex; provides the commands that follow for use in math mode. Many
+of these spacing definitions are expressed in terms of the math unit
+<dfn>mu</dfn>. It is defined as 1/18<dmn>em</dmn>, where the em is taken from the
+current math symbols family (<pxref label="Units-of-length"><xrefnodename>Units of length</xrefnodename></pxref>). Thus, a
+<code>\thickspace</code> is something like 5/18 times the width of
+a&nbsp;<samp>M</samp>.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">\;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="782">\;</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="783">\thickspace</indexterm></findex>
-<para>Normally <code>5.0mu plus 5.0mu</code>. The longer name is
-<code>\thickspace</code>. Math mode only.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="801" mergedindex="cp">\;</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="802" mergedindex="cp">\thickspace</indexterm></findex>
+<anchor name="spacing-in-math-mode-thickspace">spacing in math mode thickspace</anchor>
+<para>Synonym: <code>\thickspace</code>. Normally <code>5.0mu plus 5.0mu</code>. Math
+mode only.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\:</itemformat></item>
<itemx spaces=" "><itemformat command="code">\&gt;</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="784">\:</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="785">\&gt;</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="786">\medspace</indexterm></findex>
-<para>Normally <code>4.0mu plus 2.0mu minus 4.0mu</code>. The longer name is
-<code>\medspace</code>. Math mode only.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="803" mergedindex="cp">\:</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="804" mergedindex="cp">\&gt;</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="805" mergedindex="cp">\medspace</indexterm></findex>
+<anchor name="spacing-in-math-mode-medspace">spacing in math mode medspace</anchor>
+<para>Synonym: <code>\medspace</code>. Normally <code>4.0mu plus 2.0mu minus 4.0mu</code>.
+Math mode only.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\,</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="787">\,</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="788">\thinspace</indexterm></findex>
-<para>Normally <code>3mu</code>. The longer name is <code>\thinspace</code>. This can
-be used in both math mode and text mode. <xref label="_005cthinspace"><xrefnodename>\thinspace</xrefnodename></xref>.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="806" mergedindex="cp">\,</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="807" mergedindex="cp">\thinspace</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="541">thin space</indexterm></cindex>
+<anchor name="Spacing-in-math-mode_002f_005cthinspace">Spacing in math mode/\thinspace</anchor>
+<anchor name="spacing-in-math-mode-thinspace">spacing in math mode thinspace</anchor>
+<para>Synonym: <code>\thinspace</code>. Normally <code>3mu</code>, which is 1/6<dmn>em</dmn>.
+Can be used in both math mode and text mode (<pxref label="_005cthinspace-_0026-_005cnegthinspace"><xrefnodename>\thinspace &amp;
+\negthinspace</xrefnodename></pxref>).
+</para>
+<para>This space is widely used, for instance between the function and the
+infinitesimal in an integral <code>\int f(x)\,dx</code> and, if an author does
+this, before punctuation in a displayed equation.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">The antiderivative is
+\begin&lbrace;equation&rbrace;
+ 3x^&lbrace;-1/2&rbrace;+3^&lbrace;1/2&rbrace;\,.
+\end&lbrace;equation&rbrace;
+</pre></example>
+
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\!</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="789">\!</indexterm></findex>
-<para>A negative thin space. Normally <code>-3mu</code>. Math mode only.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="808" mergedindex="cp">\!</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="809" mergedindex="cp">\negthinspace</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="542">thin space, negative</indexterm></cindex>
+<anchor name="spacing-in-math-mode-negthinspace">spacing in math mode negthinspace</anchor>
+<para>A negative thin space. Normally <code>-3mu</code>. The <code>\!</code> command is
+math mode only but the <code>\negthinspace</code> command is available for
+text mode (<pxref label="_005cthinspace-_0026-_005cnegthinspace"><xrefnodename>\thinspace &amp; \negthinspace</xrefnodename></pxref>).
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\quad</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="411">quad</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="790">\quad</indexterm></findex>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="543">quad</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="810" mergedindex="cp">\quad</indexterm></findex>
+<anchor name="spacing-in-math-mode-quad">spacing in math mode quad</anchor>
<para>This is 18<dmn>mu</dmn>, that is, 1<dmn>em</dmn>. This is often used for space
surrounding equations or expressions, for instance for the space between
two equations inside a <code>displaymath</code> environment. It is available
in both text and math mode.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\qquad</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="791">\qquad</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="811" mergedindex="cp">\qquad</indexterm></findex>
+<anchor name="spacing-in-math-mode-qquad">spacing in math mode qquad</anchor>
<para>A length of 2 quads, that is, 36<dmn>mu</dmn> = 2<dmn>em</dmn>. It is available in
both text and math mode.
</para></tableitem></tableentry></table>
-<para>In this example a thinspace separates the function from the
-infinitesimal.
-</para>
-<example endspaces=" ">
-<pre xml:space="preserve">\int_0^1 f(x)\,dx
-</pre></example>
-
</section>
<node name="Math-miscellany" spaces=" "><nodename>Math miscellany</nodename><nodeprev automatic="on">Spacing in math mode</nodeprev><nodeup automatic="on">Math formulas</nodeup></node>
<section spaces=" "><sectiontitle>Math miscellany</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="412">math miscellany</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="544">math miscellany</indexterm></cindex>
-<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="792">\*</indexterm>\*</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="413">discretionary multiplication</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="414">multiplication symbol, discretionary line break</indexterm></cindex>
-<para>A <dfn>discretionary</dfn> multiplication symbol, at which a line break is
-allowed. Without the break multiplication is implicitly indicated by a
-space, while in the case of a break a <U>00D7</U> symbol is
-printed immediately before the break. So
+<para>&latex; contains a wide variety of mathematics facilities. Here are
+some that don&textrsquo;t fit into other categories.
+</para>
+<menu endspaces=" ">
+<menuentry leadingtext="* "><menunode separator=":: ">Colon character &amp; \colon</menunode><menudescription><pre xml:space="preserve">Colon.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\*</menunode><menudescription><pre xml:space="preserve">Discretionary multiplication.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\frac</menunode><menudescription><pre xml:space="preserve">Fraction.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\left &amp; \right</menunode><menudescription><pre xml:space="preserve">Paired delimiters.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\sqrt</menunode><menudescription><pre xml:space="preserve">Radicals.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\stackrel</menunode><menudescription><pre xml:space="preserve">Text over a relation.
+</pre></menudescription></menuentry></menu>
+
+
+<node name="Colon-character-_0026-_005ccolon" spaces=" "><nodename trailingspaces=" ">Colon character &amp; \colon</nodename><nodenext automatic="on">\*</nodenext><nodeup automatic="on">Math miscellany</nodeup></node>
+<subsection spaces=" "><sectiontitle>Colon character <code>:</code> &amp; <code>\colon</code></sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="545">:</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="546">colon character</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="812" mergedindex="cp">:</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="813" mergedindex="cp">\colon</indexterm></findex>
+
+<para>Synopsis, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\documentclass&lbrace;article&rbrace;
-\begin&lbrace;document&rbrace;
-Now \(A_3 = 0\), hence the product of all terms \(A_1\)
-through \(A_4\), that is \(A_1\* A_2\* A_3 \* A_4\), is
-equal to zero.
-\end&lbrace;document&rbrace;
+<pre xml:space="preserve">:
+\colon
</pre></example>
-<para>will make that sort of output<!-- c -->
-<w> </w>(the ellipsis <samp>[&dots;]</samp> is here to show the line break at
-the same place as in a &tex; output)<!-- c -->
-:
+<para>In mathematics, the colon character, <code>:</code>, is a relation.
</para>
-<indentedblock endspaces=" ">
-<para>Now <math>A_3 = 0</math>,
-[&dots;]
-<math>A_1</math>
-through <math>A_4</math>, that is <math>A_1 A_2 \times</math>&linebreak;<math>A_3 A_4</math>, is
-equal to zero.
-</para></indentedblock>
+<example endspaces=" ">
+<pre xml:space="preserve">With side ratios \( 3:4 \) and \( 4:5 \), the triangle is right.
+</pre></example>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="793">\cdots</indexterm>\cdots</itemformat></item>
-</tableterm><tableitem><para>A horizontal ellipsis with the dots raised to the center of the line.
-<tex endspaces=" ">
-</tex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="547"><r>package</r>, <code>amsmath</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="548"><code>amsmath</code> <r>package</r></indexterm></cindex>
+
+<noindent></noindent>
+<para>Ordinary &latex; defines <code>\colon</code> to produce the colon character
+with the spacing appropriate for punctuation, as in set-builder notation
+<code>\&lbrace;x\colon 0\leq x&lt;1\&rbrace;</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="794">\ddots</indexterm>\ddots</itemformat></item>
-</tableterm><tableitem><para>A diagonal ellipsis: <math>\ddots</math>.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="549"><r>package</r>, <code>amsmath</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="550"><code>amsmath</code> <r>package</r></indexterm></cindex>
+
+<para>But the widely-used <file>amsmath</file> package defines <code>\colon</code> for use
+in the definition of functions <code>f\colon D\to C</code>. So if you want
+the colon character as a punctuation then use <code>\mathpunct&lbrace;:&rbrace;</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="795">\frac&lbrace;<var>num</var>&rbrace;&lbrace;<var>den</var>&rbrace;</indexterm>\frac&lbrace;<var>num</var>&rbrace;&lbrace;<var>den</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="796">\frac</indexterm></findex>
-<para>Produces the fraction <var>num</var> divided by <var>den</var>.
+
+</subsection>
+<node name="_005c_002a" spaces=" "><nodename trailingspaces=" ">\*</nodename><nodenext automatic="on">\frac</nodenext><nodeprev automatic="on">Colon character &amp; \colon</nodeprev><nodeup automatic="on">Math miscellany</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\*</code></sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="551">multiplication, discretionary</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="552">breaks, multiplication discretionary</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="553">line breaks, multiplication discretionary</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="554">discretionary breaks, multiplication</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="814" mergedindex="cp">\*</indexterm></findex>
+
+<para>Synopsis:
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\*
+</pre></example>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="797">\left <var>delim1</var> ... \right <var>delim2</var></indexterm>\left <var>delim1</var> ... \right <var>delim2</var></itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="798">\right</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="415">null delimiter</indexterm></cindex>
-<para>The two delimiters need not match; <samp>.</samp> acts as a <dfn>null delimiter</dfn>,
-producing no output. The delimiters are sized according to the math
-in between. Example: <code>\left( \sum_&lbrace;i=1&rbrace;^&lbrace;10&rbrace; a_i \right]</code>.
+<para>A multiplication symbol that allows a line break. If there is a break
+then &latex; puts a <code>\times</code> symbol, <U>00D7</U>, before
+that break.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="799">\mathdollar</indexterm>\mathdollar</itemformat></item>
-</tableterm><tableitem><para>Dollar sign in math mode: $.
+<para>In <code>\( A_1\* A_2\* A_3\* A_4 \)</code>, if there is no line break then
+&latex; outputs it as though it were <code>\( A_1 A_2 A_3 A_4 \)</code>. If
+a line break does happen, for example between the two middle ones, then
+&latex; sets it like <code>\( A_1 A_2 \times \)</code>, followed by the
+break, followed by <code>\( A_3 A_4 \)</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="800">\mathellipsis</indexterm>\mathellipsis</itemformat></item>
-</tableterm><tableitem><para>Ellipsis (spaced for text) in math mode: &dots;.
+
+</subsection>
+<node name="_005cfrac" spaces=" "><nodename>\frac</nodename><nodenext automatic="on">\left &amp; \right</nodenext><nodeprev automatic="on">\*</nodeprev><nodeup automatic="on">Math miscellany</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\frac</code> </sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="555">fraction</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="815" mergedindex="cp">\frac</indexterm></findex>
+
+<para>Synopsis:
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="801">\mathparagraph</indexterm>\mathparagraph</itemformat></item>
-</tableterm><tableitem><para>Paragraph sign (pilcrow) in math mode: <U>00B6</U>.
+<example endspaces=" ">
+<pre xml:space="preserve">\frac&lbrace;<var>numerator</var>&rbrace;&lbrace;<var>denominator</var>&rbrace;
+</pre></example>
+
+<para>Produces the fraction. Used as: <code>\begin&lbrace;displaymath&rbrace;
+\frac&lbrace;1&rbrace;&lbrace;\sqrt&lbrace;2\pi\sigma&rbrace;&rbrace; \end&lbrace;displaymath&rbrace;</code>. In inline math
+mode it comes out small; see the discussion of <code>\displaystyle</code>
+(<pxref label="Math-formulas"><xrefnodename>Math formulas</xrefnodename></pxref>).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="802">\mathsection</indexterm>\mathsection</itemformat></item>
-</tableterm><tableitem><para>Section sign in math mode.
+
+</subsection>
+<node name="_005cleft-_0026-_005cright" spaces=" "><nodename>\left &amp; \right</nodename><nodenext automatic="on">\sqrt</nodenext><nodeprev automatic="on">\frac</nodeprev><nodeup automatic="on">Math miscellany</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\left</code> &amp; <code>\right</code></sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="556">delimiters, paired</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="557">paired delimiters</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="558">matching parentheses</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="559">matching brackets</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="560">null delimiter</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="816" mergedindex="cp">\left</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="817" mergedindex="cp">\right</indexterm></findex>
+
+<para>Synopsis:
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="803">\mathsterling</indexterm>\mathsterling</itemformat></item>
-</tableterm><tableitem><para>Sterling sign in math mode: &pound;.
+<example endspaces=" ">
+<pre xml:space="preserve">\left <var>delimiter1</var> ... \right <var>delimiter2</var>
+</pre></example>
+
+<para>Make matching parentheses, braces, or other delimiters. The delimiters
+are sized according to the math they enclose. This makes a unit vector
+surrounded by appropriate-height parentheses.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="804">\mathunderscore</indexterm>\mathunderscore</itemformat></item>
-</tableterm><tableitem><para>Underscore in math mode: _.
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;equation&rbrace;
+ \left(\begin&lbrace;array&rbrace;&lbrace;c&rbrace;
+ 1 \\
+ 0 \\
+ \end&lbrace;array&rbrace;\right)
+</pre></example>
+
+<para>Every <code>\left</code> must have a matching <code>\right</code>. Leaving out the
+<code>\left(</code> in the above gets <samp>Extra \right</samp>. Leaving off the
+<code>\right)</code> gets <samp>You can't use `\eqno' in math mode</samp>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="805">\overbrace&lbrace;<var>math</var>&rbrace;</indexterm>\overbrace&lbrace;<var>math</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Generates a brace over <var>math</var>.
-For example, <code>\overbrace&lbrace;x+\cdots+x&rbrace;^&lbrace;k \;\textrm&lbrace;times&rbrace;&rbrace;</code>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="806">\overline&lbrace;<var>text</var>&rbrace;</indexterm>\overline&lbrace;<var>text</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Generates a horizontal line over <var>tex</var>.
-For example, <code>\overline&lbrace;x+y&rbrace;</code>.
+<para>However, the two delimiters <var>delimiter1</var> and <var>delimiter2</var> need
+not match. A common case is that you want an unmatched brace, as
+below. Use a period, <samp>.</samp>, as a null delimiter.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="807">\sqrt[<var>root</var>]&lbrace;<var>arg</var>&rbrace;</indexterm>\sqrt[<var>root</var>]&lbrace;<var>arg</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Produces the representation of the square root of <var>arg</var>. The
-optional argument <var>root</var> determines what root to produce. For
-example, the cube root of <code>x+y</code> would be typed as
-<code>\sqrt[3]&lbrace;x+y&rbrace;</code>.
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;equation&rbrace;
+ f(n)=\left\&lbrace;\begin&lbrace;array&rbrace;&lbrace;ll&rbrace;
+ 1 &amp;\mbox&lbrace;--if \(n=0\)&rbrace; \\
+ f(n-1)+3n^2 &amp;\mbox&lbrace;--else&rbrace;
+ \end&lbrace;array&rbrace;\right.
+\end&lbrace;equation&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>Note that to get a curly brace as a delimiter you must prefix it with a
+backslash, <code>\&lbrace;</code>.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="808">\stackrel&lbrace;<var>text</var>&rbrace;&lbrace;<var>relation</var>&rbrace;</indexterm>\stackrel&lbrace;<var>text</var>&rbrace;&lbrace;<var>relation</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Puts <var>text</var> above <var>relation</var>. For example,
-<code>\stackrel&lbrace;f&rbrace;&lbrace;\longrightarrow&rbrace;</code>.
+
+</subsection>
+<node name="_005csqrt" spaces=" "><nodename>\sqrt</nodename><nodenext automatic="on">\stackrel</nodenext><nodeprev automatic="on">\left &amp; \right</nodeprev><nodeup automatic="on">Math miscellany</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\sqrt</code></sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="561">square root</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="562">roots</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="563">radical</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="818" mergedindex="cp">\sqrt</indexterm></findex>
+
+<para>Synopsis, one of:
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="809">\underbrace&lbrace;<var>math</var>&rbrace;</indexterm>\underbrace&lbrace;<var>math</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Generates <var>math</var> with a brace underneath. For example, <code>\underbrace&lbrace;x+y+z&rbrace;_&lbrace;&gt;\,0&rbrace;</code>
+<example endspaces=" ">
+<pre xml:space="preserve">\sqrt&lbrace;<var>arg</var>&rbrace;
+\sqrt[<var>root-number</var>]&lbrace;<var>arg</var>&rbrace;
+</pre></example>
+
+<para>The square root, or optionally other roots, of <var>arg</var>. The optional
+argument <var>root-number</var> gives the root, i.e., enter the cube root of
+<code>x+y</code> as <code>\sqrt[3]&lbrace;x+y&rbrace;</code>.
+The radical grows with the size of <var>arg</var> (as the height of the
+radical grows, the angle on the leftmost part gets steeper, until for
+a large enough <code>arg</code>, it is vertical).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="810">\underline&lbrace;<var>text</var>&rbrace;</indexterm>\underline&lbrace;<var>text</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Causes <var>text</var>, which may be either math mode or not, to be
-underlined. The line is always below the text, taking account of
-descenders.
+<para>&latex; has a separate <code>\surd</code> character (<pxref label="Math-symbols"><xrefnodename>Math symbols</xrefnodename></pxref>).
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="811">\vdots</indexterm>\vdots</itemformat></item>
-</tableterm><tableitem><para>Produces a vertical ellipsis.
+
+</subsection>
+<node name="_005cstackrel" spaces=" "><nodename>\stackrel</nodename><nodeprev automatic="on">\sqrt</nodeprev><nodeup automatic="on">Math miscellany</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\stackrel</code></sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="564">stack math</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="565">relation, text above</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="819" mergedindex="cp">\stackrel</indexterm></findex>
+
+<para>Synopsis, one of:
</para>
-</tableitem></tableentry></ftable>
+<example endspaces=" ">
+<pre xml:space="preserve">\stackrel&lbrace;<var>text</var>&rbrace;&lbrace;<var>relation</var>&rbrace;
+</pre></example>
+<para>Put <var>text</var> above <var>relation</var>. To put a function name above an
+arrow enter <code>\stackrel&lbrace;f&rbrace;&lbrace;\longrightarrow&rbrace;</code>.
+</para>
+</subsection>
</section>
</chapter>
<node name="Modes" spaces=" "><nodename>Modes</nodename><nodenext automatic="on">Page styles</nodenext><nodeprev automatic="on">Math formulas</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Modes</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="416">modes</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="417">paragraph mode</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="418">math mode</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="419">left-to-right mode</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="420">LR mode</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="566">modes</indexterm></cindex>
-<para>When &latex; is processing your input text, it is always in one of three
-modes:
+<para>As &latex; processes your document, at any point it is in one of six
+modes. They fall into three categories of two each, the horizontal
+modes, the math modes, and the vertical modes. Some commands only work
+in one mode or another (in particular, many commands only work in one of
+the math modes), and error messages will refer to these.
</para>
-<itemize commandarg="bullet" spaces=" " endspaces=" "><itemprepend><formattingcommand command="bullet"/></itemprepend>
+<itemize commandarg="bullet" endspaces=" ">
<listitem><prepend>&bullet;</prepend>
-<para>Paragraph mode
-</para></listitem><listitem><prepend>&bullet;</prepend>
-<para>Math mode
-</para></listitem><listitem><prepend>&bullet;</prepend>
-<para>Left-to-right mode, called LR mode for short
-</para></listitem></itemize>
+<anchor name="modes-paragraph-mode">modes paragraph mode</anchor>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="567">paragraph mode</indexterm></cindex>
+<para><dfn>Paragraph mode</dfn> is what &latex; is in when processing ordinary
+text. It breaks the input text into lines and breaks the lines into
+pages. This is the mode &latex; is in most of the time.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="568">left-to-right mode</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="569">LR mode</indexterm></cindex>
+<anchor name="modes-lr-mode">modes lr mode</anchor>
+<para><dfn>LR mode</dfn> (for left-to-right mode; in plain &tex; this is called
+<dfn>restricted horizontal mode</dfn>) is in effect when &latex; starts
+making a box with an <code>\mbox</code> command. As in paragraph mode,
+&latex;&textrsquo;s output is a string of words with spaces between them. Unlike
+in paragraph mode, in LR mode &latex; never starts a new line, it just
+keeps going from left to right. (Although &latex; will not complain
+that the LR box is too long, when it is finished and next tries to put
+that box into a line, it could very well complain that the finished LR
+box won&textrsquo;t fit there.)
+</para>
+</listitem><listitem><prepend>&bullet;</prepend>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="570">math mode</indexterm></cindex>
+<anchor name="modes-math-mode">modes math mode</anchor> <para><dfn>Math mode</dfn> is when &latex; is generating
+an inline mathematical formula.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="571">display math mode</indexterm></cindex>
+<para><dfn>Display math mode</dfn> is when &latex; is generating a displayed
+mathematical formula. (Displayed formulas differ somewhat from inline
+ones. One example is that the placement of the subscript on <code>\int</code>
+differs in the two situations.)
+</para>
+</listitem><listitem><prepend>&bullet;</prepend>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="572">vertical mode</indexterm></cindex>
+<anchor name="modes-vertical-mode">modes vertical mode</anchor>
+<para><dfn>Vertical mode</dfn> is when &latex; is building the list of lines and
+other material making the output page. This is the mode &latex; is in
+when it starts a document.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="573">internal vertical mode</indexterm></cindex>
+<anchor name="modes-internal-vertical-mode">modes internal vertical mode</anchor>
+<para><dfn>Internal vertical mode</dfn> is in effect when &latex; starts making a
+<code>\vbox</code>. This is the vertical analogue of LR mode.
+</para>
+</listitem></itemize>
-<para>Mode changes occur only when entering or leaving an environment, or when
-&latex; is processing the argument of certain text-producing commands.
-</para>
-<para><dfn>Paragraph mode</dfn> is the most common; it&textrsquo;s the one &latex; is in
-when processing ordinary text. In this mode, &latex; breaks the
-input text into lines and breaks the lines into pages.
-</para>
-<para>&latex; is in <dfn>math mode</dfn> when it&textrsquo;s generating a mathematical
-formula, either displayed math or within a line.
-</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="812">\mbox<r>, and LR mode</r></indexterm></findex>
-<para>In <dfn>LR mode</dfn>, as in paragraph mode, &latex; considers the output
-that it produces to be a string of words with spaces between them.
-However, unlike paragraph mode, &latex; keeps going from left to
-right; it never starts a new line in LR mode. Even if you put a
-hundred words into an <code>\mbox</code>, &latex; would keep typesetting
-them from left to right inside a single box (and then most likely
-complain because the resulting box was too wide to fit on the line).
-&latex; is in LR mode when it starts making a box with an
-<code>\mbox</code> command. You can get it to enter a different mode inside
-the box&textmdash;for example, you can make it enter math mode to put a
-formula in the box.
-</para>
-<para>There are also several text-producing commands and environments for
-making a box that put &latex; into paragraph mode. The box made by
-one of these commands or environments will be called a <code>parbox</code>.
-When &latex; is in paragraph mode while making a box, it is said to
-be in &textldquo;inner paragraph mode&textrdquo; (no page breaks). Its normal paragraph
-mode, which it starts out in, is called &textldquo;outer paragraph mode&textrdquo;.
+<noindent></noindent>
+<para>For instance, if you begin a &latex; article with <samp>Let \( x \) be
+...</samp> then these are the modes: first &latex; starts every document in
+vertical mode, then it reads the <samp>L</samp> and switches to paragraph
+mode, then the next switch happens at the <samp>\(</samp> where &latex;
+changes to math mode, and then when it leaves the formula it pops
+back to paragraph mode.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="574">inner paragraph mode</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="575">outer paragraph mode</indexterm></cindex>
+<anchor name="modes-inner-paragraph-mode">modes inner paragraph mode</anchor>
+<anchor name="modes-outer-paragraph-mode">modes outer paragraph mode</anchor>
+<para>Paragraph mode has two subcases. If you use a <code>\parbox</code> command or
+or a <code>minipage</code> then &latex; is put into paragraph mode. But it
+will not put a page break here. Inside one of these boxes, called a
+<dfn>parbox</dfn>, &latex; is in <dfn>inner paragraph mode</dfn>. Its more usual
+situation, where it can put page breaks, is <dfn>outer paragraph mode</dfn>
+(<pxref label="Page-breaking"><xrefnodename>Page breaking</xrefnodename></pxref>).
</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\ensuremath</menunode><menudescription><pre xml:space="preserve">Ensure that math mode is active
@@ -9478,48 +12705,47 @@ mode, which it starts out in, is called &textldquo;outer paragraph mode&textrdqu
<pre xml:space="preserve">\ensuremath&lbrace;<var>formula</var>&rbrace;
</pre></example>
-<para>The <code>\ensuremath</code> command ensures that <var>formula</var> is typeset in
-math mode whatever the current mode in which the command is used.
+<para>Ensure that <var>formula</var> is typeset in math mode.
</para>
-<para>For instance:
+<para>For instance, you can redefine commands that ordinarily can be used only
+in math mode, so that they can be used both in math and in plain text.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\documentclass&lbrace;report&rbrace;
-\newcommand&lbrace;\ab&rbrace;&lbrace;\ensuremath&lbrace;(\delta, \varepsilon)&rbrace;&rbrace;
-\begin&lbrace;document&rbrace;
-Now, the \ab\ pair is equal to \(\ab = (\frac&lbrace;1&rbrace;&lbrace;\pi&rbrace;, 0)\), ...
-\end&lbrace;document&rbrace;
+<pre xml:space="preserve">\newcommand&lbrace;\dx&rbrace;&lbrace;\ensuremath&lbrace;dx&rbrace;&rbrace;
+In $\int f(x)\, \dx$, the \dx&lbrace;&rbrace; is an infinitesimal.
</pre></example>
-<para>One can redefine commands that can be used only in math mode so that
-they ca be used in any mode like in the following example given for
-<code>\leadsto</code>:
+<para>Caution: the <code>\ensuremath</code> command is useful but not a panacea.
</para>
-<!-- c Vincent 2 Karl : "Tous les chemins mènent à Rome" is a French saying -->
-<!-- c meaning that there are many different ways to get the same result. I -->
-<!-- c am not sure whether in English the given example is also funny. -->
<example endspaces=" ">
-<pre xml:space="preserve">\documentclass&lbrace;report&rbrace;
-\usepackage&lbrace;amssymb&rbrace;
-\newcommand&lbrace;\originalMeaningOfLeadsTo&rbrace;&lbrace;&rbrace;
-\let\originalMeaningOfLeadsTo\leadsto
-\renewcommand\leadsto&lbrace;\ensuremath&lbrace;\originalMeaningOfLeadsTo&rbrace;&rbrace;
-\begin&lbrace;document&rbrace;
-All roads \leadsto\ Rome.
-\end&lbrace;document&rbrace;
+<pre xml:space="preserve">\newcommand&lbrace;\alf&rbrace;&lbrace;\ensuremath&lbrace;\alpha&rbrace;&rbrace;
+You get an alpha in text mode: \alf.
+But compare the correct spacing in $\alf+\alf$ with that in \alf+\alf.
</pre></example>
+<noindent></noindent>
+<para>Best is to typeset math things in a math mode.
+</para>
</section>
</chapter>
<node name="Page-styles" spaces=" "><nodename>Page styles</nodename><nodenext automatic="on">Spaces</nodenext><nodeprev automatic="on">Modes</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Page styles</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="421">styles, page</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="422">page styles</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="576">styles, page</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="577">page styles</indexterm></cindex>
-<para>The <code>\documentclass</code> command determines the size and position of
-the page&textrsquo;s head and foot. The page style determines what goes in them.
+<para>The style of a page determines where &latex; places the components of
+that page, such as headers and footers, and the text body. This
+includes pages in the main part of the document but also includes
+special pages such as the title page of a book, a page from an index, or
+the first page of an article.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="578"><r>package</r>, <code>fancyhdr</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="579"><code>fancyhdr</code> <r>package</r></indexterm></cindex>
+
+<para>The package <file>fancyhdr</file> is very helpful for constructing page
+styles. See its documentation on CTAN.
</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\maketitle</menunode><menudescription><pre xml:space="preserve">Generate a title page.
@@ -9532,88 +12758,173 @@ the page&textrsquo;s head and foot. The page style determines what goes in them
<node name="_005cmaketitle" spaces=" "><nodename>\maketitle</nodename><nodenext automatic="on">\pagenumbering</nodenext><nodeup automatic="on">Page styles</nodeup></node>
<section spaces=" "><sectiontitle><code>\maketitle</code></sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="423">titles, making</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="813">\maketitle</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="580">titles, making</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="820" mergedindex="cp">\maketitle</indexterm></findex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\maketitle
+</pre></example>
+
+<para>Generate a title. In the standard classes the title appears on a
+separate page, except in the <code>article</code> class where it is at the top
+of the first page. (<xref label="Document-class-options"><xrefnodename>Document class options</xrefnodename></xref> for information about
+the <code>titlepage</code> document class option.)
+</para>
+<para>This example shows <code>\maketitle</code> appearing in its usual place,
+immediately after <code>\begin&lbrace;document&rbrace;</code>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;article&rbrace;
+\title&lbrace;Constructing a Nuclear Reactor Using Only Coconuts&rbrace;
+\author&lbrace;Jonas Grumby\thanks&lbrace;%
+ With the support of a Ginger Grant from the Roy Hinkley Society.&rbrace; \\
+ Skipper, \textit&lbrace;Minnow&rbrace;
+ \and
+ Willy Gilligan\thanks&lbrace;%
+ Thanks to the Mary Ann Summers foundation
+ and to Thurston and Lovey Howell.&rbrace; \\
+ Mate, \textit&lbrace;Minnow&rbrace;
+ &rbrace;
+\date&lbrace;1964-Sep-26&rbrace;
+\begin&lbrace;document&rbrace;
+\maketitle
+Just sit right back and you'll hear a tale, a tale of a fateful trip.
+That started from this tropic port, aboard this tiny ship. The mate was
+a mighty sailin' man, the Skipper brave and sure. Five passengers set
+sail that day for a three hour tour. A three hour tour.
+ ...
+</pre></example>
-<para>The <code>\maketitle</code> command generates a title on a separate title
-page&textmdash;except in the <code>article</code> class, where the title is placed
-at the top of the first page. Information used to produce the title
-is obtained from the following declarations:
+<para>You tell &latex; the information used to produce the title by making
+the following declarations. These must come before the
+<code>\maketitle</code>, either in the preamble or in the document body.
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="814">\author&lbrace;<var>name</var> \and <var>name2</var>&rbrace;</indexterm>\author&lbrace;<var>name</var> \and <var>name2</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="424">author, for titlepage</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="815">\\ <r>for <code>\author</code></r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="816">\and <r>for <code>\author</code></r></indexterm></findex>
-<para>The <code>\author</code> command declares the document author(s), where the
-argument is a list of authors separated by <code>\and</code> commands. Use
-<code>\\</code> to separate lines within a single author&textrsquo;s entry&textmdash;for
-example, to give the author&textrsquo;s institution or address.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="817">\date&lbrace;<var>text</var>&rbrace;</indexterm>\date&lbrace;<var>text</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="425">date, for titlepage</indexterm></cindex>
-<para>The <code>\date</code> command declares <var>text</var> to be the document&textrsquo;s
-date. With no <code>\date</code> command, the current date (<pxref label="_005ctoday"><xrefnodename>\today</xrefnodename></pxref>)
-is used.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="818">\thanks&lbrace;<var>text</var>&rbrace;</indexterm>\thanks&lbrace;<var>text</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="426">thanks, for titlepage</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="427">credit footnote</indexterm></cindex>
-<para>The <code>\thanks</code> command produces a <code>\footnote</code> to the title,
-usually used for credit acknowledgements.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="819">\title&lbrace;<var>text</var>&rbrace;</indexterm>\title&lbrace;<var>text</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="428">title, for titlepage</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="820">\\ <r>for <code>\title</code></r></indexterm></findex>
-<para>The <code>\title</code> command declares <var>text</var> to be the title of the
-document. Use <code>\\</code> to force a line break, as usual.
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="821" mergedindex="cp">\author&lbrace;<var>name1</var> \and <var>name2</var> \and ...&rbrace;</indexterm>\author&lbrace;<var>name1</var> \and <var>name2</var> \and ...&rbrace;</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="581">author, for titlepage</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="822" mergedindex="cp">\\ <r>for <code>\author</code></r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="823" mergedindex="cp">\and <r>for <code>\author</code></r></indexterm></findex>
+<para>Required. Declare the document author or authors. The argument is a
+list of authors separated by <code>\and</code> commands. To separate lines
+within a single author&textrsquo;s entry, for instance to give the author&textrsquo;s
+institution or address, use a double backslash, <code>\\</code>. If you omit
+the <code>\author</code> declaration then you get <samp>LaTeX Warning: No
+\author given</samp>.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="824" mergedindex="cp">\date&lbrace;<var>text</var>&rbrace;</indexterm>\date&lbrace;<var>text</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="582">date, for titlepage</indexterm></cindex>
+<para>Optional. Declare <var>text</var> to be the document&textrsquo;s date. The <var>text</var>
+doesn&textrsquo;t need to be in a date format; it can be any text at all. If you
+omit <code>\date</code> then &latex; uses the current date (<pxref label="_005ctoday"><xrefnodename>\today</xrefnodename></pxref>).
+To have no date, instead use <code>\date&lbrace;&rbrace;</code>.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="825" mergedindex="cp">\thanks&lbrace;<var>text</var>&rbrace;</indexterm>\thanks&lbrace;<var>text</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="583">thanks, for titlepage</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="584">credit footnote</indexterm></cindex>
+<para>Optional. Produce a footnote. You can use it in the author information
+for acknowledgements, as illustrated below, but you can also use it in
+the title, or any place a footnote makes sense. It can be any text so
+you can use it to print an email address, or for any purpose.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="826" mergedindex="cp">\title&lbrace;<var>text</var>&rbrace;</indexterm>\title&lbrace;<var>text</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="585">title, for titlepage</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="827" mergedindex="cp">\\ <r>for <code>\title</code></r></indexterm></findex>
+<para>Required. Declare <var>text</var> to be the title of the document. Get line
+breaks inside <var>text</var> with a double backslash, <code>\\</code>. If you
+omit the <code>\title</code> declaration then you get <samp>LaTeX Error: No
+\title given</samp>.
</para>
</tableitem></tableentry></ftable>
+<para>Many publishers will provide a class to use in place of <code>article</code>
+in that example, that formats the title according to their house
+requirements. To make your own, see&nbsp;<ref label="titlepage"><xrefnodename>titlepage</xrefnodename></ref>. You can
+either create this as a one-off or you can include it as part of a
+renewed <code>\maketitle</code> command.
+</para>
</section>
<node name="_005cpagenumbering" spaces=" "><nodename>\pagenumbering</nodename><nodenext automatic="on">\pagestyle</nodenext><nodeprev automatic="on">\maketitle</nodeprev><nodeup automatic="on">Page styles</nodeup></node>
<section spaces=" "><sectiontitle><code>\pagenumbering</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="821">\pagenumbering</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="429">page numbering style</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="828" mergedindex="cp">\pagenumbering</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="586">page numbering style</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\pagenumbering&lbrace;<var>style</var>&rbrace;
+<pre xml:space="preserve">\pagenumbering&lbrace;<var>number-style</var>&rbrace;
</pre></example>
-<para>Specifies the style of page numbers, according to <var>style</var>; also
-resets the page number to 1. The <var>style</var> argument is one of
-the following:
+<para>Specifies the style of page numbers, and resets the page number. The
+numbering style is reflected on the page, and also in the table of
+contents and other page references. This declaration has global scope
+so its effect is not delimited by braces or environments.
+</para>
+<para>In this example, before the Main section the pages are numbered
+<samp>a</samp>, etc. Starting on the page containing that section, the pages
+are numbered <samp>1</samp>, etc.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;document&rbrace;\pagenumbering&lbrace;alph&rbrace;
+ ...
+\section&lbrace;Main&rbrace;\pagenumbering&lbrace;arabic&rbrace;
+ ...
+</pre></example>
+
+<para>The argument <var>number-style</var> is one of the following (see
+also&nbsp;<ref label="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol"><xrefnodename>\alph \Alph \arabic \roman \Roman \fnsymbol</xrefnodename></ref>).
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">arabic</itemformat></item>
-</tableterm><tableitem><para>arabic numerals
+</tableterm><tableitem><para>arabic numerals: 1, 2, &dots;
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">roman</itemformat></item>
-</tableterm><tableitem><para>lowercase Roman numerals
+</tableterm><tableitem><para>lowercase Roman numerals: i, ii, &dots;
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">Roman</itemformat></item>
-</tableterm><tableitem><para>uppercase Roman numerals
+</tableterm><tableitem><para>uppercase Roman numerals: I, II, &dots;
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">alph</itemformat></item>
-</tableterm><tableitem><para>lowercase letters
+</tableterm><tableitem><para>lowercase letters: a, b, &dots; If you have more than 26 pages then you
+get <samp>LaTeX Error: Counter too large</samp>.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">Alph</itemformat></item>
-</tableterm><tableitem><para>uppercase letters
-</para></tableitem></tableentry></table>
+</tableterm><tableitem><para>uppercase letters: A, B, &dots; If you have more than 26 pages then you
+get <samp>LaTeX Error: Counter too large</samp>.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">gobble</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="587"><r>package</r>, <code>hyperref</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="588"><code>hyperref</code> <r>package</r></indexterm></cindex>
+ <para>&latex; does not output a page number, although it
+does get reset. References to that page also are blank. (This does not
+work with the popular package <file>hyperref</file> so to have the page number
+not appear you may want to instead use <code>\pagestyle&lbrace;empty&rbrace;</code> or
+<code>\thispagestyle&lbrace;empty&rbrace;</code>.)
+</para>
+</tableitem></tableentry></table>
+<para>Traditionally, if a document has front matter&textmdash;preface, table of
+contents, etc.&textmdash;then it is numbered with lowercase Roman numerals. The
+main matter of a document uses arabic. <xref label="_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter"><xrefnodename>\frontmatter &amp; \mainmatter
+&amp; \backmatter</xrefnodename></xref>.
+</para>
+<para>If you want to address where the page number appears on the page,
+see&nbsp;<ref label="_005cpagestyle"><xrefnodename>\pagestyle</xrefnodename></ref>. If you want to change the value of page
+number then you will manipulate the <code>page</code> counter
+(<pxref label="Counters"><xrefnodename>Counters</xrefnodename></pxref>).
+</para>
</section>
<node name="_005cpagestyle" spaces=" "><nodename>\pagestyle</nodename><nodenext automatic="on">\thispagestyle</nodenext><nodeprev automatic="on">\pagenumbering</nodeprev><nodeup automatic="on">Page styles</nodeup></node>
<section spaces=" "><sectiontitle><code>\pagestyle</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="822">\pagestyle</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="430">header style</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="431">footer style</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="432">running header and footer style</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="829" mergedindex="cp">\pagestyle</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="589">header style</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="590">footer style</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="591">running header and footer style</indexterm></cindex>
<para>Synopsis:
</para>
@@ -9621,19 +12932,30 @@ the following:
<pre xml:space="preserve">\pagestyle&lbrace;<var>style</var>&rbrace;
</pre></example>
-<para>The <code>\pagestyle</code> command specifies how the headers and footers
-are typeset from the current page onwards. Values for <var>style</var>:
+<para>Declaration that specifies how the page headers and footers are typeset,
+from the current page onwards.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="592"><r>package</r>, <code>fancyhdr</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="593"><code>fancyhdr</code> <r>package</r></indexterm></cindex>
+
+<para>A discussion with an example is below. Note first that the package
+<file>fancyhdr</file> is now the standard way to manipulate headers and
+footers. New documents that need to do anything other than one of the
+standard options below should use this package. See its documentation
+on CTAN.
+</para>
+<para>Values for <var>style</var>:
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">plain</itemformat></item>
-</tableterm><tableitem><para>Just a plain page number.
+</tableterm><tableitem><para>The header is empty. The footer contains only a page number, centered.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">empty</itemformat></item>
-</tableterm><tableitem><para>Empty headers and footers, e.g., no page numbers.
+</tableterm><tableitem><para>The header and footer is empty.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">headings</itemformat></item>
-</tableterm><tableitem><para>Put running headers on each page. The document style specifies what
-goes in the headers.
+</tableterm><tableitem><para>Put running headers and footers on each page. The document style
+specifies what goes in there; see the discussion below.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">myheadings</itemformat></item>
</tableterm><tableitem><para>Custom headers, specified via the <code>\markboth</code> or the
@@ -9641,32 +12963,105 @@ goes in the headers.
</para>
</tableitem></tableentry></table>
+<para>Some discussion of the motivation for &latex;&textrsquo;s mechanism will help you
+work with the options <code>headings</code> or <code>myheadings</code>. The
+document source below produces an article, two-sided, with the pagestyle
+<code>headings</code>. On this document&textrsquo;s left hand pages, &latex; wants (in
+addition to the page number) the title of the current section. On its
+right hand pages &latex; wants the title of the current subsection.
+When it makes up a page, &latex; gets this information from the
+commands <code>\leftmark</code> and <code>\rightmark</code>. So it is up to
+<code>\section</code> and <code>\subsection</code> to store that information there.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass[twoside]&lbrace;article&rbrace;
+\pagestyle&lbrace;headings&rbrace;
+\begin&lbrace;document&rbrace;
+ ... \section&lbrace;Section 1&rbrace; ... \subsection&lbrace;Subsection 1.1&rbrace; ...
+\section&lbrace;Section 2&rbrace;
+ ...
+\subsection&lbrace;Subsection 2.1&rbrace;
+ ...
+\subsection&lbrace;Subsection 2.2&rbrace;
+ ...
+</pre></example>
+
+<noindent></noindent>
+<para>Suppose that the second section falls on a left page. Although when the
+page starts it is in the first section, &latex; will put
+<samp>Section&nbsp;2</samp> in the left page header. As to the right header,
+if no subsection starts before the end of the right page then &latex;
+blanks the right hand header. If a subsection does appear before the
+right page finishes then there are two cases. If at least one
+subsection starts on the right hand page then &latex; will put in the
+right header the title of the first subsection starting on that right
+page. If at least one of 2.1, 2.2, &dots;, starts on the left page but
+none starts on the right then &latex; puts in the right hand header the
+title of the last subsection to start, that is, the one in effect during
+the right hand page.
+</para>
+<para>To accomplish this, in a two-sided article, &latex; has <code>\section</code>
+issue a command <code>\markboth</code>, setting <code>\leftmark</code>
+to <samp>Section&nbsp;2</samp> and setting <code>\rightmark</code> to blank.
+And, &latex; has <code>\subsection</code> issue a command <code>\markright</code>,
+setting <code>\rightmark</code> to <samp>Subsection&nbsp;2.1</samp>, etc.
+</para>
<para>Here are the descriptions of <code>\markboth</code> and <code>\markright</code>:
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="823">\markboth&lbrace;<var>left</var>&rbrace;&lbrace;<var>right</var>&rbrace;</indexterm>\markboth&lbrace;<var>left</var>&rbrace;&lbrace;<var>right</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Sets both the left and the right heading. A &textldquo;left-hand heading&textrdquo;
-(<var>left</var>) is generated by the last <code>\markboth</code> command before
-the end of the page, while a &textldquo;right-hand heading&textrdquo; (<var>right</var>) is
-generated by the first <code>\markboth</code> or <code>\markright</code> that
-comes on the page if there is one, otherwise by the last one before
-the page.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="824">\markright&lbrace;<var>right</var>&rbrace;</indexterm>\markright&lbrace;<var>right</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><para>Sets the right heading, leaving the left heading unchanged.
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="830" mergedindex="cp">\markboth&lbrace;<var>left-head</var>&rbrace;&lbrace;<var>right-head</var>&rbrace;</indexterm>\markboth&lbrace;<var>left-head</var>&rbrace;&lbrace;<var>right-head</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><para>Sets both the right hand and left hand heading information for either a
+page style of <code>headings</code> or <code>myheadings</code>. A left hand page
+heading <var>left-head</var> is generated by the last <code>\markboth</code>
+command before the end of the page. A right hand page heading
+<var>right-head</var> is generated by the first <code>\markboth</code> or
+<code>\markright</code> that comes on the page if there is one, otherwise by
+the last one that came before that page.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="831" mergedindex="cp">\markright&lbrace;<var>right</var>&rbrace;</indexterm>\markright&lbrace;<var>right</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><para>Sets the right hand page heading, leaving the left unchanged.
</para>
</tableitem></tableentry></ftable>
</section>
<node name="_005cthispagestyle" spaces=" "><nodename>\thispagestyle</nodename><nodeprev automatic="on">\pagestyle</nodeprev><nodeup automatic="on">Page styles</nodeup></node>
-<section spaces=" "><sectiontitle><code>\thispagestyle&lbrace;<var>style</var>&rbrace;</code></sectiontitle>
+<section spaces=" "><sectiontitle><code>\thispagestyle</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="825">\thispagestyle</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="832" mergedindex="cp">\thispagestyle</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="594">page style, this page</indexterm></cindex>
-<para>The <code>\thispagestyle</code> command works in the same manner as the
-<code>\pagestyle</code> command (see previous section) except that it
-changes to <var>style</var> for the current page only.
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\thispagestyle&lbrace;<var>style</var>&rbrace;
+</pre></example>
+
+<para>Works in the same way as the <code>\pagestyle</code> (<pxref label="_005cpagestyle"><xrefnodename>\pagestyle</xrefnodename></pxref>),
+except that it changes to <var>style</var> for the current page only. This
+declaration has global scope, so its effect is not delimited by braces
+or environments.
+</para>
+<para>Often the first page of a chapter or section has a different style. For
+example, this &latex; book document has the first page of the first
+chapter in in <code>plain</code> style, as is the default (<pxref label="Page-styles"><xrefnodename>Page
+styles</xrefnodename></pxref>).
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;book&rbrace;
+\pagestyle&lbrace;headings&rbrace;
+\begin&lbrace;document&rbrace;
+\chapter&lbrace;First chapter&rbrace;
+ ...
+\chapter&lbrace;Second chapter&rbrace;\thispagestyle&lbrace;empty&rbrace;
+ ...
+</pre></example>
+
+<noindent></noindent>
+<para>The <code>plain</code> style has a page number on it, centered in the footer.
+To make the page entirely empty, the command
+<code>\thispagestyle&lbrace;empty&rbrace;</code> immediately follows the second
+<code>\chapter</code>.
</para>
</section>
@@ -9674,83 +13069,220 @@ changes to <var>style</var> for the current page only.
<node name="Spaces" spaces=" "><nodename>Spaces</nodename><nodenext automatic="on">Boxes</nodenext><nodeprev automatic="on">Page styles</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Spaces</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="433">spaces</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="434">white space</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="595">spaces</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="596">white space</indexterm></cindex>
-<para>&latex; has many ways to produce white (or filled) space.
+<para>&latex; has many ways to produce white (or filled) space. Some of
+these are best suited to mathematical text; see&nbsp;<ref label="Spacing-in-math-mode"><xrefnodename>Spacing in
+math mode</xrefnodename></ref>. Some spacing commands are suitable for both regular text
+and mathematical text; versions of some of these commands are in this
+chapter.
</para>
<menu endspaces=" ">
<menucomment><pre xml:space="preserve">Horizontal space
-</pre></menucomment><menuentry leadingtext="* "><menunode separator=":: ">\hspace</menunode><menudescription><pre xml:space="preserve">Fixed horizontal space.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\hfill</menunode><menudescription><pre xml:space="preserve">Stretchable horizontal space.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\spacefactor</menunode><menudescription><pre xml:space="preserve">Stretchability of following space
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\(SPACE) after control sequence</menunode><menudescription><pre xml:space="preserve">Space (gobbling) after a control sequence.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\thinspace</menunode><menudescription><pre xml:space="preserve">One-sixth of an em.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\/</menunode><menudescription><pre xml:space="preserve">Insert italic correction.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\hrulefill \dotfill</menunode><menudescription><pre xml:space="preserve">Stretchable horizontal rule or dots.
+</pre></menucomment><menuentry leadingtext="* "><menunode separator=":: ">\enspace &amp; \quad &amp; \qquad</menunode><menudescription><pre xml:space="preserve">Traditional horizontal spaces.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\hspace</menunode><menudescription><pre xml:space="preserve">Any horizontal space.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\hfill</menunode><menudescription><pre xml:space="preserve">Stretchable horizontal space.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\hss</menunode><menudescription><pre xml:space="preserve">Infinitely stretchable/shrinkable horizontal space.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\spacefactor</menunode><menudescription><pre xml:space="preserve">Stretchability of following space
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\(SPACE)</menunode><menudescription><pre xml:space="preserve">Backslash-space; and explicit space.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">~</menunode><menudescription><pre xml:space="preserve">Tie, an unbreakable space.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\thinspace &amp; \negthinspace</menunode><menudescription><pre xml:space="preserve">One-sixth of an em, and negative one-sixth.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\/</menunode><menudescription><pre xml:space="preserve">Italic correction.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\hrulefill &amp; \dotfill</menunode><menudescription><pre xml:space="preserve">Stretchable horizontal rule or dots.
</pre></menudescription></menuentry><menucomment><pre xml:space="preserve">
Vertical space
-</pre></menucomment><menuentry leadingtext="* "><menunode separator=":: ">\addvspace</menunode><menudescription><pre xml:space="preserve">Add arbitrary vertical space if needed.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\bigskip \medskip \smallskip</menunode><menudescription><pre xml:space="preserve">Fixed vertical spaces.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\vfill</menunode><menudescription><pre xml:space="preserve">Infinitely stretchable vertical space.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\vspace</menunode><menudescription><pre xml:space="preserve">Add arbitrary vertical space.
+</pre></menucomment><menuentry leadingtext="* "><menunode separator=":: ">\bigskip &amp; \medskip &amp; \smallskip</menunode><menudescription><pre xml:space="preserve">Inter-paragraph vertical spaces.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\bigbreak &amp; \medbreak &amp; \smallbreak</menunode><menudescription><pre xml:space="preserve">Inter-paragraph space and page breaks.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\strut</menunode><menudescription><pre xml:space="preserve">Ensure height of a line.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\vspace</menunode><menudescription><pre xml:space="preserve">Vertical space.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\vfill</menunode><menudescription><pre xml:space="preserve">Stretchable vertical space.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\addvspace</menunode><menudescription><pre xml:space="preserve">Add arbitrary vertical space if needed.
</pre></menudescription></menuentry></menu>
-<node name="_005chspace" spaces=" "><nodename>\hspace</nodename><nodenext automatic="on">\hfill</nodenext><nodeup automatic="on">Spaces</nodeup></node>
+<node name="_005censpace-_0026-_005cquad-_0026-_005cqquad" spaces=" "><nodename>\enspace &amp; \quad &amp; \qquad</nodename><nodenext automatic="on">\hspace</nodenext><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle><code>\enspace</code> &amp; <code>\quad</code> &amp; <code>\qquad</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="833" mergedindex="cp">\enspace</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="834" mergedindex="cp">\quad</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="835" mergedindex="cp">\qquad</indexterm></findex>
+
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\enspace
+\quad
+\qquad
+</pre></example>
+
+<para>Insert a horizontal space of 1/2<dmn>em</dmn>, 1<dmn>em</dmn>, or 2<dmn>em</dmn>. The
+em is a length defined by a font designer, often thought of as being the
+width of a capital&nbsp;M. One advantage of describing space in ems is
+that it can be more portable across documents than an absolute
+measurement such as points (<pxref label="Lengths_002fem"><xrefnodename>Lengths/em</xrefnodename></pxref>).
+</para>
+<para>This puts a suitable gap between two graphics.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;center&rbrace;
+ \includegraphics&lbrace;womensmile.png&rbrace;%
+ \qquad\includegraphics&lbrace;mensmile.png&rbrace;
+\end&lbrace;center&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para><xref label="Spacing-in-math-mode"><xrefnodename>Spacing in math mode</xrefnodename></xref> for <code>\quad</code> and <code>\qquad</code>. These
+are lengths from centuries of typesetting and so may be a better choice
+in many circumstances than arbitrary lengths, such as you get with
+<code>\hspace</code>.
+</para>
+
+</section>
+<node name="_005chspace" spaces=" "><nodename>\hspace</nodename><nodenext automatic="on">\hfill</nodenext><nodeprev automatic="on">\enspace &amp; \quad &amp; \qquad</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
<section spaces=" "><sectiontitle><code>\hspace</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="826">\hspace</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="836" mergedindex="cp">\hspace</indexterm></findex>
-<para>Synopsis:
+<para>Synopsis, one of:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\hspace&lbrace;<var>length</var>&rbrace;
\hspace*&lbrace;<var>length</var>&rbrace;
</pre></example>
-<para>Add the horizontal space given by <var>length</var>. The <var>length</var> is a
-rubber length, that is, it may contain a <code>plus</code> or <code>minus</code>
-component, in any unit that &latex; understands (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>).
+<para>Insert the horizontal space <var>length</var>. The <var>length</var> can be
+positive, negative, or zero; adding negative space is like backspacing.
+It is a rubber length, that is, it may contain a <code>plus</code> or
+<code>minus</code> component, or both (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). Because the space is
+stretchable and shrinkable, it is sometimes called <dfn>glue</dfn>.
</para>
-<para>This command can add both positive and negative space; adding negative
-space is like backspacing.
+<para>This makes a line with <samp>Name:</samp> an inch from the right margin.
</para>
-<para>Normally when &tex; breaks a paragraph into lines it discards white
-space (glues and kerns) that would come at the start of a line, so you
-get an inter-word space or a line break between words but not both. This
-command&textrsquo;s starred version <code>\hspace*&lbrace;...&rbrace;</code> puts a non-discardable
-invisible item in front of the space, so the space appears in the
-output.
+<example endspaces=" ">
+<pre xml:space="preserve">\noindent\makebox[\linewidth][r]&lbrace;Name:\hspace&lbrace;1in&rbrace;&rbrace;
+</pre></example>
+
+<para>The <code>*</code>-version inserts horizontal space that non-discardable.
+More precisely, when &tex; breaks a paragraph into lines any white
+space&textmdash;glues and kerns&textmdash;that come at a line break are discarded. The
+<code>*</code>-version avoids that (technically, it adds a non-discardable
+invisible item in front of the space).
</para>
-<para>This example make a one-line paragraph that puts <samp>Name:</samp> an inch
-from the right margin.
+<para>In this example
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\noindent\makebox[\linewidth]&lbrace;\hspace&lbrace;\fill&rbrace;Name:\hspace&lbrace;1in&rbrace;&rbrace;
+<pre xml:space="preserve">\parbox&lbrace;0.8\linewidth&rbrace;&lbrace;%
+ Fill in each blank: Four \hspace*&lbrace;1in&rbrace; and seven years ago our
+ fathers brought forth on this continent, a new \hspace*&lbrace;1in&rbrace;,
+ conceived in \hspace*&lbrace;1in&rbrace;, and dedicated to the proposition
+ that all men are created \hspace*&lbrace;1in&rbrace;.&rbrace;
</pre></example>
+<noindent></noindent>
+<para>the 1&nbsp;inch blank following <samp>conceived in</samp> falls at the start
+of a line. If you erase the <code>*</code> then &latex; discards the blank.
+</para>
+<para>Here, the <code>\hspace</code> separates the three graphics.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;center&rbrace;
+ \includegraphics&lbrace;lion.png&rbrace;% comment keeps out extra space
+ \hspace&lbrace;1cm minus 0.25cm&rbrace;\includegraphics&lbrace;tiger.png&rbrace;%
+ \hspace&lbrace;1cm minus 0.25cm&rbrace;\includegraphics&lbrace;bear.png&rbrace;
+\end&lbrace;center&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>Because the argument to each <code>\hspace</code> has <code>minus 0.25cm</code>,
+each can shrink a little if the three figures are too wide. But each
+space won&textrsquo;t shrink more than 0.25<dmn>cm</dmn> (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>).
+</para>
</section>
-<node name="_005chfill" spaces=" "><nodename>\hfill</nodename><nodenext automatic="on">\spacefactor</nodenext><nodeprev automatic="on">\hspace</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<node name="_005chfill" spaces=" "><nodename>\hfill</nodename><nodenext automatic="on">\hss</nodenext><nodeprev automatic="on">\hspace</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
<section spaces=" "><sectiontitle><code>\hfill</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="827">\hfill</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="837" mergedindex="cp">\hfill</indexterm></findex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="597">stretch, infinite horizontal</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="598">infinite horizontal stretch</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\hfill
+</pre></example>
+
+<para>Produce a rubber length which has no natural space but that can stretch
+horizontally as far as needed (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>).
+</para>
+<para>This creates a one-line paragraph with <samp>Name:</samp> on the left side
+of the page and <samp>Quiz One</samp> on the right.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\noindent Name:\hfill Quiz One
+</pre></example>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="435">stretch, infinite horizontal</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="436">infinite horizontal stretch</indexterm></cindex>
-<para>Produce a rubber length which has
-no natural space but can stretch horizontally as far as
-needed (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>).
+<findex index="fn" spaces=" "><indexterm index="fn" number="838" mergedindex="cp">\fill</indexterm></findex>
+<para>The <code>\hfill</code> command is equivalent to <code>\hspace&lbrace;\fill&rbrace;</code> and
+so the space can be discarded at line breaks. To avoid that instead use
+<code>\hspace*&lbrace;\fill&rbrace;</code> (<pxref label="_005chspace"><xrefnodename>\hspace</xrefnodename></pxref>).
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="828">\fill</indexterm></findex>
-<para>The command <code>\hfill</code> is equivalent to <code>\hspace&lbrace;\fill&rbrace;</code>. For
-space that does not disappear at line breaks use
-<code>\hspace*&lbrace;\fill&rbrace;</code> instead (<pxref label="_005chspace"><xrefnodename>\hspace</xrefnodename></pxref>).
+<para>Here the graphs are evenly spaced in the middle of the figure.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand*&lbrace;\vcenteredhbox&rbrace;[1]&lbrace;\begin&lbrace;tabular&rbrace;&lbrace;&arobase;&lbrace;&rbrace;c&arobase;&lbrace;&rbrace;&rbrace;#1\end&lbrace;tabular&rbrace;&rbrace;
+ ...
+\begin&lbrace;figure&rbrace;
+ \hspace*&lbrace;\fill&rbrace;%
+ \vcenteredhbox&lbrace;\includegraphics&lbrace;graph0.png&rbrace;&rbrace;%
+ \hfill\vcenteredhbox&lbrace;\includegraphics&lbrace;graph1.png&rbrace;&rbrace;%
+ \hspace*&lbrace;\fill&rbrace;%
+ \caption&lbrace;Comparison of two graphs&rbrace; \label&lbrace;fig:twographs&rbrace;
+\end&lbrace;figure&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>Note the <code>\hspace*</code>&textrsquo;s where the space could otherwise be dropped.
</para>
</section>
-<node name="_005cspacefactor" spaces=" "><nodename>\spacefactor</nodename><nodenext automatic="on">\(SPACE) after control sequence</nodenext><nodeprev automatic="on">\hfill</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<node name="_005chss" spaces=" "><nodename>\hss</nodename><nodenext automatic="on">\spacefactor</nodenext><nodeprev automatic="on">\hfill</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle><code>\hss</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="839" mergedindex="cp">\hss</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="599">horizontal space</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="600">horizontal space, stretchable</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="601">space, inserting horizontal</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\hss
+</pre></example>
+
+<para>Produce a horizontal space that is infinitely shrinkable as well as
+infinitely stretchable (this command is a &tex; primitive). &latex;
+authors should reach first for the <code>\makebox</code> command to get the
+effects of <code>\hss</code> (<pxref label="_005cmbox-_0026-_005cmakebox"><xrefnodename>\mbox &amp; \makebox</xrefnodename></pxref>).
+</para>
+<para>Here, the first line&textrsquo;s <code>\hss</code> makes the Z stick out to the right,
+overwriting the Y. In the second line the Z sticks out to the left,
+overwriting the X.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">X\hbox to 0pt&lbrace;Z\hss&rbrace;Y
+X\hbox to 0pt&lbrace;\hss Z&rbrace;Y
+</pre></example>
+
+<noindent></noindent>
+<para>Without the <code>\hss</code> you get something like <samp>Overfull \hbox
+(6.11111pt too wide) detected at line 20</samp>.
+</para>
+
+</section>
+<node name="_005cspacefactor" spaces=" "><nodename>\spacefactor</nodename><nodenext automatic="on">\(SPACE)</nodenext><nodeprev automatic="on">\hss</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
<section spaces=" "><sectiontitle><code>\spacefactor</code></sectiontitle>
<para>Synopsis:
@@ -9759,25 +13291,27 @@ space that does not disappear at line breaks use
<pre xml:space="preserve">\spacefactor=<var>integer</var>
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="829">\spacefactor</indexterm></findex>
-<para>While &latex; is making the page, to give the lines the best appearance
-it may stretch or shrink the gaps between words. The
-<code>\spacefactor</code> command (from Plain&nbsp;&tex;) allows you to
-change the &latex;&textrsquo;s default behavior.
+<findex index="fn" spaces=" "><indexterm index="fn" number="840" mergedindex="cp">\spacefactor</indexterm></findex>
+<para>Influence &latex;&textrsquo;s glue stretch and shrink behavior. Most user-level
+documents do not use this command.
+</para>
+<para>While &latex; is laying out the material, it may stretch or shrink the
+gaps between words. (This space is not a character; it is called the
+<dfn>interword glue</dfn>; <pxref label="_005chspace"><xrefnodename>\hspace</xrefnodename></pxref>). The <code>\spacefactor</code> command
+(from Plain&nbsp;&tex;) allows you to, for instance, have the space
+after a period stretch more than the space after a word-ending letter.
</para>
<para>After &latex; places each character, or rule or other box, it sets a
parameter called the <dfn>space factor</dfn>. If the next thing in the input
-is a space then this parameter affects how much of a horizontal gap
-&latex; will have it span. (This gap is not a character; it is called
-<dfn>interword glue</dfn>.) A larger space factor means that the glue gap
-can stretch more and shrink less.
-</para>
-<para>Normally, the space factor is 1000; this value is in effect following
-most characters, and any non-character box or math formula. But it is
-3000 after a period, exclamation mark, or question mark, it is 2000
-after a colon, 1500 after a semicolon, 1250 after a comma, and 0 after a
-right parenthesis or bracket, or closing double quote or single quote.
-Finally, it is 999 after a capital letter.
+is a space then this parameter affects how much stretching or shrinking
+can happen. A space factor that is larger than the normal value means
+that the glue can stretch more and shrink less. Normally, the space
+factor is 1000. This value is in effect following most characters, and
+any non-character box or math formula. But it is 3000 after a period,
+exclamation mark, or question mark, it is 2000 after a colon, 1500 after
+a semicolon, 1250 after a comma, and 0 after a right parenthesis or
+bracket, or closing double quote or single quote. Finally, it is 999
+after a capital letter.
</para>
<para>If the space factor&nbsp;<var>f</var> is 1000 then the glue gap will be the
font&textrsquo;s normal space value (for Computer Modern Roman 10 point this is
@@ -9786,321 +13320,698 @@ than 2000 then &tex; adds the font&textrsquo;s extra space value (for Computer
Modern Roman 10 point this is 1.11111&nbsp;points), and then the font&textrsquo;s
normal stretch value is multiplied by <math>f /1000</math> and the normal
shrink value is multiplied by <math>1000/f</math> (for Computer Modern Roman
-10 point these are 1.66666 and 1.11111&nbsp;points). In short, compared
-to a normal space, such as the space following a word ending in a
-lowercase letter, inter-sentence spacing has a fixed extra space added
-and then the space can stretch 3 times as much and shrink 1/3 as much.
-</para>
-<para>The rules for how &tex; uses space factors are even more complex
-because they play two more roles. In practice, there are two
-consequences. First, if a period or other punctuation is followed by a
-close parenthesis or close double quote then its effect is still in
-place, that is, the following glue will have increased stretch and
-shrink. Second, conversely, if punctuation comes after a capital letter
-then its effect is not in place so you get an ordinary space. For how
-to adjust to this second case, for instance if an abbreviation does not
-end in a capital letter, <pxref label="_005c_0028SPACE_0029-and-_005c_0040"><xrefnodename>\(SPACE) and \&arobase;</xrefnodename></pxref>.
+10 point these are 1.66666 and 1.11111&nbsp;points).
+</para>
+<para>For example, consider the period ending <code>A man's best friend is his
+dog.</code> After it, &tex; puts in a fixed extra space, and also allows the
+glue to stretch 3 times as much and shrink 1/3 as much, as the glue
+after <code>friend</code>, which does not end in a period.
+</para>
+<para>The rules for space factors are even more complex because they play
+additional roles. In practice, there are two consequences. First, if a
+period or other punctuation is followed by a right parenthesis or
+bracket, or right single or double quote then the spacing effect of that
+period carries through those characters (that is, the following glue
+will have increased stretch and shrink). Second, if
+punctuation comes after a capital letter then its effect is not in place
+so you get an ordinary space. This second case also affects abbreviations
+that do not end in a capital letter (<pxref label="_005c_0040"><xrefnodename>\&arobase;</xrefnodename></pxref>).
+</para>
+<para>You can only use <code>\spacefactor</code> in paragraph mode or LR mode
+(<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>). You can see the current value with
+<code>\the\spacefactor</code> or <code>\showthe\spacefactor</code>.
+</para>
+<para>(Comment, not really related to <code>\spacefactor</code>: if you get errors
+like <samp>You can't use `\spacefactor' in vertical mode</samp>, or <samp>You
+can't use `\spacefactor' in math mode.</samp>, or <samp>Improper \spacefactor</samp>
+then you have probably tried to redefine an internal command.
+<xref label="_005cmakeatletter-_0026-_005cmakeatother"><xrefnodename>\makeatletter &amp; \makeatother</xrefnodename></xref>.)
</para>
<menu endspaces=" ">
-<menuentry leadingtext="* "><menunode separator=":: ">\(SPACE) and \&arobase;</menunode><menudescription><pre xml:space="preserve">Space after a period.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\frenchspacing</menunode><menudescription><pre xml:space="preserve">Equal interword and inter-sentence space.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\normalsfcodes</menunode><menudescription><pre xml:space="preserve">Restore space factor settings to the default.
+<menuentry leadingtext="* "><menunode separator=":: ">\&arobase;</menunode><menudescription><pre xml:space="preserve">Distinguish sentence-ending periods from abbreviations.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\frenchspacing</menunode><menudescription><pre xml:space="preserve">Equal interword and inter-sentence space.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\normalsfcodes</menunode><menudescription><pre xml:space="preserve">Restore space factor settings to the default.
</pre></menudescription></menuentry></menu>
-<node name="_005c_0028SPACE_0029-and-_005c_0040" spaces=" "><nodename trailingspaces=" ">\(SPACE) and \&arobase;</nodename><nodenext automatic="on">\frenchspacing</nodenext><nodeup automatic="on">\spacefactor</nodeup></node>
-<subsection spaces=" "><sectiontitle><code>\(SPACE)</code> and <code>\&arobase;</code> </sectiontitle>
+<node name="_005c_0040" spaces=" "><nodename trailingspaces=" ">\&arobase;</nodename><nodenext automatic="on">\frenchspacing</nodenext><nodeup automatic="on">\spacefactor</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\&arobase;</code> </sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="830">\(SPACE)</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="831">\TAB</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="832">\NEWLINE</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="833">\&arobase;</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="841" mergedindex="cp">\&arobase;</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="842" mergedindex="cp">at-sign</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="602">period, sentence-ending</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="603">period, abbreviation-ending</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="604">period, spacing after</indexterm></cindex>
<anchor name="_005cAT">\AT</anchor><!-- c old name -->
-<para>Here, <code>\(SPACE)</code> means a backslash followed by a space. These
-commands mark a punctuation character, typically a period, as either
-ending a sentence or as ending an abbreviation.
+<para>Synopsis:
</para>
-<para>By default, in justifying a line &latex; adjusts the space after a
-sentence-ending period (or a question mark, exclamation point, comma, or
-colon) more than the space between words. <xref label="_005cspacefactor"><xrefnodename>\spacefactor</xrefnodename></xref>. As
-described there, &latex; assumes that the period ends a sentence unless
-it is preceded by a capital letter, in which case it takes that period
-for part of an abbreviation. Note that if a sentence-ending period is
-immediately followed by a right parenthesis or bracket, or right single
-or double quote, then the space effect of that period follows through
-that parenthesis or quote.
+<example endspaces=" ">
+<pre xml:space="preserve"><var>capital-letter</var>\&arobase;.
+</pre></example>
+
+<para>Treat a period as sentence-ending, where &latex; would otherwise think
+it is part of an abbreviation. &latex; thinks that a period ends an
+abbreviation if the period comes after a capital letter, and otherwise
+thinks the period ends the sentence. By default, in justifying a line
+&latex; adjusts the space after a sentence-ending period (or a question
+mark, exclamation point, comma, or colon) more than it adjusts the space
+between words (<pxref label="_005cspacefactor"><xrefnodename>\spacefactor</xrefnodename></pxref>).
</para>
-<para>So: if you have a period ending an abbreviation whose last letter is not
-a capital letter, and that abbreviation is not the last word in the
-sentence, then follow that period with a backslash-space (<code>\ </code>) or
-a tie (<code>~</code>) or a <code>\&arobase;</code>. Examples are <code>Nat.\ Acad.\
-Science</code>, and <code>Mr.~Bean</code>, and <code>(manure, etc.\&arobase;) for sale</code>
-(note that in the last the <code>\&arobase;</code> comes before the closing parenthesis).
+<para>This example shows the two cases to remember.
</para>
-<para>In the opposite situation, if you have a capital letter followed by a
-period that does end the sentence, then put <code>\&arobase;</code> before the
-period. For example, <code>book by the MAA\&arobase;.</code> will have correct
-inter-sentence spacing after the period.
+<example endspaces=" ">
+<pre xml:space="preserve">The songs \textit&lbrace;Red Guitar&rbrace;, etc.\ are by Loudon Wainwright~III\&arobase;.
+</pre></example>
+
+<noindent></noindent>
+<para>The second period ends the sentence, despite that it is preceded by a
+capital. We tell &latex; that it ends the sentence by putting
+<code>\&arobase;</code> before it. The first period ends the abbreviation
+<samp>etc.</samp> but not the sentence. The backslash-space, <code>\ </code>,
+produces a mid-sentence space.
</para>
-<para>For another use of <code>\(SPACE)</code>, <pxref label="_005c_0028SPACE_0029-after-control-sequence"><xrefnodename>\(SPACE) after control sequence</xrefnodename></pxref>.
+<para>So: if you have a capital letter followed by a period that ends the
+sentence, then put <code>\&arobase;</code> before the period. This holds even if
+there is an intervening right parenthesis or bracket, or right single or
+double quote, because the spacing effect of that period carries through
+those characters. For example, this
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">Use the \textit&lbrace;Instructional Practices Guide&rbrace;,
+(a book by the MAA)\&arobase;.
+</pre></example>
+
+<noindent></noindent>
+<para>will have correct inter-sentence spacing after the period.
+</para>
+<para>The <code>\&arobase;</code> command is only for a text mode. If you use it outside of
+a text mode then you get <samp>You can't use `\spacefactor' in vertical
+mode</samp> (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>).
+</para>
+<para>Comment: the converse case is a period ending an abbreviation whose last
+letter is not a capital letter, and that abbreviation is not the last
+word in the sentence. For that case follow the period with a
+backslash-space, (<code>\ </code>), or a tie, (<code>~</code>), or <code>\&arobase;</code>.
+Examples are <code>Nat.\ Acad.\ Science</code>, and <code>Mr.~Bean</code>, and
+<code>(manure, etc.\&arobase;) for sale</code> (note in the last one that the
+<code>\&arobase;</code> comes before the closing parenthesis).
</para>
</subsection>
-<node name="_005cfrenchspacing" spaces=" "><nodename>\frenchspacing</nodename><nodenext automatic="on">\normalsfcodes</nodenext><nodeprev automatic="on">\(SPACE) and \&arobase;</nodeprev><nodeup automatic="on">\spacefactor</nodeup></node>
+<node name="_005cfrenchspacing" spaces=" "><nodename>\frenchspacing</nodename><nodenext automatic="on">\normalsfcodes</nodenext><nodeprev automatic="on">\&arobase;</nodeprev><nodeup automatic="on">\spacefactor</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\frenchspacing</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="834">\frenchspacing</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="835">\nonfrenchspacing</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="437">spacing, inter-sentence</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="843" mergedindex="cp">\frenchspacing</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="844" mergedindex="cp">\nonfrenchspacing</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="605">spacing, inter-sentence</indexterm></cindex>
-<para>This declaration (from Plain &tex;) causes &latex; to treat
-inter-sentence spacing in the same way as interword spacing.
+<para>Synopsis, one of:
</para>
-<para>In justifying the text in a line, some typographic traditions, including
-English, prefer to adjust the space between sentences (or after other
-punctuation marks) more than the space between words. Following this
-declaration, all spaces are instead treated equally.
+<example endspaces=" ">
+<pre xml:space="preserve">\frenchspacing
+\nonfrenchspacing
+</pre></example>
+
+<para>The first declaration causes &latex; to treat spacing between sentences
+in the same way as spacing between words in the middle of a sentence.
+The second causes spacing between sentences to stretch or shrink more
+(<pxref label="_005cspacefactor"><xrefnodename>\spacefactor</xrefnodename></pxref>); this is the default.
</para>
-<para>Revert to the default behavior by declaring <code>\nonfrenchspacing</code>.
+<para>Some typographic traditions, including English, prefer to adjust the
+space between sentences (or spaces following a question mark,
+exclamation point, comma, or colon) more than the space between words
+that are in the middle of a sentence. Declaring <code>\frenchspacing</code>
+(the command is from Plain &tex;) switches to the tradition that all
+spaces are treated equally.
</para>
</subsection>
<node name="_005cnormalsfcodes" spaces=" "><nodename>\normalsfcodes</nodename><nodeprev automatic="on">\frenchspacing</nodeprev><nodeup automatic="on">\spacefactor</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\normalsfcodes</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="836">\normalsfcodes</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="438">spacing, inter-sentence</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="845" mergedindex="cp">\normalsfcodes</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="606">spacing, inter-sentence</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\normalsfcodes
+</pre></example>
-<para>Reset the &latex; space factor values to the default.
+<para>Reset the &latex; space factor values to the default
+(<pxref label="_005cspacefactor"><xrefnodename>\spacefactor</xrefnodename></pxref>).
</para>
</subsection>
</section>
-<node name="_005c_0028SPACE_0029-after-control-sequence" spaces=" "><nodename>\(SPACE) after control sequence</nodename><nodenext automatic="on">\thinspace</nodenext><nodeprev automatic="on">\spacefactor</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
-<section spaces=" "><sectiontitle><code>\ </code> after control sequence</sectiontitle>
+<node name="_005c_0028SPACE_0029" spaces=" "><nodename trailingspaces=" ">\(SPACE)</nodename><nodenext automatic="on">~</nodenext><nodeprev automatic="on">\spacefactor</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle>Backslash-space, <code>\ </code></sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="607">\NEWLINE</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="608">\SPACE</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="609">\TAB</indexterm></cindex>
+
+<para>This section refers to the command consisting of two characters, a
+backslash followed by a space. Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\
+</pre></example>
+
+<para>Produce a space. By default it produces white space of length
+3.33333<dmn>pt</dmn> plus 1.66666<dmn>pt</dmn> minus 1.11111<dmn>pt</dmn>.
+</para>
+<para>A blank is not a space. When you type a blank between words, &latex;
+produces white space. That&textrsquo;s different from an explicit space. This
+illustrates.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;tabular&rbrace;&lbrace;l&rbrace;
+Three blanks: in a row \\
+Three spaces:\ \ \ in a row \\
+\end&lbrace;tabular&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>On the first line &latex; collapses the three blanks to output one
+whitespace (it would be the same with a single blank or, for instance,
+with a blank and an tab and a blank, or a blank and a newline and a
+blank). But the second line asks for three spaces so the white area is
+wider. Thus, the backslash-space command will create some horizontal
+space. (But the best way to create horizontal space is with
+<code>\hspace</code>; <xref label="_005chspace"><xrefnodename>\hspace</xrefnodename></xref>.)
+</para>
+<para>The backslash-space command has two main uses. First, it is often used
+after control sequences to keep them from gobbling the space that
+follows, as in <code>\TeX\ is nice</code>. (But the approach of using curly
+parentheses, as in <code>\TeX&lbrace;&rbrace; is nice</code>, has the advantage of still
+working if the next character is a period.)
+</para>
+<para>The second common use is that
+it mark a period as ending an abbreviation instead of ending
+a sentence, as in <code>So says Prof.\ Smith</code> (<pxref label="_005c_0040"><xrefnodename>\&arobase;</xrefnodename></pxref>).
+</para>
+<para>Under normal circumstances, <code>\</code><key>tab</key> and <code>\</code><key>newline</key>
+are equivalent to backslash-space, <code>\ </code>.
+</para>
+<!-- c @PkgIndex{xspace} -->
+<!-- c Some individual commands, notably those defined with the @code{xspace}, -->
+<!-- c package do not follow the standard behavior. -->
+
+
+</section>
+<node name="_007e" spaces=" "><nodename>~</nodename><nodenext automatic="on">\thinspace &amp; \negthinspace</nodenext><nodeprev automatic="on">\(SPACE)</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle><code>~</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="846" mergedindex="cp">~</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="610">tie</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="611">space, hard</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="612">space, unbreakable</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="613">NBSP</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve"><var>before</var>~<var>after</var>
+</pre></example>
-<para>The <code>\ </code> command is often used after control sequences to keep
-them from gobbling the space that follows, as in <samp>\TeX\ is nice</samp>.
-And, under normal circumstances, <code>\</code><key>tab</key> and
-<code>\</code><key>newline</key> are equivalent to <code>\ </code>. For another use of
-<code>\ </code>, see also <ref label="_005c_0028SPACE_0029-and-_005c_0040"><xrefnodename>\(SPACE) and \&arobase;</xrefnodename></ref>.
+<para>The tie character, <code>~</code>, produces a space between <var>before</var> and
+<var>after</var> at which the line will not be broken. By default the white
+space has length 3.33333<dmn>pt</dmn> plus 1.66666<dmn>pt</dmn> minus
+1.11111<dmn>pt</dmn> (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>).
</para>
-<para>Some people prefer to use <code>&lbrace;&rbrace;</code> for the same purpose, as in
-<code>\TeX&lbrace;&rbrace; is nice</code>. This has the advantage that you can always
-write it the same way, namely <code>\TeX&lbrace;&rbrace;</code>, whether it is followed
-by a space or by a punctuation mark. Compare:
+<para>Here &latex; will not break the line between the final two words.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\TeX\ is a nice system. \TeX, a nice system.&linebreak;
-\TeX&lbrace;&rbrace; is a nice system. \TeX&lbrace;&rbrace;, a nice system.
+<pre xml:space="preserve">Thanks to Prof.~Lerman.
</pre></example>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="439"><r>package</r>, <code>xspace</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="440"><code>xspace</code> <r>package</r></indexterm></cindex>
+<noindent></noindent>
+<para>In addition, despite the period, &latex; does not use the
+end-of-sentence spacing (<pxref label="_005c_0040"><xrefnodename>\&arobase;</xrefnodename></pxref>).
+</para>
+<para>Ties prevent the end of line separation of things where that could cause
+confusion. But they also reduce &latex;&textrsquo;s options when it breaks lines
+into paragraphs, so you can use too many. They are also matters of
+taste, sometimes alarmingly dogmatic taste, among readers. Nevertheless,
+here are some usage models, many of them from the &tex;book.
+</para>
+<itemize commandarg="bullet" spaces=" " endspaces=" "><itemprepend><formattingcommand command="bullet"/></itemprepend>
+<listitem><prepend>&bullet;</prepend>
+<para>Between an enumerator and its item, such as in references:
+<code>Chapter~12</code>, or <code>Theorem~\ref&lbrace;th:Wilsons&rbrace;</code>, or
+<code>Figure~\ref&lbrace;fig:KGraph&rbrace;</code>. When cases are enumerated inline:
+<code>(b)~Show that $f(x)$ is (1)~continuous, and (2)~bounded</code>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="614"><r>package</r>, <code>siunitx</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="615"><code>siunitx</code> <r>package</r></indexterm></cindex>
-<para>Some individual commands, notably those defined with the <code>xspace</code>,
-package do not follow the standard behavior.
+</listitem><listitem><prepend>&bullet;</prepend>
+<para>Between a number and its unit: <code>$745.7.8$~watts</code> (the
+<file>siunitx</file> package has a special facility for this) or
+<code>144~eggs</code>. This includes between a month and a date:
+<code>October~12</code> or <code>12~Oct</code>. In general, in any expressions where
+numbers and abbreviations or symbols are separated by a space:
+<code>AD~565</code>, or <code>2:50~pm</code>, or <code>Boeing~747</code>, or
+<code>268~Plains Road</code>, or <code>\$$1.4$~billion</code>.
+</para>
+</listitem><listitem><prepend>&bullet;</prepend>
+<para>When mathematical phrases are rendered in words: <code>equals~$n$</code>, or
+<code>less than~$\epsilon$</code>, or <code>given~$X$</code>, or <code>modulo~$p^e$
+for all large~$n$</code> (but compare <code>is~$15$</code> with <code>is $15$~times
+the height</code>). Between mathematical symbols in apposition with nouns:
+<code>dimension~$d$</code> or <code>function~$f(x)$</code> (but compare <code>with
+length $l$~or more</code>). When a symbol is a tightly bound object of a
+preposition: <code>of~$x$</code>, or <code>from $0$ to~$1$</code>, or <code>in
+common with~$m$</code>.
+</para>
+</listitem><listitem><prepend>&bullet;</prepend>
+<para>Between symbols in series: <code>$1$,~$2$, or~$3$</code> or <code>$1$,~$2$,
+\ldots,~$n$</code>.
</para>
+</listitem><listitem><prepend>&bullet;</prepend>
+<para>Between a person&textrsquo;s forenames and between multiple surnames:
+<code>Donald~E. Knuth</code>, or <code>Luis~I. Trabb~Pardo</code>, or
+<code>Charles~XII</code> (but you must give TeX places to break the line so
+you may do <code>Charles Louis Xavier~Joseph de~la Vall\'ee~Poussin</code>).
+</para>
+</listitem><listitem><prepend>&bullet;</prepend>
+<para>Before a dash: <code>pages 12~--14</code> or <code>it is~--- it must be
+said~--- plausible</code>.
+</para>
+</listitem></itemize>
+
</section>
-<node name="_005cthinspace" spaces=" "><nodename>\thinspace</nodename><nodenext automatic="on">\/</nodenext><nodeprev automatic="on">\(SPACE) after control sequence</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
-<section spaces=" "><sectiontitle><code>\thinspace</code>: Insert 1/6<dmn>em</dmn></sectiontitle>
+<node name="_005cthinspace-_0026-_005cnegthinspace" spaces=" "><nodename>\thinspace &amp; \negthinspace</nodename><nodenext automatic="on">\/</nodenext><nodeprev automatic="on">~</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle><code>\thinspace</code> &amp; <code>\negthinspace</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="837">\thinspace</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="847" mergedindex="cp">\thinspace</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="848" mergedindex="cp">\negthinspace</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="616">thin space</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="617">space, thin</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="618">thin space, negative</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="619">space, negative thin</indexterm></cindex>
-<para><code>\thinspace</code> produces an unbreakable and unstretchable space that
-is 1/6 of an em. This is the proper space to use between nested
-quotes, as in &textrsquo;<dmn></dmn>&textrdquo;.<!-- c Abuse @dmn, which is a thin space in Texinfo. -->
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\thinspace
+\negthinspace
+</pre></example>
+
+<para>Produce an unbreakable and unstretchable space of 1/6<dmn>em</dmn> and
+-1/6<dmn>em</dmn>. These are the text mode equivalents of <code>\,</code> and
+<code>\!</code> (<pxref label="Spacing-in-math-mode_002f_005cthinspace"><xrefnodename>Spacing in math mode/\thinspace</xrefnodename></pxref>). You can use
+<code>\,</code> as a synonym for <code>\thinspace</code> in text mode.
+</para>
+<para>The <code>\negthinspace</code> command is used in text mode mostly for
+fiddling with spaces. One common use of <code>\thinspace</code> is as the
+space between nested quotes.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">Killick replied, ``I heard the Captain say, `Ahoy there.'\thinspace''
+</pre></example>
+
+<noindent></noindent>
+<para>Another use is that some style guides call for a <code>\thinspace</code>
+between an ellipsis and a sentence ending period (other style guides,
+though, think the three dots are quite enough already). Still another
+use is between initials, as in <code>D.\thinspace E.\ Knuth</code>.
</para>
</section>
-<node name="_005c_002f" spaces=" "><nodename>\/</nodename><nodenext automatic="on">\hrulefill \dotfill</nodenext><nodeprev automatic="on">\thinspace</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
-<section spaces=" "><sectiontitle><code>\/</code>: Insert italic correction</sectiontitle>
+<node name="_005c_002f" spaces=" "><nodename>\/</nodename><nodenext automatic="on">\hrulefill &amp; \dotfill</nodenext><nodeprev automatic="on">\thinspace &amp; \negthinspace</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle><code>\/</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="838">\/</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="441">italic correction</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="849" mergedindex="cp">\/</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="620">italic correction</indexterm></cindex>
-<para>The <code>\/</code> command produces an <dfn>italic correction</dfn>. This is a
-small space defined by the font designer for a given character,
-to avoid the character colliding with whatever follows. The italic
-<i>f</i> character typically has a large italic correction value.
+<para>Synopsis:
</para>
-<para>If the following character is a period or comma, it&textrsquo;s not necessary to
-insert an italic correction, since those punctuation symbols have a
-very small height. However, with semicolons or colons, as well as
-normal letters, it can help. Compare
-<tex endspaces=" ">
-</tex>
-<i>f: f;</i> (in the &tex; output, the &textlsquo;f&textrsquo;s are nicely separated)
-with <i>f: f;</i>.
+<example endspaces=" ">
+<pre xml:space="preserve"><var>before-character</var>\/<var>after-character</var>
+</pre></example>
+
+<para>Insert an <dfn>italic correction</dfn>, a small space defined by the font
+designer for each character, to avoid the character colliding with
+whatever follows. When you use <code>\/</code>, &latex; takes the correction
+from the font metric file, scales it by any scaling that has been
+applied to the font, and then inserts that much horizontal space.
</para>
-<para>When changing fonts with commands such as <code>\textit&lbrace;italic
-text&rbrace;</code> or <code>&lbrace;\itshape italic text&rbrace;</code>, &latex; will
-automatically insert an italic correction if appropriate (<pxref label="Font-styles"><xrefnodename>Font
-styles</xrefnodename></pxref>).
+<para>Here, were it not for the <code>\/</code>, the <var>before-character</var>
+italic&nbsp;f would hit the <var>after-character</var> roman&nbsp;H
</para>
-<para>Despite the name, roman characters can also have an italic
-correction. Compare
-<tex endspaces=" ">
-</tex>
-pdf&tex; (in the &tex; output, there is a small space after the &textlsquo;f&textrsquo;)
-with pdf&tex;.
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand&lbrace;\companylogo&rbrace;&lbrace;&lbrace;\it f&rbrace;\/H&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>because the italic letter leans far to the right.
+</para>
+<para>If <var>after-character</var> is a period or comma then don&textrsquo;t insert an
+italic correction since those punctuation symbols have a very small
+height. However, with semicolons or colons as well as with normal
+letters, the italic correction can help.
+</para>
+<para>When you use commands such as <code>\textit</code> or <code>\itshape</code> to
+change fonts, &latex; will automatically insert any needed italic
+correction (<pxref label="Font-styles"><xrefnodename>Font styles</xrefnodename></pxref>).
+</para>
+<para>Roman characters can also have an italic correction. An example is in
+the name <code>pdf\/\TeX</code>.
</para>
<para>There is no concept of italic correction in math mode; spacing is done
in a different way.
</para>
</section>
-<node name="_005chrulefill-_005cdotfill" spaces=" "><nodename>\hrulefill \dotfill</nodename><nodenext automatic="on">\addvspace</nodenext><nodeprev automatic="on">\/</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
-<section spaces=" "><sectiontitle><code>\hrulefill \dotfill</code></sectiontitle>
+<node name="_005chrulefill-_0026-_005cdotfill" spaces=" "><nodename>\hrulefill &amp; \dotfill</nodename><nodenext automatic="on">\bigskip &amp; \medskip &amp; \smallskip</nodenext><nodeprev automatic="on">\/</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle><code>\hrulefill</code> &amp; <code>\dotfill</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="839">\hrulefill</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="840">\dotfill</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="850" mergedindex="cp">\hrulefill</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="851" mergedindex="cp">\dotfill</indexterm></findex>
-<para>Produce an infinite rubber length (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>) filled with a
-horizontal rule (that is, a line) or with dots, instead of just white
-space.
+<para>Synopsis, one of:
</para>
-<para>When placed between blank lines this example creates a paragraph that is
-left and right justified, where the space in the middle is filled with
-evenly spaced dots.
+<example endspaces=" ">
+<pre xml:space="preserve">\hrulefill
+\dotfill
+</pre></example>
+
+<para>Produce an infinite horizontal rubber length (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>) that
+&latex; fills with a rule (that is, a line) or with dots, instead of
+white space.
+</para>
+<para>This outputs a line 2 inches long.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\noindent Jack Aubrey\dotfill Melbury Lodge
+<pre xml:space="preserve">Name:~\makebox[2in]&lbrace;\hrulefill&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>This example, when placed between blank lines, creates a paragraph that
+is left and right justified and where the middle is filled with evenly
+spaced dots.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\noindent John Aubrey, RN \dotfill&lbrace;&rbrace; Melbury Lodge
</pre></example>
<para>To make the rule or dots go to the line&textrsquo;s end use <code>\null</code> at the
start or end.
</para>
<para>To change the rule&textrsquo;s thickness, copy the definition and adjust it, as
-with <code>\renewcommand&lbrace;\hrulefill&rbrace;&lbrace;\leavevmode\leaders\hrule height
-1pt\hfill\kern\z&arobase;&rbrace;</code>, which changes the default thickness of
-0.4<dmn>pt</dmn> to 1<dmn>pt</dmn>. Similarly, adjust the dot spacing as with
-<code>\renewcommand&lbrace;\dotfill&rbrace;&lbrace;\leavevmode\cleaders\hb&arobase;xt&arobase;
-1.00em&lbrace;\hss .\hss &rbrace;\hfill\kern\z&arobase;&rbrace;</code>, which changes the default
-length of 0.33<dmn>em</dmn> to 1.00<dmn>em</dmn>.
+here
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\renewcommand&lbrace;\hrulefill&rbrace;&lbrace;%
+ \leavevmode\leaders\hrule height 1pt\hfill\kern\z&arobase;&rbrace;
+</pre></example>
-</section>
-<node name="_005caddvspace" spaces=" "><nodename>\addvspace</nodename><nodenext automatic="on">\bigskip \medskip \smallskip</nodenext><nodeprev automatic="on">\hrulefill \dotfill</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
-<section spaces=" "><sectiontitle><code>\addvspace</code></sectiontitle>
-
-<findex index="fn" spaces=" "><indexterm index="fn" number="841">\addvspace</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="442">vertical space</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="443">space, inserting vertical</indexterm></cindex>
+<noindent></noindent>
+<para>which changes the default thickness of 0.4<dmn>pt</dmn> to 1<dmn>pt</dmn>.
+Similarly, adjust the dot spacing as with
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\renewcommand&lbrace;\dotfill&rbrace;&lbrace;%
+ \leavevmode\cleaders\hb&arobase;xt&arobase;1.00em&lbrace;\hss .\hss &rbrace;\hfill\kern\z&arobase;&rbrace;
+</pre></example>
-<para><code>\addvspace&lbrace;<var>length</var>&rbrace;</code>
+<noindent></noindent>
+<para>which changes the default length of 0.33<dmn>em</dmn> to 1.00<dmn>em</dmn>.
+</para>
+<para>This example produces a line for a signature.
</para>
-<para>Add a vertical space of height <var>length</var>, which is a rubber length
-(<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). However, if vertical space has already been added to
-the same point in the output by a previous <code>\addvspace</code> command
-then this command will not add more space than what is needed to make
-the natural length of the total vertical space equal to <var>length</var>.
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;minipage&rbrace;&lbrace;4cm&rbrace;
+ \centering
+ \hrulefill\\
+ Signed
+\end&lbrace;minipage&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>The line is 4<dmn>cm</dmn> long.
</para>
-<para>Use this command to adjust the vertical space above or below an
-environment that starts a new paragraph. For instance, a Theorem
-environment is defined to begin and end with <code>\addvspace&lbrace;...&rbrace;</code>
-so that two consecutive Theorem&textrsquo;s are separated by one vertical space,
-not two.
+
+</section>
+<node name="_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip" spaces=" "><nodename>\bigskip &amp; \medskip &amp; \smallskip</nodename><nodenext automatic="on">\bigbreak &amp; \medbreak &amp; \smallbreak</nodenext><nodeprev automatic="on">\hrulefill &amp; \dotfill</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle><code>\bigskip</code> &amp; <code>\medskip</code> &amp; <code>\smallskip</code></sectiontitle>
+
+<para>Synopsis, one of:
</para>
-<para>This command is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+<example endspaces=" ">
+<pre xml:space="preserve">\bigskip
+\medskip
+\smallskip
+</pre></example>
+
+<para>Produce an amount of vertical space, large or medium-sized or
+small. These commands are fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
-<para>The error <samp>Something's wrong--perhaps a missing \item</samp> means that
-you were not in vertical mode when you invoked this command; one way to
-change that is to precede this command with a <code>\par</code> command.
+<para>Here the skip suggests the passage of time (from <i>The Golden Ocean</i> by
+O&textrsquo;Brian).
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">Mr Saumarez would have something rude to say to him, no doubt: he
+was at home again, and it was delightful.
-</section>
-<node name="_005cbigskip-_005cmedskip-_005csmallskip" spaces=" "><nodename>\bigskip \medskip \smallskip</nodename><nodenext automatic="on">\vfill</nodenext><nodeprev automatic="on">\addvspace</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
-<section spaces=" "><sectiontitle><code>\bigskip \medskip \smallskip</code></sectiontitle>
+\bigskip
+``A hundred and fifty-seven miles and one third, in twenty-four hours,''
+said Peter.
+</pre></example>
-<para>These commands produce a given amount of space, specified by the
-document class.
+<para>Each command is associated with a length defined in the document class
+file.
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="842">\bigskip</indexterm>\bigskip</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="843">\bigskipamount</indexterm></findex>
+<beforefirstitem><anchor name="bigskip">bigskip</anchor>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="852" mergedindex="cp">\bigskip</indexterm>\bigskip</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="853" mergedindex="cp">\bigskipamount</indexterm></findex>
<para>The same as <code>\vspace&lbrace;\bigskipamount&rbrace;</code>, ordinarily about one line
-space, with stretch and shrink (the default for the <code>book</code> and
-<code>article</code> classes is <code>12pt plus 4pt minus 4pt</code>).
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="844">\medskip</indexterm>\medskip</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="845">\medskipamount</indexterm></findex>
-<para>The same as <code>\vspace&lbrace;\medskipamount&rbrace;</code>, ordinarily about half of
-a line space, with stretch and shrink (the default for the <code>book</code>
-and <code>article</code> classes is <code>6pt plus 2pt minus 2pt</code>).
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="846">\smallskip</indexterm>\smallskip</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="847">\smallskipamount</indexterm></findex>
+space, with stretch and shrink. The default for the <code>book</code> and
+<code>article</code> classes is <code>12pt plus 4pt minus 4pt</code>.
+</para>
+<anchor name="medskip">medskip</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="854" mergedindex="cp">\medskip</indexterm>\medskip</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="855" mergedindex="cp">\medskipamount</indexterm></findex>
+<para>The same as <code>\vspace&lbrace;\medskipamount&rbrace;</code>, ordinarily about half of a
+line space, with stretch and shrink. The default for the <code>book</code>
+and <code>article</code> classes is <code>6pt plus 2pt minus 2pt</code>.
+</para>
+<anchor name="smallskip">smallskip</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="856" mergedindex="cp">\smallskip</indexterm>\smallskip</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="857" mergedindex="cp">\smallskipamount</indexterm></findex>
<para>The same as <code>\vspace&lbrace;\smallskipamount&rbrace;</code>, ordinarily about a
-quarter of a line space, with stretch and shrink (the default for the
-<code>book</code> and <code>article</code> classes is <code>3pt plus 1pt minus
-1pt</code>).
+quarter of a line space, with stretch and shrink. The default for the
+<code>book</code> and <code>article</code> classes is <code>3pt plus 1pt minus 1pt</code>.
</para>
</tableitem></tableentry></ftable>
+<para>Because each command is a <code>\vspace</code>, if you use on in mid-paragraph
+then it will insert its vertical space between the line in which you use
+it and the next line, not necessarily at the place that you use it. So
+these are best between paragraphs.
+</para>
+<para>The commands <code>\bigbreak</code>, <code>\medbreak</code>, and <code>\smallbreak</code>
+are similar but also suggest to &latex; that this is a good place to
+put a page break (<pxref label="_005cbigbreak-_0026-_005cmedbreak-_0026-_005csmallbreak"><xrefnodename>\bigbreak &amp; \medbreak &amp; \smallbreak</xrefnodename></pxref>.
+</para>
</section>
-<node name="_005cvfill" spaces=" "><nodename>\vfill</nodename><nodenext automatic="on">\vspace</nodenext><nodeprev automatic="on">\bigskip \medskip \smallskip</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
-<section spaces=" "><sectiontitle><code>\vfill</code></sectiontitle>
+<node name="_005cbigbreak-_0026-_005cmedbreak-_0026-_005csmallbreak" spaces=" "><nodename>\bigbreak &amp; \medbreak &amp; \smallbreak</nodename><nodenext automatic="on">\strut</nodenext><nodeprev automatic="on">\bigskip &amp; \medskip &amp; \smallskip</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle><code>\bigbreak</code> &amp; <code>\medbreak</code> &amp; <code>\smallbreak</code></sectiontitle>
+
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\bigbreak
+\medbreak
+\smallbreak
+</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="848">\vfill</indexterm></findex>
+<para>Produce a vertical space that is big or medium-sized or small, and
+suggest to &latex; that this is a good place to break the page. (The
+associated penalties are -200, -100, and -50.)
+</para>
+<para><xref label="_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip"><xrefnodename>\bigskip &amp; \medskip &amp; \smallskip</xrefnodename></xref>, for more. These commands
+produce the same vertical space but differ in that they also remove a
+preceding vertical space if it is less than what they would insert (as
+with <code>\addvspace</code>). In addition, they terminate a paragraph where
+they are used: this example
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">abc\bigbreak def ghi
-<cindex index="cp" spaces=" "><indexterm index="cp" number="444">stretch, infinite vertical</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="445">infinite vertical stretch</indexterm></cindex>
+jkl mno pqr
+</pre></example>
-<para>End the current paragraph and insert a vertical rubber length
-(<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>) that is infinite, so it can stretch or shrink as far
-as needed.
+<noindent></noindent>
+<para>will output three paragraphs, the first ending in <samp>abc</samp> and the
+second starting, after an extra vertical space and a paragraph indent,
+with <samp>def</samp>.
</para>
-<para>It is often used in the same way as <code>\vspace&lbrace;\fill&rbrace;</code>, except that
-<code>\vfill</code> ends the current paragraph, whereas
-<code>\vspace&lbrace;\fill&rbrace;</code> adds the infinite vertical space below its line
-irrespective of the paragraph structure. In both cases that space will
-disappear at a page boundary; to circumvent this see&nbsp;<ref label="_005cvspace"><xrefnodename>\vspace</xrefnodename></ref>.
+
+</section>
+<node name="_005cstrut" spaces=" "><nodename>\strut</nodename><nodenext automatic="on">\vspace</nodenext><nodeprev automatic="on">\bigbreak &amp; \medbreak &amp; \smallbreak</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle><code>\strut</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="858" mergedindex="cp">\strut</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="621">strut</indexterm></cindex>
+
+<para>Synopsis:
</para>
-<para>In this example the page is filled, so the top and bottom lines contain
-the text <samp>Lost Dog!</samp> and the third <samp>Lost Dog!</samp> is exactly
-halfway between them.
-</para>
<example endspaces=" ">
-<pre xml:space="preserve">\begin&lbrace;document&rbrace;
-Lost Dog!
-\vfill
-Lost Dog!
-\vfill
-Lost Dog!
-\end&lbrace;document&rbrace;
+<pre xml:space="preserve">\strut
</pre></example>
+<para>Ensure that the current line has height at least <code>0.7\baselineskip</code>
+and depth at least <code>0.3\baselineskip</code>. Essentially, &latex;
+inserts into the line a rectangle having zero width,
+<code>\rule[-0.3\baselineskip]&lbrace;0pt&rbrace;&lbrace;\baselineskip&rbrace;</code> (<pxref label="_005crule"><xrefnodename>\rule</xrefnodename></pxref>).
+The <code>\baselineskip</code> changes with the current font and fontsize.
+</para>
+<para>In this example the <code>\strut</code> keeps the box inside the frame from
+having zero height.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\setlength&lbrace;\fboxsep&rbrace;&lbrace;0pt&rbrace;\framebox[2in]&lbrace;\strut&rbrace;
+</pre></example>
+
+<para>This example has four lists. In the first there is a much bigger gap
+between items 2 and&nbsp;3 than there is between items 1 and&nbsp;2.
+The second list fixes that with a <code>\strut</code> at the end of its first
+item&textrsquo;s second line.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\setlength&lbrace;\fboxsep&rbrace;&lbrace;0pt&rbrace;
+\noindent\begin&lbrace;minipage&rbrace;[t]&lbrace;0.2\linewidth&rbrace;
+\begin&lbrace;enumerate&rbrace;
+ \item \parbox[t]&lbrace;15pt&rbrace;&lbrace;test \\ test&rbrace;
+ \item test
+ \item test
+\end&lbrace;enumerate&rbrace;
+\end&lbrace;minipage&rbrace;%
+\begin&lbrace;minipage&rbrace;[t]&lbrace;0.2\linewidth&rbrace;
+\begin&lbrace;enumerate&rbrace;
+ \item \parbox[t]&lbrace;15pt&rbrace;&lbrace;test \\ test\strut&rbrace;
+ \item test
+ \item test
+\end&lbrace;enumerate&rbrace;
+\end&lbrace;minipage&rbrace;%
+\begin&lbrace;minipage&rbrace;[t]&lbrace;0.2\linewidth&rbrace;
+\begin&lbrace;enumerate&rbrace;
+ \item \fbox&lbrace;\parbox[t]&lbrace;15pt&rbrace;&lbrace;test \\ test&rbrace;&rbrace;
+ \item \fbox&lbrace;test&rbrace;
+ \item \fbox&lbrace;test&rbrace;
+\end&lbrace;enumerate&rbrace;
+\end&lbrace;minipage&rbrace;%
+\begin&lbrace;minipage&rbrace;[t]&lbrace;0.2\linewidth&rbrace;
+\begin&lbrace;enumerate&rbrace;
+ \item \fbox&lbrace;\parbox[t]&lbrace;15pt&rbrace;&lbrace;test \\ test\strut&rbrace;&rbrace;
+ \item \fbox&lbrace;test&rbrace;
+ \item \fbox&lbrace;test&rbrace;
+\end&lbrace;enumerate&rbrace;
+\end&lbrace;minipage&rbrace;%
+</pre></example>
+
+<noindent></noindent>
+<para>The final two lists use <code>fbox</code> to show what&textrsquo;s happening. The third
+list&textrsquo;s <code>\parbox</code> goes only to the bottom of its second <samp>test</samp>,
+which happens not have any characters that descend below the baseline.
+The fourth list adds the strut that gives the needed extra
+below-baseline space.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="622"><r>package</r>, <code>TikZ</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="623"><code>TikZ</code> <r>package</r></indexterm></cindex>
+ <cindex index="cp" spaces=" "><indexterm index="cp" number="624"><r>package</r>, <code>Asymptote</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="625"><code>Asymptote</code> <r>package</r></indexterm></cindex>
+
+<para>The <code>\strut</code> command is often useful in graphics, such as in
+<file>TikZ</file> or <file>Asymptote</file>. For instance, you may have a command
+such as <code>\graphnode&lbrace;<var>node-name</var>&rbrace;</code> that fits a circle around
+<var>node-name</var>. However, unless you are careful the <var>node-name</var>&textrsquo;s
+<samp>x</samp> and <samp>y</samp> will produce different-diameter circles because
+the characters are different sizes. A careful <code>\graphnode</code> might
+insert a <code>\strut</code>, then <var>node-name</var>, and then draw the circle.
+</para>
+<para>The general approach of using a zero width <code>\rule</code> is useful in
+many circumstances. In this table, the zero-width rule keeps the top of
+the first integral from hitting the <code>\hline</code>. Similarly, the
+second rule keeps the second integral from hitting the first.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;tabular&rbrace;&lbrace;rl&rbrace;
+ \textsc&lbrace;Integral&rbrace; &amp;\textsc&lbrace;Value&rbrace; \\
+ \hline
+ $\int_0^x t\, dt$ &amp;$x^2/2$ \rule&lbrace;0em&rbrace;&lbrace;2.5ex&rbrace; \\
+ $\int_0^x t^2\, dt$ &amp;$x^3/3$ \rule&lbrace;0em&rbrace;&lbrace;2.5ex&rbrace;
+\end&lbrace;tabular&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>(Although the line-ending double backslash command has an available
+optional argument to put in more vertical room, that won&textrsquo;t work here.
+Changing the first double backslash to something like <code>\\[2.5ex]</code>
+will put the room between the header line and the <code>\hline</code>, and the
+integral would still hit the line.)
+</para>
</section>
-<node name="_005cvspace" spaces=" "><nodename>\vspace</nodename><nodeprev automatic="on">\vfill</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
-<section spaces=" "><sectiontitle><code>\vspace&lbrace;<var>length</var>&rbrace;</code></sectiontitle>
+<node name="_005cvspace" spaces=" "><nodename>\vspace</nodename><nodenext automatic="on">\vfill</nodenext><nodeprev automatic="on">\strut</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle><code>\vspace</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="849">\vspace</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="446">vertical space</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="447">space, vertical</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="859" mergedindex="cp">\vspace</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="626">vertical space</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="627">space, vertical</indexterm></cindex>
-<para>Synopsis, one of these two:
+<para>Synopsis, one of:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\vspace&lbrace;<var>length</var>&rbrace;
\vspace*&lbrace;<var>length</var>&rbrace;
</pre></example>
-<para>Add the vertical space <var>length</var>. This can be negative or positive,
-and is a rubber length (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>).
+<para>Add the vertical space <var>length</var>. The <var>length</var> can be positive,
+negative, or zero. It is a rubber length&textmdash;it may contain a <code>plus</code>
+or <code>minus</code> component (<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>).
+</para>
+<para>This puts space between the two paragraphs.
</para>
-<para>&latex; removes the vertical space from <code>\vspace</code> at a page
-break, that is, at the top or bottom of a page. The starred version
-<code>\vspace*&lbrace;...&rbrace;</code> causes the space to stay.
+<example endspaces=" ">
+<pre xml:space="preserve">And I slept.
+
+\vspace&lbrace;1ex plus 0.5ex&rbrace;
+The new day dawned cold.
+</pre></example>
+
+<noindent></noindent>
+<para>(<xref label="_005cbigskip-_0026-_005cmedskip-_0026-_005csmallskip"><xrefnodename>\bigskip &amp; \medskip &amp; \smallskip</xrefnodename></xref> for common inter-paragraph
+spaces.)
</para>
-<para>If <code>\vspace</code> is used in the middle of a paragraph (i.e., in
-horizontal mode), the space is inserted <emph>after</emph> the line with
-the <code>\vspace</code> command. A new paragraph is not started.
+<para>The <code>*</code>-version inserts vertical space that non-discardable. More
+precisely, &latex; discards vertical space at a page break and the
+<code>*</code>-version causes the space to stay. This example leaves space
+between the two questions.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">Question: Find the integral of \( 5x^4+5 \).
+
+\vspace*&lbrace;2cm plus 0.5cm&rbrace;
+Question: Find the derivative of \( x^5+5x+9 \).
+</pre></example>
+
+<noindent></noindent>
+<para>That space will be present even if the page break happens to fall
+between the questions.
+</para>
+<para>If you use <code>\vspace</code> in the middle of a paragraph (i.e., in
+horizontal mode) then the space is inserted after the line containing
+the <code>\vspace</code> command; it does not start a new paragraph at the
+<code>\vspace</code> command.
</para>
<para>In this example the two questions will be evenly spaced vertically on
the page, with at least one inch of space below each.
@@ -10117,255 +14028,632 @@ the page, with at least one inch of space below each.
</section>
+<node name="_005cvfill" spaces=" "><nodename>\vfill</nodename><nodenext automatic="on">\addvspace</nodenext><nodeprev automatic="on">\vspace</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle><code>\vfill</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="860" mergedindex="cp">\vfill</indexterm></findex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="628">stretch, infinite vertical</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="629">infinite vertical stretch</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\vfill
+</pre></example>
+
+<para>End the current paragraph and insert a vertical rubber length that is
+infinite, so it can stretch or shrink as far as needed
+(<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>).
+</para>
+<para>It is often used in the same way as <code>\vspace&lbrace;\fill&rbrace;</code>, except that
+<code>\vfill</code> ends the current paragraph whereas <code>\vspace&lbrace;\fill&rbrace;</code>
+adds the infinite vertical space below its line, irrespective of the
+paragraph structure. In both cases that space will disappear at a page
+boundary; to circumvent this see the starred option
+in&nbsp;<ref label="_005cvspace"><xrefnodename>\vspace</xrefnodename></ref>.
+</para>
+<para>In this example the page is filled, so the top and bottom lines contain
+the text <samp>Lost Dog!</samp> and the second <samp>Lost Dog!</samp> is exactly
+halfway between them.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;document&rbrace;
+Lost Dog!
+\vfill
+Lost Dog! % perfectly in the middle
+\vfill
+Lost Dog!
+\end&lbrace;document&rbrace;
+</pre></example>
+
+
+</section>
+<node name="_005caddvspace" spaces=" "><nodename>\addvspace</nodename><nodeprev automatic="on">\vfill</nodeprev><nodeup automatic="on">Spaces</nodeup></node>
+<section spaces=" "><sectiontitle><code>\addvspace</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="861" mergedindex="cp">\addvspace</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="630">vertical space</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="631">space, inserting vertical</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\addvspace&lbrace;<var>vert-length</var>&rbrace;
+</pre></example>
+
+<para>Add a vertical space of <var>vert-length</var>. However, if there are two or
+more <code>\addvspace</code>&textrsquo;s in a sequence then together they only add the
+space needed to make the natural length equal to the maximum of the
+<var>vert-length</var>&textrsquo;s in that sequence. This command is fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>). The <var>vert-length</var> is a rubber length
+(<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>).
+</para>
+<para>This example illustrates. The <code>picture</code> draws a scale. In a
+standard &latex; article the length <code>\baselineskip</code> is 12<dmn>pt</dmn>.
+The two rules here are 22<dmn>pt</dmn> apart: the sum of the
+<code>\baselineskip</code> and the 10<dmn>pt</dmn> from the first <code>addvspace</code>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;article&rbrace;
+\usepackage&lbrace;color&rbrace;
+\begin&lbrace;document&rbrace;
+\setlength&lbrace;\unitlength&rbrace;&lbrace;2pt&rbrace;%
+\noindent\begin&lbrace;picture&rbrace;(0,0)%
+ \multiput(0,0)(0,-1)&lbrace;25&rbrace;&lbrace;&lbrace;\color&lbrace;blue&rbrace;\line(1,0)&lbrace;1&rbrace;&rbrace;&rbrace;
+ \multiput(0,0)(0,-5)&lbrace;6&rbrace;&lbrace;&lbrace;\color&lbrace;red&rbrace;\line(1,0)&lbrace;2&rbrace;&rbrace;&rbrace;
+\end&lbrace;picture&rbrace;%
+\rule&lbrace;0.25\linewidth&rbrace;&lbrace;0.1pt&rbrace;%
+\par\addvspace&lbrace;10pt&rbrace;% \addvspace&lbrace;20pt&rbrace;%
+\par\noindent\rule&lbrace;0.25\linewidth&rbrace;&lbrace;0.1pt&rbrace;%
+\end&lbrace;document&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>Now uncomment the second <code>\addvspace</code>. It does not make the gap
+20<dmn>pt</dmn> longer; instead the gap is the sum of <code>\baselineskip</code>
+and 20<dmn>pt</dmn>. So <code>\addvspace</code> in a sense does the opposite of
+its name &textmdash; it makes sure that multiple vertical spaces do not
+accumulate, but instead that only the largest one is used.
+</para>
+<para>&latex; uses this command to adjust the vertical space above or below
+an environment that starts a new paragraph. For instance, a
+<code>theorem</code> environment begins and ends with <code>\addvspace</code> so
+that two consecutive <code>theorem</code>&textrsquo;s are separated by one vertical
+space, not two.
+</para>
+<para>A error <samp>Something's wrong--perhaps a missing \item</samp> pointing to an
+<code>\addvspace</code> means that you were not in vertical mode when you hit
+this command. One way to change that is to precede <code>\addvspace</code>
+with a <code>\par</code> command (<pxref label="_005cpar"><xrefnodename>\par</xrefnodename></pxref>), as in the above example.
+</para>
+
+</section>
</chapter>
<node name="Boxes" spaces=" "><nodename>Boxes</nodename><nodenext automatic="on">Color</nodenext><nodeprev automatic="on">Spaces</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Boxes</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="448">boxes</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="632">boxes</indexterm></cindex>
-<para>All the predefined length parameters (<pxref label="Predefined-lengths"><xrefnodename>Predefined lengths</xrefnodename></pxref>) can be
-used in the arguments of the box-making commands.
+<para>At its core, &latex; puts things in boxes and then puts the boxes on a
+page. So these commands are central.
+</para>
+<para>There are many packages on CTAN that are useful for manipulating boxes.
+One useful adjunct to the commands here is <file>adjustbox</file>.
</para>
<menu endspaces=" ">
-<menuentry leadingtext="* "><menunode separator=":: ">\mbox</menunode><menudescription><pre xml:space="preserve">Horizontal boxes.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\fbox and \framebox</menunode><menudescription><pre xml:space="preserve">Put a frame around a box.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">lrbox</menunode><menudescription><pre xml:space="preserve">An environment like <code>\sbox</code>.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\makebox</menunode><menudescription><pre xml:space="preserve">Box, adjustable position.
+<menuentry leadingtext="* "><menunode separator=":: ">\mbox &amp; \makebox</menunode><menudescription><pre xml:space="preserve">Horizontal boxes.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\fbox &amp; \framebox</menunode><menudescription><pre xml:space="preserve">Put a frame around a box.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\parbox</menunode><menudescription><pre xml:space="preserve">Box with text in paragraph mode.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\raisebox</menunode><menudescription><pre xml:space="preserve">Raise or lower text.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\savebox</menunode><menudescription><pre xml:space="preserve">Like <code>\makebox</code>, but save the text for later use.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\sbox</menunode><menudescription><pre xml:space="preserve">Like <code>\mbox</code>, but save the text for later use.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\sbox &amp; \savebox</menunode><menudescription><pre xml:space="preserve">Like <code>\makebox</code> but save the text for later.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">lrbox</menunode><menudescription><pre xml:space="preserve">Environment version of <code>\sbox</code>.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\usebox</menunode><menudescription><pre xml:space="preserve">Print saved text.
</pre></menudescription></menuentry></menu>
-<node name="_005cmbox" spaces=" "><nodename>\mbox</nodename><nodenext automatic="on">\fbox and \framebox</nodenext><nodeup automatic="on">Boxes</nodeup></node>
-<section spaces=" "><sectiontitle><code>\mbox&lbrace;<var>text&rbrace;</var></code></sectiontitle>
+<node name="_005cmbox-_0026-_005cmakebox" spaces=" "><nodename>\mbox &amp; \makebox</nodename><nodenext automatic="on">\fbox &amp; \framebox</nodenext><nodeup automatic="on">Boxes</nodeup></node>
+<section spaces=" "><sectiontitle><code>\mbox</code> &amp; <code>\makebox</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="862" mergedindex="cp">\mbox</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="863" mergedindex="cp">\makebox</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="633">box</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="634">make a box</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="635">hyphenation, preventing</indexterm></cindex>
+
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\mbox&lbrace;<var>text</var>&rbrace;
+\makebox&lbrace;<var>text</var>&rbrace;
+\makebox[<var>width</var>]&lbrace;<var>text</var>&rbrace;
+\makebox[<var>width</var>][<var>position</var>]&lbrace;<var>text</var>&rbrace;
+</pre></example>
+
+<para>Create a box, a container for material. The <var>text</var> is is typeset in
+LR mode (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>) so it is not broken into lines. The
+<code>\mbox</code> command is robust, while <code>\makebox</code> is fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<para>Because <code>text</code> is not broken into lines, you can use <code>\mbox</code>
+to prevent hyphenation. In this example, &latex; will not hyphenate
+the table name, <samp>T-4</samp>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">See Table~\mbox&lbrace;T-4&rbrace;
+</pre></example>
+
+<para>The first two command versions, <code>\mbox</code> and <code>\makebox</code>, are
+roughly equivalent. They create a box just wide enough to contain the
+<var>text</var>. (They are like plain &tex;&textrsquo;s <code>\hbox</code>.)
+</para>
+<para>In the third version the optional argument <var>width</var> specifies the
+width of the box. Note that the space occupied by the text need not
+equal the width of the box. For one thing, <var>text</var> can be too small;
+this creates a full-line box
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\makebox[\linewidth]&lbrace;Chapter Exam&rbrace;
+</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="850">\mbox</indexterm></findex>
+<noindent></noindent>
+<para>with <samp>Chapter Exam</samp> centered. But <var>text</var> can also be too wide
+for <var>width</var>. See the example below of zero-width boxes.
+</para>
+<anchor name="mbox-makebox-depth">mbox makebox depth</anchor>
+<anchor name="mbox-makebox-height">mbox makebox height</anchor>
+<anchor name="mbox-makebox-width">mbox makebox width</anchor>
+<anchor name="mbox-makebox-totalheight">mbox makebox totalheight</anchor>
+<para>In the <var>width</var> argument you can use the following lengths that refer
+to the dimension of the box that &latex; gets on typesetting
+<var>text</var>: <code>\depth</code>, <code>\height</code>, <code>\width</code>,
+<code>\totalheight</code> (this is the box&textrsquo;s height plus its depth). For
+example, to make a box with the text stretched to double the natural
+size you can say this.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\makebox[2\width]&lbrace;Get a stretcher&rbrace;
+</pre></example>
+
+<para>For the fourth command version the optional argument <var>position</var>
+gives position of the text within the box. It may take the following
+values:
+</para>
+<table commandarg="code" spaces=" " endspaces=" ">
+<tableentry><tableterm><item spaces=" "><itemformat command="code">c</itemformat></item>
+</tableterm><tableitem><para>The <var>text</var> is centered (default).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">l</itemformat></item>
+</tableterm><tableitem><para>The <var>text</var> is flush left.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">r</itemformat></item>
+</tableterm><tableitem><para>Flush right.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">s</itemformat></item>
+</tableterm><tableitem><para>Stretch the interword space in <var>text</var> across the entire <var>width</var>.
+The <var>text</var> must contain stretchable space for this to work. For
+instance, this could head a press release:
+<code>\noindent\makebox[\textwidth][s]&lbrace;\large\hfil IMMEDIATE\hfil
+RELEASE\hfil&rbrace;</code>
+</para></tableitem></tableentry></table>
+
+<para>A common use of <code>\makebox</code> is to make zero-width text boxes. This
+puts the value of the quiz questions to the left of those questions.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand&lbrace;\pts&rbrace;[1]&lbrace;\makebox[0em][r]&lbrace;#1 points\hspace*&lbrace;1em&rbrace;&rbrace;&rbrace;
+\pts&lbrace;10&rbrace;What is the air-speed velocity of an unladen swallow?
+
+\pts&lbrace;90&rbrace;An African or European swallow?
+</pre></example>
+
+<noindent></noindent>
+<para><cindex index="cp" spaces=" "><indexterm index="cp" number="636"><r>package</r>, <code>TikZ</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="637"><code>TikZ</code> <r>package</r></indexterm></cindex>
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="638"><r>package</r>, <code>Asymptote</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="639"><code>Asymptote</code> <r>package</r></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="449">hyphenation, preventing</indexterm></cindex>
-<para>The <code>\mbox</code> command creates a box just wide enough to hold the
-text created by its argument. The <var>text</var> is not broken into
-lines, so it can be used to prevent hyphenation.
+<para>The right edge of the output <samp>10 points </samp> (note the ending space)
+will be just before the <samp>What</samp> (note the space after
+<samp>points</samp>). You can use <code>\makebox</code> similarly when making
+graphics, such as in <file>TikZ</file> or <file>Asymptote</file>, where you put the
+edge of the text at a known location, regardless of the length of that
+text.
+</para>
+<para>For boxes with frames see&nbsp;<ref label="_005cfbox-_0026-_005cframebox"><xrefnodename>\fbox &amp; \framebox</xrefnodename></ref>. For colors
+see&nbsp;<ref label="Colored-boxes"><xrefnodename>Colored boxes</xrefnodename></ref>.
+</para>
+<para>There is a related version of <code>\makebox</code> that is used within the
+<code>picture</code> environment, where the length is given in terms of
+<code>\unitlength</code> (<pxref label="_005cmakebox-_0028picture_0029"><xrefnodename>\makebox (picture)</xrefnodename></pxref>).
+</para>
+<para>If you put a double-backslash into <var>text</var> then &latex; will not
+give you a new line; for instance <code>\makebox&lbrace;abc def \\ ghi&rbrace;</code>
+outputs <samp>abc defghi</samp> while <code>\makebox&lbrace;abc def \par ghi&rbrace;</code>
+outputs <samp>abc def ghi</samp>, but neither go to a second line. To get
+multiple lines see&nbsp;<ref label="_005cparbox"><xrefnodename>\parbox</xrefnodename></ref> and&nbsp;<ref label="minipage"><xrefnodename>minipage</xrefnodename></ref>.
</para>
</section>
-<node name="_005cfbox-and-_005cframebox" spaces=" "><nodename>\fbox and \framebox</nodename><nodenext automatic="on">lrbox</nodenext><nodeprev automatic="on">\mbox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
-<section spaces=" "><sectiontitle><code>\fbox</code> and <code>\framebox</code></sectiontitle>
+<node name="_005cfbox-_0026-_005cframebox" spaces=" "><nodename>\fbox &amp; \framebox</nodename><nodenext automatic="on">\parbox</nodenext><nodeprev automatic="on">\mbox &amp; \makebox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
+<section spaces=" "><sectiontitle><code>\fbox</code> &amp; <code>\framebox</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="851">\fbox</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="852">\framebox</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="864" mergedindex="cp">\fbox</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="865" mergedindex="cp">\framebox</indexterm></findex>
-<para>Synopses:
+<para>Synopses, one of:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\fbox&lbrace;<var>text</var>&rbrace;
+\framebox&lbrace;<var>text</var>&rbrace;
+\framebox[<var>width</var>]&lbrace;<var>text</var>&rbrace;
\framebox[<var>width</var>][<var>position</var>]&lbrace;<var>text</var>&rbrace;
</pre></example>
-<para>The <code>\fbox</code> and <code>\framebox</code> commands are like <code>\mbox</code>,
-except that they put a frame around the outside of the box being created.
-</para>
-<para>In addition, the <code>\framebox</code> command allows for explicit
-specification of the box width with the optional <var>width</var> argument
-(a dimension), and positioning with the optional <var>position</var>
-argument. <!-- c xxref -->
+<para>Create a box with an enclosing frame, four lines surrounding the space.
+These commands are the same as <code>\mbox</code> and <code>\makebox</code> except
+for the frame (<pxref label="_005cmbox-_0026-_005cmakebox"><xrefnodename>\mbox &amp; \makebox</xrefnodename></pxref>). The <code>\fbox</code> command is
+robust, the <code>\framebox</code> command is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="853">\fboxrule</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="854">\fboxsep</indexterm></findex>
-<para>Both commands produce a rule of thickness <code>\fboxrule</code> (default
-<code>0.4pt</code>), and leave a space of <code>\fboxsep</code> (default <code>3pt</code>)
-between the rule and the contents of the box.
+<example endspaces=" ">
+<pre xml:space="preserve">\fbox&lbrace;Warning! No work shown, no credit given.&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>&latex; puts the text into a box that cannot be split or hyphenated.
+Around that box, separated from it by a small gap, are four lines making
+a frame.
</para>
-<para><xref label="_005cframebox-_0028picture_0029"><xrefnodename>\framebox (picture)</xrefnodename></xref>, for the <code>\framebox</code> command in the
-<code>picture</code> environment.
+<para>The first two command invocations, <code>\fbox&lbrace;...&rbrace;</code> and
+<code>\framebox&lbrace;...&rbrace;</code>, are roughly the same. As to the third and
+fourth invocations, the optional arguments allow you to specify the box
+width as <var>width</var> and the position of the text inside that box as
+<var>position</var>. <xref label="_005cmbox-_0026-_005cmakebox"><xrefnodename>\mbox &amp; \makebox</xrefnodename></xref> for the full description but
+here is an example creating an empty box that is 1/4<dmn>in</dmn> wide.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\setlength&lbrace;\fboxsep&rbrace;&lbrace;0pt&rbrace;\framebox[0.25in]&lbrace;\strut&rbrace;&rbrace;
+</pre></example>
-</section>
-<node name="lrbox" spaces=" "><nodename>lrbox</nodename><nodenext automatic="on">\makebox</nodenext><nodeprev automatic="on">\fbox and \framebox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
-<section spaces=" "><sectiontitle><code>lrbox</code></sectiontitle>
+<noindent></noindent>
+<para>The <code>\strut</code> inserts a vertical height of <code>\baselineskip</code>
+(<pxref label="_005cstrut"><xrefnodename>\strut</xrefnodename></pxref>).
+</para>
+<para>These parameters determine the frame layout.
+</para>
+<ftable commandarg="code" spaces=" " endspaces=" ">
+<beforefirstitem><anchor name="fbox-framebox-fboxrule">fbox framebox fboxrule</anchor>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="866" mergedindex="cp">\fboxrule</indexterm>\fboxrule</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="867" mergedindex="cp">frame, line width</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="868" mergedindex="cp">frame rule width</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="640">\fboxrule</indexterm></cindex>
+<para>The thickness of the lines around the enclosed box. The default is
+0.2<dmn>pt</dmn>. Change it with a command such as
+<code>\setlength&lbrace;\fboxrule&rbrace;&lbrace;0.8pt&rbrace;</code> (<pxref label="_005csetlength"><xrefnodename>\setlength</xrefnodename></pxref>).
+</para>
+<anchor name="fbox-framebox-fboxsep">fbox framebox fboxsep</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="869" mergedindex="cp">\fboxsep</indexterm>\fboxsep</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="870" mergedindex="cp">frame, separation from contents</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="641">\fboxsep</indexterm></cindex>
+<para>The distance from the frame to the enclosed box. The default is 3<dmn>pt</dmn>.
+Change it with a command such as <code>\setlength&lbrace;\fboxsep&rbrace;&lbrace;0pt&rbrace;</code>
+(<pxref label="_005csetlength"><xrefnodename>\setlength</xrefnodename></pxref>). Setting it to 0<dmn>pt</dmn> is useful sometimes:
+this will put a frame around the picture with no white border.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">&lbrace;\setlength&lbrace;\fboxsep&rbrace;&lbrace;0pt&rbrace;
+ \framebox&lbrace;%
+ \includegraphics[width=0.5\textwidth]&lbrace;prudence.jpg&rbrace;&rbrace;&rbrace;
+</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="855">lrbox</indexterm></findex>
+<noindent></noindent>
+<para>The extra curly braces keep the effect of the <code>\setlength</code> local.
+</para>
+</tableitem></tableentry></ftable>
-<para>Synopsis:
+<para>As with <code>\mbox</code> and <code>\makebox</code>, &latex; will not break lines
+in <var>text</var>. But this example has &latex; break lines to make a
+paragraph, and then frame the result.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\begin&lbrace;lrbox&rbrace;&lbrace;\<var>cmd</var>&rbrace;
- <var>text </var>
-\end&lbrace;lrbox&rbrace;
+<pre xml:space="preserve">\framebox&lbrace;%
+ \begin&lbrace;minipage&rbrace;&lbrace;0.6\linewidth&rbrace;
+ My dear, here we must run as fast as we can, just to stay in place.
+ And if you wish to go anywhere you must run twice as fast as that.
+ \end&lbrace;minipage&rbrace;&rbrace;
</pre></example>
-<para>This is the environment form of <ref label="_005csbox"><xrefnodename>\sbox</xrefnodename><xrefinfoname><code>\sbox</code></xrefinfoname></ref>.
+<para><xref label="Colored-boxes"><xrefnodename>Colored boxes</xrefnodename></xref> for colors other than black and white.
</para>
-<para>The <var>text</var> inside the environment is saved in the box <code>\<var>cmd</var></code>,
-which must have been declared with <code>\newsavebox</code>.
+<para>The <code>picture</code> environment has a version of this command where the
+units depend on <code>picture</code>&textrsquo;s <code>\unitlength</code> (<pxref label="_005cframebox-_0028picture_0029"><xrefnodename>\framebox
+(picture)</xrefnodename></pxref>).
</para>
</section>
-<node name="_005cmakebox" spaces=" "><nodename>\makebox</nodename><nodenext automatic="on">\parbox</nodenext><nodeprev automatic="on">lrbox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
-<section spaces=" "><sectiontitle><code>\makebox</code></sectiontitle>
+<node name="_005cparbox" spaces=" "><nodename>\parbox</nodename><nodenext automatic="on">\raisebox</nodenext><nodeprev automatic="on">\fbox &amp; \framebox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
+<section spaces=" "><sectiontitle><code>\parbox</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="856">\makebox</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="871" mergedindex="cp">\parbox</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="642">paragraph mode</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="643">paragraph, in a box</indexterm></cindex>
-<para>Synopsis:
+<para>Synopses, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\makebox[<var>width</var>][<var>position</var>]&lbrace;<var>text</var>&rbrace;
+<pre xml:space="preserve">\parbox&lbrace;<var>width</var>&rbrace;&lbrace;<var>contents</var>&rbrace;
+\parbox[<var>position</var>]&lbrace;<var>width</var>&rbrace;&lbrace;<var>contents</var>&rbrace;
+\parbox[<var>position</var>][<var>height</var>]&lbrace;<var>width</var>&rbrace;&lbrace;<var>contents</var>&rbrace;
+\parbox[<var>position</var>][<var>height</var>][<var>inner-pos</var>]&lbrace;<var>width</var>&rbrace;&lbrace;<var>contents</var>&rbrace;
</pre></example>
-<para>The <code>\makebox</code> command creates a box just wide enough to contain
-the <var>text</var> specified. The width of the box can be overridden by the
-optional <var>width</var> argument. The position of the text within the box
-is determined by the optional <var>position</var> argument, which may take
-the following values:
+<para>Produce a box of text that is <var>width</var> wide. Use this command to make
+a box of small pieces of text, of a single paragraph. This command is
+fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
-<table commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code">c</itemformat></item>
-</tableterm><tableitem><para>Centered (default).
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">l</itemformat></item>
-</tableterm><tableitem><para>Flush left.
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">r</itemformat></item>
-</tableterm><tableitem><para>Flush right.
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">s</itemformat></item>
-</tableterm><tableitem><para>Stretch (justify) across entire <var>width</var>; <var>text</var> must contain
-stretchable space for this to work.
-</para></tableitem></tableentry></table>
+<example endspaces=" ">
+<pre xml:space="preserve">\begin&lbrace;picture&rbrace;(0,0)
+ ...
+ \put(1,2)&lbrace;\parbox&lbrace;1.75in&rbrace;&lbrace;\raggedright Because the graph is a line on
+ this semilog paper, the relationship is
+ exponential.&rbrace;&rbrace;
+\end&lbrace;picture&rbrace;
+</pre></example>
-<para><code>\makebox</code> is also used within the <code>picture</code> environment
-<pxref label="_005cmakebox-_0028picture_0029"><xrefnodename>\makebox (picture)</xrefnodename></pxref>.
+<para>The <var>contents</var> are processed in a text mode (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>) so
+&latex; will break lines to make a paragraph. But it won&textrsquo;t make
+multiple paragraphs; for that, use a <code>minipage</code> environment
+(<pxref label="minipage"><xrefnodename>minipage</xrefnodename></pxref>).
+</para>
+<para>The options for <code>\parbox</code> (except for <var>contents</var>) are the same
+as those for <code>minipage</code>. For convenience a summary of the options
+is here but see&nbsp;<ref label="minipage"><xrefnodename>minipage</xrefnodename></ref> for a complete description.
+</para>
+<para>There are two required arguments. The <var>width</var> is a rigid length
+(<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). It sets the width of the box into which &latex;
+typesets <var>contents</var>. The <var>contents</var> is the text that is placed
+in that box. It should not have any paragraph-making components.
+</para>
+<para>There are three optional arguments, <var>position</var>, <var>height</var>, and
+<var>inner-pos</var>. The <var>position</var> gives the vertical alignment of the
+<code>parbox</code> with respect to the surrounding material. The possible
+values are <code>c</code> or <code>m</code> to make the vertical center of the
+<code>parbox</code> lines up with the center of the adjacent line (this is the
+default), or <code>t</code> to match the top line of the <code>parbox</code> with
+the baseline of the surrounding material, or <code>b</code> to match the
+bottom line.
+</para>
+<para>The optional argument <var>height</var> overrides the natural height of the
+box.
+</para>
+<para>The optional argument <var>inner-pos</var> controls the placement of
+<var>content</var> inside the <code>parbox</code>. Its default is the value of
+<var>position</var>. Its possible values are: <code>t</code> to put the
+<var>content</var> at the top of the box, <code>c</code> to put it in the vertical
+center, <code>b</code> to put it at the bottom of the box, and <code>s</code> to
+stretch it out vertically (for this, the text must contain vertically
+stretchable space).
</para>
-
</section>
-<node name="_005cparbox" spaces=" "><nodename>\parbox</nodename><nodenext automatic="on">\raisebox</nodenext><nodeprev automatic="on">\makebox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
-<section spaces=" "><sectiontitle><code>\parbox</code></sectiontitle>
+<node name="_005craisebox" spaces=" "><nodename>\raisebox</nodename><nodenext automatic="on">\sbox &amp; \savebox</nodenext><nodeprev automatic="on">\parbox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
+<section spaces=" "><sectiontitle><code>\raisebox</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="857">\parbox</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="872" mergedindex="cp">\raisebox</indexterm></findex>
-<para>Synopsis:
+<para>Synopsis, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\parbox[<var>position</var>][<var>height</var>][<var>inner-pos</var>]&lbrace;<var>width</var>&rbrace;&lbrace;<var>text</var>&rbrace;
+<pre xml:space="preserve">\raisebox&lbrace;<var>distance</var>&rbrace;&lbrace;<var>text</var>&rbrace;
+\raisebox&lbrace;<var>distance</var>&rbrace;[<var>height</var>]&lbrace;<var>text</var>&rbrace;
+\raisebox&lbrace;<var>distance</var>&rbrace;[<var>height</var>][<var>depth</var>]&lbrace;<var>text</var>&rbrace;
</pre></example>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="450">paragraph mode</indexterm></cindex>
-<para>The <code>\parbox</code> command produces a box whose contents are created
-in <dfn>paragraph mode</dfn>. It should be used to make a box small
-pieces of text, with nothing fancy inside. In particular, you
-shouldn&textrsquo;t use any paragraph-making environments inside a
-<code>\parbox</code> argument. For larger pieces of text, including ones
-containing a paragraph-making environment, you should use a
-<code>minipage</code> environment (<pxref label="minipage"><xrefnodename>minipage</xrefnodename></pxref>).
+<para>Raise or lower <var>text</var>. This command is fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
-<para><code>\parbox</code> has two mandatory arguments:
+<para>This example makes a command for the restriction of a function by
+lowering the vertical bar symbol.
</para>
-<table commandarg="var" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="var">width</itemformat></item>
-</tableterm><tableitem><para>the width of the parbox;
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">text</itemformat></item>
-</tableterm><tableitem><para>the text that goes inside the parbox.
-</para></tableitem></tableentry></table>
+<!-- c credit: egreg https://tex.stackexchange.com/a/278631/121234 -->
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand\restricted[1]&lbrace;\raisebox&lbrace;-.5ex&rbrace;&lbrace;$|$&rbrace;_&lbrace;#1&rbrace;&rbrace;
+$f\restricted&lbrace;A&rbrace;$
+</pre></example>
-<para>By default &latex; will position vertically a parbox so its center
-lines up with the center of the surrounding text line. When the
-optional <var>position</var> argument is present and equal either to <samp>t</samp>
-or <samp>b</samp>, this allows you respectively to align either the top or
-bottom line in the parbox with the baseline of the surrounding text. You
-may also specify <samp>m</samp> for <var>position</var> to get the default
-behaviour.
+<para>The first mandatory argument <var>distance</var> specifies how far to raise
+the second mandatory argument <var>text</var>. This is a rigid length
+(<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). If it is negative then it lowers <var>text</var>. The
+<var>text</var> is processed in LR mode so it cannot contain line breaks
+(<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>).
</para>
-<para>The optional <var>height</var> argument overrides the natural height of the box.
+<para>The optional arguments <var>height</var> and <var>depth</var> are dimensions. If
+they are specified, they override the natural height and depth of the
+box &latex; gets by typesetting <var>text</var>.
</para>
-<para>The <var>inner-pos</var> argument controls the placement of the text inside
-the box, as follows; if it is not specified, <var>position</var> is used.
+<anchor name="raisebox-depth">raisebox depth</anchor>
+<anchor name="raisebox-height">raisebox height</anchor>
+<anchor name="raisebox-width">raisebox width</anchor>
+<anchor name="raisebox-totalheight">raisebox totalheight</anchor>
+<para>In the arguments <var>distance</var>, <var>height</var>, and <var>depth</var> you can
+use the following lengths that refer to the dimension of the box that
+&latex; gets on typesetting <var>text</var>: <code>\depth</code>, <code>\height</code>,
+<code>\width</code>, <code>\totalheight</code> (this is the box&textrsquo;s height plus its
+depth).
</para>
-<table commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code">t</itemformat></item>
-</tableterm><tableitem><para>text is placed at the top of the box.
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">c</itemformat></item>
-</tableterm><tableitem><para>text is centered in the box.
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">b</itemformat></item>
-</tableterm><tableitem><para>text is placed at the bottom of the box.
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">s</itemformat></item>
-</tableterm><tableitem><para>stretch vertically; the text must contain vertically stretchable space
-for this to work.
-</para></tableitem></tableentry></table>
+<para>This will align two graphics on their top (<pxref label="Graphics"><xrefnodename>Graphics</xrefnodename></pxref>).
+</para>
+<!-- c credit: FAQ https://texfaq.org/FAQ-topgraph -->
+<example endspaces=" ">
+<pre xml:space="preserve">\usepackage&lbrace;graphicx&rbrace; \usepackage&lbrace;calc&rbrace; % in preamble
+ ...
+\begin&lbrace;center&rbrace;
+ \raisebox&lbrace;1ex-\height&rbrace;&lbrace;%
+ \includegraphics[width=0.4\linewidth]&lbrace;lion.png&rbrace;&rbrace;
+ \qquad
+ \raisebox&lbrace;1ex-\height&rbrace;&lbrace;%
+ \includegraphics[width=0.4\linewidth]&lbrace;meta.png&rbrace;&rbrace;
+\end&lbrace;center&rbrace;
+</pre></example>
+<noindent></noindent>
+<para>The first <code>\height</code> is the height of <file>lion.png</file> while the
+second is the height of <file>meta.png</file>.
+</para>
</section>
-<node name="_005craisebox" spaces=" "><nodename>\raisebox</nodename><nodenext automatic="on">\savebox</nodenext><nodeprev automatic="on">\parbox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
-<section spaces=" "><sectiontitle><code>\raisebox</code></sectiontitle>
+<node name="_005csbox-_0026-_005csavebox" spaces=" "><nodename>\sbox &amp; \savebox</nodename><nodenext automatic="on">lrbox</nodenext><nodeprev automatic="on">\raisebox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
+<section spaces=" "><sectiontitle><code>\sbox</code> &amp; <code>\savebox</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="858">\raisebox</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="873" mergedindex="cp">\sbox</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="874" mergedindex="cp">\savebox</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="644">box, save</indexterm></cindex>
-<para>Synopsis:
+<para>Synopsis, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\raisebox&lbrace;<var>distance</var>&rbrace;[<var>height</var>][<var>depth</var>]&lbrace;<var>text</var>&rbrace;
+<pre xml:space="preserve">\sbox&lbrace;<var>box-cmd</var>&rbrace;&lbrace;<var>text</var>&rbrace;
+\savebox&lbrace;<var>box-cmd</var>&rbrace;&lbrace;<var>text</var>&rbrace;
+\savebox&lbrace;<var>box-cmd</var>&rbrace;[<var>width</var>]&lbrace;<var>text</var>&rbrace;
+\savebox&lbrace;<var>box-cmd</var>&rbrace;[<var>width</var>][<var>pos</var>]&lbrace;<var>text</var>&rbrace;
</pre></example>
-<para>The <code>\raisebox</code> command raises or lowers <var>text</var>. The first
-mandatory argument specifies how high <var>text</var> is to be raised (or
-lowered if it is a negative amount). <var>text</var> itself is processed
-in LR mode.
+<para>Typeset <var>text</var> just as with <code>\makebox</code> (<pxref label="_005cmbox-_0026-_005cmakebox"><xrefnodename>\mbox &amp;
+\makebox</xrefnodename></pxref>) except that &latex; does not output it but instead saves it
+in a storage bin named <var>box-cmd</var>. The bin name <var>box-cmd</var> begins
+with a backslash, <code>\</code>. You must have previously allocated the bin
+<var>box-cmd</var> with <code>\newsavebox</code> (<pxref label="_005cnewsavebox"><xrefnodename>\newsavebox</xrefnodename></pxref>).The
+<code>\sbox</code> command is robust while <code>\savebox</code> is fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
-<para>The optional arguments <var>height</var> and <var>depth</var> are dimensions. If
-they are specified, &latex; treats <var>text</var> as extending a certain
-distance above the baseline (<var>height</var>) or below (<var>depth</var>),
-ignoring its natural height and depth.
+<para>This creates and uses a bin.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newsavebox&lbrace;\fullname&rbrace;
+\sbox&lbrace;\fullname&rbrace;&lbrace;John Jacob Jingleheimer Schmidt&rbrace;
+ ...
+\usebox&lbrace;\fullname&rbrace;! His name is my name, too!
+Whenever we go out, the people always shout!
+There goes \\usebox&lbrace;\fullname&rbrace;! Ya da da da da da da.
+</pre></example>
-</section>
-<node name="_005csavebox" spaces=" "><nodename>\savebox</nodename><nodenext automatic="on">\sbox</nodenext><nodeprev automatic="on">\raisebox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
-<section spaces=" "><sectiontitle><code>\savebox</code></sectiontitle>
-
-<findex index="fn" spaces=" "><indexterm index="fn" number="859">\savebox</indexterm></findex>
+<noindent></noindent>
+<para>One advantage of using and reusing a bin over a <code>\newcommand</code> is
+efficiency, that &latex; need not repeatedly retypeset the contents.
+See the example below.
+</para>
+<para>The first two command invocations,
+<code>\sbox&lbrace;<var>box-cmd</var>&rbrace;&lbrace;<var>text</var>&rbrace;</code> and
+<code>\savebox&lbrace;<var>box-cmd</var>&rbrace;&lbrace;<var>text</var>&rbrace;</code>, are roughly equivalent.
+As to the third and fourth, the optional arguments allow you to specify
+the box width as <var>width</var>, and the position of the text inside that
+box as <var>position</var>. <xref label="_005cmbox-_0026-_005cmakebox"><xrefnodename>\mbox &amp; \makebox</xrefnodename></xref> for the full
+description.
+</para>
+<para>In the <code>\sbox</code> and <code>\savebox</code> commands the <var>text</var> is
+typeset in LR mode so it does not have line breaks (<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>). If
+you use these then &latex; doesn&textrsquo;t give you an error but it ignores
+what you want: if you enter <code>\sbox&lbrace;\newbin&rbrace;&lbrace;test \\ test&rbrace;</code> and
+<code>\usebox&lbrace;\newbin&rbrace;</code> then you get <samp>testtest</samp>, while if you
+enter <code>\sbox&lbrace;\newbin&rbrace;&lbrace;test \par test&rbrace;</code> and
+<code>\usebox&lbrace;\newbin&rbrace;</code> then you get <samp>test test</samp>, but no error or
+warning. To fix this use a <code>\parbox</code> or <code>minipage</code> as here.
+</para>
+<!-- c credit: egreg https://tex.stackexchange.com/a/41668/121234 -->
+<example endspaces=" ">
+<pre xml:space="preserve">\savebox&lbrace;\abin&rbrace;&lbrace;%
+ \begin&lbrace;minipage&rbrace;&lbrace;\linewidth&rbrace;
+ \begin&lbrace;enumerate&rbrace;
+ \item First item
+ \item Second item
+ \end&lbrace;enumerate&rbrace;
+ \end&lbrace;minipage&rbrace;&rbrace;
+ ...
+\usebox&lbrace;\abin&rbrace;
+</pre></example>
-<para>Synopsis:
+<para>As an example of the efficiency of reusing a bin&textrsquo;s contents, this puts
+the same picture on each page of the document by putting it in the
+header. &latex; only typesets it once.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\savebox&lbrace;<var>\boxcmd</var>&rbrace;[<var>width</var>][<var>pos</var>]&lbrace;<var>text</var>&rbrace;
+<pre xml:space="preserve">\usepackage&lbrace;graphicx&rbrace; % all this in the preamble
+\newsavebox&lbrace;\sealbin&rbrace;
+\savebox&lbrace;\sealbin&rbrace;&lbrace;%
+ \setlength&lbrace;\unitlength&rbrace;&lbrace;1in&rbrace;%
+ \begin&lbrace;picture&rbrace;(0,0)%
+ \put(1.5,-2.5)&lbrace;%
+ \begin&lbrace;tabular&rbrace;&lbrace;c&rbrace;
+ \includegraphics[height=2in]&lbrace;companylogo.png&rbrace; \\
+ Office of the President
+ \end&lbrace;tabular&rbrace;&rbrace;
+ \end&lbrace;picture&rbrace;%
+&rbrace;
+\markright&lbrace;\usebox&lbrace;\sealbin&rbrace;&rbrace;
+\pagestyle&lbrace;headings&rbrace;
</pre></example>
-<para>This command typeset <var>text</var> in a box just as with <code>\makebox</code>
-(<pxref label="_005cmakebox"><xrefnodename>\makebox</xrefnodename></pxref>), except that instead of printing the resulting box,
-it saves it in the box labeled <var>\boxcmd</var>, which must have been
-declared with <code>\newsavebox</code> (<pxref label="_005cnewsavebox"><xrefnodename>\newsavebox</xrefnodename></pxref>).
+<noindent></noindent>
+<para>The <code>picture</code> environment is good for fine-tuning the placement.
+</para>
+<para>If the bin has not already been defined then you get something like
+<samp>Undefined control sequence. &lt;argument&gt; \nobin</samp>.
</para>
</section>
-<node name="_005csbox" spaces=" "><nodename>\sbox</nodename><nodenext automatic="on">\usebox</nodenext><nodeprev automatic="on">\savebox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
-<section spaces=" "><sectiontitle><code>\sbox&lbrace;<var>\boxcmd</var>&rbrace;&lbrace;<var>text</var>&rbrace;</code></sectiontitle>
+<node name="lrbox" spaces=" "><nodename>lrbox</nodename><nodenext automatic="on">\usebox</nodenext><nodeprev automatic="on">\sbox &amp; \savebox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
+<section spaces=" "><sectiontitle><code>lrbox</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="860">\sbox</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="875" mergedindex="cp">lrbox</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\sbox&lbrace;<var>\boxcmd</var>&rbrace;&lbrace;<var>text</var>&rbrace;
+<pre xml:space="preserve">\begin&lbrace;lrbox&rbrace;&lbrace;<var>box-cmd</var>&rbrace;
+ <var>text</var>
+\end&lbrace;lrbox&rbrace;
</pre></example>
-<para><code>\sbox</code> types <var>text</var> in a box just as with <code>\mbox</code>
-(<pxref label="_005cmbox"><xrefnodename>\mbox</xrefnodename></pxref>) except that instead of the resulting box being
-included in the normal output, it is saved in the box labeled
-<var>\boxcmd</var>. <var>\boxcmd</var> must have been previously declared with
-<code>\newsavebox</code> (<pxref label="_005cnewsavebox"><xrefnodename>\newsavebox</xrefnodename></pxref>).
+<para>The <var>text</var> inside the environment is saved in the bin
+<code><var>box-cmd</var></code>. The <var>box-cmd</var> must begin with a
+backslash. You must create this bin in advance with <code>\newsavebox</code>
+(<pxref label="_005cnewsavebox"><xrefnodename>\newsavebox</xrefnodename></pxref>). This is the environment form of the <code>\sbox</code>
+and <code>\savebox</code> commands, and is equivalent to them. <xref label="_005csbox-_0026-_005csavebox"><xrefnodename>\sbox &amp;
+\savebox</xrefnodename></xref> for the full information.
+</para>
+<para>In this example the environment is convenient for entering the
+<code>tabular</code>.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newsavebox&lbrace;\jhbin&rbrace;
+\begin&lbrace;lrbox&rbrace;&lbrace;\jhbin&rbrace;
+ \begin&lbrace;tabular&rbrace;&lbrace;c&rbrace;
+ \includegraphics[height=1in]&lbrace;jh.png&rbrace; \\
+ Jim Hef&lbrace;&rbrace;feron
+ \end&lbrace;tabular&rbrace;
+\end&lbrace;lrbox&rbrace;
+ ...
+\usebox&lbrace;\jhbin&rbrace;
+</pre></example>
+
</section>
-<node name="_005cusebox" spaces=" "><nodename>\usebox</nodename><nodeprev automatic="on">\sbox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
-<section spaces=" "><sectiontitle><code>\usebox&lbrace;<var>\boxcmd</var>&rbrace;</code></sectiontitle>
+<node name="_005cusebox" spaces=" "><nodename>\usebox</nodename><nodeprev automatic="on">lrbox</nodeprev><nodeup automatic="on">Boxes</nodeup></node>
+<section spaces=" "><sectiontitle><code>\usebox</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="861">\usebox</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="876" mergedindex="cp">\usebox</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="645">box, use saved box</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\usebox&lbrace;<var>\boxcmd</var>&rbrace;
+<pre xml:space="preserve">\usebox&lbrace;<var>box-cmd</var>&rbrace;
</pre></example>
-<para><code>\usebox</code> produces the box most recently saved in the bin
-<var>\boxcmd</var> by a <code>\savebox</code> command (<pxref label="_005csavebox"><xrefnodename>\savebox</xrefnodename></pxref>).
+<para>Produce the box most recently saved in the bin <var>box-cmd</var> by the
+commands <code>\sbox</code> or <code>\savebox</code>, or the <code>lrbox</code>
+environment. <xref label="_005csbox-_0026-_005csavebox"><xrefnodename>\sbox &amp; \savebox</xrefnodename></xref> for more information and examples.
+(Note that <var>box-cmd</var> starts with a backslash.) This command is
+robust (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para>
</section>
@@ -10373,7 +14661,7 @@ included in the normal output, it is saved in the box labeled
<node name="Color" spaces=" "><nodename>Color</nodename><nodenext automatic="on">Graphics</nodenext><nodeprev automatic="on">Boxes</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Color</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="451">color</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="646">color</indexterm></cindex>
<para>You can add color to text, rules, etc. You can also have color in a box
or on an entire page and write text on top of it.
@@ -10395,10 +14683,10 @@ significantly extends the capabilities described here, including adding
<node name="Color-package-options" spaces=" "><nodename>Color package options</nodename><nodenext automatic="on">Color models</nodenext><nodeup automatic="on">Color</nodeup></node>
-<section spaces=" "><sectiontitle>Color package options</sectiontitle>
+<section spaces=" "><sectiontitle><code>color</code> package options</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="452">color package options</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="453">options, color package</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="647">color package options</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="648">options, color package</indexterm></cindex>
<para>Synopsis (must be in the document preamble):
</para>
@@ -10448,7 +14736,7 @@ memory space.
<node name="Color-models" spaces=" "><nodename>Color models</nodename><nodenext automatic="on">Commands for color</nodenext><nodeprev automatic="on">Color package options</nodeprev><nodeup automatic="on">Color</nodeup></node>
<section spaces=" "><sectiontitle>Color models</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="454">color models</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="649">color models</indexterm></cindex>
<para>A <dfn>color model</dfn> is a way of representing colors. &latex;&textrsquo;s
capabilities depend on the printer driver. However, the <file>pdftex</file>,
@@ -10464,17 +14752,20 @@ such as with inks, so that combining full intensity of cyan, magenta,
and yellow makes black.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code">cmyk</itemformat></item>
+<beforefirstitem><anchor name="color-models-cmyk">color models cmyk</anchor>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code">cmyk</itemformat></item>
</tableterm><tableitem><para>A comma-separated list with four real numbers between 0 and 1,
inclusive. The first number is the intensity of cyan, the second is
magenta, and the others are yellow and black. A number value of 0 means
minimal intensity, while a 1 is for full intensity. This model is often
used in color printing. It is a subtractive model.
</para>
+<anchor name="color-models-gray">color models gray</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">gray</itemformat></item>
</tableterm><tableitem><para>A single real number between 0 and 1, inclusive. The colors are shades
of grey. The number 0 produces black while 1 gives white.
</para>
+<anchor name="color-models-rgb">color models rgb</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">rgb</itemformat></item>
</tableterm><tableitem><para>A comma-separated list with three real numbers between 0 and 1,
inclusive. The first number is the intensity of the red component, the
@@ -10482,6 +14773,7 @@ second is green, and the third the blue. A number value of 0 means that
none of that component is added in, while a 1 means full intensity.
This is an additive model.
</para>
+<anchor name="color-models-RGB">color models RGB</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">RGB</itemformat></item>
</tableterm><tableitem><para>(<file>pdftex</file>, <file>xetex</file>, <file>luatex</file> drivers) A comma-separated
list with three integers between 0 and 255, inclusive. This model is a
@@ -10490,6 +14782,7 @@ often described in a red-green-blue model using numbers in this range.
The values entered here are converted to the <code>rgb</code> model by
dividing by 255.
</para>
+<anchor name="color-models-named">color models named</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">named</itemformat></item>
</tableterm><tableitem><para>Colors are accessed by name, such as <samp>PrussianBlue</samp>. The list of
names depends on the driver, but all support the names <samp>black</samp>,
@@ -10504,7 +14797,7 @@ names depends on the driver, but all support the names <samp>black</samp>,
<node name="Commands-for-color" spaces=" "><nodename>Commands for color</nodename><nodeprev automatic="on">Color models</nodeprev><nodeup automatic="on">Color</nodeup></node>
<section spaces=" "><sectiontitle>Commands for color</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="455">color package commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="650">color package commands</indexterm></cindex>
<para>These are the commands available with the <file>color</file> package.
</para>
@@ -10519,9 +14812,9 @@ names depends on the driver, but all support the names <samp>black</samp>,
<node name="Define-colors" spaces=" "><nodename>Define colors</nodename><nodenext automatic="on">Colored text</nodenext><nodeup automatic="on">Commands for color</nodeup></node>
<subsection spaces=" "><sectiontitle>Define colors</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="456">color</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="457">define color</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="458">color, define</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="651">color</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="652">define color</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="653">color, define</indexterm></cindex>
<para>Synopsis:
</para>
@@ -10529,9 +14822,15 @@ names depends on the driver, but all support the names <samp>black</samp>,
<pre xml:space="preserve">\definecolor&lbrace;<var>name</var>&rbrace;&lbrace;<var>model</var>&rbrace;&lbrace;<var>specification</var>&rbrace;
</pre></example>
-<para>Give the name <var>name</var> to the color. For example, after
-<code>\definecolor&lbrace;silver&rbrace;&lbrace;rgb&rbrace;&lbrace;0.75,0.75,0.74&rbrace;</code> you can use that
-color name with <code>Hi ho, \textcolor&lbrace;silver&rbrace;&lbrace;Silver&rbrace;!</code>.
+<para>Give the name <var>name</var> to the color. For example, after this
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\definecolor&lbrace;silver&rbrace;&lbrace;rgb&rbrace;&lbrace;0.75,0.75,0.74&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>you can use that color name with <code>Hi ho,
+\textcolor&lbrace;silver&rbrace;&lbrace;Silver&rbrace;!</code>.
</para>
<para>This example gives the color a more abstract name, so it could change and
not be misleading.
@@ -10549,8 +14848,8 @@ or style, rather than in the document body.
<node name="Colored-text" spaces=" "><nodename>Colored text</nodename><nodenext automatic="on">Colored boxes</nodenext><nodeprev automatic="on">Define colors</nodeprev><nodeup automatic="on">Commands for color</nodeup></node>
<subsection spaces=" "><sectiontitle>Colored text</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="459">color</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="460">colored text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="654">color</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="655">colored text</indexterm></cindex>
<para>Synopses:
</para>
@@ -10559,6 +14858,7 @@ or style, rather than in the document body.
\textcolor[<var>color model</var>]&lbrace;<var>color specification</var>&rbrace;&lbrace;...&rbrace;
</pre></example>
+<noindent></noindent>
<para>or
</para>
<example endspaces=" ">
@@ -10569,9 +14869,11 @@ or style, rather than in the document body.
<para>The affected text gets the color. This line
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\textcolor&lbrace;magenta&rbrace;&lbrace;My name is Ozymandias, king of kings:&rbrace; Look on my works, ye Mighty, and despair!
+<pre xml:space="preserve">\textcolor&lbrace;magenta&rbrace;&lbrace;My name is Ozymandias, king of kings:&rbrace;
+Look on my works, ye Mighty, and despair!
</pre></example>
+<noindent></noindent>
<para>causes the first half to be in magenta while the rest is in black. You
can use a color declared with <code>\definecolor</code> in exactly the same
way that we just used the builtin color <samp>magenta</samp>.
@@ -10599,9 +14901,15 @@ including the vertical and horizontal lines.
\end&lbrace;center&rbrace;
</pre></example>
-<para>You can use color in equations. A document might have
-<code>\definecolor&lbrace;highlightcolor&rbrace;&lbrace;RGB&rbrace;&lbrace;225,15,0&rbrace;</code> in the
-preamble, and then contain this equation.
+<para>You can use color in equations. A document might have this definition
+in the preamble
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\definecolor&lbrace;highlightcolor&rbrace;&lbrace;RGB&rbrace;&lbrace;225,15,0&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>and then contain this equation.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;equation&rbrace;
@@ -10614,7 +14922,8 @@ but sometimes you want a one-off. Those are the second forms in the
synopses.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">Colors of \textcolor[rgb]&lbrace;0.33,0.14,0.47&rbrace;&lbrace;Purple&rbrace; and &lbrace;\color[rgb]&lbrace;0.72,0.60,0.37&rbrace; Gold&rbrace; for the team
+<pre xml:space="preserve">Colors of \textcolor[rgb]&lbrace;0.33,0.14,0.47&rbrace;&lbrace;Purple&rbrace; and
+&lbrace;\color[rgb]&lbrace;0.72,0.60,0.37&rbrace; Gold&rbrace; for the team.
</pre></example>
<para>The format of <var>color specification </var> depends on the color model
@@ -10631,6 +14940,7 @@ numbers, <code>gray</code> takes only one.
<pre xml:space="preserve">\textcolor&lbrace;green&rbrace;&lbrace;kind of \textcolor&lbrace;blue&rbrace;&lbrace;blue&rbrace;&rbrace;
</pre></example>
+<noindent></noindent>
<para>has a final word that is blue, not a combination of blue and green.
</para>
<!-- c xx address coloring a line of a table? -->
@@ -10640,22 +14950,23 @@ numbers, <code>gray</code> takes only one.
<node name="Colored-boxes" spaces=" "><nodename>Colored boxes</nodename><nodenext automatic="on">Colored pages</nodenext><nodeprev automatic="on">Colored text</nodeprev><nodeup automatic="on">Commands for color</nodeup></node>
<subsection spaces=" "><sectiontitle>Colored boxes</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="461">color</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="462">colored boxes</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="463">box, colored</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="656">color</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="657">colored boxes</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="658">box, colored</indexterm></cindex>
<para>Synopses:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\colorbox&lbrace;<var>name</var>&rbrace;&lbrace;...&rbrace;
-\colorbox[<var>model name</var>]&lbrace;<var>box background color specification</var>&rbrace;&lbrace;...&rbrace;
+\colorbox[<var>model name</var>]&lbrace;<var>box background color</var>&rbrace;&lbrace;...&rbrace;
</pre></example>
+<noindent></noindent>
<para>or
</para>
<example endspaces=" ">
<pre xml:space="preserve">\fcolorbox&lbrace;<var>frame color</var>&rbrace;&lbrace;<var>box background color</var>&rbrace;&lbrace;...&rbrace;
-\fcolorbox[<var>model name</var>]&lbrace;<var>frame color specification</var>&rbrace;&lbrace;<var>box background color specification</var>&rbrace;&lbrace;...&rbrace;
+\fcolorbox[<var>model name</var>]&lbrace;<var>frame color</var>&rbrace;&lbrace;<var>box background color</var>&rbrace;&lbrace;...&rbrace;
</pre></example>
<para>Make a box with the stated background color. The <code>\fcolorbox</code>
@@ -10665,6 +14976,7 @@ command puts a frame around the box. For instance this
<pre xml:space="preserve">Name:~\colorbox&lbrace;cyan&rbrace;&lbrace;\makebox[5cm][l]&lbrace;\strut&rbrace;&rbrace;
</pre></example>
+<noindent></noindent>
<para>makes a cyan-colored box that is five centimeters long and gets its
depth and height from the <code>\strut</code> (so the depth is
<code>-.3\baselineskip</code> and the height is <code>\baselineskip</code>). This
@@ -10675,7 +14987,7 @@ puts white text on a blue background.
</pre></example>
<para>The <code>\fcolorbox</code> commands use the same parameters as <code>\fbox</code>
-(<pxref label="_005cfbox-and-_005cframebox"><xrefnodename>\fbox and \framebox</xrefnodename></pxref>), <code>\fboxrule</code> and <code>\fboxsep</code>, to
+(<pxref label="_005cfbox-_0026-_005cframebox"><xrefnodename>\fbox &amp; \framebox</xrefnodename></pxref>), <code>\fboxrule</code> and <code>\fboxsep</code>, to
set the thickness of the rule and the boundary between the box interior
and the surrounding rule. &latex;&textrsquo;s defaults are <code>0.4pt</code> and
<code>3pt</code>, respectively.
@@ -10694,10 +15006,10 @@ of the second line.
<node name="Colored-pages" spaces=" "><nodename>Colored pages</nodename><nodeprev automatic="on">Colored boxes</nodeprev><nodeup automatic="on">Commands for color</nodeup></node>
<subsection spaces=" "><sectiontitle>Colored pages</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="464">color</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="465">colored page</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="466">page, colored</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="467">background, colored</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="659">color</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="660">colored page</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="661">page, colored</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="662">background, colored</indexterm></cindex>
<para>Synopses:
</para>
@@ -10728,8 +15040,8 @@ rather than the default transparent background.)
<node name="Graphics" spaces=" "><nodename>Graphics</nodename><nodenext automatic="on">Special insertions</nodenext><nodeprev automatic="on">Color</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Graphics</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="468">graphics</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="469">graphics package</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="663">graphics</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="664">graphics package</indexterm></cindex>
<para>You can use graphics such as PNG or PDF files in your &latex; document.
You need an additional package, which comes standard with &latex;.
@@ -10766,7 +15078,7 @@ external to &latex;, that generate a graphic that you include using the
commands of this chapter. Two that use a programming language are
Asymptote and MetaPost. One that uses a graphical interface is Xfig.
Full description of these systems is outside the scope of this document;
-see their documentation.
+see their documentation on CTAN.
</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">Graphics package options</menunode><menudescription><pre xml:space="preserve">Options when you load the package.
@@ -10776,10 +15088,10 @@ see their documentation.
<node name="Graphics-package-options" spaces=" "><nodename>Graphics package options</nodename><nodenext automatic="on">Graphics package configuration</nodenext><nodeup automatic="on">Graphics</nodeup></node>
-<section spaces=" "><sectiontitle>Graphics package options</sectiontitle>
+<section spaces=" "><sectiontitle><code>graphics</code> package options</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="470">graphics package options</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="471">options, graphics package</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="665">graphics package options</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="666">options, graphics package</indexterm></cindex>
<para>Synopsis (must be in the document preamble):
</para>
@@ -10787,6 +15099,7 @@ see their documentation.
<pre xml:space="preserve">\usepackage[<var>comma-separated option list</var>]&lbrace;graphics&rbrace;
</pre></example>
+<noindent></noindent>
<para>or
</para>
<example endspaces=" ">
@@ -10856,28 +15169,28 @@ option has &latex; to read the size from the latter.
</section>
<node name="Graphics-package-configuration" spaces=" "><nodename>Graphics package configuration</nodename><nodenext automatic="on">Commands for graphics</nodenext><nodeprev automatic="on">Graphics package options</nodeprev><nodeup automatic="on">Graphics</nodeup></node>
-<section spaces=" "><sectiontitle>Graphics package configuration</sectiontitle>
+<section spaces=" "><sectiontitle><code>graphics</code> package configuration</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="472">graphics</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="473">graphics package</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="474">configuration, graphics package</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="475">EPS files</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="476">JPEG files</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="477">JPG files</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="478">PDF graphic files</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="479">PNG files</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="667">graphics</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="668">graphics package</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="669">configuration, graphics package</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="670">EPS files</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="671">JPEG files</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="672">JPG files</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="673">PDF graphic files</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="674">PNG files</indexterm></cindex>
<para>These commands configure the way &latex; searches the file system for
the graphic.
</para>
<para>The behavior of file system search code is necessarily platform
-dependent. In this document we cover Linux, Macintosh, and Windows, as
+dependent. In this document we cover GNU/Linux, Macintosh, and Windows, as
those systems are typically configured. For other situations consult
the documentation in <file>grfguide.pdf</file>, or the &latex; source, or your
&tex; distribution&textrsquo;s documentation.
</para>
<menu endspaces=" ">
-<menuentry leadingtext="* "><menunode separator=":: ">\graphicspath</menunode><menudescription><pre xml:space="preserve">Directories to search.
+<menuentry leadingtext="* "><menunode separator=":: ">\graphicspath</menunode><menudescription><pre xml:space="preserve">Directories to search.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\DeclareGraphicsExtensions</menunode><menudescription><pre xml:space="preserve">File types, such as JPG or EPS.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\DeclareGraphicsRule</menunode><menudescription><pre xml:space="preserve">How to handle file types.
</pre></menudescription></menuentry></menu>
@@ -10886,7 +15199,7 @@ the documentation in <file>grfguide.pdf</file>, or the &latex; source, or your
<node name="_005cgraphicspath" spaces=" "><nodename>\graphicspath</nodename><nodenext automatic="on">\DeclareGraphicsExtensions</nodenext><nodeup automatic="on">Graphics package configuration</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\graphicspath</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="862">\graphicspath</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="877" mergedindex="cp">\graphicspath</indexterm></findex>
<para>Synopsis:
</para>
@@ -10933,6 +15246,7 @@ current directory,
\usepackage&lbrace;lion.png&rbrace;
</pre></example>
+<noindent></noindent>
<para>for each of the listed directories, &latex; concatenates it with the
file name and searches for the result, checking for <file>pix/lion.png</file>
and then <file>../pix/lion.png</file>. This algorithm means that the
@@ -10946,9 +15260,9 @@ these means that the document is not portable. (You could preserve
portability by adjusting your &tex; system settings configuration file
parameter <code>TEXINPUTS</code>; see the documentation of your system.)
</para>
-<para>You can use <code>\graphicspath</code> in the preamble or in the document
-body. You can use it more than once. For debugging, show its value
-with <code>\makeatletter\typeout&lbrace;\Ginput&arobase;path&rbrace;\makeatother</code>.
+<para>You can use <code>\graphicspath</code> anywhere in the document. You can use
+it more than once. Show its value with
+<code>\makeatletter\typeout&lbrace;\Ginput&arobase;path&rbrace;\makeatother</code>.
</para>
<para>The directories are taken with respect to the base file. That is,
suppose that you are working on a document based on <file>book/book.tex</file>
@@ -10962,7 +15276,7 @@ instead in <file>book/plots</file>.
<node name="_005cDeclareGraphicsExtensions" spaces=" "><nodename>\DeclareGraphicsExtensions</nodename><nodenext automatic="on">\DeclareGraphicsRule</nodenext><nodeprev automatic="on">\graphicspath</nodeprev><nodeup automatic="on">Graphics package configuration</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\DeclareGraphicsExtensions</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="863">\DeclareGraphicsExtensions</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="878" mergedindex="cp">\DeclareGraphicsExtensions</indexterm></findex>
<para>Synopses:
</para>
@@ -10984,6 +15298,7 @@ files.
\includegraphics&lbrace;lion&rbrace; % will find <file>lion.png</file> before <file>lion.pdf</file>
</pre></example>
+<noindent></noindent>
<para>Because the file name <file>lion</file> does not have a period, &latex; uses
the extension list. For each directory in the graphics path
(<pxref label="_005cgraphicspath"><xrefnodename>\graphicspath</xrefnodename></pxref>), &latex; will try the extensions in the order
@@ -10992,17 +15307,20 @@ and extensions then it reports <samp>! LaTeX Error: File `<file>lion</file>'
not found</samp>. Note that you must include the periods at the start of the
extensions.
</para>
-<para>Because Linux and Macintosh filenames are case sensitive, the list of
+<para>Because GNU/Linux and Macintosh filenames are case sensitive, the list of
file extensions is case sensitive on those platforms. The Windows
platform is not case sensitive.
</para>
<para>You are not required to include <code>\DeclareGraphicsExtensions</code> in
your document; the printer driver has a sensible default. For example,
-the most recent <file>pdftex.def</file> has the extension list
-<samp><code>.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2</code></samp>.
+the most recent <file>pdftex.def</file> has this extension list.
</para>
-<para>You can use this command in the preamble or in the document body. You
-can use it more than once. For debugging, show its value with
+<example endspaces=" ">
+<pre xml:space="preserve">.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2
+</pre></example>
+
+<para>You can use this command anywhere in the document. You can use it more
+than once. Show its value with
<code>\makeatletter\typeout&lbrace;\Gin&arobase;extensions&rbrace;\makeatother</code>.
</para>
@@ -11010,7 +15328,7 @@ can use it more than once. For debugging, show its value with
<node name="_005cDeclareGraphicsRule" spaces=" "><nodename>\DeclareGraphicsRule</nodename><nodeprev automatic="on">\DeclareGraphicsExtensions</nodeprev><nodeup automatic="on">Graphics package configuration</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\DeclareGraphicsRule</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="864">\DeclareGraphicsRule</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="879" mergedindex="cp">\DeclareGraphicsRule</indexterm></findex>
<para>Synopsis:
</para>
@@ -11035,6 +15353,7 @@ input the file.
<pre xml:space="preserve">\DeclareGraphicsRule&lbrace;*&rbrace;&lbrace;mps&rbrace;&lbrace;*&rbrace;&lbrace;&rbrace;
</pre></example>
+<noindent></noindent>
<para>tells &latex; that it should handle as MetaPost output any file with an
extension not covered by another rule, so it covers <file>filename.1</file>,
<file>filename.2</file>, etc.
@@ -11095,8 +15414,8 @@ See the documentation for your &tex; distribution.
<node name="Commands-for-graphics" spaces=" "><nodename>Commands for graphics</nodename><nodeprev automatic="on">Graphics package configuration</nodeprev><nodeup automatic="on">Graphics</nodeup></node>
<section spaces=" "><sectiontitle>Commands for graphics</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="480">graphics package commands</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="481">commands, graphics package</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="675">graphics package commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="676">commands, graphics package</indexterm></cindex>
<para>These are the commands available with the <file>graphics</file> and
<file>graphicx</file> packages.
@@ -11112,16 +15431,16 @@ See the documentation for your &tex; distribution.
<node name="_005cincludegraphics" spaces=" "><nodename>\includegraphics</nodename><nodenext automatic="on">\rotatebox</nodenext><nodeup automatic="on">Commands for graphics</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\includegraphics</code></sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="482">graphics</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="483">graphics package</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="484">including graphics</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="485">importing graphics</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="486">EPS files</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="487">JPEG files</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="488">JPG files</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="489">PDF graphic files</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="490">PNG files</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="865">\includegraphics</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="677">graphics</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="678">graphics package</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="679">including graphics</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="680">importing graphics</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="681">EPS files</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="682">JPEG files</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="683">JPG files</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="684">PDF graphic files</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="685">PNG files</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="880" mergedindex="cp">\includegraphics</indexterm></findex>
<para>Synopses for <file>graphics</file> package:
</para>
@@ -11158,13 +15477,14 @@ over-print the surrounding area.
\end&lbrace;center&rbrace;
</pre></example>
+<noindent></noindent>
<para>will incorporate into the document the graphic in <file>plot.pdf</file>,
centered and at its nominal size. You can also give a path to the file,
as with <code>\includegraphics&lbrace;graphics/plot.pdf&rbrace;</code>. To specify a list
of locations to search for the file, <pxref label="_005cgraphicspath"><xrefnodename>\graphicspath</xrefnodename></pxref>.
</para>
-<para>If your filename includes spaces then put it in double quotes, as with
-<code>\includegraphics&lbrace;&quot;sister picture.jpg&quot;&rbrace;</code>.
+<para>If your filename includes spaces then put it in double quotes. An example
+is <code>\includegraphics&lbrace;&quot;sister picture.jpg&quot;&rbrace;</code>.
</para>
<para>The <code>\includegraphics&lbrace;<var>filename</var>&rbrace;</code> command decides on the
type of graphic by splitting <var>filename</var> on the first dot. You can
@@ -11202,7 +15522,7 @@ caption.
...
\begin&lbrace;center&rbrace;
\includegraphics&lbrace;pix/nix.png&rbrace;
- \captionof&lbrace;figure&rbrace;&lbrace;The spirit of the night&rbrace; \label&lbrace;pix:nix&rbrace; % if you want a caption
+ \captionof&lbrace;figure&rbrace;&lbrace;The spirit of the night&rbrace; \label&lbrace;pix:nix&rbrace; % optional
\end&lbrace;center&rbrace;
</pre></example>
@@ -11210,8 +15530,7 @@ caption.
text, with the two vertically centered.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\newcommand*&lbrace;\vcenteredhbox&rbrace;[1]&lbrace;\begingroup
- \setbox0=\hbox&lbrace;#1&rbrace;\parbox&lbrace;\wd0&rbrace;&lbrace;\box0&rbrace;\endgroup&rbrace;
+<pre xml:space="preserve">\newcommand*&lbrace;\vcenteredhbox&rbrace;[1]&lbrace;\begin&lbrace;tabular&rbrace;&lbrace;&arobase;&lbrace;&rbrace;c&arobase;&lbrace;&rbrace;&rbrace;#1\end&lbrace;tabular&rbrace;&rbrace;
...
\begin&lbrace;center&rbrace;
\vcenteredhbox&lbrace;\includegraphics[width=0.4\textwidth]&lbrace;plot&rbrace;&rbrace;
@@ -11248,6 +15567,7 @@ in a key-value form, as here.
\end&lbrace;center&rbrace;
</pre></example>
+<noindent></noindent>
<para>The options are read left-to-right. So the first graphic above is made
one inch wide and then rotated, while the second is rotated and then
made one inch wide. Thus, unless the graphic is perfectly square, the
@@ -11263,7 +15583,8 @@ page it puts together boxes and this is the box allocated for the
graphic.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code">width</itemformat></item>
+<beforefirstitem><anchor name="includegraphics-width">includegraphics width</anchor>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code">width</itemformat></item>
</tableterm><tableitem><para>The graphic will be shown so its bounding box is this width. An example
is <code>\includegraphics[width=1in]&lbrace;plot&rbrace;</code>. You can use the standard
&tex; dimensions (<pxref label="Units-of-length"><xrefnodename>Units of length</xrefnodename></pxref>) and also convenient is
@@ -11274,37 +15595,44 @@ the width of the text with
<code>\includegraphics[width=\linewidth-1.0cm]&lbrace;hefferon.jpg&rbrace;</code>.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">height</itemformat></item>
-</tableterm><tableitem><para>The graphic will be shown so its bounding box is this height. You can
+</tableterm><tableitem><anchor name="includegraphics-height">includegraphics height</anchor>
+<para>The graphic will be shown so its bounding box is this height. You can
use the standard &tex; dimensions (<pxref label="Units-of-length"><xrefnodename>Units of length</xrefnodename></pxref>), and also
convenient are <code>\pageheight</code> and <code>\textheight</code> (<pxref label="Page-layout-parameters"><xrefnodename>Page
-layout parameters</xrefnodename></pxref>). For instance,
+layout parameters</xrefnodename></pxref>). For instance, the command
<code>\includegraphics[height=0.25\textheight]&lbrace;godel&rbrace;</code> will make the
-graphic be a quarter of the height of the text area.
+graphic a quarter of the height of the text area.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">totalheight</itemformat></item>
-</tableterm><tableitem><para>The graphic will be shown so its bounding box has this height plus
+</tableterm><tableitem><anchor name="includegraphics-totalheght">includegraphics totalheght</anchor>
+<para>The graphic will be shown so its bounding box has this height plus
depth. This differs from the height if the graphic was rotated. For
instance, if it has been rotated by -90 then it will have zero height
but a large depth.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">keepaspectratio</itemformat></item>
-</tableterm><tableitem><para>If set to <code>true</code>, or just specified as with
-<code>\includegraphics[...,keepaspectratio,...]&lbrace;...&rbrace;</code> and you give as
-options both <code>width</code> and <code>height</code> (or <code>totalheight</code>),
-then &latex; will make the graphic is as large as possible without
-distortion. That is, &latex; will ensure that neither is the graphic
-wider than <code>width</code> nor taller than <code>height</code> (or
+</tableterm><tableitem><anchor name="includegraphics-keepaspectratio">includegraphics keepaspectratio</anchor>
+<para>If set to <code>true</code>, or just specified as here
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve"><code>\includegraphics[...,keepaspectratio,...]&lbrace;...&rbrace;</code>
+</pre></example>
+
+<noindent></noindent>
+<para>and you give as options both <code>width</code> and <code>height</code> (or
+<code>totalheight</code>), then &latex; will make the graphic is as large as
+possible without distortion. That is, &latex; will ensure that neither
+is the graphic wider than <code>width</code> nor taller than <code>height</code> (or
<code>totalheight</code>).
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">scale</itemformat></item>
-</tableterm><tableitem><para>Factor by which to scale the graphic. Specifying
-<code>\includegraphics[scale=2.0]&lbrace;...&rbrace;</code> makes the graphic twice its
-nominal size. This number may be any value; a number between 1
-and&nbsp;0 will shrink the graphic and a negative number will reflect
-it.
+</tableterm><tableitem><para>Factor by which to scale the graphic. To make a graphic twice its
+nominal size, enter <code>\includegraphics[scale=2.0]&lbrace;...&rbrace;</code>. This
+number may be any value; a number between 1 and&nbsp;0 will shrink the
+graphic and a negative number will reflect it.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">angle</itemformat></item>
-</tableterm><tableitem><para>Rotate the picture. The angle is taken in degrees and counterclockwise.
+</tableterm><tableitem><para>Rotate the graphic. The angle is taken in degrees and counterclockwise.
The graphic is rotated about its <code>origin</code>; see that option. For a
complete description of how rotated material is typeset,
<pxref label="_005crotatebox"><xrefnodename>\rotatebox</xrefnodename></pxref>.
@@ -11313,9 +15641,9 @@ complete description of how rotated material is typeset,
</tableterm><tableitem><para>The point of the graphic about which the rotation happens. Possible
values are any string containing one or two of: <code>l</code> for left,
<code>r</code> for right, <code>b</code> for bottom, <code>c</code> for center, <code>t</code>
-for top, and <code>B</code> for baseline. Thus,
+for top, and <code>B</code> for baseline. Thus, entering the command
<code>\includegraphics[angle=180,origin=c]&lbrace;moon&rbrace;</code> will turn the
-picture upside down from the center, while
+picture upside down about that picture&textrsquo;s center, while the command
<code>\includegraphics[angle=180,origin=lB]&lbrace;LeBateau&rbrace;</code> will turn its
picture upside down about its left baseline. (The character <code>c</code>
gives the horizontal center in <code>bc</code> or <code>tc</code>, but gives the
@@ -11328,7 +15656,8 @@ vertical center in <code>lc</code> or <code>rc</code>.) The default is <code>lB
<para>These are lesser-used options.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code">viewport</itemformat></item>
+<beforefirstitem><anchor name="includegraphics-viewport">includegraphics viewport</anchor>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code">viewport</itemformat></item>
</tableterm><tableitem><para>Pick out a subregion of the graphic to show. Takes four arguments,
separated by spaces and given in &tex; dimensions, as with
<code>\includegraphics[.., viewport=0in 0in 1in 0.618in]&lbrace;...&rbrace;</code>. The
@@ -11336,6 +15665,7 @@ dimensions default to big points,&nbsp;<code>bp</code>. They are taken
relative to the origin specified by the bounding box. See also the
<code>trim</code> option.
</para>
+<anchor name="includegraphics-trim">includegraphics trim</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">trim</itemformat></item>
</tableterm><tableitem><para>Gives parts of the graphic to not show. Takes four arguments, separated
by spaces, that are given in &tex; dimensions, as with
@@ -11345,17 +15675,25 @@ will crop the picture by 0&nbsp;inches on the left, 0.1&nbsp;inches on
the bottom, 0.2&nbsp;inches on the right, and 0.3&nbsp;inches on the
top. See also the <code>viewport</code> option.
</para>
+<anchor name="includegraphics-clip">includegraphics clip</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">clip</itemformat></item>
-</tableterm><tableitem><para>If set to <code>true</code>, or just specified as with
-<code>\includegraphics[...,clip,...]&lbrace;...&rbrace;</code>, then the graphic is
-cropped to the bounding box. You can get this effect by instead using
-the starred form of the command, as
+</tableterm><tableitem><para>If set to <code>true</code>, or just specified as here
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\includegraphics[...,clip,...]&lbrace;...&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>then the graphic is cropped to the bounding box. This is the same as
+using the starred form of the command,
<code>\includegraphics*[...]&lbrace;...&rbrace;</code>.
</para>
+<anchor name="includegraphics-page">includegraphics page</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">page</itemformat></item>
</tableterm><tableitem><para>Give the page number of a multi-page PDF file. The default is
<code>page=1</code>.
</para>
+<anchor name="includegraphics-pagebox">includegraphics pagebox</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">pagebox</itemformat></item>
</tableterm><tableitem><para>Specifies which bounding box to use for PDF files from among
<code>mediabox</code>, <code>cropbox</code>, <code>bleedbox</code>, <code>trimbox</code>, or
@@ -11370,22 +15708,33 @@ content. The driver will set the image size based on CropBox if
present, otherwise it will not use one of the others, with a
driver-defined order of preference. MediaBox is always present.
</para>
+<anchor name="includegraphics-interpolate">includegraphics interpolate</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">interpolate</itemformat></item>
</tableterm><tableitem><para>Enable or disable interpolation of raster images by the viewer. Can be
-set with <code>interpolate=true</code> or just specified as with
-<code>\includegraphics[...,interpolate,...]&lbrace;...&rbrace;</code>.
+set with <code>interpolate=true</code> or just specified as here.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\includegraphics[...,interpolate,...]&lbrace;...&rbrace;
+</pre></example>
+
+<anchor name="includegraphics-quiet">includegraphics quiet</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">quiet</itemformat></item>
</tableterm><tableitem><para>Do not write information to the log. You can set it with
<code>quiet=true</code> or just specified it with
<code>\includegraphics[...,quite,...]&lbrace;...&rbrace;</code>,
</para>
+<anchor name="includegraphics-draft">includegraphics draft</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">draft</itemformat></item>
-</tableterm><tableitem><para>If you set it with <code>draft=true</code> or just specified it with
-<code>\includegraphics[...,draft,...]&lbrace;...&rbrace;</code>, then the graphic will not
-appear in the document, possibly saving color printer ink. Instead,
-&latex; will put an empty box of the correct size with the filename
-printed in it.
+</tableterm><tableitem><para>If you set it with <code>draft=true</code> or just specify it with
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\includegraphics[...,draft,...]&lbrace;...&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>then the graphic will not appear in the document, possibly saving color
+printer ink. Instead, &latex; will put an empty box of the correct
+size with the filename printed in it.
</para>
</tableitem></tableentry></table>
@@ -11400,7 +15749,8 @@ For example, if an <file>.eps</file> file has the line <code>%%BoundingBox 10
60/72&nbsp;inch tall.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code">bb</itemformat></item>
+<beforefirstitem><anchor name="includegraphics-bb">includegraphics bb</anchor>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code">bb</itemformat></item>
</tableterm><tableitem><para>Specify the bounding box of the displayed region. The argument is four
dimensions separated by spaces, as with <code>\includegraphics[.., bb=
0in 0in 1in 0.618in]&lbrace;...&rbrace;</code>. Usually <code>\includegraphics</code> reads the
@@ -11408,23 +15758,40 @@ BoundingBox numbers from the EPS file automatically, so this option is
only useful if the bounding box is missing from that file or if you want
to change it.
</para>
+<anchor name="includegraphics-bbllx">includegraphics bbllx</anchor>
+<anchor name="includegraphics-bblly">includegraphics bblly</anchor>
+<anchor name="includegraphics-bburx">includegraphics bburx</anchor>
+<anchor name="includegraphics-bbury">includegraphics bbury</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">bbllx, bblly, bburx, bbury</itemformat></item>
</tableterm><tableitem><para>Set the bounding box. These four are obsolete, but are retained for
compatibility with old packages.
</para>
+<anchor name="includegraphics-natwidth">includegraphics natwidth</anchor>
+<anchor name="includegraphics-natheight">includegraphics natheight</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">natwidth, natheight</itemformat></item>
</tableterm><tableitem><para>An alternative for <code>bb</code>. Setting
-<code>\includegraphics[...,natwidth=1in,natheight=0.618in,...]&lbrace;...&rbrace;</code>
-is the same as setting <code>bb=0 0 1in 0.618in</code>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\includegraphics[...,natwidth=1in,natheight=0.618in,...]&lbrace;...&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>is the same as setting <code>bb=0 0 1in 0.618in</code>.
</para>
+<anchor name="includegraphics-hiresbb">includegraphics hiresbb</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">hiresbb</itemformat></item>
</tableterm><tableitem><para>If set to <code>true</code>, or just specified as with
-<code>\includegraphics[...,hiresbb,...]&lbrace;...&rbrace;</code>, then &latex; will look
-for <code>%%HiResBoundingBox</code> lines instead of <code>%%BoundingBox</code>
-lines. (The <code>BoundingBox</code> lines use only natural numbers while the
-<code>HiResBoundingBox</code> lines use decimals; both use units equivalent to
-&tex;&textrsquo;s big points, 1/72&nbsp;inch.) To override a prior setting of
-<code>true</code>, you can set it to <code>false</code>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\includegraphics[...,hiresbb,...]&lbrace;...&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>then &latex; will look for <code>%%HiResBoundingBox</code> lines instead of
+<code>%%BoundingBox</code> lines. (The <code>BoundingBox</code> lines use only
+natural numbers while the <code>HiResBoundingBox</code> lines use decimals;
+both use units equivalent to &tex;&textrsquo;s big points, 1/72&nbsp;inch.) To
+override a prior setting of <code>true</code>, you can set it to <code>false</code>.
</para>
</tableitem></tableentry></table>
@@ -11435,21 +15802,26 @@ will read the file <file>lion.xxx</file> as though it were
<file>lion.png</file>. For more on these, <pxref label="_005cDeclareGraphicsRule"><xrefnodename>\DeclareGraphicsRule</xrefnodename></pxref>.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code">type</itemformat></item>
+<beforefirstitem><anchor name="includegraphics-type">includegraphics type</anchor>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code">type</itemformat></item>
</tableterm><tableitem><para>Specify the graphics type.
</para>
+<anchor name="includegraphics-ext">includegraphics ext</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">ext</itemformat></item>
</tableterm><tableitem><para>Specify the graphics extension.
Only use this in conjunction with the option <code>type</code>.
</para>
+<anchor name="includegraphics-read">includegraphics read</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">read</itemformat></item>
</tableterm><tableitem><para>Specify the file extension of the read file.
Only use this in conjunction with the option <code>type</code>.
</para>
+<anchor name="includegraphics-command">includegraphics command</anchor>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">command</itemformat></item>
-</tableterm><tableitem><para>Specify a command to be applied to this file.
-Only use this in conjunction with the option <code>type</code>.
-<!-- c write18 and restricted execution. -->
+</tableterm><tableitem><para>Specify a command to be applied to this file. Only use this in
+conjunction with the option <code>type</code>. <xref label="Command-line-options"><xrefnodename>Command line options</xrefnodename></xref>
+for a discussion of enabling the <code>\write18</code> functionality to run
+external commands.
</para>
</tableitem></tableentry></table>
@@ -11458,10 +15830,10 @@ Only use this in conjunction with the option <code>type</code>.
<node name="_005crotatebox" spaces=" "><nodename>\rotatebox</nodename><nodenext automatic="on">\scalebox</nodenext><nodeprev automatic="on">\includegraphics</nodeprev><nodeup automatic="on">Commands for graphics</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\rotatebox</code></sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="491">rotation</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="492">rotating graphics</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="493">rotating text</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="866">\rotatebox</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="686">rotation</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="687">rotating graphics</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="688">rotating text</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="881" mergedindex="cp">\rotatebox</indexterm></findex>
<para>Synopsis for <file>graphics</file> package:
</para>
@@ -11476,7 +15848,8 @@ Only use this in conjunction with the option <code>type</code>.
\rotatebox[<var>key-value list</var>]&lbrace;<var>angle</var>&rbrace;&lbrace;<var>material</var>&rbrace;
</pre></example>
-<para>Put <var>material</var> in a box and rotate it <var>angle</var> degrees counterclockwise.
+<para>Put <var>material</var> in a box and rotate it <var>angle</var> degrees
+counterclockwise.
</para>
<para>This example rotates the table column heads forty five degrees.
</para>
@@ -11513,15 +15886,21 @@ except for the <code>x</code> and <code>y</code> options (<pxref label="_005cinc
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">origin</itemformat></item>
</tableterm><tableitem><para>The point of the <var>material</var>&textrsquo;s box about which the rotation happens.
-Possible values are any string containing one or two of: <code>l</code> for
+Possible value is any string containing one or two of: <code>l</code> for
left, <code>r</code> for right, <code>b</code> for bottom, <code>c</code> for center,
-<code>t</code> for top, and <code>B</code> for baseline. Thus,
-<code>\includegraphics[angle=180,origin=c]&lbrace;moon&rbrace;</code> will turn the
-picture upside down from the center, while
-<code>\includegraphics[angle=180,origin=lB]&lbrace;LeBateau&rbrace;</code> will turn its
-picture upside down about its left baseline. (The character <code>c</code>
-gives the horizontal center in <code>bc</code> or <code>tc</code> but gives the
-vertical center in <code>lc</code> or <code>rc</code>.) The default is <code>lB</code>.
+<code>t</code> for top, and <code>B</code> for baseline. Thus, the first line here
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\includegraphics[angle=180,origin=c]&lbrace;moon&rbrace;
+\includegraphics[angle=180,origin=lB]&lbrace;LeBateau&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>will turn the picture upside down from the center while the second will
+turn its picture upside down about its left baseline. (The character
+<code>c</code> gives the horizontal center in <code>bc</code> or <code>tc</code> but gives
+the vertical center in <code>lc</code> or <code>rc</code>.) The default is
+<code>lB</code>.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">x, y</itemformat></item>
</tableterm><tableitem><para>Specify an arbitrary point of rotation with
@@ -11541,14 +15920,14 @@ setting <code>units=6.283185</code> changes to radians counterclockwise.
<node name="_005cscalebox" spaces=" "><nodename>\scalebox</nodename><nodenext automatic="on">\resizebox</nodenext><nodeprev automatic="on">\rotatebox</nodeprev><nodeup automatic="on">Commands for graphics</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\scalebox</code></sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="494">graphics, scaling</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="495">graphics, resizing</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="496">scaling</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="497">resizing</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="498">text, scaling</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="499">text, resizing</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="867">\scalebox</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="868">\reflectbox</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="689">graphics, scaling</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="690">graphics, resizing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="691">scaling</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="692">resizing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="693">text, scaling</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="694">text, resizing</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="882" mergedindex="cp">\scalebox</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="883" mergedindex="cp">\reflectbox</indexterm></findex>
<para>Synopses:
</para>
@@ -11570,10 +15949,15 @@ first text and doubles the size of the second.
<para>If you do not specify the optional <var>vertical factor</var> then it
defaults to the same value as the <var>horizontal factor</var>.
</para>
-<para>You can use this command to resize a graphic, as with
-<code>\scalebox&lbrace;0.5&rbrace;&lbrace;\includegraphics&lbrace;lion&rbrace;&rbrace;</code>. If you use the
-<file>graphicx</file> package then you can accomplish the same thing with
-optional arguments to <code>\includegraphics</code>
+<para>You can use this command to resize a graphic, as here.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\scalebox&lbrace;0.5&rbrace;&lbrace;\includegraphics&lbrace;lion&rbrace;&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>If you use the <file>graphicx</file> package then you can accomplish the same
+thing with optional arguments to <code>\includegraphics</code>
(<pxref label="_005cincludegraphics"><xrefnodename>\includegraphics</xrefnodename></pxref>).
</para>
<para>The <code>\reflectbox</code> command abbreviates
@@ -11586,13 +15970,13 @@ immediately followed by its mirror reflection.
<node name="_005cresizebox" spaces=" "><nodename>\resizebox</nodename><nodeprev automatic="on">\scalebox</nodeprev><nodeup automatic="on">Commands for graphics</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\resizebox</code></sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="500">graphics, scaling</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="501">graphics, resizing</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="502">scaling</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="503">resizing</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="504">text, scaling</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="505">text, resizing</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="869">\resizebox</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="695">graphics, scaling</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="696">graphics, resizing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="697">scaling</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="698">resizing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="699">text, scaling</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="700">text, resizing</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="884" mergedindex="cp">\resizebox</indexterm></findex>
<para>Synopses:
</para>
@@ -11631,8 +16015,8 @@ text two inches wide but keep the original height with
<node name="Special-insertions" spaces=" "><nodename>Special insertions</nodename><nodenext automatic="on">Splitting the input</nodenext><nodeprev automatic="on">Graphics</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Special insertions</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="506">special insertions</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="507">insertions of special characters</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="701">special insertions</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="702">insertions of special characters</indexterm></cindex>
<para>&latex; provides commands for inserting characters that have a
special meaning do not correspond to simple characters you can type.
@@ -11643,7 +16027,7 @@ special meaning do not correspond to simple characters you can type.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Symbols by font position</menunode><menudescription><pre xml:space="preserve">Inserting font symbols by number.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Text symbols</menunode><menudescription><pre xml:space="preserve">Inserting other non-letter symbols in text.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Accents</menunode><menudescription><pre xml:space="preserve">Inserting accents.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Additional Latin letters</menunode><menudescription><pre xml:space="preserve">Inserting other non-English characters.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Additional Latin letters</menunode><menudescription><pre xml:space="preserve">Inserting other non-English characters.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\rule</menunode><menudescription><pre xml:space="preserve">Inserting lines and rectangles.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\today</menunode><menudescription><pre xml:space="preserve">Inserting today&textrsquo;s date.
</pre></menudescription></menuentry></menu>
@@ -11652,41 +16036,42 @@ special meaning do not correspond to simple characters you can type.
<node name="Reserved-characters" spaces=" "><nodename>Reserved characters</nodename><nodenext automatic="on">Upper and lower case</nodenext><nodeup automatic="on">Special insertions</nodeup></node>
<section spaces=" "><sectiontitle>Reserved characters</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="508">reserved characters</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="509">characters, reserved</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="510">special characters</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="511">characters, special</indexterm></cindex>
-<para>&latex; sets aside the following characters for special purposes (for
-example, the percent sign&nbsp;<code>%</code> is for comments) so they are
+<cindex index="cp" spaces=" "><indexterm index="cp" number="703">reserved characters</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="704">characters, reserved</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="705">special characters</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="706">characters, special</indexterm></cindex>
+<para>&latex; sets aside the following characters for special purposes. For
+example, the percent sign&nbsp;<code>%</code> is for comments. They are
called <dfn>reserved characters</dfn> or <dfn>special characters</dfn>.
</para>
<example endspaces=" ">
<pre xml:space="preserve"># $ % &amp; &lbrace; &rbrace; _ ~ ^ \
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="870">\#</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="871">\$</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="872">\%</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="873">\&amp;</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="874">\_</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="875">\&lbrace;</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="876">\&rbrace;</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="885" mergedindex="cp">\#</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="886" mergedindex="cp">\$</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="887" mergedindex="cp">\%</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="888" mergedindex="cp">\&amp;</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="889" mergedindex="cp">\_</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="890" mergedindex="cp">\&lbrace;</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="891" mergedindex="cp">\&rbrace;</indexterm></findex>
<para>If you want a reserved character to be printed as itself, in the text
body font, for all but the final three characters in that list simply
put a backslash&nbsp;<code>\</code> in front of the character. Thus,
-<code>\$1.23</code> will produce&nbsp;<code>$1.23</code> in your output.
+typing <code>\$1.23</code> will produce&nbsp;<code>$1.23</code> in your output.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="877">\~</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="878">\^</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="879">\textbackslash</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="892" mergedindex="cp">\~</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="893" mergedindex="cp">\^</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="894" mergedindex="cp">\textbackslash</indexterm></findex>
<para>As to the last three characters, to get a tilde in the text body font
use <code>\~&lbrace;&rbrace;</code> (omitting the curly braces would result in the next
character receiving a tilde accent). Similarly, to get a get a text
-body font circumflex use <code>\^&lbrace;&rbrace;</code>. A text body font backslash
-results from <code>\textbackslash&lbrace;&rbrace;</code>.
+body font circumflex use <code>\^&lbrace;&rbrace;</code>. To get a backslash in the font
+of the text body, enter <code>\textbackslash&lbrace;&rbrace;</code>.
</para>
<para>To produce the reserved characters in a typewriter font use
-<code>\verb!!</code>, as below.
+<code>\verb!!</code> as below (the double backslash&nbsp;<code>\\</code> is only
+there to split the lines).
</para>
<example endspaces=" ">
<pre xml:space="preserve">\begin&lbrace;center&rbrace;
@@ -11695,17 +16080,14 @@ results from <code>\textbackslash&lbrace;&rbrace;</code>.
\end&lbrace;center&rbrace;
</pre></example>
-<para>In that example the double backslash&nbsp;<code>\\</code> is only there to
-split the lines.
-</para>
</section>
<node name="Upper-and-lower-case" spaces=" "><nodename>Upper and lower case</nodename><nodenext automatic="on">Symbols by font position</nodenext><nodeprev automatic="on">Reserved characters</nodeprev><nodeup automatic="on">Special insertions</nodeup></node>
<section spaces=" "><sectiontitle>Upper and lower case</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="512">Upper case</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="513">Lower case</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="514">characters, case</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="707">uppercase</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="708">lowercase</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="709">characters, case of</indexterm></cindex>
<para>Synopsis:
</para>
@@ -11748,15 +16130,15 @@ you need to do expansion. Here the <code>\Schoolname</code> produces
<w> </w>\expandafter&lbrace;\schoolname&rbrace;&rbrace;
</pre></example>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="515"><r>package</r>, <code>textcase</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="516"><code>textcase</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="710"><r>package</r>, <code>textcase</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="711"><code>textcase</code> <r>package</r></indexterm></cindex>
<para>The <file>textcase</file> package brings some of the missing feature of the
standard &latex; commands <code>\MakeUppercase</code> and
<code>\MakeLowerCase</code>.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="517"><r>package</r>, <code>mfirstuc</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="518"><code>mfirstuc</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="712"><r>package</r>, <code>mfirstuc</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="713"><code>mfirstuc</code> <r>package</r></indexterm></cindex>
<para>To uppercase only the first letter of words, you can use the package
<file>mfirstuc</file>.
@@ -11766,9 +16148,9 @@ standard &latex; commands <code>\MakeUppercase</code> and
<node name="Symbols-by-font-position" spaces=" "><nodename>Symbols by font position</nodename><nodenext automatic="on">Text symbols</nodenext><nodeprev automatic="on">Upper and lower case</nodeprev><nodeup automatic="on">Special insertions</nodeup></node>
<section spaces=" "><sectiontitle>Symbols by font position</sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="880">\symbol</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="519">accessing any character of a font</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="520">font symbols, by number</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="895" mergedindex="cp">\symbol</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="714">accessing any character of a font</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="715">font symbols, by number</indexterm></cindex>
<para>You can access any character of the current font using its number with
the <code>\symbol</code> command. For example, the visible space character
@@ -11785,288 +16167,300 @@ example could also be written as <code>\symbol&lbrace;'40&rbrace;</code> or
<node name="Text-symbols" spaces=" "><nodename>Text symbols</nodename><nodenext automatic="on">Accents</nodenext><nodeprev automatic="on">Symbols by font position</nodeprev><nodeup automatic="on">Special insertions</nodeup></node>
<section spaces=" "><sectiontitle>Text symbols</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="521">text symbols</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="522">symbols, text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="716">text symbols</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="717">symbols, text</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="881">textcomp <r>package</r></indexterm></findex>
-<para>&latex; provides commands to generate a number of non-letter symbols
-in running text. Some of these, especially the more obscure ones, are
-not available in OT1; you may need to load the <code>textcomp</code> package.
+<findex index="fn" spaces=" "><indexterm index="fn" number="896" mergedindex="cp">textcomp <r>package</r></indexterm></findex>
+<para>&latex; provides commands to generate a number of non-letter symbols in
+running text. Some of these, especially the more obscure ones, are not
+available in OT1. Unless you are using Xe&latex; or Lua&latex; then
+you may need to load the <code>textcomp</code> package.
</para>
<ftable commandarg="code" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="882">\copyright</indexterm>\copyright</itemformat></item>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="883">\textcopyright</indexterm>\textcopyright</itemformat></itemx>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="523">copyright symbol</indexterm></cindex>
-<para>The copyright symbol, &copyright;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="884">\dag</indexterm>\dag</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="524">dagger, in text</indexterm></cindex>
-<para>The dagger symbol (in text).
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="885">\ddag</indexterm>\ddag</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="525">double dagger, in text</indexterm></cindex>
-<para>The double dagger symbol (in text).
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="886">\LaTeX</indexterm>\LaTeX</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="526">&latex; logo</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="527">logo, &latex;</indexterm></cindex>
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="897" mergedindex="cp">\copyright</indexterm>\copyright</itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="898" mergedindex="cp">\textcopyright</indexterm>\textcopyright</itemformat></itemx>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="718">copyright symbol</indexterm></cindex>
+<para>&copyright; The copyright symbol.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="899" mergedindex="cp">\dag</indexterm>\dag</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="719">dagger, in text</indexterm></cindex>
+<para><U>2020</U> The dagger symbol (in text).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="900" mergedindex="cp">\ddag</indexterm>\ddag</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="720">double dagger, in text</indexterm></cindex>
+<para><U>2021</U> The double dagger symbol (in text).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="901" mergedindex="cp">\LaTeX</indexterm>\LaTeX</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="721">&latex; logo</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="722">logo, &latex;</indexterm></cindex>
<para>The &latex; logo.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="887">\LaTeXe</indexterm>\LaTeXe</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="528">&latex;2e logo</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="529">logo, &latex;2e</indexterm></cindex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="902" mergedindex="cp">\LaTeXe</indexterm>\LaTeXe</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="723">&latex;2e logo</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="724">logo, &latex;2e</indexterm></cindex>
<para>The &latex;2e logo.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="888">\guillemotleft <r>(&laquo;)</r></indexterm>\guillemotleft <r>(&laquo;)</r></itemformat></item>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="889">\guillemotright <r>(&raquo;)</r></indexterm>\guillemotright <r>(&raquo;)</r></itemformat></itemx>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="890">\guilsinglleft <r>(&lsaquo;)</r></indexterm>\guilsinglleft <r>(&lsaquo;)</r></itemformat></itemx>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="891">\guilsinglright <r>(&rsaquo;)</r></indexterm>\guilsinglright <r>(&rsaquo;)</r></itemformat></itemx>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="530">double guillemets</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="531">single guillemets</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="532">left angle quotation marks</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="533">right angle quotation marks</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="534">double angle quotation marks</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="535">single angle quotation marks</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="536">French quotation marks</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="537">quotation marks, French</indexterm></cindex>
-<para>Double and single angle quotation marks, commonly used in French:
-&laquo;, &raquo;, &lsaquo;, &rsaquo;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="892">\ldots</indexterm>\ldots</itemformat></item>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="893">\dots</indexterm>\dots</itemformat></itemx>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="894">\textellipsis</indexterm>\textellipsis</itemformat></itemx>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="538">ellipsis</indexterm></cindex>
-<para>An ellipsis (three dots at the baseline): &textlsquo;&dots;&textrsquo;. <code>\ldots</code>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="903" mergedindex="cp">\guillemotleft <r>(&laquo;)</r></indexterm>\guillemotleft <r>(&laquo;)</r></itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="904" mergedindex="cp">\guillemotright <r>(&raquo;)</r></indexterm>\guillemotright <r>(&raquo;)</r></itemformat></itemx>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="905" mergedindex="cp">\guilsinglleft <r>(&lsaquo;)</r></indexterm>\guilsinglleft <r>(&lsaquo;)</r></itemformat></itemx>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="906" mergedindex="cp">\guilsinglright <r>(&rsaquo;)</r></indexterm>\guilsinglright <r>(&rsaquo;)</r></itemformat></itemx>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="725">double guillemets</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="726">single guillemets</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="727">left angle quotation marks</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="728">right angle quotation marks</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="729">double angle quotation marks</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="730">single angle quotation marks</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="731">French quotation marks</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="732">quotation marks, French</indexterm></cindex>
+<para>&laquo;, &raquo;, &lsaquo;, &rsaquo;
+Double and single angle quotation marks, commonly used in French.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="907" mergedindex="cp">\ldots</indexterm>\ldots</itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="908" mergedindex="cp">\dots</indexterm>\dots</itemformat></itemx>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="909" mergedindex="cp">\textellipsis</indexterm>\textellipsis</itemformat></itemx>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="733">ellipsis</indexterm></cindex>
+<para>&dots; An ellipsis (three dots at the baseline): <code>\ldots</code>
and <code>\dots</code> also work in math mode.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="895">\lq</indexterm>\lq</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="539">left quote</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="540">opening quote</indexterm></cindex>
-<para>Left (opening) quote: &textlsquo;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="896">\P</indexterm>\P</itemformat></item>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="897">\textparagraph</indexterm>\textparagraph</itemformat></itemx>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="541">paragraph symbol</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="542">pilcrow</indexterm></cindex>
-<para>Paragraph sign (pilcrow): <U>00B6</U>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="898">\pounds</indexterm>\pounds</itemformat></item>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="899">\textsterling</indexterm>\textsterling</itemformat></itemx>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="543">pounds symbol</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="544">sterling symbol</indexterm></cindex>
-<para>English pounds sterling: &pound;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="900">\quotedblbase <r>(&bdquo;)</r></indexterm>\quotedblbase <r>(&bdquo;)</r></itemformat></item>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="901">\quotesinglbase <r>(&sbquo;)</r></indexterm>\quotesinglbase <r>(&sbquo;)</r></itemformat></itemx>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="545">double low-9 quotation mark</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="546">single low-9 quotation mark</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="547">low-9 quotation marks, single and double</indexterm></cindex>
-<para>Double and single quotation marks on the baseline:
-&bdquo; and &sbquo;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="902">\rq</indexterm>\rq</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="548">right quote</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="549">closing quote</indexterm></cindex>
-<para>Right (closing) quote: &textrsquo;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="903">\S</indexterm>\S</itemformat></item>
-</tableterm><tableitem><para>\itemx \textsection
-<cindex index="cp" spaces=" "><indexterm index="cp" number="550">section symbol</indexterm></cindex>
-Section sign: <U>00A7</U>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="904">\TeX</indexterm>\TeX</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="551">&tex; logo</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="552">logo, &tex;</indexterm></cindex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="910" mergedindex="cp">\lq</indexterm>\lq</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="734">left quote</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="735">opening quote</indexterm></cindex>
+<para>&textlsquo; Left (opening) quote.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="911" mergedindex="cp">\P</indexterm>\P</itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="912" mergedindex="cp">\textparagraph</indexterm>\textparagraph</itemformat></itemx>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="736">paragraph symbol</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="737">pilcrow</indexterm></cindex>
+<para><U>00B6</U> Paragraph sign (pilcrow).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="913" mergedindex="cp">\pounds</indexterm>\pounds</itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="914" mergedindex="cp">\textsterling</indexterm>\textsterling</itemformat></itemx>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="738">pounds symbol</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="739">sterling symbol</indexterm></cindex>
+<para>&pound; English pounds sterling.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="915" mergedindex="cp">\quotedblbase <r>(&bdquo;)</r></indexterm>\quotedblbase <r>(&bdquo;)</r></itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="916" mergedindex="cp">\quotesinglbase <r>(&sbquo;)</r></indexterm>\quotesinglbase <r>(&sbquo;)</r></itemformat></itemx>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="740">double low-9 quotation mark</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="741">single low-9 quotation mark</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="742">low-9 quotation marks, single and double</indexterm></cindex>
+<para>&bdquo; and &sbquo;
+Double and single quotation marks on the baseline.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="917" mergedindex="cp">\rq</indexterm>\rq</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="743">right quote</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="744">closing quote</indexterm></cindex>
+<para>&textrsquo; Right (closing) quote.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="918" mergedindex="cp">\S</indexterm>\S</itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="919" mergedindex="cp">\textsection</indexterm>\textsection</itemformat></itemx>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="745">section symbol</indexterm></cindex>
+<para><U>00A7</U> Section sign.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="920" mergedindex="cp">\TeX</indexterm>\TeX</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="746">&tex; logo</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="747">logo, &tex;</indexterm></cindex>
<para>The &tex; logo.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="905">\textasciicircum</indexterm>\textasciicircum</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="553">circumflex, ASCII, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="554">ASCII circumflex, in text</indexterm></cindex>
-<para>ASCII circumflex: ^.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="906">\textasciitilde</indexterm>\textasciitilde</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="555">tilde, ASCII, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="556">ASCII tilde, in text</indexterm></cindex>
-<para>ASCII tilde: ~.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="907">\textasteriskcentered</indexterm>\textasteriskcentered</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="557">asterisk, centered, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="558">centered asterisk, in text</indexterm></cindex>
-<para>Centered asterisk: *.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="908">\textbackslash</indexterm>\textbackslash</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="559">backslash, in text</indexterm></cindex>
-<para>Backslash: \.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="909">\textbar</indexterm>\textbar</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="560">vertical bar, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="561">bar, vertical, in text</indexterm></cindex>
-<para>Vertical bar: |.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="910">\textbardbl</indexterm>\textbardbl</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="562">vertical bar, double, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="563">bar, double vertical, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="564">double vertical bar, in text</indexterm></cindex>
-<para>Double vertical bar.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="911">\textbigcircle</indexterm>\textbigcircle</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="565">big circle symbols, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="566">circle symbol, big, in text</indexterm></cindex>
-<para>Big circle symbol.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="912">\textbraceleft</indexterm>\textbraceleft</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="567">left brace, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="568">brace, left, in text</indexterm></cindex>
-<para>Left brace: &lbrace;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="913">\textbraceright</indexterm>\textbraceright</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="569">right brace, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="570">brace, right, in text</indexterm></cindex>
-<para>Right brace: &rbrace;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="914">\textbullet</indexterm>\textbullet</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="571">bullet, in text</indexterm></cindex>
-<para>Bullet: &bullet;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="915">\textcircled&lbrace;<var>letter</var>&rbrace;</indexterm>\textcircled&lbrace;<var>letter</var>&rbrace;</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="572">circled letter, in text</indexterm></cindex>
-<para><var>letter</var> in a circle, as in &registered;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="916">\textcompwordmark</indexterm>\textcompwordmark</itemformat></item>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="917">\textcapitalcompwordmark</indexterm>\textcapitalcompwordmark</itemformat></itemx>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="918">\textascendercompwordmark</indexterm>\textascendercompwordmark</itemformat></itemx>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="573">composite word mark, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="574">cap height</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="575">ascender height</indexterm></cindex>
-<para>Composite word mark (invisible). The <code>\textcapital...</code> form
-has the cap height of the font, while the <code>\textascender...</code> form
-has the ascender height.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="919">\textdagger</indexterm>\textdagger</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="576">dagger, in text</indexterm></cindex>
-<para>Dagger: <math>\dag</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="920">\textdaggerdbl</indexterm>\textdaggerdbl</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="577">dagger, double, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="578">double dagger, in text</indexterm></cindex>
-<para>Double dagger: <math>\ddag</math>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="921">\textdollar <r>(or <code>\$</code>)</r></indexterm>\textdollar <r>(or <code>\$</code>)</r></itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="579">dollar sign</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="580">currency, dollar</indexterm></cindex>
-<para>Dollar sign: $.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="922">\textemdash <r>(or <code>---</code>)</r></indexterm>\textemdash <r>(or <code>---</code>)</r></itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="581">em-dash</indexterm></cindex>
-<para>Em-dash: &textmdash; (for punctuation).
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="923">\textendash <r>(or <code>--</code>)</r></indexterm>\textendash <r>(or <code>--</code>)</r></itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="582">e-dash</indexterm></cindex>
-<para>En-dash: &textndash; (for ranges).
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="924">\texteuro</indexterm>\texteuro</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="583">euro symbol</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="584">currency, euro</indexterm></cindex>
-<para>The Euro symbol: &euro;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="925">\textexclamdown <r>(or <code>!`</code>)</r></indexterm>\textexclamdown <r>(or <code>!`</code>)</r></itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="585">exclamation point, upside-down</indexterm></cindex>
-<para>Upside down exclamation point: &iexcl;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="926">\textgreater</indexterm>\textgreater</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="586">greater than symbol, in text</indexterm></cindex>
-<para>Greater than: &gt;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="927">\textless</indexterm>\textless</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="587">less than symbol, in text</indexterm></cindex>
-<para>Less than: &lt;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="928">\textleftarrow</indexterm>\textleftarrow</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="588">arrow, left, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="589">left arrow, in text</indexterm></cindex>
-<para>Left arrow.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="929">\textordfeminine</indexterm>\textordfeminine</itemformat></item>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="930">\textordmasculine</indexterm>\textordmasculine</itemformat></itemx>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="590">feminine ordinal symbol</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="591">masculine ordinal symbol</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="592">ordinals, feminine and masculine</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="593">Spanish ordinals, feminine and masculine</indexterm></cindex>
-<para>Feminine and masculine ordinal symbols: &ordf;, &ordm;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="931">\textperiodcentered</indexterm>\textperiodcentered</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="594">period, centered, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="595">centered period, in text</indexterm></cindex>
-<para>Centered period: <U>00B7</U>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="932">\textquestiondown <r>(or <code>?`</code>)</r></indexterm>\textquestiondown <r>(or <code>?`</code>)</r></itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="596">question mark, upside-down</indexterm></cindex>
-<para>Upside down question mark: &iquest;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="933">\textquotedblleft <r>(or <code>``</code>)</r></indexterm>\textquotedblleft <r>(or <code>``</code>)</r></itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="597">left quote, double</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="598">double left quote</indexterm></cindex>
-<para>Double left quote: &textldquo;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="934">\textquotedblright <r>(or <code>''</code>)</r></indexterm>\textquotedblright <r>(or <code>''</code>)</r></itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="599">right quote, double</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="600">double right quote</indexterm></cindex>
-<para>Double right quote: &textrdquo;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="935">\textquoteleft <r>(or <code>`</code>)</r></indexterm>\textquoteleft <r>(or <code>`</code>)</r></itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="601">left quote, single</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="602">single left quote</indexterm></cindex>
-<para>Single left quote: &textlsquo;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="936">\textquoteright <r>(or <code>'</code>)</r></indexterm>\textquoteright <r>(or <code>'</code>)</r></itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="603">right quote, single</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="604">single right quote</indexterm></cindex>
-<para>Single right quote: &textrsquo;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="937">\textquotesingle</indexterm>\textquotesingle</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="605">quote, single straight</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="606">straight single quote</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="607">single quote, straight</indexterm></cindex>
-<para>Straight single quote. (From TS1 encoding.)
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="938">\textquotestraightbase</indexterm>\textquotestraightbase</itemformat></item>
-<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="939">\textquotestraightdblbase</indexterm>\textquotestraightdblbase</itemformat></itemx>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="608">quote, straight base</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="609">straight quote, base</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="610">double quote, straight base</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="611">straight double quote, base</indexterm></cindex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="921" mergedindex="cp">\textasciicircum</indexterm>\textasciicircum</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="748">circumflex, ASCII, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="749">ASCII circumflex, in text</indexterm></cindex>
+<para>^ ASCII circumflex.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="922" mergedindex="cp">\textasciitilde</indexterm>\textasciitilde</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="750">tilde, ASCII, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="751">ASCII tilde, in text</indexterm></cindex>
+<para>~ ASCII tilde.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="923" mergedindex="cp">\textasteriskcentered</indexterm>\textasteriskcentered</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="752">asterisk, centered, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="753">centered asterisk, in text</indexterm></cindex>
+<para>* Centered asterisk.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="924" mergedindex="cp">\textbackslash</indexterm>\textbackslash</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="754">backslash, in text</indexterm></cindex>
+<para>\ Backslash.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="925" mergedindex="cp">\textbar</indexterm>\textbar</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="755">vertical bar, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="756">bar, vertical, in text</indexterm></cindex>
+<para>| Vertical bar.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="926" mergedindex="cp">\textbardbl</indexterm>\textbardbl</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="757">vertical bar, double, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="758">bar, double vertical, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="759">double vertical bar, in text</indexterm></cindex>
+<para><U>23F8</U> Double vertical bar.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="927" mergedindex="cp">\textbigcircle</indexterm>\textbigcircle</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="760">big circle symbols, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="761">circle symbol, big, in text</indexterm></cindex>
+<para><U>25EF</U> Big circle symbol.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="928" mergedindex="cp">\textbraceleft</indexterm>\textbraceleft</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="762">left brace, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="763">brace, left, in text</indexterm></cindex>
+<para>&lbrace; Left brace.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="929" mergedindex="cp">\textbraceright</indexterm>\textbraceright</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="764">right brace, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="765">brace, right, in text</indexterm></cindex>
+<para>&rbrace; Right brace.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="930" mergedindex="cp">\textbullet</indexterm>\textbullet</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="766">bullet, in text</indexterm></cindex>
+<para>&bullet; Bullet.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="931" mergedindex="cp">\textcircled&lbrace;<var>letter</var>&rbrace;</indexterm>\textcircled&lbrace;<var>letter</var>&rbrace;</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="767">circled letter, in text</indexterm></cindex>
+<para><U>24B6</U> Circle around <var>letter</var>.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="932" mergedindex="cp">\textcompwordmark</indexterm>\textcompwordmark</itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="933" mergedindex="cp">\textcapitalcompwordmark</indexterm>\textcapitalcompwordmark</itemformat></itemx>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="934" mergedindex="cp">\textascendercompwordmark</indexterm>\textascendercompwordmark</itemformat></itemx>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="768">composite word mark, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="769">cap height</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="770">ascender height</indexterm></cindex>
+<para>Used to separate letters that would normally ligature. For example,
+<code>f\textcompwordmark i</code> produces <samp>fi</samp> without a ligature. This
+is most useful in non-English languages. The
+<code>\textcapitalcompwordmark</code> form has the cap height of the font
+while the <code>\textascendercompwordmark</code> form has the ascender height.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="935" mergedindex="cp">\textdagger</indexterm>\textdagger</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="771">dagger, in text</indexterm></cindex>
+<para><U>2020</U> Dagger.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="936" mergedindex="cp">\textdaggerdbl</indexterm>\textdaggerdbl</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="772">dagger, double, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="773">double dagger, in text</indexterm></cindex>
+<para><U>2021</U> Double dagger.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="937" mergedindex="cp">\textdollar <r>(or <code>\$</code>)</r></indexterm>\textdollar <r>(or <code>\$</code>)</r></itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="774">dollar sign</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="775">currency, dollar</indexterm></cindex>
+<para>$ Dollar sign.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="938" mergedindex="cp">\textemdash <r>(or <code>---</code>)</r></indexterm>\textemdash <r>(or <code>---</code>)</r></itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="776">em-dash</indexterm></cindex>
+<para>&textmdash; Em-dash (used for punctuation, as in
+<code>The playoffs --- if you are fortunate enough to make the playoffs ---
+is more like a sprint.</code>).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="939" mergedindex="cp">\textendash <r>(or <code>--</code>)</r></indexterm>\textendash <r>(or <code>--</code>)</r></itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="777">e-dash</indexterm></cindex>
+<para>&textndash; En-dash (used for ranges, as in <code>See pages 12--14</code>).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="940" mergedindex="cp">\texteuro</indexterm>\texteuro</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="778">euro symbol</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="779">currency, euro</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="780"><r>package</r>, <code>eurosym</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="781"><code>eurosym</code> <r>package</r></indexterm></cindex>
+
+<para>The Euro symbol: &euro;. For an alternative glyph design, try the
+<file>eurosym</file> package; also, most fonts nowadays come with their own
+Euro symbol (Unicode U+20AC).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="941" mergedindex="cp">\textexclamdown <r>(or <code>!`</code>)</r></indexterm>\textexclamdown <r>(or <code>!`</code>)</r></itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="782">exclamation point, upside-down</indexterm></cindex>
+<para>&iexcl; Upside down exclamation point.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="942" mergedindex="cp">\textgreater</indexterm>\textgreater</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="783">greater than symbol, in text</indexterm></cindex>
+<para>&gt; Greater than symbol.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="943" mergedindex="cp">\textless</indexterm>\textless</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="784">less than symbol, in text</indexterm></cindex>
+<para>&lt; Less than symbol.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="944" mergedindex="cp">\textleftarrow</indexterm>\textleftarrow</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="785">arrow, left, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="786">left arrow, in text</indexterm></cindex>
+<para><U>2190</U> Left arrow.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="945" mergedindex="cp">\textordfeminine</indexterm>\textordfeminine</itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="946" mergedindex="cp">\textordmasculine</indexterm>\textordmasculine</itemformat></itemx>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="787">feminine ordinal symbol</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="788">masculine ordinal symbol</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="789">ordinals, feminine and masculine</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="790">Spanish ordinals, feminine and masculine</indexterm></cindex>
+<para>&ordf;, &ordm; Feminine and masculine ordinal symbols.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="947" mergedindex="cp">\textperiodcentered</indexterm>\textperiodcentered</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="791">period, centered, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="792">centered period, in text</indexterm></cindex>
+<para><U>00B7</U> Centered period.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="948" mergedindex="cp">\textquestiondown <r>(or <code>?`</code>)</r></indexterm>\textquestiondown <r>(or <code>?`</code>)</r></itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="793">question mark, upside-down</indexterm></cindex>
+<para>&iquest; Upside down question mark.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="949" mergedindex="cp">\textquotedblleft <r>(or <code>``</code>)</r></indexterm>\textquotedblleft <r>(or <code>``</code>)</r></itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="794">left quote, double</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="795">double left quote</indexterm></cindex>
+<para>&textldquo; Double left quote.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="950" mergedindex="cp">\textquotedblright <r>(or <code>''</code>)</r></indexterm>\textquotedblright <r>(or <code>''</code>)</r></itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="796">right quote, double</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="797">double right quote</indexterm></cindex>
+<para>&textrdquo; Double right quote.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="951" mergedindex="cp">\textquoteleft <r>(or <code>`</code>)</r></indexterm>\textquoteleft <r>(or <code>`</code>)</r></itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="798">left quote, single</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="799">single left quote</indexterm></cindex>
+<para>&textlsquo; Single left quote.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="952" mergedindex="cp">\textquoteright <r>(or <code>'</code>)</r></indexterm>\textquoteright <r>(or <code>'</code>)</r></itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="800">right quote, single</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="801">single right quote</indexterm></cindex>
+<para>&textrsquo; Single right quote.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="953" mergedindex="cp">\textquotesingle</indexterm>\textquotesingle</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="802">quote, single straight</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="803">straight single quote</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="804">single quote, straight</indexterm></cindex>
+<para><U>0027</U> Straight single quote. (From TS1 encoding.)
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="954" mergedindex="cp">\textquotestraightbase</indexterm>\textquotestraightbase</itemformat></item>
+<itemx spaces=" "><itemformat command="code"><indexterm index="fn" number="955" mergedindex="cp">\textquotestraightdblbase</indexterm>\textquotestraightdblbase</itemformat></itemx>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="805">quote, straight base</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="806">straight quote, base</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="807">double quote, straight base</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="808">straight double quote, base</indexterm></cindex>
+<!-- c Unicode doesn't have these https://en.wikipedia.org/wiki/Quotation_mark -->
<para>Single and double straight quotes on the baseline.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="940">\textregistered</indexterm>\textregistered</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="612">registered symbol</indexterm></cindex>
-<para>Registered symbol: &registered;.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="956" mergedindex="cp">\textregistered</indexterm>\textregistered</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="809">registered symbol</indexterm></cindex>
+<para>&registered; Registered symbol.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="941">\textrightarrow</indexterm>\textrightarrow</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="613">arrow, right, in text</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="614">right arrow, in text</indexterm></cindex>
-<para>Right arrow.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="957" mergedindex="cp">\textrightarrow</indexterm>\textrightarrow</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="810">arrow, right, in text</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="811">right arrow, in text</indexterm></cindex>
+<para><U>2192</U> Right arrow.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="942">\textthreequartersemdash</indexterm>\textthreequartersemdash</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="615">three-quarters em-dash</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="616">em-dash, three-quarters</indexterm></cindex>
-<para>&textldquo;Three-quarters&textrdquo; em-dash, between en-dash and em-dash.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="958" mergedindex="cp">\textthreequartersemdash</indexterm>\textthreequartersemdash</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="812">three-quarters em-dash</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="813">em-dash, three-quarters</indexterm></cindex>
+<para><U>FE58</U> &textldquo;Three-quarters&textrdquo; em-dash, between en-dash and em-dash.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="943">\texttrademark</indexterm>\texttrademark</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="617">trademark symbol</indexterm></cindex>
-<para>Trademark symbol: <U>2122</U>.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="959" mergedindex="cp">\texttrademark</indexterm>\texttrademark</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="814">trademark symbol</indexterm></cindex>
+<para><U>2122</U> Trademark symbol.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="944">\texttwelveudash</indexterm>\texttwelveudash</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="618">two-thirds em-dash</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="619">em-dash, two-thirds</indexterm></cindex>
-<para>&textldquo;Two-thirds&textrdquo; em-dash, between en-dash and em-dash.
+<!-- c ?? Diff from \textthreequartersemdash? In Unicode? -->
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="960" mergedindex="cp">\texttwelveudash</indexterm>\texttwelveudash</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="815">two-thirds em-dash</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="816">em-dash, two-thirds</indexterm></cindex>
+<para><U>FE58</U> &textldquo;Two-thirds&textrdquo; em-dash, between en-dash and em-dash.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="945">\textunderscore</indexterm>\textunderscore</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="620">underscore, in text</indexterm></cindex>
-<para>Underscore: _.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="961" mergedindex="cp">\textunderscore</indexterm>\textunderscore</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="817">underscore, in text</indexterm></cindex>
+<para>_ Underscore.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="946">\textvisiblespace</indexterm>\textvisiblespace</itemformat></item>
-</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="621">visible space symbol, in text</indexterm></cindex>
-<para>Visible space symbol.
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="962" mergedindex="cp">\textvisiblespace</indexterm>\textvisiblespace</itemformat></item>
+</tableterm><tableitem><cindex index="cp" spaces=" "><indexterm index="cp" number="818">visible space symbol, in text</indexterm></cindex>
+<para><U>2423</U> Visible space symbol.
</para>
</tableitem></tableentry></ftable>
@@ -12075,167 +16469,167 @@ has the ascender height.
<node name="Accents" spaces=" "><nodename>Accents</nodename><nodenext automatic="on">Additional Latin letters</nodenext><nodeprev automatic="on">Text symbols</nodeprev><nodeup automatic="on">Special insertions</nodeup></node>
<section spaces=" "><sectiontitle>Accents</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="622">accents</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="623">characters, accented</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="624">letters, accented</indexterm></cindex>
-
-<cindex index="cp" spaces=" "><indexterm index="cp" number="625"><r>package</r>, <code>babel</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="626"><code>babel</code> <r>package</r></indexterm></cindex>
-
-<cindex index="cp" spaces=" "><indexterm index="cp" number="627">multilingual support</indexterm></cindex>
-<para>&latex; has wide support for many of the world&textrsquo;s scripts and
-languages, through the <code>babel</code> package and related support. This
-section does not attempt to cover all that support. It merely lists
-the core &latex; commands for creating accented characters.
-</para>
-<para>The <code>\capital...</code> commands produce alternative forms for use with
-capital letters. These are not available with OT1.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="819">accents</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="820">characters, accented</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="821">letters, accented</indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="822"><r>package</r>, <code>babel</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="823"><code>babel</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="824"><r>package</r>, <code>polyglossia</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="825"><code>polyglossia</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="826">multilingual support</indexterm></cindex>
+<para>&latex; has wide support for many of the world&textrsquo;s scripts and languages,
+through the <code>babel</code> package and related support if you are using
+pdf&latex;, or <file>polyglossia</file> if you are using Xe&latex; or
+Lua&latex;. This section does not cover that support. It only lists
+the core &latex; commands for creating accented characters. The
+<code>\capital...</code> commands shown here produce alternative forms for use
+with capital letters. These are not available with OT1.
+</para>
+<para>Below, to make them easier to find, the accents are all illustrated with
+lowercase <samp>o</samp>.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="963" mergedindex="cp">\i <r>(dotless i)</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="827">dotless i</indexterm></cindex>
+<para>Note that <code>\i</code> produces a dotless i,
+<!-- c @dotless{i}, -->
+<findex index="fn" spaces=" "><indexterm index="fn" number="964" mergedindex="cp">\j <r>(dotless j)</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="828">dotless j</indexterm></cindex>
+and <code>\j</code> produces a dotless j.
+<!-- c @dotless{j}. -->
+These are often used in place of their dotted counterparts when they are
+accented.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">\&quot;</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitaldieresis</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="947">\&quot; <r>(umlaut accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="948">\capitaldieresis</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="628">umlaut accent</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="629">dieresis accent</indexterm></cindex>
-<para>Produces an umlaut (dieresis), as in <accent type="uml">o</accent>.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="965" mergedindex="cp">\&quot; <r>(umlaut accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="966" mergedindex="cp">\capitaldieresis</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="829">umlaut accent</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="830">dieresis accent</indexterm></cindex>
+<para><accent type="uml">o</accent> Umlaut (dieresis).
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\'</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitalacute</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="949">\' <r>(acute accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="950">\capitalacute</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="630">acute accent</indexterm></cindex>
-<para>Produces an acute accent, as in <accent type="acute">o</accent>. In the <code>tabbing</code>
-environment, pushes current column to the right of the previous column
-(<pxref label="tabbing"><xrefnodename>tabbing</xrefnodename></pxref>).
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="967" mergedindex="cp">\' <r>(acute accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="968" mergedindex="cp">\capitalacute</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="831">acute accent</indexterm></cindex>
+<para><accent type="acute">o</accent> Acute accent.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\.</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="951">\. <r>(dot-over accent)</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="631">dot accent</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="632">dot-over accent</indexterm></cindex>
-<para>Produces a dot accent over the following, as in <accent type="dotaccent">o</accent>.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="969" mergedindex="cp">\. <r>(dot-over accent)</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="832">dot accent</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="833">dot-over accent</indexterm></cindex>
+<para><accent type="dotaccent">o</accent> Dot accent.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\=</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitalmacron</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="952">\= <r>(macron accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="953">\capitalmacron</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="633">macron accent</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="634">overbar accent</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="635">bar-over accent</indexterm></cindex>
-<para>Produces a macron (overbar) accent over the following, as in <accent type="macr">o</accent>.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="970" mergedindex="cp">\= <r>(macron accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="971" mergedindex="cp">\capitalmacron</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="834">macron accent</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="835">overbar accent</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="836">bar-over accent</indexterm></cindex>
+<para><accent type="macr">o</accent> Macron (overbar) accent.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\^</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitalcircumflex</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="954">\^ <r>(circumflex accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="955">\capitalcircumflex</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="636">circumflex accent</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="637">hat accent</indexterm></cindex>
-<para>Produces a circumflex (hat) accent over the following, as in <accent type="circ">o</accent>.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="972" mergedindex="cp">\^ <r>(circumflex accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="973" mergedindex="cp">\capitalcircumflex</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="837">circumflex accent</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="838">hat accent</indexterm></cindex>
+<para><accent type="circ">o</accent> Circumflex (hat) accent.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\`</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitalgrave</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="956">\` <r>(grave accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="957">\capitalgrave</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="638">grave accent</indexterm></cindex>
-<para>Produces a grave accent over the following, as in <accent type="grave">o</accent>. In the
-<code>tabbing</code> environment, move following text to the right margin
-(<pxref label="tabbing"><xrefnodename>tabbing</xrefnodename></pxref>).
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="974" mergedindex="cp">\` <r>(grave accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="975" mergedindex="cp">\capitalgrave</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="839">grave accent</indexterm></cindex>
+<para><accent type="grave">o</accent> Grave accent.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\~</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitaltilde</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="958">\~ <r>(tilde accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="959">\capitaltilde</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="639">tilde accent</indexterm></cindex>
-<para>Produces a tilde accent over the following, as in <accent type="tilde">n</accent>.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="976" mergedindex="cp">\~ <r>(tilde accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="977" mergedindex="cp">\capitaltilde</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="840">tilde accent</indexterm></cindex>
+<para><accent type="tilde">n</accent> Tilde accent.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\b</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="960">\b <r>(bar-under accent)</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="640">bar-under accent</indexterm></cindex>
-<para>Produces a bar accent under the following, as in <accent type="ubaraccent">o</accent>. See
-also <code>\underbar</code> hereinafter.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="978" mergedindex="cp">\b <r>(bar-under accent)</r></indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="841">bar-under accent</indexterm></cindex>
+<para><accent type="ubaraccent">o</accent> Bar accent underneath.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="979" mergedindex="cp">\underbar</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="842">underbar</indexterm></cindex>
+<para>Related to this, <code>\underbar&lbrace;<var>text</var>&rbrace;</code> produces a bar under
+<var>text</var>. The argument is always processed in LR mode
+(<pxref label="Modes"><xrefnodename>Modes</xrefnodename></pxref>). The bar is always a fixed position under the baseline,
+thus crossing through descenders. See also <code>\underline</code> in
+<ref label="Math-miscellany"><xrefnodename>Math miscellany</xrefnodename></ref>.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\c</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitalcedilla</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="961">\c <r>(cedilla accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="962">\capitalcedilla</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="641">cedilla accent</indexterm></cindex>
-<para>Produces a cedilla accent under the following, as in <accent type="cedil">c</accent>.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="980" mergedindex="cp">\c <r>(cedilla accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="981" mergedindex="cp">\capitalcedilla</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="843">cedilla accent</indexterm></cindex>
+<para><accent type="cedil">c</accent> Cedilla accent underneath.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\d</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitaldotaccent</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="963">\d <r>(dot-under accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="964">\capitaldotaccent</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="642">dot-under accent</indexterm></cindex>
-<para>Produces a dot accent under the following, as in <accent type="udotaccent">o</accent>.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="982" mergedindex="cp">\d <r>(dot-under accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="983" mergedindex="cp">\capitaldotaccent</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="844">dot-under accent</indexterm></cindex>
+<para><accent type="udotaccent">o</accent> Dot accent underneath.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\H</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitalhungarumlaut</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="965">\H <r>(Hungarian umlaut accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="966">\capitalhungarumlaut</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="643">hungarian umlaut accent</indexterm></cindex>
-<para>Produces a long Hungarian umlaut accent over the following, as in <accent type="doubleacute">o</accent>.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\i</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="967">\i <r>(dotless i)</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="644">dotless i</indexterm></cindex>
-<para>Produces a dotless i, as in &textlsquo;<dotless>i</dotless>&textrsquo;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\j</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="968">\j <r>(dotless j)</r></indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="645">dotless j</indexterm></cindex>
-<para>Produces a dotless j, as in &textlsquo;<dotless>j</dotless>&textrsquo;.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="984" mergedindex="cp">\H <r>(Hungarian umlaut accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="985" mergedindex="cp">\capitalhungarumlaut</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="845">hungarian umlaut accent</indexterm></cindex>
+<para><accent type="doubleacute">o</accent> Long Hungarian umlaut accent.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\k</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitalogonek</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="969">\k <r>(ogonek)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="970">\capitalogonek</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="646">ogonek</indexterm></cindex>
-<para>Produces a letter with ogonek, as in &textlsquo;<accent type="ogon">o</accent>&textrsquo;. Not available in
-the OT1 encoding.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="986" mergedindex="cp">\k <r>(ogonek)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="987" mergedindex="cp">\capitalogonek</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="846">ogonek</indexterm></cindex>
+<para><accent type="ogon">o</accent> Ogonek. Not available in the OT1 encoding.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\r</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitalring</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="971">\r <r>(ring accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="972">\capitalring</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="647">ring accent</indexterm></cindex>
-<para>Produces a ring accent, as in &textlsquo;<accent type="ring">o</accent>&textrsquo;.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="988" mergedindex="cp">\r <r>(ring accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="989" mergedindex="cp">\capitalring</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="847">ring accent</indexterm></cindex>
+<para><accent type="ring">o</accent> Ring accent.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\t</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitaltie</itemformat></itemx>
<itemx spaces=" "><itemformat command="code">\newtie</itemformat></itemx>
<itemx spaces=" "><itemformat command="code">\capitalnewtie</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="973">\t <r>(tie-after accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="974">\capitaltie</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="975">\newtie</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="976">\capitalnewtie</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="648">tie-after accent</indexterm></cindex>
-<para>Produces a tie-after accent, as in &textlsquo;<accent type="tieaccent">oo</accent>&textrsquo;. The
-<code>\newtie</code> form is centered in its box.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="990" mergedindex="cp">\t <r>(tie-after accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="991" mergedindex="cp">\capitaltie</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="992" mergedindex="cp">\newtie</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="993" mergedindex="cp">\capitalnewtie</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="848">tie-after accent</indexterm></cindex>
+<para><accent type="tieaccent">oo</accent> Tie-after accent. The <code>\newtie</code> form is centered in
+its box.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\u</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitalbreve</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="977">\u <r>(breve accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="978">\capitalbreve</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="649">breve accent</indexterm></cindex>
-<para>Produces a breve accent, as in &textlsquo;<accent type="breve">o</accent>&textrsquo;.
-</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\underbar</itemformat></item>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="979">\underbar</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="650">underbar</indexterm></cindex>
-<para>Not exactly an accent, this produces a bar under the argument text.
-The argument is always processed in horizontal mode. The bar is
-always a fixed position under the baseline, thus crossing through
-descenders. See also <code>\underline</code> in <ref label="Math-miscellany"><xrefnodename>Math miscellany</xrefnodename></ref>.
-See also <code>\b</code> above.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="994" mergedindex="cp">\u <r>(breve accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="995" mergedindex="cp">\capitalbreve</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="849">breve accent</indexterm></cindex>
+<para><accent type="breve">o</accent> Breve accent.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\v</itemformat></item>
<itemx spaces=" "><itemformat command="code">\capitalcaron</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="980">\v <r>(breve accent)</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="981">\capitalcaron</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="651">hacek accent</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="652">check accent</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="653">caron accent</indexterm></cindex>
-<para>Produces a h<accent type="acute" bracketed="off">a</accent><accent type="caron">c</accent>ek (check, caron) accent, as in &textlsquo;<accent type="caron">o</accent>&textrsquo;.
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="996" mergedindex="cp">\v <r>(breve accent)</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="997" mergedindex="cp">\capitalcaron</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="850">hacek accent</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="851">check accent</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="852">caron accent</indexterm></cindex>
+<para><accent type="caron">o</accent> H<accent type="acute" bracketed="off">a</accent><accent type="caron">c</accent>ek (check, caron) accent.
</para>
</tableitem></tableentry></table>
@@ -12245,98 +16639,98 @@ See also <code>\b</code> above.
<section spaces=" "><sectiontitle>Additional Latin letters</sectiontitle>
<anchor name="Non_002dEnglish-characters">Non-English characters</anchor>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="654">Latin letters, additional</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="655">letters, additional Latin</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="656">extended Latin</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="657">special characters</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="658">non-English characters</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="659">characters, non-English</indexterm></cindex>
-
-<para>Here are the basic &latex; commands for inserting letters (beyond
-A&textndash;Z) extending the Latin alphabet, used primarily in languages other
+<cindex index="cp" spaces=" "><indexterm index="cp" number="853">Latin letters, additional</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="854">letters, additional Latin</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="855">extended Latin</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="856">special characters</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="857">non-English characters</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="858">characters, non-English</indexterm></cindex>
+
+<para>Here are the basic &latex; commands for inserting letters beyond
+A&textndash;Z that extend the Latin alphabet, used primarily in languages other
than English.
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">\aa</itemformat></item>
<itemx spaces=" "><itemformat command="code">\AA</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="982">\aa (&aring;)</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="983">\AA (&Aring;)</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="660">aring</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="998" mergedindex="cp">\aa (&aring;)</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="999" mergedindex="cp">\AA (&Aring;)</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="859">aring</indexterm></cindex>
<para>&aring; and &Aring;.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ae</itemformat></item>
<itemx spaces=" "><itemformat command="code">\AE</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="984">\ae (&aelig;)</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="985">\AE (&AElig;)</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="661">ae ligature</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1000" mergedindex="cp">\ae (&aelig;)</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1001" mergedindex="cp">\AE (&AElig;)</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="860">ae ligature</indexterm></cindex>
<para>&aelig; and &AElig;.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\dh</itemformat></item>
<itemx spaces=" "><itemformat command="code">\DH</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="986">\dh (&eth;)</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="987">\DH (&ETH;)</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="662">Icelandic eth</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="663">eth, Icelandic letter</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1002" mergedindex="cp">\dh (&eth;)</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1003" mergedindex="cp">\DH (&ETH;)</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="861">Icelandic eth</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="862">eth, Icelandic letter</indexterm></cindex>
<para>Icelandic letter eth: &eth; and &ETH;. Not available with <sc>OT1</sc>
encoding, you need the <file>fontenc</file> package to select an alternate
font encoding, such as <sc>T1</sc>.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\dj</itemformat></item>
<itemx spaces=" "><itemformat command="code">\DJ</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="988">\dj</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="989">\DJ</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1004" mergedindex="cp">\dj</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1005" mergedindex="cp">\DJ</indexterm></findex>
<para>Crossed d and D, a.k.a.&noeos; capital and small letter d with stroke. Not
available with <sc>OT1</sc> encoding, you need the <file>fontenc</file> package to
select an alternate font encoding, such as <sc>T1</sc>.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ij</itemformat></item>
<itemx spaces=" "><itemformat command="code">\IJ</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="990">\ij (ij)</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="991">\IJ (IJ)</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="664">ij letter, Dutch</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1006" mergedindex="cp">\ij (ij)</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1007" mergedindex="cp">\IJ (IJ)</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="863">ij letter, Dutch</indexterm></cindex>
<para>ij and IJ (except somewhat closer together than appears here).
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\l</itemformat></item>
<itemx spaces=" "><itemformat command="code">\L</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="992">\l (&lslash;)</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="993">\L (&Lslash;)</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="665">polish l</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1008" mergedindex="cp">\l (&lslash;)</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1009" mergedindex="cp">\L (&Lslash;)</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="864">polish l</indexterm></cindex>
<para>&lslash; and &Lslash;.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ng</itemformat></item>
<itemx spaces=" "><itemformat command="code">\NG</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="994">\ng</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="995">\NG</indexterm></findex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1010" mergedindex="cp">\ng</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1011" mergedindex="cp">\NG</indexterm></findex>
<para>Lappish letter eng, also used in phonetics.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\o</itemformat></item>
<itemx spaces=" "><itemformat command="code">\O</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="996">\o (&oslash;)</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="997">\O (&Oslash;)</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="666">oslash</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1012" mergedindex="cp">\o (&oslash;)</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1013" mergedindex="cp">\O (&Oslash;)</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="865">oslash</indexterm></cindex>
<para>&oslash; and &Oslash;.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\oe</itemformat></item>
<itemx spaces=" "><itemformat command="code">\OE</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="998">\oe (&oelig;)</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="999">\OE (&OElig;)</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="667">oe ligature</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1014" mergedindex="cp">\oe (&oelig;)</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1015" mergedindex="cp">\OE (&OElig;)</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="866">oe ligature</indexterm></cindex>
<para>&oelig; and &OElig;.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\ss</itemformat></item>
<itemx spaces=" "><itemformat command="code">\SS</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1000">\ss (&szlig;)</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1001">\SS (SS)</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="668">es-zet German letter</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="669">sharp S letters</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1016" mergedindex="cp">\ss (&szlig;)</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1017" mergedindex="cp">\SS (SS)</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="867">es-zet German letter</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="868">sharp S letters</indexterm></cindex>
<para>&szlig; and SS.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">\th</itemformat></item>
<itemx spaces=" "><itemformat command="code">\TH</itemformat></itemx>
-</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1002">\th (&thorn;)</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1003">\TH (&THORN;)</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="670">Icelandic thorn</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="671">thorn, Icelandic letter</indexterm></cindex>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1018" mergedindex="cp">\th (&thorn;)</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1019" mergedindex="cp">\TH (&THORN;)</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="869">Icelandic thorn</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="870">thorn, Icelandic letter</indexterm></cindex>
<para>Icelandic letter thorn: &thorn; and &THORN;. Not available with <sc>OT1</sc>
encoding, you need the <file>fontenc</file> package to select an alternate
font encoding, such as <sc>T1</sc>.
@@ -12348,45 +16742,81 @@ font encoding, such as <sc>T1</sc>.
<node name="_005crule" spaces=" "><nodename>\rule</nodename><nodenext automatic="on">\today</nodenext><nodeprev automatic="on">Additional Latin letters</nodeprev><nodeup automatic="on">Special insertions</nodeup></node>
<section spaces=" "><sectiontitle><code>\rule</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1004">\rule</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1020" mergedindex="cp">\rule</indexterm></findex>
-<para>Synopsis:
+<para>Synopsis, one of:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\rule[<var>raise</var>]&lbrace;<var>width</var>&rbrace;&lbrace;<var>thickness</var>&rbrace;
+<pre xml:space="preserve">\rule&lbrace;<var>width</var>&rbrace;&lbrace;<var>thickness</var>&rbrace;
+\rule[<var>raise</var>]&lbrace;<var>width</var>&rbrace;&lbrace;<var>thickness</var>&rbrace;
</pre></example>
-<para>The <code>\rule</code> command produces <dfn>rules</dfn>, that is, lines or
-rectangles. The arguments are:
+<para>Produce a <dfn>rule</dfn>, a filled-in rectangle.
</para>
-<table commandarg="var" spaces=" " endspaces=" ">
-<tableentry><tableterm><item spaces=" "><itemformat command="var">raise</itemformat></item>
-</tableterm><tableitem><para>How high to raise the rule (optional).
+<cindex index="cp" spaces=" "><indexterm index="cp" number="871">Halmos symbol</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="872">tombstone</indexterm></cindex>
+<para>This produces a rectangular blob, sometimes called a Halmos symbol,
+often used to mark the end of a proof.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">width</itemformat></item>
-</tableterm><tableitem><para>The length of the rule (mandatory).
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand&lbrace;\qedsymbol&rbrace;&lbrace;\rule&lbrace;0.4em&rbrace;&lbrace;2ex&rbrace;&rbrace;
+</pre></example>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="873"><r>package</r>, <code>amsthm</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="874"><code>amsthm</code> <r>package</r></indexterm></cindex>
+
+<noindent></noindent>
+<para>The <file>amsthm</file> package includes this command, with a somewhat
+different-looking symbol.
</para>
-</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">thickness</itemformat></item>
-</tableterm><tableitem><para>The thickness of the rule (mandatory).
-</para></tableitem></tableentry></table>
+<para>The mandatory arguments give the horizontal <var>width</var> and vertical
+<var>thickness</var> of the rectangle. They are rigid lengths
+(<pxref label="Lengths"><xrefnodename>Lengths</xrefnodename></pxref>). The optional argument <var>raise</var> is also a rigid
+length, and tells &latex; how much to raise the rule above the
+baseline, or lower it if the length is negative.
+</para>
+<para>This produces a line, a rectangle that is wide but not tall.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\noindent\rule&lbrace;\textwidth&rbrace;&lbrace;0.4pt&rbrace;
+</pre></example>
+<noindent></noindent>
+<para>The line is the width of the page and 0.4&nbsp;points tall. This line
+thickness is common in &latex;.
+</para>
+<para>A rule that has zero width, or zero thickness, will not show up in the
+output, but can cause &latex; to change the output around it.
+<xref label="_005cstrut"><xrefnodename>\strut</xrefnodename></xref> for examples.
+</para>
</section>
<node name="_005ctoday" spaces=" "><nodename>\today</nodename><nodeprev automatic="on">\rule</nodeprev><nodeup automatic="on">Special insertions</nodeup></node>
<section spaces=" "><sectiontitle><code>\today</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1005">\today</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="672">date, today&textrsquo;s</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1021" mergedindex="cp">\today</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="875">date, today&textrsquo;s</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="876">today&textrsquo;s date</indexterm></cindex>
-<para>The <code>\today</code> command produces today&textrsquo;s date, in the format
-<samp><var>month</var> <var>dd</var>, <var>yyyy</var></samp>; for example, <samp>July 4, 1976</samp>.
-It uses the predefined counters <code>\day</code>, <code>\month</code>, and
-<code>\year</code> (<pxref label="_005cday-_005cmonth-_005cyear"><xrefnodename>\day \month \year</xrefnodename></pxref>) to do this. It is not
-updated as the program runs.
+<para>Synopsis:
</para>
-<para>Multilingual packages like <file>babel</file> or classes like <file>lettre</file>,
-among others, will localize <code>\today</code>. For example, the following
-will output <samp>4 juillet 1976</samp>:
+<example endspaces=" ">
+<pre xml:space="preserve">\today
+</pre></example>
+
+<para>Produce today&textrsquo;s date in the format <samp><var>month</var> <var>dd</var>,
+<var>yyyy</var></samp>. An example of a date in that format is <samp>July 4,
+1976</samp>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="877"><r>package</r>, <code>babel</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="878"><code>babel</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="879"><r>package</r>, <code>polyglossia</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="880"><code>polyglossia</code> <r>package</r></indexterm></cindex>
+
+<para>Multilingual packages such as <file>babel</file> or <file>polyglossia</file>, or
+classes such as <file>lettre</file>, will localize <code>\today</code>. For example,
+the following will output <samp>4 juillet 1976</samp>:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\year=1976 \month=7 \day=4
@@ -12397,11 +16827,18 @@ will output <samp>4 juillet 1976</samp>:
\end&lbrace;document&rbrace;
</pre></example>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="673"><r>package</r>, <code>datetime</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="674"><code>datetime</code> <r>package</r></indexterm></cindex>
+<noindent></noindent>
+<para><code>\today</code> uses the counters <code>\day</code>, <code>\month</code>, and
+<code>\year</code> (<pxref label="_005cday-_0026-_005cmonth-_0026-_005cyear"><xrefnodename>\day &amp; \month &amp; \year</xrefnodename></pxref>).
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="881"><r>package</r>, <code>datetime</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="882"><code>datetime</code> <r>package</r></indexterm></cindex>
-<para>The <code>datetime</code> package, among others, can produce a wide variety
-of other date formats.
+<para>A number of package on CTAN work with dates. One is <file>datetime</file> package
+which can produce a wide variety of date formats, including ISO standards.
+</para>
+<para>The date is not updated as the &latex; process runs, so in principle the
+date could be incorrect by the time the program finishes.
</para>
</section>
@@ -12409,95 +16846,294 @@ of other date formats.
<node name="Splitting-the-input" spaces=" "><nodename>Splitting the input</nodename><nodenext automatic="on">Front/back matter</nodenext><nodeprev automatic="on">Special insertions</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Splitting the input</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="675">splitting the input file</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="676">input file</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="883">splitting the input file</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="884">input file</indexterm></cindex>
-<para>A large document requires a lot of input. Rather than putting the whole
-input in a single large file, it&textrsquo;s more efficient to split it into
-several smaller ones. Regardless of how many separate files you use,
-there is one that is the
-<cindex index="cp" spaces=" "><indexterm index="cp" number="677">root file</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="678">file, root</indexterm></cindex>
-<dfn>root file</dfn>; it is the one whose name you type
-when you run &latex;.
+<para>&latex; lets you split a large document into several smaller ones.
+This can simplify editing or allow multiple authors to work on the
+document. It can also speed processing.
+</para>
+<para>Regardless of how many separate files you use, there is always one
+<cindex index="cp" spaces=" "><indexterm index="cp" number="885">root file</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="886">file, root</indexterm></cindex>
+<dfn>root file</dfn>, on which &latex; compilation starts. This shows such
+a file with five included files.
</para>
-<para><xref label="filecontents"><xrefnodename>filecontents</xrefnodename></xref>, for an environment that allows bundling an
-external file to be created with the main document.
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;book&rbrace;
+\includeonly&lbrace; % comment out lines below to omit compiling
+ pref,
+ chap1,
+ chap2,
+ append,
+ bib
+ &rbrace;
+\begin&lbrace;document&rbrace;
+\frontmatter
+\include&lbrace;pref&rbrace;
+\mainmatter
+\include&lbrace;chap1&rbrace;
+\include&lbrace;chap2&rbrace;
+\appendix
+\include&lbrace;append&rbrace;
+\backmatter
+\include&lbrace;bib&rbrace;
+\end&lbrace;document&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>This will bring in material from <file>pref.tex</file>, <file>chap1.tex</file>,
+<file>chap2.tex</file>, <file>append.tex</file>, and <file>bib.tex</file>. If you compile
+this file, and then comment out all of the lines inside
+<code>\includeonly&lbrace;...&rbrace;</code> except for <code>chap1,</code> and compile again,
+then &latex; will only process the material in the first chapter.
+Thus, your output will appear more quickly and be shorter to print.
+However, the advantage of the <code>\includeonly</code> command is that
+&latex; will retain the page numbers and all of the cross reference
+information from the other parts of the document so these will appear in
+your output correctly.
+</para>
+<para><xref label="Larger-book-template"><xrefnodename>Larger book template</xrefnodename></xref> for another example of <code>\includeonly</code>.
</para>
<menu endspaces=" ">
-<menuentry leadingtext="* "><menunode separator=":: ">\include</menunode><menudescription><pre xml:space="preserve">Conditionally include a file.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\includeonly</menunode><menudescription><pre xml:space="preserve">Determine which files are included.
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\input</menunode><menudescription><pre xml:space="preserve">Unconditionally include a file.
+<menuentry leadingtext="* "><menunode separator=":: ">\endinput</menunode><menudescription><pre xml:space="preserve">Stop including material from a file.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\include &amp; \includeonly</menunode><menudescription><pre xml:space="preserve">Conditionally include files.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\input</menunode><menudescription><pre xml:space="preserve">Unconditionally include a file.
</pre></menudescription></menuentry></menu>
-<node name="_005cinclude" spaces=" "><nodename>\include</nodename><nodenext automatic="on">\includeonly</nodenext><nodeup automatic="on">Splitting the input</nodeup></node>
-<section spaces=" "><sectiontitle><code>\include</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1006">\include</indexterm></findex>
+<node name="_005cendinput" spaces=" "><nodename>\endinput</nodename><nodenext automatic="on">\include &amp; \includeonly</nodenext><nodeup automatic="on">Splitting the input</nodeup></node>
+<section spaces=" "><sectiontitle><code>\endinput</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="1022" mergedindex="cp">\endinput</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\include&lbrace;<var>file</var>&rbrace;
+<pre xml:space="preserve">\endinput
</pre></example>
-<para>If no <code>\includeonly</code> command is present, the <code>\include</code>
-command executes <code>\clearpage</code> to start a new page
-(<pxref label="_005cclearpage"><xrefnodename>\clearpage</xrefnodename></pxref>), then reads <var>file</var>, then does another
-<code>\clearpage</code>.
+<para>When you <code>\include&lbrace;filename&rbrace;</code>, inside <file>filename.tex</file> the
+material after <code>\endinput</code> will not be included. This command is
+optional; if <file>filename.tex</file> has no <code>\endinput</code> then &latex;
+will read all of the file.
</para>
-<para>Given an <code>\includeonly</code> command, the <code>\include</code> actions are
-only run if <var>file</var> is listed as an argument to
-<code>\includeonly</code>. See <ref label="_005cincludeonly"><xrefnodename>\includeonly</xrefnodename></ref>.
+<para>For example, suppose that a document&textrsquo;s root file has
+<code>\input&lbrace;chap1&rbrace;</code> and this is <file>chap1.tex</file>.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="679">nested <code>\include</code>, not allowed</indexterm></cindex>
-<para>The <code>\include</code> command may not appear in the preamble or in a file
-read by another <code>\include</code> command.
+<example endspaces=" ">
+<pre xml:space="preserve">\chapter&lbrace;One&rbrace;
+This material will appear in the document.
+\endinput
+This will not appear.
+</pre></example>
+
+<para>This can be useful for putting documentation or comments at the end of a
+file, or for avoiding junk characters that can be added during mailing.
+It is also useful for debugging: one strategy to localize errors is to
+put <code>\endinput</code> halfway through the included file and see if the
+error disappears. Now, knowing which half contains the error, moving
+<code>\endinput</code> to halfway through that area further narrows down the
+location. This process rapidly finds the offending line.
+</para>
+<para>After reading <code>\endinput</code>, &latex; continues to read to the end of
+the line, so something can follow this command and be read nonetheless.
+This allows you, for instance, to close an <code>\if...</code> with a
+<code>\fi</code>.
</para>
</section>
-<node name="_005cincludeonly" spaces=" "><nodename>\includeonly</nodename><nodenext automatic="on">\input</nodenext><nodeprev automatic="on">\include</nodeprev><nodeup automatic="on">Splitting the input</nodeup></node>
-<section spaces=" "><sectiontitle><code>\includeonly</code></sectiontitle>
+<node name="_005cinclude-_0026-_005cincludeonly" spaces=" "><nodename>\include &amp; \includeonly</nodename><nodenext automatic="on">\input</nodenext><nodeprev automatic="on">\endinput</nodeprev><nodeup automatic="on">Splitting the input</nodeup></node>
+<section spaces=" "><sectiontitle><code>\include</code> &amp; <code>\includeonly</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1007">\includeonly</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1023" mergedindex="cp">\include</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1024" mergedindex="cp">\includeonly</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\includeonly&lbrace;<var>file1</var>,<var>file2</var>,...&rbrace;
+<pre xml:space="preserve">\includeonly&lbrace; % in document preamble
+ ...
+ <var>filename</var>,
+ ...
+ &rbrace;
+ ...
+\include&lbrace;<var>filename</var>&rbrace; % in document body
</pre></example>
-<para>The <code>\includeonly</code> command controls which files will be read by
-subsequent <code>\include</code> commands. The list of filenames is
-comma-separated. Each element <var>file1</var>, <var>file2</var>, &dots; must
-exactly match a filename specified in a <code>\include</code> command for the
-selection to be effective.
+<para>Bring material from the external file <file><var>filename</var>.tex</file> into a
+&latex; document.
</para>
-<para>This command can only appear in the preamble.
+<para>The <code>\include</code> command does three things: it executes
+<code>\clearpage</code> (<pxref label="_005cclearpage-_0026-_005ccleardoublepage"><xrefnodename>\clearpage &amp; \cleardoublepage</xrefnodename></pxref>), then it
+inputs the material from <file><var>filename</var>.tex</file> into the document,
+and then it does another <code>\clearpage</code>. This command can only
+appear in the document body. The <code>\includeonly</code> command controls
+which files will be read by &latex; under subsequent <code>\include</code>
+commands. Its list of filenames is comma-separated, and it can only
+appear in the preamble.
+</para>
+<para>This example root document, <file>constitution.tex</file>, brings in
+three files, <file>preamble.tex</file>, <file>articles.tex</file>, and
+<file>amendments.tex</file>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;book&rbrace;
+\includeonly&lbrace;
+ preamble,
+ articles,
+ amendments
+ &rbrace;
+\begin&lbrace;document&rbrace;
+\include&lbrace;preamble&rbrace;
+\include&lbrace;articles&rbrace;
+\include&lbrace;amendments&rbrace;
+\end&lbrace;document&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>The file <file>preamble.tex</file> contains no special code; you have just
+excerpted the chapter from <file>consitution.tex</file> and put it in a
+separate file just for editing convenience.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\chapter&lbrace;Preamble&rbrace;
+We the People of the United States,
+in Order to form a more perfect Union, ...
+</pre></example>
+
+<noindent></noindent>
+<para>Running &latex; on <file>constitution.tex</file> makes the material from the
+three files appear in the document but also generates the auxiliary
+files <file>preamble.aux</file>, <file>articles.aux</file>, and
+<file>amendments.tex</file>. These contain information such as page numbers
+and cross-references (<pxref label="Cross-references"><xrefnodename>Cross references</xrefnodename></pxref>). If you now comment out
+<code>\includeonly</code>&textrsquo;s lines with <code>preamble</code> and <code>amendments</code>
+and run &latex; again then the resulting document shows only the
+material from <file>articles.tex</file>, not the material from
+<file>preamble.tex</file> or <file>amendments.tex</file>. Nonetheless, all of the
+auxiliary information from the omitted files is still there, including
+the starting page number of the chapter.
+</para>
+<para>If the document preamble does not have <code>\includeonly</code> then
+&latex; will include all the files you call for with <code>\include</code>
+commands.
+</para>
+<para>The <code>\include</code> command makes a new page. To avoid that, see
+<ref label="_005cinput"><xrefnodename>\input</xrefnodename></ref> (which, however, does not retain the auxiliary
+information).
+</para>
+<para><xref label="Larger-book-template"><xrefnodename>Larger book template</xrefnodename></xref> for another example using <code>\include</code>
+and <code>\includeonly</code>. That example also uses <code>\input</code> for some
+material that will not necessarily start on a new page.
+</para>
+<para>File names can involve paths.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;book&rbrace;
+\includeonly&lbrace;
+ chapters/chap1,
+ &rbrace;
+\begin&lbrace;document&rbrace;
+\include&lbrace;chapters/chap1&rbrace;
+\end&lbrace;document&rbrace;
+</pre></example>
+
+<para>To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores. Nevertheless, for the name <samp>amo amas amat</samp>,
+this works under &tex; Live on GNU/Linux:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;book&rbrace;
+\includeonly&lbrace;
+ &quot;amo\space amas\space amat&quot;
+ &rbrace;
+\begin&lbrace;document&rbrace;
+\include&lbrace;&quot;amo\space amas\space amat&quot;&rbrace;
+\end&lbrace;document&rbrace;
+</pre></example>
+
+<para>and this works under MiK&tex; on Windows:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;book&rbrace;
+\includeonly&lbrace;
+ &lbrace;&quot;amo amas amat&quot;&rbrace;
+ &rbrace;
+\begin&lbrace;document&rbrace;
+\include&lbrace;&lbrace;&quot;amo amas amat&quot;&rbrace;&rbrace;
+\end&lbrace;document&rbrace;
+</pre></example>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="887">nested <code>\include</code>, not allowed</indexterm></cindex>
+<para>You cannot use <code>\include</code> inside a file that is being included or
+you get <samp>LaTeX Error: \include cannot be nested.</samp> The
+<code>\include</code> command cannot appear in the document preamble; you will
+get <samp>LaTeX Error: Missing \begin&lbrace;document&rbrace;</samp>.
+</para>
+<para>If a file that you <code>\include</code> does not exist, for instance if you
+<code>\include&lbrace;athiesm&rbrace;</code> but you meant <code>\include&lbrace;atheism&rbrace;</code>,
+then &latex; does not give you an error but will warn you <samp>No file
+athiesm.tex.</samp> (It will also create <file>athiesm.aux</file>.)
+</para>
+<para>If you <code>\include</code> the root file in itself then you first get
+<samp>LaTeX Error: Can be used only in preamble.</samp> Later runs get
+<samp>TeX capacity exceeded, sorry [text input levels=15]</samp>. To fix
+this, you must remove the inclusion <code>\include&lbrace;root&rbrace;</code> but also
+delete the file <file><var>root</var>.aux</file> and rerun &latex;.
</para>
</section>
-<node name="_005cinput" spaces=" "><nodename>\input</nodename><nodeprev automatic="on">\includeonly</nodeprev><nodeup automatic="on">Splitting the input</nodeup></node>
+<node name="_005cinput" spaces=" "><nodename>\input</nodename><nodeprev automatic="on">\include &amp; \includeonly</nodeprev><nodeup automatic="on">Splitting the input</nodeup></node>
<section spaces=" "><sectiontitle><code>\input</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1008">\input</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1025" mergedindex="cp">\input</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\input&lbrace;<var>file</var>&rbrace;
+<pre xml:space="preserve">\input&lbrace;<var>filename</var>&rbrace;
</pre></example>
-<para>The <code>\input</code> command causes the specified <var>file</var> to be read
-and processed, as if its contents had been inserted in the current
-file at that point.
+<para>&latex; processes the file as if its contents were inserted in the
+current file. For a more sophisticated inclusion mechanism see
+<ref label="_005cinclude-_0026-_005cincludeonly"><xrefnodename>\include &amp; \includeonly</xrefnodename></ref>.
+</para>
+<para>If <var>filename</var> does not end in <samp>.tex</samp> then &latex; first tries
+the filename with that extension; this is the usual case. If
+<var>filename</var> ends with <samp>.tex</samp> then &latex; looks for the
+filename as it is.
</para>
-<para>If <var>file</var> does not end in <samp>.tex</samp> (e.g., <samp>foo</samp> or
-<samp>foo.bar</samp>), it is first tried with that extension (<samp>foo.tex</samp>
-or <samp>foo.bar.tex</samp>). If that is not found, the original <var>file</var>
-is tried (<samp>foo</samp> or <samp>foo.bar</samp>).
+<para>For example, this
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\input&lbrace;macros&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>will cause &latex; to first look for <file>macros.tex</file>. If it finds
+that file then it processes its contents as thought they had been
+copy-pasted in. If there is no file of the name <file>macros.tex</file> then
+&latex; tries the name <file>macros</file>, without an extension. (This may
+vary by distribution.)
+</para>
+<para>To make your document portable across distributions and platforms you
+should avoid spaces in the file names. The tradition is to instead use
+dashes or underscores. Nevertheless, for the name <samp>amo amas amat</samp>,
+this works under &tex; Live on GNU/Linux:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\input&lbrace;&quot;amo\space amas\space amat&quot;&rbrace;
+</pre></example>
+
+<para>and this works under MiK&tex; on Windows:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\input&lbrace;&lbrace;&quot;amo amas amat&quot;&rbrace;&rbrace;
+</pre></example>
+
</section>
</chapter>
@@ -12505,53 +17141,154 @@ is tried (<samp>foo</samp> or <samp>foo.bar</samp>).
<chapter spaces=" "><sectiontitle>Front/back matter</sectiontitle>
<menu endspaces=" ">
-<menuentry leadingtext="* "><menunode separator="::">Tables of contents</menunode><menudescription><pre xml:space="preserve">
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator="::">Glossaries</menunode><menudescription><pre xml:space="preserve">
-</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator="::">Indexes</menunode><menudescription><pre xml:space="preserve">
+<menuentry leadingtext="* "><menunode separator=":: ">Table of contents etc.</menunode><menudescription><pre xml:space="preserve">Table of contents, list of figures, list of tables.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Indexes</menunode><menudescription><pre xml:space="preserve">Generate an index.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Glossaries</menunode><menudescription><pre xml:space="preserve">Generate a glossary.
</pre></menudescription></menuentry></menu>
-<node name="Tables-of-contents" spaces=" "><nodename>Tables of contents</nodename><nodenext automatic="on">Glossaries</nodenext><nodeup automatic="on">Front/back matter</nodeup></node>
-<section spaces=" "><sectiontitle>Tables of contents</sectiontitle>
+<node name="Table-of-contents-etc_002e" spaces=" "><nodename>Table of contents etc.</nodename><nodenext automatic="on">Indexes</nodenext><nodeup automatic="on">Front/back matter</nodeup></node>
+<section spaces=" "><sectiontitle>Table of contents etc.</sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="888">table of contents, creating</indexterm></cindex>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="1026" mergedindex="cp">\tableofcontents</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1027" mergedindex="cp">.toc <r>file</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1028" mergedindex="cp">\listoffigures</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1029" mergedindex="cp">\listoftables</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1030" mergedindex="cp">.lof <r>file</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1031" mergedindex="cp">.lot <r>file</r></indexterm></findex>
+
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\tableofcontents
+\listoffigures
+\listoftables
+</pre></example>
+
+<para>Produce a table of contents, or list of figures, or list of tables. Put
+the command in the input file where you want the table or list to
+go. You do not type the entries; for example, typically the table of
+contents entries are automatically generated from the sectioning
+commands <code>\chapter</code>, etc.
+</para>
+<para>This example illustrates the first command, <code>\tableofcontents</code>.
+&latex; will produce a table of contents on the book&textrsquo;s first page.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;book&rbrace;
+% \setcounter&lbrace;tocdepth&rbrace;&lbrace;1&rbrace;
+\begin&lbrace;document&rbrace;
+\tableofcontents\newpage
+ ...
+\chapter&lbrace;...&rbrace;
+ ...
+\section&lbrace;...&rbrace;
+ ...
+\subsection&lbrace;...&rbrace;
+ ...
+\end&lbrace;document&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>Uncommenting the second line would cause that table to contain chapter
+and section listings but not subsection listings, because the
+<code>\section</code> command has level&nbsp;1. <xref label="Sectioning"><xrefnodename>Sectioning</xrefnodename></xref> for level
+numbers of the sectioning units. For more on the <code>tocdepth</code>
+<pxref label="Sectioning_002ftocdepth"><xrefnodename>Sectioning/tocdepth</xrefnodename></pxref>.
+</para>
+<para>Another example of the use of <code>\tableofcontents</code> is in <ref label="Larger-book-template"><xrefnodename>Larger
+book template</xrefnodename></ref>.
+</para>
+<para>If you want a page break after the table of contents, write a
+<code>\newpage</code> command after the <code>\tableofcontents</code> command, as
+above.
+</para>
+<para>To make the table of contents &latex; stores the information in an
+auxiliary file named <file><var>root-file</var>.toc</file> (<pxref label="Splitting-the-input"><xrefnodename>Splitting the
+input</xrefnodename></pxref>). For example, this &latex; file <file>test.tex</file>
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;article&rbrace;
+\begin&lbrace;document&rbrace;
+\tableofcontents\newpage
+\section&lbrace;First section&rbrace;
+\subsection&lbrace;First subsection&rbrace;
+ ...
+</pre></example>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="680">table of contents, creating</indexterm></cindex>
+<noindent></noindent>
+<para>writes the following line to <file>test.toc</file>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\contentsline &lbrace;section&rbrace;&lbrace;\numberline &lbrace;1&rbrace;First section&rbrace;&lbrace;2&rbrace;
+\contentsline &lbrace;subsection&rbrace;&lbrace;\numberline &lbrace;1.1&rbrace;First subsection&rbrace;&lbrace;2&rbrace;
+</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1009">\tableofcontents</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1010">.toc <r>file</r></indexterm></findex>
-<para>A table of contents is produced with the <code>\tableofcontents</code>
-command. You put the command right where you want the table of
-contents to go; &latex; does the rest for you. A previous run must
-have generated a <file>.toc</file> file.
+<noindent></noindent>
+<para>The <code>section</code> or <code>subsection</code> is the sectioning unit. The
+hook <code>\numberline</code> lets you to change how the information appears
+in the table of contents. Of its two arguments, <code>1</code> or <code>1.1</code>
+is the sectioning unit number and <code>First section</code> or <code>First
+subsection</code> is the title. Finally, <code>2</code> is the page number on which
+the sectioning units start.
+</para>
+<para>One consequence of this auxiliary file storage strategy is that to get the
+contents page correct you must run &latex; twice, once to store the
+information and once to get it. In particular, the first time that you
+run &latex; on a new document, the table of contents page will be empty
+except for its <samp>Contents</samp> header. Just run it again.
</para>
-<para>The <code>\tableofcontents</code> command produces a heading, but it does
-not automatically start a new page. If you want a new page after the
-table of contents, write a <code>\newpage</code> command after the
-<code>\tableofcontents</code> command.
+<para>The commands <code>\listoffigures</code> and <code>\listoftables</code> produce a
+list of figures and a list of tables. They work the same way as the
+contents commands; for instance, these work with information stored in
+<file>.lof</file> and <file>.lot</file> files.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="889"><r>package</r>, <code>babel</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="890"><code>babel</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="891"><r>package</r>, <code>polyglossia</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="892"><code>polyglossia</code> <r>package</r></indexterm></cindex>
+
+<para>To change the header for the table of contents page do something like
+the first line here.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1011">\listoffigures</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1012">\listoftables</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1013">.lof <r>file</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1014">.lot <r>file</r></indexterm></findex>
-<para>The analogous commands <code>\listoffigures</code> and <code>\listoftables</code>
-produce a list of figures and a list of tables (from <file>.lof</file> and
-<file>.lot</file> files), respectively. Everything works exactly the same
-as for the table of contents.
+<example endspaces=" ">
+<pre xml:space="preserve">\renewcommand&lbrace;\contentsname&rbrace;&lbrace;Table of contents&rbrace;
+\renewcommand&lbrace;\listfigurename&rbrace;&lbrace;Plots&rbrace;
+\renewcommand&lbrace;\listtablename&rbrace;&lbrace;Tables&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>Similarly, the other two lines will do the other two.
+Internationalization packages such as <file>babel</file> or <file>polyglossia</file>
+will change the headers depending on the chosen base language.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1015">\nofiles</indexterm></findex>
-<para>The command <code>\nofiles</code> overrides these commands, and
-<emph>prevents</emph> any of these lists from being generated.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="893"><r>package</r>, <code>tocloft</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="894"><code>tocloft</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="895"><r>package</r>, <code>tocbibbind</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="896"><code>tocbibbind</code> <r>package</r></indexterm></cindex>
+
+<para>CTAN has many packages for the table of contents and lists of figures
+and tables. One convenient one for adjusting some aspects of the
+default, such as spacing, is <file>tocloft</file>. And, <file>tocbibbind</file>
+will automatically add the bibliography, index, etc. to the table of
+contents.
</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\addcontentsline</menunode><menudescription><pre xml:space="preserve">Add an entry to table of contents, etc.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\addtocontents</menunode><menudescription><pre xml:space="preserve">Add text directly to table of contents file, etc.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\nofiles</menunode><menudescription><pre xml:space="preserve">Prevent writing to auxiliary files.
</pre></menudescription></menuentry></menu>
-<node name="_005caddcontentsline" spaces=" "><nodename>\addcontentsline</nodename><nodenext automatic="on">\addtocontents</nodenext><nodeup automatic="on">Tables of contents</nodeup></node>
+<node name="_005caddcontentsline" spaces=" "><nodename>\addcontentsline</nodename><nodenext automatic="on">\addtocontents</nodenext><nodeup automatic="on">Table of contents etc.</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\addcontentsline</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1016">\addcontentsline</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="681">table of contents entry, manually adding</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1032" mergedindex="cp">\addcontentsline</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="897">table of contents entry, manually adding</indexterm></cindex>
<para>Synopsis:
</para>
@@ -12559,170 +17296,824 @@ as for the table of contents.
<pre xml:space="preserve">\addcontentsline&lbrace;<var>ext</var>&rbrace;&lbrace;<var>unit</var>&rbrace;&lbrace;<var>text</var>&rbrace;
</pre></example>
-<para>The <code>\addcontentsline</code> command adds an entry to the specified list
-or table where:
+<findex index="fn" spaces=" "><indexterm index="fn" number="1033" mergedindex="cp">\contentsline</indexterm></findex>
+<para>Add an entry to the file specified by <var>ext</var>. Usually <var>ext</var> is
+one of <code>toc</code> for the table of contents, <code>lof</code> for the list of
+figures, or <code>lot</code> for the list of tables.
+</para>
+<para>The following will result in an <samp>Appendices</samp> line in the table of
+contents.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\addcontentsline&lbrace;toc&rbrace;&lbrace;section&rbrace;&lbrace;\protect\textbf&lbrace;Appendices&rbrace;&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>It will appear at the same indentation level as the sections, will be in
+boldface, and will be assigned the page number associated with the point
+where it appears in the input file.
+</para>
+<para>The <code>\addcontentsline</code> command writes information to the file
+<file><var>root-name</var>.<var>ext</var></file>. It writes that information as the
+text of the command
+<code>\contentsline&lbrace;<var>unit</var>&rbrace;&lbrace;<var>text</var>&rbrace;&lbrace;<var>num</var>&rbrace;</code>, where
+<code><var>num</var></code> is the current value of counter <code><var>unit</var></code>. The
+most common case is the table of contents and there <var>num</var> is the
+page number of the first page of <var>unit</var>.
+</para>
+<para>This command is invoked by the sectioning commands <code>\chapter</code>,
+etc., and also by <code>\caption</code> inside a float environment. But it is
+also used by authors. For example, in a book to have the preface
+unnumbered, you may use the starred <code>\chapter*</code>. But that does not
+put in table of contents information, so you can enter it manually, as
+here.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\chapter*&lbrace;Preface&rbrace;
+\addcontentsline&lbrace;toc&rbrace;&lbrace;chapter&rbrace;&lbrace;\protect\numberline&lbrace;&rbrace;Preface&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>In the <file>.toc</file> file &latex; will put the line <code>\contentsline
+&lbrace;chapter&rbrace;&lbrace;\numberline &lbrace;&rbrace;Preface&rbrace;&lbrace;3&rbrace;</code>; note the page number
+<samp>3</samp>.
+</para>
+<!-- c xx how hardwired are these values? other unit names? -->
+
+<para>All of the arguments for <code>\addcontentsline</code> are required.
</para>
<table commandarg="var" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="var">ext</itemformat></item>
-</tableterm><tableitem><para>The filename extension of the file on which information is to be written,
-typically one of: <code>toc</code> (table of contents), <code>lof</code> (list of
-figures), or <code>lot</code> (list of tables).
+</tableterm><tableitem><para>Typically one of the strings <code>toc</code> for the table of contents,
+<code>lof</code> for the list of figures, or <code>lot</code> for the list of
+tables. The filename extension of the information file.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">unit</itemformat></item>
-</tableterm><tableitem><para>The name of the sectional unit being added, typically one of the
-following, matching the value of the <var>ext</var> argument:
+</tableterm><tableitem><para>A string that depends on the value of the <var>ext</var> argument:
</para>
<table commandarg="code" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="code">toc</itemformat></item>
-</tableterm><tableitem><para>The name of the sectional unit: <code>part</code>, <code>chapter</code>,
-<code>section</code>, <code>subsection</code>, <code>subsubsection</code>.
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">lof</itemformat></item>
+</tableterm><tableitem><para>For the table of contents, this is the name of a sectional unit:
+<code>part</code>, <code>chapter</code>, <code>section</code>, <code>subsection</code>, etc.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">lof</itemformat></item>
</tableterm><tableitem><para>For the list of figures: <code>figure</code>.
-</para></tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">lot</itemformat></item>
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">lot</itemformat></item>
</tableterm><tableitem><para>For the list of tables: <code>table</code>.
</para></tableitem></tableentry></table>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">text</itemformat></item>
-</tableterm><tableitem><para>The text of the entry.
+</tableterm><tableitem><para>The text of the entry. You must <code>\protect</code> any commands that are
+fragile (<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
</para></tableitem></tableentry></table>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1017">\contentsline</indexterm></findex>
-<para>What is written to the <file>.<var>ext</var></file> file is the command
-<code>\contentsline&lbrace;<var>unit</var>&rbrace;&lbrace;<var>text</var>&rbrace;&lbrace;<var>num</var>&rbrace;</code>, where
-<code><var>num</var></code> is the current value of counter <code><var>unit</var></code>.
+<para>The <code>\addcontentsline</code> command has an interaction with
+<code>\include</code> (<pxref label="_005cinclude-_0026-_005cincludeonly"><xrefnodename>\include &amp; \includeonly</xrefnodename></pxref>). If you use them at
+the same level, as with
+<code>\addcontentsline&lbrace;...&rbrace;&lbrace;...&rbrace;&lbrace;...&rbrace;\include&lbrace;...&rbrace;</code> then lines
+in the table of contents can come out in the wrong order. The solution
+is to move <code>\addcontentsline</code> into the file being included.
</para>
-<!-- c xx how hardwired are these values? other unit names? -->
+<para>If you use a <var>unit</var> that &latex; does not recognize, as here
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\addcontentsline&lbrace;toc&rbrace;&lbrace;setcion&rbrace;&lbrace;\protect\textbf&lbrace;Appendices&rbrace;&rbrace;
+</pre></example>
+<noindent></noindent>
+<para>then you don&textrsquo;t get an error but the formatting in the table of contents
+will not make sense.
+</para>
</subsection>
-<node name="_005caddtocontents" spaces=" "><nodename>\addtocontents</nodename><nodeprev automatic="on">\addcontentsline</nodeprev><nodeup automatic="on">Tables of contents</nodeup></node>
+<node name="_005caddtocontents" spaces=" "><nodename>\addtocontents</nodename><nodenext automatic="on">\nofiles</nodenext><nodeprev automatic="on">\addcontentsline</nodeprev><nodeup automatic="on">Table of contents etc.</nodeup></node>
<subsection spaces=" "><sectiontitle><code>\addtocontents</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1018">\addtocontents&lbrace;<var>ext</var>&rbrace;&lbrace;<var>text</var>&rbrace;</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1034" mergedindex="cp">\addtocontents&lbrace;<var>ext</var>&rbrace;&lbrace;<var>text</var>&rbrace;</indexterm></findex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\addtocontents&lbrace;<var>ext</var>&rbrace;&lbrace;<var>text</var>&rbrace;
+</pre></example>
-<para>The <code>\addtocontents</code>&lbrace;<var>ext</var>&rbrace;&lbrace;<var>text</var>&rbrace; command adds text
-(or formatting commands) directly to the <file>.<var>ext</var></file> file that
-generates the table of contents or lists of figures or tables.
+<para>Add <var>text</var>, which may be text or formatting commands, directly to
+the auxiliary file with extension <var>ext</var>. This is most commonly used
+for the table of contents so that is the discussion here, but this also
+applies to the list of figures and list of tables.
+</para>
+<para>This will put some vertical space in the table of contents after the
+<samp>Contents</samp> header.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\tableofcontents\newpage
+\addtocontents&lbrace;toc&rbrace;&lbrace;\protect\vspace*&lbrace;3ex&rbrace;&rbrace;
+</pre></example>
+
+<para>The <code>\addtocontents</code> command has two arguments. Both are
+required.
</para>
<table commandarg="var" spaces=" " endspaces=" ">
<tableentry><tableterm><item spaces=" "><itemformat command="var">ext</itemformat></item>
-</tableterm><tableitem><para>The extension of the file on which information is to be written,
-typically one of: <file>toc</file> (table of contents), <file>lof</file> (list of
-figures), or <file>lot</file> (list of tables).
+</tableterm><tableitem><para>Typically one of: <file>toc</file> for the table of contents, <file>lof</file> for
+the list of figures, or <file>lot</file> for the list of tables. The
+extension of the file holding the information.
</para>
</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="var">text</itemformat></item>
-</tableterm><tableitem><para>The text to be written.
+</tableterm><tableitem><para>The text, and possibly commands, to be written.
</para></tableitem></tableentry></table>
+<para>The sectioning commands such as <code>\chapter</code> use the
+<code>\addcontentsline</code> command to store information. This command
+creates lines in the <file>.toc</file> auxiliary file containing the
+<code>\contentsline</code> command (<pxref label="_005caddcontentsline"><xrefnodename>\addcontentsline</xrefnodename></pxref>). In contrast,
+the command <code>\addtocontents</code> puts material directly in that file.
+</para>
+<para>The <code>\addtocontents</code> command has an interaction with
+<code>\include</code> (<pxref label="_005cinclude-_0026-_005cincludeonly"><xrefnodename>\include &amp; \includeonly</xrefnodename></pxref>). If you use them at
+the same level, as with
+<code>\addtocontents&lbrace;...&rbrace;&lbrace;...&rbrace;\include&lbrace;...&rbrace;</code> then lines in the
+table of contents can come out in the wrong order. The solution is to
+move <code>\addtocontents</code> into the file being included.
+</para>
</subsection>
-</section>
-<node name="Glossaries" spaces=" "><nodename>Glossaries</nodename><nodenext automatic="on">Indexes</nodenext><nodeprev automatic="on">Tables of contents</nodeprev><nodeup automatic="on">Front/back matter</nodeup></node>
-<section spaces=" "><sectiontitle>Glossaries</sectiontitle>
+<node name="_005cnofiles" spaces=" "><nodename>\nofiles</nodename><nodeprev automatic="on">\addtocontents</nodeprev><nodeup automatic="on">Table of contents etc.</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\nofiles</code></sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="682">glossaries</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1035" mergedindex="cp">\nofiles</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1019">\makeglossary</indexterm></findex>
-<para>The command <code>\makeglossary</code> enables creating glossaries.
+<para>Synopsis:
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1020">\glossary</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="683"><file>.glo</file> file</indexterm></cindex>
-<para>The command <code>\glossary&lbrace;<var>text</var>&rbrace;</code> writes a glossary entry for
-<var>text</var> to an auxiliary file with the <file>.glo</file> extension.
+<example endspaces=" ">
+<pre xml:space="preserve">\nofiles
+</pre></example>
+
+<para>Prevent &latex; from writing any auxiliary files. The only output will
+be the <file>.log</file> and <file>.pdf</file> (or <file>.dvi</file>) files. This command
+must go in the preamble.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1021">\glossaryentry</indexterm></findex>
-<para>Specifically, what gets written is the command
-<code>\glossaryentry&lbrace;<var>text</var>&rbrace;&lbrace;<var>pageno</var>&rbrace;</code>, where
-<var>pageno</var> is the current <code>\thepage</code> value.
+<para>Because of the <code>\nofiles</code> command this example will not produce a
+<file>.toc</file> file.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="684">glossary <r>package</r></indexterm></cindex>
-<para>The <code>glossary</code> package on CTAN provides support for fancier
-glossaries.
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;book&rbrace;
+\nofiles
+\begin&lbrace;document&rbrace;
+\tableofcontents\newpage
+\chapter&lbrace;...&rbrace;
+ ...
+</pre></example>
+
+<noindent></noindent>
+<para>&latex; will not erase any existing auxiliary files, so if you insert
+the <code>\nofiles</code> command after you have run the file and gotten
+a <file>.toc</file> then the table of contents page will continue to show
+the old information.
</para>
+</subsection>
</section>
-<node name="Indexes" spaces=" "><nodename>Indexes</nodename><nodeprev automatic="on">Glossaries</nodeprev><nodeup automatic="on">Front/back matter</nodeup></node>
+<node name="Indexes" spaces=" "><nodename>Indexes</nodename><nodenext automatic="on">Glossaries</nodenext><nodeprev automatic="on">Table of contents etc.</nodeprev><nodeup automatic="on">Front/back matter</nodeup></node>
<section spaces=" "><sectiontitle>Indexes</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="685">indexes</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="898">indexes</indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1022">\makeindex</indexterm></findex>
-<para>The command <code>\makeindex</code> enables creating indexes. Put this in
-the preamble.
+<findex index="fn" spaces=" "><indexterm index="fn" number="1036" mergedindex="cp">\makeindex</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1037" mergedindex="cp">\index</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="899"><file>.idx</file> file</indexterm></cindex>
+
+<para>This document has an index.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1023">\index</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="686"><file>.idx</file> file</indexterm></cindex>
-<para>The command <code>\index&lbrace;<var>text</var>&rbrace;</code> writes an index entry for
-<var>text</var> to an auxiliary file named with the <file>.idx</file> extension.
-</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1024">\indexentry</indexterm></findex>
-<para>Specifically, what gets written is the command
-<code>\indexentry&lbrace;<var>text</var>&rbrace;&lbrace;<var>pageno</var>&rbrace;</code>, where <var>pageno</var>
-is the current <code>\thepage</code> value.
-</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="687">&textlsquo;see&textrsquo; and &textlsquo;see also&textrsquo; index entries</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="688">index entries, &textlsquo;see&textrsquo; and &textlsquo;see also&textrsquo;</indexterm></cindex>
-<para>To generate a index entry for &textlsquo;bar&textrsquo; that says &textlsquo;See foo&textrsquo;, use a
-vertical bar: <code>\index&lbrace;bar|see&lbrace;foo&rbrace;&rbrace;</code>. Use <code>seealso</code>
-instead of <code>see</code> to make a &textlsquo;See also&textrsquo; entry.
-</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1025">\seename</indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1026">\alsoname</indexterm></findex>
-<para>The text &textlsquo;See&textrsquo; is defined by the macro <code>\seename</code>, and &textlsquo;See also&textrsquo;
-by the macro <code>\alsoname</code>. These can be redefined for other
-languages.
-</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="689"><command>makeindex</command> program</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="690"><command>xindy</command> program</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="691"><file>.ind</file> file</indexterm></cindex>
-<para>The generated <file>.idx</file> file is then sorted with an external
-command, usually either <command>makeindex</command>
-(<url><urefurl>http://mirror.ctan.org/indexing/makeindex</urefurl></url>) or (the
-multi-lingual) <command>xindy</command> (<url><urefurl>http://xindy.sourceforge.net</urefurl></url>).
-This results in a <file>.ind</file> file, which can then be read to typeset
-the index.
-</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1027">\printindex</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="692"><r>package</r>, <code>makeidx</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="693"><code>makeidx</code> <r>package</r></indexterm></cindex>
-
-<para>The index is usually generated with the <code>\printindex</code> command.
-This is defined in the <code>makeidx</code> package, so
-<code>\usepackage&lbrace;makeidx&rbrace;</code> needs to be in the preamble.
-</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1028">\indexspace</indexterm></findex>
-<para>The rubber length <code>\indexspace</code> is inserted before each new
-letter in the printed index; its default value is <samp>10pt plus5pt
-minus3pt</samp>.
-</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="694"><r>package</r>, <code>showidx</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="695"><code>showidx</code> <r>package</r></indexterm></cindex>
-
-<para>The <code>showidx</code> package causes each index entries to be shown in
-the margin on the page where the entry appears. This can help in
-preparing the index.
-</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="696"><r>package</r>, <code>multind</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="697"><code>multind</code> <r>package</r></indexterm></cindex>
-
-<para>The <code>multind</code> package supports multiple indexes. See also the
-&tex; FAQ entry on this topic,
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;article&rbrace;
+\usepackage&lbrace;makeidx&rbrace; \makeindex
+ ...
+\begin&lbrace;document&rbrace;
+ ...
+Recall Wilson's Theorem: \index&lbrace;Wilson's Theorem&rbrace;
+a number \( n&gt;1 \) is prime if and only if the factorial of \( n-1 \)
+is congruent to \( -1 \) modulo~\( n \).
+ ...
+\printindex
+ ...
+</pre></example>
+
+<noindent></noindent>
+<para>The <code>\usepackage&lbrace;makeidx&rbrace;</code> and <code>\makeindex</code> in the preamble
+bring in the relevant commands.
+</para>
+<para>Producing an index is a three stage process. First, in the document
+body you declare index entries with the <code>\index</code> command
+(<pxref label="_005cindex"><xrefnodename>\index</xrefnodename></pxref>). When you run &latex;, the <code>\index</code> writes its
+information to an auxiliary file <file><var>root-name</var>.idx</file>. Next, to
+alphabetize and to do other manipulations you run an external command,
+typically <command>makeindex</command> or <command>xindy</command> (<pxref label="makeindex"><xrefnodename>makeindex</xrefnodename></pxref>).
+These output a file <file><var>root-name</var>.ind</file>. Finally, you bring the
+information back into your document and typeset it with the
+<code>\printindex</code> command (<pxref label="_005cprintindex"><xrefnodename>\printindex</xrefnodename></pxref>).
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="900"><r>package</r>, <code>showidx</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="901"><code>showidx</code> <r>package</r></indexterm></cindex>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="902"><r>package</r>, <code>multind</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="903"><code>multind</code> <r>package</r></indexterm></cindex>
+
+<para>There are many packages that apply to indexing commands. The
+<code>showidx</code> package causes each index entries to be shown in the
+margin on the page where the entry appears. This can help in preparing
+the index. The <code>multind</code> package supports multiple indexes. See
+also the &tex; FAQ entry on this topic,
<url><urefurl>http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind</urefurl></url>.
</para>
+<menu endspaces=" ">
+<menuentry leadingtext="* "><menunode separator=":: ">\index</menunode><menudescription><pre xml:space="preserve">Declare an index entry.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">makeindex</menunode><menudescription><pre xml:space="preserve">Alphabetize index entries.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\printindex</menunode><menudescription><pre xml:space="preserve">Put the index here.
+</pre></menudescription></menuentry></menu>
+
+
+<node name="_005cindex" spaces=" "><nodename>\index</nodename><nodenext automatic="on">makeindex</nodenext><nodeup automatic="on">Indexes</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\index</code></sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="904">index entry</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1038" mergedindex="cp">\index</indexterm></findex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\index&lbrace;<var>index-entry-string</var>&rbrace;
+</pre></example>
+
+<para>Declare an entry in the index. This command is fragile
+(<pxref label="_005cprotect"><xrefnodename>\protect</xrefnodename></pxref>).
+</para>
+<para>For example, as described in <ref label="Indexes"><xrefnodename>Indexes</xrefnodename></ref>, one way to get an index from
+what&textrsquo;s below is to compile the document with <code>pdflatex test</code>, then
+process the index entries with <code>makeindex test</code>, and then compile
+again with <code>pdflatex test</code>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">W~Ackermann (1896--1962).\index&lbrace;Ackermann&rbrace;
+ ...
+Ackermann function\index&lbrace;Ackermann!function&rbrace;
+ ...
+rate of growth\index&lbrace;Ackermann!function!growth rate&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>All three index entries will get a page number, such as <samp>Ackermann,
+22</samp>. &latex; will format the second as a subitem of the first, on the
+line below it and indented, and the third as a subitem of the second.
+Three levels deep is as far as you can nest subentries. (If you add
+<code>\index&lbrace;Ackermann!function!growth rate!comparison&rbrace;</code> then
+<command>makeindex</command> says <samp>Scanning input file test.idx....done (4
+entries accepted, 1 rejected)</samp> and nothing appears in the index).
+</para>
+<para>If you enter a second <code>\index</code> with the same
+<var>index-entry-string</var> then you will get a single index entry with two
+page numbers (unless they happen to fall on the same page). Thus,
+adding <code>as for Ackermann.\index&lbrace;Ackermann&rbrace;</code> later in the same
+document as above will give an index entry like <samp>Ackermann, 22,
+151</samp>. Also, you can enter the index entries in any order, so for
+instance <code>\index&lbrace;Ackermann!function&rbrace;</code> could come before
+<code>\index&lbrace;Ackermann&rbrace;</code>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="905">index, page range</indexterm></cindex>
+<para>Get a page range in the output, like <samp>Hilbert, 23--27</samp>, as here.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">W~Ackermann (1896--1962).\index&lbrace;Ackermann&rbrace;
+ ...
+D~Hilbert (1862--1943)\index&lbrace;Ackermann!Hilbert\(&rbrace;
+ ...
+disapproved of his marriage.\index&lbrace;Ackermann!Hilbert\)&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>If the beginning and ending of the page range are equal then the system
+just gives a single page entry, not a range.
+</para>
+<para>If you index subentries but not a main entry, as with
+<code>\index&lbrace;Jones!program&rbrace;</code> and <code>\index&lbrace;Jones!results&rbrace;</code>, then
+the output is the item <samp>Jones</samp> with no comma or page number,
+followed by two subitems, like <samp>program, 50</samp> and <samp>results,
+51</samp>.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="906">&textlsquo;see&textrsquo; and &textlsquo;see also&textrsquo; index entries</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="907">index entries, &textlsquo;see&textrsquo; and &textlsquo;see also&textrsquo;</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1039" mergedindex="cp">\seename</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1040" mergedindex="cp">\alsoname</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="908"><r>package</r>, <code>babel</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="909"><code>babel</code> <r>package</r></indexterm></cindex>
+ <cindex index="cp" spaces=" "><indexterm index="cp" number="910"><r>package</r>, <code>polyglossia</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="911"><code>polyglossia</code> <r>package</r></indexterm></cindex>
+
+
+<para>Generate a index entry that says <samp>See</samp> by using a vertical bar
+character: <code>\index&lbrace;Ackermann!function|see&lbrace;P\'eter's
+function&rbrace;&rbrace;</code>. You can instead get <samp>See also</samp> with <code>seealso</code>.
+(The text <samp>See</samp> is defined by <code>\seename</code>, and <samp>See also</samp>
+by <code>\alsoname</code>. You can redefine these either by using an
+internationalization package such as <file>babel</file> or <file>polyglossia</file>,
+or directly as with <code>\renewcommand&lbrace;\alsoname&rbrace;[1]&lbrace;Also see
+#1&rbrace;</code>.)
+</para>
+<para>The <samp>See</samp> feature is part of a more general functionality. After
+the vertical bar you can put the name of a one-input command, as in
+<code>\index&lbrace;group|textit&rbrace;</code> (note the missing backslash on the
+<code>\textit</code> command) and the system will apply that command to the
+page number, here giving something like <code>\textit&lbrace;7&rbrace;</code>. You can
+define your own one-input commands, such as
+<code>\newcommand&lbrace;\definedpage&rbrace;[1]&lbrace;&lbrace;\color&lbrace;blue&rbrace;#1&rbrace;&rbrace;</code> and then
+<code>\index&lbrace;Ackermann!function|definedpage&rbrace;</code> will give a blue page
+number (<pxref label="Color"><xrefnodename>Color</xrefnodename></pxref>). Another, less practical, example is this,
+</para>
+<!-- c credit Ian Thompson https://tex.stackexchange.com/a/272572/121234 -->
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand\indexownpage[1]&lbrace;#1, \thepage&rbrace;
+ ... Epimenides.\index&lbrace;self-reference|indexownpage&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>which creates an entry citing the page number of its own index listing.
+</para>
+<para>The two functions just described combine, as here
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\index&lbrace;Ackermann!function|(definedpage&rbrace;
+ ...
+\index&lbrace;Ackermann!function|)&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>which outputs an index entry like <samp>function, 23--27</samp> where the page
+number range is in blue.
+</para>
+<para>Consider an index entry such as <samp><U>03B1</U>-ring</samp>. Entering
+it as <code>$\alpha$-ring</code> will cause it to be alphabetized according to
+the dollar sign. You can instead enter it using an at-sign, as
+<code>\index&lbrace;alpha-ring&arobase;$\alpha$-ring&rbrace;</code>. If you specify an entry
+with an at-sign separating two strings, <code><var>pos</var>&arobase;<var>text</var></code>,
+then <var>pos</var> gives the alphabetical position of the entry while
+<var>text</var> produces the text of the entry. Another example is that
+<code>\index&lbrace;Saint Michael's College&arobase;SMC&rbrace;</code> produces an index entry
+<samp>SMC</samp> alphabetized into a different location than its spelling
+would naturally give it.
+</para>
+<para>To put a <code>!</code>, or <code>&arobase;</code>, or <code>|</code> character in an index
+entry, preceding it with a double quote, <code>&quot;</code>. (The double quote
+gets deleted before alphabetization.)
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="912"><r>package</r>, <code>index</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="913"><code>index</code> <r>package</r></indexterm></cindex>
+
+<para>A number of packages on CTAN have additional functionality beyond that
+provided by <file>makeidx</file>. One is <file>index</file>, which allows for
+multiple indices and contains a command
+<code>\index*&lbrace;<var>index-entry-string</var>&rbrace;</code> that prints the
+<var>index-entry-string</var> as well as indexing it.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1041" mergedindex="cp">\indexentry</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="914">idx file</indexterm></cindex>
+<para>The <code>\index</code> command writes the indexing information to the file
+<file><var>root-name</var>.idx</file> file. Specifically, it writes text of the
+command
+<code>\indexentry&lbrace;<var>index-entry-string</var>&rbrace;&lbrace;<var>page-num</var>&rbrace;</code>, where
+where <var>page-num</var> is the value of the <code>\thepage</code> counter. On
+occasion, when the <code>\printindex</code> command is confused, you have to
+delete this file to start with a fresh slate.
+</para>
+<para>If you omit the closing brace of an <code>\index</code> command then you get a
+message like this.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">Runaway argument? &lbrace;Ackermann!function
+! Paragraph ended before \&arobase;wrindex was complete.
+</pre></example>
+
+
+</subsection>
+<node name="makeindex" spaces=" "><nodename>makeindex</nodename><nodenext automatic="on">\printindex</nodenext><nodeprev automatic="on">\index</nodeprev><nodeup automatic="on">Indexes</nodeup></node>
+<subsection spaces=" "><sectiontitle><command>makeindex</command></sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="915">index, processing</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1042" mergedindex="cp">makeindex</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="916"><command>makeindex</command> program</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="917"><file>.ind</file> file</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="918"><file>.idx</file> file</indexterm></cindex>
+
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">makeindex <var>filename</var>
+makeindex -s <var>style-file</var> <var>filename</var>
+makeindex <var>options</var> <var>filename0</var> ...
+</pre></example>
+
+<para>Sort, and otherwise process, the index information in the auxiliary file
+<var>filename</var>. This is a command line program. It takes one or more
+raw index files, <file><var>filename</var>.idx</file> files, and produces the
+actual index file, the <file><var>filename</var>.ind</file> file that is input by
+<code>\printindex</code> (<pxref label="_005cprintindex"><xrefnodename>\printindex</xrefnodename></pxref>).
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="919"><file>.isty</file> file</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1043" mergedindex="cp">index, style file</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1044" mergedindex="cp">makeindex, style file</indexterm></findex>
+<para>The first form of the command suffices for many uses. The second allows
+you to format the index by using an <dfn>index style file</dfn>, a
+<file>.isty</file> file. The third form is the most general; see the full
+documentation on CTAN.
+</para>
+<para>This is a simple <file>.isty</file> file.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">% book.isty
+% $ makeindex -s book.isty -p odd book.idx
+% creates the index as book.ind, starting on an odd page.
+preamble
+&quot;\\pagestyle&lbrace;empty&rbrace;
+\\small
+\\begin&lbrace;theindex&rbrace;
+\\thispagestyle&lbrace;empty&rbrace;&quot;
+
+postamble
+&quot;\n
+\\end&lbrace;theindex&rbrace;&quot;
+</pre></example>
+
+<para>The description here covers only some of the index formatting
+possibilities in <var>style-file</var>. For a full list see the documentation
+on CTAN.
+</para>
+<para>A style file consists of a list of pairs: <var>specifier</var> and
+<var>attribute</var>. These can appear in the file in any order. All of the
+<var>attributes</var> are strings, except where noted. Strings are
+surrounded with double quotes, <code>&quot;</code>, and the maximum length of a
+string is 144 characters. The <code>\n</code> is for a newline and <code>\t</code>
+is for a tab. Backslashes are escaped with another backslash,
+<code>\\</code>. If a line begins with a percent sign, <code>%</code>, then it is a
+comment.
+</para>
+<ftable commandarg="code" spaces=" " endspaces=" ">
+<beforefirstitem><anchor name="makeindex-preamble">makeindex preamble</anchor>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1045" mergedindex="cp">preamble</indexterm>preamble</itemformat></item>
+</tableterm><tableitem><para>Preamble of the output file. Defines the context in which the index is
+formatted. Default: <code>&quot;\\begin&lbrace;theindex&rbrace;\n&quot;</code>.
+</para>
+<anchor name="makeindex-postamble">makeindex postamble</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1046" mergedindex="cp">postamble</indexterm>postamble</itemformat></item>
+</tableterm><tableitem><para>Postamble of the output file. Default: <code>&quot;\n\n\\end&lbrace;theindex&rbrace;\n&quot;</code>.
+</para>
+<anchor name="makeindex-group-skip">makeindex group skip</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1047" mergedindex="cp">group_skip</indexterm>group_skip</itemformat></item>
+</tableterm><tableitem><findex index="fn" spaces=" "><indexterm index="fn" number="1048" mergedindex="cp">\indexspace</indexterm></findex>
+<para>Traditionally index items are broken into groups, typically a group for
+entries starting with <samp>a</samp>, etc. This specifier gives what is
+inserted when a new group begins. Default: <code>&quot;\n\n \\indexspace\n&quot;</code>
+(<code>\indexspace</code> is a rubber length with default value <code>10pt
+plus5pt minus3pt</code>).
+</para>
+<anchor name="makeindex-letheadflag">makeindex letheadflag</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1049" mergedindex="cp">lethead_flag</indexterm>lethead_flag</itemformat></item>
+</tableterm><tableitem><para>An integer. It governs what is inserted for a new group or letter. If
+it is 0 (which is the default) then other than <code>group_skip</code> nothing
+will be inserted before the group. If it is is positive then at a new
+letter the <code>lethead_prefix</code> and <code>lethead_suffix</code> will be
+inserted, with that letter in uppercase between them. If it is negative
+then what will be inserted is the letter in lowercase. The default
+is&nbsp;0.
+</para>
+<anchor name="makeindex-lethead-prefix">makeindex lethead prefix</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1050" mergedindex="cp">lethead_prefix</indexterm>lethead_prefix</itemformat></item>
+</tableterm><tableitem><para>If a new group begins with a different letter then this is the prefix
+inserted before the new letter header. Default: <code>&quot;&quot;</code>
+</para>
+<anchor name="makeindex-lethead-suffix">makeindex lethead suffix</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1051" mergedindex="cp">lethead_suffix</indexterm>lethead_suffix</itemformat></item>
+</tableterm><tableitem><para>If a group begins with a different letter then this is the suffix
+inserted after the new letter header. Default: <code>&quot;&quot;</code>.
+</para>
+<anchor name="makeindex-item-0">makeindex item 0</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1052" mergedindex="cp">item_0</indexterm>item_0 </itemformat></item>
+</tableterm><tableitem><para>What is put between two level&nbsp;0 items. Default: <code>&quot;\n \\item
+&quot;</code>.
+</para>
+<anchor name="makeindex-item-1">makeindex item 1</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1053" mergedindex="cp">item_1</indexterm>item_1</itemformat></item>
+</tableterm><tableitem><para>Put between two level&nbsp;1 items. Default: <code>&quot;\n \\subitem &quot;</code>.
+</para>
+<anchor name="makeindex-item-2">makeindex item 2</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1054" mergedindex="cp">item_2</indexterm>item_2</itemformat></item>
+</tableterm><tableitem><para>put between two level&nbsp;2 items. Default: <code>&quot;\n \\subsubitem &quot;</code>.
+</para>
+<anchor name="makeindex-item-01">makeindex item 01</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1055" mergedindex="cp">item_01</indexterm>item_01</itemformat></item>
+</tableterm><tableitem><para>What is put between a level&nbsp;0 item and a level&nbsp;1 item.
+Default: <code>&quot;\n \\subitem &quot;</code>.
+</para>
+<anchor name="makeindex-item-x1">makeindex item x1</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1056" mergedindex="cp">item_x1</indexterm>item_x1</itemformat></item>
+</tableterm><tableitem><para>What is put between a level&nbsp;0 item and a level&nbsp;1 item in the
+case that the level&nbsp;0 item doesn&textrsquo;t have any page numbers (as in
+<code>\index&lbrace;aaa|see&lbrace;bbb&rbrace;&rbrace;</code>). Default: <code>&quot;\n \\subitem &quot;</code>.
+</para>
+<anchor name="makeindex-item-12">makeindex item 12</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1057" mergedindex="cp">item_12</indexterm>item_12</itemformat></item>
+</tableterm><tableitem><para>What is put between a level&nbsp;1 item and a level&nbsp;2 item.
+Default: <code>&quot;\n \\subsubitem &quot;</code>.
+</para>
+<anchor name="makeindex-item-x2">makeindex item x2</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1058" mergedindex="cp">item_x2</indexterm>item_x2</itemformat></item>
+</tableterm><tableitem><para>What is put between a level&nbsp;1 item and a level&nbsp;2 item, if the
+level&nbsp;1 item doesn&textrsquo;t have page numbers. Default: <code>&quot;\n
+\\subsubitem &quot;</code>.
+</para>
+<anchor name="makeindex-delim-0">makeindex delim 0</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1059" mergedindex="cp">delim_0</indexterm>delim_0</itemformat></item>
+</tableterm><tableitem><para>Delimiter put between a level&nbsp;0 key and its first page
+number. Default: a comma followed by a blank, <code>&quot;, &quot;</code>.
+</para>
+<anchor name="makeindex-delim-1">makeindex delim 1</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1060" mergedindex="cp">delim_1</indexterm>delim_1</itemformat></item>
+</tableterm><tableitem><para>Delimiter put between a level&nbsp;1 key and its first page
+number. Default: a comma followed by a blank, <code>&quot;, &quot;</code>.
+</para>
+<anchor name="makeindex-delim-2">makeindex delim 2</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1061" mergedindex="cp">delim_2</indexterm>delim_2</itemformat></item>
+</tableterm><tableitem><para>Delimiter between a level&nbsp;2 key and its first page number. Default:
+a comma followed by a blank, <code>&quot;, &quot;</code>.
+</para>
+<anchor name="makeindex-delim-n">makeindex delim n</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1062" mergedindex="cp">delim_n</indexterm>delim_n</itemformat></item>
+</tableterm><tableitem><para>Delimiter between two page numbers for the same key (at any
+level). Default: a comma followed by a blank, <code>&quot;, &quot;</code>.
+</para>
+<anchor name="makeindex-delim-r">makeindex delim r</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1063" mergedindex="cp">delim_r</indexterm>delim_r</itemformat></item>
+</tableterm><tableitem><para>What is put between the starting and ending page numbers of a range.
+Default: <code>&quot;--&quot;</code>.
+</para>
+<anchor name="makeindex-line-max">makeindex line max</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1064" mergedindex="cp">line_max</indexterm>line_max</itemformat></item>
+</tableterm><tableitem><para>An integer. Maximum length of an index entry&textrsquo;s line in the output,
+beyond which the line wraps. Default: <code>72</code>.
+</para>
+<anchor name="makeindex-indent-space">makeindex indent space</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1065" mergedindex="cp">indent_space</indexterm>indent_space</itemformat></item>
+</tableterm><tableitem><para>What is inserted at the start of a wrapped line. Default:
+<code>&quot;\t\t&quot;</code>.
+</para>
+<anchor name="makeindex-indent-length">makeindex indent length</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1066" mergedindex="cp">indent_length</indexterm>indent_length</itemformat></item>
+</tableterm><tableitem><para>A number. The length of the wrapped line indentation. The default
+<code>indent_space</code> is two tabs and each tab is eight spaces so the
+default here is <code>16</code>.
+</para>
+<anchor name="makeindex-page-precedence">makeindex page precedence</anchor>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1067" mergedindex="cp">page_precedence</indexterm>page_precedence</itemformat></item>
+</tableterm><tableitem><para>A document may have pages numbered in different ways. For example, a
+book may have front matter pages numbered in lowercase roman while main
+matter pages are in arabic. This string specifies the order in which
+they will appear in the index. The <command>makeindex</command> command supports
+five different types of numerals: lowercase roman <code>r</code>, and numeric
+or arabic <code>n</code>, and lowercase alphabetic <code>a</code>, and uppercase
+roman <code>R</code>, and uppercase alphabetic <code>A</code>. Default:
+<code>&quot;rnaRA&quot;</code>.
+</para>
+</tableitem></tableentry></ftable>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="1068" mergedindex="cp">xindy</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="920"><command>xindy</command> program</indexterm></cindex>
+<para>There are a number of other programs that do the job <command>makeindex</command>
+does. One is <command>xindy</command>, which does internationalization and can
+process indexes for documents marked up using &latex; and a number of
+other languages. It is is highly configurable, both in markup terms and
+in terms of the collating order of the text. See the documentation on
+CTAN.
+</para>
+
+</subsection>
+<node name="_005cprintindex" spaces=" "><nodename>\printindex</nodename><nodeprev automatic="on">makeindex</nodeprev><nodeup automatic="on">Indexes</nodeup></node>
+<subsection spaces=" "><sectiontitle><command>\printindex</command></sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="921">index, printing</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1069" mergedindex="cp">\printindex</indexterm></findex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\printindex
+</pre></example>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1070" mergedindex="cp">\printindex</indexterm></findex>
+<para>Place the index into the output.
+</para>
+<para>To get an index you must first include
+<code>\usepackage&lbrace;makeidx&rbrace;\makeindex</code> in the document preamble and
+compile the document, then run the system command <command>makeindex</command>,
+and then compile the document again. <xref label="Indexes"><xrefnodename>Indexes</xrefnodename></xref> for further
+discussion and an example of the use of <code>\printindex</code>.
+</para>
+
+</subsection>
+</section>
+<node name="Glossaries" spaces=" "><nodename>Glossaries</nodename><nodeprev automatic="on">Indexes</nodeprev><nodeup automatic="on">Front/back matter</nodeup></node>
+<section spaces=" "><sectiontitle>Glossaries</sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="922">glossary</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="923">glossaries</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="924">acronyms, list of</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1071" mergedindex="cp">\makeglossary</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1072" mergedindex="cp">\printglossaries</indexterm></findex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\usepackage&lbrace;glossaries&rbrace; \makeglossaries
+ ...
+\newglossaryentry&lbrace;<var>label</var>&rbrace;&lbrace;<var>settings</var>&rbrace;
+ ...
+\gls&lbrace;<var>label</var>&rbrace;.
+ ...
+\printglossaries
+</pre></example>
+
+<para>The <file>glossaries</file> package allows you to make glossaries, including
+multiple glossaries, as well as lists of acronyms.
+</para>
+<para>To get the output from this example, compile the document (for instance
+with <code>pdflatex filename</code>), then run the command line command
+<code>makeglossaries filename</code>, and then compile the document again.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;...&rbrace;
+\usepackage&lbrace;glossaries&rbrace; \makeglossaries
+\newglossaryentry&lbrace;tm&rbrace;&lbrace;%
+ name=&lbrace;Turing machine&rbrace;,
+ description=&lbrace;A model of a machine that computes. The model is simple
+ but can compute anything any existing device can compute.
+ It is the standard model used in Computer Science.&rbrace;,
+ &rbrace;
+\begin&lbrace;document&rbrace;
+Everything begins with the definition of a \gls&lbrace;tm&rbrace;.
+ ...
+\printglossaries
+\end&lbrace;document&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>That gives two things. In the main text it outputs <samp>... definition
+of a Turing machine</samp>. In addition, in a separate sectional unit headed
+<samp>Glossary</samp> there appears a description list. In boldface it says
+<samp>Turing machine</samp> and the rest of the item says in normal type
+<samp>A model of a machine &dots; Computer Science</samp>.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1073" mergedindex="cp">\makeglossary</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1074" mergedindex="cp">\printglossaries</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="925"><file>.glo</file> file</indexterm></cindex>
+<para>The command <code>\makeglossary</code> opens the file that will contain the
+entry information, <file><var>root-file</var>.glo</file>. Put the
+<code>\printglossaries</code> command where you want the glossaries to appear
+in your document.
+</para>
+<para>The <file>glossaries</file> package is very powerful. For instance, besides
+the commands <code>\newglossaryentry</code> and <code>\gls</code>, there are similar
+commands for a list of acronyms. See the package documentations on
+CTAN.
+</para>
+<menu endspaces=" ">
+<menuentry leadingtext="* "><menunode separator=":: ">\newglossaryentry</menunode><menudescription><pre xml:space="preserve">Declare the content of a glossary entry.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\gls</menunode><menudescription><pre xml:space="preserve">Give a page reference for a glossary entry.
+</pre></menudescription></menuentry></menu>
+
+
+<node name="_005cnewglossaryentry" spaces=" "><nodename>\newglossaryentry</nodename><nodenext automatic="on">\gls</nodenext><nodeup automatic="on">Glossaries</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\newglossaryentry</code></sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="926">glossary, entries</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1075" mergedindex="cp">\newglossaryentry</indexterm></findex>
+
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newglossaryentry&lbrace;<var>label</var>&rbrace;
+&lbrace;
+ name=&lbrace;<var>name</var>&rbrace;,
+ description=&lbrace;<var>description</var>&rbrace;,
+ <var>other options</var>, ...
+&rbrace;
+</pre></example>
+
+<para>or
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\longnewglossaryentry&lbrace;<var>label</var>&rbrace;
+&lbrace;
+ name=&lbrace;<var>name</var>&rbrace;,
+ <var>other options</var> ...,
+&rbrace;
+&lbrace;<var>description</var>&rbrace;
+</pre></example>
+
+<para>Declare a new entry for a glossary. The <var>label</var> must be unique for
+the document. The settings associated with the label are pairs:
+<code><var>key</var>=<var>value</var></code>.
+</para>
+<para>This puts the blackboard bold symbol for the real numbers <U>211D</U> in the
+glossary.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newglossaryentry&lbrace;R&rbrace;
+&lbrace;
+ name=&lbrace;\ensuremath&lbrace;\mathbb&lbrace;R&rbrace;&rbrace;&rbrace;,
+ description=&lbrace;the real numbers&rbrace;,
+&rbrace;
+</pre></example>
+
+<para>Use the second command form if the <var>description</var> spans more than one
+paragraph.
+</para>
+<para>For a full list of <var>key</var>s see the package documentation on CTAN but
+here are a few.
+</para>
+<ftable commandarg="code" spaces=" " endspaces=" ">
+<tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1076" mergedindex="cp">name</indexterm>name</itemformat></item>
+</tableterm><tableitem><para>(Required.) The word, phrase, or symbol that you are defining.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1077" mergedindex="cp">description</indexterm>description</itemformat></item>
+</tableterm><tableitem><para>(Required.) The description that will appear in the glossary.
+If this has more than one paragraph then you must use the second command
+form given in the synopsis.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1078" mergedindex="cp">plural</indexterm>plural</itemformat></item>
+</tableterm><tableitem><para>The plural form of <var>name</var>. Refer to the plural form using
+<code>\glspl</code> or <code>\Glspl</code> (<pxref label="_005cgls"><xrefnodename>\gls</xrefnodename></pxref>).
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1079" mergedindex="cp">sort</indexterm>sort</itemformat></item>
+</tableterm><tableitem><para>How to place this entry in the list of entries that the glossary holds.
+</para>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code"><indexterm index="fn" number="1080" mergedindex="cp">symbol</indexterm>symbol</itemformat></item>
+</tableterm><tableitem><para>A symbol, such as a mathematical symbol, besides the name.
+</para>
+</tableitem></tableentry></ftable>
+
+
+</subsection>
+<node name="_005cgls" spaces=" "><nodename>\gls</nodename><nodeprev automatic="on">\newglossaryentry</nodeprev><nodeup automatic="on">Glossaries</nodeup></node>
+<subsection spaces=" "><sectiontitle><code>\gls</code></sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="927">glossary, entry reference</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1081" mergedindex="cp">\gls</indexterm></findex>
+
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\gls&lbrace;<var>label</var>&rbrace;
+\glspl&lbrace;<var>label</var>&rbrace;
+\Gls&lbrace;<var>label</var>&rbrace;
+\Glspl&lbrace;<var>label</var>&rbrace;
+</pre></example>
+
+<para>Refer to a glossary entry. The entries are declared with
+<code>\newglossaryentry</code> (<pxref label="_005cnewglossaryentry"><xrefnodename>\newglossaryentry</xrefnodename></pxref>).
+</para>
+<para>This
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newglossaryentry&lbrace;N&rbrace;&lbrace;%
+ name=&lbrace;the natural numbers&rbrace;,
+ description=&lbrace;The numbers $0$, $1$, $2$, $\ldots$\&arobase;&rbrace;,
+ symbol=&lbrace;\ensuremath&lbrace;\mathbb&lbrace;N&rbrace;&rbrace;&rbrace;,
+ &rbrace;
+ ...
+Consider \gls&lbrace;N&rbrace;.
+</pre></example>
+
+<noindent></noindent>
+<para>gives the output <samp>Consider the natural numbers</samp>.
+</para>
+<para>The second command form <code>\glspl&lbrace;<var>label</var>&rbrace;</code> produces the plural
+of <var>name</var> (by default it tries adding an <samp>s</samp>). The third form
+capitalizes the first letter of <var>name</var>, as does the fourth form,
+which also takes the plural.
+</para>
+
+</subsection>
</section>
</chapter>
<node name="Letters" spaces=" "><nodename>Letters</nodename><nodenext automatic="on">Terminal input/output</nodenext><nodeprev automatic="on">Front/back matter</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Letters</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="698">letters, writing</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="699">writing letters</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="928">letters, writing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="929">writing letters</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\documentclass&lbrace;letter&rbrace;
-\address&lbrace;<var>sender address</var>&rbrace;
+\address&lbrace;<var>senders address</var>&rbrace; % return address
\signature&lbrace;<var>sender name</var>&rbrace;
\begin&lbrace;document&rbrace;
\begin&lbrace;letter&rbrace;&lbrace;<var>recipient address</var>&rbrace;
@@ -12730,7 +18121,7 @@ preparing the index.
<var>letter body</var>
\closing&lbrace;<var>closing text</var>&rbrace;
\end&lbrace;letter&rbrace;
-... more letters ...
+ ...
\end&lbrace;document&rbrace;
</pre></example>
@@ -12738,12 +18129,11 @@ preparing the index.
</para>
<para>Each letter is in a separate <code>letter</code> environment, whose argument
<var>recipient address</var> often contains multiple lines separated with a
-double backslash&nbsp;(<code>\\</code>). For example, you might have:
+double backslash,&nbsp;(<code>\\</code>). For example, you might have:
</para>
<example endspaces=" ">
-<pre xml:space="preserve"> \begin&lbrace;letter&rbrace;&lbrace;Mr. Joe Smith \\
- 2345 Princess St. \\
- Edinburgh, EH1 1AA&rbrace;
+<pre xml:space="preserve"> \begin&lbrace;letter&rbrace;&lbrace;Ninon de l'Enclos \\
+ l'h\^otel Sagonne&rbrace;
...
\end&lbrace;letter&rbrace;
</pre></example>
@@ -12757,29 +18147,29 @@ preamble. As with the recipient address, often <var>sender address</var>
contains multiple lines separated by a double
backslash&nbsp;(<code>\\</code>). &latex; will put the <var>sender name</var>
under the closing, after a vertical space for the traditional
-hand-written signature; it also can contain multiple lines.
+hand-written signature.
</para>
-<para>Each <code>letter</code> environment body begins with a required <code>\opening</code> command
-such as <code>\opening&lbrace;Dear Madam or Sir:&rbrace;</code>. The <var>letter body</var>
-text is ordinary &latex; so it can contain everything from
-enumerated lists to displayed math, except that commands such as
-<code>\chapter</code> that make no sense in a letter are turned off. Each
-<code>letter</code> environment body typically ends with a <code>\closing</code>
-command such as <code>\closing&lbrace;Yours,&rbrace;</code>.
+<para>Each <code>letter</code> environment body begins with a required
+<code>\opening</code> command such as <code>\opening&lbrace;Dear Madam or Sir:&rbrace;</code>.
+The <var>letter body</var> text is ordinary &latex; so it can contain
+everything from enumerated lists to displayed math, except that commands
+such as <code>\chapter</code> that make no sense in a letter are turned off.
+Each <code>letter</code> environment body typically ends with a
+<code>\closing</code> command such as <code>\closing&lbrace;Yours,&rbrace;</code>.
</para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1029">\\ <r>for letters</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1082" mergedindex="cp">\\ <r>for letters</r></indexterm></findex>
<para>Additional material may come after the <code>\closing</code>. You can say who
is receiving a copy of the letter with a command like <code>\cc&lbrace;the
Boss \\ the Boss's Boss&rbrace;</code>. There&textrsquo;s a similar <code>\encl</code> command for
a list of enclosures. And, you can add a postscript with <code>\ps</code>.
</para>
-<para>&latex;&textrsquo;s default is to indent the signature and the <code>\closing</code>
-above it by a length of <code>\longindentation</code>. By default this is
+<para>&latex;&textrsquo;s default is to indent the sender name and the closing above it
+by a length of <code>\longindentation</code>. By default this is
<code>0.5\textwidth</code>. To make them flush left, put
<code>\setlength&lbrace;\longindentation&rbrace;&lbrace;0em&rbrace;</code> in your preamble.
</para>
<para>To set a fixed date use something like
-<code>\renewcommand&lbrace;\today&rbrace;&lbrace;2015-Oct-12&rbrace;</code>. If put in your preamble
+<code>\renewcommand&lbrace;\today&rbrace;&lbrace;1958-Oct-12&rbrace;</code>. If put in your preamble
then it will apply to all the letters.
</para>
<para>This example shows only one <code>letter</code> environment. The three lines
@@ -12814,7 +18204,6 @@ I am not interested in entering a business arrangement with you.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\opening</menunode><menudescription><pre xml:space="preserve">Saying hello.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\ps</menunode><menudescription><pre xml:space="preserve">Adding a postscript.
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\signature</menunode><menudescription><pre xml:space="preserve">Sender&textrsquo;s signature.
-<!-- c ?Not user-level? * \stopbreaks and \startbreaks:: Disallow and allow page breaks. -->
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">\telephone</menunode><menudescription><pre xml:space="preserve">Sender&textrsquo;s phone number.
</pre></menudescription></menuentry></menu>
@@ -12822,7 +18211,7 @@ I am not interested in entering a business arrangement with you.
<node name="_005caddress" spaces=" "><nodename>\address</nodename><nodenext automatic="on">\cc</nodenext><nodeup automatic="on">Letters</nodeup></node>
<section spaces=" "><sectiontitle><code>\address</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1030">\address</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1083" mergedindex="cp">\address</indexterm></findex>
<para>Synopsis:
</para>
@@ -12830,19 +18219,18 @@ I am not interested in entering a business arrangement with you.
<pre xml:space="preserve">\address&lbrace;<var>senders address</var>&rbrace;
</pre></example>
-<para>Specifies the return address as it appears on the letter and on the
+<para>Specify the return address, as it appears on the letter and on the
envelope. Separate multiple lines in <var>senders address</var> with a
-double backslash&nbsp;<code>\\</code>.
+double backslash,&nbsp;<code>\\</code>.
</para>
<para>Because it can apply to multiple letters this declaration is often put
in the preamble. However, it can go anywhere, including inside an
individual <code>letter</code> environment.
</para>
-<para>This command is optional: without the <code>\address</code> declaration the
-letter is formatted with some blank space on top, for copying onto
-pre-printed letterhead paper. (<xref label="Overview"><xrefnodename>Overview</xrefnodename></xref>, for details on your
-local implementation.) With the <code>\address</code> declaration, it is
-formatted as a personal letter.
+<para>This command is optional: if you do not use it then the letter is
+formatted with some blank space on top, for copying onto pre-printed
+letterhead paper. If you do use the <code>\address</code> declaration then it
+is formatted as a personal letter.
</para>
<para>Here is an example.
</para>
@@ -12856,20 +18244,20 @@ formatted as a personal letter.
<node name="_005ccc" spaces=" "><nodename>\cc</nodename><nodenext automatic="on">\closing</nodenext><nodeprev automatic="on">\address</nodeprev><nodeup automatic="on">Letters</nodeup></node>
<section spaces=" "><sectiontitle><code>\cc</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1031">\cc</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="700">cc list, in letters</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1084" mergedindex="cp">\cc</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="930">cc list, in letters</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\cc&lbrace;<var>first name</var> \\
+<pre xml:space="preserve">\cc&lbrace;<var>name0</var> \\
... &rbrace;
</pre></example>
<para>Produce a list of names to which copies of the letter were sent. This
command is optional. If it appears then typically it comes after
-<code>\closing</code>. Separate multiple lines with a double
-backslash&nbsp;<code>\\</code>, as in:
+<code>\closing</code>. Put the names on different lines by separating them
+with a double backslash, <code>\\</code>, as in:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\cc&lbrace;President \\
@@ -12881,9 +18269,9 @@ backslash&nbsp;<code>\\</code>, as in:
<node name="_005cclosing" spaces=" "><nodename>\closing</nodename><nodenext automatic="on">\encl</nodenext><nodeprev automatic="on">\cc</nodeprev><nodeup automatic="on">Letters</nodeup></node>
<section spaces=" "><sectiontitle><code>\closing</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1032">\closing</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="701">letters, ending</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="702">closing letters</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1085" mergedindex="cp">\closing</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="931">letters, ending</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="932">closing letters</indexterm></cindex>
<para>Synopsis:
</para>
@@ -12891,8 +18279,8 @@ backslash&nbsp;<code>\\</code>, as in:
<pre xml:space="preserve">\closing&lbrace;<var>text</var>&rbrace;
</pre></example>
-<para>Usually at the end of a letter, above the handwritten signature, there
-is a <code>\closing</code> (although this command is optional). For example,
+<para>Produce the letter&textrsquo;s closing. This is optional, but usual. It appears
+at the end of a letter, above a handwritten signature. For example:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\closing&lbrace;Regards,&rbrace;
@@ -12903,8 +18291,8 @@ is a <code>\closing</code> (although this command is optional). For example,
<node name="_005cencl" spaces=" "><nodename>\encl</nodename><nodenext automatic="on">\location</nodenext><nodeprev automatic="on">\closing</nodeprev><nodeup automatic="on">Letters</nodeup></node>
<section spaces=" "><sectiontitle><code>\encl</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1033">\encl</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="703">enclosure list</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1086" mergedindex="cp">\encl</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="933">enclosure list</indexterm></cindex>
<para>Synopsis:
</para>
@@ -12915,11 +18303,11 @@ is a <code>\closing</code> (although this command is optional). For example,
<para>Produce a list of things included with the letter. This command is
optional; when it is used, it typically is put after <code>\closing</code>.
-Separate multiple lines with a double backslash&nbsp;<code>\\</code>.
+Separate multiple lines with a double backslash, <code>\\</code>.
</para>
<example endspaces=" ">
<pre xml:space="preserve">\encl&lbrace;License \\
- Passport &rbrace;
+ Passport&rbrace;
</pre></example>
@@ -12927,7 +18315,7 @@ Separate multiple lines with a double backslash&nbsp;<code>\\</code>.
<node name="_005clocation" spaces=" "><nodename>\location</nodename><nodenext automatic="on">\makelabels</nodenext><nodeprev automatic="on">\encl</nodeprev><nodeup automatic="on">Letters</nodeup></node>
<section spaces=" "><sectiontitle><code>\location</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1034">\location</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1087" mergedindex="cp">\location</indexterm></findex>
<para>Synopsis:
</para>
@@ -12935,7 +18323,7 @@ Separate multiple lines with a double backslash&nbsp;<code>\\</code>.
<pre xml:space="preserve">\location&lbrace;<var>text</var>&rbrace;
</pre></example>
-<para>The <var>text</var> appears centered at the bottom of the each page. It only
+<para>The <var>text</var> appears centered at the bottom of the page. It only
appears if the page style is <code>firstpage</code>.
</para>
@@ -12943,37 +18331,77 @@ appears if the page style is <code>firstpage</code>.
<node name="_005cmakelabels" spaces=" "><nodename>\makelabels</nodename><nodenext automatic="on">\name</nodenext><nodeprev automatic="on">\location</nodeprev><nodeup automatic="on">Letters</nodeup></node>
<section spaces=" "><sectiontitle><code>\makelabels</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1035">\makelabels</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1088" mergedindex="cp">\makelabels</indexterm></findex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\makelabels
+<pre xml:space="preserve">\makelabels % in preamble
</pre></example>
-<para>Create a sheet of address labels from the recipient addresses, one for
-each letter. This sheet will be output before the letters, with the idea
-that you can copy it to a sheet of peel-off labels. This command goes
-in the preamble.
+<para>Optional, for a document that contains <code>letter</code> environments. If
+you just put <code>\makelabels</code> in the preamble then at the end of the
+document you will get a sheet with labels for all the recipients, one
+for each letter environment, that you can copy to a sheet of peel-off
+address labels.
</para>
<para>Customize the labels by redefining the commands <code>\startlabels</code>,
-<code>\mlabel</code>, and <code>\returnaddress</code> in the preamble. The command
-<code>\startlabels</code> sets the width, height, number of columns, etc., of
-the page onto which the labels are printed. The command
-<code>\mlabel&lbrace;<var>sender address</var>&rbrace;&lbrace;<var>recipient address</var>&rbrace;</code>
-produces the two labels (or one, if you choose to ignore the <var>sender
-address</var>). The <var>sender address</var> is the value returned by the macro
-<code>\returnaddress</code> while <var>recipient address</var> is the value passed
-in the argument to the <code>letter</code> environment. By default
-<code>\mlabel</code> ignores the first argument, the <var>sender address</var>.
+<code>\mlabel</code>, and <code>\returnaddress</code> (and perhaps <code>\name</code>) in
+the preamble. The command <code>\startlabels</code> sets the width, height,
+number of columns, etc., of the page onto which the labels are printed.
+The command <code>\mlabel&lbrace;<var>return address</var>&rbrace;&lbrace;<var>recipient
+address</var>&rbrace;</code> produces the two labels (or one, if you choose to ignore the
+<var>return address</var>) for each letter environment. The first argument,
+<var>return address</var>, is the value returned by the macro
+<code>\returnaddress</code>. The second argument, <var>recipient address</var>, is
+the value passed in the argument to the <code>letter</code> environment. By
+default <code>\mlabel</code> ignores the first argument, the <var>return
+address</var>, causing the default behavior described in the prior paragraph.
+</para>
+<para>This illustrates customization. Its output includes a page with two
+columns having two labels each.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\documentclass&lbrace;letter&rbrace;
+\renewcommand*&lbrace;\returnaddress&rbrace;&lbrace;Fred McGuilicuddy \\
+ Oshkosh, Mineola 12305&rbrace;
+\newcommand*\originalMlabel&lbrace;&rbrace;
+\let\originalMlabel\mlabel
+\def\mlabel#1#2&lbrace;\originalMlabel&lbrace;&rbrace;&lbrace;#1&rbrace;\originalMlabel&lbrace;&rbrace;&lbrace;#2&rbrace;&rbrace;
+\makelabels
+ ...
+\begin&lbrace;document&rbrace;
+\begin&lbrace;letter&rbrace;&lbrace;A Einstein \\
+ 112 Mercer Street \\
+ Princeton, New Jersey, USA 08540&rbrace;
+ ...
+\end&lbrace;letter&rbrace;
+\begin&lbrace;letter&rbrace;&lbrace;K G\&quot;odel \\
+ 145 Linden Lane \\
+ Princeton, New Jersey, USA 08540&rbrace;
+ ...
+\end&lbrace;letter&rbrace;
+\end&lbrace;document&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>The first column contains the return address twice. The second column
+contains the address for each recipient.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="934"><r>package</r>, <code>envlab</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="935"><code>envlab</code> <r>package</r></indexterm></cindex>
+
+<para>The package <code>envlab</code> makes formatting the labels easier, with
+standard sizes already provided. The preamble lines
+<code>\usepackage[personalenvelope]&lbrace;envlab&rbrace;</code> and <code>\makelabels</code>
+are all that you need to print envelopes.
</para>
-<!-- c xxx TODO, align on latex2e-fr.texi, see https://mail.gna.org/public/latexrefman-discuss/2015-10/msg00000.html -->
</section>
<node name="_005cname" spaces=" "><nodename>\name</nodename><nodenext automatic="on">\opening</nodenext><nodeprev automatic="on">\makelabels</nodeprev><nodeup automatic="on">Letters</nodeup></node>
<section spaces=" "><sectiontitle><code>\name</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1036">\name</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1089" mergedindex="cp">\name</indexterm></findex>
<para>Synopsis:
</para>
@@ -12981,26 +18409,25 @@ in the argument to the <code>letter</code> environment. By default
<pre xml:space="preserve">\name&lbrace;<var>name</var>&rbrace;
</pre></example>
-<para>Sender&textrsquo;s name, used for printing on the envelope together with the
-return address.
+<para>Optional. Sender&textrsquo;s name, used for printing on the envelope together
+with the return address.
</para>
</section>
<node name="_005copening" spaces=" "><nodename>\opening</nodename><nodenext automatic="on">\ps</nodenext><nodeprev automatic="on">\name</nodeprev><nodeup automatic="on">Letters</nodeup></node>
<section spaces=" "><sectiontitle><code>\opening</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1037">\opening</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="704">letters, starting</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1090" mergedindex="cp">\opening</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="936">letters, starting</indexterm></cindex>
<para>Synopsis:
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\opening&lbrace;<var>text</var>&rbrace;
+<pre xml:space="preserve">\opening&lbrace;<var>salutation</var>&rbrace;
</pre></example>
-<para>This command is required. It starts a letter, following the
-<code>\begin&lbrace;letter&rbrace;&lbrace;...&rbrace;</code>. The mandatory argument <var>text</var> is the
-text that starts your letter. For instance:
+<para>Required. Follows the <code>\begin&lbrace;letter&rbrace;&lbrace;...&rbrace;</code>. The argument
+<var>salutation</var> is mandatory. For instance:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\opening&lbrace;Dear John:&rbrace;
@@ -13010,8 +18437,8 @@ text that starts your letter. For instance:
</section>
<node name="_005cps" spaces=" "><nodename>\ps</nodename><nodenext automatic="on">\signature</nodenext><nodeprev automatic="on">\opening</nodeprev><nodeup automatic="on">Letters</nodeup></node>
<section spaces=" "><sectiontitle><code>\ps</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1038">\ps</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="705">postscript, in letters</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1091" mergedindex="cp">\ps</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="937">postscript, in letters</indexterm></cindex>
<para>Synopsis:
</para>
@@ -13038,15 +18465,15 @@ text that starts your letter. For instance:
... &rbrace;
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1039">\signature</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1092" mergedindex="cp">\signature</indexterm></findex>
<para>The sender&textrsquo;s name. This command is optional, although its inclusion is
usual.
</para>
-<para>The argument text appears at the end of the letter, after the closing
-and after a vertical space for the traditional hand-written
+<para>The argument text appears at the end of the letter, after the closing.
+&latex; leaves some vertical space for a handwritten
signature. Separate multiple lines with a double
-backslash&nbsp;<code>\\</code>. For example:
+backslash,&nbsp;<code>\\</code>. For example:
</para>
<example endspaces=" ">
<pre xml:space="preserve">\signature&lbrace;J Fred Muggs \\
@@ -13055,16 +18482,24 @@ backslash&nbsp;<code>\\</code>. For example:
<para>&latex;&textrsquo;s default for the vertical space from the <code>\closing</code> text
down to the <code>\signature</code> text is <code>6\medskipamount</code>, which is
-six times 0.7<dmn>em</dmn>.
+six times <code>\medskipamount</code> (where <code>\medskipamount</code> is equal to
+a <code>\parskip</code>, which in turn is defined by default here to
+0.7<dmn>em</dmn>).
</para>
<para>This command is usually in the preamble, to apply to all the letters in
the document. To have it apply to one letter only, put it inside a
<code>letter</code> environment and before the <code>\closing</code>.
</para>
-<para>You can include a graphic in the signature, for instance with
-<code>\signature&lbrace;\vspace&lbrace;-6\medskipamount&rbrace;\includegraphics&lbrace;sig.png&rbrace;\\
-My name&rbrace;</code> (this requires writing <code>\usepackage&lbrace;graphicx&rbrace;</code> in the
-preamble).
+<para>You can include a graphic in the signature as here.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\signature&lbrace;\vspace&lbrace;-6\medskipamount&rbrace;\includegraphics&lbrace;sig.png&rbrace;\\
+ My name&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>For this you must put <code>\usepackage&lbrace;graphicx&rbrace;</code> in the preamble
+(<pxref label="Graphics"><xrefnodename>Graphics</xrefnodename></pxref>).
</para>
<!-- c I think this is not a user-level command; it is used to keep from breaking -->
@@ -13089,7 +18524,7 @@ preamble).
<node name="_005ctelephone" spaces=" "><nodename>\telephone</nodename><nodeprev automatic="on">\signature</nodeprev><nodeup automatic="on">Letters</nodeup></node>
<section spaces=" "><sectiontitle><code>\telephone</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1040">\telephone</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1093" mergedindex="cp">\telephone</indexterm></findex>
<para>Synopsis:
</para>
@@ -13108,8 +18543,8 @@ page.
<node name="Terminal-input_002foutput" spaces=" "><nodename>Terminal input/output</nodename><nodenext automatic="on">Command line</nodenext><nodeprev automatic="on">Letters</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Terminal input/output</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="706">input/output, to terminal</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="707">terminal input/output</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="938">input/output, to terminal</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="939">terminal input/output</indexterm></cindex>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator=":: ">\typein</menunode><menudescription><pre xml:space="preserve">Read text from the terminal.
@@ -13118,30 +18553,72 @@ page.
<node name="_005ctypein" spaces=" "><nodename>\typein</nodename><nodenext automatic="on">\typeout</nodenext><nodeup automatic="on">Terminal input/output</nodeup></node>
-<section spaces=" "><sectiontitle><code>\typein[<var>cmd</var>]&lbrace;<var>msg</var>&rbrace;</code></sectiontitle>
+<section spaces=" "><sectiontitle><code>\typein</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1041">\typein</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1094" mergedindex="cp">\typein</indexterm></findex>
-<para>Synopsis:
+<para>Synopsis, one of:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\typein&lbrace;<var>prompt-msg</var>&rbrace;
+\typein[<var>cmd</var>]&lbrace;<var>prompt-msg</var>&rbrace;
+</pre></example>
+
+<para>Print <var>prompt-msg</var> on the terminal and cause &latex; to stop and
+wait for you to type a line of input. This line of input ends when you
+hit the return key.
+</para>
+<para>For example, this
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">As long as I live I shall never forget \typein&lbrace;Enter student name:&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>coupled with this command line interaction
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">Enter student name:
+
+\&arobase;typein=Aphra Behn
+</pre></example>
+
+<noindent></noindent>
+<para>gives the output <samp>... never forget Aphra Behn</samp>.
+</para>
+<para>The first command version, <code>\typein&lbrace;<var>prompt-msg</var>&rbrace;</code>, causes
+the input you typed to be processed as if it had been included in the
+input file in place of the <code>\typein</code> command.
+</para>
+<para>In the second command version the optional argument <code><var>cmd</var></code>
+argument must be a command name &textmdash; it must begin with a backslash, \.
+This command name is then defined or redefined to be the input that you
+typed. For example, this
</para>
<example endspaces=" ">
-<pre xml:space="preserve">\typein[\<var>cmd</var>]&lbrace;<var>msg</var>&rbrace;
+<pre xml:space="preserve">\typein[\student]&lbrace;Enter student name:&rbrace;
+\typeout&lbrace;Recommendation for \student .&rbrace;
</pre></example>
-<para><code>\typein</code> prints <var>msg</var> on the terminal and causes &latex; to
-stop and wait for you to type a line of input, ending with return. If
-the optional <code>\<var>cmd</var></code> argument is omitted, the typed input is
-processed as if it had been included in the input file in place of the
-<code>\typein</code> command. If the <code>\<var>cmd</var></code> argument is present, it
-must be a command name. This command name is then defined or
-redefined to be the typed input.
+<noindent></noindent>
+<para>gives this output on the command line,
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">Enter student name:
+
+\student=John Dee
+Recommendation for John Dee.
+</pre></example>
+
+<noindent></noindent>
+<para>where the user has entered <samp>John Dee.</samp>
</para>
</section>
<node name="_005ctypeout" spaces=" "><nodename>\typeout</nodename><nodeprev automatic="on">\typein</nodeprev><nodeup automatic="on">Terminal input/output</nodeup></node>
-<section spaces=" "><sectiontitle><code>\typeout&lbrace;<var>msg</var>&rbrace;</code></sectiontitle>
+<section spaces=" "><sectiontitle><code>\typeout</code></sectiontitle>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1042">\typeout</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1095" mergedindex="cp">\typeout</indexterm></findex>
<para>Synopsis:
</para>
@@ -13149,16 +18626,37 @@ redefined to be the typed input.
<pre xml:space="preserve">\typeout&lbrace;<var>msg</var>&rbrace;
</pre></example>
-<para>Prints <code>msg</code> on the terminal and in the <code>log</code> file.
-Commands in <code>msg</code> that are defined with <code>\newcommand</code> or
+<para>Print <code>msg</code> on the terminal and in the <code>log</code> file.
+</para>
+<para>This
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand&lbrace;\student&rbrace;&lbrace;John Dee&rbrace;
+\typeout&lbrace;Recommendation for \student .&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>outputs <samp>Recommendation for John Dee</samp>. Like what happens here with
+<code>\student</code>, commands that are defined with <code>\newcommand</code> or
<code>\renewcommand</code> (among others) are replaced by their definitions
before being printed.
</para>
<para>&latex;&textrsquo;s usual rules for treating multiple spaces as a single space
-and ignoring spaces after a command name apply to <code>msg</code>. A
-<code>\space</code> command in <code>msg</code> causes a single space to be
-printed, independent of surrounding spaces. A <code>^^J</code> in
-<code>msg</code> prints a newline.
+and ignoring spaces after a command name apply to <code>msg</code>. As above,
+use the command <code>\space</code> to get a single space, independent of
+surrounding spaces. Use <code>^^J</code> to get a newline. Get a percent
+character with <code>\csname &arobase;percentchar\endcsname</code>.
+</para>
+<para>This command can be useful for simple debugging, as here:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newlength&lbrace;\jhlength&rbrace;
+\setlength&lbrace;\jhlength&rbrace;&lbrace;5pt&rbrace;
+\typeout&lbrace;The length is \the\jhlength.&rbrace;
+</pre></example>
+
+<noindent></noindent>
+<para>produces on the command line <samp>The length is 5.0pt</samp>.
</para>
</section>
@@ -13166,41 +18664,298 @@ printed, independent of surrounding spaces. A <code>^^J</code> in
<node name="Command-line" spaces=" "><nodename>Command line</nodename><nodenext automatic="on">Document templates</nodenext><nodeprev automatic="on">Terminal input/output</nodeprev><nodeup automatic="on">Top</nodeup></node>
<chapter spaces=" "><sectiontitle>Command line</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="708">command line</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="940">command line</indexterm></cindex>
+
+<para>Synopsis (from a terminal command line):
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">pdflatex <var>options</var> <var>argument</var>
+</pre></example>
+
+<para>Run &latex; on <var>argument</var>. In place of <command>pdflatex</command> you can
+also use <command>xelatex</command>, or <code>lualatex</code>, or <code>dviluatex</code>, or
+<code>latex</code>.
+</para>
+<para>For example, this will run &latex; on the file <file>thesis.tex</file>,
+creating the output <file>thesis.pdf</file>.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">pdflatex thesis
+</pre></example>
+
+<noindent></noindent>
+<para><findex index="fn" spaces=" "><indexterm index="fn" number="1096" mergedindex="cp">.tex, <r>default extension</r></indexterm></findex>
+Note that <file>.tex</file> is the default file extension.
+</para>
+<para>pdf&tex; is a development of the original &tex; program, as are
+Xe&tex; and Lua&tex; (<pxref label="TeX-engines"><xrefnodename>&tex; engines</xrefnodename></pxref>). They are completely
+backward compatible. But the original program had a custom output
+format, DVI, while the newer ones can output directly to PDF. This
+allows them to take advantage of the extra features in PDF such as
+hyperlinks, support for modern image formats such as JPG and PNG, and
+ubiquitous viewing programs. In short, if you run <command>pdflatex</command> or
+<command>xelatex</command> or <command>lualatex</command> then you will by default get PDF
+and have access to all its modern features. If you run <command>latex</command>,
+or <code>dvilualatex</code>, then you will get DVI. The description here
+assumes pdf&latex;.
+</para>
+<para><xref label="Command-line-options"><xrefnodename>Command line options</xrefnodename></xref>, for a selection of the most useful
+command line options. As to <var>argument</var>, the usual case is that it
+does not begin with a backslash, so the system takes it to be the name
+of a file and it compiles that file. If <var>argument</var> begins with a
+backslash then the system will interpret it as a line of &latex;
+input, which can be used for special effects (<pxref label="Command-line-input"><xrefnodename>Command line
+input</xrefnodename></pxref>).
+</para>
+<para>If you gave no arguments or options then <command>pdflatex</command> prompts for
+input from the terminal. You can escape from this by entering
+<code>&lt;control&gt;-D</code>.
+</para>
+<para>If &latex; finds an error in your document then by default it stops and
+asks you about it. <xref label="Recovering-from-errors"><xrefnodename>Recovering from errors</xrefnodename></xref> for an outline of what
+to do.
+</para>
+<menu endspaces=" ">
+<menuentry leadingtext="* "><menunode separator=":: ">Command line options</menunode><menudescription><pre xml:space="preserve">Read text from the terminal.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Command line input</menunode><menudescription><pre xml:space="preserve">Write text to the terminal.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator=":: ">Recovering from errors</menunode><menudescription><pre xml:space="preserve">When something goes wrong.
+</pre></menudescription></menuentry></menu>
+
+
+<node name="Command-line-options" spaces=" "><nodename>Command line options</nodename><nodenext automatic="on">Command line input</nodenext><nodeup automatic="on">Command line</nodeup></node>
+<section spaces=" "><sectiontitle>Command line options</sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="941">options, command line</indexterm></cindex>
+
+<para>These are the command-line options relevant to ordinary document
+authoring. For a full list, try running <samp>latex --help</samp> from the
+command line.
+</para>
+<para>With many implementations you can specify command line options by
+prefixing them with <samp>-</samp> or <samp>--</samp>. This is the case for
+both &tex; Live (and Mac&tex;) and MiK&tex;. We will use both
+conventions interchangeably.
+</para>
+<table commandarg="code" spaces=" " endspaces=" ">
+<beforefirstitem><findex index="fn" spaces=" "><indexterm index="fn" number="1097" mergedindex="cp">--version <r>command-line option</r></indexterm></findex>
+</beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code">-version</itemformat></item>
+</tableterm><tableitem><para>Show the current version, like <samp>pdfTeX 3.14159265-2.6-1.40.16 (TeX
+Live 2015/Debian)</samp> along with a small amount of additional information,
+and exit.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1098" mergedindex="cp">--help <r>command-line option</r></indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-help</itemformat></item>
+</tableterm><tableitem><para>Give a brief usage message that is useful as a prompt and exit.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1099" mergedindex="cp">--interaction <r>command-line option</r></indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-interaction=<var>mode</var></itemformat></item>
+</tableterm><tableitem><para>&tex; compiles a document in one of four interaction modes:
+<code>batchmode</code>, <code>nonstopmode</code>, <code>scrollmode</code>,
+<code>errorstopmode</code>. In <dfn>errorstop mode</dfn> (the default), &tex;
+stops at each error and asks for user intervention. In <dfn>batch
+mode</dfn> it prints nothing on the terminal, errors are scrolled as if the
+user hit <code>&lt;return&gt;</code> at every error, and missing files cause the
+job to abort. In <dfn>nonstop mode</dfn>, diagnostic message appear on the
+terminal but as in batch mode there is no user interaction. In
+<dfn>scroll mode</dfn>, &tex; only stops for missing files or keyboard
+input.
+</para>
+<para>For instance, starting &latex; with this command line
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">pdflatex -interaction=batchmode <var>filename</var>
+</pre></example>
+
+<noindent></noindent>
+<para>eliminates most terminal output.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1100" mergedindex="cp">--jobname <r>command-line option</r></indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-jobname=<var>string</var></itemformat></item>
+</tableterm><tableitem><para>Set the value of &tex;&textrsquo;s <code>jobname</code> to the string. The log file
+and output file will then be named <file><var>string</var>.log</file> and
+<file><var>string</var>.pdf</file>.
+</para>
+<para>When you run <code><command>pdflatex</command> <var>options</var> <var>argument</var></code>, if
+<var>argument</var> does not start with a backslash then &tex; considers it
+the name of a file to input. Otherwise it waits for the first
+<code>\input</code> instruction and the name of the input file will be the job
+name. This is used to name the log file the output file. This option
+overrides that process and directly specifies the name. <xref label="Command-line-input"><xrefnodename>Command
+line input</xrefnodename></xref> for an example of its use.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1101" mergedindex="cp">--output-directory <r>command-line option</r></indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-output-directory=<var>directory</var></itemformat></item>
+</tableterm><tableitem><para>Write files in the directory <var>directory</var>. It must already exist.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1102" mergedindex="cp">--shell-escape <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1103" mergedindex="cp">--no-shell-escape <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1104" mergedindex="cp">--enable-write18 <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1105" mergedindex="cp">--disable-write18 <r>command-line option</r></indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">shell-escape</itemformat></item>
+<itemx spaces=" "><itemformat command="code">no-shell-escape</itemformat></itemx>
+<itemx spaces=" "><itemformat command="code">enable-write18</itemformat></itemx>
+<itemx spaces=" "><itemformat command="code">disable-write18</itemformat></itemx>
+</tableterm><tableitem><para>Enable or disable <code>\write18&lbrace;<var>shell command</var>&rbrace;</code>. The first two
+options are for with &tex; Live or Mac&tex; while the second two are
+for MiK&tex;.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="942"><r>package</r>, <code>sagetex</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="943"><code>sagetex</code> <r>package</r></indexterm></cindex>
+
+<para>Sometimes you want to run external system commands from inside a
+&latex; file. For instance the package <file>sagetex</file> allows you to
+have the mathematics software system <i>Sage</i> do calculations or draw
+graphs and then incorporate that output in your document. For this
+&tex; provides the <code>\write18</code> command.
+</para>
+<para>But with this functionality enabled, security issues could happen if you
+compiled a &latex; file from the Internet. By default <code>\write18</code>
+is disabled. (More precisely, by default &tex; Live, Mac&tex;, and
+MiK&tex; only allow the execution of a limited number of &tex;-related
+programs, which they distribute.)
+</para>
+<para>If you invoke &latex; with the option <code>no-shell-escape</code>, and in
+your document you call <code>\write18&lbrace;ls -l&rbrace;</code>, then you do not get an
+error but the log file says <samp>runsystem(ls -l)...disabled</samp>.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1106" mergedindex="cp">--halt-on-error <r>command-line option</r></indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-halt-on-error</itemformat></item>
+</tableterm><tableitem><para>Stop processing at the first error.
+</para>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1107" mergedindex="cp">--file-line-error <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1108" mergedindex="cp">--no-file-line-error <r>command-line option</r></indexterm></findex>
+</tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-file-line-error</itemformat></item>
+</tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-no-file-line-error</itemformat></item>
+</tableterm><tableitem><para>Enable or disable <code><var>filename</var>:<var>lineno</var>:<var>error</var></code>-style
+error messages. These are only available with &tex; Live or Mac&tex;.
+</para></tableitem></tableentry></table>
+
+
+</section>
+<node name="Command-line-input" spaces=" "><nodename>Command line input</nodename><nodenext automatic="on">Recovering from errors</nodenext><nodeprev automatic="on">Command line options</nodeprev><nodeup automatic="on">Command line</nodeup></node>
+<section spaces=" "><sectiontitle>Command line input</sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="944">input, on command line</indexterm></cindex>
+
+<para>As part of the command line invocation <code>pdflatex <var>options</var>
+<var>argument</var></code> you can specify arbitrary &latex; input by starting
+<var>argument</var> with a backslash. This allows you to do some special
+effects.
+</para>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="945"><r>package</r>, <code>hyperref</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="946"><code>hyperref</code> <r>package</r></indexterm></cindex>
+
+<para>For example, this file (which uses the <file>hyperref</file> package for
+hyperlinks) can produce two kinds of output, one for paper and one for a
+PDF.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\ifdefined\paperversion % in preamble
+\newcommand&lbrace;\urlcolor&rbrace;&lbrace;black&rbrace;
+\else
+\newcommand&lbrace;\urlcolor&rbrace;&lbrace;blue&rbrace;
+\fi
+\usepackage[colorlinks=true,urlcolor=\urlcolor]&lbrace;hyperref&rbrace;
+ ...
+\href&lbrace;https://www.ctan.org&rbrace;&lbrace;CTAN&rbrace; % in body
+ ...
+</pre></example>
+
+<noindent></noindent>
+<para>Compiling this document <file>book.tex</file> with the command line
+<code>pdflatex test</code> will give the <samp>CTAN</samp> link in blue. But
+compiling it with <code>pdflatex &quot;\def\paperversion&lbrace;&rbrace;\input test.tex&quot;</code>
+has the link in black. (Note the use of double quotes to prevent
+interpretation of the symbols by the command line shell; your system may
+do this differently.)
+</para>
+<para>In a similar way, from the single file <file>main.tex</file> you can compile
+two different versions.
+</para>
+<!-- c credit Paul Gaborit: https://tex.stackexchange.com/a/220101/121234 -->
+<example endspaces=" ">
+<pre xml:space="preserve">pdflatex -jobname=students &quot;\def\student&lbrace;&rbrace;\input&lbrace;main&rbrace;&quot;
+pdflatex -jobname=teachers &quot;\def\teachers&lbrace;&rbrace;\input&lbrace;main&rbrace;&quot;
+</pre></example>
+
+<noindent></noindent>
+<para>The <code>jobname</code> option is there because otherwise both files would be
+called <file>main.pdf</file> and the second would overwrite the first.
+</para>
+<para>A final example. This loads the package <file>graphicx</file> with the option
+<code>draft</code>
+</para>
+<!-- c credit Herbert Voss: https://tex.stackexchange.com/a/17236/121234 -->
+<example endspaces=" ">
+<pre xml:space="preserve">pdflatex -jobname=aa &quot;\RequirePackage[draft]&lbrace;graphicx&rbrace;\input&lbrace;aa.tex&rbrace;&quot;
+</pre></example>
+
+<noindent></noindent>
+<para>so the graphic files are read for their size information but not
+incorporated into the PDF. (The <code>jobname</code> option is needed because
+otherwise the output file would be <file>graphicx.pdf</file>, as
+<code>\RequirePackage</code> does an <code>\input</code> of its own.)
+</para>
+
+</section>
+<node name="Recovering-from-errors" spaces=" "><nodename>Recovering from errors</nodename><nodeprev automatic="on">Command line input</nodeprev><nodeup automatic="on">Command line</nodeup></node>
+<section spaces=" "><sectiontitle>Recovering from errors</sectiontitle>
+
+<para>If &latex; finds an error in your document then it gives you an error
+message and prompts you with a question mark, <code>?</code>. For instance,
+running &latex; on this file
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newcommand&lbrace;\NP&rbrace;&lbrace;\ensuremath&lbrace;\textbf&lbrace;NP&rbrace;&rbrace;&rbrace;
+The \PN&lbrace;&rbrace; problem is a million dollar one.
+</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1043">.tex, <r>default extension</r></indexterm></findex>
-<para>The input file specification indicates the file to be formatted;
-&tex; uses <file>.tex</file> as a default file extension. If you omit the
-input file entirely, &tex; accepts input from the terminal. You can
-also specify arbitrary &latex; input by starting with a backslash.
-For example, this processes <file>foo.tex</file> without pausing after every
-error:
+<noindent></noindent>
+<para>causes it show this, and wait for input.
</para>
<example endspaces=" ">
-<pre xml:space="preserve">latex '\nonstopmode\input foo.tex'
+<pre xml:space="preserve">! Undefined control sequence.
+l.5 The \PN
+ &lbrace;&rbrace; problem is a million dollar one.
+?
</pre></example>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1044">--help <r>command-line option</r></indexterm></findex>
-<para>With many, but not all, implementations, command-line options can also
-be specified in the usual Unix way, starting with <samp>-</samp> or
-<samp>--</samp>. For a list of those options, try <samp>latex --help</samp>.
+<noindent></noindent>
+<para>The simplest thing is to enter <samp>x</samp> and <code>&lt;return&gt;</code> and fix the
+typo. You could instead enter <samp>?</samp> and <code>&lt;return&gt;</code> to see other
+options.
</para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="709"><samp>*</samp> prompt</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="710">prompt, <samp>*</samp></indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1045">\stop</indexterm></findex>
-<para>If &latex; stops in the middle of the document and gives you a
-<samp>*</samp> prompt, it is waiting for input. You can type <code>\stop</code>
-(and return) and it will prematurely end the document.
+<cindex index="cp" spaces=" "><indexterm index="cp" number="947"><samp>*</samp> prompt</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="948">prompt, <samp>*</samp></indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1109" mergedindex="cp">\stop</indexterm></findex>
+<para>There are two other error scenarios. The first is that you forgot to
+include the <code>\end&lbrace;document&rbrace;</code> or misspelled it. In this case
+&latex; gives you a <samp>*</samp> prompt. You can get back to the command
+line by typing <code>\stop</code> and <code>&lt;return&gt;</code>.
</para>
-<para><xref label="TeX-engines"><xrefnodename>&tex; engines</xrefnodename></xref>, for other system commands invoking &latex;.
+<para>The last scenario is that you mistyped the file name. For instance,
+instead of <code>pdflatex test</code> you might type <code>pdflatex tste</code>.
</para>
+<example endspaces=" ">
+<pre xml:space="preserve">! I can't find file `tste'.
+&lt;*&gt; tste
+
+(Press Enter to retry, or Control-D to exit)
+Please type another input file name:
+</pre></example>
+<noindent></noindent>
+<para>The simplest thing is to enter <code>&lt;Contol&gt;</code> and <samp>d</samp> (holding
+them down at the same time), and just fix the command line.
+</para>
+
+</section>
</chapter>
-<node name="Document-templates" spaces=" "><nodename>Document templates</nodename><nodenext automatic="on">Concept Index</nodenext><nodeprev automatic="on">Command line</nodeprev><nodeup automatic="on">Top</nodeup></node>
+<node name="Document-templates" spaces=" "><nodename>Document templates</nodename><nodenext automatic="on">Index</nodenext><nodeprev automatic="on">Command line</nodeprev><nodeup automatic="on">Top</nodeup></node>
<appendix spaces=" "><sectiontitle>Document templates</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="711">document templates</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="712">templates, document</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="949">document templates</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="950">templates, document</indexterm></cindex>
<para>Although not reference material, perhaps these document templates will
be useful. Additional template resources are listed at
@@ -13208,16 +18963,18 @@ be useful. Additional template resources are listed at
</para>
<menu endspaces=" ">
<menuentry leadingtext="* "><menunode separator="::">beamer template</menunode><menudescription><pre xml:space="preserve">
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator="::">article template</menunode><menudescription><pre xml:space="preserve">
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator="::">book template</menunode><menudescription><pre xml:space="preserve">
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator="::">Larger book template</menunode><menudescription><pre xml:space="preserve">
</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator="::">tugboat template</menunode><menudescription><pre xml:space="preserve">
</pre></menudescription></menuentry></menu>
-<node name="beamer-template" spaces=" "><nodename>beamer template</nodename><nodenext automatic="on">book template</nodenext><nodeup automatic="on">Document templates</nodeup></node>
+<node name="beamer-template" spaces=" "><nodename>beamer template</nodename><nodenext automatic="on">article template</nodenext><nodeup automatic="on">Document templates</nodeup></node>
<section spaces=" "><sectiontitle><code>beamer</code> template</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="713"><code>beamer</code> template and class</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="714">template, <code>beamer</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="951"><code>beamer</code> template and class</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="952">template, <code>beamer</code></indexterm></cindex>
<para>The <code>beamer</code> class creates presentation slides. It has a vast
array of features, but here is a basic template:
@@ -13251,11 +19008,40 @@ array of features, but here is a basic template:
</para>
</section>
-<node name="book-template" spaces=" "><nodename>book template</nodename><nodenext automatic="on">tugboat template</nodenext><nodeprev automatic="on">beamer template</nodeprev><nodeup automatic="on">Document templates</nodeup></node>
+<node name="article-template" spaces=" "><nodename>article template</nodename><nodenext automatic="on">book template</nodenext><nodeprev automatic="on">beamer template</nodeprev><nodeup automatic="on">Document templates</nodeup></node>
+<section spaces=" "><sectiontitle><code>article</code> template</sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="953">template, <code>article</code></indexterm></cindex>
+
+<verbatim xml:space="preserve">
+\documentclass{article}
+\title{Article Class Template}
+\author{Alex Author}
+
+\begin{document}
+\maketitle
+
+\section{First section}
+Some text.
+
+\subsection{First section, first subsection}
+Additional text.
+
+\section{Second section}
+Some more text.
+\end{document}
+</verbatim>
+
+
+</section>
+<node name="book-template" spaces=" "><nodename>book template</nodename><nodenext automatic="on">Larger book template</nodenext><nodeprev automatic="on">article template</nodeprev><nodeup automatic="on">Document templates</nodeup></node>
<section spaces=" "><sectiontitle><code>book</code> template</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="715">template, <code>book</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="954">template, <code>book</code></indexterm></cindex>
+<para>This is a straightforward template for a book. See <xref label="Larger-book-template"><xrefnodename>Larger book
+template</xrefnodename></xref> for a more elaborate one.
+</para>
<verbatim xml:space="preserve">
\documentclass{book}
\title{Book Class Template}
@@ -13277,12 +19063,69 @@ The end.
</section>
-<node name="tugboat-template" spaces=" "><nodename>tugboat template</nodename><nodeprev automatic="on">book template</nodeprev><nodeup automatic="on">Document templates</nodeup></node>
+<node name="Larger-book-template" spaces=" "><nodename>Larger book template</nodename><nodenext automatic="on">tugboat template</nodenext><nodeprev automatic="on">book template</nodeprev><nodeup automatic="on">Document templates</nodeup></node>
+<section spaces=" "><sectiontitle>Larger <code>book</code> template</sectiontitle>
+
+<cindex index="cp" spaces=" "><indexterm index="cp" number="955">template, <code>book</code></indexterm></cindex>
+
+<para>This is a more elaborate template for a book. It has
+<code>\frontmatter</code>, <code>\mainmatter</code>, and <code>\backmatter</code> to
+control the typography of the three main areas of a book
+(<pxref label="_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter"><xrefnodename>\frontmatter &amp; \mainmatter &amp; \backmatter</xrefnodename></pxref>). The book has a
+bibliography and an index.
+</para>
+<para>Notable is that it uses <code>\include</code> and <code>\includeonly</code>
+(<pxref label="Splitting-the-input"><xrefnodename>Splitting the input</xrefnodename></pxref>). While you are working on a chapter you
+can comment out all the other chapter entries from the argument to
+<code>\includeonly</code>. That will speed up compilation without losing any
+information such as cross-references. (Material that does not need to
+come on a new page is brought in with <code>\input</code> instead of
+<code>\include</code>. You don&textrsquo;t get the cross-reference benefit this way.)
+</para>
+<verbatim xml:space="preserve">
+\documentclass[titlepage]{book}
+\usepackage{makeidx}\makeindex
+
+\title{Book Class Template}
+\author{Alex Author}
+
+\includeonly{%
+ frontcover,
+ preface,
+ chap1,
+ ...
+ }
+\begin{document}
+\frontmatter
+\include{frontcover}
+ % maybe comment out while drafting:
+\maketitle \input{dedication} \input{copyright}
+\tableofcontents
+\include{preface}
+\mainmatter
+\include{chap1}
+...
+\appendix
+\include{appena}
+...
+\backmatter
+\bibliographystyle{apalike}
+\addcontentsline{toc}{chapter}{Bibliography}
+\bibliography
+\addcontentsline{toc}{chapter}{Index}
+\printindex
+\include{backcover}
+\end{document}
+</verbatim>
+
+
+</section>
+<node name="tugboat-template" spaces=" "><nodename>tugboat template</nodename><nodeprev automatic="on">Larger book template</nodeprev><nodeup automatic="on">Document templates</nodeup></node>
<section spaces=" "><sectiontitle><code>tugboat</code> template</sectiontitle>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="716">template, TUGboat</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="717">TUGboat template</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="718"><code>ltugboat</code> class</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="956">template, TUGboat</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="957">TUGboat template</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="958"><code>ltugboat</code> class</indexterm></cindex>
<para><cite>TUGboat</cite> is the journal of the &tex; Users Group,
<url><urefurl>http://tug.org/TUGboat</urefurl></url>.
@@ -13372,17 +19215,13 @@ Email \verb|tugboat@tug.org| if problems or questions.
</section>
</appendix>
-<node name="Concept-Index" spaces=" "><nodename>Concept Index</nodename><nodenext automatic="on">Command Index</nodenext><nodeprev automatic="on">Document templates</nodeprev><nodeup automatic="on">Top</nodeup></node>
-<unnumbered spaces=" "><sectiontitle>Concept Index</sectiontitle>
+<node name="Index" spaces=" "><nodename>Index</nodename><nodeprev automatic="on">Document templates</nodeprev><nodeup automatic="on">Top</nodeup></node>
+<unnumbered spaces=" "><sectiontitle>Index</sectiontitle>
-<printindex value="cp" line=" cp"></printindex>
+<!-- c Keep `Command Index' working for ltx-help.el. -->
+<anchor name="Command-Index">Command Index</anchor>
-<!-- c The name of the `Command Index' node must NOT be altered for ltx-help.el. -->
-</unnumbered>
-<node name="Command-Index" spaces=" "><nodename>Command Index</nodename><nodeprev automatic="on">Concept Index</nodeprev><nodeup automatic="on">Top</nodeup></node>
-<unnumbered spaces=" "><sectiontitle>Command Index</sectiontitle>
-
-<printindex value="fn" line=" fn"></printindex>
+<printindex value="cp" line=" cp"></printindex>
</unnumbered>
<bye></bye>