[latexrefman-commits] [SCM] latexrefman updated: r929 - trunk
Jim Hefferon
INVALID.NOREPLY at gnu.org.ua
Sun Jun 27 18:27:42 CEST 2021
Author: jimhefferon
Date: 2021-06-27 16:27:42 +0000 (Sun, 27 Jun 2021)
New Revision: 929
Modified:
trunk/ChangeLog
trunk/latex2e.html
trunk/latex2e.info
trunk/latex2e.pdf
trunk/latex2e.texi
Log:
add section on \@dottedtocline
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2021-06-21 17:30:21 UTC (rev 928)
+++ trunk/ChangeLog 2021-06-27 16:27:42 UTC (rev 929)
@@ -1,3 +1,8 @@
+2021-06-27 Jim Hefferon <jhefferon at smcvt.edu>
+
+ * latex2e.texi (\@dottedtocline): Add section. Move some
+ material up to Table of Contents to avoid duplication.
+
2021-06-21 Karl Berry <karl at freefriends.org>
* latex2e.texi (Jobname): updates; consistently use "jobname"
@@ -14,11 +19,11 @@
2021-06-12 Jim Hefferon <jim at joshua.smcvt.edu>
- * latex2e.texi (Expressions): Add section on \numberline.
+ * latex2e.texi (\numberline): Add section on \numberline.
2021-06-11 Jim Hefferon <jim at joshua.smcvt.edu>
- * latex2e.texi (Expressions): Add section on \contentsline.
+ * latex2e.texi (\contentsline): Add section on \contentsline.
2021-06-09 Jim Hefferon <jim at joshua.smcvt.edu>
Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html 2021-06-21 17:30:21 UTC (rev 928)
+++ trunk/latex2e.html 2021-06-27 16:27:42 UTC (rev 929)
@@ -532,11 +532,12 @@
<ul class="no-bullet">
<li><a id="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 id="toc-_005caddcontentsline-1" href="#g_t_005caddcontentsline">25.1.1 <code>\addcontentsline</code></a></li>
- <li><a id="toc-_005caddtocontents-1" href="#g_t_005caddtocontents">25.1.2 <code>\addtocontents</code></a></li>
- <li><a id="toc-_005ccontentsline-1" href="#g_t_005ccontentsline">25.1.3 <code>\contentsline</code></a></li>
- <li><a id="toc-_005cnofiles-1" href="#g_t_005cnofiles">25.1.4 <code>\nofiles</code></a></li>
- <li><a id="toc-_005cnumberline-1" href="#g_t_005cnumberline">25.1.5 <code>\numberline</code></a></li>
+ <li><a id="toc-_005c_0040dottedtocline-1" href="#g_t_005c_0040dottedtocline">25.1.1 <code>\@dottedtocline</code></a></li>
+ <li><a id="toc-_005caddcontentsline-1" href="#g_t_005caddcontentsline">25.1.2 <code>\addcontentsline</code></a></li>
+ <li><a id="toc-_005caddtocontents-1" href="#g_t_005caddtocontents">25.1.3 <code>\addtocontents</code></a></li>
+ <li><a id="toc-_005ccontentsline-1" href="#g_t_005ccontentsline">25.1.4 <code>\contentsline</code></a></li>
+ <li><a id="toc-_005cnofiles-1" href="#g_t_005cnofiles">25.1.5 <code>\nofiles</code></a></li>
+ <li><a id="toc-_005cnumberline-1" href="#g_t_005cnumberline">25.1.6 <code>\numberline</code></a></li>
</ul></li>
<li><a id="toc-Indexes-1" href="#Indexes">25.2 Indexes</a>
<ul class="no-bullet">
@@ -582,7 +583,7 @@
<ul class="no-bullet">
<li><a id="toc-Command-line-options-1" href="#Command-line-options">28.1 Command line options</a></li>
<li><a id="toc-Command-line-input-1" href="#Command-line-input">28.2 Command line input</a></li>
- <li><a id="toc-Job-name" href="#Jobname">28.3 Job name</a></li>
+ <li><a id="toc-Jobname-1" href="#Jobname">28.3 Jobname</a></li>
<li><a id="toc-Recovering-from-errors-1" href="#Recovering-from-errors">28.4 Recovering from errors</a></li>
</ul></li>
<li><a id="toc-Document-templates-1" href="#Document-templates">Appendix A Document templates</a>
@@ -2096,7 +2097,7 @@
</div>
<span id="fontenc-package-1"></span><h3 class="section">4.1 <code>fontenc</code> package</h3>
-<span id="index-Font-encoding"></span>
+<span id="index-font-encoding"></span>
<span id="index-UTF_002d8_002c-font-support-for"></span>
<span id="index-T1"></span>
<span id="index-OT1"></span>
@@ -2233,9 +2234,9 @@
</div>
<span id="g_t_005cDeclareFontEncoding-1"></span><h4 class="subsection">4.1.1 <code>\DeclareFontEncoding</code></h4>
-<span id="index-Font-encoding-1"></span>
-<span id="index-Encoding_002c-font"></span>
-<span id="index-Accents_002c-defining"></span>
+<span id="index-font-encoding_002c-declaring"></span>
+<span id="index-encoding_002c-font"></span>
+<span id="index-accents_002c-defining"></span>
<span id="index-_005cDeclareFontEncoding"></span>
<p>Synopsis:
@@ -2283,8 +2284,8 @@
</div>
<span id="g_t_005cDeclareTextAccent-1"></span><h4 class="subsection">4.1.2 <code>\DeclareTextAccent</code></h4>
-<span id="index-Font-encoding-2"></span>
-<span id="index-Accents_002c-defining-1"></span>
+<span id="index-font-encoding-1"></span>
+<span id="index-accents_002c-defining-1"></span>
<span id="index-_005cDeclareTextAccent"></span>
<p>Synopsis:
@@ -2319,8 +2320,7 @@
</div>
<span id="g_t_005cDeclareTextAccentDefault-1"></span><h4 class="subsection">4.1.3 <code>\DeclareTextAccentDefault</code></h4>
-<span id="index-Font-encoding-3"></span>
-<span id="index-Accents_002c-defining-2"></span>
+<span id="index-accents_002c-defining-2"></span>
<span id="index-_005cDeclareTextAccent-1"></span>
<span id="index-_005cDeclareTextAccentDefault"></span>
@@ -2364,7 +2364,6 @@
</div>
<span id="g_t_005cDeclareTextCommand-_0026-_005cProvideTextCommand-1"></span><h4 class="subsection">4.1.4 <code>\DeclareTextCommand</code> & <code>\ProvideTextCommand</code></h4>
-<span id="index-Font-encoding-4"></span>
<span id="index-_005cDeclareTextCommand"></span>
<span id="index-_005cDeclareTextCommandDefault"></span>
<span id="index-_005cProvideTextCommand"></span>
@@ -2432,7 +2431,7 @@
Next: <a href="#g_t_005cDeclareTextComposite" accesskey="n" rel="next">\DeclareTextComposite</a>, Previous: <a href="#g_t_005cDeclareTextCommand-_0026-_005cProvideTextCommand" accesskey="p" rel="prev">\DeclareTextCommand & \ProvideTextCommand</a>, Up: <a href="#fontenc-package" accesskey="u" rel="up">fontenc package</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_005cDeclareTextCommandDefault-_0026-_005cProvideTextCommandDefault-"></span><h4 class="subsection">4.1.5 <code>\DeclareTextCommandDefault</code> & <code>\ProvideTextCommandDefault </code></h4>
-<span id="index-Font-encoding-5"></span>
+
<span id="index-_005cDeclareTextCommand-1"></span>
<span id="index-_005cDeclareTextCommandDefault-1"></span>
<span id="index-_005cProvideTextCommand-1"></span>
@@ -2480,8 +2479,7 @@
</div>
<span id="g_t_005cDeclareTextComposite-1"></span><h4 class="subsection">4.1.6 <code>\DeclareTextComposite</code></h4>
-<span id="index-Font-encoding-6"></span>
-<span id="index-Accents_002c-defining-3"></span>
+<span id="index-accents_002c-defining-3"></span>
<span id="index-_005cDeclareTextComposite"></span>
<p>Synopsis:
@@ -2518,8 +2516,7 @@
</div>
<span id="g_t_005cDeclareTextCompositeCommand-1"></span><h4 class="subsection">4.1.7 <code>\DeclareTextCompositeCommand</code></h4>
-<span id="index-Font-encoding-7"></span>
-<span id="index-Accents_002c-defining-4"></span>
+<span id="index-accents_002c-defining-4"></span>
<span id="index-_005cDeclareTextCompositeCommand"></span>
<p>Synopsis:
@@ -2550,8 +2547,7 @@
</div>
<span id="g_t_005cDeclareTextSymbol-1"></span><h4 class="subsection">4.1.8 <code>\DeclareTextSymbol</code></h4>
-<span id="index-Font-encoding-8"></span>
-<span id="index-Symbol_002c-defining"></span>
+<span id="index-symbol_002c-defining"></span>
<span id="index-_005cDeclareTextSymbol"></span>
<p>Synopsis:
@@ -2591,8 +2587,7 @@
</div>
<span id="g_t_005cDeclareTextSymbolDefault-1"></span><h4 class="subsection">4.1.9 <code>\DeclareTextSymbolDefault</code></h4>
-<span id="index-Font-encoding-9"></span>
-<span id="index-Accents_002c-defining-5"></span>
+<span id="index-accents_002c-defining-5"></span>
<span id="index-_005cDeclareTextSymbol-1"></span>
<span id="index-_005cDeclareTextSymbolDefault"></span>
@@ -2632,7 +2627,6 @@
</div>
<span id="g_t_005cLastDeclaredEncoding-1"></span><h4 class="subsection">4.1.10 <code>\LastDeclaredEncoding</code></h4>
-<span id="index-Font-encoding-10"></span>
<span id="index-_005cLastDeclaredEncoding"></span>
<p>Synopsis:
@@ -2661,7 +2655,6 @@
</div>
<span id="g_t_005cUseTextSymbol-_0026-_005cUseTextAccent-1"></span><h4 class="subsection">4.1.11 <code>\UseTextSymbol</code> & <code>\UseTextAccent</code></h4>
-<span id="index-Font-encoding-11"></span>
<span id="index-_005cUseTextSymbol"></span>
<span id="index-_005cUseTextAccent"></span>
@@ -7315,7 +7308,8 @@
<span id="index-siunitx-package"></span>
<div class="example">
-<pre class="example">% siunitx to have the S column specifier, which aligns numbers on decimal point
+<pre class="example">% siunitx to have the S column specifier,
+% which aligns numbers on their decimal point.
\usepackage{siunitx}
\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
...
@@ -7326,7 +7320,8 @@
\begin{tabular}{r|S}
% \multicolumn to remove vertical bar between column headers
\multicolumn{1}{r}{Borough} &
- % Braces to prevent siunitx to misinterprete point as a decimal separator
+ % braces to prevent siunitx from misinterpreting the
+ % period as a decimal separator
{Pop. (million)} \\ \hline
The Bronx &1.5 \\
Brooklyn &2.6 \\
@@ -9113,13 +9108,13 @@
</p>
<p>Under the hood, LaTeX remembers the <var>cite_key</var> and <var>label</var>
information because <code>\bibitem</code> writes it to the auxiliary file
-<samp><var>jobname</var>.aux</samp> (see <a href="#Jobname">Jobname</a>). For instance, the above example causes
-<code>\bibcite{latexdps}{Lamport, 1993}</code> and
-<code>\bibcite{texbook}{1}</code> to appear in that file. The <samp>.aux</samp>
-file is read by the <code>\begin{document}</code> command and then the
-information is available for <code>\cite</code> commands. This explains why
-you need to run LaTeX twice to resolve references: once to write it
-out and once to read it in.
+<samp><var>jobname</var>.aux</samp> (see <a href="#Jobname">Jobname</a>). For instance, the above
+example causes <code>\bibcite{latexdps}{Lamport, 1993}</code> and
+<code>\bibcite{texbook}{1}</code> to appear in that file. The
+<samp>.aux</samp> file is read by the <code>\begin{document}</code> command and
+then the information is available for <code>\cite</code> commands. This
+explains why you need to run LaTeX twice to resolve references:
+once to write it out and once to read it in.
</p>
<p>Because of this two-pass algorithm, when you add a <code>\bibitem</code> or
change its <var>cite_key</var> you may get ‘<samp>LaTeX Warning: Label(s) may
@@ -10439,7 +10434,7 @@
paragraph mode; see <a href="#Modes">Modes</a>). There are some workarounds; see
following sections.
</p>
-<span id="index-Footnotes_002c-in-a-minipage"></span>
+<span id="index-footnotes_002c-in-a-minipage"></span>
<span id="index-mpfootnote-counter"></span>
<p>In a <code>minipage</code> environment the <code>\footnote</code> command uses the
<code>mpfootnote</code> counter instead of the <code>footnote</code> counter, so
@@ -12362,7 +12357,7 @@
<dl compact="compact">
<dt><code>pt</code></dt>
<dd><span id="index-pt"></span>
-<span id="index-Point"></span>
+<span id="index-point"></span>
<span id="units-of-length-pt"></span><p>Point, 1/72.27 inch. The conversion to metric units
is 1point = 2.845mm = .2845cm.
</p>
@@ -12381,37 +12376,37 @@
</dd>
<dt><code>bp</code></dt>
<dd><span id="index-bp"></span>
-<span id="index-Big-point"></span>
+<span id="index-big-point"></span>
<span id="units-of-length-bp"></span><p>Big point, 1/72 inch. This length is the definition of a point in
PostScript and many desktop publishing systems.
</p>
</dd>
<dt><code>cm</code></dt>
-<dd><span id="index-Centimeter"></span>
+<dd><span id="index-centimeter"></span>
<span id="index-cm"></span>
<span id="units-of-length-cm"></span><p>Centimeter
</p>
</dd>
<dt><code>mm</code></dt>
-<dd><span id="index-Millimeter"></span>
+<dd><span id="index-millimeter"></span>
<span id="index-mm"></span>
<span id="units-of-length-mm"></span><p>Millimeter
</p>
</dd>
<dt><code>dd</code></dt>
-<dd><span id="index-Didot-point"></span>
+<dd><span id="index-didot-point"></span>
<span id="index-dd"></span>
<span id="units-of-length-dd"></span><p>Didot point, 1.07 pt
</p>
</dd>
<dt><code>cc</code></dt>
-<dd><span id="index-Cicero"></span>
+<dd><span id="index-cicero"></span>
<span id="index-cc"></span>
<span id="units-of-length-cc"></span><p>Cicero, 12 dd
</p>
</dd>
<dt><code>sp</code></dt>
-<dd><span id="index-Scaled-point"></span>
+<dd><span id="index-scaled-point"></span>
<span id="index-sp"></span>
<span id="units-of-length-sp"></span><p>Scaled point, 1/65536 pt
</p>
@@ -12652,12 +12647,12 @@
glue, or muglue, you can instead write an expression to compute that
type of quantity.
</p>
-<p>An example is that <code>\the\dimexpr\linewidth-4pt\relax</code> will produce
-document output giving the length that is four points less than width of
-a line (the only purpose of <code>\the</code> is to show the result in the
-document). Similarly, <code>\romannumeral\numexpr6+3\relax</code> will
-produce ‘<samp>ix</samp>’, and <code>\the\glueexpr 5pt plus 1pt * 2 \relax</code> will
-produce ‘<samp>10.0pt plus 2.0pt</samp>’.
+<p>An example is that <code>\the\dimexpr\linewidth-4pt\relax</code> will
+produce as output the length that is four points less than width of a
+line (the only purpose of <code>\the</code> is to show the result in the
+document). Analogously, <code>\romannumeral\numexpr6+3\relax</code> will
+produce ‘<samp>ix</samp>’, and <code>\the\glueexpr 5pt plus 1pt * 2 \relax</code>
+will produce ‘<samp>10.0pt plus 2.0pt</samp>’.
</p>
<p>A convenience here over doing calculations by allocating registers and
then using <code>\advance</code>, etc., is that the evaluation of expressions
@@ -12672,9 +12667,10 @@
with charity for all with firmness in the right as God gives us to see
the right let us strive on to finish the work we are in to bind up the
nation's wounds, to care for him who shall have borne the battle and
-for his widow and his orphan ~ to do all which may achieve and cherish
-a just and lasting peace among ourselves and with all nations.
----Abraham Lincoln, Second Inaugural Address, from the memorial}
+for his widow and his orphan \textasciitilde\ to do all which may
+achieve and cherish a just and lasting peace among ourselves and with
+all nations. ---Abraham Lincoln, Second Inaugural Address, from the
+memorial}
\end{center}
</pre></div>
@@ -12691,17 +12687,17 @@
of measure (pt inserted)</code>. This is because for <code>\dimexpr</code> and
<code>\glueexpr</code>, the input consists of a dimension or glue value
followed by an optional multiplication factor, and not the other way
-around. Thus <code>\the\dimexpr1pt*10\relax</code> is valid and produces
-‘<samp>10.0pt</samp>’, but <code>\the\dimexpr10*1pt\relax</code> gives the
+around. Thus <code>\the\dimexpr 1pt*10\relax</code> is valid and produces
+‘<samp>10.0pt</samp>’, but <code>\the\dimexpr 10*1pt\relax</code> gives the
<code>Illegal unit</code> error.
</p>
<p>The expressions absorb tokens and carry out appropriate mathematics up
to a <code>\relax</code> (which will be absorbed), or up to the first
-non-valid token. Thus, <code>\the\numexpr2+3px</code> will print ‘<samp>5px</samp>’,
-because LaTeX reads the <code>\numexpr2+3</code>, which is made up of
-numbers, and then finds <code>px</code>, which is not a number. It therefore
-terminates the expression and produces the ‘<samp>5</samp>’, followed by the
-regular text ‘<samp>px</samp>’.
+non-valid token. Thus, <code>\the\numexpr2+3px</code> will print
+‘<samp>5px</samp>’, because LaTeX reads the <code>\numexpr2+3</code>, which is
+made up of numbers, and then finds the letter <code>p</code>, which cannot
+be part of a number. It therefore terminates the expression and
+produces the ‘<samp>5</samp>’, followed by the regular text ‘<samp>px</samp>’.
</p>
<p>This termination behavior is useful in comparisons. In
<code>\ifnum\numexpr\parindent*2 < 10pt Yes\else No\fi</code>, the less than
@@ -12711,7 +12707,7 @@
<p>Expressions may use the operators <code>+</code>, <code>-</code>, <code>*</code> and
<code>/</code> along with parentheses for subexpressions, <code>(...)</code>. In
glue expressions the <code>plus</code> and <code>minus</code> parts do not need
-parenthesis to be affected by a factor. So <code>\the\glueexpr 5pt plus
+parentheses to be affected by a factor. So <code>\the\glueexpr 5pt plus
1pt * 2 \relax</code> results in ‘<samp>10pt plus 2pt</samp>’.
</p>
<p>TeX will coerce other numerical types in the same way as it does when
@@ -12725,19 +12721,20 @@
‘<samp>3.0pt</samp>’.
</p>
<p>The details of the arithmetic: each factor is checked to be in the
-allowed range, numbers must be less than 2 to the power 31 in absolute
-value, and dimensions or glue components must be less than 2 to the
-power 14 points, or <code>mu</code>, or <code>fil</code>, etc. The arithmetic
-operations are performed individually, except for a scaling operation (a
-multiplication immediately followed by a division) which is done as one
-combined operation with a 64-bit product as intermediate value. The
-result of each operation is again checked to be in the allowed range.
+allowed range, numbers must be less than <em>2^{31}</em> in absolute
+value, and dimensions or glue components must be less than
+<em>2^{14}</em> points, or <code>mu</code>, or <code>fil</code>, etc. The
+arithmetic operations are performed individually, except for a scaling
+operation (a multiplication immediately followed by a division) which
+is done as one combined operation with a 64-bit product as
+intermediate value. The result of each operation is again checked to
+be in the allowed range.
</p>
<p>Finally, division and scaling take place with rounding (unlike TeX’s
<code>\divide</code>, which truncates). Thus
-<code>\the\dimexpr5pt*(3/2)\relax</code> puts ‘<samp>10.0pt</samp>’ in the document,
+<code>\the\dimexpr 5pt*(3/2)\relax</code> puts ‘<samp>10.0pt</samp>’ in the document,
because it rounds <code>3/2</code> to <code>2</code>, while
-<code>\the\dimexpr5pt*(4/3)\relax</code> produces ‘<samp>5.0pt</samp>’.
+<code>\the\dimexpr 5pt*(4/3)\relax</code> produces ‘<samp>5.0pt</samp>’.
</p>
<hr>
@@ -15098,7 +15095,7 @@
</div>
<span id="Delimiters-1"></span><h4 class="subsection">16.2.5 Delimiters</h4>
-<span id="index-Delimiters"></span>
+<span id="index-delimiters"></span>
<span id="index-parentheses"></span>
<span id="index-braces"></span>
<span id="index-curly-braces"></span>
@@ -17476,8 +17473,9 @@
<span id="index-_007e"></span>
<span id="index-tie"></span>
-<span id="index-space_002c-hard"></span>
<span id="index-space_002c-unbreakable"></span>
+<span id="index-hard-space"></span>
+<span id="index-unbreakable-space"></span>
<span id="index-NBSP"></span>
<p>Synopsis:
@@ -21736,7 +21734,7 @@
<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
+<p>To make the table of contents, LaTeX stores the information in an
auxiliary file named <samp><var>root-file</var>.toc</samp> (see <a href="#Splitting-the-input">Splitting the input</a>). For example, this LaTeX file <samp>test.tex</samp>
</p>
<div class="example">
@@ -21748,39 +21746,85 @@
...
</pre></div>
-<p>writes the following line to <samp>test.toc</samp>.
+<p>writes these lines 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. Its unique argument, <code>1</code> or <code>1.1</code>,
-is the sectioning unit number, whereas the remainder of the second
-argument of <code>\contentsline</code>, <code>First section</code> or <code>First
-subsection</code>, is the title. Finally, the third argument, <code>2</code>, is
-the page number on which the sectioning units start (see <a href="#g_t_005ccontentsline">\contentsline</a>).
+<span id="index-_005ccontentsline"></span>
+<p>Each line contains a single command, <code>\contentsline</code>
+(see <a href="#g_t_005ccontentsline">\contentsline</a>). The first argument, the <code>section</code> or
+<code>subsection</code>, is the sectioning unit. The second argument has two
+components. The hook <code>\numberline</code> determines how the sectioning
+number, <code>1</code> or <code>1.1</code>, appears in the table of contents
+(see <a href="#g_t_005cnumberline">\numberline</a>). The remainder of the second argument of
+<code>\contentsline</code>, ‘<samp>First section</samp>’ or ‘<samp>First subsection</samp>’,
+is the sectioning title text. Finally, the third argument, ‘<samp>2</samp>’, is
+the page number on which this sectioning unit starts.
</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>To typeset these lines, the document class provides commands
+<code>\l at section{<var>text</var>}{<var>pagenumber</var>}</code> or
+<code>\l at subsection{<var>text</var>}{<var>pagenumber</var>}</code>, etc. These
+<code>\l@<var>section-unit</var></code> commands often use the
+<code>\@dottedtocline</code> command (see <a href="#g_t_005c_0040dottedtocline">\@dottedtocline</a>).
</p>
+<p>A consequence of LaTeX’s strategy of using auxiliary files is that to
+get the correct information in the document you must run LaTeX twice,
+once to store the information and the second time to retrieve it. In
+the ordinary course of writing a document authors run LaTeX a number
+of times, but you may notice that the first time that you compile a new
+document, the table of contents page will be empty except for its
+‘<samp>Contents</samp>’ header. Just run LaTeX 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.
+list of figures and a list of tables. Their information is stored in
+files with extension <samp>.lof</samp> and <samp>.lot</samp>. They work the same way
+as <code>\tableofcontents</code> but the latter is more common, so we use it
+for most examples.
</p>
-<p>To change the header for the table of contents page do something like
-the first line here.
+<p>You can manually add material to the table of contents, the list of
+figures, and the list of tables. For instance, add a line about a
+section to the table of contents with
+<code>\addcontentsline{toc}{section}{<var>text</var>}</code>.
+(see <a href="#g_t_005caddcontentsline">\addcontentsline</a>). Add arbitrary material, that is, non-line
+material, with <code>\addtocontents</code>, as with the command
+<code>\addtocontents{lof}{\protect\vspace{2ex}}</code>, which adds
+vertical space to the list of figures (see <a href="#g_t_005caddtocontents">\addtocontents</a>).
</p>
+<p>Lines in the table of contents, the list of figures, and the list of
+tables, have four parts. First is an indent. Next is a box into which
+sectioning numbers are placed, and then the third box holds the title
+text, such as ‘<samp>First section</samp>’. Finally there is a box up against
+the right margin, inside of which LaTeX puts the page number box.
+For the indent and the width of the number box,
+see <a href="#g_t_005c_0040dottedtocline">\@dottedtocline</a>. The right margin box has width
+<code>\@tocrmarg</code> and the page number is flush right in that space,
+inside a box of width <code>\@pnumwidth</code>. By default
+<code>\@tocrmarg</code> is <code>2.55em</code> and <code>\@pnumwidth</code> is
+<code>1.55em</code>. Change these as with
+<code>\renewcommand{\@tocrmarg}{3.5em}</code>.
+</p>
+<span id="index-package_002c-tocloft"></span>
+<span id="index-tocloft-package"></span>
+
+<span id="index-package_002c-tocbibbind"></span>
+<span id="index-tocbibbind-package"></span>
+
+<p>CTAN has many packages for the table of contents and lists of figures
+and tables (see <a href="#CTAN">CTAN</a>). The package <samp>tocloft</samp> is convenient for
+adjusting some aspects of the default such as spacing. And,
+<samp>tocbibbind</samp> will automatically add the bibliography, index,
+etc. to the table of contents.
+</p>
+<p>To change the header for the table of contents page, do something like
+these commands before you call <code>\tableofcontents</code>, etc.
+</p>
<div class="example">
-<pre class="example">\renewcommand{\contentsname}{Table of contents}
+<pre class="example">\renewcommand{\contentsname}{Table of Contents}
\renewcommand{\listfigurename}{Plots}
-\renewcommand{\listtablename}{Tables}
+\renewcommand{\listtablename}{Specifications}
</pre></div>
<p><span id="index-package_002c-babel-4"></span>
@@ -21789,42 +21833,77 @@
<span id="index-package_002c-polyglossia-2"></span>
<span id="index-polyglossia-package-2"></span>
-<p>Similarly, the other two lines will do the other two.
-Internationalization packages such as <samp>babel</samp> or <samp>polyglossia</samp>
-will change the headers depending on the chosen base language.
+<p>Internationalization packages such as <samp>babel</samp> or <samp>polyglossia</samp>
+will change these headers depending on the chosen base language.
</p>
-<span id="index-package_002c-tocloft"></span>
-<span id="index-tocloft-package"></span>
-
-<span id="index-package_002c-tocbibbind"></span>
-<span id="index-tocbibbind-package"></span>
-
-<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.
+<tr><td align="left" valign="top">• <a href="#g_t_005c_0040dottedtocline" accesskey="1">\@dottedtocline</a></td><td> </td><td align="left" valign="top">Format entry line in 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.
+<tr><td align="left" valign="top">• <a href="#g_t_005caddcontentsline" accesskey="2">\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_005ccontentsline" accesskey="3">\contentsline</a></td><td> </td><td align="left" valign="top">Internal command to set line in table of contents, etc.
+<tr><td align="left" valign="top">• <a href="#g_t_005caddtocontents" accesskey="3">\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="4">\nofiles</a></td><td> </td><td align="left" valign="top">Prevent writing to auxiliary files.
+<tr><td align="left" valign="top">• <a href="#g_t_005ccontentsline" accesskey="4">\contentsline</a></td><td> </td><td align="left" valign="top">Set line in table of contents, etc.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_005cnumberline" accesskey="5">\numberline</a></td><td> </td><td align="left" valign="top">Put its number argument flush left in a box.
+<tr><td align="left" valign="top">• <a href="#g_t_005cnofiles" accesskey="5">\nofiles</a></td><td> </td><td align="left" valign="top">Prevent writing to auxiliary files.
</td></tr>
+<tr><td align="left" valign="top">• <a href="#g_t_005cnumberline" accesskey="6">\numberline</a></td><td> </td><td align="left" valign="top">Put its number argument flush left in a box.
+</td></tr>
</table>
<hr>
+<span id="g_t_005c_0040dottedtocline"></span><div class="header">
+<p>
+Next: <a href="#g_t_005caddcontentsline" accesskey="n" rel="next">\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="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="g_t_005c_0040dottedtocline-1"></span><h4 class="subsection">25.1.1 <code>\@dottedtocline</code></h4>
+
+<span id="index-_005c_0040dottedtocline"></span>
+<span id="index-table-of-contents-entry_002c-create-dotted-line"></span>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\@dottedtocline{<var>section-level-num</var>}{<var>indent</var>}{<var>numwidth</var>}{<var>text</var>}{<var>pagenumber</var>}
+</pre></div>
+
+<p>Used internally by LaTeX to format an entry line in the table of
+contents, list of figures, or list of tables. Authors do not directly
+enter <code>\@dottedtocline</code> commands.
+</p>
+<p>This command is often used by <code>\l at section</code>, <code>\l at subsection</code>,
+etc., to format the content lines. For example, the <samp>article.cls</samp>
+file contains these definitions.
+</p>
+<div class="example">
+<pre class="example">\newcommand*\l at section{\@dottedtocline{1}{1.5em}{2.3em}}
+\newcommand*\l at subsection{\@dottedtocline{2}{3.8em}{3.2em}}
+\newcommand*\l at subsubsection{\@dottedtocline{3}{7.0em}{4.1em}}
+</pre></div>
+
+<p>(In this example, <code>\@dottedcline</code> appears to have been given only
+three arguments. But tracing the internal code shows it picks up the
+<var>text</var> and <var>pagenumber</var> arguments from a call to
+<code>\contentsline</code>.)
+</p>
+<p>Between the box for the title text of a section and the right margin
+box, these <code>\@dottedtocline</code> commands insert leaders,
+evenly-spaced dots. The dot-to-dot space is given by the command
+<code>\@dotsep</code>. By default it is 4.5 (it is in math units, which are
+<code>1/18</code> em. Change it using <code>\renewcommand</code>, as with
+<code>\renewcommand{\@dotsep}{3.5}</code>. (In the default book class,
+LaTeX does not use dotted leaders for the Part and Chapter table
+entries, and in the default article class it does not use dotted leaders
+for Section entries.)
+</p>
+
+<hr>
<span id="g_t_005caddcontentsline"></span><div class="header">
<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="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005caddtocontents" accesskey="n" rel="next">\addtocontents</a>, Previous: <a href="#g_t_005c_0040dottedtocline" accesskey="p" rel="prev">\@dottedtocline</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="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="g_t_005caddcontentsline-1"></span><h4 class="subsection">25.1.1 <code>\addcontentsline</code></h4>
+<span id="g_t_005caddcontentsline-1"></span><h4 class="subsection">25.1.2 <code>\addcontentsline</code></h4>
<span id="index-_005caddcontentsline"></span>
<span id="index-table-of-contents-entry_002c-manually-adding"></span>
@@ -21835,10 +21914,8 @@
<pre class="example">\addcontentsline{<var>ext</var>}{<var>unit</var>}{<var>text</var>}
</pre></div>
-<span id="index-_005ccontentsline"></span>
-<p>Add an entry to the file specified by <var>ext</var>. Usually <var>ext</var> is
-one of: <code>toc</code> for the table of contents, <code>lof</code> for the list of
-figures, or <code>lot</code> for the list of tables.
+<span id="index-_005ccontentsline-1"></span>
+<p>Add an entry to the auxillary file with extension <var>ext</var>.
</p>
<p>The following will result in an ‘<samp>Appendices</samp>’ line in the table of
contents.
@@ -21861,10 +21938,10 @@
</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.
+also used by authors. For example, an author writing a book whose style
+is to have an unnumbered preface may use the starred <code>\chapter*</code>.
+But that command leaves out table of contents information, which can be
+entered manually, as here.
</p>
<div class="example">
<pre class="example">\chapter*{Preface}
@@ -21872,10 +21949,9 @@
</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>’.
+{chapter}{\numberline {}Preface}{3}</code>; note that the page number
+‘<samp>3</samp>’ is automatically generated by the system, not entered manually.
</p>
-
<p>All of the arguments for <code>\addcontentsline</code> are required.
</p>
<dl compact="compact">
@@ -21932,7 +22008,7 @@
<p>
Next: <a href="#g_t_005ccontentsline" accesskey="n" rel="next">\contentsline</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="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="g_t_005caddtocontents-1"></span><h4 class="subsection">25.1.2 <code>\addtocontents</code></h4>
+<span id="g_t_005caddtocontents-1"></span><h4 class="subsection">25.1.3 <code>\addtocontents</code></h4>
<span id="index-_005caddtocontents_007bext_007d_007btext_007d"></span>
@@ -21944,7 +22020,7 @@
<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
+for the table of contents so that is the discussion here, but it 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
@@ -21955,6 +22031,28 @@
\addtocontents{toc}{\protect\vspace*{3ex}}
</pre></div>
+<p>This puts the word ‘<samp>Page</samp>’, in boldface, above the column of page
+numbers and after the header.
+</p>
+<div class="example">
+<pre class="example">\tableofcontents
+\addtocontents{toc}{~\hfill\textbf{Page}\par}
+\chapter{...}
+</pre></div>
+
+<p>This adds a line announcing work by a new author.
+</p>
+<div class="example">
+<pre class="example">\addtocontents{toc}{%
+ \protect\vspace{2ex}
+ \textbf{Chapters by N. Other Author}\par}
+</pre></div>
+
+<p>The difference between <code>\addtocontents</code> and <code>\addcontentsline</code>
+is that the latter is strictly for lines, such as with a line giving the
+page number for the start of a new subset of the chapters. As the above
+examples show, <code>\addtocontents</code> is for material such as spacing.
+</p>
<p>The <code>\addtocontents</code> command has two arguments. Both are
required.
</p>
@@ -21989,10 +22087,10 @@
<p>
Next: <a href="#g_t_005cnofiles" accesskey="n" rel="next">\nofiles</a>, 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="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="g_t_005ccontentsline-1"></span><h4 class="subsection">25.1.3 <code>\contentsline</code></h4>
+<span id="g_t_005ccontentsline-1"></span><h4 class="subsection">25.1.4 <code>\contentsline</code></h4>
-<span id="index-Table-of-contents"></span>
-<span id="index-_005ccontentsline-1"></span>
+<span id="index-table-of-contents"></span>
+<span id="index-_005ccontentsline-2"></span>
<span id="index-_005ctableofcontents-1"></span>
<span id="index-_002etoc-file-2"></span>
<span id="index-_005clistoffigures-1"></span>
@@ -22009,12 +22107,12 @@
<pre class="example">\contentsline{<var>unit</var>}{<var>text</var>}{<var>pagenumber</var>}
</pre></div>
-<p>Used internally by LaTeX to typeset an entry of the Table of
-Contents, List of Figures, or List of Tables (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>). Authors do not directly enter <code>\contentsline</code> commands.
+<p>Used internally by LaTeX to typeset an entry of the table of
+contents, list of figures, or list of tables (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>). Authors do not directly enter <code>\contentsline</code> commands.
</p>
<p>Usually adding material to these lists is done automatically by the
-commands <code>\chapter</code>, <code>\section</code>, etc. for the Table of
-Contents, or by the <code>\caption</code> command inside of a <code>\figure</code>
+commands <code>\chapter</code>, <code>\section</code>, etc. for the table of
+contents, or by the <code>\caption</code> command inside of a <code>\figure</code>
or <code>\table</code> environment (see <a href="#figure">figure</a> and see <a href="#table">table</a>). Thus,
where the base file is <samp>thesis.tex</samp>, and contains the declaration
<code>\tableofcontents</code>, the command <code>\chapter{Chapter One}</code>
@@ -22035,23 +22133,14 @@
<p>To manually add material, use
<code>\addcontentsline{<var>filetype</var>}{<var>unit</var>}{<var>text</var>}</code>,
where <var>filetype</var> is <code>toc</code>, <code>lof</code>, or <code>lot</code>
-(see <a href="#g_t_005caddcontentsline">\addcontentsline</a>). For example, for the Table of Contents,
-<code>\addcontentsline{toc}{<var>unit</var>}{<var>text</var>}</code> writes to the
-<samp>.toc</samp> file the line
-<code>\contentsline{<var>unit</var>}{<var>text</var>}{<var>pagenumber</var>}</code>,
-where <var>unit</var> is <code>chapter</code>, <code>section</code>, <code>subsection</code>,
-etc. When LaTeX runs, this line is transformed to
-<code>\l@<var>unit</var>{<var>text</var>}{<var>pagenumber</var>}</code>. Thus,
-<code>\contentsline{chapter}{Background}{2}</code> will become
-<code>\l at chapter{Background}{2}</code>, where <code>\l at chapter</code> is
-defined by the document class.
+(see <a href="#g_t_005caddcontentsline">\addcontentsline</a>).
</p>
<p>For manipulating how the <code>\contentline</code> material is typeset, see
the <samp>tocloft</samp> package.
</p>
<p>Note that the <code>hyperref</code> package changes the definition of
<code>\contentsline</code> (and <code>\addcontentsline</code>) to add more
-arguments, to make hyperlinks. Ths is the source of the error
+arguments, to make hyperlinks. This is the source of the error
<code>Argument of \contentsline has an extra }</code>. Fix this error by
deleting the <samp>.toc</samp> or <samp>.lof</samp> or <samp>.lot</samp> file, and running
LaTeX again.
@@ -22062,7 +22151,7 @@
<p>
Next: <a href="#g_t_005cnumberline" accesskey="n" rel="next">\numberline</a>, Previous: <a href="#g_t_005ccontentsline" accesskey="p" rel="prev">\contentsline</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="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="g_t_005cnofiles-1"></span><h4 class="subsection">25.1.4 <code>\nofiles</code></h4>
+<span id="g_t_005cnofiles-1"></span><h4 class="subsection">25.1.5 <code>\nofiles</code></h4>
<span id="index-_005cnofiles"></span>
@@ -22099,7 +22188,7 @@
<p>
Previous: <a href="#g_t_005cnofiles" accesskey="p" rel="prev">\nofiles</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="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="g_t_005cnumberline-1"></span><h4 class="subsection">25.1.5 <code>\numberline</code></h4>
+<span id="g_t_005cnumberline-1"></span><h4 class="subsection">25.1.6 <code>\numberline</code></h4>
<span id="index-_005cnumberline"></span>
@@ -22110,16 +22199,23 @@
</pre></div>
<p>Typeset its argument flush left in a box. This is used in a
-<code>\contentsline</code> command (see <a href="#g_t_005ccontentsline">\contentsline</a>).
+<code>\contentsline</code> command to typeset the section number
+(see <a href="#g_t_005ccontentsline">\contentsline</a>).
</p>
<p>For example, this line in a <samp>.toc</samp> file causes the <code>1</code> to be
typeset flush left.
</p>
<div class="example">
-<pre class="example">\contentsline {section}{\numberline {1}First section}{2}
+<pre class="example">\contentsline {subsection}{\numberline {1.1}Motivation}{2}
</pre></div>
-<p>This command is fragile, so you may need to preceed it with
+<p>By default, LaTeX typesets the section numbers in a box of length
+<code>\@tempdima</code>. That length is set by the commands
+<code>\l at section</code>, <code>\l at subsection</code>, etc. Put section numbers
+inside a natural-width box with
+<code>\renewcommand{\numberline}[1]{#1~}</code>.
+</p>
+<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>
@@ -23990,7 +24086,8 @@
</div>
<span id="Command-line-interface-1"></span><h2 class="chapter">28 Command line interface</h2>
-<span id="Command-line"></span><span id="index-command-line"></span>
+<span id="Command-line"></span><span id="index-command-line-interface"></span>
+<span id="index-interface_002c-command-line"></span>
<span id="index-CLI"></span>
<p>Synopsis (from a terminal command line):
@@ -23999,9 +24096,10 @@
<pre class="example">pdflatex <var>options</var> <var>argument</var>
</pre></div>
-<p>Run LaTeX on <var>argument</var>. In place of <code>pdflatex</code> you can
-also use <code>xelatex</code>, or <code>lualatex</code>, or <code>dviluatex</code>, or
-<code>latex</code>.
+<p>Run LaTeX on <var>argument</var>. In place of <code>pdflatex</code> you
+can also use (for PDF output) <code>xelatex</code> or <code>lualatex</code>, or
+(for DVI output) <code>latex</code> or <code>dvilualatex</code>, among others
+(see <a href="#TeX-engines">TeX engines</a>).
</p>
<p>For example, this will run LaTeX on the file <samp>thesis.tex</samp>,
creating the output <samp>thesis.pdf</samp>.
@@ -24067,8 +24165,8 @@
command line.
</p>
<p>With many implementations you can specify command line options by
-prefixing them with ‘<samp>-</samp>’ or ‘<samp>--</samp>’. This is the case for
-both TeX Live (and MacTeX) and MiKTeX. We will use both
+prefixing them with ‘<samp>-</samp>’ or ‘<samp>--</samp>’. This is the case for both
+TeX Live (including MacTeX) and MiKTeX. We will use both
conventions interchangeably. If an option takes a value, it can be
specified either as a separate argument (‘<samp>--foo val</samp>’), or as one
argument with an ‘<samp>=</samp>’ sign (‘<samp>--foo=val</samp>’), but there can be no
@@ -24190,17 +24288,21 @@
<span id="index-input_002c-on-command-line"></span>
-<p>As part of the command line invocation <code>pdflatex <var>options</var>
-<var>argument</var></code> you can specify arbitrary LaTeX input by starting
-<var>argument</var> with a backslash. This allows you to do some special
-effects.
+<p>As part of the command line invocation
</p>
+<div class="example">
+<pre class="example"><var>latex-engine</var> <var>options</var> <var>argument</var>
+</pre></div>
+
+<p>you can specify arbitrary LaTeX input by starting
+<var>argument</var> with a backslash. (All the engines support this.) This
+allows you to do some special effects.
+</p>
<span id="index-package_002c-hyperref-3"></span>
<span id="index-hyperref-package-3"></span>
-
-<p>For example, this file (which uses the <samp>hyperref</samp> package for
-hyperlinks) can produce two kinds of output, one for paper and one for a
-PDF.
+<p>For example, this file (which uses the
+<samp>hyperref</samp> package for hyperlinks) can produce two kinds of
+output, one to be read on physical paper and one to be read online.
</p>
<div class="example">
<pre class="example">\ifdefined\paperversion % in preamble
@@ -24216,11 +24318,18 @@
<p>Compiling this document <samp>book.tex</samp> with the command line
<code>pdflatex book</code> will give the ‘<samp>CTAN</samp>’ link in blue. But
-compiling it with <code>pdflatex "\def\paperversion{}\input book.tex"</code>
-has the link in black. (Note the use of double quotes to prevent
-interpretation of the symbols by the command line shell; your system may
-do this differently.)
+compiling it with
</p>
+<div class="example">
+<pre class="example">pdflatex "\def\paperversion{}\input book.tex"
+</pre></div>
+
+<p>has the link in black. We use double quotes to prevent
+interpretation of the symbols by the command line shell. (This
+usually works on both Unix and Windows systems, but there are many
+peculiarities to shell quoting, so read your system documentation if
+need be.)
+</p>
<p>In a similar way, from the single file <samp>main.tex</samp> you can compile
two different versions.
</p>
@@ -24230,9 +24339,11 @@
</pre></div>
<p>The <code>jobname</code> option is there because otherwise both files would be
-called <samp>main.pdf</samp> and the second would overwrite the first.
+called <samp>main.pdf</samp> and the second would overwrite the first. (See
+the next section.)
</p>
-<p>In this example, one passes the <code>draft</code> option to the <samp>graphicx</samp> package:
+<p>In this example, we pass the <code>draft</code> option to the
+<samp>graphicx</samp> package:
</p>
<div class="example">
<pre class="example">pdflatex "\PassOptionsToPackage{draft}{graphicx}\input{aa.tex}"
@@ -24248,48 +24359,56 @@
<p>
Next: <a href="#Recovering-from-errors" accesskey="n" rel="next">Recovering from errors</a>, Previous: <a href="#Command-line-input" accesskey="p" rel="prev">Command line input</a>, Up: <a href="#Command-line-interface" accesskey="u" rel="up">Command line interface</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="Job-name"></span><h3 class="section">28.3 Job name</h3>
+<span id="Jobname-1"></span><h3 class="section">28.3 Jobname</h3>
<span id="index-_005cjobname"></span>
-<span id="index-Job-name"></span>
+<span id="index-jobname-1"></span>
+<span id="index-document-root-name"></span>
+<span id="index-name-of-document-root"></span>
-<p>Running LaTeX creates a number of files, including the output but
-also including others. These files are named with the job name. The
-most common case is the simplest, where for instance the command
-<code>pdflatex thesis</code> creates <code>thesis.pdf</code> and also
-<code>thesis.log</code> and <code>thesis.aux</code>. Here the job name is
-<code>thesis</code>.
+<p>Running LaTeX creates a number of files, including the main PDF (or
+DVI) output but also including others. These files are named with the
+so-called <em>jobname</em>. The most common case is also the simplest,
+where for instance the command <code>pdflatex thesis</code> creates
+<code>thesis.pdf</code> and also <code>thesis.log</code> and <code>thesis.aux</code>.
+Here the job name is <code>thesis</code>.
</p>
-<p>In general, the command is <code><var>latex-engine</var> <var>options</var>
-<var>argument</var></code>, where <var>latex-engine</var> is one of <code>pdflatex</code>,
-<code>xelatex</code>, or <code>lualatex</code>, or <code>dviluatex</code>, or
-<code>latex</code>. If <var>argument</var> does not start with a backslash, as
-above with <code>thesis</code>, then TeX considers it the name of a file to
-input as the document root. The name of that root file, without the
-<samp>.tex</samp> extension, is the job name. If <var>argument</var> does start
-with a backslash, or if TeX is in interactive mode, then it waits for
-the first <code>\input</code> instruction, and the job name is the name of the
-input file.
+<p>In general, LaTeX is invoked as <code><var>latex-engine</var>
+<var>options</var> <var>argument</var></code>, where <var>latex-engine</var> is
+<code>pdflatex</code>, <code>lualatex</code>, etc. (see <a href="#TeX-engines">TeX engines</a>).
+If <var>argument</var> does not start with a backslash, as is the case
+above with <code>thesis</code>, then TeX considers it to be the name of
+the file to input as the main document. The name of that root file,
+without the <samp>.tex</samp> extension, is the jobname. If <var>argument</var>
+does start with a backslash, or if TeX is in interactive mode, then
+it waits for the first <code>\input</code> command, and the jobname is the
+argument to <code>\input</code>.
</p>
-<p>There are two more possibilities for the job name. To directly specify
-it, use the <code>jobname</code> option. <a href="#Command-line-input">Command line input</a> has an
-example, generating the outputs <samp>students.pdf</samp> and
-<samp>professors.pdf</samp> from the same source, <samp>principal.tex</samp>.
+<p>There are two more possibilities for the jobname. It can be directly
+specified with the <code>-jobname</code> option, as in <code>pdflatex
+-jobname=myname</code> (see <a href="#Command-line-input">Command line input</a> for a real example).
</p>
-<p>The final possibility is that the default job name is <samp>texput</samp>. So
-for example, if there is no <code>jobname</code> option and the compilation
-stops before the first <code>\input</code>, then the product log will be named
-<samp>texput.log</samp>. A special case of this is that in recent versions of
-LaTeX the job name is also <samp>texput</samp> if the first <code>\input</code>
-occurs by being indirectly called by either <code>\documentclass</code> or
-<code>\RequirePackage</code>. So this will produce a file named
-<samp>texput.pdf</samp>.
+<span id="index-texput_002c-jobname-default"></span>
+<span id="index-fallback-jobname"></span>
+<p>The final possibility is <samp>texput</samp>, which is the final fallback
+default if no other name is available to TeX. For example, if no
+<code>-jobname</code> option was specified, and the compilation stops before
+there is any output, then the log file will be named
+<samp>texput.log</samp>.
</p>
+<span id="index-_005cdocumentclass_002c-and-texput-jobname"></span>
+<span id="index-_005cRequirePackage_002c-and-texput-jobname"></span>
+<p>A special case of this is that in LaTeX versions of (approximately)
+2020 or later, the jobname is also <samp>texput</samp> if the first
+<code>\input</code> occurs as a result of being called by either
+<code>\documentclass</code> or <code>\RequirePackage</code>. So this will produce
+a file named <samp>texput.pdf</samp>:
+</p>
<div class="example">
<pre class="example">pdflatex "\documentclass{minimal}\begin{document}Hello!\end{document}"
</pre></div>
-<p>However, this special case only applies to those two commands. Here,
+<p>However, this special case only applies to those two commands. Thus, with
</p>
<div class="example">
<pre class="example">pdflatex "\documentclass{article}\usepackage{lipsum}\input{thesis}"
@@ -24298,20 +24417,25 @@
<p>the output file is <samp>lipsum.pdf</samp>, as <code>\usepackage</code> calls
<code>\input</code>.
</p>
-<p>Within the document, the macro <code>\jobname</code> expands to the job name.
+<span id="index-_005cjobname-1"></span>
+<p>Within the document, the macro <code>\jobname</code> expands to the jobname.
(When you run LaTeX on a file whose name contains spaces, the string
returned by <code>\jobname</code> contains matching start and end quotes.)
In the expansion of that macro, all characters are of
-catcode 12 (other) except that spaces are category 10.
-So printing the job name can cause problems if the file name contains
-non-ASCII characters.
+catcode 12 (other) except that spaces are category 10,
+including letters that are normally catcode 11.
</p>
-<p>Because of this catcode restriction, to use the job name in a
-conditional, one solution is to use a macro of text from the
-<samp>xtring</samp> package in its star variant, which is insensitive to
-catcode. For example, in the following text the footnote “Including
-Respublica Bananensis Francorum.” is only present if the task name
-starts with <samp>my-doc</samp>.
+<span id="index-_005cIfBeginWith_002a-macro-from-xstring"></span>
+<span id="index-package_002c-xstring"></span>
+<span id="index-xstring-package"></span>
+
+<p>Because of this catcode situation, using the jobname in a conditional
+can become complicated. One solution is to use the macro
+<code>\IfBeginWith</code> from the <samp>xstring</samp> package in its star
+variant, which is insensitive to catcode. For example, in the
+following text the footnote “Including Respublica Bananensis
+Francorum.” is only present if the task name starts with
+<samp>my-doc</samp>.
</p>
<div class="example">
<pre class="example">If a democracy is just a regime where citizens vote then
@@ -24320,11 +24444,7 @@
democracies.
</pre></div>
-<p>The potential problem for the unstarred version of <code>\IfBeginWith</code>
-is that the <code>-</code> in ‘<samp>my-doc</samp>’ has catcode 11, while in
-<code>\jobname</code>, if a <code>-</code> is there then it has catcode 12.
-</p>
-<p>Manipulating the value of <code>\jobname</code> inside of a document cannot
+<p>Manipulating the value of <code>\jobname</code> inside of a document does not
change the name of the output file or the log file.
</p>
@@ -24756,6 +24876,7 @@
<tr><td></td><td valign="top"><a href="#index-_005c_0040"><code>\@</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005c_0040">\@</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_0040auxout"><code>\@auxout</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cwrite">\write</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_0040beginparpenalty"><code>\@beginparpenalty</code></a>:</td><td> </td><td valign="top"><a href="#list">list</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005c_0040dottedtocline"><code>\@dottedtocline</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005c_0040dottedtocline">\@dottedtocline</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_0040endparpenalty"><code>\@endparpenalty</code></a>:</td><td> </td><td valign="top"><a href="#list">list</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_0040fnsymbol"><code>\@fnsymbol</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_0040ifstar"><code>\@ifstar</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005c_0040ifstar">\@ifstar</a></td></tr>
@@ -24901,8 +25022,9 @@
<tr><td></td><td valign="top"><a href="#index-_005ccolumnwidth-2"><code>\columnwidth</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-_005ccomplement"><code>\complement</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-_005ccong"><code>\cong</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-_005ccontentsline"><code>\contentsline</code></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-_005ccontentsline-1"><code>\contentsline</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ccontentsline">\contentsline</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005ccontentsline"><code>\contentsline</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-_005ccontentsline-1"><code>\contentsline</code></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-_005ccontentsline-2"><code>\contentsline</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ccontentsline">\contentsline</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ccoprod"><code>\coprod</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-_005ccopyright"><code>\copyright</code></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-_005ccos"><code>\cos</code></a>:</td><td> </td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
@@ -24963,6 +25085,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cdj"><code>\dj</code></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-_005cDJ"><code>\DJ</code></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-_005cdocumentclass"><code>\documentclass</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-_005cdocumentclass_002c-and-texput-jobname"><code>\documentclass<span class="roman">, and <code>texput</code> jobname</span></code></a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cdot"><code>\dot</code></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-_005cdoteq"><code>\doteq</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-_005cdotfill"><code>\dotfill</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005chrulefill-_0026-_005cdotfill">\hrulefill & \dotfill</a></td></tr>
@@ -25069,6 +25192,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cHuge"><code>\Huge</code></a>:</td><td> </td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005chyphenation"><code>\hyphenation</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005chyphenation">\hyphenation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ci-_0028dotless-i_0029"><code>\i <span class="roman">(dotless i)</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-_005cIfBeginWith_002a-macro-from-xstring"><code>\IfBeginWith*<span class="roman"> macro from <samp>xstring</samp></span></code></a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ciff"><code>\iff</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-_005cIfFileExists"><code>\IfFileExists</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-_005cignorespaces"><code>\ignorespaces</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cignorespaces-_0026-_005cignorespacesafterend">\ignorespaces & \ignorespacesafterend</a></td></tr>
@@ -25106,6 +25230,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cj-_0028dotless-j_0029"><code>\j <span class="roman">(dotless j)</span></code></a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cjmath"><code>\jmath</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cjobname"><code><code>\jobname</code></code></a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cjobname-1"><code>\jobname</code></a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cJoin"><code>\Join</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-_005ck-_0028ogonek_0029"><code>\k <span class="roman">(ogonek)</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-_005ckappa"><code>\kappa</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -25413,6 +25538,7 @@
<tr><td></td><td valign="top"><a href="#index-_005crefstepcounter"><code>\refstepcounter</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005crefstepcounter">\refstepcounter</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005crenewenvironment"><code>\renewenvironment</code></a>:</td><td> </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-_005cRequirePackage"><code>\RequirePackage</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-_005cRequirePackage_002c-and-texput-jobname"><code>\RequirePackage<span class="roman">, and <code>texput</code> jobname</span></code></a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cRequirePackageWithOptions"><code>\RequirePackageWithOptions</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-_005cresizebox"><code>\resizebox</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005crestorecr"><code>\restorecr</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cobeycr-_0026-_005crestorecr">\obeycr & \restorecr</a></td></tr>
@@ -25730,12 +25856,12 @@
<tr><td></td><td valign="top"><a href="#index-abstract-package"><code>abstract</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#abstract">abstract</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-abstracts">abstracts</a>:</td><td> </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-defining">Accents, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareFontEncoding">\DeclareFontEncoding</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Accents_002c-defining-1">Accents, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextAccent">\DeclareTextAccent</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Accents_002c-defining-2">Accents, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextAccentDefault">\DeclareTextAccentDefault</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Accents_002c-defining-3">Accents, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextComposite">\DeclareTextComposite</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Accents_002c-defining-4">Accents, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextCompositeCommand">\DeclareTextCompositeCommand</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Accents_002c-defining-5">Accents, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextSymbolDefault">\DeclareTextSymbolDefault</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-accents_002c-defining">accents, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareFontEncoding">\DeclareFontEncoding</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-accents_002c-defining-1">accents, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextAccent">\DeclareTextAccent</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-accents_002c-defining-2">accents, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextAccentDefault">\DeclareTextAccentDefault</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-accents_002c-defining-3">accents, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextComposite">\DeclareTextComposite</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-accents_002c-defining-4">accents, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextCompositeCommand">\DeclareTextCompositeCommand</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-accents_002c-defining-5">accents, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextSymbolDefault">\DeclareTextSymbolDefault</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>
@@ -25818,7 +25944,7 @@
<tr><td></td><td valign="top"><a href="#index-bibliography_002c-creating-_0028manually_0029">bibliography, creating (manually)</a>:</td><td> </td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bibTeX_002c-using">bibTeX, using</a>:</td><td> </td><td valign="top"><a href="#Using-BibTeX">Using BibTeX</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-big-circle-symbols_002c-in-text">big circle symbols, in text</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Big-point">Big point</a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-big-point">big point</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-bigfoot-package"><code>bigfoot</code> <span class="roman">package</span></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-black-boxes_002c-omitting">black boxes, omitting</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-blackboard-bold">blackboard bold</a>:</td><td> </td><td valign="top"><a href="#Blackboard-bold">Blackboard bold</a></td></tr>
@@ -25874,7 +26000,7 @@
<tr><td></td><td valign="top"><a href="#index-centered-period_002c-in-text">centered period, 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-centering-text_002c-declaration-for">centering text, declaration for</a>:</td><td> </td><td valign="top"><a href="#g_t_005ccentering">\centering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-centering-text_002c-environment-for">centering text, environment for</a>:</td><td> </td><td valign="top"><a href="#center">center</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Centimeter">Centimeter</a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-centimeter">centimeter</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-changing-case-of-characters">changing case of characters</a>:</td><td> </td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-chapter">chapter</a>:</td><td> </td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-chapter-1">chapter</a>:</td><td> </td><td valign="top"><a href="#g_t_005cchapter">\chapter</a></td></tr>
@@ -25889,7 +26015,7 @@
<tr><td></td><td valign="top"><a href="#index-characters_002c-special">characters, special</a>:</td><td> </td><td valign="top"><a href="#Reserved-characters">Reserved characters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-check-accent">check accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-check-accent_002c-math">check accent, math</a>:</td><td> </td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Cicero">Cicero</a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cicero">cicero</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-circle-symbol_002c-big_002c-in-text">circle symbol, big, 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-circled-letter_002c-in-text">circled letter, 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-circumflex-accent">circumflex accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
@@ -25929,7 +26055,7 @@
<tr><td></td><td valign="top"><a href="#index-colored-boxes">colored boxes</a>:</td><td> </td><td valign="top"><a href="#Colored-boxes">Colored boxes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-colored-page">colored page</a>:</td><td> </td><td valign="top"><a href="#Colored-pages">Colored pages</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-colored-text">colored text</a>:</td><td> </td><td valign="top"><a href="#Colored-text">Colored text</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-command-line">command line</a>:</td><td> </td><td valign="top"><a href="#Command-line-interface">Command line interface</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-command-line-interface">command line interface</a>:</td><td> </td><td valign="top"><a href="#Command-line-interface">Command line interface</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-command-syntax">command syntax</a>:</td><td> </td><td valign="top"><a href="#LaTeX-command-syntax">LaTeX command syntax</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-commands_002c-class-and-package">commands, class and package</a>:</td><td> </td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-commands_002c-defining-new-ones">commands, defining new ones</a>:</td><td> </td><td valign="top"><a href="#g_t_005cnewcommand-_0026-_005crenewcommand">\newcommand & \renewcommand</a></td></tr>
@@ -25990,7 +26116,7 @@
<tr><td></td><td valign="top"><a href="#index-defining-new-theorems">defining new theorems</a>:</td><td> </td><td valign="top"><a href="#g_t_005cnewtheorem">\newtheorem</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-definitions">definitions</a>:</td><td> </td><td valign="top"><a href="#Definitions">Definitions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-delayed-_005cwrite">delayed <code>\write</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cwrite">\write</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Delimiters">Delimiters</a>:</td><td> </td><td valign="top"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-delimiters">delimiters</a>:</td><td> </td><td valign="top"><a href="#Delimiters">Delimiters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-delimiters_002c-paired">delimiters, paired</a>:</td><td> </td><td valign="top"><a href="#g_t_005cleft-_0026-_005cright">\left & \right</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>
@@ -26001,7 +26127,7 @@
<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-description-lists_002c-creating">description lists, creating</a>:</td><td> </td><td valign="top"><a href="#description">description</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-design-size_002c-in-font-definitions">design size, in font definitions</a>:</td><td> </td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Didot-point">Didot point</a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-didot-point">didot point</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-dieresis-accent">dieresis accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-difference-between-class-and-package">difference between class and package</a>:</td><td> </td><td valign="top"><a href="#Class-and-package-construction">Class and package construction</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dimen-plain-TeX">dimen <span class="roman">plain TeX</span></a>:</td><td> </td><td valign="top"><a href="#Lengths">Lengths</a></td></tr>
@@ -26018,6 +26144,7 @@
<tr><td></td><td valign="top"><a href="#index-document-class_002c-defined">document class, defined</a>:</td><td> </td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-document-classes">document classes</a>:</td><td> </td><td valign="top"><a href="#Document-classes">Document classes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-document-environment"><code><code>document</code> <span class="roman">environment</span></code></a>:</td><td> </td><td valign="top"><a href="#document">document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-document-root-name">document root name</a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-document-templates">document templates</a>:</td><td> </td><td valign="top"><a href="#Document-templates">Document templates</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dollar-sign">dollar sign</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dot-accent">dot accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
@@ -26059,7 +26186,7 @@
<tr><td></td><td valign="top"><a href="#index-em_002ddash_002c-two_002dthirds">em-dash, two-thirds</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-emphasis">emphasis</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-enclosure-list">enclosure list</a>:</td><td> </td><td valign="top"><a href="#g_t_005cencl">\encl</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Encoding_002c-font">Encoding, font</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareFontEncoding">\DeclareFontEncoding</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-encoding_002c-font">encoding, font</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareFontEncoding">\DeclareFontEncoding</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-encoding_002c-of-input-files">encoding, of input files</a>:</td><td> </td><td valign="top"><a href="#inputenc-package">inputenc package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-end-matter-of-a-book">end matter of a book</a>:</td><td> </td><td valign="top"><a href="#g_t_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter & \mainmatter & \backmatter</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-end-of-document-hook">end of document hook</a>:</td><td> </td><td valign="top"><a href="#g_t_005cAtEndDocument">\AtEndDocument</a></td></tr>
@@ -26139,6 +26266,7 @@
<tr><td></td><td valign="top"><a href="#index-external-files_002c-writing">external files, writing</a>:</td><td> </td><td valign="top"><a href="#filecontents">filecontents</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fallback-jobname">fallback jobname</a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-families_002c-of-fonts">families, of fonts</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-fancyhdr-package"><code>fancyhdr</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#Page-styles">Page styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fancyhdr-package-1"><code>fancyhdr</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
@@ -26171,18 +26299,9 @@
<tr><td></td><td valign="top"><a href="#index-font-catalogue">font catalogue</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-font-commands_002c-low_002dlevel">font commands, low-level</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-font-dimension_002c-slant">font dimension, slant</a>:</td><td> </td><td valign="top"><a href="#g_t_005c_002f">\/</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Font-encoding">Font encoding</a>:</td><td> </td><td valign="top"><a href="#fontenc-package">fontenc package</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Font-encoding-1">Font encoding</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareFontEncoding">\DeclareFontEncoding</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Font-encoding-2">Font encoding</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextAccent">\DeclareTextAccent</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Font-encoding-3">Font encoding</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextAccentDefault">\DeclareTextAccentDefault</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Font-encoding-4">Font encoding</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextCommand-_0026-_005cProvideTextCommand">\DeclareTextCommand & \ProvideTextCommand</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Font-encoding-5">Font encoding</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextCommandDefault-_0026-_005cProvideTextCommandDefault">\DeclareTextCommandDefault & \ProvideTextCommandDefault</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Font-encoding-6">Font encoding</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextComposite">\DeclareTextComposite</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Font-encoding-7">Font encoding</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextCompositeCommand">\DeclareTextCompositeCommand</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Font-encoding-8">Font encoding</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextSymbol">\DeclareTextSymbol</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Font-encoding-9">Font encoding</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextSymbolDefault">\DeclareTextSymbolDefault</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Font-encoding-10">Font encoding</a>:</td><td> </td><td valign="top"><a href="#g_t_005cLastDeclaredEncoding">\LastDeclaredEncoding</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Font-encoding-11">Font encoding</a>:</td><td> </td><td valign="top"><a href="#g_t_005cUseTextSymbol-_0026-_005cUseTextAccent">\UseTextSymbol & \UseTextAccent</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-font-encoding">font encoding</a>:</td><td> </td><td valign="top"><a href="#fontenc-package">fontenc package</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-font-encoding-1">font encoding</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextAccent">\DeclareTextAccent</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-font-encoding_002c-declaring">font encoding, declaring</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareFontEncoding">\DeclareFontEncoding</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-font-size">font size</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-font-sizes">font sizes</a>:</td><td> </td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-font-styles">font styles</a>:</td><td> </td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
@@ -26200,7 +26319,7 @@
<tr><td></td><td valign="top"><a href="#index-footnote_002c-of-a-footnote">footnote, of a footnote</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-footnotes-in-figures">footnotes in figures</a>:</td><td> </td><td valign="top"><a href="#minipage">minipage</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-footnotes_002c-creating">footnotes, creating</a>:</td><td> </td><td valign="top"><a href="#Footnotes">Footnotes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Footnotes_002c-in-a-minipage">Footnotes, in a minipage</a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-footnotes_002c-in-a-minipage">footnotes, in a minipage</a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-footnotes_002c-symbols-instead-of-numbers">footnotes, symbols instead of numbers</a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnote">\footnote</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-force-option-for-filecontents"><code>force</code> option for <code>filecontents</code></a>:</td><td> </td><td valign="top"><a href="#filecontents">filecontents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-format-files_002c-TeX">format files, TeX</a>:</td><td> </td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
@@ -26255,6 +26374,7 @@
<tr><td></td><td valign="top"><a href="#index-hacek-accent_002c-math">háček 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-hacek-accent">hacek accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Halmos-symbol">Halmos symbol</a>:</td><td> </td><td valign="top"><a href="#g_t_005crule">\rule</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hard-space">hard space</a>:</td><td> </td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hat-accent">hat accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hat-accent_002c-math">hat accent, math</a>:</td><td> </td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-header-style">header style</a>:</td><td> </td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
@@ -26318,6 +26438,7 @@
<tr><td></td><td valign="top"><a href="#index-inputenc"><code>inputenc</code></a>:</td><td> </td><td valign="top"><a href="#inputenc-package">inputenc package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-inserting-figures">inserting figures</a>:</td><td> </td><td valign="top"><a href="#figure">figure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-insertions-of-special-characters">insertions of special characters</a>:</td><td> </td><td valign="top"><a href="#Special-insertions">Special insertions</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-interface_002c-command-line">interface, command line</a>:</td><td> </td><td valign="top"><a href="#Command-line-interface">Command line interface</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-interline-space">interline space</a>:</td><td> </td><td valign="top"><a href="#g_t_005cbaselineskip-_0026-_005cbaselinestretch">\baselineskip & \baselinestretch</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-internal-vertical-mode">internal vertical mode</a>:</td><td> </td><td valign="top"><a href="#Modes">Modes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-invisible-character">invisible character</a>:</td><td> </td><td valign="top"><a href="#g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom">\phantom & \vphantom & \hphantom</a></td></tr>
@@ -26334,8 +26455,8 @@
<tr><td></td><td valign="top"><a href="#index-item_005fx2"><code>item_x2</code></a>:</td><td> </td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-J">J</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Job-name">Job name</a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-jobname">jobname</a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-jobname-1">jobname</a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-JPEG-files">JPEG files</a>:</td><td> </td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-JPG-files">JPG files</a>:</td><td> </td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-justification_002c-ragged-left">justification, ragged left</a>:</td><td> </td><td valign="top"><a href="#g_t_005craggedleft">\raggedleft</a></td></tr>
@@ -26480,7 +26601,7 @@
<tr><td></td><td valign="top"><a href="#index-MetaPost-package"><code>MetaPost</code> <span class="roman">package</span></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-mfirstuc-package"><code>mfirstuc</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mhchem-package"><code>mhchem</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts & superscripts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Millimeter">Millimeter</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-millimeter">millimeter</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-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>
<tr><td></td><td valign="top"><a href="#index-minipage_002c-creating-a">minipage, creating a</a>:</td><td> </td><td valign="top"><a href="#minipage">minipage</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-minted-package"><code>minted</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
@@ -26501,6 +26622,7 @@
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-N">N</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-name-of-document-root">name of document root</a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-NBSP">NBSP</a>:</td><td> </td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-nested-_005cinclude_002c-not-allowed">nested <code>\include</code>, not allowed</a>:</td><td> </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-new-class-commands">new class commands</a>:</td><td> </td><td valign="top"><a href="#Class-and-package-construction">Class and package construction</a></td></tr>
@@ -26690,6 +26812,7 @@
<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>
<tr><td></td><td valign="top"><a href="#index-package_002c-xparse"><span class="roman">package</span>, <code>xparse</code></a>:</td><td> </td><td valign="top"><a href="#LaTeX-command-syntax">LaTeX command syntax</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-xparse-1"><span class="roman">package</span>, <code>xparse</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005c_0040ifstar">\@ifstar</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-xstring"><span class="roman">package</span>, <code>xstring</code></a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-packages_002c-loading-additional">packages, loading additional</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-page-break_002c-forcing">page break, forcing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cpagebreak-_0026-_005cnopagebreak">\pagebreak & \nopagebreak</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-page-break_002c-preventing">page break, preventing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cpagebreak-_0026-_005cnopagebreak">\pagebreak & \nopagebreak</a></td></tr>
@@ -26744,7 +26867,7 @@
<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-PNG-files">PNG files</a>:</td><td> </td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-poetry_002c-an-environment-for">poetry, an environment for</a>:</td><td> </td><td valign="top"><a href="#verse">verse</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Point">Point</a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-point">point</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-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>
@@ -26822,7 +26945,7 @@
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_letter-S">S</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-sans-serif-font">sans serif font</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-Scaled-point">Scaled point</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-scaled-point">scaled point</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-scaling">scaling</a>:</td><td> </td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-scaling-1">scaling</a>:</td><td> </td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-script-fonts">script fonts</a>:</td><td> </td><td valign="top"><a href="#Calligraphic">Calligraphic</a></td></tr>
@@ -26873,7 +26996,6 @@
<tr><td></td><td valign="top"><a href="#index-source-files_002c-making-self_002dcontained">source files, making self-contained</a>:</td><td> </td><td valign="top"><a href="#filecontents">filecontents</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-space-between-lines">space between lines</a>:</td><td> </td><td valign="top"><a href="#g_t_005cbaselineskip-_0026-_005cbaselinestretch">\baselineskip & \baselinestretch</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-space_002c-hard">space, hard</a>:</td><td> </td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-space_002c-inserting-horizontal">space, inserting horizontal</a>:</td><td> </td><td valign="top"><a href="#g_t_005chss">\hss</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-space_002c-inserting-vertical">space, inserting vertical</a>:</td><td> </td><td valign="top"><a href="#g_t_005caddvspace">\addvspace</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-space_002c-negative-thin">space, negative thin</a>:</td><td> </td><td valign="top"><a href="#g_t_005cthinspace-_0026-_005cnegthinspace">\thinspace & \negthinspace</a></td></tr>
@@ -26922,7 +27044,7 @@
<tr><td></td><td valign="top"><a href="#index-suffix-package"><code>suffix</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005c_0040ifstar">\@ifstar</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-superscript">superscript</a>:</td><td> </td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts & superscripts</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></td><td valign="top"><a href="#index-Symbol_002c-defining">Symbol, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextSymbol">\DeclareTextSymbol</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-symbol_002c-defining">symbol, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareTextSymbol">\DeclareTextSymbol</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-symbols_002c-arrows">symbols, arrows</a>:</td><td> </td><td valign="top"><a href="#Arrows">Arrows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-symbols_002c-boldface">symbols, boldface</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-symbols_002c-math">symbols, math</a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -26935,7 +27057,8 @@
<tr><td></td><td valign="top"><a href="#index-tab-stops_002c-using">tab stops, using</a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tabbing-environment"><code><code>tabbing</code> <span class="roman">environment</span></code></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-table-environment"><code><code>table</code> <span class="roman">environment</span></code></a>:</td><td> </td><td valign="top"><a href="#table">table</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Table-of-contents">Table of contents</a>:</td><td> </td><td valign="top"><a href="#g_t_005ccontentsline">\contentsline</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-table-of-contents">table of contents</a>:</td><td> </td><td valign="top"><a href="#g_t_005ccontentsline">\contentsline</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-table-of-contents-entry_002c-create-dotted-line">table of contents entry, create dotted line</a>:</td><td> </td><td valign="top"><a href="#g_t_005c_0040dottedtocline">\@dottedtocline</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-table-of-contents-entry_002c-manually-adding">table of contents entry, manually adding</a>:</td><td> </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>
@@ -26953,6 +27076,7 @@
<tr><td></td><td valign="top"><a href="#index-TeX-format-_0028_002efmt_0029-files">TeX format (<code>.fmt</code>) files</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-TeX-logo">TeX logo</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-texosquery-package"><code>texosquery</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cwrite18">\write18</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-texput_002c-jobname-default"><code>texput<span class="roman">, jobname default</span></code></a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-text-symbols">text symbols</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-text_002c-resizing">text, resizing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-text_002c-resizing-1">text, resizing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
@@ -27022,6 +27146,7 @@
<tr><th id="Index_cp_letter-U">U</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-ulem-package"><code>ulem</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#Over_002d-and-Underlining">Over- and Underlining</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-umlaut-accent">umlaut accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-unbreakable-space">unbreakable space</a>:</td><td> </td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-underbar">underbar</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-underlining">underlining</a>:</td><td> </td><td valign="top"><a href="#Over_002d-and-Underlining">Over- and Underlining</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-underscore_002c-in-text">underscore, in text</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
@@ -27084,6 +27209,7 @@
<tr><td></td><td valign="top"><a href="#index-xparse-package-1"><code>xparse</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005c_0040ifstar">\@ifstar</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xr-package"><code><code>xr</code> package</code></a>:</td><td> </td><td valign="top"><a href="#xr-package">xr package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xr_002dhyper-package"><code><code>xr-hyper</code> package</code></a>:</td><td> </td><td valign="top"><a href="#xr-package">xr package</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-xstring-package"><code>xstring</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#Jobname">Jobname</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="#Index_cp_symbol-1"><b>$</b></a>
Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info 2021-06-21 17:30:21 UTC (rev 928)
+++ trunk/latex2e.info 2021-06-27 16:27:42 UTC (rev 929)
@@ -4881,7 +4881,8 @@
This puts a table containing data side by side with a map graphic.
They are vertically centered.
- % siunitx to have the S column specifier, which aligns numbers on decimal point
+ % siunitx to have the S column specifier,
+ % which aligns numbers on their decimal point.
\usepackage{siunitx}
\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
...
@@ -4892,7 +4893,8 @@
\begin{tabular}{r|S}
% \multicolumn to remove vertical bar between column headers
\multicolumn{1}{r}{Borough} &
- % Braces to prevent siunitx to misinterprete point as a decimal separator
+ % braces to prevent siunitx from misinterpreting the
+ % period as a decimal separator
{Pop. (million)} \\ \hline
The Bronx &1.5 \\
Brooklyn &2.6 \\
@@ -8871,12 +8873,12 @@
glue, or muglue, you can instead write an expression to compute that
type of quantity.
- An example is that '\the\dimexpr\linewidth-4pt\relax' will produce
-document output giving the length that is four points less than width of
-a line (the only purpose of '\the' is to show the result in the
-document). Similarly, '\romannumeral\numexpr6+3\relax' will produce
-'ix', and '\the\glueexpr 5pt plus 1pt * 2 \relax' will produce '10.0pt
-plus 2.0pt'.
+ An example is that '\the\dimexpr\linewidth-4pt\relax' will produce as
+output the length that is four points less than width of a line (the
+only purpose of '\the' is to show the result in the document).
+Analogously, '\romannumeral\numexpr6+3\relax' will produce 'ix', and
+'\the\glueexpr 5pt plus 1pt * 2 \relax' will produce '10.0pt plus
+2.0pt'.
A convenience here over doing calculations by allocating registers
and then using '\advance', etc., is that the evaluation of expressions
@@ -8890,9 +8892,10 @@
with charity for all with firmness in the right as God gives us to see
the right let us strive on to finish the work we are in to bind up the
nation's wounds, to care for him who shall have borne the battle and
- for his widow and his orphan ~ to do all which may achieve and cherish
- a just and lasting peace among ourselves and with all nations.
- ---Abraham Lincoln, Second Inaugural Address, from the memorial}
+ for his widow and his orphan \textasciitilde\ to do all which may
+ achieve and cherish a just and lasting peace among ourselves and with
+ all nations. ---Abraham Lincoln, Second Inaugural Address, from the
+ memorial}
\end{center}
The EXPRESSION consists of one or more terms of the same type
@@ -8907,16 +8910,16 @@
'\dimexpr\linewidth-3*\offset' gives the error 'Illegal unit of measure
(pt inserted)'. This is because for '\dimexpr' and '\glueexpr', the
input consists of a dimension or glue value followed by an optional
-multiplication factor, and not the other way around. Thus
-'\the\dimexpr1pt*10\relax' is valid and produces '10.0pt', but
-'\the\dimexpr10*1pt\relax' gives the 'Illegal unit' error.
+multiplication factor, and not the other way around. Thus '\the\dimexpr
+1pt*10\relax' is valid and produces '10.0pt', but '\the\dimexpr
+10*1pt\relax' gives the 'Illegal unit' error.
The expressions absorb tokens and carry out appropriate mathematics
up to a '\relax' (which will be absorbed), or up to the first non-valid
token. Thus, '\the\numexpr2+3px' will print '5px', because LaTeX reads
-the '\numexpr2+3', which is made up of numbers, and then finds 'px',
-which is not a number. It therefore terminates the expression and
-produces the '5', followed by the regular text 'px'.
+the '\numexpr2+3', which is made up of numbers, and then finds the
+letter 'p', which cannot be part of a number. It therefore terminates
+the expression and produces the '5', followed by the regular text 'px'.
This termination behavior is useful in comparisons. In
'\ifnum\numexpr\parindent*2 < 10pt Yes\else No\fi', the less than sign
@@ -8925,7 +8928,7 @@
Expressions may use the operators '+', '-', '*' and '/' along with
parentheses for subexpressions, '(...)'. In glue expressions the 'plus'
-and 'minus' parts do not need parenthesis to be affected by a factor.
+and 'minus' parts do not need parentheses to be affected by a factor.
So '\the\glueexpr 5pt plus 1pt * 2 \relax' results in '10pt plus 2pt'.
TeX will coerce other numerical types in the same way as it does when
@@ -8938,18 +8941,18 @@
'3.0pt'.
The details of the arithmetic: each factor is checked to be in the
-allowed range, numbers must be less than 2 to the power 31 in absolute
-value, and dimensions or glue components must be less than 2 to the
-power 14 points, or 'mu', or 'fil', etc. The arithmetic operations are
-performed individually, except for a scaling operation (a multiplication
-immediately followed by a division) which is done as one combined
-operation with a 64-bit product as intermediate value. The result of
-each operation is again checked to be in the allowed range.
+allowed range, numbers must be less than 2^{31} in absolute value, and
+dimensions or glue components must be less than 2^{14} points, or 'mu',
+or 'fil', etc. The arithmetic operations are performed individually,
+except for a scaling operation (a multiplication immediately followed by
+a division) which is done as one combined operation with a 64-bit
+product as intermediate value. The result of each operation is again
+checked to be in the allowed range.
Finally, division and scaling take place with rounding (unlike TeX's
-'\divide', which truncates). Thus '\the\dimexpr5pt*(3/2)\relax' puts
+'\divide', which truncates). Thus '\the\dimexpr 5pt*(3/2)\relax' puts
'10.0pt' in the document, because it rounds '3/2' to '2', while
-'\the\dimexpr5pt*(4/3)\relax' produces '5.0pt'.
+'\the\dimexpr 5pt*(4/3)\relax' produces '5.0pt'.
File: latex2e.info, Node: Making paragraphs, Next: Math formulas, Prev: Lengths, Up: Top
@@ -14992,7 +14995,7 @@
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
+ To make the table of contents, LaTeX stores the information in an
auxiliary file named 'ROOT-FILE.toc' (*note Splitting the input::). For
example, this LaTeX file 'test.tex'
@@ -15003,69 +15006,131 @@
\subsection{First subsection}
...
-writes the following line to 'test.toc'.
+writes these lines 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. Its unique argument, '1' or '1.1', is the sectioning
-unit number, whereas the remainder of the second argument of
-'\contentsline', 'First section' or 'First subsection', is the title.
-Finally, the third argument, '2', is the page number on which the
-sectioning units start (*note \contentsline::).
+Each line contains a single command, '\contentsline' (*note
+\contentsline::). The first argument, the 'section' or 'subsection', is
+the sectioning unit. The second argument has two components. The hook
+'\numberline' determines how the sectioning number, '1' or '1.1',
+appears in the table of contents (*note \numberline::). The remainder
+of the second argument of '\contentsline', 'First section' or 'First
+subsection', is the sectioning title text. Finally, the third argument,
+'2', is the page number on which this sectioning unit starts.
- 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.
+ To typeset these lines, the document class provides commands
+'\l at section{TEXT}{PAGENUMBER}' or '\l at subsection{TEXT}{PAGENUMBER}',
+etc. These '\l at SECTION-UNIT' commands often use the '\@dottedtocline'
+command (*note \@dottedtocline::).
+ A consequence of LaTeX's strategy of using auxiliary files is that to
+get the correct information in the document you must run LaTeX twice,
+once to store the information and the second time to retrieve it. In
+the ordinary course of writing a document authors run LaTeX a number of
+times, but you may notice that the first time that you compile a new
+document, the table of contents page will be empty except for its
+'Contents' header. Just run LaTeX 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.
+figures and a list of tables. Their information is stored in files with
+extension '.lof' and '.lot'. They work the same way as
+'\tableofcontents' but the latter is more common, so we use it for most
+examples.
- To change the header for the table of contents page do something like
-the first line here.
+ You can manually add material to the table of contents, the list of
+figures, and the list of tables. For instance, add a line about a
+section to the table of contents with
+'\addcontentsline{toc}{section}{TEXT}'. (*note \addcontentsline::).
+Add arbitrary material, that is, non-line material, with
+'\addtocontents', as with the command
+'\addtocontents{lof}{\protect\vspace{2ex}}', which adds vertical space
+to the list of figures (*note \addtocontents::).
- \renewcommand{\contentsname}{Table of contents}
+ Lines in the table of contents, the list of figures, and the list of
+tables, have four parts. First is an indent. Next is a box into which
+sectioning numbers are placed, and then the third box holds the title
+text, such as 'First section'. Finally there is a box up against the
+right margin, inside of which LaTeX puts the page number box. For the
+indent and the width of the number box, *note \@dottedtocline::. The
+right margin box has width '\@tocrmarg' and the page number is flush
+right in that space, inside a box of width '\@pnumwidth'. By default
+'\@tocrmarg' is '2.55em' and '\@pnumwidth' is '1.55em'. Change these as
+with '\renewcommand{\@tocrmarg}{3.5em}'.
+
+ CTAN has many packages for the table of contents and lists of figures
+and tables (*note CTAN::). The package 'tocloft' is convenient for
+adjusting some aspects of the default such as spacing. And,
+'tocbibbind' will automatically add the bibliography, index, etc. to
+the table of contents.
+
+ To change the header for the table of contents page, do something
+like these commands before you call '\tableofcontents', etc.
+
+ \renewcommand{\contentsname}{Table of Contents}
\renewcommand{\listfigurename}{Plots}
- \renewcommand{\listtablename}{Tables}
+ \renewcommand{\listtablename}{Specifications}
- Similarly, the other two lines will do the other two.
-Internationalization packages such as 'babel' or 'polyglossia' will
-change the headers depending on the chosen base language.
+ Internationalization packages such as 'babel' or 'polyglossia' will
+change these headers depending on the chosen base language.
- CTAN has many packages for the table of contents and lists of figures
-and tables. One convenient one for adjusting some aspects of the
-default, such as spacing, is 'tocloft'. And, 'tocbibbind' will
-automatically add the bibliography, index, etc. to the table of
-contents.
-
* Menu:
+* \@dottedtocline:: Format entry line in table of contents, etc.
* \addcontentsline:: Add an entry to table of contents, etc.
* \addtocontents:: Add text directly to table of contents file, etc.
-* \contentsline:: Internal command to set line in table of contents, etc.
+* \contentsline:: Set line in table of contents, etc.
* \nofiles:: Prevent writing to auxiliary files.
* \numberline:: Put its number argument flush left in a box.
-File: latex2e.info, Node: \addcontentsline, Next: \addtocontents, Up: Table of contents etc.
+File: latex2e.info, Node: \@dottedtocline, Next: \addcontentsline, Up: Table of contents etc.
-25.1.1 '\addcontentsline'
+25.1.1 '\@dottedtocline'
+------------------------
+
+Synopsis:
+
+ \@dottedtocline{SECTION-LEVEL-NUM}{INDENT}{NUMWIDTH}{TEXT}{PAGENUMBER}
+
+ Used internally by LaTeX to format an entry line in the table of
+contents, list of figures, or list of tables. Authors do not directly
+enter '\@dottedtocline' commands.
+
+ This command is often used by '\l at section', '\l at subsection', etc., to
+format the content lines. For example, the 'article.cls' file contains
+these definitions.
+
+ \newcommand*\l at section{\@dottedtocline{1}{1.5em}{2.3em}}
+ \newcommand*\l at subsection{\@dottedtocline{2}{3.8em}{3.2em}}
+ \newcommand*\l at subsubsection{\@dottedtocline{3}{7.0em}{4.1em}}
+
+(In this example, '\@dottedcline' appears to have been given only three
+arguments. But tracing the internal code shows it picks up the TEXT and
+PAGENUMBER arguments from a call to '\contentsline'.)
+
+ Between the box for the title text of a section and the right margin
+box, these '\@dottedtocline' commands insert leaders, evenly-spaced
+dots. The dot-to-dot space is given by the command '\@dotsep'. By
+default it is 4.5 (it is in math units, which are '1/18' em. Change it
+using '\renewcommand', as with '\renewcommand{\@dotsep}{3.5}'. (In the
+default book class, LaTeX does not use dotted leaders for the Part and
+Chapter table entries, and in the default article class it does not use
+dotted leaders for Section entries.)
+
+
+File: latex2e.info, Node: \addcontentsline, Next: \addtocontents, Prev: \@dottedtocline, Up: Table of contents etc.
+
+25.1.2 '\addcontentsline'
-------------------------
Synopsis:
\addcontentsline{EXT}{UNIT}{TEXT}
- Add an entry to the file specified by EXT. Usually EXT is one
-of: 'toc' for the table of contents, 'lof' for the list of figures, or
-'lot' for the list of tables.
+ Add an entry to the auxillary file with extension EXT.
The following will result in an 'Appendices' line in the table of
contents.
@@ -15085,15 +15150,17 @@
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.
+by authors. For example, an author writing a book whose style is to
+have an unnumbered preface may use the starred '\chapter*'. But that
+command leaves out table of contents information, which can be entered
+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'.
+{chapter}{\numberline {}Preface}{3}'; note that the page number '3' is
+automatically generated by the system, not entered manually.
All of the arguments for '\addcontentsline' are required.
@@ -15135,7 +15202,7 @@
File: latex2e.info, Node: \addtocontents, Next: \contentsline, Prev: \addcontentsline, Up: Table of contents etc.
-25.1.2 '\addtocontents'
+25.1.3 '\addtocontents'
-----------------------
Synopsis:
@@ -15144,8 +15211,8 @@
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.
+table of contents so that is the discussion here, but it 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.
@@ -15153,6 +15220,24 @@
\tableofcontents\newpage
\addtocontents{toc}{\protect\vspace*{3ex}}
+This puts the word 'Page', in boldface, above the column of page numbers
+and after the header.
+
+ \tableofcontents
+ \addtocontents{toc}{~\hfill\textbf{Page}\par}
+ \chapter{...}
+
+This adds a line announcing work by a new author.
+
+ \addtocontents{toc}{%
+ \protect\vspace{2ex}
+ \textbf{Chapters by N. Other Author}\par}
+
+ The difference between '\addtocontents' and '\addcontentsline' is
+that the latter is strictly for lines, such as with a line giving the
+page number for the start of a new subset of the chapters. As the above
+examples show, '\addtocontents' is for material such as spacing.
+
The '\addtocontents' command has two arguments. Both are required.
EXT
@@ -15178,19 +15263,19 @@
File: latex2e.info, Node: \contentsline, Next: \nofiles, Prev: \addtocontents, Up: Table of contents etc.
-25.1.3 '\contentsline'
+25.1.4 '\contentsline'
----------------------
Synopsis:
\contentsline{UNIT}{TEXT}{PAGENUMBER}
- Used internally by LaTeX to typeset an entry of the Table of
-Contents, List of Figures, or List of Tables (*note Table of contents
+ Used internally by LaTeX to typeset an entry of the table of
+contents, list of figures, or list of tables (*note Table of contents
etc.::). Authors do not directly enter '\contentsline' commands.
Usually adding material to these lists is done automatically by the
-commands '\chapter', '\section', etc. for the Table of Contents, or by
+commands '\chapter', '\section', etc. for the table of contents, or by
the '\caption' command inside of a '\figure' or '\table' environment
(*note figure:: and *note table::). Thus, where the base file is
'thesis.tex', and contains the declaration '\tableofcontents', the
@@ -15207,28 +15292,21 @@
To manually add material, use
'\addcontentsline{FILETYPE}{UNIT}{TEXT}', where FILETYPE is 'toc',
-'lof', or 'lot' (*note \addcontentsline::). For example, for the Table
-of Contents, '\addcontentsline{toc}{UNIT}{TEXT}' writes to the '.toc'
-file the line '\contentsline{UNIT}{TEXT}{PAGENUMBER}', where UNIT is
-'chapter', 'section', 'subsection', etc. When LaTeX runs, this line is
-transformed to '\l at UNIT{TEXT}{PAGENUMBER}'. Thus,
-'\contentsline{chapter}{Background}{2}' will become
-'\l at chapter{Background}{2}', where '\l at chapter' is defined by the
-document class.
+'lof', or 'lot' (*note \addcontentsline::).
For manipulating how the '\contentline' material is typeset, see the
'tocloft' package.
Note that the 'hyperref' package changes the definition of
'\contentsline' (and '\addcontentsline') to add more arguments, to make
-hyperlinks. Ths is the source of the error 'Argument of \contentsline
+hyperlinks. This is the source of the error 'Argument of \contentsline
has an extra }'. Fix this error by deleting the '.toc' or '.lof' or
'.lot' file, and running LaTeX again.
File: latex2e.info, Node: \nofiles, Next: \numberline, Prev: \contentsline, Up: Table of contents etc.
-25.1.4 '\nofiles'
+25.1.5 '\nofiles'
-----------------
Synopsis:
@@ -15256,7 +15334,7 @@
File: latex2e.info, Node: \numberline, Prev: \nofiles, Up: Table of contents etc.
-25.1.5 '\numberline'
+25.1.6 '\numberline'
--------------------
Synopsis:
@@ -15264,14 +15342,20 @@
\numberline{NUMBER}
Typeset its argument flush left in a box. This is used in a
-'\contentsline' command (*note \contentsline::).
+'\contentsline' command to typeset the section number (*note
+\contentsline::).
For example, this line in a '.toc' file causes the '1' to be typeset
flush left.
- \contentsline {section}{\numberline {1}First section}{2}
+ \contentsline {subsection}{\numberline {1.1}Motivation}{2}
- This command is fragile, so you may need to preceed it with
+ By default, LaTeX typesets the section numbers in a box of length
+'\@tempdima'. That length is set by the commands '\l at section',
+'\l at subsection', etc. Put section numbers inside a natural-width box
+with '\renewcommand{\numberline}[1]{#1~}'.
+
+ 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
@@ -16614,8 +16698,9 @@
pdflatex OPTIONS ARGUMENT
- Run LaTeX on ARGUMENT. In place of 'pdflatex' you can also use
-'xelatex', or 'lualatex', or 'dviluatex', or 'latex'.
+ Run LaTeX on ARGUMENT. In place of 'pdflatex' you can also use (for
+PDF output) 'xelatex' or 'lualatex', or (for DVI output) 'latex' or
+'dvilualatex', among others (*note TeX engines::).
For example, this will run LaTeX on the file 'thesis.tex', creating
the output 'thesis.pdf'.
@@ -16669,10 +16754,10 @@
With many implementations you can specify command line options by
prefixing them with '-' or '--'. This is the case for both TeX Live
-(and MacTeX) and MiKTeX. We will use both conventions interchangeably.
-If an option takes a value, it can be specified either as a separate
-argument ('--foo val'), or as one argument with an '=' sign
-('--foo=val'), but there can be no spaces around the '='. We will
+(including MacTeX) and MiKTeX. We will use both conventions
+interchangeably. If an option takes a value, it can be specified either
+as a separate argument ('--foo val'), or as one argument with an '='
+sign ('--foo=val'), but there can be no spaces around the '='. We will
generally use the '=' syntax.
'-version'
@@ -16750,13 +16835,17 @@
28.2 Command line input
=======================
-As part of the command line invocation 'pdflatex OPTIONS ARGUMENT' you
-can specify arbitrary LaTeX input by starting ARGUMENT with a backslash.
-This allows you to do some special effects.
+As part of the command line invocation
+ LATEX-ENGINE OPTIONS ARGUMENT
+
+you can specify arbitrary LaTeX input by starting ARGUMENT with a
+backslash. (All the engines support this.) This allows you to do some
+special effects.
+
For example, this file (which uses the 'hyperref' package for
-hyperlinks) can produce two kinds of output, one for paper and one for a
-PDF.
+hyperlinks) can produce two kinds of output, one to be read on physical
+paper and one to be read online.
\ifdefined\paperversion % in preamble
\newcommand{\urlcolor}{black}
@@ -16769,11 +16858,15 @@
...
Compiling this document 'book.tex' with the command line 'pdflatex book'
-will give the 'CTAN' link in blue. But compiling it with 'pdflatex
-"\def\paperversion{}\input book.tex"' has the link in black. (Note the
-use of double quotes to prevent interpretation of the symbols by the
-command line shell; your system may do this differently.)
+will give the 'CTAN' link in blue. But compiling it with
+ pdflatex "\def\paperversion{}\input book.tex"
+
+has the link in black. We use double quotes to prevent interpretation
+of the symbols by the command line shell. (This usually works on both
+Unix and Windows systems, but there are many peculiarities to shell
+quoting, so read your system documentation if need be.)
+
In a similar way, from the single file 'main.tex' you can compile two
different versions.
@@ -16781,9 +16874,10 @@
pdflatex -jobname=teachers "\def\teachers{}\input{main}"
The 'jobname' option is there because otherwise both files would be
-called 'main.pdf' and the second would overwrite the first.
+called 'main.pdf' and the second would overwrite the first. (See the
+next section.)
- In this example, one passes the 'draft' option to the 'graphicx'
+ In this example, we pass the 'draft' option to the 'graphicx'
package:
pdflatex "\PassOptionsToPackage{draft}{graphicx}\input{aa.tex}"
@@ -16795,69 +16889,67 @@
File: latex2e.info, Node: Jobname, Next: Recovering from errors, Prev: Command line input, Up: Command line interface
-28.3 Job name
-=============
+28.3 Jobname
+============
-Running LaTeX creates a number of files, including the output but also
-including others. These files are named with the job name. The most
-common case is the simplest, where for instance the command 'pdflatex
-thesis' creates 'thesis.pdf' and also 'thesis.log' and 'thesis.aux'.
-Here the job name is 'thesis'.
+Running LaTeX creates a number of files, including the main PDF (or DVI)
+output but also including others. These files are named with the
+so-called "jobname". The most common case is also the simplest, where
+for instance the command 'pdflatex thesis' creates 'thesis.pdf' and also
+'thesis.log' and 'thesis.aux'. Here the job name is 'thesis'.
- In general, the command is 'LATEX-ENGINE OPTIONS ARGUMENT', where
-LATEX-ENGINE is one of 'pdflatex', 'xelatex', or 'lualatex', or
-'dviluatex', or 'latex'. If ARGUMENT does not start with a backslash,
-as above with 'thesis', then TeX considers it the name of a file to
-input as the document root. The name of that root file, without the
-'.tex' extension, is the job name. If ARGUMENT does start with a
+ In general, LaTeX is invoked as 'LATEX-ENGINE OPTIONS ARGUMENT',
+where LATEX-ENGINE is 'pdflatex', 'lualatex', etc. (*note TeX
+engines::). If ARGUMENT does not start with a backslash, as is the case
+above with 'thesis', then TeX considers it to be the name of the file to
+input as the main document. The name of that root file, without the
+'.tex' extension, is the jobname. If ARGUMENT does start with a
backslash, or if TeX is in interactive mode, then it waits for the first
-'\input' instruction, and the job name is the name of the input file.
+'\input' command, and the jobname is the argument to '\input'.
- There are two more possibilities for the job name. To directly
-specify it, use the 'jobname' option. *note Command line input:: has an
-example, generating the outputs 'students.pdf' and 'professors.pdf' from
-the same source, 'principal.tex'.
+ There are two more possibilities for the jobname. It can be directly
+specified with the '-jobname' option, as in 'pdflatex -jobname=myname'
+(*note Command line input:: for a real example).
- The final possibility is that the default job name is 'texput'. So
-for example, if there is no 'jobname' option and the compilation stops
-before the first '\input', then the product log will be named
-'texput.log'. A special case of this is that in recent versions of
-LaTeX the job name is also 'texput' if the first '\input' occurs by
-being indirectly called by either '\documentclass' or '\RequirePackage'.
-So this will produce a file named 'texput.pdf'.
+ The final possibility is 'texput', which is the final fallback
+default if no other name is available to TeX. For example, if no
+'-jobname' option was specified, and the compilation stops before there
+is any output, then the log file will be named 'texput.log'.
+ A special case of this is that in LaTeX versions of (approximately)
+2020 or later, the jobname is also 'texput' if the first '\input' occurs
+as a result of being called by either '\documentclass' or
+'\RequirePackage'. So this will produce a file named 'texput.pdf':
+
pdflatex "\documentclass{minimal}\begin{document}Hello!\end{document}"
- However, this special case only applies to those two commands. Here,
+ However, this special case only applies to those two commands. Thus,
+with
pdflatex "\documentclass{article}\usepackage{lipsum}\input{thesis}"
- the output file is 'lipsum.pdf', as '\usepackage' calls '\input'.
+the output file is 'lipsum.pdf', as '\usepackage' calls '\input'.
- Within the document, the macro '\jobname' expands to the job name.
+ Within the document, the macro '\jobname' expands to the jobname.
(When you run LaTeX on a file whose name contains spaces, the string
returned by '\jobname' contains matching start and end quotes.) In the
expansion of that macro, all characters are of catcode 12 (other) except
-that spaces are category 10. So printing the job name can cause
-problems if the file name contains non-ASCII characters.
+that spaces are category 10, including letters that are normally
+catcode 11.
- Because of this catcode restriction, to use the job name in a
-conditional, one solution is to use a macro of text from the 'xtring'
-package in its star variant, which is insensitive to catcode. For
-example, in the following text the footnote "Including Respublica
-Bananensis Francorum." is only present if the task name starts with
-'my-doc'.
+ Because of this catcode situation, using the jobname in a conditional
+can become complicated. One solution is to use the macro '\IfBeginWith'
+from the 'xstring' package in its star variant, which is insensitive to
+catcode. For example, in the following text the footnote "Including
+Respublica Bananensis Francorum." is only present if the task name
+starts with 'my-doc'.
If a democracy is just a regime where citizens vote then
all banana republics \IfBeginWith*{\jobname}{my-doc}%
{\footnote{Including Respublica Bananensis Francorum.}}{} are
democracies.
- The potential problem for the unstarred version of '\IfBeginWith' is
-that the '-' in 'my-doc' has catcode 11, while in '\jobname', if a '-'
-is there then it has catcode 12.
-
- Manipulating the value of '\jobname' inside of a document cannot
+ Manipulating the value of '\jobname' inside of a document does not
change the name of the output file or the log file.
@@ -17126,7 +17218,7 @@
* .lot file <2>: \contentsline. (line 6)
* .pdf file: Output files. (line 20)
* .tex, default extension: Command line interface.
- (line 18)
+ (line 19)
* .toc file: Output files. (line 43)
* .toc file <1>: Table of contents etc..
(line 6)
@@ -17178,6 +17270,7 @@
* \@: \@. (line 6)
* \@auxout: \write. (line 45)
* \@beginparpenalty: list. (line 242)
+* \@dottedtocline: \@dottedtocline. (line 6)
* \@endparpenalty: list. (line 250)
* \@fnsymbol: \footnote. (line 24)
* \@ifstar: \@ifstar. (line 6)
@@ -17357,8 +17450,10 @@
(line 9)
* \complement: Math symbols. (line 132)
* \cong: Math symbols. (line 138)
-* \contentsline: \addcontentsline. (line 10)
-* \contentsline <1>: \contentsline. (line 6)
+* \contentsline: Table of contents etc..
+ (line 63)
+* \contentsline <1>: \addcontentsline. (line 10)
+* \contentsline <2>: \contentsline. (line 6)
* \coprod: Math symbols. (line 141)
* \copyright: Text symbols. (line 13)
* \cos: Math functions. (line 24)
@@ -17442,6 +17537,7 @@
* \DJ: Additional Latin letters.
(line 26)
* \documentclass: Document classes. (line 6)
+* \documentclass, and texput jobname: Jobname. (line 30)
* \dot: Math accents. (line 25)
* \doteq: Math symbols. (line 180)
* \dotfill: \hrulefill & \dotfill.
@@ -17570,6 +17666,7 @@
* \Huge: Font sizes. (line 11)
* \hyphenation: \hyphenation. (line 6)
* \i (dotless i): Accents. (line 19)
+* \IfBeginWith* macro from xstring: Jobname. (line 53)
* \iff: Math symbols. (line 256)
* \IfFileExists: Class and package commands.
(line 128)
@@ -17615,6 +17712,7 @@
* \j (dotless j): Accents. (line 19)
* \jmath: Math symbols. (line 283)
* \jobname: Jobname. (line 6)
+* \jobname <1>: Jobname. (line 44)
* \Join: Math symbols. (line 280)
* \k (ogonek): Accents. (line 73)
* \kappa: Math symbols. (line 287)
@@ -18002,6 +18100,7 @@
(line 6)
* \RequirePackage: Class and package commands.
(line 323)
+* \RequirePackage, and texput jobname: Jobname. (line 30)
* \RequirePackageWithOptions: Class and package commands.
(line 323)
* \resizebox: \resizebox. (line 6)
@@ -18349,16 +18448,16 @@
* abstract package: abstract. (line 27)
* abstracts: abstract. (line 6)
* accents: Accents. (line 6)
-* Accents, defining: \DeclareFontEncoding.
+* accents, defining: \DeclareFontEncoding.
(line 6)
-* Accents, defining <1>: \DeclareTextAccent. (line 6)
-* Accents, defining <2>: \DeclareTextAccentDefault.
+* accents, defining <1>: \DeclareTextAccent. (line 6)
+* accents, defining <2>: \DeclareTextAccentDefault.
(line 6)
-* Accents, defining <3>: \DeclareTextComposite.
+* accents, defining <3>: \DeclareTextComposite.
(line 6)
-* Accents, defining <4>: \DeclareTextCompositeCommand.
+* accents, defining <4>: \DeclareTextCompositeCommand.
(line 6)
-* Accents, defining <5>: \DeclareTextSymbolDefault.
+* accents, defining <5>: \DeclareTextSymbolDefault.
(line 6)
* accents, mathematical: Math accents. (line 6)
* accessing any character of a font: Symbols by font position.
@@ -18428,7 +18527,7 @@
* babel package <2>: Accents. (line 6)
* babel package <3>: \today. (line 13)
* babel package <4>: Table of contents etc..
- (line 89)
+ (line 124)
* babel package <5>: \index. (line 56)
* back matter of a book: \frontmatter & \mainmatter & \backmatter.
(line 6)
@@ -18451,7 +18550,7 @@
* bibliography, creating (manually): thebibliography. (line 6)
* bibTeX, using: Using BibTeX. (line 6)
* big circle symbols, in text: Text symbols. (line 86)
-* Big point: Units of length. (line 20)
+* big point: Units of length. (line 20)
* bigfoot package: Footnotes of footnotes.
(line 6)
* black boxes, omitting: Document class options.
@@ -18516,7 +18615,7 @@
* centered period, in text: Text symbols. (line 170)
* centering text, declaration for: \centering. (line 6)
* centering text, environment for: center. (line 6)
-* Centimeter: Units of length. (line 24)
+* centimeter: Units of length. (line 24)
* changing case of characters: Upper and lower case.
(line 6)
* chapter: Sectioning. (line 6)
@@ -18536,7 +18635,7 @@
* characters, special: Reserved characters. (line 6)
* check accent: Accents. (line 91)
* check accent, math: Math accents. (line 20)
-* Cicero: Units of length. (line 33)
+* cicero: Units of length. (line 33)
* circle symbol, big, in text: Text symbols. (line 86)
* circled letter, in text: Text symbols. (line 98)
* circumflex accent: Accents. (line 40)
@@ -18588,7 +18687,7 @@
* colored boxes: Colored boxes. (line 6)
* colored page: Colored pages. (line 6)
* colored text: Colored text. (line 6)
-* command line: Command line interface.
+* command line interface: Command line interface.
(line 6)
* command syntax: LaTeX command syntax.
(line 6)
@@ -18659,7 +18758,7 @@
* defining new theorems: \newtheorem. (line 6)
* definitions: Definitions. (line 6)
* delayed \write: \write. (line 65)
-* Delimiters: Delimiters. (line 6)
+* delimiters: Delimiters. (line 6)
* delimiters, paired: \left & \right. (line 6)
* delim_0: makeindex. (line 110)
* delim_1: makeindex. (line 114)
@@ -18670,7 +18769,7 @@
* description environment: description. (line 6)
* description lists, creating: description. (line 6)
* design size, in font definitions: \newfont. (line 19)
-* Didot point: Units of length. (line 30)
+* didot point: Units of length. (line 30)
* dieresis accent: Accents. (line 25)
* difference between class and package: Class and package construction.
(line 15)
@@ -18692,6 +18791,7 @@
* document class, defined: Starting and ending. (line 17)
* document classes: Document classes. (line 6)
* document environment: document. (line 6)
+* document root name: Jobname. (line 6)
* document templates: Document templates. (line 6)
* dollar sign: Text symbols. (line 116)
* dot accent: Accents. (line 32)
@@ -18733,7 +18833,7 @@
* em-dash, two-thirds: Text symbols. (line 207)
* emphasis: Font styles. (line 60)
* enclosure list: \encl. (line 6)
-* Encoding, font: \DeclareFontEncoding.
+* encoding, font: \DeclareFontEncoding.
(line 6)
* encoding, of input files: inputenc package. (line 15)
* end matter of a book: \frontmatter & \mainmatter & \backmatter.
@@ -18825,6 +18925,7 @@
(line 6)
* external commands: \write18. (line 6)
* external files, writing: filecontents. (line 6)
+* fallback jobname: Jobname. (line 25)
* families, of fonts: Low-level font commands.
(line 21)
* fancyhdr package: Page styles. (line 12)
@@ -18865,27 +18966,10 @@
* font commands, low-level: Low-level font commands.
(line 6)
* font dimension, slant: \/. (line 40)
-* Font encoding: fontenc package. (line 6)
-* Font encoding <1>: \DeclareFontEncoding.
+* font encoding: fontenc package. (line 6)
+* font encoding <1>: \DeclareTextAccent. (line 6)
+* font encoding, declaring: \DeclareFontEncoding.
(line 6)
-* Font encoding <2>: \DeclareTextAccent. (line 6)
-* Font encoding <3>: \DeclareTextAccentDefault.
- (line 6)
-* Font encoding <4>: \DeclareTextCommand & \ProvideTextCommand.
- (line 6)
-* Font encoding <5>: \DeclareTextCommandDefault & \ProvideTextCommandDefault.
- (line 6)
-* Font encoding <6>: \DeclareTextComposite.
- (line 6)
-* Font encoding <7>: \DeclareTextCompositeCommand.
- (line 6)
-* Font encoding <8>: \DeclareTextSymbol. (line 6)
-* Font encoding <9>: \DeclareTextSymbolDefault.
- (line 6)
-* Font encoding <10>: \LastDeclaredEncoding.
- (line 6)
-* Font encoding <11>: \UseTextSymbol & \UseTextAccent.
- (line 6)
* font size: Low-level font commands.
(line 101)
* font sizes: Font sizes. (line 6)
@@ -18909,7 +18993,7 @@
(line 6)
* footnotes in figures: minipage. (line 107)
* footnotes, creating: Footnotes. (line 6)
-* Footnotes, in a minipage: \footnote. (line 62)
+* footnotes, in a minipage: \footnote. (line 62)
* footnotes, symbols instead of numbers: \footnote. (line 24)
* force option for filecontents: filecontents. (line 31)
* format files, TeX: TeX engines. (line 6)
@@ -18968,6 +19052,7 @@
* group_skip: makeindex. (line 57)
* hacek accent: Accents. (line 91)
* Halmos symbol: \rule. (line 13)
+* hard space: ~. (line 6)
* hat accent: Accents. (line 40)
* hat accent, math: Math accents. (line 32)
* header style: \pagestyle. (line 6)
@@ -18987,7 +19072,7 @@
* hyperref package: \footnotemark. (line 48)
* hyperref package <1>: \footnotemark. (line 57)
* hyperref package <2>: \pagenumbering. (line 45)
-* hyperref package <3>: Command line input. (line 10)
+* hyperref package <3>: Command line input. (line 14)
* hyphen character, non-breaking: Text symbols. (line 160)
* hyphenation, defining: \hyphenation. (line 6)
* hyphenation, discretionary: \discretionary. (line 6)
@@ -19037,6 +19122,8 @@
* inputenc: inputenc package. (line 6)
* inserting figures: figure. (line 6)
* insertions of special characters: Special insertions. (line 6)
+* interface, command line: Command line interface.
+ (line 6)
* interline space: \baselineskip & \baselinestretch.
(line 6)
* internal vertical mode: Modes. (line 38)
@@ -19053,9 +19140,9 @@
* item_2: makeindex. (line 87)
* item_x1: makeindex. (line 94)
* item_x2: makeindex. (line 104)
-* Job name: Jobname. (line 6)
* jobname: Command line options.
(line 43)
+* jobname <1>: Jobname. (line 6)
* JPEG files: \includegraphics. (line 6)
* JPG files: \includegraphics. (line 6)
* justification, ragged left: \raggedleft. (line 6)
@@ -19218,7 +19305,7 @@
(line 46)
* mhchem package: Subscripts & superscripts.
(line 62)
-* Millimeter: Units of length. (line 27)
+* millimeter: Units of length. (line 27)
* minipage environment: minipage. (line 6)
* minipage, creating a: minipage. (line 6)
* minted package: tabbing. (line 146)
@@ -19237,6 +19324,7 @@
* multind package: Indexes. (line 32)
* multiplication, discretionary: \*. (line 6)
* name: \newglossaryentry. (line 43)
+* name of document root: Jobname. (line 6)
* NBSP: ~. (line 6)
* nested \include, not allowed: \include & \includeonly.
(line 106)
@@ -19360,7 +19448,7 @@
* package, babel <2>: Accents. (line 6)
* package, babel <3>: \today. (line 13)
* package, babel <4>: Table of contents etc..
- (line 89)
+ (line 124)
* package, babel <5>: \index. (line 56)
* package, beamer: beamer template. (line 6)
* package, bigfoot: Footnotes of footnotes.
@@ -19404,7 +19492,7 @@
* package, hyperref: \footnotemark. (line 48)
* package, hyperref <1>: \footnotemark. (line 57)
* package, hyperref <2>: \pagenumbering. (line 45)
-* package, hyperref <3>: Command line input. (line 10)
+* package, hyperref <3>: Command line input. (line 14)
* package, indentfirst: \part. (line 50)
* package, indentfirst <1>: \chapter. (line 58)
* package, indentfirst <2>: \section. (line 60)
@@ -19441,7 +19529,7 @@
* package, polyglossia: Accents. (line 6)
* package, polyglossia <1>: \today. (line 13)
* package, polyglossia <2>: Table of contents etc..
- (line 90)
+ (line 125)
* package, polyglossia <3>: \index. (line 56)
* package, PSTricks: \line. (line 36)
* package, setspace: \baselineskip & \baselinestretch.
@@ -19466,9 +19554,9 @@
* package, titlesec <5>: \subsubsection & \paragraph & \subparagraph.
(line 65)
* package, tocbibbind: Table of contents etc..
- (line 94)
+ (line 111)
* package, tocloft: Table of contents etc..
- (line 94)
+ (line 111)
* package, ulem: Over- and Underlining.
(line 15)
* package, unicode-math: Greek letters. (line 37)
@@ -19477,6 +19565,7 @@
* package, xparse: LaTeX command syntax.
(line 37)
* package, xparse <1>: \@ifstar. (line 66)
+* package, xstring: Jobname. (line 53)
* packages, loading additional: Additional packages. (line 6)
* page break, forcing: \pagebreak & \nopagebreak.
(line 6)
@@ -19538,13 +19627,13 @@
* plural: \newglossaryentry. (line 51)
* PNG files: \includegraphics. (line 6)
* poetry, an environment for: verse. (line 6)
-* Point: Units of length. (line 10)
+* point: Units of length. (line 10)
* polish l: Additional Latin letters.
(line 36)
* polyglossia package: Accents. (line 6)
* polyglossia package <1>: \today. (line 13)
* polyglossia package <2>: Table of contents etc..
- (line 90)
+ (line 125)
* polyglossia package <3>: \index. (line 56)
* portrait orientation: Document class options.
(line 60)
@@ -19621,7 +19710,7 @@
(line 6)
* running header and footer style: \pagestyle. (line 6)
* sans serif font: Font styles. (line 91)
-* Scaled point: Units of length. (line 36)
+* scaled point: Units of length. (line 36)
* scaling: \scalebox. (line 6)
* scaling <1>: \resizebox. (line 6)
* script fonts: Calligraphic. (line 6)
@@ -19679,7 +19768,6 @@
* sp: Units of length. (line 36)
* space between lines: \baselineskip & \baselinestretch.
(line 6)
-* space, hard: ~. (line 6)
* space, inserting horizontal: \hss. (line 6)
* space, inserting vertical: \addvspace. (line 6)
* space, negative thin: \thinspace & \negthinspace.
@@ -19741,7 +19829,7 @@
* superscript: Subscripts & superscripts.
(line 6)
* symbol: \newglossaryentry. (line 59)
-* Symbol, defining: \DeclareTextSymbol. (line 6)
+* symbol, defining: \DeclareTextSymbol. (line 6)
* symbols, arrows: Arrows. (line 6)
* symbols, boldface: \boldmath & \unboldmath.
(line 6)
@@ -19753,7 +19841,9 @@
* tab stops, using: tabbing. (line 6)
* tabbing environment: tabbing. (line 6)
* table environment: table. (line 6)
-* Table of contents: \contentsline. (line 6)
+* table of contents: \contentsline. (line 6)
+* table of contents entry, create dotted line: \@dottedtocline.
+ (line 6)
* table of contents entry, manually adding: \addcontentsline. (line 6)
* table of contents file: Output files. (line 43)
* table of contents, avoiding footnotes: Footnotes in section headings.
@@ -19774,6 +19864,7 @@
* TeX format (.fmt) files: TeX engines. (line 6)
* TeX logo: Text symbols. (line 65)
* texosquery package: \write18. (line 65)
+* texput, jobname default: Jobname. (line 25)
* text symbols: Text symbols. (line 6)
* text, resizing: \scalebox. (line 6)
* text, resizing <1>: \resizebox. (line 6)
@@ -19824,11 +19915,11 @@
* titlesec package <5>: \subsubsection & \paragraph & \subparagraph.
(line 65)
* tocbibbind package: Table of contents etc..
- (line 94)
+ (line 111)
* tocdepth: Sectioning. (line 80)
* tocdepth counter: Sectioning. (line 81)
* tocloft package: Table of contents etc..
- (line 94)
+ (line 111)
* today's date: \today. (line 6)
* tombstone: \rule. (line 13)
* topmargin: Page layout parameters.
@@ -19856,6 +19947,7 @@
* ulem package: Over- and Underlining.
(line 15)
* umlaut accent: Accents. (line 25)
+* unbreakable space: ~. (line 6)
* underbar: Accents. (line 53)
* underlining: Over- and Underlining.
(line 6)
@@ -19920,6 +20012,7 @@
* xparse package <1>: \@ifstar. (line 66)
* xr package: xr package. (line 6)
* xr-hyper package: xr package. (line 6)
+* xstring package: Jobname. (line 53)
@@ -20112,352 +20205,353 @@
Node: trivlist185766
Node: math187294
Node: minipage187600
-Node: picture193129
-Node: \put199359
-Node: \multiput199924
-Node: \qbezier200663
-Node: \graphpaper202136
-Node: \line202930
-Node: \linethickness204904
-Node: \thinlines205353
-Node: \thicklines205764
-Node: \circle206148
-Node: \oval206690
-Node: \shortstack207666
-Node: \vector209063
-Node: \makebox (picture)209977
-Node: \framebox (picture)211159
-Node: \frame212632
-Node: \dashbox213072
-Node: quotation & quote214207
-Node: tabbing215103
-Node: table221006
-Node: tabular223070
-Ref: tabular arrayrulewidth229407
-Ref: tabular arraystrech229647
-Ref: tabular doublerulesep229868
-Ref: tabular tabcolsep230004
-Node: \multicolumn230525
-Node: \vline234401
-Node: \cline235792
-Node: \hline236502
-Node: thebibliography237184
-Node: \bibitem239667
-Node: \cite241961
-Node: \nocite243829
-Node: Using BibTeX244337
-Node: theorem246508
-Node: titlepage247430
-Node: verbatim248713
-Node: \verb250526
-Node: verse252619
-Node: Line breaking253846
-Node: \\255212
-Node: \obeycr & \restorecr257645
-Node: \newline258456
-Node: \- (hyphenation)259485
-Node: \discretionary261123
-Node: \fussy & \sloppy262011
-Node: sloppypar262794
-Node: \hyphenation263940
-Node: \linebreak & \nolinebreak264534
-Node: Page breaking265682
-Node: \clearpage & \cleardoublepage267712
-Node: \newpage269232
-Node: \enlargethispage270530
-Node: \pagebreak & \nopagebreak271486
-Node: Footnotes273153
-Node: \footnote274299
-Ref: footnote footnoterule275567
-Ref: footnote footnotesep276178
-Node: \footnotemark277244
-Node: \footnotetext279583
-Node: Footnotes in section headings280185
-Node: Footnotes in a table281018
-Node: Footnotes of footnotes283940
-Node: Definitions284644
-Node: \newcommand & \renewcommand285691
-Node: \providecommand290992
-Node: \makeatletter & \makeatother292157
-Node: \@ifstar294259
-Node: \newcounter297744
-Node: \newlength299464
-Node: \newsavebox300286
-Node: \newenvironment & \renewenvironment301265
-Node: \newtheorem306589
-Node: \newfont310161
-Node: \protect311394
-Node: \ignorespaces & \ignorespacesafterend313782
-Node: xspace package316463
-Node: Counters318528
-Node: \alph \Alph \arabic \roman \Roman \fnsymbol320229
-Node: \usecounter322854
-Node: \value323713
-Node: \setcounter324766
-Node: \addtocounter325362
-Node: \refstepcounter325816
-Node: \stepcounter326485
-Node: \day & \month & \year327038
-Node: Lengths327849
-Node: Units of length332384
-Ref: units of length pt332587
-Ref: units of length pc332687
-Ref: units of length in332710
-Ref: units of length bp332736
-Ref: units of length cm332867
-Ref: units of length mm332889
-Ref: units of length dd332911
-Ref: units of length cc332943
-Ref: units of length sp332968
-Ref: Lengths/em332999
-Ref: Lengths/en332999
-Ref: Lengths/ex332999
-Ref: units of length em332999
-Ref: units of length en332999
-Ref: units of length ex332999
-Node: \setlength333855
-Node: \addtolength334940
-Node: \settodepth336015
-Node: \settoheight336893
-Node: \settowidth337786
-Node: Expressions338674
-Node: Making paragraphs343447
-Node: \par345218
-Node: \indent & \noindent347165
-Node: \parindent & \parskip348700
-Node: Marginal notes350007
-Ref: marginal notes marginparpush351403
-Ref: marginal notes marginparsep351577
-Ref: marginal notes marginparwidth351709
-Node: Math formulas352058
-Node: Subscripts & superscripts356226
-Node: Math symbols358387
-Node: Arrows382158
-Node: \boldmath & \unboldmath383346
-Node: Blackboard bold384865
-Node: Calligraphic385667
-Node: Delimiters386198
-Node: \left & \right388386
-Node: \bigl & \bigr etc.392394
-Node: Dots395147
-Ref: ellipses cdots395578
-Ref: ellipses ddots395723
-Ref: ellipses ldots395804
-Ref: ellipses vdots396221
-Node: Greek letters397405
-Node: Math functions399084
-Node: Math accents400728
-Node: Over- and Underlining401627
-Node: Spacing in math mode403454
-Ref: spacing in math mode thickspace404389
-Ref: spacing in math mode medspace404814
-Ref: Spacing in math mode/\thinspace405241
-Ref: spacing in math mode thinspace405241
-Ref: spacing in math mode negthinspace405722
-Ref: spacing in math mode quad406049
-Ref: spacing in math mode qquad406305
-Node: \smash406643
-Node: \phantom & \vphantom & \hphantom408860
-Node: \mathstrut411407
-Node: Math miscellany412369
-Node: Colon character & \colon412875
-Node: \*413568
-Node: \frac414148
-Node: \sqrt414519
-Node: \stackrel415105
-Node: Modes415378
-Ref: modes paragraph mode415828
-Ref: modes lr mode416024
-Ref: modes math mode416630
-Ref: modes vertical mode416965
-Ref: modes internal vertical mode417136
-Ref: modes inner paragraph mode417609
-Ref: modes outer paragraph mode417609
-Node: \ensuremath418023
-Node: Page styles418728
-Node: \maketitle419491
-Node: \pagenumbering422509
-Node: \pagestyle424497
-Node: \thispagestyle427999
-Node: Spaces428953
-Node: \enspace & \quad & \qquad430394
-Node: \hspace431309
-Node: \hfill433147
-Node: \hss434211
-Node: \spacefactor434905
-Node: \@438292
-Ref: \AT438392
-Node: \frenchspacing440332
-Node: \normalsfcodes441167
-Node: \(SPACE)441414
-Node: ~443204
-Node: \thinspace & \negthinspace445781
-Node: \/446952
-Node: \hrulefill & \dotfill448908
-Node: \bigskip & \medskip & \smallskip450264
-Ref: bigskip451082
-Ref: medskip451286
-Ref: smallskip451495
-Node: \bigbreak & \medbreak & \smallbreak452156
-Node: \strut453142
-Node: \vspace456337
-Node: \vfill457901
-Node: \addvspace458829
-Node: Boxes460825
-Node: \mbox & \makebox461531
-Ref: mbox makebox depth462799
-Ref: mbox makebox height462799
-Ref: mbox makebox width462799
-Ref: mbox makebox totalheight462799
-Node: \fbox & \framebox464894
-Ref: fbox framebox fboxrule466208
-Ref: fbox framebox fboxsep466398
-Node: \parbox467488
-Node: \raisebox469794
-Ref: raisebox depth470767
-Ref: raisebox height470767
-Ref: raisebox width470767
-Ref: raisebox totalheight470767
-Node: \sbox & \savebox471468
-Node: lrbox474530
-Node: \usebox475416
-Node: Color475855
-Node: Color package options476654
-Node: Color models478300
-Ref: color models cmyk479097
-Ref: color models gray479460
-Ref: color models rgb479609
-Ref: color models RGB479946
-Ref: color models named480321
-Node: Commands for color480609
-Node: Define colors481024
-Node: Colored text481749
-Node: Colored boxes484146
-Node: Colored pages485535
-Node: Graphics486228
-Node: Graphics package options488355
-Node: Graphics package configuration491108
-Node: \graphicspath491910
-Node: \DeclareGraphicsExtensions494868
-Node: \DeclareGraphicsRule496686
-Node: Commands for graphics499867
-Node: \includegraphics500372
-Ref: includegraphics width505426
-Ref: includegraphics height505959
-Ref: includegraphics totalheight506365
-Ref: includegraphics keepaspectratio506629
-Ref: includegraphics viewport508315
-Ref: includegraphics trim508710
-Ref: includegraphics clip509166
-Ref: includegraphics page509426
-Ref: includegraphics pagebox509517
-Ref: includegraphics interpolate510382
-Ref: includegraphics quiet510587
-Ref: includegraphics draft510748
-Ref: includegraphics bb511553
-Ref: includegraphics bbllx511951
-Ref: includegraphics bblly511951
-Ref: includegraphics bburx511951
-Ref: includegraphics bbury511951
-Ref: includegraphics natwidth512093
-Ref: includegraphics natheight512093
-Ref: includegraphics hiresbb512279
-Ref: includegraphics type513041
-Ref: includegraphics ext513081
-Ref: includegraphics read513184
-Ref: includegraphics command513301
-Node: \rotatebox513547
-Node: \scalebox516401
-Node: \resizebox517457
-Node: Special insertions518649
-Node: Reserved characters519517
-Node: Upper and lower case520777
-Node: Symbols by font position523163
-Node: Text symbols523842
-Node: Accents528826
-Node: \accent530979
-Node: Additional Latin letters532741
-Ref: Non-English characters532923
-Node: inputenc package533942
-Node: \rule536492
-Node: \today537657
-Node: Splitting the input538593
-Node: \endinput540335
-Node: \include & \includeonly541638
-Node: \input545935
-Node: Front/back matter547150
-Node: Table of contents etc.547483
-Node: \addcontentsline551481
-Node: \addtocontents554348
-Node: \contentsline555944
-Node: \nofiles558060
-Node: \numberline558811
-Node: Indexes559647
-Node: \index561255
-Node: makeindex566360
-Ref: makeindex preamble568028
-Ref: makeindex postamble568168
-Ref: makeindex group skip568253
-Ref: makeindex letheadflag568586
-Ref: makeindex lethead prefix569047
-Ref: makeindex lethead suffix569199
-Ref: makeindex item 0569347
-Ref: makeindex item 1569427
-Ref: makeindex item 2569502
-Ref: makeindex item 01569580
-Ref: makeindex item x1569685
-Ref: makeindex item 12569890
-Ref: makeindex item x2569998
-Ref: makeindex delim 0570158
-Ref: makeindex delim 1570288
-Ref: makeindex delim 2570418
-Ref: makeindex delim n570544
-Ref: makeindex delim r570679
-Ref: makeindex line max570787
-Ref: makeindex indent space570922
-Ref: makeindex indent length571017
-Ref: makeindex page precedence571202
-Node: \printindex572076
-Node: Glossaries572549
-Node: \newglossaryentry574516
-Node: \gls575983
-Node: Letters576777
-Node: \address580395
-Node: \cc581206
-Node: \closing581648
-Node: \encl581962
-Node: \location582376
-Node: \makelabels582640
-Node: \name584957
-Node: \opening585198
-Node: \ps585479
-Node: \signature585768
-Node: \telephone586996
-Node: Input/output587361
-Node: \openin & \openout588091
-Node: \read590834
-Node: \typein592021
-Node: \typeout593281
-Node: \write594331
-Node: \write and security599058
-Node: \message600002
-Node: \wlog601831
-Node: \write18602332
-Node: Command line interface605823
-Ref: Command line605987
-Node: Command line options608070
-Ref: interaction modes609066
-Ref: output directory610020
-Node: Command line input611719
-Node: Jobname613548
-Node: Recovering from errors616829
-Node: Document templates618174
-Node: beamer template618608
-Node: article template619250
-Node: book template619713
-Node: Larger book template620192
-Node: Index621734
-Ref: Command Index621820
+Node: picture193165
+Node: \put199395
+Node: \multiput199960
+Node: \qbezier200699
+Node: \graphpaper202172
+Node: \line202966
+Node: \linethickness204940
+Node: \thinlines205389
+Node: \thicklines205800
+Node: \circle206184
+Node: \oval206726
+Node: \shortstack207702
+Node: \vector209099
+Node: \makebox (picture)210013
+Node: \framebox (picture)211195
+Node: \frame212668
+Node: \dashbox213108
+Node: quotation & quote214243
+Node: tabbing215139
+Node: table221042
+Node: tabular223106
+Ref: tabular arrayrulewidth229443
+Ref: tabular arraystrech229683
+Ref: tabular doublerulesep229904
+Ref: tabular tabcolsep230040
+Node: \multicolumn230561
+Node: \vline234437
+Node: \cline235828
+Node: \hline236538
+Node: thebibliography237220
+Node: \bibitem239703
+Node: \cite241997
+Node: \nocite243865
+Node: Using BibTeX244373
+Node: theorem246544
+Node: titlepage247466
+Node: verbatim248749
+Node: \verb250562
+Node: verse252655
+Node: Line breaking253882
+Node: \\255248
+Node: \obeycr & \restorecr257681
+Node: \newline258492
+Node: \- (hyphenation)259521
+Node: \discretionary261159
+Node: \fussy & \sloppy262047
+Node: sloppypar262830
+Node: \hyphenation263976
+Node: \linebreak & \nolinebreak264570
+Node: Page breaking265718
+Node: \clearpage & \cleardoublepage267748
+Node: \newpage269268
+Node: \enlargethispage270566
+Node: \pagebreak & \nopagebreak271522
+Node: Footnotes273189
+Node: \footnote274335
+Ref: footnote footnoterule275603
+Ref: footnote footnotesep276214
+Node: \footnotemark277280
+Node: \footnotetext279619
+Node: Footnotes in section headings280221
+Node: Footnotes in a table281054
+Node: Footnotes of footnotes283976
+Node: Definitions284680
+Node: \newcommand & \renewcommand285727
+Node: \providecommand291028
+Node: \makeatletter & \makeatother292193
+Node: \@ifstar294295
+Node: \newcounter297780
+Node: \newlength299500
+Node: \newsavebox300322
+Node: \newenvironment & \renewenvironment301301
+Node: \newtheorem306625
+Node: \newfont310197
+Node: \protect311430
+Node: \ignorespaces & \ignorespacesafterend313818
+Node: xspace package316499
+Node: Counters318564
+Node: \alph \Alph \arabic \roman \Roman \fnsymbol320265
+Node: \usecounter322890
+Node: \value323749
+Node: \setcounter324802
+Node: \addtocounter325398
+Node: \refstepcounter325852
+Node: \stepcounter326521
+Node: \day & \month & \year327074
+Node: Lengths327885
+Node: Units of length332420
+Ref: units of length pt332623
+Ref: units of length pc332723
+Ref: units of length in332746
+Ref: units of length bp332772
+Ref: units of length cm332903
+Ref: units of length mm332925
+Ref: units of length dd332947
+Ref: units of length cc332979
+Ref: units of length sp333004
+Ref: Lengths/em333035
+Ref: Lengths/en333035
+Ref: Lengths/ex333035
+Ref: units of length em333035
+Ref: units of length en333035
+Ref: units of length ex333035
+Node: \setlength333891
+Node: \addtolength334976
+Node: \settodepth336051
+Node: \settoheight336929
+Node: \settowidth337822
+Node: Expressions338710
+Node: Making paragraphs343495
+Node: \par345266
+Node: \indent & \noindent347213
+Node: \parindent & \parskip348748
+Node: Marginal notes350055
+Ref: marginal notes marginparpush351451
+Ref: marginal notes marginparsep351625
+Ref: marginal notes marginparwidth351757
+Node: Math formulas352106
+Node: Subscripts & superscripts356274
+Node: Math symbols358435
+Node: Arrows382206
+Node: \boldmath & \unboldmath383394
+Node: Blackboard bold384913
+Node: Calligraphic385715
+Node: Delimiters386246
+Node: \left & \right388434
+Node: \bigl & \bigr etc.392442
+Node: Dots395195
+Ref: ellipses cdots395626
+Ref: ellipses ddots395771
+Ref: ellipses ldots395852
+Ref: ellipses vdots396269
+Node: Greek letters397453
+Node: Math functions399132
+Node: Math accents400776
+Node: Over- and Underlining401675
+Node: Spacing in math mode403502
+Ref: spacing in math mode thickspace404437
+Ref: spacing in math mode medspace404862
+Ref: Spacing in math mode/\thinspace405289
+Ref: spacing in math mode thinspace405289
+Ref: spacing in math mode negthinspace405770
+Ref: spacing in math mode quad406097
+Ref: spacing in math mode qquad406353
+Node: \smash406691
+Node: \phantom & \vphantom & \hphantom408908
+Node: \mathstrut411455
+Node: Math miscellany412417
+Node: Colon character & \colon412923
+Node: \*413616
+Node: \frac414196
+Node: \sqrt414567
+Node: \stackrel415153
+Node: Modes415426
+Ref: modes paragraph mode415876
+Ref: modes lr mode416072
+Ref: modes math mode416678
+Ref: modes vertical mode417013
+Ref: modes internal vertical mode417184
+Ref: modes inner paragraph mode417657
+Ref: modes outer paragraph mode417657
+Node: \ensuremath418071
+Node: Page styles418776
+Node: \maketitle419539
+Node: \pagenumbering422557
+Node: \pagestyle424545
+Node: \thispagestyle428047
+Node: Spaces429001
+Node: \enspace & \quad & \qquad430442
+Node: \hspace431357
+Node: \hfill433195
+Node: \hss434259
+Node: \spacefactor434953
+Node: \@438340
+Ref: \AT438440
+Node: \frenchspacing440380
+Node: \normalsfcodes441215
+Node: \(SPACE)441462
+Node: ~443252
+Node: \thinspace & \negthinspace445829
+Node: \/447000
+Node: \hrulefill & \dotfill448956
+Node: \bigskip & \medskip & \smallskip450312
+Ref: bigskip451130
+Ref: medskip451334
+Ref: smallskip451543
+Node: \bigbreak & \medbreak & \smallbreak452204
+Node: \strut453190
+Node: \vspace456385
+Node: \vfill457949
+Node: \addvspace458877
+Node: Boxes460873
+Node: \mbox & \makebox461579
+Ref: mbox makebox depth462847
+Ref: mbox makebox height462847
+Ref: mbox makebox width462847
+Ref: mbox makebox totalheight462847
+Node: \fbox & \framebox464942
+Ref: fbox framebox fboxrule466256
+Ref: fbox framebox fboxsep466446
+Node: \parbox467536
+Node: \raisebox469842
+Ref: raisebox depth470815
+Ref: raisebox height470815
+Ref: raisebox width470815
+Ref: raisebox totalheight470815
+Node: \sbox & \savebox471516
+Node: lrbox474578
+Node: \usebox475464
+Node: Color475903
+Node: Color package options476702
+Node: Color models478348
+Ref: color models cmyk479145
+Ref: color models gray479508
+Ref: color models rgb479657
+Ref: color models RGB479994
+Ref: color models named480369
+Node: Commands for color480657
+Node: Define colors481072
+Node: Colored text481797
+Node: Colored boxes484194
+Node: Colored pages485583
+Node: Graphics486276
+Node: Graphics package options488403
+Node: Graphics package configuration491156
+Node: \graphicspath491958
+Node: \DeclareGraphicsExtensions494916
+Node: \DeclareGraphicsRule496734
+Node: Commands for graphics499915
+Node: \includegraphics500420
+Ref: includegraphics width505474
+Ref: includegraphics height506007
+Ref: includegraphics totalheight506413
+Ref: includegraphics keepaspectratio506677
+Ref: includegraphics viewport508363
+Ref: includegraphics trim508758
+Ref: includegraphics clip509214
+Ref: includegraphics page509474
+Ref: includegraphics pagebox509565
+Ref: includegraphics interpolate510430
+Ref: includegraphics quiet510635
+Ref: includegraphics draft510796
+Ref: includegraphics bb511601
+Ref: includegraphics bbllx511999
+Ref: includegraphics bblly511999
+Ref: includegraphics bburx511999
+Ref: includegraphics bbury511999
+Ref: includegraphics natwidth512141
+Ref: includegraphics natheight512141
+Ref: includegraphics hiresbb512327
+Ref: includegraphics type513089
+Ref: includegraphics ext513129
+Ref: includegraphics read513232
+Ref: includegraphics command513349
+Node: \rotatebox513595
+Node: \scalebox516449
+Node: \resizebox517505
+Node: Special insertions518697
+Node: Reserved characters519565
+Node: Upper and lower case520825
+Node: Symbols by font position523211
+Node: Text symbols523890
+Node: Accents528874
+Node: \accent531027
+Node: Additional Latin letters532789
+Ref: Non-English characters532971
+Node: inputenc package533990
+Node: \rule536540
+Node: \today537705
+Node: Splitting the input538641
+Node: \endinput540383
+Node: \include & \includeonly541686
+Node: \input545983
+Node: Front/back matter547198
+Node: Table of contents etc.547531
+Node: \@dottedtocline553232
+Node: \addcontentsline554739
+Node: \addtocontents557617
+Node: \contentsline559834
+Node: \nofiles561527
+Node: \numberline562278
+Node: Indexes563393
+Node: \index565001
+Node: makeindex570106
+Ref: makeindex preamble571774
+Ref: makeindex postamble571914
+Ref: makeindex group skip571999
+Ref: makeindex letheadflag572332
+Ref: makeindex lethead prefix572793
+Ref: makeindex lethead suffix572945
+Ref: makeindex item 0573093
+Ref: makeindex item 1573173
+Ref: makeindex item 2573248
+Ref: makeindex item 01573326
+Ref: makeindex item x1573431
+Ref: makeindex item 12573636
+Ref: makeindex item x2573744
+Ref: makeindex delim 0573904
+Ref: makeindex delim 1574034
+Ref: makeindex delim 2574164
+Ref: makeindex delim n574290
+Ref: makeindex delim r574425
+Ref: makeindex line max574533
+Ref: makeindex indent space574668
+Ref: makeindex indent length574763
+Ref: makeindex page precedence574948
+Node: \printindex575822
+Node: Glossaries576295
+Node: \newglossaryentry578262
+Node: \gls579729
+Node: Letters580523
+Node: \address584141
+Node: \cc584952
+Node: \closing585394
+Node: \encl585708
+Node: \location586122
+Node: \makelabels586386
+Node: \name588703
+Node: \opening588944
+Node: \ps589225
+Node: \signature589514
+Node: \telephone590742
+Node: Input/output591107
+Node: \openin & \openout591837
+Node: \read594580
+Node: \typein595767
+Node: \typeout597027
+Node: \write598077
+Node: \write and security602804
+Node: \message603748
+Node: \wlog605577
+Node: \write18606078
+Node: Command line interface609569
+Ref: Command line609733
+Node: Command line options611886
+Ref: interaction modes612889
+Ref: output directory613843
+Node: Command line input615542
+Node: Jobname617573
+Node: Recovering from errors620715
+Node: Document templates622060
+Node: beamer template622494
+Node: article template623136
+Node: book template623599
+Node: Larger book template624078
+Node: Index625620
+Ref: Command Index625706
End Tag Table
Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2021-06-21 17:30:21 UTC (rev 928)
+++ trunk/latex2e.texi 2021-06-27 16:27:42 UTC (rev 929)
@@ -27,7 +27,7 @@
@c xx JH ligatures
@c xx JH \stretch
@c xx JH \@@dottedtocline?
- at c xx JH \caption, \ignorespaces
+ at c xx JH \caption
@c
@c xx The typeset source2e has an index with all kernel
@c xx commands, though some are internal and shouldn't be included.
@@ -18906,7 +18906,7 @@
@code{\newpage} command after the @code{\tableofcontents} command, as
above.
-To make the table of contents @LaTeX{} stores the information in an
+To make the table of contents, @LaTeX{} stores the information in an
auxiliary file named @file{@var{root-file}.toc} (@pxref{Splitting the
input}). For example, this @LaTeX{} file @file{test.tex}
@@ -18920,66 +18920,143 @@
@end example
@noindent
-writes the following line to @file{test.toc}.
+writes these lines to @file{test.toc}.
@example
\contentsline @{section@}@{\numberline @{1@}First section@}@{2@}
\contentsline @{subsection@}@{\numberline @{1.1@}First subsection@}@{2@}
@end example
+ at findex \contentsline
@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. Its unique argument, @code{1} or @code{1.1},
-is the sectioning unit number, whereas the remainder of the second
-argument of @code{\contentsline}, @code{First section} or @code{First
-subsection}, is the title. Finally, the third argument, @code{2}, is
-the page number on which the sectioning units start (@pxref{\contentsline}).
+Each line contains a single command, @code{\contentsline}
+(@pxref{\contentsline}). The first argument, the @code{section} or
+ at code{subsection}, is the sectioning unit. The second argument has two
+components. The hook @code{\numberline} determines how the sectioning
+number, @code{1} or @code{1.1}, appears in the table of contents
+(@pxref{\numberline}). The remainder of the second argument of
+ at code{\contentsline}, @samp{First section} or @samp{First subsection},
+is the sectioning title text. Finally, the third argument, @samp{2}, is
+the page number on which this sectioning unit starts.
-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.
+To typeset these lines, the document class provides commands
+ at code{\l@@section@{@var{text}@}@{@var{pagenumber}@}} or
+ at code{\l@@subsection@{@var{text}@}@{@var{pagenumber}@}}, etc. These
+ at code{\l@@@var{section-unit}} commands often use the
+ at code{\@@dottedtocline} command (@pxref{\@@dottedtocline}).
+A consequence of @LaTeX{}'s strategy of using auxiliary files is that to
+get the correct information in the document you must run @LaTeX{} twice,
+once to store the information and the second time to retrieve it. In
+the ordinary course of writing a document authors run @LaTeX{} a number
+of times, but you may notice that the first time that you compile a new
+document, the table of contents page will be empty except for its
+ at samp{Contents} header. Just run @LaTeX{} 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.
+list of figures and a list of tables. Their information is stored in
+files with extension @file{.lof} and @file{.lot}. They work the same way
+as @code{\tableofcontents} but the latter is more common, so we use it
+for most examples.
-To change the header for the table of contents page do something like
-the first line here.
+You can manually add material to the table of contents, the list of
+figures, and the list of tables. For instance, add a line about a
+section to the table of contents with
+ at code{\addcontentsline@{toc@}@{section@}@{@var{text}@}}.
+(@pxref{\addcontentsline}). Add arbitrary material, that is, non-line
+material, with @code{\addtocontents}, as with the command
+ at code{\addtocontents@{lof@}@{\protect\vspace@{2ex@}@}}, which adds
+vertical space to the list of figures (@pxref{\addtocontents}).
+Lines in the table of contents, the list of figures, and the list of
+tables, have four parts. First is an indent. Next is a box into which
+sectioning numbers are placed, and then the third box holds the title
+text, such as @samp{First section}. Finally there is a box up against
+the right margin, inside of which @LaTeX{} puts the page number box.
+For the indent and the width of the number box,
+ at pxref{\@@dottedtocline}. The right margin box has width
+ at code{\@@tocrmarg} and the page number is flush right in that space,
+inside a box of width @code{\@@pnumwidth}. By default
+ at code{\@@tocrmarg} is @code{2.55em} and @code{\@@pnumwidth} is
+ at code{1.55em}. Change these as with
+ at code{\renewcommand@{\@@tocrmarg@}@{3.5em@}}.
+
+ at PkgIndex{tocloft}
+ at PkgIndex{tocbibbind}
+CTAN has many packages for the table of contents and lists of figures
+and tables (@pxref{CTAN}). The package @file{tocloft} is convenient for
+adjusting some aspects of the default such as spacing. And,
+ at file{tocbibbind} will automatically add the bibliography, index,
+etc. to the table of contents.
+
+To change the header for the table of contents page, do something like
+these commands before you call @code{\tableofcontents}, etc.
+
@example
-\renewcommand@{\contentsname@}@{Table of contents@}
+\renewcommand@{\contentsname@}@{Table of Contents@}
\renewcommand@{\listfigurename@}@{Plots@}
-\renewcommand@{\listtablename@}@{Tables@}
+\renewcommand@{\listtablename@}@{Specifications@}
@end example
@noindent
@PkgIndex{babel}
@PkgIndex{polyglossia}
-Similarly, the other two lines will do the other two.
Internationalization packages such as @file{babel} or @file{polyglossia}
-will change the headers depending on the chosen base language.
+will change these 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
+* \@@dottedtocline:: Format entry line in table of contents, etc.
* \addcontentsline:: Add an entry to table of contents, etc.
* \addtocontents:: Add text directly to table of contents file, etc.
-* \contentsline:: Internal command to set line in table of contents, etc.
+* \contentsline:: Set line in table of contents, etc.
* \nofiles:: Prevent writing to auxiliary files.
* \numberline:: Put its number argument flush left in a box.
@end menu
+ at node \@@dottedtocline
+ at subsection @code{\@@dottedtocline}
+
+ at findex \@@dottedtocline
+ at cindex table of contents entry, create dotted line
+
+Synopsis:
+
+ at example
+\@@dottedtocline@{@var{section-level-num}@}@{@var{indent}@}@{@var{numwidth}@}@{@var{text}@}@{@var{pagenumber}@}
+ at end example
+
+Used internally by @LaTeX{} to format an entry line in the table of
+contents, list of figures, or list of tables. Authors do not directly
+enter @code{\@@dottedtocline} commands.
+
+This command is often used by @code{\l@@section}, @code{\l@@subsection},
+etc., to format the content lines. For example, the @file{article.cls}
+file contains these definitions.
+
+ at example
+\newcommand*\l@@section@{\@@dottedtocline@{1@}@{1.5em@}@{2.3em@}@}
+\newcommand*\l@@subsection@{\@@dottedtocline@{2@}@{3.8em@}@{3.2em@}@}
+\newcommand*\l@@subsubsection@{\@@dottedtocline@{3@}@{7.0em@}@{4.1em@}@}
+ at end example
+
+ at noindent
+(In this example, @code{\@@dottedcline} appears to have been given only
+three arguments. But tracing the internal code shows it picks up the
+ at var{text} and @var{pagenumber} arguments from a call to
+ at code{\contentsline}.)
+
+Between the box for the title text of a section and the right margin
+box, these @code{\@@dottedtocline} commands insert leaders,
+evenly-spaced dots. The dot-to-dot space is given by the command
+ at code{\@@dotsep}. By default it is 4.5 (it is in math units, which are
+ at code{1/18}@tie{}em. Change it using @code{\renewcommand}, as with
+ at code{\renewcommand@{\@@dotsep@}@{3.5@}}. (In the default book class,
+ at LaTeX{} does not use dotted leaders for the Part and Chapter table
+entries, and in the default article class it does not use dotted leaders
+for Section entries.)
+
+
@node \addcontentsline
@subsection @code{\addcontentsline}
@@ -18993,9 +19070,7 @@
@end example
@findex \contentsline
-Add an entry to the file specified by @var{ext}. Usually @var{ext} is
-one of:@tie{}@code{toc} for the table of contents, @code{lof} for the list of
-figures, or @code{lot} for the list of tables.
+Add an entry to the auxillary file with extension @var{ext}.
The following will result in an @samp{Appendices} line in the table of
contents.
@@ -19019,10 +19094,10 @@
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.
+also used by authors. For example, an author writing a book whose style
+is to have an unnumbered preface may use the starred @code{\chapter*}.
+But that command leaves out table of contents information, which can be
+entered manually, as here.
@example
\chapter*@{Preface@}
@@ -19031,11 +19106,9 @@
@noindent
In the @file{.toc} file @LaTeX{} will put the line @code{\contentsline
-@{chapter@}@{\numberline @{@}Preface@}@{3@}}; note the page number
- at samp{3}.
+@{chapter@}@{\numberline @{@}Preface@}@{3@}}; note that the page number
+ at samp{3} is automatically generated by the system, not entered manually.
- at c xx how hardwired are these values? other unit names?
-
All of the arguments for @code{\addcontentsline} are required.
@table @var
@@ -19095,7 +19168,7 @@
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
+for the table of contents so that is the discussion here, but it also
applies to the list of figures and list of tables.
This will put some vertical space in the table of contents after the
@@ -19106,6 +19179,30 @@
\addtocontents@{toc@}@{\protect\vspace*@{3ex@}@}
@end example
+ at noindent
+This puts the word @samp{Page}, in boldface, above the column of page
+numbers and after the header.
+
+ at example
+\tableofcontents
+\addtocontents@{toc@}@{~\hfill\textbf@{Page@}\par@}
+\chapter@{...@}
+ at end example
+
+ at noindent
+This adds a line announcing work by a new author.
+
+ at example
+\addtocontents@{toc@}@{%
+ \protect\vspace@{2ex@}
+ \textbf@{Chapters by N. Other Author@}\par@}
+ at end example
+
+The difference between @code{\addtocontents} and @code{\addcontentsline}
+is that the latter is strictly for lines, such as with a line giving the
+page number for the start of a new subset of the chapters. As the above
+examples show, @code{\addtocontents} is for material such as spacing.
+
The @code{\addtocontents} command has two arguments. Both are
required.
@@ -19154,13 +19251,13 @@
\contentsline@{@var{unit}@}@{@var{text}@}@{@var{pagenumber}@}
@end example
-Used internally by @LaTeX{} to typeset an entry of the Table of
-Contents, List of Figures, or List of Tables (@pxref{Table of contents
+Used internally by @LaTeX{} to typeset an entry of the table of
+contents, list of figures, or list of tables (@pxref{Table of contents
etc.}). Authors do not directly enter @code{\contentsline} commands.
Usually adding material to these lists is done automatically by the
-commands @code{\chapter}, @code{\section}, etc. for the Table of
-Contents, or by the @code{\caption} command inside of a @code{\figure}
+commands @code{\chapter}, @code{\section}, etc. for the table of
+contents, or by the @code{\caption} command inside of a @code{\figure}
or @code{\table} environment (@pxref{figure} and @pxref{table}). Thus,
where the base file is @file{thesis.tex}, and contains the declaration
@code{\tableofcontents}, the command @code{\chapter@{Chapter One@}}
@@ -19181,16 +19278,7 @@
To manually add material, use
@code{\addcontentsline@{@var{filetype}@}@{@var{unit}@}@{@var{text}@}},
where @var{filetype} is @code{toc}, @code{lof}, or @code{lot}
-(@pxref{\addcontentsline}). For example, for the Table of Contents,
- at code{\addcontentsline@{toc@}@{@var{unit}@}@{@var{text}@}} writes to the
- at file{.toc} file the line
- at code{\contentsline@{@var{unit}@}@{@var{text}@}@{@var{pagenumber}@}},
-where @var{unit} is @code{chapter}, @code{section}, @code{subsection},
-etc. When @LaTeX{} runs, this line is transformed to
- at code{\l@@@var{unit}@{@var{text}@}@{@var{pagenumber}@}}. Thus,
- at code{\contentsline@{chapter@}@{Background@}@{2@}} will become
- at code{\l@@chapter@{Background@}@{2@}}, where @code{\l@@chapter} is
-defined by the document class.
+(@pxref{\addcontentsline}).
For manipulating how the @code{\contentline} material is typeset, see
the @file{tocloft} package.
@@ -19249,15 +19337,22 @@
@end example
Typeset its argument flush left in a box. This is used in a
- at code{\contentsline} command (@pxref{\contentsline}).
+ at code{\contentsline} command to typeset the section number
+(@pxref{\contentsline}).
For example, this line in a @file{.toc} file causes the @code{1} to be
typeset flush left.
@example
-\contentsline @{section@}@{\numberline @{1@}First section@}@{2@}
+\contentsline @{subsection@}@{\numberline @{1.1@}Motivation@}@{2@}
@end example
+By default, @LaTeX{} typesets the section numbers in a box of length
+ at code{\@@tempdima}. That length is set by the commands
+ at code{\l@@section}, @code{\l@@subsection}, etc. Put section numbers
+inside a natural-width box with
+ at code{\renewcommand@{\numberline@}[1]@{#1~@}}.
+
This command is fragile, so you may need to precede it with
@code{\protect} (@pxref{\protect}). An example is the use of
@code{\protect} in the command
More information about the latexrefman-commits
mailing list.