[latexrefman-commits] [SCM] latexrefman updated: r662 - trunk
jimhefferon at gnu.org.ua
jimhefferon at gnu.org.ua
Tue Jun 26 18:00:32 CEST 2018
Author: jimhefferon
Date: 2018-06-26 19:00:32 +0300 (Tue, 26 Jun 2018)
New Revision: 662
Modified:
trunk/ChangeLog
trunk/latex2e.html
trunk/latex2e.info
trunk/latex2e.pdf
trunk/latex2e.texi
Log:
Front/back matter; did table of contents, indexes, and glossaries
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2018-06-21 22:45:36 UTC (rev 661)
+++ trunk/ChangeLog 2018-06-26 16:00:32 UTC (rev 662)
@@ -1,3 +1,10 @@
+2018-06-26 Jim Hefferon <jhefferon at 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 at smcvt.edu>
* latex2e.texi (Special insertions) Rearranged the lists so that
Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html 2018-06-21 22:45:36 UTC (rev 661)
+++ trunk/latex2e.html 2018-06-26 16:00:32 UTC (rev 662)
@@ -326,7 +326,7 @@
<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-_005cday-_0026-_005cmonth-_0026-_005cyear-1" href="#g_t_005cday-_0026-_005cmonth-_0026-_005cyear">13.8 <code>\day</code> & <code>\month</code> & <code>\year</code></a></li>
</ul></li>
<li><a name="toc-Lengths-1" href="#Lengths">14 Lengths</a>
<ul class="no-bullet">
@@ -462,13 +462,23 @@
</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-Glossaries-1" href="#Glossaries">25.2 Glossaries</a></li>
- <li><a name="toc-Indexes-1" href="#Indexes">25.3 Indexes</a></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>
</ul></li>
<li><a name="toc-Letters-1" href="#Letters">26 Letters</a>
<ul class="no-bullet">
@@ -3422,7 +3432,7 @@
<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="#Tables-of-contents">Tables of contents</a>) and in running
+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.
@@ -3488,8 +3498,8 @@
<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="#Tables-of-contents">Tables of contents</a>), and sets the running header information
-(see <a href="#Page-styles">Page styles</a>).
+(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> form shows <var>title</var> on a fresh line, in boldface.
But it does not show the chapter number, does not increment the
@@ -3503,9 +3513,10 @@
</pre></div>
<p>The optional argument <var>toc-title</var> will appear as the chapter title
-in the table of contents (see <a href="#Tables-of-contents">Tables of contents</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,
+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)}
@@ -3627,9 +3638,10 @@
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="#Tables-of-contents">Tables of contents</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,
+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,
@@ -3727,9 +3739,9 @@
<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="#Tables-of-contents">Tables of contents</a>). If it is not
-present then <var>title</var> will be there. This shows the full name in the
-title of the section,
+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
@@ -3843,8 +3855,8 @@
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="#Tables-of-contents">Tables of contents</a>). If it is not
-present then <var>title</var> will be there.
+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 3, of
@@ -5294,7 +5306,7 @@
<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
@@ -7532,7 +7544,7 @@
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="#Tables-of-contents">Tables of contents</a>).
+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.
@@ -10697,7 +10709,7 @@
</td></tr>
<tr><td align="left" valign="top">• <a href="#g_t_005cstepcounter" accesskey="7">\stepcounter</a>:</td><td> </td><td align="left" valign="top">Add to a counter, resetting subsidiary counters.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_005cday-_005cmonth-_005cyear" accesskey="8">\day \month \year</a>:</td><td> </td><td align="left" valign="top">Numeric date values.
+<tr><td align="left" valign="top">• <a href="#g_t_005cday-_0026-_005cmonth-_0026-_005cyear" accesskey="8">\day & \month & \year</a>:</td><td> </td><td align="left" valign="top">Numeric date values.
</td></tr>
</table>
@@ -10962,7 +10974,7 @@
<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> [<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 & \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> [<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_005cstepcounter_007bcounter_007d"></a>
<h3 class="section">13.7 <code>\stepcounter{<var>counter</var>}</code></h3>
@@ -10975,28 +10987,37 @@
</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> [<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_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> & <code>\month</code> & <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–31), month of the year (<code>\month</code>, 1–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>The related command <code>\today</code> produces a string representing the
-current day (see <a href="#g_t_005ctoday">\today</a>).
+<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>
+<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 ‘<samp>-2, -4</samp>’ (the
+bogus month value produces no output).
+</p>
+
<hr>
<a name="Lengths"></a>
<div class="header">
@@ -19231,6 +19252,9 @@
\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 & \month & \year</a>).
+</p>
<a name="index-package_002c-datetime"></a>
<a name="index-datetime-package"></a>
@@ -19535,59 +19559,146 @@
<h2 class="chapter">25 Front/back matter</h2>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Tables-of-contents" accesskey="1">Tables of contents</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Table-of-contents-etc_002e" accesskey="1">Table of contents etc.</a>:</td><td> </td><td align="left" valign="top">Table of contents, list of figures, list of tables.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Glossaries" accesskey="2">Glossaries</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Indexes" accesskey="2">Indexes</a>:</td><td> </td><td align="left" valign="top">Generate an index.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Indexes" accesskey="3">Indexes</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Glossaries" accesskey="3">Glossaries</a>:</td><td> </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> [<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> [<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="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 counter <code>tocdepth</code> determines which of parts, chapters,
-sections, etc., are listed (see <a href="#Sectioning_002ftocdepth">Sectioning/tocdepth</a>).
-</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’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 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
+auxillary 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 ‘<samp>Contents</samp>’ 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
+<code>\renewcommand{\contentsname}{Table of contents}</code>. Similarly,
+<code>\renewcommand{\listfigurename}{Plots}</code> and
+<code>\renewcommand{\listtablename}{Tables}</code> 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">• <a href="#g_t_005caddcontentsline" accesskey="1">\addcontentsline</a>:</td><td> </td><td align="left" valign="top">Add an entry to table of contents, etc.
</td></tr>
<tr><td align="left" valign="top">• <a href="#g_t_005caddtocontents" accesskey="2">\addtocontents</a>:</td><td> </td><td align="left" valign="top">Add text directly to table of contents file, etc.
</td></tr>
+<tr><td align="left" valign="top">• <a href="#g_t_005cnofiles" accesskey="3">\nofiles</a>:</td><td> </td><td align="left" valign="top">Prevent writing to auxillary files
+</td></tr>
</table>
@@ -19595,7 +19706,7 @@
<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> [<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> [<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_005caddcontentsline-1"></a>
<h4 class="subsection">25.1.1 <code>\addcontentsline</code></h4>
@@ -19609,28 +19720,67 @@
<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>.
</p>
+<p>The following will result in an ‘<samp>Appendices</samp>’ line in the table of
+contents.
+</p>
+<div class="example">
+<pre class="example">\addcontentsline{toc}{section}{\protect\textbf{Appendices}}
+</pre></div>
+
+<p>It wll 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
+‘<samp>3</samp>’.
+</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>
@@ -19638,82 +19788,130 @@
</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 & \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 in
+<code>\addcontentsline{toc}{setcion}{\protect\textbf{Appendices}}</code>,
+then you don’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> [<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> [<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_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
+‘<samp>Contents</samp>’ header.
+</p>
+<div class="example">
+<pre class="example">\tableofcontents\newpage
+\addtocontents{toc}{\protect\vspace*{3ex}}
+</pre></div>
+
+<p>The <code>\addtocontents</code> command has three arguments. All 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> store information with
+the <code>\addcontentsline</code> command, which creates lines in the
+<samp>.toc</samp> file containing the <code>\contentsline</code> command
+(see <a href="#g_t_005caddcontentsline">\addcontentsline</a>). In contrast, <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 & \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> [<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> [<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="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 auxillary 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 auxillary 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> [<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> [<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="Indexes-1"></a>
-<h3 class="section">25.3 Indexes</h3>
+<h3 class="section">25.2 Indexes</h3>
<a name="index-indexes"></a>
@@ -19723,65 +19921,699 @@
</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 shows a document that 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>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 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">• <a href="#g_t_005cindex" accesskey="1">\index</a>:</td><td> </td><td align="left" valign="top">Declare an index entry.
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#makeindex" accesskey="2">makeindex</a>:</td><td> </td><td align="left" valign="top">Alphabetize index entries.
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#g_t_005cprintindex" accesskey="3">\printindex</a>:</td><td> </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> [<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_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’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 ‘<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{Ackermann!function!growth rate!comparison}</code> then
+<code>makeindex</code> says ‘<samp>Scanning input file test.idx....done (4
+entries accepted, 1 rejected)</samp>’ 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 ‘<samp>Ackermann, 22,
+151</samp>’. 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 ‘<samp>Hilbert, 23--27</samp>’, 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 ‘<samp>Jones</samp>’ with no comma or page number,
+followed by two subitems, like ‘<samp>program, 50</samp>’ and ‘<samp>results,
+51</samp>’.
+</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 ‘bar’ that says ‘See foo’, use a
-vertical bar: <code>\index{bar|see{foo}}</code>. Use <code>seealso</code>
-instead of <code>see</code> to make a ‘See also’ entry.
-</p>
<a name="index-_005cseename"></a>
<a name="index-_005calsoname"></a>
-<p>The text ‘See’ is defined by the macro <code>\seename</code>, and ‘See also’
-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
+‘<samp>See</samp>’ by using a vertical bar character:
+<code>\index{Ackermann!function|see{P\'eter's function}}</code>. 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
+<samp>babel</samp> or <samp>polyglossia</samp>, or directly as with
+<code>\renewcommand{\alsoname}[1]{Also see #1}</code>.)
</p>
+<p>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{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 with
+<code>\index{Ackermann!function|(definedpage}</code> and
+<code>\index{Ackermann!function|)}</code>, which outputs an index entry like
+‘<samp>function, 23--27</samp>’ where the page number range is in blue.
+</p>
+<p>Consider an index entry such as ‘<samp>α-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{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 at SMC}</code> produces an index entry
+‘<samp>SMC</samp>’ 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>"</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 ‘<samp>Runaway argument? {Ackermann!function ! Paragraph
+ended before \@wrindex was complete.</samp>’.
+</p>
+
+<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> [<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="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
+"\\pagestyle{empty}
+\\small
+\\begin{theindex}
+\\thispagestyle{empty}"
+
+postamble
+"\n
+\\end{theindex}"
+</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>"</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">
+<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>"\\begin{theindex}\n"</code>.
+</p>
+</dd>
+<dt><code>postamble</code>
+<a name="index-postamble"></a>
+</dt>
+<dd><p>Postamble of the output file. Default: <code>"\n\n\\end{theindex}\n"</code>.
+</p>
+</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 ‘<samp>a</samp>’, etc. This specifier gives what is
+inserted when a new group begins. Default: <code>"\n\n \\indexspace\n"</code>
+(<code>\indexspace</code> is a rubber length with default value <code>10pt
+plus5pt minus3pt</code>).
+</p>
+</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 0.
+</p>
+</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>""</code>
+</p>
+</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>""</code>.
+</p>
+</dd>
+<dt><code>item_0</code>
+<a name="index-item_005f0"></a>
+</dt>
+<dd><p>What is put between two level 0 items. Default: <code>"\n \\item
+"</code>.
+</p>
+</dd>
+<dt><code>item_1</code>
+<a name="index-item_005f1"></a>
+</dt>
+<dd><p>Put between two level 1 items. Default: <code>"\n \\subitem "</code>.
+</p>
+</dd>
+<dt><code>item_2</code>
+<a name="index-item_005f2"></a>
+</dt>
+<dd><p>put between two level 2 items. Default: <code>"\n \\subsubitem "</code>.
+</p>
+</dd>
+<dt><code>item_01</code>
+<a name="index-item_005f01"></a>
+</dt>
+<dd><p>What is put between a level 0 item and a level 1 item.
+Default: <code>"\n \\subitem "</code>.
+</p>
+</dd>
+<dt><code>item_x1</code>
+<a name="index-item_005fx1"></a>
+</dt>
+<dd><p>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
+<code>\index{aaa|see{bbb}}</code>). Default: <code>"\n \\subitem "</code>.
+</p>
+</dd>
+<dt><code>item_12</code>
+<a name="index-item_005f12"></a>
+</dt>
+<dd><p>What is put between a level 1 item and a level 2 item.
+Default: <code>"\n \\subsubitem "</code>.
+</p>
+</dd>
+<dt><code>item_x2 <string></code>
+<a name="index-item_005fx2-_003cstring_003e"></a>
+</dt>
+<dd><p>What is put between a level 1 item and a level 2 item, if the
+level 1 item doesn’t have page numbers. Default: <code>"\n
+\\subsubitem "</code>.
+</p>
+</dd>
+<dt><code>delim_0</code>
+<a name="index-delim_005f0"></a>
+</dt>
+<dd><p>Delimiter put between a level 0 key and its first page
+number. Default: a comma followed by a blank, <code>", "</code>.
+</p>
+</dd>
+<dt><code>delim_1</code>
+<a name="index-delim_005f1"></a>
+</dt>
+<dd><p>Delimiter put between a level 1 key and its first page
+number. Default: a comma followed by a blank, <code>", "</code>.
+</p>
+</dd>
+<dt><code>delim_2</code>
+<a name="index-delim_005f2"></a>
+</dt>
+<dd><p>Delimiter between a level 2 key and its first page number. Default:
+a comma followed by a blank, <code>", "</code>.
+</p>
+</dd>
+<dt><code>delim_n <string></code>
+<a name="index-delim_005fn-_003cstring_003e"></a>
+</dt>
+<dd><p>Delimiter between two page numbers for the same key (at any
+level). Default: a comma followed by a blank, <code>", "</code>.
+</p>
+</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>"--"</code>.
+</p>
+</dd>
+<dt><code>line_max</code>
+<a name="index-line_005fmax"></a>
+</dt>
+<dd><p>An integer. Maximum length of an index entry’s line in the output,
+beyond which the line wraps. Default: <code>72</code>.
+</p>
+</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>"\t\t"</code>.
+</p>
+</dd>
+<dt><code>indent_length <number></code>
+<a name="index-indent_005flength-_003cnumber_003e"></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>
+</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>"rnaRA"</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> [<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_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 ‘<samp>10pt plus5pt
-minus3pt</samp>’.
+<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>
-<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.
+<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> [<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="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>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 very simple
+ but can compute anything that an existing device can compute.
+ It is the standard one 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 ‘<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 … Computer Science</samp>’.
+</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">• <a href="#g_t_005cnewglossaryentry" accesskey="1">\newglossaryentry</a>:</td><td> </td><td align="left" valign="top">Declare the content of a glossary entry.
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#g_t_005cgls" accesskey="2">\gls</a>:</td><td> </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> [<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_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 ℝ 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> [<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_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 ‘<samp>Consider the natural numbers</samp>’.
+</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 ‘<samp>s</samp>’). 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>
@@ -20750,7 +21582,9 @@
<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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#makeindex">makeindex</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-_003a">:</a>:</td><td> </td><td valign="top"><a href="#Colon-character-_0026-_005ccolon">Colon character & \colon</a></td></tr>
@@ -20763,13 +21597,14 @@
<tr><td></td><td valign="top"><a href="#index-_005cTAB">\TAB</a>:</td><td> </td><td valign="top"><a href="#g_t_005c_0028SPACE_0029">\(SPACE)</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_symbol-5">`</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_0060see_0027-and-_0060see-also_0027-index-entries">‘see’ and ‘see also’ index entries</a>:</td><td> </td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_0060see_0027-and-_0060see-also_0027-index-entries">‘see’ and ‘see also’ index entries</a>:</td><td> </td><td valign="top"><a href="#g_t_005cindex">\index</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> </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> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
@@ -20812,6 +21647,8 @@
<tr><td></td><td valign="top"><a href="#index-babel-package-1"><code>babel</code> <span class="roman">package</span></a>:</td><td> </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> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
@@ -21093,7 +21930,9 @@
<tr><td></td><td valign="top"><a href="#index-global-options">global options</a>:</td><td> </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> </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> </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> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#Graphics-package-configuration">Graphics package configuration</a></td></tr>
@@ -21137,6 +21976,7 @@
<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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
@@ -21150,7 +21990,12 @@
<tr><td></td><td valign="top"><a href="#index-indentfirst-package-3"><code>indentfirst</code> <span class="roman">package</span></a>:</td><td> </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> </td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection & \paragraph & \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> </td><td valign="top"><a href="#g_t_005cindent-_0026-_005cnoindent">\indent & \noindent</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-index-entries_002c-_0060see_0027-and-_0060see-also_0027">index entries, ‘see’ and ‘see also’</a>:</td><td> </td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-index-entries_002c-_0060see_0027-and-_0060see-also_0027">index entries, ‘see’ and ‘see also’</a>:</td><td> </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> </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> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#g_t_005cvfill">\vfill</a></td></tr>
@@ -21248,8 +22093,7 @@
<tr><td></td><td valign="top"><a href="#index-macros2e-package"><code>macros2e</code> <span class="roman">package</span></a>:</td><td> </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> </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> </td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox & \makebox</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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#Marginal-notes">Marginal notes</a></td></tr>
@@ -21348,6 +22192,8 @@
<tr><td></td><td valign="top"><a href="#index-package_002c-babel-1"><span class="roman">package</span>, <code>babel</code></a>:</td><td> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#g_t_005cboldmath-_0026-_005cunboldmath">\boldmath & \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> </td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
@@ -21374,10 +22220,10 @@
<tr><td></td><td valign="top"><a href="#index-package_002c-indentfirst-3"><span class="roman">package</span>, <code>indentfirst</code></a>:</td><td> </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> </td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection & \paragraph & \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> </td><td valign="top"><a href="#g_t_005cindent-_0026-_005cnoindent">\indent & \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> </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> </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> </td><td valign="top"><a href="#verbatim">verbatim</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> </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> </td><td valign="top"><a href="#Indexes">Indexes</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> </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> </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-mfirstuc"><span class="roman">package</span>, <code>mfirstuc</code></a>:</td><td> </td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
@@ -21388,6 +22234,8 @@
<tr><td></td><td valign="top"><a href="#index-package_002c-pict2e"><span class="roman">package</span>, <code>pict2e</code></a>:</td><td> </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> </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> </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> </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> </td><td valign="top"><a href="#g_t_005cindex">\index</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> </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> </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> </td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
@@ -21401,6 +22249,8 @@
<tr><td></td><td valign="top"><a href="#index-package_002c-titlesec-2"><span class="roman">package</span>, <code>titlesec</code></a>:</td><td> </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> </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> </td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection & \paragraph & \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> </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> </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> </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> </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> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
@@ -21452,6 +22302,8 @@
<tr><td></td><td valign="top"><a href="#index-polish-l">polish l</a>:</td><td> </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> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand & \renewcommand</a></td></tr>
@@ -21597,7 +22449,7 @@
<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> </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> </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> </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> </td><td valign="top"><a href="#Tables-of-contents">Tables of contents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-table-of-contents_002c-creating">table of contents, creating</a>:</td><td> </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> </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> </td><td valign="top"><a href="#table">table</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-template_002c-article">template, <code>article</code></a>:</td><td> </td><td valign="top"><a href="#article-template">article template</a></td></tr>
@@ -21641,6 +22493,8 @@
<tr><td></td><td valign="top"><a href="#index-titlesec-package-2"><code>titlesec</code> <span class="roman">package</span></a>:</td><td> </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> </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> </td><td valign="top"><a href="#g_t_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">\subsubsection & \paragraph & \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> </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-tocloft-package"><code>tocloft</code> <span class="roman">package</span></a>:</td><td> </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’s date</a>:</td><td> </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> </td><td valign="top"><a href="#g_t_005crule">\rule</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-trademark-symbol">trademark symbol</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
@@ -21698,7 +22552,7 @@
<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> </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> </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> </td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-xindy-program"><code>xindy</code> program</a>:</td><td> </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: </th><td><a class="summary-letter" href="#Concept-Index_cp_symbol-1"><b>*</b></a>
@@ -21806,6 +22660,8 @@
<a class="summary-letter" href="#Command-Index_fn_letter-F"><b>F</b></a>
+<a class="summary-letter" href="#Command-Index_fn_letter-G"><b>G</b></a>
+
<a class="summary-letter" href="#Command-Index_fn_letter-H"><b>H</b></a>
<a class="summary-letter" href="#Command-Index_fn_letter-I"><b>I</b></a>
@@ -21848,14 +22704,14 @@
<tr><td></td><td valign="top"><a href="#index-_002eaux-file"><code>.aux <span class="roman">file</span></code></a>:</td><td> </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> </td><td valign="top"><a href="#Output-files">Output files</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> </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> </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> </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> </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> </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> </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> </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> </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> </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> </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> </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> </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> </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-4">1</a></th><td></td><td></td></tr>
@@ -21920,7 +22776,7 @@
<tr><td></td><td valign="top"><a href="#index-_005calpha"><code>\alpha</code></a>:</td><td> </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> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -22051,7 +22907,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cdashbox"><code>\dashbox</code></a>:</td><td> </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> </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> </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> </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> </td><td valign="top"><a href="#g_t_005cday-_0026-_005cmonth-_0026-_005cyear">\day & \month & \year</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdblfloatpagefraction"><code>\dblfloatpagefraction</code></a>:</td><td> </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> </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> </td><td valign="top"><a href="#g_t_005ctwocolumn">\twocolumn</a></td></tr>
@@ -22155,8 +23011,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cgeq"><code>\geq</code></a>:</td><td> </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> </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> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
@@ -22201,8 +23056,9 @@
<tr><td></td><td valign="top"><a href="#index-_005cincludeonly"><code>\includeonly</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cinclude-_0026-_005cincludeonly">\include & \includeonly</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cindent"><code>\indent</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cindent-_0026-_005cnoindent">\indent & \noindent</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cindex"><code>\index</code></a>:</td><td> </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> </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> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#g_t_005cinput">\input</a></td></tr>
@@ -22284,8 +23140,8 @@
<tr><td></td><td valign="top"><a href="#index-_005clinethickness"><code>\linethickness</code></a>:</td><td> </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> </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> </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> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
@@ -22304,6 +23160,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cmakebox"><code>\makebox</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox & \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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#g_t_005cmakelabels">\makelabels</a></td></tr>
@@ -22344,7 +23201,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cmid"><code>\mid</code></a>:</td><td> </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> </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> </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> </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> </td><td valign="top"><a href="#g_t_005cday-_0026-_005cmonth-_0026-_005cyear">\day & \month & \year</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cmp"><code>\mp</code></a>:</td><td> </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> </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> </td><td valign="top"><a href="#g_t_005cmulticolumn">\multicolumn</a></td></tr>
@@ -22363,6 +23220,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cnewcounter"><code>\newcounter</code></a>:</td><td> </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> </td><td valign="top"><a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment & \renewenvironment</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnewfont"><code>\newfont</code></a>:</td><td> </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> </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> </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> </td><td valign="top"><a href="#g_t_005cnewline">\newline</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnewpage"><code>\newpage</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cnewpage">\newpage</a></td></tr>
@@ -22375,7 +23233,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cnocite"><code>\nocite</code></a>:</td><td> </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> </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> </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> </td><td valign="top"><a href="#Tables-of-contents">Tables of contents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cnofiles"><code>\nofiles</code></a>:</td><td> </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> </td><td valign="top"><a href="#g_t_005cindent-_0026-_005cnoindent">\indent & \noindent</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnolinebreak"><code>\nolinebreak</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005clinebreak-_0026-_005cnolinebreak">\linebreak & \nolinebreak</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cnonfrenchspacing"><code>\nonfrenchspacing</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfrenchspacing">\frenchspacing</a></td></tr>
@@ -22459,7 +23317,10 @@
<tr><td></td><td valign="top"><a href="#index-_005cprec"><code>\prec</code></a>:</td><td> </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> </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> </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> </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> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -22530,7 +23391,7 @@
<tr><td></td><td valign="top"><a href="#index-_005csec"><code>\sec</code></a>:</td><td> </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> </td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005csection-1"><code>\section</code></a>:</td><td> </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> </td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cseename"><code>\seename</code></a>:</td><td> </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> </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> </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> </td><td valign="top"><a href="#g_t_005csetlength">\setlength</a></td></tr>
@@ -22593,7 +23454,7 @@
<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> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctabbingsep"><code>\tabbingsep</code></a>:</td><td> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -22747,7 +23608,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cwr"><code>\wr</code></a>:</td><td> </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> </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> </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> </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> </td><td valign="top"><a href="#g_t_005cday-_0026-_005cmonth-_0026-_005cyear">\day & \month & \year</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005czeta"><code>\zeta</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</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> </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> </td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
@@ -22810,6 +23671,12 @@
<tr><td></td><td valign="top"><a href="#index-dbltopnumber"><code>dbltopnumber</code></a>:</td><td> </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> </td><td valign="top"><a href="#Floats">Floats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dd"><code>dd</code></a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-delim_005f0"><code>delim_0</code></a>:</td><td> </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> </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> </td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-delim_005fn-_003cstring_003e"><code>delim_n <string></code></a>:</td><td> </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> </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> </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> </td><td valign="top"><a href="#description">description</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> </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> </td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
@@ -22875,13 +23742,26 @@
<tr><td></td><td valign="top"><a href="#index-frame_002c-line-width"><code>frame, line width</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfbox-_0026-_005cframebox">\fbox & \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> </td><td valign="top"><a href="#g_t_005cfbox-_0026-_005cframebox">\fbox & \framebox</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
+<tr><th><a name="Command-Index_fn_letter-G">G</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-group_005fskip"><code>group_skip</code></a>:</td><td> </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> </td><td valign="top"><a href="#About-this-document">About this document</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><td></td><td valign="top"><a href="#index-in"><code>in</code></a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-inch"><code>inch</code></a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-indent_005flength-_003cnumber_003e"><code>indent_length <number></code></a>:</td><td> </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> </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> </td><td valign="top"><a href="#makeindex">makeindex</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> </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> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-item_005fx2-_003cstring_003e"><code>item_x2 <string></code></a>:</td><td> </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><td></td><td valign="top"><a href="#index-landscape-option"><code>landscape <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
@@ -22890,9 +23770,13 @@
<tr><td></td><td valign="top"><a href="#index-latexrefman_0040tug_002eorg-email-address"><code><a href="mailto:latexrefman at tug.org">latexrefman at tug.org</a> <span class="roman">email address</span></code></a>:</td><td> </td><td valign="top"><a href="#About-this-document">About this document</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> </td><td valign="top"><a href="#Document-class-options">Document class options</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> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-lethead_005fflag"><code>lethead_flag</code></a>:</td><td> </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> </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> </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> </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> </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> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-line_005fmax"><code>line_max</code></a>:</td><td> </td><td valign="top"><a href="#makeindex">makeindex</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> </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> </td><td valign="top"><a href="#picture">picture</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-lrbox"><code>lrbox</code></a>:</td><td> </td><td valign="top"><a href="#lrbox">lrbox</a></td></tr>
@@ -22900,6 +23784,8 @@
<tr><td></td><td valign="top"><a href="#index-lualatex-command"><code>lualatex <span class="roman">command</span></code></a>:</td><td> </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><td></td><td valign="top"><a href="#index-makeindex"><code>makeindex</code></a>:</td><td> </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> </td><td valign="top"><a href="#makeindex">makeindex</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> </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> </td><td valign="top"><a href="#Math-formulas">Math formulas</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> </td><td valign="top"><a href="#minipage">minipage</a></td></tr>
@@ -22907,6 +23793,7 @@
<tr><td></td><td valign="top"><a href="#index-mu"><code>mu</code></a>:</td><td> </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-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> </td><td valign="top"><a href="#g_t_005cnewglossaryentry">\newglossaryentry</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> </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_letter-O">O</a></th><td></td><td></td></tr>
@@ -22917,9 +23804,13 @@
<tr><td></td><td valign="top"><a href="#index-openright-option"><code>openright <span class="roman">option</span></code></a>:</td><td> </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_letter-P">P</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-page_005fprecedence"><code>page_precedence</code></a>:</td><td> </td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pc"><code>pc</code></a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</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> </td><td valign="top"><a href="#Output-files">Output files</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> </td><td valign="top"><a href="#picture">picture</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-plural"><code>plural</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cnewglossaryentry">\newglossaryentry</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-postamble"><code>postamble</code></a>:</td><td> </td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-preamble"><code>preamble</code></a>:</td><td> </td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pt"><code>pt</code></a>:</td><td> </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>
@@ -22934,7 +23825,9 @@
<tr><td></td><td valign="top"><a href="#index-secnumdepth-counter"><code>secnumdepth <span class="roman">counter</span></code></a>:</td><td> </td><td valign="top"><a href="#Sectioning">Sectioning</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> </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> </td><td valign="top"><a href="#sloppypar">sloppypar</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-sort"><code>sort</code></a>:</td><td> </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> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-symbol"><code>symbol</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cnewglossaryentry">\newglossaryentry</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><td></td><td valign="top"><a href="#index-tabbing-environment"><code><code>tabbing</code> <span class="roman">environment</span></code></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
@@ -22966,6 +23859,7 @@
<tr><td></td><td valign="top"><a href="#index-xdvi-command"><code>xdvi <span class="roman">command</span></code></a>:</td><td> </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> </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> </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> </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: </th><td><a class="summary-letter" href="#Command-Index_fn_symbol-1"><b>&</b></a>
@@ -23003,6 +23897,8 @@
<a class="summary-letter" href="#Command-Index_fn_letter-F"><b>F</b></a>
+<a class="summary-letter" href="#Command-Index_fn_letter-G"><b>G</b></a>
+
<a class="summary-letter" href="#Command-Index_fn_letter-H"><b>H</b></a>
<a class="summary-letter" href="#Command-Index_fn_letter-I"><b>I</b></a>
Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info 2018-06-21 22:45:36 UTC (rev 661)
+++ trunk/latex2e.info 2018-06-26 16:00:32 UTC (rev 662)
@@ -2012,10 +2012,10 @@
entry.
The optional argument TOC-TITLE will appear as the part title in the
-table of contents (*note Tables of contents::) 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.
+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.
\part[Up from the bottom; my life story]{Up from the bottom\\ my life story}
@@ -2058,8 +2058,8 @@
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 Tables of contents::), and sets
-the running header information (*note Page styles::).
+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,
@@ -2071,7 +2071,7 @@
\chapter*{Preamble}
The optional argument TOC-TITLE will appear as the chapter title in
-the table of contents (*note Tables of contents::) and in running
+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,
@@ -2165,7 +2165,7 @@
the prior section.)
The optional argument TOC-TITLE will appear as the section title in
-the table of contents (*note Tables of contents::) and in running
+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,
@@ -2241,7 +2241,7 @@
contents entry.
The optional argument TOC-TITLE will appear as the section title in
-the table of contents (*note Tables of contents::). If it is not
+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,
@@ -2324,7 +2324,7 @@
number for '\subsubsection').
The optional argument TOC-TITLE will appear as the division title in
-the table of contents (*note Tables of contents::). If it is not
+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
@@ -3376,8 +3376,8 @@
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
@@ -4992,7 +4992,7 @@
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 Tables of contents::).
+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.
@@ -7327,13 +7327,13 @@
* 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
@@ -7510,7 +7510,7 @@
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}'
============================
@@ -7520,19 +7520,27 @@
within", *note \newcounter::.)
-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 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.
+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::).
- The related command '\today' produces a string representing the
-current day (*note \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:
+ \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
@@ -12865,6 +12873,9 @@
\today
\end{document}
+'\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.
@@ -13103,44 +13114,110 @@
* 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 counter 'tocdepth' determines which of parts, chapters, sections,
-etc., are listed (*note Sectioning/tocdepth::).
+ \tableofcontents
+ \listoffigures
+ \listoftables
- 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.
+ 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.
- 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
+ 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
+auxillary 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
+'\renewcommand{\contentsname}{Table of contents}'. Similarly,
+'\renewcommand{\listfigurename}{Plots}' and
+'\renewcommand{\listtablename}{Tables}' 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.
- The command '\nofiles' overrides these commands, and _prevents_ any
-of these lists from being generated.
-
* Menu:
* \addcontentsline:: Add an entry to table of contents, etc.
* \addtocontents:: Add text directly to table of contents file, etc.
+* \nofiles:: Prevent writing to auxillary 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'
-------------------------
@@ -13149,113 +13226,628 @@
\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.
+ The following will result in an 'Appendices' line in the table of
+contents.
+
+ \addcontentsline{toc}{section}{\protect\textbf{Appendices}}
+
+It wll 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 in
+'\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 three arguments. All 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' store information with the
+'\addcontentsline' command, which creates lines in the '.toc' file
+containing the '\contentsline' command (*note \addcontentsline::). In
+contrast, '\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 auxillary files. The only output will
+be the '.log' and '.pdf' (or '.dvi') files. This command must go in the
+preamble.
- The 'glossary' package on CTAN provides support for fancier
-glossaries.
+ 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 auxillary 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.
- The command '\index{TEXT}' writes an index entry for TEXT to an
-auxiliary file named with the '.idx' extension.
+ This shows a document that has an index.
- Specifically, what gets written is the command
-'\indexentry{TEXT}{PAGENO}', where PAGENO is the current '\thepage'
-value.
+ \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
+ ...
- 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.
+The '\usepackage{makeidx}' and '\makeindex' in the preamble bring in the
+relevant commands.
- The text 'See' is defined by the macro '\seename', and 'See also' by
-the macro '\alsoname'. These can be redefined for other languages.
+ Producing an index is a three stage process. First 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::).
- 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.
+ 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>.
- 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.
+* Menu:
- The rubber length '\indexspace' is inserted before each new letter in
-the printed index; its default value is '10pt plus5pt minus3pt'.
+* \index:: Declare an index entry.
+* makeindex:: Alphabetize index entries.
+* \printindex:: Put the index here.
- 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.
+
+File: latex2e.info, Node: \index, Next: makeindex, Up: Indexes
- 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>.
+25.2.1 '\index'
+---------------
+Synopsis:
+
+ \index{INDEX-ENTRY-STRING}
+
+ 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}}'. 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 with
+'\index{Ackermann!function|(definedpage}' and
+'\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 at 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 at 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 '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 <string>'
+ 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 <string>'
+ 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 <number>'
+ 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 very simple
+ but can compute anything that an existing device can compute.
+ It is the standard one 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
26 Letters
@@ -13928,9 +14520,11 @@
* *-form of sectioning commands: Sectioning. (line 31)
* *-form, defining new commands: \newcommand & \renewcommand.
(line 25)
-* .glo file: Glossaries. (line 8)
+* .glo file: Glossaries. (line 43)
* .idx file: Indexes. (line 9)
-* .ind file: Indexes. (line 23)
+* .idx file <1>: makeindex. (line 6)
+* .ind file: makeindex. (line 6)
+* .isty file: makeindex. (line 18)
* :: Colon character & \colon.
(line 6)
* \fboxrule: \fbox & \framebox. (line 38)
@@ -13938,12 +14532,13 @@
* \NEWLINE: \(SPACE). (line 6)
* \SPACE: \(SPACE). (line 6)
* \TAB: \(SPACE). (line 6)
-* 'see' and 'see also' index entries: Indexes. (line 16)
+* 'see' and 'see also' index entries: \index. (line 56)
* 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)
@@ -13988,6 +14583,9 @@
* 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)
@@ -14161,7 +14759,7 @@
* dagger, in text <1>: Text symbols. (line 108)
* date, for titlepage: \maketitle. (line 51)
* date, today's: \today. (line 6)
-* datetime package: \today. (line 24)
+* datetime package: \today. (line 27)
* define color: Define colors. (line 6)
* defining a new command: \newcommand & \renewcommand.
(line 6)
@@ -14324,7 +14922,9 @@
(line 6)
* global options <1>: Additional packages. (line 15)
* glossaries: Glossaries. (line 6)
-* glossary package: Glossaries. (line 15)
+* 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.
@@ -14371,6 +14971,7 @@
(line 20)
* Icelandic thorn: Additional Latin letters.
(line 56)
+* idx file: \index. (line 101)
* ij letter, Dutch: Additional Latin letters.
(line 32)
* implementations of TeX: TeX engines. (line 6)
@@ -14386,7 +14987,12 @@
* indentfirst package <4>: \subsubsection & \paragraph & \subparagraph.
(line 61)
* indentfirst package <5>: \indent & \noindent. (line 48)
-* index entries, 'see' and 'see also': Indexes. (line 16)
+* index entries, 'see' and 'see also': \index. (line 56)
+* index entry: \index. (line 6)
+* index package: \index. (line 96)
+* index, page range: \index. (line 40)
+* index, printing: \printindex. (line 6)
+* index, processing: makeindex. (line 6)
* indexes: Indexes. (line 6)
* infinite horizontal stretch: \hfill. (line 6)
* infinite vertical stretch: \vfill. (line 6)
@@ -14490,8 +15096,7 @@
(line 39)
* Madsen, Lars: eqnarray. (line 6)
* make a box: \mbox & \makebox. (line 6)
-* makeidx package: Indexes. (line 28)
-* makeindex program: Indexes. (line 23)
+* makeindex program: makeindex. (line 6)
* making a title page: titlepage. (line 6)
* making paragraphs: Making paragraphs. (line 6)
* marginal notes: Marginal notes. (line 6)
@@ -14526,7 +15131,7 @@
* mu, math unit: Units of length. (line 49)
* multicolumn text: \twocolumn. (line 6)
* multilingual support: Accents. (line 6)
-* multind package: Indexes. (line 39)
+* multind package: Indexes. (line 35)
* multiplication, discretionary: \*. (line 6)
* NBSP: ~. (line 6)
* nested \include, not allowed: \include & \includeonly.
@@ -14610,6 +15215,9 @@
* 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.
@@ -14618,7 +15226,7 @@
* package, cleveref <1>: \footnotemark. (line 48)
* package, cprotect: verbatim. (line 26)
* package, cprotect <1>: \verb. (line 34)
-* package, datetime: \today. (line 24)
+* package, datetime: \today. (line 27)
* package, enumitem: list. (line 248)
* package, envlab: \makelabels. (line 49)
* package, etoolbox: Class and package commands.
@@ -14642,11 +15250,11 @@
* package, indentfirst <4>: \subsubsection & \paragraph & \subparagraph.
(line 61)
* package, indentfirst <5>: \indent & \noindent. (line 48)
+* package, index: \index. (line 96)
* package, listings: tabbing. (line 145)
* package, listings <1>: verbatim. (line 31)
* package, macros2e: \makeatletter and \makeatother.
(line 39)
-* package, makeidx: Indexes. (line 28)
* package, mathtools: Math formulas. (line 21)
* package, mathtools <1>: Over- and Underlining.
(line 44)
@@ -14656,10 +15264,13 @@
(line 60)
* package, minted: tabbing. (line 145)
* package, minted <1>: verbatim. (line 31)
-* package, multind: Indexes. (line 39)
+* package, multind: Indexes. (line 35)
* package, pict2e: \line. (line 35)
* 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, setspace: Low-level font commands.
(line 118)
* package, showidx: Indexes. (line 35)
@@ -14676,6 +15287,10 @@
* package, titlesec <3>: \subsection. (line 52)
* package, titlesec <4>: \subsubsection & \paragraph & \subparagraph.
(line 65)
+* package, tocbibbind: Table of contents etc..
+ (line 87)
+* package, tocloft: Table of contents etc..
+ (line 87)
* package, ulem: Over- and Underlining.
(line 15)
* package, url: \verb. (line 30)
@@ -14738,6 +15353,9 @@
(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)
@@ -14901,7 +15519,8 @@
* 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)
+* table of contents, creating: Table of contents etc..
+ (line 6)
* table of contents, sectioning numbers printed: Sectioning. (line 73)
* tables, creating: table. (line 6)
* template, article: article template. (line 6)
@@ -14955,6 +15574,10 @@
* titlesec package <3>: \subsection. (line 52)
* titlesec package <4>: \subsubsection & \paragraph & \subparagraph.
(line 65)
+* tocbibbind package: Table of contents etc..
+ (line 87)
+* tocloft package: Table of contents etc..
+ (line 87)
* today's date: \today. (line 6)
* tombstone: \rule. (line 13)
* trademark symbol: Text symbols. (line 178)
@@ -15010,7 +15633,7 @@
* writing letters: Letters. (line 6)
* x-height: Units of length. (line 38)
* XeTeX: TeX engines. (line 38)
-* xindy program: Indexes. (line 23)
+* xindy program: makeindex. (line 153)
File: latex2e.info, Node: Command Index, Prev: Concept Index, Up: Top
@@ -15026,14 +15649,17 @@
* .aux file: Output files. (line 33)
* .dvi file: Output files. (line 10)
* .lof file: Output files. (line 43)
-* .lof file <1>: Tables of contents. (line 19)
+* .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 19)
+* .lot file <1>: Table of contents etc..
+ (line 6)
* .pdf file: Output files. (line 20)
* .tex, default extension: Command line. (line 6)
* .toc file: Output files. (line 43)
-* .toc file <1>: Tables of contents. (line 6)
+* .toc file <1>: Table of contents etc..
+ (line 6)
* .xdv file: TeX engines. (line 38)
* 10pt option: Document class options.
(line 14)
@@ -15107,7 +15733,7 @@
(line 14)
* \Alph{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
(line 19)
-* \alsoname: Indexes. (line 20)
+* \alsoname: \index. (line 56)
* \amalg: Math symbols. (line 33)
* \and for \author: \maketitle. (line 43)
* \angle: Math symbols. (line 36)
@@ -15249,7 +15875,7 @@
(line 9)
* \complement: Math symbols. (line 140)
* \cong: Math symbols. (line 146)
-* \contentsline: \addcontentsline. (line 33)
+* \contentsline: \addcontentsline. (line 10)
* \coprod: Math symbols. (line 149)
* \copyright: Text symbols. (line 11)
* \cos: Math functions. (line 24)
@@ -15266,7 +15892,8 @@
* \dashbox: \dashbox. (line 6)
* \dashv: Math symbols. (line 160)
* \date{TEXT}: \maketitle. (line 50)
-* \day: \day \month \year. (line 6)
+* \day: \day & \month & \year.
+ (line 6)
* \dblfloatpagefraction: \twocolumn. (line 69)
* \dblfloatsep: \twocolumn. (line 75)
* \dbltextfloatsep: \twocolumn. (line 82)
@@ -15395,8 +16022,7 @@
* \geq: Math symbols. (line 240)
* \gets: Math symbols. (line 244)
* \gg: Math symbols. (line 247)
-* \glossary: Glossaries. (line 8)
-* \glossaryentry: Glossaries. (line 11)
+* \gls: \gls. (line 6)
* \graphicspath: \graphicspath. (line 6)
* \graphpaper: \graphpaper. (line 6)
* \grave: Math accents. (line 28)
@@ -15455,8 +16081,9 @@
(line 6)
* \indent: \indent & \noindent. (line 6)
* \index: Indexes. (line 9)
-* \indexentry: Indexes. (line 12)
-* \indexspace: Indexes. (line 32)
+* \index <1>: \index. (line 6)
+* \indexentry: \index. (line 101)
+* \indexspace: makeindex. (line 58)
* \inf: Math functions. (line 57)
* \infty: Math symbols. (line 279)
* \input: \input. (line 6)
@@ -15545,8 +16172,10 @@
(line 33)
* \linewidth <1>: Page layout parameters.
(line 34)
-* \listoffigures: Tables of contents. (line 19)
-* \listoftables: Tables of contents. (line 19)
+* \listoffigures: Table of contents etc..
+ (line 6)
+* \listoftables: Table of contents etc..
+ (line 6)
* \listparindent: list. (line 136)
* \ll: Math symbols. (line 378)
* \ln: Math functions. (line 75)
@@ -15568,6 +16197,7 @@
* \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 55)
* \makelabels: \makelabels. (line 6)
@@ -15617,7 +16247,8 @@
* \mid: Math symbols. (line 416)
* \min: Math functions. (line 84)
* \models: Math symbols. (line 426)
-* \month: \day \month \year. (line 6)
+* \month: \day & \month & \year.
+ (line 6)
* \mp: Math symbols. (line 431)
* \mu: Math symbols. (line 434)
* \multicolumn: \multicolumn. (line 6)
@@ -15641,6 +16272,7 @@
* \newenvironment: \newenvironment & \renewenvironment.
(line 6)
* \newfont: \newfont. (line 6)
+* \newglossaryentry: \newglossaryentry. (line 6)
* \newlength: \newlength. (line 6)
* \newline: \newline. (line 6)
* \newpage: \newpage. (line 6)
@@ -15655,7 +16287,7 @@
* \nocite: \nocite. (line 6)
* \nocorr: Font styles. (line 21)
* \nocorrlist: Font styles. (line 21)
-* \nofiles: Tables of contents. (line 24)
+* \nofiles: \nofiles. (line 6)
* \noindent: \indent & \noindent. (line 6)
* \nolinebreak: \linebreak & \nolinebreak.
(line 6)
@@ -15769,7 +16401,10 @@
* \prec: Math symbols. (line 539)
* \preceq: Math symbols. (line 542)
* \prime: Math symbols. (line 547)
-* \printindex: Indexes. (line 28)
+* \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)
* \ProcessOptions*: Class and package commands.
@@ -15855,7 +16490,7 @@
* \sec: Math functions. (line 93)
* \section: Sectioning. (line 6)
* \section <1>: \section. (line 6)
-* \seename: Indexes. (line 20)
+* \seename: \index. (line 56)
* \selectfont: Low-level font commands.
(line 131)
* \setcounter: \setcounter. (line 6)
@@ -15926,7 +16561,8 @@
* \t (tie-after accent): Accents. (line 81)
* \tabbingsep: tabbing. (line 121)
* \tabcolsep: tabular. (line 172)
-* \tableofcontents: Tables of contents. (line 6)
+* \tableofcontents: Table of contents etc..
+ (line 6)
* \tan: Math functions. (line 105)
* \tanh: Math functions. (line 108)
* \tau: Math symbols. (line 736)
@@ -16097,7 +16733,8 @@
* \wr: Math symbols. (line 901)
* \Xi: Math symbols. (line 904)
* \xi: Math symbols. (line 907)
-* \year: \day \month \year. (line 6)
+* \year: \day & \month & \year.
+ (line 6)
* \zeta: Math symbols. (line 910)
* \\ (for center): center. (line 22)
* \\ (for eqnarray): eqnarray. (line 29)
@@ -16151,6 +16788,12 @@
* dbltopnumber: Floats. (line 134)
* dbltopnumber <1>: Floats. (line 135)
* dd: Units of length. (line 30)
+* delim_0: makeindex. (line 110)
+* delim_1: makeindex. (line 114)
+* delim_2: makeindex. (line 118)
+* delim_n <string>: makeindex. (line 122)
+* delim_r: makeindex. (line 126)
+* description: \newglossaryentry. (line 46)
* description environment: description. (line 6)
* displaymath environment: displaymath. (line 6)
* displaymath environment <1>: Math formulas. (line 6)
@@ -16215,11 +16858,22 @@
* frame rule width: \fbox & \framebox. (line 38)
* frame, line width: \fbox & \framebox. (line 38)
* frame, separation from contents: \fbox & \framebox. (line 43)
+* group_skip: makeindex. (line 57)
* <http://puszcza.gnu.org.ua/software/latexrefman/> home page: About this document.
(line 6)
* in: Units of length. (line 17)
* inch: Units of length. (line 17)
+* indent_length <number>: makeindex. (line 138)
+* indent_space: makeindex. (line 134)
+* index, style file: makeindex. (line 18)
* 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 <string>: makeindex. (line 104)
* landscape option: Document class options.
(line 49)
* latex command: Output files. (line 10)
@@ -16229,20 +16883,27 @@
(line 19)
* leqno option: Document class options.
(line 49)
+* 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)
+* line_max: makeindex. (line 130)
* list environment: list. (line 6)
* LR box: picture. (line 103)
* lrbox: lrbox. (line 6)
* lshort document: About this document. (line 41)
* lualatex command: TeX engines. (line 29)
+* makeindex: makeindex. (line 6)
+* makeindex, style file: makeindex. (line 18)
* math environment: math. (line 6)
* math environment <1>: Math formulas. (line 6)
* minipage environment: minipage. (line 6)
* mm: Units of length. (line 27)
* mu: Units of length. (line 49)
+* name: \newglossaryentry. (line 43)
* notitlepage option: Document class options.
(line 49)
* onecolumn option: Document class options.
@@ -16255,9 +16916,13 @@
(line 49)
* openright option: Document class options.
(line 78)
+* page_precedence: makeindex. (line 143)
* pc: Units of length. (line 14)
* pdflatex command: Output files. (line 20)
* picture environment: picture. (line 6)
+* plural: \newglossaryentry. (line 51)
+* postamble: makeindex. (line 54)
+* preamble: makeindex. (line 50)
* pt: Units of length. (line 10)
* quotation environment: quotation & quote. (line 6)
* quote environment: quotation & quote. (line 6)
@@ -16266,7 +16931,9 @@
* secnumdepth counter: Sectioning. (line 62)
* slides class: Document classes. (line 11)
* sloppypar: sloppypar. (line 6)
+* sort: \newglossaryentry. (line 55)
* sp: Units of length. (line 36)
+* symbol: \newglossaryentry. (line 59)
* tabbing environment: tabbing. (line 6)
* table environment: table. (line 6)
* tabular environment: tabular. (line 6)
@@ -16294,6 +16961,7 @@
* xdvi command: Output files. (line 10)
* xdvipdfmx: TeX engines. (line 38)
* xelatex command: TeX engines. (line 38)
+* xindy: makeindex. (line 153)
@@ -16332,261 +17000,267 @@
Ref: Sectioning/secnumdepth80334
Ref: Sectioning/tocdepth80945
Node: \part81990
-Node: \chapter84173
-Node: \section87967
-Node: \subsection91255
-Node: \subsubsection & \paragraph & \subparagraph93979
-Node: \appendix96632
-Node: \frontmatter & \mainmatter & \backmatter97873
-Node: \@startsection99215
-Ref: \@startsection/name100536
-Ref: \@startsection/level100996
-Ref: \@startsection/indent101879
-Ref: \@startsection/beforeskip102142
-Ref: \@startsection/afterskip103663
-Ref: \@startsection/style104974
-Node: Cross references108809
-Node: \label110909
-Node: \pageref112706
-Node: \ref113506
-Node: Environments114383
-Node: abstract116386
-Node: array117975
-Node: center120370
-Node: \centering122098
-Node: description123542
-Node: displaymath125729
-Node: document127507
-Node: \AtBeginDocument127937
-Node: \AtEndDocument128561
-Node: enumerate129205
-Node: eqnarray131999
-Node: equation133994
-Node: figure134622
-Node: filecontents136693
-Node: flushleft138443
-Node: \raggedright139372
-Node: flushright140570
-Node: \raggedleft141233
-Node: itemize142023
-Node: letter145488
-Node: list145726
-Node: \item158544
-Node: trivlist159795
-Node: math161323
-Node: minipage161629
-Node: picture166486
-Node: \put172920
-Node: \multiput173398
-Node: \qbezier174118
-Node: \graphpaper175046
-Node: \line175843
-Node: \linethickness177622
-Node: \thinlines178071
-Node: \thicklines178482
-Node: \circle178866
-Node: \oval179406
-Node: \shortstack180385
-Node: \vector181787
-Node: \makebox (picture)182630
-Node: \framebox (picture)183559
-Node: \frame184354
-Node: \dashbox184753
-Node: quotation & quote185479
-Node: tabbing186375
-Node: table192380
-Node: tabular194401
-Node: \multicolumn201651
-Node: \vline205536
-Node: \cline206881
-Node: \hline207565
-Node: thebibliography208247
-Node: \bibitem210660
-Node: \cite212938
-Node: \nocite214591
-Node: Using BibTeX215080
-Node: theorem217027
-Node: titlepage217949
-Node: verbatim219232
-Node: \verb220742
-Node: verse222211
-Node: Line breaking223441
-Node: \\224807
-Node: \obeycr & \restorecr227256
-Node: \newline228056
-Node: \- (hyphenation)228994
-Node: \discretionary230635
-Node: \fussy & \sloppy231523
-Node: sloppypar232305
-Node: \hyphenation233444
-Node: \linebreak & \nolinebreak234029
-Node: Page breaking235100
-Node: \clearpage & \cleardoublepage237129
-Node: \newpage238607
-Node: \enlargethispage239900
-Node: \pagebreak & \nopagebreak240856
-Node: Footnotes242439
-Node: \footnote243585
-Node: \footnotemark246533
-Node: \footnotetext248878
-Node: Footnotes in section headings249479
-Node: Footnotes in a table250306
-Node: Footnotes of footnotes253184
-Node: Definitions253888
-Node: \newcommand & \renewcommand254765
-Node: \providecommand259979
-Node: \newcounter261128
-Node: \newlength262873
-Node: \newsavebox263733
-Node: \newenvironment & \renewenvironment264677
-Node: \newtheorem269802
-Node: \newfont273330
-Node: \protect274626
-Node: \ignorespaces & \ignorespacesafterend277012
-Node: Counters279758
-Node: \alph \Alph \arabic \roman \Roman \fnsymbol281431
-Node: \usecounter284259
-Node: \value285122
-Node: \setcounter286051
-Node: \addtocounter286653
-Node: \refstepcounter287118
-Node: \stepcounter287776
-Node: \day \month \year288118
-Node: Lengths288663
-Node: Units of length293099
-Ref: Lengths/em293736
-Ref: Lengths/en293736
-Ref: Lengths/ex293736
-Node: \setlength294592
-Node: \addtolength295369
-Node: \settodepth296343
-Node: \settoheight297098
-Node: \settowidth297857
-Node: Predefined lengths298639
-Node: Making paragraphs299154
-Node: \par300809
-Node: \indent & \noindent302647
-Node: \parindent & \parskip304199
-Node: Marginal notes305237
-Node: Math formulas307036
-Node: Subscripts & superscripts311023
-Node: Math symbols313132
-Node: Blackboard bold339502
-Node: Calligraphic340277
-Node: \boldmath & \unboldmath340849
-Node: Ellipses342379
-Node: Math functions344533
-Node: Math accents346141
-Node: Over- and Underlining347040
-Node: Spacing in math mode348868
-Ref: Spacing in math mode/\thinspace349875
-Ref: Spacing in math mode/\quad350556
-Ref: Spacing in math mode/\qquad350812
-Node: Math miscellany350910
-Node: Colon character & \colon351469
-Node: \*352162
-Node: \frac352746
-Node: \left & \right353159
-Node: \sqrt354336
-Node: \stackrel354931
-Node: Modes355204
-Node: \ensuremath357818
-Node: Page styles358535
-Node: \maketitle359298
-Node: \pagenumbering362308
-Node: \pagestyle364245
-Node: \thispagestyle367750
-Node: Spaces368137
-Node: \enspace & \quad & \qquad369578
-Node: \hspace370525
-Node: \hfill372339
-Node: \hss373395
-Node: \spacefactor374092
-Node: \@377481
-Ref: \AT377581
-Node: \frenchspacing379524
-Node: \normalsfcodes380359
-Node: \(SPACE)380606
-Node: ~382241
-Node: \thinspace & \negthinspace384720
-Node: \/385663
-Node: \hrulefill & \dotfill386969
-Node: \bigskip & \medskip & \smallskip388305
-Node: \bigbreak & \medbreak & \smallbreak390197
-Node: \strut391182
-Node: \vspace394368
-Node: \vfill395925
-Node: \addvspace396803
-Node: Boxes398800
-Node: \mbox & \makebox399636
-Node: \fbox & \framebox402811
-Node: \parbox405335
-Node: \raisebox407615
-Node: \sbox & \savebox409273
-Node: lrbox412235
-Node: \usebox413057
-Node: Color413407
-Node: Color package options414251
-Node: Color models415897
-Node: Commands for color418206
-Node: Define colors418621
-Node: Colored text419336
-Node: Colored boxes421708
-Node: Colored pages423142
-Node: Graphics423835
-Node: Graphics package options425962
-Node: Graphics package configuration428715
-Node: \graphicspath429517
-Node: \DeclareGraphicsExtensions432440
-Node: \DeclareGraphicsRule434237
-Node: Commands for graphics437426
-Node: \includegraphics437931
-Node: \rotatebox450900
-Node: \scalebox453695
-Node: \resizebox454747
-Node: Special insertions455939
-Node: Reserved characters456741
-Node: Upper and lower case457942
-Node: Symbols by font position459857
-Node: Text symbols460477
-Node: Accents464325
-Node: Additional Latin letters466340
-Ref: Non-English characters466511
-Node: \rule467528
-Node: \today468645
-Node: Splitting the input469490
-Node: \endinput471042
-Node: \include & \includeonly472309
-Node: \input476533
-Node: Front/back matter477241
-Node: Tables of contents477446
-Node: \addcontentsline478629
-Node: \addtocontents479647
-Node: Glossaries480180
-Node: Indexes480699
-Node: Letters482332
-Node: \address485998
-Node: \cc486809
-Node: \closing487227
-Node: \encl487504
-Node: \location487919
-Node: \makelabels488183
-Node: \name490335
-Node: \opening490576
-Node: \ps490857
-Node: \signature491146
-Node: \telephone492363
-Node: Terminal input/output492728
-Node: \typein492993
-Node: \typeout493728
-Node: Command line494335
-Node: Document templates495287
-Node: beamer template495740
-Node: article template496394
-Node: book template496821
-Node: Larger book template497302
-Node: tugboat template498788
-Node: Concept Index501159
-Node: Command Index580039
+Node: \chapter84178
+Node: \section87980
+Node: \subsection91272
+Node: \subsubsection & \paragraph & \subparagraph94000
+Node: \appendix96657
+Node: \frontmatter & \mainmatter & \backmatter97898
+Node: \@startsection99240
+Ref: \@startsection/name100561
+Ref: \@startsection/level101021
+Ref: \@startsection/indent101904
+Ref: \@startsection/beforeskip102167
+Ref: \@startsection/afterskip103688
+Ref: \@startsection/style104999
+Node: Cross references108834
+Node: \label110934
+Node: \pageref112731
+Node: \ref113531
+Node: Environments114408
+Node: abstract116411
+Node: array118000
+Node: center120395
+Node: \centering122123
+Node: description123567
+Node: displaymath125754
+Node: document127532
+Node: \AtBeginDocument127962
+Node: \AtEndDocument128586
+Node: enumerate129230
+Node: eqnarray132024
+Node: equation134019
+Node: figure134647
+Node: filecontents136722
+Node: flushleft138472
+Node: \raggedright139401
+Node: flushright140599
+Node: \raggedleft141262
+Node: itemize142052
+Node: letter145517
+Node: list145755
+Node: \item158573
+Node: trivlist159824
+Node: math161352
+Node: minipage161658
+Node: picture166515
+Node: \put172949
+Node: \multiput173427
+Node: \qbezier174147
+Node: \graphpaper175075
+Node: \line175872
+Node: \linethickness177651
+Node: \thinlines178100
+Node: \thicklines178511
+Node: \circle178895
+Node: \oval179435
+Node: \shortstack180414
+Node: \vector181816
+Node: \makebox (picture)182659
+Node: \framebox (picture)183588
+Node: \frame184383
+Node: \dashbox184782
+Node: quotation & quote185508
+Node: tabbing186404
+Node: table192409
+Node: tabular194434
+Node: \multicolumn201684
+Node: \vline205569
+Node: \cline206914
+Node: \hline207598
+Node: thebibliography208280
+Node: \bibitem210693
+Node: \cite212971
+Node: \nocite214624
+Node: Using BibTeX215113
+Node: theorem217060
+Node: titlepage217982
+Node: verbatim219265
+Node: \verb220775
+Node: verse222244
+Node: Line breaking223474
+Node: \\224840
+Node: \obeycr & \restorecr227289
+Node: \newline228089
+Node: \- (hyphenation)229027
+Node: \discretionary230668
+Node: \fussy & \sloppy231556
+Node: sloppypar232338
+Node: \hyphenation233477
+Node: \linebreak & \nolinebreak234062
+Node: Page breaking235133
+Node: \clearpage & \cleardoublepage237162
+Node: \newpage238640
+Node: \enlargethispage239933
+Node: \pagebreak & \nopagebreak240889
+Node: Footnotes242472
+Node: \footnote243618
+Node: \footnotemark246566
+Node: \footnotetext248911
+Node: Footnotes in section headings249512
+Node: Footnotes in a table250339
+Node: Footnotes of footnotes253217
+Node: Definitions253921
+Node: \newcommand & \renewcommand254798
+Node: \providecommand260012
+Node: \newcounter261161
+Node: \newlength262906
+Node: \newsavebox263766
+Node: \newenvironment & \renewenvironment264710
+Node: \newtheorem269835
+Node: \newfont273363
+Node: \protect274659
+Node: \ignorespaces & \ignorespacesafterend277045
+Node: Counters279791
+Node: \alph \Alph \arabic \roman \Roman \fnsymbol281492
+Node: \usecounter284320
+Node: \value285183
+Node: \setcounter286112
+Node: \addtocounter286714
+Node: \refstepcounter287179
+Node: \stepcounter287837
+Node: \day & \month & \year288183
+Node: Lengths288997
+Node: Units of length293433
+Ref: Lengths/em294070
+Ref: Lengths/en294070
+Ref: Lengths/ex294070
+Node: \setlength294926
+Node: \addtolength295703
+Node: \settodepth296677
+Node: \settoheight297432
+Node: \settowidth298191
+Node: Predefined lengths298973
+Node: Making paragraphs299488
+Node: \par301143
+Node: \indent & \noindent302981
+Node: \parindent & \parskip304533
+Node: Marginal notes305571
+Node: Math formulas307370
+Node: Subscripts & superscripts311357
+Node: Math symbols313466
+Node: Blackboard bold339836
+Node: Calligraphic340611
+Node: \boldmath & \unboldmath341183
+Node: Ellipses342713
+Node: Math functions344867
+Node: Math accents346475
+Node: Over- and Underlining347374
+Node: Spacing in math mode349202
+Ref: Spacing in math mode/\thinspace350209
+Ref: Spacing in math mode/\quad350890
+Ref: Spacing in math mode/\qquad351146
+Node: Math miscellany351244
+Node: Colon character & \colon351803
+Node: \*352496
+Node: \frac353080
+Node: \left & \right353493
+Node: \sqrt354670
+Node: \stackrel355265
+Node: Modes355538
+Node: \ensuremath358152
+Node: Page styles358869
+Node: \maketitle359632
+Node: \pagenumbering362642
+Node: \pagestyle364579
+Node: \thispagestyle368084
+Node: Spaces368471
+Node: \enspace & \quad & \qquad369912
+Node: \hspace370859
+Node: \hfill372673
+Node: \hss373729
+Node: \spacefactor374426
+Node: \@377815
+Ref: \AT377915
+Node: \frenchspacing379858
+Node: \normalsfcodes380693
+Node: \(SPACE)380940
+Node: ~382575
+Node: \thinspace & \negthinspace385054
+Node: \/385997
+Node: \hrulefill & \dotfill387303
+Node: \bigskip & \medskip & \smallskip388639
+Node: \bigbreak & \medbreak & \smallbreak390531
+Node: \strut391516
+Node: \vspace394702
+Node: \vfill396259
+Node: \addvspace397137
+Node: Boxes399134
+Node: \mbox & \makebox399970
+Node: \fbox & \framebox403145
+Node: \parbox405669
+Node: \raisebox407949
+Node: \sbox & \savebox409607
+Node: lrbox412569
+Node: \usebox413391
+Node: Color413741
+Node: Color package options414585
+Node: Color models416231
+Node: Commands for color418540
+Node: Define colors418955
+Node: Colored text419670
+Node: Colored boxes422042
+Node: Colored pages423476
+Node: Graphics424169
+Node: Graphics package options426296
+Node: Graphics package configuration429049
+Node: \graphicspath429851
+Node: \DeclareGraphicsExtensions432774
+Node: \DeclareGraphicsRule434571
+Node: Commands for graphics437760
+Node: \includegraphics438265
+Node: \rotatebox451234
+Node: \scalebox454029
+Node: \resizebox455081
+Node: Special insertions456273
+Node: Reserved characters457075
+Node: Upper and lower case458276
+Node: Symbols by font position460191
+Node: Text symbols460811
+Node: Accents464659
+Node: Additional Latin letters466674
+Ref: Non-English characters466845
+Node: \rule467862
+Node: \today468979
+Node: Splitting the input469915
+Node: \endinput471467
+Node: \include & \includeonly472734
+Node: \input476958
+Node: Front/back matter477666
+Node: Table of contents etc.477999
+Node: \addcontentsline481691
+Node: \addtocontents484407
+Node: \nofiles485967
+Node: Indexes486699
+Node: \index488401
+Node: makeindex493470
+Node: \printindex499203
+Node: Glossaries499675
+Node: \newglossaryentry501649
+Node: \gls503118
+Node: Letters503915
+Node: \address507581
+Node: \cc508392
+Node: \closing508810
+Node: \encl509087
+Node: \location509502
+Node: \makelabels509766
+Node: \name511918
+Node: \opening512159
+Node: \ps512440
+Node: \signature512729
+Node: \telephone513946
+Node: Terminal input/output514311
+Node: \typein514576
+Node: \typeout515311
+Node: Command line515918
+Node: Document templates516870
+Node: beamer template517323
+Node: article template517977
+Node: book template518404
+Node: Larger book template518885
+Node: tugboat template520371
+Node: Concept Index522742
+Node: Command Index603813
End Tag Table
Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2018-06-21 22:45:36 UTC (rev 661)
+++ trunk/latex2e.texi 2018-06-26 16:00:32 UTC (rev 662)
@@ -32,6 +32,7 @@
@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
+ at c xx JH \contentsline, \@@dottedtocline?
@c
@c xx The typeset source2e has an index with all kernel
@c xx commands, though some are internal and shouldn't be included.
@@ -2679,7 +2680,7 @@
@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{Tables of contents}) and in running
+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.
@@ -2735,8 +2736,8 @@
@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{Tables of contents}), and sets the running header information
-(@pxref{Page styles}).
+(@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
@@ -2750,9 +2751,10 @@
@end example
The optional argument @var{toc-title} will appear as the chapter title
-in the table of contents (@pxref{Tables of contents}) 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,
+in the table of contents (@pxref{Table of contents etc.}) and in
+running headers (@pxref{Page styles}). If it is not present then
+ at var{title} will be there. This shows the full name in the chapter
+title,
@example
\chapter[Weyl]@{Hermann Klaus Hugo (Peter) Weyl (1885--1955)@}
@@ -2862,9 +2864,10 @@
prior section.)
The optional argument @var{toc-title} will appear as the section title
-in the table of contents (@pxref{Tables of contents}) 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,
+in the table of contents (@pxref{Table of contents etc.}) and in
+running headers (@pxref{Page styles}). If it is not present then
+ at var{title} will be there. This shows the full name in the title of the
+section,
@example
\section[Elizabeth~II]@{Elizabeth the Second,
@@ -2953,9 +2956,9 @@
@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{Tables of contents}). If it is not
-present then @var{title} will be there. This shows the full name in the
-title of the section,
+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
@@ -3060,8 +3063,8 @@
show the number for @code{\subsubsection}).
The optional argument @var{toc-title} will appear as the division title
-in the table of contents (@pxref{Tables of contents}). If it is not
-present then @var{title} will be there.
+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 at tie{}3, of
@@ -4328,8 +4331,8 @@
@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
@@ -6225,7 +6228,7 @@
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{Tables of contents}).
+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.
@@ -8979,13 +8982,13 @@
@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
@@ -9212,23 +9215,32 @@
``counters numbered within'', @pxref{\newcounter}.)
- at node \day \month \year
- at section @code{\day \month \year}: Predefined counters
+ at node \day & \month & \year
+ at section @code{\day} & @code{\month} & @code{\year}
@findex \day
@findex \month
@findex \year
- at 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.
+ at 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:
+ at example
+\day=-2 \month=13 \year=-4 \today
+ at end example
+gives no error or warning and results in the output @samp{-2, -4} (the
+bogus month value produces no output).
+
+
@node Lengths
@chapter Lengths
@@ -15838,8 +15850,6 @@
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}.
- at c It uses the predefined counters @code{\day}, @code{\month}, and
- at c @code{\year} (@pxref{\day \month \year}) to do this.
@PkgIndex{babel}
@PkgIndex{polyglossia}
@@ -15856,6 +15866,10 @@
\end@{document@}
@end example
+ at noindent
+ at code{\today} uses the counters @code{\day}, @code{\month}, and
+ at code{\year} (@pxref{\day & \month & \year}).
+
@PkgIndex{datetime}
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.
@@ -16125,48 +16139,130 @@
@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
- at node Tables of contents
- at section Tables of contents
+ at node Table of contents etc.
+ at 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 counter @code{tocdepth} determines which of parts, chapters,
-sections, etc., are listed (@pxref{Sectioning/tocdepth}).
-
-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
- at 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
- at file{.lot} files), respectively. Everything works exactly the same
-as for the table of contents.
- at findex \nofiles
-The command @code{\nofiles} overrides these commands, and
- at emph{prevents} any of these lists from being generated.
+Synopsis, one of:
+ at example
+\tableofcontents
+\listoffigures
+\listoftables
+ at 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}.
+ at LaTeX{} will produce a table of contents on the book's first page.
+
+ at example
+\documentclass@{book@}
+% \setcounter@{tocdepth@}@{1@}
+\begin@{document@}
+\tableofcontents\newpage
+ ...
+\chapter@{...@}
+ ...
+\section@{...@}
+ ...
+\subsection@{...@}
+ ...
+\end@{document@}
+ at end example
+
+ at noindent
+Uncommenting the second line would cause that table to contain chapter
+and section listings but not subsection listings, because the
+ at code{\section} command has level at tie{}1. @xref{Sectioning} for level
+numbers of the sectioning units. For more on the @code{tocdepth}
+ at 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
+ at code{\newpage} command after the @code{\tableofcontents} command, as
+above.
+
+To make the table of contents @LaTeX{} stores the information in an
+auxillary file named @file{@var{root-file}.toc} (@pxref{Splitting the
+input}). For example, this @LaTeX{} file @file{test.tex}
+
+ at example
+\documentclass@{article@}
+\begin@{document@}
+\tableofcontents\newpage
+\section@{First section@}
+\subsection@{First subsection@}
+ ...
+ at end example
+
+writes the following line to @file{test.toc}.
+
+ at example
+\contentsline @{section@}@{\numberline @{1@}First section@}@{2@}
+\contentsline @{subsection@}@{\numberline @{1.1@}First subsection@}@{2@}
+ at end example
+
+ at 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
+ at file{.lof} and @file{.lot} files.
+
+ at PkgIndex{babel}
+ at PkgIndex{polyglossia}
+To change the header for the table of contents page do something like
+ at code{\renewcommand@{\contentsname@}@{Table of contents@}}. Similarly,
+ at code{\renewcommand@{\listfigurename@}@{Plots@}} and
+ at code{\renewcommand@{\listtablename@}@{Tables@}} will do the other two.
+Internationalization packages such as @file{babel} or @file{polyglossia}
+will change the headers depending on the chosen base language.
+
+ at PkgIndex{tocloft}
+ at 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 auxillary files
@end menu
@@ -16182,39 +16278,87 @@
\addcontentsline@{@var{ext}@}@{@var{unit}@}@{@var{text}@}
@end example
-The @code{\addcontentsline} command adds an entry to the specified list
-or table where:
+ at findex \contentsline
+Add an entry to the file specified by @var{ext}.
+The following will result in an @samp{Appendices} line in the table of
+contents.
+
+ at example
+\addcontentsline@{toc@}@{section@}@{\protect\textbf@{Appendices@}@}
+ at end example
+
+ at noindent
+It wll 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
+ at file{@var{root-name}. at var{ext}}. It writes that information as the
+text of the command
+ at code{\contentsline@{@var{unit}@}@{@var{text}@}@{@var{num}@}}, where
+ at 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.
+
+ at example
+\chapter*@{Preface@}
+\addcontentsline@{toc@}@{chapter@}@{\protect\numberline@{@}Preface@}
+ at end example
+
+ at noindent
+In the @file{.toc} file @LaTeX{} will put the line @code{\contentsline
+@{chapter@}@{\numberline @{@}Preface@}@{3@}}; note the page number
+ at samp{3}.
+
+ at 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,
+ at 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},
- at code{section}, @code{subsection}, @code{subsubsection}.
+For the table of contents, this is the name of a sectional unit:
+ at 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
- at findex \contentsline
-What is written to the @file{. at var{ext}} file is the command
- at code{\contentsline@{@var{unit}@}@{@var{text}@}@{@var{num}@}}, where
- at code{@var{num}} is the current value of counter @code{@var{unit}}.
+The @code{\addcontentsline} command has an interaction with
+ at code{\include} (@pxref{\include & \includeonly}). If you use them at
+the same level, as with
+ at 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.
- at c xx how hardwired are these values? other unit names?
+If you use a @var{unit} that @LaTeX{} does not recognize, as in
+ at code{\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.
@node \addtocontents
@@ -16222,44 +16366,86 @@
@findex \addtocontents@{@var{ext}@}@{@var{text}@}
-The @code{\addtocontents}@{@var{ext}@}@{@var{text}@} command adds text
-(or formatting commands) directly to the @file{. at var{ext}} file that
-generates the table of contents or lists of figures or tables.
+Synopsis:
+ at example
+\addtocontents@{@var{ext}@}@{@var{text}@}
+ at 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
+ at samp{Contents} header.
+
+ at example
+\tableofcontents\newpage
+\addtocontents@{toc@}@{\protect\vspace*@{3ex@}@}
+ at end example
+
+The @code{\addtocontents} command has three arguments. All 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} store information with
+the @code{\addcontentsline} command, which creates lines in the
+ at file{.toc} file containing the @code{\contentsline} command
+(@pxref{\addcontentsline}). In contrast, @code{\addtocontents} puts
+material directly in that file.
- at node Glossaries
- at section Glossaries
+The @code{\addtocontents} command has an interaction with
+ at code{\include} (@pxref{\include & \includeonly}). If you use them at
+the same level, as with
+ at 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.
- at cindex glossaries
- at findex \makeglossary
-The command @code{\makeglossary} enables creating glossaries.
+ at node \nofiles
+ at subsection @code{\nofiles}
- at findex \glossary
- at cindex @file{.glo} file
-The command @code{\glossary@{@var{text}@}} writes a glossary entry for
- at var{text} to an auxiliary file with the @file{.glo} extension.
+ at findex \nofiles
- at findex \glossaryentry
-Specifically, what gets written is the command
- at code{\glossaryentry@{@var{text}@}@{@var{pageno}@}}, where
- at var{pageno} is the current @code{\thepage} value.
+Synopsis:
- at cindex glossary @r{package}
-The @code{glossary} package on CTAN provides support for fancier
-glossaries.
+ at example
+\nofiles
+ at end example
+Prevent @LaTeX{} from writing any auxillary 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
+ at file{.toc} file.
+
+ at example
+\documentclass@{book@}
+\nofiles
+\begin@{document@}
+\tableofcontents\newpage
+\chapter@{...@}
+ ...
+ at end example
+
+ at noindent
+ at LaTeX{} will not erase any existing auxillary 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
@section Indexes
@@ -16271,58 +16457,572 @@
@findex \index
@cindex @file{.idx} file
-The command @code{\index@{@var{text}@}} writes an index entry for
- at var{text} to an auxiliary file named with the @file{.idx} extension.
- at findex \indexentry
-Specifically, what gets written is the command
- at code{\indexentry@{@var{text}@}@{@var{pageno}@}}, where @var{pageno}
-is the current @code{\thepage} value.
+This shows a document that has an index.
+ at 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
+ ...
+ at end example
+
+ at 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 you declare index
+entries with the @code{\index} command (@pxref{\index}). When you run
+ at LaTeX{}, the @code{\index} writes its information to an auxiliary file
+ at 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
+ at file{@var{root-name}.ind}. Finally, you bring the information back
+into your document and typeset it with the @code{\printindex} command
+(@pxref{\printindex}).
+
+ at PkgIndex{showidx}
+ at PkgIndex{multind}
+There are many packages that apply to indexing commands. The
+ at 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,
+ at url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind}.
+
+ at menu
+* \index:: Declare an index entry.
+* makeindex:: Alphabetize index entries.
+* \printindex:: Put the index here.
+ at end menu
+
+
+ at node \index
+ at subsection @code{\index}
+
+ at cindex index entry
+ at findex \index
+
+Synopsis:
+
+ at example
+\index@{@var{index-entry-string}@}
+ at 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}.
+
+ at example
+W~Ackermann (1896--1962).\index@{Ackermann@}
+ ...
+Ackermann function\index@{Ackermann!function@}
+ ...
+rate of growth\index@{Ackermann!function!growth rate@}
+ at end example
+
+ at 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
+ at code{\index@{Ackermann!function!growth rate!comparison@}} then
+ at 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
+ at 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
+ at code{\index@{Ackermann@}}.
+
+ at cindex index, page range
+Get a page range in the output, like @samp{Hilbert, 23--27}, as here.
+
+ at example
+W~Ackermann (1896--1962).\index@{Ackermann@}
+ ...
+D~Hilbert (1862--1943)\index@{Ackermann!Hilbert\(@}
+ ...
+disapproved of his marriage.\index@{Ackermann!Hilbert\)@}
+ at end example
+
+ at 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
+ at 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.
+ at PkgIndex{babel} @PkgIndex{polyglossia} Generate a index entry that says
+ at samp{See} by using a vertical bar character:
+ at code{\index@{Ackermann!function|see@{P\'eter's function@}@}}. Get
+ at samp{See also} with @code{seealso}. (The text @samp{See} is defined by
+ at code{\seename}, and @samp{See also} by @code{\alsoname}. You can
+redefine these either by using an internationalization package such as
+ at file{babel} or @file{polyglossia}, or directly as with
+ at 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
+ at code{\index@{group|textit@}} (note the missing backslash on the
+ at 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
+ at code{\newcommand@{\definedpage@}[1]@{@{\color@{blue@}#1@}@}} and then
+ at code{\index@{Ackermann!function|definedpage@}} will give a blue page
+number (@pxref{Color}). Another, less practical, example is this,
+
+ at c credit Ian Thompson https://tex.stackexchange.com/a/272572/121234
+ at example
+\newcommand\indexownpage[1]@{#1, \thepage@}
+ ... Epimenides.\index@{self-reference|indexownpage@}
+ at end example
+
+ at noindent
+which creates an entry citing the page number of its own index listing.
+
+The two functions just described combine, as with
+ at code{\index@{Ackermann!function|(definedpage@}} and
+ at code{\index@{Ackermann!function|)@}}, which outputs an index entry like
+ at 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
+ at 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
+ at var{text} produces the text of the entry. Another example is that
+ at code{\index@{Saint Michael's College@@SMC@}} produces an index entry
+ at 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.)
+
+ at 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
+ at code{\index*@{@var{index-entry-string}@}} that prints the
+ at var{index-entry-string} as well as indexing it.
+
+ at findex \indexentry
+ at cindex idx file
+The @code{\index} command writes the indexing information to the file
+ at file{@var{root-name}.idx} file. Specifically, it writes text of the
+command
+ at 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 @samp{Runaway argument? @{Ackermann!function ! Paragraph
+ended before \@@wrindex was complete.}.
+
+
+ at node makeindex
+ at subsection @command{makeindex}
+
+ at cindex index, processing
+ at findex makeindex
@cindex @command{makeindex} program
- at 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.
+ at cindex @file{.idx} file
- at findex \printindex
- at PkgIndex{makeidx}
-The index is usually generated with the @code{\printindex} command.
-This is defined in the @code{makeidx} package, so
- at code{\usepackage@{makeidx@}} needs to be in the preamble.
+Synopsis, one of:
+ at example
+makeindex @var{filename}
+makeindex -s @var{style-file} @var{filename}
+makeindex @var{options} @var{filename0} ...
+ at end example
+
+Sort, and otherwise process, the index information in the auxiliary file
+ at 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
+ at code{\printindex} (@pxref{\printindex}).
+
+ at cindex @file{.isty} file
+ at findex index, style file
+ at 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
+ at file{.isty} file. The third form is the most general; see the full
+documentation on CTAN.
+
+This is a simple @file{.isty} file.
+
+ at 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@}"
+ at 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
+ at var{attribute}. These can appear in the file in any order. All of the
+ at 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,
+ at code{\\}. If a line begins with a percent sign, @code{%}, then it is a
+comment.
+
+ at ftable @code
+ at item preamble
+Preamble of the output file. Defines the context in which the index is
+formatted. Default: @code{"\\begin@{theindex@}\n"}.
+
+ at item postamble
+Postamble of the output file. Default: @code{"\n\n\\end@{theindex@}\n"}.
+
+ at 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}).
- at 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.
+ at 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 at tie{}0.
- at PkgIndex{multind}
-The @code{multind} package supports multiple indexes. See also the
- at TeX{} FAQ entry on this topic,
- at url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind}.
+ at 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{""}
+ at item lethead_suffix
+If a group begins with a different letter then this is the suffix
+inserted after the new letter header. Default: @code{""}.
+ at item item_0
+What is put between two level at tie{}0 items. Default: @code{"\n \\item
+"}.
+
+ at item item_1
+Put between two level at tie{}1 items. Default: @code{"\n \\subitem "}.
+
+ at item item_2
+put between two level at tie{}2 items. Default: @code{"\n \\subsubitem "}.
+
+ at item item_01
+What is put between a level at tie{}0 item and a level at tie{}1 item.
+Default: @code{"\n \\subitem "}.
+
+ at item item_x1
+What is put between a level at tie{}0 item and a level at tie{}1 item in the
+case that the level at tie{}0 item doesn't have any page numbers (as in
+ at code{\index@{aaa|see@{bbb@}@}}). Default: @code{"\n \\subitem "}.
+
+ at item item_12
+What is put between a level at tie{}1 item and a level at tie{}2 item.
+Default: @code{"\n \\subsubitem "}.
+
+ at item item_x2 <string>
+What is put between a level at tie{}1 item and a level at tie{}2 item, if the
+level at tie{}1 item doesn't have page numbers. Default: @code{"\n
+\\subsubitem "}.
+
+ at item delim_0
+Delimiter put between a level at tie{}0 key and its first page
+number. Default: a comma followed by a blank, @code{", "}.
+
+ at item delim_1
+Delimiter put between a level at tie{}1 key and its first page
+number. Default: a comma followed by a blank, @code{", "}.
+
+ at item delim_2
+Delimiter between a level at tie{}2 key and its first page number. Default:
+a comma followed by a blank, @code{", "}.
+
+ at item delim_n <string>
+Delimiter between two page numbers for the same key (at any
+level). Default: a comma followed by a blank, @code{", "}.
+
+ at item delim_r
+What is put between the starting and ending page numbers of a range.
+Default: @code{"--"}.
+
+ at item line_max
+An integer. Maximum length of an index entry's line in the output,
+beyond which the line wraps. Default: @code{72}.
+
+ at item indent_space
+What is inserted at the start of a wrapped line. Default:
+ at code{"\t\t"}.
+
+ at item indent_length <number>
+A number. The length of the wrapped line indentation. The default
+ at code{indent_space} is two tabs and each tab is eight spaces so the
+default here is @code{16}.
+
+ at 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:
+ at code{"rnaRA"}.
+
+ at end ftable
+
+ at findex xindy
+ at 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.
+
+
+ at node \printindex
+ at subsection @command{\printindex}
+
+ at cindex index, printing
+ at findex \printindex
+
+Synopsis:
+
+ at example
+\printindex
+ at end example
+
+ at findex \printindex
+Place the index into the output.
+
+To get an index you must first include
+ at 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}.
+
+
+ at node Glossaries
+ at section Glossaries
+
+ at cindex glossary
+ at cindex glossaries
+ at cindex acronyms, list of
+ at findex \makeglossary
+ at findex \printglossaries
+
+Synopsis:
+
+ at example
+\usepackage@{glossaries@} \makeglossaries
+ ...
+\newglossaryentry@{@var{label}@}@{@var{settings}@}
+ ...
+\gls@{@var{label}@}.
+ ...
+\printglossaries
+ at 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
+ at code{makeglossaries filename}, and then compile the document again.
+
+ at example
+\documentclass@{...@}
+\usepackage@{glossaries@} \makeglossaries
+\newglossaryentry@{tm@}@{%
+ name=@{Turing machine@},
+ description=@{A model of a machine that computes. The model is very simple
+ but can compute anything that an existing device can compute.
+ It is the standard one used in Computer Science.@},
+ @}
+\begin@{document@}
+Everything begins with the definition of a \gls@{tm@}.
+ ...
+\printglossaries
+\end@{document@}
+ at end example
+
+ at 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
+ at samp{Glossary} there appears a description list. In boldface it says
+ at samp{Turing machine} and the rest of the item says in normal type
+ at samp{A model of a machine @dots{} Computer Science}.
+
+ at findex \makeglossary
+ at findex \printglossaries
+ at cindex @file{.glo} file
+The command @code{\makeglossary} opens the file that will contain the
+entry information, @file{@var{root-file}.glo}. Put the
+ at 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.
+
+ at menu
+* \newglossaryentry:: Declare the content of a glossary entry.
+* \gls:: Give a page reference for a glossary entry.
+ at end menu
+
+
+ at node \newglossaryentry
+ at subsection @code{\newglossaryentry}
+
+ at cindex glossary, entries
+ at findex \newglossaryentry
+
+Synopsis, one of:
+
+ at example
+\newglossaryentry@{@var{label}@}
+@{
+ name=@{@var{name}@},
+ description=@{@var{description}@},
+ @var{other options}, ...
+@}
+ at end example
+
+or
+
+ at example
+\longnewglossaryentry@{@var{label}@}
+@{
+ name=@{@var{name}@},
+ @var{other options} ...,
+@}
+@{@var{description}@}
+ at 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:
+ at code{@var{key}=@var{value}}.
+
+This puts the blackboard bold symbol for the real numbers @BES{211D,} in the
+glossary.
+
+ at example
+\newglossaryentry@{R@}
+@{
+ name=@{\ensuremath@{\mathbb@{R@}@}@},
+ description=@{the real numbers@},
+@}
+ at 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.
+
+ at ftable @code
+ at item name
+(Required.) The word, phrase, or symbol that you are defining.
+
+ at 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.
+
+ at item plural
+The plural form of @var{name}. Refer to the plural form using
+ at code{\glspl} or @code{\Glspl} (@pxref{\gls}).
+
+ at item sort
+How to place this entry in the list of entries that the glossary holds.
+
+ at item symbol
+A symbol, such as a mathematical symbol, besides the name.
+
+ at end ftable
+
+
+ at node \gls
+ at subsection @code{\gls}
+
+ at cindex glossary, entry reference
+ at findex \gls
+
+Synopsis, one of:
+
+ at example
+\gls@{@var{label}@}
+\glspl@{@var{label}@}
+\Gls@{@var{label}@}
+\Glspl@{@var{label}@}
+ at end example
+
+Refer to a glossary entry. The entries are declared with
+ at code{\newglossaryentry} (@pxref{\newglossaryentry}).
+
+This
+
+ at example
+\newglossaryentry@{N@}@{%
+ name=@{the natural numbers@},
+ description=@{The numbers $0$, $1$, $2$, $\ldots$\@@@},
+ symbol=@{\ensuremath@{\mathbb@{N@}@}@},
+ @}
+ ...
+Consider \gls@{N@}.
+ at end example
+
+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
@chapter Letters
More information about the latexrefman-commits
mailing list