[latexrefman-commits] [SCM] latexrefman updated: r643 - trunk
jimhefferon at gnu.org.ua
jimhefferon at gnu.org.ua
Thu Jun 7 22:35:03 CEST 2018
Author: jimhefferon
Date: 2018-06-07 23:35:03 +0300 (Thu, 07 Jun 2018)
New Revision: 643
Modified:
trunk/ChangeLog
trunk/latex2e.html
trunk/latex2e.info
trunk/latex2e.pdf
trunk/latex2e.texi
Log:
\pagenumbering, \maketitle
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2018-06-07 15:30:12 UTC (rev 642)
+++ trunk/ChangeLog 2018-06-07 20:35:03 UTC (rev 643)
@@ -1,3 +1,9 @@
+2018-06-07 Jim Hefferon <jhefferon at smcvt.edu>
+
+ * latex2e.texi (\pagenumbering) Add gobble, examples, refs to
+ page styles and counters.
+ (\maketitle) Improve example to contain all four declarations.
+
2018-06-06 Jim Hefferon <jhefferon at smcvt.edu>
* latex2e.texi (Math spacing) Adjust wording.
Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html 2018-06-07 15:30:12 UTC (rev 642)
+++ trunk/latex2e.html 2018-06-07 20:35:03 UTC (rev 643)
@@ -344,7 +344,7 @@
<li><a name="toc-Math-symbols-1" href="#Math-symbols">16.2 Math symbols</a>
<ul class="no-bullet">
<li><a name="toc-Blackboard-bold-1" href="#Blackboard-bold">16.2.1 Blackboard bold</a></li>
- <li><a name="toc-Caligraphic-1" href="#Caligraphic">16.2.2 Caligraphic</a></li>
+ <li><a name="toc-Calligraphic-1" href="#Calligraphic">16.2.2 Calligraphic</a></li>
<li><a name="toc-_005cboldmath-_0026-_005cunboldmath-1" href="#g_t_005cboldmath-_0026-_005cunboldmath">16.2.3 <code>\boldmath</code> & <code>\unboldmath</code></a></li>
</ul></li>
<li><a name="toc-Math-functions-1" href="#Math-functions">16.3 Math functions</a></li>
@@ -361,7 +361,7 @@
<li><a name="toc-_005cmaketitle-1" href="#g_t_005cmaketitle">18.1 <code>\maketitle</code></a></li>
<li><a name="toc-_005cpagenumbering-1" href="#g_t_005cpagenumbering">18.2 <code>\pagenumbering</code></a></li>
<li><a name="toc-_005cpagestyle-1" href="#g_t_005cpagestyle">18.3 <code>\pagestyle</code></a></li>
- <li><a name="toc-_005cthispagestyle_007bstyle_007d" href="#g_t_005cthispagestyle">18.4 <code>\thispagestyle{<var>style</var>}</code></a></li>
+ <li><a name="toc-_005cthispagestyle-1" href="#g_t_005cthispagestyle">18.4 <code>\thispagestyle</code></a></li>
</ul></li>
<li><a name="toc-Spaces-1" href="#Spaces">19 Spaces</a>
<ul class="no-bullet">
@@ -8260,7 +8260,7 @@
break here then TeX puts <var>no-break</var>
</p>
<p>In ‘<samp>difficult</samp>’ the three letters <code>ffi</code> form a ligature. But
-TeX can nontheless break between the two f’s with this.
+TeX can nonetheless break between the two f’s with this.
</p>
<div class="example">
<pre class="example">di\discretionary{f-}{fi}{ffi}cult
@@ -8620,7 +8620,7 @@
<p>The starred form <code>\enlargesthispage*</code> tries to squeeze the material
together on the page as much as possible, for the common use case of
-geting one more line on the page. This is often used together with an
+getting one more line on the page. This is often used together with an
explicit <code>\pagebreak</code>.
</p>
@@ -8676,7 +8676,7 @@
‘<samp>nation,</samp>’ since that is where LaTeX breaks that line. In
addition, with <code>\pagebreak</code> the vertical space on the page is
stretched out where possible so that it extends to the normal bottom
-margin. This can look wierd, and if <code>\flushbottom</code> is in effect
+margin. This can look strange, and if <code>\flushbottom</code> is in effect
this can cause you to get ‘<samp>Underfull \vbox (badness 10000) has
occurred while \output is active</samp>’. See <a href="#g_t_005cnewpage">\newpage</a> for a command that
does not have these effects.
@@ -9258,7 +9258,7 @@
I employ \lawyers[Howe]{Dewey}{Cheatem}.
</pre></div>
-<p>The ouptut is ‘<samp>I employ Dewey, Cheatem, and Howe</samp>’. The optional
+<p>The output is ‘<samp>I employ Dewey, Cheatem, and Howe</samp>’. The optional
argument, the <code>Howe</code>, is associated with <code>#1</code>, while
<code>Dewey</code> and <code>Cheatem</code> are associated with <code>#2</code>
and <code>#3</code>. Because of the optional argument,
@@ -9522,7 +9522,7 @@
<dd><p>Optional; an integer from 0 to 9 denoting the number of arguments of
that the environment will take. When you use the environment these
arguments appear after the <code>\begin</code>, as in
-<code>\begin{<var>env</var>}{<var>arg1</var>} .... {<var>argn</var>}</code>. Omiting
+<code>\begin{<var>env</var>}{<var>arg1</var>} .... {<var>argn</var>}</code>. Omitting
this is equivalent to setting it to 0; the environment will have no
arguments. When redefining an environment, the new version can have a
different number of arguments than the old version.
@@ -9658,7 +9658,7 @@
<code>\newtheorem{<var>name</var>}{<var>title</var>}[<var>numbered_within</var>]</code>,
creates an environment whose counter is subordinate to the existing
counter <var>numbered_within</var>, so this counter will be reset when
-<var>numbered_within</var> is reset. See the second e3xample below.
+<var>numbered_within</var> is reset. See the second example below.
</p>
<p>The third form
<code>\newtheorem{<var>name</var>}[<var>numbered_like</var>]{<var>title</var>}</code>,
@@ -12783,7 +12783,7 @@
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#Blackboard-bold" accesskey="1">Blackboard bold</a>:</td><td> </td><td align="left" valign="top">Doublestruck characters.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Caligraphic" accesskey="2">Caligraphic</a>:</td><td> </td><td align="left" valign="top">Cursive characters.
+<tr><td align="left" valign="top">• <a href="#Calligraphic" accesskey="2">Calligraphic</a>:</td><td> </td><td align="left" valign="top">Cursive characters.
</td></tr>
<tr><td align="left" valign="top">• <a href="#g_t_005cboldmath-_0026-_005cunboldmath" accesskey="3">\boldmath & \unboldmath</a>:</td><td> </td><td align="left" valign="top">Symbols in boldface.
</td></tr>
@@ -12794,7 +12794,7 @@
<a name="Blackboard-bold"></a>
<div class="header">
<p>
-Next: <a href="#Caligraphic" accesskey="n" rel="next">Caligraphic</a>, Up: <a href="#Math-symbols" accesskey="u" rel="up">Math symbols</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Calligraphic" accesskey="n" rel="next">Calligraphic</a>, Up: <a href="#Math-symbols" accesskey="u" rel="up">Math symbols</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Blackboard-bold-1"></a>
<h4 class="subsection">16.2.1 Blackboard bold</h4>
@@ -12831,15 +12831,17 @@
</p>
<hr>
-<a name="Caligraphic"></a>
+<a name="Calligraphic"></a>
<div class="header">
<p>
Next: <a href="#g_t_005cboldmath-_0026-_005cunboldmath" accesskey="n" rel="next">\boldmath & \unboldmath</a>, Previous: <a href="#Blackboard-bold" accesskey="p" rel="prev">Blackboard bold</a>, Up: <a href="#Math-symbols" accesskey="u" rel="up">Math symbols</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Caligraphic-1"></a>
-<h4 class="subsection">16.2.2 Caligraphic</h4>
+<a name="Calligraphic-1"></a>
+<h4 class="subsection">16.2.2 Calligraphic</h4>
-<a name="index-caligraphic"></a>
+<a name="index-calligraphic-fonts"></a>
+<a name="index-script-fonts"></a>
+<a name="index-fonts_002c-script"></a>
<p>Synopsis:
</p>
@@ -12865,7 +12867,7 @@
<a name="g_t_005cboldmath-_0026-_005cunboldmath"></a>
<div class="header">
<p>
-Previous: <a href="#Caligraphic" accesskey="p" rel="prev">Caligraphic</a>, Up: <a href="#Math-symbols" accesskey="u" rel="up">Math symbols</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Calligraphic" accesskey="p" rel="prev">Calligraphic</a>, Up: <a href="#Math-symbols" accesskey="u" rel="up">Math symbols</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="g_t_005cboldmath-_0026-_005cunboldmath-1"></a>
<h4 class="subsection">16.2.3 <code>\boldmath</code> & <code>\unboldmath</code></h4>
@@ -12890,10 +12892,11 @@
<a name="index-_005cboldmath-1"></a>
<a name="index-_005cunboldmath-1"></a>
-<p>Declarations to change the letters and symbols in <var>math</var> to be in a
-bold font, or to countermand that and bring back the unbolded default.
-They must be used when not in math mode or display math mode
-(see <a href="#Modes">Modes</a>). Both commands are fragile (see <a href="#g_t_005cprotect">\protect</a>).
+<p>Declarations to change the letters and symbols in <var>math</var> to be in
+a bold font, or to countermand that and bring back the regular
+(non-bold) default. They must be used when not in math mode or display
+math mode (see <a href="#Modes">Modes</a>). Both commands are fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
</p>
<p>In this example each <code>\boldmath</code> command takes place inside an
<code>\mbox</code>,
@@ -13038,7 +13041,7 @@
<dt><code>\hom</code>
<a name="index-_005chom"></a>
</dt>
-<dd><p>Homomorphisms
+<dd><p>Homomorphism
</p>
</dd>
<dt><code>\inf</code>
@@ -13694,56 +13697,68 @@
<a name="index-titles_002c-making"></a>
<a name="index-_005cmaketitle"></a>
-<p>Generate a title. It is on a separate title page, except in the
-<code>article</code> class where it is at the top of the first page.
+<p>Synopsis:
</p>
-<p>This example
+<div class="example">
+<pre class="example">\maketitle
+</pre></div>
+
+<p>Generate a title. In the standard classes the title appears on a
+separate page, except in the <code>article</code> class where it is at the top
+of the first page.
</p>
+<p>This example shows <code>\maketitle</code> appearing in its usual place,
+immediately after <code>\begin{document}</code>.
+</p>
<div class="example">
<pre class="example">\documentclass{article}
-\title{On the Electrodynamics of Moving Bodies}
-\author{A~Einstein\thanks{%
- Gratefully acknowledged is the support of the Swiss Patent Office.}}
-\date{1905-Jun-30}
+\title{Constructing a Nuclear Reactor Using Only Coconuts}
+\author{Jonas Grumby\thanks{%
+ With the support of a Ginger Grant from the Roy Hinkley Society.} \\
+ Skipper, \textit{Minnow}
+ \and
+ Willy Gilligan\thanks{%
+ Thanks to the Mary Ann Summers foundation
+ and to Thurston and Lovey Howell.} \\
+ Mate, \textit{Minnow}
+ }
+\date{1964-Sep-26}
\begin{document}
\maketitle
-It is known that Maxwell's electrodynamics---as usually understood at the
-present time---when applied to moving bodies, leads to asymmetries which
-do not appear to be inherent in the phenomena.
- ...
-In conclusion I wish to say that in working at the problem here dealt
-with I have had the loyal assistance of my friend and colleague M~Besso,
-and that I am indebted to him for several valuable suggestions.
-\end{document}
+Just sit right back and you'll hear a tale, a tale of a fateful trip.
+That started from this tropic port, aboard this tiny ship. The mate was
+a mighty sailin' man, the Skipper brave and sure. Five passengers set
+sail that day for a three hour tour. A three hour tour.
+ ...
</pre></div>
-<p>shows the <code>\maketitle</code> command appearing immediately after the
-<code>\begin{document}</code>.
+<p>You tell LaTeX the information used to produce the title by making
+the following declarations. These must come before the
+<code>\maketitle</code>, either in the preamble or in the document body.
</p>
-<p>Information used to produce the title is obtained from the following
-declarations. These must come before the <code>\maketitle</code>, either in
-the preamble or in the document body.
-</p>
<dl compact="compact">
-<dt><code>\author{<var>name</var> \and <var>name2</var>}</code>
-<a name="index-_005cauthor_007bname-_005cand-name2_007d"></a>
+<dt><code>\author{<var>name1</var> \and <var>name2</var> \and ...}</code>
+<a name="index-_005cauthor_007bname1-_005cand-name2-_005cand-_002e_002e_002e_007d"></a>
</dt>
<dd><a name="index-author_002c-for-titlepage"></a>
<a name="index-_005c_005c-for-_005cauthor"></a>
<a name="index-_005cand-for-_005cauthor"></a>
<p>Required. Declare the document author or authors. The argument is a
-list of authors separated by <code>\and</code> commands. Use <code>\\</code> to
-separate lines within a single author’s entry—for example, to give the
-author’s institution or address. If you omit this then you get
-‘<samp>LaTeX Warning: No \author given</samp>’.
+list of authors separated by <code>\and</code> commands. To separate lines
+within a single author’s entry, for instance to give the author’s
+institution or address, use a double blackslash, <code>\\</code>. If you omit
+the <code>\author</code> declaration then you get ‘<samp>LaTeX Warning: No
+\author given</samp>’.
</p>
</dd>
<dt><code>\date{<var>text</var>}</code>
<a name="index-_005cdate_007btext_007d"></a>
</dt>
<dd><a name="index-date_002c-for-titlepage"></a>
-<p>Optional. Declare <var>text</var> to be the document’s date. If you omit it
-then LaTeX uses the current date (see <a href="#g_t_005ctoday">\today</a>).
+<p>Optional. Declare <var>text</var> to be the document’s date. The <var>text</var>
+doesn’t need to be in a date format; it can be any text at all. If you
+omit <code>\date</code> then LaTeX uses the current date (see <a href="#g_t_005ctoday">\today</a>).
+To have no date, instead use <code>\date{}</code>.
</p>
</dd>
<dt><code>\thanks{<var>text</var>}</code>
@@ -13751,8 +13766,10 @@
</dt>
<dd><a name="index-thanks_002c-for-titlepage"></a>
<a name="index-credit-footnote"></a>
-<p>Optional. Produce a footnote to the title, usually for
-acknowledgements.
+<p>Optional. Produce a footnote. You can use it in the author information
+for acknowledgements, as illustrated below, but you can also use it in
+the title, or any place a footnote makes sense. It can be any text so
+you can use it to print an email address, or for any purpose.
</p>
</dd>
<dt><code>\title{<var>text</var>}</code>
@@ -13760,13 +13777,20 @@
</dt>
<dd><a name="index-title_002c-for-titlepage"></a>
<a name="index-_005c_005c-for-_005ctitle"></a>
-<p>Required. Declare <var>text</var> to be the title of the document. Inside
-<var>text</var>, use <code>\\</code> to get line breaks. If you omit this command
-then you get ‘<samp>LaTeX Error: No \title given</samp>’.
+<p>Required. Declare <var>text</var> to be the title of the document. Get line
+breaks inside <var>text</var> with a double backslash, <code>\\</code>. If you
+omit the <code>\title</code> declaration then you get ‘<samp>LaTeX Error: No
+\title given</samp>’.
</p>
</dd>
</dl>
+<p>Many publishers will provide a class to use in place of <code>article</code>
+in that example, that formats the title according to their house
+requirements. To make your own, see <a href="#titlepage">titlepage</a>. You can
+either create this as a one-off or you can include it as part of a
+renewed <code>\maketitle</code> command.
+</p>
<hr>
<a name="g_t_005cpagenumbering"></a>
@@ -13783,35 +13807,73 @@
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\pagenumbering{<var>style</var>}
+<pre class="example">\pagenumbering{<var>number-style</var>}
</pre></div>
-<p>Specifies the style of page numbers, according to <var>style</var>; also
-resets the page number to 1. The <var>style</var> argument is one of
-the following:
+<p>Specifies the style of page numbers, and resets the page number. The
+numbering style is reflected on the page, and also in the table of
+contents and other page references. This declaration has global scope
+so its effect is not delimited by braces or environments.
</p>
+<p>In this example, before the Main section the pages are numbered
+‘<samp>a</samp>’, etc. Starting on the page containing that section, the pages
+are numbered ‘<samp>1</samp>’, etc.
+</p>
+<div class="example">
+<pre class="example">\begin{document}\pagenumbering{alph}
+ ...
+\section{Main}\pagenumbering{arabic}
+ ...
+</pre></div>
+
+
+<p>The argument <var>number-style</var> is one of the following (see
+also <a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a>).
+</p>
<dl compact="compact">
<dt><code>arabic</code></dt>
-<dd><p>arabic numerals
+<dd><p>arabic numerals: 1, 2, …
</p>
</dd>
<dt><code>roman</code></dt>
-<dd><p>lowercase Roman numerals
+<dd><p>lowercase Roman numerals: i, ii, …
</p>
</dd>
<dt><code>Roman</code></dt>
-<dd><p>uppercase Roman numerals
+<dd><p>uppercase Roman numerals: I, II, …
</p>
</dd>
<dt><code>alph</code></dt>
-<dd><p>lowercase letters
+<dd><p>lowercase letters: a, b, … If you have more than 26 pages then you
+get ‘<samp>LaTeX Error: Counter too large</samp>’.
</p>
</dd>
<dt><code>Alph</code></dt>
-<dd><p>uppercase letters
-</p></dd>
+<dd><p>uppercase letters: A, B, … If you have more than 26 pages then you
+get ‘<samp>LaTeX Error: Counter too large</samp>’.
+</p>
+</dd>
+<dt><code>gobble</code></dt>
+<dd><a name="index-package_002c-hyperref-1"></a>
+<a name="index-hyperref-package-1"></a>
+<p>LaTeX does not output a page number, although it
+does get reset. References to that page also are blank. (This does not
+work with the popular package <samp>hyperref</samp> so to have the page number
+not appear you may want to instead use <code>\pagestyle{empty}</code> or
+<code>\thispagestyle{empty}</code>.)
+</p>
+</dd>
</dl>
+<p>Traditionally, if a document has front matter—preface, table of
+contents, etc.—then it is numbered with lower case Roman numerals. The
+main matter of a document uses arabic.
+</p>
+<p>If you want to address where the page number appears on the page,
+see <a href="#g_t_005cpagestyle">\pagestyle</a>. If you want to change the value of page
+number then you will manipulate the <code>page</code> counter
+(see <a href="#Counters">Counters</a>).
+</p>
<hr>
<a name="g_t_005cpagestyle"></a>
@@ -13833,8 +13895,8 @@
<pre class="example">\pagestyle{<var>style</var>}
</pre></div>
-<p>The <code>\pagestyle</code> command specifies how the headers and footers
-are typeset from the current page onwards. Values for <var>style</var>:
+<p>Specifies how the page headers and footers are typeset, from the current
+page onwards. Values for <var>style</var>:
</p>
<dl compact="compact">
<dt><code>plain</code></dt>
@@ -13886,16 +13948,24 @@
<p>
Previous: <a href="#g_t_005cpagestyle" accesskey="p" rel="prev">\pagestyle</a>, Up: <a href="#Page-styles" accesskey="u" rel="up">Page styles</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cthispagestyle_007bstyle_007d"></a>
-<h3 class="section">18.4 <code>\thispagestyle{<var>style</var>}</code></h3>
+<a name="g_t_005cthispagestyle-1"></a>
+<h3 class="section">18.4 <code>\thispagestyle</code></h3>
<a name="index-_005cthispagestyle"></a>
+<a name="index-page-style_002c-this-page"></a>
-<p>The <code>\thispagestyle</code> command works in the same manner as the
-<code>\pagestyle</code> command (see previous section) except that it
-changes to <var>style</var> for the current page only.
+<p>Synopsis:
</p>
+<div class="example">
+<pre class="example">\thispagestyle{<var>style</var>}
+</pre></div>
+<p>Works in the same way as the <code>\pagestyle</code> (see <a href="#g_t_005cpagestyle">\pagestyle</a>),
+except that it changes to <var>style</var> for the current page only. This
+declaration has global scope, so its effect is not delimited by braces
+or environments.
+</p>
+
<hr>
<a name="Spaces"></a>
<div class="header">
@@ -17236,22 +17306,28 @@
<p>Regardless of how many separate files you use, there is always one
<a name="index-root-file"></a>
<a name="index-file_002c-root"></a>
-<em>root file</em>, on which LaTeX compilation starts.
-This shows such a file with three included files.
+<em>root file</em>, on which LaTeX compilation starts. This shows such
+a file with five included files.
</p>
<div class="example">
<pre class="example">\documentclass{book}
-\includeonly{ % comment out lines here to skip compiling those parts
+\includeonly{ % comment out lines here to shortcut compiling those parts
pref,
chap1,
- chap2
+ chap2,
+ append,
+ bib
}
\begin{document}
\frontmatter
\include{pref}
\mainmatter
\include{chap1}
-\include{chap2}
+\include{chap2}
+\appendix
+\include{append}
+\backmatter
+\include{bib}
\end{document}
</pre></div>
@@ -18687,7 +18763,7 @@
<tr><td></td><td valign="top"><a href="#index-bulleted-lists">bulleted lists</a>:</td><td> </td><td valign="top"><a href="#itemize">itemize</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-C">C</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-caligraphic">caligraphic</a>:</td><td> </td><td valign="top"><a href="#Caligraphic">Caligraphic</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-calligraphic-fonts">calligraphic fonts</a>:</td><td> </td><td valign="top"><a href="#Calligraphic">Calligraphic</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-calligraphic-letters-for-math">calligraphic letters for math</a>:</td><td> </td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cap-height">cap height</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-caron-accent">caron accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
@@ -18887,6 +18963,7 @@
<tr><td></td><td valign="top"><a href="#index-font-symbols_002c-by-number">font symbols, by number</a>:</td><td> </td><td valign="top"><a href="#Symbols-by-font-position">Symbols by font position</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fonts">fonts</a>:</td><td> </td><td valign="top"><a href="#Fonts">Fonts</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fonts_002c-new-commands-for">fonts, new commands for</a>:</td><td> </td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fonts_002c-script">fonts, script</a>:</td><td> </td><td valign="top"><a href="#Calligraphic">Calligraphic</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-footer-style">footer style</a>:</td><td> </td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-footer_002c-parameters-for">footer, parameters for</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-footnote-number_002c-cross-referencing">footnote number, cross referencing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
@@ -18944,6 +19021,7 @@
<tr><td></td><td valign="top"><a href="#index-here_002c-putting-floats">here, putting floats</a>:</td><td> </td><td valign="top"><a href="#Floats">Floats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hungarian-umlaut-accent">hungarian umlaut accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperref-package"><code>hyperref</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hyperref-package-1"><code>hyperref</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cpagenumbering">\pagenumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-defining">hyphenation, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005chyphenation">\hyphenation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-discretionary">hyphenation, discretionary</a>:</td><td> </td><td valign="top"><a href="#g_t_005cdiscretionary">\discretionary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-forcing">hyphenation, forcing</a>:</td><td> </td><td valign="top"><a href="#g_t_005c_002d-_0028hyphenation_0029">\- (hyphenation)</a></td></tr>
@@ -19160,6 +19238,7 @@
<tr><td></td><td valign="top"><a href="#index-package_002c-geometry"><span class="roman">package</span>, <code>geometry</code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-geometry-1"><span class="roman">package</span>, <code>geometry</code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-hyperref"><span class="roman">package</span>, <code>hyperref</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-hyperref-1"><span class="roman">package</span>, <code>hyperref</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cpagenumbering">\pagenumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-indentfirst"><span class="roman">package</span>, <code>indentfirst</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cindent-_0026-_005cnoindent">\indent & \noindent</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-listings"><span class="roman">package</span>, <code>listings</code></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-listings-1"><span class="roman">package</span>, <code>listings</code></a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
@@ -19188,6 +19267,7 @@
<tr><td></td><td valign="top"><a href="#index-page-layout-parameters">page layout parameters</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-page-number_002c-cross-referencing">page number, cross referencing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cpageref">\pageref</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-page-numbering-style">page numbering style</a>:</td><td> </td><td valign="top"><a href="#g_t_005cpagenumbering">\pagenumbering</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-page-style_002c-this-page">page style, this page</a>:</td><td> </td><td valign="top"><a href="#g_t_005cthispagestyle">\thispagestyle</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-page-styles">page styles</a>:</td><td> </td><td valign="top"><a href="#Page-styles">Page styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-page_002c-colored">page, colored</a>:</td><td> </td><td valign="top"><a href="#Colored-pages">Colored pages</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-paragraph-indentation">paragraph indentation</a>:</td><td> </td><td valign="top"><a href="#g_t_005cparindent-_0026-_005cparskip">\parindent & \parskip</a></td></tr>
@@ -19277,6 +19357,7 @@
<tr><td></td><td valign="top"><a href="#index-Scaled-point">Scaled point</a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-scaling">scaling</a>:</td><td> </td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-scaling-1">scaling</a>:</td><td> </td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-script-fonts">script fonts</a>:</td><td> </td><td valign="top"><a href="#Calligraphic">Calligraphic</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-script-letters-for-math">script letters for math</a>:</td><td> </td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-section-number_002c-cross-referencing">section number, cross referencing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-section-numbers_002c-printing">section numbers, printing</a>:</td><td> </td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
@@ -19658,7 +19739,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cAtEndDocument"><code>\AtEndDocument</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cAtEndDocument">\AtEndDocument</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cAtEndOfClass"><code>\AtEndOfClass</code></a>:</td><td> </td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cAtEndOfPackage"><code>\AtEndOfPackage</code></a>:</td><td> </td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_005cauthor_007bname-_005cand-name2_007d"><code>\author{<var>name</var> \and <var>name2</var>}</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cauthor_007bname1-_005cand-name2-_005cand-_002e_002e_002e_007d"><code>\author{<var>name1</var> \and <var>name2</var> \and ...}</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ca_0060-_0028grave-accent-in-tabbing_0029"><code>\a` <span class="roman">(grave accent in tabbing)</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-_005cb-_0028bar_002dunder-accent_0029"><code>\b <span class="roman">(bar-under accent)</span></code></a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbackslash"><code>\backslash</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info 2018-06-07 15:30:12 UTC (rev 642)
+++ trunk/latex2e.info 2018-06-07 20:35:03 UTC (rev 643)
@@ -5545,7 +5545,7 @@
here then TeX puts NO-BREAK
In 'difficult' the three letters 'ffi' form a ligature. But TeX can
-nontheless break between the two f's with this.
+nonetheless break between the two f's with this.
di\discretionary{f-}{fi}{ffi}cult
@@ -5802,7 +5802,7 @@
The starred form '\enlargesthispage*' tries to squeeze the material
together on the page as much as possible, for the common use case of
-geting one more line on the page. This is often used together with an
+getting one more line on the page. This is often used together with an
explicit '\pagebreak'.
@@ -5843,7 +5843,7 @@
since that is where LaTeX breaks that line. In addition, with
'\pagebreak' the vertical space on the page is stretched out where
possible so that it extends to the normal bottom margin. This can look
-wierd, and if '\flushbottom' is in effect this can cause you to get
+strange, and if '\flushbottom' is in effect this can cause you to get
'Underfull \vbox (badness 10000) has occurred while \output is active'.
*Note \newpage:: for a command that does not have these effects.
@@ -6267,7 +6267,7 @@
\newcommand{\lawyers}[3][company]{#2, #3, and~#1}
I employ \lawyers[Howe]{Dewey}{Cheatem}.
- The ouptut is 'I employ Dewey, Cheatem, and Howe'. The optional
+ The output is 'I employ Dewey, Cheatem, and Howe'. The optional
argument, the 'Howe', is associated with '#1', while 'Dewey' and
'Cheatem' are associated with '#2' and '#3'. Because of the optional
argument, '\lawyers{Dewey}{Cheatem}' will give the output 'I employ
@@ -6457,7 +6457,7 @@
Optional; an integer from 0 to 9 denoting the number of arguments
of that the environment will take. When you use the environment
these arguments appear after the '\begin', as in '\begin{ENV}{ARG1}
- .... {ARGN}'. Omiting this is equivalent to setting it to 0; the
+ .... {ARGN}'. Omitting this is equivalent to setting it to 0; the
environment will have no arguments. When redefining an
environment, the new version can have a different number of
arguments than the old version.
@@ -6562,7 +6562,7 @@
The second form, '\newtheorem{NAME}{TITLE}[NUMBERED_WITHIN]', creates
an environment whose counter is subordinate to the existing counter
NUMBERED_WITHIN, so this counter will be reset when NUMBERED_WITHIN is
-reset. See the second e3xample below.
+reset. See the second example below.
The third form '\newtheorem{NAME}[NUMBERED_LIKE]{TITLE}', with
optional argument between the two required arguments, creates an
@@ -8558,11 +8558,11 @@
* Menu:
* Blackboard bold:: Doublestruck characters.
-* Caligraphic:: Cursive characters.
+* Calligraphic:: Cursive characters.
* \boldmath & \unboldmath:: Symbols in boldface.
-File: latex2e.info, Node: Blackboard bold, Next: Caligraphic, Up: Math symbols
+File: latex2e.info, Node: Blackboard bold, Next: Calligraphic, Up: Math symbols
16.2.1 Blackboard bold
----------------------
@@ -8591,10 +8591,10 @@
capital letters; look on CTAN.
-File: latex2e.info, Node: Caligraphic, Next: \boldmath & \unboldmath, Prev: Blackboard bold, Up: Math symbols
+File: latex2e.info, Node: Calligraphic, Next: \boldmath & \unboldmath, Prev: Blackboard bold, Up: Math symbols
-16.2.2 Caligraphic
-------------------
+16.2.2 Calligraphic
+-------------------
Synopsis:
@@ -8612,7 +8612,7 @@
outputs a plus sign.
-File: latex2e.info, Node: \boldmath & \unboldmath, Prev: Caligraphic, Up: Math symbols
+File: latex2e.info, Node: \boldmath & \unboldmath, Prev: Calligraphic, Up: Math symbols
16.2.3 '\boldmath' & '\unboldmath'
----------------------------------
@@ -8626,9 +8626,9 @@
\unboldmath \( MATH \)
Declarations to change the letters and symbols in MATH to be in a
-bold font, or to countermand that and bring back the unbolded default.
-They must be used when not in math mode or display math mode (*note
-Modes::). Both commands are fragile (*note \protect::).
+bold font, or to countermand that and bring back the regular (non-bold)
+default. They must be used when not in math mode or display math mode
+(*note Modes::). Both commands are fragile (*note \protect::).
In this example each '\boldmath' command takes place inside an
'\mbox',
@@ -8709,7 +8709,7 @@
Greatest common divisor
'\hom'
- Homomorphisms
+ Homomorphism
'\inf'
Infinum
@@ -9075,54 +9075,73 @@
18.1 '\maketitle'
=================
-Generate a title. It is on a separate title page, except in the
-'article' class where it is at the top of the first page.
+Synopsis:
- This example
+ \maketitle
+ Generate a title. In the standard classes the title appears on a
+separate page, except in the 'article' class where it is at the top of
+the first page.
+
+ This example shows '\maketitle' appearing in its usual place,
+immediately after '\begin{document}'.
+
\documentclass{article}
- \title{On the Electrodynamics of Moving Bodies}
- \author{A~Einstein\thanks{%
- Gratefully acknowledged is the support of the Swiss Patent Office.}}
- \date{1905-Jun-30}
+ \title{Constructing a Nuclear Reactor Using Only Coconuts}
+ \author{Jonas Grumby\thanks{%
+ With the support of a Ginger Grant from the Roy Hinkley Society.} \\
+ Skipper, \textit{Minnow}
+ \and
+ Willy Gilligan\thanks{%
+ Thanks to the Mary Ann Summers foundation
+ and to Thurston and Lovey Howell.} \\
+ Mate, \textit{Minnow}
+ }
+ \date{1964-Sep-26}
\begin{document}
\maketitle
- It is known that Maxwell's electrodynamics---as usually understood at the
- present time---when applied to moving bodies, leads to asymmetries which
- do not appear to be inherent in the phenomena.
- ...
- In conclusion I wish to say that in working at the problem here dealt
- with I have had the loyal assistance of my friend and colleague M~Besso,
- and that I am indebted to him for several valuable suggestions.
- \end{document}
+ Just sit right back and you'll hear a tale, a tale of a fateful trip.
+ That started from this tropic port, aboard this tiny ship. The mate was
+ a mighty sailin' man, the Skipper brave and sure. Five passengers set
+ sail that day for a three hour tour. A three hour tour.
+ ...
- shows the '\maketitle' command appearing immediately after the
-'\begin{document}'.
+ You tell LaTeX the information used to produce the title by making
+the following declarations. These must come before the '\maketitle',
+either in the preamble or in the document body.
- Information used to produce the title is obtained from the following
-declarations. These must come before the '\maketitle', either in the
-preamble or in the document body.
-
-'\author{NAME \and NAME2}'
+'\author{NAME1 \and NAME2 \and ...}'
Required. Declare the document author or authors. The argument is
- a list of authors separated by '\and' commands. Use '\\' to
- separate lines within a single author's entry--for example, to give
- the author's institution or address. If you omit this then you get
- 'LaTeX Warning: No \author given'.
+ a list of authors separated by '\and' commands. To separate lines
+ within a single author's entry, for instance to give the author's
+ institution or address, use a double blackslash, '\\'. If you omit
+ the '\author' declaration then you get 'LaTeX Warning: No \author
+ given'.
'\date{TEXT}'
- Optional. Declare TEXT to be the document's date. If you omit it
- then LaTeX uses the current date (*note \today::).
+ Optional. Declare TEXT to be the document's date. The TEXT
+ doesn't need to be in a date format; it can be any text at all. If
+ you omit '\date' then LaTeX uses the current date (*note \today::).
+ To have no date, instead use '\date{}'.
'\thanks{TEXT}'
- Optional. Produce a footnote to the title, usually for
- acknowledgements.
+ Optional. Produce a footnote. You can use it in the author
+ information for acknowledgements, as illustrated below, but you can
+ also use it in the title, or any place a footnote makes sense. It
+ can be any text so you can use it to print an email address, or for
+ any purpose.
'\title{TEXT}'
- Required. Declare TEXT to be the title of the document. Inside
- TEXT, use '\\' to get line breaks. If you omit this command then
- you get 'LaTeX Error: No \title given'.
+ Required. Declare TEXT to be the title of the document. Get line
+ breaks inside TEXT with a double backslash, '\\'. If you omit the
+ '\title' declaration then you get 'LaTeX Error: No \title given'.
+ Many publishers will provide a class to use in place of 'article' in
+that example, that formats the title according to their house
+requirements. To make your own, see *note titlepage::. You can either
+create this as a one-off or you can include it as part of a renewed
+'\maketitle' command.
+
File: latex2e.info, Node: \pagenumbering, Next: \pagestyle, Prev: \maketitle, Up: Page styles
@@ -9131,26 +9150,57 @@
Synopsis:
- \pagenumbering{STYLE}
+ \pagenumbering{NUMBER-STYLE}
- Specifies the style of page numbers, according to STYLE; also resets
-the page number to 1. The STYLE argument is one of the following:
+ Specifies the style of page numbers, and resets the page number. The
+numbering style is reflected on the page, and also in the table of
+contents and other page references. This declaration has global scope
+so its effect is not delimited by braces or environments.
+ In this example, before the Main section the pages are numbered 'a',
+etc. Starting on the page containing that section, the pages are
+numbered '1', etc.
+
+ \begin{document}\pagenumbering{alph}
+ ...
+ \section{Main}\pagenumbering{arabic}
+ ...
+
+ The argument NUMBER-STYLE is one of the following (see also *note
+\alph \Alph \arabic \roman \Roman \fnsymbol::).
+
'arabic'
- arabic numerals
+ arabic numerals: 1, 2, ...
'roman'
- lowercase Roman numerals
+ lowercase Roman numerals: i, ii, ...
'Roman'
- uppercase Roman numerals
+ uppercase Roman numerals: I, II, ...
'alph'
- lowercase letters
+ lowercase letters: a, b, ... If you have more than 26 pages then
+ you get 'LaTeX Error: Counter too large'.
'Alph'
- uppercase letters
+ uppercase letters: A, B, ... If you have more than 26 pages then
+ you get 'LaTeX Error: Counter too large'.
+'gobble'
+ LaTeX does not output a page number, although it does get reset.
+ References to that page also are blank. (This does not work with
+ the popular package 'hyperref' so to have the page number not
+ appear you may want to instead use '\pagestyle{empty}' or
+ '\thispagestyle{empty}'.)
+
+ Traditionally, if a document has front matter--preface, table of
+contents, etc.--then it is numbered with lower case Roman numerals. The
+main matter of a document uses arabic.
+
+ If you want to address where the page number appears on the page,
+see *note \pagestyle::. If you want to change the value of page number
+then you will manipulate the 'page' counter (*note Counters::).
+
File: latex2e.info, Node: \pagestyle, Next: \thispagestyle, Prev: \pagenumbering, Up: Page styles
@@ -9161,8 +9211,8 @@
\pagestyle{STYLE}
- The '\pagestyle' command specifies how the headers and footers are
-typeset from the current page onwards. Values for STYLE:
+ Specifies how the page headers and footers are typeset, from the
+current page onwards. Values for STYLE:
'plain'
Just a plain page number.
@@ -9193,13 +9243,18 @@
File: latex2e.info, Node: \thispagestyle, Prev: \pagestyle, Up: Page styles
-18.4 '\thispagestyle{STYLE}'
-============================
+18.4 '\thispagestyle'
+=====================
-The '\thispagestyle' command works in the same manner as the
-'\pagestyle' command (see previous section) except that it changes to
-STYLE for the current page only.
+Synopsis:
+ \thispagestyle{STYLE}
+
+ Works in the same way as the '\pagestyle' (*note \pagestyle::),
+except that it changes to STYLE for the current page only. This
+declaration has global scope, so its effect is not delimited by braces
+or environments.
+
File: latex2e.info, Node: Spaces, Next: Boxes, Prev: Page styles, Up: Top
@@ -11373,13 +11428,15 @@
Regardless of how many separate files you use, there is always one
"root file", on which LaTeX compilation starts. This shows such a file
-with three included files.
+with five included files.
\documentclass{book}
- \includeonly{ % comment out lines here to skip compiling those parts
+ \includeonly{ % comment out lines here to shortcut compiling those parts
pref,
chap1,
- chap2
+ chap2,
+ append,
+ bib
}
\begin{document}
\frontmatter
@@ -11387,6 +11444,10 @@
\mainmatter
\include{chap1}
\include{chap2}
+ \appendix
+ \include{append}
+ \backmatter
+ \include{bib}
\end{document}
This will bring in material from 'pref.tex', 'chap1.tex', and
@@ -12349,7 +12410,7 @@
* ASCII tilde, in text: Text symbols. (line 67)
* asterisk, centered, in text: Text symbols. (line 70)
* at clause, in font definitions: \newfont. (line 19)
-* author, for titlepage: \maketitle. (line 35)
+* author, for titlepage: \maketitle. (line 42)
* auxiliary file: Output files. (line 33)
* babel package: thebibliography. (line 53)
* babel package <1>: Accents. (line 6)
@@ -12395,7 +12456,7 @@
* bullet symbol: Math symbols. (line 119)
* bullet, in text: Text symbols. (line 91)
* bulleted lists: itemize. (line 6)
-* caligraphic: Caligraphic. (line 6)
+* calligraphic fonts: Calligraphic. (line 6)
* calligraphic letters for math: Font styles. (line 74)
* cap height: Text symbols. (line 99)
* caron accent: Accents. (line 97)
@@ -12498,7 +12559,7 @@
* cprotect package <1>: \verb. (line 34)
* creating pictures: picture. (line 6)
* creating tables: table. (line 6)
-* credit footnote: \maketitle. (line 46)
+* credit footnote: \maketitle. (line 56)
* cross references: Cross references. (line 6)
* cross references, resolving: Output files. (line 33)
* cross referencing with page number: \pageref. (line 6)
@@ -12508,7 +12569,7 @@
* dagger, double, in text: Text symbols. (line 107)
* dagger, in text: Text symbols. (line 15)
* dagger, in text <1>: Text symbols. (line 104)
-* date, for titlepage: \maketitle. (line 42)
+* date, for titlepage: \maketitle. (line 50)
* date, today's: \today. (line 6)
* datetime package: \today. (line 22)
* define color: Define colors. (line 6)
@@ -12637,6 +12698,7 @@
(line 6)
* fonts: Fonts. (line 6)
* fonts, new commands for: \newfont. (line 6)
+* fonts, script: Calligraphic. (line 6)
* footer style: \pagestyle. (line 6)
* footer, parameters for: Page layout parameters.
(line 6)
@@ -12702,6 +12764,7 @@
* here, putting floats: Floats. (line 52)
* hungarian umlaut accent: Accents. (line 59)
* hyperref package: \footnotemark. (line 48)
+* hyperref package <1>: \pagenumbering. (line 45)
* hyphenation, defining: \hyphenation. (line 6)
* hyphenation, discretionary: \discretionary. (line 6)
* hyphenation, forcing: \- (hyphenation). (line 6)
@@ -12947,6 +13010,7 @@
* package, geometry <1>: Document class options.
(line 44)
* package, hyperref: \footnotemark. (line 48)
+* package, hyperref <1>: \pagenumbering. (line 45)
* package, indentfirst: \indent & \noindent. (line 48)
* package, listings: tabbing. (line 145)
* package, listings <1>: verbatim. (line 31)
@@ -12984,6 +13048,7 @@
(line 6)
* page number, cross referencing: \pageref. (line 6)
* page numbering style: \pagenumbering. (line 6)
+* page style, this page: \thispagestyle. (line 6)
* page styles: Page styles. (line 6)
* page, colored: Colored pages. (line 6)
* paragraph indentation: \parindent & \parskip.
@@ -13081,6 +13146,7 @@
* Scaled point: Units of length. (line 36)
* scaling: \scalebox. (line 6)
* scaling <1>: \resizebox. (line 6)
+* script fonts: Calligraphic. (line 6)
* script letters for math: Font styles. (line 74)
* section number, cross referencing: \ref. (line 6)
* section numbers, printing: Sectioning. (line 47)
@@ -13174,7 +13240,7 @@
* textcase package: Upper and lower case.
(line 42)
* textcomp package: Font styles. (line 134)
-* thanks, for titlepage: \maketitle. (line 46)
+* thanks, for titlepage: \maketitle. (line 56)
* theorem-like environment: \newtheorem. (line 6)
* theorems, defining: \newtheorem. (line 6)
* theorems, typesetting: theorem. (line 6)
@@ -13188,7 +13254,7 @@
* title page, separate or run-in: Document class options.
(line 71)
* title pages, creating: titlepage. (line 6)
-* title, for titlepage: \maketitle. (line 50)
+* title, for titlepage: \maketitle. (line 63)
* titles, making: \maketitle. (line 6)
* trademark symbol: Text symbols. (line 172)
* transcript file: Output files. (line 28)
@@ -13340,7 +13406,7 @@
(line 19)
* \alsoname: Indexes. (line 20)
* \amalg: Math symbols. (line 33)
-* \and for \author: \maketitle. (line 35)
+* \and for \author: \maketitle. (line 42)
* \angle: Math symbols. (line 36)
* \appendix: Sectioning. (line 37)
* \approx: Math symbols. (line 41)
@@ -13363,7 +13429,7 @@
(line 14)
* \AtEndOfPackage: Class and package commands.
(line 14)
-* \author{NAME \and NAME2}: \maketitle. (line 34)
+* \author{NAME1 \and NAME2 \and ...}: \maketitle. (line 41)
* \a` (grave accent in tabbing): tabbing. (line 103)
* \b (bar-under accent): Accents. (line 46)
* \backslash: Math symbols. (line 56)
@@ -13491,7 +13557,7 @@
* \dagger: Math symbols. (line 157)
* \dashbox: \dashbox. (line 6)
* \dashv: Math symbols. (line 160)
-* \date{TEXT}: \maketitle. (line 41)
+* \date{TEXT}: \maketitle. (line 49)
* \day: \day \month \year. (line 6)
* \dblfloatpagefraction: \twocolumn. (line 69)
* \dblfloatsep: \twocolumn. (line 75)
@@ -14206,7 +14272,7 @@
(line 56)
* \TH (TH): Additional Latin letters.
(line 56)
-* \thanks{TEXT}: \maketitle. (line 45)
+* \thanks{TEXT}: \maketitle. (line 55)
* \theta: Math symbols. (line 729)
* \thicklines: \thicklines. (line 6)
* \thickspace: Spacing in math mode.
@@ -14219,7 +14285,7 @@
* \tilde: Math accents. (line 43)
* \times: Math symbols. (line 733)
* \tiny: Font sizes. (line 11)
-* \title{TEXT}: \maketitle. (line 49)
+* \title{TEXT}: \maketitle. (line 62)
* \to: Math symbols. (line 737)
* \today: \today. (line 6)
* \top: Math symbols. (line 741)
@@ -14305,8 +14371,8 @@
* \\ for letters: Letters. (line 49)
* \\ for tabular: tabular. (line 34)
* \\ for verse: verse. (line 21)
-* \\ for \author: \maketitle. (line 35)
-* \\ for \title: \maketitle. (line 50)
+* \\ for \author: \maketitle. (line 42)
+* \\ for \title: \maketitle. (line 63)
* \\ force line break: \\. (line 6)
* \\* (for eqnarray): eqnarray. (line 37)
* \^: Reserved characters. (line 20)
@@ -14597,158 +14663,158 @@
Node: \newline207864
Node: \- (hyphenation)208802
Node: \discretionary210443
-Node: \fussy & \sloppy211330
-Node: sloppypar212112
-Node: \hyphenation213251
-Node: \linebreak & \nolinebreak213837
-Node: Page breaking214905
-Node: \clearpage & \cleardoublepage216934
-Node: \newpage218416
-Node: \enlargethispage219709
-Node: \pagebreak & \nopagebreak220664
-Node: Footnotes222249
-Node: \footnote223395
-Node: \footnotemark226343
-Node: \footnotetext228688
-Node: Footnotes in section headings229289
-Node: Footnotes in a table230116
-Node: Footnotes of footnotes232994
-Node: Definitions233698
-Node: \newcommand & \renewcommand234575
-Node: \providecommand239786
-Node: \newcounter240935
-Node: \newlength242680
-Node: \newsavebox243540
-Node: \newenvironment & \renewenvironment244484
-Node: \newtheorem249594
-Node: \newfont253123
-Node: \protect254419
-Node: \ignorespaces & \ignorespacesafterend256805
-Node: Counters259554
-Node: \alph \Alph \arabic \roman \Roman \fnsymbol261227
-Node: \usecounter264056
-Node: \value264919
-Node: \setcounter265848
-Node: \addtocounter266450
-Node: \refstepcounter266915
-Node: \stepcounter267573
-Node: \day \month \year267915
-Node: Lengths268460
-Node: Units of length270250
-Node: \setlength271744
-Node: \addtolength272521
-Node: \settodepth273495
-Node: \settoheight274250
-Node: \settowidth275009
-Node: Predefined lengths275792
-Node: Making paragraphs276307
-Node: \par277962
-Node: \indent & \noindent279644
-Node: \parindent & \parskip281200
-Node: Marginal notes282239
-Node: Math formulas284038
-Node: Subscripts & superscripts287959
-Node: Math symbols290072
-Node: Blackboard bold315841
-Node: Caligraphic316616
-Node: \boldmath & \unboldmath317186
-Node: Math functions318693
-Node: Math accents320302
-Node: Spacing in math mode321122
-Node: Math miscellany322669
-Node: Modes325368
-Node: \ensuremath327982
-Node: Page styles328699
-Node: \maketitle329462
-Node: \pagenumbering331502
-Node: \pagestyle331998
-Node: \thispagestyle333139
-Node: Spaces333445
-Node: \hspace334315
-Node: \hfill335270
-Node: \spacefactor335662
-Node: \(SPACE) and \@338374
-Ref: \AT338517
-Node: \frenchspacing339994
-Node: \normalsfcodes340610
-Node: \(SPACE) after control sequence340799
-Node: \thinspace341710
-Node: \/342102
-Node: \hrulefill \dotfill343284
-Node: \addvspace344277
-Node: \bigskip \medskip \smallskip345323
-Node: \vfill346215
-Node: \vspace347084
-Node: Boxes348077
-Node: \mbox348789
-Node: \fbox and \framebox349076
-Node: lrbox349880
-Node: \makebox350238
-Node: \parbox350958
-Node: \raisebox353069
-Node: \savebox353682
-Node: \sbox354097
-Node: \usebox354546
-Node: Color354807
-Node: Color package options355651
-Node: Color models357297
-Node: Commands for color359606
-Node: Define colors360021
-Node: Colored text360736
-Node: Colored boxes363111
-Node: Colored pages364550
-Node: Graphics365243
-Node: Graphics package options367370
-Node: Graphics package configuration370126
-Node: \graphicspath370928
-Node: \DeclareGraphicsExtensions373851
-Node: \DeclareGraphicsRule375648
-Node: Commands for graphics378837
-Node: \includegraphics379342
-Node: \rotatebox392311
-Node: \scalebox395106
-Node: \resizebox396158
-Node: Special insertions397350
-Node: Reserved characters398154
-Node: Upper and lower case399355
-Node: Symbols by font position401270
-Node: Text symbols401890
-Node: Accents405338
-Node: Additional Latin letters407880
-Ref: Non-English characters408051
-Node: \rule409068
-Node: \today409497
-Node: Splitting the input410251
-Node: \endinput411628
-Node: \include & \includeonly412895
-Node: \input416931
-Node: Front/back matter417639
-Node: Tables of contents417844
-Node: \addcontentsline418905
-Node: \addtocontents419923
-Node: Glossaries420456
-Node: Indexes420975
-Node: Letters422608
-Node: \address426274
-Node: \cc427085
-Node: \closing427503
-Node: \encl427780
-Node: \location428195
-Node: \makelabels428459
-Node: \name430611
-Node: \opening430852
-Node: \ps431133
-Node: \signature431422
-Node: \telephone432639
-Node: Terminal input/output433004
-Node: \typein433269
-Node: \typeout433854
-Node: Command line434477
-Node: Document templates435429
-Node: beamer template435836
-Node: book template436487
-Node: tugboat template436855
-Node: Concept Index439219
-Node: Command Index507005
+Node: \fussy & \sloppy211331
+Node: sloppypar212113
+Node: \hyphenation213252
+Node: \linebreak & \nolinebreak213838
+Node: Page breaking214906
+Node: \clearpage & \cleardoublepage216935
+Node: \newpage218417
+Node: \enlargethispage219710
+Node: \pagebreak & \nopagebreak220666
+Node: Footnotes222253
+Node: \footnote223399
+Node: \footnotemark226347
+Node: \footnotetext228692
+Node: Footnotes in section headings229293
+Node: Footnotes in a table230120
+Node: Footnotes of footnotes232998
+Node: Definitions233702
+Node: \newcommand & \renewcommand234579
+Node: \providecommand239790
+Node: \newcounter240939
+Node: \newlength242684
+Node: \newsavebox243544
+Node: \newenvironment & \renewenvironment244488
+Node: \newtheorem249599
+Node: \newfont253127
+Node: \protect254423
+Node: \ignorespaces & \ignorespacesafterend256809
+Node: Counters259558
+Node: \alph \Alph \arabic \roman \Roman \fnsymbol261231
+Node: \usecounter264060
+Node: \value264923
+Node: \setcounter265852
+Node: \addtocounter266454
+Node: \refstepcounter266919
+Node: \stepcounter267577
+Node: \day \month \year267919
+Node: Lengths268464
+Node: Units of length270254
+Node: \setlength271748
+Node: \addtolength272525
+Node: \settodepth273499
+Node: \settoheight274254
+Node: \settowidth275013
+Node: Predefined lengths275796
+Node: Making paragraphs276311
+Node: \par277966
+Node: \indent & \noindent279648
+Node: \parindent & \parskip281204
+Node: Marginal notes282243
+Node: Math formulas284042
+Node: Subscripts & superscripts287963
+Node: Math symbols290076
+Node: Blackboard bold315845
+Node: Calligraphic316621
+Node: \boldmath & \unboldmath317194
+Node: Math functions318713
+Node: Math accents320321
+Node: Spacing in math mode321141
+Node: Math miscellany322688
+Node: Modes325387
+Node: \ensuremath328001
+Node: Page styles328718
+Node: \maketitle329481
+Node: \pagenumbering332397
+Node: \pagestyle334335
+Node: \thispagestyle335457
+Node: Spaces335844
+Node: \hspace336714
+Node: \hfill337669
+Node: \spacefactor338061
+Node: \(SPACE) and \@340773
+Ref: \AT340916
+Node: \frenchspacing342393
+Node: \normalsfcodes343009
+Node: \(SPACE) after control sequence343198
+Node: \thinspace344109
+Node: \/344501
+Node: \hrulefill \dotfill345683
+Node: \addvspace346676
+Node: \bigskip \medskip \smallskip347722
+Node: \vfill348614
+Node: \vspace349483
+Node: Boxes350476
+Node: \mbox351188
+Node: \fbox and \framebox351475
+Node: lrbox352279
+Node: \makebox352637
+Node: \parbox353357
+Node: \raisebox355468
+Node: \savebox356081
+Node: \sbox356496
+Node: \usebox356945
+Node: Color357206
+Node: Color package options358050
+Node: Color models359696
+Node: Commands for color362005
+Node: Define colors362420
+Node: Colored text363135
+Node: Colored boxes365510
+Node: Colored pages366949
+Node: Graphics367642
+Node: Graphics package options369769
+Node: Graphics package configuration372525
+Node: \graphicspath373327
+Node: \DeclareGraphicsExtensions376250
+Node: \DeclareGraphicsRule378047
+Node: Commands for graphics381236
+Node: \includegraphics381741
+Node: \rotatebox394710
+Node: \scalebox397505
+Node: \resizebox398557
+Node: Special insertions399749
+Node: Reserved characters400553
+Node: Upper and lower case401754
+Node: Symbols by font position403669
+Node: Text symbols404289
+Node: Accents407737
+Node: Additional Latin letters410279
+Ref: Non-English characters410450
+Node: \rule411467
+Node: \today411896
+Node: Splitting the input412650
+Node: \endinput414130
+Node: \include & \includeonly415397
+Node: \input419433
+Node: Front/back matter420141
+Node: Tables of contents420346
+Node: \addcontentsline421407
+Node: \addtocontents422425
+Node: Glossaries422958
+Node: Indexes423477
+Node: Letters425110
+Node: \address428776
+Node: \cc429587
+Node: \closing430005
+Node: \encl430282
+Node: \location430697
+Node: \makelabels430961
+Node: \name433113
+Node: \opening433354
+Node: \ps433635
+Node: \signature433924
+Node: \telephone435141
+Node: Terminal input/output435506
+Node: \typein435771
+Node: \typeout436356
+Node: Command line436979
+Node: Document templates437931
+Node: beamer template438338
+Node: book template438989
+Node: tugboat template439357
+Node: Concept Index441721
+Node: Command Index509872
End Tag Table
Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2018-06-07 15:30:12 UTC (rev 642)
+++ trunk/latex2e.texi 2018-06-07 20:35:03 UTC (rev 643)
@@ -31,6 +31,8 @@
@c xx JH \section
@c xx JH ligatures
@c xx JH \xspace
+ at c xx JH \stretch
+ at c xx JH \frontmatter, \mainmatter, \appendix, \backmatter
@c
@c xx The typeset source2e has an index with all kernel
@c xx commands, though some are internal and shouldn't be included.
@@ -11130,68 +11132,89 @@
@cindex titles, making
@findex \maketitle
-Generate a title. It is on a separate title page, except in the
- at code{article} class where it is at the top of the first page.
+Synopsis:
-This example
+ at example
+\maketitle
+ at end example
+Generate a title. In the standard classes the title appears on a
+separate page, except in the @code{article} class where it is at the top
+of the first page.
+
+This example shows @code{\maketitle} appearing in its usual place,
+immediately after @code{\begin@{document@}}.
+
@example
\documentclass@{article@}
-\title@{On the Electrodynamics of Moving Bodies@}
-\author@{A~Einstein\thanks@{%
- Gratefully acknowledged is the support of the Swiss Patent Office.@}@}
-\date@{1905-Jun-30@}
+\title@{Constructing a Nuclear Reactor Using Only Coconuts@}
+\author@{Jonas Grumby\thanks@{%
+ With the support of a Ginger Grant from the Roy Hinkley Society.@} \\
+ Skipper, \textit@{Minnow@}
+ \and
+ Willy Gilligan\thanks@{%
+ Thanks to the Mary Ann Summers foundation
+ and to Thurston and Lovey Howell.@} \\
+ Mate, \textit@{Minnow@}
+ @}
+\date@{1964-Sep-26@}
\begin@{document@}
\maketitle
-It is known that Maxwell's electrodynamics---as usually understood at the
-present time---when applied to moving bodies, leads to asymmetries which
-do not appear to be inherent in the phenomena.
- ...
-In conclusion I wish to say that in working at the problem here dealt
-with I have had the loyal assistance of my friend and colleague M~Besso,
-and that I am indebted to him for several valuable suggestions.
-\end@{document@}
+Just sit right back and you'll hear a tale, a tale of a fateful trip.
+That started from this tropic port, aboard this tiny ship. The mate was
+a mighty sailin' man, the Skipper brave and sure. Five passengers set
+sail that day for a three hour tour. A three hour tour.
+ ...
@end example
-shows the @code{\maketitle} command appearing immediately after the
- at code{\begin@{document@}}.
+You tell @LaTeX{} the information used to produce the title by making
+the following declarations. These must come before the
+ at code{\maketitle}, either in the preamble or in the document body.
-Information used to produce the title is obtained from the following
-declarations. These must come before the @code{\maketitle}, either in
-the preamble or in the document body.
-
@ftable @code
- at item \author@{@var{name} \and @var{name2}@}
+ at item \author@{@var{name1} \and @var{name2} \and ...@}
@cindex author, for titlepage
@findex \\ @r{for @code{\author}}
@findex \and @r{for @code{\author}}
Required. Declare the document author or authors. The argument is a
-list of authors separated by @code{\and} commands. Use @code{\\} to
-separate lines within a single author's entry---for example, to give the
-author's institution or address. If you omit this then you get
- at samp{LaTeX Warning: No \author given}.
+list of authors separated by @code{\and} commands. To separate lines
+within a single author's entry, for instance to give the author's
+institution or address, use a double blackslash, @code{\\}. If you omit
+the @code{\author} declaration then you get @samp{LaTeX Warning: No
+\author given}.
@item \date@{@var{text}@}
@cindex date, for titlepage
-Optional. Declare @var{text} to be the document's date. If you omit it
-then @LaTeX{} uses the current date (@pxref{\today}).
+Optional. Declare @var{text} to be the document's date. The @var{text}
+doesn't need to be in a date format; it can be any text at all. If you
+omit @code{\date} then @LaTeX{} uses the current date (@pxref{\today}).
+To have no date, instead use @code{\date@{@}}.
@item \thanks@{@var{text}@}
@cindex thanks, for titlepage
@cindex credit footnote
-Optional. Produce a footnote to the title, usually for
-acknowledgements.
+Optional. Produce a footnote. You can use it in the author information
+for acknowledgements, as illustrated below, but you can also use it in
+the title, or any place a footnote makes sense. It can be any text so
+you can use it to print an email address, or for any purpose.
@item \title@{@var{text}@}
@cindex title, for titlepage
@findex \\ @r{for @code{\title}}
-Required. Declare @var{text} to be the title of the document. Inside
- at var{text}, use @code{\\} to get line breaks. If you omit this command
-then you get @samp{LaTeX Error: No \title given}.
+Required. Declare @var{text} to be the title of the document. Get line
+breaks inside @var{text} with a double backslash, @code{\\}. If you
+omit the @code{\title} declaration then you get @samp{LaTeX Error: No
+\title given}.
@end ftable
+Many publishers will provide a class to use in place of @code{article}
+in that example, that formats the title according to their house
+requirements. To make your own, see at tie{}@ref{titlepage}. You can
+either create this as a one-off or you can include it as part of a
+renewed @code{\maketitle} command.
+
@node \pagenumbering
@section @code{\pagenumbering}
@@ -11201,31 +11224,67 @@
Synopsis:
@example
-\pagenumbering@{@var{style}@}
+\pagenumbering@{@var{number-style}@}
@end example
-Specifies the style of page numbers, according to @var{style}; also
-resets the page number to 1. The @var{style} argument is one of
-the following:
+Specifies the style of page numbers, and resets the page number. The
+numbering style is reflected on the page, and also in the table of
+contents and other page references. This declaration has global scope
+so its effect is not delimited by braces or environments.
+In this example, before the Main section the pages are numbered
+ at samp{a}, etc. Starting on the page containing that section, the pages
+are numbered @samp{1}, etc.
+
+ at example
+\begin@{document@}\pagenumbering@{alph@}
+ ...
+\section@{Main@}\pagenumbering@{arabic@}
+ ...
+ at end example
+
+ at c xx See also \frontmatter, ...
+
+The argument @var{number-style} is one of the following (see
+also at tie{}@ref{\alph \Alph \arabic \roman \Roman \fnsymbol}).
+
@table @code
@item arabic
-arabic numerals
+arabic numerals: 1, 2, @dots{}
@item roman
-lowercase Roman numerals
+lowercase Roman numerals: i, ii, @dots{}
@item Roman
-uppercase Roman numerals
+uppercase Roman numerals: I, II, @dots{}
@item alph
-lowercase letters
+lowercase letters: a, b, @dots{} If you have more than 26 pages then you
+get @samp{LaTeX Error: Counter too large}.
@item Alph
-uppercase letters
+uppercase letters: A, B, @dots{} If you have more than 26 pages then you
+get @samp{LaTeX Error: Counter too large}.
+
+ at item gobble
+ at PkgIndex{hyperref} @LaTeX{} does not output a page number, although it
+does get reset. References to that page also are blank. (This does not
+work with the popular package @file{hyperref} so to have the page number
+not appear you may want to instead use @code{\pagestyle@{empty@}} or
+ at code{\thispagestyle@{empty@}}.)
+
@end table
+Traditionally, if a document has front matter---preface, table of
+contents, etc.---then it is numbered with lower case Roman numerals. The
+main matter of a document uses arabic.
+If you want to address where the page number appears on the page,
+see at tie{}@ref{\pagestyle}. If you want to change the value of page
+number then you will manipulate the @code{page} counter
+(@pxref{Counters}).
+
+
@node \pagestyle
@section @code{\pagestyle}
@@ -11240,8 +11299,8 @@
\pagestyle@{@var{style}@}
@end example
-The @code{\pagestyle} command specifies how the headers and footers
-are typeset from the current page onwards. Values for @var{style}:
+Specifies how the page headers and footers are typeset, from the current
+page onwards. Values for @var{style}:
@table @code
@item plain
@@ -11278,15 +11337,23 @@
@node \thispagestyle
- at section @code{\thispagestyle@{@var{style}@}}
+ at section @code{\thispagestyle}
@findex \thispagestyle
+ at cindex page style, this page
-The @code{\thispagestyle} command works in the same manner as the
- at code{\pagestyle} command (see previous section) except that it
-changes to @var{style} for the current page only.
+Synopsis:
+ at example
+\thispagestyle@{@var{style}@}
+ at end example
+Works in the same way as the @code{\pagestyle} (@pxref{\pagestyle}),
+except that it changes to @var{style} for the current page only. This
+declaration has global scope, so its effect is not delimited by braces
+or environments.
+
+
@node Spaces
@chapter Spaces
@@ -13993,22 +14060,28 @@
Regardless of how many separate files you use, there is always one
@cindex root file
@cindex file, root
- at dfn{root file}, on which @LaTeX{} compilation starts.
-This shows such a file with three included files.
+ at dfn{root file}, on which @LaTeX{} compilation starts. This shows such
+a file with five included files.
@example
\documentclass@{book@}
-\includeonly@{ % comment out lines here to skip compiling those parts
+\includeonly@{ % comment out lines here to shortcut compiling those parts
pref,
chap1,
- chap2
+ chap2,
+ append,
+ bib
@}
\begin@{document@}
\frontmatter
\include@{pref@}
\mainmatter
\include@{chap1@}
-\include@{chap2@}
+\include@{chap2@}
+\appendix
+\include@{append@}
+\backmatter
+\include@{bib@}
\end@{document@}
@end example
More information about the latexrefman-commits
mailing list