[latexrefman-commits] [SCM] latexrefman updated: r925 - trunk
Jim Hefferon
INVALID.NOREPLY at gnu.org.ua
Fri Jun 11 16:07:10 CEST 2021
Author: jimhefferon
Date: 2021-06-11 14:07:09 +0000 (Fri, 11 Jun 2021)
New Revision: 925
Modified:
trunk/ChangeLog
trunk/latex2e.html
trunk/latex2e.info
trunk/latex2e.pdf
trunk/latex2e.texi
Log:
add section on \contentsline
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2021-06-09 12:41:18 UTC (rev 924)
+++ trunk/ChangeLog 2021-06-11 14:07:09 UTC (rev 925)
@@ -1,5 +1,9 @@
-2021-06-04 Jim Hefferon <jim at joshua.smcvt.edu>
+2021-06-11 Jim Hefferon <jim at joshua.smcvt.edu>
+ * latex2e.texi (Expressions): Add section on \contentsline.
+
+2021-06-09 Jim Hefferon <jim at joshua.smcvt.edu>
+
* latex2e.texi (Expressions): Add section on \numexpr, etc.
2021-06-04 Jim Hefferon <jim at joshua.smcvt.edu>
Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html 2021-06-09 12:41:18 UTC (rev 924)
+++ trunk/latex2e.html 2021-06-11 14:07:09 UTC (rev 925)
@@ -534,7 +534,8 @@
<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-_005cnofiles-1" href="#g_t_005cnofiles">25.1.3 <code>\nofiles</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>
</ul></li>
<li><a id="toc-Indexes-1" href="#Indexes">25.2 Indexes</a>
<ul class="no-bullet">
@@ -12735,7 +12736,7 @@
<code>\divide</code>, which truncates). Thus
<code>\the\dimexpr5pt*(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> puts ‘<samp>5.0pt</samp>’.
+<code>\the\dimexpr5pt*(4/3)\relax</code> produces ‘<samp>5.0pt</samp>’.
</p>
<hr>
@@ -16304,7 +16305,7 @@
<code>$\sqrt{x\mathstrut} + \sqrt{x^i\mathstrut}$</code>.
</p>
<p>The <code>\mathstrut</code> command adds the vertical height of an open
-parenthesis, <code>(</code> but no horizontal space. It is defined as
+parenthesis, <code>(</code>, but no horizontal space. It is defined as
<code>\vphantom{(}</code>, so see <a href="#g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom">\phantom & \vphantom & \hphantom</a> for
more. An advantage over <code>\strut</code> is that <code>\mathstrut</code> adds no
depth, which is often the right thing for formulas. Using the height of
@@ -21808,8 +21809,10 @@
</td></tr>
<tr><td align="left" valign="top">• <a href="#g_t_005caddtocontents" accesskey="2">\addtocontents</a></td><td> </td><td align="left" valign="top">Add text directly to table of contents file, etc.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_005cnofiles" accesskey="3">\nofiles</a></td><td> </td><td align="left" valign="top">Prevent writing to auxiliary files.
+<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.
</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.
+</td></tr>
</table>
@@ -21924,7 +21927,7 @@
<hr>
<span id="g_t_005caddtocontents"></span><div class="header">
<p>
-Next: <a href="#g_t_005cnofiles" accesskey="n" rel="next">\nofiles</a>, Previous: <a href="#g_t_005caddcontentsline" accesskey="p" rel="prev">\addcontentsline</a>, Up: <a href="#Table-of-contents-etc_002e" accesskey="u" rel="up">Table of contents etc.</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</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>
@@ -21979,11 +21982,86 @@
</p>
<hr>
+<span id="g_t_005ccontentsline"></span><div class="header">
+<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="index-Table-of-contents"></span>
+<span id="index-_005ccontentsline-1"></span>
+<span id="index-_005ctableofcontents-1"></span>
+<span id="index-_002etoc-file-2"></span>
+<span id="index-_005clistoffigures-1"></span>
+<span id="index-_005clistoftables-1"></span>
+<span id="index-_002elof-file-2"></span>
+<span id="index-_002elot-file-2"></span>
+<span id="index-_005cl_0040chapter"></span>
+<span id="index-_005cl_0040section"></span>
+<span id="index-_005cl_0040subsection"></span>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<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. 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>
+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>
+produces something like this in the file <samp>thesis.toc</samp>.
+</p>
+<div class="example">
+<pre class="example">\contentsline {chapter}{\numberline {1}Chapter One}{3}
+</pre></div>
+
+<p>If the file contains the declaration <code>\listoffigures</code> then a figure
+environment involving <code>\caption{Test}</code> will produce
+something like this in <samp>thesis.lof</samp>.
+</p>
+<div class="example">
+<pre class="example">\contentsline {figure}{\numberline {1.1}{\ignorespaces Test}}{6}
+</pre></div>
+
+<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.
+</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
+<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.
+</p>
+
+
+<hr>
<span id="g_t_005cnofiles"></span><div class="header">
<p>
-Previous: <a href="#g_t_005caddtocontents" accesskey="p" rel="prev">\addtocontents</a>, Up: <a href="#Table-of-contents-etc_002e" accesskey="u" rel="up">Table of contents etc.</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+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.3 <code>\nofiles</code></h4>
+<span id="g_t_005cnofiles-1"></span><h4 class="subsection">25.1.4 <code>\nofiles</code></h4>
<span id="index-_005cnofiles"></span>
@@ -24586,13 +24664,16 @@
<tr><td></td><td valign="top"><a href="#index-_002eisty-file"><samp>.isty</samp> file</a>:</td><td> </td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002elof-file"><code>.lof <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002elof-file-1"><code>.lof <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002elof-file-2"><code>.lof <span class="roman">file</span></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-_002elog-file"><code>.log <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002elot-file"><code>.lot <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002elot-file-1"><code>.lot <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002elot-file-2"><code>.lot <span class="roman">file</span></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-_002epdf-file"><code>.pdf <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002etex_002c-default-extension"><code>.tex, <span class="roman">default extension</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-interface">Command line interface</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002etoc-file"><code>.toc <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002etoc-file-1"><code>.toc <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002etoc-file-2"><code>.toc <span class="roman">file</span></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-_002exdv-file"><code>.xdv <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Index_cp_symbol-6">/</th><td></td><td></td></tr>
@@ -24785,6 +24866,7 @@
<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-_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>
@@ -24995,6 +25077,9 @@
<tr><td></td><td valign="top"><a href="#index-_005ckill"><code>\kill</code></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cl-_0028l_0029"><code>\l (ł)</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-_005cL-_0028L_0029"><code>\L (Ł)</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-_005cl_0040chapter"><code>\l at chapter</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-_005cl_0040section"><code>\l at section</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-_005cl_0040subsection"><code>\l at subsection</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-_005clabel"><code>\label</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005clabel">\label</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005clabelenumi"><code>\labelenumi</code></a>:</td><td> </td><td valign="top"><a href="#enumerate">enumerate</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005clabelenumii"><code>\labelenumii</code></a>:</td><td> </td><td valign="top"><a href="#enumerate">enumerate</a></td></tr>
@@ -25056,7 +25141,9 @@
<tr><td></td><td valign="top"><a href="#index-_005clinewidth"><code>\linewidth</code></a>:</td><td> </td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005clinewidth-1"><code>\linewidth</code></a>:</td><td> </td><td valign="top"><a href="#Page-layout-parameters">Page layout parameters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005clistoffigures"><code>\listoffigures</code></a>:</td><td> </td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005clistoffigures-1"><code>\listoffigures</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-_005clistoftables"><code>\listoftables</code></a>:</td><td> </td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005clistoftables-1"><code>\listoftables</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-_005clistparindent"><code>\listparindent</code></a>:</td><td> </td><td valign="top"><a href="#list">list</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cll"><code>\ll</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cln"><code>\ln</code></a>:</td><td> </td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
@@ -25393,6 +25480,7 @@
<tr><td></td><td valign="top"><a href="#index-_005ctabbingsep"><code>\tabbingsep</code></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctabcolsep"><code>\tabcolsep</code></a>:</td><td> </td><td valign="top"><a href="#tabular">tabular</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctableofcontents"><code>\tableofcontents</code></a>:</td><td> </td><td valign="top"><a href="#Table-of-contents-etc_002e">Table of contents etc.</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005ctableofcontents-1"><code>\tableofcontents</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-_005ctan"><code>\tan</code></a>:</td><td> </td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctanh"><code>\tanh</code></a>:</td><td> </td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctau"><code>\tau</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -26810,6 +26898,7 @@
<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-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>
Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info 2021-06-09 12:41:18 UTC (rev 924)
+++ trunk/latex2e.info 2021-06-11 14:07:09 UTC (rev 925)
@@ -8949,7 +8949,7 @@
Finally, division and scaling take place with rounding (unlike TeX's
'\divide', which truncates). Thus '\the\dimexpr5pt*(3/2)\relax' puts
'10.0pt' in the document, because it rounds '3/2' to '2', while
-'\the\dimexpr5pt*(4/3)\relax' puts '5.0pt'.
+'\the\dimexpr5pt*(4/3)\relax' produces '5.0pt'.
File: latex2e.info, Node: Making paragraphs, Next: Math formulas, Prev: Lengths, Up: Top
@@ -11166,7 +11166,7 @@
'$\sqrt{x\mathstrut} + \sqrt{x^i\mathstrut}$'.
The '\mathstrut' command adds the vertical height of an open
-parenthesis, '(' but no horizontal space. It is defined as
+parenthesis, '(', but no horizontal space. It is defined as
'\vphantom{(}', so see *note \phantom & \vphantom & \hphantom:: for
more. An advantage over '\strut' is that '\mathstrut' adds no depth,
which is often the right thing for formulas. Using the height of an
@@ -15049,6 +15049,7 @@
* \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.
* \nofiles:: Prevent writing to auxiliary files.
@@ -15130,7 +15131,7 @@
will not make sense.
-File: latex2e.info, Node: \addtocontents, Next: \nofiles, Prev: \addcontentsline, Up: Table of contents etc.
+File: latex2e.info, Node: \addtocontents, Next: \contentsline, Prev: \addcontentsline, Up: Table of contents etc.
25.1.2 '\addtocontents'
-----------------------
@@ -15173,9 +15174,59 @@
'\addtocontents' into the file being included.
-File: latex2e.info, Node: \nofiles, Prev: \addtocontents, Up: Table of contents etc.
+File: latex2e.info, Node: \contentsline, Next: \nofiles, Prev: \addtocontents, Up: Table of contents etc.
-25.1.3 '\nofiles'
+25.1.3 '\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. 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
+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
+command '\chapter{Chapter One}' produces something like this in the file
+'thesis.toc'.
+
+ \contentsline {chapter}{\numberline {1}Chapter One}{3}
+
+ If the file contains the declaration '\listoffigures' then a figure
+environment involving '\caption{Test}' will produce something like this
+in 'thesis.lof'.
+
+ \contentsline {figure}{\numberline {1.1}{\ignorespaces Test}}{6}
+
+ 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.
+
+ 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
+has an extra }'. Fix this error by deleting the '.toc' or '.lof' or
+'.lot' file, and running LaTeX again.
+
+
+File: latex2e.info, Node: \nofiles, Prev: \contentsline, Up: Table of contents etc.
+
+25.1.4 '\nofiles'
-----------------
Synopsis:
@@ -17039,16 +17090,19 @@
* .lof file: Output files. (line 43)
* .lof file <1>: Table of contents etc..
(line 6)
+* .lof file <2>: \contentsline. (line 6)
* .log file: Output files. (line 28)
* .lot file: Output files. (line 43)
* .lot file <1>: Table of contents etc..
(line 6)
+* .lot file <2>: \contentsline. (line 6)
* .pdf file: Output files. (line 20)
* .tex, default extension: Command line interface.
(line 18)
* .toc file: Output files. (line 43)
* .toc file <1>: Table of contents etc..
(line 6)
+* .toc file <2>: \contentsline. (line 6)
* .xdv file: TeX engines. (line 42)
* /bin/sh, used by \write18: \write18. (line 60)
* 10pt option: Document class options.
@@ -17276,6 +17330,7 @@
* \complement: Math symbols. (line 132)
* \cong: Math symbols. (line 138)
* \contentsline: \addcontentsline. (line 10)
+* \contentsline <1>: \contentsline. (line 6)
* \coprod: Math symbols. (line 141)
* \copyright: Text symbols. (line 13)
* \cos: Math functions. (line 24)
@@ -17541,6 +17596,9 @@
(line 36)
* \L (Ł): Additional Latin letters.
(line 36)
+* \l at chapter: \contentsline. (line 6)
+* \l at section: \contentsline. (line 6)
+* \l at subsection: \contentsline. (line 6)
* \label: \label. (line 6)
* \labelenumi: enumerate. (line 56)
* \labelenumii: enumerate. (line 56)
@@ -17611,8 +17669,10 @@
(line 34)
* \listoffigures: Table of contents etc..
(line 6)
+* \listoffigures <1>: \contentsline. (line 6)
* \listoftables: Table of contents etc..
(line 6)
+* \listoftables <1>: \contentsline. (line 6)
* \listparindent: list. (line 142)
* \ll: Math symbols. (line 361)
* \ln: Math functions. (line 75)
@@ -18031,6 +18091,7 @@
* \tabcolsep: tabular. (line 172)
* \tableofcontents: Table of contents etc..
(line 6)
+* \tableofcontents <1>: \contentsline. (line 6)
* \tan: Math functions. (line 105)
* \tanh: Math functions. (line 108)
* \tau: Math symbols. (line 719)
@@ -19663,6 +19724,7 @@
* 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 entry, manually adding: \addcontentsline. (line 6)
* table of contents file: Output files. (line 43)
* table of contents, avoiding footnotes: Footnotes in section headings.
@@ -20130,241 +20192,242 @@
Node: \settoheight336893
Node: \settowidth337786
Node: Expressions338674
-Node: Making paragraphs343443
-Node: \par345214
-Node: \indent & \noindent347161
-Node: \parindent & \parskip348696
-Node: Marginal notes350003
-Ref: marginal notes marginparpush351399
-Ref: marginal notes marginparsep351573
-Ref: marginal notes marginparwidth351705
-Node: Math formulas352054
-Node: Subscripts & superscripts356222
-Node: Math symbols358383
-Node: Arrows382154
-Node: \boldmath & \unboldmath383342
-Node: Blackboard bold384861
-Node: Calligraphic385663
-Node: Delimiters386194
-Node: \left & \right388382
-Node: \bigl & \bigr etc.392390
-Node: Dots395143
-Ref: ellipses cdots395574
-Ref: ellipses ddots395719
-Ref: ellipses ldots395800
-Ref: ellipses vdots396217
-Node: Greek letters397401
-Node: Math functions399080
-Node: Math accents400724
-Node: Over- and Underlining401623
-Node: Spacing in math mode403450
-Ref: spacing in math mode thickspace404385
-Ref: spacing in math mode medspace404810
-Ref: Spacing in math mode/\thinspace405237
-Ref: spacing in math mode thinspace405237
-Ref: spacing in math mode negthinspace405718
-Ref: spacing in math mode quad406045
-Ref: spacing in math mode qquad406301
-Node: \smash406639
-Node: \phantom & \vphantom & \hphantom408856
-Node: \mathstrut411403
-Node: Math miscellany412364
-Node: Colon character & \colon412870
-Node: \*413563
-Node: \frac414143
-Node: \sqrt414514
-Node: \stackrel415100
-Node: Modes415373
-Ref: modes paragraph mode415823
-Ref: modes lr mode416019
-Ref: modes math mode416625
-Ref: modes vertical mode416960
-Ref: modes internal vertical mode417131
-Ref: modes inner paragraph mode417604
-Ref: modes outer paragraph mode417604
-Node: \ensuremath418018
-Node: Page styles418723
-Node: \maketitle419486
-Node: \pagenumbering422504
-Node: \pagestyle424492
-Node: \thispagestyle427994
-Node: Spaces428948
-Node: \enspace & \quad & \qquad430389
-Node: \hspace431304
-Node: \hfill433142
-Node: \hss434206
-Node: \spacefactor434900
-Node: \@438287
-Ref: \AT438387
-Node: \frenchspacing440327
-Node: \normalsfcodes441162
-Node: \(SPACE)441409
-Node: ~443199
-Node: \thinspace & \negthinspace445776
-Node: \/446947
-Node: \hrulefill & \dotfill448903
-Node: \bigskip & \medskip & \smallskip450259
-Ref: bigskip451077
-Ref: medskip451281
-Ref: smallskip451490
-Node: \bigbreak & \medbreak & \smallbreak452151
-Node: \strut453137
-Node: \vspace456332
-Node: \vfill457896
-Node: \addvspace458824
-Node: Boxes460820
-Node: \mbox & \makebox461526
-Ref: mbox makebox depth462794
-Ref: mbox makebox height462794
-Ref: mbox makebox width462794
-Ref: mbox makebox totalheight462794
-Node: \fbox & \framebox464889
-Ref: fbox framebox fboxrule466203
-Ref: fbox framebox fboxsep466393
-Node: \parbox467483
-Node: \raisebox469789
-Ref: raisebox depth470762
-Ref: raisebox height470762
-Ref: raisebox width470762
-Ref: raisebox totalheight470762
-Node: \sbox & \savebox471463
-Node: lrbox474525
-Node: \usebox475411
-Node: Color475850
-Node: Color package options476649
-Node: Color models478295
-Ref: color models cmyk479092
-Ref: color models gray479455
-Ref: color models rgb479604
-Ref: color models RGB479941
-Ref: color models named480316
-Node: Commands for color480604
-Node: Define colors481019
-Node: Colored text481744
-Node: Colored boxes484141
-Node: Colored pages485530
-Node: Graphics486223
-Node: Graphics package options488350
-Node: Graphics package configuration491103
-Node: \graphicspath491905
-Node: \DeclareGraphicsExtensions494863
-Node: \DeclareGraphicsRule496681
-Node: Commands for graphics499862
-Node: \includegraphics500367
-Ref: includegraphics width505421
-Ref: includegraphics height505954
-Ref: includegraphics totalheight506360
-Ref: includegraphics keepaspectratio506624
-Ref: includegraphics viewport508310
-Ref: includegraphics trim508705
-Ref: includegraphics clip509161
-Ref: includegraphics page509421
-Ref: includegraphics pagebox509512
-Ref: includegraphics interpolate510377
-Ref: includegraphics quiet510582
-Ref: includegraphics draft510743
-Ref: includegraphics bb511548
-Ref: includegraphics bbllx511946
-Ref: includegraphics bblly511946
-Ref: includegraphics bburx511946
-Ref: includegraphics bbury511946
-Ref: includegraphics natwidth512088
-Ref: includegraphics natheight512088
-Ref: includegraphics hiresbb512274
-Ref: includegraphics type513036
-Ref: includegraphics ext513076
-Ref: includegraphics read513179
-Ref: includegraphics command513296
-Node: \rotatebox513542
-Node: \scalebox516396
-Node: \resizebox517452
-Node: Special insertions518644
-Node: Reserved characters519512
-Node: Upper and lower case520772
-Node: Symbols by font position523158
-Node: Text symbols523837
-Node: Accents528821
-Node: \accent530974
-Node: Additional Latin letters532736
-Ref: Non-English characters532918
-Node: inputenc package533937
-Node: \rule536487
-Node: \today537652
-Node: Splitting the input538588
-Node: \endinput540330
-Node: \include & \includeonly541633
-Node: \input545930
-Node: Front/back matter547145
-Node: Table of contents etc.547478
-Node: \addcontentsline551303
-Node: \addtocontents554145
-Node: \nofiles555736
-Node: Indexes556468
-Node: \index558076
-Node: makeindex563181
-Ref: makeindex preamble564849
-Ref: makeindex postamble564989
-Ref: makeindex group skip565074
-Ref: makeindex letheadflag565407
-Ref: makeindex lethead prefix565868
-Ref: makeindex lethead suffix566020
-Ref: makeindex item 0566168
-Ref: makeindex item 1566248
-Ref: makeindex item 2566323
-Ref: makeindex item 01566401
-Ref: makeindex item x1566506
-Ref: makeindex item 12566711
-Ref: makeindex item x2566819
-Ref: makeindex delim 0566979
-Ref: makeindex delim 1567109
-Ref: makeindex delim 2567239
-Ref: makeindex delim n567365
-Ref: makeindex delim r567500
-Ref: makeindex line max567608
-Ref: makeindex indent space567743
-Ref: makeindex indent length567838
-Ref: makeindex page precedence568023
-Node: \printindex568897
-Node: Glossaries569370
-Node: \newglossaryentry571337
-Node: \gls572804
-Node: Letters573598
-Node: \address577216
-Node: \cc578027
-Node: \closing578469
-Node: \encl578783
-Node: \location579197
-Node: \makelabels579461
-Node: \name581778
-Node: \opening582019
-Node: \ps582300
-Node: \signature582589
-Node: \telephone583817
-Node: Input/output584182
-Node: \openin & \openout584912
-Node: \read587655
-Node: \typein588842
-Node: \typeout590102
-Node: \write591152
-Node: \write and security595879
-Node: \message596823
-Node: \wlog598652
-Node: \write18599153
-Node: Command line interface602644
-Ref: Command line602808
-Node: Command line options604891
-Ref: interaction modes605887
-Ref: output directory606841
-Node: Command line input608540
-Node: Jobname610369
-Node: Recovering from errors613650
-Node: Document templates614995
-Node: beamer template615429
-Node: article template616071
-Node: book template616534
-Node: Larger book template617013
-Node: Index618555
-Ref: Command Index618641
+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: \addcontentsline551388
+Node: \addtocontents554230
+Node: \contentsline555826
+Node: \nofiles557909
+Node: Indexes558640
+Node: \index560248
+Node: makeindex565353
+Ref: makeindex preamble567021
+Ref: makeindex postamble567161
+Ref: makeindex group skip567246
+Ref: makeindex letheadflag567579
+Ref: makeindex lethead prefix568040
+Ref: makeindex lethead suffix568192
+Ref: makeindex item 0568340
+Ref: makeindex item 1568420
+Ref: makeindex item 2568495
+Ref: makeindex item 01568573
+Ref: makeindex item x1568678
+Ref: makeindex item 12568883
+Ref: makeindex item x2568991
+Ref: makeindex delim 0569151
+Ref: makeindex delim 1569281
+Ref: makeindex delim 2569411
+Ref: makeindex delim n569537
+Ref: makeindex delim r569672
+Ref: makeindex line max569780
+Ref: makeindex indent space569915
+Ref: makeindex indent length570010
+Ref: makeindex page precedence570195
+Node: \printindex571069
+Node: Glossaries571542
+Node: \newglossaryentry573509
+Node: \gls574976
+Node: Letters575770
+Node: \address579388
+Node: \cc580199
+Node: \closing580641
+Node: \encl580955
+Node: \location581369
+Node: \makelabels581633
+Node: \name583950
+Node: \opening584191
+Node: \ps584472
+Node: \signature584761
+Node: \telephone585989
+Node: Input/output586354
+Node: \openin & \openout587084
+Node: \read589827
+Node: \typein591014
+Node: \typeout592274
+Node: \write593324
+Node: \write and security598051
+Node: \message598995
+Node: \wlog600824
+Node: \write18601325
+Node: Command line interface604816
+Ref: Command line604980
+Node: Command line options607063
+Ref: interaction modes608059
+Ref: output directory609013
+Node: Command line input610712
+Node: Jobname612541
+Node: Recovering from errors615822
+Node: Document templates617167
+Node: beamer template617601
+Node: article template618243
+Node: book template618706
+Node: Larger book template619185
+Node: Index620727
+Ref: Command Index620813
End Tag Table
Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2021-06-09 12:41:18 UTC (rev 924)
+++ trunk/latex2e.texi 2021-06-11 14:07:09 UTC (rev 925)
@@ -26,7 +26,8 @@
@c xx JH something on code listings
@c xx JH ligatures
@c xx JH \stretch
- at c xx JH \contentsline, \@@dottedtocline?
+ at c xx JH \@@dottedtocline?
+ at c xx JH \caption, \numberline, \ignorespaces
@c
@c xx The typeset source2e has an index with all kernel
@c xx commands, though some are internal and shouldn't be included.
@@ -14067,7 +14068,7 @@
@code{$\sqrt@{x\mathstrut@} + \sqrt@{x^i\mathstrut@}$}.
The @code{\mathstrut} command adds the vertical height of an open
-parenthesis, @code{(} but no horizontal space. It is defined as
+parenthesis, @code{(}, but no horizontal space. It is defined as
@code{\vphantom@{(@}}, so see @ref{\phantom & \vphantom & \hphantom} for
more. An advantage over @code{\strut} is that @code{\mathstrut} adds no
depth, which is often the right thing for formulas. Using the height of
@@ -18976,6 +18977,7 @@
@menu
* \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.
* \nofiles:: Prevent writing to auxiliary files.
@end menu
@@ -19133,6 +19135,77 @@
move @code{\addtocontents} into the file being included.
+ at node \contentsline
+ at subsection @code{\contentsline}
+
+ at cindex Table of contents
+ at findex \contentsline
+ at findex \tableofcontents
+ at findex .toc @r{file}
+ at findex \listoffigures
+ at findex \listoftables
+ at findex .lof @r{file}
+ at findex .lot @r{file}
+ at findex \l@@chapter
+ at findex \l@@section
+ at findex \l@@subsection
+
+Synopsis:
+
+ at example
+\contentsline@{@var{unit}@}@{@var{text}@}@{@var{pagenumber}@}
+ at end example
+
+Used internally by @LaTeX{} to typeset an entry of the Table of
+Contents, List of Figures, or List of Tables. 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}
+or @code{\table} environment (@pxref{figure} and @pxref{table}). Thus,
+where the base file is @file{thesis.tex}, and contains the declaration
+ at code{\tableofcontents}, the command @code{\chapter@{Chapter One@}}
+produces something like this in the file @file{thesis.toc}.
+
+ at example
+\contentsline @{chapter@}@{\numberline @{1@}Chapter One@}@{3@}
+ at end example
+
+If the file contains the declaration @code{\listoffigures} then a figure
+environment involving @code{\caption@{Test@}} will produce
+something like this in @file{thesis.lof}.
+
+ at example
+\contentsline @{figure@}@{\numberline @{1.1@}@{\ignorespaces Test@}@}@{6@}
+ at end example
+
+To manually add material, use
+ at 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.
+
+For manipulating how the @code{\contentline} material is typeset, see
+the @file{tocloft} package.
+
+Note that the @code{hyperref} package changes the definition of
+ at code{\contentsline} (and @code{\addcontentsline}) to add more
+arguments, to make hyperlinks. Ths is the source of the error
+ at code{Argument of \contentsline has an extra @}}. Fix this error by
+deleting the @file{.toc} or @file{.lof} or @file{.lot} file, and running
+ at LaTeX{} again.
+
+
+
@node \nofiles
@subsection @code{\nofiles}
More information about the latexrefman-commits
mailing list.