[latexrefman-commits] [SCM] latexrefman updated: r675 - trunk
jimhefferon at gnu.org.ua
jimhefferon at gnu.org.ua
Sun Jul 1 22:07:34 CEST 2018
Author: jimhefferon
Date: 2018-07-01 23:07:33 +0300 (Sun, 01 Jul 2018)
New Revision: 675
Modified:
trunk/ChangeLog
trunk/latex2e.html
trunk/latex2e.info
trunk/latex2e.pdf
trunk/latex2e.texi
Log:
Commit some more changes, through the \t's
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2018-07-01 16:00:16 UTC (rev 674)
+++ trunk/ChangeLog 2018-07-01 20:07:33 UTC (rev 675)
@@ -1,6 +1,11 @@
2018-07-01 Jim Hefferon <jhefferon at smcvt.edu>
* latex2e.texi (Many sections) Check entries against
+ latex2e-reference. Through the \t's.
+
+2018-07-01 Jim Hefferon <jhefferon at smcvt.edu>
+
+ * latex2e.texi (Many sections) Check entries against
latex2e-reference. Through the \m's.
2018-06-30 Karl Berry <karl at freefriends.org>
Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html 2018-07-01 16:00:16 UTC (rev 674)
+++ trunk/latex2e.html 2018-07-01 20:07:33 UTC (rev 675)
@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This document is an unofficial reference manual for LaTeX, a
-document preparation system, version of June 2018.
+document preparation system, version of July 2018.
This manual was originally translated from LATEX.HLP v1.0a in
the VMS Help Library. The pre-translation version was written by
@@ -37,10 +37,10 @@
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<title>LaTeX2e unofficial reference manual (June 2018)</title>
+<title>LaTeX2e unofficial reference manual (July 2018)</title>
-<meta name="description" content="LaTeX2e unofficial reference manual (June 2018)">
-<meta name="keywords" content="LaTeX2e unofficial reference manual (June 2018)">
+<meta name="description" content="LaTeX2e unofficial reference manual (July 2018)">
+<meta name="keywords" content="LaTeX2e unofficial reference manual (July 2018)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
@@ -81,7 +81,7 @@
</head>
<body lang="en">
-<h1 class="settitle" align="center">LaTeX2e unofficial reference manual (June 2018)</h1>
+<h1 class="settitle" align="center">LaTeX2e unofficial reference manual (July 2018)</h1>
@@ -309,11 +309,11 @@
<li><a name="toc-_005cnewcommand-_0026-_005crenewcommand-1" href="#g_t_005cnewcommand-_0026-_005crenewcommand">12.1 <code>\newcommand</code> & <code>\renewcommand</code></a></li>
<li><a name="toc-_005cprovidecommand-1" href="#g_t_005cprovidecommand">12.2 <code>\providecommand</code></a></li>
<li><a name="toc-_005cnewcounter_003a-Allocating-a-counter" href="#g_t_005cnewcounter">12.3 <code>\newcounter</code>: Allocating a counter</a></li>
- <li><a name="toc-_005cnewlength_003a-Allocating-a-length" href="#g_t_005cnewlength">12.4 <code>\newlength</code>: Allocating a length</a></li>
- <li><a name="toc-_005cnewsavebox_003a-Allocating-a-box" href="#g_t_005cnewsavebox">12.5 <code>\newsavebox</code>: Allocating a box</a></li>
+ <li><a name="toc-_005cnewlength-1" href="#g_t_005cnewlength">12.4 <code>\newlength</code></a></li>
+ <li><a name="toc-_005cnewsavebox-1" href="#g_t_005cnewsavebox">12.5 <code>\newsavebox</code></a></li>
<li><a name="toc-_005cnewenvironment-_0026-_005crenewenvironment-1" href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">12.6 <code>\newenvironment</code> & <code>\renewenvironment</code></a></li>
<li><a name="toc-_005cnewtheorem-1" href="#g_t_005cnewtheorem">12.7 <code>\newtheorem</code></a></li>
- <li><a name="toc-_005cnewfont_003a-Define-a-new-font-_0028obsolete_0029" href="#g_t_005cnewfont">12.8 <code>\newfont</code>: Define a new font (obsolete)</a></li>
+ <li><a name="toc-_005cnewfont-1" href="#g_t_005cnewfont">12.8 <code>\newfont</code></a></li>
<li><a name="toc-_005cprotect-1" href="#g_t_005cprotect">12.9 <code>\protect</code></a></li>
<li><a name="toc-_005cignorespaces-_0026-_005cignorespacesafterend-1" href="#g_t_005cignorespaces-_0026-_005cignorespacesafterend">12.10 <code>\ignorespaces & \ignorespacesafterend</code></a></li>
</ul></li>
@@ -335,7 +335,7 @@
<li><a name="toc-_005caddtolength-1" href="#g_t_005caddtolength">14.3 <code>\addtolength</code></a></li>
<li><a name="toc-_005csettodepth-1" href="#g_t_005csettodepth">14.4 <code>\settodepth</code></a></li>
<li><a name="toc-_005csettoheight-1" href="#g_t_005csettoheight">14.5 <code>\settoheight</code></a></li>
- <li><a name="toc-_005csettowidth_007d" href="#g_t_005csettowidth">14.6 <code>\settowidth}</code></a></li>
+ <li><a name="toc-_005csettowidth-1" href="#g_t_005csettowidth">14.6 <code>\settowidth</code></a></li>
</ul></li>
<li><a name="toc-Making-paragraphs-1" href="#Making-paragraphs">15 Making paragraphs</a>
<ul class="no-bullet">
@@ -528,7 +528,7 @@
<h1 class="top">LaTeX2e: An unofficial reference manual</h1>
<p>This document is an unofficial reference manual (version of
-June 2018) for LaTeX2e, a document preparation system.
+July 2018) for LaTeX2e, a document preparation system.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#About-this-document" accesskey="1">About this document</a>:</td><td> </td><td align="left" valign="top">Bug reporting, etc.
@@ -2604,10 +2604,9 @@
<p>Start a new page and produce single-column output. If the document is
given the class option <code>onecolumn</code> then this is the default
-behavior (see <a href="#Document-class-options">Document class options</a>).
+behavior (see <a href="#Document-class-options">Document class options</a>). This command is fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
</p>
-<p>This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
-</p>
<hr>
<a name="g_t_005ctwocolumn"></a>
@@ -4465,7 +4464,13 @@
\end{enumerate}
</pre></div>
+<a name="index-package_002c-cleveref-1"></a>
+<a name="index-cleveref-package-1"></a>
+<p>The <samp>cleveref</samp> package includes text such as ‘<samp>Theorem</samp>’ in the
+reference. See the documentation on CTAN.
+</p>
+
<hr>
<a name="Environments"></a>
<div class="header">
@@ -7023,7 +7028,7 @@
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\shortstack[<var>position</var>]{<var>line 1</var> \\ <var>line 2</var> \\ ... }
+<pre class="example">\shortstack[<var>position</var>]{<var>line 1</var> \\ ... }
</pre></div>
<p>Produce a vertical stack of objects.
@@ -7037,9 +7042,9 @@
</pre></div>
<p>For a short stack, the reference point is the lower left of the stack.
-In this example the <a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox & \makebox</a> puts the stack flush right in
-a zero width box so in total the short stack sits slightly to the left
-of the <em>y</em> axis.
+In the above example the <a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox & \makebox</a> puts the stack flush
+right in a zero width box so in total the short stack sits slightly to
+the left of the <em>y</em> axis.
</p>
<p>The valid positions are:
</p>
@@ -8342,12 +8347,12 @@
</pre></div>
<p>Produces no output but writes <var>keys</var> to the auxiliary file
-<samp><var>filename</var>.aux</samp>.
+<samp><var>doc-filename</var>.aux</samp>.
</p>
<p>The mandatory argument <var>keys</var> is a comma-separated list of one or
more citation keys (see <a href="#g_t_005cbibitem">\bibitem</a>). This information is used by
BibTeX to include these works in your reference list even though you
-have not actually cited them (see <a href="#g_t_005ccite">\cite</a>).
+have not cited them (see <a href="#g_t_005ccite">\cite</a>).
</p>
<hr>
@@ -8933,16 +8938,18 @@
<a name="index-_005cnewline"></a>
<a name="index-new-line_002c-starting-_0028paragraph-mode_0029"></a>
-<p>In ordinary text this is equivalent to double-backslash (see <a href="#g_t_005c_005c">\\</a>); it
-ends a line, and does so in a way that does not right-justify the line,
-so the prior text is not stretched. This command is fragile
+<p>In ordinary text, this ends a line in a way that does not right-justify
+the line, so the prior text is not stretched. That is, in paragraph mode
+(see <a href="#Modes">Modes</a>), the <code>\newline</code> command is equivalent to
+double-backslash (see <a href="#g_t_005c_005c">\\</a>). This command is fragile
(see <a href="#g_t_005cprotect">\protect</a>).
</p>
-<p>Inside a <code>tabular</code> or <code>array</code> environment, in a column with a
-specifier producing a paragraph box such as typically <code>p{...}</code>,
-<code>\newline</code> will insert a line end inside of the column; that is, it
-does not break the entire tabular row. To break the entire row use
-<code>\\</code> or its equivalent <code>\tabularnewline</code>.
+<p>However, the two commands are different inside a <code>tabular</code> or
+<code>array</code> environment. In a column with a specifier producing a
+paragraph box such as typically <code>p{...}</code>, <code>\newline</code> will
+insert a line end inside of the column; that is, it does not break the
+entire tabular row. To break the entire row use <code>\\</code> or its
+equivalent <code>\tabularnewline</code>.
</p>
<p>This will print ‘<samp>Name:</samp>’ and ‘<samp>Address:</samp>’ as two lines in a
single cell of the table.
@@ -9172,10 +9179,12 @@
</pre></div>
<p>Encourage or discourage a line break. The optional <var>zero-to-four</var>
-is an integer that converts the command from a demand to a request. The
-higher the number, the more insistent the request. The default is 4, so
-that without the optional argument these commands entirely force or
-prevent the break. Both commands are fragile (see <a href="#g_t_005cprotect">\protect</a>).
+is an integer that allows you to soften the instruction. The default is
+4, so that without the optional argument these commands entirely force
+or prevent the break. But for instance, <code>\nolinebreak[1]</code> is a
+suggestion that another place may be better. The higher the number, the
+more insistent the request. Both commands are fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
</p>
<p>Here we tell LaTeX that a good place to put a linebreak is after the
standard legal text.
@@ -9423,10 +9432,12 @@
</pre></div>
<p>Encourage or discourage a page break. The optional <var>zero-to-four</var>
-is an integer that converts the command from a demand to a request. The
-higher the number, the more insistent the request. The default is 4, so
-that without the optional argument these commands entirely force or
-prevent the break. Both commands are fragile (see <a href="#g_t_005cprotect">\protect</a>).
+is an integer that allows you to soften the request. The default is 4,
+so that without the optional argument these commands entirely force or
+prevent the break. But for instance <code>\nopagebreak[1]</code> suggests to
+LaTeX that another spot might be preferrable. The higher the number,
+the more insistent the request. Both commands are fragile
+(see <a href="#g_t_005cprotect">\protect</a>).
</p>
<p>LaTeX’s page endings are optimized so ordinarily you only use this
command in a document body to polish the final version, or inside
@@ -9657,8 +9668,8 @@
Therefore, anyone who can manage a crocodile is not a baby.
</pre></div>
-<a name="index-package_002c-cleveref-1"></a>
-<a name="index-cleveref-package-1"></a>
+<a name="index-package_002c-cleveref-2"></a>
+<a name="index-cleveref-package-2"></a>
<a name="index-package_002c-hyperref"></a>
<a name="index-hyperref-package"></a>
@@ -9944,31 +9955,31 @@
<dt><var>cmd</var></dt>
<dd>
<p>Required; the command name. It must begin with a backslash, <code>\</code>,
-and must not begin with <code>\end</code>. For <code>\newcommand</code>, it must
-not be already defined. For <code>\renewcommand</code>, this name must
-already be defined.
+and must not begin with the four letter string <code>\end</code>. For
+<code>\newcommand</code>, it must not be already defined. For
+<code>\renewcommand</code>, this name must already be defined.
</p>
</dd>
<dt><var>nargs</var></dt>
<dd><p>Optional; an integer from 0 to 9, specifying the number of arguments
-that the command can take, including any optional argument. Omitting
-this argument is the same as specifying 0, meaning that the command has
-no arguments. If you redefine a command, the new version can have a
+that the command takes, including any optional argument. Omitting this
+argument is the same as specifying 0, meaning that the command has no
+arguments. If you redefine a command, the new version can have a
different number of arguments than the old version.
</p>
</dd>
<dt><var>optargdefault</var></dt>
-<dd><p>Optional; if this argument is present then the first argument of defined
-command <code>\<var>cmd</var></code> is optional, with default value <var>optargdefault</var>
+<dd><p>Optional; if this argument is present then the first argument of
+<code>\<var>cmd</var></code> is optional, with default value <var>optargdefault</var>
(which may be the empty string). If this argument is not present then
<code>\<var>cmd</var></code> does not take an optional argument.
</p>
<a name="index-positional-parameter"></a>
<p>That is, if <code>\<var>cmd</var></code> is used with square brackets, as in
-<code>\<var>cmd</var>[<var>optval</var>]</code>, then within <var>defn</var> then <code>#1</code>
-is set to the value of <var>optval</var>. On the other hand, if
-<code>\<var>cmd</var></code> is called without the square brackets, then within
-<var>defn</var> the parameter <code>#1</code> is set to the value of
+<code>\<var>cmd</var>[<var>optval</var>]{...}...</code>, then within <var>defn</var> the
+parameter <code>#1</code> is set to the value of <var>optval</var>. On the
+other hand, if <code>\<var>cmd</var></code> is called without the square brackets
+then within <var>defn</var> the parameter <code>#1</code> is set to the value of
<var>optargdefault</var>. In either case, the required arguments start with
<code>#2</code>.
</p>
@@ -10166,8 +10177,8 @@
<p>
Next: <a href="#g_t_005cnewsavebox" accesskey="n" rel="next">\newsavebox</a>, Previous: <a href="#g_t_005cnewcounter" accesskey="p" rel="prev">\newcounter</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cnewlength_003a-Allocating-a-length"></a>
-<h3 class="section">12.4 <code>\newlength</code>: Allocating a length</h3>
+<a name="g_t_005cnewlength-1"></a>
+<h3 class="section">12.4 <code>\newlength</code></h3>
<a name="index-_005cnewlength"></a>
<a name="index-lengths_002c-allocating-new"></a>
@@ -10178,13 +10189,13 @@
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\newlength{\<var>arg</var>}
+<pre class="example">\newlength{<var>arg</var>}
</pre></div>
<p>Allocate a new length register (see <a href="#Lengths">Lengths</a>). The required argument
-must begin with a backslash, <code>\</code>. The new register hold rubber
-lengths such as <code>72.27pt</code> or <code>1in plus.2in minus.1in</code> (a
-LaTeX length register is what plain TeX calls a <code>skip</code>
+<var>arg</var> must begin with a backslash, <code>\</code>. The new register holds
+rubber lengths such as <code>72.27pt</code> or <code>1in plus.2in minus.1in</code>
+(a LaTeX length register is what plain TeX calls a <code>skip</code>
register). The initial value is zero. The control sequence
<code>\<var>arg</var></code> must not be already defined.
</p>
@@ -10206,8 +10217,8 @@
<p>
Next: <a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment" accesskey="n" rel="next">\newenvironment & \renewenvironment</a>, Previous: <a href="#g_t_005cnewlength" accesskey="p" rel="prev">\newlength</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cnewsavebox_003a-Allocating-a-box"></a>
-<h3 class="section">12.5 <code>\newsavebox</code>: Allocating a box</h3>
+<a name="g_t_005cnewsavebox-1"></a>
+<h3 class="section">12.5 <code>\newsavebox</code></h3>
<a name="index-_005cnewsavebox"></a>
<a name="index-box_002c-allocating-new"></a>
@@ -10215,13 +10226,14 @@
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\newsavebox{\<var>cmd</var>}
+<pre class="example">\newsavebox{<var>cmd</var>}
</pre></div>
<p>Define <code>\<var>cmd</var></code> to refer to a new “bin” for storing boxes.
Such a box is for holding typeset material, to use multiple times or to
-measure or manipulate (see <a href="#Boxes">Boxes</a>). The name <code>\<var>cmd</var></code> must
-start with a backslash, <code>\</code>, and must not already be defined.
+measure or manipulate (see <a href="#Boxes">Boxes</a>). The required bin name
+<code><var>cmd</var></code> must start with a backslash, <code>\</code>, and must not
+already be defined. This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
</p>
<p>The first line here sets you up to save the material for later use.
</p>
@@ -10233,12 +10245,11 @@
<p>The output is ‘<samp>Our logo is LoGo</samp>’.
</p>
-<p>If there is an already defined box then you get something like
+<p>If there is an already defined bin then you get something like
‘<samp>LaTeX Error: Command \logobox already defined. Or name
\end... illegal, see p.192 of the manual</samp>’.
</p>
-<p>The allocation of a box is global. This command is fragile
-(see <a href="#g_t_005cprotect">\protect</a>).
+<p>The allocation of a box is global.
</p>
<hr>
@@ -10283,8 +10294,8 @@
</p>
<a name="index-_002a_002dform-of-environment-commands"></a>
<p>The starred form of these commands requires that the arguments not
-contain multiple paragraphs of text. The body of these environments can
-still contain multiple paragraphs.
+contain multiple paragraphs of text. However, the body of these
+environments can contain multiple paragraphs.
</p>
<dl compact="compact">
<dt><var>env</var></dt>
@@ -10299,9 +10310,9 @@
</dd>
<dt><var>nargs</var></dt>
<dd><p>Optional; an integer from 0 to 9 denoting the number of arguments of
-that the environment will take. When you use the environment these
+that the environment takes. When you use the environment these
arguments appear after the <code>\begin</code>, as in
-<code>\begin{<var>env</var>}{<var>arg1</var>} .... {<var>argn</var>}</code>. Omitting
+<code>\begin{<var>env</var>}{<var>arg1</var>} ... {<var>argn</var>}</code>. Omitting
this is equivalent to setting it to 0; the environment will have no
arguments. When redefining an environment, the new version can have a
different number of arguments than the old version.
@@ -10313,14 +10324,14 @@
may be the empty string). If this is not in the definition then the
environment does not take an optional argument.
</p>
-<p>That is, when this is present in the environment definition then you can
-start the environment with square brackets, as in
-<code>\begin{<var>env</var>}[<var>optval</var>] ... \end{<var>env</var>}</code>. In this
-case, within <var>begdefn</var> the parameter <code>#1</code> is set to the value
-of <var>optval</var>. If you call <code>\begin{<var>env</var>}</code> without square
-brackets, then within <var>begdefn</var> the parameter <code>#1</code> is set to
-the value of the default <var>optargdefault</var>. In either case, any
-required arguments start with <code>#2</code>.
+<p>That is, when <var>optargdefault</var> is present in the environment
+definition then you can start the environment with square brackets, as
+in <code>\begin{<var>env</var>}[<var>optval</var>]{...} ... \end{<var>env</var>}</code>.
+In this case, within <var>begdefn</var> the parameter <code>#1</code> is set to the
+value of <var>optval</var>. If you call <code>\begin{<var>env</var>}</code> without
+square brackets, then within <var>begdefn</var> the parameter <code>#1</code> is
+set to the value of the default <var>optargdefault</var>. In either case,
+any required arguments start with <code>#2</code>.
</p>
<p>Omitting <code>[<var>myval</var>]</code> in the call is different than having the
square brackets with no contents, as in <code>[]</code>. The former results
@@ -10338,9 +10349,9 @@
</dd>
<dt><var>enddef</var></dt>
<dd><p>Required; the text expanded at every occurrence of
-<code>\end{<var>env</var>}</code>. This may not contain any parameters, so you
-cannot use <code>#1</code>, <code>#2</code>, etc., here (but see the final example
-below).
+<code>\end{<var>env</var>}</code>. This may not contain any parameters, that is,
+you cannot use <code>#1</code>, <code>#2</code>, etc., here (but see the final
+example below).
</p>
</dd>
</dl>
@@ -10367,10 +10378,20 @@
}
</pre></div>
-<p>This one shows the use of arguments; it gives a quotation environment
-that cites the author.
+<p>This has an argument, which is set in boldface at the start of a
+paragraph.
</p>
<div class="example">
+<pre class="example">\newenvironment{point}[1]{%
+ \noindent\textbf{#1}
+}{%
+}
+</pre></div>
+
+<p>This one shows the use of a optional argument; it gives a quotation
+environment that cites the author.
+</p>
+<div class="example">
<pre class="example">\newenvironment{citequote}[1][Shakespeare]{%
\begin{quotation}
\noindent\textit{#1}:
@@ -10456,9 +10477,10 @@
</p>
<dl compact="compact">
<dt><var>name</var></dt>
-<dd><p>The name of the environment. It must not begin with a backslash,
-<code>\</code>. It must not be the name of an existing environment, and
-the command name <code>\<var>name</var></code> must not already be defined.
+<dd><p>The name of the environment. It is a string of letters. It must not
+begin with a backslash, <code>\</code>. It must not be the name of an
+existing environment, and the command name <code>\<var>name</var></code> must not
+already be defined.
</p>
</dd>
<dt><var>title</var></dt>
@@ -10552,8 +10574,8 @@
<p>
Next: <a href="#g_t_005cprotect" accesskey="n" rel="next">\protect</a>, Previous: <a href="#g_t_005cnewtheorem" accesskey="p" rel="prev">\newtheorem</a>, Up: <a href="#Definitions" accesskey="u" rel="up">Definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005cnewfont_003a-Define-a-new-font-_0028obsolete_0029"></a>
-<h3 class="section">12.8 <code>\newfont</code>: Define a new font (obsolete)</h3>
+<a name="g_t_005cnewfont-1"></a>
+<h3 class="section">12.8 <code>\newfont</code></h3>
<a name="index-_005cnewfont"></a>
<a name="index-fonts_002c-new-commands-for"></a>
@@ -11022,9 +11044,9 @@
</pre></div>
<p>Globally set the counter <var>counter</var> to have the value of the
-<var>value</var> argument. Thus, you can set a counter’s value as
-<code>\setcounter{section}{5}</code>. Note that the counter name does not
-start with a backslash.
+<var>value</var> argument, which must be an integer. Thus, you can set a
+counter’s value as <code>\setcounter{section}{5}</code>. Note that the
+counter name does not start with a backslash.
</p>
<p>In this example if the counter <code>theorem</code> has value 12 then the
second line will print ‘<samp>XII</samp>’.
@@ -11113,6 +11135,11 @@
within it. (For the definition of “counters numbered within”,
see <a href="#g_t_005cnewcounter">\newcounter</a>.)
</p>
+<p>This command differs from <code>\refstepcounter</code> in that this one does
+not influence references — it does not define the current
+<code>\ref</code> value to be the result of <code>\thecounter</code>
+(see <a href="#g_t_005crefstepcounter">\refstepcounter</a>).
+</p>
<hr>
<a name="g_t_005cday-_0026-_005cmonth-_0026-_005cyear"></a>
@@ -11470,8 +11497,9 @@
<pre class="example">\settodepth{<var>len</var>}{<var>text</var>}
</pre></div>
-<p>Set the length <var>len</var> to the depth of the <var>text</var> argument. The
-length name <var>len</var> must begin with a backslash, <code>\</code>.
+<p>Set the length <var>len</var> to the depth of box that LaTeX gets on
+typesetting the <var>text</var> argument. The length name <var>len</var> must
+begin with a backslash, <code>\</code>.
</p>
<p>This will show how low the character descenders go.
</p>
@@ -11505,9 +11533,9 @@
<pre class="example">\settoheight{<var>len</var>}{text}
</pre></div>
-<p>Sets the length <var>len</var> to the height of the
-<code>text</code> argument. The length name <var>len</var> must begin with a
-backslash, <code>\</code>.
+<p>Sets the length <var>len</var> to the height of box that LaTeX gets on
+typesetting the <code>text</code> argument. The length name <var>len</var> must
+begin with a backslash, <code>\</code>.
</p>
<p>This will show how high the characters go.
</p>
@@ -11530,8 +11558,8 @@
<p>
Previous: <a href="#g_t_005csettoheight" accesskey="p" rel="prev">\settoheight</a>, Up: <a href="#Lengths" accesskey="u" rel="up">Lengths</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_005csettowidth_007d"></a>
-<h3 class="section">14.6 <code>\settowidth}</code></h3>
+<a name="g_t_005csettowidth-1"></a>
+<h3 class="section">14.6 <code>\settowidth</code></h3>
<a name="index-_005csettowidth"></a>
@@ -11541,8 +11569,9 @@
<pre class="example">\settowidth{<var>len</var>}{<var>text</var>}
</pre></div>
-<p>Set the length <var>len</var> to the width of the <var>text</var>. The length
-name <var>len</var> must begin with a backslash, <code>\</code>.
+<p>Set the length <var>len</var> to the width of the box that LaTeX gets on
+typesetting the <var>text</var> argument. The length name <var>len</var> must
+begin with a backslash, <code>\</code>.
</p>
<p>This measures the width of the lowercase ASCII alphabet.
</p>
@@ -11647,7 +11676,7 @@
<a name="index-_005cpar"></a>
<a name="index-paragraph_002c-ending"></a>
-<p>Synopsis (note that while reading the input TeX converts two
+<p>Synopsis (note that while reading the input TeX, converts two
consecutive newlines to a <code>\par</code>):
</p>
<div class="example">
@@ -15203,7 +15232,26 @@
declaration has global scope, so its effect is not delimited by braces
or environments.
</p>
+<p>Often the first page of a chapter or section has a different style. For
+example, this LaTeX book document has the first page of the first
+chapter in in <code>plain</code> style, as is the default (see <a href="#Page-styles">Page styles</a>).
+</p>
+<div class="example">
+<pre class="example">\documentclass{book}
+\pagestyle{headings}
+\begin{document}
+\chapter{First chapter}
+ ...
+\chapter{Second chapter}\thispagestyle{empty}
+ ...
+</pre></div>
+<p>The <code>plain</code> style has a page number on it, centered in the footer.
+To make the page entirely empty, the command
+<code>\thispagestyle{empty}</code> immediately follows the second
+<code>\chapter</code>.
+</p>
+
<hr>
<a name="Spaces"></a>
<div class="header">
@@ -16782,7 +16830,7 @@
<p>Typeset <var>text</var> just as with <code>\makebox</code> (see <a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox & \makebox</a>) except that LaTeX does not output it but instead saves it
in a storage bin named <var>box-cmd</var>. The bin name <var>box-cmd</var> begins
-with a backslash. You must have previously allocated the bin
+with a backslash, <code>\</code>. You must have previously allocated the bin
<var>box-cmd</var> with <code>\newsavebox</code> (see <a href="#g_t_005cnewsavebox">\newsavebox</a>).The
<code>\sbox</code> command is robust while <code>\savebox</code> is fragile
(see <a href="#g_t_005cprotect">\protect</a>).
@@ -19379,12 +19427,12 @@
\rule[<var>raise</var>]{<var>width</var>}{<var>thickness</var>}
</pre></div>
-<p>Produce a <em>rule</em>, a rectangle.
+<p>Produce a <em>rule</em>, a filled-in rectangle.
</p>
<a name="index-Halmos-symbol"></a>
<a name="index-tombstone"></a>
-<p>This produces a rectangular blob of ink, sometimes called a Halmos
-symbol, often used to mark the end of a proof.
+<p>This produces a rectangular blob, sometimes called a Halmos symbol,
+often used to mark the end of a proof.
</p>
<div class="example">
<pre class="example">\newcommand{\qedsymbol}{\rule{0.4em}{2ex}}
@@ -19396,9 +19444,10 @@
<p>The <samp>amsthm</samp> package includes this command, with a somewhat
different-looking symbol.
</p>
-<p>The mandatory arguments <var>width</var> and <var>thickness</var> are rigid
-lengths (see <a href="#Lengths">Lengths</a>). The optional argument <var>raise</var> is also a
-rigid length, and tells LaTeX how much to raise the rule above the
+<p>The mandatory arguments give the horizontal <var>width</var> and vertical
+<var>thickness</var> of the rectangle. They are rigid lengths
+(see <a href="#Lengths">Lengths</a>). The optional argument <var>raise</var> is also a rigid
+length, and tells LaTeX how much to raise the rule above the
baseline, or lower it if the length is negative.
</p>
<p>This produces a line, a rectangle that is wide but not tall.
@@ -23306,7 +23355,8 @@
<tr><td></td><td valign="top"><a href="#index-class-options-2">class options</a>:</td><td> </td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-classes-of-documents">classes of documents</a>:</td><td> </td><td valign="top"><a href="#Document-classes">Document classes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cleveref-package"><code>cleveref</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-cleveref-package-1"><code>cleveref</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cleveref-package-1"><code>cleveref</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cleveref-package-2"><code>cleveref</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-clock-option-to-slides-class"><code>clock <span class="roman">option to <code>slides</code> class</span></code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-closing-letters">closing letters</a>:</td><td> </td><td valign="top"><a href="#g_t_005cclosing">\closing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-closing-quote">closing quote</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
@@ -23890,7 +23940,8 @@
<tr><td></td><td valign="top"><a href="#index-package_002c-bigfoot"><span class="roman">package</span>, <code>bigfoot</code></a>:</td><td> </td><td valign="top"><a href="#Footnotes-of-footnotes">Footnotes of footnotes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-bm"><span class="roman">package</span>, <code>bm</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cboldmath-_0026-_005cunboldmath">\boldmath & \unboldmath</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-cleveref"><span class="roman">package</span>, <code>cleveref</code></a>:</td><td> </td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-cleveref-1"><span class="roman">package</span>, <code>cleveref</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-cleveref-1"><span class="roman">package</span>, <code>cleveref</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-cleveref-2"><span class="roman">package</span>, <code>cleveref</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-cprotect"><span class="roman">package</span>, <code>cprotect</code></a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-cprotect-1"><span class="roman">package</span>, <code>cprotect</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-datetime"><span class="roman">package</span>, <code>datetime</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info 2018-07-01 16:00:16 UTC (rev 674)
+++ trunk/latex2e.info 2018-07-01 20:07:33 UTC (rev 675)
@@ -2,7 +2,7 @@
latex2e.texi.
This document is an unofficial reference manual for LaTeX, a document
-preparation system, version of June 2018.
+preparation system, version of July 2018.
This manual was originally translated from 'LATEX.HLP' v1.0a in the
VMS Help Library. The pre-translation version was written by George D.
@@ -42,7 +42,7 @@
LaTeX2e: An unofficial reference manual
***************************************
-This document is an unofficial reference manual (version of June 2018)
+This document is an unofficial reference manual (version of July 2018)
for LaTeX2e, a document preparation system.
* Menu:
@@ -1449,10 +1449,9 @@
Start a new page and produce single-column output. If the document
is given the class option 'onecolumn' then this is the default behavior
-(*note Document class options::).
+(*note Document class options::). This command is fragile (*note
+\protect::).
- This command is fragile (*note \protect::).
-
File: latex2e.info, Node: \twocolumn, Next: \flushbottom, Prev: \onecolumn, Up: Layout
@@ -2786,6 +2785,9 @@
\item Con\TeX t
\end{enumerate}
+ The 'cleveref' package includes text such as 'Theorem' in the
+reference. See the documentation on CTAN.
+
File: latex2e.info, Node: Environments, Next: Line breaking, Prev: Cross references, Up: Top
@@ -4628,7 +4630,7 @@
Synopsis:
- \shortstack[POSITION]{LINE 1 \\ LINE 2 \\ ... }
+ \shortstack[POSITION]{LINE 1 \\ ... }
Produce a vertical stack of objects.
@@ -4639,9 +4641,9 @@
\put(-0.25,2){\makebox[0][r]{\shortstack[r]{$y$\\ axis}}}
For a short stack, the reference point is the lower left of the stack.
-In this example the *note \mbox & \makebox:: puts the stack flush right
-in a zero width box so in total the short stack sits slightly to the
-left of the y axis.
+In the above example the *note \mbox & \makebox:: puts the stack flush
+right in a zero width box so in total the short stack sits slightly to
+the left of the y axis.
The valid positions are:
@@ -5598,12 +5600,12 @@
\nocite{KEYS}
Produces no output but writes KEYS to the auxiliary file
-'FILENAME.aux'.
+'DOC-FILENAME.aux'.
The mandatory argument KEYS is a comma-separated list of one or more
citation keys (*note \bibitem::). This information is used by BibTeX to
include these works in your reference list even though you have not
-actually cited them (*note \cite::).
+cited them (*note \cite::).
File: latex2e.info, Node: Using BibTeX, Prev: \nocite, Up: thebibliography
@@ -6009,16 +6011,17 @@
9.3 '\newline'
==============
-In ordinary text this is equivalent to double-backslash (*note \\::); it
-ends a line, and does so in a way that does not right-justify the line,
-so the prior text is not stretched. This command is fragile (*note
+In ordinary text, this ends a line in a way that does not right-justify
+the line, so the prior text is not stretched. That is, in paragraph
+mode (*note Modes::), the '\newline' command is equivalent to
+double-backslash (*note \\::). This command is fragile (*note
\protect::).
- Inside a 'tabular' or 'array' environment, in a column with a
-specifier producing a paragraph box such as typically 'p{...}',
-'\newline' will insert a line end inside of the column; that is, it does
-not break the entire tabular row. To break the entire row use '\\' or
-its equivalent '\tabularnewline'.
+ However, the two commands are different inside a 'tabular' or 'array'
+environment. In a column with a specifier producing a paragraph box
+such as typically 'p{...}', '\newline' will insert a line end inside of
+the column; that is, it does not break the entire tabular row. To break
+the entire row use '\\' or its equivalent '\tabularnewline'.
This will print 'Name:' and 'Address:' as two lines in a single cell
of the table.
@@ -6182,10 +6185,11 @@
\nolinebreak[ZERO-TO-FOUR]
Encourage or discourage a line break. The optional ZERO-TO-FOUR is
-an integer that converts the command from a demand to a request. The
-higher the number, the more insistent the request. The default is 4, so
-that without the optional argument these commands entirely force or
-prevent the break. Both commands are fragile (*note \protect::).
+an integer that allows you to soften the instruction. The default is 4,
+so that without the optional argument these commands entirely force or
+prevent the break. But for instance, '\nolinebreak[1]' is a suggestion
+that another place may be better. The higher the number, the more
+insistent the request. Both commands are fragile (*note \protect::).
Here we tell LaTeX that a good place to put a linebreak is after the
standard legal text.
@@ -6364,10 +6368,11 @@
\nopagebreak[ZERO-TO-FOUR]
Encourage or discourage a page break. The optional ZERO-TO-FOUR is
-an integer that converts the command from a demand to a request. The
-higher the number, the more insistent the request. The default is 4, so
+an integer that allows you to soften the request. The default is 4, so
that without the optional argument these commands entirely force or
-prevent the break. Both commands are fragile (*note \protect::).
+prevent the break. But for instance '\nopagebreak[1]' suggests to LaTeX
+that another spot might be preferrable. The higher the number, the more
+insistent the request. Both commands are fragile (*note \protect::).
LaTeX's page endings are optimized so ordinarily you only use this
command in a document body to polish the final version, or inside
@@ -6737,30 +6742,30 @@
CMD
Required; the command name. It must begin with a backslash, '\',
- and must not begin with '\end'. For '\newcommand', it must not be
- already defined. For '\renewcommand', this name must already be
- defined.
+ and must not begin with the four letter string '\end'. For
+ '\newcommand', it must not be already defined. For
+ '\renewcommand', this name must already be defined.
NARGS
Optional; an integer from 0 to 9, specifying the number of
- arguments that the command can take, including any optional
- argument. Omitting this argument is the same as specifying 0,
- meaning that the command has no arguments. If you redefine a
- command, the new version can have a different number of arguments
- than the old version.
+ arguments that the command takes, including any optional argument.
+ Omitting this argument is the same as specifying 0, meaning that
+ the command has no arguments. If you redefine a command, the new
+ version can have a different number of arguments than the old
+ version.
OPTARGDEFAULT
Optional; if this argument is present then the first argument of
- defined command '\CMD' is optional, with default value
- OPTARGDEFAULT (which may be the empty string). If this argument is
- not present then '\CMD' does not take an optional argument.
+ '\CMD' is optional, with default value OPTARGDEFAULT (which may be
+ the empty string). If this argument is not present then '\CMD'
+ does not take an optional argument.
That is, if '\CMD' is used with square brackets, as in
- '\CMD[OPTVAL]', then within DEFN then '#1' is set to the value of
- OPTVAL. On the other hand, if '\CMD' is called without the square
- brackets, then within DEFN the parameter '#1' is set to the value
- of OPTARGDEFAULT. In either case, the required arguments start
- with '#2'.
+ '\CMD[OPTVAL]{...}...', then within DEFN the parameter '#1' is set
+ to the value of OPTVAL. On the other hand, if '\CMD' is called
+ without the square brackets then within DEFN the parameter '#1' is
+ set to the value of OPTARGDEFAULT. In either case, the required
+ arguments start with '#2'.
Omitting '[OPTARGDEFAULT]' is different from having the square
brackets with no contents, as in '[]'. The former sets '#1' to the
@@ -6909,18 +6914,18 @@
File: latex2e.info, Node: \newlength, Next: \newsavebox, Prev: \newcounter, Up: Definitions
-12.4 '\newlength': Allocating a length
-======================================
+12.4 '\newlength'
+=================
Synopsis:
- \newlength{\ARG}
+ \newlength{ARG}
Allocate a new length register (*note Lengths::). The required
-argument must begin with a backslash, '\'. The new register hold rubber
-lengths such as '72.27pt' or '1in plus.2in minus.1in' (a LaTeX length
-register is what plain TeX calls a 'skip' register). The initial value
-is zero. The control sequence '\ARG' must not be already defined.
+argument ARG must begin with a backslash, '\'. The new register holds
+rubber lengths such as '72.27pt' or '1in plus.2in minus.1in' (a LaTeX
+length register is what plain TeX calls a 'skip' register). The initial
+value is zero. The control sequence '\ARG' must not be already defined.
An example:
@@ -6934,17 +6939,18 @@
File: latex2e.info, Node: \newsavebox, Next: \newenvironment & \renewenvironment, Prev: \newlength, Up: Definitions
-12.5 '\newsavebox': Allocating a box
-====================================
+12.5 '\newsavebox'
+==================
Synopsis:
- \newsavebox{\CMD}
+ \newsavebox{CMD}
Define '\CMD' to refer to a new "bin" for storing boxes. Such a box
is for holding typeset material, to use multiple times or to measure or
-manipulate (*note Boxes::). The name '\CMD' must start with a
-backslash, '\', and must not already be defined.
+manipulate (*note Boxes::). The required bin name 'CMD' must start with
+a backslash, '\', and must not already be defined. This command is
+fragile (*note \protect::).
The first line here sets you up to save the material for later use.
@@ -6954,12 +6960,11 @@
The output is 'Our logo is LoGo'.
- If there is an already defined box then you get something like 'LaTeX
+ If there is an already defined bin then you get something like 'LaTeX
Error: Command \logobox already defined. Or name \end... illegal, see
p.192 of the manual'.
- The allocation of a box is global. This command is fragile (*note
-\protect::).
+ The allocation of a box is global.
File: latex2e.info, Node: \newenvironment & \renewenvironment, Next: \newtheorem, Prev: \newsavebox, Up: Definitions
@@ -6989,8 +6994,8 @@
'\begin{ENV} ... BODY ... \end{ENV}'.
The starred form of these commands requires that the arguments not
-contain multiple paragraphs of text. The body of these environments can
-still contain multiple paragraphs.
+contain multiple paragraphs of text. However, the body of these
+environments can contain multiple paragraphs.
ENV
Required; the environment name. It consists only of letters or the
@@ -7003,9 +7008,9 @@
NARGS
Optional; an integer from 0 to 9 denoting the number of arguments
- of that the environment will take. When you use the environment
- these arguments appear after the '\begin', as in '\begin{ENV}{ARG1}
- .... {ARGN}'. Omitting this is equivalent to setting it to 0; the
+ of that the environment takes. When you use the environment these
+ arguments appear after the '\begin', as in '\begin{ENV}{ARG1} ...
+ {ARGN}'. Omitting this is equivalent to setting it to 0; the
environment will have no arguments. When redefining an
environment, the new version can have a different number of
arguments than the old version.
@@ -7016,13 +7021,14 @@
may be the empty string). If this is not in the definition then
the environment does not take an optional argument.
- That is, when this is present in the environment definition then
- you can start the environment with square brackets, as in
- '\begin{ENV}[OPTVAL] ... \end{ENV}'. In this case, within BEGDEFN
- the parameter '#1' is set to the value of OPTVAL. If you call
- '\begin{ENV}' without square brackets, then within BEGDEFN the
- parameter '#1' is set to the value of the default OPTARGDEFAULT.
- In either case, any required arguments start with '#2'.
+ That is, when OPTARGDEFAULT is present in the environment
+ definition then you can start the environment with square brackets,
+ as in '\begin{ENV}[OPTVAL]{...} ... \end{ENV}'. In this case,
+ within BEGDEFN the parameter '#1' is set to the value of OPTVAL.
+ If you call '\begin{ENV}' without square brackets, then within
+ BEGDEFN the parameter '#1' is set to the value of the default
+ OPTARGDEFAULT. In either case, any required arguments start with
+ '#2'.
Omitting '[MYVAL]' in the call is different than having the square
brackets with no contents, as in '[]'. The former results in '#1'
@@ -7037,8 +7043,8 @@
ENDDEF
Required; the text expanded at every occurrence of '\end{ENV}'.
- This may not contain any parameters, so you cannot use '#1', '#2',
- etc., here (but see the final example below).
+ This may not contain any parameters, that is, you cannot use '#1',
+ '#2', etc., here (but see the final example below).
All environments, that is to say the BEGDEF code, the environment
body, and the ENDDEF code, are processed within a group. Thus, in the
@@ -7060,9 +7066,17 @@
\end{quotation}
}
- This one shows the use of arguments; it gives a quotation environment
-that cites the author.
+ This has an argument, which is set in boldface at the start of a
+paragraph.
+ \newenvironment{point}[1]{%
+ \noindent\textbf{#1}
+ }{%
+ }
+
+ This one shows the use of a optional argument; it gives a quotation
+environment that cites the author.
+
\newenvironment{citequote}[1][Shakespeare]{%
\begin{quotation}
\noindent\textit{#1}:
@@ -7127,9 +7141,10 @@
Arguments:
NAME
- The name of the environment. It must not begin with a backslash,
- '\'. It must not be the name of an existing environment, and the
- command name '\NAME' must not already be defined.
+ The name of the environment. It is a string of letters. It must
+ not begin with a backslash, '\'. It must not be the name of an
+ existing environment, and the command name '\NAME' must not already
+ be defined.
TITLE
The text to be printed at the beginning of the environment, before
@@ -7206,8 +7221,8 @@
File: latex2e.info, Node: \newfont, Next: \protect, Prev: \newtheorem, Up: Definitions
-12.8 '\newfont': Define a new font (obsolete)
-=============================================
+12.8 '\newfont'
+===============
This command is obsolete. This description is here only to help with
old documents. New documents should define fonts in families through
@@ -7542,8 +7557,8 @@
\setcounter{COUNTER}{VALUE}
Globally set the counter COUNTER to have the value of the VALUE
-argument. Thus, you can set a counter's value as
-'\setcounter{section}{5}'. Note that the counter name does not start
+argument, which must be an integer. Thus, you can set a counter's value
+as '\setcounter{section}{5}'. Note that the counter name does not start
with a backslash.
In this example if the counter 'theorem' has value 12 then the second
@@ -7606,6 +7621,10 @@
it. (For the definition of "counters numbered within", *note
\newcounter::.)
+ This command differs from '\refstepcounter' in that this one does not
+influence references -- it does not define the current '\ref' value to
+be the result of '\thecounter' (*note \refstepcounter::).
+
File: latex2e.info, Node: \day & \month & \year, Prev: \stepcounter, Up: Counters
@@ -7850,8 +7869,9 @@
\settodepth{LEN}{TEXT}
- Set the length LEN to the depth of the TEXT argument. The length
-name LEN must begin with a backslash, '\'.
+ Set the length LEN to the depth of box that LaTeX gets on typesetting
+the TEXT argument. The length name LEN must begin with a backslash,
+'\'.
This will show how low the character descenders go.
@@ -7875,8 +7895,9 @@
\settoheight{LEN}{text}
- Sets the length LEN to the height of the 'text' argument. The length
-name LEN must begin with a backslash, '\'.
+ Sets the length LEN to the height of box that LaTeX gets on
+typesetting the 'text' argument. The length name LEN must begin with a
+backslash, '\'.
This will show how high the characters go.
@@ -7893,15 +7914,16 @@
File: latex2e.info, Node: \settowidth, Prev: \settoheight, Up: Lengths
-14.6 '\settowidth}'
-===================
+14.6 '\settowidth'
+==================
Synopsis:
\settowidth{LEN}{TEXT}
- Set the length LEN to the width of the TEXT. The length name LEN
-must begin with a backslash, '\'.
+ Set the length LEN to the width of the box that LaTeX gets on
+typesetting the TEXT argument. The length name LEN must begin with a
+backslash, '\'.
This measures the width of the lowercase ASCII alphabet.
@@ -7971,8 +7993,8 @@
15.1 '\par'
===========
-Synopsis (note that while reading the input TeX converts two consecutive
-newlines to a '\par'):
+Synopsis (note that while reading the input TeX, converts two
+consecutive newlines to a '\par'):
\par
@@ -10129,6 +10151,22 @@
declaration has global scope, so its effect is not delimited by braces
or environments.
+ Often the first page of a chapter or section has a different style.
+For example, this LaTeX book document has the first page of the first
+chapter in in 'plain' style, as is the default (*note Page styles::).
+
+ \documentclass{book}
+ \pagestyle{headings}
+ \begin{document}
+ \chapter{First chapter}
+ ...
+ \chapter{Second chapter}\thispagestyle{empty}
+ ...
+
+The 'plain' style has a page number on it, centered in the footer. To
+make the page entirely empty, the command '\thispagestyle{empty}'
+immediately follows the second '\chapter'.
+
File: latex2e.info, Node: Spaces, Next: Boxes, Prev: Page styles, Up: Top
@@ -11288,10 +11326,10 @@
Typeset TEXT just as with '\makebox' (*note \mbox & \makebox::)
except that LaTeX does not output it but instead saves it in a storage
-bin named BOX-CMD. The bin name BOX-CMD begins with a backslash. You
-must have previously allocated the bin BOX-CMD with '\newsavebox' (*note
-\newsavebox::).The '\sbox' command is robust while '\savebox' is fragile
-(*note \protect::).
+bin named BOX-CMD. The bin name BOX-CMD begins with a backslash, '\'.
+You must have previously allocated the bin BOX-CMD with '\newsavebox'
+(*note \newsavebox::).The '\sbox' command is robust while '\savebox' is
+fragile (*note \protect::).
This creates and uses a bin.
@@ -12950,20 +12988,21 @@
\rule{WIDTH}{THICKNESS}
\rule[RAISE]{WIDTH}{THICKNESS}
- Produce a "rule", a rectangle.
+ Produce a "rule", a filled-in rectangle.
- This produces a rectangular blob of ink, sometimes called a Halmos
-symbol, often used to mark the end of a proof.
+ This produces a rectangular blob, sometimes called a Halmos symbol,
+often used to mark the end of a proof.
\newcommand{\qedsymbol}{\rule{0.4em}{2ex}}
The 'amsthm' package includes this command, with a somewhat
different-looking symbol.
- The mandatory arguments WIDTH and THICKNESS are rigid lengths (*note
-Lengths::). The optional argument RAISE is also a rigid length, and
-tells LaTeX how much to raise the rule above the baseline, or lower it
-if the length is negative.
+ The mandatory arguments give the horizontal WIDTH and vertical
+THICKNESS of the rectangle. They are rigid lengths (*note Lengths::).
+The optional argument RAISE is also a rigid length, and tells LaTeX how
+much to raise the rule above the baseline, or lower it if the length is
+negative.
This produces a line, a rectangle that is wide but not tall.
@@ -16264,7 +16303,8 @@
(line 66)
* classes of documents: Document classes. (line 6)
* cleveref package: Cross references. (line 38)
-* cleveref package <1>: \footnotemark. (line 48)
+* cleveref package <1>: \ref. (line 29)
+* cleveref package <2>: \footnotemark. (line 48)
* clock option to slides class: Document class options.
(line 99)
* closing letters: \closing. (line 6)
@@ -16932,7 +16972,8 @@
* package, bm: \boldmath & \unboldmath.
(line 32)
* package, cleveref: Cross references. (line 38)
-* package, cleveref <1>: \footnotemark. (line 48)
+* package, cleveref <1>: \ref. (line 29)
+* package, cleveref <2>: \footnotemark. (line 48)
* package, cprotect: verbatim. (line 26)
* package, cprotect <1>: \verb. (line 34)
* package, datetime: \today. (line 27)
@@ -17451,457 +17492,457 @@
Ref: low level font commands usefont58311
Node: Layout58554
Node: \onecolumn59052
-Node: \twocolumn59414
-Ref: twocolumn columnsep60037
-Ref: twocolumn columnseprule60286
-Ref: twocolumn columnwidth60582
-Ref: twocolumn dbltopfraction61148
-Ref: twocolumn dblfloatpagefraction62091
-Ref: twocolumn dblfloatsep62338
-Ref: twocolumn dbltextfloatsep62643
-Ref: twocolumn dbltopnumber62826
-Node: \flushbottom63791
-Node: \raggedbottom64891
-Node: Page layout parameters65427
-Ref: page layout parameters columnsep65630
-Ref: page layout parameters columnseprule65630
-Ref: page layout parameters columnwidth65630
-Ref: page layout parameters headheight65884
-Ref: page layout parameters headsep66051
-Ref: page layout parameters footskip66364
-Ref: page layout parameters linewidth66698
-Ref: page layout parameters marginparpush67051
-Ref: page layout parameters marginsep67051
-Ref: page layout parameters marginparwidth67051
-Ref: page layout parameters oddsidemargin68091
-Ref: page layout parameters evensidemargin68091
-Ref: page layout parameters paperheight68628
-Ref: page layout parameters paperwidth68854
-Ref: page layout parameters textheight69078
-Ref: page layout parameters textwidth69467
-Ref: page layout parameters hsize70396
-Ref: page layout parameters topmargin70602
-Ref: page layout parameters topskip70906
-Node: Floats71122
-Ref: floats bottomfraction75490
-Ref: floats floatpagefraction75617
-Ref: floats textfraction75728
-Ref: floats topfraction75930
-Ref: floats floatsep76182
-Ref: floats intextsep76292
-Ref: floats textfloatsep76507
-Ref: floats bottomnumber76771
-Ref: floats dbltopnumber76879
-Ref: floats topnumber76998
-Ref: floats totalnumber77102
-Node: Sectioning77631
-Ref: sectioning secnumdepth80330
-Ref: Sectioning/secnumdepth80330
-Ref: sectioning tocdepth80931
-Ref: Sectioning/tocdepth80931
-Node: \part81976
-Node: \chapter84152
-Node: \section87926
-Node: \subsection91193
-Node: \subsubsection & \paragraph & \subparagraph93907
-Node: \appendix96564
-Node: \frontmatter & \mainmatter & \backmatter97801
-Node: \@startsection99142
-Ref: startsection name100519
-Ref: \@startsection/name100519
-Ref: startsection level100973
-Ref: \@startsection/level100973
-Ref: startsection indent101853
-Ref: \@startsection/indent101853
-Ref: startsection beforeskip102116
-Ref: \@startsection/beforeskip102116
-Ref: startsection afterskip103637
-Ref: \@startsection/afterskip103637
-Ref: startsection style104948
-Ref: \@startsection/style104948
-Node: Cross references108654
-Node: \label110747
-Node: \pageref112567
-Node: \ref113357
-Node: Environments114224
-Node: abstract116227
-Node: array117816
-Node: center120211
-Node: \centering121939
-Node: description123436
-Node: displaymath125623
-Node: document127400
-Node: \AtBeginDocument127830
-Node: \AtEndDocument128454
-Node: enumerate129098
-Ref: enumerate enumi130955
-Ref: enumerate enumii130955
-Ref: enumerate enumiii130955
-Ref: enumerate enumiv130955
-Ref: enumerate labelenumi131353
-Ref: enumerate labelenumii131353
-Ref: enumerate labelenumiii131353
-Ref: enumerate labelenumiv131353
-Node: eqnarray131892
-Node: equation133887
-Node: figure134515
-Node: filecontents136590
-Node: flushleft138337
-Node: \raggedright139299
-Node: flushright140497
-Node: \raggedleft141160
-Node: itemize141950
-Ref: itemize labelitemi143169
-Ref: itemize labelitemii143169
-Ref: itemize labelitemiii143169
-Ref: itemize labelitemiv143169
-Ref: itemize leftmargin144011
-Ref: itemize leftmargini144011
-Ref: itemize leftmarginii144011
-Ref: itemize leftmarginiii144011
-Ref: itemize leftmarginiv144011
-Ref: itemize leftmarginv144011
-Ref: itemize leftmarginvi144011
-Node: letter145415
-Node: list145653
-Ref: list makelabel147905
-Ref: list itemindent149272
-Ref: list itemsep149409
-Ref: list labelsep150061
-Ref: list labelwidth150224
-Ref: list leftmargin151235
-Ref: list listparindent152088
-Ref: list parsep152319
-Ref: list partopsep152822
-Ref: list rightmargin153620
-Ref: list topsep153805
-Ref: list beginparpenalty157380
-Ref: list itempenalty157479
-Ref: list endparpenalty157583
-Node: \item158455
-Node: trivlist159706
-Node: math161234
-Node: minipage161540
-Node: picture166394
-Node: \put172810
-Node: \multiput173288
-Node: \qbezier174027
-Node: \graphpaper174952
-Node: \line175746
-Node: \linethickness177658
-Node: \thinlines178107
-Node: \thicklines178518
-Node: \circle178902
-Node: \oval179442
-Node: \shortstack180418
-Node: \vector181820
-Node: \makebox (picture)182663
-Node: \framebox (picture)183845
-Node: \frame185318
-Node: \dashbox185757
-Node: quotation & quote186892
-Node: tabbing187788
-Node: table193781
-Node: tabular195806
-Ref: tabular arrayrulewidth201898
-Ref: tabular arraystrech202138
-Ref: tabular doublerulesep202359
-Ref: tabular tabcolsep202495
-Node: \multicolumn203016
-Node: \vline206875
-Node: \cline208220
-Node: \hline208930
-Node: thebibliography209612
-Node: \bibitem212022
-Node: \cite214297
-Node: \nocite215947
-Node: Using BibTeX216436
-Node: theorem218591
-Node: titlepage219513
-Node: verbatim220796
-Node: \verb222306
-Node: verse223772
-Node: Line breaking224999
-Node: \\226365
-Node: \obeycr & \restorecr228798
-Node: \newline229592
-Node: \- (hyphenation)230527
-Node: \discretionary232165
-Node: \fussy & \sloppy233053
-Node: sloppypar233836
-Node: \hyphenation234982
-Node: \linebreak & \nolinebreak235576
-Node: Page breaking236647
-Node: \clearpage & \cleardoublepage238676
-Node: \newpage240196
-Node: \enlargethispage241494
-Node: \pagebreak & \nopagebreak242450
-Node: Footnotes244038
-Node: \footnote245184
-Ref: footnote footnoterule246452
-Ref: footnote footnotesep247063
-Node: \footnotemark248129
-Node: \footnotetext250468
-Node: Footnotes in section headings251069
-Node: Footnotes in a table251902
-Node: Footnotes of footnotes254824
-Node: Definitions255528
-Node: \newcommand & \renewcommand256405
-Node: \providecommand261616
-Node: \newcounter262762
-Node: \newlength264489
-Node: \newsavebox265349
-Node: \newenvironment & \renewenvironment266290
-Node: \newtheorem271415
-Node: \newfont274954
-Node: \protect276250
-Node: \ignorespaces & \ignorespacesafterend278636
-Node: Counters281374
-Node: \alph \Alph \arabic \roman \Roman \fnsymbol283075
-Node: \usecounter285729
-Node: \value286574
-Node: \setcounter287485
-Node: \addtocounter288055
-Node: \refstepcounter288509
-Node: \stepcounter289178
-Node: \day & \month & \year289521
-Node: Lengths290332
-Node: Units of length294685
-Ref: units of length pt294888
-Ref: units of length pc295010
-Ref: units of length in295033
-Ref: units of length bp295059
-Ref: units of length cm295190
-Ref: units of length mm295212
-Ref: units of length dd295234
-Ref: units of length cc295266
-Ref: units of length sp295291
-Ref: Lengths/em295322
-Ref: Lengths/en295322
-Ref: Lengths/ex295322
-Ref: units of length em295322
-Ref: units of length en295322
-Ref: units of length ex295322
-Node: \setlength296178
-Node: \addtolength296955
-Node: \settodepth297917
-Node: \settoheight298672
-Node: \settowidth299431
-Node: Making paragraphs300164
-Node: \par301813
-Node: \indent & \noindent303657
-Node: \parindent & \parskip305191
-Node: Marginal notes306226
-Ref: marginal notes marginparpush307433
-Ref: marginal notes marginparsep307546
-Ref: marginal notes marginparwidth307678
-Node: Math formulas308027
-Node: Subscripts & superscripts312120
-Node: Math symbols314229
-Node: Blackboard bold340387
-Node: Calligraphic341159
-Node: \boldmath & \unboldmath341731
-Node: Ellipses343249
-Ref: ellipses cdots343635
-Ref: ellipses ddots343782
-Ref: ellipses ldots343860
-Ref: ellipses vdots344220
-Node: Math functions345400
-Node: Math accents347044
-Node: Over- and Underlining347943
-Node: Spacing in math mode349770
-Ref: spacing in math mode thickspace350588
-Ref: spacing in math mode medspace350680
-Ref: Spacing in math mode/\thinspace350776
-Ref: spacing in math mode thinspace350776
-Ref: spacing in math mode negthinspace351257
-Ref: spacing in math mode quad351455
-Ref: spacing in math mode qquad351711
-Node: Math miscellany351809
-Node: Colon character & \colon352368
-Node: \*353061
-Node: \frac353645
-Node: \left & \right354025
-Node: \sqrt355199
-Node: \stackrel355794
-Node: Modes356067
-Ref: modes paragraph mode356512
-Ref: modes lr mode356713
-Ref: modes math mode357229
-Ref: modes vertical mode357574
-Ref: modes internal vertical mode357745
-Ref: modes inner paragraph mode358215
-Ref: modes outer paragraph mode358215
-Node: \ensuremath358681
-Node: Page styles359386
-Node: \maketitle360149
-Node: \pagenumbering363159
-Node: \pagestyle365147
-Node: \thispagestyle368649
-Node: Spaces369036
-Node: \enspace & \quad & \qquad370477
-Node: \hspace371391
-Node: \hfill373229
-Node: \hss374293
-Node: \spacefactor374987
-Node: \@378374
-Ref: \AT378474
-Node: \frenchspacing380414
-Node: \normalsfcodes381249
-Node: \(SPACE)381496
-Node: ~383131
-Node: \thinspace & \negthinspace385601
-Node: \/386544
-Node: \hrulefill & \dotfill387850
-Node: \bigskip & \medskip & \smallskip389206
-Ref: bigskip390024
-Ref: medskip390228
-Ref: smallskip390437
-Node: \bigbreak & \medbreak & \smallbreak391098
-Node: \strut392084
-Node: \vspace395278
-Node: \vfill396835
-Node: \addvspace397713
-Node: Boxes399711
-Node: \mbox & \makebox400417
-Ref: mbox makebox depth401632
-Ref: mbox makebox height401632
-Ref: mbox makebox width401632
-Ref: mbox makebox totalheight401632
-Node: \fbox & \framebox403726
-Ref: fbox framebox fboxrule405039
-Ref: fbox framebox fboxsep405229
-Node: \parbox406318
-Node: \raisebox408622
-Ref: raisebox depth409585
-Ref: raisebox height409585
-Ref: raisebox width409585
-Ref: raisebox totalheight409585
-Node: \sbox & \savebox410299
-Node: lrbox413261
-Node: \usebox414083
-Node: Color414415
-Node: Color package options415259
-Node: Color models416905
-Ref: color models cmyk417702
-Ref: color models gray418065
-Ref: color models rgb418214
-Ref: color models RGB418551
-Ref: color models named418926
-Node: Commands for color419214
-Node: Define colors419629
-Node: Colored text420354
-Node: Colored boxes422752
-Node: Colored pages424141
-Node: Graphics424834
-Node: Graphics package options426961
-Node: Graphics package configuration429714
-Node: \graphicspath430516
-Node: \DeclareGraphicsExtensions433407
-Node: \DeclareGraphicsRule435175
-Node: Commands for graphics438361
-Node: \includegraphics438866
-Ref: includegraphics width443916
-Ref: includegraphics height444447
-Ref: includegraphics totalheght444853
-Ref: includegraphics keepaspectratio445117
-Ref: includegraphics viewport446803
-Ref: includegraphics trim447173
-Ref: includegraphics clip447629
-Ref: includegraphics page447889
-Ref: includegraphics pagebox447980
-Ref: includegraphics interpolate448845
-Ref: includegraphics quiet449050
-Ref: includegraphics draft449211
-Ref: includegraphics bb450016
-Ref: includegraphics bbllx450414
-Ref: includegraphics bblly450414
-Ref: includegraphics bburx450414
-Ref: includegraphics bbury450414
-Ref: includegraphics natwidth450556
-Ref: includegraphics natheight450556
-Ref: includegraphics hiresbb450742
-Ref: includegraphics type451504
-Ref: includegraphics ext451544
-Ref: includegraphics read451647
-Ref: includegraphics command451764
-Node: \rotatebox452009
-Node: \scalebox454840
-Node: \resizebox455896
-Node: Special insertions457088
-Node: Reserved characters457890
-Node: Upper and lower case459088
-Node: Symbols by font position461003
-Node: Text symbols461623
-Node: Accents465624
-Node: Additional Latin letters467639
-Ref: Non-English characters467810
-Node: \rule468827
-Node: \today469944
-Node: Splitting the input470880
-Node: \endinput472414
-Node: \include & \includeonly473681
-Node: \input477903
-Node: Front/back matter479118
-Node: Table of contents etc.479451
-Node: \addcontentsline483187
-Node: \addtocontents486029
-Node: \nofiles487620
-Node: Indexes488352
-Node: \index489980
-Node: makeindex495095
-Ref: makeindex preamble496763
-Ref: makeindex postamble496903
-Ref: makeindex group skip496988
-Ref: makeindex letheadflag497308
-Ref: makeindex lethead prefix497772
-Ref: makeindex lethead suffix497924
-Ref: makeindex item 0498072
-Ref: makeindex item 1498152
-Ref: makeindex item 2498227
-Ref: makeindex item 01498305
-Ref: makeindex item x1498410
-Ref: makeindex item 12498615
-Ref: makeindex item x2498723
-Ref: makeindex delim 0498883
-Ref: makeindex delim 1499013
-Ref: makeindex delim 2499143
-Ref: makeindex delim n499269
-Ref: makeindex delim r499404
-Ref: makeindex line max499512
-Ref: makeindex indent space499647
-Ref: makeindex indent length499742
-Ref: makeindex page precedence499927
-Node: \printindex500801
-Node: Glossaries501273
-Node: \newglossaryentry503240
-Node: \gls504709
-Node: Letters505503
-Node: \address509170
-Node: \cc509981
-Node: \closing510423
-Node: \encl510737
-Node: \location511151
-Node: \makelabels511415
-Node: \name513732
-Node: \opening513973
-Node: \ps514254
-Node: \signature514543
-Node: \telephone515771
-Node: Terminal input/output516136
-Node: \typein516401
-Node: \typeout517650
-Node: Command line518694
-Node: Command line options520752
-Node: Command line input524294
-Node: Recovering from errors526158
-Node: Document templates527492
-Node: beamer template527937
-Node: article template528591
-Node: book template529018
-Node: Larger book template529499
-Node: tugboat template530985
-Node: Index533356
-Ref: Command Index533442
+Node: \twocolumn59411
+Ref: twocolumn columnsep60034
+Ref: twocolumn columnseprule60283
+Ref: twocolumn columnwidth60579
+Ref: twocolumn dbltopfraction61145
+Ref: twocolumn dblfloatpagefraction62088
+Ref: twocolumn dblfloatsep62335
+Ref: twocolumn dbltextfloatsep62640
+Ref: twocolumn dbltopnumber62823
+Node: \flushbottom63788
+Node: \raggedbottom64888
+Node: Page layout parameters65424
+Ref: page layout parameters columnsep65627
+Ref: page layout parameters columnseprule65627
+Ref: page layout parameters columnwidth65627
+Ref: page layout parameters headheight65881
+Ref: page layout parameters headsep66048
+Ref: page layout parameters footskip66361
+Ref: page layout parameters linewidth66695
+Ref: page layout parameters marginparpush67048
+Ref: page layout parameters marginsep67048
+Ref: page layout parameters marginparwidth67048
+Ref: page layout parameters oddsidemargin68088
+Ref: page layout parameters evensidemargin68088
+Ref: page layout parameters paperheight68625
+Ref: page layout parameters paperwidth68851
+Ref: page layout parameters textheight69075
+Ref: page layout parameters textwidth69464
+Ref: page layout parameters hsize70393
+Ref: page layout parameters topmargin70599
+Ref: page layout parameters topskip70903
+Node: Floats71119
+Ref: floats bottomfraction75487
+Ref: floats floatpagefraction75614
+Ref: floats textfraction75725
+Ref: floats topfraction75927
+Ref: floats floatsep76179
+Ref: floats intextsep76289
+Ref: floats textfloatsep76504
+Ref: floats bottomnumber76768
+Ref: floats dbltopnumber76876
+Ref: floats topnumber76995
+Ref: floats totalnumber77099
+Node: Sectioning77628
+Ref: sectioning secnumdepth80327
+Ref: Sectioning/secnumdepth80327
+Ref: sectioning tocdepth80928
+Ref: Sectioning/tocdepth80928
+Node: \part81973
+Node: \chapter84149
+Node: \section87923
+Node: \subsection91190
+Node: \subsubsection & \paragraph & \subparagraph93904
+Node: \appendix96561
+Node: \frontmatter & \mainmatter & \backmatter97798
+Node: \@startsection99139
+Ref: startsection name100516
+Ref: \@startsection/name100516
+Ref: startsection level100970
+Ref: \@startsection/level100970
+Ref: startsection indent101850
+Ref: \@startsection/indent101850
+Ref: startsection beforeskip102113
+Ref: \@startsection/beforeskip102113
+Ref: startsection afterskip103634
+Ref: \@startsection/afterskip103634
+Ref: startsection style104945
+Ref: \@startsection/style104945
+Node: Cross references108651
+Node: \label110744
+Node: \pageref112564
+Node: \ref113354
+Node: Environments114330
+Node: abstract116333
+Node: array117922
+Node: center120317
+Node: \centering122045
+Node: description123542
+Node: displaymath125729
+Node: document127506
+Node: \AtBeginDocument127936
+Node: \AtEndDocument128560
+Node: enumerate129204
+Ref: enumerate enumi131061
+Ref: enumerate enumii131061
+Ref: enumerate enumiii131061
+Ref: enumerate enumiv131061
+Ref: enumerate labelenumi131459
+Ref: enumerate labelenumii131459
+Ref: enumerate labelenumiii131459
+Ref: enumerate labelenumiv131459
+Node: eqnarray131998
+Node: equation133993
+Node: figure134621
+Node: filecontents136696
+Node: flushleft138443
+Node: \raggedright139405
+Node: flushright140603
+Node: \raggedleft141266
+Node: itemize142056
+Ref: itemize labelitemi143275
+Ref: itemize labelitemii143275
+Ref: itemize labelitemiii143275
+Ref: itemize labelitemiv143275
+Ref: itemize leftmargin144117
+Ref: itemize leftmargini144117
+Ref: itemize leftmarginii144117
+Ref: itemize leftmarginiii144117
+Ref: itemize leftmarginiv144117
+Ref: itemize leftmarginv144117
+Ref: itemize leftmarginvi144117
+Node: letter145521
+Node: list145759
+Ref: list makelabel148011
+Ref: list itemindent149378
+Ref: list itemsep149515
+Ref: list labelsep150167
+Ref: list labelwidth150330
+Ref: list leftmargin151341
+Ref: list listparindent152194
+Ref: list parsep152425
+Ref: list partopsep152928
+Ref: list rightmargin153726
+Ref: list topsep153911
+Ref: list beginparpenalty157486
+Ref: list itempenalty157585
+Ref: list endparpenalty157689
+Node: \item158561
+Node: trivlist159812
+Node: math161340
+Node: minipage161646
+Node: picture166500
+Node: \put172916
+Node: \multiput173394
+Node: \qbezier174133
+Node: \graphpaper175058
+Node: \line175852
+Node: \linethickness177764
+Node: \thinlines178213
+Node: \thicklines178624
+Node: \circle179008
+Node: \oval179548
+Node: \shortstack180524
+Node: \vector181921
+Node: \makebox (picture)182764
+Node: \framebox (picture)183946
+Node: \frame185419
+Node: \dashbox185858
+Node: quotation & quote186993
+Node: tabbing187889
+Node: table193882
+Node: tabular195907
+Ref: tabular arrayrulewidth201999
+Ref: tabular arraystrech202239
+Ref: tabular doublerulesep202460
+Ref: tabular tabcolsep202596
+Node: \multicolumn203117
+Node: \vline206976
+Node: \cline208321
+Node: \hline209031
+Node: thebibliography209713
+Node: \bibitem212123
+Node: \cite214398
+Node: \nocite216048
+Node: Using BibTeX216532
+Node: theorem218687
+Node: titlepage219609
+Node: verbatim220892
+Node: \verb222402
+Node: verse223868
+Node: Line breaking225095
+Node: \\226461
+Node: \obeycr & \restorecr228894
+Node: \newline229688
+Node: \- (hyphenation)230717
+Node: \discretionary232355
+Node: \fussy & \sloppy233243
+Node: sloppypar234026
+Node: \hyphenation235172
+Node: \linebreak & \nolinebreak235766
+Node: Page breaking236913
+Node: \clearpage & \cleardoublepage238942
+Node: \newpage240462
+Node: \enlargethispage241760
+Node: \pagebreak & \nopagebreak242716
+Node: Footnotes244383
+Node: \footnote245529
+Ref: footnote footnoterule246797
+Ref: footnote footnotesep247408
+Node: \footnotemark248474
+Node: \footnotetext250813
+Node: Footnotes in section headings251414
+Node: Footnotes in a table252247
+Node: Footnotes of footnotes255169
+Node: Definitions255873
+Node: \newcommand & \renewcommand256750
+Node: \providecommand261980
+Node: \newcounter263126
+Node: \newlength264853
+Node: \newsavebox265675
+Node: \newenvironment & \renewenvironment266591
+Node: \newtheorem271907
+Node: \newfont275479
+Node: \protect276715
+Node: \ignorespaces & \ignorespacesafterend279101
+Node: Counters281839
+Node: \alph \Alph \arabic \roman \Roman \fnsymbol283540
+Node: \usecounter286194
+Node: \value287039
+Node: \setcounter287950
+Node: \addtocounter288546
+Node: \refstepcounter289000
+Node: \stepcounter289669
+Node: \day & \month & \year290215
+Node: Lengths291026
+Node: Units of length295379
+Ref: units of length pt295582
+Ref: units of length pc295704
+Ref: units of length in295727
+Ref: units of length bp295753
+Ref: units of length cm295884
+Ref: units of length mm295906
+Ref: units of length dd295928
+Ref: units of length cc295960
+Ref: units of length sp295985
+Ref: Lengths/em296016
+Ref: Lengths/en296016
+Ref: Lengths/ex296016
+Ref: units of length em296016
+Ref: units of length en296016
+Ref: units of length ex296016
+Node: \setlength296872
+Node: \addtolength297649
+Node: \settodepth298611
+Node: \settoheight299401
+Node: \settowidth300195
+Node: Making paragraphs300974
+Node: \par302623
+Node: \indent & \noindent304468
+Node: \parindent & \parskip306002
+Node: Marginal notes307037
+Ref: marginal notes marginparpush308244
+Ref: marginal notes marginparsep308357
+Ref: marginal notes marginparwidth308489
+Node: Math formulas308838
+Node: Subscripts & superscripts312931
+Node: Math symbols315040
+Node: Blackboard bold341198
+Node: Calligraphic341970
+Node: \boldmath & \unboldmath342542
+Node: Ellipses344060
+Ref: ellipses cdots344446
+Ref: ellipses ddots344593
+Ref: ellipses ldots344671
+Ref: ellipses vdots345031
+Node: Math functions346211
+Node: Math accents347855
+Node: Over- and Underlining348754
+Node: Spacing in math mode350581
+Ref: spacing in math mode thickspace351399
+Ref: spacing in math mode medspace351491
+Ref: Spacing in math mode/\thinspace351587
+Ref: spacing in math mode thinspace351587
+Ref: spacing in math mode negthinspace352068
+Ref: spacing in math mode quad352266
+Ref: spacing in math mode qquad352522
+Node: Math miscellany352620
+Node: Colon character & \colon353179
+Node: \*353872
+Node: \frac354456
+Node: \left & \right354836
+Node: \sqrt356010
+Node: \stackrel356605
+Node: Modes356878
+Ref: modes paragraph mode357323
+Ref: modes lr mode357524
+Ref: modes math mode358040
+Ref: modes vertical mode358385
+Ref: modes internal vertical mode358556
+Ref: modes inner paragraph mode359026
+Ref: modes outer paragraph mode359026
+Node: \ensuremath359492
+Node: Page styles360197
+Node: \maketitle360960
+Node: \pagenumbering363970
+Node: \pagestyle365958
+Node: \thispagestyle369460
+Node: Spaces370417
+Node: \enspace & \quad & \qquad371858
+Node: \hspace372772
+Node: \hfill374610
+Node: \hss375674
+Node: \spacefactor376368
+Node: \@379755
+Ref: \AT379855
+Node: \frenchspacing381795
+Node: \normalsfcodes382630
+Node: \(SPACE)382877
+Node: ~384512
+Node: \thinspace & \negthinspace386982
+Node: \/387925
+Node: \hrulefill & \dotfill389231
+Node: \bigskip & \medskip & \smallskip390587
+Ref: bigskip391405
+Ref: medskip391609
+Ref: smallskip391818
+Node: \bigbreak & \medbreak & \smallbreak392479
+Node: \strut393465
+Node: \vspace396659
+Node: \vfill398216
+Node: \addvspace399094
+Node: Boxes401092
+Node: \mbox & \makebox401798
+Ref: mbox makebox depth403013
+Ref: mbox makebox height403013
+Ref: mbox makebox width403013
+Ref: mbox makebox totalheight403013
+Node: \fbox & \framebox405107
+Ref: fbox framebox fboxrule406420
+Ref: fbox framebox fboxsep406610
+Node: \parbox407699
+Node: \raisebox410003
+Ref: raisebox depth410966
+Ref: raisebox height410966
+Ref: raisebox width410966
+Ref: raisebox totalheight410966
+Node: \sbox & \savebox411680
+Node: lrbox414646
+Node: \usebox415468
+Node: Color415800
+Node: Color package options416644
+Node: Color models418290
+Ref: color models cmyk419087
+Ref: color models gray419450
+Ref: color models rgb419599
+Ref: color models RGB419936
+Ref: color models named420311
+Node: Commands for color420599
+Node: Define colors421014
+Node: Colored text421739
+Node: Colored boxes424137
+Node: Colored pages425526
+Node: Graphics426219
+Node: Graphics package options428346
+Node: Graphics package configuration431099
+Node: \graphicspath431901
+Node: \DeclareGraphicsExtensions434792
+Node: \DeclareGraphicsRule436560
+Node: Commands for graphics439746
+Node: \includegraphics440251
+Ref: includegraphics width445301
+Ref: includegraphics height445832
+Ref: includegraphics totalheght446238
+Ref: includegraphics keepaspectratio446502
+Ref: includegraphics viewport448188
+Ref: includegraphics trim448558
+Ref: includegraphics clip449014
+Ref: includegraphics page449274
+Ref: includegraphics pagebox449365
+Ref: includegraphics interpolate450230
+Ref: includegraphics quiet450435
+Ref: includegraphics draft450596
+Ref: includegraphics bb451401
+Ref: includegraphics bbllx451799
+Ref: includegraphics bblly451799
+Ref: includegraphics bburx451799
+Ref: includegraphics bbury451799
+Ref: includegraphics natwidth451941
+Ref: includegraphics natheight451941
+Ref: includegraphics hiresbb452127
+Ref: includegraphics type452889
+Ref: includegraphics ext452929
+Ref: includegraphics read453032
+Ref: includegraphics command453149
+Node: \rotatebox453394
+Node: \scalebox456225
+Node: \resizebox457281
+Node: Special insertions458473
+Node: Reserved characters459275
+Node: Upper and lower case460473
+Node: Symbols by font position462388
+Node: Text symbols463008
+Node: Accents467009
+Node: Additional Latin letters469024
+Ref: Non-English characters469195
+Node: \rule470212
+Node: \today471384
+Node: Splitting the input472320
+Node: \endinput473854
+Node: \include & \includeonly475121
+Node: \input479343
+Node: Front/back matter480558
+Node: Table of contents etc.480891
+Node: \addcontentsline484627
+Node: \addtocontents487469
+Node: \nofiles489060
+Node: Indexes489792
+Node: \index491420
+Node: makeindex496535
+Ref: makeindex preamble498203
+Ref: makeindex postamble498343
+Ref: makeindex group skip498428
+Ref: makeindex letheadflag498748
+Ref: makeindex lethead prefix499212
+Ref: makeindex lethead suffix499364
+Ref: makeindex item 0499512
+Ref: makeindex item 1499592
+Ref: makeindex item 2499667
+Ref: makeindex item 01499745
+Ref: makeindex item x1499850
+Ref: makeindex item 12500055
+Ref: makeindex item x2500163
+Ref: makeindex delim 0500323
+Ref: makeindex delim 1500453
+Ref: makeindex delim 2500583
+Ref: makeindex delim n500709
+Ref: makeindex delim r500844
+Ref: makeindex line max500952
+Ref: makeindex indent space501087
+Ref: makeindex indent length501182
+Ref: makeindex page precedence501367
+Node: \printindex502241
+Node: Glossaries502713
+Node: \newglossaryentry504680
+Node: \gls506149
+Node: Letters506943
+Node: \address510610
+Node: \cc511421
+Node: \closing511863
+Node: \encl512177
+Node: \location512591
+Node: \makelabels512855
+Node: \name515172
+Node: \opening515413
+Node: \ps515694
+Node: \signature515983
+Node: \telephone517211
+Node: Terminal input/output517576
+Node: \typein517841
+Node: \typeout519090
+Node: Command line520134
+Node: Command line options522192
+Node: Command line input525734
+Node: Recovering from errors527598
+Node: Document templates528932
+Node: beamer template529377
+Node: article template530031
+Node: book template530458
+Node: Larger book template530939
+Node: tugboat template532425
+Node: Index534796
+Ref: Command Index534882
End Tag Table
Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2018-07-01 16:00:16 UTC (rev 674)
+++ trunk/latex2e.texi 2018-07-01 20:07:33 UTC (rev 675)
@@ -2,7 +2,7 @@
@c $Id$
@comment %**start of header (This is for running Texinfo on a region.)
@setfilename latex2e.info
- at set UPDATED June 2018
+ at set UPDATED July 2018
@include common.texi
@settitle @LaTeX{}2e unofficial reference manual (@value{UPDATED})
@comment %**end of header (This is for running Texinfo on a region.)
@@ -2027,11 +2027,10 @@
Start a new page and produce single-column output. If the document is
given the class option @code{onecolumn} then this is the default
-behavior (@pxref{Document class options}).
+behavior (@pxref{Document class options}). This command is fragile
+(@pxref{\protect}).
-This command is fragile (@pxref{\protect}).
-
@node \twocolumn
@section @code{\twocolumn}
@@ -3693,7 +3692,11 @@
\end@{enumerate@}
@end example
+ at PkgIndex{cleveref}
+The @file{cleveref} package includes text such as @samp{Theorem} in the
+reference. See the documentation on CTAN.
+
@node Environments
@chapter Environments
@@ -5930,7 +5933,7 @@
Synopsis:
@example
-\shortstack[@var{position}]@{@var{line 1} \\ @var{line 2} \\ ... @}
+\shortstack[@var{position}]@{@var{line 1} \\ ... @}
@end example
Produce a vertical stack of objects.
@@ -5945,9 +5948,9 @@
@noindent
For a short stack, the reference point is the lower left of the stack.
-In this example the @ref{\mbox & \makebox} puts the stack flush right in
-a zero width box so in total the short stack sits slightly to the left
-of the @math{y}@tie{}axis.
+In the above example the @ref{\mbox & \makebox} puts the stack flush
+right in a zero width box so in total the short stack sits slightly to
+the left of the @math{y}@tie{}axis.
The valid positions are:
@@ -7073,12 +7076,12 @@
@end example
Produces no output but writes @var{keys} to the auxiliary file
- at file{@var{filename}.aux}.
+ at file{@var{doc-filename}.aux}.
The mandatory argument @var{keys} is a comma-separated list of one or
more citation keys (@pxref{\bibitem}). This information is used by
Bib at TeX{} to include these works in your reference list even though you
-have not actually cited them (@pxref{\cite}).
+have not cited them (@pxref{\cite}).
@node Using BibTeX
@@ -7576,16 +7579,18 @@
@findex \newline
@cindex new line, starting (paragraph mode)
-In ordinary text this is equivalent to double-backslash (@pxref{\\}); it
-ends a line, and does so in a way that does not right-justify the line,
-so the prior text is not stretched. This command is fragile
+In ordinary text, this ends a line in a way that does not right-justify
+the line, so the prior text is not stretched. That is, in paragraph mode
+(@pxref{Modes}), the @code{\newline} command is equivalent to
+double-backslash (@pxref{\\}). This command is fragile
(@pxref{\protect}).
-Inside a @code{tabular} or @code{array} environment, in a column with a
-specifier producing a paragraph box such as typically @code{p@{...@}},
- at code{\newline} will insert a line end inside of the column; that is, it
-does not break the entire tabular row. To break the entire row use
- at code{\\} or its equivalent @code{\tabularnewline}.
+However, the two commands are different inside a @code{tabular} or
+ at code{array} environment. In a column with a specifier producing a
+paragraph box such as typically @code{p@{...@}}, @code{\newline} will
+insert a line end inside of the column; that is, it does not break the
+entire tabular row. To break the entire row use @code{\\} or its
+equivalent @code{\tabularnewline}.
This will print @samp{Name:} and @samp{Address:} as two lines in a
single cell of the table.
@@ -7782,10 +7787,12 @@
@end example
Encourage or discourage a line break. The optional @var{zero-to-four}
-is an integer that converts the command from a demand to a request. The
-higher the number, the more insistent the request. The default is 4, so
-that without the optional argument these commands entirely force or
-prevent the break. Both commands are fragile (@pxref{\protect}).
+is an integer that allows you to soften the instruction. The default is
+4, so that without the optional argument these commands entirely force
+or prevent the break. But for instance, @code{\nolinebreak[1]} is a
+suggestion that another place may be better. The higher the number, the
+more insistent the request. Both commands are fragile
+(@pxref{\protect}).
Here we tell @LaTeX{} that a good place to put a linebreak is after the
standard legal text.
@@ -8005,10 +8012,12 @@
@end example
Encourage or discourage a page break. The optional @var{zero-to-four}
-is an integer that converts the command from a demand to a request. The
-higher the number, the more insistent the request. The default is 4, so
-that without the optional argument these commands entirely force or
-prevent the break. Both commands are fragile (@pxref{\protect}).
+is an integer that allows you to soften the request. The default is 4,
+so that without the optional argument these commands entirely force or
+prevent the break. But for instance @code{\nopagebreak[1]} suggests to
+ at LaTeX{} that another spot might be preferrable. The higher the number,
+the more insistent the request. Both commands are fragile
+(@pxref{\protect}).
@LaTeX{}'s page endings are optimized so ordinarily you only use this
command in a document body to polish the final version, or inside
@@ -8452,29 +8461,29 @@
@item cmd
Required; the command name. It must begin with a backslash, @code{\},
-and must not begin with @code{\end}. For @code{\newcommand}, it must
-not be already defined. For @code{\renewcommand}, this name must
-already be defined.
+and must not begin with the four letter string @code{\end}. For
+ at code{\newcommand}, it must not be already defined. For
+ at code{\renewcommand}, this name must already be defined.
@item nargs
Optional; an integer from 0 to 9, specifying the number of arguments
-that the command can take, including any optional argument. Omitting
-this argument is the same as specifying 0, meaning that the command has
-no arguments. If you redefine a command, the new version can have a
+that the command takes, including any optional argument. Omitting this
+argument is the same as specifying 0, meaning that the command has no
+arguments. If you redefine a command, the new version can have a
different number of arguments than the old version.
@item optargdefault
-Optional; if this argument is present then the first argument of defined
-command @code{\@var{cmd}} is optional, with default value @var{optargdefault}
+Optional; if this argument is present then the first argument of
+ at code{\@var{cmd}} is optional, with default value @var{optargdefault}
(which may be the empty string). If this argument is not present then
@code{\@var{cmd}} does not take an optional argument.
@cindex positional parameter
That is, if @code{\@var{cmd}} is used with square brackets, as in
- at code{\@var{cmd}[@var{optval}]}, then within @var{defn} then @code{#1}
-is set to the value of @var{optval}. On the other hand, if
- at code{\@var{cmd}} is called without the square brackets, then within
- at var{defn} the parameter @code{#1} is set to the value of
+ at code{\@var{cmd}[@var{optval}]@{...@}...}, then within @var{defn} the
+parameter at tie{}@code{#1} is set to the value of @var{optval}. On the
+other hand, if @code{\@var{cmd}} is called without the square brackets
+then within @var{defn} the parameter @code{#1} is set to the value of
@var{optargdefault}. In either case, the required arguments start with
@code{#2}.
@@ -8658,7 +8667,7 @@
@node \newlength
- at section @code{\newlength}: Allocating a length
+ at section @code{\newlength}
@findex \newlength
@cindex lengths, allocating new
@@ -8669,13 +8678,13 @@
Synopsis:
@example
-\newlength@{\@var{arg}@}
+\newlength@{@var{arg}@}
@end example
Allocate a new length register (@pxref{Lengths}). The required argument
-must begin with a backslash, @code{\}. The new register hold rubber
-lengths such as @code{72.27pt} or @code{1in plus.2in minus.1in} (a
- at LaTeX{} length register is what plain @TeX{} calls a @code{skip}
+ at var{arg} must begin with a backslash, @code{\}. The new register holds
+rubber lengths such as @code{72.27pt} or @code{1in plus.2in minus.1in}
+(a @LaTeX{} length register is what plain @TeX{} calls a @code{skip}
register). The initial value is zero. The control sequence
@code{\@var{arg}} must not be already defined.
@@ -8692,7 +8701,7 @@
@node \newsavebox
- at section @code{\newsavebox}: Allocating a box
+ at section @code{\newsavebox}
@findex \newsavebox
@cindex box, allocating new
@@ -8700,13 +8709,14 @@
Synopsis:
@example
-\newsavebox@{\@var{cmd}@}
+\newsavebox@{@var{cmd}@}
@end example
Define @code{\@var{cmd}} to refer to a new ``bin'' for storing boxes.
Such a box is for holding typeset material, to use multiple times or to
-measure or manipulate (@pxref{Boxes}). The name @code{\@var{cmd}} must
-start with a backslash, @code{\}, and must not already be defined.
+measure or manipulate (@pxref{Boxes}). The required bin name
+ at code{@var{cmd}} must start with a backslash, @code{\}, and must not
+already be defined. This command is fragile (@pxref{\protect}).
The first line here sets you up to save the material for later use.
@@ -8719,12 +8729,11 @@
@noindent
The output is @samp{Our logo is LoGo}.
-If there is an already defined box then you get something like
+If there is an already defined bin then you get something like
@samp{LaTeX Error: Command \logobox already defined. Or name
\end... illegal, see p.192 of the manual}.
-The allocation of a box is global. This command is fragile
-(@pxref{\protect}).
+The allocation of a box is global.
@node \newenvironment & \renewenvironment
@@ -8764,8 +8773,8 @@
@cindex @code{*}-form of environment commands
The starred form of these commands requires that the arguments not
-contain multiple paragraphs of text. The body of these environments can
-still contain multiple paragraphs.
+contain multiple paragraphs of text. However, the body of these
+environments can contain multiple paragraphs.
@table @var
@item env
@@ -8779,9 +8788,9 @@
@item nargs
Optional; an integer from 0 to 9 denoting the number of arguments of
-that the environment will take. When you use the environment these
+that the environment takes. When you use the environment these
arguments appear after the @code{\begin}, as in
- at code{\begin@{@var{env}@}@{@var{arg1}@} .... @{@var{argn}@}}. Omitting
+ at code{\begin@{@var{env}@}@{@var{arg1}@} ... @{@var{argn}@}}. Omitting
this is equivalent to setting it to 0; the environment will have no
arguments. When redefining an environment, the new version can have a
different number of arguments than the old version.
@@ -8792,14 +8801,14 @@
may be the empty string). If this is not in the definition then the
environment does not take an optional argument.
-That is, when this is present in the environment definition then you can
-start the environment with square brackets, as in
- at code{\begin@{@var{env}@}[@var{optval}] ... \end@{@var{env}@}}. In this
-case, within @var{begdefn} the parameter @code{#1} is set to the value
-of @var{optval}. If you call @code{\begin@{@var{env}@}} without square
-brackets, then within @var{begdefn} the parameter @code{#1} is set to
-the value of the default @var{optargdefault}. In either case, any
-required arguments start with @code{#2}.
+That is, when @var{optargdefault} is present in the environment
+definition then you can start the environment with square brackets, as
+in @code{\begin@{@var{env}@}[@var{optval}]@{...@} ... \end@{@var{env}@}}.
+In this case, within @var{begdefn} the parameter @code{#1} is set to the
+value of @var{optval}. If you call @code{\begin@{@var{env}@}} without
+square brackets, then within @var{begdefn} the parameter @code{#1} is
+set to the value of the default @var{optargdefault}. In either case,
+any required arguments start with @code{#2}.
Omitting @code{[@var{myval}]} in the call is different than having the
square brackets with no contents, as in @code{[]}. The former results
@@ -8815,9 +8824,9 @@
@item enddef
Required; the text expanded at every occurrence of
- at code{\end@{@var{env}@}}. This may not contain any parameters, so you
-cannot use @code{#1}, @code{#2}, etc., here (but see the final example
-below).
+ at code{\end@{@var{env}@}}. This may not contain any parameters, that is,
+you cannot use @code{#1}, @code{#2}, etc., here (but see the final
+example below).
@end table
@@ -8843,10 +8852,20 @@
@}
@end example
-This one shows the use of arguments; it gives a quotation environment
-that cites the author.
+This has an argument, which is set in boldface at the start of a
+paragraph.
@example
+\newenvironment@{point@}[1]@{%
+ \noindent\textbf@{#1@}
+@}@{%
+@}
+ at end example
+
+This one shows the use of a optional argument; it gives a quotation
+environment that cites the author.
+
+ at example
\newenvironment@{citequote@}[1][Shakespeare]@{%
\begin@{quotation@}
\noindent\textit@{#1@}:
@@ -8927,9 +8946,10 @@
@table @var
@item name
-The name of the environment. It must not begin with a backslash,
- at code{\}. It must not be the name of an existing environment, and
-the command name @code{\@var{name}} must not already be defined.
+The name of the environment. It is a string of letters. It must not
+begin with a backslash, @code{\}. It must not be the name of an
+existing environment, and the command name @code{\@var{name}} must not
+already be defined.
@item title
The text to be printed at the beginning of the environment, before the
@@ -9014,7 +9034,7 @@
@node \newfont
- at section @code{\newfont}: Define a new font (obsolete)
+ at section @code{\newfont}
@findex \newfont
@cindex fonts, new commands for
@@ -9433,9 +9453,9 @@
@end example
Globally set the counter @var{counter} to have the value of the
- at var{value} argument. Thus, you can set a counter's value as
- at code{\setcounter@{section@}@{5@}}. Note that the counter name does not
-start with a backslash.
+ at var{value} argument, which must be an integer. Thus, you can set a
+counter's value as @code{\setcounter@{section@}@{5@}}. Note that the
+counter name does not start with a backslash.
In this example if the counter @code{theorem} has value 12 then the
second line will print @samp{XII}.
@@ -9507,7 +9527,12 @@
within it. (For the definition of ``counters numbered within'',
@pxref{\newcounter}.)
+This command differs from @code{\refstepcounter} in that this one does
+not influence references at tie{}--- it does not define the current
+ at code{\ref} value to be the result of @code{\thecounter}
+(@pxref{\refstepcounter}).
+
@node \day & \month & \year
@section @code{\day} & @code{\month} & @code{\year}
@@ -9837,8 +9862,9 @@
\settodepth@{@var{len}@}@{@var{text}@}
@end example
-Set the length @var{len} to the depth of the @var{text} argument. The
-length name @var{len} must begin with a backslash, @code{\}.
+Set the length @var{len} to the depth of box that @LaTeX{} gets on
+typesetting the @var{text} argument. The length name @var{len} must
+begin with a backslash, @code{\}.
This will show how low the character descenders go.
@@ -9866,9 +9892,9 @@
\settoheight@{@var{len}@}@{text@}
@end example
-Sets the length @var{len} to the height of the
- at code{text} argument. The length name @var{len} must begin with a
-backslash, @code{\}.
+Sets the length @var{len} to the height of box that @LaTeX{} gets on
+typesetting the @code{text} argument. The length name @var{len} must
+begin with a backslash, @code{\}.
This will show how high the characters go.
@@ -9886,7 +9912,7 @@
@node \settowidth
- at section @code{\settowidth@}}
+ at section @code{\settowidth}
@findex \settowidth
@@ -9896,8 +9922,9 @@
\settowidth@{@var{len}@}@{@var{text}@}
@end example
-Set the length @var{len} to the width of the @var{text}. The length
-name @var{len} must begin with a backslash, @code{\}.
+Set the length @var{len} to the width of the box that @LaTeX{} gets on
+typesetting the @var{text} argument. The length name @var{len} must
+begin with a backslash, @code{\}.
This measures the width of the lowercase ASCII alphabet.
@@ -10009,7 +10036,7 @@
@findex \par
@cindex paragraph, ending
-Synopsis (note that while reading the input @TeX{} converts two
+Synopsis (note that while reading the input @TeX{}, converts two
consecutive newlines to a @code{\par}):
@example
@@ -12691,7 +12718,28 @@
declaration has global scope, so its effect is not delimited by braces
or environments.
+Often the first page of a chapter or section has a different style. For
+example, this @LaTeX{} book document has the first page of the first
+chapter in in @code{plain} style, as is the default (@pxref{Page
+styles}).
+ at example
+\documentclass@{book@}
+\pagestyle@{headings@}
+\begin@{document@}
+\chapter@{First chapter@}
+ ...
+\chapter@{Second chapter@}\thispagestyle@{empty@}
+ ...
+ at end example
+
+ at noindent
+The @code{plain} style has a page number on it, centered in the footer.
+To make the page entirely empty, the command
+ at code{\thispagestyle@{empty@}} immediately follows the second
+ at code{\chapter}.
+
+
@node Spaces
@chapter Spaces
@@ -14111,7 +14159,7 @@
Typeset @var{text} just as with @code{\makebox} (@pxref{\mbox &
\makebox}) except that @LaTeX{} does not output it but instead saves it
in a storage bin named @var{box-cmd}. The bin name @var{box-cmd} begins
-with a backslash. You must have previously allocated the bin
+with a backslash, @code{\}. You must have previously allocated the bin
@var{box-cmd} with @code{\newsavebox} (@pxref{\newsavebox}).The
@code{\sbox} command is robust while @code{\savebox} is fragile
(@pxref{\protect}).
@@ -16305,12 +16353,12 @@
\rule[@var{raise}]@{@var{width}@}@{@var{thickness}@}
@end example
-Produce a @dfn{rule}, a rectangle.
+Produce a @dfn{rule}, a filled-in rectangle.
@cindex Halmos symbol
@cindex tombstone
-This produces a rectangular blob of ink, sometimes called a Halmos
-symbol, often used to mark the end of a proof.
+This produces a rectangular blob, sometimes called a Halmos symbol,
+often used to mark the end of a proof.
@example
\newcommand@{\qedsymbol@}@{\rule@{0.4em@}@{2ex@}@}
@@ -16321,9 +16369,10 @@
The @file{amsthm} package includes this command, with a somewhat
different-looking symbol.
-The mandatory arguments @var{width} and @var{thickness} are rigid
-lengths (@pxref{Lengths}). The optional argument @var{raise} is also a
-rigid length, and tells @LaTeX{} how much to raise the rule above the
+The mandatory arguments give the horizontal @var{width} and vertical
+ at var{thickness} of the rectangle. They are rigid lengths
+(@pxref{Lengths}). The optional argument @var{raise} is also a rigid
+length, and tells @LaTeX{} how much to raise the rule above the
baseline, or lower it if the length is negative.
This produces a line, a rectangle that is wide but not tall.
More information about the latexrefman-commits
mailing list