[latexrefman-commits] [SCM] latexrefman updated: r621 - trunk
jimhefferon at gnu.org.ua
jimhefferon at gnu.org.ua
Fri May 18 20:08:28 CEST 2018
Author: jimhefferon
Date: 2018-05-18 21:08:28 +0300 (Fri, 18 May 2018)
New Revision: 621
Modified:
trunk/ChangeLog
trunk/latex2e.html
trunk/latex2e.info
trunk/latex2e.pdf
trunk/latex2e.texi
Log:
Start working through CTAN package latex-info as called for in xx list in doc top
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2018-05-17 21:43:30 UTC (rev 620)
+++ trunk/ChangeLog 2018-05-18 18:08:28 UTC (rev 621)
@@ -1,5 +1,12 @@
2018-05-17 Jim Hefferon <jhefferon at smcvt.edu>
-
+
+ * latex2e.texi Going through http://ctan.org/pkg/latex-info
+ (CTAN package latex-info), making sure this doc has everything
+ the older one has. So far, Counters done. Also adjust wording
+ as it arises.
+
+2018-05-17 Jim Hefferon <jhefferon at smcvt.edu>
+
* latex2e.texi (\include & \incluldeonly) Combine the two. Include
discussion of many edge cases, with examples.
(Splitting the input) Add typical case example.
Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html 2018-05-17 21:43:30 UTC (rev 620)
+++ trunk/latex2e.html 2018-05-18 18:08:28 UTC (rev 621)
@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This document is an unofficial reference manual for LaTeX, a
-document preparation system, version of March 2018.
+document preparation system, version of May 2018.
This manual was originally translated from LATEX.HLP v1.0a in
the VMS Help Library. The pre-translation version was written by
@@ -37,10 +37,10 @@
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<title>LaTeX2e unofficial reference manual (March 2018)</title>
+<title>LaTeX2e unofficial reference manual (May 2018)</title>
-<meta name="description" content="LaTeX2e unofficial reference manual (March 2018)">
-<meta name="keywords" content="LaTeX2e unofficial reference manual (March 2018)">
+<meta name="description" content="LaTeX2e unofficial reference manual (May 2018)">
+<meta name="keywords" content="LaTeX2e unofficial reference manual (May 2018)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
@@ -81,7 +81,7 @@
</head>
<body lang="en">
-<h1 class="settitle" align="center">LaTeX2e unofficial reference manual (March 2018)</h1>
+<h1 class="settitle" align="center">LaTeX2e unofficial reference manual (May 2018)</h1>
@@ -487,7 +487,7 @@
<h1 class="top">LaTeX2e: An unofficial reference manual</h1>
<p>This document is an unofficial reference manual (version of
-March 2018) for LaTeX2e, a document preparation system.
+May 2018) for LaTeX2e, a document preparation system.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#About-this-document" accesskey="1">About this document</a>:</td><td> </td><td align="left" valign="top">Bug reporting, etc.
@@ -1239,9 +1239,9 @@
<a name="index-class-options"></a>
<a name="index-global-options"></a>
-<p>You can specify so-called <em>global options</em> or <em>class options</em> to
-the <code>\documentclass</code> command by enclosing them in square brackets.
-To specify more than one <var>option</var>, separate them with a comma, as in:
+<p>You can specify <em>global options</em> or <em>class options</em> to the
+<code>\documentclass</code> command by enclosing them in square brackets. To
+specify more than one <var>option</var>, separate them with a comma.
</p>
<div class="example">
<pre class="example">\documentclass[<var>option1</var>,<var>option2</var>,...]{<var>class</var>}
@@ -5262,6 +5262,7 @@
<p>This example has the labels in red. They are numbered, and the left
edge of the label lines up with the left edge of the item text.
+See <a href="#g_t_005cusecounter">\usecounter</a>.
</p>
<div class="example">
<pre class="example">\usepackage{color}
@@ -8208,18 +8209,22 @@
<p>Globally defines a new counter named <var>countername</var> and initialize
the new counter to zero.
</p>
-<p>The name <var>countername</var> must consists of letters only, and does not
+<p>The name <var>countername</var> must consist of letters only. It does not
begin with a backslash. This name must not already be in use by another
counter.
</p>
<p>When you use the optional argument <code>[<var>supercounter</var>]</code> then
-<var>countername</var> will be numbered within, or subsidiary to, the
-existing counter <var>supercounter</var>. For example, ordinarily
+<var>countername</var> the counter foo will be reset whenever the counter
+<var>supercounter</var> is incremented. For example, ordinarily
<code>subsection</code> is numbered within <code>section</code> so that any time
-<var>supercounter</var> is incremented with <code>\stepcounter</code>
+<var>supercounter</var> is incremented, either with <code>\stepcounter</code>
(see <a href="#g_t_005cstepcounter">\stepcounter</a>) or <code>\refstepcounter</code>
-(see <a href="#g_t_005crefstepcounter">\refstepcounter</a>) then <var>countername</var> is reset to zero.
+(see <a href="#g_t_005crefstepcounter">\refstepcounter</a>), then <var>countername</var> is reset to zero.
</p>
+<p>The super counter must already exist. If you enter
+<code>\newcounter{jh}[lh]</code> and <code>lh</code> is not a defined counter
+then you will get ‘<samp>LaTeX Error: No counter 'lh' defined.</samp>’
+</p>
<p>See <a href="#Counters">Counters</a>, for more information about counters.
</p>
@@ -8823,6 +8828,8 @@
through <code>enumiv</code> are used in the <code>enumerate</code> environment, for
up to four levels of nesting (see <a href="#enumerate">enumerate</a>).
</p>
+<p>Counters can have any integer value but they are typically positive.
+</p>
<p>New counters are created with <code>\newcounter</code>. See <a href="#g_t_005cnewcounter">\newcounter</a>.
</p>
@@ -8870,53 +8877,64 @@
<dt><code>\alph{<var>counter</var>}</code>
<a name="index-_005calph_007bcounter_007d"></a>
</dt>
-<dd><p>Print the value of <var>counter</var> in lowercase letters: ‘a’, ‘b’, <small class="enddots">...</small>
+<dd><p>Print the value of <var>counter</var> in lowercase letters: ‘a’, ‘b’,
+<small class="enddots">...</small> If the counter’s value is less than 1 or more than 26 then
+you get ‘<samp>LaTeX Error: Counter too large.</samp>’
</p>
</dd>
<dt><code>\Alph{<var>counter</var>}</code>
<a name="index-_005cAlph_007bcounter_007d"></a>
</dt>
-<dd><p>Print in uppercase letters: ‘A’, ‘B’, <small class="enddots">...</small>
+<dd><p>Print in uppercase letters: ‘A’, ‘B’, <small class="enddots">...</small> If the counter’s value
+is less than 1 or more than 26 then you get ‘<samp>LaTeX Error: Counter
+too large.</samp>’
</p>
</dd>
<dt><code>\arabic{<var>counter</var>}</code>
<a name="index-_005carabic_007bcounter_007d"></a>
</dt>
-<dd><p>Print in Arabic numbers: ‘1’, ‘2’, <small class="enddots">...</small>
+<dd><p>Print in Arabic numbers such as ‘<samp>5</samp>’ or ‘<samp>-2</samp>’.
</p>
</dd>
<dt><code>\roman{<var>counter</var>}</code>
<a name="index-_005croman_007bcounter_007d"></a>
</dt>
-<dd><p>Print in lowercase roman numerals: ‘i’, ‘ii’, <small class="enddots">...</small>
+<dd><p>Print in lowercase roman numerals: ‘i’, ‘ii’, <small class="enddots">...</small> If the
+counter’s value is less than 1 then you get no warning or error but
+LaTeX does not print anything in the output.
</p>
</dd>
<dt><code>\Roman{<var>counter</var>}</code>
<a name="index-_005cRoman_007bcounter_007d"></a>
</dt>
-<dd><p>Print in uppercase roman numerals: ‘I’, ‘II’, <small class="enddots">...</small>
+<dd><p>Print in uppercase roman numerals: ‘I’, ‘II’, <small class="enddots">...</small> If the
+counter’s value is less than 1 then you get no warning or error but
+LaTeX does not print anything in the output.
</p>
</dd>
<dt><code>\fnsymbol{<var>counter</var>}</code>
<a name="index-_005cfnsymbol_007bcounter_007d"></a>
</dt>
-<dd><p>Prints the value of <var>counter</var> in a specific sequence of nine
-symbols (conventionally used for labeling footnotes). The value of
-<var>counter</var> must be between 1 and 9, inclusive.
+<dd><p>Prints the value of <var>counter</var> in a specific sequence of nine symbols
+(conventionally used for labeling footnotes). The value of
+<var>counter</var> must be between 1 and 9, inclusive. If the
+counter’s value is less than 0 or more than 9 then you get ‘<samp>LaTeX
+Error: Counter too large</samp>’, while if it is 0 then you get no error or
+warning but LaTeX does not print anything in the output.
</p>
<p>Here are the symbols:
</p>
<table>
-<thead><tr><th width="33%">Name</th><th width="33%">Command</th><th width="33%">Equivalent Unicode symbol and/or numeric code point</th></tr></thead>
-<tr><td width="33%">asterisk</td><td width="33%"><code>\ast</code></td><td width="33%">*</td></tr>
-<tr><td width="33%">dagger</td><td width="33%"><code>\dagger</code></td><td width="33%">†</td></tr>
-<tr><td width="33%">ddagger</td><td width="33%"><code>\ddagger</code></td><td width="33%">‡</td></tr>
-<tr><td width="33%">section-sign</td><td width="33%"><code>\S</code></td><td width="33%">§</td></tr>
-<tr><td width="33%">paragraph-sign</td><td width="33%"><code>\P</code></td><td width="33%">¶</td></tr>
-<tr><td width="33%">double-vert</td><td width="33%"><code>\parallel</code></td><td width="33%">‖</td></tr>
-<tr><td width="33%">double-asterisk</td><td width="33%"><code>\ast\ast</code></td><td width="33%">**</td></tr>
-<tr><td width="33%">double-dagger</td><td width="33%"><code>\dagger\dagger</code></td><td width="33%">††</td></tr>
-<tr><td width="33%">double-ddagger</td><td width="33%"><code>\ddagger\ddagger</code></td><td width="33%">‡‡</td></tr>
+<thead><tr><th width="10%">Number</th><th width="30%">Name</th><th width="30%">Command</th><th width="30%">Equivalent Unicode symbol and/or numeric code point</th></tr></thead>
+<tr><td width="10%">1</td><td width="30%">asterisk</td><td width="30%"><code>\ast</code></td><td width="30%">*</td></tr>
+<tr><td width="10%">2</td><td width="30%">dagger</td><td width="30%"><code>\dagger</code></td><td width="30%">†</td></tr>
+<tr><td width="10%">3</td><td width="30%">ddagger</td><td width="30%"><code>\ddagger</code></td><td width="30%">‡</td></tr>
+<tr><td width="10%">4</td><td width="30%">section-sign</td><td width="30%"><code>\S</code></td><td width="30%">§</td></tr>
+<tr><td width="10%">5</td><td width="30%">paragraph-sign</td><td width="30%"><code>\P</code></td><td width="30%">¶</td></tr>
+<tr><td width="10%">6</td><td width="30%">double-vert</td><td width="30%"><code>\parallel</code></td><td width="30%">‖</td></tr>
+<tr><td width="10%">7</td><td width="30%">double-asterisk</td><td width="30%"><code>\ast\ast</code></td><td width="30%">**</td></tr>
+<tr><td width="10%">8</td><td width="30%">double-dagger</td><td width="30%"><code>\dagger\dagger</code></td><td width="30%">††</td></tr>
+<tr><td width="10%">9</td><td width="30%">double-ddagger</td><td width="30%"><code>\ddagger\ddagger</code></td><td width="30%">‡‡</td></tr>
</table>
</dd>
@@ -8942,15 +8960,16 @@
<pre class="example">\usecounter{<var>counter</var>}
</pre></div>
-<p>In the <code>list</code> environment, when used in the second argument, this
-command sets up <var>counter</var> to number the list items. It initializes
-<var>counter</var> to zero, and arranges that when <code>\item</code> is called
-without its optional argument then <var>counter</var> is incremented by
-<code>\refstepcounter</code>, making its value be the current <code>ref</code>
-value. This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
+<p>Used in the second argument of the <code>list</code> environment
+(see <a href="#list">list</a>). It sets up <var>counter</var> to number the list items. It
+initializes <var>counter</var> to zero, and arranges that when <code>\item</code>
+is called without its optional argument then <var>counter</var> is
+incremented by <code>\refstepcounter</code>, making its value be the current
+<code>ref</code> value (see <a href="#g_t_005cref">\ref</a>). This command is fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
</p>
-<p>Put in the preamble, this makes a new list environment enumerated with
-<var>testcounter</var>:
+<p>Put in the docuemnt preamble, this example makes a new list environment
+enumerated with <var>testcounter</var>:
</p>
<div class="example">
<pre class="example">\newcounter{testcounter}
@@ -8982,10 +9001,10 @@
<pre class="example">\value{<var>counter</var>}
</pre></div>
-<p>This command expands to the value of <var>counter</var>. It is often used
-in <code>\setcounter</code> or <code>\addtocounter</code>, but <code>\value</code> can
-be used anywhere that LaTeX expects a number. It must not be
-preceded by <code>\protect</code> (see <a href="#g_t_005cprotect">\protect</a>).
+<p>Expands to the value of <var>counter</var>. It is often used in
+<code>\setcounter</code> or <code>\addtocounter</code> but <code>\value</code> can be used
+anywhere that LaTeX expects a number. It must not be preceded by
+<code>\protect</code> (see <a href="#g_t_005cprotect">\protect</a>).
</p>
<p>The <code>\value</code> command is not used for typesetting the value of the
counter. See <a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a>.
@@ -9029,15 +9048,17 @@
<pre class="example">\setcounter{<var>counter</var>}{<var>value</var>}
</pre></div>
-<p>The <code>\setcounter</code> command globally sets the value of <var>counter</var>
-to the <var>value</var> argument. Note that the counter name does not start
-with a backslash.
+<p>Globally set the counter <var>counter</var> to have the value of the
+<var>value</var> argument. Thus, you can set a counter’s value as
+<code>\setcounter{section}{5}</code>. Note that the counter name does not
+start with a backslash.
</p>
-<p>In this example the section value appears as ‘<samp>V</samp>’.
+<p>In this example if the counter <code>theorem</code> has value 12 then the
+second line will print ‘<samp>XII</samp>’.
</p>
<div class="example">
-<pre class="example">\setcounter{section}{5}
-Here it is in Roman: \Roman{section}.
+<pre class="example">\setcounter{exercise}{\value{theorem}}
+Here it is in Roman: \Roman{exercise}.
</pre></div>
@@ -15560,7 +15581,7 @@
<pre class="example">\endinput
</pre></div>
-<p>When you <code>\include{file}</code>, inside <samp>filename.tex</samp> the
+<p>When you <code>\include{filename}</code>, inside <samp>filename.tex</samp> the
material after <code>\endinput</code> will not be included. This command is
optional; if <samp>filename.tex</samp> has no <code>\endinput</code> then LaTeX
will read all of the file.
@@ -15618,7 +15639,7 @@
</p>
<p>The <code>\include</code> command does three things: it executes
<code>\clearpage</code> (see <a href="#g_t_005cclearpage">\clearpage</a>), then it inputs the material from
-<samp>filename.tex</samp> into the document, and then it does another
+<samp><var>filename</var>.tex</samp> into the document, and then it does another
<code>\clearpage</code>. This command can only appear in the document body.
The <code>\includeonly</code> command controls which files will be read by
LaTeX under subsequent <code>\include</code> commands. Its list of
@@ -15648,7 +15669,7 @@
</p>
<div class="example">
<pre class="example">\chapter{Preamble}
-We the People of the United States, in Order to form a more perfect Union, …
+We the People of the United States, in Order to form a more perfect Union, ...
</pre></div>
<p>Running LaTeX on <samp>constitution.tex</samp> makes the material from the
@@ -15660,14 +15681,14 @@
and run LaTeX again then the resulting document shows only the
material from <samp>articles.tex</samp>, not the material from
<samp>preamble.tex</samp> or <samp>amendments.tex</samp>. Nonetheless, all of the
-auxillary information from the omitted files, including the starting
-page number of this chapter, is still there.
+auxillary information from the omitted files is still there, including
+the starting page number of the chapter.
</p>
<p>If the document preamble does not have <code>\includeonly</code> then
LaTeX will include all the files you call for with <code>\include</code>
commands.
</p>
-<p>The <code>\include</code> command makess a new page. To avoid that, see
+<p>The <code>\include</code> command makes a new page. To avoid that, see
<a href="#g_t_005cinput">\input</a> (which, however, does not retain the auxillary
information).
</p>
@@ -15684,9 +15705,9 @@
</pre></div>
<p>To make your document portable across distributions and platforms you
-should avoid spaces. The tradition is to instead use underscores in the
-file names. That said, for the filename ‘<samp><samp>amo amas amat</samp></samp>’,
-this works under TeX Live on Linux
+should avoid spaces in the file names. The tradition is to instead use
+underscores. That said, for the name ‘<samp><samp>amo amas amat</samp></samp>’, this
+works under TeX Live on Linux
</p>
<div class="example">
<pre class="example">\documentclass{book}
@@ -15712,9 +15733,9 @@
<a name="index-nested-_005cinclude_002c-not-allowed"></a>
<p>You cannot use <code>\include</code> inside a file that is being included or
-you get ‘<samp>! LaTeX Error: \include cannot be nested.</samp>’ The
+you get ‘<samp>LaTeX Error: \include cannot be nested.</samp>’ The
<code>\include</code> command cannot appear in the document preamble; you will
-get ‘<samp>! LaTeX Error: Missing \begin{document}.</samp>’.
+get ‘<samp>LaTeX Error: Missing \begin{document}.</samp>’.
</p>
<p>If a file that you <code>\include</code> does not exist, for instance if you
<code>\include{athiesm}</code> but you meant <code>\include{atheism}</code>,
@@ -15722,8 +15743,8 @@
athiesm.tex.</samp>’ (It will also create <samp>athiesm.aux</samp>.)
</p>
<p>If you <code>\include</code> the root file in itself then you first get
-‘<samp>! LaTeX Error: Can be used only in preamble.</samp>’ Later runs get
-‘<samp>! TeX capacity exceeded, sorry [text input levels=15]</samp>’. To fix
+‘<samp>LaTeX Error: Can be used only in preamble.</samp>’ Later runs get
+‘<samp>TeX capacity exceeded, sorry [text input levels=15]</samp>’. To fix
this, you must remove the inclusion <code>\include{root}</code> but also
delete the file <samp><var>root</var>.aux</samp> and rerun LaTeX.
</p>
Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info 2018-05-17 21:43:30 UTC (rev 620)
+++ trunk/latex2e.info 2018-05-18 18:08:28 UTC (rev 621)
@@ -2,7 +2,7 @@
latex2e.texi.
This document is an unofficial reference manual for LaTeX, a document
-preparation system, version of March 2018.
+preparation system, version of May 2018.
This manual was originally translated from 'LATEX.HLP' v1.0a in the
VMS Help Library. The pre-translation version was written by George D.
@@ -42,7 +42,7 @@
LaTeX2e: An unofficial reference manual
***************************************
-This document is an unofficial reference manual (version of March 2018)
+This document is an unofficial reference manual (version of May 2018)
for LaTeX2e, a document preparation system.
* Menu:
@@ -546,9 +546,9 @@
3.1 Document class options
==========================
-You can specify so-called "global options" or "class options" to the
+You can specify "global options" or "class options" to the
'\documentclass' command by enclosing them in square brackets. To
-specify more than one OPTION, separate them with a comma, as in:
+specify more than one OPTION, separate them with a comma.
\documentclass[OPTION1,OPTION2,...]{CLASS}
@@ -3372,7 +3372,8 @@
'-51').
This example has the labels in red. They are numbered, and the left
-edge of the label lines up with the left edge of the item text.
+edge of the label lines up with the left edge of the item text. *Note
+\usecounter::.
\usepackage{color}
\newcounter{cnt}
@@ -5399,17 +5400,21 @@
Globally defines a new counter named COUNTERNAME and initialize the
new counter to zero.
- The name COUNTERNAME must consists of letters only, and does not
-begin with a backslash. This name must not already be in use by another
+ The name COUNTERNAME must consist of letters only. It does not begin
+with a backslash. This name must not already be in use by another
counter.
When you use the optional argument '[SUPERCOUNTER]' then COUNTERNAME
-will be numbered within, or subsidiary to, the existing counter
-SUPERCOUNTER. For example, ordinarily 'subsection' is numbered within
-'section' so that any time SUPERCOUNTER is incremented with
+the counter foo will be reset whenever the counter SUPERCOUNTER is
+incremented. For example, ordinarily 'subsection' is numbered within
+'section' so that any time SUPERCOUNTER is incremented, either with
'\stepcounter' (*note \stepcounter::) or '\refstepcounter' (*note
-\refstepcounter::) then COUNTERNAME is reset to zero.
+\refstepcounter::), then COUNTERNAME is reset to zero.
+ The super counter must already exist. If you enter
+'\newcounter{jh}[lh]' and 'lh' is not a defined counter then you will
+get 'LaTeX Error: No counter 'lh' defined.'
+
*Note Counters::, for more information about counters.
@@ -5868,6 +5873,8 @@
are used in the 'enumerate' environment, for up to four levels of
nesting (*note enumerate::).
+ Counters can have any integer value but they are typically positive.
+
New counters are created with '\newcounter'. *Note \newcounter::.
* Menu:
@@ -5896,40 +5903,51 @@
with a backslash.
'\alph{COUNTER}'
- Print the value of COUNTER in lowercase letters: 'a', 'b', ...
+ Print the value of COUNTER in lowercase letters: 'a', 'b', ... If
+ the counter's value is less than 1 or more than 26 then you get
+ 'LaTeX Error: Counter too large.'
'\Alph{COUNTER}'
- Print in uppercase letters: 'A', 'B', ...
+ Print in uppercase letters: 'A', 'B', ... If the counter's value
+ is less than 1 or more than 26 then you get 'LaTeX Error: Counter
+ too large.'
'\arabic{COUNTER}'
- Print in Arabic numbers: '1', '2', ...
+ Print in Arabic numbers such as '5' or '-2'.
'\roman{COUNTER}'
- Print in lowercase roman numerals: 'i', 'ii', ...
+ Print in lowercase roman numerals: 'i', 'ii', ... If the counter's
+ value is less than 1 then you get no warning or error but LaTeX
+ does not print anything in the output.
'\Roman{COUNTER}'
- Print in uppercase roman numerals: 'I', 'II', ...
+ Print in uppercase roman numerals: 'I', 'II', ... If the counter's
+ value is less than 1 then you get no warning or error but LaTeX
+ does not print anything in the output.
'\fnsymbol{COUNTER}'
Prints the value of COUNTER in a specific sequence of nine symbols
(conventionally used for labeling footnotes). The value of COUNTER
- must be between 1 and 9, inclusive.
+ must be between 1 and 9, inclusive. If the counter's value is less
+ than 0 or more than 9 then you get 'LaTeX Error: Counter too
+ large', while if it is 0 then you get no error or warning but LaTeX
+ does not print anything in the output.
Here are the symbols:
- Name Command Equivalent Unicode
- symbol and/or numeric
- code point
- ---------------------------------------------------------------------------
- asterisk '\ast' *
- dagger '\dagger' U+2020
- ddagger '\ddagger' U+2021
- section-sign '\S' U+00A7
- paragraph-sign '\P' U+00B6
- double-vert '\parallel' U+2016
- double-asterisk '\ast\ast' **
- double-dagger '\dagger\dagger' U+2020U+2020
- double-ddagger '\ddagger\ddagger' U+2021U+2021
+ Number Name Command Equivalent Unicode
+ symbol and/or
+ numeric code point
+ -----------------------------------------------------------------------------
+ 1 asterisk '\ast' *
+ 2 dagger '\dagger' U+2020
+ 3 ddagger '\ddagger' U+2021
+ 4 section-sign '\S' U+00A7
+ 5 paragraph-sign '\P' U+00B6
+ 6 double-vert '\parallel' U+2016
+ 7 double-asterisk '\ast\ast' **
+ 8 double-dagger '\dagger\dagger' U+2020U+2020
+ 9 double-ddagger '\ddagger\ddagger' U+2021U+2021
File: latex2e.info, Node: \usecounter, Next: \value, Prev: \alph \Alph \arabic \roman \Roman \fnsymbol, Up: Counters
@@ -5941,15 +5959,15 @@
\usecounter{COUNTER}
- In the 'list' environment, when used in the second argument, this
-command sets up COUNTER to number the list items. It initializes
-COUNTER to zero, and arranges that when '\item' is called without its
-optional argument then COUNTER is incremented by '\refstepcounter',
-making its value be the current 'ref' value. This command is fragile
-(*note \protect::).
+ Used in the second argument of the 'list' environment (*note list::).
+It sets up COUNTER to number the list items. It initializes COUNTER to
+zero, and arranges that when '\item' is called without its optional
+argument then COUNTER is incremented by '\refstepcounter', making its
+value be the current 'ref' value (*note \ref::). This command is
+fragile (*note \protect::).
- Put in the preamble, this makes a new list environment enumerated
-with TESTCOUNTER:
+ Put in the docuemnt preamble, this example makes a new list
+environment enumerated with TESTCOUNTER:
\newcounter{testcounter}
\newenvironment{test}{%
@@ -5970,10 +5988,9 @@
\value{COUNTER}
- This command expands to the value of COUNTER. It is often used in
-'\setcounter' or '\addtocounter', but '\value' can be used anywhere that
-LaTeX expects a number. It must not be preceded by '\protect' (*note
-\protect::).
+ Expands to the value of COUNTER. It is often used in '\setcounter'
+or '\addtocounter' but '\value' can be used anywhere that LaTeX expects
+a number. It must not be preceded by '\protect' (*note \protect::).
The '\value' command is not used for typesetting the value of the
counter. *Note \alph \Alph \arabic \roman \Roman \fnsymbol::.
@@ -6002,14 +6019,16 @@
\setcounter{COUNTER}{VALUE}
- The '\setcounter' command globally sets the value of COUNTER to the
-VALUE argument. Note that the counter name does not start with a
-backslash.
+ Globally set the counter COUNTER to have the value of the VALUE
+argument. Thus, you can set a counter's value as
+'\setcounter{section}{5}'. Note that the counter name does not start
+with a backslash.
- In this example the section value appears as 'V'.
+ In this example if the counter 'theorem' has value 12 then the second
+line will print 'XII'.
- \setcounter{section}{5}
- Here it is in Roman: \Roman{section}.
+ \setcounter{exercise}{\value{theorem}}
+ Here it is in Roman: \Roman{exercise}.
File: latex2e.info, Node: \addtocounter, Next: \refstepcounter, Prev: \setcounter, Up: Counters
@@ -10012,8 +10031,8 @@
\endinput
- When you '\include{file}', inside 'filename.tex' the material after
-'\endinput' will not be included. This command is optional; if
+ When you '\include{filename}', inside 'filename.tex' the material
+after '\endinput' will not be included. This command is optional; if
'filename.tex' has no '\endinput' then LaTeX will read all of the file.
For example, suppose that a document's root file has '\input{chap1}'
@@ -10056,7 +10075,7 @@
document.
The '\include' command does three things: it executes '\clearpage'
-(*note \clearpage::), then it inputs the material from 'filename.tex'
+(*note \clearpage::), then it inputs the material from 'FILENAME.tex'
into the document, and then it does another '\clearpage'. This command
can only appear in the document body. The '\includeonly' command
controls which files will be read by LaTeX under subsequent '\include'
@@ -10093,13 +10112,13 @@
'preamble' and 'amendments' and run LaTeX again then the resulting
document shows only the material from 'articles.tex', not the material
from 'preamble.tex' or 'amendments.tex'. Nonetheless, all of the
-auxillary information from the omitted files, including the starting
-page number of this chapter, is still there.
+auxillary information from the omitted files is still there, including
+the starting page number of the chapter.
If the document preamble does not have '\includeonly' then LaTeX will
include all the files you call for with '\include' commands.
- The '\include' command makess a new page. To avoid that, see *note
+ The '\include' command makes a new page. To avoid that, see *note
\input:: (which, however, does not retain the auxillary information).
File names can involve paths.
@@ -10113,8 +10132,8 @@
\end{document}
To make your document portable across distributions and platforms you
-should avoid spaces. The tradition is to instead use underscores in the
-file names. That said, for the filename ''amo amas amat'', this works
+should avoid spaces in the file names. The tradition is to instead use
+underscores. That said, for the name ''amo amas amat'', this works
under TeX Live on Linux
\documentclass{book}
@@ -10136,8 +10155,8 @@
\end{document}
You cannot use '\include' inside a file that is being included or you
-get '! LaTeX Error: \include cannot be nested.' The '\include' command
-cannot appear in the document preamble; you will get '! LaTeX Error:
+get 'LaTeX Error: \include cannot be nested.' The '\include' command
+cannot appear in the document preamble; you will get 'LaTeX Error:
Missing \begin{document}.'.
If a file that you '\include' does not exist, for instance if you
@@ -10145,8 +10164,8 @@
not give you an error but will warn you 'No file athiesm.tex.' (It will
also create 'athiesm.aux'.)
- If you '\include' the root file in itself then you first get '! LaTeX
-Error: Can be used only in preamble.' Later runs get '! TeX capacity
+ If you '\include' the root file in itself then you first get 'LaTeX
+Error: Can be used only in preamble.' Later runs get 'TeX capacity
exceeded, sorry [text input levels=15]'. To fix this, you must remove
the inclusion '\include{root}' but also delete the file 'ROOT.aux' and
rerun LaTeX.
@@ -11843,7 +11862,7 @@
* \alph{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
(line 14)
* \Alph{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 17)
+ (line 19)
* \alsoname: Indexes. (line 20)
* \amalg: Math symbols. (line 28)
* \and for \author: \maketitle. (line 12)
@@ -11851,7 +11870,7 @@
* \appendix: Sectioning. (line 37)
* \approx: Math symbols. (line 36)
* \arabic{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 20)
+ (line 24)
* \arccos: Math functions. (line 9)
* \arcsin: Math functions. (line 12)
* \arctan: Math functions. (line 15)
@@ -12082,7 +12101,7 @@
* \flushbottom: \flushbottom. (line 6)
* \fnsymbol, and footnotes: \footnote. (line 23)
* \fnsymbol{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 29)
+ (line 37)
* \fontencoding: Low-level font commands.
(line 11)
* \fontfamily: Low-level font commands.
@@ -12542,9 +12561,9 @@
* \rm: Font styles. (line 79)
* \rmfamily: Font styles. (line 30)
* \roman{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 23)
+ (line 27)
* \Roman{COUNTER}: \alph \Alph \arabic \roman \Roman \fnsymbol.
- (line 26)
+ (line 32)
* \rotatebox: \rotatebox. (line 6)
* \rq: Text symbols. (line 54)
* \rule: \rule. (line 6)
@@ -12983,266 +13002,266 @@
Tag Table:
-Node: Top1702
-Node: About this document3580
-Node: Overview5440
-Node: Starting and ending6940
-Ref: Starting & ending7075
-Node: Output files8061
-Node: TeX engines10307
-Node: LaTeX command syntax12745
-Node: Environment14579
-Node: Declaration15652
-Node: \makeatletter and \makeatother16038
-Node: \@ifstar18231
-Node: Document classes21060
-Node: Document class options22383
-Node: Additional packages25482
-Node: Class and package construction26113
-Node: Class and package structure27565
-Node: Class and package commands29859
-Node: Fonts47384
-Ref: Typefaces47487
-Node: Font styles47815
-Node: Font sizes52243
-Node: Low-level font commands53474
-Node: Layout58581
-Node: \onecolumn59079
-Node: \twocolumn59410
-Node: \flushbottom63805
-Node: \raggedbottom64905
-Node: Page layout parameters65441
-Node: Floats71139
-Node: Sectioning77604
-Ref: Sectioning/secnumdepth78925
-Node: \@startsection79335
-Ref: \@startsection/name80607
-Ref: \@startsection/level81067
-Ref: \@startsection/indent82138
-Ref: \@startsection/beforeskip82401
-Ref: \@startsection/afterskip83922
-Ref: \@startsection/style85233
-Node: Cross references89069
-Node: \label90935
-Node: \pageref92482
-Node: \ref93152
-Node: Environments93841
-Node: abstract95844
-Node: array97433
-Node: center99691
-Node: \centering101332
-Node: description102704
-Node: displaymath104891
-Node: document106669
-Node: \AtBeginDocument107099
-Node: \AtEndDocument107723
-Node: enumerate108367
-Node: eqnarray111164
-Node: equation113218
-Node: figure113888
-Node: filecontents115700
-Node: flushleft117453
-Node: \raggedright117946
-Node: flushright118505
-Node: \raggedleft119003
-Node: itemize119560
-Node: letter123061
-Node: list123299
-Node: \item135988
-Node: trivlist137241
-Node: math138769
-Node: minipage139075
-Node: picture140267
-Node: \circle145283
-Node: \makebox (picture)145626
-Node: \framebox (picture)146332
-Node: \dashbox146822
-Node: \frame147345
-Node: \line147671
-Node: \linethickness148129
-Node: \thicklines148550
-Node: \thinlines148860
-Node: \multiput149162
-Node: \oval149529
-Node: \put150250
-Node: \shortstack150541
-Node: \vector151015
-Node: quotation and quote151329
-Node: tabbing152536
-Node: table158474
-Node: tabular159901
-Node: \multicolumn167109
-Node: \vline170994
-Node: \cline172339
-Node: \hline173023
-Node: thebibliography173706
-Node: \bibitem175320
-Node: \cite176078
-Node: \nocite176597
-Node: Using BibTeX176885
-Node: theorem178394
-Node: titlepage178780
-Node: verbatim180070
-Node: \verb180709
-Node: verse181259
-Node: Line breaking181753
-Node: \\182850
-Node: \obeycr & \restorecr183888
-Node: \newline184290
-Node: \- (hyphenation)185124
-Node: \discretionary185739
-Node: \fussy186031
-Node: \sloppy186421
-Node: \hyphenation186748
-Node: \linebreak & \nolinebreak187373
-Node: Page breaking188025
-Node: \cleardoublepage188633
-Node: \clearpage189062
-Node: \newpage189359
-Node: \enlargethispage189590
-Node: \pagebreak & \nopagebreak190117
-Node: Footnotes190811
-Node: \footnote192065
-Node: \footnotemark193861
-Node: \footnotetext195105
-Node: Footnotes in a table195595
-Node: Footnotes in section headings197452
-Node: Footnotes of footnotes198308
-Node: Multiple reference to footnotes199075
-Node: Footnote parameters199933
-Node: Definitions200683
-Node: \newcommand & \renewcommand201560
-Node: \providecommand205396
-Node: \newcounter206057
-Node: \newlength207028
-Node: \newsavebox207675
-Node: \newenvironment & \renewenvironment208286
-Node: \newtheorem212646
-Node: \newfont216135
-Node: \protect217700
-Node: \ignorespaces & \ignorespacesafterend220086
-Node: Counters222835
-Node: \alph \Alph \arabic \roman \Roman \fnsymbol224435
-Node: \usecounter226507
-Node: \value227339
-Node: \setcounter228282
-Node: \addtocounter228768
-Node: \refstepcounter229233
-Node: \stepcounter229891
-Node: \day \month \year230233
-Node: Lengths230778
-Node: Units of length232568
-Node: \setlength234062
-Node: \addtolength234466
-Node: \settodepth234784
-Node: \settoheight235075
-Node: \settowidth235372
-Node: Predefined lengths235680
-Node: Making paragraphs236195
-Node: \indent236767
-Node: \noindent237229
-Node: \parskip237738
-Node: Marginal notes237996
-Node: Math formulas239808
-Node: Subscripts & superscripts241592
-Node: Math symbols242930
-Node: Math functions268259
-Node: Math accents269202
-Node: Spacing in math mode270174
-Node: Math miscellany271641
-Node: Modes274191
-Node: \ensuremath276031
-Node: Page styles276947
-Node: \maketitle277441
-Node: \pagenumbering278511
-Node: \pagestyle279007
-Node: \thispagestyle280148
-Node: Spaces280454
-Node: \hspace281324
-Node: \hfill282279
-Node: \spacefactor282671
-Node: \(SPACE) and \@285383
-Ref: \AT285526
-Node: \frenchspacing287003
-Node: \normalsfcodes287619
-Node: \(SPACE) after control sequence287808
-Node: \thinspace288719
-Node: \/289039
-Node: \hrulefill \dotfill290221
-Node: \addvspace291214
-Node: \bigskip \medskip \smallskip292260
-Node: \vfill293152
-Node: \vspace294021
-Node: Boxes295014
-Node: \mbox295726
-Node: \fbox and \framebox296013
-Node: lrbox296817
-Node: \makebox297175
-Node: \parbox297895
-Node: \raisebox299463
-Node: \savebox300060
-Node: \sbox300475
-Node: \usebox300924
-Node: Color301185
-Node: Color package options302029
-Node: Color models303675
-Node: Commands for color305984
-Node: Define colors306399
-Node: Colored text307114
-Node: Colored boxes309489
-Node: Colored pages310928
-Node: Graphics311621
-Node: Graphics package options313740
-Node: Graphics package configuration316496
-Node: \graphicspath317287
-Node: \DeclareGraphicsExtensions320210
-Node: \DeclareGraphicsRule322003
-Node: Commands for graphics325192
-Node: \includegraphics325697
-Node: \rotatebox338723
-Node: \scalebox341518
-Node: \resizebox342570
-Node: Special insertions343762
-Node: Reserved characters344566
-Node: Upper and lower case345767
-Node: Symbols by font position347682
-Node: Text symbols348302
-Node: Accents351750
-Node: Additional Latin letters354292
-Ref: Non-English characters354463
-Node: \rule355480
-Node: \today355909
-Node: Splitting the input356663
-Node: \endinput358040
-Node: \include & \includeonly359303
-Node: \input363319
-Node: Front/back matter364029
-Node: Tables of contents364234
-Node: \addcontentsline365295
-Node: \addtocontents366313
-Node: Glossaries366846
-Node: Indexes367365
-Node: Letters368998
-Node: \address372676
-Node: \cc373546
-Node: \closing373964
-Node: \encl374275
-Node: \location374690
-Node: \makelabels374959
-Node: \name375960
-Node: \opening376190
-Node: \ps376530
-Node: \signature376819
-Node: \telephone377911
-Node: Terminal input/output378276
-Node: \typein378541
-Node: \typeout379126
-Node: Command line379749
-Node: Document templates380701
-Node: beamer template381108
-Node: book template381759
-Node: tugboat template382127
-Node: Concept Index384491
-Node: Command Index447328
+Node: Top1700
+Node: About this document3576
+Node: Overview5436
+Node: Starting and ending6936
+Ref: Starting & ending7071
+Node: Output files8057
+Node: TeX engines10303
+Node: LaTeX command syntax12741
+Node: Environment14575
+Node: Declaration15648
+Node: \makeatletter and \makeatother16034
+Node: \@ifstar18227
+Node: Document classes21056
+Node: Document class options22379
+Node: Additional packages25461
+Node: Class and package construction26092
+Node: Class and package structure27544
+Node: Class and package commands29838
+Node: Fonts47363
+Ref: Typefaces47466
+Node: Font styles47794
+Node: Font sizes52222
+Node: Low-level font commands53453
+Node: Layout58560
+Node: \onecolumn59058
+Node: \twocolumn59389
+Node: \flushbottom63784
+Node: \raggedbottom64884
+Node: Page layout parameters65420
+Node: Floats71118
+Node: Sectioning77583
+Ref: Sectioning/secnumdepth78904
+Node: \@startsection79314
+Ref: \@startsection/name80586
+Ref: \@startsection/level81046
+Ref: \@startsection/indent82117
+Ref: \@startsection/beforeskip82380
+Ref: \@startsection/afterskip83901
+Ref: \@startsection/style85212
+Node: Cross references89048
+Node: \label90914
+Node: \pageref92461
+Node: \ref93131
+Node: Environments93820
+Node: abstract95823
+Node: array97412
+Node: center99670
+Node: \centering101311
+Node: description102683
+Node: displaymath104870
+Node: document106648
+Node: \AtBeginDocument107078
+Node: \AtEndDocument107702
+Node: enumerate108346
+Node: eqnarray111143
+Node: equation113197
+Node: figure113867
+Node: filecontents115679
+Node: flushleft117432
+Node: \raggedright117925
+Node: flushright118484
+Node: \raggedleft118982
+Node: itemize119539
+Node: letter123040
+Node: list123278
+Node: \item135989
+Node: trivlist137242
+Node: math138770
+Node: minipage139076
+Node: picture140268
+Node: \circle145284
+Node: \makebox (picture)145627
+Node: \framebox (picture)146333
+Node: \dashbox146823
+Node: \frame147346
+Node: \line147672
+Node: \linethickness148130
+Node: \thicklines148551
+Node: \thinlines148861
+Node: \multiput149163
+Node: \oval149530
+Node: \put150251
+Node: \shortstack150542
+Node: \vector151016
+Node: quotation and quote151330
+Node: tabbing152537
+Node: table158475
+Node: tabular159902
+Node: \multicolumn167110
+Node: \vline170995
+Node: \cline172340
+Node: \hline173024
+Node: thebibliography173707
+Node: \bibitem175321
+Node: \cite176079
+Node: \nocite176598
+Node: Using BibTeX176886
+Node: theorem178395
+Node: titlepage178781
+Node: verbatim180071
+Node: \verb180710
+Node: verse181260
+Node: Line breaking181754
+Node: \\182851
+Node: \obeycr & \restorecr183889
+Node: \newline184291
+Node: \- (hyphenation)185125
+Node: \discretionary185740
+Node: \fussy186032
+Node: \sloppy186422
+Node: \hyphenation186749
+Node: \linebreak & \nolinebreak187374
+Node: Page breaking188026
+Node: \cleardoublepage188634
+Node: \clearpage189063
+Node: \newpage189360
+Node: \enlargethispage189591
+Node: \pagebreak & \nopagebreak190118
+Node: Footnotes190812
+Node: \footnote192066
+Node: \footnotemark193862
+Node: \footnotetext195106
+Node: Footnotes in a table195596
+Node: Footnotes in section headings197453
+Node: Footnotes of footnotes198309
+Node: Multiple reference to footnotes199076
+Node: Footnote parameters199934
+Node: Definitions200684
+Node: \newcommand & \renewcommand201561
+Node: \providecommand205397
+Node: \newcounter206058
+Node: \newlength207209
+Node: \newsavebox207856
+Node: \newenvironment & \renewenvironment208467
+Node: \newtheorem212827
+Node: \newfont216316
+Node: \protect217881
+Node: \ignorespaces & \ignorespacesafterend220267
+Node: Counters223016
+Node: \alph \Alph \arabic \roman \Roman \fnsymbol224689
+Node: \usecounter227518
+Node: \value228381
+Node: \setcounter229310
+Node: \addtocounter229912
+Node: \refstepcounter230377
+Node: \stepcounter231035
+Node: \day \month \year231377
+Node: Lengths231922
+Node: Units of length233712
+Node: \setlength235206
+Node: \addtolength235610
+Node: \settodepth235928
+Node: \settoheight236219
+Node: \settowidth236516
+Node: Predefined lengths236824
+Node: Making paragraphs237339
+Node: \indent237911
+Node: \noindent238373
+Node: \parskip238882
+Node: Marginal notes239140
+Node: Math formulas240952
+Node: Subscripts & superscripts242736
+Node: Math symbols244074
+Node: Math functions269403
+Node: Math accents270346
+Node: Spacing in math mode271318
+Node: Math miscellany272785
+Node: Modes275335
+Node: \ensuremath277175
+Node: Page styles278091
+Node: \maketitle278585
+Node: \pagenumbering279655
+Node: \pagestyle280151
+Node: \thispagestyle281292
+Node: Spaces281598
+Node: \hspace282468
+Node: \hfill283423
+Node: \spacefactor283815
+Node: \(SPACE) and \@286527
+Ref: \AT286670
+Node: \frenchspacing288147
+Node: \normalsfcodes288763
+Node: \(SPACE) after control sequence288952
+Node: \thinspace289863
+Node: \/290183
+Node: \hrulefill \dotfill291365
+Node: \addvspace292358
+Node: \bigskip \medskip \smallskip293404
+Node: \vfill294296
+Node: \vspace295165
+Node: Boxes296158
+Node: \mbox296870
+Node: \fbox and \framebox297157
+Node: lrbox297961
+Node: \makebox298319
+Node: \parbox299039
+Node: \raisebox300607
+Node: \savebox301204
+Node: \sbox301619
+Node: \usebox302068
+Node: Color302329
+Node: Color package options303173
+Node: Color models304819
+Node: Commands for color307128
+Node: Define colors307543
+Node: Colored text308258
+Node: Colored boxes310633
+Node: Colored pages312072
+Node: Graphics312765
+Node: Graphics package options314884
+Node: Graphics package configuration317640
+Node: \graphicspath318431
+Node: \DeclareGraphicsExtensions321354
+Node: \DeclareGraphicsRule323147
+Node: Commands for graphics326336
+Node: \includegraphics326841
+Node: \rotatebox339867
+Node: \scalebox342662
+Node: \resizebox343714
+Node: Special insertions344906
+Node: Reserved characters345710
+Node: Upper and lower case346911
+Node: Symbols by font position348826
+Node: Text symbols349446
+Node: Accents352894
+Node: Additional Latin letters355436
+Ref: Non-English characters355607
+Node: \rule356624
+Node: \today357053
+Node: Splitting the input357807
+Node: \endinput359184
+Node: \include & \includeonly360451
+Node: \input364452
+Node: Front/back matter365162
+Node: Tables of contents365367
+Node: \addcontentsline366428
+Node: \addtocontents367446
+Node: Glossaries367979
+Node: Indexes368498
+Node: Letters370131
+Node: \address373809
+Node: \cc374679
+Node: \closing375097
+Node: \encl375408
+Node: \location375823
+Node: \makelabels376092
+Node: \name377093
+Node: \opening377323
+Node: \ps377663
+Node: \signature377952
+Node: \telephone379044
+Node: Terminal input/output379409
+Node: \typein379674
+Node: \typeout380259
+Node: Command line380882
+Node: Document templates381834
+Node: beamer template382241
+Node: book template382892
+Node: tugboat template383260
+Node: Concept Index385624
+Node: Command Index448461
End Tag Table
Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2018-05-17 21:43:30 UTC (rev 620)
+++ trunk/latex2e.texi 2018-05-18 18:08:28 UTC (rev 621)
@@ -2,7 +2,7 @@
@c $Id$
@comment %**start of header (This is for running Texinfo on a region.)
@setfilename latex2e.info
- at set UPDATED March 2018
+ at set UPDATED May 2018
@include common.texi
@settitle @LaTeX{}2e unofficial reference manual (@value{UPDATED})
@comment %**end of header (This is for running Texinfo on a region.)
@@ -750,9 +750,9 @@
@cindex class options
@cindex global options
-You can specify so-called @dfn{global options} or @dfn{class options} to
-the @code{\documentclass} command by enclosing them in square brackets.
-To specify more than one @var{option}, separate them with a comma, as in:
+You can specify @dfn{global options} or @dfn{class options} to the
+ at code{\documentclass} command by enclosing them in square brackets. To
+specify more than one @var{option}, separate them with a comma.
@example
\documentclass[@var{option1}, at var{option2},...]@{@var{class}@}
@@ -4265,6 +4265,7 @@
This example has the labels in red. They are numbered, and the left
edge of the label lines up with the left edge of the item text.
+ at xref{\usecounter}.
@example
\usepackage@{color@}
@@ -6652,18 +6653,22 @@
Globally defines a new counter named @var{countername} and initialize
the new counter to zero.
-The name @var{countername} must consists of letters only, and does not
+The name @var{countername} must consist of letters only. It does not
begin with a backslash. This name must not already be in use by another
counter.
When you use the optional argument @code{[@var{supercounter}]} then
- at var{countername} will be numbered within, or subsidiary to, the
-existing counter @var{supercounter}. For example, ordinarily
+ at var{countername} the counter foo will be reset whenever the counter
+ at var{supercounter} is incremented. For example, ordinarily
@code{subsection} is numbered within @code{section} so that any time
- at var{supercounter} is incremented with @code{\stepcounter}
+ at var{supercounter} is incremented, either with @code{\stepcounter}
(@pxref{\stepcounter}) or @code{\refstepcounter}
-(@pxref{\refstepcounter}) then @var{countername} is reset to zero.
+(@pxref{\refstepcounter}), then @var{countername} is reset to zero.
+The super counter must already exist. If you enter
+ at code{\newcounter@{jh@}[lh]} and @code{lh} is not a defined counter
+then you will get @samp{LaTeX Error: No counter 'lh' defined.}
+
@xref{Counters}, for more information about counters.
@@ -7211,6 +7216,8 @@
through @code{enumiv} are used in the @code{enumerate} environment, for
up to four levels of nesting (@pxref{enumerate}).
+Counters can have any integer value but they are typically positive.
+
New counters are created with @code{\newcounter}. @xref{\newcounter}.
@@ -7242,47 +7249,58 @@
@ftable @code
@item \alph@{@var{counter}@}
-Print the value of @var{counter} in lowercase letters: `a', `b', @enddots{}
+Print the value of @var{counter} in lowercase letters: `a', `b',
+ at enddots{} If the counter's value is less than 1 or more than 26 then
+you get @samp{LaTeX Error: Counter too large.}
@item \Alph@{@var{counter}@}
-Print in uppercase letters: `A', `B', @enddots{}
+Print in uppercase letters: `A', `B', @enddots{} If the counter's value
+is less than 1 or more than 26 then you get @samp{LaTeX Error: Counter
+too large.}
@item \arabic@{@var{counter}@}
-Print in Arabic numbers: `1', `2', @enddots{}
+Print in Arabic numbers such as @samp{5} or @samp{-2}.
@item \roman@{@var{counter}@}
-Print in lowercase roman numerals: `i', `ii', @enddots{}
+Print in lowercase roman numerals: `i', `ii', @enddots{} If the
+counter's value is less than 1 then you get no warning or error but
+ at LaTeX{} does not print anything in the output.
@item \Roman@{@var{counter}@}
-Print in uppercase roman numerals: `I', `II', @enddots{}
+Print in uppercase roman numerals: `I', `II', @enddots{} If the
+counter's value is less than 1 then you get no warning or error but
+ at LaTeX{} does not print anything in the output.
@item \fnsymbol@{@var{counter}@}
-Prints the value of @var{counter} in a specific sequence of nine
-symbols (conventionally used for labeling footnotes). The value of
- at var{counter} must be between at tie{}1 and at tie{}9, inclusive.
+Prints the value of @var{counter} in a specific sequence of nine symbols
+(conventionally used for labeling footnotes). The value of
+ at var{counter} must be between at tie{}1 and at tie{}9, inclusive. If the
+counter's value is less than 0 or more than 9 then you get @samp{LaTeX
+Error: Counter too large}, while if it is 0 then you get no error or
+warning but @LaTeX{} does not print anything in the output.
Here are the symbols:
- at multitable @columnfractions .33 .33 .33
- at headitem Name at tab Command at tab@iftexthenelse{Symbol,Equivalent Unicode symbol and/or numeric code point}
+ at multitable @columnfractions .10 .30 .30 .30
+ at headitem Number at tab Name at tab Command at tab@iftexthenelse{Symbol,Equivalent Unicode symbol and/or numeric code point}
@item
-asterisk at tab@code{\ast}@tab at iftexthenelse{@math{@ast},*}
+1 at tab asterisk at tab@code{\ast}@tab at iftexthenelse{@math{@ast},*}
@item
-dagger at tab@code{\dagger}@tab at BES{2020,\dagger}
+2 at tab dagger at tab@code{\dagger}@tab at BES{2020,\dagger}
@item
-ddagger at tab@code{\ddagger}@tab at BES{2021,\ddagger}
+3 at tab ddagger at tab@code{\ddagger}@tab at BES{2021,\ddagger}
@item
-section-sign at tab@code{\S}@tab at BES{00A7,\S}
+4 at tab section-sign at tab@code{\S}@tab at BES{00A7,\S}
@item
-paragraph-sign at tab@code{\P}@tab at BES{00B6,\P}
+5 at tab paragraph-sign at tab@code{\P}@tab at BES{00B6,\P}
@item
-double-vert at tab@code{\parallel}@tab at BES{2016,\parallel}
+6 at tab double-vert at tab@code{\parallel}@tab at BES{2016,\parallel}
@item
-double-asterisk at tab@code{\ast\ast}@tab at iftexthenelse{@math{@ast at ast},**}
+7 at tab double-asterisk at tab@code{\ast\ast}@tab at iftexthenelse{@math{@ast at ast},**}
@item
-double-dagger at tab@code{\dagger\dagger}@tab at BES{2020,\dagger}@BES{2020,\dagger}
+8 at tab double-dagger at tab@code{\dagger\dagger}@tab at BES{2020,\dagger}@BES{2020,\dagger}
@item
-double-ddagger at tab@code{\ddagger\ddagger}@tab at BES{2021,\ddagger}@BES{2021,\ddagger}
+9 at tab double-ddagger at tab@code{\ddagger\ddagger}@tab at BES{2021,\ddagger}@BES{2021,\ddagger}
@end multitable
@end ftable
@@ -7301,15 +7319,16 @@
\usecounter@{@var{counter}@}
@end example
-In the @code{list} environment, when used in the second argument, this
-command sets up @var{counter} to number the list items. It initializes
- at var{counter} to zero, and arranges that when @code{\item} is called
-without its optional argument then @var{counter} is incremented by
- at code{\refstepcounter}, making its value be the current @code{ref}
-value. This command is fragile (@pxref{\protect}).
+Used in the second argument of the @code{list} environment
+(@pxref{list}). It sets up @var{counter} to number the list items. It
+initializes @var{counter} to zero, and arranges that when @code{\item}
+is called without its optional argument then @var{counter} is
+incremented by @code{\refstepcounter}, making its value be the current
+ at code{ref} value (@pxref{\ref}). This command is fragile
+(@pxref{\protect}).
-Put in the preamble, this makes a new list environment enumerated with
- at var{testcounter}:
+Put in the docuemnt preamble, this example makes a new list environment
+enumerated with @var{testcounter}:
@example
\newcounter@{testcounter@}
@@ -7335,10 +7354,10 @@
\value@{@var{counter}@}
@end example
-This command expands to the value of @var{counter}. It is often used
-in @code{\setcounter} or @code{\addtocounter}, but @code{\value} can
-be used anywhere that @LaTeX{} expects a number. It must not be
-preceded by @code{\protect} (@pxref{\protect}).
+Expands to the value of @var{counter}. It is often used in
+ at code{\setcounter} or @code{\addtocounter} but @code{\value} can be used
+anywhere that @LaTeX{} expects a number. It must not be preceded by
+ at code{\protect} (@pxref{\protect}).
The @code{\value} command is not used for typesetting the value of the
counter. @xref{\alph \Alph \arabic \roman \Roman \fnsymbol}.
@@ -7376,15 +7395,17 @@
\setcounter@{@var{counter}@}@{@var{value}@}
@end example
-The @code{\setcounter} command globally sets the value of @var{counter}
-to the @var{value} argument. Note that the counter name does not start
-with a backslash.
+Globally set the counter @var{counter} to have the value of the
+ at var{value} argument. Thus, you can set a counter's value as
+ at code{\setcounter@{section@}@{5@}}. Note that the counter name does not
+start with a backslash.
-In this example the section value appears as @samp{V}.
+In this example if the counter @code{theorem} has value 12 then the
+second line will print @samp{XII}.
@example
-\setcounter@{section@}@{5@}
-Here it is in Roman: \Roman@{section@}.
+\setcounter@{exercise@}@{\value@{theorem@}@}
+Here it is in Roman: \Roman@{exercise@}.
@end example
@@ -12216,7 +12237,7 @@
\endinput
@end example
-When you @code{\include@{file@}}, inside @file{filename.tex} the
+When you @code{\include@{filename@}}, inside @file{filename.tex} the
material after @code{\endinput} will not be included. This command is
optional; if @file{filename.tex} has no @code{\endinput} then @LaTeX{}
will read all of the file.
@@ -12268,7 +12289,7 @@
The @code{\include} command does three things: it executes
@code{\clearpage} (@pxref{\clearpage}), then it inputs the material from
- at file{filename.tex} into the document, and then it does another
+ at file{@var{filename}.tex} into the document, and then it does another
@code{\clearpage}. This command can only appear in the document body.
The @code{\includeonly} command controls which files will be read by
@LaTeX{} under subsequent @code{\include} commands. Its list of
@@ -12298,7 +12319,7 @@
@example
\chapter@{Preamble@}
-We the People of the United States, in Order to form a more perfect Union, @dots{}
+We the People of the United States, in Order to form a more perfect Union, ...
@end example
Running @LaTeX{} on @file{constitution.tex} makes the material from the
@@ -12310,14 +12331,14 @@
and run @LaTeX{} again then the resulting document shows only the
material from @file{articles.tex}, not the material from
@file{preamble.tex} or @file{amendments.tex}. Nonetheless, all of the
-auxillary information from the omitted files, including the starting
-page number of this chapter, is still there.
+auxillary information from the omitted files is still there, including
+the starting page number of the chapter.
If the document preamble does not have @code{\includeonly} then
@LaTeX{} will include all the files you call for with @code{\include}
commands.
-The @code{\include} command makess a new page. To avoid that, see
+The @code{\include} command makes a new page. To avoid that, see
@ref{\input} (which, however, does not retain the auxillary
information).
@@ -12334,9 +12355,9 @@
@end example
To make your document portable across distributions and platforms you
-should avoid spaces. The tradition is to instead use underscores in the
-file names. That said, for the filename @samp{@file{amo amas amat}},
-this works under TeX Live on Linux
+should avoid spaces in the file names. The tradition is to instead use
+underscores. That said, for the name @samp{@file{amo amas amat}}, this
+works under TeX Live on Linux
@example
\documentclass@{book@}
@@ -12362,9 +12383,9 @@
@cindex nested @code{\include}, not allowed
You cannot use @code{\include} inside a file that is being included or
-you get @samp{! LaTeX Error: \include cannot be nested.} The
+you get @samp{LaTeX Error: \include cannot be nested.} The
@code{\include} command cannot appear in the document preamble; you will
-get @samp{! LaTeX Error: Missing \begin@{document@}.}.
+get @samp{LaTeX Error: Missing \begin@{document@}.}.
If a file that you @code{\include} does not exist, for instance if you
@code{\include@{athiesm@}} but you meant @code{\include@{atheism@}},
@@ -12372,8 +12393,8 @@
athiesm.tex.} (It will also create @file{athiesm.aux}.)
If you @code{\include} the root file in itself then you first get
- at samp{! LaTeX Error: Can be used only in preamble.} Later runs get
- at samp{! TeX capacity exceeded, sorry [text input levels=15]}. To fix
+ at samp{LaTeX Error: Can be used only in preamble.} Later runs get
+ at samp{TeX capacity exceeded, sorry [text input levels=15]}. To fix
this, you must remove the inclusion @code{\include@{root@}} but also
delete the file @file{@var{root}.aux} and rerun @LaTeX{}.
More information about the latexrefman-commits
mailing list