[latexrefman-commits] [SCM] latexrefman updated: r667 - trunk
jimhefferon at gnu.org.ua
jimhefferon at gnu.org.ua
Fri Jun 29 13:00:36 CEST 2018
Author: jimhefferon
Date: 2018-06-29 14:00:36 +0300 (Fri, 29 Jun 2018)
New Revision: 667
Modified:
trunk/ChangeLog
trunk/latex2e.html
trunk/latex2e.info
trunk/latex2e.pdf
trunk/latex2e.texi
Log:
Fixing overfull and underfull lines; through page 100.
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2018-06-28 18:51:27 UTC (rev 666)
+++ trunk/ChangeLog 2018-06-29 11:00:36 UTC (rev 667)
@@ -1,3 +1,8 @@
+2018-06-29 Jim Hefferon <jhefferon at smcvt.edu>
+
+ * latex2e.texi (Many sections) Fix over- and underfull lines in PDF.
+ Through page 100.
+
2018-06-28 Jim Hefferon <jhefferon at smcvt.edu>
* latex2e.texi (Command line) Fix synopsis calling syntax. Added
Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html 2018-06-28 18:51:27 UTC (rev 666)
+++ trunk/latex2e.html 2018-06-29 11:00:36 UTC (rev 667)
@@ -1104,9 +1104,9 @@
in their names see <a href="http://ctan.org/pkg/macros2e">http://ctan.org/pkg/macros2e</a>. These macros are
mainly intended to package or class authors.
</p>
-<p>The example below is typical. In the user’s class file is a command
-<code>\thesis at universityname</code>. The user wants to change the
-definition. These three lines should go in the preamble, before the
+<p>In this example the class file has a command
+<code>\thesis at universityname</code> that the user wants to change. These
+three lines should go in the preamble, before the
<code>\begin{document}</code>.
</p>
<div class="example">
@@ -1138,8 +1138,8 @@
</p>
<div class="example">
<pre class="example">\newcommand{\mycmd}{\@ifstar{\mycmd at star}{\mycmd at nostar}}
-\newcommand{\mycmd at nostar}[<var>non-starred command number of args</var>]{<var>body of non-starred command</var>}
-\newcommand{\mycmd at star}[<var>starred command number of args</var>]{<var>body of starred command</var>}
+\newcommand{\mycmd at nostar}[<var>nostar-num-args</var>]{<var>nostar-body</var>}
+\newcommand{\mycmd at star}[<var>star-num-args</var>]{<var>star-body</var>}
</pre></div>
<p>Many standard LaTeX environments or commands have a variant with the
@@ -1174,15 +1174,16 @@
</pre></div>
<p>In the next example, the starred variant takes a different number of
-arguments than does the unstarred one. With this definition, Agent
-007’s <code>``My name is \agentsecret*{Bond},
-\agentsecret{James}{Bond}.''</code> is equivalent to <code>``My name is
-\textsc{Bond}, \textit{James} textsc{Bond}.''</code>
+arguments than the unstarred one. With this definition, Agent 007’s
+<code>``My name is \agentsecret*{Bond},
+\agentsecret{James}{Bond}.''</code> is equivalent to entering the commands
+<code>``My name is \textsc{Bond}, \textit{James} textsc{Bond}.''</code>
</p>
<div class="example">
<pre class="example">\newcommand*{\agentsecret at unstarred}[2]{\textit{#1} \textsc{#2}}
\newcommand*{\agentsecret at starred}[1]{\textsc{#1}}
-\newcommand*{\agentsecret}{\@ifstar{\agentsecret at starred}{\agentsecret at unstarred}}
+\newcommand*{\agentsecret}{%
+ \@ifstar{\agentsecret at starred}{\agentsecret at unstarred}}
</pre></div>
<p>There are two sometimes more convenient ways to accomplish the work of
@@ -1691,10 +1692,10 @@
<a name="index-package-options-1"></a>
<a name="index-options_002c-class"></a>
<a name="index-options_002c-package-1"></a>
-<p>Make an option available to a user, for invoking in their
+<p>Make an option available to a user to invoke in their
<code>\documentclass</code> command. For example, the <code>smcmemo</code> class
-could have an option allowing users to put the institutional logo on the
-first page with <code>\documentclass[logo]{smcmemo}</code>. The class file
+could have an option <code>\documentclass[logo]{smcmemo}</code> allowing
+users to put the institutional logo on the first page. The class file
must contain <code>\DeclareOption{logo}{<var>code</var>}</code> (and later,
<code>\ProcessOptions</code>).
</p>
@@ -1743,14 +1744,14 @@
</p>
<a name="index-package_002c-etoolbox"></a>
<a name="index-etoolbox-package"></a>
-
-<p>The <code>etoolbox</code> package offers commands <code>\newrobustcmd</code>,
-<code>\newrobustcmd*</code>, <code>\renewrobustcmd</code>, <code>\renewrobustcmd*</code>,
-<code>\providerobustcmd</code>, and <code>\providerobustcmd*</code> which are similar
-to <code>\newcommand</code>, <code>\newcommand*</code>, <code>\renewcommand</code>,
-<code>\renewcommand*</code>, <code>\providecommand</code>, and
-<code>\providecommand*</code>, but define a robust <var>cmd</var> with two advantages
-as compared to <code>\DeclareRobustCommand</code>:
+<p>The <samp>etoolbox</samp> package offers the commands
+<code>\newrobustcmd</code>, <code>\newrobustcmd*</code>, as well as the commands
+<code>\renewrobustcmd</code>, <code>\renewrobustcmd*</code>, and the commands
+<code>\providerobustcmd</code>, and <code>\providerobustcmd*</code>. These are
+similar to <code>\newcommand</code>, <code>\newcommand*</code>,
+<code>\renewcommand</code>, <code>\renewcommand*</code>, <code>\providecommand</code>, and
+<code>\providecommand*</code>, but define a robust <var>cmd</var> with two
+advantages as compared to <code>\DeclareRobustCommand</code>:
</p><ol>
<li> They use the low-level e-TeX protection mechanism rather than the
higher level LaTeX <code>\protect</code> mechanism, so they do not incur
@@ -1768,13 +1769,18 @@
<dt><code>\InputIfFileExists{<var>file name</var>}{<var>true code</var>}{<var>false code</var>}</code></dt>
<dd><a name="index-_005cIfFileExists"></a>
<a name="index-_005cInputIfFileExists"></a>
-<p>Execute <var>true code</var> if LaTeX can find the file <samp><var>file
-name</var></samp> and <var>false code</var> otherwise. In the second case it inputs the
-file immediately after executing <var>true code</var>. Thus
-<code>\IfFileExists{img.pdf}{\includegraphics{img.pdf}}{\typeout{WARNING:
-img.pdf not found}}</code> will include the graphic <samp>img.pdf</samp> if it is
-found but otherwise just give a warning.
+<p>Execute <var>true code</var> if LaTeX finds the file <samp><var>file
+name</var></samp> or <var>false code</var> otherwise. In the first case it executing
+<var>true code</var> and then inputs the file. Thus the command
</p>
+<div class="example">
+<pre class="example">\IfFileExists{img.pdf}{%
+ \includegraphics{img.pdf}}{\typeout{!! img.pdf not found}
+</pre></div>
+
+<p>will include the graphic <samp>img.pdf</samp> if it is found and otherwise
+give a warning.
+</p>
<p>This command looks for the file in all search paths that LaTeX uses,
not only in the current directory. To look only in the current
directory do something like <code>\IfFileExists{./filename}{<var>true
@@ -1796,12 +1802,16 @@
<var>release date</var> is optional. If present it must have the form
<var>YYYY/MM/DD</var>.
</p>
-<p>If you request a <var>release date</var> and the date of
-the package installed on your system is earlier, then you get a warning
-on the screen and in the log like <code>You have requested, on input
-line 4, version `2038/01/19' of document class article, but only version
-`2014/09/29 v1.4h Standard LaTeX document class' is available.</code>
+<p>If you request a <var>release date</var> and the date of the package
+installed on your system is earlier, then you get a warning on the
+screen and in the log like this.
</p>
+<div class="example">
+<pre class="example">You have requested, on input line 4, version `2038/01/19' of
+document class article, but only version `2014/09/29 v1.4h
+Standard LaTeX document class' is available.
+</pre></div>
+
<p>The command version <code>\LoadClassWithOptions</code> uses the list of
options for the current class. This means it ignores any options passed
to it via <code>\PassOptionsToClass</code>. This is a convenience command
@@ -1835,10 +1845,13 @@
features, include the optional <var>format date</var> on which those features
were implemented. If present it must be in the form <code>YYYY/MM/DD</code>.
If the format version installed on your system is earlier than
-<var>format date</var> then you get a warning like ‘<samp>You have requested
-release `2038/01/20' of LaTeX, but only release `2016/02/01' is
-available.</samp>’
+<var>format date</var> then you get a warning like this.
</p>
+<div class="example">
+<pre class="example">You have requested release `2038/01/20' of LaTeX, but only
+release `2016/02/01' is available.
+</pre></div>
+
</dd>
<dt><code>\OptionNotUsed</code></dt>
<dd><a name="index-_005cOptionNotUsed"></a>
@@ -1865,18 +1878,23 @@
</p>
<p>If your own code is bringing in a package twice then you can collapse
that to once, for example replacing the two
-<code>\RequirePackage[landscape]{geometry}\RequirePackage[margins=1in]{geometry}</code>
-with the single
-<code>\RequirePackage[landscape,margins=1in]{geometry}</code>. But if you
-are loading a package that in turn loads another package then you need
-to queue up the options you desire for this other package. For
-instance, suppose the package <code>foo</code> loads the package
-<code>geometry</code>. Instead of
-<code>\RequirePackage{foo}\RequirePackage[draft]{graphics}</code> you must
-write <code>\PassOptionsToPackage{draft}{graphics}
-\RequirePackage{foo}</code>. (If <code>foo.sty</code> loads an option in conflict
-with what you want then you may have to look into altering its source.)
+<code>\RequirePackage[landscape]{geometry}</code> and
+<code>\RequirePackage[margins=1in]{geometry}</code> with the single command
+<code>\RequirePackage[landscape,margins=1in]{geometry}</code>.
</p>
+<p>However, imagine that you are loading <samp>firstpkg</samp> and inside that
+package it loads <samp>secondpkg</samp>, and you need the second package to be
+loaded with option <code>draft</code>. Then before doing the first package
+you must queue up the options for the second package, like this.
+</p>
+<div class="example">
+<pre class="example">\PassOptionsToPackage{draft}{secondpkg}
+\RequirePackage{firstpkg}
+</pre></div>
+
+<p>(If <code>firstpkg.sty</code> loads an option in conflict with what you want
+then you may have to alter its source.)
+</p>
<p>These commands are useful for general users as well as class and package
writers. For instance, suppose a user wants to load the <code>graphicx</code>
package with the option <code>draft</code> and also wants to use a class
@@ -1934,34 +1952,36 @@
<dt><code>\ProvidesPackage{<var>package name</var>}[<var>release date</var>]</code></dt>
<dd><a name="index-_005cProvidesClass"></a>
<a name="index-_005cProvidesPackage"></a>
-<p>Identifies the class or package, printing a message to the screen and the log file.
+<p>Identifies the class or package, printing a message to the screen and
+the log file.
</p>
-<p>When a user writes <code>\documentclass{smcmemo}</code> then LaTeX loads
-the file <samp>smcmemo.cls</samp>. Similarly, a user writing
-<code>\usepackage{test}</code> prompts LaTeX to load the file
-<code>test.sty</code>. If the name of the file does not match the declared
-class or package name then you get a warning. Thus, if you invoke
+<p>When you load a class or package, for example with
+<code>\documentclass{smcmemo}</code> or <code>\usepackage{test}</code>, LaTeX
+inputs a file. If the name of the file does not match the class or
+package name declared in it then you get a warning. Thus, if you invoke
<code>\documentclass{smcmemo}</code>, and the file <samp>smcmemo.cls</samp> has
the statement <code>\ProvidesClass{xxx}</code> then you get a warning like
<code>You have requested document class `smcmemo', but the document
class provides 'xxx'.</code> This warning does not prevent LaTeX from
processing the rest of the class file normally.
</p>
-<p>If you include the optional argument, then you must include the date, before
-the first space if any, and it must have the form <code>YYYY/MM/DD</code>. The rest
-of the optional argument is free-form, although it traditionally identifies
-the class, and is written to the screen during compilation and to the
-log file. Thus, if your file <samp>smcmemo.cls</samp> contains the line
-<code>\ProvidesClass{smcmemo}[2008/06/01 v1.0 SMC memo class]</code> and your
-document’s first line is <code>\documentclass{smcmemo}</code> then you will
-see <code>Document Class: smcmemo 2008/06/01 v1.0 SMC memo class</code>.
+<p>If you include the optional argument then you must include a date,
+before any spaces, of the form <code>YYYY/MM/DD</code>. The rest of the
+optional argument is free-form, although it traditionally identifies the
+class, and is written to the screen during compilation and to the log
+file. Thus, if your file <samp>smcmemo.cls</samp> contains the line
+<code>\ProvidesClass{smcmemo}[2008/06/01 v1.0 SMC memo class]</code> and
+your document’s first line is <code>\documentclass{smcmemo}</code> then you
+will see <code>Document Class: smcmemo 2008/06/01 v1.0 SMC memo class</code>.
</p>
<p>The date in the optional argument allows class and package users to ask
-to be warned if the version of the class or package installed on their
-system is earlier than <var>release date</var>, by using the optional arguments
-such as <code>\documentclass{smcmemo}[2018/10/12]</code> or
-<code>\usepackage{foo}[[2017/07/07]]</code>. (Note that package users only
-rarely include a date, and class users almost never do.)
+to be warned if the version of the class or package is earlier than
+<var>release date</var>. For instance, a user could enter
+<code>\documentclass{smcmemo}[2018/10/12]</code> or
+<code>\usepackage{foo}[[2017/07/07]]</code> to require a class or package
+with certain features by specifying that it must be released no earlier
+than the given date. (Although, in practice package users only rarely
+include a date, and class users almost never do.)
</p>
</dd>
<dt><code>\ProvidesFile{<var>file name</var>}[<var>additional information</var>]</code></dt>
@@ -1978,11 +1998,10 @@
<dt><code>\RequirePackageWithOptions{<var>package name</var>}[<var>release date</var>]</code></dt>
<dd><a name="index-_005cRequirePackage"></a>
<a name="index-_005cRequirePackageWithOptions"></a>
-<p>Load a package, like the document author command <code>\usepackage</code>.
-See <a href="#Additional-packages">Additional packages</a>. An example is
-<code>\RequirePackage[landscape,margin=1in]{geometry}</code>. Note that the
-LaTeX development team strongly recommends use of these commands over
-Plain TeX’s <code>\input</code>; see the Class Guide.
+<p>Load a package, like the command <code>\usepackage</code> (see <a href="#Additional-packages">Additional packages</a>). The LaTeX development team strongly recommends use of
+these commands over Plain TeX’s <code>\input</code>; see the Class
+Guide. An example is
+<code>\RequirePackage[landscape,margin=1in]{geometry}</code>.
</p>
<p>The <var>option list</var>, if present, is a comma-separated list. The
<var>release date</var>, if present, must have the form <var>YYYY/MM/DD</var>. If
@@ -2688,7 +2707,7 @@
to avoid going to float pages so soon.
</li></ul>
-<p>You can redefine it, for instance with
+<p>You can redefine it, as with
<code>\renewcommand{\dbltopfraction}{0.9}</code>.
</p>
</dd>
@@ -2942,7 +2961,7 @@
</dt>
<dd><a name="index-_005cpaperheight-1"></a>
<p>The height of the paper, as distinct from the height of the print area.
-It is normally set with a document class option, as in
+Normally set with a document class option, as in
<code>\documentclass[a4paper]{article}</code> (see <a href="#Document-class-options">Document class options</a>).
</p>
</dd>
@@ -2951,7 +2970,7 @@
</dt>
<dd><a name="index-_005cpaperwidth-1"></a>
<p>The width of the paper, as distinct from the width of the print area.
-It is normally set with a document class option, as in
+Normally set with a document class option, as in
<code>\documentclass[a4paper]{article}</code> (see <a href="#Document-class-options">Document class options</a>).
</p>
</dd>
@@ -3173,8 +3192,9 @@
</p></dd>
</dl>
-<p>Parameters relating to vertical space around floats (change them with
-<code>\setlength{<var>parameter</var>}{<var>length expression</var>}</code>):
+<p>Parameters relating to vertical space around floats (change them with a
+command of the form <code>\setlength{<var>parameter</var>}{<var>length
+expression</var>}</code>):
</p>
<dl compact="compact">
<dt><code>\floatsep</code>
@@ -3203,8 +3223,9 @@
</p></dd>
</dl>
-<p>Counters relating to the number of floats on a page (change them with
-<code>\setcounter{<var>ctrname</var>}{<var>natural number</var>}</code>):
+<p>Counters relating to the number of floats on a page (change them with a
+command of the form <code>\setcounter{<var>ctrname</var>}{<var>natural
+number</var>}</code>):
</p>
<dl compact="compact">
<dt><code>bottomnumber</code>
@@ -3281,7 +3302,7 @@
<var>sectioning-command</var>[<var>toc-title</var>]{<var>title</var>}
</pre></div>
-<p>For instance, declare the start of a subsection with something like
+<p>For instance, declare the start of a subsection as with
<code>\subsection{Motivation}</code>.
</p>
<p>The table has each <var>sectioning-command</var> in LaTeX. All are
@@ -3338,11 +3359,11 @@
</dt>
<dd><a name="index-secnumdepth-counter"></a>
<a name="index-section-numbers_002c-printing"></a>
-<a name="Sectioning_002fsecnumdepth"></a><p>Controls which sectioning commands are numbered. The setting
-<code>\setcounter{secnumdepth}{<var>level</var>}</code> suppresses numbering of
-sectioning at any depth greater than <var>level</var> (see <a href="#g_t_005csetcounter">\setcounter</a>).
-See the above table for the level numbers. For instance, in an
-<code>article</code>, if <code>secnumdepth</code> is 1 then a
+<a name="Sectioning_002fsecnumdepth"></a><p>Controls which sectioning commands are
+numbered. Suppress numbering of sectioning at any depth greater than
+<var>level</var> <code>\setcounter{secnumdepth}{<var>level</var>}</code>
+(see <a href="#g_t_005csetcounter">\setcounter</a>). See the above table for the level numbers. For
+instance, if the <code>secnumdepth</code> is 1 in an <code>article</code> then a
<code>\section{Introduction}</code> command will produce output like ‘<samp>1
Introduction</samp>’ while <code>\subsection{Discussion}</code> will produce output
like ‘<samp>Discussion</samp>’, without the number. LaTeX’s default
@@ -3417,8 +3438,8 @@
<pre class="example">\part{VOLUME I \\
PERSONAL MEMOIRS OF U.\ S.\ GRANT}
\chapter{ANCESTRY--BIRTH--BOYHOOD.}
-My family is American, and has been for generations, in all its branches,
-direct and collateral.
+My family is American, and has been for generations,
+in all its branches, direct and collateral.
</pre></div>
<p>In each standard class the <code>\part</code> command outputs a part number
@@ -3443,7 +3464,7 @@
out the break in the table of contents.
</p>
<div class="example">
-<pre class="example">\part[Up from the bottom; my life story]{Up from the bottom\\ my life story}
+<pre class="example">\part[Up from the bottom; my life]{Up from the bottom\\ my life}
</pre></div>
<p>For determining which sectional units are numbered and which appear in
@@ -3492,9 +3513,10 @@
<div class="example">
<pre class="example">\chapter{Loomings}
Call me Ishmael.
-Some years ago---never mind how long precisely---having little or no money in my purse,
-and nothing particular to interest me on shore, I thought I would sail about
-a little and see the watery part of the world.
+Some years ago---never mind how long precisely---having little or no
+money in my purse, and nothing particular to interest me on shore, I
+thought I would sail about a little and see the watery part of
+the world.
</pre></div>
<p>The LaTeX default starts each chapter on a fresh page, an
@@ -3532,7 +3554,7 @@
the break in the contents
</p>
<div class="example">
-<pre class="example">\chapter[Given it all at birth\\ my life story]{Given it all at birth\\ my life story}
+<pre class="example">\chapter[Given it all\\ my story]{Given it all\\ my story}
</pre></div>
<p>For determining which sectional units are numbered and which appear in
@@ -3688,7 +3710,7 @@
<pre class="example">\usepackage{titlesec} % in preamble
\titleformat{\section}
{\normalfont\Large\bfseries} % format of title
- {\makebox[1pc][r]{\thesection\hspace{1pc}}} % label, such as 1 for a section
+ {\makebox[1pc][r]{\thesection\hspace{1pc}}} % label
{0pt} % length of separation between label and title
{} % before-code hook
\titlespacing*{\section}
@@ -3727,9 +3749,9 @@
<pre class="example">We will show that there are more functions than Turing machines and that
therefore some functions have no associated machine.
-\subsection{Cardinality}
-We will begin with two paradoxes, two examples that dramatize
-the challenge to our intuition posed by comparing the sizes of infinite sets.
+\subsection{Cardinality} We will begin with two paradoxes that
+dramatize the challenge to our intuition posed by comparing the sizes of
+infinite sets.
</pre></div>
<p>For the standard LaTeX classes <code>book</code> and <code>report</code> the
@@ -4013,11 +4035,21 @@
</p>
<p>Technically, <code>\@startsection</code> has the form
</p><div class="example">
-<pre class="example">\@startsection{<var>name</var>}{<var>level</var>}{<var>indent</var>}{<var>beforeskip</var>}{<var>afterskip</var>}{<var>style</var>}*[<var>toctitle</var>]{<var>title</var>}
+<pre class="example">\@startsection{<var>name</var>}
+ {<var>level</var>}
+ {<var>indent</var>}
+ {<var>beforeskip</var>}
+ {<var>afterskip</var>}
+ {<var>style</var>}*[<var>toctitle</var>]{<var>title</var>}
</pre></div>
-<p>(the star <code>*</code> is optional), so that issuing
+<p>so that issuing
</p><div class="example">
-<pre class="example">\renewcommand{\section}{\@startsection{<var>name</var>}{<var>level</var>}{<var>indent</var>}{<var>beforeskip</var>}{<var>afterskip</var>}{<var>style</var>}}
+<pre class="example">\renewcommand{\section}{\@startsection{<var>name</var>}
+ {<var>level</var>}
+ {<var>indent</var>}
+ {<var>beforeskip</var>}
+ {<var>afterskip</var>}
+ {<var>style</var>}}
</pre></div>
<p>redefines <code>\section</code> to have the form
<code>\section*[<var>toctitle</var>]{<var>title</var>}</code> (here too, the
@@ -4028,12 +4060,11 @@
</p>
<dl compact="compact">
<dt><var>name</var></dt>
-<dd><a name="g_t_005c_0040startsection_002fname"></a><p>Name of the counter used to number the
-sectioning header. This counter must be defined separately. Most
-commonly this is either <code>section</code>, <code>subsection</code>, or
-<code>paragraph</code>. Although in those three cases the counter name is the
-same as the sectioning command itself, using the same name is not
-required.
+<dd><a name="g_t_005c_0040startsection_002fname"></a><p>Name of the counter used to number the sectioning header. This counter
+must be defined separately. Most commonly this is either
+<code>section</code>, <code>subsection</code>, or <code>paragraph</code>. Although in
+those cases the counter name is the same as the sectioning command
+itself, you don’t have to use the same name.
</p>
<p>Then <code>\the</code><var>name</var> displays the title number and
<code>\</code><var>name</var><code>mark</code> is for the page headers. See the third
@@ -4045,10 +4076,10 @@
See <a href="#Sectioning">Sectioning</a> for the list of standard level numbers.
</p>
<p>If <var>level</var> is less than or equal to the value of the counter
-<code>secnumdepth</code> then the titles for this sectioning command will be
-numbered (see <a href="#Sectioning_002fsecnumdepth">Sectioning/secnumdepth</a>). For instance, in an
-<code>article</code>, if <code>secnumdepth</code> is 1 then a
-<code>\section{Introduction}</code> command will produce output like “1
+<code>secnumdepth</code> then titles for this sectioning command will be
+numbered (see <a href="#Sectioning_002fsecnumdepth">Sectioning/secnumdepth</a>). For instance, if
+<code>secnumdepth</code> is 1 in an <code>article</code> then the command
+<code>\section{Introduction}</code> will produce output like “1
Introduction” while <code>\subsection{Discussion}</code> will produce
output like “Discussion”, without the number prefix.
</p>
@@ -4133,18 +4164,19 @@
<p>These are LaTeX’s defaults for the first three sectioning units that
are defined with <code>\@startsection</code>, for the <samp>article</samp>,
-<samp>book</samp>, and <samp>report</samp> classes.
+<samp>book</samp>, and <samp>report</samp> classes. For section, the <var>level</var> is
+1, the <var>indent</var> is 0pt, the <var>beforeskip</var> is <code>-3.5ex
+plus -1ex minus -0.2ex</code>, the <var>afterskip</var> is <code>2.3ex plus 0.2ex</code>,
+and the <var>style</var> is <code>\normalfont\Large\bfseries</code>. For
+subsection, the <var>lelel</var> is 2, the <var>indent</var> is 0pt, the
+<var>beforeskip</var> is <code>-3.25ex plus -1ex minus -0.2ex</code>, the
+<var>afterskip</var> is <code>1.5ex plus 0.2ex</code>, and the <var>style</var> is
+<code>\normalfont\large\bfseries</code>. For subsubsection, the <var>level</var>
+is 3, the <var>indent</var> is 0pt, the <var>beforeskip</var> is
+<code>-3.25ex plus -1ex minus -0.2ex</code>, the <var>afterskip</var> is
+<code>1.5ex plus 0.2ex</code>, and the <var>style</var> is
+<code>\normalfont\normalsize\bfseries</code>.
</p>
-<table>
-<thead><tr><th width="10%"></th><th width="30%"><code>section</code></th><th width="30%"><code>subsection</code></th><th width="30%"><code>subsubsection</code></th></tr></thead>
-<tr><td width="10%"><a href="#g_t_005c_0040startsection_002fname"><var>name</var></a></td><td width="30%">section</td><td width="30%">subsection</td><td width="30%">subsubsection</td></tr>
-<tr><td width="10%"><a href="#g_t_005c_0040startsection_002flevel"><var>level</var></a></td><td width="30%">1</td><td width="30%">2</td><td width="30%">3</td></tr>
-<tr><td width="10%"><a href="#g_t_005c_0040startsection_002findent"><var>indent</var></a></td><td width="30%"><code>0pt</code></td><td width="30%"><code>0pt</code></td><td width="30%"><code>0pt</code></td></tr>
-<tr><td width="10%"><a href="#g_t_005c_0040startsection_002fbeforeskip"><var>beforeskip</var></a></td><td width="30%"><code>-3.5ex plus -1ex minus -0.2ex</code></td><td width="30%"><code>-3.25ex plus -1ex minus -0.2ex</code></td><td width="30%"><code>-3.25ex plus -1ex minus -0.2ex</code></td></tr>
-<tr><td width="10%"><a href="#g_t_005c_0040startsection_002fafterskip"><var>afterskip</var></a></td><td width="30%"><code>2.3ex plus 0.2ex</code></td><td width="30%"><code>1.5ex plus 0.2ex</code></td><td width="30%"><code>1.5ex plus 0.2ex</code></td></tr>
-<tr><td width="10%"><a href="#g_t_005c_0040startsection_002fstyle"><var>style</var></a></td><td width="30%"><code>\normalfont\Large\bfseries</code></td><td width="30%"><code>\normalfont\large\bfseries</code></td><td width="30%"><code>\normalfont\normalsize\bfseries</code></td></tr>
-</table>
-
<p>Here are examples. They go either in a package or class file or in the
preamble of a LaTeX document. If you put them in the preamble they
must go between a <code>\makeatletter</code> command and a
@@ -4223,7 +4255,7 @@
later if needed.
</p>
<div class="example">
-<pre class="example">We will later see this with Theorem~\ref{th:GreensThm}. % forward reference
+<pre class="example">We will see this with Theorem~\ref{th:GreensThm}. % forward reference
...
\begin{theorem} \label{th:GreensThm}
...
@@ -4324,8 +4356,8 @@
<p>Thus, <code>\label{fig:Euler}</code> is a label for a figure with a portrait
of the great man.
</p>
-<p>Inside the auxiliary file the reference information is kept in the
-format
+<p>In the auxiliary file the reference information is kept as the text of
+a command of the form
<code>\newlabel{<var>label</var>}{{<var>currentlabel</var>}{<var>pagenumber</var>}}</code>.
Here <var>currentlabel</var> is the current value of the macro
<code>\@currentlabel</code> that is usually updated whenever you call
@@ -5440,8 +5472,9 @@
<div class="example">
<pre class="example">\noindent\begin{minipage}{3in}
\begin{flushleft}
- A long sentence that will be broken by \LaTeX{} at a convenient spot. \\
- And, a forced fresh line.
+ A long sentence that will be broken by \LaTeX{}
+ at a convenient spot. \\
+ And, a fresh line forced by the double backslash.
\end{flushleft}
\end{minipage}
</pre></div>
@@ -5797,8 +5830,8 @@
</p>
<a name="index-_005cmakelabel"></a>
<p>Another command that can go in <var>spacing</var> is <code>\makelabel</code>, which
-constructs the label box. By default it positions the contents flush
-right. It takes one argument, the label. It typesets the contents in
+constructs the label box. By default it puts the contents flush
+right. Its only argument is the label, which it typesets in
LR mode. One example of changing its definition is that to the above
<code>named</code> example before the definition of the environment add
<code>\newcommand{\namedmakelabel}[1]{\textsc{#1}}</code>, and between
@@ -6459,7 +6492,7 @@
...
\begin{center}
\setlength{\unitlength}{\textwidth}
-\begin{picture}(1,1) % leave space for picture, \textwidth wide and tall
+\begin{picture}(1,1) % leave space, \textwidth wide and tall
\put(0,0){\includegraphics[width=\textwidth]{desertedisland.jpg}}
\put(0.25,0.35){\textcolor{red}{X Treasure here}}
\end{picture}
@@ -7699,8 +7732,8 @@
\end{flushleft}
</pre></div>
-<p>This example shows text, a decimal point, between the columns, arranged
-so the numbers in the table are aligned on that decimal point.
+<p>The next example shows text, a decimal point between the columns,
+arranged so the numbers in the table are aligned on it.
</p>
<div class="example">
<pre class="example">\begin{tabular}{r@{$.$}l}
@@ -7712,20 +7745,18 @@
<a name="index-_005cextracolsep"></a>
<p>An <code>\extracolsep{<var>wd</var>}</code> command in an @-expression causes an
extra space of width <var>wd</var> to appear to the left of all subsequent
-columns, until countermanded by another <code>\extracolsep</code> command.
-Unlike ordinary intercolumn space, this extra space is not suppressed by
-an @-expression. An <code>\extracolsep</code> command can be used only in an
+columns, until countermanded by another <code>\extracolsep</code>. Unlike
+ordinary intercolumn space, this extra space is not suppressed by an
+ at -expression. An <code>\extracolsep</code> command can be used only in an
@-expression in the <code>cols</code> argument. Below, LaTeX inserts the
right amount of intercolumn space to make the entire table 4 inches
wide.
</p>
<div class="example">
-<pre class="example">\begin{center}
- \begin{tabular*}{4in}{l@{\ \ldots\extracolsep{\fill}}l}
- Seven times down, eight times up
- &such is life!
- \end{tabular*}
-\end{center}
+<pre class="example">\begin{tabular*}{4in}{l@{\extracolsep{\fill}}l}
+ Seven times down, eight times up \ldots
+ &such is life!
+\end{tabular*}
</pre></div>
<p>To insert commands that are automatically executed before a given
@@ -7749,10 +7780,10 @@
</dd>
<dt><code>*{<var>num</var>}{<var>cols</var>}</code></dt>
<dd><p>Equivalent to <var>num</var> copies of <var>cols</var>, where <var>num</var> is a
-positive integer and <var>cols</var> is a list of specifiers. Thus
-<code>\begin{tabular}{|*{3}{l|r}|}</code> is equivalent to
-<code>\begin{tabular}{|l|rl|rl|r|}</code>. Note that <var>cols</var> may
-contain another <code>*</code>-expression.
+positive integer and <var>cols</var> is a list of specifiers. Thus the
+specifier <code>\begin{tabular}{|*{3}{l|r}|}</code> is equivalent to
+the specifier <code>\begin{tabular}{|l|rl|rl|r|}</code>. Note that
+<var>cols</var> may contain another <code>*</code>-expression.
</p>
</dd>
</dl>
@@ -7840,8 +7871,9 @@
</p>
<div class="example">
<pre class="example">\begin{tabular}{lccl}
- \textit{ID} &\multicolumn{2}{c}{\textit{Name}} &\textit{Age} \\ \hline % row one
- 978-0-393-03701-2 &O'Brian &Patrick &55 \\ % row two
+ \textit{ID} &\multicolumn{2}{c}{\textit{Name}} &\textit{Age} \\
+ \hline
+ 978-0-393-03701-2 &O'Brian &Patrick &55 \\
...
\end{tabular}
</pre></div>
@@ -8769,7 +8801,7 @@
\end{center}
</pre></div>
-<p>The solution is to replace the double backslash with something like
+<p>Fix it by replacing the double backslash with something like
<code>\vspace{\baselineskip}</code>.
</p>
@@ -9004,15 +9036,16 @@
</p>
<div class="example">
<pre class="example">\begin{sloppypar}
- Her plan for the morning thus settled, she sat quietly down to her book
- after breakfast, resolving to remain in the same place and the same
- employment till the clock struck one; and from habitude very little
- incommoded by the remarks and ejaculations of Mrs.\ Allen, whose vacancy
- of mind and incapacity for thinking were such, that as she never talked
- a great deal, so she could never be entirely silent; and, therefore, while
- she sat at her work, if she lost her needle or broke her thread, if she
- heard a carriage in the street, or saw a speck upon her gown, she must
- observe it aloud, whether there were anyone at leisure to answer her or not.
+ Her plan for the morning thus settled, she sat quietly down to her
+ book after breakfast, resolving to remain in the same place and the
+ same employment till the clock struck one; and from habitude very
+ little incommoded by the remarks and ejaculations of Mrs.\ Allen,
+ whose vacancy of mind and incapacity for thinking were such, that
+ as she never talked a great deal, so she could never be entirely
+ silent; and, therefore, while she sat at her work, if she lost her
+ needle or broke her thread, if she heard a carriage in the street,
+ or saw a speck upon her gown, she must observe it aloud, whether
+ there were anyone at leisure to answer her or not.
\end{sloppypar}
</pre></div>
@@ -9250,10 +9283,11 @@
requested. This
</p>
<div class="example">
-<pre class="example">Four score and seven years ago our fathers brought forth on this continent,
+<pre class="example">Four score and seven years ago our fathers brought forth on this
+continent,
\newpage
-\noindent a new nation, conceived in Liberty, and dedicated to the proposition
-that all men are created equal.
+\noindent a new nation, conceived in Liberty, and dedicated to the
+proposition that all men are created equal.
</pre></div>
<p>makes a new page start after ‘<samp>continent,</samp>’ and the cut-off line
@@ -9342,7 +9376,8 @@
the line in which they appear. So this
</p>
<div class="example">
-<pre class="example">Four score and seven years ago our fathers brought forth on this continent,
+<pre class="example">Four score and seven years ago our fathers brought forth on this
+continent,
\pagebreak
a new nation, conceived in Liberty, and dedicated to the proposition
that all men are created equal.
@@ -9463,9 +9498,9 @@
Change the rule with something like this.
</p>
<div class="example">
-<pre class="example">\renewcommand{\footnoterule}{% Kerns keep it from taking up vertical space
- \kern -3pt % This -3 is the negative of
- \hrule width \textwidth height 1pt % the sum of this 1
+<pre class="example">\renewcommand{\footnoterule}{% Kerns avoid vertical space
+ \kern -3pt % This -3 is negative
+ \hrule width \textwidth height 1pt % of the sum of this 1
\kern 2pt} % and this 2
</pre></div>
@@ -9554,9 +9589,9 @@
<div class="example">
<pre class="example">\newcounter{footnoteValueSaver}
All babies are illogical.\footnote{%
- Source: Lewis Carroll.}\setcounter{footnoteValueSaver}{\value{footnote}}
+ Lewis Carroll.}\setcounter{footnoteValueSaver}{\value{footnote}}
Nobody is despised who can manage a crocodile.\footnote{%
- Source: Captain Hook.}
+ Captain Hook.}
Illogical persons are despised.\footnotemark[\value{footnoteValueSaver}]
Therefore, anyone who can manage a crocodile is not a baby.
</pre></div>
@@ -9573,8 +9608,8 @@
<pre class="example">\usepackage{cleveref}[2012/02/15] % in preamble
\crefformat{footnote}{#2\footnotemark[#1]#3}
...
-The theorem is from Evers.\footnote{\label{fn:TE}Tinker and Evers, 1994.}
-The corollary is from Chance.\footnote{Evers and Chance, 1990.}
+The theorem is from Evers.\footnote{\label{fn:TE}Tinker, Evers, 1994.}
+The corollary is from Chance.\footnote{Evers, Chance, 1990.}
But the key lemma is from Tinker.\cref{fn:TE}
</pre></div>
@@ -9634,7 +9669,8 @@
argument to <code>\section</code>
</p>
<div class="example">
-<pre class="example">\section[Please]{Please\footnote{Don't footnote in chapter and section headers!}}
+<pre class="example">\section[Please]{Please\footnote{%
+ Don't footnote in chapter and section headers!}}
</pre></div>
<p>No <code>\protect</code> is needed in front of <code>\footnote</code> here because
@@ -9694,8 +9730,12 @@
Christine Hatherleigh Wood &Fiance\footnotemark
\end{tabular}
\end{minipage}% percent sign keeps footnote text close to minipage
- \stepcounter{mpFootnoteValueSaver}\footnotetext[\value{mpFootnoteValueSaver}]{Little is known other than her death.}%
- \stepcounter{mpFootnoteValueSaver}\footnotetext[\value{mpFootnoteValueSaver}]{Relationship is unresolved in XXI.}
+ \stepcounter{mpFootnoteValueSaver}%
+ \footnotetext[\value{mpFootnoteValueSaver}]{%
+ Little is known other than her death.}%
+ \stepcounter{mpFootnoteValueSaver}%
+ \footnotetext[\value{mpFootnoteValueSaver}]{%
+ Relationship is unresolved in XXI.}
\end{center}
</pre></div>
Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info 2018-06-28 18:51:27 UTC (rev 666)
+++ trunk/latex2e.info 2018-06-29 11:00:36 UTC (rev 667)
@@ -423,10 +423,9 @@
<http://ctan.org/pkg/macros2e>. These macros are mainly intended to
package or class authors.
- The example below is typical. In the user's class file is a command
-'\thesis at universityname'. The user wants to change the definition.
-These three lines should go in the preamble, before the
-'\begin{document}'.
+ In this example the class file has a command '\thesis at universityname'
+that the user wants to change. These three lines should go in the
+preamble, before the '\begin{document}'.
\makeatletter
\renewcommand{\thesis at universityname}{Saint Michael's College}
@@ -445,8 +444,8 @@
Synopsis:
\newcommand{\mycmd}{\@ifstar{\mycmd at star}{\mycmd at nostar}}
- \newcommand{\mycmd at nostar}[NON-STARRED COMMAND NUMBER OF ARGS]{BODY OF NON-STARRED COMMAND}
- \newcommand{\mycmd at star}[STARRED COMMAND NUMBER OF ARGS]{BODY OF STARRED COMMAND}
+ \newcommand{\mycmd at nostar}[NOSTAR-NUM-ARGS]{NOSTAR-BODY}
+ \newcommand{\mycmd at star}[STAR-NUM-ARGS]{STAR-BODY}
Many standard LaTeX environments or commands have a variant with the
same name but ending with a star character '*', an asterisk. Examples
@@ -477,14 +476,15 @@
\newcommand*{\ciel}{\@ifstar{\ciel at starred}{\ciel at unstarred}}
In the next example, the starred variant takes a different number of
-arguments than does the unstarred one. With this definition, Agent
-007's '``My name is \agentsecret*{Bond}, \agentsecret{James}{Bond}.'''
-is equivalent to '``My name is \textsc{Bond}, \textit{James}
-textsc{Bond}.'''
+arguments than the unstarred one. With this definition, Agent 007's
+'``My name is \agentsecret*{Bond}, \agentsecret{James}{Bond}.''' is
+equivalent to entering the commands '``My name is \textsc{Bond},
+\textit{James} textsc{Bond}.'''
\newcommand*{\agentsecret at unstarred}[2]{\textit{#1} \textsc{#2}}
\newcommand*{\agentsecret at starred}[1]{\textsc{#1}}
- \newcommand*{\agentsecret}{\@ifstar{\agentsecret at starred}{\agentsecret at unstarred}}
+ \newcommand*{\agentsecret}{%
+ \@ifstar{\agentsecret at starred}{\agentsecret at unstarred}}
There are two sometimes more convenient ways to accomplish the work
of '\@ifstar'. The 'suffix' package allows the construct
@@ -805,11 +805,11 @@
'\DeclareOption{OPTION}{CODE}'
'\DeclareOption*{CODE}'
- Make an option available to a user, for invoking in their
+ Make an option available to a user to invoke in their
'\documentclass' command. For example, the 'smcmemo' class could
- have an option allowing users to put the institutional logo on the
- first page with '\documentclass[logo]{smcmemo}'. The class file
- must contain '\DeclareOption{logo}{CODE}' (and later,
+ have an option '\documentclass[logo]{smcmemo}' allowing users to
+ put the institutional logo on the first page. The class file must
+ contain '\DeclareOption{logo}{CODE}' (and later,
'\ProcessOptions').
If you request an option that has not been declared, by default
@@ -849,10 +849,11 @@
and the command is used within a moving argument, use
'\newcommand'.
- The 'etoolbox' package offers commands '\newrobustcmd',
- '\newrobustcmd*', '\renewrobustcmd', '\renewrobustcmd*',
- '\providerobustcmd', and '\providerobustcmd*' which are similar to
- '\newcommand', '\newcommand*', '\renewcommand', '\renewcommand*',
+ The 'etoolbox' package offers the commands '\newrobustcmd',
+ '\newrobustcmd*', as well as the commands '\renewrobustcmd',
+ '\renewrobustcmd*', and the commands '\providerobustcmd', and
+ '\providerobustcmd*'. These are similar to '\newcommand',
+ '\newcommand*', '\renewcommand', '\renewcommand*',
'\providecommand', and '\providecommand*', but define a robust CMD
with two advantages as compared to '\DeclareRobustCommand':
1. They use the low-level e-TeX protection mechanism rather than
@@ -866,13 +867,16 @@
'\IfFileExists{FILE NAME}{TRUE CODE}{FALSE CODE}'
'\InputIfFileExists{FILE NAME}{TRUE CODE}{FALSE CODE}'
- Execute TRUE CODE if LaTeX can find the file 'FILE NAME' and FALSE
- CODE otherwise. In the second case it inputs the file immediately
- after executing TRUE CODE. Thus
- '\IfFileExists{img.pdf}{\includegraphics{img.pdf}}{\typeout{WARNING:
- img.pdf not found}}' will include the graphic 'img.pdf' if it is
- found but otherwise just give a warning.
+ Execute TRUE CODE if LaTeX finds the file 'FILE NAME' or FALSE CODE
+ otherwise. In the first case it executing TRUE CODE and then
+ inputs the file. Thus the command
+ \IfFileExists{img.pdf}{%
+ \includegraphics{img.pdf}}{\typeout{!! img.pdf not found}
+
+ will include the graphic 'img.pdf' if it is found and otherwise
+ give a warning.
+
This command looks for the file in all search paths that LaTeX
uses, not only in the current directory. To look only in the
current directory do something like '\IfFileExists{./filename}{TRUE
@@ -893,10 +897,12 @@
If you request a RELEASE DATE and the date of the package installed
on your system is earlier, then you get a warning on the screen and
- in the log like 'You have requested, on input line 4, version
- `2038/01/19' of document class article, but only version
- `2014/09/29 v1.4h Standard LaTeX document class' is available.'
+ in the log like this.
+ You have requested, on input line 4, version `2038/01/19' of
+ document class article, but only version `2014/09/29 v1.4h
+ Standard LaTeX document class' is available.
+
The command version '\LoadClassWithOptions' uses the list of
options for the current class. This means it ignores any options
passed to it via '\PassOptionsToClass'. This is a convenience
@@ -927,9 +933,11 @@
features, include the optional FORMAT DATE on which those features
were implemented. If present it must be in the form 'YYYY/MM/DD'.
If the format version installed on your system is earlier than
- FORMAT DATE then you get a warning like 'You have requested release
- `2038/01/20' of LaTeX, but only release `2016/02/01' is available.'
+ FORMAT DATE then you get a warning like this.
+ You have requested release `2038/01/20' of LaTeX, but only
+ release `2016/02/01' is available.
+
'\OptionNotUsed'
Adds the current option to the list of unused options. Can only be
used within the CODE argument of either '\DeclareOption' or
@@ -950,18 +958,21 @@
If your own code is bringing in a package twice then you can
collapse that to once, for example replacing the two
- '\RequirePackage[landscape]{geometry}\RequirePackage[margins=1in]{geometry}'
- with the single '\RequirePackage[landscape,margins=1in]{geometry}'.
- But if you are loading a package that in turn loads another package
- then you need to queue up the options you desire for this other
- package. For instance, suppose the package 'foo' loads the package
- 'geometry'. Instead of
- '\RequirePackage{foo}\RequirePackage[draft]{graphics}' you must
- write '\PassOptionsToPackage{draft}{graphics}
- \RequirePackage{foo}'. (If 'foo.sty' loads an option in conflict
- with what you want then you may have to look into altering its
- source.)
+ '\RequirePackage[landscape]{geometry}' and
+ '\RequirePackage[margins=1in]{geometry}' with the single command
+ '\RequirePackage[landscape,margins=1in]{geometry}'.
+ However, imagine that you are loading 'firstpkg' and inside that
+ package it loads 'secondpkg', and you need the second package to be
+ loaded with option 'draft'. Then before doing the first package
+ you must queue up the options for the second package, like this.
+
+ \PassOptionsToPackage{draft}{secondpkg}
+ \RequirePackage{firstpkg}
+
+ (If 'firstpkg.sty' loads an option in conflict with what you want
+ then you may have to alter its source.)
+
These commands are useful for general users as well as class and
package writers. For instance, suppose a user wants to load the
'graphicx' package with the option 'draft' and also wants to use a
@@ -1012,31 +1023,33 @@
Identifies the class or package, printing a message to the screen
and the log file.
- When a user writes '\documentclass{smcmemo}' then LaTeX loads the
- file 'smcmemo.cls'. Similarly, a user writing '\usepackage{test}'
- prompts LaTeX to load the file 'test.sty'. If the name of the file
- does not match the declared class or package name then you get a
- warning. Thus, if you invoke '\documentclass{smcmemo}', and the
- file 'smcmemo.cls' has the statement '\ProvidesClass{xxx}' then you
- get a warning like 'You have requested document class `smcmemo',
- but the document class provides 'xxx'.' This warning does not
- prevent LaTeX from processing the rest of the class file normally.
+ When you load a class or package, for example with
+ '\documentclass{smcmemo}' or '\usepackage{test}', LaTeX inputs a
+ file. If the name of the file does not match the class or package
+ name declared in it then you get a warning. Thus, if you invoke
+ '\documentclass{smcmemo}', and the file 'smcmemo.cls' has the
+ statement '\ProvidesClass{xxx}' then you get a warning like 'You
+ have requested document class `smcmemo', but the document class
+ provides 'xxx'.' This warning does not prevent LaTeX from
+ processing the rest of the class file normally.
- If you include the optional argument, then you must include the
- date, before the first space if any, and it must have the form
- 'YYYY/MM/DD'. The rest of the optional argument is free-form,
- although it traditionally identifies the class, and is written to
- the screen during compilation and to the log file. Thus, if your
- file 'smcmemo.cls' contains the line
- '\ProvidesClass{smcmemo}[2008/06/01 v1.0 SMC memo class]' and your
- document's first line is '\documentclass{smcmemo}' then you will
- see 'Document Class: smcmemo 2008/06/01 v1.0 SMC memo class'.
+ If you include the optional argument then you must include a date,
+ before any spaces, of the form 'YYYY/MM/DD'. The rest of the
+ optional argument is free-form, although it traditionally
+ identifies the class, and is written to the screen during
+ compilation and to the log file. Thus, if your file 'smcmemo.cls'
+ contains the line '\ProvidesClass{smcmemo}[2008/06/01 v1.0 SMC memo
+ class]' and your document's first line is '\documentclass{smcmemo}'
+ then you will see 'Document Class: smcmemo 2008/06/01 v1.0 SMC memo
+ class'.
The date in the optional argument allows class and package users to
- ask to be warned if the version of the class or package installed
- on their system is earlier than RELEASE DATE, by using the optional
- arguments such as '\documentclass{smcmemo}[2018/10/12]' or
- '\usepackage{foo}[[2017/07/07]]'. (Note that package users only
+ ask to be warned if the version of the class or package is earlier
+ than RELEASE DATE. For instance, a user could enter
+ '\documentclass{smcmemo}[2018/10/12]' or
+ '\usepackage{foo}[[2017/07/07]]' to require a class or package with
+ certain features by specifying that it must be released no earlier
+ than the given date. (Although, in practice package users only
rarely include a date, and class users almost never do.)
'\ProvidesFile{FILE NAME}[ADDITIONAL INFORMATION]'
@@ -1049,11 +1062,10 @@
'\RequirePackage[OPTION LIST]{PACKAGE NAME}[RELEASE DATE]'
'\RequirePackageWithOptions{PACKAGE NAME}[RELEASE DATE]'
- Load a package, like the document author command '\usepackage'.
- *Note Additional packages::. An example is
- '\RequirePackage[landscape,margin=1in]{geometry}'. Note that the
- LaTeX development team strongly recommends use of these commands
- over Plain TeX's '\input'; see the Class Guide.
+ Load a package, like the command '\usepackage' (*note Additional
+ packages::). The LaTeX development team strongly recommends use of
+ these commands over Plain TeX's '\input'; see the Class Guide. An
+ example is '\RequirePackage[landscape,margin=1in]{geometry}'.
The OPTION LIST, if present, is a comma-separated list. The
RELEASE DATE, if present, must have the form YYYY/MM/DD. If the
@@ -1508,8 +1520,7 @@
* Increase the value of '\dbltopfraction' to a suitably large
number, to avoid going to float pages so soon.
- You can redefine it, for instance with
- '\renewcommand{\dbltopfraction}{0.9}'.
+ You can redefine it, as with '\renewcommand{\dbltopfraction}{0.9}'.
'\dblfloatpagefraction'
For a float page of two-column wide floats, this is the minimum
@@ -1674,13 +1685,13 @@
'\paperheight'
The height of the paper, as distinct from the height of the print
- area. It is normally set with a document class option, as in
+ area. Normally set with a document class option, as in
'\documentclass[a4paper]{article}' (*note Document class
options::).
'\paperwidth'
The width of the paper, as distinct from the width of the print
- area. It is normally set with a document class option, as in
+ area. Normally set with a document class option, as in
'\documentclass[a4paper]{article}' (*note Document class
options::).
@@ -1840,7 +1851,7 @@
floats; default '.7'.
Parameters relating to vertical space around floats (change them with
-'\setlength{PARAMETER}{LENGTH EXPRESSION}'):
+a command of the form '\setlength{PARAMETER}{LENGTH EXPRESSION}'):
'\floatsep'
Space between floats at the top or bottom of a page; default '12pt
@@ -1856,7 +1867,7 @@
default '20pt plus2pt minus4pt'.
Counters relating to the number of floats on a page (change them with
-'\setcounter{CTRNAME}{NATURAL NUMBER}'):
+a command of the form '\setcounter{CTRNAME}{NATURAL NUMBER}'):
'bottomnumber'
Maximum number of floats that can appear at the bottom of a text
@@ -1894,7 +1905,7 @@
SECTIONING-COMMAND*{TITLE}
SECTIONING-COMMAND[TOC-TITLE]{TITLE}
-For instance, declare the start of a subsection with something like
+For instance, declare the start of a subsection as with
'\subsection{Motivation}'.
The table has each SECTIONING-COMMAND in LaTeX. All are available in
@@ -1943,11 +1954,11 @@
Two counters relate to the appearance of sectioning commands.
'secnumdepth'
- Controls which sectioning commands are numbered. The setting
- '\setcounter{secnumdepth}{LEVEL}' suppresses numbering of
- sectioning at any depth greater than LEVEL (*note \setcounter::).
- See the above table for the level numbers. For instance, in an
- 'article', if 'secnumdepth' is 1 then a '\section{Introduction}'
+ Controls which sectioning commands are numbered. Suppress
+ numbering of sectioning at any depth greater than LEVEL
+ '\setcounter{secnumdepth}{LEVEL}' (*note \setcounter::). See the
+ above table for the level numbers. For instance, if the
+ 'secnumdepth' is 1 in an 'article' then a '\section{Introduction}'
command will produce output like '1 Introduction' while
'\subsection{Discussion}' will produce output like 'Discussion',
without the number. LaTeX's default 'secnumdepth' is 3 in
@@ -1993,8 +2004,8 @@
\part{VOLUME I \\
PERSONAL MEMOIRS OF U.\ S.\ GRANT}
\chapter{ANCESTRY--BIRTH--BOYHOOD.}
- My family is American, and has been for generations, in all its branches,
- direct and collateral.
+ My family is American, and has been for generations,
+ in all its branches, direct and collateral.
In each standard class the '\part' command outputs a part number such
as 'Part I', alone on its line, in boldface, and in large type. Then
@@ -2017,7 +2028,7 @@
there. This example puts a line break in TITLE but leaves out the break
in the table of contents.
- \part[Up from the bottom; my life story]{Up from the bottom\\ my life story}
+ \part[Up from the bottom; my life]{Up from the bottom\\ my life}
For determining which sectional units are numbered and which appear
in the table of contents, the level number of a part is -1 (*note
@@ -2049,9 +2060,10 @@
\chapter{Loomings}
Call me Ishmael.
- Some years ago---never mind how long precisely---having little or no money in my purse,
- and nothing particular to interest me on shore, I thought I would sail about
- a little and see the watery part of the world.
+ Some years ago---never mind how long precisely---having little or no
+ money in my purse, and nothing particular to interest me on shore, I
+ thought I would sail about a little and see the watery part of
+ the world.
The LaTeX default starts each chapter on a fresh page, an
odd-numbered page if the document is two-sided. It produces a chapter
@@ -2081,7 +2093,7 @@
title but that doesn't work well with running headers so it omits the
break in the contents
- \chapter[Given it all at birth\\ my life story]{Given it all at birth\\ my life story}
+ \chapter[Given it all\\ my story]{Given it all\\ my story}
For determining which sectional units are numbered and which appear
in the table of contents, the level number of a chapter is 0 (*note
@@ -2198,7 +2210,7 @@
\usepackage{titlesec} % in preamble
\titleformat{\section}
{\normalfont\Large\bfseries} % format of title
- {\makebox[1pc][r]{\thesection\hspace{1pc}}} % label, such as 1 for a section
+ {\makebox[1pc][r]{\thesection\hspace{1pc}}} % label
{0pt} % length of separation between label and title
{} % before-code hook
\titlespacing*{\section}
@@ -2226,9 +2238,9 @@
We will show that there are more functions than Turing machines and that
therefore some functions have no associated machine.
- \subsection{Cardinality}
- We will begin with two paradoxes, two examples that dramatize
- the challenge to our intuition posed by comparing the sizes of infinite sets.
+ \subsection{Cardinality} We will begin with two paradoxes that
+ dramatize the challenge to our intuition posed by comparing the sizes of
+ infinite sets.
For the standard LaTeX classes 'book' and 'report' the default output
is like '1.2.3 TITLE' (for chapter 1, section 2, subsection 3), alone on
@@ -2429,9 +2441,19 @@
may want to use the '\secdef' command.
Technically, '\@startsection' has the form
- \@startsection{NAME}{LEVEL}{INDENT}{BEFORESKIP}{AFTERSKIP}{STYLE}*[TOCTITLE]{TITLE}
-(the star '*' is optional), so that issuing
- \renewcommand{\section}{\@startsection{NAME}{LEVEL}{INDENT}{BEFORESKIP}{AFTERSKIP}{STYLE}}
+ \@startsection{NAME}
+ {LEVEL}
+ {INDENT}
+ {BEFORESKIP}
+ {AFTERSKIP}
+ {STYLE}*[TOCTITLE]{TITLE}
+so that issuing
+ \renewcommand{\section}{\@startsection{NAME}
+ {LEVEL}
+ {INDENT}
+ {BEFORESKIP}
+ {AFTERSKIP}
+ {STYLE}}
redefines '\section' to have the form '\section*[TOCTITLE]{TITLE}' (here
too, the star '*' is optional). *Note Sectioning::. This implies that
when you write a command like '\renewcommand{section}{...}', the
@@ -2441,9 +2463,9 @@
NAME
Name of the counter used to number the sectioning header. This
counter must be defined separately. Most commonly this is either
- 'section', 'subsection', or 'paragraph'. Although in those three
- cases the counter name is the same as the sectioning command
- itself, using the same name is not required.
+ 'section', 'subsection', or 'paragraph'. Although in those cases
+ the counter name is the same as the sectioning command itself, you
+ don't have to use the same name.
Then '\the'NAME displays the title number and '\'NAME'mark' is for
the page headers. See the third example below.
@@ -2453,12 +2475,12 @@
Sectioning:: for the list of standard level numbers.
If LEVEL is less than or equal to the value of the counter
- 'secnumdepth' then the titles for this sectioning command will be
- numbered (*note Sectioning/secnumdepth::). For instance, in an
- 'article', if 'secnumdepth' is 1 then a '\section{Introduction}'
- command will produce output like "1 Introduction" while
- '\subsection{Discussion}' will produce output like "Discussion",
- without the number prefix.
+ 'secnumdepth' then titles for this sectioning command will be
+ numbered (*note Sectioning/secnumdepth::). For instance, if
+ 'secnumdepth' is 1 in an 'article' then the command
+ '\section{Introduction}' will produce output like "1 Introduction"
+ while '\subsection{Discussion}' will produce output like
+ "Discussion", without the number prefix.
If LEVEL is less than or equal to the value of the counter TOCDEPTH
then the table of contents will have an entry for this sectioning
@@ -2535,18 +2557,16 @@
These are LaTeX's defaults for the first three sectioning units that
are defined with '\@startsection', for the 'article', 'book', and
-'report' classes.
+'report' classes. For section, the LEVEL is 1, the INDENT is 0pt, the
+BEFORESKIP is '-3.5ex plus -1ex minus -0.2ex', the AFTERSKIP is '2.3ex
+plus 0.2ex', and the STYLE is '\normalfont\Large\bfseries'. For
+subsection, the LELEL is 2, the INDENT is 0pt, the BEFORESKIP is
+'-3.25ex plus -1ex minus -0.2ex', the AFTERSKIP is '1.5ex plus 0.2ex',
+and the STYLE is '\normalfont\large\bfseries'. For subsubsection, the
+LEVEL is 3, the INDENT is 0pt, the BEFORESKIP is '-3.25ex plus -1ex
+minus -0.2ex', the AFTERSKIP is '1.5ex plus 0.2ex', and the STYLE is
+'\normalfont\normalsize\bfseries'.
- 'section' 'subsection' 'subsubsection'
------------------------------------------------------------------------------
-*note NAME: \@startsection/name.sectionsubsection subsubsection
-*note LEVEL: \@startsection/level.12 3
-*note INDENT: \@startsection/indent.'0pt''0pt' '0pt'
-*note BEFORESKIP: \@startsection/beforeskip.'-3.5ex plus -1ex'-3.25ex plus -1ex'-3.25ex plus -1ex
- minus -0.2ex' minus -0.2ex' minus -0.2ex'
-*note AFTERSKIP: \@startsection/afterskip.'2.3ex plus 0.2ex''1.5ex plus 0.2ex''1.5ex plus 0.2ex'
-*note STYLE: \@startsection/style.'\normalfont\Large\bfseries''\normalfont\large\bfseries''\normalfont\normalsize\bfseries'
-
Here are examples. They go either in a package or class file or in
the preamble of a LaTeX document. If you put them in the preamble they
must go between a '\makeatletter' command and a '\makeatother'.
@@ -2611,7 +2631,7 @@
number, put it into the output, and will change that number later if
needed.
- We will later see this with Theorem~\ref{th:GreensThm}. % forward reference
+ We will see this with Theorem~\ref{th:GreensThm}. % forward reference
...
\begin{theorem} \label{th:GreensThm}
...
@@ -2683,13 +2703,13 @@
'eq'
for equations
- Thus, '\label{fig:Euler}' is a label for a figure with a portrait of
-the great man.
+Thus, '\label{fig:Euler}' is a label for a figure with a portrait of the
+great man.
- Inside the auxiliary file the reference information is kept in the
-format '\newlabel{LABEL}{{CURRENTLABEL}{PAGENUMBER}}'. Here
-CURRENTLABEL is the current value of the macro '\@currentlabel' that is
-usually updated whenever you call '\refstepcounter{COUNTER}'.
+ In the auxiliary file the reference information is kept as the text
+of a command of the form '\newlabel{LABEL}{{CURRENTLABEL}{PAGENUMBER}}'.
+Here CURRENTLABEL is the current value of the macro '\@currentlabel'
+that is usually updated whenever you call '\refstepcounter{COUNTER}'.
Below, the key 'sec:test' will get the number of the current section
and the key 'fig:test' will get the number of the figure.
@@ -3469,8 +3489,9 @@
\noindent\begin{minipage}{3in}
\begin{flushleft}
- A long sentence that will be broken by \LaTeX{} at a convenient spot. \\
- And, a forced fresh line.
+ A long sentence that will be broken by \LaTeX{}
+ at a convenient spot. \\
+ And, a fresh line forced by the double backslash.
\end{flushleft}
\end{minipage}
@@ -3715,10 +3736,10 @@
'\item'.
Another command that can go in SPACING is '\makelabel', which
-constructs the label box. By default it positions the contents flush
-right. It takes one argument, the label. It typesets the contents in
-LR mode. One example of changing its definition is that to the above
-'named' example before the definition of the environment add
+constructs the label box. By default it puts the contents flush right.
+Its only argument is the label, which it typesets in LR mode. One
+example of changing its definition is that to the above 'named' example
+before the definition of the environment add
'\newcommand{\namedmakelabel}[1]{\textsc{#1}}', and between the
'\setlength' command and the parenthesis that closes the SPACING
argument also add '\let\makelabel\namedmakelabel'. Then the items will
@@ -4233,7 +4254,7 @@
...
\begin{center}
\setlength{\unitlength}{\textwidth}
- \begin{picture}(1,1) % leave space for picture, \textwidth wide and tall
+ \begin{picture}(1,1) % leave space, \textwidth wide and tall
\put(0,0){\includegraphics[width=\textwidth]{desertedisland.jpg}}
\put(0.25,0.35){\textcolor{red}{X Treasure here}}
\end{picture}
@@ -5113,9 +5134,9 @@
\end{tabular}
\end{flushleft}
- This example shows text, a decimal point, between the columns,
- arranged so the numbers in the table are aligned on that
- decimal point.
+ The next example shows text, a decimal point between the
+ columns, arranged so the numbers in the table are aligned on
+ it.
\begin{tabular}{r@{$.$}l}
$3$ &$14$ \\
@@ -5125,18 +5146,16 @@
An '\extracolsep{WD}' command in an @-expression causes an
extra space of width WD to appear to the left of all
subsequent columns, until countermanded by another
- '\extracolsep' command. Unlike ordinary intercolumn space,
- this extra space is not suppressed by an @-expression. An
- '\extracolsep' command can be used only in an @-expression in
- the 'cols' argument. Below, LaTeX inserts the right amount of
+ '\extracolsep'. Unlike ordinary intercolumn space, this extra
+ space is not suppressed by an @-expression. An '\extracolsep'
+ command can be used only in an @-expression in the 'cols'
+ argument. Below, LaTeX inserts the right amount of
intercolumn space to make the entire table 4 inches wide.
- \begin{center}
- \begin{tabular*}{4in}{l@{\ \ldots\extracolsep{\fill}}l}
- Seven times down, eight times up
- &such is life!
- \end{tabular*}
- \end{center}
+ \begin{tabular*}{4in}{l@{\extracolsep{\fill}}l}
+ Seven times down, eight times up \ldots
+ &such is life!
+ \end{tabular*}
To insert commands that are automatically executed before a
given column, load the 'array' package and use the '>{...}'
@@ -5157,8 +5176,8 @@
'*{NUM}{COLS}'
Equivalent to NUM copies of COLS, where NUM is a positive
- integer and COLS is a list of specifiers. Thus
- '\begin{tabular}{|*{3}{l|r}|}' is equivalent to
+ integer and COLS is a list of specifiers. Thus the specifier
+ '\begin{tabular}{|*{3}{l|r}|}' is equivalent to the specifier
'\begin{tabular}{|l|rl|rl|r|}'. Note that COLS may contain
another '*'-expression.
@@ -5214,8 +5233,9 @@
spanned by the single heading 'Name'.
\begin{tabular}{lccl}
- \textit{ID} &\multicolumn{2}{c}{\textit{Name}} &\textit{Age} \\ \hline % row one
- 978-0-393-03701-2 &O'Brian &Patrick &55 \\ % row two
+ \textit{ID} &\multicolumn{2}{c}{\textit{Name}} &\textit{Age} \\
+ \hline
+ 978-0-393-03701-2 &O'Brian &Patrick &55 \\
...
\end{tabular}
@@ -5889,7 +5909,7 @@
\end{minipage}
\end{center}
- The solution is to replace the double backslash with something like
+Fix it by replacing the double backslash with something like
'\vspace{\baselineskip}'.
@@ -6064,15 +6084,16 @@
The example is simple.
\begin{sloppypar}
- Her plan for the morning thus settled, she sat quietly down to her book
- after breakfast, resolving to remain in the same place and the same
- employment till the clock struck one; and from habitude very little
- incommoded by the remarks and ejaculations of Mrs.\ Allen, whose vacancy
- of mind and incapacity for thinking were such, that as she never talked
- a great deal, so she could never be entirely silent; and, therefore, while
- she sat at her work, if she lost her needle or broke her thread, if she
- heard a carriage in the street, or saw a speck upon her gown, she must
- observe it aloud, whether there were anyone at leisure to answer her or not.
+ Her plan for the morning thus settled, she sat quietly down to her
+ book after breakfast, resolving to remain in the same place and the
+ same employment till the clock struck one; and from habitude very
+ little incommoded by the remarks and ejaculations of Mrs.\ Allen,
+ whose vacancy of mind and incapacity for thinking were such, that
+ as she never talked a great deal, so she could never be entirely
+ silent; and, therefore, while she sat at her work, if she lost her
+ needle or broke her thread, if she heard a carriage in the street,
+ or saw a speck upon her gown, she must observe it aloud, whether
+ there were anyone at leisure to answer her or not.
\end{sloppypar}
@@ -6241,10 +6262,11 @@
the '\newpage' command will cause the new page to start right where
requested. This
- Four score and seven years ago our fathers brought forth on this continent,
+ Four score and seven years ago our fathers brought forth on this
+ continent,
\newpage
- \noindent a new nation, conceived in Liberty, and dedicated to the proposition
- that all men are created equal.
+ \noindent a new nation, conceived in Liberty, and dedicated to the
+ proposition that all men are created equal.
makes a new page start after 'continent,' and the cut-off line is not
right justified. In addition, '\newpage' does not vertically stretch
@@ -6307,7 +6329,8 @@
If you use these inside a paragraph, they apply to the point
following the line in which they appear. So this
- Four score and seven years ago our fathers brought forth on this continent,
+ Four score and seven years ago our fathers brought forth on this
+ continent,
\pagebreak
a new nation, conceived in Liberty, and dedicated to the proposition
that all men are created equal.
@@ -6392,9 +6415,9 @@
thickness of '0.4pt', and horizontal size of '0.4\columnwidth'
long. Change the rule with something like this.
- \renewcommand{\footnoterule}{% Kerns keep it from taking up vertical space
- \kern -3pt % This -3 is the negative of
- \hrule width \textwidth height 1pt % the sum of this 1
+ \renewcommand{\footnoterule}{% Kerns avoid vertical space
+ \kern -3pt % This -3 is negative
+ \hrule width \textwidth height 1pt % of the sum of this 1
\kern 2pt} % and this 2
'\footnotesep'
@@ -6462,9 +6485,9 @@
\newcounter{footnoteValueSaver}
All babies are illogical.\footnote{%
- Source: Lewis Carroll.}\setcounter{footnoteValueSaver}{\value{footnote}}
+ Lewis Carroll.}\setcounter{footnoteValueSaver}{\value{footnote}}
Nobody is despised who can manage a crocodile.\footnote{%
- Source: Captain Hook.}
+ Captain Hook.}
Illogical persons are despised.\footnotemark[\value{footnoteValueSaver}]
Therefore, anyone who can manage a crocodile is not a baby.
@@ -6473,8 +6496,8 @@
\usepackage{cleveref}[2012/02/15] % in preamble
\crefformat{footnote}{#2\footnotemark[#1]#3}
...
- The theorem is from Evers.\footnote{\label{fn:TE}Tinker and Evers, 1994.}
- The corollary is from Chance.\footnote{Evers and Chance, 1990.}
+ The theorem is from Evers.\footnote{\label{fn:TE}Tinker, Evers, 1994.}
+ The corollary is from Chance.\footnote{Evers, Chance, 1990.}
But the key lemma is from Tinker.\cref{fn:TE}
It will work with the package 'hyperref'.
@@ -6514,7 +6537,8 @@
have it not appear on the table of contents is to use the optional
argument to '\section'
- \section[Please]{Please\footnote{Don't footnote in chapter and section headers!}}
+ \section[Please]{Please\footnote{%
+ Don't footnote in chapter and section headers!}}
No '\protect' is needed in front of '\footnote' here because what
gets moved to the table of contents is the optional argument.
@@ -6564,8 +6588,12 @@
Christine Hatherleigh Wood &Fiance\footnotemark
\end{tabular}
\end{minipage}% percent sign keeps footnote text close to minipage
- \stepcounter{mpFootnoteValueSaver}\footnotetext[\value{mpFootnoteValueSaver}]{Little is known other than her death.}%
- \stepcounter{mpFootnoteValueSaver}\footnotetext[\value{mpFootnoteValueSaver}]{Relationship is unresolved in XXI.}
+ \stepcounter{mpFootnoteValueSaver}%
+ \footnotetext[\value{mpFootnoteValueSaver}]{%
+ Little is known other than her death.}%
+ \stepcounter{mpFootnoteValueSaver}%
+ \footnotetext[\value{mpFootnoteValueSaver}]{%
+ Relationship is unresolved in XXI.}
\end{center}
For a floating 'table' environment (*note table::), use the
@@ -14817,7 +14845,7 @@
* at clause, in font definitions: \newfont. (line 19)
* author, for titlepage: \maketitle. (line 43)
* auxiliary file: Output files. (line 33)
-* babel package: \chapter. (line 70)
+* babel package: \chapter. (line 71)
* babel package <1>: thebibliography. (line 53)
* babel package <2>: Accents. (line 6)
* babel package <3>: \today. (line 13)
@@ -15221,7 +15249,7 @@
* indent, forcing: \indent & \noindent. (line 6)
* indentation of paragraphs, in minipage: minipage. (line 108)
* indentfirst package: \part. (line 50)
-* indentfirst package <1>: \chapter. (line 57)
+* indentfirst package <1>: \chapter. (line 58)
* indentfirst package <2>: \section. (line 60)
* indentfirst package <3>: \subsection. (line 48)
* indentfirst package <4>: \subsubsection & \paragraph & \subparagraph.
@@ -15451,7 +15479,7 @@
* package, appendix: \appendix. (line 29)
* package, Asymptote: \strut. (line 62)
* package, Asymptote <1>: \mbox & \makebox. (line 70)
-* package, babel: \chapter. (line 70)
+* package, babel: \chapter. (line 71)
* package, babel <1>: thebibliography. (line 53)
* package, babel <2>: Accents. (line 6)
* package, babel <3>: \today. (line 13)
@@ -15486,7 +15514,7 @@
* package, hyperref <1>: \pagenumbering. (line 45)
* package, hyperref <2>: Command line input. (line 10)
* package, indentfirst: \part. (line 50)
-* package, indentfirst <1>: \chapter. (line 57)
+* package, indentfirst <1>: \chapter. (line 58)
* package, indentfirst <2>: \section. (line 60)
* package, indentfirst <3>: \subsection. (line 48)
* package, indentfirst <4>: \subsubsection & \paragraph & \subparagraph.
@@ -15526,7 +15554,7 @@
* package, TikZ: \strut. (line 62)
* package, TikZ <1>: \mbox & \makebox. (line 69)
* package, titlesec: \part. (line 54)
-* package, titlesec <1>: \chapter. (line 78)
+* package, titlesec <1>: \chapter. (line 79)
* package, titlesec <2>: \section. (line 64)
* package, titlesec <3>: \subsection. (line 52)
* package, titlesec <4>: \subsubsection & \paragraph & \subparagraph.
@@ -15816,7 +15844,7 @@
* title, for titlepage: \maketitle. (line 64)
* titles, making: \maketitle. (line 6)
* titlesec package: \part. (line 54)
-* titlesec package <1>: \chapter. (line 78)
+* titlesec package <1>: \chapter. (line 79)
* titlesec package <2>: \section. (line 64)
* titlesec package <3>: \subsection. (line 52)
* titlesec package <4>: \subsubsection & \paragraph & \subparagraph.
@@ -16016,8 +16044,8 @@
* \arctan: Math functions. (line 15)
* \arg: Math functions. (line 18)
* \arraycolsep: array. (line 39)
-* \arrayrulewidth: tabular. (line 157)
-* \arraystretch: tabular. (line 163)
+* \arrayrulewidth: tabular. (line 155)
+* \arraystretch: tabular. (line 161)
* \ast: Math symbols. (line 44)
* \asymp: Math symbols. (line 53)
* \AtBeginDocument: \AtBeginDocument. (line 6)
@@ -16164,11 +16192,11 @@
* \date{TEXT}: \maketitle. (line 50)
* \day: \day & \month & \year.
(line 6)
-* \dblfloatpagefraction: \twocolumn. (line 69)
-* \dblfloatsep: \twocolumn. (line 75)
-* \dbltextfloatsep: \twocolumn. (line 82)
+* \dblfloatpagefraction: \twocolumn. (line 68)
+* \dblfloatsep: \twocolumn. (line 74)
+* \dbltextfloatsep: \twocolumn. (line 81)
* \dbltopfraction: \twocolumn. (line 47)
-* \dbltopnumber: \twocolumn. (line 87)
+* \dbltopnumber: \twocolumn. (line 86)
* \ddag: Text symbols. (line 18)
* \ddagger: Math symbols. (line 164)
* \ddot: Math accents. (line 22)
@@ -16210,7 +16238,7 @@
* \dotfill: \hrulefill & \dotfill.
(line 6)
* \dots: Text symbols. (line 35)
-* \doublerulesep: tabular. (line 168)
+* \doublerulesep: tabular. (line 166)
* \downarrow: Math symbols. (line 191)
* \Downarrow: Math symbols. (line 195)
* \ell: Math symbols. (line 199)
@@ -16236,7 +16264,7 @@
* \evensidemargin <2>: Page layout parameters.
(line 68)
* \ExecuteOptions: Class and package commands.
- (line 166)
+ (line 172)
* \exists: Math symbols. (line 218)
* \exp: Math functions. (line 48)
* \extracolsep: tabular. (line 115)
@@ -16332,7 +16360,7 @@
* \i (dotless i): Accents. (line 17)
* \iff: Math symbols. (line 263)
* \IfFileExists: Class and package commands.
- (line 127)
+ (line 128)
* \ignorespaces: \ignorespaces & \ignorespacesafterend.
(line 6)
* \ignorespacesafterend: \ignorespaces & \ignorespacesafterend.
@@ -16358,7 +16386,7 @@
* \infty: Math symbols. (line 279)
* \input: \input. (line 6)
* \InputIfFileExists: Class and package commands.
- (line 127)
+ (line 128)
* \int: Math symbols. (line 282)
* \intextsep: Floats. (line 118)
* \intextsep <1>: Floats. (line 119)
@@ -16451,9 +16479,9 @@
* \ln: Math functions. (line 75)
* \lnot: Math symbols. (line 382)
* \LoadClass: Class and package commands.
- (line 144)
+ (line 148)
* \LoadClassWithOptions: Class and package commands.
- (line 144)
+ (line 148)
* \location: \location. (line 6)
* \log: Math functions. (line 78)
* \longleftarrow: Math symbols. (line 385)
@@ -16529,7 +16557,7 @@
* \ne: Math symbols. (line 443)
* \nearrow: Math symbols. (line 446)
* \NeedsTeXFormat: Class and package commands.
- (line 176)
+ (line 182)
* \neg: Math symbols. (line 449)
* \negthinspace: Spacing in math mode.
(line 45)
@@ -16599,7 +16627,7 @@
* \opening: \opening. (line 6)
* \oplus: Math symbols. (line 497)
* \OptionNotUsed: Class and package commands.
- (line 192)
+ (line 200)
* \oslash: Math symbols. (line 501)
* \otimes: Math symbols. (line 504)
* \oval: \oval. (line 6)
@@ -16651,9 +16679,9 @@
* \partial: Math symbols. (line 517)
* \partopsep: list. (line 151)
* \PassOptionsToClass: Class and package commands.
- (line 198)
+ (line 206)
* \PassOptionsToPackage: Class and package commands.
- (line 198)
+ (line 206)
* \pdfpageheight: Document class options.
(line 40)
* \pdfpagewidth: Document class options.
@@ -16676,19 +16704,19 @@
* \printindex: \printindex. (line 6)
* \printindex <1>: \printindex. (line 10)
* \ProcessOptions: Class and package commands.
- (line 232)
+ (line 243)
* \ProcessOptions*: Class and package commands.
- (line 232)
+ (line 243)
* \prod: Math symbols. (line 556)
* \propto: Math symbols. (line 559)
* \protect: \protect. (line 6)
* \providecommand: \providecommand. (line 6)
* \ProvidesClass: Class and package commands.
- (line 270)
+ (line 281)
* \ProvidesFile: Class and package commands.
- (line 301)
+ (line 314)
* \ProvidesPackage: Class and package commands.
- (line 270)
+ (line 281)
* \ps: \ps. (line 6)
* \Psi: Math symbols. (line 562)
* \psi: Math symbols. (line 565)
@@ -16721,9 +16749,9 @@
* \renewenvironment: \newenvironment & \renewenvironment.
(line 6)
* \RequirePackage: Class and package commands.
- (line 310)
+ (line 323)
* \RequirePackageWithOptions: Class and package commands.
- (line 310)
+ (line 323)
* \resizebox: \resizebox. (line 6)
* \restorecr: \obeycr & \restorecr.
(line 6)
@@ -16831,7 +16859,7 @@
(line 6)
* \t (tie-after accent): Accents. (line 81)
* \tabbingsep: tabbing. (line 121)
-* \tabcolsep: tabular. (line 172)
+* \tabcolsep: tabular. (line 170)
* \tableofcontents: Table of contents etc..
(line 6)
* \tan: Math functions. (line 105)
@@ -17272,293 +17300,293 @@
Node: Environment14621
Node: Declaration15694
Node: \makeatletter and \makeatother16080
-Node: \@ifstar18273
-Node: Document classes21102
-Node: Document class options22425
-Node: Additional packages25507
-Node: Class and package construction26138
-Node: Class and package structure27590
-Node: Class and package commands29884
-Node: Fonts47409
-Ref: Typefaces47512
-Node: Font styles47840
-Node: Font sizes52268
-Node: Low-level font commands53499
-Node: Layout58606
-Node: \onecolumn59104
-Node: \twocolumn59466
-Node: \flushbottom63861
-Node: \raggedbottom64961
-Node: Page layout parameters65497
-Node: Floats71195
-Node: Sectioning77660
-Ref: Sectioning/secnumdepth80371
-Ref: Sectioning/tocdepth80982
-Node: \part82027
-Node: \chapter84215
-Node: \section88017
-Node: \subsection91309
-Node: \subsubsection & \paragraph & \subparagraph94037
-Node: \appendix96694
-Node: \frontmatter & \mainmatter & \backmatter97935
-Node: \@startsection99277
-Ref: \@startsection/name100598
-Ref: \@startsection/level101058
-Ref: \@startsection/indent101941
-Ref: \@startsection/beforeskip102204
-Ref: \@startsection/afterskip103725
-Ref: \@startsection/style105036
-Node: Cross references108871
-Node: \label110971
-Node: \pageref112768
-Node: \ref113568
-Node: Environments114445
-Node: abstract116448
-Node: array118037
-Node: center120432
-Node: \centering122160
-Node: description123604
-Node: displaymath125791
-Node: document127569
-Node: \AtBeginDocument127999
-Node: \AtEndDocument128623
-Node: enumerate129267
-Node: eqnarray132061
-Node: equation134056
-Node: figure134684
-Node: filecontents136759
-Node: flushleft138509
-Node: \raggedright139438
-Node: flushright140636
-Node: \raggedleft141299
-Node: itemize142089
-Node: letter145554
-Node: list145792
-Node: \item158610
-Node: trivlist159861
-Node: math161389
-Node: minipage161695
-Node: picture166552
-Node: \put172986
-Node: \multiput173464
-Node: \qbezier174184
-Node: \graphpaper175112
-Node: \line175909
-Node: \linethickness177688
-Node: \thinlines178137
-Node: \thicklines178548
-Node: \circle178932
-Node: \oval179472
-Node: \shortstack180451
-Node: \vector181853
-Node: \makebox (picture)182696
-Node: \framebox (picture)183625
-Node: \frame184420
-Node: \dashbox184819
-Node: quotation & quote185545
-Node: tabbing186441
-Node: table192446
-Node: tabular194471
-Node: \multicolumn201721
-Node: \vline205606
-Node: \cline206951
-Node: \hline207635
-Node: thebibliography208317
-Node: \bibitem210730
-Node: \cite213008
-Node: \nocite214661
-Node: Using BibTeX215150
-Node: theorem217097
-Node: titlepage218019
-Node: verbatim219302
-Node: \verb220812
-Node: verse222281
-Node: Line breaking223511
-Node: \\224877
-Node: \obeycr & \restorecr227326
-Node: \newline228126
-Node: \- (hyphenation)229064
-Node: \discretionary230705
-Node: \fussy & \sloppy231593
-Node: sloppypar232375
-Node: \hyphenation233514
-Node: \linebreak & \nolinebreak234099
-Node: Page breaking235170
-Node: \clearpage & \cleardoublepage237199
-Node: \newpage238677
-Node: \enlargethispage239970
-Node: \pagebreak & \nopagebreak240926
-Node: Footnotes242509
-Node: \footnote243655
-Node: \footnotemark246603
-Node: \footnotetext248948
-Node: Footnotes in section headings249549
-Node: Footnotes in a table250376
-Node: Footnotes of footnotes253254
-Node: Definitions253958
-Node: \newcommand & \renewcommand254835
-Node: \providecommand260049
-Node: \newcounter261198
-Node: \newlength262943
-Node: \newsavebox263803
-Node: \newenvironment & \renewenvironment264747
-Node: \newtheorem269872
-Node: \newfont273400
-Node: \protect274696
-Node: \ignorespaces & \ignorespacesafterend277082
-Node: Counters279828
-Node: \alph \Alph \arabic \roman \Roman \fnsymbol281529
-Node: \usecounter284357
-Node: \value285220
-Node: \setcounter286149
-Node: \addtocounter286751
-Node: \refstepcounter287216
-Node: \stepcounter287874
-Node: \day & \month & \year288220
-Node: Lengths289034
-Node: Units of length293470
-Ref: Lengths/em294107
-Ref: Lengths/en294107
-Ref: Lengths/ex294107
-Node: \setlength294963
-Node: \addtolength295740
-Node: \settodepth296714
-Node: \settoheight297469
-Node: \settowidth298228
-Node: Predefined lengths299010
-Node: Making paragraphs299525
-Node: \par301180
-Node: \indent & \noindent303018
-Node: \parindent & \parskip304570
-Node: Marginal notes305608
-Node: Math formulas307407
-Node: Subscripts & superscripts311394
-Node: Math symbols313503
-Node: Blackboard bold339873
-Node: Calligraphic340648
-Node: \boldmath & \unboldmath341220
-Node: Ellipses342750
-Node: Math functions344904
-Node: Math accents346512
-Node: Over- and Underlining347411
-Node: Spacing in math mode349239
-Ref: Spacing in math mode/\thinspace350246
-Ref: Spacing in math mode/\quad350927
-Ref: Spacing in math mode/\qquad351183
-Node: Math miscellany351281
-Node: Colon character & \colon351840
-Node: \*352533
-Node: \frac353117
-Node: \left & \right353530
-Node: \sqrt354707
-Node: \stackrel355302
-Node: Modes355575
-Node: \ensuremath358189
-Node: Page styles358901
-Node: \maketitle359664
-Node: \pagenumbering362674
-Node: \pagestyle364611
-Node: \thispagestyle368116
-Node: Spaces368503
-Node: \enspace & \quad & \qquad369944
-Node: \hspace370891
-Node: \hfill372705
-Node: \hss373761
-Node: \spacefactor374458
-Node: \@377847
-Ref: \AT377947
-Node: \frenchspacing379890
-Node: \normalsfcodes380725
-Node: \(SPACE)380972
-Node: ~382607
-Node: \thinspace & \negthinspace385086
-Node: \/386029
-Node: \hrulefill & \dotfill387335
-Node: \bigskip & \medskip & \smallskip388671
-Node: \bigbreak & \medbreak & \smallbreak390563
-Node: \strut391548
-Node: \vspace394734
-Node: \vfill396291
-Node: \addvspace397169
-Node: Boxes399166
-Node: \mbox & \makebox400002
-Node: \fbox & \framebox403177
-Node: \parbox405701
-Node: \raisebox407981
-Node: \sbox & \savebox409639
-Node: lrbox412601
-Node: \usebox413423
-Node: Color413773
-Node: Color package options414617
-Node: Color models416263
-Node: Commands for color418572
-Node: Define colors418987
-Node: Colored text419702
-Node: Colored boxes422074
-Node: Colored pages423508
-Node: Graphics424201
-Node: Graphics package options426328
-Node: Graphics package configuration429081
-Node: \graphicspath429883
-Node: \DeclareGraphicsExtensions432806
-Node: \DeclareGraphicsRule434603
-Node: Commands for graphics437792
-Node: \includegraphics438297
-Node: \rotatebox451266
-Node: \scalebox454061
-Node: \resizebox455113
-Node: Special insertions456305
-Node: Reserved characters457107
-Node: Upper and lower case458308
-Node: Symbols by font position460223
-Node: Text symbols460843
-Node: Accents464844
-Node: Additional Latin letters466859
-Ref: Non-English characters467030
-Node: \rule468047
-Node: \today469164
-Node: Splitting the input470100
-Node: \endinput471652
-Node: \include & \includeonly472919
-Node: \input477143
-Node: Front/back matter477851
-Node: Table of contents etc.478184
-Node: \addcontentsline481877
-Node: \addtocontents484594
-Node: \nofiles486154
-Node: Indexes486886
-Node: \index488514
-Node: makeindex493583
-Node: \printindex499316
-Node: Glossaries499788
-Node: \newglossaryentry501762
-Node: \gls503231
-Node: Letters504028
-Node: \address507694
-Node: \cc508505
-Node: \closing508923
-Node: \encl509200
-Node: \location509615
-Node: \makelabels509879
-Node: \name512031
-Node: \opening512272
-Node: \ps512553
-Node: \signature512842
-Node: \telephone514059
-Node: Terminal input/output514424
-Node: \typein514689
-Node: \typeout515944
-Node: Command line516991
-Node: Command line options519048
-Node: Command line input522480
-Node: Recovering from errors524348
-Node: Document templates525685
-Node: beamer template526138
-Node: article template526792
-Node: book template527219
-Node: Larger book template527700
-Node: tugboat template529186
-Node: Concept Index531557
-Node: Command Index613322
+Node: \@ifstar18238
+Node: Document classes21027
+Node: Document class options22350
+Node: Additional packages25432
+Node: Class and package construction26063
+Node: Class and package structure27515
+Node: Class and package commands29809
+Node: Fonts47423
+Ref: Typefaces47526
+Node: Font styles47854
+Node: Font sizes52282
+Node: Low-level font commands53513
+Node: Layout58620
+Node: \onecolumn59118
+Node: \twocolumn59480
+Node: \flushbottom63860
+Node: \raggedbottom64960
+Node: Page layout parameters65496
+Node: Floats71182
+Node: Sectioning77691
+Ref: Sectioning/secnumdepth80390
+Ref: Sectioning/tocdepth80991
+Node: \part82036
+Node: \chapter84212
+Node: \section87991
+Node: \subsection91258
+Node: \subsubsection & \paragraph & \subparagraph93972
+Node: \appendix96629
+Node: \frontmatter & \mainmatter & \backmatter97870
+Node: \@startsection99212
+Ref: \@startsection/name100585
+Ref: \@startsection/level101039
+Ref: \@startsection/indent101919
+Ref: \@startsection/beforeskip102182
+Ref: \@startsection/afterskip103703
+Ref: \@startsection/style105014
+Node: Cross references108697
+Node: \label110790
+Node: \pageref112602
+Node: \ref113402
+Node: Environments114279
+Node: abstract116282
+Node: array117871
+Node: center120266
+Node: \centering121994
+Node: description123438
+Node: displaymath125625
+Node: document127403
+Node: \AtBeginDocument127833
+Node: \AtEndDocument128457
+Node: enumerate129101
+Node: eqnarray131895
+Node: equation133890
+Node: figure134518
+Node: filecontents136593
+Node: flushleft138343
+Node: \raggedright139305
+Node: flushright140503
+Node: \raggedleft141166
+Node: itemize141956
+Node: letter145421
+Node: list145659
+Node: \item158461
+Node: trivlist159712
+Node: math161240
+Node: minipage161546
+Node: picture166403
+Node: \put172825
+Node: \multiput173303
+Node: \qbezier174023
+Node: \graphpaper174951
+Node: \line175748
+Node: \linethickness177527
+Node: \thinlines177976
+Node: \thicklines178387
+Node: \circle178771
+Node: \oval179311
+Node: \shortstack180290
+Node: \vector181692
+Node: \makebox (picture)182535
+Node: \framebox (picture)183464
+Node: \frame184259
+Node: \dashbox184658
+Node: quotation & quote185384
+Node: tabbing186280
+Node: table192285
+Node: tabular194310
+Node: \multicolumn201500
+Node: \vline205365
+Node: \cline206710
+Node: \hline207394
+Node: thebibliography208076
+Node: \bibitem210489
+Node: \cite212767
+Node: \nocite214420
+Node: Using BibTeX214909
+Node: theorem216856
+Node: titlepage217778
+Node: verbatim219061
+Node: \verb220571
+Node: verse222040
+Node: Line breaking223270
+Node: \\224636
+Node: \obeycr & \restorecr227075
+Node: \newline227875
+Node: \- (hyphenation)228813
+Node: \discretionary230454
+Node: \fussy & \sloppy231342
+Node: sloppypar232124
+Node: \hyphenation233270
+Node: \linebreak & \nolinebreak233855
+Node: Page breaking234926
+Node: \clearpage & \cleardoublepage236955
+Node: \newpage238433
+Node: \enlargethispage239731
+Node: \pagebreak & \nopagebreak240687
+Node: Footnotes242275
+Node: \footnote243421
+Node: \footnotemark246348
+Node: \footnotetext248671
+Node: Footnotes in section headings249272
+Node: Footnotes in a table250108
+Node: Footnotes of footnotes253034
+Node: Definitions253738
+Node: \newcommand & \renewcommand254615
+Node: \providecommand259829
+Node: \newcounter260978
+Node: \newlength262723
+Node: \newsavebox263583
+Node: \newenvironment & \renewenvironment264527
+Node: \newtheorem269652
+Node: \newfont273180
+Node: \protect274476
+Node: \ignorespaces & \ignorespacesafterend276862
+Node: Counters279608
+Node: \alph \Alph \arabic \roman \Roman \fnsymbol281309
+Node: \usecounter284137
+Node: \value285000
+Node: \setcounter285929
+Node: \addtocounter286531
+Node: \refstepcounter286996
+Node: \stepcounter287654
+Node: \day & \month & \year288000
+Node: Lengths288814
+Node: Units of length293250
+Ref: Lengths/em293887
+Ref: Lengths/en293887
+Ref: Lengths/ex293887
+Node: \setlength294743
+Node: \addtolength295520
+Node: \settodepth296494
+Node: \settoheight297249
+Node: \settowidth298008
+Node: Predefined lengths298790
+Node: Making paragraphs299305
+Node: \par300960
+Node: \indent & \noindent302798
+Node: \parindent & \parskip304350
+Node: Marginal notes305388
+Node: Math formulas307187
+Node: Subscripts & superscripts311174
+Node: Math symbols313283
+Node: Blackboard bold339653
+Node: Calligraphic340428
+Node: \boldmath & \unboldmath341000
+Node: Ellipses342530
+Node: Math functions344684
+Node: Math accents346292
+Node: Over- and Underlining347191
+Node: Spacing in math mode349019
+Ref: Spacing in math mode/\thinspace350026
+Ref: Spacing in math mode/\quad350707
+Ref: Spacing in math mode/\qquad350963
+Node: Math miscellany351061
+Node: Colon character & \colon351620
+Node: \*352313
+Node: \frac352897
+Node: \left & \right353310
+Node: \sqrt354487
+Node: \stackrel355082
+Node: Modes355355
+Node: \ensuremath357969
+Node: Page styles358681
+Node: \maketitle359444
+Node: \pagenumbering362454
+Node: \pagestyle364391
+Node: \thispagestyle367896
+Node: Spaces368283
+Node: \enspace & \quad & \qquad369724
+Node: \hspace370671
+Node: \hfill372485
+Node: \hss373541
+Node: \spacefactor374238
+Node: \@377627
+Ref: \AT377727
+Node: \frenchspacing379670
+Node: \normalsfcodes380505
+Node: \(SPACE)380752
+Node: ~382387
+Node: \thinspace & \negthinspace384866
+Node: \/385809
+Node: \hrulefill & \dotfill387115
+Node: \bigskip & \medskip & \smallskip388451
+Node: \bigbreak & \medbreak & \smallbreak390343
+Node: \strut391328
+Node: \vspace394514
+Node: \vfill396071
+Node: \addvspace396949
+Node: Boxes398946
+Node: \mbox & \makebox399782
+Node: \fbox & \framebox402957
+Node: \parbox405481
+Node: \raisebox407761
+Node: \sbox & \savebox409419
+Node: lrbox412381
+Node: \usebox413203
+Node: Color413553
+Node: Color package options414397
+Node: Color models416043
+Node: Commands for color418352
+Node: Define colors418767
+Node: Colored text419482
+Node: Colored boxes421854
+Node: Colored pages423288
+Node: Graphics423981
+Node: Graphics package options426108
+Node: Graphics package configuration428861
+Node: \graphicspath429663
+Node: \DeclareGraphicsExtensions432586
+Node: \DeclareGraphicsRule434383
+Node: Commands for graphics437572
+Node: \includegraphics438077
+Node: \rotatebox451046
+Node: \scalebox453841
+Node: \resizebox454893
+Node: Special insertions456085
+Node: Reserved characters456887
+Node: Upper and lower case458088
+Node: Symbols by font position460003
+Node: Text symbols460623
+Node: Accents464624
+Node: Additional Latin letters466639
+Ref: Non-English characters466810
+Node: \rule467827
+Node: \today468944
+Node: Splitting the input469880
+Node: \endinput471432
+Node: \include & \includeonly472699
+Node: \input476923
+Node: Front/back matter477631
+Node: Table of contents etc.477964
+Node: \addcontentsline481657
+Node: \addtocontents484374
+Node: \nofiles485934
+Node: Indexes486666
+Node: \index488294
+Node: makeindex493363
+Node: \printindex499096
+Node: Glossaries499568
+Node: \newglossaryentry501542
+Node: \gls503011
+Node: Letters503808
+Node: \address507474
+Node: \cc508285
+Node: \closing508703
+Node: \encl508980
+Node: \location509395
+Node: \makelabels509659
+Node: \name511811
+Node: \opening512052
+Node: \ps512333
+Node: \signature512622
+Node: \telephone513839
+Node: Terminal input/output514204
+Node: \typein514469
+Node: \typeout515724
+Node: Command line516771
+Node: Command line options518828
+Node: Command line input522260
+Node: Recovering from errors524128
+Node: Document templates525465
+Node: beamer template525918
+Node: article template526572
+Node: book template526999
+Node: Larger book template527480
+Node: tugboat template528966
+Node: Concept Index531337
+Node: Command Index613102
End Tag Table
Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2018-06-28 18:51:27 UTC (rev 666)
+++ trunk/latex2e.texi 2018-06-29 11:00:36 UTC (rev 667)
@@ -607,9 +607,9 @@
in their names see @url{http://ctan.org/pkg/macros2e}. These macros are
mainly intended to package or class authors.
-The example below is typical. In the user's class file is a command
- at code{\thesis@@universityname}. The user wants to change the
-definition. These three lines should go in the preamble, before the
+In this example the class file has a command
+ at code{\thesis@@universityname} that the user wants to change. These
+three lines should go in the preamble, before the
@code{\begin@{document@}}.
@example
@@ -634,8 +634,8 @@
@example
\newcommand@{\mycmd@}@{\@@ifstar@{\mycmd@@star@}@{\mycmd@@nostar@}@}
-\newcommand@{\mycmd@@nostar@}[@var{non-starred command number of args}]@{@var{body of non-starred command}@}
-\newcommand@{\mycmd@@star@}[@var{starred command number of args}]@{@var{body of starred command}@}
+\newcommand@{\mycmd@@nostar@}[@var{nostar-num-args}]@{@var{nostar-body}@}
+\newcommand@{\mycmd@@star@}[@var{star-num-args}]@{@var{star-body}@}
@end example
Many standard @LaTeX{} environments or commands have a variant with the
@@ -670,15 +670,16 @@
@end example
In the next example, the starred variant takes a different number of
-arguments than does the unstarred one. With this definition, Agent
-007's @code{``My name is \agentsecret*@{Bond@},
-\agentsecret@{James@}@{Bond@}.''} is equivalent to @code{``My name is
-\textsc@{Bond@}, \textit@{James@} textsc@{Bond@}.''}
+arguments than the unstarred one. With this definition, Agent 007's
+ at code{``My name is \agentsecret*@{Bond@},
+\agentsecret@{James@}@{Bond@}.''} is equivalent to entering the commands
+ at code{``My name is \textsc@{Bond@}, \textit@{James@} textsc@{Bond@}.''}
@example
\newcommand*@{\agentsecret@@unstarred@}[2]@{\textit@{#1@} \textsc@{#2@}@}
\newcommand*@{\agentsecret@@starred@}[1]@{\textsc@{#1@}@}
-\newcommand*@{\agentsecret@}@{\@@ifstar@{\agentsecret@@starred@}@{\agentsecret@@unstarred@}@}
+\newcommand*@{\agentsecret@}@{%
+ \@@ifstar@{\agentsecret@@starred@}@{\agentsecret@@unstarred@}@}
@end example
There are two sometimes more convenient ways to accomplish the work of
@@ -1121,10 +1122,10 @@
@cindex package options
@cindex options, class
@cindex options, package
-Make an option available to a user, for invoking in their
+Make an option available to a user to invoke in their
@code{\documentclass} command. For example, the @code{smcmemo} class
-could have an option allowing users to put the institutional logo on the
-first page with @code{\documentclass[logo]@{smcmemo@}}. The class file
+could have an option @code{\documentclass[logo]@{smcmemo@}} allowing
+users to put the institutional logo on the first page. The class file
must contain @code{\DeclareOption@{logo@}@{@var{code}@}} (and later,
@code{\ProcessOptions}).
@@ -1171,14 +1172,14 @@
using @code{\newcommand} so unless the command's data is fragile and the
command is used within a moving argument, use @code{\newcommand}.
- at PkgIndex{etoolbox}
-The @code{etoolbox} package offers commands @code{\newrobustcmd},
- at code{\newrobustcmd*}, @code{\renewrobustcmd}, @code{\renewrobustcmd*},
- at code{\providerobustcmd}, and @code{\providerobustcmd*} which are similar
-to @code{\newcommand}, @code{\newcommand*}, @code{\renewcommand},
- at code{\renewcommand*}, @code{\providecommand}, and
- at code{\providecommand*}, but define a robust @var{cmd} with two advantages
-as compared to @code{\DeclareRobustCommand}:
+ at PkgIndex{etoolbox} The @file{etoolbox} package offers the commands
+ at code{\newrobustcmd}, @code{\newrobustcmd*}, as well as the commands
+ at code{\renewrobustcmd}, @code{\renewrobustcmd*}, and the commands
+ at code{\providerobustcmd}, and @code{\providerobustcmd*}. These are
+similar to @code{\newcommand}, @code{\newcommand*},
+ at code{\renewcommand}, @code{\renewcommand*}, @code{\providecommand}, and
+ at code{\providecommand*}, but define a robust @var{cmd} with two
+advantages as compared to @code{\DeclareRobustCommand}:
@enumerate
@item
They use the low-level e- at TeX{} protection mechanism rather than the
@@ -1197,13 +1198,19 @@
@item \InputIfFileExists@{@var{file name}@}@{@var{true code}@}@{@var{false code}@}
@findex \IfFileExists
@findex \InputIfFileExists
-Execute @var{true code} if @LaTeX{} can find the file @file{@var{file
-name}} and @var{false code} otherwise. In the second case it inputs the
-file immediately after executing @var{true code}. Thus
- at code{\IfFileExists@{img.pdf@}@{\includegraphics@{img.pdf@}@}@{\typeout@{WARNING:
-img.pdf not found@}@}} will include the graphic @file{img.pdf} if it is
-found but otherwise just give a warning.
+Execute @var{true code} if @LaTeX{} finds the file @file{@var{file
+name}} or @var{false code} otherwise. In the first case it executing
+ at var{true code} and then inputs the file. Thus the command
+ at example
+\IfFileExists@{img.pdf@}@{%
+ \includegraphics@{img.pdf@}@}@{\typeout@{!! img.pdf not found@}
+ at end example
+
+ at noindent
+will include the graphic @file{img.pdf} if it is found and otherwise
+give a warning.
+
This command looks for the file in all search paths that @LaTeX{} uses,
not only in the current directory. To look only in the current
directory do something like @code{\IfFileExists@{./filename@}@{@var{true
@@ -1227,12 +1234,16 @@
@c and do some actions conditionnally on version later or not to some
@c date.
-If you request a @var{release date} and the date of
-the package installed on your system is earlier, then you get a warning
-on the screen and in the log like @code{You have requested, on input
-line 4, version `2038/01/19' of document class article, but only version
-`2014/09/29 v1.4h Standard LaTeX document class' is available.}
+If you request a @var{release date} and the date of the package
+installed on your system is earlier, then you get a warning on the
+screen and in the log like this.
+ at example
+You have requested, on input line 4, version `2038/01/19' of
+document class article, but only version `2014/09/29 v1.4h
+Standard LaTeX document class' is available.
+ at end example
+
The command version @code{\LoadClassWithOptions} uses the list of
options for the current class. This means it ignores any options passed
to it via @code{\PassOptionsToClass}. This is a convenience command
@@ -1264,10 +1275,13 @@
features, include the optional @var{format date} on which those features
were implemented. If present it must be in the form @code{YYYY/MM/DD}.
If the format version installed on your system is earlier than
- at var{format date} then you get a warning like @samp{You have requested
-release `2038/01/20' of LaTeX, but only release `2016/02/01' is
-available.}
+ at var{format date} then you get a warning like this.
+ at example
+You have requested release `2038/01/20' of LaTeX, but only
+release `2016/02/01' is available.
+ at end example
+
@item \OptionNotUsed
@findex \OptionNotUsed
Adds the current option to the list of unused options. Can only be used
@@ -1297,18 +1311,24 @@
If your own code is bringing in a package twice then you can collapse
that to once, for example replacing the two
- at code{\RequirePackage[landscape]@{geometry@}\RequirePackage[margins=1in]@{geometry@}}
-with the single
- at code{\RequirePackage[landscape,margins=1in]@{geometry@}}. But if you
-are loading a package that in turn loads another package then you need
-to queue up the options you desire for this other package. For
-instance, suppose the package @code{foo} loads the package
- at code{geometry}. Instead of
- at code{\RequirePackage@{foo@}\RequirePackage[draft]@{graphics@}} you must
-write @code{\PassOptionsToPackage@{draft@}@{graphics@}
-\RequirePackage@{foo@}}. (If @code{foo.sty} loads an option in conflict
-with what you want then you may have to look into altering its source.)
+ at code{\RequirePackage[landscape]@{geometry@}} and
+ at code{\RequirePackage[margins=1in]@{geometry@}} with the single command
+ at code{\RequirePackage[landscape,margins=1in]@{geometry@}}.
+However, imagine that you are loading @file{firstpkg} and inside that
+package it loads @file{secondpkg}, and you need the second package to be
+loaded with option @code{draft}. Then before doing the first package
+you must queue up the options for the second package, like this.
+
+ at example
+\PassOptionsToPackage@{draft@}@{secondpkg@}
+\RequirePackage@{firstpkg@}
+ at end example
+
+ at noindent
+(If @code{firstpkg.sty} loads an option in conflict with what you want
+then you may have to alter its source.)
+
These commands are useful for general users as well as class and package
writers. For instance, suppose a user wants to load the @code{graphicx}
package with the option @code{draft} and also wants to use a class
@@ -1366,34 +1386,36 @@
@item \ProvidesPackage@{@var{package name}@}[@var{release date}]
@findex \ProvidesClass
@findex \ProvidesPackage
-Identifies the class or package, printing a message to the screen and the log file.
+Identifies the class or package, printing a message to the screen and
+the log file.
-When a user writes @code{\documentclass@{smcmemo@}} then @LaTeX{} loads
-the file @file{smcmemo.cls}. Similarly, a user writing
- at code{\usepackage@{test@}} prompts @LaTeX{} to load the file
- at code{test.sty}. If the name of the file does not match the declared
-class or package name then you get a warning. Thus, if you invoke
+When you load a class or package, for example with
+ at code{\documentclass@{smcmemo@}} or @code{\usepackage@{test@}}, @LaTeX{}
+inputs a file. If the name of the file does not match the class or
+package name declared in it then you get a warning. Thus, if you invoke
@code{\documentclass@{smcmemo@}}, and the file @file{smcmemo.cls} has
the statement @code{\ProvidesClass@{xxx@}} then you get a warning like
@code{You have requested document class `smcmemo', but the document
class provides 'xxx'.} This warning does not prevent @LaTeX{} from
processing the rest of the class file normally.
-If you include the optional argument, then you must include the date, before
-the first space if any, and it must have the form @code{YYYY/MM/DD}. The rest
-of the optional argument is free-form, although it traditionally identifies
-the class, and is written to the screen during compilation and to the
-log file. Thus, if your file @file{smcmemo.cls} contains the line
- at code{\ProvidesClass@{smcmemo@}[2008/06/01 v1.0 SMC memo class]} and your
-document's first line is @code{\documentclass@{smcmemo@}} then you will
-see @code{Document Class: smcmemo 2008/06/01 v1.0 SMC memo class}.
+If you include the optional argument then you must include a date,
+before any spaces, of the form @code{YYYY/MM/DD}. The rest of the
+optional argument is free-form, although it traditionally identifies the
+class, and is written to the screen during compilation and to the log
+file. Thus, if your file @file{smcmemo.cls} contains the line
+ at code{\ProvidesClass@{smcmemo@}[2008/06/01 v1.0 SMC memo class]} and
+your document's first line is @code{\documentclass@{smcmemo@}} then you
+will see @code{Document Class: smcmemo 2008/06/01 v1.0 SMC memo class}.
The date in the optional argument allows class and package users to ask
-to be warned if the version of the class or package installed on their
-system is earlier than @var{release date}, by using the optional arguments
-such as @code{\documentclass@{smcmemo@}[2018/10/12]} or
- at code{\usepackage@{foo@}[[2017/07/07]]}. (Note that package users only
-rarely include a date, and class users almost never do.)
+to be warned if the version of the class or package is earlier than
+ at var{release date}. For instance, a user could enter
+ at code{\documentclass@{smcmemo@}[2018/10/12]} or
+ at code{\usepackage@{foo@}[[2017/07/07]]} to require a class or package
+with certain features by specifying that it must be released no earlier
+than the given date. (Although, in practice package users only rarely
+include a date, and class users almost never do.)
@item \ProvidesFile@{@var{file name}@}[@var{additional information}]
@findex \ProvidesFile
@@ -1408,11 +1430,11 @@
@item \RequirePackageWithOptions@{@var{package name}@}[@var{release date}]
@findex \RequirePackage
@findex \RequirePackageWithOptions
-Load a package, like the document author command @code{\usepackage}.
- at xref{Additional packages}. An example is
- at code{\RequirePackage[landscape,margin=1in]@{geometry@}}. Note that the
- at LaTeX{} development team strongly recommends use of these commands over
-Plain at tie{}@TeX{}'s @code{\input}; see the Class Guide.
+Load a package, like the command @code{\usepackage} (@pxref{Additional
+packages}). The @LaTeX{} development team strongly recommends use of
+these commands over Plain at tie{}@TeX{}'s @code{\input}; see the Class
+Guide. An example is
+ at code{\RequirePackage[landscape,margin=1in]@{geometry@}}.
The @var{option list}, if present, is a comma-separated list. The
@var{release date}, if present, must have the form @var{YYYY/MM/DD}. If
@@ -2067,7 +2089,7 @@
to avoid going to float pages so soon.
@end itemize
-You can redefine it, for instance with
+You can redefine it, as with
@code{\renewcommand@{\dbltopfraction@}@{0.9@}}.
@item \dblfloatpagefraction
@@ -2261,14 +2283,14 @@
@item \paperheight
@findex \paperheight
The height of the paper, as distinct from the height of the print area.
-It is normally set with a document class option, as in
+Normally set with a document class option, as in
@code{\documentclass[a4paper]@{article@}} (@pxref{Document class
options}).
@item \paperwidth
@findex \paperwidth
The width of the paper, as distinct from the width of the print area.
-It is normally set with a document class option, as in
+Normally set with a document class option, as in
@code{\documentclass[a4paper]@{article@}} (@pxref{Document class
options}).
@@ -2451,8 +2473,9 @@
floats; default @samp{.7}.
@end ftable
-Parameters relating to vertical space around floats (change them with
- at code{\setlength@{@var{parameter}@}@{@var{length expression}@}}):
+Parameters relating to vertical space around floats (change them with a
+command of the form @code{\setlength@{@var{parameter}@}@{@var{length
+expression}@}}):
@ftable @code
@item \floatsep
@@ -2472,8 +2495,9 @@
default @samp{20pt plus2pt minus4pt}.
@end ftable
-Counters relating to the number of floats on a page (change them with
- at code{\setcounter@{@var{ctrname}@}@{@var{natural number}@}}):
+Counters relating to the number of floats on a page (change them with a
+command of the form @code{\setcounter@{@var{ctrname}@}@{@var{natural
+number}@}}):
@ftable @code
@item bottomnumber
@@ -2533,7 +2557,7 @@
@end example
@noindent
-For instance, declare the start of a subsection with something like
+For instance, declare the start of a subsection as with
@code{\subsection@{Motivation@}}.
The table has each @var{sectioning-command} in @LaTeX{}. All are
@@ -2595,12 +2619,11 @@
@item secnumdepth
@findex secnumdepth @r{counter}
@cindex section numbers, printing
- at anchor{Sectioning/secnumdepth}
-Controls which sectioning commands are numbered. The setting
- at code{\setcounter@{secnumdepth@}@{@var{level}@}} suppresses numbering of
-sectioning at any depth greater than @var{level} (@pxref{\setcounter}).
-See the above table for the level numbers. For instance, in an
- at code{article}, if @code{secnumdepth} is 1 then a
+ at anchor{Sectioning/secnumdepth} Controls which sectioning commands are
+numbered. Suppress numbering of sectioning at any depth greater than
+ at var{level} @code{\setcounter@{secnumdepth@}@{@var{level}@}}
+(@pxref{\setcounter}). See the above table for the level numbers. For
+instance, if the @code{secnumdepth} is 1 in an @code{article} then a
@code{\section@{Introduction@}} command will produce output like @samp{1
Introduction} while @code{\subsection@{Discussion@}} will produce output
like @samp{Discussion}, without the number. @LaTeX{}'s default
@@ -2658,8 +2681,8 @@
\part@{VOLUME I \\
PERSONAL MEMOIRS OF U.\ S.\ GRANT@}
\chapter@{ANCESTRY--BIRTH--BOYHOOD.@}
-My family is American, and has been for generations, in all its branches,
-direct and collateral.
+My family is American, and has been for generations,
+in all its branches, direct and collateral.
@end example
In each standard class the @code{\part} command outputs a part number
@@ -2684,7 +2707,7 @@
out the break in the table of contents.
@example
-\part[Up from the bottom; my life story]@{Up from the bottom\\ my life story@}
+\part[Up from the bottom; my life]@{Up from the bottom\\ my life@}
@end example
For determining which sectional units are numbered and which appear in
@@ -2723,9 +2746,10 @@
@example
\chapter@{Loomings@}
Call me Ishmael.
-Some years ago---never mind how long precisely---having little or no money in my purse,
-and nothing particular to interest me on shore, I thought I would sail about
-a little and see the watery part of the world.
+Some years ago---never mind how long precisely---having little or no
+money in my purse, and nothing particular to interest me on shore, I
+thought I would sail about a little and see the watery part of
+the world.
@end example
The @LaTeX{} default starts each chapter on a fresh page, an
@@ -2763,7 +2787,7 @@
the break in the contents
@example
-\chapter[Given it all at birth\\ my life story]@{Given it all at birth\\ my life story@}
+\chapter[Given it all\\ my story]@{Given it all\\ my story@}
@end example
For determining which sectional units are numbered and which appear in
@@ -2904,7 +2928,7 @@
\usepackage@{titlesec@} % in preamble
\titleformat@{\section@}
@{\normalfont\Large\bfseries@} % format of title
- @{\makebox[1pc][r]@{\thesection\hspace@{1pc@}@}@} % label, such as 1 for a section
+ @{\makebox[1pc][r]@{\thesection\hspace@{1pc@}@}@} % label
@{0pt@} % length of separation between label and title
@{@} % before-code hook
\titlespacing*@{\section@}
@@ -2937,9 +2961,9 @@
We will show that there are more functions than Turing machines and that
therefore some functions have no associated machine.
-\subsection@{Cardinality@}
-We will begin with two paradoxes, two examples that dramatize
-the challenge to our intuition posed by comparing the sizes of infinite sets.
+\subsection@{Cardinality@} We will begin with two paradoxes that
+dramatize the challenge to our intuition posed by comparing the sizes of
+infinite sets.
@end example
For the standard @LaTeX{} classes @code{book} and @code{report} the
@@ -3191,13 +3215,24 @@
Technically, @code{\@@startsection} has the form
@example
-\@@startsection@{@var{name}@}@{@var{level}@}@{@var{indent}@}@{@var{beforeskip}@}@{@var{afterskip}@}@{@var{style}@}*[@var{toctitle}]@{@var{title}@}
+\@@startsection@{@var{name}@}
+ @{@var{level}@}
+ @{@var{indent}@}
+ @{@var{beforeskip}@}
+ @{@var{afterskip}@}
+ @{@var{style}@}*[@var{toctitle}]@{@var{title}@}
@end example
- at noindent (the star at tie{}@code{*} is optional), so that issuing
+ at noindent so that issuing
@example
-\renewcommand@{\section@}@{\@@startsection@{@var{name}@}@{@var{level}@}@{@var{indent}@}@{@var{beforeskip}@}@{@var{afterskip}@}@{@var{style}@}@}
+\renewcommand@{\section@}@{\@@startsection@{@var{name}@}
+ @{@var{level}@}
+ @{@var{indent}@}
+ @{@var{beforeskip}@}
+ @{@var{afterskip}@}
+ @{@var{style}@}@}
@end example
- at noindent redefines @code{\section} to have the form
+ at noindent
+redefines @code{\section} to have the form
@code{\section*[@var{toctitle}]@{@var{title}@}} (here too, the
star at tie{}@code{*} is optional). @xref{Sectioning}. This implies that
when you write a command like @code{\renewcommand@{section@}@{...@}},
@@ -3207,12 +3242,12 @@
@table @var
@item name
- at anchor{\@@startsection/name} Name of the counter used to number the
-sectioning header. This counter must be defined separately. Most
-commonly this is either @code{section}, @code{subsection}, or
- at code{paragraph}. Although in those three cases the counter name is the
-same as the sectioning command itself, using the same name is not
-required.
+ at anchor{\@@startsection/name}
+Name of the counter used to number the sectioning header. This counter
+must be defined separately. Most commonly this is either
+ at code{section}, @code{subsection}, or @code{paragraph}. Although in
+those cases the counter name is the same as the sectioning command
+itself, you don't have to use the same name.
Then @code{\the}@var{name} displays the title number and
@code{\}@var{name}@code{mark} is for the page headers. See the third
@@ -3224,10 +3259,10 @@
@xref{Sectioning} for the list of standard level numbers.
If @var{level} is less than or equal to the value of the counter
- at code{secnumdepth} then the titles for this sectioning command will be
-numbered (@pxref{Sectioning/secnumdepth}). For instance, in an
- at code{article}, if @code{secnumdepth} is 1 then a
- at code{\section@{Introduction@}} command will produce output like ``1
+ at code{secnumdepth} then titles for this sectioning command will be
+numbered (@pxref{Sectioning/secnumdepth}). For instance, if
+ at code{secnumdepth} is 1 in an @code{article} then the command
+ at code{\section@{Introduction@}} will produce output like ``1
Introduction'' while @code{\subsection@{Discussion@}} will produce
output like ``Discussion'', without the number prefix.
@@ -3307,30 +3342,19 @@
These are @LaTeX{}'s defaults for the first three sectioning units that
are defined with @code{\@@startsection}, for the @file{article},
- at file{book}, and @file{report} classes.
+ at file{book}, and @file{report} classes. For section, the @var{level} is
+1, the @var{indent} is 0 at dmn{pt}, the @var{beforeskip} is @code{-3.5ex
+plus -1ex minus -0.2ex}, the @var{afterskip} is @code{2.3ex plus 0.2ex},
+and the @var{style} is @code{\normalfont\Large\bfseries}. For
+subsection, the @var{lelel} is 2, the @var{indent} is 0 at dmn{pt}, the
+ at var{beforeskip} is @code{-3.25ex plus -1ex minus -0.2ex}, the
+ at var{afterskip} is @code{1.5ex plus 0.2ex}, and the @var{style} is
+ at code{\normalfont\large\bfseries}. For subsubsection, the @var{level}
+is 3, the @var{indent} is 0 at dmn{pt}, the @var{beforeskip} is
+ at code{-3.25ex plus -1ex minus -0.2ex}, the @var{afterskip} is
+ at code{1.5ex plus 0.2ex}, and the @var{style} is
+ at code{\normalfont\normalsize\bfseries}.
- at multitable @columnfractions .10 .30 .30 .30
- at headitem @tab @code{section} @tab @code{subsection} @tab @code{subsubsection}
- at item @ref{\@@startsection/name, at var{name}, at var{name}}
- at tab section @tab subsection @tab subsubsection
- at item @ref{\@@startsection/level, at var{level}, at var{level}}
- at tab 1 @tab 2 @tab 3
- at item @ref{\@@startsection/indent, at var{indent}, at var{indent}}
- at tab @code{0pt} @tab @code{0pt} @tab @code{0pt}
- at item @ref{\@@startsection/beforeskip, at var{beforeskip}, at var{beforeskip}}
- at tab @code{-3.5ex plus -1ex minus -0.2ex}
- at tab @code{-3.25ex plus -1ex minus -0.2ex}
- at tab @code{-3.25ex plus -1ex minus -0.2ex}
- at item @ref{\@@startsection/afterskip, at var{afterskip}, at var{afterskip}}
- at tab @code{2.3ex plus 0.2ex}
- at tab @code{1.5ex plus 0.2ex}
- at tab @code{1.5ex plus 0.2ex}
- at item @ref{\@@startsection/style, at var{style}, at var{style}}
- at tab @code{\normalfont\Large\bfseries}
- at tab @code{\normalfont\large\bfseries}
- at tab @code{\normalfont\normalsize\bfseries}
- at end multitable
-
Here are examples. They go either in a package or class file or in the
preamble of a @LaTeX{} document. If you put them in the preamble they
must go between a @code{\makeatletter} command and a
@@ -3404,7 +3428,7 @@
later if needed.
@example
-We will later see this with Theorem~\ref@{th:GreensThm@}. % forward reference
+We will see this with Theorem~\ref@{th:GreensThm@}. % forward reference
...
\begin@{theorem@} \label@{th:GreensThm@}
...
@@ -3486,11 +3510,12 @@
for equations
@end table
+ at noindent
Thus, @code{\label@{fig:Euler@}} is a label for a figure with a portrait
of the great man.
-Inside the auxiliary file the reference information is kept in the
-format
+In the auxiliary file the reference information is kept as the text of
+a command of the form
@code{\newlabel@{@var{label}@}@{@{@var{currentlabel}@}@{@var{pagenumber}@}@}}.
Here @var{currentlabel} is the current value of the macro
@code{\@@currentlabel} that is usually updated whenever you call
@@ -4441,8 +4466,9 @@
@example
\noindent\begin@{minipage@}@{3in@}
\begin@{flushleft@}
- A long sentence that will be broken by \LaTeX@{@} at a convenient spot. \\
- And, a forced fresh line.
+ A long sentence that will be broken by \LaTeX@{@}
+ at a convenient spot. \\
+ And, a fresh line forced by the double backslash.
\end@{flushleft@}
\end@{minipage@}
@end example
@@ -4757,8 +4783,8 @@
@findex \makelabel
Another command that can go in @var{spacing} is @code{\makelabel}, which
-constructs the label box. By default it positions the contents flush
-right. It takes one argument, the label. It typesets the contents in
+constructs the label box. By default it puts the contents flush
+right. Its only argument is the label, which it typesets in
LR mode. One example of changing its definition is that to the above
@code{named} example before the definition of the environment add
@code{\newcommand@{\namedmakelabel@}[1]@{\textsc@{#1@}@}}, and between
@@ -5326,7 +5352,7 @@
...
\begin@{center@}
\setlength@{\unitlength@}@{\textwidth@}
-\begin@{picture@}(1,1) % leave space for picture, \textwidth wide and tall
+\begin@{picture@}(1,1) % leave space, \textwidth wide and tall
\put(0,0)@{\includegraphics[width=\textwidth]@{desertedisland.jpg@}@}
\put(0.25,0.35)@{\textcolor@{red@}@{X Treasure here@}@}
\end@{picture@}
@@ -6362,8 +6388,8 @@
\end@{flushleft@}
@end example
-This example shows text, a decimal point, between the columns, arranged
-so the numbers in the table are aligned on that decimal point.
+The next example shows text, a decimal point between the columns,
+arranged so the numbers in the table are aligned on it.
@example
\begin@{tabular@}@{r@@@{$.$@}l@}
@@ -6375,20 +6401,18 @@
@findex \extracolsep
An @code{\extracolsep@{@var{wd}@}} command in an @@-expression causes an
extra space of width @var{wd} to appear to the left of all subsequent
-columns, until countermanded by another @code{\extracolsep} command.
-Unlike ordinary intercolumn space, this extra space is not suppressed by
-an @@-expression. An @code{\extracolsep} command can be used only in an
+columns, until countermanded by another @code{\extracolsep}. Unlike
+ordinary intercolumn space, this extra space is not suppressed by an
+@@-expression. An @code{\extracolsep} command can be used only in an
@@-expression in the @code{cols} argument. Below, @LaTeX{} inserts the
right amount of intercolumn space to make the entire table 4 inches
wide.
@example
-\begin@{center@}
- \begin@{tabular*@}@{4in@}@{l@@@{\ \ldots\extracolsep@{\fill@}@}l@}
- Seven times down, eight times up
- &such is life!
- \end@{tabular*@}
-\end@{center@}
+\begin@{tabular*@}@{4in@}@{l@@@{\extracolsep@{\fill@}@}l@}
+ Seven times down, eight times up \ldots
+ &such is life!
+\end@{tabular*@}
@end example
To insert commands that are automatically executed before a given
@@ -6411,10 +6435,10 @@
@item *@{@var{num}@}@{@var{cols}@}
Equivalent to @var{num} copies of @var{cols}, where @var{num} is a
-positive integer and @var{cols} is a list of specifiers. Thus
- at code{\begin@{tabular@}@{|*@{3@}@{l|r@}|@}} is equivalent to
- at code{\begin@{tabular@}@{|l|rl|rl|r|@}}. Note that @var{cols} may
-contain another @code{*}-expression.
+positive integer and @var{cols} is a list of specifiers. Thus the
+specifier @code{\begin@{tabular@}@{|*@{3@}@{l|r@}|@}} is equivalent to
+the specifier @code{\begin@{tabular@}@{|l|rl|rl|r|@}}. Note that
+ at var{cols} may contain another @code{*}-expression.
@end table
@end table
@@ -6479,8 +6503,9 @@
@example
\begin@{tabular@}@{lccl@}
- \textit@{ID@} &\multicolumn@{2@}@{c@}@{\textit@{Name@}@} &\textit@{Age@} \\ \hline % row one
- 978-0-393-03701-2 &O'Brian &Patrick &55 \\ % row two
+ \textit@{ID@} &\multicolumn@{2@}@{c@}@{\textit@{Name@}@} &\textit@{Age@} \\
+ \hline
+ 978-0-393-03701-2 &O'Brian &Patrick &55 \\
...
\end@{tabular@}
@end example
@@ -7275,7 +7300,8 @@
\end@{center@}
@end example
-The solution is to replace the double backslash with something like
+ at noindent
+Fix it by replacing the double backslash with something like
@code{\vspace@{\baselineskip@}}.
@@ -7474,15 +7500,16 @@
@example
\begin@{sloppypar@}
- Her plan for the morning thus settled, she sat quietly down to her book
- after breakfast, resolving to remain in the same place and the same
- employment till the clock struck one; and from habitude very little
- incommoded by the remarks and ejaculations of Mrs.\ Allen, whose vacancy
- of mind and incapacity for thinking were such, that as she never talked
- a great deal, so she could never be entirely silent; and, therefore, while
- she sat at her work, if she lost her needle or broke her thread, if she
- heard a carriage in the street, or saw a speck upon her gown, she must
- observe it aloud, whether there were anyone at leisure to answer her or not.
+ Her plan for the morning thus settled, she sat quietly down to her
+ book after breakfast, resolving to remain in the same place and the
+ same employment till the clock struck one; and from habitude very
+ little incommoded by the remarks and ejaculations of Mrs.\ Allen,
+ whose vacancy of mind and incapacity for thinking were such, that
+ as she never talked a great deal, so she could never be entirely
+ silent; and, therefore, while she sat at her work, if she lost her
+ needle or broke her thread, if she heard a carriage in the street,
+ or saw a speck upon her gown, she must observe it aloud, whether
+ there were anyone at leisure to answer her or not.
\end@{sloppypar@}
@end example
@@ -7688,10 +7715,11 @@
requested. This
@example
-Four score and seven years ago our fathers brought forth on this continent,
+Four score and seven years ago our fathers brought forth on this
+continent,
\newpage
-\noindent a new nation, conceived in Liberty, and dedicated to the proposition
-that all men are created equal.
+\noindent a new nation, conceived in Liberty, and dedicated to the
+proposition that all men are created equal.
@end example
@noindent makes a new page start after @samp{continent,} and the cut-off line
@@ -7768,7 +7796,8 @@
the line in which they appear. So this
@example
-Four score and seven years ago our fathers brought forth on this continent,
+Four score and seven years ago our fathers brought forth on this
+continent,
\pagebreak
a new nation, conceived in Liberty, and dedicated to the proposition
that all men are created equal.
@@ -7871,9 +7900,9 @@
@c Credit egreg: https://tex.stackexchange.com/a/21917
@example
-\renewcommand@{\footnoterule@}@{% Kerns keep it from taking up vertical space
- \kern -3pt % This -3 is the negative of
- \hrule width \textwidth height 1pt % the sum of this 1
+\renewcommand@{\footnoterule@}@{% Kerns avoid vertical space
+ \kern -3pt % This -3 is negative
+ \hrule width \textwidth height 1pt % of the sum of this 1
\kern 2pt@} % and this 2
@end example
@@ -7952,9 +7981,9 @@
@example
\newcounter@{footnoteValueSaver@}
All babies are illogical.\footnote@{%
- Source: Lewis Carroll.@}\setcounter@{footnoteValueSaver@}@{\value@{footnote@}@}
+ Lewis Carroll.@}\setcounter@{footnoteValueSaver@}@{\value@{footnote@}@}
Nobody is despised who can manage a crocodile.\footnote@{%
- Source: Captain Hook.@}
+ Captain Hook.@}
Illogical persons are despised.\footnotemark[\value@{footnoteValueSaver@}]
Therefore, anyone who can manage a crocodile is not a baby.
@end example
@@ -7968,8 +7997,8 @@
\usepackage@{cleveref@}[2012/02/15] % in preamble
\crefformat@{footnote@}@{#2\footnotemark[#1]#3@}
...
-The theorem is from Evers.\footnote@{\label@{fn:TE@}Tinker and Evers, 1994.@}
-The corollary is from Chance.\footnote@{Evers and Chance, 1990.@}
+The theorem is from Evers.\footnote@{\label@{fn:TE@}Tinker, Evers, 1994.@}
+The corollary is from Chance.\footnote@{Evers, Chance, 1990.@}
But the key lemma is from Tinker.\cref@{fn:TE@}
@end example
@@ -8018,7 +8047,8 @@
argument to @code{\section}
@example
-\section[Please]@{Please\footnote@{Don't footnote in chapter and section headers!@}@}
+\section[Please]@{Please\footnote@{%
+ Don't footnote in chapter and section headers!@}@}
@end example
No @code{\protect} is needed in front of @code{\footnote} here because
@@ -8072,8 +8102,12 @@
Christine Hatherleigh Wood &Fiance\footnotemark
\end@{tabular@}
\end@{minipage@}% percent sign keeps footnote text close to minipage
- \stepcounter@{mpFootnoteValueSaver@}\footnotetext[\value@{mpFootnoteValueSaver@}]@{Little is known other than her death.@}%
- \stepcounter@{mpFootnoteValueSaver@}\footnotetext[\value@{mpFootnoteValueSaver@}]@{Relationship is unresolved in XXI.@}
+ \stepcounter@{mpFootnoteValueSaver@}%
+ \footnotetext[\value@{mpFootnoteValueSaver@}]@{%
+ Little is known other than her death.@}%
+ \stepcounter@{mpFootnoteValueSaver@}%
+ \footnotetext[\value@{mpFootnoteValueSaver@}]@{%
+ Relationship is unresolved in XXI.@}
\end@{center@}
@end example
More information about the latexrefman-commits
mailing list