[latexrefman-commits] [SCM] latexrefman updated: r988 - trunk
Jim Hefferon
INVALID.NOREPLY at gnu.org.ua
Mon Aug 16 17:29:44 CEST 2021
Author: jimhefferon
Date: 2021-08-16 15:29:44 +0000 (Mon, 16 Aug 2021)
New Revision: 988
Modified:
trunk/ChangeLog
trunk/latex2e.html
trunk/latex2e.info
trunk/latex2e.pdf
trunk/latex2e.texi
trunk/writing.html
Log:
Add section on \caption
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2021-08-13 17:12:43 UTC (rev 987)
+++ trunk/ChangeLog 2021-08-16 15:29:44 UTC (rev 988)
@@ -1,3 +1,7 @@
+2021-08-16 Jim Hefferon <jhefferon at smcvt.edu>
+ * latex2e.texi (\caption): Add section on \caption. Put in
+ cross-references to figure and table entries.
+
2021-08-13 Jim Hefferon <jhefferon at smcvt.edu>
* latex2e.texi (Command line input): Replace the graphics draft
option example with \includeonly{} example.
Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html 2021-08-13 17:12:43 UTC (rev 987)
+++ trunk/latex2e.html 2021-08-16 15:29:44 UTC (rev 988)
@@ -223,7 +223,10 @@
<li><a id="toc-_005craggedbottom-1" href="#g_t_005craggedbottom">5.4 <code>\raggedbottom</code></a></li>
<li><a id="toc-Page-layout-parameters-1" href="#Page-layout-parameters">5.5 Page layout parameters</a></li>
<li><a id="toc-_005cbaselineskip-_0026-_005cbaselinestretch-1" href="#g_t_005cbaselineskip-_0026-_005cbaselinestretch">5.6 <code>\baselineskip</code> & <code>\baselinestretch</code></a></li>
- <li><a id="toc-Floats-1" href="#Floats">5.7 Floats</a></li>
+ <li><a id="toc-Floats-1" href="#Floats">5.7 Floats</a>
+ <ul class="no-bullet">
+ <li><a id="toc-_005ccaption-1" href="#g_t_005ccaption">5.7.1 <code>\caption</code></a></li>
+ </ul></li>
</ul></li>
<li><a id="toc-Sectioning-1" href="#Sectioning">6 Sectioning</a>
<ul class="no-bullet">
@@ -4040,8 +4043,112 @@
LaTeX?”
(<a href="https://www.latex-project.org/publications/2014-FMi-TUB-tb111mitt-float-placement.pdf">https://www.latex-project.org/publications/2014-FMi-TUB-tb111mitt-float-placement.pdf</a>).
</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#g_t_005ccaption" accesskey="1">\caption</a></td><td> </td><td align="left" valign="top">Make a caption for a floating environment.
+</td></tr>
+</table>
+
<hr>
+<span id="g_t_005ccaption"></span><div class="header">
+<p>
+Up: <a href="#Floats" accesskey="u" rel="up">Floats</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="g_t_005ccaption-1"></span><h4 class="subsection">5.7.1 <code>\caption</code></h4>
+
+<span id="index-_005ccaption"></span>
+<span id="index-captions"></span>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\caption{<var>caption-text</var>}
+</pre></div>
+
+<p>or
+</p>
+<div class="example">
+<pre class="example">\caption[<var>short-caption-text</var>]{<var>caption-text</var>}
+</pre></div>
+
+<p>Make a caption for a floating environment, such as a <code>figure</code> or
+<code>table</code> environment (see <a href="#figure">figure</a> or <a href="#table">table</a>).
+</p>
+<p>In this example, LaTeX places a caption below the blank space that is
+left by the author for the later inclusion of a picture.
+</p>
+<div class="example">
+<pre class="example">\begin{figure}
+ \vspace*{1cm}
+ \caption{Alonzo Cushing, Battery A, 4th US Artillery.}
+ \label{fig:CushingPic}
+\end{figure}
+</pre></div>
+
+<p>The <code>\caption</code> command will label the <var>caption-text</var> with
+something like ‘<samp>Figure 1:</samp>’ for an article or
+‘<samp>Figure 1.1:</samp>’ for a book. The text is centered if it is
+shorter than the text width, or set as an unindented paragraph if it
+takes more than one line.
+</p>
+<p>In addition to placing the <var>caption-text</var> in the output, the
+<code>\caption</code> command also saves that information for use in a list of
+figures or list of tables (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>).
+</p>
+<p>Here the <code>\caption</code> command uses the optional
+<var>short-caption-text</var>, so that the shorter text appears in the list
+of tables, rather than the longer <var>caption-text</var>.
+</p>
+<div class="example">
+<pre class="example">\begin{table}
+ \centering
+ \begin{tabular}{|*{3}{c}|}
+ \hline
+ 4 &9 &2 \\
+ 3 &5 &7 \\
+ 8 &1 &6 \\
+ \hline
+ \end{tabular}
+ \caption[\textit{Lo Shu} magic square]{%
+ The \textit{Lo Shu} magic square, which is unique among
+ squares of order three up to rotation and reflection.}
+ \label{tab:LoShu}
+\end{table}
+</pre></div>
+
+<p>LaTeX will label the <var>caption-text</var> with something like
+‘<samp>Table 1:</samp>’ for an article or ‘<samp>Table 1.1:</samp>’ for a
+book.
+</p>
+<p>The caption can appear at the top of the <code>figure</code> or <code>table</code>.
+For instance, that would happen in the prior example by putting the
+<code>\caption</code> between the <code>\centering</code> and the
+<code>\begin{tabular}</code>.
+</p>
+<p>Different floating environments are numbered separately, by default.
+The counter for the <code>figure</code> environment is named <code>figure</code>,
+and similarly the counter for the <code>table</code> environment is
+<code>table</code>.
+</p>
+<p>The text that will be put in the list of figures or list of tables is
+moving text. If you get the LaTeX error ‘<samp>! Argument of
+\@caption has an extra }</samp>’ then you must put <code>\protect</code> in front
+of any fragile commands. See <a href="#g_t_005cprotect">\protect</a>.
+</p>
+<p>The <code>caption</code> package has many options to adjust how the caption
+appears, for example changing the font size, making the caption be
+hanging text rather than set as a paragraph, or making the caption
+always set as a paragraph rather than centered when it is short.
+</p>
+
+
+
+
+
+
+
+
+<hr>
<span id="Sectioning"></span><div class="header">
<p>
Next: <a href="#Cross-references" accesskey="n" rel="next">Cross references</a>, Previous: <a href="#Layout" accesskey="p" rel="prev">Layout</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
@@ -5680,7 +5787,6 @@
<span id="index-_005ccentering"></span>
<span id="index-centering-text_002c-declaration-for"></span>
-
<p>Synopsis:
</p>
<div class="example">
@@ -6208,10 +6314,11 @@
in <a href="#Floats">Floats</a>.
</p>
<p>The label is optional; it is used for cross references (see <a href="#Cross-references">Cross references</a>).
-<span id="index-_005ccaption"></span>
+<span id="index-_005ccaption-1"></span>
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="#Table-of-contents-etc_002e">Table of contents etc.</a>).
+figure (see <a href="#g_t_005ccaption">\caption</a>). 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="#Table-of-contents-etc_002e">Table of contents etc.</a>).
</p>
<p>This example makes a figure out of a graphic. LaTeX will place that
graphic and its caption at the top of a page or, if it is pushed to the
@@ -8514,11 +8621,11 @@
float placement algorithm, see <a href="#Floats">Floats</a>.
</p>
<p>The label is optional; it is used for cross references (see <a href="#Cross-references">Cross references</a>).
-<span id="index-_005ccaption-1"></span>
+<span id="index-_005ccaption-2"></span>
The <code>\caption</code> command is also optional. It specifies caption text
-<var>title</var> for the table. By default it is numbered. If its optional
-<var>lottitle</var> is present then that text is used in the list of tables
-instead of <var>title</var> (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>).
+<var>title</var> for the table (see <a href="#g_t_005ccaption">\caption</a>). By default it is
+numbered. If its optional <var>lottitle</var> is present then that text is
+used in the list of tables instead of <var>title</var> (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>).
</p>
<p>In this example the table and caption will float to the bottom of a page,
unless it is pushed to a float page at the end.
@@ -11765,9 +11872,10 @@
<pre class="example">\ignorespacesafterend
</pre></div>
-<p>Both commands cause LaTeX to ignore spaces after the end of the
-command up until the first non-space character. The first is a command
-from plain TeX, and the second is LaTeX-specific.
+<p>Both commands cause LaTeX to ignore spaces (that is, characters of
+category 10) after the end of the command, up until the first
+non-space character. The first is a command from plain TeX, and the
+second is LaTeX-specific.
</p>
<p>The <code>ignorespaces</code> is often used when defining commands via
<code>\newcommand</code>, or <code>\newenvironment</code>, or <code>\def</code>. The
@@ -19369,7 +19477,7 @@
</p>
<p>Graphics come in two main types, raster and vector. LaTeX can use
both. In raster graphics the file contains an entry for each location
-in an array, describing what color it is. An example is a photograph,
+in an array, describing what color it is. An example is a photograph
in JPG format. In vector graphics, the file contains a list of
instructions such as ‘<samp>draw a circle with this radius and that
center</samp>’. An example is a line drawing produced by the Asymptote
@@ -22503,16 +22611,20 @@
<code>\renewcommand{\numberline}[1]{#1~}</code> before
<code>\tableofcontents</code>.
</p>
-<p>This command is fragile, so you may need to precede it with
+<p>This command is fragile so you may need to precede it with
<code>\protect</code> (see <a href="#g_t_005cprotect">\protect</a>). An example is the use of
-<code>\protect</code> in the command
-<code>\addcontentsline{toc}{section}{\protect\numberline{}Summary}</code>
-to get the <code>\numberline</code> into the <code>\contentsline</code> command in
-the <samp>.toc</samp> file: <code>\contentsline {section}{\numberline
-{}Summary}{6}</code> (the page number ‘<samp>6</samp>’ is automatically added by
-LaTeX; see <a href="#g_t_005caddcontentsline">\addcontentsline</a>).
+<code>\protect</code> in this command,
</p>
+<div class="example">
+<pre class="example"><code>\addcontentsline{toc}{section}{\protect\numberline{}Summary}</code>
+</pre></div>
+<p>to get the <code>\numberline</code> into the <code>\contentsline</code>
+command in the <samp>.toc</samp> file: <code>\contentsline
+{section}{\numberline {}Summary}{6}</code> (the page number ‘<samp>6</samp>’
+is automatically added by LaTeX; see <a href="#g_t_005caddcontentsline">\addcontentsline</a>).
+</p>
+
<hr>
<span id="Indexes"></span><div class="header">
<p>
@@ -24676,8 +24788,8 @@
<pre class="example">pdflatex "\includeonly{chap1}\input{mybook}"
</pre></div>
-<p>will give output that has the first chapter but no
-other. See <a href="#Splitting-the-input">Splitting the input</a>.
+<p>will give output that has the first chapter but no other
+chapter. See <a href="#Splitting-the-input">Splitting the input</a>.
</p>
<hr>
@@ -25311,8 +25423,9 @@
<tr><td></td><td valign="top"><a href="#index-_005ccapitalring"><code>\capitalring</code></a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccapitaltie"><code>\capitaltie</code></a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccapitaltilde"><code>\capitaltilde</code></a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005ccaption"><code>\caption</code></a>:</td><td> </td><td valign="top"><a href="#figure">figure</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005ccaption-1"><code>\caption</code></a>:</td><td> </td><td valign="top"><a href="#table">table</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005ccaption"><code>\caption</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ccaption">\caption</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005ccaption-1"><code>\caption</code></a>:</td><td> </td><td valign="top"><a href="#figure">figure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005ccaption-2"><code>\caption</code></a>:</td><td> </td><td valign="top"><a href="#table">table</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccc"><code>\cc</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ccc">\cc</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccdot"><code>\cdot</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccdots"><code>\cdots</code></a>:</td><td> </td><td valign="top"><a href="#Dots">Dots</a></td></tr>
@@ -26323,6 +26436,7 @@
<tr><td></td><td valign="top"><a href="#index-calligraphic-fonts">calligraphic fonts</a>:</td><td> </td><td valign="top"><a href="#Calligraphic">Calligraphic</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-calligraphic-letters-for-math">calligraphic letters for math</a>:</td><td> </td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cap-height">cap height</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-captions">captions</a>:</td><td> </td><td valign="top"><a href="#g_t_005ccaption">\caption</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-caron-accent">caron accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-catcode">catcode</a>:</td><td> </td><td valign="top"><a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter & \makeatother</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-category-code_002c-character">category code, character</a>:</td><td> </td><td valign="top"><a href="#g_t_005cmakeatletter-_0026-_005cmakeatother">\makeatletter & \makeatother</a></td></tr>
Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info 2021-08-13 17:12:43 UTC (rev 987)
+++ trunk/latex2e.info 2021-08-16 15:29:44 UTC (rev 988)
@@ -2438,7 +2438,86 @@
environments like figure and table in LaTeX?"
(<https://www.latex-project.org/publications/2014-FMi-TUB-tb111mitt-float-placement.pdf>).
+* Menu:
+
+* \caption:: Make a caption for a floating environment.
+
+File: latex2e.info, Node: \caption, Up: Floats
+
+5.7.1 '\caption'
+----------------
+
+Synopsis:
+
+ \caption{CAPTION-TEXT}
+
+or
+
+ \caption[SHORT-CAPTION-TEXT]{CAPTION-TEXT}
+
+ Make a caption for a floating environment, such as a 'figure' or
+'table' environment (*note figure:: or *note table::).
+
+ In this example, LaTeX places a caption below the blank space that is
+left by the author for the later inclusion of a picture.
+
+ \begin{figure}
+ \vspace*{1cm}
+ \caption{Alonzo Cushing, Battery A, 4th US Artillery.}
+ \label{fig:CushingPic}
+ \end{figure}
+
+The '\caption' command will label the CAPTION-TEXT with something like
+'Figure 1:' for an article or 'Figure 1.1:' for a book. The text is
+centered if it is shorter than the text width, or set as an unindented
+paragraph if it takes more than one line.
+
+ In addition to placing the CAPTION-TEXT in the output, the '\caption'
+command also saves that information for use in a list of figures or list
+of tables (see *note Table of contents etc.::).
+
+ Here the '\caption' command uses the optional SHORT-CAPTION-TEXT, so
+that the shorter text appears in the list of tables, rather than the
+longer CAPTION-TEXT.
+
+ \begin{table}
+ \centering
+ \begin{tabular}{|*{3}{c}|}
+ \hline
+ 4 &9 &2 \\
+ 3 &5 &7 \\
+ 8 &1 &6 \\
+ \hline
+ \end{tabular}
+ \caption[\textit{Lo Shu} magic square]{%
+ The \textit{Lo Shu} magic square, which is unique among
+ squares of order three up to rotation and reflection.}
+ \label{tab:LoShu}
+ \end{table}
+
+LaTeX will label the CAPTION-TEXT with something like 'Table 1:' for an
+article or 'Table 1.1:' for a book.
+
+ The caption can appear at the top of the 'figure' or 'table'. For
+instance, that would happen in the prior example by putting the
+'\caption' between the '\centering' and the '\begin{tabular}'.
+
+ Different floating environments are numbered separately, by default.
+The counter for the 'figure' environment is named 'figure', and
+similarly the counter for the 'table' environment is 'table'.
+
+ The text that will be put in the list of figures or list of tables is
+moving text. If you get the LaTeX error '! Argument of \@caption has an
+extra }' then you must put '\protect' in front of any fragile commands.
+*Note \protect::.
+
+ The 'caption' package has many options to adjust how the caption
+appears, for example changing the font size, making the caption be
+hanging text rather than set as a paragraph, or making the caption
+always set as a paragraph rather than centered when it is short.
+
+
File: latex2e.info, Node: Sectioning, Next: Cross references, Prev: Layout, Up: Top
6 Sectioning
@@ -4048,9 +4127,9 @@
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 Table of contents
-etc.::).
+for the figure (*note \caption::). By default it is numbered. If
+LOFTITLE is present, it is used in the list of figures instead of TITLE
+(*note Table of contents etc.::).
This example makes a figure out of a graphic. LaTeX will place that
graphic and its caption at the top of a page or, if it is pushed to the
@@ -5753,9 +5832,9 @@
The label is optional; it is used for cross references (*note Cross
references::). The '\caption' command is also optional. It specifies
-caption text TITLE for the table. By default it is numbered. If its
-optional LOTTITLE is present then that text is used in the list of
-tables instead of TITLE (*note Table of contents etc.::).
+caption text TITLE for the table (*note \caption::). By default it is
+numbered. If its optional LOTTITLE is present then that text is used in
+the list of tables instead of TITLE (*note Table of contents etc.::).
In this example the table and caption will float to the bottom of a
page, unless it is pushed to a float page at the end.
@@ -8226,9 +8305,10 @@
\ignorespacesafterend
- Both commands cause LaTeX to ignore spaces after the end of the
-command up until the first non-space character. The first is a command
-from plain TeX, and the second is LaTeX-specific.
+ Both commands cause LaTeX to ignore spaces (that is, characters of
+category 10) after the end of the command, up until the first non-space
+character. The first is a command from plain TeX, and the second is
+LaTeX-specific.
The 'ignorespaces' is often used when defining commands via
'\newcommand', or '\newenvironment', or '\def'. The example below
@@ -13447,8 +13527,8 @@
Graphics come in two main types, raster and vector. LaTeX can use
both. In raster graphics the file contains an entry for each location
-in an array, describing what color it is. An example is a photograph,
-in JPG format. In vector graphics, the file contains a list of
+in an array, describing what color it is. An example is a photograph in
+JPG format. In vector graphics, the file contains a list of
instructions such as 'draw a circle with this radius and that center'.
An example is a line drawing produced by the Asymptote program, in PDF
format. Generally vector graphics are more useful because you can
@@ -15563,14 +15643,16 @@
'\l at subsection', etc. Put section numbers inside a natural-width box
with '\renewcommand{\numberline}[1]{#1~}' before '\tableofcontents'.
- This command is fragile, so you may need to precede it with
-'\protect' (*note \protect::). An example is the use of '\protect' in
-the command
-'\addcontentsline{toc}{section}{\protect\numberline{}Summary}' to get
-the '\numberline' into the '\contentsline' command in the '.toc' file:
-'\contentsline {section}{\numberline {}Summary}{6}' (the page number '6'
-is automatically added by LaTeX; *note \addcontentsline::).
+ This command is fragile so you may need to precede it with '\protect'
+(*note \protect::). An example is the use of '\protect' in this
+command,
+ \addcontentsline{toc}{section}{\protect\numberline{}Summary}
+
+to get the '\numberline' into the '\contentsline' command in the '.toc'
+file: '\contentsline {section}{\numberline {}Summary}{6}' (the page
+number '6' is automatically added by LaTeX; *note \addcontentsline::).
+
File: latex2e.info, Node: Indexes, Next: Glossaries, Prev: Table of contents etc., Up: Front/back matter
@@ -17125,7 +17207,7 @@
pdflatex "\includeonly{chap1}\input{mybook}"
-will give output that has the first chapter but no other. *Note
+will give output that has the first chapter but no other chapter. *Note
Splitting the input::.
@@ -17639,8 +17721,9 @@
* \capitalring: Accents. (line 77)
* \capitaltie: Accents. (line 83)
* \capitaltilde: Accents. (line 48)
-* \caption: figure. (line 44)
-* \caption <1>: table. (line 42)
+* \caption: \caption. (line 6)
+* \caption <1>: figure. (line 44)
+* \caption <2>: table. (line 42)
* \cc: \cc. (line 6)
* \cdot: Math symbols. (line 118)
* \cdots: Dots. (line 17)
@@ -18856,6 +18939,7 @@
* calligraphic fonts: Calligraphic. (line 6)
* calligraphic letters for math: Font styles. (line 79)
* cap height: Text symbols. (line 103)
+* captions: \caption. (line 6)
* caron accent: Accents. (line 91)
* catcode: \makeatletter & \makeatother.
(line 19)
@@ -20411,447 +20495,448 @@
Ref: floats dbltopnumber99440
Ref: floats topnumber99559
Ref: floats totalnumber99663
-Node: Sectioning100205
-Ref: sectioning secnumdepth103314
-Ref: Sectioning/secnumdepth103314
-Ref: sectioning tocdepth103940
-Ref: Sectioning/tocdepth103940
-Node: \part104980
-Node: \chapter107157
-Node: \section110930
-Node: \subsection114197
-Node: \subsubsection & \paragraph & \subparagraph116911
-Node: \appendix119568
-Node: \frontmatter & \mainmatter & \backmatter120861
-Node: \@startsection122270
-Ref: startsection name123759
-Ref: \@startsection/name123759
-Ref: startsection level124213
-Ref: \@startsection/level124213
-Ref: startsection indent125094
-Ref: \@startsection/indent125094
-Ref: startsection beforeskip125357
-Ref: \@startsection/beforeskip125357
-Ref: startsection afterskip126878
-Ref: \@startsection/afterskip126878
-Ref: startsection style128189
-Ref: \@startsection/style128189
-Node: Cross references131890
-Node: \label134039
-Node: \pageref135859
-Node: \ref136649
-Node: xr package137644
-Node: Environments139478
-Node: abstract141480
-Node: array143069
-Node: center145961
-Node: \centering147714
-Node: description149211
-Node: displaymath151428
-Node: document153124
-Node: \AtBeginDocument153554
-Node: \AtEndDocument154178
-Node: enumerate154822
-Ref: enumerate enumi156685
-Ref: enumerate enumii156685
-Ref: enumerate enumiii156685
-Ref: enumerate enumiv156685
-Ref: enumerate labelenumi157083
-Ref: enumerate labelenumii157083
-Ref: enumerate labelenumiii157083
-Ref: enumerate labelenumiv157083
-Node: eqnarray157622
-Node: equation159618
-Node: figure160286
-Node: filecontents162440
-Node: flushleft164349
-Node: \raggedright165376
-Node: flushright166574
-Node: \raggedleft167398
-Node: itemize168269
-Ref: itemize labelitemi169817
-Ref: itemize labelitemii169817
-Ref: itemize labelitemiii169817
-Ref: itemize labelitemiv169817
-Ref: itemize leftmargin170476
-Ref: itemize leftmargini170476
-Ref: itemize leftmarginii170476
-Ref: itemize leftmarginiii170476
-Ref: itemize leftmarginiv170476
-Ref: itemize leftmarginv170476
-Ref: itemize leftmarginvi170476
-Node: letter171958
-Node: list172196
-Ref: list makelabel174643
-Ref: list itemindent176028
-Ref: list itemsep176165
-Ref: list labelsep176818
-Ref: list labelwidth176981
-Ref: list leftmargin177992
-Ref: list listparindent178845
-Ref: list parsep179076
-Ref: list partopsep179544
-Ref: list rightmargin180342
-Ref: list topsep180527
-Ref: list beginparpenalty184102
-Ref: list itempenalty184201
-Ref: list endparpenalty184305
-Node: \item185176
-Node: trivlist186422
-Node: math187950
-Node: minipage188256
-Node: picture193821
-Node: \put200051
-Node: \multiput200616
-Node: \qbezier201355
-Node: \graphpaper202828
-Node: \line203622
-Node: \linethickness205596
-Node: \thinlines206045
-Node: \thicklines206456
-Node: \circle206840
-Node: \oval207382
-Node: \shortstack208358
-Node: \vector209755
-Node: \makebox (picture)210669
-Node: \framebox (picture)211851
-Node: \frame213324
-Node: \dashbox213764
-Node: quotation & quote214899
-Node: tabbing215795
-Node: table221698
-Node: tabular223762
-Ref: tabular arrayrulewidth230099
-Ref: tabular arraystrech230339
-Ref: tabular doublerulesep230560
-Ref: tabular tabcolsep230696
-Node: \multicolumn231217
-Node: \vline235093
-Node: \cline236484
-Node: \hline237194
-Node: thebibliography237876
-Node: \bibitem240359
-Node: \cite242661
-Node: \nocite244529
-Node: Using BibTeX245037
-Node: theorem247208
-Node: titlepage248130
-Node: verbatim249413
-Node: \verb251226
-Node: verse253319
-Node: Line breaking254546
-Node: \\255912
-Node: \obeycr & \restorecr258342
-Node: \newline259153
-Node: \- (hyphenation)260182
-Node: \discretionary261820
-Node: \fussy & \sloppy262708
-Node: sloppypar263491
-Node: \hyphenation264637
-Node: \linebreak & \nolinebreak265231
-Node: Page breaking266379
-Node: \clearpage & \cleardoublepage268409
-Node: \newpage269929
-Node: \enlargethispage271227
-Node: \pagebreak & \nopagebreak272183
-Node: Footnotes274154
-Node: \footnote275300
-Ref: footnote footnoterule276568
-Ref: footnote footnotesep277179
-Node: \footnotemark278245
-Node: \footnotetext280584
-Node: Footnotes in section headings281186
-Node: Footnotes in a table282019
-Node: Footnotes of footnotes284941
-Node: Definitions285645
-Node: \newcommand & \renewcommand286692
-Node: Control sequences292127
-Node: \providecommand293482
-Node: \makeatletter & \makeatother294647
-Node: \@ifstar296749
-Node: \newcounter300234
-Node: \newlength301954
-Node: \newsavebox302877
-Node: \newenvironment & \renewenvironment303856
-Node: \newtheorem309180
-Node: \newfont312752
-Node: \protect313985
-Node: \ignorespaces & \ignorespacesafterend316373
-Node: xspace package319054
-Node: Counters321119
-Node: \alph \Alph \arabic \roman \Roman \fnsymbol322820
-Node: \usecounter325445
-Node: \value326304
-Node: \setcounter327357
-Node: \addtocounter327953
-Node: \refstepcounter328407
-Node: \stepcounter329076
-Node: \day & \month & \year329629
-Node: Lengths330538
-Node: Units of length335126
-Ref: units of length pt335329
-Ref: units of length pc335429
-Ref: units of length in335452
-Ref: units of length bp335478
-Ref: units of length cm335609
-Ref: units of length mm335631
-Ref: units of length dd335653
-Ref: units of length cc335685
-Ref: units of length sp335710
-Ref: Lengths/em335741
-Ref: Lengths/en335741
-Ref: Lengths/ex335741
-Ref: units of length em335741
-Ref: units of length en335741
-Ref: units of length ex335741
-Node: \setlength336597
-Node: \addtolength337780
-Node: \settodepth339203
-Node: \settoheight340191
-Node: \settowidth341189
-Node: \stretch342194
-Node: Expressions343396
-Node: Making paragraphs348178
-Node: \par350507
-Node: \indent & \noindent352553
-Node: \parindent & \parskip354088
-Node: Marginal notes355395
-Ref: marginal notes marginparpush356791
-Ref: marginal notes marginparsep356965
-Ref: marginal notes marginparwidth357097
-Node: Math formulas357446
-Node: Subscripts & superscripts360494
-Node: Math symbols362655
-Node: Arrows386426
-Node: \boldmath & \unboldmath387614
-Node: Blackboard bold389133
-Node: Calligraphic389935
-Node: Delimiters390466
-Node: \left & \right392654
-Node: \bigl & \bigr etc.396662
-Node: Dots399415
-Ref: ellipses cdots399846
-Ref: ellipses ddots399991
-Ref: ellipses ldots400072
-Ref: ellipses vdots400489
-Node: Greek letters401673
-Node: Math functions403352
-Node: Math accents404996
-Node: Over- and Underlining405895
-Node: Spacing in math mode407722
-Ref: spacing in math mode thickspace408653
-Ref: spacing in math mode medspace409104
-Ref: Spacing in math mode/\thinspace409560
-Ref: spacing in math mode thinspace409560
-Ref: spacing in math mode negthinspace410041
-Ref: spacing in math mode quad410414
-Ref: spacing in math mode qquad410670
-Node: \smash411008
-Node: \phantom & \vphantom & \hphantom413225
-Node: \mathstrut415799
-Node: Math styles416761
-Node: Math miscellany419501
-Node: Colon character & \colon419998
-Node: \*420691
-Node: \frac421271
-Node: \sqrt421642
-Node: \stackrel422228
-Node: Modes422501
-Ref: modes paragraph mode422951
-Ref: modes lr mode423263
-Ref: modes math mode423869
-Ref: modes vertical mode424204
-Ref: modes internal vertical mode424422
-Ref: modes inner paragraph mode424945
-Ref: modes outer paragraph mode424945
-Node: \ensuremath425359
-Node: Page styles426064
-Node: \maketitle426827
-Node: \pagenumbering429845
-Node: \pagestyle431833
-Node: \thispagestyle435335
-Node: Spaces436289
-Node: \enspace & \quad & \qquad437609
-Node: \hspace438524
-Node: \hfill440381
-Node: \hss441445
-Node: \spacefactor442139
-Node: \@445546
-Ref: \AT445666
-Node: \frenchspacing & \nonfrenchspacing447606
-Ref: \frenchspacing447724
-Node: \normalsfcodes448526
-Node: \(SPACE)448794
-Ref: Leading blanks450734
-Node: ~451047
-Node: \thinspace & \negthinspace453624
-Node: \/454822
-Node: \hrulefill & \dotfill456780
-Node: \bigskip & \medskip & \smallskip458136
-Ref: bigskip458954
-Ref: medskip459158
-Ref: smallskip459367
-Node: \bigbreak & \medbreak & \smallbreak460028
-Node: \strut461014
-Node: \vspace464251
-Node: \vfill465812
-Node: \addvspace466740
-Node: Boxes468786
-Node: \mbox & \makebox469492
-Ref: mbox makebox depth470760
-Ref: mbox makebox height470760
-Ref: mbox makebox width470760
-Ref: mbox makebox totalheight470760
-Node: \fbox & \framebox472855
-Ref: fbox framebox fboxrule474162
-Ref: fbox framebox fboxsep474352
-Node: \parbox475454
-Node: \raisebox477760
-Ref: raisebox depth478733
-Ref: raisebox height478733
-Ref: raisebox width478733
-Ref: raisebox totalheight478733
-Node: \sbox & \savebox479434
-Node: lrbox482496
-Node: \usebox483382
-Node: Color483821
-Node: Color package options484620
-Node: Color models486266
-Ref: color models cmyk487063
-Ref: color models gray487426
-Ref: color models rgb487575
-Ref: color models RGB487912
-Ref: color models named488287
-Node: Commands for color488575
-Node: Define colors488990
-Node: Colored text489715
-Node: Colored boxes492112
-Node: Colored pages493501
-Node: Graphics494194
-Node: Graphics package options496321
-Node: Graphics package configuration499074
-Node: \graphicspath499876
-Node: \DeclareGraphicsExtensions502834
-Node: \DeclareGraphicsRule504652
-Node: Commands for graphics507833
-Node: \includegraphics508338
-Ref: includegraphics width513401
-Ref: includegraphics height513934
-Ref: includegraphics totalheight514340
-Ref: includegraphics keepaspectratio514604
-Ref: includegraphics viewport516290
-Ref: includegraphics trim516685
-Ref: includegraphics clip517141
-Ref: includegraphics page517401
-Ref: includegraphics pagebox517492
-Ref: includegraphics interpolate518357
-Ref: includegraphics quiet518562
-Ref: includegraphics draft518723
-Ref: includegraphics bb519528
-Ref: includegraphics bbllx519926
-Ref: includegraphics bblly519926
-Ref: includegraphics bburx519926
-Ref: includegraphics bbury519926
-Ref: includegraphics natwidth520068
-Ref: includegraphics natheight520068
-Ref: includegraphics hiresbb520254
-Ref: includegraphics type521016
-Ref: includegraphics ext521056
-Ref: includegraphics read521159
-Ref: includegraphics command521276
-Node: \rotatebox521522
-Node: \scalebox524376
-Node: \resizebox525432
-Node: Special insertions526624
-Node: Reserved characters527492
-Node: Upper and lower case528752
-Node: Symbols by font position531138
-Node: Text symbols531817
-Node: Accents536801
-Node: \accent538954
-Node: Additional Latin letters540716
-Ref: Non-English characters540898
-Node: inputenc package541917
-Node: \rule544467
-Node: \today545655
-Node: Splitting the input546591
-Node: \endinput548333
-Node: \include & \includeonly549636
-Node: \input553933
-Node: Front/back matter555148
-Node: Table of contents etc.555481
-Node: \@dottedtocline561186
-Node: \addcontentsline562773
-Node: \addtocontents565836
-Node: \contentsline568053
-Node: \nofiles569831
-Node: \numberline570582
-Node: Indexes571740
-Node: \index574454
-Node: makeindex579559
-Ref: makeindex preamble581227
-Ref: makeindex postamble581367
-Ref: makeindex group skip581452
-Ref: makeindex letheadflag581785
-Ref: makeindex lethead prefix582246
-Ref: makeindex lethead suffix582398
-Ref: makeindex item 0582546
-Ref: makeindex item 1582626
-Ref: makeindex item 2582701
-Ref: makeindex item 01582779
-Ref: makeindex item x1582884
-Ref: makeindex item 12583089
-Ref: makeindex item x2583197
-Ref: makeindex delim 0583357
-Ref: makeindex delim 1583487
-Ref: makeindex delim 2583617
-Ref: makeindex delim n583743
-Ref: makeindex delim r583878
-Ref: makeindex line max583986
-Ref: makeindex indent space584121
-Ref: makeindex indent length584216
-Ref: makeindex page precedence584401
-Node: \printindex585436
-Node: Glossaries585909
-Node: \newglossaryentry587876
-Node: \gls589343
-Node: Letters590137
-Node: \address593755
-Node: \cc594566
-Node: \closing595008
-Node: \encl595322
-Node: \location595736
-Node: \makelabels596000
-Node: \name598317
-Node: \opening598558
-Node: \ps598839
-Node: \signature599128
-Node: \telephone600356
-Node: Input/output600721
-Node: \openin & \openout601451
-Node: \read604194
-Node: \typein605381
-Node: \typeout606641
-Node: \write607691
-Node: \write and security612418
-Node: \message613362
-Node: \wlog615191
-Node: \write18615692
-Node: Command line interface619183
-Ref: Command line619347
-Node: Command line options621500
-Ref: interaction modes622503
-Ref: output directory623457
-Node: Command line input625156
-Node: Jobname627271
-Node: Recovering from errors630413
-Node: Document templates631841
-Node: beamer template632275
-Node: article template632917
-Node: book template633380
-Node: Larger book template633859
-Node: Index635401
-Ref: Command Index635487
+Node: \caption100280
+Node: Sectioning102900
+Ref: sectioning secnumdepth106009
+Ref: Sectioning/secnumdepth106009
+Ref: sectioning tocdepth106635
+Ref: Sectioning/tocdepth106635
+Node: \part107675
+Node: \chapter109852
+Node: \section113625
+Node: \subsection116892
+Node: \subsubsection & \paragraph & \subparagraph119606
+Node: \appendix122263
+Node: \frontmatter & \mainmatter & \backmatter123556
+Node: \@startsection124965
+Ref: startsection name126454
+Ref: \@startsection/name126454
+Ref: startsection level126908
+Ref: \@startsection/level126908
+Ref: startsection indent127789
+Ref: \@startsection/indent127789
+Ref: startsection beforeskip128052
+Ref: \@startsection/beforeskip128052
+Ref: startsection afterskip129573
+Ref: \@startsection/afterskip129573
+Ref: startsection style130884
+Ref: \@startsection/style130884
+Node: Cross references134585
+Node: \label136734
+Node: \pageref138554
+Node: \ref139344
+Node: xr package140339
+Node: Environments142173
+Node: abstract144175
+Node: array145764
+Node: center148656
+Node: \centering150409
+Node: description151906
+Node: displaymath154123
+Node: document155819
+Node: \AtBeginDocument156249
+Node: \AtEndDocument156873
+Node: enumerate157517
+Ref: enumerate enumi159380
+Ref: enumerate enumii159380
+Ref: enumerate enumiii159380
+Ref: enumerate enumiv159380
+Ref: enumerate labelenumi159778
+Ref: enumerate labelenumii159778
+Ref: enumerate labelenumiii159778
+Ref: enumerate labelenumiv159778
+Node: eqnarray160317
+Node: equation162313
+Node: figure162981
+Node: filecontents165154
+Node: flushleft167063
+Node: \raggedright168090
+Node: flushright169288
+Node: \raggedleft170112
+Node: itemize170983
+Ref: itemize labelitemi172531
+Ref: itemize labelitemii172531
+Ref: itemize labelitemiii172531
+Ref: itemize labelitemiv172531
+Ref: itemize leftmargin173190
+Ref: itemize leftmargini173190
+Ref: itemize leftmarginii173190
+Ref: itemize leftmarginiii173190
+Ref: itemize leftmarginiv173190
+Ref: itemize leftmarginv173190
+Ref: itemize leftmarginvi173190
+Node: letter174672
+Node: list174910
+Ref: list makelabel177357
+Ref: list itemindent178742
+Ref: list itemsep178879
+Ref: list labelsep179532
+Ref: list labelwidth179695
+Ref: list leftmargin180706
+Ref: list listparindent181559
+Ref: list parsep181790
+Ref: list partopsep182258
+Ref: list rightmargin183056
+Ref: list topsep183241
+Ref: list beginparpenalty186816
+Ref: list itempenalty186915
+Ref: list endparpenalty187019
+Node: \item187890
+Node: trivlist189136
+Node: math190664
+Node: minipage190970
+Node: picture196535
+Node: \put202765
+Node: \multiput203330
+Node: \qbezier204069
+Node: \graphpaper205542
+Node: \line206336
+Node: \linethickness208310
+Node: \thinlines208759
+Node: \thicklines209170
+Node: \circle209554
+Node: \oval210096
+Node: \shortstack211072
+Node: \vector212469
+Node: \makebox (picture)213383
+Node: \framebox (picture)214565
+Node: \frame216038
+Node: \dashbox216478
+Node: quotation & quote217613
+Node: tabbing218509
+Node: table224412
+Node: tabular226495
+Ref: tabular arrayrulewidth232832
+Ref: tabular arraystrech233072
+Ref: tabular doublerulesep233293
+Ref: tabular tabcolsep233429
+Node: \multicolumn233950
+Node: \vline237826
+Node: \cline239217
+Node: \hline239927
+Node: thebibliography240609
+Node: \bibitem243092
+Node: \cite245394
+Node: \nocite247262
+Node: Using BibTeX247770
+Node: theorem249941
+Node: titlepage250863
+Node: verbatim252146
+Node: \verb253959
+Node: verse256052
+Node: Line breaking257279
+Node: \\258645
+Node: \obeycr & \restorecr261075
+Node: \newline261886
+Node: \- (hyphenation)262915
+Node: \discretionary264553
+Node: \fussy & \sloppy265441
+Node: sloppypar266224
+Node: \hyphenation267370
+Node: \linebreak & \nolinebreak267964
+Node: Page breaking269112
+Node: \clearpage & \cleardoublepage271142
+Node: \newpage272662
+Node: \enlargethispage273960
+Node: \pagebreak & \nopagebreak274916
+Node: Footnotes276887
+Node: \footnote278033
+Ref: footnote footnoterule279301
+Ref: footnote footnotesep279912
+Node: \footnotemark280978
+Node: \footnotetext283317
+Node: Footnotes in section headings283919
+Node: Footnotes in a table284752
+Node: Footnotes of footnotes287674
+Node: Definitions288378
+Node: \newcommand & \renewcommand289425
+Node: Control sequences294860
+Node: \providecommand296215
+Node: \makeatletter & \makeatother297380
+Node: \@ifstar299482
+Node: \newcounter302967
+Node: \newlength304687
+Node: \newsavebox305610
+Node: \newenvironment & \renewenvironment306589
+Node: \newtheorem311913
+Node: \newfont315485
+Node: \protect316718
+Node: \ignorespaces & \ignorespacesafterend319106
+Node: xspace package321825
+Node: Counters323890
+Node: \alph \Alph \arabic \roman \Roman \fnsymbol325591
+Node: \usecounter328216
+Node: \value329075
+Node: \setcounter330128
+Node: \addtocounter330724
+Node: \refstepcounter331178
+Node: \stepcounter331847
+Node: \day & \month & \year332400
+Node: Lengths333309
+Node: Units of length337897
+Ref: units of length pt338100
+Ref: units of length pc338200
+Ref: units of length in338223
+Ref: units of length bp338249
+Ref: units of length cm338380
+Ref: units of length mm338402
+Ref: units of length dd338424
+Ref: units of length cc338456
+Ref: units of length sp338481
+Ref: Lengths/em338512
+Ref: Lengths/en338512
+Ref: Lengths/ex338512
+Ref: units of length em338512
+Ref: units of length en338512
+Ref: units of length ex338512
+Node: \setlength339368
+Node: \addtolength340551
+Node: \settodepth341974
+Node: \settoheight342962
+Node: \settowidth343960
+Node: \stretch344965
+Node: Expressions346167
+Node: Making paragraphs350949
+Node: \par353278
+Node: \indent & \noindent355324
+Node: \parindent & \parskip356859
+Node: Marginal notes358166
+Ref: marginal notes marginparpush359562
+Ref: marginal notes marginparsep359736
+Ref: marginal notes marginparwidth359868
+Node: Math formulas360217
+Node: Subscripts & superscripts363265
+Node: Math symbols365426
+Node: Arrows389197
+Node: \boldmath & \unboldmath390385
+Node: Blackboard bold391904
+Node: Calligraphic392706
+Node: Delimiters393237
+Node: \left & \right395425
+Node: \bigl & \bigr etc.399433
+Node: Dots402186
+Ref: ellipses cdots402617
+Ref: ellipses ddots402762
+Ref: ellipses ldots402843
+Ref: ellipses vdots403260
+Node: Greek letters404444
+Node: Math functions406123
+Node: Math accents407767
+Node: Over- and Underlining408666
+Node: Spacing in math mode410493
+Ref: spacing in math mode thickspace411424
+Ref: spacing in math mode medspace411875
+Ref: Spacing in math mode/\thinspace412331
+Ref: spacing in math mode thinspace412331
+Ref: spacing in math mode negthinspace412812
+Ref: spacing in math mode quad413185
+Ref: spacing in math mode qquad413441
+Node: \smash413779
+Node: \phantom & \vphantom & \hphantom415996
+Node: \mathstrut418570
+Node: Math styles419532
+Node: Math miscellany422272
+Node: Colon character & \colon422769
+Node: \*423462
+Node: \frac424042
+Node: \sqrt424413
+Node: \stackrel424999
+Node: Modes425272
+Ref: modes paragraph mode425722
+Ref: modes lr mode426034
+Ref: modes math mode426640
+Ref: modes vertical mode426975
+Ref: modes internal vertical mode427193
+Ref: modes inner paragraph mode427716
+Ref: modes outer paragraph mode427716
+Node: \ensuremath428130
+Node: Page styles428835
+Node: \maketitle429598
+Node: \pagenumbering432616
+Node: \pagestyle434604
+Node: \thispagestyle438106
+Node: Spaces439060
+Node: \enspace & \quad & \qquad440380
+Node: \hspace441295
+Node: \hfill443152
+Node: \hss444216
+Node: \spacefactor444910
+Node: \@448317
+Ref: \AT448437
+Node: \frenchspacing & \nonfrenchspacing450377
+Ref: \frenchspacing450495
+Node: \normalsfcodes451297
+Node: \(SPACE)451565
+Ref: Leading blanks453505
+Node: ~453818
+Node: \thinspace & \negthinspace456395
+Node: \/457593
+Node: \hrulefill & \dotfill459551
+Node: \bigskip & \medskip & \smallskip460907
+Ref: bigskip461725
+Ref: medskip461929
+Ref: smallskip462138
+Node: \bigbreak & \medbreak & \smallbreak462799
+Node: \strut463785
+Node: \vspace467022
+Node: \vfill468583
+Node: \addvspace469511
+Node: Boxes471557
+Node: \mbox & \makebox472263
+Ref: mbox makebox depth473531
+Ref: mbox makebox height473531
+Ref: mbox makebox width473531
+Ref: mbox makebox totalheight473531
+Node: \fbox & \framebox475626
+Ref: fbox framebox fboxrule476933
+Ref: fbox framebox fboxsep477123
+Node: \parbox478225
+Node: \raisebox480531
+Ref: raisebox depth481504
+Ref: raisebox height481504
+Ref: raisebox width481504
+Ref: raisebox totalheight481504
+Node: \sbox & \savebox482205
+Node: lrbox485267
+Node: \usebox486153
+Node: Color486592
+Node: Color package options487391
+Node: Color models489037
+Ref: color models cmyk489834
+Ref: color models gray490197
+Ref: color models rgb490346
+Ref: color models RGB490683
+Ref: color models named491058
+Node: Commands for color491346
+Node: Define colors491761
+Node: Colored text492486
+Node: Colored boxes494883
+Node: Colored pages496272
+Node: Graphics496965
+Node: Graphics package options499091
+Node: Graphics package configuration501844
+Node: \graphicspath502646
+Node: \DeclareGraphicsExtensions505604
+Node: \DeclareGraphicsRule507422
+Node: Commands for graphics510603
+Node: \includegraphics511108
+Ref: includegraphics width516171
+Ref: includegraphics height516704
+Ref: includegraphics totalheight517110
+Ref: includegraphics keepaspectratio517374
+Ref: includegraphics viewport519060
+Ref: includegraphics trim519455
+Ref: includegraphics clip519911
+Ref: includegraphics page520171
+Ref: includegraphics pagebox520262
+Ref: includegraphics interpolate521127
+Ref: includegraphics quiet521332
+Ref: includegraphics draft521493
+Ref: includegraphics bb522298
+Ref: includegraphics bbllx522696
+Ref: includegraphics bblly522696
+Ref: includegraphics bburx522696
+Ref: includegraphics bbury522696
+Ref: includegraphics natwidth522838
+Ref: includegraphics natheight522838
+Ref: includegraphics hiresbb523024
+Ref: includegraphics type523786
+Ref: includegraphics ext523826
+Ref: includegraphics read523929
+Ref: includegraphics command524046
+Node: \rotatebox524292
+Node: \scalebox527146
+Node: \resizebox528202
+Node: Special insertions529394
+Node: Reserved characters530262
+Node: Upper and lower case531522
+Node: Symbols by font position533908
+Node: Text symbols534587
+Node: Accents539571
+Node: \accent541724
+Node: Additional Latin letters543486
+Ref: Non-English characters543668
+Node: inputenc package544687
+Node: \rule547237
+Node: \today548425
+Node: Splitting the input549361
+Node: \endinput551103
+Node: \include & \includeonly552406
+Node: \input556703
+Node: Front/back matter557918
+Node: Table of contents etc.558251
+Node: \@dottedtocline563956
+Node: \addcontentsline565543
+Node: \addtocontents568606
+Node: \contentsline570823
+Node: \nofiles572601
+Node: \numberline573352
+Node: Indexes574516
+Node: \index577230
+Node: makeindex582335
+Ref: makeindex preamble584003
+Ref: makeindex postamble584143
+Ref: makeindex group skip584228
+Ref: makeindex letheadflag584561
+Ref: makeindex lethead prefix585022
+Ref: makeindex lethead suffix585174
+Ref: makeindex item 0585322
+Ref: makeindex item 1585402
+Ref: makeindex item 2585477
+Ref: makeindex item 01585555
+Ref: makeindex item x1585660
+Ref: makeindex item 12585865
+Ref: makeindex item x2585973
+Ref: makeindex delim 0586133
+Ref: makeindex delim 1586263
+Ref: makeindex delim 2586393
+Ref: makeindex delim n586519
+Ref: makeindex delim r586654
+Ref: makeindex line max586762
+Ref: makeindex indent space586897
+Ref: makeindex indent length586992
+Ref: makeindex page precedence587177
+Node: \printindex588212
+Node: Glossaries588685
+Node: \newglossaryentry590652
+Node: \gls592119
+Node: Letters592913
+Node: \address596531
+Node: \cc597342
+Node: \closing597784
+Node: \encl598098
+Node: \location598512
+Node: \makelabels598776
+Node: \name601093
+Node: \opening601334
+Node: \ps601615
+Node: \signature601904
+Node: \telephone603132
+Node: Input/output603497
+Node: \openin & \openout604227
+Node: \read606970
+Node: \typein608157
+Node: \typeout609417
+Node: \write610467
+Node: \write and security615194
+Node: \message616138
+Node: \wlog617967
+Node: \write18618468
+Node: Command line interface621959
+Ref: Command line622123
+Node: Command line options624276
+Ref: interaction modes625279
+Ref: output directory626233
+Node: Command line input627932
+Node: Jobname630055
+Node: Recovering from errors633197
+Node: Document templates634625
+Node: beamer template635059
+Node: article template635701
+Node: book template636164
+Node: Larger book template636643
+Node: Index638185
+Ref: Command Index638271
End Tag Table
Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2021-08-13 17:12:43 UTC (rev 987)
+++ trunk/latex2e.texi 2021-08-16 15:29:44 UTC (rev 988)
@@ -3297,7 +3297,109 @@
@LaTeX{}?''
(@url{https://www.latex-project.org/publications/2014-FMi-TUB-tb111mitt-float-placement.pdf}).
+ at menu
+* \caption:: Make a caption for a floating environment.
+ at end menu
+
+ at node \caption
+ at subsection @code{\caption}
+
+ at findex \caption
+ at cindex captions
+
+Synopsis:
+
+ at example
+\caption@{@var{caption-text}@}
+ at end example
+
+ at noindent
+or
+
+ at example
+\caption[@var{short-caption-text}]@{@var{caption-text}@}
+ at end example
+
+Make a caption for a floating environment, such as a @code{figure} or
+ at code{table} environment (@pxref{figure} or @ref{table}).
+
+In this example, @LaTeX{} places a caption below the blank space that is
+left by the author for the later inclusion of a picture.
+
+ at example
+\begin@{figure@}
+ \vspace*@{1cm@}
+ \caption@{Alonzo Cushing, Battery A, 4th US Artillery.@}
+ \label@{fig:CushingPic@}
+\end@{figure@}
+ at end example
+
+ at noindent
+The @code{\caption} command will label the @var{caption-text} with
+something like @samp{Figure at tie{}1:} for an article or
+ at samp{Figure at tie{}1.1:} for a book. The text is centered if it is
+shorter than the text width, or set as an unindented paragraph if it
+takes more than one line.
+
+In addition to placing the @var{caption-text} in the output, the
+ at code{\caption} command also saves that information for use in a list of
+figures or list of tables (see @ref{Table of contents etc.}).
+
+Here the @code{\caption} command uses the optional
+ at var{short-caption-text}, so that the shorter text appears in the list
+of tables, rather than the longer @var{caption-text}.
+
+ at example
+\begin@{table@}
+ \centering
+ \begin@{tabular@}@{|*@{3@}@{c@}|@}
+ \hline
+ 4 &9 &2 \\
+ 3 &5 &7 \\
+ 8 &1 &6 \\
+ \hline
+ \end@{tabular@}
+ \caption[\textit@{Lo Shu@} magic square]@{%
+ The \textit@{Lo Shu@} magic square, which is unique among
+ squares of order three up to rotation and reflection.@}
+ \label@{tab:LoShu@}
+\end@{table@}
+ at end example
+
+ at noindent
+ at LaTeX{} will label the @var{caption-text} with something like
+ at samp{Table at tie{}1:} for an article or @samp{Table at tie{}1.1:} for a
+book.
+
+The caption can appear at the top of the @code{figure} or @code{table}.
+For instance, that would happen in the prior example by putting the
+ at code{\caption} between the @code{\centering} and the
+ at code{\begin@{tabular@}}.
+
+Different floating environments are numbered separately, by default.
+The counter for the @code{figure} environment is named @code{figure},
+and similarly the counter for the @code{table} environment is
+ at code{table}.
+
+The text that will be put in the list of figures or list of tables is
+moving text. If you get the @LaTeX{} error @samp{! Argument of
+\@@caption has an extra @}} then you must put @code{\protect} in front
+of any fragile commands. @xref{\protect}.
+
+The @code{caption} package has many options to adjust how the caption
+appears, for example changing the font size, making the caption be
+hanging text rather than set as a paragraph, or making the caption
+always set as a paragraph rather than centered when it is short.
+
+
+
+
+
+
+
+
+
@node Sectioning
@chapter Sectioning
@@ -4803,7 +4905,6 @@
@findex \centering
@cindex centering text, declaration for
-
Synopsis:
@example
@@ -5295,9 +5396,9 @@
references}).
@findex \caption
The optional @code{\caption} command specifies caption text for the
-figure. By default it is numbered. If @var{loftitle} is present, it is
-used in the list of figures instead of @var{title} (@pxref{Table of
-contents etc.}).
+figure (@pxref{\caption}). By default it is numbered. If @var{loftitle}
+is present, it is used in the list of figures instead of @var{title}
+(@pxref{Table of contents etc.}).
This example makes a figure out of a graphic. @LaTeX{} will place that
graphic and its caption at the top of a page or, if it is pushed to the
@@ -7358,9 +7459,10 @@
references}).
@findex \caption
The @code{\caption} command is also optional. It specifies caption text
- at var{title} for the table. By default it is numbered. If its optional
- at var{lottitle} is present then that text is used in the list of tables
-instead of @var{title} (@pxref{Table of contents etc.}).
+ at var{title} for the table (@pxref{\caption}). By default it is
+numbered. If its optional @var{lottitle} is present then that text is
+used in the list of tables instead of @var{title} (@pxref{Table of
+contents etc.}).
In this example the table and caption will float to the bottom of a page,
unless it is pushed to a float page at the end.
@@ -10333,9 +10435,10 @@
\ignorespacesafterend
@end example
-Both commands cause @LaTeX{} to ignore spaces after the end of the
-command up until the first non-space character. The first is a command
-from plain @TeX{}, and the second is @LaTeX{}-specific.
+Both commands cause @LaTeX{} to ignore spaces (that is, characters of
+category at tie{}10) after the end of the command, up until the first
+non-space character. The first is a command from plain @TeX{}, and the
+second is @LaTeX{}-specific.
The @code{ignorespaces} is often used when defining commands via
@code{\newcommand}, or @code{\newenvironment}, or @code{\def}. The
@@ -16901,7 +17004,7 @@
Graphics come in two main types, raster and vector. @LaTeX{} can use
both. In raster graphics the file contains an entry for each location
-in an array, describing what color it is. An example is a photograph,
+in an array, describing what color it is. An example is a photograph
in JPG format. In vector graphics, the file contains a list of
instructions such as @samp{draw a circle with this radius and that
center}. An example is a line drawing produced by the Asymptote
@@ -19637,16 +19740,21 @@
@code{\renewcommand@{\numberline@}[1]@{#1~@}} before
@code{\tableofcontents}.
-This command is fragile, so you may need to precede it with
+This command is fragile so you may need to precede it with
@code{\protect} (@pxref{\protect}). An example is the use of
- at code{\protect} in the command
+ at code{\protect} in this command,
+
+ at example
@code{\addcontentsline@{toc@}@{section@}@{\protect\numberline@{@}Summary@}}
-to get the @code{\numberline} into the @code{\contentsline} command in
-the @file{.toc} file: @code{\contentsline @{section@}@{\numberline
-@{@}Summary@}@{6@}} (the page number @samp{6} is automatically added by
- at LaTeX{}; @pxref{\addcontentsline}).
+ at end example
+ at noindent
+to get the @code{\numberline} into the @code{\contentsline}
+command in the @file{.toc} file: @code{\contentsline
+@{section@}@{\numberline @{@}Summary@}@{6@}} (the page number @samp{6}
+is automatically added by @LaTeX{}; @pxref{\addcontentsline}).
+
@node Indexes
@section Indexes
Modified: trunk/writing.html
===================================================================
--- trunk/writing.html 2021-08-13 17:12:43 UTC (rev 987)
+++ trunk/writing.html 2021-08-16 15:29:44 UTC (rev 988)
@@ -174,7 +174,9 @@
If convenient, furnish any parameter values that are in the standard
classes.
For instance, <code>\footnote</code> has <code>\footnoterule</code>
- and <code>\footnotesep</code>.</li>
+ and <code>\footnotesep</code>.
+ Consider giving the values of any magic numbers in the standard packages.
+ </li>
<li><span class="listitem">Some entries end with more examples.</span>
Following the full explanation, you may want to give
@@ -185,7 +187,8 @@
For most commands the arguments are simple, but for some they
merit more complete coverage.</li>
- <li>Define index entries, with <tt>@cindex</tt> for the general index
+ <li><span class="listitem">Define index entries,</span>
+ with <tt>@cindex</tt> for the general index
and <tt>@findex</tt> for macro and other code names. Start general
index entries with a lowercase letter (“<tt>font</tt>”,
unless the word would normally be capitalized
@@ -202,7 +205,10 @@
(1) Test all examples, no matter how small.
(2) Use best practices, both coding and typographic practices,
such as including the <code>\,</code> space in <code>$\int x\, dx$</code>.
- (3) Keep it brief but make it interesting, or at least sensible.
+ (3) There is such a thing as too many examples.
+ Perhaps two or at most three is enough.
+ (4) Keep them brief.
+ (5) Make them interesting, or at least sensible.
If you are illustrating an aspect of formula writing
then use an actual formula.
For text, use an example from an actual document if reasonable but
@@ -264,6 +270,7 @@
<li><span class="listitem">Tags</span>
Use <code>@code{..}</code> for code,
<code>@file{..}</code> for file names,
+ <code>@code{..}</code> for package names,
<code>@samp{..}</code> for examples.
Don't forget that curly braces inside examples need to be escaped
with at-signs: <code>@code{\macro@{arg@}</code>.</li>
More information about the latexrefman-commits
mailing list.