[latexrefman-commits] [SCM] latexrefman updated: r903 - trunk
karl at gnu.org.ua
karl at gnu.org.ua
Thu Apr 29 23:51:36 CEST 2021
Author: karl
Date: 2021-04-29 21:51:35 +0000 (Thu, 29 Apr 2021)
New Revision: 903
Modified:
trunk/ChangeLog
trunk/aspell.en.pws
trunk/latex2e.html
trunk/latex2e.info
trunk/latex2e.pdf
trunk/latex2e.texi
Log:
babel supports unicode engines, per javier
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2021-04-22 16:44:32 UTC (rev 902)
+++ trunk/ChangeLog 2021-04-29 21:51:35 UTC (rev 903)
@@ -1,3 +1,8 @@
+2021-04-29 Karl Berry <karl at freefriends.org>
+
+ * latex2e.texi (Accents): babel supports Unicode engines now.
+ Report from Javier Bezos, 29 Apr 2021 14:35:39.
+
2021-04-22 Karl Berry <karl at freefriends.org>
* latex2e.texi (Using BibTeX, Output files): https://mirror.ctan.org.
Modified: trunk/aspell.en.pws
===================================================================
--- trunk/aspell.en.pws 2021-04-22 16:44:32 UTC (rev 902)
+++ trunk/aspell.en.pws 2021-04-29 21:51:35 UTC (rev 903)
@@ -267,3 +267,4 @@
grfext
shellesc
CLI
+adjustbox
Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html 2021-04-22 16:44:32 UTC (rev 902)
+++ trunk/latex2e.html 2021-04-29 21:51:35 UTC (rev 903)
@@ -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 December 2020.
+document preparation system, version of April 2021.
This manual was originally translated from LATEX.HLP v1.0a in the
VMS Help Library. The pre-translation version was written by
@@ -39,10 +39,10 @@
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<title>LaTeX2e unofficial reference manual (December 2020)</title>
+<title>LaTeX2e unofficial reference manual (April 2021)</title>
-<meta name="description" content="LaTeX2e unofficial reference manual (December 2020)">
-<meta name="keywords" content="LaTeX2e unofficial reference manual (December 2020)">
+<meta name="description" content="LaTeX2e unofficial reference manual (April 2021)">
+<meta name="keywords" content="LaTeX2e unofficial reference manual (April 2021)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
@@ -99,7 +99,7 @@
</head>
<body lang="en">
-<h1 class="settitle" align="center">LaTeX2e unofficial reference manual (December 2020)</h1>
+<h1 class="settitle" align="center">LaTeX2e unofficial reference manual (April 2021)</h1>
@@ -551,7 +551,8 @@
<ul class="no-bullet">
<li><a id="toc-Command-line-options-1" href="#Command-line-options">28.1 Command line options</a></li>
<li><a id="toc-Command-line-input-1" href="#Command-line-input">28.2 Command line input</a></li>
- <li><a id="toc-Recovering-from-errors-1" href="#Recovering-from-errors">28.3 Recovering from errors</a></li>
+ <li><a id="toc-TeX_0027s-job-name" href="#Jobname">28.3 TeX’s job name</a></li>
+ <li><a id="toc-Recovering-from-errors-1" href="#Recovering-from-errors">28.4 Recovering from errors</a></li>
</ul></li>
<li><a id="toc-Document-templates-1" href="#Document-templates">Appendix A Document templates</a>
<ul class="no-bullet">
@@ -574,7 +575,7 @@
<span id="LaTeX2e_003a-An-unofficial-reference-manual"></span><h1 class="top">LaTeX2e: An unofficial reference manual</h1>
<p>This document is an unofficial reference manual (version of
-December 2020) for LaTeX2e, a document preparation system.
+April 2021) 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.
@@ -849,7 +850,7 @@
Portable Document Format <code>.pdf</code> file with <code>dvipdfmx</code>.
The contents of the file can be dumped in human-readable form with
<code>dvitype</code>. A vast array of other DVI utility programs are
-available (<a href="http://mirror.ctan.org/dviware">http://mirror.ctan.org/dviware</a>).
+available (<a href="https://mirror.ctan.org/dviware">https://mirror.ctan.org/dviware</a>).
</p>
</dd>
<dt><code>.pdf</code></dt>
@@ -3300,19 +3301,19 @@
<span id="index-_005ccolumnsep"></span>
</dt>
<dd><span id="twocolumn-columnsep"></span><p>The distance between columns. The default is 35pt. Change it with a
-command such as <code>\setlength{\columnsep}{40pt}</code> You must change
-it before the two column environment starts; in the preamble is a good
+command such as <code>\setlength{\columnsep}{40pt}</code>. You must change
+it before the two column mode starts; in the preamble is a good
place.
</p>
</dd>
<dt><code>\columnseprule</code>
<span id="index-_005ccolumnseprule"></span>
</dt>
-<dd><span id="twocolumn-columnseprule"></span><p>The width of the rule between columns. The rule appears halfway between
-the two columns. The default is 0pt, meaning that there is no rule.
-Change it with a command such as
+<dd><span id="twocolumn-columnseprule"></span><p>The width of the rule between columns. The default is 0pt, meaning that
+there is no rule. Otherwise, the rule appears halfway between the two
+columns. Change it with a command such as
<code>\setlength{\columnseprule}{0.4pt}</code>, before the two-column
-environment starts.
+mode starts.
</p>
</dd>
<dt><code>\columnwidth</code>
@@ -3320,8 +3321,8 @@
</dt>
<dd><span id="twocolumn-columnwidth"></span><p>The width of a single column. In one-column mode this is equal to
<code>\textwidth</code>. In two-column mode by default LaTeX sets the
-width of each of the two columns to be half of <code>\textwidth</code> minus
-<code>\columnsep</code>.
+width of each of the two columns, <code>\columnwidth</code>, to be half of
+<code>\textwidth</code> minus <code>\columnsep</code>.
</p>
</dd>
</dl>
@@ -3340,7 +3341,7 @@
<dd><p>The maximum fraction at the top of a two-column page that may be
occupied by two-column wide floats. The default is 0.7, meaning that
the height of a <code>table*</code> or <code>figure*</code> environment must not
-exceed <code>0.7\textheight</code> . If the height of your starred float
+exceed <code>0.7\textheight</code>. If the height of your starred float
environment exceeds this then you can take one of the following actions
to prevent it from floating all the way to the back of the document:
</p>
@@ -3358,37 +3359,37 @@
<p>You can redefine it, as with
<code>\renewcommand{\dbltopfraction}{0.9}</code>.
</p>
-<span id="twocolumn-dblfloatpagefraction"></span></dd>
+</dd>
<dt><code>\dblfloatpagefraction</code>
<span id="index-_005cdblfloatpagefraction"></span>
</dt>
-<dd><p>For a float page of two-column wide floats, this is the minimum fraction
+<dd><span id="twocolumn-dblfloatpagefraction"></span><p>For a float page of two-column wide floats, this is the minimum fraction
that must be occupied by floats, limiting the amount of blank space.
LaTeX’s default is <code>0.5</code>. Change it with <code>\renewcommand</code>.
</p>
-<span id="twocolumn-dblfloatsep"></span></dd>
+</dd>
<dt><code>\dblfloatsep</code>
<span id="index-_005cdblfloatsep"></span>
</dt>
-<dd><p>On a float page of two-column wide floats, this length is the distance
+<dd><span id="twocolumn-dblfloatsep"></span><p>On a float page of two-column wide floats, this length is the distance
between floats, at both the top and bottom of the page. The default is
<code>12pt plus2pt minus2pt</code> for a document set at <code>10pt</code> or
<code>11pt</code>, and <code>14pt plus2pt minus4pt</code> for a document set at
<code>12pt</code>.
</p>
-<span id="twocolumn-dbltextfloatsep"></span></dd>
+</dd>
<dt><code>\dbltextfloatsep</code>
<span id="index-_005cdbltextfloatsep"></span>
</dt>
-<dd><p>This length is the distance between a multi-column float at the top or
+<dd><span id="twocolumn-dbltextfloatsep"></span><p>This length is the distance between a multi-column float at the top or
bottom of a page and the main text. The default is <code>20pt plus2pt
minus4pt</code>.
</p>
-<span id="twocolumn-dbltopnumber"></span></dd>
+</dd>
<dt><code>\dbltopnumber</code>
<span id="index-_005cdbltopnumber"></span>
</dt>
-<dd><p>On a float page of two-column wide floats, this counter gives the
+<dd><span id="twocolumn-dbltopnumber"></span><p>On a float page of two-column wide floats, this counter gives the
maximum number of floats allowed at the top of the page. The LaTeX
default is <code>2</code>.
</p>
@@ -3515,7 +3516,7 @@
<span id="page-layout-parameters-headsep"></span><p>Vertical distance between the bottom of the header line and the top of
the main text. The default in the <code>article</code> and <code>report</code>
classes is ‘<samp>25pt</samp>’. In the <code>book</code> class the default is: if the
-document is set at 10pt then it is ‘<samp>0.25in</samp>’, and at 11pt and 12pt
+document is set at 10pt then it is ‘<samp>0.25in</samp>’, and at 11pt or 12pt
it is ‘<samp>0.275in</samp>’.
</p>
</dd>
@@ -3586,12 +3587,12 @@
</dt>
<dd><span id="index-_005coddsidemargin-2"></span>
<span id="index-_005cevensidemargin-2"></span>
-<span id="page-layout-parameters-oddsidemargin"></span><span id="page-layout-parameters-evensidemargin"></span><p>The <code>\oddsidemargin</code> is the extra distance between the left side of
+<span id="page-layout-parameters-oddsidemargin"></span><span id="page-layout-parameters-evensidemargin"></span><p>The <code>\oddsidemargin</code> length is the extra distance between the left side of
the page and the text’s left margin, on odd-numbered pages when the
document class option <code>twoside</code> is chosen and on all pages when
<code>oneside</code> is in effect. When <code>twoside</code> is in effect, on
even-numbered pages the extra distance on the left is
-<code>evensidemargin</code>.
+<code>\evensidemargin</code>.
</p>
<p>LaTeX’s default is that <code>\oddsidemargin</code> is 40% of the
difference between <code>\paperwidth</code> and <code>\textwidth</code>, and
@@ -3651,12 +3652,12 @@
specified width, and revert to their normal values at the end of the
<code>minipage</code> or <code>\parbox</code>.
</p>
+</dd>
+<dt><code>\hsize</code>
<span id="index-_005chsize"></span>
-<span id="page-layout-parameters-hsize"></span></dd>
-<dt><code>\hsize</code>
-<span id="index-_005chsize-1"></span>
</dt>
-<dd><p>This entry is included for completeness: <code>\hsize</code> is the TeX
+<dd><span id="index-_005chsize-1"></span>
+<span id="page-layout-parameters-hsize"></span><p>This entry is included for completeness: <code>\hsize</code> is the TeX
primitive parameter used when text is broken into lines. It should not
be used in normal LaTeX documents.
</p>
@@ -6145,7 +6146,7 @@
<p>An environment that creates a paragraph whose lines are flush to the
left-hand margin, and ragged right. If you have lines that are too long
then LaTeX will linebreak them in a way that avoids hyphenation and
-stretching or shrinking spaces. To force a new line use a double
+stretching or shrinking interword spaces. To force a new line use a double
backslash, <code>\\</code>. For the declaration form
see <a href="#g_t_005craggedright">\raggedright</a>.
</p>
@@ -6196,7 +6197,7 @@
</pre></div>
<p>A declaration which causes lines to be flush to the left margin and
-ragged right. It can be used inside an environment such as <code>quote</code>
+ragged right. It can be used inside an <var>environment</var> such as <code>quote</code>
or in a <code>parbox</code>. For the environment form
see <a href="#flushleft">flushleft</a>.
</p>
@@ -6245,11 +6246,13 @@
<p>An environment that creates a paragraph whose lines are flush to the
right-hand margin and ragged left. If you have lines that are too long
to fit the margins then LaTeX will linebreak them in a way that
-avoids hyphenation and stretching or shrinking spaces. To force a new
+avoids hyphenation and stretching or shrinking inter-word spaces. To force a new
line use a double backslash, <code>\\</code>. For the declaration form
see <a href="#g_t_005craggedleft">\raggedleft</a>.
</p>
-<p>For an example related to this environment, see <a href="#flushleft">flushleft</a>.
+<p>For an example related to this environment, see <a href="#flushleft">flushleft</a>,
+where one just have mutatis mutandis to replace <code>flushleft</code> by
+<code>flushright</code>.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#g_t_005craggedleft" accesskey="1">\raggedleft</a></td><td> </td><td align="left" valign="top">Declaration form of the <code>flushright</code> environment.
@@ -6284,7 +6287,7 @@
</pre></div>
<p>A declaration which causes lines to be flush to the right margin and
-ragged left. It can be used inside an environment such as <code>quote</code>
+ragged left. It can be used inside an <var>environment</var> such as <code>quote</code>
or in a <code>parbox</code>. For the environment form
see <a href="#flushright">flushright</a>.
</p>
@@ -6294,7 +6297,9 @@
scope of the declaration must contain the blank line or <code>\end</code>
command that ends the paragraph unit.
</p>
-<p>For an example related to this environment, see <a href="#g_t_005craggedright">\raggedright</a>.
+<p>For an example related to this environment, see <a href="#g_t_005craggedright">\raggedright</a>,
+where one just have mutatis mutandis to replace <code>\raggedright</code> by
+<code>\raggedleft</code>.
</p>
<hr>
@@ -6323,8 +6328,8 @@
\end{itemize}
</pre></div>
-<p>Produce a list that is unordered, sometimes called a bullet list. The
-environment must have at least one <code>\item</code>; having none causes the
+<p>Produce an <em>unordered list</em>, sometimes called a bullet list. There
+must be at least one <code>\item</code> within the environment; having none causes the
LaTeX error ‘<samp>Something's wrong--perhaps a missing \item</samp>’.
</p>
<p>This gives a two-item list.
@@ -6336,35 +6341,39 @@
\end{itemize}
</pre></div>
-<p>As a top-level list each label would come out as a bullet, •.
-The format of the labeling depends on the nesting level; see below.
+<p>With the default locale—without loading e.g. <samp>babel</samp> package
+with another language than USenglish—as a top-level list each label
+would come out as a bullet, •. The format of the labeling
+depends on the nesting level; see below.
</p>
<span id="index-_005citem-3"></span>
<p>Start list items with the <code>\item</code> command (see <a href="#g_t_005citem">\item</a>). If you
give <code>\item</code> an optional argument by following it with square
-brackets, as in <code>\item[Optional label]</code>, then by default it will
-appear in bold and be flush right, so it could extend into the left
-margin. For labels that are flush left see the <a href="#description">description</a>
-environment. Following the <code>\item</code> is optional text, which may
-contain multiple paragraphs.
+brackets, as in <code>\item[<var>Optional label</var>]</code>, then by default
+<var>Optional label</var> will appear in bold and be flush right, so it could
+extend into the left margin. For labels that are flush left see the
+<a href="#description">description</a> environment. Following the <code>\item</code> is the text of
+the item, which may be empty or contain multiple paragraphs.
</p>
+<p>Unordered lists can be nested within one another, up to four levels deep.
+They can also be nested within other paragraph-making environments, such
+as <code>enumerate</code> (see <a href="#enumerate">enumerate</a>).
+</p>
<span id="index-_005clabelitemi"></span>
<span id="index-_005clabelitemii"></span>
<span id="index-_005clabelitemiii"></span>
<span id="index-_005clabelitemiv"></span>
-<span id="itemize-labelitemi"></span><span id="itemize-labelitemii"></span><span id="itemize-labelitemiii"></span><span id="itemize-labelitemiv"></span><p>Itemized lists can be nested within one another, up to four levels deep.
-They can also be nested within other paragraph-making environments, such
-as <code>enumerate</code> (see <a href="#enumerate">enumerate</a>). The <code>itemize</code> environment
-uses the commands <code>\labelitemi</code> through <code>\labelitemiv</code> to
-produce the default label (this also uses the convention of lowercase
-roman numerals at the end of the command names that signify the nesting
-level). These are the default marks at each level.
+<span id="itemize-labelitemi"></span><span id="itemize-labelitemii"></span><span id="itemize-labelitemiii"></span><span id="itemize-labelitemiv"></span><p>The <code>itemize</code> environment uses the commands <code>\labelitemi</code>
+through <code>\labelitemiv</code> to produce the default label (note the
+the convention of lowercase roman numerals at the end of the command
+names that signify the nesting level). These are the default marks at
+each level.
</p>
<ol>
<li> • (bullet, from <code>\textbullet</code>)
</li><li> <b>-<span class="nolinebreak">-</span><!-- /@w --></b> (bold en-dash, from <code>\normalfont\bfseries\textendash</code>)
</li><li> * (asterisk, from <code>\textasteriskcentered</code>)
-</li><li> . (centered dot, rendered here as a period, from <code>\textperiodcentered</code>)
+</li><li> . (vertically centered dot, rendered here as a period, from <code>\textperiodcentered</code>)
</li></ol>
<p>Change the labels with <code>\renewcommand</code>. For instance, this makes
@@ -6383,21 +6392,22 @@
<span id="index-_005cleftmarginvi"></span>
<span id="itemize-leftmargin"></span><span id="itemize-leftmargini"></span><span id="itemize-leftmarginii"></span><span id="itemize-leftmarginiii"></span><span id="itemize-leftmarginiv"></span><span id="itemize-leftmarginv"></span><span id="itemize-leftmarginvi"></span><p>The distance between the left margin of the enclosing environment and
the left margin of the <code>itemize</code> list is determined by the
-parameters <code>\leftmargini</code> through <code>\leftmarginvi</code>. (Note the
-convention of using lowercase roman numerals a the end of the command
-name to denote the nesting level.) The defaults are: <code>2.5em</code> in
-level 1 (<code>2em</code> in two-column mode), <code>2.2em</code> in level 2,
-<code>1.87em</code> in level 3, and <code>1.7em</code> in level 4, with smaller
-values for more deeply nested levels.
+parameters <code>\leftmargini</code> through <code>\leftmarginvi</code>. (This also
+uses the convention of using lowercase roman numerals a the end of the
+command name to denote the nesting level.) The defaults are:
+<code>2.5em</code> in level 1 (<code>2em</code> in two-column mode), <code>2.2em</code> in
+level 2, <code>1.87em</code> in level 3, and <code>1.7em</code> in level 4, with
+smaller values for more deeply nested levels.
</p>
<span id="index-package_002c-enumitem"></span>
<span id="index-enumitem-package"></span>
<p>For other major LaTeX labeled list environments, see
-<a href="#description">description</a> and <a href="#enumerate">enumerate</a>. For information about list
-layout parameters, including the default values, and for information
-about customizing list layout, see <a href="#list">list</a>. The package
-<samp>enumitem</samp> is useful for customizing lists.
+<a href="#description">description</a> and <a href="#enumerate">enumerate</a>. The <code>itemize</code>,
+<code>enumerate</code> and <code>description</code> environment use the same list
+layout parameters. For a description, including the default values, and
+for information about customizing list layout, see <a href="#list">list</a>. The
+package <samp>enumitem</samp> is useful for customizing lists.
</p>
<p>This example greatly reduces the margin space for outermost itemized
lists.
@@ -6790,7 +6800,7 @@
\let\makelabel=\makeredlabel
}
}
-{\end{list} }
+{\end{list}}
</pre></div>
<table class="menu" border="0" cellspacing="0">
@@ -7105,20 +7115,28 @@
<p>This puts a table containing data side by side with a map graphic. They
are vertically centered.
</p>
+<span id="index-package_002c-siunitx"></span>
+<span id="index-siunitx-package"></span>
+
<div class="example">
-<pre class="example">\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
+<pre class="example">% siunitx to have the S column specifier, which aligns numbers on decimal point
+\usepackage{siunitx}
+\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
...
\begin{center}
\vcenteredhbox{\includegraphics[width=0.3\textwidth]{nyc.png}}
\hspace{0.1\textwidth}
\begin{minipage}{0.5\textwidth}
- \begin{tabular}{r|l}
- \multicolumn{1}{r}{Borough} &Pop (million) \\ \hline
- The Bronx &$1.5$ \\
- Brooklyn &$2.6$ \\
- Manhattan &$1.6$ \\
- Queens &$2.3$ \\
- Staten Island &$0.5$
+ \begin{tabular}{r|S}
+ % \multicolumn to remove vertical bar between column headers
+ \multicolumn{1}{r}{Borough} &
+ % Braces to prevent siunitx to misinterprete point as a decimal separator
+ {Pop. (million)} \\ \hline
+ The Bronx &1.5 \\
+ Brooklyn &2.6 \\
+ Manhattan &1.6 \\
+ Queens &2.3 \\
+ Staten Island &0.5
\end{tabular}
\end{minipage}
\end{center}
@@ -7141,7 +7159,7 @@
<p>Synopses:
</p><div class="example">
<pre class="example">\begin{picture}(<var>width</var>,<var>height</var>)
- <var>picture commands</var>
+ <var>picture command</var>
\end{picture}
</pre></div>
@@ -7149,10 +7167,12 @@
</p>
<div class="example">
<pre class="example">\begin{picture}(<var>width</var>,<var>height</var>)(<var>xoffset</var>,<var>yoffset</var>)
- <var>picture commands</var>
+ <var>picture command</var>
\end{picture}
</pre></div>
+<p>Where there may be any number of <var>picture command</var>’s.
+</p>
<p>An environment to create simple pictures containing lines, arrows,
boxes, circles, and text. This environment is not obsolete, but new
documents typically use much more powerful graphics creation systems,
@@ -7169,24 +7189,25 @@
\put(2,1){\makebox(0,0)[l]{\ first leg}}
\put(4,2){\vector(1,2){2}}
\put(5,4){\makebox(0,0)[l]{\ second leg}}
- \put(0,0){\line(1,1){6}}
+ \put(0,0){\vector(1,1){6}}
\put(3,3){\makebox(0,0)[r]{sum\ }}
\end{picture}
</pre></div>
<p>The <code>picture</code> environment has one required argument, a pair of
-numbers (<var>width</var>,<var>height</var>). Multiply these by the value
-<code>\unitlength</code> to get the nominal size of the output, the space that
-LaTeX reserves on the output page. This nominal size need not be how
-large the picture really is; LaTeX will draw things from the picture
-outside the picture’s box.
+positive real numbers (<var>width</var>,<var>height</var>). Multiply these by the
+value <code>\unitlength</code> to get the nominal size of the output, i.e.
+the space that LaTeX reserves on the output page. This nominal size
+need not be how large the picture really is; LaTeX will draw things
+from the picture outside the picture’s box.
</p>
<p>This environment also has an optional argument
(<var>xoffset</var>,<var>yoffset</var>). It is used to shift the origin. Unlike
most optional arguments, this one is not contained in square brackets.
-As with the required argument, it consists of two real numbers.
-Multiply these by <code>\unitlength</code> to get the point at the lower-left
-corner of the picture.
+As with the required argument, it consists of a pair of two real
+numbers, but these may also be negative or null. Multiply these
+by <code>\unitlength</code> to get the coordinates of the point at the
+lower-left corner of the picture.
</p>
<p>For example, if <code>\unitlength</code> has been set to <code>1mm</code>, the
command
@@ -7205,14 +7226,14 @@
</p>
<span id="index-position_002c-in-picture"></span>
<p>Each <var>picture command</var> tells LaTeX where to put something by
-naming its position. A <em>position</em> is a pair such as <code>(2.4,-5)</code>
+providing its position. A <em>position</em> is a pair such as <code>(2.4,-5)</code>
giving the x- and y-coordinates. A <em>coordinate</em> is a not a length,
it is a real number (it may have a decimal point or a minus sign). It
specifies a length in multiples of the unit length <code>\unitlength</code>,
so if <code>\unitlength</code> has been set to <code>1cm</code>, then the coordinate
-2.54 specifies a length of 2.54 centimeters.
+<code>2.54</code> specifies a length of 2.54 centimeters.
</p>
-<p>LaTeX’s default for <code>\unitlength</code> is <code>1pt</code>. it is a rigid
+<p>LaTeX’s default for <code>\unitlength</code> is <code>1pt</code>. It is a rigid
length (see <a href="#Lengths">Lengths</a>). Change it with the <code>\setlength</code> command
(see <a href="#g_t_005csetlength">\setlength</a>). Make this change only outside of a <code>picture</code>
environment.
@@ -7220,12 +7241,12 @@
<p>The <code>picture</code> environment supports using standard arithmetic
expressions as well as numbers.
</p>
-<p>Coordinates are given with respect to an origin, which is normally at
+<p>Coordinates are given with respect to an origin, which is by default at
the lower-left corner of the picture. Note that when a position appears
as an argument, as with <code>\put(1,2){...}</code>, it is not enclosed in
braces since the parentheses serve to delimit the argument. Also,
unlike in some computer graphics systems, larger y-coordinates are
-further up the page.
+further up the page, ie. <em>y = 1</em> is <em>above</em> <em>y = 0</em>.
</p>
<p>There are four ways to put things in a picture: <code>\put</code>,
<code>\multiput</code>, <code>\qbezier</code>, and <code>\graphpaper</code>. The most
@@ -7275,17 +7296,17 @@
\end{center}
</pre></div>
-<p>The red X will be precisely a quarter of the <code>\linewidth</code> from
-the left margin, and <code>0.35\linewidth</code> up from the bottom. Another
-example of this usage is to put similar code in the page header to get
-repeat material on each of a document’s pages.
+<p>The red X will be precisely a quarter of the <code>\textwidth</code> from
+the left margin, and <code>0.35\textwidth</code> up from the bottom of the
+picture. Another example of this usage is to put similar code in the
+page header to get repeat material on each of a document’s pages.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#g_t_005cput" accesskey="1">\put</a></td><td> </td><td align="left" valign="top">Place an object at a specified place.
</td></tr>
<tr><td align="left" valign="top">• <a href="#g_t_005cmultiput" accesskey="2">\multiput</a></td><td> </td><td align="left" valign="top">Draw multiple instances of an object.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_005cqbezier" accesskey="3">\qbezier</a></td><td> </td><td align="left" valign="top">Draw a quadratic Bezier curve.
+<tr><td align="left" valign="top">• <a href="#g_t_005cqbezier" accesskey="3">\qbezier</a></td><td> </td><td align="left" valign="top">Draw a quadratic Bézier curve.
</td></tr>
<tr><td align="left" valign="top">• <a href="#g_t_005cgraphpaper" accesskey="4">\graphpaper</a></td><td> </td><td align="left" valign="top">Draw graph paper.
</td></tr>
@@ -7421,10 +7442,10 @@
that curve.
</p>
<div class="example">
-<pre class="example">\begin{picture}(3,1.5)
+<pre class="example">\begin{picture}(8,4)
\put(0,0){\vector(1,0){8}} % x axis
\put(0,0){\vector(0,1){4}} % y axis
- \put(2,0){\line(0,1){3}} % left side rectangle
+ \put(2,0){\line(0,1){3}} % left side
\put(4,0){\line(0,1){3.5}} % right side
\qbezier(2,3)(2.5,2.9)(3,3.25)
\qbezier(3,3.25)(3.5,3.6)(4,3.5)
@@ -7449,7 +7470,10 @@
\graphpaper[<var>spacing</var>](<var>x_init</var>,<var>y_init</var>)(<var>x_dimen</var>,<var>y_dimen</var>)
</pre></div>
-<p>Draw a coordinate grid. Requires the <code>graphpap</code> package.
+<span id="index-package_002c-graphpap"></span>
+<span id="index-graphpap-package"></span>
+
+<p>Draw a coordinate grid. Requires the <samp>graphpap</samp> package.
The grid’s origin is <code>(<var>x_init</var>,<var>y_init</var>)</code>.
Grid lines come every <var>spacing</var> units (the default is 10).
The grid extends <var>x_dimen</var> units to the right and <var>y_dimen</var> units up.
@@ -7622,8 +7646,8 @@
<pre class="example">\put(5,7){\circle{6}}
</pre></div>
-<p>The available radii for <code>circle</code> are, in points, the even
-numbers from 2 to 20, inclusive. For <code>circle*</code> they are all the
+<p>The available radii for <code>\circle</code> are, in points, the even
+numbers from 2 to 20, inclusive. For <code>\circle*</code> they are all the
integers from 1 to 15.
</p>
@@ -7999,6 +8023,7 @@
</div>
<span id="tabbing-1"></span><h3 class="section">8.21 <code>tabbing</code></h3>
+
<span id="index-environment_002c-tabbing"></span>
<span id="index-tabbing-environment"></span>
@@ -8027,12 +8052,12 @@
</p>
<div class="example">
<pre class="example">\begin{tabbing}
-\hspace{0.75in} \= \hspace{0.40in} \= \hspace{0.40in} \kill
-Ship \> Guns \> Year \\
-\textit{Sophie} \> 14 \> 1800 \\
-\textit{Polychrest} \> 24 \> 1803 \\
-\textit{Lively} \> 38 \> 1804 \\
-\textit{Surprise} \> 28 \> 1805 \\
+\hspace{1.2in}\=\hspace{1in}\=\kill
+Ship \>Guns \>Year \\
+\textit{Sophie} \>14 \>1800 \\
+\textit{Polychrest} \>24 \>1803 \\
+\textit{Lively} \>38 \>1804 \\
+\textit{Surprise} \>28 \>1805 \\
\end{tabbing}
</pre></div>
@@ -8043,10 +8068,10 @@
sets the tab stops. Another distinction is that <code>tabular</code>
generates a box, but <code>tabbing</code> can be broken across pages.
Finally, while <code>tabular</code> can be used in any mode, <code>tabbing</code>
-can be used only in paragraph mode and it starts a new paragraph.
+can be used only in paragraph mode and it always starts a new paragraph,
+without indentation.
</p>
-<p>A <code>tabbing</code> environment always starts a new paragraph, without
-indentation. Moreover, as shown in the example above, there is no need
+<p>Moreover, as shown in the example above, there is no need
to use the starred form of the <code>\hspace</code> command at the beginning
of a tabbed row. The right margin of the <code>tabbing</code> environment is
the end of line, so that the width of the environment is
@@ -8059,8 +8084,9 @@
<code>\kill</code>. The last row may omit the <code>\\</code> and end with just
<code>\end{tabbing}</code>.
</p>
-<p>At any point the <code>tabbing</code> environment has a current tab stop
-pattern, a sequence of <em><var>n</var> > 0</em> tab stops, numbered 0, 1,
+<span id="index-pattern_002c-current-tab-stops_002c-tabbing"></span>
+<p>At any point the <code>tabbing</code> environment has a <em>current tab stop
+pattern</em>, a sequence of <em><var>n</var> > 0</em> tab stops, numbered 0, 1,
etc. These create <var>n</var> corresponding columns. Tab stop 0 is
always the left margin, defined by the enclosing environment. Tab
stop number <var>i</var> is set if it is assigned a horizontal
@@ -8269,19 +8295,17 @@
\end{table}
</pre></div>
-<p>but you can put many different kinds of content in a <code>table</code>,
-including text, LaTeX commands, etc.
+<p>but you can put many different kinds of content in a <code>table</code>:
+the <var>table body</var> may contain text, LaTeX commands, graphics, etc. It is
+typeset in a <code>parbox</code> of width <code>\textwidth</code>.
</p>
<p>For the possible values of <var>placement</var> and their effect on the
float placement algorithm, see <a href="#Floats">Floats</a>.
</p>
-<p>The table body is typeset in a <code>parbox</code> of width <code>\textwidth</code>.
-It can contain text, commands, graphics, etc.
-</p>
<p>The label is optional; it is used for cross references (see <a href="#Cross-references">Cross references</a>).
<span id="index-_005ccaption-1"></span>
The <code>\caption</code> command is also optional. It specifies caption text
-for the table. By default it is numbered. If its optional
+<var>title</var> for the table. By default it is numbered. If its optional
<var>lottitle</var> is present then that text is used in the list of tables
instead of <var>title</var> (see <a href="#Table-of-contents-etc_002e">Table of contents etc.</a>).
</p>
@@ -8470,7 +8494,7 @@
declaration (when used in a <code>p</code>-column element these declarations
must appear inside braces, as with <code>{\centering .. \\
..}</code>). Otherwise LaTeX will misinterpret the double backslash as
-ending the row. Instead, to get a line break in there use
+ending the tabular row. Instead, to get a line break in there use
<code>\newline</code> (see <a href="#g_t_005cnewline">\newline</a>).
</p>
</dd>
@@ -8790,15 +8814,17 @@
</pre></div>
<p>This styles the first reference as ‘<samp>[1] Leslie ...</samp>’, and so that
-<code>\cite{latexdps}</code> produces the matching ‘<samp>... based on [1]</samp>’.
-The second <code>\cite</code> produces ‘<samp>[1, 2]</samp>’. You must compile the
-document twice to resolve these references.
+<code>... based on \cite{latexdps}</code> produces the matching
+‘<samp>... based on [1]</samp>’. The second <code>\cite</code> produces ‘<samp>[1,
+2]</samp>’. You must compile the document twice to resolve these references.
</p>
<p>The mandatory argument <var>widest-label</var> is text that, when typeset, is
as wide as the widest item label produced by the <code>\bibitem</code>
commands. The tradition is to use <code>9</code> for bibliographies with less
than 10 references, <code>99</code> for ones with less than 100, etc.
</p>
+<span id="index-_005cbibname"></span>
+<span id="index-_005crefname"></span>
<p>The bibliographic list is headed by a title such as ‘<samp>Bibliography</samp>’.
To change it there are two cases. In the <samp>book</samp> and <samp>report</samp>
classes, where the top level sectioning is <code>\chapter</code> and the
@@ -8806,7 +8832,7 @@
<code>\bibname</code>. For <samp>article</samp>, where the class’s top level
sectioning is <code>\section</code> and the default is ‘<samp>References</samp>’, the
title is in macro <code>\refname</code>. Change it by redefining the command,
-as with <code>\renewcommand{\refname}{Cited references}</code> after
+as with <code>\renewcommand{\refname}{Cited references}</code>, after
<code>\begin{document}</code>.
</p>
<span id="index-package_002c-babel-1"></span>
@@ -8816,6 +8842,8 @@
redefine <code>\refname</code> or <code>\bibname</code> to fit the selected
language.
</p>
+<p>See <a href="#list">list</a>, for the list layout control parameters.
+</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#g_t_005cbibitem" accesskey="1">\bibitem</a></td><td> </td><td align="left" valign="top">Specify a bibliography item.
</td></tr>
@@ -8849,16 +8877,16 @@
<pre class="example">\bibitem[<var>label</var>]{<var>cite_key</var>}
</pre></div>
-<p>Generate an entry labeled by <var>label</var>. The default is for LaTeX to
-generates a number using the <code>enumi</code> counter. The <em>citation key</em>
+<p>Generate an entry labeled by default by a number generated using the
+<code>enumi</code> counter. The <em>citation key</em>
<span id="index-citation-key"></span>
-<var>cite_key</var> is a string of
+<var>cite_key</var> can be any string of
letters, numbers, and punctuation symbols (but not comma).
</p>
<p>See <a href="#thebibliography">thebibliography</a>, for an example.
</p>
-<p>The optional <var>label</var> changes the default label from an integer to the
-given string. With this
+<p>When provided, the optional <var>label</var> becomes the entry label and the
+<code>enumi</code> counter is not incremented. With this
</p>
<div class="example">
<pre class="example">\begin{thebibliography}
@@ -8889,7 +8917,7 @@
</p>
<p>Under the hood, LaTeX remembers the <var>cite_key</var> and <var>label</var>
information because <code>\bibitem</code> writes it to the auxiliary file
-<samp><var>filename</var>.aux</samp>. For instance, the above example causes
+<samp><var>jobname</var>.aux</samp> (see <a href="#Jobname">Jobname</a>). For instance, the above example causes
<code>\bibcite{latexdps}{Lamport, 1993}</code> and
<code>\bibcite{texbook}{1}</code> to appear in that file. The <samp>.aux</samp>
file is read by the <code>\begin{document}</code> command and then the
@@ -8941,20 +8969,21 @@
\end{thebibliography}
</pre></div>
-<p>produces output like ‘<samp>... source is [1]</samp>’. (You can change the
-appearance of the citation with bibliography styles. More is in
-<a href="#Using-BibTeX">Using BibTeX</a>.)
+<p>produces output like ‘<samp>... source is [1]</samp>’. You can change the
+appearance of the citation and of the reference by using bibliography
+styles if you generate automatically the <code>thebibliography</code>
+environment. More information in <a href="#Using-BibTeX">Using BibTeX</a>.
</p>
<p>The optional argument <var>subcite</var> is appended to the citation. For
example, <code>See 14.3 in \cite[p.~314]{texbook}</code> might produce
‘<samp>See 14.3 in [1, p. 314]</samp>’.
</p>
<p>In addition to what appears in the output, <code>\cite</code> writes
-information to the auxiliary file <samp><var>filename</var>.aux</samp>. For
-instance, <code>\cite{latexdps}</code> writes ‘<samp>\citation{latexdps}</samp>’
-to that file. This information is used by BibTeX to include in your
-reference list only those works that you have actually cited; see
-<a href="#g_t_005cnocite">\nocite</a> also.
+information to the auxiliary file <samp><var>jobname</var>.aux</samp>
+(see <a href="#Jobname">Jobname</a>). For instance, <code>\cite{latexdps}</code> writes
+‘<samp>\citation{latexdps}</samp>’ to that file. This information is used by
+BibTeX to include in your reference list only those works that you
+have actually cited; see <a href="#g_t_005cnocite">\nocite</a> also.
</p>
<p>If <var>keys</var> is not in your bibliography information then you get
‘<samp>LaTeX Warning: There were undefined references</samp>’, and in the output
@@ -8982,12 +9011,12 @@
</pre></div>
<p>Produces no output but writes <var>keys</var> to the auxiliary file
-<samp><var>doc-filename</var>.aux</samp>.
+<samp><var>jobname</var>.aux</samp> (see <a href="#Jobname">Jobname</a>).
</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 cited them (see <a href="#g_t_005ccite">\cite</a>).
+have not explicitly cited them (see <a href="#g_t_005ccite">\cite</a>).
</p>
<hr>
@@ -9006,7 +9035,7 @@
<p>As described in <code>thebibliography</code> (see <a href="#thebibliography">thebibliography</a>), a
sophisticated approach to managing bibliographies is provided by the
BibTeX program. This is only an introduction; see the full
-documentation on CTAN.
+documentation on CTAN (see <a href="#CTAN">CTAN</a>).
</p>
<p>With BibTeX, you don’t use <code>thebibliography</code>
(see <a href="#thebibliography">thebibliography</a>). Instead, include these lines.
@@ -9039,7 +9068,7 @@
<p>Many, many other BibTeX style files exist,
tailored to the demands of various publications. See CTAN’s listing
-<a href="http://mirror.ctan.org/biblio/bibtex/contrib">http://mirror.ctan.org/biblio/bibtex/contrib</a>.
+<a href="https://mirror.ctan.org/biblio/bibtex/contrib">https://mirror.ctan.org/biblio/bibtex/contrib</a>.
</p>
<p>The <code>\bibliography</code> command is what actually produces the
bibliography. Its argument is a comma-separated list, referring to
@@ -9220,8 +9249,13 @@
<p>You cannot use the verbatim environment in the argument to macros, for
instance in the argument to a <code>\section</code>. This is not the same as
-commands being fragile (see <a href="#g_t_005cprotect">\protect</a>), instead it just cannot appear
-there. (But the <code>cprotect</code> package can help with this.)
+commands being fragile (see <a href="#g_t_005cprotect">\protect</a>), instead it just cannot work,
+as the <code>verbatim</code> environment changes the catcode regime before
+processing its contents, and restore it immediately afterward,
+nevertheless with a macro argument the content of the argument has
+already be converted to a token list along the catcode regime in effect
+when the macro was called. However, the <code>cprotect</code> package can
+help with this.
</p>
<span id="index-package_002c-listings-1"></span>
<span id="index-listings-package-1"></span>
@@ -9244,7 +9278,7 @@
<p>A package that provides many more options for verbatim environments is
<code>fancyvrb</code>. Another is <code>verbatimbox</code>.
</p>
-<p>For a list of all the relevant packages, see CTAN.
+<p>For a list of all the relevant packages, see CTAN (see <a href="#CTAN">CTAN</a>).
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#g_t_005cverb" accesskey="1">\verb</a></td><td> </td><td align="left" valign="top">The macro form of the <code>verbatim</code> environment.
@@ -9296,7 +9330,8 @@
<p>The <code>*</code>-form differs only in that spaces are printed with a visible
space character.
</p>
-<p>The output from this will include a character showing spaces.
+<p>The output from this will include a visible space on both side of word
+‘<samp>with</samp>’:
</p>
<div class="example">
<pre class="example">The command's first argument is \verb*!filename with extension! and ...
@@ -9306,7 +9341,7 @@
<span id="index-url-package"></span>
<p>For typesetting Internet addresses, urls, the package <code>url</code>
-provides an option that is better than the <code>\verb</code> command, since
+is a better option than the <code>\verb</code> command, since
it allows line breaks.
</p>
<span id="index-package_002c-listings-2"></span>
@@ -9323,7 +9358,11 @@
<p>You cannot use <code>\verb</code> in the argument to a macro, for instance in
the argument to a <code>\section</code>. It is not a question of <code>\verb</code>
-being fragile (see <a href="#g_t_005cprotect">\protect</a>), instead it just cannot appear there.
+being fragile (see <a href="#g_t_005cprotect">\protect</a>), instead it just cannot work, as the
+<code>\verb</code> command changes the catcode regime before reading its
+argument, and restore it immediately afterward, nevertheless with a
+macro argument the content of the argument has already be converted to a
+token list along the catcode regime in effect when the macro was called.
However, the <code>cprotect</code> package can help with this.
</p>
@@ -12543,29 +12582,30 @@
<span id="index-_005cparindent-2"></span>
<span id="index-_005cparskip"></span>
<span id="index-paragraph-indentation"></span>
+<span id="index-horizontal-paragraph-indentation"></span>
<span id="index-vertical-space-before-paragraphs"></span>
<p>Synopsis:
</p>
<div class="example">
-<pre class="example">\setlength{\parskip}{<var>horizontal len</var>}
-\setlength{\parinden}{<var>vertical len</var>}
+<pre class="example">\setlength{\parindent}{<var>horizontal len</var>}
+\setlength{\parskip}{<var>vertical len</var>}
</pre></div>
-<p>Both are a rubber lengths (see <a href="#Lengths">Lengths</a>). They give the indentation
-of ordinary paragraphs, not paragraphs inside minipages
-(see <a href="#minipage">minipage</a>), and the vertical space between paragraphs.
+<p>Both are rubber lengths (see <a href="#Lengths">Lengths</a>). They affect the
+indentation of ordinary paragraphs, not paragraphs inside
+minipages (see <a href="#minipage">minipage</a>), and the vertical space between
+paragraphs, respectively.
</p>
-<p>This, put in the preamble,
+<p>For example, if this is put in the preamble:
</p>
<div class="example">
<pre class="example">\setlength{\parindent}{0em}
\setlength{\parskip}{1ex}
</pre></div>
-<p>arranges that the document will have paragraphs that are not indented,
-but instead are vertically separated by about the height of a lowercase
-‘<samp>x</samp>’.
+<p>The document will have paragraphs that are not indented, but instead
+are vertically separated by about the height of a lowercase ‘<samp>x</samp>’.
</p>
<p>In standard LaTeX documents, the default value for <code>\parindent</code>
in one-column documents is <code>15pt</code> when the default text size is
@@ -12574,10 +12614,11 @@
are set before LaTeX calls <code>\normalfont</code> so <code>em</code> is derived
from the default font, Computer Modern. If you use a different font
then to set <code>\parindent</code> in units matching that font, do
-<code>\AtBeginDocument{\setlength{\parindent}{1em}}</code>.) The
-default value for <code>\parskip</code> in LaTeX’s standard document styles
-is <code>0pt plus1pt</code>.
+<code>\AtBeginDocument{\setlength{\parindent}{1em}}</code>.)
</p>
+<p>The default value for <code>\parskip</code> in LaTeX’s standard document
+styles is <code>0pt plus1pt</code>.
+</p>
<hr>
<span id="Marginal-notes"></span><div class="header">
@@ -12631,8 +12672,8 @@
<dt><code>\marginparpush</code>
<span id="index-_005cmarginparpush-2"></span>
</dt>
-<dd><span id="marginal-notes-marginparpush"></span><p>Minimum vertical space between notes; default ‘<samp>7pt</samp>’ for
-‘<samp>12pt</samp>’ documents, ‘<samp>5pt</samp>’ else.
+<dd><span id="marginal-notes-marginparpush"></span><p>Minimum vertical space between notes; default ‘<samp>7pt</samp>’ for ‘<samp>12pt</samp>’
+documents, ‘<samp>5pt</samp>’ else. See also <a href="#page-layout-parameters-marginparpush">page layout parameters marginparpush</a>.
</p>
</dd>
<dt><code>\marginparsep</code>
@@ -17055,8 +17096,8 @@
</li><li> When cases are enumerated inline: <code>(b)~Show that $f(x)$ is
(1)~continuous, and (2)~bounded</code>.
-<span id="index-package_002c-siunitx"></span>
-<span id="index-siunitx-package"></span>
+<span id="index-package_002c-siunitx-1"></span>
+<span id="index-siunitx-package-1"></span>
</li><li> Between a number and its unit: <code>$745.7.8$~watts</code> (the
<samp>siunitx</samp> package has a special facility for this) or
@@ -17666,6 +17707,9 @@
<p>At its core, LaTeX puts things in boxes and then puts the boxes on a
page. So these commands are central.
</p>
+<span id="index-package_002c-adjustbox"></span>
+<span id="index-adjustbox-package"></span>
+
<p>There are many packages on CTAN that are useful for manipulating boxes.
One useful adjunct to the commands here is <samp>adjustbox</samp>.
</p>
@@ -17716,13 +17760,13 @@
</p>
<p>Because <code>text</code> is not broken into lines, you can use <code>\mbox</code>
to prevent hyphenation. In this example, LaTeX will not hyphenate
-the table name, ‘<samp>T-4</samp>’.
+the tank name, ‘<samp>T-34</samp>’.
</p>
<div class="example">
-<pre class="example">See Table~\mbox{T-4}
+<pre class="example">The soviet tank \mbox{T-34} is a symbol of victory against nazism.
</pre></div>
-<p>The first two command versions, <code>\mbox</code> and <code>\makebox</code>, are
+<p>The first two command synopsis versions, <code>\mbox</code> and <code>\makebox</code>, are
roughly equivalent. They create a box just wide enough to contain the
<var>text</var>. (They are like plain TeX’s <code>\hbox</code>.)
</p>
@@ -17749,7 +17793,7 @@
<pre class="example">\makebox[2\width]{Get a stretcher}
</pre></div>
-<p>For the fourth command version the optional argument <var>position</var>
+<p>For the fourth command synopsis version the optional argument <var>position</var>
gives position of the text within the box. It may take the following
values:
</p>
@@ -17791,12 +17835,11 @@
<span id="index-package_002c-Asymptote-2"></span>
<span id="index-Asymptote-package-2"></span>
-<p>The right edge of the output ‘<samp>10 points </samp>’ (note the ending space)
-will be just before the ‘<samp>What</samp>’ (note the space after
-‘<samp>points</samp>’). You can use <code>\makebox</code> similarly when making
-graphics, such as in <samp>TikZ</samp> or <samp>Asymptote</samp>, where you put the
-edge of the text at a known location, regardless of the length of that
-text.
+<p>The right edge of the output ‘<samp>10 points </samp>’ (note the ending space
+after ‘<samp>points</samp>’) will be just before the ‘<samp>What</samp>’. You can use
+<code>\makebox</code> similarly when making graphics, such as in <samp>TikZ</samp>
+or <samp>Asymptote</samp>, where you put the edge of the text at a known
+location, regardless of the length of that text.
</p>
<p>For boxes with frames see <a href="#g_t_005cfbox-_0026-_005cframebox">\fbox & \framebox</a>. For colors
see <a href="#Colored-boxes">Colored boxes</a>.
@@ -17805,11 +17848,12 @@
<code>picture</code> environment, where the length is given in terms of
<code>\unitlength</code> (see <a href="#g_t_005cmakebox-_0028picture_0029">\makebox (picture)</a>).
</p>
-<p>If you put a double-backslash into <var>text</var> then LaTeX will not
-give you a new line; for instance <code>\makebox{abc def \\ ghi}</code>
-outputs ‘<samp>abc defghi</samp>’ while <code>\makebox{abc def \par ghi}</code>
-outputs ‘<samp>abc def ghi</samp>’, but neither go to a second line. To get
-multiple lines see <a href="#g_t_005cparbox">\parbox</a> and <a href="#minipage">minipage</a>.
+<p>As <var>text</var> is typeset in LR mode, neither a double backslash
+<code>\\</code> nor <code>\par</code> will give you a new line; for instance
+<code>\makebox{abc def \\ ghi}</code> outputs ‘<samp>abc defghi</samp>’ while
+<code>\makebox{abc def \par ghi}</code> outputs ‘<samp>abc def ghi</samp>’, both on
+a single line. To get multiple lines see <a href="#g_t_005cparbox">\parbox</a>
+and <a href="#minipage">minipage</a>.
</p>
<hr>
@@ -17998,11 +18042,11 @@
<p>Raise or lower <var>text</var>. This command is fragile (see <a href="#g_t_005cprotect">\protect</a>).
</p>
-<p>This example makes a command for the restriction of a function by
-lowering the vertical bar symbol.
+<p>This example makes a command for denoting the restriction of a function
+by lowering the vertical bar symbol.
</p>
<div class="example">
-<pre class="example">\newcommand\restricted[1]{\raisebox{-.5ex}{$|$}_{#1}}
+<pre class="example">\newcommand*\restricted[1]{\raisebox{-.5ex}{$|$}_{#1}}
$f\restricted{A}$
</pre></div>
@@ -18025,7 +18069,7 @@
<p>This will align two graphics on their top (see <a href="#Graphics">Graphics</a>).
</p>
<div class="example">
-<pre class="example">\usepackage{graphicx} \usepackage{calc} % in preamble
+<pre class="example">\usepackage{graphicx,calc} % in preamble
...
\begin{center}
\raisebox{1ex-\height}{%
@@ -18061,13 +18105,13 @@
</pre></div>
<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, <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>).
+in a box register referred to by a variable named <var>box-cmd</var>. The
+variable name <var>box-cmd</var> begins with a backslash, <code>\</code>. You must
+have previously allocated the box register <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>).
</p>
-<p>This creates and uses a bin.
+<p>This creates and uses a box register.
</p>
<div class="example">
<pre class="example">\newsavebox{\fullname}
@@ -18075,12 +18119,12 @@
...
\usebox{\fullname}! His name is my name, too!
Whenever we go out, the people always shout!
-There goes \\usebox{\fullname}! Ya da da da da da da.
+There goes \usebox{\fullname}! Ya da da da da da da.
</pre></div>
-<p>One advantage of using and reusing a bin over a <code>\newcommand</code> is
-efficiency, that LaTeX need not repeatedly retypeset the contents.
-See the example below.
+<p>One advantage of using and reusing a box register over a
+<code>\newcommand</code> macro variable is efficiency, that LaTeX need not
+repeatedly retypeset the contents. See the example below.
</p>
<p>The first two command invocations,
<code>\sbox{<var>box-cmd</var>}{<var>text</var>}</code> and
@@ -18093,14 +18137,14 @@
<p>In the <code>\sbox</code> and <code>\savebox</code> commands the <var>text</var> is
typeset in LR mode so it does not have line breaks (see <a href="#Modes">Modes</a>). If
you use these then LaTeX doesn’t give you an error but it ignores
-what you want: if you enter <code>\sbox{\newbin}{test \\ test}</code> and
-<code>\usebox{\newbin}</code> then you get ‘<samp>testtest</samp>’, while if you
-enter <code>\sbox{\newbin}{test \par test}</code> and
-<code>\usebox{\newbin}</code> then you get ‘<samp>test test</samp>’, but no error or
+what you want: if you enter <code>\sbox{\newreg}{test \\ test}</code> and
+<code>\usebox{\newreg}</code> then you get ‘<samp>testtest</samp>’, while if you
+enter <code>\sbox{\newreg}{test \par test}</code> and
+<code>\usebox{\newreg}</code> then you get ‘<samp>test test</samp>’, but no error or
warning. To fix this use a <code>\parbox</code> or <code>minipage</code> as here.
</p>
<div class="example">
-<pre class="example">\savebox{\abin}{%
+<pre class="example">\savebox{\areg}{%
\begin{minipage}{\linewidth}
\begin{enumerate}
\item First item
@@ -18108,17 +18152,17 @@
\end{enumerate}
\end{minipage}}
...
-\usebox{\abin}
+\usebox{\areg}
</pre></div>
-<p>As an example of the efficiency of reusing a bin’s contents, this puts
+<p>As an example of the efficiency of reusing a register’s contents, this puts
the same picture on each page of the document by putting it in the
header. LaTeX only typesets it once.
</p>
<div class="example">
<pre class="example">\usepackage{graphicx} % all this in the preamble
-\newsavebox{\sealbin}
-\savebox{\sealbin}{%
+\newsavebox{\sealreg}
+\savebox{\sealreg}{%
\setlength{\unitlength}{1in}%
\begin{picture}(0,0)%
\put(1.5,-2.5){%
@@ -18128,14 +18172,14 @@
\end{tabular}}
\end{picture}%
}
-\markright{\usebox{\sealbin}}
+\markright{\usebox{\sealreg}}
\pagestyle{headings}
</pre></div>
<p>The <code>picture</code> environment is good for fine-tuning the placement.
</p>
-<p>If the bin has not already been defined then you get something like
-‘<samp>Undefined control sequence. <argument> \nobin</samp>’.
+<p>If the register <code>\noreg</code> has not already been defined then you get something like
+‘<samp>Undefined control sequence. <argument> \noreg</samp>’.
</p>
<hr>
@@ -18155,25 +18199,27 @@
\end{lrbox}
</pre></div>
-<p>The <var>text</var> inside the environment is saved in the bin
-<code><var>box-cmd</var></code>. The <var>box-cmd</var> must begin with a
-backslash. You must create this bin in advance with <code>\newsavebox</code>
-(see <a href="#g_t_005cnewsavebox">\newsavebox</a>). This is the environment form of the <code>\sbox</code>
-and <code>\savebox</code> commands, and is equivalent to them. See <a href="#g_t_005csbox-_0026-_005csavebox">\sbox & \savebox</a>, for the full information.
+<p>This is the environment form of the <code>\sbox</code> and <code>\savebox</code>
+commands, and is equivalent to them. See <a href="#g_t_005csbox-_0026-_005csavebox">\sbox & \savebox</a>, for the
+full description.
</p>
-<p>In this example the environment is convenient for entering the
-<code>tabular</code>.
+<p>The <var>text</var> inside the environment is saved in the box register
+referred to by variable <code><var>box-cmd</var></code>. The variable name
+<var>box-cmd</var> must begin with a backslash, <code>\</code>. You must allocate
+this box register in advance with <code>\newsavebox</code>
+(see <a href="#g_t_005cnewsavebox">\newsavebox</a>). In this example the environment is convenient
+for entering the <code>tabular</code>.
</p>
<div class="example">
-<pre class="example">\newsavebox{\jhbin}
-\begin{lrbox}{\jhbin}
+<pre class="example">\newsavebox{\jhreg}
+\begin{lrbox}{\jhreg}
\begin{tabular}{c}
\includegraphics[height=1in]{jh.png} \\
Jim Hef{}feron
\end{tabular}
\end{lrbox}
...
-\usebox{\jhbin}
+\usebox{\jhreg}
</pre></div>
@@ -18193,10 +18239,10 @@
<pre class="example">\usebox{<var>box-cmd</var>}
</pre></div>
-<p>Produce the box most recently saved in the bin <var>box-cmd</var> by the
+<p>Produce the box most recently saved in the box register <var>box-cmd</var> by the
commands <code>\sbox</code> or <code>\savebox</code>, or the <code>lrbox</code>
environment. See <a href="#g_t_005csbox-_0026-_005csavebox">\sbox & \savebox</a>, for more information and examples.
-(Note that <var>box-cmd</var> starts with a backslash.) This command is
+(Note that the variable name <var>box-cmd</var> starts with a backslash, <code>\</code>.) This command is
robust (see <a href="#g_t_005cprotect">\protect</a>).
</p>
@@ -20135,7 +20181,11 @@
<span id="index-package_002c-eurosym"></span>
<span id="index-eurosym-package"></span>
-<p>The Euro currency symbol: €. For an alternative glyph design, try the
+<p>The Euro currency symbol: €.
+<span id="index-package_002c-eurosym-1"></span>
+<span id="index-eurosym-package-1"></span>
+</p>
+<p>For an alternative glyph design, try the
<samp>eurosym</samp> package; also, most fonts nowadays come with their own
Euro symbol (Unicode U+20AC).
</p>
@@ -20324,14 +20374,17 @@
<span id="index-polyglossia-package"></span>
<span id="index-multilingual-support"></span>
-<p>LaTeX has wide support for many of the world’s scripts and languages,
-through the <code>babel</code> package and related support if you are using
-pdfLaTeX, or <samp>polyglossia</samp> if you are using XeLaTeX or
-LuaLaTeX. This section does not cover that support. It only lists
-the core LaTeX commands for creating accented characters. The
-<code>\capital...</code> commands shown here produce alternative forms for use
-with capital letters. These are not available with OT1.
+<p>LaTeX has wide support for many of the world’s scripts and
+languages, provided through the core <code>babel</code> package, which
+supports pdfLaTeX, XeLaTeX and LuaLaTeX. The
+<samp>polyglossia</samp> package provides similar support with the latter
+two engines.
</p>
+<p>This section does not cover that support. It only lists the core
+LaTeX commands for creating accented characters. The
+<code>\capital...</code> commands shown here produce alternative forms for
+use with capital letters. These are not available with OT1.
+</p>
<p>Below, to make them easier to find, the accents are all illustrated with
lowercase ‘<samp>o</samp>’.
</p>
@@ -23357,8 +23410,10 @@
</td></tr>
<tr><td align="left" valign="top">• <a href="#Command-line-input" accesskey="2">Command line input</a></td><td> </td><td align="left" valign="top">Specify LaTeX code on the command line.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Recovering-from-errors" accesskey="3">Recovering from errors</a></td><td> </td><td align="left" valign="top">When something goes wrong.
+<tr><td align="left" valign="top">• <a href="#Jobname" accesskey="3">Jobname</a></td><td> </td><td align="left" valign="top">How TeX sets the current job name.
</td></tr>
+<tr><td align="left" valign="top">• <a href="#Recovering-from-errors" accesskey="4">Recovering from errors</a></td><td> </td><td align="left" valign="top">When something goes wrong.
+</td></tr>
</table>
@@ -23429,16 +23484,8 @@
<dt><code>-jobname=<var>string</var></code></dt>
<dd><p>Set the value of TeX’s <em>jobname</em> to the string. The log file
and output file will then be named <samp><var>string</var>.log</samp> and
-<samp><var>string</var>.pdf</samp>.
+<samp><var>string</var>.pdf</samp>. see <a href="#Jobname">Jobname</a>.
</p>
-<p>When you run <code><code>pdflatex</code> <var>options</var> <var>argument</var></code>, if
-<var>argument</var> does not start with a backslash then TeX considers it
-the name of a file to input. Otherwise it waits for the first
-<code>\input</code> instruction and the name of the input file will be the job
-name. This is used to name the log file the output file. The
-<code>jobname</code> option overrides that process and directly specifies the
-name. See <a href="#Command-line-input">Command line input</a>, for an example of its use.
-</p>
<span id="output-directory"></span><span id="index-output-directory-for-all-external-files"></span>
<span id="index-_002d_002doutput_002ddirectory-command_002dline-option"></span>
</dd>
@@ -23501,7 +23548,7 @@
<hr>
<span id="Command-line-input"></span><div class="header">
<p>
-Next: <a href="#Recovering-from-errors" accesskey="n" rel="next">Recovering from errors</a>, Previous: <a href="#Command-line-options" accesskey="p" rel="prev">Command line options</a>, Up: <a href="#Command-line-interface" accesskey="u" rel="up">Command line interface</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Jobname" accesskey="n" rel="next">Jobname</a>, Previous: <a href="#Command-line-options" accesskey="p" rel="prev">Command line options</a>, Up: <a href="#Command-line-interface" accesskey="u" rel="up">Command line interface</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Command-line-input-1"></span><h3 class="section">28.2 Command line input</h3>
@@ -23549,25 +23596,47 @@
<p>The <code>jobname</code> option is there because otherwise both files would be
called <samp>main.pdf</samp> and the second would overwrite the first.
</p>
-<p>A final example. This loads the package <samp>graphicx</samp> with the option
-<code>draft</code>
+<p>In this example, one passes the <code>draft</code> option to the <samp>graphicx</samp> package:
</p>
<div class="example">
-<pre class="example">pdflatex -jobname=aa "\RequirePackage[draft]{graphicx}\input{aa.tex}"
+<pre class="example">pdflatex "\PassOptionsToPackage{draft}{graphicx}\input{aa.tex}"
</pre></div>
<p>so the graphic files are read for their bounding box size information
-but not incorporated into the PDF. (The <code>jobname</code> option is there
-because otherwise the output file would be <samp>graphicx.pdf</samp>, as
-<code>\RequirePackage</code> does an <code>\input</code> of its own.)
+but replaced in the PDF by a box with same size and that contains only
+the file name, which speeds up compilation time and saves printer ink.
</p>
<hr>
+<span id="Jobname"></span><div class="header">
+<p>
+Next: <a href="#Recovering-from-errors" accesskey="n" rel="next">Recovering from errors</a>, Previous: <a href="#Command-line-input" accesskey="p" rel="prev">Command line input</a>, Up: <a href="#Command-line-interface" accesskey="u" rel="up">Command line interface</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="TeX_0027s-job-name"></span><h3 class="section">28.3 TeX’s job name</h3>
+
+<p>When you run <code><code>pdflatex</code> <var>options</var> <var>argument</var></code>, if
+<var>argument</var> does not start with a backslash then TeX considers it
+the name of a file to input. Otherwise it waits for the first
+<code>\input</code> instruction and the name of the input file will be the job
+name. This is used to name the log file the output file. The
+<code>jobname</code> option overrides that process and directly specifies the
+name. See <a href="#Command-line-input">Command line input</a>, for an example of its use.
+</p>
+
+<div class="example">
+<pre class="example">pdflatex -jobname=aa "\RequirePackage[draft]{graphicx}\input{aa.tex}"
+</pre></div>
+<p>The <code>jobname</code> option is there because otherwise the output file
+would be <samp>graphicx.pdf</samp>, as <code>\RequirePackage</code> does an
+<code>\input</code> of its own.
+</p>
+
+<hr>
<span id="Recovering-from-errors"></span><div class="header">
<p>
-Previous: <a href="#Command-line-input" accesskey="p" rel="prev">Command line input</a>, Up: <a href="#Command-line-interface" accesskey="u" rel="up">Command line interface</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Jobname" accesskey="p" rel="prev">Jobname</a>, Up: <a href="#Command-line-interface" accesskey="u" rel="up">Command line interface</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Recovering-from-errors-1"></span><h3 class="section">28.3 Recovering from errors</h3>
+<span id="Recovering-from-errors-1"></span><h3 class="section">28.4 Recovering from errors</h3>
<p>If LaTeX finds an error in your document then it gives you an error
message and prompts you with a question mark, <code>?</code>. For instance,
@@ -24049,6 +24118,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cbibitem"><code>\bibitem</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cbibitem">\bibitem</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbibliography"><code>\bibliography</code></a>:</td><td> </td><td valign="top"><a href="#Using-BibTeX">Using BibTeX</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbibliographystyle"><code>\bibliographystyle</code></a>:</td><td> </td><td valign="top"><a href="#Using-BibTeX">Using BibTeX</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cbibname"><code>\bibname</code></a>:</td><td> </td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigcap"><code>\bigcap</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigcirc"><code>\bigcirc</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cbigcup"><code>\bigcup</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -24624,6 +24694,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cread"><code>\read</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cread">\read</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cref"><code>\ref</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-_005creflectbox"><code>\reflectbox</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005crefname"><code>\refname</code></a>:</td><td> </td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005crefstepcounter"><code>\refstepcounter</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005crefstepcounter">\refstepcounter</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005crenewenvironment"><code>\renewenvironment</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment & \renewenvironment</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cRequirePackage"><code>\RequirePackage</code></a>:</td><td> </td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
@@ -24951,6 +25022,7 @@
<tr><td></td><td valign="top"><a href="#index-acute-accent">acute accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-acute-accent_002c-math">acute accent, math</a>:</td><td> </td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-additional-packages_002c-loading">additional packages, loading</a>:</td><td> </td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-adjustbox-package"><code>adjustbox</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#Boxes">Boxes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ae-ligature">ae ligature</a>:</td><td> </td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-algorithm2e-package"><code>algorithm2e</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-align-environment_002c-from-amsmath">align <span class="roman">environment, from <code>amsmath</code></span></a>:</td><td> </td><td valign="top"><a href="#eqnarray">eqnarray</a></td></tr>
@@ -25328,6 +25400,7 @@
<tr><td></td><td valign="top"><a href="#index-etoolbox-package"><code>etoolbox</code> <span class="roman">package</span></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-euro-symbol">euro symbol</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-eurosym-package"><code>eurosym</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-eurosym-package-1"><code>eurosym</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ex">ex</a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ex-1"><code>ex</code></a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-exclamation-point_002c-upside_002ddown">exclamation point, upside-down</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
@@ -25442,6 +25515,7 @@
<tr><td></td><td valign="top"><a href="#index-graphics_002c-resizing-1">graphics, resizing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-graphics_002c-scaling">graphics, scaling</a>:</td><td> </td><td valign="top"><a href="#g_t_005cscalebox">\scalebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-graphics_002c-scaling-1">graphics, scaling</a>:</td><td> </td><td valign="top"><a href="#g_t_005cresizebox">\resizebox</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-graphpap-package"><code>graphpap</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cgraphpaper">\graphpaper</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-grave-accent">grave accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-grave-accent_002c-math">grave accent, math</a>:</td><td> </td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-greater-than-symbol_002c-in-text">greater than symbol, in text</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
@@ -25462,6 +25536,7 @@
<tr><td></td><td valign="top"><a href="#index-hello_002c-world">hello, world</a>:</td><td> </td><td valign="top"><a href="#Starting-and-ending">Starting and ending</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-here_002c-putting-floats">here, putting floats</a>:</td><td> </td><td valign="top"><a href="#Floats">Floats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-home-page-for-manual">home page for manual</a>:</td><td> </td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-horizontal-paragraph-indentation">horizontal paragraph indentation</a>:</td><td> </td><td valign="top"><a href="#g_t_005cparindent-_0026-_005cparskip">\parindent & \parskip</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-horizontal-space">horizontal space</a>:</td><td> </td><td valign="top"><a href="#g_t_005chss">\hss</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-horizontal-space_002c-stretchable">horizontal space, stretchable</a>:</td><td> </td><td valign="top"><a href="#g_t_005chss">\hss</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-horizontal-spacing">horizontal spacing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cphantom-_0026-_005cvphantom-_0026-_005chphantom">\phantom & \vphantom & \hphantom</a></td></tr>
@@ -25754,6 +25829,7 @@
<tr><td></td><td valign="top"><a href="#index-package-options">package options</a>:</td><td> </td><td valign="top"><a href="#Class-and-package-structure">Class and package structure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package-options-1">package 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-package_002c-abstract"><span class="roman">package</span>, <code>abstract</code></a>:</td><td> </td><td valign="top"><a href="#abstract">abstract</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-adjustbox"><span class="roman">package</span>, <code>adjustbox</code></a>:</td><td> </td><td valign="top"><a href="#Boxes">Boxes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-algorithm2e"><span class="roman">package</span>, <code>algorithm2e</code></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-amscd"><span class="roman">package</span>, <code>amscd</code></a>:</td><td> </td><td valign="top"><a href="#Arrows">Arrows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-amsfonts"><span class="roman">package</span>, <code>amsfonts</code></a>:</td><td> </td><td valign="top"><a href="#Math-formulas">Math formulas</a></td></tr>
@@ -25804,6 +25880,7 @@
<tr><td></td><td valign="top"><a href="#index-package_002c-envlab"><span class="roman">package</span>, <code>envlab</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cmakelabels">\makelabels</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-etoolbox"><span class="roman">package</span>, <code>etoolbox</code></a>:</td><td> </td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-eurosym"><span class="roman">package</span>, <code>eurosym</code></a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-eurosym-1"><span class="roman">package</span>, <code>eurosym</code></a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-expl3"><span class="roman">package</span>, <code>expl3</code></a>:</td><td> </td><td valign="top"><a href="#LaTeX-command-syntax">LaTeX command syntax</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-expl3-1"><span class="roman">package</span>, <code>expl3</code></a>:</td><td> </td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-fancyhdr"><span class="roman">package</span>, <code>fancyhdr</code></a>:</td><td> </td><td valign="top"><a href="#Page-styles">Page styles</a></td></tr>
@@ -25814,6 +25891,7 @@
<tr><td></td><td valign="top"><a href="#index-package_002c-float"><span class="roman">package</span>, <code>float</code></a>:</td><td> </td><td valign="top"><a href="#Floats">Floats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-geometry"><span class="roman">package</span>, <code>geometry</code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-geometry-1"><span class="roman">package</span>, <code>geometry</code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-graphpap"><span class="roman">package</span>, <code>graphpap</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cgraphpaper">\graphpaper</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-grfext"><span class="roman">package</span>, <code>grfext</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cDeclareGraphicsExtensions">\DeclareGraphicsExtensions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-hyperref"><span class="roman">package</span>, <code>hyperref</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-hyperref-1"><span class="roman">package</span>, <code>hyperref</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
@@ -25854,7 +25932,8 @@
<tr><td></td><td valign="top"><a href="#index-package_002c-setspace"><span class="roman">package</span>, <code>setspace</code></a>:</td><td> </td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-shellesc"><span class="roman">package</span>, <code>shellesc</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cwrite18">\write18</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-showidx"><span class="roman">package</span>, <code>showidx</code></a>:</td><td> </td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-siunitx"><span class="roman">package</span>, <code>siunitx</code></a>:</td><td> </td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-siunitx"><span class="roman">package</span>, <code>siunitx</code></a>:</td><td> </td><td valign="top"><a href="#minipage">minipage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-siunitx-1"><span class="roman">package</span>, <code>siunitx</code></a>:</td><td> </td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-suffix"><span class="roman">package</span>, <code>suffix</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005c_0040ifstar">\@ifstar</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-texosquery"><span class="roman">package</span>, <code>texosquery</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cwrite18">\write18</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-textcase"><span class="roman">package</span>, <code>textcase</code></a>:</td><td> </td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
@@ -25906,6 +25985,7 @@
<tr><td></td><td valign="top"><a href="#index-parentheses">parentheses</a>:</td><td> </td><td valign="top"><a href="#Delimiters">Delimiters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-part">part</a>:</td><td> </td><td valign="top"><a href="#Sectioning">Sectioning</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-part-1">part</a>:</td><td> </td><td valign="top"><a href="#g_t_005cpart">\part</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-pattern_002c-current-tab-stops_002c-tabbing">pattern, current tab stops, <span class="roman">tabbing</span></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pc"><code>pc</code></a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-PDF-graphic-files">PDF graphic files</a>:</td><td> </td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pdflatex"><code>pdflatex</code></a>:</td><td> </td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
@@ -26044,7 +26124,8 @@
<tr><td></td><td valign="top"><a href="#index-single-low_002d9-quotation-mark">single low-9 quotation mark</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-single-quote_002c-straight">single quote, straight</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-single-right-quote">single right quote</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-siunitx-package"><code>siunitx</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-siunitx-package"><code>siunitx</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#minipage">minipage</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-siunitx-package-1"><code>siunitx</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_007e">~</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-sizes-of-text">sizes of text</a>:</td><td> </td><td valign="top"><a href="#Font-sizes">Font sizes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-skip-plain-TeX">skip <span class="roman">plain TeX</span></a>:</td><td> </td><td valign="top"><a href="#Lengths">Lengths</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-skip-register_002c-plain-TeX">skip register, plain TeX</a>:</td><td> </td><td valign="top"><a href="#g_t_005cnewlength">\newlength</a></td></tr>
Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info 2021-04-22 16:44:32 UTC (rev 902)
+++ trunk/latex2e.info 2021-04-29 21:51:35 UTC (rev 903)
@@ -2,7 +2,7 @@
latex2e.texi.
This document is an unofficial reference manual for LaTeX, a document
-preparation system, version of December 2020.
+preparation system, version of April 2021.
This manual was originally translated from 'LATEX.HLP' v1.0a in the
VMS Help Library. The pre-translation version was written by George D.
@@ -44,8 +44,8 @@
LaTeX2e: An unofficial reference manual
***************************************
-This document is an unofficial reference manual (version of December
-2020) for LaTeX2e, a document preparation system.
+This document is an unofficial reference manual (version of April 2021)
+for LaTeX2e, a document preparation system.
* Menu:
@@ -229,7 +229,7 @@
'.pdf' file with 'dvipdfmx'. The contents of the file can be
dumped in human-readable form with 'dvitype'. A vast array of
other DVI utility programs are available
- (<http://mirror.ctan.org/dviware>).
+ (<https://mirror.ctan.org/dviware>).
'.pdf'
If LaTeX is invoked via the system command 'pdflatex', among other
@@ -1943,22 +1943,22 @@
'\columnsep'
The distance between columns. The default is 35pt. Change it with
- a command such as '\setlength{\columnsep}{40pt}' You must change it
- before the two column environment starts; in the preamble is a good
+ a command such as '\setlength{\columnsep}{40pt}'. You must change
+ it before the two column mode starts; in the preamble is a good
place.
'\columnseprule'
- The width of the rule between columns. The rule appears halfway
- between the two columns. The default is 0pt, meaning that there is
- no rule. Change it with a command such as
- '\setlength{\columnseprule}{0.4pt}', before the two-column
- environment starts.
+ The width of the rule between columns. The default is 0pt, meaning
+ that there is no rule. Otherwise, the rule appears halfway between
+ the two columns. Change it with a command such as
+ '\setlength{\columnseprule}{0.4pt}', before the two-column mode
+ starts.
'\columnwidth'
The width of a single column. In one-column mode this is equal to
'\textwidth'. In two-column mode by default LaTeX sets the width
- of each of the two columns to be half of '\textwidth' minus
- '\columnsep'.
+ of each of the two columns, '\columnwidth', to be half of
+ '\textwidth' minus '\columnsep'.
In a two-column document, the starred environments 'table*' and
'figure*' are two columns wide, whereas the unstarred environments
@@ -1970,7 +1970,7 @@
The maximum fraction at the top of a two-column page that may be
occupied by two-column wide floats. The default is 0.7, meaning
that the height of a 'table*' or 'figure*' environment must not
- exceed '0.7\textheight' . If the height of your starred float
+ exceed '0.7\textheight'. If the height of your starred float
environment exceeds this then you can take one of the following
actions to prevent it from floating all the way to the back of the
document:
@@ -2092,8 +2092,8 @@
Vertical distance between the bottom of the header line and the top
of the main text. The default in the 'article' and 'report'
classes is '25pt'. In the 'book' class the default is: if the
- document is set at 10pt then it is '0.25in', and at 11pt and 12pt
- it is '0.275in'.
+ document is set at 10pt then it is '0.25in', and at 11pt or 12pt it
+ is '0.275in'.
'\footskip'
Distance from the baseline of the last line of text to the baseline
@@ -2137,12 +2137,12 @@
'\oddsidemargin'
'\evensidemargin'
- The '\oddsidemargin' is the extra distance between the left side of
- the page and the text's left margin, on odd-numbered pages when the
- document class option 'twoside' is chosen and on all pages when
- 'oneside' is in effect. When 'twoside' is in effect, on
+ The '\oddsidemargin' length is the extra distance between the left
+ side of the page and the text's left margin, on odd-numbered pages
+ when the document class option 'twoside' is chosen and on all pages
+ when 'oneside' is in effect. When 'twoside' is in effect, on
even-numbered pages the extra distance on the left is
- 'evensidemargin'.
+ '\evensidemargin'.
LaTeX's default is that '\oddsidemargin' is 40% of the difference
between '\paperwidth' and '\textwidth', and '\evensidemargin' is
@@ -4010,8 +4010,9 @@
An environment that creates a paragraph whose lines are flush to the
left-hand margin, and ragged right. If you have lines that are too long
then LaTeX will linebreak them in a way that avoids hyphenation and
-stretching or shrinking spaces. To force a new line use a double
-backslash, '\\'. For the declaration form see *note \raggedright::.
+stretching or shrinking interword spaces. To force a new line use a
+double backslash, '\\'. For the declaration form see *note
+\raggedright::.
This creates a box of text that is at most 3 inches wide, with the
text flush left and ragged right.
@@ -4045,7 +4046,7 @@
\end{ENVIRONMENT}
A declaration which causes lines to be flush to the left margin and
-ragged right. It can be used inside an environment such as 'quote' or
+ragged right. It can be used inside an ENVIRONMENT such as 'quote' or
in a 'parbox'. For the environment form see *note flushleft::.
Unlike the 'flushleft' environment, the '\raggedright' command does
@@ -4079,11 +4080,13 @@
An environment that creates a paragraph whose lines are flush to the
right-hand margin and ragged left. If you have lines that are too long
to fit the margins then LaTeX will linebreak them in a way that avoids
-hyphenation and stretching or shrinking spaces. To force a new line use
-a double backslash, '\\'. For the declaration form see *note
-\raggedleft::.
+hyphenation and stretching or shrinking inter-word spaces. To force a
+new line use a double backslash, '\\'. For the declaration form
+see *note \raggedleft::.
- For an example related to this environment, see *note flushleft::.
+ For an example related to this environment, see *note flushleft::,
+where one just have mutatis mutandis to replace 'flushleft' by
+'flushright'.
* Menu:
@@ -4106,7 +4109,7 @@
\end{ENVIRONMENT}
A declaration which causes lines to be flush to the right margin and
-ragged left. It can be used inside an environment such as 'quote' or in
+ragged left. It can be used inside an ENVIRONMENT such as 'quote' or in
a 'parbox'. For the environment form see *note flushright::.
Unlike the 'flushright' environment, the '\raggedleft' command does
@@ -4115,7 +4118,9 @@
declaration must contain the blank line or '\end' command that ends the
paragraph unit.
- For an example related to this environment, see *note \raggedright::.
+ For an example related to this environment, see *note \raggedright::,
+where one just have mutatis mutandis to replace '\raggedright' by
+'\raggedleft'.
File: latex2e.info, Node: itemize, Next: letter, Prev: flushright, Up: Environments
@@ -4131,9 +4136,9 @@
...
\end{itemize}
- Produce a list that is unordered, sometimes called a bullet list.
-The environment must have at least one '\item'; having none causes the
-LaTeX error 'Something's wrong--perhaps a missing \item'.
+ Produce an "unordered list", sometimes called a bullet list. There
+must be at least one '\item' within the environment; having none causes
+the LaTeX error 'Something's wrong--perhaps a missing \item'.
This gives a two-item list.
@@ -4142,28 +4147,32 @@
\item Rice portrait
\end{itemize}
-As a top-level list each label would come out as a bullet, *. The
-format of the labeling depends on the nesting level; see below.
+With the default locale--without loading e.g. 'babel' package with
+another language than USenglish--as a top-level list each label would
+come out as a bullet, *. The format of the labeling depends on the
+nesting level; see below.
Start list items with the '\item' command (*note \item::). If you
give '\item' an optional argument by following it with square brackets,
-as in '\item[Optional label]', then by default it will appear in bold
-and be flush right, so it could extend into the left margin. For labels
-that are flush left see the *note description:: environment. Following
-the '\item' is optional text, which may contain multiple paragraphs.
+as in '\item[OPTIONAL LABEL]', then by default OPTIONAL LABEL will
+appear in bold and be flush right, so it could extend into the left
+margin. For labels that are flush left see the *note description::
+environment. Following the '\item' is the text of the item, which may
+be empty or contain multiple paragraphs.
- Itemized lists can be nested within one another, up to four levels
+ Unordered lists can be nested within one another, up to four levels
deep. They can also be nested within other paragraph-making
-environments, such as 'enumerate' (*note enumerate::). The 'itemize'
-environment uses the commands '\labelitemi' through '\labelitemiv' to
-produce the default label (this also uses the convention of lowercase
-roman numerals at the end of the command names that signify the nesting
-level). These are the default marks at each level.
+environments, such as 'enumerate' (*note enumerate::).
+ The 'itemize' environment uses the commands '\labelitemi' through
+'\labelitemiv' to produce the default label (note the the convention of
+lowercase roman numerals at the end of the command names that signify
+the nesting level). These are the default marks at each level.
+
1. * (bullet, from '\textbullet')
2. -- (bold en-dash, from '\normalfont\bfseries\textendash')
3. * (asterisk, from '\textasteriskcentered')
- 4. . (centered dot, rendered here as a period, from
+ 4. . (vertically centered dot, rendered here as a period, from
'\textperiodcentered')
Change the labels with '\renewcommand'. For instance, this makes the
@@ -4173,15 +4182,16 @@
The distance between the left margin of the enclosing environment and
the left margin of the 'itemize' list is determined by the parameters
-'\leftmargini' through '\leftmarginvi'. (Note the convention of using
-lowercase roman numerals a the end of the command name to denote the
-nesting level.) The defaults are: '2.5em' in level 1 ('2em' in
-two-column mode), '2.2em' in level 2, '1.87em' in level 3, and '1.7em'
-in level 4, with smaller values for more deeply nested levels.
+'\leftmargini' through '\leftmarginvi'. (This also uses the convention
+of using lowercase roman numerals a the end of the command name to
+denote the nesting level.) The defaults are: '2.5em' in level 1 ('2em'
+in two-column mode), '2.2em' in level 2, '1.87em' in level 3, and
+'1.7em' in level 4, with smaller values for more deeply nested levels.
For other major LaTeX labeled list environments, see *note
-description:: and *note enumerate::. For information about list layout
-parameters, including the default values, and for information about
+description:: and *note enumerate::. The 'itemize', 'enumerate' and
+'description' environment use the same list layout parameters. For a
+description, including the default values, and for information about
customizing list layout, see *note list::. The package 'enumitem' is
useful for customizing lists.
@@ -4503,7 +4513,7 @@
\let\makelabel=\makeredlabel
}
}
- {\end{list} }
+ {\end{list}}
* Menu:
@@ -4742,19 +4752,24 @@
This puts a table containing data side by side with a map graphic.
They are vertically centered.
+ % siunitx to have the S column specifier, which aligns numbers on decimal point
+ \usepackage{siunitx}
\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
...
\begin{center}
\vcenteredhbox{\includegraphics[width=0.3\textwidth]{nyc.png}}
\hspace{0.1\textwidth}
\begin{minipage}{0.5\textwidth}
- \begin{tabular}{r|l}
- \multicolumn{1}{r}{Borough} &Pop (million) \\ \hline
- The Bronx &$1.5$ \\
- Brooklyn &$2.6$ \\
- Manhattan &$1.6$ \\
- Queens &$2.3$ \\
- Staten Island &$0.5$
+ \begin{tabular}{r|S}
+ % \multicolumn to remove vertical bar between column headers
+ \multicolumn{1}{r}{Borough} &
+ % Braces to prevent siunitx to misinterprete point as a decimal separator
+ {Pop. (million)} \\ \hline
+ The Bronx &1.5 \\
+ Brooklyn &2.6 \\
+ Manhattan &1.6 \\
+ Queens &2.3 \\
+ Staten Island &0.5
\end{tabular}
\end{minipage}
\end{center}
@@ -4767,15 +4782,17 @@
Synopses:
\begin{picture}(WIDTH,HEIGHT)
- PICTURE COMMANDS
+ PICTURE COMMAND
\end{picture}
or
\begin{picture}(WIDTH,HEIGHT)(XOFFSET,YOFFSET)
- PICTURE COMMANDS
+ PICTURE COMMAND
\end{picture}
+Where there may be any number of PICTURE COMMAND's.
+
An environment to create simple pictures containing lines, arrows,
boxes, circles, and text. This environment is not obsolete, but new
documents typically use much more powerful graphics creation systems,
@@ -4791,21 +4808,23 @@
\put(2,1){\makebox(0,0)[l]{\ first leg}}
\put(4,2){\vector(1,2){2}}
\put(5,4){\makebox(0,0)[l]{\ second leg}}
- \put(0,0){\line(1,1){6}}
+ \put(0,0){\vector(1,1){6}}
\put(3,3){\makebox(0,0)[r]{sum\ }}
\end{picture}
The 'picture' environment has one required argument, a pair of
-numbers (WIDTH,HEIGHT). Multiply these by the value '\unitlength' to
-get the nominal size of the output, the space that LaTeX reserves on the
-output page. This nominal size need not be how large the picture really
-is; LaTeX will draw things from the picture outside the picture's box.
+positive real numbers (WIDTH,HEIGHT). Multiply these by the value
+'\unitlength' to get the nominal size of the output, i.e. the space that
+LaTeX reserves on the output page. This nominal size need not be how
+large the picture really is; LaTeX will draw things from the picture
+outside the picture's box.
This environment also has an optional argument (XOFFSET,YOFFSET). It
is used to shift the origin. Unlike most optional arguments, this one
is not contained in square brackets. As with the required argument, it
-consists of two real numbers. Multiply these by '\unitlength' to get
-the point at the lower-left corner of the picture.
+consists of a pair of two real numbers, but these may also be negative
+or null. Multiply these by '\unitlength' to get the coordinates of the
+point at the lower-left corner of the picture.
For example, if '\unitlength' has been set to '1mm', the command
@@ -4819,15 +4838,15 @@
picture by shifting everything, you can just add the appropriate
optional argument.
- Each PICTURE COMMAND tells LaTeX where to put something by naming its
-position. A "position" is a pair such as '(2.4,-5)' giving the x- and
-y-coordinates. A "coordinate" is a not a length, it is a real number
-(it may have a decimal point or a minus sign). It specifies a length in
-multiples of the unit length '\unitlength', so if '\unitlength' has been
-set to '1cm', then the coordinate 2.54 specifies a length of 2.54
-centimeters.
+ Each PICTURE COMMAND tells LaTeX where to put something by providing
+its position. A "position" is a pair such as '(2.4,-5)' giving the x-
+and y-coordinates. A "coordinate" is a not a length, it is a real
+number (it may have a decimal point or a minus sign). It specifies a
+length in multiples of the unit length '\unitlength', so if
+'\unitlength' has been set to '1cm', then the coordinate '2.54'
+specifies a length of 2.54 centimeters.
- LaTeX's default for '\unitlength' is '1pt'. it is a rigid length
+ LaTeX's default for '\unitlength' is '1pt'. It is a rigid length
(*note Lengths::). Change it with the '\setlength' command (*note
\setlength::). Make this change only outside of a 'picture'
environment.
@@ -4835,12 +4854,12 @@
The 'picture' environment supports using standard arithmetic
expressions as well as numbers.
- Coordinates are given with respect to an origin, which is normally at
-the lower-left corner of the picture. Note that when a position appears
-as an argument, as with '\put(1,2){...}', it is not enclosed in braces
-since the parentheses serve to delimit the argument. Also, unlike in
-some computer graphics systems, larger y-coordinates are further up the
-page.
+ Coordinates are given with respect to an origin, which is by default
+at the lower-left corner of the picture. Note that when a position
+appears as an argument, as with '\put(1,2){...}', it is not enclosed in
+braces since the parentheses serve to delimit the argument. Also,
+unlike in some computer graphics systems, larger y-coordinates are
+further up the page, ie. y = 1 is _above_ y = 0.
There are four ways to put things in a picture: '\put', '\multiput',
'\qbezier', and '\graphpaper'. The most often used is '\put'. This
@@ -4880,16 +4899,16 @@
\end{picture}
\end{center}
-The red X will be precisely a quarter of the '\linewidth' from the left
-margin, and '0.35\linewidth' up from the bottom. Another example of
-this usage is to put similar code in the page header to get repeat
-material on each of a document's pages.
+The red X will be precisely a quarter of the '\textwidth' from the left
+margin, and '0.35\textwidth' up from the bottom of the picture. Another
+example of this usage is to put similar code in the page header to get
+repeat material on each of a document's pages.
* Menu:
* \put:: Place an object at a specified place.
* \multiput:: Draw multiple instances of an object.
-* \qbezier:: Draw a quadratic Bezier curve.
+* \qbezier:: Draw a quadratic Bézier curve.
* \graphpaper:: Draw graph paper.
* \line:: Draw a straight line.
* \linethickness:: Set thickness of horizontal and vertical lines.
@@ -4982,10 +5001,10 @@
This draws a rectangle with a wavy top, using '\qbezier' for that
curve.
- \begin{picture}(3,1.5)
+ \begin{picture}(8,4)
\put(0,0){\vector(1,0){8}} % x axis
\put(0,0){\vector(0,1){4}} % y axis
- \put(2,0){\line(0,1){3}} % left side rectangle
+ \put(2,0){\line(0,1){3}} % left side
\put(4,0){\line(0,1){3.5}} % right side
\qbezier(2,3)(2.5,2.9)(3,3.25)
\qbezier(3,3.25)(3.5,3.6)(4,3.5)
@@ -5123,9 +5142,9 @@
\put(5,7){\circle{6}}
- The available radii for 'circle' are, in points, the even numbers
-from 2 to 20, inclusive. For 'circle*' they are all the integers from 1
-to 15.
+ The available radii for '\circle' are, in points, the even numbers
+from 2 to 20, inclusive. For '\circle*' they are all the integers from
+1 to 15.
File: latex2e.info, Node: \oval, Next: \shortstack, Prev: \circle, Up: picture
@@ -5421,12 +5440,12 @@
widths, ended by a '\kill' command (which is described below):
\begin{tabbing}
- \hspace{0.75in} \= \hspace{0.40in} \= \hspace{0.40in} \kill
- Ship \> Guns \> Year \\
- \textit{Sophie} \> 14 \> 1800 \\
- \textit{Polychrest} \> 24 \> 1803 \\
- \textit{Lively} \> 38 \> 1804 \\
- \textit{Surprise} \> 28 \> 1805 \\
+ \hspace{1.2in}\=\hspace{1in}\=\kill
+ Ship \>Guns \>Year \\
+ \textit{Sophie} \>14 \>1800 \\
+ \textit{Polychrest} \>24 \>1803 \\
+ \textit{Lively} \>38 \>1804 \\
+ \textit{Surprise} \>28 \>1805 \\
\end{tabbing}
Both the 'tabbing' environment and the more widely-used 'tabular'
@@ -5435,21 +5454,21 @@
while in 'tabbing' the user sets the tab stops. Another distinction is
that 'tabular' generates a box, but 'tabbing' can be broken across
pages. Finally, while 'tabular' can be used in any mode, 'tabbing' can
-be used only in paragraph mode and it starts a new paragraph.
+be used only in paragraph mode and it always starts a new paragraph,
+without indentation.
- A 'tabbing' environment always starts a new paragraph, without
-indentation. Moreover, as shown in the example above, there is no need
-to use the starred form of the '\hspace' command at the beginning of a
-tabbed row. The right margin of the 'tabbing' environment is the end of
-line, so that the width of the environment is '\linewidth'.
+ Moreover, as shown in the example above, there is no need to use the
+starred form of the '\hspace' command at the beginning of a tabbed row.
+The right margin of the 'tabbing' environment is the end of line, so
+that the width of the environment is '\linewidth'.
The 'tabbing' environment contains a sequence of "tabbed rows". The
first tabbed row begins immediately after '\begin{tabbing}' and each row
ends with '\\' or '\kill'. The last row may omit the '\\' and end with
just '\end{tabbing}'.
- At any point the 'tabbing' environment has a current tab stop
-pattern, a sequence of N > 0 tab stops, numbered 0, 1, etc. These
+ At any point the 'tabbing' environment has a "current tab stop
+pattern", a sequence of N > 0 tab stops, numbered 0, 1, etc. These
create N corresponding columns. Tab stop 0 is always the left margin,
defined by the enclosing environment. Tab stop number I is set if it is
assigned a horizontal position on the page. Tab stop number I can only
@@ -5583,20 +5602,18 @@
\label{tab:cello}
\end{table}
-but you can put many different kinds of content in a 'table', including
-text, LaTeX commands, etc.
+but you can put many different kinds of content in a 'table': the TABLE
+BODY may contain text, LaTeX commands, graphics, etc. It is typeset in
+a 'parbox' of width '\textwidth'.
For the possible values of PLACEMENT and their effect on the float
placement algorithm, see *note Floats::.
- The table body is typeset in a 'parbox' of width '\textwidth'. It
-can contain text, commands, graphics, etc.
-
The label is optional; it is used for cross references (*note Cross
references::). The '\caption' command is also optional. It specifies
-caption text for the table. By default it is numbered. If its optional
-LOTTITLE is present then that text is used in the list of tables instead
-of TITLE (*note Table of contents etc.::).
+caption text TITLE for the table. By default it is numbered. If its
+optional LOTTITLE is present then that text is used in the list of
+tables instead of TITLE (*note Table of contents etc.::).
In this example the table and caption will float to the bottom of a
page, unless it is pushed to a float page at the end.
@@ -5749,8 +5766,8 @@
(when used in a 'p'-column element these declarations must
appear inside braces, as with '{\centering .. \\ ..}').
Otherwise LaTeX will misinterpret the double backslash as
- ending the row. Instead, to get a line break in there use
- '\newline' (*note \newline::).
+ ending the tabular row. Instead, to get a line break in there
+ use '\newline' (*note \newline::).
'*{NUM}{COLS}'
Equivalent to NUM copies of COLS, where NUM is a positive
@@ -5992,10 +6009,10 @@
Addison-Wesley, Reading, Massachusetts, 1983.
\end{thebibliography}
-This styles the first reference as '[1] Leslie ...', and so that
-'\cite{latexdps}' produces the matching '... based on [1]'. The second
-'\cite' produces '[1, 2]'. You must compile the document twice to
-resolve these references.
+This styles the first reference as '[1] Leslie ...', and so that '...
+based on \cite{latexdps}' produces the matching '... based on [1]'. The
+second '\cite' produces '[1, 2]'. You must compile the document twice
+to resolve these references.
The mandatory argument WIDEST-LABEL is text that, when typeset, is as
wide as the widest item label produced by the '\bibitem' commands. The
@@ -6008,12 +6025,14 @@
'Bibliography', that title is in the macro '\bibname'. For 'article',
where the class's top level sectioning is '\section' and the default is
'References', the title is in macro '\refname'. Change it by redefining
-the command, as with '\renewcommand{\refname}{Cited references}' after
+the command, as with '\renewcommand{\refname}{Cited references}', after
'\begin{document}'.
Language support packages such as 'babel' will automatically redefine
'\refname' or '\bibname' to fit the selected language.
+ *Note list::, for the list layout control parameters.
+
* Menu:
* \bibitem:: Specify a bibliography item.
@@ -6035,15 +6054,14 @@
\bibitem[LABEL]{CITE_KEY}
- Generate an entry labeled by LABEL. The default is for LaTeX to
-generates a number using the 'enumi' counter. The "citation key"
-CITE_KEY is a string of letters, numbers, and punctuation symbols (but
-not comma).
+ Generate an entry labeled by default by a number generated using the
+'enumi' counter. The "citation key" CITE_KEY can be any string of
+letters, numbers, and punctuation symbols (but not comma).
*Note thebibliography::, for an example.
- The optional LABEL changes the default label from an integer to the
-given string. With this
+ When provided, the optional LABEL becomes the entry label and the
+'enumi' counter is not incremented. With this
\begin{thebibliography}
\bibitem[Lamport 1993]{latexdps}
@@ -6071,13 +6089,13 @@
were multiply-defined labels'.
Under the hood, LaTeX remembers the CITE_KEY and LABEL information
-because '\bibitem' writes it to the auxiliary file 'FILENAME.aux'. For
-instance, the above example causes '\bibcite{latexdps}{Lamport, 1993}'
-and '\bibcite{texbook}{1}' to appear in that file. The '.aux' file is
-read by the '\begin{document}' command and then the information is
-available for '\cite' commands. This explains why you need to run LaTeX
-twice to resolve references: once to write it out and once to read it
-in.
+because '\bibitem' writes it to the auxiliary file 'JOBNAME.aux' (*note
+Jobname::). For instance, the above example causes
+'\bibcite{latexdps}{Lamport, 1993}' and '\bibcite{texbook}{1}' to appear
+in that file. The '.aux' file is read by the '\begin{document}' command
+and then the information is available for '\cite' commands. This
+explains why you need to run LaTeX twice to resolve references: once to
+write it out and once to read it in.
Because of this two-pass algorithm, when you add a '\bibitem' or
change its CITE_KEY you may get 'LaTeX Warning: Label(s) may have
@@ -6112,19 +6130,20 @@
Addison-Wesley, Reading, Massachusetts, 1983.
\end{thebibliography}
-produces output like '... source is [1]'. (You can change the
-appearance of the citation with bibliography styles. More is in *note
-Using BibTeX::.)
+produces output like '... source is [1]'. You can change the appearance
+of the citation and of the reference by using bibliography styles if you
+generate automatically the 'thebibliography' environment. More
+information in *note Using BibTeX::.
The optional argument SUBCITE is appended to the citation. For
example, 'See 14.3 in \cite[p.~314]{texbook}' might produce 'See 14.3 in
[1, p. 314]'.
In addition to what appears in the output, '\cite' writes information
-to the auxiliary file 'FILENAME.aux'. For instance, '\cite{latexdps}'
-writes '\citation{latexdps}' to that file. This information is used by
-BibTeX to include in your reference list only those works that you have
-actually cited; see *note \nocite:: also.
+to the auxiliary file 'JOBNAME.aux' (*note Jobname::). For instance,
+'\cite{latexdps}' writes '\citation{latexdps}' to that file. This
+information is used by BibTeX to include in your reference list only
+those works that you have actually cited; see *note \nocite:: also.
If KEYS is not in your bibliography information then you get 'LaTeX
Warning: There were undefined references', and in the output the
@@ -6146,12 +6165,12 @@
\nocite{KEYS}
Produces no output but writes KEYS to the auxiliary file
-'DOC-FILENAME.aux'.
+'JOBNAME.aux' (*note Jobname::).
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
-cited them (*note \cite::).
+explicitly cited them (*note \cite::).
File: latex2e.info, Node: Using BibTeX, Prev: \nocite, Up: thebibliography
@@ -6162,7 +6181,7 @@
As described in 'thebibliography' (*note thebibliography::), a
sophisticated approach to managing bibliographies is provided by the
BibTeX program. This is only an introduction; see the full
-documentation on CTAN.
+documentation on CTAN (*note CTAN::).
With BibTeX, you don't use 'thebibliography' (*note
thebibliography::). Instead, include these lines.
@@ -6186,7 +6205,7 @@
Many, many other BibTeX style files exist, tailored to the demands of
various publications. See CTAN's listing
-<http://mirror.ctan.org/biblio/bibtex/contrib>.
+<https://mirror.ctan.org/biblio/bibtex/contrib>.
The '\bibliography' command is what actually produces the
bibliography. Its argument is a comma-separated list, referring to
@@ -6316,8 +6335,13 @@
You cannot use the verbatim environment in the argument to macros,
for instance in the argument to a '\section'. This is not the same as
-commands being fragile (*note \protect::), instead it just cannot appear
-there. (But the 'cprotect' package can help with this.)
+commands being fragile (*note \protect::), instead it just cannot work,
+as the 'verbatim' environment changes the catcode regime before
+processing its contents, and restore it immediately afterward,
+nevertheless with a macro argument the content of the argument has
+already be converted to a token list along the catcode regime in effect
+when the macro was called. However, the 'cprotect' package can help
+with this.
One common use of verbatim input is to typeset computer code. There
are packages that are an improvement the 'verbatim' environment. For
@@ -6328,7 +6352,7 @@
A package that provides many more options for verbatim environments
is 'fancyvrb'. Another is 'verbatimbox'.
- For a list of all the relevant packages, see CTAN.
+ For a list of all the relevant packages, see CTAN (*note CTAN::).
* Menu:
@@ -6368,21 +6392,25 @@
The '*'-form differs only in that spaces are printed with a visible
space character.
- The output from this will include a character showing spaces.
+ The output from this will include a visible space on both side of
+word 'with':
The command's first argument is \verb*!filename with extension! and ...
- For typesetting Internet addresses, urls, the package 'url' provides
-an option that is better than the '\verb' command, since it allows line
-breaks.
+ For typesetting Internet addresses, urls, the package 'url' is a
+better option than the '\verb' command, since it allows line breaks.
For computer code there are many packages with advantages over
'\verb'. One is 'listings', another is 'minted'.
You cannot use '\verb' in the argument to a macro, for instance in
the argument to a '\section'. It is not a question of '\verb' being
-fragile (*note \protect::), instead it just cannot appear there.
-However, the 'cprotect' package can help with this.
+fragile (*note \protect::), instead it just cannot work, as the '\verb'
+command changes the catcode regime before reading its argument, and
+restore it immediately afterward, nevertheless with a macro argument the
+content of the argument has already be converted to a token list along
+the catcode regime in effect when the macro was called. However, the
+'cprotect' package can help with this.
File: latex2e.info, Node: verse, Prev: verbatim, Up: Environments
@@ -8813,21 +8841,21 @@
Synopsis:
- \setlength{\parskip}{HORIZONTAL LEN}
- \setlength{\parinden}{VERTICAL LEN}
+ \setlength{\parindent}{HORIZONTAL LEN}
+ \setlength{\parskip}{VERTICAL LEN}
- Both are a rubber lengths (*note Lengths::). They give the
+ Both are rubber lengths (*note Lengths::). They affect the
indentation of ordinary paragraphs, not paragraphs inside minipages
-(*note minipage::), and the vertical space between paragraphs.
+(*note minipage::), and the vertical space between paragraphs,
+respectively.
- This, put in the preamble,
+ For example, if this is put in the preamble:
\setlength{\parindent}{0em}
\setlength{\parskip}{1ex}
-arranges that the document will have paragraphs that are not indented,
-but instead are vertically separated by about the height of a lowercase
-'x'.
+The document will have paragraphs that are not indented, but instead are
+vertically separated by about the height of a lowercase 'x'.
In standard LaTeX documents, the default value for '\parindent' in
one-column documents is '15pt' when the default text size is '10pt',
@@ -8835,9 +8863,11 @@
is '1em'. (These values are set before LaTeX calls '\normalfont' so
'em' is derived from the default font, Computer Modern. If you use a
different font then to set '\parindent' in units matching that font, do
-'\AtBeginDocument{\setlength{\parindent}{1em}}'.) The default value for
-'\parskip' in LaTeX's standard document styles is '0pt plus1pt'.
+'\AtBeginDocument{\setlength{\parindent}{1em}}'.)
+ The default value for '\parskip' in LaTeX's standard document styles
+is '0pt plus1pt'.
+
File: latex2e.info, Node: Marginal notes, Prev: \parindent & \parskip, Up: Making paragraphs
@@ -8875,7 +8905,8 @@
'\marginparpush'
Minimum vertical space between notes; default '7pt' for '12pt'
- documents, '5pt' else.
+ documents, '5pt' else. See also *note page layout parameters
+ marginparpush::.
'\marginparsep'
Horizontal space between the main text and the note; default '11pt'
@@ -12206,14 +12237,14 @@
command is robust, while '\makebox' is fragile (*note \protect::).
Because 'text' is not broken into lines, you can use '\mbox' to
-prevent hyphenation. In this example, LaTeX will not hyphenate the
-table name, 'T-4'.
+prevent hyphenation. In this example, LaTeX will not hyphenate the tank
+name, 'T-34'.
- See Table~\mbox{T-4}
+ The soviet tank \mbox{T-34} is a symbol of victory against nazism.
- The first two command versions, '\mbox' and '\makebox', are roughly
-equivalent. They create a box just wide enough to contain the TEXT.
-(They are like plain TeX's '\hbox'.)
+ The first two command synopsis versions, '\mbox' and '\makebox', are
+roughly equivalent. They create a box just wide enough to contain the
+TEXT. (They are like plain TeX's '\hbox'.)
In the third version the optional argument WIDTH specifies the width
of the box. Note that the space occupied by the text need not equal the
@@ -12233,8 +12264,9 @@
\makebox[2\width]{Get a stretcher}
- For the fourth command version the optional argument POSITION gives
-position of the text within the box. It may take the following values:
+ For the fourth command synopsis version the optional argument
+POSITION gives position of the text within the box. It may take the
+following values:
'c'
The TEXT is centered (default).
@@ -12261,11 +12293,11 @@
\pts{90}An African or European swallow?
- The right edge of the output '10 points ' (note the ending space)
-will be just before the 'What' (note the space after 'points'). You can
-use '\makebox' similarly when making graphics, such as in 'TikZ' or
-'Asymptote', where you put the edge of the text at a known location,
-regardless of the length of that text.
+ The right edge of the output '10 points ' (note the ending space
+after 'points') will be just before the 'What'. You can use '\makebox'
+similarly when making graphics, such as in 'TikZ' or 'Asymptote', where
+you put the edge of the text at a known location, regardless of the
+length of that text.
For boxes with frames see *note \fbox & \framebox::. For colors
see *note Colored boxes::.
@@ -12274,11 +12306,11 @@
'picture' environment, where the length is given in terms of
'\unitlength' (*note \makebox (picture)::).
- If you put a double-backslash into TEXT then LaTeX will not give you
-a new line; for instance '\makebox{abc def \\ ghi}' outputs 'abc defghi'
-while '\makebox{abc def \par ghi}' outputs 'abc def ghi', but neither go
-to a second line. To get multiple lines see *note \parbox:: and *note
-minipage::.
+ As TEXT is typeset in LR mode, neither a double backslash '\\' nor
+'\par' will give you a new line; for instance '\makebox{abc def \\ ghi}'
+outputs 'abc defghi' while '\makebox{abc def \par ghi}' outputs 'abc def
+ghi', both on a single line. To get multiple lines see *note \parbox::
+and *note minipage::.
File: latex2e.info, Node: \fbox & \framebox, Next: \parbox, Prev: \mbox & \makebox, Up: Boxes
@@ -12418,10 +12450,10 @@
Raise or lower TEXT. This command is fragile (*note \protect::).
- This example makes a command for the restriction of a function by
-lowering the vertical bar symbol.
+ This example makes a command for denoting the restriction of a
+function by lowering the vertical bar symbol.
- \newcommand\restricted[1]{\raisebox{-.5ex}{$|$}_{#1}}
+ \newcommand*\restricted[1]{\raisebox{-.5ex}{$|$}_{#1}}
$f\restricted{A}$
The first mandatory argument DISTANCE specifies how far to raise the
@@ -12440,7 +12472,7 @@
This will align two graphics on their top (*note Graphics::).
- \usepackage{graphicx} \usepackage{calc} % in preamble
+ \usepackage{graphicx,calc} % in preamble
...
\begin{center}
\raisebox{1ex-\height}{%
@@ -12467,24 +12499,25 @@
\savebox{BOX-CMD}[WIDTH][POS]{TEXT}
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
+except that LaTeX does not output it but instead saves it in a box
+register referred to by a variable named BOX-CMD. The variable name
+BOX-CMD begins with a backslash, '\'. You must have previously
+allocated the box register BOX-CMD with '\newsavebox' (*note
+\newsavebox::). The '\sbox' command is robust while '\savebox' is
fragile (*note \protect::).
- This creates and uses a bin.
+ This creates and uses a box register.
\newsavebox{\fullname}
\sbox{\fullname}{John Jacob Jingleheimer Schmidt}
...
\usebox{\fullname}! His name is my name, too!
Whenever we go out, the people always shout!
- There goes \\usebox{\fullname}! Ya da da da da da da.
+ There goes \usebox{\fullname}! Ya da da da da da da.
-One advantage of using and reusing a bin over a '\newcommand' is
-efficiency, that LaTeX need not repeatedly retypeset the contents. See
-the example below.
+One advantage of using and reusing a box register over a '\newcommand'
+macro variable is efficiency, that LaTeX need not repeatedly retypeset
+the contents. See the example below.
The first two command invocations, '\sbox{BOX-CMD}{TEXT}' and
'\savebox{BOX-CMD}{TEXT}', are roughly equivalent. As to the third and
@@ -12495,12 +12528,12 @@
In the '\sbox' and '\savebox' commands the TEXT is typeset in LR mode
so it does not have line breaks (*note Modes::). If you use these then
LaTeX doesn't give you an error but it ignores what you want: if you
-enter '\sbox{\newbin}{test \\ test}' and '\usebox{\newbin}' then you get
-'testtest', while if you enter '\sbox{\newbin}{test \par test}' and
-'\usebox{\newbin}' then you get 'test test', but no error or warning.
+enter '\sbox{\newreg}{test \\ test}' and '\usebox{\newreg}' then you get
+'testtest', while if you enter '\sbox{\newreg}{test \par test}' and
+'\usebox{\newreg}' then you get 'test test', but no error or warning.
To fix this use a '\parbox' or 'minipage' as here.
- \savebox{\abin}{%
+ \savebox{\areg}{%
\begin{minipage}{\linewidth}
\begin{enumerate}
\item First item
@@ -12508,15 +12541,15 @@
\end{enumerate}
\end{minipage}}
...
- \usebox{\abin}
+ \usebox{\areg}
- As an example of the efficiency of reusing a bin's contents, this
-puts the same picture on each page of the document by putting it in the
-header. LaTeX only typesets it once.
+ As an example of the efficiency of reusing a register's contents,
+this puts the same picture on each page of the document by putting it in
+the header. LaTeX only typesets it once.
\usepackage{graphicx} % all this in the preamble
- \newsavebox{\sealbin}
- \savebox{\sealbin}{%
+ \newsavebox{\sealreg}
+ \savebox{\sealreg}{%
\setlength{\unitlength}{1in}%
\begin{picture}(0,0)%
\put(1.5,-2.5){%
@@ -12526,13 +12559,13 @@
\end{tabular}}
\end{picture}%
}
- \markright{\usebox{\sealbin}}
+ \markright{\usebox{\sealreg}}
\pagestyle{headings}
The 'picture' environment is good for fine-tuning the placement.
- If the bin has not already been defined then you get something like
-'Undefined control sequence. <argument> \nobin'.
+ If the register '\noreg' has not already been defined then you get
+something like 'Undefined control sequence. <argument> \noreg'.
File: latex2e.info, Node: lrbox, Next: \usebox, Prev: \sbox & \savebox, Up: Boxes
@@ -12546,24 +12579,25 @@
TEXT
\end{lrbox}
- The TEXT inside the environment is saved in the bin 'BOX-CMD'. The
-BOX-CMD must begin with a backslash. You must create this bin in
-advance with '\newsavebox' (*note \newsavebox::). This is the
-environment form of the '\sbox' and '\savebox' commands, and is
-equivalent to them. *Note \sbox & \savebox::, for the full information.
+ This is the environment form of the '\sbox' and '\savebox' commands,
+and is equivalent to them. *Note \sbox & \savebox::, for the full
+description.
- In this example the environment is convenient for entering the
-'tabular'.
+ The TEXT inside the environment is saved in the box register referred
+to by variable 'BOX-CMD'. The variable name BOX-CMD must begin with a
+backslash, '\'. You must allocate this box register in advance with
+'\newsavebox' (*note \newsavebox::). In this example the environment is
+convenient for entering the 'tabular'.
- \newsavebox{\jhbin}
- \begin{lrbox}{\jhbin}
+ \newsavebox{\jhreg}
+ \begin{lrbox}{\jhreg}
\begin{tabular}{c}
\includegraphics[height=1in]{jh.png} \\
Jim Hef{}feron
\end{tabular}
\end{lrbox}
...
- \usebox{\jhbin}
+ \usebox{\jhreg}
File: latex2e.info, Node: \usebox, Prev: lrbox, Up: Boxes
@@ -12575,10 +12609,11 @@
\usebox{BOX-CMD}
- Produce the box most recently saved in the bin BOX-CMD by the
-commands '\sbox' or '\savebox', or the 'lrbox' environment. *Note \sbox
-& \savebox::, for more information and examples. (Note that BOX-CMD
-starts with a backslash.) This command is robust (*note \protect::).
+ Produce the box most recently saved in the box register BOX-CMD by
+the commands '\sbox' or '\savebox', or the 'lrbox' environment. *Note
+\sbox & \savebox::, for more information and examples. (Note that the
+variable name BOX-CMD starts with a backslash, '\'.) This command is
+robust (*note \protect::).
File: latex2e.info, Node: Color, Next: Graphics, Prev: Boxes, Up: Top
@@ -13918,10 +13953,12 @@
'\texteuro'
- The Euro currency symbol: €. For an alternative glyph design, try
- the 'eurosym' package; also, most fonts nowadays come with their
- own Euro symbol (Unicode U+20AC).
+ The Euro currency symbol: €.
+ For an alternative glyph design, try the 'eurosym' package; also,
+ most fonts nowadays come with their own Euro symbol (Unicode
+ U+20AC).
+
'\textexclamdown (or '!`')'
¡ Upside down exclamation point.
@@ -13991,13 +14028,15 @@
============
LaTeX has wide support for many of the world's scripts and languages,
-through the 'babel' package and related support if you are using
-pdfLaTeX, or 'polyglossia' if you are using XeLaTeX or LuaLaTeX. This
-section does not cover that support. It only lists the core LaTeX
-commands for creating accented characters. The '\capital...' commands
-shown here produce alternative forms for use with capital letters.
-These are not available with OT1.
+provided through the core 'babel' package, which supports pdfLaTeX,
+XeLaTeX and LuaLaTeX. The 'polyglossia' package provides similar
+support with the latter two engines.
+ This section does not cover that support. It only lists the core
+LaTeX commands for creating accented characters. The '\capital...'
+commands shown here produce alternative forms for use with capital
+letters. These are not available with OT1.
+
Below, to make them easier to find, the accents are all illustrated
with lowercase 'o'.
@@ -16146,6 +16185,7 @@
* Command line options:: Commonly used command line options.
* Command line input:: Specify LaTeX code on the command line.
+* Jobname:: How TeX sets the current job name.
* Recovering from errors:: When something goes wrong.
@@ -16194,15 +16234,8 @@
'-jobname=STRING'
Set the value of TeX's "jobname" to the string. The log file and
output file will then be named 'STRING.log' and 'STRING.pdf'.
+ *note Jobname::.
- When you run 'pdflatex OPTIONS ARGUMENT', if ARGUMENT does not
- start with a backslash then TeX considers it the name of a file to
- input. Otherwise it waits for the first '\input' instruction and
- the name of the input file will be the job name. This is used to
- name the log file the output file. The 'jobname' option overrides
- that process and directly specifies the name. *Note Command line
- input::, for an example of its use.
-
'-output-directory=DIRECTORY'
Write files in the directory DIRECTORY. It must already exist.
This applies to all external files created by TeX or LaTeX, such as
@@ -16243,7 +16276,7 @@
These are only available with TeX Live or MacTeX.
-File: latex2e.info, Node: Command line input, Next: Recovering from errors, Prev: Command line options, Up: Command line interface
+File: latex2e.info, Node: Command line input, Next: Jobname, Prev: Command line options, Up: Command line interface
28.2 Command line input
=======================
@@ -16281,20 +16314,37 @@
The 'jobname' option is there because otherwise both files would be
called 'main.pdf' and the second would overwrite the first.
- A final example. This loads the package 'graphicx' with the option
-'draft'
+ In this example, one passes the 'draft' option to the 'graphicx'
+package:
- pdflatex -jobname=aa "\RequirePackage[draft]{graphicx}\input{aa.tex}"
+ pdflatex "\PassOptionsToPackage{draft}{graphicx}\input{aa.tex}"
so the graphic files are read for their bounding box size information
-but not incorporated into the PDF. (The 'jobname' option is there
-because otherwise the output file would be 'graphicx.pdf', as
-'\RequirePackage' does an '\input' of its own.)
+but replaced in the PDF by a box with same size and that contains only
+the file name, which speeds up compilation time and saves printer ink.
-File: latex2e.info, Node: Recovering from errors, Prev: Command line input, Up: Command line interface
+File: latex2e.info, Node: Jobname, Next: Recovering from errors, Prev: Command line input, Up: Command line interface
-28.3 Recovering from errors
+28.3 TeX's job name
+===================
+
+When you run 'pdflatex OPTIONS ARGUMENT', if ARGUMENT does not start
+with a backslash then TeX considers it the name of a file to input.
+Otherwise it waits for the first '\input' instruction and the name of
+the input file will be the job name. This is used to name the log file
+the output file. The 'jobname' option overrides that process and
+directly specifies the name. *Note Command line input::, for an example
+of its use.
+
+ pdflatex -jobname=aa "\RequirePackage[draft]{graphicx}\input{aa.tex}"
+ The 'jobname' option is there because otherwise the output file would
+be 'graphicx.pdf', as '\RequirePackage' does an '\input' of its own.
+
+
+File: latex2e.info, Node: Recovering from errors, Prev: Jobname, Up: Command line interface
+
+28.4 Recovering from errors
===========================
If LaTeX finds an error in your document then it gives you an error
@@ -16514,13 +16564,13 @@
* *-form, defining new commands: \newcommand & \renewcommand.
(line 27)
* --disable-write18 command-line option: Command line options.
- (line 68)
+ (line 61)
* --enable-write18 command-line option: Command line options.
- (line 68)
+ (line 61)
* --file-line-error command-line option: Command line options.
- (line 89)
+ (line 82)
* --halt-on-error command-line option: Command line options.
- (line 86)
+ (line 79)
* --help command-line option: Command line options.
(line 23)
* --interaction command-line option: Command line options.
@@ -16528,13 +16578,13 @@
* --jobname command-line option: Command line options.
(line 43)
* --no-file-line-error command-line option: Command line options.
- (line 89)
+ (line 82)
* --no-shell-escape command-line option: Command line options.
- (line 68)
+ (line 61)
* --output-directory command-line option: Command line options.
- (line 55)
+ (line 48)
* --shell-escape command-line option: Command line options.
- (line 68)
+ (line 61)
* --version command-line option: Command line options.
(line 18)
* -1, write stream number: \write. (line 30)
@@ -16576,12 +16626,12 @@
(line 6)
* \!: Spacing in math mode.
(line 58)
-* \" (umlaut accent): Accents. (line 23)
+* \" (umlaut accent): Accents. (line 25)
* \#: Reserved characters. (line 14)
* \$: Reserved characters. (line 14)
* \%: Reserved characters. (line 14)
* \&: Reserved characters. (line 14)
-* \' (acute accent): Accents. (line 27)
+* \' (acute accent): Accents. (line 29)
* \' (tabbing): tabbing. (line 87)
* \(...\) inline math: math. (line 12)
* \*: \*. (line 6)
@@ -16590,14 +16640,14 @@
(line 44)
* \-: tabbing. (line 83)
* \- (hyphenation): \- (hyphenation). (line 6)
-* \. (dot-over accent): Accents. (line 30)
+* \. (dot-over accent): Accents. (line 32)
* \/: \/. (line 6)
* \:: Spacing in math mode.
(line 34)
* \;: Spacing in math mode.
(line 23)
* \<: tabbing. (line 75)
-* \= (macron accent): Accents. (line 34)
+* \= (macron accent): Accents. (line 36)
* \= (tabbing): tabbing. (line 69)
* \>: tabbing. (line 73)
* \> <1>: Spacing in math mode.
@@ -16665,7 +16715,7 @@
(line 14)
* \author{NAME1 \and NAME2 \and ...}: \maketitle. (line 42)
* \a` (grave accent in tabbing): tabbing. (line 103)
-* \b (bar-under accent): Accents. (line 49)
+* \b (bar-under accent): Accents. (line 51)
* \backmatter: \frontmatter & \mainmatter & \backmatter.
(line 6)
* \backslash: Math symbols. (line 49)
@@ -16681,6 +16731,7 @@
* \bibitem: \bibitem. (line 6)
* \bibliography: Using BibTeX. (line 6)
* \bibliographystyle: Using BibTeX. (line 6)
+* \bibname: thebibliography. (line 44)
* \bigcap: Math symbols. (line 56)
* \bigcirc: Math symbols. (line 61)
* \bigcup: Math symbols. (line 64)
@@ -16709,26 +16760,26 @@
* \Box: Math symbols. (line 105)
* \breve: Math accents. (line 16)
* \bullet: Math symbols. (line 110)
-* \c (cedilla accent): Accents. (line 59)
+* \c (cedilla accent): Accents. (line 61)
* \cal: Font styles. (line 78)
* \cap: Math symbols. (line 113)
-* \capitalacute: Accents. (line 27)
-* \capitalbreve: Accents. (line 85)
-* \capitalcaron: Accents. (line 89)
-* \capitalcedilla: Accents. (line 59)
-* \capitalcircumflex: Accents. (line 38)
-* \capitaldieresis: Accents. (line 23)
-* \capitaldotaccent: Accents. (line 63)
-* \capitalgrave: Accents. (line 42)
-* \capitalhungarumlaut: Accents. (line 67)
-* \capitalmacron: Accents. (line 34)
-* \capitalnewtie: Accents. (line 81)
-* \capitalogonek: Accents. (line 71)
-* \capitalring: Accents. (line 75)
-* \capitaltie: Accents. (line 81)
-* \capitaltilde: Accents. (line 46)
+* \capitalacute: Accents. (line 29)
+* \capitalbreve: Accents. (line 87)
+* \capitalcaron: Accents. (line 91)
+* \capitalcedilla: Accents. (line 61)
+* \capitalcircumflex: Accents. (line 40)
+* \capitaldieresis: Accents. (line 25)
+* \capitaldotaccent: Accents. (line 65)
+* \capitalgrave: Accents. (line 44)
+* \capitalhungarumlaut: Accents. (line 69)
+* \capitalmacron: Accents. (line 36)
+* \capitalnewtie: Accents. (line 83)
+* \capitalogonek: Accents. (line 73)
+* \capitalring: Accents. (line 77)
+* \capitaltie: Accents. (line 83)
+* \capitaltilde: Accents. (line 48)
* \caption: figure. (line 44)
-* \caption <1>: table. (line 44)
+* \caption <1>: table. (line 42)
* \cc: \cc. (line 6)
* \cdot: Math symbols. (line 118)
* \cdots: Dots. (line 17)
@@ -16793,7 +16844,7 @@
* \cup: Math symbols. (line 144)
* \CurrentOption: Class and package commands.
(line 60)
-* \d (dot-under accent): Accents. (line 63)
+* \d (dot-under accent): Accents. (line 65)
* \dag: Text symbols. (line 17)
* \dagger: Math symbols. (line 148)
* \dashbox: \dashbox. (line 6)
@@ -16964,7 +17015,7 @@
* \guillemotright (»): Text symbols. (line 30)
* \guilsinglleft (‹): Text symbols. (line 31)
* \guilsinglright (›): Text symbols. (line 32)
-* \H (Hungarian umlaut accent): Accents. (line 67)
+* \H (Hungarian umlaut accent): Accents. (line 69)
* \hat: Math accents. (line 31)
* \hbar: Math symbols. (line 244)
* \headheight: Page layout parameters.
@@ -16986,13 +17037,13 @@
* \hsize: Page layout parameters.
(line 119)
* \hsize <1>: Page layout parameters.
- (line 119)
+ (line 120)
* \hspace: \hspace. (line 6)
* \hss: \hss. (line 6)
* \huge: Font sizes. (line 11)
* \Huge: Font sizes. (line 11)
* \hyphenation: \hyphenation. (line 6)
-* \i (dotless i): Accents. (line 17)
+* \i (dotless i): Accents. (line 19)
* \iff: Math symbols. (line 256)
* \IfFileExists: Class and package commands.
(line 128)
@@ -17031,14 +17082,14 @@
* \item: description. (line 31)
* \item <1>: enumerate. (line 29)
* \item <2>: itemize. (line 6)
-* \item <3>: itemize. (line 28)
+* \item <3>: itemize. (line 30)
* \itemindent: list. (line 84)
* \itemsep: list. (line 88)
* \itshape: Font styles. (line 34)
-* \j (dotless j): Accents. (line 17)
+* \j (dotless j): Accents. (line 19)
* \jmath: Math symbols. (line 283)
* \Join: Math symbols. (line 280)
-* \k (ogonek): Accents. (line 71)
+* \k (ogonek): Accents. (line 73)
* \kappa: Math symbols. (line 287)
* \ker: Math functions. (line 60)
* \kill: tabbing. (line 107)
@@ -17051,10 +17102,10 @@
* \labelenumii: enumerate. (line 56)
* \labelenumiii: enumerate. (line 56)
* \labelenumiv: enumerate. (line 56)
-* \labelitemi: itemize. (line 35)
-* \labelitemii: itemize. (line 35)
-* \labelitemiii: itemize. (line 35)
-* \labelitemiv: itemize. (line 35)
+* \labelitemi: itemize. (line 42)
+* \labelitemii: itemize. (line 42)
+* \labelitemiii: itemize. (line 42)
+* \labelitemiv: itemize. (line 42)
* \labelsep: list. (line 100)
* \labelwidth: list. (line 105)
* \Lambda: Math symbols. (line 290)
@@ -17081,14 +17132,14 @@
* \lefteqn: eqnarray. (line 46)
* \leftharpoondown: Math symbols. (line 333)
* \leftharpoonup: Math symbols. (line 336)
-* \leftmargin: itemize. (line 54)
+* \leftmargin: itemize. (line 58)
* \leftmargin <1>: list. (line 125)
-* \leftmargini: itemize. (line 54)
-* \leftmarginii: itemize. (line 54)
-* \leftmarginiii: itemize. (line 54)
-* \leftmarginiv: itemize. (line 54)
-* \leftmarginv: itemize. (line 54)
-* \leftmarginvi: itemize. (line 54)
+* \leftmargini: itemize. (line 58)
+* \leftmarginii: itemize. (line 58)
+* \leftmarginiii: itemize. (line 58)
+* \leftmarginiv: itemize. (line 58)
+* \leftmarginv: itemize. (line 58)
+* \leftmarginvi: itemize. (line 58)
* \Leftrightarrow: Math symbols. (line 339)
* \leftrightarrow: Math symbols. (line 344)
* \leq: Math symbols. (line 349)
@@ -17147,12 +17198,12 @@
* \marginparpush <1>: Page layout parameters.
(line 43)
* \marginparpush <2>: Marginal notes. (line 35)
-* \marginparsep: Marginal notes. (line 39)
+* \marginparsep: Marginal notes. (line 40)
* \marginparwidth: Page layout parameters.
(line 42)
* \marginparwidth <1>: Page layout parameters.
(line 43)
-* \marginparwidth <2>: Marginal notes. (line 43)
+* \marginparwidth <2>: Marginal notes. (line 44)
* \marginsep: Page layout parameters.
(line 41)
* \marginsep <1>: Page layout parameters.
@@ -17222,7 +17273,7 @@
* \newpage: \newpage. (line 6)
* \newsavebox: \newsavebox. (line 6)
* \newtheorem: \newtheorem. (line 6)
-* \newtie: Accents. (line 81)
+* \newtie: Accents. (line 83)
* \newwrite: \write. (line 24)
* \ng: Additional Latin letters.
(line 40)
@@ -17322,7 +17373,7 @@
* \parsep: list. (line 148)
* \parskip: \parindent & \parskip.
(line 6)
-* \parskip example: itemize. (line 73)
+* \parskip example: itemize. (line 78)
* \part: Sectioning. (line 6)
* \part <1>: \part. (line 6)
* \partial: Math symbols. (line 499)
@@ -17390,7 +17441,7 @@
(line 6)
* \quotedblbase („): Text symbols. (line 53)
* \quotesinglbase (‚): Text symbols. (line 54)
-* \r (ring accent): Accents. (line 75)
+* \r (ring accent): Accents. (line 77)
* \raggedbottom: \raggedbottom. (line 6)
* \raggedleft: \raggedleft. (line 6)
* \raggedright: \raggedright. (line 6)
@@ -17403,6 +17454,7 @@
* \read: \read. (line 6)
* \ref: \ref. (line 6)
* \reflectbox: \scalebox. (line 6)
+* \refname: thebibliography. (line 44)
* \refstepcounter: \refstepcounter. (line 6)
* \renewenvironment: \newenvironment & \renewenvironment.
(line 6)
@@ -17520,7 +17572,7 @@
* \swarrow: Math symbols. (line 716)
* \symbol: Symbols by font position.
(line 6)
-* \t (tie-after accent): Accents. (line 81)
+* \t (tie-after accent): Accents. (line 83)
* \TAB: \(SPACE). (line 6)
* \tabbingsep: tabbing. (line 121)
* \tabcolsep: tabular. (line 172)
@@ -17555,48 +17607,48 @@
* \textemdash (or ---): Text symbols. (line 118)
* \textendash (or --): Text symbols. (line 124)
* \texteuro: Text symbols. (line 127)
-* \textexclamdown (or !`): Text symbols. (line 133)
+* \textexclamdown (or !`): Text symbols. (line 135)
* \textfloatsep: Floats. (line 123)
* \textfloatsep <1>: Floats. (line 124)
* \textfraction: Floats. (line 102)
* \textfraction <1>: Floats. (line 103)
-* \textgreater: Text symbols. (line 136)
+* \textgreater: Text symbols. (line 138)
* \textheight: Page layout parameters.
(line 91)
* \textheight <1>: Page layout parameters.
(line 92)
* \textit: Font styles. (line 34)
-* \textleftarrow: Text symbols. (line 142)
-* \textless: Text symbols. (line 139)
+* \textleftarrow: Text symbols. (line 144)
+* \textless: Text symbols. (line 141)
* \textmd: Font styles. (line 37)
* \textnormal: Font styles. (line 58)
-* \textordfeminine: Text symbols. (line 145)
-* \textordmasculine: Text symbols. (line 146)
+* \textordfeminine: Text symbols. (line 147)
+* \textordmasculine: Text symbols. (line 148)
* \textparagraph: Text symbols. (line 46)
-* \textperiodcentered: Text symbols. (line 149)
-* \textquestiondown (or ?`): Text symbols. (line 152)
-* \textquotedblleft (or ``): Text symbols. (line 155)
-* \textquotedblright (or ''): Text symbols. (line 158)
-* \textquoteleft (or `): Text symbols. (line 161)
-* \textquoteright (or '): Text symbols. (line 164)
-* \textquotesingle: Text symbols. (line 167)
-* \textquotestraightbase: Text symbols. (line 170)
-* \textquotestraightdblbase: Text symbols. (line 171)
-* \textregistered: Text symbols. (line 174)
-* \textrightarrow: Text symbols. (line 177)
+* \textperiodcentered: Text symbols. (line 151)
+* \textquestiondown (or ?`): Text symbols. (line 154)
+* \textquotedblleft (or ``): Text symbols. (line 157)
+* \textquotedblright (or ''): Text symbols. (line 160)
+* \textquoteleft (or `): Text symbols. (line 163)
+* \textquoteright (or '): Text symbols. (line 166)
+* \textquotesingle: Text symbols. (line 169)
+* \textquotestraightbase: Text symbols. (line 172)
+* \textquotestraightdblbase: Text symbols. (line 173)
+* \textregistered: Text symbols. (line 176)
+* \textrightarrow: Text symbols. (line 179)
* \textrm: Font styles. (line 31)
* \textsc: Font styles. (line 52)
* \textsection: Text symbols. (line 61)
* \textsf: Font styles. (line 49)
* \textsl: Font styles. (line 46)
* \textsterling: Text symbols. (line 50)
-* \textthreequartersemdash: Text symbols. (line 180)
-* \texttrademark: Text symbols. (line 183)
+* \textthreequartersemdash: Text symbols. (line 182)
+* \texttrademark: Text symbols. (line 185)
* \texttt: Font styles. (line 55)
-* \texttwelveudash: Text symbols. (line 186)
-* \textunderscore: Text symbols. (line 189)
+* \texttwelveudash: Text symbols. (line 188)
+* \textunderscore: Text symbols. (line 191)
* \textup: Font styles. (line 43)
-* \textvisiblespace: Text symbols. (line 192)
+* \textvisiblespace: Text symbols. (line 194)
* \textwidth: Page layout parameters.
(line 99)
* \textwidth <1>: Page layout parameters.
@@ -17640,17 +17692,17 @@
* \twocolumn: \twocolumn. (line 6)
* \typein: \typein. (line 6)
* \typeout: \typeout. (line 6)
-* \u (breve accent): Accents. (line 85)
+* \u (breve accent): Accents. (line 87)
* \unboldmath: \boldmath & \unboldmath.
(line 6)
* \unboldmath <1>: \boldmath & \unboldmath.
(line 14)
-* \underbar: Accents. (line 51)
+* \underbar: Accents. (line 53)
* \underbrace{MATH}: Over- and Underlining.
(line 26)
* \underline{TEXT}: Over- and Underlining.
(line 9)
-* \unitlength: picture. (line 26)
+* \unitlength: picture. (line 28)
* \unlhd: Math symbols. (line 753)
* \unrhd: Math symbols. (line 759)
* \Uparrow: Math symbols. (line 765)
@@ -17671,7 +17723,7 @@
(line 6)
* \UseTextSymbol: \UseTextAccent & \UseTextSymbol.
(line 6)
-* \v (breve accent): Accents. (line 89)
+* \v (breve accent): Accents. (line 91)
* \value: \value. (line 6)
* \vanothing: Math symbols. (line 806)
* \varepsilon: Math symbols. (line 801)
@@ -17704,7 +17756,7 @@
* \write streams 16, 17, 18: \write. (line 86)
* \write18: \write18. (line 6)
* \write18, enabling: Command line options.
- (line 68)
+ (line 61)
* \Xi: Math symbols. (line 860)
* \xi: Math symbols. (line 863)
* \year: \day & \month & \year.
@@ -17725,15 +17777,15 @@
* \\ force line break: \\. (line 6)
* \\* (for eqnarray): eqnarray. (line 37)
* \^: Reserved characters. (line 21)
-* \^ (circumflex accent): Accents. (line 38)
+* \^ (circumflex accent): Accents. (line 40)
* \_: Reserved characters. (line 14)
-* \` (grave accent): Accents. (line 42)
+* \` (grave accent): Accents. (line 44)
* \` (tabbing): tabbing. (line 93)
* \{: Reserved characters. (line 14)
* \|: Math symbols. (line 18)
* \}: Reserved characters. (line 14)
* \~: Reserved characters. (line 21)
-* \~ (tilde accent): Accents. (line 46)
+* \~ (tilde accent): Accents. (line 48)
* ^ superscript: Subscripts & superscripts.
(line 6)
* ^^J, in \write: \write. (line 95)
@@ -17765,9 +17817,10 @@
* accessing any character of a font: Symbols by font position.
(line 6)
* acronyms, list of: Glossaries. (line 6)
-* acute accent: Accents. (line 27)
+* acute accent: Accents. (line 29)
* acute accent, math: Math accents. (line 11)
* additional packages, loading: Additional packages. (line 6)
+* adjustbox package: Boxes. (line 9)
* ae ligature: Additional Latin letters.
(line 16)
* algorithm2e package: tabbing. (line 146)
@@ -17805,8 +17858,8 @@
* array (package) package: array. (line 77)
* array environment: array. (line 6)
* arrays, math: array. (line 6)
-* arrow, left, in text: Text symbols. (line 143)
-* arrow, right, in text: Text symbols. (line 178)
+* arrow, left, in text: Text symbols. (line 145)
+* arrow, right, in text: Text symbols. (line 180)
* arrows: Arrows. (line 6)
* article class: Document classes. (line 11)
* ascender height: Text symbols. (line 103)
@@ -17815,7 +17868,7 @@
* asterisk, centered, in text: Text symbols. (line 74)
* Asymptote package: \line. (line 36)
* Asymptote package <1>: \strut. (line 62)
-* Asymptote package <2>: \mbox & \makebox. (line 73)
+* Asymptote package <2>: \mbox & \makebox. (line 74)
* Asymptote package <3>: \write18. (line 13)
* at clause, in font definitions: \newfont. (line 19)
* at-sign: \@. (line 6)
@@ -17836,9 +17889,9 @@
* backslash, in text: Text symbols. (line 77)
* bar, double vertical, in text: Text symbols. (line 83)
* bar, vertical, in text: Text symbols. (line 80)
-* bar-over accent: Accents. (line 34)
+* bar-over accent: Accents. (line 36)
* bar-over accent, math: Math accents. (line 14)
-* bar-under accent: Accents. (line 49)
+* bar-under accent: Accents. (line 51)
* basics of LaTeX: Overview. (line 6)
* batchmode: Command line options.
(line 27)
@@ -17891,7 +17944,7 @@
* breaking lines: Line breaking. (line 6)
* breaking pages: Page breaking. (line 6)
* breaks, multiplication discretionary: \*. (line 6)
-* breve accent: Accents. (line 85)
+* breve accent: Accents. (line 87)
* breve accent, math: Math accents. (line 17)
* bug reporting: About this document. (line 28)
* bullet lists: itemize. (line 6)
@@ -17901,19 +17954,19 @@
* calligraphic fonts: Calligraphic. (line 6)
* calligraphic letters for math: Font styles. (line 79)
* cap height: Text symbols. (line 103)
-* caron accent: Accents. (line 89)
+* caron accent: Accents. (line 91)
* catcode: \makeatletter & \makeatother.
(line 19)
* category code, character: \makeatletter & \makeatother.
(line 19)
* cc: Units of length. (line 33)
* cc list, in letters: \cc. (line 6)
-* cedilla accent: Accents. (line 59)
+* cedilla accent: Accents. (line 61)
* center environment: center. (line 6)
* centered asterisk, in text: Text symbols. (line 74)
* centered equations: Document class options.
(line 57)
-* centered period, in text: Text symbols. (line 150)
+* centered period, in text: Text symbols. (line 152)
* centering text, declaration for: \centering. (line 6)
* centering text, environment for: center. (line 6)
* Centimeter: Units of length. (line 24)
@@ -17932,12 +17985,12 @@
(line 6)
* characters, reserved: Reserved characters. (line 6)
* characters, special: Reserved characters. (line 6)
-* check accent: Accents. (line 89)
+* check accent: Accents. (line 91)
* check accent, math: Math accents. (line 20)
* Cicero: Units of length. (line 33)
* circle symbol, big, in text: Text symbols. (line 86)
* circled letter, in text: Text symbols. (line 98)
-* circumflex accent: Accents. (line 38)
+* circumflex accent: Accents. (line 40)
* circumflex accent, math: Math accents. (line 32)
* circumflex, ASCII, in text: Text symbols. (line 68)
* citation key: \bibitem. (line 15)
@@ -18067,7 +18120,7 @@
* description lists, creating: description. (line 6)
* design size, in font definitions: \newfont. (line 19)
* Didot point: Units of length. (line 30)
-* dieresis accent: Accents. (line 23)
+* dieresis accent: Accents. (line 25)
* difference between class and package: Class and package construction.
(line 15)
* dimen plain TeX: Lengths. (line 9)
@@ -18090,13 +18143,13 @@
* document environment: document. (line 6)
* document templates: Document templates. (line 6)
* dollar sign: Text symbols. (line 116)
-* dot accent: Accents. (line 30)
+* dot accent: Accents. (line 32)
* dot over accent, math: Math accents. (line 26)
-* dot-over accent: Accents. (line 30)
-* dot-under accent: Accents. (line 63)
-* dotless i: Accents. (line 17)
+* dot-over accent: Accents. (line 32)
+* dot-under accent: Accents. (line 65)
+* dotless i: Accents. (line 19)
* dotless i, math: Math symbols. (line 264)
-* dotless j: Accents. (line 17)
+* dotless j: Accents. (line 19)
* dotless j, math: Math symbols. (line 284)
* dots: Dots. (line 6)
* double angle quotation marks: Text symbols. (line 33)
@@ -18104,10 +18157,10 @@
* double dagger, in text <1>: Text symbols. (line 113)
* double dot accent, math: Math accents. (line 23)
* double guillemets: Text symbols. (line 33)
-* double left quote: Text symbols. (line 156)
+* double left quote: Text symbols. (line 158)
* double low-9 quotation mark: Text symbols. (line 55)
-* double quote, straight base: Text symbols. (line 172)
-* double right quote: Text symbols. (line 159)
+* double quote, straight base: Text symbols. (line 174)
+* double right quote: Text symbols. (line 161)
* double spacing: Low-level font commands.
(line 118)
* double vertical bar, in text: Text symbols. (line 83)
@@ -18125,8 +18178,8 @@
* em: Units of length. (line 38)
* em <1>: Units of length. (line 38)
* em-dash: Text symbols. (line 119)
-* em-dash, three-quarters: Text symbols. (line 181)
-* em-dash, two-thirds: Text symbols. (line 187)
+* em-dash, three-quarters: Text symbols. (line 183)
+* em-dash, two-thirds: Text symbols. (line 189)
* emphasis: Font styles. (line 60)
* enclosure list: \encl. (line 6)
* Encoding, font: \DeclareFontEncoding.
@@ -18138,7 +18191,7 @@
* engines, TeX: TeX engines. (line 6)
* enlarge current page: \enlargethispage. (line 6)
* enumerate environment: enumerate. (line 6)
-* enumitem package: itemize. (line 62)
+* enumitem package: itemize. (line 66)
* enumitem package <1>: list. (line 254)
* environment: Starting and ending. (line 25)
* environment form of font size commands: Font sizes. (line 36)
@@ -18203,9 +18256,10 @@
(line 110)
* euro symbol: Text symbols. (line 128)
* eurosym package: Text symbols. (line 128)
+* eurosym package <1>: Text symbols. (line 129)
* ex: Units of length. (line 38)
* ex <1>: Units of length. (line 38)
-* exclamation point, upside-down: Text symbols. (line 134)
+* exclamation point, upside-down: Text symbols. (line 136)
* executivepaper option: Document class options.
(line 19)
* expl3 package: LaTeX command syntax.
@@ -18223,8 +18277,8 @@
* fancyhdr package: Page styles. (line 12)
* fancyhdr package <1>: \pagestyle. (line 13)
* fancyvrb package: tabbing. (line 146)
-* fancyvrb package <1>: verbatim. (line 37)
-* feminine ordinal symbol: Text symbols. (line 147)
+* fancyvrb package <1>: verbatim. (line 42)
+* feminine ordinal symbol: Text symbols. (line 149)
* figure environment: figure. (line 6)
* figure number, cross referencing: \ref. (line 6)
* figures, footnotes in: minipage. (line 106)
@@ -18349,18 +18403,19 @@
* graphics, resizing <1>: \resizebox. (line 6)
* graphics, scaling: \scalebox. (line 6)
* graphics, scaling <1>: \resizebox. (line 6)
-* grave accent: Accents. (line 42)
+* graphpap package: \graphpaper. (line 11)
+* grave accent: Accents. (line 44)
* grave accent, math: Math accents. (line 29)
-* greater than symbol, in text: Text symbols. (line 137)
+* greater than symbol, in text: Text symbols. (line 139)
* greek letters: Math symbols. (line 6)
* Greek letters: Greek letters. (line 6)
* grfext package: \DeclareGraphicsExtensions.
(line 39)
* group, and environments: Environments. (line 18)
* group_skip: makeindex. (line 57)
-* hacek accent: Accents. (line 89)
+* hacek accent: Accents. (line 91)
* Halmos symbol: \rule. (line 13)
-* hat accent: Accents. (line 38)
+* hat accent: Accents. (line 40)
* hat accent, math: Math accents. (line 32)
* header style: \pagestyle. (line 6)
* header, parameters for: Page layout parameters.
@@ -18368,11 +18423,13 @@
* hello, world: Starting and ending. (line 6)
* here, putting floats: Floats. (line 52)
* home page for manual: About this document. (line 6)
+* horizontal paragraph indentation: \parindent & \parskip.
+ (line 6)
* horizontal space: \hss. (line 6)
* horizontal space, stretchable: \hss. (line 6)
* horizontal spacing: \phantom & \vphantom & \hphantom.
(line 6)
-* hungarian umlaut accent: Accents. (line 67)
+* hungarian umlaut accent: Accents. (line 69)
* hyperref package: \footnotemark. (line 48)
* hyperref package <1>: \footnotemark. (line 57)
* hyperref package <2>: \pagenumbering. (line 45)
@@ -18472,11 +18529,11 @@
* layout, page parameters for: Page layout parameters.
(line 6)
* left angle quotation marks: Text symbols. (line 33)
-* left arrow, in text: Text symbols. (line 143)
+* left arrow, in text: Text symbols. (line 145)
* left brace, in text: Text symbols. (line 89)
* left quote: Text symbols. (line 43)
-* left quote, double: Text symbols. (line 156)
-* left quote, single: Text symbols. (line 162)
+* left quote, double: Text symbols. (line 158)
+* left quote, single: Text symbols. (line 164)
* left-hand equation numbers: Document class options.
(line 63)
* left-justifying text: \raggedright. (line 6)
@@ -18490,7 +18547,7 @@
* lengths, setting: \setlength. (line 6)
* leqno option: Document class options.
(line 49)
-* less than symbol, in text: Text symbols. (line 140)
+* less than symbol, in text: Text symbols. (line 142)
* lethead_flag: makeindex. (line 64)
* lethead_prefix: makeindex. (line 73)
* lethead_suffix: makeindex. (line 77)
@@ -18522,7 +18579,7 @@
* list of figures file: Output files. (line 43)
* list of tables file: Output files. (line 43)
* listings package: tabbing. (line 146)
-* listings package <1>: verbatim. (line 31)
+* listings package <1>: verbatim. (line 36)
* listings package <2>: \verb. (line 42)
* lists of items: itemize. (line 6)
* lists of items, generic: list. (line 6)
@@ -18542,7 +18599,7 @@
(line 6)
* lowercase: Upper and lower case.
(line 6)
-* LR box: picture. (line 89)
+* LR box: picture. (line 93)
* LR mode: Modes. (line 16)
* lrbox: lrbox. (line 6)
* lshort document: About this document. (line 50)
@@ -18551,7 +18608,7 @@
* LuaTeX: TeX engines. (line 33)
* LuaTeX, 256 output streams in: \write. (line 42)
* m-width: Units of length. (line 38)
-* macron accent: Accents. (line 34)
+* macron accent: Accents. (line 36)
* macron accent, math: Math accents. (line 14)
* macros2e package: \makeatletter & \makeatother.
(line 41)
@@ -18566,7 +18623,7 @@
* making a title page: titlepage. (line 6)
* making paragraphs: Making paragraphs. (line 6)
* marginal notes: Marginal notes. (line 6)
-* masculine ordinal symbol: Text symbols. (line 147)
+* masculine ordinal symbol: Text symbols. (line 149)
* matching brackets: \left & \right. (line 6)
* matching parentheses: \left & \right. (line 6)
* math accents: Math accents. (line 6)
@@ -18602,7 +18659,7 @@
* minipage environment: minipage. (line 6)
* minipage, creating a: minipage. (line 6)
* minted package: tabbing. (line 146)
-* minted package <1>: verbatim. (line 31)
+* minted package <1>: verbatim. (line 36)
* minted package <2>: \verb. (line 42)
* mirrors of CTAN: CTAN. (line 25)
* mm: Units of length. (line 27)
@@ -18650,7 +18707,7 @@
* oblique font: Font styles. (line 94)
* oe ligature: Additional Latin letters.
(line 48)
-* ogonek: Accents. (line 71)
+* ogonek: Accents. (line 73)
* old-style numerals: Font styles. (line 133)
* one-column output: \onecolumn. (line 6)
* onecolumn option: Document class options.
@@ -18684,14 +18741,14 @@
(line 6)
* options, package <1>: Class and package commands.
(line 66)
-* ordinals, feminine and masculine: Text symbols. (line 147)
+* ordinals, feminine and masculine: Text symbols. (line 149)
* oslash: Additional Latin letters.
(line 44)
* OT1: fontenc package. (line 6)
* outer paragraph mode: Modes. (line 47)
* output directory for all external files: Command line options.
- (line 55)
-* overbar accent: Accents. (line 34)
+ (line 48)
+* overbar accent: Accents. (line 36)
* overdot accent, math: Math accents. (line 26)
* overlining: Over- and Underlining.
(line 6)
@@ -18704,6 +18761,7 @@
* package options <1>: Class and package commands.
(line 66)
* package, abstract: abstract. (line 27)
+* package, adjustbox: Boxes. (line 9)
* package, algorithm2e: tabbing. (line 146)
* package, amscd: Arrows. (line 41)
* package, amsfonts: Math formulas. (line 86)
@@ -18731,7 +18789,7 @@
* package, array (package): array. (line 77)
* package, Asymptote: \line. (line 36)
* package, Asymptote <1>: \strut. (line 62)
-* package, Asymptote <2>: \mbox & \makebox. (line 73)
+* package, Asymptote <2>: \mbox & \makebox. (line 74)
* package, Asymptote <3>: \write18. (line 13)
* package, babel: \chapter. (line 71)
* package, babel <1>: thebibliography. (line 53)
@@ -18755,12 +18813,13 @@
* package, datatool: \read. (line 31)
* package, datetime: \today. (line 27)
* package, dcolumn: array. (line 77)
-* package, enumitem: itemize. (line 62)
+* package, enumitem: itemize. (line 66)
* package, enumitem <1>: list. (line 254)
* package, envlab: \makelabels. (line 55)
* package, etoolbox: Class and package commands.
(line 110)
* package, eurosym: Text symbols. (line 128)
+* package, eurosym <1>: Text symbols. (line 129)
* package, expl3: LaTeX command syntax.
(line 37)
* package, expl3 <1>: Upper and lower case.
@@ -18768,13 +18827,14 @@
* package, fancyhdr: Page styles. (line 12)
* package, fancyhdr <1>: \pagestyle. (line 13)
* package, fancyvrb: tabbing. (line 146)
-* package, fancyvrb <1>: verbatim. (line 37)
+* package, fancyvrb <1>: verbatim. (line 42)
* package, flafter: Floats. (line 82)
* package, float: Floats. (line 52)
* package, geometry: Document class options.
(line 40)
* package, geometry <1>: Document class options.
(line 44)
+* package, graphpap: \graphpaper. (line 11)
* package, grfext: \DeclareGraphicsExtensions.
(line 39)
* package, hyperref: \footnotemark. (line 48)
@@ -18791,7 +18851,7 @@
* package, index: \index. (line 101)
* package, latexsym: Arrows. (line 6)
* package, listings: tabbing. (line 146)
-* package, listings <1>: verbatim. (line 31)
+* package, listings <1>: verbatim. (line 36)
* package, listings <2>: \verb. (line 42)
* package, lmodern: fontenc package. (line 37)
* package, macros2e: \makeatletter & \makeatother.
@@ -18810,7 +18870,7 @@
* package, mhchem: Subscripts & superscripts.
(line 62)
* package, minted: tabbing. (line 146)
-* package, minted <1>: verbatim. (line 31)
+* package, minted <1>: verbatim. (line 36)
* package, minted <2>: \verb. (line 42)
* package, multind: Indexes. (line 32)
* package, pict2e: \line. (line 36)
@@ -18824,14 +18884,15 @@
(line 118)
* package, shellesc: \write18. (line 71)
* package, showidx: Indexes. (line 32)
-* package, siunitx: ~. (line 37)
+* package, siunitx: minipage. (line 136)
+* package, siunitx <1>: ~. (line 37)
* package, suffix: \@ifstar. (line 66)
* package, texosquery: \write18. (line 65)
* package, textcase: Upper and lower case.
(line 43)
* package, TikZ: \line. (line 36)
* package, TikZ <1>: \strut. (line 62)
-* package, TikZ <2>: \mbox & \makebox. (line 72)
+* package, TikZ <2>: \mbox & \makebox. (line 73)
* package, tikz-cd: Arrows. (line 41)
* package, titlesec: Sectioning. (line 60)
* package, titlesec <1>: \part. (line 54)
@@ -18847,8 +18908,8 @@
* package, ulem: Over- and Underlining.
(line 15)
* package, unicode-math: Greek letters. (line 37)
-* package, url: \verb. (line 38)
-* package, verbatimbox: verbatim. (line 37)
+* package, url: \verb. (line 39)
+* package, verbatimbox: verbatim. (line 42)
* package, xparse: LaTeX command syntax.
(line 37)
* package, xparse <1>: \@ifstar. (line 66)
@@ -18889,6 +18950,7 @@
* parentheses: Delimiters. (line 6)
* part: Sectioning. (line 6)
* part <1>: \part. (line 6)
+* pattern, current tab stops, tabbing: tabbing. (line 51)
* pc: Units of length. (line 14)
* PDF graphic files: \includegraphics. (line 6)
* pdflatex: TeX engines. (line 15)
@@ -18897,7 +18959,7 @@
* pdfTeX: Output files. (line 20)
* pdfTeX engine: TeX engines. (line 16)
* period, abbreviation-ending: \@. (line 6)
-* period, centered, in text: Text symbols. (line 150)
+* period, centered, in text: Text symbols. (line 152)
* period, sentence-ending: \@. (line 6)
* period, spacing after: \@. (line 6)
* pica: Units of length. (line 14)
@@ -18922,7 +18984,7 @@
* polyglossia package <3>: \index. (line 56)
* portrait orientation: Document class options.
(line 60)
-* position, in picture: picture. (line 60)
+* position, in picture: picture. (line 64)
* positional parameter: \newcommand & \renewcommand.
(line 54)
* postamble: makeindex. (line 54)
@@ -18938,12 +19000,12 @@
* pt: Units of length. (line 10)
* quad: Spacing in math mode.
(line 65)
-* question mark, upside-down: Text symbols. (line 153)
+* question mark, upside-down: Text symbols. (line 155)
* quotation environment: quotation & quote. (line 6)
* quotation marks, French: Text symbols. (line 33)
* quote environment: quotation & quote. (line 6)
-* quote, single straight: Text symbols. (line 168)
-* quote, straight base: Text symbols. (line 172)
+* quote, single straight: Text symbols. (line 170)
+* quote, straight base: Text symbols. (line 174)
* quoted text with paragraph indentation, displaying: quotation & quote.
(line 6)
* quoted text without paragraph indentation, displaying: quotation & quote.
@@ -18958,7 +19020,7 @@
(line 6)
* reference, forward: Cross references. (line 27)
* references, resolving forward: Output files. (line 33)
-* registered symbol: Text symbols. (line 175)
+* registered symbol: Text symbols. (line 177)
* relation, text above: \stackrel. (line 6)
* release candidates: TeX engines. (line 70)
* remarks in the margin: Marginal notes. (line 6)
@@ -18969,17 +19031,17 @@
* resizing <1>: \resizebox. (line 6)
* restricted shell access: \write18. (line 53)
* right angle quotation marks: Text symbols. (line 33)
-* right arrow, in text: Text symbols. (line 178)
+* right arrow, in text: Text symbols. (line 180)
* right brace, in text: Text symbols. (line 92)
* right quote: Text symbols. (line 58)
-* right quote, double: Text symbols. (line 159)
-* right quote, single: Text symbols. (line 165)
+* right quote, double: Text symbols. (line 161)
+* right quote, single: Text symbols. (line 167)
* right-hand equation numbers: Document class options.
(line 63)
* right-justifying text: \raggedleft. (line 6)
* right-justifying text, environment for: flushright. (line 6)
* rigid lengths: Lengths. (line 9)
-* ring accent: Accents. (line 75)
+* ring accent: Accents. (line 77)
* ring accent, math: Math accents. (line 35)
* robust commands: \protect. (line 6)
* roman font: Font styles. (line 85)
@@ -19027,18 +19089,19 @@
(line 52)
* shell access: \write18. (line 6)
* shell escape: Command line options.
- (line 68)
+ (line 61)
* SHELL, environment variables: \write18. (line 60)
* shellesc package: \write18. (line 71)
* showidx package: Indexes. (line 32)
* simulating typed text: verbatim. (line 6)
* single angle quotation marks: Text symbols. (line 33)
* single guillemets: Text symbols. (line 33)
-* single left quote: Text symbols. (line 162)
+* single left quote: Text symbols. (line 164)
* single low-9 quotation mark: Text symbols. (line 55)
-* single quote, straight: Text symbols. (line 168)
-* single right quote: Text symbols. (line 165)
-* siunitx package: ~. (line 37)
+* single quote, straight: Text symbols. (line 170)
+* single right quote: Text symbols. (line 167)
+* siunitx package: minipage. (line 136)
+* siunitx package <1>: ~. (line 37)
* sizes of text: Font sizes. (line 6)
* skip plain TeX: Lengths. (line 9)
* skip register, plain TeX: \newlength. (line 6)
@@ -19068,7 +19131,7 @@
* spacing, inter-sentence <1>: \normalsfcodes. (line 6)
* spacing, math mode: \phantom & \vphantom & \hphantom.
(line 6)
-* Spanish ordinals, feminine and masculine: Text symbols. (line 147)
+* Spanish ordinals, feminine and masculine: Text symbols. (line 149)
* special characters: Reserved characters. (line 6)
* special characters <1>: Additional Latin letters.
(line 6)
@@ -19087,9 +19150,9 @@
* starting on a right-hand page: \clearpage & \cleardoublepage.
(line 6)
* sterling symbol: Text symbols. (line 51)
-* straight double quote, base: Text symbols. (line 172)
-* straight quote, base: Text symbols. (line 172)
-* straight single quote: Text symbols. (line 168)
+* straight double quote, base: Text symbols. (line 174)
+* straight quote, base: Text symbols. (line 174)
+* straight single quote: Text symbols. (line 170)
* stretch, infinite horizontal: \hfill. (line 6)
* stretch, infinite vertical: \vfill. (line 6)
* stretch, omitting vertical: \raggedbottom. (line 6)
@@ -19166,14 +19229,14 @@
(line 6)
* thorn, Icelandic letter: Additional Latin letters.
(line 56)
-* three-quarters em-dash: Text symbols. (line 181)
+* three-quarters em-dash: Text symbols. (line 183)
* tie: ~. (line 6)
-* tie-after accent: Accents. (line 81)
+* tie-after accent: Accents. (line 83)
* TikZ package: \line. (line 36)
* TikZ package <1>: \strut. (line 62)
-* TikZ package <2>: \mbox & \makebox. (line 72)
+* TikZ package <2>: \mbox & \makebox. (line 73)
* tikz-cd package: Arrows. (line 41)
-* tilde accent: Accents. (line 46)
+* tilde accent: Accents. (line 48)
* tilde accent, math: Math accents. (line 38)
* tilde, ASCII, in text: Text symbols. (line 71)
* title page, separate or run-in: Document class options.
@@ -19205,12 +19268,12 @@
* topnumber <1>: Floats. (line 139)
* totalnumber: Floats. (line 142)
* totalnumber <1>: Floats. (line 143)
-* trademark symbol: Text symbols. (line 184)
+* trademark symbol: Text symbols. (line 186)
* transcript file: Output files. (line 28)
* TrueType fonts: TeX engines. (line 6)
* TS1 encoding: Text symbols. (line 6)
* two-column output: \twocolumn. (line 6)
-* two-thirds em-dash: Text symbols. (line 187)
+* two-thirds em-dash: Text symbols. (line 189)
* twocolumn option: Document class options.
(line 78)
* twoside option: Document class options.
@@ -19223,11 +19286,11 @@
* typewriter labels in lists: description. (line 36)
* ulem package: Over- and Underlining.
(line 15)
-* umlaut accent: Accents. (line 23)
-* underbar: Accents. (line 51)
+* umlaut accent: Accents. (line 25)
+* underbar: Accents. (line 53)
* underlining: Over- and Underlining.
(line 6)
-* underscore, in text: Text symbols. (line 190)
+* underscore, in text: Text symbols. (line 192)
* Unicode input, native: TeX engines. (line 6)
* unicode-math package: Greek letters. (line 37)
* units, of length: Units of length. (line 6)
@@ -19237,7 +19300,7 @@
* uplatex-dev: TeX engines. (line 68)
* uppercase: Upper and lower case.
(line 6)
-* url package: \verb. (line 38)
+* url package: \verb. (line 39)
* using BibTeX: Using BibTeX. (line 6)
* usrguide official documentation: About this document. (line 45)
* UTF-8, default LaTeX input encoding: Overview. (line 12)
@@ -19248,7 +19311,7 @@
* verbatim environment: verbatim. (line 6)
* verbatim text: verbatim. (line 6)
* verbatim text, inline: \verb. (line 6)
-* verbatimbox package: verbatim. (line 37)
+* verbatimbox package: verbatim. (line 42)
* verse environment: verse. (line 6)
* vertical bar, double, in text: Text symbols. (line 83)
* vertical bar, in text: Text symbols. (line 80)
@@ -19261,7 +19324,7 @@
(line 6)
* vertical spacing, math mode: \smash. (line 6)
* visible space: \verb. (line 31)
-* visible space symbol, in text: Text symbols. (line 193)
+* visible space symbol, in text: Text symbols. (line 195)
* weights, of fonts: Low-level font commands.
(line 58)
* whatsit item: \write. (line 65)
@@ -19289,532 +19352,533 @@
Tag Table:
-Node: Top1850
-Node: About this document3658
-Node: Overview5944
-Node: Starting and ending7724
-Ref: Starting & ending7859
-Node: Output files9036
-Ref: output files dvi9315
-Ref: output files pdf9826
-Ref: output files log10151
-Ref: output files aux10348
-Node: TeX engines11317
-Ref: tex engines latex11853
-Ref: tex engines lualatex12688
-Ref: tex engines xelatex13149
-Node: LaTeX command syntax15109
-Node: Environment17036
-Node: CTAN18263
-Node: Document classes19719
-Ref: document classes article20159
-Ref: document classes book20247
-Ref: document classes letter20432
-Ref: document classes report20508
-Ref: document classes slides20660
-Node: Document class options21113
-Node: Additional packages24195
-Node: Class and package construction24826
-Node: Class and package structure26276
-Node: Class and package commands28571
-Node: Fonts46176
-Ref: Typefaces46279
-Node: fontenc package48241
-Node: \DeclareFontEncoding52558
-Node: \DeclareTextAccent53976
-Node: \DeclareTextAccentDefault54833
-Node: \DeclareTextCommand & \ProvideTextCommand55904
-Node: \DeclareTextCommandDefault & \ProvideTextCommandDefault58138
-Node: \DeclareTextComposite59445
-Node: \DeclareTextCompositeCommand60532
-Node: \DeclareTextSymbol61207
-Node: \DeclareTextSymbolDefault62312
-Node: \LastDeclaredEncoding63266
-Node: \UseTextAccent & \UseTextSymbol63890
-Node: Font styles65098
-Node: Font sizes69330
-Node: Low-level font commands71555
-Ref: low level font commands fontencoding71839
-Ref: low level font commands fontfamily72395
-Ref: low level font commands fontseries73158
-Ref: low level font commands fontshape74310
-Ref: low level font commands fontsize74607
-Ref: low level font commands baselinestretch75132
-Ref: low level font commands linespread75841
-Ref: low level font commands selectfont76091
-Ref: low level font commands usefont76417
-Node: Layout76660
-Node: \onecolumn77158
-Node: \twocolumn77517
-Ref: twocolumn columnsep78140
-Ref: twocolumn columnseprule78389
-Ref: twocolumn columnwidth78685
-Ref: twocolumn dbltopfraction79251
-Ref: twocolumn dblfloatpagefraction80194
-Ref: twocolumn dblfloatsep80441
-Ref: twocolumn dbltextfloatsep80746
-Ref: twocolumn dbltopnumber80929
-Node: \flushbottom81894
-Node: \raggedbottom82994
-Node: Page layout parameters83530
-Ref: page layout parameters columnsep83733
-Ref: page layout parameters columnseprule83733
-Ref: page layout parameters columnwidth83733
-Ref: page layout parameters headheight83987
-Ref: page layout parameters headsep84154
-Ref: page layout parameters footskip84467
-Ref: page layout parameters linewidth84801
-Ref: page layout parameters marginparpush85154
-Ref: page layout parameters marginsep85154
-Ref: page layout parameters marginparwidth85154
-Ref: page layout parameters oddsidemargin86194
-Ref: page layout parameters evensidemargin86194
-Ref: page layout parameters paperheight86731
-Ref: page layout parameters paperwidth86957
-Ref: page layout parameters textheight87181
-Ref: page layout parameters textwidth87570
-Ref: page layout parameters hsize88499
-Ref: page layout parameters topmargin88705
-Ref: page layout parameters topskip89009
-Node: Floats89225
-Ref: floats bottomfraction93553
-Ref: floats floatpagefraction93680
-Ref: floats textfraction93791
-Ref: floats topfraction93993
-Ref: floats floatsep94245
-Ref: floats intextsep94355
-Ref: floats textfloatsep94570
-Ref: floats bottomnumber94834
-Ref: floats dbltopnumber94942
-Ref: floats topnumber95061
-Ref: floats totalnumber95165
-Node: Sectioning95707
-Ref: sectioning secnumdepth98816
-Ref: Sectioning/secnumdepth98816
-Ref: sectioning tocdepth99442
-Ref: Sectioning/tocdepth99442
-Node: \part100482
-Node: \chapter102659
-Node: \section106432
-Node: \subsection109699
-Node: \subsubsection & \paragraph & \subparagraph112413
-Node: \appendix115070
-Node: \frontmatter & \mainmatter & \backmatter116363
-Node: \@startsection117772
-Ref: startsection name119261
-Ref: \@startsection/name119261
-Ref: startsection level119715
-Ref: \@startsection/level119715
-Ref: startsection indent120596
-Ref: \@startsection/indent120596
-Ref: startsection beforeskip120859
-Ref: \@startsection/beforeskip120859
-Ref: startsection afterskip122380
-Ref: \@startsection/afterskip122380
-Ref: startsection style123691
-Ref: \@startsection/style123691
-Node: Cross references127392
-Node: \label129485
-Node: \pageref131305
-Node: \ref132095
-Node: Environments133071
-Node: abstract135073
-Node: array136662
-Node: center139554
-Node: \centering141307
-Node: description142804
-Node: displaymath145021
-Node: document146717
-Node: \AtBeginDocument147147
-Node: \AtEndDocument147771
-Node: enumerate148415
-Ref: enumerate enumi150278
-Ref: enumerate enumii150278
-Ref: enumerate enumiii150278
-Ref: enumerate enumiv150278
-Ref: enumerate labelenumi150676
-Ref: enumerate labelenumii150676
-Ref: enumerate labelenumiii150676
-Ref: enumerate labelenumiv150676
-Node: eqnarray151215
-Node: equation153211
-Node: figure153879
-Node: filecontents156033
-Node: flushleft157942
-Node: \raggedright158959
-Node: flushright160157
-Node: \raggedleft160893
-Node: itemize161683
-Ref: itemize labelitemi162905
-Ref: itemize labelitemii162905
-Ref: itemize labelitemiii162905
-Ref: itemize labelitemiv162905
-Ref: itemize leftmargin163747
-Ref: itemize leftmargini163747
-Ref: itemize leftmarginii163747
-Ref: itemize leftmarginiii163747
-Ref: itemize leftmarginiv163747
-Ref: itemize leftmarginv163747
-Ref: itemize leftmarginvi163747
-Node: letter165151
-Node: list165389
-Ref: list makelabel167836
-Ref: list itemindent169221
-Ref: list itemsep169358
-Ref: list labelsep170011
-Ref: list labelwidth170174
-Ref: list leftmargin171185
-Ref: list listparindent172038
-Ref: list parsep172269
-Ref: list partopsep172737
-Ref: list rightmargin173535
-Ref: list topsep173720
-Ref: list beginparpenalty177295
-Ref: list itempenalty177394
-Ref: list endparpenalty177498
-Node: \item178370
-Node: trivlist179616
-Node: math181144
-Node: minipage181450
-Node: picture186692
-Node: \put192721
-Node: \multiput193286
-Node: \qbezier194025
-Node: \graphpaper195510
-Node: \line196304
-Node: \linethickness198278
-Node: \thinlines198727
-Node: \thicklines199138
-Node: \circle199522
-Node: \oval200062
-Node: \shortstack201038
-Node: \vector202435
-Node: \makebox (picture)203349
-Node: \framebox (picture)204531
-Node: \frame206004
-Node: \dashbox206444
-Node: quotation & quote207579
-Node: tabbing208475
-Node: table214468
-Node: tabular216561
-Ref: tabular arrayrulewidth222890
-Ref: tabular arraystrech223130
-Ref: tabular doublerulesep223351
-Ref: tabular tabcolsep223487
-Node: \multicolumn224008
-Node: \vline227884
-Node: \cline229275
-Node: \hline229985
-Node: thebibliography230667
-Node: \bibitem233078
-Node: \cite235354
-Node: \nocite237109
-Node: Using BibTeX237593
-Node: theorem239748
-Node: titlepage240670
-Node: verbatim241953
-Node: \verb243463
-Node: verse245278
-Node: Line breaking246505
-Node: \\247871
-Node: \obeycr & \restorecr250304
-Node: \newline251115
-Node: \- (hyphenation)252144
-Node: \discretionary253782
-Node: \fussy & \sloppy254670
-Node: sloppypar255453
-Node: \hyphenation256599
-Node: \linebreak & \nolinebreak257193
-Node: Page breaking258341
-Node: \clearpage & \cleardoublepage260371
-Node: \newpage261891
-Node: \enlargethispage263189
-Node: \pagebreak & \nopagebreak264145
-Node: Footnotes265812
-Node: \footnote266958
-Ref: footnote footnoterule268226
-Ref: footnote footnotesep268837
-Node: \footnotemark269903
-Node: \footnotetext272242
-Node: Footnotes in section headings272844
-Node: Footnotes in a table273677
-Node: Footnotes of footnotes276599
-Node: Definitions277303
-Node: \newcommand & \renewcommand278279
-Node: \providecommand283580
-Node: \makeatletter & \makeatother284745
-Node: \@ifstar286847
-Node: \newcounter290332
-Node: \newlength292052
-Node: \newsavebox292874
-Node: \newenvironment & \renewenvironment293853
-Node: \newtheorem299177
-Node: \newfont302749
-Node: \protect303982
-Node: \ignorespaces & \ignorespacesafterend306370
-Node: Counters309108
-Node: \alph \Alph \arabic \roman \Roman \fnsymbol310809
-Node: \usecounter313434
-Node: \value314293
-Node: \setcounter315346
-Node: \addtocounter315942
-Node: \refstepcounter316396
-Node: \stepcounter317065
-Node: \day & \month & \year317618
-Node: Lengths318429
-Node: Units of length322908
-Ref: units of length pt323111
-Ref: units of length pc323211
-Ref: units of length in323234
-Ref: units of length bp323260
-Ref: units of length cm323391
-Ref: units of length mm323413
-Ref: units of length dd323435
-Ref: units of length cc323467
-Ref: units of length sp323492
-Ref: Lengths/em323523
-Ref: Lengths/en323523
-Ref: Lengths/ex323523
-Ref: units of length em323523
-Ref: units of length en323523
-Ref: units of length ex323523
-Node: \setlength324379
-Node: \addtolength325464
-Node: \settodepth326539
-Node: \settoheight327417
-Node: \settowidth328310
-Node: Making paragraphs329178
-Node: \par330949
-Node: \indent & \noindent332896
-Node: \parindent & \parskip334431
-Node: Marginal notes335716
-Ref: marginal notes marginparpush337112
-Ref: marginal notes marginparsep337225
-Ref: marginal notes marginparwidth337357
-Node: Math formulas337706
-Node: Subscripts & superscripts341874
-Node: Math symbols344035
-Node: Arrows367806
-Node: \boldmath & \unboldmath368994
-Node: Blackboard bold370513
-Node: Calligraphic371315
-Node: Delimiters371846
-Node: \left & \right374034
-Node: \bigl & \bigr etc.378042
-Node: Dots380795
-Ref: ellipses cdots381226
-Ref: ellipses ddots381371
-Ref: ellipses ldots381452
-Ref: ellipses vdots381869
-Node: Greek letters383053
-Node: Math functions384732
-Node: Math accents386376
-Node: Over- and Underlining387275
-Node: Spacing in math mode389102
-Ref: spacing in math mode thickspace390037
-Ref: spacing in math mode medspace390462
-Ref: Spacing in math mode/\thinspace390889
-Ref: spacing in math mode thinspace390889
-Ref: spacing in math mode negthinspace391370
-Ref: spacing in math mode quad391697
-Ref: spacing in math mode qquad391953
-Node: \smash392216
-Node: \phantom & \vphantom & \hphantom394433
-Node: Math miscellany396471
-Node: Colon character & \colon396977
-Node: \*397670
-Node: \frac398250
-Node: \sqrt398621
-Node: \stackrel399207
-Node: Modes399480
-Ref: modes paragraph mode399930
-Ref: modes lr mode400126
-Ref: modes math mode400732
-Ref: modes vertical mode401067
-Ref: modes internal vertical mode401238
-Ref: modes inner paragraph mode401711
-Ref: modes outer paragraph mode401711
-Node: \ensuremath402125
-Node: Page styles402830
-Node: \maketitle403593
-Node: \pagenumbering406611
-Node: \pagestyle408599
-Node: \thispagestyle412101
-Node: Spaces413055
-Node: \enspace & \quad & \qquad414496
-Node: \hspace415411
-Node: \hfill417249
-Node: \hss418313
-Node: \spacefactor419007
-Node: \@422394
-Ref: \AT422494
-Node: \frenchspacing424434
-Node: \normalsfcodes425269
-Node: \(SPACE)425516
-Node: ~427306
-Node: \thinspace & \negthinspace429883
-Node: \/431054
-Node: \hrulefill & \dotfill433010
-Node: \bigskip & \medskip & \smallskip434366
-Ref: bigskip435184
-Ref: medskip435388
-Ref: smallskip435597
-Node: \bigbreak & \medbreak & \smallbreak436258
-Node: \strut437244
-Node: \vspace440439
-Node: \vfill442003
-Node: \addvspace442931
-Node: Boxes444927
-Node: \mbox & \makebox445633
-Ref: mbox makebox depth446845
-Ref: mbox makebox height446845
-Ref: mbox makebox width446845
-Ref: mbox makebox totalheight446845
-Node: \fbox & \framebox448939
-Ref: fbox framebox fboxrule450253
-Ref: fbox framebox fboxsep450443
-Node: \parbox451533
-Node: \raisebox453839
-Ref: raisebox depth454802
-Ref: raisebox height454802
-Ref: raisebox width454802
-Ref: raisebox totalheight454802
-Node: \sbox & \savebox455516
-Node: lrbox458483
-Node: \usebox459306
-Node: Color459713
-Node: Color package options460512
-Node: Color models462158
-Ref: color models cmyk462955
-Ref: color models gray463318
-Ref: color models rgb463467
-Ref: color models RGB463804
-Ref: color models named464179
-Node: Commands for color464467
-Node: Define colors464882
-Node: Colored text465607
-Node: Colored boxes468004
-Node: Colored pages469393
-Node: Graphics470086
-Node: Graphics package options472213
-Node: Graphics package configuration474966
-Node: \graphicspath475768
-Node: \DeclareGraphicsExtensions478726
-Node: \DeclareGraphicsRule480544
-Node: Commands for graphics483725
-Node: \includegraphics484230
-Ref: includegraphics width489284
-Ref: includegraphics height489817
-Ref: includegraphics totalheight490223
-Ref: includegraphics keepaspectratio490487
-Ref: includegraphics viewport492173
-Ref: includegraphics trim492568
-Ref: includegraphics clip493024
-Ref: includegraphics page493284
-Ref: includegraphics pagebox493375
-Ref: includegraphics interpolate494240
-Ref: includegraphics quiet494445
-Ref: includegraphics draft494606
-Ref: includegraphics bb495411
-Ref: includegraphics bbllx495809
-Ref: includegraphics bblly495809
-Ref: includegraphics bburx495809
-Ref: includegraphics bbury495809
-Ref: includegraphics natwidth495951
-Ref: includegraphics natheight495951
-Ref: includegraphics hiresbb496137
-Ref: includegraphics type496899
-Ref: includegraphics ext496939
-Ref: includegraphics read497042
-Ref: includegraphics command497159
-Node: \rotatebox497405
-Node: \scalebox500259
-Node: \resizebox501315
-Node: Special insertions502507
-Node: Reserved characters503309
-Node: Upper and lower case504569
-Node: Symbols by font position506955
-Node: Text symbols507634
-Node: Accents511814
-Node: \accent513922
-Node: Additional Latin letters515689
-Ref: Non-English characters515860
-Node: \rule516879
-Node: \today518052
-Node: Splitting the input518988
-Node: \endinput520730
-Node: \include & \includeonly522033
-Node: \input526330
-Node: Front/back matter527545
-Node: Table of contents etc.527878
-Node: \addcontentsline531703
-Node: \addtocontents534545
-Node: \nofiles536136
-Node: Indexes536868
-Node: \index538476
-Node: makeindex543581
-Ref: makeindex preamble545249
-Ref: makeindex postamble545389
-Ref: makeindex group skip545474
-Ref: makeindex letheadflag545807
-Ref: makeindex lethead prefix546268
-Ref: makeindex lethead suffix546420
-Ref: makeindex item 0546568
-Ref: makeindex item 1546648
-Ref: makeindex item 2546723
-Ref: makeindex item 01546801
-Ref: makeindex item x1546906
-Ref: makeindex item 12547111
-Ref: makeindex item x2547219
-Ref: makeindex delim 0547379
-Ref: makeindex delim 1547509
-Ref: makeindex delim 2547639
-Ref: makeindex delim n547765
-Ref: makeindex delim r547900
-Ref: makeindex line max548008
-Ref: makeindex indent space548143
-Ref: makeindex indent length548238
-Ref: makeindex page precedence548423
-Node: \printindex549297
-Node: Glossaries549770
-Node: \newglossaryentry551737
-Node: \gls553204
-Node: Letters553998
-Node: \address557616
-Node: \cc558427
-Node: \closing558869
-Node: \encl559183
-Node: \location559597
-Node: \makelabels559861
-Node: \name562178
-Node: \opening562419
-Node: \ps562700
-Node: \signature562989
-Node: \telephone564217
-Node: Input/output564582
-Node: \openin & \openout565312
-Node: \read568055
-Node: \typein569242
-Node: \typeout570502
-Node: \write571552
-Node: \write and security576279
-Node: \message577223
-Node: \wlog579052
-Node: \write18579553
-Node: Command line interface583044
-Ref: Command line583208
-Node: Command line options585227
-Ref: interaction modes586223
-Ref: output directory587622
-Node: Command line input589321
-Node: Recovering from errors591207
-Node: Document templates592563
-Node: beamer template592997
-Node: article template593639
-Node: book template594102
-Node: Larger book template594581
-Node: Index596123
-Ref: Command Index596209
+Node: Top1847
+Node: About this document3652
+Node: Overview5938
+Node: Starting and ending7718
+Ref: Starting & ending7853
+Node: Output files9030
+Ref: output files dvi9309
+Ref: output files pdf9821
+Ref: output files log10146
+Ref: output files aux10343
+Node: TeX engines11312
+Ref: tex engines latex11848
+Ref: tex engines lualatex12683
+Ref: tex engines xelatex13144
+Node: LaTeX command syntax15104
+Node: Environment17031
+Node: CTAN18258
+Node: Document classes19714
+Ref: document classes article20154
+Ref: document classes book20242
+Ref: document classes letter20427
+Ref: document classes report20503
+Ref: document classes slides20655
+Node: Document class options21108
+Node: Additional packages24190
+Node: Class and package construction24821
+Node: Class and package structure26271
+Node: Class and package commands28566
+Node: Fonts46171
+Ref: Typefaces46274
+Node: fontenc package48236
+Node: \DeclareFontEncoding52553
+Node: \DeclareTextAccent53971
+Node: \DeclareTextAccentDefault54828
+Node: \DeclareTextCommand & \ProvideTextCommand55899
+Node: \DeclareTextCommandDefault & \ProvideTextCommandDefault58133
+Node: \DeclareTextComposite59440
+Node: \DeclareTextCompositeCommand60527
+Node: \DeclareTextSymbol61202
+Node: \DeclareTextSymbolDefault62307
+Node: \LastDeclaredEncoding63261
+Node: \UseTextAccent & \UseTextSymbol63885
+Node: Font styles65093
+Node: Font sizes69325
+Node: Low-level font commands71550
+Ref: low level font commands fontencoding71834
+Ref: low level font commands fontfamily72390
+Ref: low level font commands fontseries73153
+Ref: low level font commands fontshape74305
+Ref: low level font commands fontsize74602
+Ref: low level font commands baselinestretch75127
+Ref: low level font commands linespread75836
+Ref: low level font commands selectfont76086
+Ref: low level font commands usefont76412
+Node: Layout76655
+Node: \onecolumn77153
+Node: \twocolumn77512
+Ref: twocolumn columnsep78135
+Ref: twocolumn columnseprule78379
+Ref: twocolumn columnwidth78679
+Ref: twocolumn dbltopfraction79262
+Ref: twocolumn dblfloatpagefraction80228
+Ref: twocolumn dblfloatsep80466
+Ref: twocolumn dbltextfloatsep80775
+Ref: twocolumn dbltopnumber80955
+Node: \flushbottom81904
+Node: \raggedbottom83004
+Node: Page layout parameters83540
+Ref: page layout parameters columnsep83743
+Ref: page layout parameters columnseprule83743
+Ref: page layout parameters columnwidth83743
+Ref: page layout parameters headheight83997
+Ref: page layout parameters headsep84164
+Ref: page layout parameters footskip84476
+Ref: page layout parameters linewidth84810
+Ref: page layout parameters marginparpush85163
+Ref: page layout parameters marginsep85163
+Ref: page layout parameters marginparwidth85163
+Ref: page layout parameters oddsidemargin86203
+Ref: page layout parameters evensidemargin86203
+Ref: page layout parameters paperheight86748
+Ref: page layout parameters paperwidth86974
+Ref: page layout parameters textheight87198
+Ref: page layout parameters textwidth87587
+Ref: page layout parameters hsize88525
+Ref: page layout parameters topmargin88722
+Ref: page layout parameters topskip89026
+Node: Floats89242
+Ref: floats bottomfraction93570
+Ref: floats floatpagefraction93697
+Ref: floats textfraction93808
+Ref: floats topfraction94010
+Ref: floats floatsep94262
+Ref: floats intextsep94372
+Ref: floats textfloatsep94587
+Ref: floats bottomnumber94851
+Ref: floats dbltopnumber94959
+Ref: floats topnumber95078
+Ref: floats totalnumber95182
+Node: Sectioning95724
+Ref: sectioning secnumdepth98833
+Ref: Sectioning/secnumdepth98833
+Ref: sectioning tocdepth99459
+Ref: Sectioning/tocdepth99459
+Node: \part100499
+Node: \chapter102676
+Node: \section106449
+Node: \subsection109716
+Node: \subsubsection & \paragraph & \subparagraph112430
+Node: \appendix115087
+Node: \frontmatter & \mainmatter & \backmatter116380
+Node: \@startsection117789
+Ref: startsection name119278
+Ref: \@startsection/name119278
+Ref: startsection level119732
+Ref: \@startsection/level119732
+Ref: startsection indent120613
+Ref: \@startsection/indent120613
+Ref: startsection beforeskip120876
+Ref: \@startsection/beforeskip120876
+Ref: startsection afterskip122397
+Ref: \@startsection/afterskip122397
+Ref: startsection style123708
+Ref: \@startsection/style123708
+Node: Cross references127409
+Node: \label129502
+Node: \pageref131322
+Node: \ref132112
+Node: Environments133088
+Node: abstract135090
+Node: array136679
+Node: center139571
+Node: \centering141324
+Node: description142821
+Node: displaymath145038
+Node: document146734
+Node: \AtBeginDocument147164
+Node: \AtEndDocument147788
+Node: enumerate148432
+Ref: enumerate enumi150295
+Ref: enumerate enumii150295
+Ref: enumerate enumiii150295
+Ref: enumerate enumiv150295
+Ref: enumerate labelenumi150693
+Ref: enumerate labelenumii150693
+Ref: enumerate labelenumiii150693
+Ref: enumerate labelenumiv150693
+Node: eqnarray151232
+Node: equation153228
+Node: figure153896
+Node: filecontents156050
+Node: flushleft157959
+Node: \raggedright158986
+Node: flushright160184
+Node: \raggedleft161008
+Node: itemize161879
+Ref: itemize labelitemi163427
+Ref: itemize labelitemii163427
+Ref: itemize labelitemiii163427
+Ref: itemize labelitemiv163427
+Ref: itemize leftmargin164090
+Ref: itemize leftmargini164090
+Ref: itemize leftmarginii164090
+Ref: itemize leftmarginiii164090
+Ref: itemize leftmarginiv164090
+Ref: itemize leftmarginv164090
+Ref: itemize leftmarginvi164090
+Node: letter165572
+Node: list165810
+Ref: list makelabel168257
+Ref: list itemindent169642
+Ref: list itemsep169779
+Ref: list labelsep170432
+Ref: list labelwidth170595
+Ref: list leftmargin171606
+Ref: list listparindent172459
+Ref: list parsep172690
+Ref: list partopsep173158
+Ref: list rightmargin173956
+Ref: list topsep174141
+Ref: list beginparpenalty177716
+Ref: list itempenalty177815
+Ref: list endparpenalty177919
+Node: \item178790
+Node: trivlist180036
+Node: math181564
+Node: minipage181870
+Node: picture187385
+Node: \put193606
+Node: \multiput194171
+Node: \qbezier194910
+Node: \graphpaper196383
+Node: \line197177
+Node: \linethickness199151
+Node: \thinlines199600
+Node: \thicklines200011
+Node: \circle200395
+Node: \oval200937
+Node: \shortstack201913
+Node: \vector203310
+Node: \makebox (picture)204224
+Node: \framebox (picture)205406
+Node: \frame206879
+Node: \dashbox207319
+Node: quotation & quote208454
+Node: tabbing209350
+Node: table215253
+Node: tabular217317
+Ref: tabular arrayrulewidth223654
+Ref: tabular arraystrech223894
+Ref: tabular doublerulesep224115
+Ref: tabular tabcolsep224251
+Node: \multicolumn224772
+Node: \vline228648
+Node: \cline230039
+Node: \hline230749
+Node: thebibliography231431
+Node: \bibitem233914
+Node: \cite236208
+Node: \nocite238076
+Node: Using BibTeX238584
+Node: theorem240755
+Node: titlepage241677
+Node: verbatim242960
+Node: \verb244773
+Node: verse246866
+Node: Line breaking248093
+Node: \\249459
+Node: \obeycr & \restorecr251892
+Node: \newline252703
+Node: \- (hyphenation)253732
+Node: \discretionary255370
+Node: \fussy & \sloppy256258
+Node: sloppypar257041
+Node: \hyphenation258187
+Node: \linebreak & \nolinebreak258781
+Node: Page breaking259929
+Node: \clearpage & \cleardoublepage261959
+Node: \newpage263479
+Node: \enlargethispage264777
+Node: \pagebreak & \nopagebreak265733
+Node: Footnotes267400
+Node: \footnote268546
+Ref: footnote footnoterule269814
+Ref: footnote footnotesep270425
+Node: \footnotemark271491
+Node: \footnotetext273830
+Node: Footnotes in section headings274432
+Node: Footnotes in a table275265
+Node: Footnotes of footnotes278187
+Node: Definitions278891
+Node: \newcommand & \renewcommand279867
+Node: \providecommand285168
+Node: \makeatletter & \makeatother286333
+Node: \@ifstar288435
+Node: \newcounter291920
+Node: \newlength293640
+Node: \newsavebox294462
+Node: \newenvironment & \renewenvironment295441
+Node: \newtheorem300765
+Node: \newfont304337
+Node: \protect305570
+Node: \ignorespaces & \ignorespacesafterend307958
+Node: Counters310696
+Node: \alph \Alph \arabic \roman \Roman \fnsymbol312397
+Node: \usecounter315022
+Node: \value315881
+Node: \setcounter316934
+Node: \addtocounter317530
+Node: \refstepcounter317984
+Node: \stepcounter318653
+Node: \day & \month & \year319206
+Node: Lengths320017
+Node: Units of length324496
+Ref: units of length pt324699
+Ref: units of length pc324799
+Ref: units of length in324822
+Ref: units of length bp324848
+Ref: units of length cm324979
+Ref: units of length mm325001
+Ref: units of length dd325023
+Ref: units of length cc325055
+Ref: units of length sp325080
+Ref: Lengths/em325111
+Ref: Lengths/en325111
+Ref: Lengths/ex325111
+Ref: units of length em325111
+Ref: units of length en325111
+Ref: units of length ex325111
+Node: \setlength325967
+Node: \addtolength327052
+Node: \settodepth328127
+Node: \settoheight329005
+Node: \settowidth329898
+Node: Making paragraphs330766
+Node: \par332537
+Node: \indent & \noindent334484
+Node: \parindent & \parskip336019
+Node: Marginal notes337326
+Ref: marginal notes marginparpush338722
+Ref: marginal notes marginparsep338896
+Ref: marginal notes marginparwidth339028
+Node: Math formulas339377
+Node: Subscripts & superscripts343545
+Node: Math symbols345706
+Node: Arrows369477
+Node: \boldmath & \unboldmath370665
+Node: Blackboard bold372184
+Node: Calligraphic372986
+Node: Delimiters373517
+Node: \left & \right375705
+Node: \bigl & \bigr etc.379713
+Node: Dots382466
+Ref: ellipses cdots382897
+Ref: ellipses ddots383042
+Ref: ellipses ldots383123
+Ref: ellipses vdots383540
+Node: Greek letters384724
+Node: Math functions386403
+Node: Math accents388047
+Node: Over- and Underlining388946
+Node: Spacing in math mode390773
+Ref: spacing in math mode thickspace391708
+Ref: spacing in math mode medspace392133
+Ref: Spacing in math mode/\thinspace392560
+Ref: spacing in math mode thinspace392560
+Ref: spacing in math mode negthinspace393041
+Ref: spacing in math mode quad393368
+Ref: spacing in math mode qquad393624
+Node: \smash393887
+Node: \phantom & \vphantom & \hphantom396104
+Node: Math miscellany398142
+Node: Colon character & \colon398648
+Node: \*399341
+Node: \frac399921
+Node: \sqrt400292
+Node: \stackrel400878
+Node: Modes401151
+Ref: modes paragraph mode401601
+Ref: modes lr mode401797
+Ref: modes math mode402403
+Ref: modes vertical mode402738
+Ref: modes internal vertical mode402909
+Ref: modes inner paragraph mode403382
+Ref: modes outer paragraph mode403382
+Node: \ensuremath403796
+Node: Page styles404501
+Node: \maketitle405264
+Node: \pagenumbering408282
+Node: \pagestyle410270
+Node: \thispagestyle413772
+Node: Spaces414726
+Node: \enspace & \quad & \qquad416167
+Node: \hspace417082
+Node: \hfill418920
+Node: \hss419984
+Node: \spacefactor420678
+Node: \@424065
+Ref: \AT424165
+Node: \frenchspacing426105
+Node: \normalsfcodes426940
+Node: \(SPACE)427187
+Node: ~428977
+Node: \thinspace & \negthinspace431554
+Node: \/432725
+Node: \hrulefill & \dotfill434681
+Node: \bigskip & \medskip & \smallskip436037
+Ref: bigskip436855
+Ref: medskip437059
+Ref: smallskip437268
+Node: \bigbreak & \medbreak & \smallbreak437929
+Node: \strut438915
+Node: \vspace442110
+Node: \vfill443674
+Node: \addvspace444602
+Node: Boxes446598
+Node: \mbox & \makebox447304
+Ref: mbox makebox depth448572
+Ref: mbox makebox height448572
+Ref: mbox makebox width448572
+Ref: mbox makebox totalheight448572
+Node: \fbox & \framebox450667
+Ref: fbox framebox fboxrule451981
+Ref: fbox framebox fboxsep452171
+Node: \parbox453261
+Node: \raisebox455567
+Ref: raisebox depth456540
+Ref: raisebox height456540
+Ref: raisebox width456540
+Ref: raisebox totalheight456540
+Node: \sbox & \savebox457241
+Node: lrbox460303
+Node: \usebox461189
+Node: Color461628
+Node: Color package options462427
+Node: Color models464073
+Ref: color models cmyk464870
+Ref: color models gray465233
+Ref: color models rgb465382
+Ref: color models RGB465719
+Ref: color models named466094
+Node: Commands for color466382
+Node: Define colors466797
+Node: Colored text467522
+Node: Colored boxes469919
+Node: Colored pages471308
+Node: Graphics472001
+Node: Graphics package options474128
+Node: Graphics package configuration476881
+Node: \graphicspath477683
+Node: \DeclareGraphicsExtensions480641
+Node: \DeclareGraphicsRule482459
+Node: Commands for graphics485640
+Node: \includegraphics486145
+Ref: includegraphics width491199
+Ref: includegraphics height491732
+Ref: includegraphics totalheight492138
+Ref: includegraphics keepaspectratio492402
+Ref: includegraphics viewport494088
+Ref: includegraphics trim494483
+Ref: includegraphics clip494939
+Ref: includegraphics page495199
+Ref: includegraphics pagebox495290
+Ref: includegraphics interpolate496155
+Ref: includegraphics quiet496360
+Ref: includegraphics draft496521
+Ref: includegraphics bb497326
+Ref: includegraphics bbllx497724
+Ref: includegraphics bblly497724
+Ref: includegraphics bburx497724
+Ref: includegraphics bbury497724
+Ref: includegraphics natwidth497866
+Ref: includegraphics natheight497866
+Ref: includegraphics hiresbb498052
+Ref: includegraphics type498814
+Ref: includegraphics ext498854
+Ref: includegraphics read498957
+Ref: includegraphics command499074
+Node: \rotatebox499320
+Node: \scalebox502174
+Node: \resizebox503230
+Node: Special insertions504422
+Node: Reserved characters505224
+Node: Upper and lower case506484
+Node: Symbols by font position508870
+Node: Text symbols509549
+Node: Accents513734
+Node: \accent515887
+Node: Additional Latin letters517654
+Ref: Non-English characters517825
+Node: \rule518844
+Node: \today520017
+Node: Splitting the input520953
+Node: \endinput522695
+Node: \include & \includeonly523998
+Node: \input528295
+Node: Front/back matter529510
+Node: Table of contents etc.529843
+Node: \addcontentsline533668
+Node: \addtocontents536510
+Node: \nofiles538101
+Node: Indexes538833
+Node: \index540441
+Node: makeindex545546
+Ref: makeindex preamble547214
+Ref: makeindex postamble547354
+Ref: makeindex group skip547439
+Ref: makeindex letheadflag547772
+Ref: makeindex lethead prefix548233
+Ref: makeindex lethead suffix548385
+Ref: makeindex item 0548533
+Ref: makeindex item 1548613
+Ref: makeindex item 2548688
+Ref: makeindex item 01548766
+Ref: makeindex item x1548871
+Ref: makeindex item 12549076
+Ref: makeindex item x2549184
+Ref: makeindex delim 0549344
+Ref: makeindex delim 1549474
+Ref: makeindex delim 2549604
+Ref: makeindex delim n549730
+Ref: makeindex delim r549865
+Ref: makeindex line max549973
+Ref: makeindex indent space550108
+Ref: makeindex indent length550203
+Ref: makeindex page precedence550388
+Node: \printindex551262
+Node: Glossaries551735
+Node: \newglossaryentry553702
+Node: \gls555169
+Node: Letters555963
+Node: \address559581
+Node: \cc560392
+Node: \closing560834
+Node: \encl561148
+Node: \location561562
+Node: \makelabels561826
+Node: \name564143
+Node: \opening564384
+Node: \ps564665
+Node: \signature564954
+Node: \telephone566182
+Node: Input/output566547
+Node: \openin & \openout567277
+Node: \read570020
+Node: \typein571207
+Node: \typeout572467
+Node: \write573517
+Node: \write and security578244
+Node: \message579188
+Node: \wlog581017
+Node: \write18581518
+Node: Command line interface585009
+Ref: Command line585173
+Node: Command line options587256
+Ref: interaction modes588252
+Ref: output directory589206
+Node: Command line input590905
+Node: Jobname592734
+Node: Recovering from errors593549
+Node: Document templates594894
+Node: beamer template595328
+Node: article template595970
+Node: book template596433
+Node: Larger book template596912
+Node: Index598454
+Ref: Command Index598540
End Tag Table
Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2021-04-22 16:44:32 UTC (rev 902)
+++ trunk/latex2e.texi 2021-04-29 21:51:35 UTC (rev 903)
@@ -7775,10 +7775,10 @@
@end example
@noindent
-produces output like @samp{... source is [1]}. (You can change the
-appearance of the citation and of the refernece by using bibliography
+produces output like @samp{... source is [1]}. You can change the
+appearance of the citation and of the reference by using bibliography
styles if you generate automatically the @code{thebibliography}
-environment. More is in @ref{Using BibTeX}.)
+environment. More information in @ref{Using BibTeX}.
The optional argument @var{subcite} is appended to the citation. For
example, @code{See 14.3 in \cite[p.~314]@{texbook@}} might produce
@@ -17660,14 +17660,17 @@
@PkgIndex{babel}
@PkgIndex{polyglossia}
@cindex multilingual support
- at LaTeX{} has wide support for many of the world's scripts and languages,
-through the @code{babel} package and related support if you are using
-pdf at LaTeX{}, or @file{polyglossia} if you are using Xe at LaTeX{} or
-Lua at LaTeX{}. This section does not cover that support. It only lists
-the core @LaTeX{} commands for creating accented characters. The
- at code{\capital...} commands shown here produce alternative forms for use
-with capital letters. These are not available with OT1.
+ at LaTeX{} has wide support for many of the world's scripts and
+languages, provided through the core @code{babel} package, which
+supports pdf at LaTeX{}, Xe at LaTeX{} and Lua at LaTeX{}. The
+ at file{polyglossia} package provides similar support with the latter
+two engines.
+This section does not cover that support. It only lists the core
+ at LaTeX{} commands for creating accented characters. The
+ at code{\capital...} commands shown here produce alternative forms for
+use with capital letters. These are not available with OT1.
+
Below, to make them easier to find, the accents are all illustrated with
lowercase @samp{o}.
@@ -20586,63 +20589,63 @@
@noindent
so the graphic files are read for their bounding box size information
-but raplaced in the PDF by a box with same size and that contains only
+but replaced in the PDF by a box with same size and that contains only
the file name, which speeds up compilation time and saves printer ink.
@c xx TODO translate the following
@ignore
-Un autre exemple classique est de cribler certains chapitres à la
-compilation en les passant à @code{\includeonly} dans la ligne de
-commande. Ainsi, supposons qu'on a un fichier racine @file{livre.tex}
-ainsi formé :
-
- at example
-\documentclass@{book@}
-\begin@{document@}
-\frontmatter
-\include@{pref@}
-\mainmatter
-\include@{chap1@}
-\include@{chap2@}
-\appendix
-\include@{append@}
-\backmatter
-\include@{bib@}
-\end@{document@}
- at end example
-
-En compilant @file{livre.tex} avec la ligne de commande suivante :
-
- at example
-pdflatex '\includeonly@{chap1@}\input@{livre@}
- at end example
-
- at noindent
-seul le chapitre contenu dans @file{chap1.tex} sera produit en
-sortie. @xref{Splitting the input}.
-
-Dans ce dernier exemple, on force la date au 14 juillet 1789 :
-
- at example
-pdflatex '\day=14 \month=7 \year=1789 \input revolution'
- at end example
-
-Ainsi, si le fichier @file{revolution.tex} contient ceci :
-
- at example
-\documentclass[french]@{minimal@}
-\usepackage@{babel@}
-\begin@{document@}
-\today\ c'est la révolution !
-\end@{document@}
- at end example
-
- at noindent
-alors vous aurez en sortie un truc du genre :
-
- at example
-14 juillet 1789 c'est la révolution !
- at end example
+ at c Un autre exemple classique est de cribler certains chapitres à la
+ at c compilation en les passant à @code{\includeonly} dans la ligne de
+ at c commande. Ainsi, supposons qu'on a un fichier racine @file{livre.tex}
+ at c ainsi formé :
+ at c
+ at c @example
+ at c \documentclass@{book@}
+ at c \begin@{document@}
+ at c \frontmatter
+ at c \include@{pref@}
+ at c \mainmatter
+ at c \include@{chap1@}
+ at c \include@{chap2@}
+ at c \appendix
+ at c \include@{append@}
+ at c \backmatter
+ at c \include@{bib@}
+ at c \end@{document@}
+ at c @end example
+ at c
+ at c En compilant @file{livre.tex} avec la ligne de commande suivante :
+ at c
+ at c @example
+ at c pdflatex '\includeonly@{chap1@}\input@{livre@}
+ at c @end example
+ at c
+ at c @noindent
+ at c seul le chapitre contenu dans @file{chap1.tex} sera produit en
+ at c sortie. @xref{Splitting the input}.
+ at c
+ at c Dans ce dernier exemple, on force la date au 14 juillet 1789 :
+ at c
+ at c @example
+ at c pdflatex '\day=14 \month=7 \year=1789 \input revolution'
+ at c @end example
+ at c
+ at c Ainsi, si le fichier @file{revolution.tex} contient ceci :
+ at c
+ at c @example
+ at c \documentclass[french]@{minimal@}
+ at c \usepackage@{babel@}
+ at c \begin@{document@}
+ at c \today\ c'est la révolution !
+ at c \end@{document@}
+ at c @end example
+ at c
+ at c @noindent
+ at c alors vous aurez en sortie un truc du genre :
+ at c
+ at c @example
+ at c 14 juillet 1789 c'est la révolution !
+ at c @end example
@end ignore
@node Jobname
@@ -20669,90 +20672,90 @@
@c xx French version below:
@ignore
- at node Jobname
-
-Quand vous exécutez @code{@command{pdflatex} @var{options}
- at var{argument}}, si @var{argument} ne commence pas par une contr'oblique
-alors @TeX{} considère que c'est le nom du fichier racine à lire en
-entrée. Le nom du fichier racine, sans l'extension @file{.tex} si elle
-est donnée, définit alors le @dfn{nom d'ouvrage}, celui-ci est utilisé pour
-nommer le fichier journal et le fichier de sortie.
-
-Autrement, si @var{argument} commence par une contr'oblique, il attend
-la première instruction @code{\input} et le nom du fichier en entrée
-devient le nom d'ouvrage.
-
-Au sein du document, la variable @code{\jobname} se développe dans le
-nom d'ouvrage, avec la particularité que tous les caractères sont de
-catcode 11 (lettre). Ainsi, si vous voulez utilisez le nom d'ouvrage
-comme une condition, la solution la plus simple est d'utiliser une macro
-de text du paquetage @file{xtring} dans sa variante étoilée pour être
-insensible au catcode. Dans le texte suivant par exemple, la note en bas
-de page « dont la Respublica Bananensis Francorum. » n'est présente que
-si le nom de tâche commence par @file{moi-meme}.
-
- at example
-Si une démocratie est juste un régime où les citoyens votent alors
-toutes les républiques bananières\IfBeginWith*@{\jobname@}@{moi-meme@}%
-@{\footnote@{dont la Respublica Bananensis Francorum.@}@}@{@} sont des
-démocraties.
- at end example
-
-Cela ne fonctionnerait pas si la version non étoilée de
- at code{\IfBeginWith} était utilisée, parce que le @code{-} dans
- at samp{moi-meme} a un catcode 12, alors que dans @code{\jobname}, s'il
-s'y trouve, il a nécessairement un catcode 11.
-
-Dans certains cas il peut être utile de fixer le nom de tâche à une
-autre valeur que celle par défaut, l'option @code{--jobname} permet de
-faire cela, elle l'emporte sur le premier @code{\input} et spécifie
-directement le nom. @xref{Command line input}, pour un exemple d'usage,
-où l'on génère deux fichiers @file{etudiants.pdf} et
- at file{professeurs.pdf} à partir d'un même code source @file{principal.tex}.
-
-En l'absence d'option @code{--jobname}, la valeur initiale de
- at code{\jobname} est @code{texput}, de sorte que si la compilation
-s'arrête avant le premier @code{\input}, le journal produit sera nommé
- at file{texput.log}. Par exemple la commande suivante :
-
- at example
-pdflatex "\nonstopmode\errmessage@{\string\jobname\space vaut \jobname@}"
- at end example
-
-produira un journal @file{textput.log} contenant le message d'erreur
- at samp{! \jobname vaut texput.}.
-
-Attention, le nom de tâche est également forcé à @file{texput} si le
-premier @code{\input} est indirectement appelé par @code{\documentclass}
-ou @code{\RequirePackage}. Ainsi l'exemple suivant produira un fichier
-nommé @file{texput.pdf} avec une version raisonnablement récente de
- at LaTeX{} :
-
- at example
-pdflatex "\documentclass@{minimal@}\begin@{document@}Bonjour !\end@{document@}"
- at end example
-
-mais avec une version plus ancienne le fichier de sortie se serait nommé
- at file{minimal.pdf}, parce que le premier @code{\input} appelé
-indirectement par @code{\documentclass} aurait été traité de la même
-façon que s'il chargeait le fichier source racine.
-
-Voici un autre exemple de cela, ici on reprend l'exemple donné dans
- at ref{Command line input} où l'on passe sur la ligne de commande l'option
- at code{draft} au paquetage @file{graphicx}. Mais au lieu de le faire avec
- at code{\PassOptionToPackage}, on le fait avec @code{\RequirePackage}, ce
-qui a également pour effet que le paquetage @file{graphicx} sera chargé
-en premier, si ce n'était pas déjà le cas.
-
- at c credit Herbert Voss: https://tex.stackexchange.com/a/17236/121234
- at example
-pdflatex --jobname=aa "\RequirePackage[draft]@{graphicx@}\input@{aa.tex@}"
- at end example
-
-L'option @code{--jobname=aa} est nécessaire, car elle garantit que le
-fichier de sortie se nommera bien @file{aa.pdf}, et non
- at file{texput.pdf} avec une version récente de @LaTeX{}, ni
- at file{graphicx.pdf} avec une version plus ancienne.
+ at c @node Jobname
+ at c
+ at c Quand vous exécutez @code{@command{pdflatex} @var{options}
+ at c @var{argument}}, si @var{argument} ne commence pas par une contr'oblique
+ at c alors @TeX{} considère que c'est le nom du fichier racine à lire en
+ at c entrée. Le nom du fichier racine, sans l'extension @file{.tex} si elle
+ at c est donnée, définit alors le @dfn{nom d'ouvrage}, celui-ci est utilisé pour
+ at c nommer le fichier journal et le fichier de sortie.
+ at c
+ at c Autrement, si @var{argument} commence par une contr'oblique, il attend
+ at c la première instruction @code{\input} et le nom du fichier en entrée
+ at c devient le nom d'ouvrage.
+ at c
+ at c Au sein du document, la variable @code{\jobname} se développe dans le
+ at c nom d'ouvrage, avec la particularité que tous les caractères sont de
+ at c catcode 11 (lettre). Ainsi, si vous voulez utilisez le nom d'ouvrage
+ at c comme une condition, la solution la plus simple est d'utiliser une macro
+ at c de text du paquetage @file{xtring} dans sa variante étoilée pour être
+ at c insensible au catcode. Dans le texte suivant par exemple, la note en bas
+ at c de page « dont la Respublica Bananensis Francorum. » n'est présente que
+ at c si le nom de tâche commence par @file{moi-meme}.
+ at c
+ at c @example
+ at c Si une démocratie est juste un régime où les citoyens votent alors
+ at c toutes les républiques bananières\IfBeginWith*@{\jobname@}@{moi-meme@}%
+ at c @{\footnote@{dont la Respublica Bananensis Francorum.@}@}@{@} sont des
+ at c démocraties.
+ at c @end example
+ at c
+ at c Cela ne fonctionnerait pas si la version non étoilée de
+ at c @code{\IfBeginWith} était utilisée, parce que le @code{-} dans
+ at c @samp{moi-meme} a un catcode 12, alors que dans @code{\jobname}, s'il
+ at c s'y trouve, il a nécessairement un catcode 11.
+ at c
+ at c Dans certains cas il peut être utile de fixer le nom de tâche à une
+ at c autre valeur que celle par défaut, l'option @code{--jobname} permet de
+ at c faire cela, elle l'emporte sur le premier @code{\input} et spécifie
+ at c directement le nom. @xref{Command line input}, pour un exemple d'usage,
+ at c où l'on génère deux fichiers @file{etudiants.pdf} et
+ at c @file{professeurs.pdf} à partir d'un même code source @file{principal.tex}.
+ at c
+ at c En l'absence d'option @code{--jobname}, la valeur initiale de
+ at c @code{\jobname} est @code{texput}, de sorte que si la compilation
+ at c s'arrête avant le premier @code{\input}, le journal produit sera nommé
+ at c @file{texput.log}. Par exemple la commande suivante :
+ at c
+ at c @example
+ at c pdflatex "\nonstopmode\errmessage@{\string\jobname\space vaut \jobname@}"
+ at c @end example
+ at c
+ at c produira un journal @file{textput.log} contenant le message d'erreur
+ at c @samp{! \jobname vaut texput.}.
+ at c
+ at c Attention, le nom de tâche est également forcé à @file{texput} si le
+ at c premier @code{\input} est indirectement appelé par @code{\documentclass}
+ at c ou @code{\RequirePackage}. Ainsi l'exemple suivant produira un fichier
+ at c nommé @file{texput.pdf} avec une version raisonnablement récente de
+ at c @LaTeX{} :
+ at c
+ at c @example
+ at c pdflatex "\documentclass@{minimal@}\begin@{document@}Bonjour !\end@{document@}"
+ at c @end example
+ at c
+ at c mais avec une version plus ancienne le fichier de sortie se serait nommé
+ at c @file{minimal.pdf}, parce que le premier @code{\input} appelé
+ at c indirectement par @code{\documentclass} aurait été traité de la même
+ at c façon que s'il chargeait le fichier source racine.
+ at c
+ at c Voici un autre exemple de cela, ici on reprend l'exemple donné dans
+ at c @ref{Command line input} où l'on passe sur la ligne de commande l'option
+ at c @code{draft} au paquetage @file{graphicx}. Mais au lieu de le faire avec
+ at c @code{\PassOptionToPackage}, on le fait avec @code{\RequirePackage}, ce
+ at c qui a également pour effet que le paquetage @file{graphicx} sera chargé
+ at c en premier, si ce n'était pas déjà le cas.
+ at c
+ at c @c credit Herbert Voss: https://tex.stackexchange.com/a/17236/121234
+ at c @example
+ at c pdflatex --jobname=aa "\RequirePackage[draft]@{graphicx@}\input@{aa.tex@}"
+ at c @end example
+ at c
+ at c L'option @code{--jobname=aa} est nécessaire, car elle garantit que le
+ at c fichier de sortie se nommera bien @file{aa.pdf}, et non
+ at c @file{texput.pdf} avec une version récente de @LaTeX{}, ni
+ at c @file{graphicx.pdf} avec une version plus ancienne.
@end ignore
@node Recovering from errors
More information about the latexrefman-commits
mailing list.