[latexrefman-commits] [SCM] latexrefman updated: r926 - trunk

Jim Hefferon INVALID.NOREPLY at gnu.org.ua
Sat Jun 12 17:11:37 CEST 2021


Author: jimhefferon
Date: 2021-06-12 15:11:36 +0000 (Sat, 12 Jun 2021)
New Revision: 926

Modified:
   trunk/ChangeLog
   trunk/latex2e.html
   trunk/latex2e.info
   trunk/latex2e.pdf
   trunk/latex2e.texi
Log:
Add section on \numberline

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2021-06-11 14:07:09 UTC (rev 925)
+++ trunk/ChangeLog	2021-06-12 15:11:36 UTC (rev 926)
@@ -1,3 +1,7 @@
+2021-06-12  Jim Hefferon  <jim at joshua.smcvt.edu>
+
+	* latex2e.texi (Expressions): Add section on \numberline.
+
 2021-06-11  Jim Hefferon  <jim at joshua.smcvt.edu>
 
 	* latex2e.texi (Expressions): Add section on \contentsline.

Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html	2021-06-11 14:07:09 UTC (rev 925)
+++ trunk/latex2e.html	2021-06-12 15:11:36 UTC (rev 926)
@@ -536,6 +536,7 @@
       <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>
     </ul></li>
     <li><a id="toc-Indexes-1" href="#Indexes">25.2 Indexes</a>
     <ul class="no-bullet">
@@ -21760,7 +21761,7 @@
 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.
+the page number on which the sectioning units start (see <a href="#g_t_005ccontentsline">\contentsline</a>).
 </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
@@ -21813,6 +21814,8 @@
 </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>
+<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.
+</td></tr>
 </table>
 
 
@@ -21834,7 +21837,7 @@
 
 <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
+one of: <code>toc</code> for the table of contents, <code>lof</code> for the list of
 figures, or <code>lot</code> for the list of tables.
 </p>
 <p>The following will result in an ‘<samp>Appendices</samp>’ line in the table of
@@ -21852,9 +21855,9 @@
 <samp><var>root-name</var>.<var>ext</var></samp>.  It writes that information as the
 text of the command
 <code>\contentsline{<var>unit</var>}{<var>text</var>}{<var>num</var>}</code>, where
-<code><var>num</var></code> is the current value of counter <code><var>unit</var></code>.  The
-most common case is the table of contents and there <var>num</var> is the
-page number of the first page of <var>unit</var>.
+<code><var>num</var></code> is the current value of counter <code><var>unit</var></code>
+(see <a href="#g_t_005ccontentsline">\contentsline</a>).  The most common case is the table of contents
+and there <var>num</var> is the page number of the first page of <var>unit</var>.
 </p>
 <p>This command is invoked by the sectioning commands <code>\chapter</code>,
 etc., and also by <code>\caption</code> inside a float environment.  But it is
@@ -22007,8 +22010,7 @@
 </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.
+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
@@ -22055,11 +22057,10 @@
 LaTeX again.
 </p>
 
-
 <hr>
 <span id="g_t_005cnofiles"></span><div class="header">
 <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>
+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>
 
@@ -22094,6 +22095,41 @@
 </p>
 
 <hr>
+<span id="g_t_005cnumberline"></span><div class="header">
+<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="index-_005cnumberline"></span>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\numberline{<var>number</var>}
+</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>).
+</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></div>
+
+<p>This command is fragile, so you may need to preceed it with
+<code>\protect</code> (see <a href="#g_t_005cprotect">\protect</a>).  An example is the use of
+<code>\protect</code> in the command
+<code>\addcontentsline{toc}{section}{\protect\numberline{}Summary}</code>
+to get the <code>\numberline</code> into this command in the <samp>.toc</samp> file:
+<code>\contentsline {section}{\numberline {}Summary}{6}</code> (the
+page number ‘<samp>6</samp>’ is automatically added by LaTeX;
+see <a href="#g_t_005caddcontentsline">\addcontentsline</a>).
+</p>
+
+<hr>
 <span id="Indexes"></span><div class="header">
 <p>
 Next: <a href="#Glossaries" accesskey="n" rel="next">Glossaries</a>, Previous: <a href="#Table-of-contents-etc_002e" accesskey="p" rel="prev">Table of contents etc.</a>, Up: <a href="#Front_002fback-matter" accesskey="u" rel="up">Front/back matter</a>   [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
@@ -25255,6 +25291,7 @@
 <tr><td></td><td valign="top"><a href="#index-_005cnot"><code>\not</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-_005cnotin"><code>\notin</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-_005cnu"><code>\nu</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-_005cnumberline"><code>\numberline</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cnumberline">\numberline</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-_005cnwarrow"><code>\nwarrow</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-_005co-_0028o_0029"><code>\o (ø)</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-_005cO-_0028O_0029"><code>\O (Ø)</code></a>:</td><td> </td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>

Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info	2021-06-11 14:07:09 UTC (rev 925)
+++ trunk/latex2e.info	2021-06-12 15:11:36 UTC (rev 926)
@@ -15014,7 +15014,7 @@
 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.
+sectioning units start (*note \contentsline::).
 
    One consequence of this auxiliary file storage strategy is that to
 get the contents page correct you must run LaTeX twice, once to store
@@ -15051,6 +15051,7 @@
 * \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.
+* \numberline::         Put its number argument flush left in a box.
 
 
 File: latex2e.info,  Node: \addcontentsline,  Next: \addtocontents,  Up: Table of contents etc.
@@ -15062,9 +15063,9 @@
 
      \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 file specified by EXT.  Usually EXT is one
+of: 'toc' for the table of contents, 'lof' for the list of figures, or
+'lot' for the list of tables.
 
    The following will result in an 'Appendices' line in the table of
 contents.
@@ -15078,8 +15079,9 @@
    The '\addcontentsline' command writes information to the file
 'ROOT-NAME.EXT'.  It writes that information as the text of the command
 '\contentsline{UNIT}{TEXT}{NUM}', where 'NUM' is the current value of
-counter 'UNIT'.  The most common case is the table of contents and there
-NUM is the page number of the first page of UNIT.
+counter 'UNIT' (*note \contentsline::).  The most common case is the
+table of contents and there NUM is the page number of the first page of
+UNIT.
 
    This command is invoked by the sectioning commands '\chapter', etc.,
 and also by '\caption' inside a float environment.  But it is also used
@@ -15184,8 +15186,8 @@
      \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.
+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
@@ -15224,7 +15226,7 @@
 '.lot' file, and running LaTeX again.
 
 
-File: latex2e.info,  Node: \nofiles,  Prev: \contentsline,  Up: Table of contents etc.
+File: latex2e.info,  Node: \nofiles,  Next: \numberline,  Prev: \contentsline,  Up: Table of contents etc.
 
 25.1.4 '\nofiles'
 -----------------
@@ -15252,6 +15254,32 @@
 the table of contents page will continue to show the old information.
 
 
+File: latex2e.info,  Node: \numberline,  Prev: \nofiles,  Up: Table of contents etc.
+
+25.1.5 '\numberline'
+--------------------
+
+Synopsis:
+
+     \numberline{NUMBER}
+
+   Typeset its argument flush left in a box.  This is used in a
+'\contentsline' command (*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}
+
+   This command is fragile, so you may need to preceed it with
+'\protect' (*note \protect::).  An example is the use of '\protect' in
+the command
+'\addcontentsline{toc}{section}{\protect\numberline{}Summary}' to get
+the '\numberline' into this command in the '.toc' file: '\contentsline
+{section}{\numberline {}Summary}{6}' (the page number '6' is
+automatically added by LaTeX; *note \addcontentsline::).
+
+
 File: latex2e.info,  Node: Indexes,  Next: Glossaries,  Prev: Table of contents etc.,  Up: Front/back matter
 
 25.2 Indexes
@@ -17809,6 +17837,7 @@
 * \not:                                  Math symbols.        (line 444)
 * \notin:                                Math symbols.        (line 452)
 * \nu:                                   Math symbols.        (line 456)
+* \numberline:                           \numberline.         (line   6)
 * \nwarrow:                              Math symbols.        (line 459)
 * \o (ø):                                Additional Latin letters.
                                                               (line  44)
@@ -20358,76 +20387,77 @@
 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
+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
 
 End Tag Table
 

Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2021-06-11 14:07:09 UTC (rev 925)
+++ trunk/latex2e.texi	2021-06-12 15:11:36 UTC (rev 926)
@@ -27,7 +27,7 @@
 @c xx JH ligatures
 @c xx JH \stretch
 @c xx JH \@@dottedtocline?
- at c xx JH \caption, \numberline, \ignorespaces
+ at c xx JH \caption, \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.
@@ -18937,7 +18937,7 @@
 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.
+the page number on which the sectioning units start (@pxref{\contentsline}).
 
 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
@@ -18979,6 +18979,7 @@
 * \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.
+* \numberline::         Put its number argument flush left in a box.
 @end menu
 
 
@@ -18996,7 +18997,7 @@
 
 @findex \contentsline
 Add an entry to the file specified by @var{ext}.  Usually @var{ext} is
-one of @code{toc} for the table of contents, @code{lof} for the list of
+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.
 
 The following will result in an @samp{Appendices} line in the table of
@@ -19015,9 +19016,9 @@
 @file{@var{root-name}. at var{ext}}.  It writes that information as the
 text of the command
 @code{\contentsline@{@var{unit}@}@{@var{text}@}@{@var{num}@}}, where
- at code{@var{num}} is the current value of counter @code{@var{unit}}.  The
-most common case is the table of contents and there @var{num} is the
-page number of the first page of @var{unit}.
+ at code{@var{num}} is the current value of counter @code{@var{unit}}
+(@pxref{\contentsline}).  The most common case is the table of contents
+and there @var{num} is the page number of the first page of @var{unit}.
 
 This command is invoked by the sectioning commands @code{\chapter},
 etc., and also by @code{\caption} inside a float environment.  But it is
@@ -19157,8 +19158,8 @@
 @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.
+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
@@ -19205,7 +19206,6 @@
 @LaTeX{} again.
 
 
-
 @node \nofiles
 @subsection @code{\nofiles}
 
@@ -19240,6 +19240,37 @@
 the old information.
 
 
+ at node \numberline
+ at subsection @code{\numberline}
+
+ at findex \numberline
+
+Synopsis:
+
+ at example
+\numberline@{@var{number}@}
+ at end example
+
+Typeset its argument flush left in a box.  This is used in a
+ at code{\contentsline} command (@pxref{\contentsline}).
+
+For example, this line in a @file{.toc} file causes the @code{1} to be
+typeset flush left.
+
+ at example
+\contentsline @{section@}@{\numberline @{1@}First section@}@{2@}
+ at end example
+
+This command is fragile, so you may need to preceed it with
+ at code{\protect} (@pxref{\protect}).  An example is the use of
+ at code{\protect} in the command
+ at code{\addcontentsline@{toc@}@{section@}@{\protect\numberline@{@}Summary@}}
+to get the @code{\numberline} into this command in the @file{.toc} file:
+ at code{\contentsline @{section@}@{\numberline @{@}Summary@}@{6@}} (the
+page number @samp{6} is automatically added by @LaTeX{};
+ at pxref{\addcontentsline}).
+
+
 @node Indexes
 @section Indexes
 



More information about the latexrefman-commits mailing list.