[latexrefman-commits] [SCM] latexrefman updated: r716 - in trunk: . latex2e-help-texinfo-tree/la [more]

jimhefferon at gnu.org.ua jimhefferon at gnu.org.ua
Sun Oct 21 23:39:31 CEST 2018


Author: jimhefferon
Date: 2018-10-22 00:39:31 +0300 (Mon, 22 Oct 2018)
New Revision: 716

Added:
   trunk/latex2e-help-texinfo-tree/latex2e/_005copenin-_0026-_005copenout.html
   trunk/latex2e-help-texinfo-tree/latex2e/bs-openin-and-bs-openout.html
Modified:
   trunk/ChangeLog
   trunk/latex2e-help-texinfo-tree/latex2e/Index.html
   trunk/latex2e-help-texinfo-tree/latex2e/Input_002foutput.html
   trunk/latex2e-help-texinfo-tree/latex2e/_005cmessage.html
   trunk/latex2e-help-texinfo-tree/latex2e/_005csignature.html
   trunk/latex2e-help-texinfo-tree/latex2e/_005ctypein.html
   trunk/latex2e-help-texinfo-tree/latex2e/_005ctypeout.html
   trunk/latex2e-help-texinfo-tree/latex2e/_005cwlog.html
   trunk/latex2e-help-texinfo-tree/latex2e/_005cwrite.html
   trunk/latex2e-help-texinfo-tree/latex2e/_005cwrite18.html
   trunk/latex2e-help-texinfo-tree/latex2e/index.html
   trunk/latex2e.dbk
   trunk/latex2e.dvi
   trunk/latex2e.html
   trunk/latex2e.info
   trunk/latex2e.pdf
   trunk/latex2e.texi
   trunk/latex2e.txt
   trunk/latex2e.xml
   trunk/src/keeptrack.csv
Log:
Add \openin & \openout

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/ChangeLog	2018-10-21 21:39:31 UTC (rev 716)
@@ -1,5 +1,10 @@
 2018-10-21  Jim Hefferon  <jhefferon at smcvt.edu>
 
+	* latex2e.texi  Add \openin & \openout.  Adjust wording of \write,
+	\write18, and others.
+
+2018-10-21  Jim Hefferon  <jhefferon at smcvt.edu>
+
 	* latex2e.texi  Add \write, \message, \wlog, and \write18.
 	Change title from Terminal input/output to just Input/output.
 	Also adjust wording of command line options.

Modified: trunk/latex2e-help-texinfo-tree/latex2e/Index.html
===================================================================
--- trunk/latex2e-help-texinfo-tree/latex2e/Index.html	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e-help-texinfo-tree/latex2e/Index.html	2018-10-21 21:39:31 UTC (rev 716)
@@ -406,6 +406,8 @@
 <tr><td></td><td valign="top"><a href="_005cclearpage-_0026-_005ccleardoublepage.html#index-_005ccleardoublepage"><code>\cleardoublepage</code></a>:</td><td> </td><td valign="top"><a href="_005cclearpage-_0026-_005ccleardoublepage.html#g_t_005cclearpage-_0026-_005ccleardoublepage">\clearpage & \cleardoublepage</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005cclearpage-_0026-_005ccleardoublepage.html#index-_005cclearpage"><code>\clearpage</code></a>:</td><td> </td><td valign="top"><a href="_005cclearpage-_0026-_005ccleardoublepage.html#g_t_005cclearpage-_0026-_005ccleardoublepage">\clearpage & \cleardoublepage</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005ccline.html#index-_005ccline"><code>\cline</code></a>:</td><td> </td><td valign="top"><a href="_005ccline.html#g_t_005ccline">\cline</a></td></tr>
+<tr><td></td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#index-_005cclosein"><code>\closein</code></a>:</td><td> </td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
+<tr><td></td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#index-_005ccloseout"><code>\closeout</code></a>:</td><td> </td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005cclosing.html#index-_005cclosing"><code>\closing</code></a>:</td><td> </td><td valign="top"><a href="_005cclosing.html#g_t_005cclosing">\closing</a></td></tr>
 <tr><td></td><td valign="top"><a href="Math-symbols.html#index-_005cclubsuit"><code>\clubsuit</code></a>:</td><td> </td><td valign="top"><a href="Math-symbols.html#Math-symbols">Math symbols</a></td></tr>
 <tr><td></td><td valign="top"><a href="Colon-character-_0026-_005ccolon.html#index-_005ccolon"><code>\colon</code></a>:</td><td> </td><td valign="top"><a href="Colon-character-_0026-_005ccolon.html#Colon-character-_0026-_005ccolon">Colon character & \colon</a></td></tr>
@@ -793,7 +795,9 @@
 <tr><td></td><td valign="top"><a href="Math-symbols.html#index-_005comega"><code>\omega</code></a>:</td><td> </td><td valign="top"><a href="Math-symbols.html#Math-symbols">Math symbols</a></td></tr>
 <tr><td></td><td valign="top"><a href="Math-symbols.html#index-_005cominus"><code>\ominus</code></a>:</td><td> </td><td valign="top"><a href="Math-symbols.html#Math-symbols">Math symbols</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005conecolumn.html#index-_005conecolumn"><code>\onecolumn</code></a>:</td><td> </td><td valign="top"><a href="_005conecolumn.html#g_t_005conecolumn">\onecolumn</a></td></tr>
+<tr><td></td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#index-_005copenin"><code>\openin</code></a>:</td><td> </td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005copening.html#index-_005copening"><code>\opening</code></a>:</td><td> </td><td valign="top"><a href="_005copening.html#g_t_005copening">\opening</a></td></tr>
+<tr><td></td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#index-_005copenout"><code>\openout</code></a>:</td><td> </td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
 <tr><td></td><td valign="top"><a href="Math-symbols.html#index-_005coplus"><code>\oplus</code></a>:</td><td> </td><td valign="top"><a href="Math-symbols.html#Math-symbols">Math symbols</a></td></tr>
 <tr><td></td><td valign="top"><a href="Class-and-package-commands.html#index-_005cOptionNotUsed"><code>\OptionNotUsed</code></a>:</td><td> </td><td valign="top"><a href="Class-and-package-commands.html#Class-and-package-commands">Class and package commands</a></td></tr>
 <tr><td></td><td valign="top"><a href="Math-symbols.html#index-_005coslash"><code>\oslash</code></a>:</td><td> </td><td valign="top"><a href="Math-symbols.html#Math-symbols">Math symbols</a></td></tr>
@@ -1234,8 +1238,7 @@
 <tr><td></td><td valign="top"><a href="_005cline.html#index-Asymptote-package"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="_005cline.html#g_t_005cline">\line</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005cstrut.html#index-Asymptote-package-1"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="_005cstrut.html#g_t_005cstrut">\strut</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005cmbox-_0026-_005cmakebox.html#index-Asymptote-package-2"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="_005cmbox-_0026-_005cmakebox.html#g_t_005cmbox-_0026-_005cmakebox">\mbox & \makebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="_005cwrite.html#index-Asymptote-package-3"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="_005cwrite.html#g_t_005cwrite">\write</a></td></tr>
-<tr><td></td><td valign="top"><a href="_005cwrite18.html#index-Asymptote-package-4"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="_005cwrite18.html#g_t_005cwrite18">\write18</a></td></tr>
+<tr><td></td><td valign="top"><a href="_005cwrite18.html#index-Asymptote-package-3"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="_005cwrite18.html#g_t_005cwrite18">\write18</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005cnewfont.html#index-at-clause_002c-in-font-definitions">at clause, in font definitions</a>:</td><td> </td><td valign="top"><a href="_005cnewfont.html#g_t_005cnewfont">\newfont</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005c_0040.html#index-at_002dsign"><code>at-sign</code></a>:</td><td> </td><td valign="top"><a href="_005c_0040.html#g_t_005c_0040">\@</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005cmaketitle.html#index-author_002c-for-titlepage">author, for titlepage</a>:</td><td> </td><td valign="top"><a href="_005cmaketitle.html#g_t_005cmaketitle">\maketitle</a></td></tr>
@@ -1564,6 +1567,8 @@
 <tr><td></td><td valign="top"><a href="_005cref.html#index-figure-number_002c-cross-referencing">figure number, cross referencing</a>:</td><td> </td><td valign="top"><a href="_005cref.html#g_t_005cref">\ref</a></td></tr>
 <tr><td></td><td valign="top"><a href="minipage.html#index-figures_002c-footnotes-in">figures, footnotes in</a>:</td><td> </td><td valign="top"><a href="minipage.html#minipage">minipage</a></td></tr>
 <tr><td></td><td valign="top"><a href="figure.html#index-figures_002c-inserting">figures, inserting</a>:</td><td> </td><td valign="top"><a href="figure.html#figure">figure</a></td></tr>
+<tr><td></td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#index-file_002c-closing">file, closing</a>:</td><td> </td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
+<tr><td></td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#index-file_002c-opening">file, opening</a>:</td><td> </td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
 <tr><td></td><td valign="top"><a href="Splitting-the-input.html#index-file_002c-root">file, root</a>:</td><td> </td><td valign="top"><a href="Splitting-the-input.html#Splitting-the-input">Splitting the input</a></td></tr>
 <tr><td></td><td valign="top"><a href="filecontents.html#index-filecontents-environment"><code><code>filecontents</code> <span class="roman">environment</span></code></a>:</td><td> </td><td valign="top"><a href="filecontents.html#filecontents">filecontents</a></td></tr>
 <tr><td></td><td valign="top"><a href="filecontents.html#index-filecontents_002a-environment"><code><code>filecontents*</code> <span class="roman">environment</span></code></a>:</td><td> </td><td valign="top"><a href="filecontents.html#filecontents">filecontents</a></td></tr>
@@ -1698,6 +1703,7 @@
 <tr><td></td><td valign="top"><a href="Modes.html#index-inner-paragraph-mode">inner paragraph mode</a>:</td><td> </td><td valign="top"><a href="Modes.html#Modes">Modes</a></td></tr>
 <tr><td></td><td valign="top"><a href="Splitting-the-input.html#index-input-file">input file</a>:</td><td> </td><td valign="top"><a href="Splitting-the-input.html#Splitting-the-input">Splitting the input</a></td></tr>
 <tr><td></td><td valign="top"><a href="Command-line-input.html#index-input_002c-on-command-line">input, on command line</a>:</td><td> </td><td valign="top"><a href="Command-line-input.html#Command-line-input">Command line input</a></td></tr>
+<tr><td></td><td valign="top"><a href="Input_002foutput.html#index-input_002foutput">input/output</a>:</td><td> </td><td valign="top"><a href="Input_002foutput.html#Input_002foutput">Input/output</a></td></tr>
 <tr><td></td><td valign="top"><a href="Input_002foutput.html#index-input_002foutput_002c-to-terminal">input/output, to terminal</a>:</td><td> </td><td valign="top"><a href="Input_002foutput.html#Input_002foutput">Input/output</a></td></tr>
 <tr><td></td><td valign="top"><a href="figure.html#index-inserting-figures">inserting figures</a>:</td><td> </td><td valign="top"><a href="figure.html#figure">figure</a></td></tr>
 <tr><td></td><td valign="top"><a href="Special-insertions.html#index-insertions-of-special-characters">insertions of special characters</a>:</td><td> </td><td valign="top"><a href="Special-insertions.html#Special-insertions">Special insertions</a></td></tr>
@@ -1893,6 +1899,7 @@
 <tr><td></td><td valign="top"><a href="_005conecolumn.html#index-one_002dcolumn-output">one-column output</a>:</td><td> </td><td valign="top"><a href="_005conecolumn.html#g_t_005conecolumn">\onecolumn</a></td></tr>
 <tr><td></td><td valign="top"><a href="Document-class-options.html#index-onecolumn-option"><code>onecolumn <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="Document-class-options.html#Document-class-options">Document class options</a></td></tr>
 <tr><td></td><td valign="top"><a href="Document-class-options.html#index-oneside-option"><code>oneside <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="Document-class-options.html#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#index-open-a-file">open a file</a>:</td><td> </td><td valign="top"><a href="_005copenin-_0026-_005copenout.html#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
 <tr><td></td><td valign="top"><a href="Document-class-options.html#index-openany-option"><code>openany <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="Document-class-options.html#Document-class-options">Document class options</a></td></tr>
 <tr><td></td><td valign="top"><a href="Document-class-options.html#index-openbib-option"><code>openbib <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="Document-class-options.html#Document-class-options">Document class options</a></td></tr>
 <tr><td></td><td valign="top"><a href="Text-symbols.html#index-opening-quote">opening quote</a>:</td><td> </td><td valign="top"><a href="Text-symbols.html#Text-symbols">Text symbols</a></td></tr>
@@ -1940,8 +1947,7 @@
 <tr><td></td><td valign="top"><a href="_005cline.html#index-package_002c-Asymptote"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td> </td><td valign="top"><a href="_005cline.html#g_t_005cline">\line</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005cstrut.html#index-package_002c-Asymptote-1"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td> </td><td valign="top"><a href="_005cstrut.html#g_t_005cstrut">\strut</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005cmbox-_0026-_005cmakebox.html#index-package_002c-Asymptote-2"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td> </td><td valign="top"><a href="_005cmbox-_0026-_005cmakebox.html#g_t_005cmbox-_0026-_005cmakebox">\mbox & \makebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="_005cwrite.html#index-package_002c-Asymptote-3"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td> </td><td valign="top"><a href="_005cwrite.html#g_t_005cwrite">\write</a></td></tr>
-<tr><td></td><td valign="top"><a href="_005cwrite18.html#index-package_002c-Asymptote-4"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td> </td><td valign="top"><a href="_005cwrite18.html#g_t_005cwrite18">\write18</a></td></tr>
+<tr><td></td><td valign="top"><a href="_005cwrite18.html#index-package_002c-Asymptote-3"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td> </td><td valign="top"><a href="_005cwrite18.html#g_t_005cwrite18">\write18</a></td></tr>
 <tr><td></td><td valign="top"><a href="_005cchapter.html#index-package_002c-babel"><span class="roman">package</span>, <code>babel</code></a>:</td><td> </td><td valign="top"><a href="_005cchapter.html#g_t_005cchapter">\chapter</a></td></tr>
 <tr><td></td><td valign="top"><a href="thebibliography.html#index-package_002c-babel-1"><span class="roman">package</span>, <code>babel</code></a>:</td><td> </td><td valign="top"><a href="thebibliography.html#thebibliography">thebibliography</a></td></tr>
 <tr><td></td><td valign="top"><a href="Accents.html#index-package_002c-babel-2"><span class="roman">package</span>, <code>babel</code></a>:</td><td> </td><td valign="top"><a href="Accents.html#Accents">Accents</a></td></tr>

Modified: trunk/latex2e-help-texinfo-tree/latex2e/Input_002foutput.html
===================================================================
--- trunk/latex2e-help-texinfo-tree/latex2e/Input_002foutput.html	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e-help-texinfo-tree/latex2e/Input_002foutput.html	2018-10-21 21:39:31 UTC (rev 716)
@@ -50,7 +50,7 @@
 <link href="Index.html#Index" rel="index" title="Index">
 <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
 <link href="index.html#Top" rel="up" title="Top">
-<link href="_005ctypein.html#g_t_005ctypein" rel="next" title="\typein">
+<link href="_005copenin-_0026-_005copenout.html#g_t_005copenin-_0026-_005copenout" rel="next" title="\openin & \openout">
 <link href="_005ctelephone.html#g_t_005ctelephone" rel="prev" title="\telephone">
 <style type="text/css">
 <!--
@@ -121,14 +121,23 @@
 
 <a name="index-input_002foutput_002c-to-terminal"></a>
 <a name="index-terminal-input_002foutput"></a>
+<a name="index-input_002foutput"></a>
 
+<p>LaTeX uses the ability to write to a file and later read it back in
+to build document components such as a table of contents or index.  You
+can also read a file that other programs written, or write a file for
+others to read.  You can communicate with users through the terminal.
+And, you can issue instructions for the operating system.
+</p>
 <table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="_005ctypein.html#g_t_005ctypein" accesskey="1">\typein</a>:</td><td>  </td><td align="left" valign="top">Read text from the terminal.
+<tr><td align="left" valign="top">• <a href="_005copenin-_0026-_005copenout.html#g_t_005copenin-_0026-_005copenout" accesskey="1">\openin & \openout</a>:</td><td>  </td><td align="left" valign="top">Open a file.
 </td></tr>
-<tr><td align="left" valign="top">• <a href="_005ctypeout.html#g_t_005ctypeout" accesskey="2">\typeout</a>:</td><td>  </td><td align="left" valign="top">Write text to the terminal.
+<tr><td align="left" valign="top">• <a href="_005ctypein.html#g_t_005ctypein" accesskey="2">\typein</a>:</td><td>  </td><td align="left" valign="top">Read text from the terminal.
 </td></tr>
-<tr><td align="left" valign="top">• <a href="_005cwrite.html#g_t_005cwrite" accesskey="3">\write</a>:</td><td>  </td><td align="left" valign="top">Write text to a file or terminal.
+<tr><td align="left" valign="top">• <a href="_005ctypeout.html#g_t_005ctypeout" accesskey="3">\typeout</a>:</td><td>  </td><td align="left" valign="top">Write text to the terminal.
 </td></tr>
+<tr><td align="left" valign="top">• <a href="_005cwrite.html#g_t_005cwrite" accesskey="4">\write</a>:</td><td>  </td><td align="left" valign="top">Write text to a file or terminal.
+</td></tr>
 </table>
 
 

Modified: trunk/latex2e-help-texinfo-tree/latex2e/_005cmessage.html
===================================================================
--- trunk/latex2e-help-texinfo-tree/latex2e/_005cmessage.html	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e-help-texinfo-tree/latex2e/_005cmessage.html	2018-10-21 21:39:31 UTC (rev 716)
@@ -117,7 +117,7 @@
 </div>
 <hr>
 <a name="g_t_005cmessage-1"></a>
-<h4 class="subsection">27.3.1 <code>\message</code></h4>
+<h4 class="subsection">27.4.1 <code>\message</code></h4>
 
 <a name="index-_005cmessage"></a>
 

Modified: trunk/latex2e-help-texinfo-tree/latex2e/_005csignature.html
===================================================================
--- trunk/latex2e-help-texinfo-tree/latex2e/_005csignature.html	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e-help-texinfo-tree/latex2e/_005csignature.html	2018-10-21 21:39:31 UTC (rev 716)
@@ -164,9 +164,6 @@
 
 
 
-
-
-
 <hr/><div class='referenceinfo'> <a href='https://latexref.xyz/'> <i>Unofficial LaTeX2e reference manual</i></a></div>
 </body>
 </html>

Modified: trunk/latex2e-help-texinfo-tree/latex2e/_005ctypein.html
===================================================================
--- trunk/latex2e-help-texinfo-tree/latex2e/_005ctypein.html	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e-help-texinfo-tree/latex2e/_005ctypein.html	2018-10-21 21:39:31 UTC (rev 716)
@@ -51,7 +51,7 @@
 <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
 <link href="Input_002foutput.html#Input_002foutput" rel="up" title="Input/output">
 <link href="_005ctypeout.html#g_t_005ctypeout" rel="next" title="\typeout">
-<link href="Input_002foutput.html#Input_002foutput" rel="prev" title="Input/output">
+<link href="_005copenin-_0026-_005copenout.html#g_t_005copenin-_0026-_005copenout" rel="prev" title="\openin & \openout">
 <style type="text/css">
 <!--
 /* $Id: latex2e.css 690 2018-09-15 15:20:19Z jimhefferon $
@@ -113,11 +113,11 @@
 <a name="g_t_005ctypein"></a>
 <div class="header">
 <p>
-Next: <a href="_005ctypeout.html#g_t_005ctypeout" accesskey="n" rel="next">\typeout</a>, Up: <a href="Input_002foutput.html#Input_002foutput" accesskey="u" rel="up">Input/output</a>   [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="_005ctypeout.html#g_t_005ctypeout" accesskey="n" rel="next">\typeout</a>, Previous: <a href="_005copenin-_0026-_005copenout.html#g_t_005copenin-_0026-_005copenout" accesskey="p" rel="prev">\openin & \openout</a>, Up: <a href="Input_002foutput.html#Input_002foutput" accesskey="u" rel="up">Input/output</a>   [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
 </div>
 <hr>
 <a name="g_t_005ctypein-1"></a>
-<h3 class="section">27.1 <code>\typein</code></h3>
+<h3 class="section">27.2 <code>\typein</code></h3>
 
 <a name="index-_005ctypein"></a>
 

Modified: trunk/latex2e-help-texinfo-tree/latex2e/_005ctypeout.html
===================================================================
--- trunk/latex2e-help-texinfo-tree/latex2e/_005ctypeout.html	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e-help-texinfo-tree/latex2e/_005ctypeout.html	2018-10-21 21:39:31 UTC (rev 716)
@@ -117,7 +117,7 @@
 </div>
 <hr>
 <a name="g_t_005ctypeout-1"></a>
-<h3 class="section">27.2 <code>\typeout</code></h3>
+<h3 class="section">27.3 <code>\typeout</code></h3>
 
 <a name="index-_005ctypeout"></a>
 

Modified: trunk/latex2e-help-texinfo-tree/latex2e/_005cwlog.html
===================================================================
--- trunk/latex2e-help-texinfo-tree/latex2e/_005cwlog.html	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e-help-texinfo-tree/latex2e/_005cwlog.html	2018-10-21 21:39:31 UTC (rev 716)
@@ -117,7 +117,7 @@
 </div>
 <hr>
 <a name="g_t_005cwlog-1"></a>
-<h4 class="subsection">27.3.2 <code>\wlog</code></h4>
+<h4 class="subsection">27.4.2 <code>\wlog</code></h4>
 
 <a name="index-_005cwlog"></a>
 

Modified: trunk/latex2e-help-texinfo-tree/latex2e/_005cwrite.html
===================================================================
--- trunk/latex2e-help-texinfo-tree/latex2e/_005cwrite.html	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e-help-texinfo-tree/latex2e/_005cwrite.html	2018-10-21 21:39:31 UTC (rev 716)
@@ -117,7 +117,7 @@
 </div>
 <hr>
 <a name="g_t_005cwrite-1"></a>
-<h3 class="section">27.3 <code>\write</code></h3>
+<h3 class="section">27.4 <code>\write</code></h3>
 
 <a name="index-_005cwrite"></a>
 
@@ -131,16 +131,6 @@
 opened by <code>\openout</code>.  For instance, <code>\write6</code> writes to text
 stream number 6.
 </p>
-<a name="index-package_002c-Asymptote-3"></a>
-<a name="index-Asymptote-package-3"></a>
-
-<p>LaTeX uses the ability to write to a file and later read it back in
-to build document components such as a Table of Contents or Index.  You
-can also output a file that other programs read, for instance by writing
-out an Asymptote graphics source file, having LaTeX then run the
-<samp>asymptote</samp> program on that file (see <a href="_005cwrite18.html#g_t_005cwrite18">\write18</a>), and finally
-bringing that graphic back into the document (see <a href="_005cincludegraphics.html#g_t_005cincludegraphics">\includegraphics</a>).
-</p>
 <p>If this appears in <samp><var>basefile</var>.tex</samp> then it opens
 <samp><var>basefile</var>.jh</samp>, writes ‘<samp>Hello World!</samp>’ and a newline to
 it, and closes that file.
@@ -163,14 +153,14 @@
 <p>Typically <var>number</var> is between 0 and 15 because typically
 LaTeX authors follow the prior example and the number is allocated by
 the system.  If <var>number</var> is outside the range from 0 to 15 or if it
-is not associated with an open file then LaTeX writes the string to
+is not associated with an open file then LaTeX writes <var>string</var> to
 the log file.  If <var>number</var> is positive then in addition LaTeX
-writes <var>string</var> to the terminal.  (But the numbers 16, 17, and 18
-are special; see below.) Thus, <code>test \write-1{Hello World!}</code> puts
-‘<samp>Hello World!</samp>’ followed by a newline in the log file.  (This is
-what the <code>\wlog</code> command does; see <a href="_005cwlog.html#g_t_005cwlog">\wlog</a>).  And
+writes <var>string</var> to the terminal. Thus, <code>test \write-1{Hello
+World!}</code> puts ‘<samp>Hello World!</samp>’ followed by a newline in the log
+file.  (This is what the <code>\wlog</code> command does; see <a href="_005cwlog.html#g_t_005cwlog">\wlog</a>).  And
 <code>\write100{Hello World!}</code> puts the same in the log file but also
 puts ‘<samp>Hello World!</samp>’ followed by a newline in the terminal output.
+(But 16, 17, and 18 are special as <var>number</var>; see below.)
 </p>
 <p>In LuaLaTeX, instead of 16 output streams there are 256
 (see <a href="TeX-engines.html#TeX-engines">TeX engines</a>).
@@ -193,15 +183,16 @@
 </pre></div>
 
 <p>With the first, LaTeX writes <var>string</var> to the file.  Any commands
-in <var>string</var> will be expanded (as in <code>\edef</code>, except that you
-should use <code>#</code> instead of <code>##</code>).  With the second,
-<var>string</var> is stored on the current list of things (as a TeX
-“whatsit”) and kept until the page is shipped out.  On that list the
-commands are unexpanded until at the time of shipout.  The third,
+in <var>string</var> will be expanded (just as in <code>\edef</code> so that to
+prevent expansion you should use <code>\noexpand</code> or a <code>toks</code>,
+except that you should use <code>#</code> instead of <code>##</code>).  With the
+second, <var>string</var> is stored on the current list of things (as a
+TeX “whatsit”) and kept until the page is shipped out and likewise
+the commands are unexpanded until shipout.  The third,
 <code>\protected at write</code>, is like the second except that you can use
-<code>\protect</code> on fragile commands. In this third case the extra first
-argument allows you to locally insert extra definitions to make more
-commands be safe or have special definition during the write.
+<code>\protect</code> on fragile commands. The extra first argument allows you
+to locally insert extra definitions to make more commands be safe or
+have special definition during the write.
 </p>
 <p>Here <var>string</var> contains a control sequence.
 </p>
@@ -216,25 +207,26 @@
 followed by a newline.
 </p>
 <p>The cases where <var>number</var> is 16, 17, or 18 are special.  Because of
-<code>\write<var>number</var></code>’s behavior when <var>number</var> is outside the
-range from 0 to 15, there is some convention of writing to the log file
-and the terminal with <code>\write16</code>.  In the past <code>\write17</code> has
-sometimes been used in a similar way.  The <code>\write18</code> command is
-even more special; modern TeX systems use it for issuing commands to
-the operating system (see <a href="_005cwrite18.html#g_t_005cwrite18">\write18</a>).
+<code>\write</code>’s behavior when <var>number</var> is outside the range from 0
+to 15 described above, in Plain TeX <code>\write16</code> and
+<code>\write17</code> were sometimes used to write to the log file and the
+terminal.  Note that in LaTeX the natural way to do that is with
+<code>\typeout</code> (see <a href="_005ctypeout.html#g_t_005ctypeout">\typeout</a>).  The <code>\write18</code> command is even
+more special; modern TeX systems use it for giving commands to the
+operating system (see <a href="_005cwrite18.html#g_t_005cwrite18">\write18</a>).
 </p>
 <p>Ordinarily <code>\write</code> outputs a single line.  Put in a newline with
 <code>^^J</code>.  Thus, this produces two lines in the log file.
 </p>
 <div class="example">
-<pre class="example">\wlog{Parallel Lines have a lot in common.^^JBut they never meet.}
+<pre class="example">\wlog{Parallel lines have a lot in common.^^JBut they never meet.}
 </pre></div>
 
-<p>Writing arbitrary files has obvious security problems.  If you
-downloaded a LaTeX file and compiling it overwrote your password file
-then you would be annoyed.  TeX systems by default only allow you to
-open files for writing that are in the current directory or in a
-subdirectory.  This example
+<p>The ability to Write files raises security issues.  If you compiled a
+downloaded LaTeX file and it overwrote your password file then you
+would be annoyed.  TeX systems by default only allow you to open
+files for writing that are in the current directory or in a
+subdirectory.  This
 </p>
 <div class="example">
 <pre class="example">\newwrite\jhfile
@@ -245,17 +237,17 @@
 I can't write on file `../test.jh'</samp>’.  Note that you can get such an
 error when trying to use commands such as <code>\include{../filename}</code>
 because LaTeX will try to open <samp>../filename.aux</samp>.  The simplest
-solution is to put the included files in the same directory or
-subdirectories of the master file.
+solution is to put the included files in the same directory as the
+master file, or in subdirectories.
 </p>
 <a name="index-package_002c-answers"></a>
 <a name="index-answers-package"></a>
 
-<p>If you want that the material you write is output verbatim, without
-expanding the commands, for instance to write answers to exercises, then
-look at the <samp>answers</samp> package on CTAN.
+<p>A common case where authors want to write a file not already provided by
+LaTeX is for answers to exercises, or some other situation where you
+want to write out verbatim, without expanding the commands.  CTAN has a
+number of packages for this; one is <samp>answers</samp>.
 </p>
-
 <table class="menu" border="0" cellspacing="0">
 <tr><td align="left" valign="top">• <a href="_005cmessage.html#g_t_005cmessage" accesskey="1">\message</a>:</td><td>  </td><td align="left" valign="top">Write part of a line to log file and terminal.
 </td></tr>

Modified: trunk/latex2e-help-texinfo-tree/latex2e/_005cwrite18.html
===================================================================
--- trunk/latex2e-help-texinfo-tree/latex2e/_005cwrite18.html	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e-help-texinfo-tree/latex2e/_005cwrite18.html	2018-10-21 21:39:31 UTC (rev 716)
@@ -117,7 +117,7 @@
 </div>
 <hr>
 <a name="g_t_005cwrite18-1"></a>
-<h4 class="subsection">27.3.3 <code>\write18</code></h4>
+<h4 class="subsection">27.4.3 <code>\write18</code></h4>
 
 <a name="index-_005cwrite18"></a>
 <a name="index-external-commands"></a>
@@ -133,8 +133,8 @@
 runs the command and LaTeX’s execution is blocked until that
 finishes.
 </p>
-<a name="index-package_002c-Asymptote-4"></a>
-<a name="index-Asymptote-package-4"></a>
+<a name="index-package_002c-Asymptote-3"></a>
+<a name="index-Asymptote-package-3"></a>
 
 <p>This
 </p>
@@ -146,19 +146,21 @@
 \includegraphics{pix\figure\fignum.pdf}
 </pre></div>
 
-<p>will run <samp>Asymptote</samp> on <samp>figure1.asy</samp>, so that the document
-can later read in the resulting graphic (see <a href="_005cincludegraphics.html#g_t_005cincludegraphics">\includegraphics</a>).
+<p>will run <samp>Asymptote</samp> on <samp>pix/figure1.asy</samp>, so that the
+document can later read in the resulting graphic
+(see <a href="_005cincludegraphics.html#g_t_005cincludegraphics">\includegraphics</a>).  Like any <code>\write</code>, here LaTeX
+expands macros in <var>shell_command</var> so that <code>\fignum</code> is replaced
+by ‘<samp>1</samp>’.
 </p>
 <p>Another example is that you can automatically run BibTeX at the start
 of each LaTeX run (see <a href="Using-BibTeX.html#Using-BibTeX">Using BibTeX</a>) by including
 <code>\immediate\write18{bibtex8 \jobname}</code> as the first line of the
-file.  Like any <code>\write</code>, here LaTeX expands macros in
-<var>shell_command</var> so that <code>\jobname</code> gives the base name of the
-current file.
+file.  Note that <code>\jobname</code> gives the base name of the current
+file.
 </p>
 <p>You sometimes need to do a multi-step process to get the information
-that you want.  This will get a list of all PDF files in the current
-directory.
+that you want.  This will insert into the input a list of all PDF files
+in the current directory.
 </p>
 <div class="example">
 <pre class="example">\immediate\write18{ls *.pdf > tmp.dat}
@@ -167,10 +169,8 @@
 
 <p>The standard behaviour of any <code>\write</code> is to wait until a page is
 being shipped out before expanding the macros or writing to the stream
-(see <a href="_005cwrite.html#g_t_005cwrite">\write</a>). But sometimes you want it done now.  The command
-<code>\immediate\write18{<var>shell_command</var>}</code> will send
-<var>shell_command</var> to the operating system for execution now, rather
-than waiting until the next shipout.
+(see <a href="_005cwrite.html#g_t_005cwrite">\write</a>). But sometimes you want it done now.  For this, use
+<code>\immediate\write18{<var>shell_command</var>}</code>.
 </p>
 <p>There are obvious security issues with allowing system commands inside a
 LaTeX file.  If you download a file off the net and it contains
@@ -186,16 +186,17 @@
 run MetaFont to generate missing fonts, even if you do not use the
 <code>shell-escape</code> or <code>enable-write18</code> option. By default this
 list of allowed commands is short and features only commands that are
-under the control of the distribution maintainers.
+under the control of the distribution maintainers (see <a href="Command-line-options.html#Command-line-options">Command line options</a>).
 </p>
 <p>Some packages need to run external system commands. For instance
 <samp>sagetex</samp> allows you to have the mathematics software system
 <i>Sage</i> do calculations or draw graphs and then incorporate that output
 in your document. For this you must compile with full <code>\write18</code>
-capability turned on (see <a href="Command-line-options.html#Command-line-options">Command line options</a>).
+capability turned on.
 </p>
 
 
+
 <hr/><div class='referenceinfo'> <a href='https://latexref.xyz/'> <i>Unofficial LaTeX2e reference manual</i></a></div>
 </body>
 </html>

Index: trunk/latex2e-help-texinfo-tree/latex2e/bs-openin-and-bs-openout.html
===================================================================
--- trunk/latex2e-help-texinfo-tree/latex2e/bs-openin-and-bs-openout.html	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e-help-texinfo-tree/latex2e/bs-openin-and-bs-openout.html	2018-10-21 21:39:31 UTC (rev 716)

Property changes on: trunk/latex2e-help-texinfo-tree/latex2e/bs-openin-and-bs-openout.html
___________________________________________________________________
Added: svn:special
## -0,0 +1 ##
+*
\ No newline at end of property
Modified: trunk/latex2e-help-texinfo-tree/latex2e/index.html
===================================================================
--- trunk/latex2e-help-texinfo-tree/latex2e/index.html	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e-help-texinfo-tree/latex2e/index.html	2018-10-21 21:39:31 UTC (rev 716)
@@ -573,13 +573,14 @@
   </ul></li>
   <li><a name="toc-Input_002foutput-1" href="Input_002foutput.html#Input_002foutput">27 Input/output</a>
   <ul class="no-bullet">
-    <li><a name="toc-_005ctypein-1" href="_005ctypein.html#g_t_005ctypein">27.1 <code>\typein</code></a></li>
-    <li><a name="toc-_005ctypeout-1" href="_005ctypeout.html#g_t_005ctypeout">27.2 <code>\typeout</code></a></li>
-    <li><a name="toc-_005cwrite-1" href="_005cwrite.html#g_t_005cwrite">27.3 <code>\write</code></a>
+    <li><a name="toc-_005copenin-_0026-_005copenout-1" href="_005copenin-_0026-_005copenout.html#g_t_005copenin-_0026-_005copenout">27.1 <code>\openin</code> & <code>\openout</code></a></li>
+    <li><a name="toc-_005ctypein-1" href="_005ctypein.html#g_t_005ctypein">27.2 <code>\typein</code></a></li>
+    <li><a name="toc-_005ctypeout-1" href="_005ctypeout.html#g_t_005ctypeout">27.3 <code>\typeout</code></a></li>
+    <li><a name="toc-_005cwrite-1" href="_005cwrite.html#g_t_005cwrite">27.4 <code>\write</code></a>
     <ul class="no-bullet">
-      <li><a name="toc-_005cmessage-1" href="_005cmessage.html#g_t_005cmessage">27.3.1 <code>\message</code></a></li>
-      <li><a name="toc-_005cwlog-1" href="_005cwlog.html#g_t_005cwlog">27.3.2 <code>\wlog</code></a></li>
-      <li><a name="toc-_005cwrite18-1" href="_005cwrite18.html#g_t_005cwrite18">27.3.3 <code>\write18</code></a></li>
+      <li><a name="toc-_005cmessage-1" href="_005cmessage.html#g_t_005cmessage">27.4.1 <code>\message</code></a></li>
+      <li><a name="toc-_005cwlog-1" href="_005cwlog.html#g_t_005cwlog">27.4.2 <code>\wlog</code></a></li>
+      <li><a name="toc-_005cwrite18-1" href="_005cwrite18.html#g_t_005cwrite18">27.4.3 <code>\write18</code></a></li>
     </ul></li>
   </ul></li>
   <li><a name="toc-Command-line-1" href="Command-line.html#Command-line">28 Command line</a>

Modified: trunk/latex2e.dbk
===================================================================
--- trunk/latex2e.dbk	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e.dbk	2018-10-21 21:39:31 UTC (rev 716)
@@ -16588,24 +16588,6 @@
 (see <link linkend="Graphics">Graphics</link>).
 </para>
 
-<!-- I think this is not a user-level command; it is used to keep from breaking -->
-<!-- the page between the closing and the signature -->
-<!-- @node \stopbreaks and \startbreaks -->
-<!-- @section @code{\stopbreaks} and @code{\startbreaks} -->
-
-<!-- @findex \startbreak -->
-<!-- @findex \stopbreaks -->
-
-<!-- @example  -->
-<!-- @code{\stopbreaks} -->
-<!-- text -->
-<!-- @code{\startbreaks} -->
-<!-- @end example -->
-
-<!-- The @code{\stopbreaks} inhibits page breaking.  The @code{\startbreaks} resumes -->
-<!-- normal page breaking. -->
-<!-- -->
-<!-- -->
 </sect1>
 <sect1 label="26.11" id="_005ctelephone">
 <title><literal>\telephone</literal></title>
@@ -16629,10 +16611,91 @@
 
 <indexterm role="cp"><primary>input/output, to terminal</primary></indexterm>
 <indexterm role="cp"><primary>terminal input/output</primary></indexterm>
+<indexterm role="cp"><primary>input/output</primary></indexterm>
 
+<para>&latex; uses the ability to write to a file and later read it back in
+to build document components such as a table of contents or index.  You
+can also read a file that other programs written, or write a file for
+others to read.  You can communicate with users through the terminal.
+And, you can issue instructions for the operating system.
+</para>
 
 
-<sect1 label="27.1" id="_005ctypein">
+<sect1 label="27.1" id="_005copenin-_0026-_005copenout">
+<title><literal>\openin</literal> & <literal>\openout</literal></title>
+
+<indexterm role="fn"><primary>\openin</primary></indexterm>
+<indexterm role="fn"><primary>\openout</primary></indexterm>
+<indexterm role="fn"><primary>\closein</primary></indexterm>
+<indexterm role="fn"><primary>\closeout</primary></indexterm>
+<indexterm role="cp"><primary>file, opening</primary></indexterm>
+<indexterm role="cp"><primary>file, closing</primary></indexterm>
+<indexterm role="cp"><primary>open a file</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\openin<replaceable>number</replaceable>=<replaceable>filename</replaceable>
+</screen>
+<para>or:
+</para>
+<screen>\openout<replaceable>number</replaceable>=<replaceable>filename</replaceable>
+</screen>
+<para>Open a file for reading material, or for writing it.  The <replaceable>number</replaceable>
+must be between 0 and 15, as in <literal>\openin3</literal> (in Lua&latex;
+<replaceable>number</replaceable> can be between 0 and 255).
+</para>
+<para>Here &tex; opens the file <filename>presidents.tex</filename> for reading.
+</para>
+<screen>\newread\presidentsfile
+\openin\presidentsfile=presidents
+\typeout{presidentsfile is \the\presidentsfile}
+\read\presidentsfile to\presidentline
+\typeout{\presidentline}
+</screen>
+<para>The <literal>\newread</literal> command allocates input stream numbers from 0
+to 15, (there is also a <literal>\newwrite</literal>).  Being able to work not
+with a number but with the more memorable <literal>\presidentsfile</literal> is just
+a convenience; the first line typed out is something like
+‘<literal>presidentsfile is 1</literal>’.  The second line is like ‘<literal>1 Washington,
+George</literal>’.
+</para>
+<para>Close files with <literal>\closein<replaceable>number</replaceable></literal> and
+<literal>\closeout<replaceable>number</replaceable></literal>.
+</para>
+<para>How &latex; handles filenames varies among distributions, and even can
+vary among versions of a distribution.  If the file does not have an
+extension then &tex; will add a <filename>.tex</filename>.  This creates
+<filename>presidents.tex</filename>, writes one line to it, and closes it.
+</para>
+<screen>\newwrite\presidentsfile
+\openout\presidentsfile=presidents
+\write\presidentsfile{1 Washington, George}
+\closeout\presidentsfile
+</screen>
+<para>But filenames with a period can cause trouble: if &tex; finds a
+<replaceable>filename</replaceable> of <filename>presidents.dat</filename> it could look first for
+<filename>presidents.dat.tex</filename> and later for <filename>presidents.dat</filename>, or it
+could do the opposite.  Your distribution’s documentation should say
+more, and if you find something that works for you then you are good,
+but to ensure complete portability the best thing is to use file names
+containing only the twenty six ASCII letters (not case-sensitive), along
+with underscore and dash, and no dot or space.
+</para>
+<para>Ordinarily &tex; will not try to open the file until the next page
+shipout. To change this, use
+<literal>\immediate\openin<replaceable>number</replaceable>=<replaceable>filename</replaceable></literal>.
+</para>
+<para>For <literal>openin</literal>, if &tex; cannot find the file then it does not give
+an error.  It just considers that the stream is not open (test for this
+with <literal>\ifeof</literal>; one recourse is the command
+<literal>\InputIfFileExists</literal>, see <link linkend="Class-and-package-commands">Class and package commands</link>).  If you
+try to use the same number twice, &latex; won’t give you an error.  If
+you try to use a bad number then you get an error message like ‘<literal>!
+Bad number (16).  <to be read again> = l.30 \openin16=test.jh</literal>’.
+</para>
+
+</sect1>
+<sect1 label="27.2" id="_005ctypein">
 <title><literal>\typein</literal></title>
 
 <indexterm role="fn"><primary>\typein</primary></indexterm>
@@ -16681,7 +16744,7 @@
 </para>
 
 </sect1>
-<sect1 label="27.2" id="_005ctypeout">
+<sect1 label="27.3" id="_005ctypeout">
 <title><literal>\typeout</literal></title>
 
 <indexterm role="fn"><primary>\typeout</primary></indexterm>
@@ -16718,7 +16781,7 @@
 </para>
 
 </sect1>
-<sect1 label="27.3" id="_005cwrite">
+<sect1 label="27.4" id="_005cwrite">
 <title><literal>\write</literal></title>
 
 <indexterm role="fn"><primary>\write</primary></indexterm>
@@ -16731,16 +16794,6 @@
 opened by <literal>\openout</literal>.  For instance, <literal>\write6</literal> writes to text
 stream number 6.
 </para>
-<indexterm role="cp"><primary>package, <literal>Asymptote</literal></primary></indexterm>
-<indexterm role="cp"><primary><literal>Asymptote</literal> package</primary></indexterm>
-
-<para>&latex; uses the ability to write to a file and later read it back in
-to build document components such as a Table of Contents or Index.  You
-can also output a file that other programs read, for instance by writing
-out an Asymptote graphics source file, having &latex; then run the
-<filename>asymptote</filename> program on that file (see <link linkend="_005cwrite18">\write18</link>), and finally
-bringing that graphic back into the document (see <link linkend="_005cincludegraphics">\includegraphics</link>).
-</para>
 <para>If this appears in <filename><replaceable>basefile</replaceable>.tex</filename> then it opens
 <filename><replaceable>basefile</replaceable>.jh</filename>, writes ‘<literal>Hello World!</literal>’ and a newline to
 it, and closes that file.
@@ -16761,14 +16814,14 @@
 <para>Typically <replaceable>number</replaceable> is between 0 and 15 because typically
 &latex; authors follow the prior example and the number is allocated by
 the system.  If <replaceable>number</replaceable> is outside the range from 0 to 15 or if it
-is not associated with an open file then &latex; writes the string to
+is not associated with an open file then &latex; writes <replaceable>string</replaceable> to
 the log file.  If <replaceable>number</replaceable> is positive then in addition &latex;
-writes <replaceable>string</replaceable> to the terminal.  (But the numbers 16, 17, and 18
-are special; see below.) Thus, <literal>test \write-1{Hello World!}</literal> puts
-‘<literal>Hello World!</literal>’ followed by a newline in the log file.  (This is
-what the <literal>\wlog</literal> command does; see <link linkend="_005cwlog">\wlog</link>).  And
+writes <replaceable>string</replaceable> to the terminal. Thus, <literal>test \write-1{Hello
+World!}</literal> puts ‘<literal>Hello World!</literal>’ followed by a newline in the log
+file.  (This is what the <literal>\wlog</literal> command does; see <link linkend="_005cwlog">\wlog</link>).  And
 <literal>\write100{Hello World!}</literal> puts the same in the log file but also
 puts ‘<literal>Hello World!</literal>’ followed by a newline in the terminal output.
+(But 16, 17, and 18 are special as <replaceable>number</replaceable>; see below.)
 </para>
 <para>In Lua&latex;, instead of 16 output streams there are 256
 (see <link linkend="TeX-engines">&tex; engines</link>).
@@ -16790,15 +16843,16 @@
 \protected at write\@auxout{}{<replaceable>string</replaceable>}
 </screen>
 <para>With the first, &latex; writes <replaceable>string</replaceable> to the file.  Any commands
-in <replaceable>string</replaceable> will be expanded (as in <literal>\edef</literal>, except that you
-should use <literal>#</literal> instead of <literal>##</literal>).  With the second,
-<replaceable>string</replaceable> is stored on the current list of things (as a &tex;
-“whatsit”) and kept until the page is shipped out.  On that list the
-commands are unexpanded until at the time of shipout.  The third,
+in <replaceable>string</replaceable> will be expanded (just as in <literal>\edef</literal> so that to
+prevent expansion you should use <literal>\noexpand</literal> or a <literal>toks</literal>,
+except that you should use <literal>#</literal> instead of <literal>##</literal>).  With the
+second, <replaceable>string</replaceable> is stored on the current list of things (as a
+&tex; “whatsit”) and kept until the page is shipped out and likewise
+the commands are unexpanded until shipout.  The third,
 <literal>\protected at write</literal>, is like the second except that you can use
-<literal>\protect</literal> on fragile commands. In this third case the extra first
-argument allows you to locally insert extra definitions to make more
-commands be safe or have special definition during the write.
+<literal>\protect</literal> on fragile commands. The extra first argument allows you
+to locally insert extra definitions to make more commands be safe or
+have special definition during the write.
 </para>
 <para>Here <replaceable>string</replaceable> contains a control sequence.
 </para>
@@ -16811,23 +16865,24 @@
 followed by a newline.
 </para>
 <para>The cases where <replaceable>number</replaceable> is 16, 17, or 18 are special.  Because of
-<literal>\write<replaceable>number</replaceable></literal>’s behavior when <replaceable>number</replaceable> is outside the
-range from 0 to 15, there is some convention of writing to the log file
-and the terminal with <literal>\write16</literal>.  In the past <literal>\write17</literal> has
-sometimes been used in a similar way.  The <literal>\write18</literal> command is
-even more special; modern &tex; systems use it for issuing commands to
-the operating system (see <link linkend="_005cwrite18">\write18</link>).
+<literal>\write</literal>’s behavior when <replaceable>number</replaceable> is outside the range from 0
+to 15 described above, in Plain &tex; <literal>\write16</literal> and
+<literal>\write17</literal> were sometimes used to write to the log file and the
+terminal.  Note that in &latex; the natural way to do that is with
+<literal>\typeout</literal> (see <link linkend="_005ctypeout">\typeout</link>).  The <literal>\write18</literal> command is even
+more special; modern &tex; systems use it for giving commands to the
+operating system (see <link linkend="_005cwrite18">\write18</link>).
 </para>
 <para>Ordinarily <literal>\write</literal> outputs a single line.  Put in a newline with
 <literal>^^J</literal>.  Thus, this produces two lines in the log file.
 </para>
-<screen>\wlog{Parallel Lines have a lot in common.^^JBut they never meet.}
+<screen>\wlog{Parallel lines have a lot in common.^^JBut they never meet.}
 </screen>
-<para>Writing arbitrary files has obvious security problems.  If you
-downloaded a &latex; file and compiling it overwrote your password file
-then you would be annoyed.  &tex; systems by default only allow you to
-open files for writing that are in the current directory or in a
-subdirectory.  This example
+<para>The ability to Write files raises security issues.  If you compiled a
+downloaded &latex; file and it overwrote your password file then you
+would be annoyed.  &tex; systems by default only allow you to open
+files for writing that are in the current directory or in a
+subdirectory.  This
 </para>
 <screen>\newwrite\jhfile
 \openout\jhfile=../test.jh
@@ -16836,20 +16891,20 @@
 I can't write on file `../test.jh'</literal>’.  Note that you can get such an
 error when trying to use commands such as <literal>\include{../filename}</literal>
 because &latex; will try to open <filename>../filename.aux</filename>.  The simplest
-solution is to put the included files in the same directory or
-subdirectories of the master file.
+solution is to put the included files in the same directory as the
+master file, or in subdirectories.
 </para>
 <indexterm role="cp"><primary>package, <literal>answers</literal></primary></indexterm>
 <indexterm role="cp"><primary><literal>answers</literal> package</primary></indexterm>
 
-<para>If you want that the material you write is output verbatim, without
-expanding the commands, for instance to write answers to exercises, then
-look at the <filename>answers</filename> package on CTAN.
+<para>A common case where authors want to write a file not already provided by
+&latex; is for answers to exercises, or some other situation where you
+want to write out verbatim, without expanding the commands.  CTAN has a
+number of packages for this; one is <filename>answers</filename>.
 </para>
 
 
-
-<sect2 label="27.3.1" id="_005cmessage">
+<sect2 label="27.4.1" id="_005cmessage">
 <title><literal>\message</literal></title>
 
 <indexterm role="fn"><primary>\message</primary></indexterm>
@@ -16899,7 +16954,7 @@
 </para>
 
 </sect2>
-<sect2 label="27.3.2" id="_005cwlog">
+<sect2 label="27.4.2" id="_005cwlog">
 <title><literal>\wlog</literal></title>
 
 <indexterm role="fn"><primary>\wlog</primary></indexterm>
@@ -16921,7 +16976,7 @@
 </screen>
 
 </sect2>
-<sect2 label="27.3.3" id="_005cwrite18">
+<sect2 label="27.4.3" id="_005cwrite18">
 <title><literal>\write18</literal></title>
 
 <indexterm role="fn"><primary>\write18</primary></indexterm>
@@ -16948,29 +17003,29 @@
 \immediate\write18{cd pix && asy figure\fignum}
 \includegraphics{pix\figure\fignum.pdf}
 </screen>
-<para>will run <filename>Asymptote</filename> on <filename>figure1.asy</filename>, so that the document
-can later read in the resulting graphic (see <link linkend="_005cincludegraphics">\includegraphics</link>).
+<para>will run <filename>Asymptote</filename> on <filename>pix/figure1.asy</filename>, so that the
+document can later read in the resulting graphic
+(see <link linkend="_005cincludegraphics">\includegraphics</link>).  Like any <literal>\write</literal>, here &latex;
+expands macros in <replaceable>shell_command</replaceable> so that <literal>\fignum</literal> is replaced
+by ‘<literal>1</literal>’.
 </para>
 <para>Another example is that you can automatically run Bib&tex; at the start
 of each &latex; run (see <link linkend="Using-BibTeX">Using BibTeX</link>) by including
 <literal>\immediate\write18{bibtex8 \jobname}</literal> as the first line of the
-file.  Like any <literal>\write</literal>, here &latex; expands macros in
-<replaceable>shell_command</replaceable> so that <literal>\jobname</literal> gives the base name of the
-current file.
+file.  Note that <literal>\jobname</literal> gives the base name of the current
+file.
 </para>
 <para>You sometimes need to do a multi-step process to get the information
-that you want.  This will get a list of all PDF files in the current
-directory.
+that you want.  This will insert into the input a list of all PDF files
+in the current directory.
 </para>
 <screen>\immediate\write18{ls *.pdf > tmp.dat}
 \input{tmp.dat}
 </screen>
 <para>The standard behaviour of any <literal>\write</literal> is to wait until a page is
 being shipped out before expanding the macros or writing to the stream
-(see <link linkend="_005cwrite">\write</link>). But sometimes you want it done now.  The command
-<literal>\immediate\write18{<replaceable>shell_command</replaceable>}</literal> will send
-<replaceable>shell_command</replaceable> to the operating system for execution now, rather
-than waiting until the next shipout.
+(see <link linkend="_005cwrite">\write</link>). But sometimes you want it done now.  For this, use
+<literal>\immediate\write18{<replaceable>shell_command</replaceable>}</literal>.
 </para>
 <para>There are obvious security issues with allowing system commands inside a
 &latex; file.  If you download a file off the net and it contains
@@ -16986,14 +17041,16 @@
 run MetaFont to generate missing fonts, even if you do not use the
 <literal>shell-escape</literal> or <literal>enable-write18</literal> option. By default this
 list of allowed commands is short and features only commands that are
-under the control of the distribution maintainers.
+under the control of the distribution maintainers (see <link linkend="Command-line-options">Command line
+options</link>).
 </para>
 <para>Some packages need to run external system commands. For instance
 <filename>sagetex</filename> allows you to have the mathematics software system
 <emphasis>Sage</emphasis> do calculations or draw graphs and then incorporate that output
 in your document. For this you must compile with full <literal>\write18</literal>
-capability turned on (see <link linkend="Command-line-options">Command line options</link>).
+capability turned on.
 </para>
+
 </sect2>
 </sect1>
 </chapter>

Modified: trunk/latex2e.dvi
===================================================================
(Binary files differ)

Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e.html	2018-10-21 21:39:31 UTC (rev 716)
@@ -525,13 +525,14 @@
   </ul></li>
   <li><a name="toc-Input_002foutput-1" href="#Input_002foutput">27 Input/output</a>
   <ul class="no-bullet">
-    <li><a name="toc-_005ctypein-1" href="#g_t_005ctypein">27.1 <code>\typein</code></a></li>
-    <li><a name="toc-_005ctypeout-1" href="#g_t_005ctypeout">27.2 <code>\typeout</code></a></li>
-    <li><a name="toc-_005cwrite-1" href="#g_t_005cwrite">27.3 <code>\write</code></a>
+    <li><a name="toc-_005copenin-_0026-_005copenout-1" href="#g_t_005copenin-_0026-_005copenout">27.1 <code>\openin</code> & <code>\openout</code></a></li>
+    <li><a name="toc-_005ctypein-1" href="#g_t_005ctypein">27.2 <code>\typein</code></a></li>
+    <li><a name="toc-_005ctypeout-1" href="#g_t_005ctypeout">27.3 <code>\typeout</code></a></li>
+    <li><a name="toc-_005cwrite-1" href="#g_t_005cwrite">27.4 <code>\write</code></a>
     <ul class="no-bullet">
-      <li><a name="toc-_005cmessage-1" href="#g_t_005cmessage">27.3.1 <code>\message</code></a></li>
-      <li><a name="toc-_005cwlog-1" href="#g_t_005cwlog">27.3.2 <code>\wlog</code></a></li>
-      <li><a name="toc-_005cwrite18-1" href="#g_t_005cwrite18">27.3.3 <code>\write18</code></a></li>
+      <li><a name="toc-_005cmessage-1" href="#g_t_005cmessage">27.4.1 <code>\message</code></a></li>
+      <li><a name="toc-_005cwlog-1" href="#g_t_005cwlog">27.4.2 <code>\wlog</code></a></li>
+      <li><a name="toc-_005cwrite18-1" href="#g_t_005cwrite18">27.4.3 <code>\write18</code></a></li>
     </ul></li>
   </ul></li>
   <li><a name="toc-Command-line-1" href="#Command-line">28 Command line</a>
@@ -21811,9 +21812,6 @@
 (see <a href="#Graphics">Graphics</a>).
 </p>
 
-
-
-
 <hr>
 <a name="g_t_005ctelephone"></a>
 <div class="header">
@@ -21848,25 +21846,121 @@
 
 <a name="index-input_002foutput_002c-to-terminal"></a>
 <a name="index-terminal-input_002foutput"></a>
+<a name="index-input_002foutput"></a>
 
+<p>LaTeX uses the ability to write to a file and later read it back in
+to build document components such as a table of contents or index.  You
+can also read a file that other programs written, or write a file for
+others to read.  You can communicate with users through the terminal.
+And, you can issue instructions for the operating system.
+</p>
 <table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#g_t_005ctypein" accesskey="1">\typein</a>:</td><td>  </td><td align="left" valign="top">Read text from the terminal.
+<tr><td align="left" valign="top">• <a href="#g_t_005copenin-_0026-_005copenout" accesskey="1">\openin & \openout</a>:</td><td>  </td><td align="left" valign="top">Open a file.
 </td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_005ctypeout" accesskey="2">\typeout</a>:</td><td>  </td><td align="left" valign="top">Write text to the terminal.
+<tr><td align="left" valign="top">• <a href="#g_t_005ctypein" accesskey="2">\typein</a>:</td><td>  </td><td align="left" valign="top">Read text from the terminal.
 </td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_005cwrite" accesskey="3">\write</a>:</td><td>  </td><td align="left" valign="top">Write text to a file or terminal.
+<tr><td align="left" valign="top">• <a href="#g_t_005ctypeout" accesskey="3">\typeout</a>:</td><td>  </td><td align="left" valign="top">Write text to the terminal.
 </td></tr>
+<tr><td align="left" valign="top">• <a href="#g_t_005cwrite" accesskey="4">\write</a>:</td><td>  </td><td align="left" valign="top">Write text to a file or terminal.
+</td></tr>
 </table>
 
 
 <hr>
+<a name="g_t_005copenin-_0026-_005copenout"></a>
+<div class="header">
+<p>
+Next: <a href="#g_t_005ctypein" accesskey="n" rel="next">\typein</a>, Up: <a href="#Input_002foutput" accesskey="u" rel="up">Input/output</a>   [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="g_t_005copenin-_0026-_005copenout-1"></a>
+<h3 class="section">27.1 <code>\openin</code> & <code>\openout</code></h3>
+
+<a name="index-_005copenin"></a>
+<a name="index-_005copenout"></a>
+<a name="index-_005cclosein"></a>
+<a name="index-_005ccloseout"></a>
+<a name="index-file_002c-opening"></a>
+<a name="index-file_002c-closing"></a>
+<a name="index-open-a-file"></a>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\openin<var>number</var>=<var>filename</var>
+</pre></div>
+
+<p>or:
+</p>
+<div class="example">
+<pre class="example">\openout<var>number</var>=<var>filename</var>
+</pre></div>
+
+<p>Open a file for reading material, or for writing it.  The <var>number</var>
+must be between 0 and 15, as in <code>\openin3</code> (in LuaLaTeX
+<var>number</var> can be between 0 and 255).
+</p>
+<p>Here TeX opens the file <samp>presidents.tex</samp> for reading.
+</p>
+<div class="example">
+<pre class="example">\newread\presidentsfile
+\openin\presidentsfile=presidents
+\typeout{presidentsfile is \the\presidentsfile}
+\read\presidentsfile to\presidentline
+\typeout{\presidentline}
+</pre></div>
+
+<p>The <code>\newread</code> command allocates input stream numbers from 0
+to 15, (there is also a <code>\newwrite</code>).  Being able to work not
+with a number but with the more memorable <code>\presidentsfile</code> is just
+a convenience; the first line typed out is something like
+‘<samp>presidentsfile is 1</samp>’.  The second line is like ‘<samp>1 Washington,
+George</samp>’.
+</p>
+<p>Close files with <code>\closein<var>number</var></code> and
+<code>\closeout<var>number</var></code>.
+</p>
+<p>How LaTeX handles filenames varies among distributions, and even can
+vary among versions of a distribution.  If the file does not have an
+extension then TeX will add a <samp>.tex</samp>.  This creates
+<samp>presidents.tex</samp>, writes one line to it, and closes it.
+</p>
+<div class="example">
+<pre class="example">\newwrite\presidentsfile
+\openout\presidentsfile=presidents
+\write\presidentsfile{1 Washington, George}
+\closeout\presidentsfile
+</pre></div>
+
+<p>But filenames with a period can cause trouble: if TeX finds a
+<var>filename</var> of <samp>presidents.dat</samp> it could look first for
+<samp>presidents.dat.tex</samp> and later for <samp>presidents.dat</samp>, or it
+could do the opposite.  Your distribution’s documentation should say
+more, and if you find something that works for you then you are good,
+but to ensure complete portability the best thing is to use file names
+containing only the twenty six ASCII letters (not case-sensitive), along
+with underscore and dash, and no dot or space.
+</p>
+<p>Ordinarily TeX will not try to open the file until the next page
+shipout. To change this, use
+<code>\immediate\openin<var>number</var>=<var>filename</var></code>.
+</p>
+<p>For <code>openin</code>, if TeX cannot find the file then it does not give
+an error.  It just considers that the stream is not open (test for this
+with <code>\ifeof</code>; one recourse is the command
+<code>\InputIfFileExists</code>, see <a href="#Class-and-package-commands">Class and package commands</a>).  If you
+try to use the same number twice, LaTeX won’t give you an error.  If
+you try to use a bad number then you get an error message like ‘<samp>!
+Bad number (16).  <to be read again> = l.30 \openin16=test.jh</samp>’.
+</p>
+
+<hr>
 <a name="g_t_005ctypein"></a>
 <div class="header">
 <p>
-Next: <a href="#g_t_005ctypeout" accesskey="n" rel="next">\typeout</a>, Up: <a href="#Input_002foutput" accesskey="u" rel="up">Input/output</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="#g_t_005ctypeout" accesskey="n" rel="next">\typeout</a>, Previous: <a href="#g_t_005copenin-_0026-_005copenout" accesskey="p" rel="prev">\openin & \openout</a>, Up: <a href="#Input_002foutput" accesskey="u" rel="up">Input/output</a>   [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
 </div>
 <a name="g_t_005ctypein-1"></a>
-<h3 class="section">27.1 <code>\typein</code></h3>
+<h3 class="section">27.2 <code>\typein</code></h3>
 
 <a name="index-_005ctypein"></a>
 
@@ -21930,7 +22024,7 @@
 Next: <a href="#g_t_005cwrite" accesskey="n" rel="next">\write</a>, Previous: <a href="#g_t_005ctypein" accesskey="p" rel="prev">\typein</a>, Up: <a href="#Input_002foutput" accesskey="u" rel="up">Input/output</a>   [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
 </div>
 <a name="g_t_005ctypeout-1"></a>
-<h3 class="section">27.2 <code>\typeout</code></h3>
+<h3 class="section">27.3 <code>\typeout</code></h3>
 
 <a name="index-_005ctypeout"></a>
 
@@ -21978,7 +22072,7 @@
 Previous: <a href="#g_t_005ctypeout" accesskey="p" rel="prev">\typeout</a>, Up: <a href="#Input_002foutput" accesskey="u" rel="up">Input/output</a>   [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
 </div>
 <a name="g_t_005cwrite-1"></a>
-<h3 class="section">27.3 <code>\write</code></h3>
+<h3 class="section">27.4 <code>\write</code></h3>
 
 <a name="index-_005cwrite"></a>
 
@@ -21992,16 +22086,6 @@
 opened by <code>\openout</code>.  For instance, <code>\write6</code> writes to text
 stream number 6.
 </p>
-<a name="index-package_002c-Asymptote-3"></a>
-<a name="index-Asymptote-package-3"></a>
-
-<p>LaTeX uses the ability to write to a file and later read it back in
-to build document components such as a Table of Contents or Index.  You
-can also output a file that other programs read, for instance by writing
-out an Asymptote graphics source file, having LaTeX then run the
-<samp>asymptote</samp> program on that file (see <a href="#g_t_005cwrite18">\write18</a>), and finally
-bringing that graphic back into the document (see <a href="#g_t_005cincludegraphics">\includegraphics</a>).
-</p>
 <p>If this appears in <samp><var>basefile</var>.tex</samp> then it opens
 <samp><var>basefile</var>.jh</samp>, writes ‘<samp>Hello World!</samp>’ and a newline to
 it, and closes that file.
@@ -22024,14 +22108,14 @@
 <p>Typically <var>number</var> is between 0 and 15 because typically
 LaTeX authors follow the prior example and the number is allocated by
 the system.  If <var>number</var> is outside the range from 0 to 15 or if it
-is not associated with an open file then LaTeX writes the string to
+is not associated with an open file then LaTeX writes <var>string</var> to
 the log file.  If <var>number</var> is positive then in addition LaTeX
-writes <var>string</var> to the terminal.  (But the numbers 16, 17, and 18
-are special; see below.) Thus, <code>test \write-1{Hello World!}</code> puts
-‘<samp>Hello World!</samp>’ followed by a newline in the log file.  (This is
-what the <code>\wlog</code> command does; see <a href="#g_t_005cwlog">\wlog</a>).  And
+writes <var>string</var> to the terminal. Thus, <code>test \write-1{Hello
+World!}</code> puts ‘<samp>Hello World!</samp>’ followed by a newline in the log
+file.  (This is what the <code>\wlog</code> command does; see <a href="#g_t_005cwlog">\wlog</a>).  And
 <code>\write100{Hello World!}</code> puts the same in the log file but also
 puts ‘<samp>Hello World!</samp>’ followed by a newline in the terminal output.
+(But 16, 17, and 18 are special as <var>number</var>; see below.)
 </p>
 <p>In LuaLaTeX, instead of 16 output streams there are 256
 (see <a href="#TeX-engines">TeX engines</a>).
@@ -22054,15 +22138,16 @@
 </pre></div>
 
 <p>With the first, LaTeX writes <var>string</var> to the file.  Any commands
-in <var>string</var> will be expanded (as in <code>\edef</code>, except that you
-should use <code>#</code> instead of <code>##</code>).  With the second,
-<var>string</var> is stored on the current list of things (as a TeX
-“whatsit”) and kept until the page is shipped out.  On that list the
-commands are unexpanded until at the time of shipout.  The third,
+in <var>string</var> will be expanded (just as in <code>\edef</code> so that to
+prevent expansion you should use <code>\noexpand</code> or a <code>toks</code>,
+except that you should use <code>#</code> instead of <code>##</code>).  With the
+second, <var>string</var> is stored on the current list of things (as a
+TeX “whatsit”) and kept until the page is shipped out and likewise
+the commands are unexpanded until shipout.  The third,
 <code>\protected at write</code>, is like the second except that you can use
-<code>\protect</code> on fragile commands. In this third case the extra first
-argument allows you to locally insert extra definitions to make more
-commands be safe or have special definition during the write.
+<code>\protect</code> on fragile commands. The extra first argument allows you
+to locally insert extra definitions to make more commands be safe or
+have special definition during the write.
 </p>
 <p>Here <var>string</var> contains a control sequence.
 </p>
@@ -22077,25 +22162,26 @@
 followed by a newline.
 </p>
 <p>The cases where <var>number</var> is 16, 17, or 18 are special.  Because of
-<code>\write<var>number</var></code>’s behavior when <var>number</var> is outside the
-range from 0 to 15, there is some convention of writing to the log file
-and the terminal with <code>\write16</code>.  In the past <code>\write17</code> has
-sometimes been used in a similar way.  The <code>\write18</code> command is
-even more special; modern TeX systems use it for issuing commands to
-the operating system (see <a href="#g_t_005cwrite18">\write18</a>).
+<code>\write</code>’s behavior when <var>number</var> is outside the range from 0
+to 15 described above, in Plain TeX <code>\write16</code> and
+<code>\write17</code> were sometimes used to write to the log file and the
+terminal.  Note that in LaTeX the natural way to do that is with
+<code>\typeout</code> (see <a href="#g_t_005ctypeout">\typeout</a>).  The <code>\write18</code> command is even
+more special; modern TeX systems use it for giving commands to the
+operating system (see <a href="#g_t_005cwrite18">\write18</a>).
 </p>
 <p>Ordinarily <code>\write</code> outputs a single line.  Put in a newline with
 <code>^^J</code>.  Thus, this produces two lines in the log file.
 </p>
 <div class="example">
-<pre class="example">\wlog{Parallel Lines have a lot in common.^^JBut they never meet.}
+<pre class="example">\wlog{Parallel lines have a lot in common.^^JBut they never meet.}
 </pre></div>
 
-<p>Writing arbitrary files has obvious security problems.  If you
-downloaded a LaTeX file and compiling it overwrote your password file
-then you would be annoyed.  TeX systems by default only allow you to
-open files for writing that are in the current directory or in a
-subdirectory.  This example
+<p>The ability to Write files raises security issues.  If you compiled a
+downloaded LaTeX file and it overwrote your password file then you
+would be annoyed.  TeX systems by default only allow you to open
+files for writing that are in the current directory or in a
+subdirectory.  This
 </p>
 <div class="example">
 <pre class="example">\newwrite\jhfile
@@ -22106,17 +22192,17 @@
 I can't write on file `../test.jh'</samp>’.  Note that you can get such an
 error when trying to use commands such as <code>\include{../filename}</code>
 because LaTeX will try to open <samp>../filename.aux</samp>.  The simplest
-solution is to put the included files in the same directory or
-subdirectories of the master file.
+solution is to put the included files in the same directory as the
+master file, or in subdirectories.
 </p>
 <a name="index-package_002c-answers"></a>
 <a name="index-answers-package"></a>
 
-<p>If you want that the material you write is output verbatim, without
-expanding the commands, for instance to write answers to exercises, then
-look at the <samp>answers</samp> package on CTAN.
+<p>A common case where authors want to write a file not already provided by
+LaTeX is for answers to exercises, or some other situation where you
+want to write out verbatim, without expanding the commands.  CTAN has a
+number of packages for this; one is <samp>answers</samp>.
 </p>
-
 <table class="menu" border="0" cellspacing="0">
 <tr><td align="left" valign="top">• <a href="#g_t_005cmessage" accesskey="1">\message</a>:</td><td>  </td><td align="left" valign="top">Write part of a line to log file and terminal.
 </td></tr>
@@ -22134,7 +22220,7 @@
 Next: <a href="#g_t_005cwlog" accesskey="n" rel="next">\wlog</a>, Up: <a href="#g_t_005cwrite" accesskey="u" rel="up">\write</a>   [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
 </div>
 <a name="g_t_005cmessage-1"></a>
-<h4 class="subsection">27.3.1 <code>\message</code></h4>
+<h4 class="subsection">27.4.1 <code>\message</code></h4>
 
 <a name="index-_005cmessage"></a>
 
@@ -22197,7 +22283,7 @@
 Next: <a href="#g_t_005cwrite18" accesskey="n" rel="next">\write18</a>, Previous: <a href="#g_t_005cmessage" accesskey="p" rel="prev">\message</a>, Up: <a href="#g_t_005cwrite" accesskey="u" rel="up">\write</a>   [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
 </div>
 <a name="g_t_005cwlog-1"></a>
-<h4 class="subsection">27.3.2 <code>\wlog</code></h4>
+<h4 class="subsection">27.4.2 <code>\wlog</code></h4>
 
 <a name="index-_005cwlog"></a>
 
@@ -22230,7 +22316,7 @@
 Previous: <a href="#g_t_005cwlog" accesskey="p" rel="prev">\wlog</a>, Up: <a href="#g_t_005cwrite" accesskey="u" rel="up">\write</a>   [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
 </div>
 <a name="g_t_005cwrite18-1"></a>
-<h4 class="subsection">27.3.3 <code>\write18</code></h4>
+<h4 class="subsection">27.4.3 <code>\write18</code></h4>
 
 <a name="index-_005cwrite18"></a>
 <a name="index-external-commands"></a>
@@ -22246,8 +22332,8 @@
 runs the command and LaTeX’s execution is blocked until that
 finishes.
 </p>
-<a name="index-package_002c-Asymptote-4"></a>
-<a name="index-Asymptote-package-4"></a>
+<a name="index-package_002c-Asymptote-3"></a>
+<a name="index-Asymptote-package-3"></a>
 
 <p>This
 </p>
@@ -22259,19 +22345,21 @@
 \includegraphics{pix\figure\fignum.pdf}
 </pre></div>
 
-<p>will run <samp>Asymptote</samp> on <samp>figure1.asy</samp>, so that the document
-can later read in the resulting graphic (see <a href="#g_t_005cincludegraphics">\includegraphics</a>).
+<p>will run <samp>Asymptote</samp> on <samp>pix/figure1.asy</samp>, so that the
+document can later read in the resulting graphic
+(see <a href="#g_t_005cincludegraphics">\includegraphics</a>).  Like any <code>\write</code>, here LaTeX
+expands macros in <var>shell_command</var> so that <code>\fignum</code> is replaced
+by ‘<samp>1</samp>’.
 </p>
 <p>Another example is that you can automatically run BibTeX at the start
 of each LaTeX run (see <a href="#Using-BibTeX">Using BibTeX</a>) by including
 <code>\immediate\write18{bibtex8 \jobname}</code> as the first line of the
-file.  Like any <code>\write</code>, here LaTeX expands macros in
-<var>shell_command</var> so that <code>\jobname</code> gives the base name of the
-current file.
+file.  Note that <code>\jobname</code> gives the base name of the current
+file.
 </p>
 <p>You sometimes need to do a multi-step process to get the information
-that you want.  This will get a list of all PDF files in the current
-directory.
+that you want.  This will insert into the input a list of all PDF files
+in the current directory.
 </p>
 <div class="example">
 <pre class="example">\immediate\write18{ls *.pdf > tmp.dat}
@@ -22280,10 +22368,8 @@
 
 <p>The standard behaviour of any <code>\write</code> is to wait until a page is
 being shipped out before expanding the macros or writing to the stream
-(see <a href="#g_t_005cwrite">\write</a>). But sometimes you want it done now.  The command
-<code>\immediate\write18{<var>shell_command</var>}</code> will send
-<var>shell_command</var> to the operating system for execution now, rather
-than waiting until the next shipout.
+(see <a href="#g_t_005cwrite">\write</a>). But sometimes you want it done now.  For this, use
+<code>\immediate\write18{<var>shell_command</var>}</code>.
 </p>
 <p>There are obvious security issues with allowing system commands inside a
 LaTeX file.  If you download a file off the net and it contains
@@ -22299,14 +22385,15 @@
 run MetaFont to generate missing fonts, even if you do not use the
 <code>shell-escape</code> or <code>enable-write18</code> option. By default this
 list of allowed commands is short and features only commands that are
-under the control of the distribution maintainers.
+under the control of the distribution maintainers (see <a href="#Command-line-options">Command line options</a>).
 </p>
 <p>Some packages need to run external system commands. For instance
 <samp>sagetex</samp> allows you to have the mathematics software system
 <i>Sage</i> do calculations or draw graphs and then incorporate that output
 in your document. For this you must compile with full <code>\write18</code>
-capability turned on (see <a href="#Command-line-options">Command line options</a>).
+capability turned on.
 </p>
+
 <hr>
 <a name="Command-line"></a>
 <div class="header">
@@ -23203,6 +23290,8 @@
 <tr><td></td><td valign="top"><a href="#index-_005ccleardoublepage"><code>\cleardoublepage</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cclearpage-_0026-_005ccleardoublepage">\clearpage & \cleardoublepage</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-_005cclearpage"><code>\clearpage</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cclearpage-_0026-_005ccleardoublepage">\clearpage & \cleardoublepage</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-_005ccline"><code>\cline</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ccline">\cline</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cclosein"><code>\closein</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005ccloseout"><code>\closeout</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-_005cclosing"><code>\closing</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cclosing">\closing</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-_005cclubsuit"><code>\clubsuit</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-_005ccolon"><code>\colon</code></a>:</td><td> </td><td valign="top"><a href="#Colon-character-_0026-_005ccolon">Colon character & \colon</a></td></tr>
@@ -23590,7 +23679,9 @@
 <tr><td></td><td valign="top"><a href="#index-_005comega"><code>\omega</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-_005cominus"><code>\ominus</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-_005conecolumn"><code>\onecolumn</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005conecolumn">\onecolumn</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005copenin"><code>\openin</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-_005copening"><code>\opening</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005copening">\opening</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005copenout"><code>\openout</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-_005coplus"><code>\oplus</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-_005cOptionNotUsed"><code>\OptionNotUsed</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-_005coslash"><code>\oslash</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
@@ -24031,8 +24122,7 @@
 <tr><td></td><td valign="top"><a href="#index-Asymptote-package"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-Asymptote-package-1"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cstrut">\strut</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-Asymptote-package-2"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox & \makebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Asymptote-package-3"><code>Asymptote</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cwrite">\write</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Asymptote-package-4"><code>Asymptote</code> <span class="roman">package</span></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-Asymptote-package-3"><code>Asymptote</code> <span class="roman">package</span></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-at-clause_002c-in-font-definitions">at clause, in font definitions</a>:</td><td> </td><td valign="top"><a href="#g_t_005cnewfont">\newfont</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-at_002dsign"><code>at-sign</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005c_0040">\@</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-author_002c-for-titlepage">author, for titlepage</a>:</td><td> </td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
@@ -24361,6 +24451,8 @@
 <tr><td></td><td valign="top"><a href="#index-figure-number_002c-cross-referencing">figure number, cross referencing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-figures_002c-footnotes-in">figures, footnotes in</a>:</td><td> </td><td valign="top"><a href="#minipage">minipage</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-figures_002c-inserting">figures, inserting</a>:</td><td> </td><td valign="top"><a href="#figure">figure</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-file_002c-closing">file, closing</a>:</td><td> </td><td valign="top"><a href="#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-file_002c-opening">file, opening</a>:</td><td> </td><td valign="top"><a href="#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-file_002c-root">file, root</a>:</td><td> </td><td valign="top"><a href="#Splitting-the-input">Splitting the input</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-filecontents-environment"><code><code>filecontents</code> <span class="roman">environment</span></code></a>:</td><td> </td><td valign="top"><a href="#filecontents">filecontents</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-filecontents_002a-environment"><code><code>filecontents*</code> <span class="roman">environment</span></code></a>:</td><td> </td><td valign="top"><a href="#filecontents">filecontents</a></td></tr>
@@ -24495,6 +24587,7 @@
 <tr><td></td><td valign="top"><a href="#index-inner-paragraph-mode">inner paragraph mode</a>:</td><td> </td><td valign="top"><a href="#Modes">Modes</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-input-file">input file</a>:</td><td> </td><td valign="top"><a href="#Splitting-the-input">Splitting the input</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-input_002c-on-command-line">input, on command line</a>:</td><td> </td><td valign="top"><a href="#Command-line-input">Command line input</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-input_002foutput">input/output</a>:</td><td> </td><td valign="top"><a href="#Input_002foutput">Input/output</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-input_002foutput_002c-to-terminal">input/output, to terminal</a>:</td><td> </td><td valign="top"><a href="#Input_002foutput">Input/output</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-inserting-figures">inserting figures</a>:</td><td> </td><td valign="top"><a href="#figure">figure</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-insertions-of-special-characters">insertions of special characters</a>:</td><td> </td><td valign="top"><a href="#Special-insertions">Special insertions</a></td></tr>
@@ -24690,6 +24783,7 @@
 <tr><td></td><td valign="top"><a href="#index-one_002dcolumn-output">one-column output</a>:</td><td> </td><td valign="top"><a href="#g_t_005conecolumn">\onecolumn</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-onecolumn-option"><code>onecolumn <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-oneside-option"><code>oneside <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-open-a-file">open a file</a>:</td><td> </td><td valign="top"><a href="#g_t_005copenin-_0026-_005copenout">\openin & \openout</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-openany-option"><code>openany <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-openbib-option"><code>openbib <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-opening-quote">opening quote</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
@@ -24737,8 +24831,7 @@
 <tr><td></td><td valign="top"><a href="#index-package_002c-Asymptote"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cline">\line</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-Asymptote-1"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cstrut">\strut</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-Asymptote-2"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cmbox-_0026-_005cmakebox">\mbox & \makebox</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-Asymptote-3"><span class="roman">package</span>, <code>Asymptote</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cwrite">\write</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package_002c-Asymptote-4"><span class="roman">package</span>, <code>Asymptote</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-Asymptote-3"><span class="roman">package</span>, <code>Asymptote</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-babel"><span class="roman">package</span>, <code>babel</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cchapter">\chapter</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-babel-1"><span class="roman">package</span>, <code>babel</code></a>:</td><td> </td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-babel-2"><span class="roman">package</span>, <code>babel</code></a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>

Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e.info	2018-10-21 21:39:31 UTC (rev 716)
@@ -14703,16 +14703,87 @@
 27 Input/output
 ***************
 
+LaTeX uses the ability to write to a file and later read it back in to
+build document components such as a table of contents or index.  You can
+also read a file that other programs written, or write a file for others
+to read.  You can communicate with users through the terminal.  And, you
+can issue instructions for the operating system.
+
 * Menu:
 
+* \openin & \openout::  Open a file.
 * \typein::             Read text from the terminal.
 * \typeout::            Write text to the terminal.
 * \write::              Write text to a file or terminal.
 
 
-File: latex2e.info,  Node: \typein,  Next: \typeout,  Up: Input/output
+File: latex2e.info,  Node: \openin & \openout,  Next: \typein,  Up: Input/output
 
-27.1 '\typein'
+27.1 '\openin' & '\openout'
+===========================
+
+Synopsis:
+
+     \openinNUMBER=FILENAME
+
+   or:
+
+     \openoutNUMBER=FILENAME
+
+   Open a file for reading material, or for writing it.  The NUMBER must
+be between 0 and 15, as in '\openin3' (in LuaLaTeX NUMBER can be between
+0 and 255).
+
+   Here TeX opens the file 'presidents.tex' for reading.
+
+     \newread\presidentsfile
+     \openin\presidentsfile=presidents
+     \typeout{presidentsfile is \the\presidentsfile}
+     \read\presidentsfile to\presidentline
+     \typeout{\presidentline}
+
+The '\newread' command allocates input stream numbers from 0 to 15,
+(there is also a '\newwrite').  Being able to work not with a number but
+with the more memorable '\presidentsfile' is just a convenience; the
+first line typed out is something like 'presidentsfile is 1'.  The
+second line is like '1 Washington, George'.
+
+   Close files with '\closeinNUMBER' and '\closeoutNUMBER'.
+
+   How LaTeX handles filenames varies among distributions, and even can
+vary among versions of a distribution.  If the file does not have an
+extension then TeX will add a '.tex'.  This creates 'presidents.tex',
+writes one line to it, and closes it.
+
+     \newwrite\presidentsfile
+     \openout\presidentsfile=presidents
+     \write\presidentsfile{1 Washington, George}
+     \closeout\presidentsfile
+
+But filenames with a period can cause trouble: if TeX finds a FILENAME
+of 'presidents.dat' it could look first for 'presidents.dat.tex' and
+later for 'presidents.dat', or it could do the opposite.  Your
+distribution's documentation should say more, and if you find something
+that works for you then you are good, but to ensure complete portability
+the best thing is to use file names containing only the twenty six ASCII
+letters (not case-sensitive), along with underscore and dash, and no dot
+or space.
+
+   Ordinarily TeX will not try to open the file until the next page
+shipout.  To change this, use '\immediate\openinNUMBER=FILENAME'.
+
+   For 'openin', if TeX cannot find the file then it does not give an
+error.  It just considers that the stream is not open (test for this
+with '\ifeof'; one recourse is the command '\InputIfFileExists', *note
+Class and package commands::).  If you try to use the same number twice,
+LaTeX won't give you an error.  If you try to use a bad number then you
+get an error message like '! Bad number (16). <to be read again> = l.30
+\openin16=test.jh'.
+
+
+File: latex2e.info,  Node: \typein,  Next: \typeout,  Prev: \openin & \openout,  Up: Input/output
+
+27.2 '\typein'
 ==============
 
 Synopsis, one of:
@@ -14760,7 +14831,7 @@
 
 File: latex2e.info,  Node: \typeout,  Next: \write,  Prev: \typein,  Up: Input/output
 
-27.2 '\typeout'
+27.3 '\typeout'
 ===============
 
 Synopsis:
@@ -14796,7 +14867,7 @@
 
 File: latex2e.info,  Node: \write,  Prev: \typeout,  Up: Input/output
 
-27.3 '\write'
+27.4 '\write'
 =============
 
 Synopsis:
@@ -14806,13 +14877,6 @@
    Write 'string' to the log file, to the terminal, or to a file opened
 by '\openout'.  For instance, '\write6' writes to text stream number 6.
 
-   LaTeX uses the ability to write to a file and later read it back in
-to build document components such as a Table of Contents or Index.  You
-can also output a file that other programs read, for instance by writing
-out an Asymptote graphics source file, having LaTeX then run the
-'asymptote' program on that file (*note \write18::), and finally
-bringing that graphic back into the document (*note \includegraphics::).
-
    If this appears in 'BASEFILE.tex' then it opens 'BASEFILE.jh', writes
 'Hello World!' and a newline to it, and closes that file.
 
@@ -14832,13 +14896,13 @@
    Typically NUMBER is between 0 and 15 because typically LaTeX authors
 follow the prior example and the number is allocated by the system.  If
 NUMBER is outside the range from 0 to 15 or if it is not associated with
-an open file then LaTeX writes the string to the log file.  If NUMBER is
-positive then in addition LaTeX writes STRING to the terminal.  (But the
-numbers 16, 17, and 18 are special; see below.)  Thus, 'test
-\write-1{Hello World!}' puts 'Hello World!' followed by a newline in the
-log file.  (This is what the '\wlog' command does; *note \wlog::).  And
-'\write100{Hello World!}' puts the same in the log file but also puts
-'Hello World!' followed by a newline in the terminal output.
+an open file then LaTeX writes STRING to the log file.  If NUMBER is
+positive then in addition LaTeX writes STRING to the terminal.  Thus,
+'test \write-1{Hello World!}' puts 'Hello World!' followed by a newline
+in the log file.  (This is what the '\wlog' command does; *note
+\wlog::).  And '\write100{Hello World!}' puts the same in the log file
+but also puts 'Hello World!' followed by a newline in the terminal
+output.  (But 16, 17, and 18 are special as NUMBER; see below.)
 
    In LuaLaTeX, instead of 16 output streams there are 256 (*note TeX
 engines::).
@@ -14858,14 +14922,15 @@
      \protected at write\@auxout{}{STRING}
 
    With the first, LaTeX writes STRING to the file.  Any commands in
-STRING will be expanded (as in '\edef', except that you should use '#'
+STRING will be expanded (just as in '\edef' so that to prevent expansion
+you should use '\noexpand' or a 'toks', except that you should use '#'
 instead of '##').  With the second, STRING is stored on the current list
-of things (as a TeX "whatsit") and kept until the page is shipped out.
-On that list the commands are unexpanded until at the time of shipout.
-The third, '\protected at write', is like the second except that you can
-use '\protect' on fragile commands.  In this third case the extra first
-argument allows you to locally insert extra definitions to make more
-commands be safe or have special definition during the write.
+of things (as a TeX "whatsit") and kept until the page is shipped out
+and likewise the commands are unexpanded until shipout.  The third,
+'\protected at write', is like the second except that you can use
+'\protect' on fragile commands.  The extra first argument allows you to
+locally insert extra definitions to make more commands be safe or have
+special definition during the write.
 
    Here STRING contains a control sequence.
 
@@ -14878,23 +14943,22 @@
 a newline.
 
    The cases where NUMBER is 16, 17, or 18 are special.  Because of
-'\writeNUMBER''s behavior when NUMBER is outside the range from 0 to 15,
-there is some convention of writing to the log file and the terminal
-with '\write16'.  In the past '\write17' has sometimes been used in a
-similar way.  The '\write18' command is even more special; modern TeX
-systems use it for issuing commands to the operating system (*note
-\write18::).
+'\write''s behavior when NUMBER is outside the range from 0 to 15
+described above, in Plain TeX '\write16' and '\write17' were sometimes
+used to write to the log file and the terminal.  Note that in LaTeX the
+natural way to do that is with '\typeout' (*note \typeout::).  The
+'\write18' command is even more special; modern TeX systems use it for
+giving commands to the operating system (*note \write18::).
 
    Ordinarily '\write' outputs a single line.  Put in a newline with
 '^^J'.  Thus, this produces two lines in the log file.
 
-     \wlog{Parallel Lines have a lot in common.^^JBut they never meet.}
+     \wlog{Parallel lines have a lot in common.^^JBut they never meet.}
 
-   Writing arbitrary files has obvious security problems.  If you
-downloaded a LaTeX file and compiling it overwrote your password file
-then you would be annoyed.  TeX systems by default only allow you to
-open files for writing that are in the current directory or in a
-subdirectory.  This example
+   The ability to Write files raises security issues.  If you compiled a
+downloaded LaTeX file and it overwrote your password file then you would
+be annoyed.  TeX systems by default only allow you to open files for
+writing that are in the current directory or in a subdirectory.  This
 
      \newwrite\jhfile
      \openout\jhfile=../test.jh
@@ -14903,12 +14967,13 @@
 can't write on file `../test.jh''.  Note that you can get such an error
 when trying to use commands such as '\include{../filename}' because
 LaTeX will try to open '../filename.aux'.  The simplest solution is to
-put the included files in the same directory or subdirectories of the
-master file.
+put the included files in the same directory as the master file, or in
+subdirectories.
 
-   If you want that the material you write is output verbatim, without
-expanding the commands, for instance to write answers to exercises, then
-look at the 'answers' package on CTAN.
+   A common case where authors want to write a file not already provided
+by LaTeX is for answers to exercises, or some other situation where you
+want to write out verbatim, without expanding the commands.  CTAN has a
+number of packages for this; one is 'answers'.
 
 * Menu:
 
@@ -14919,7 +14984,7 @@
 
 File: latex2e.info,  Node: \message,  Next: \wlog,  Up: \write
 
-27.3.1 '\message'
+27.4.1 '\message'
 -----------------
 
 Synopsis:
@@ -14966,7 +15031,7 @@
 
 File: latex2e.info,  Node: \wlog,  Next: \write18,  Prev: \message,  Up: \write
 
-27.3.2 '\wlog'
+27.4.2 '\wlog'
 --------------
 
 Synopsis:
@@ -14987,7 +15052,7 @@
 
 File: latex2e.info,  Node: \write18,  Prev: \wlog,  Up: \write
 
-27.3.3 '\write18'
+27.4.3 '\write18'
 -----------------
 
 Synopsis:
@@ -15005,28 +15070,27 @@
      \immediate\write18{cd pix && asy figure\fignum}
      \includegraphics{pix\figure\fignum.pdf}
 
-will run 'Asymptote' on 'figure1.asy', so that the document can later
-read in the resulting graphic (*note \includegraphics::).
+will run 'Asymptote' on 'pix/figure1.asy', so that the document can
+later read in the resulting graphic (*note \includegraphics::).  Like
+any '\write', here LaTeX expands macros in SHELL_COMMAND so that
+'\fignum' is replaced by '1'.
 
    Another example is that you can automatically run BibTeX at the start
 of each LaTeX run (*note Using BibTeX::) by including
 '\immediate\write18{bibtex8 \jobname}' as the first line of the file.
-Like any '\write', here LaTeX expands macros in SHELL_COMMAND so that
-'\jobname' gives the base name of the current file.
+Note that '\jobname' gives the base name of the current file.
 
    You sometimes need to do a multi-step process to get the information
-that you want.  This will get a list of all PDF files in the current
-directory.
+that you want.  This will insert into the input a list of all PDF files
+in the current directory.
 
      \immediate\write18{ls *.pdf > tmp.dat}
      \input{tmp.dat}
 
    The standard behaviour of any '\write' is to wait until a page is
 being shipped out before expanding the macros or writing to the stream
-(*note \write::).  But sometimes you want it done now.  The command
-'\immediate\write18{SHELL_COMMAND}' will send SHELL_COMMAND to the
-operating system for execution now, rather than waiting until the next
-shipout.
+(*note \write::).  But sometimes you want it done now.  For this, use
+'\immediate\write18{SHELL_COMMAND}'.
 
    There are obvious security issues with allowing system commands
 inside a LaTeX file.  If you download a file off the net and it contains
@@ -15042,13 +15106,14 @@
 those that run MetaFont to generate missing fonts, even if you do not
 use the 'shell-escape' or 'enable-write18' option.  By default this list
 of allowed commands is short and features only commands that are under
-the control of the distribution maintainers.
+the control of the distribution maintainers (*note Command line
+options::).
 
    Some packages need to run external system commands.  For instance
 'sagetex' allows you to have the mathematics software system Sage do
 calculations or draw graphs and then incorporate that output in your
 document.  For this you must compile with full '\write18' capability
-turned on (*note Command line options::).
+turned on.
 
 
 File: latex2e.info,  Node: Command line,  Next: Document templates,  Prev: Input/output,  Up: Top
@@ -15777,6 +15842,8 @@
 * \clearpage:                            \clearpage & \cleardoublepage.
                                                               (line   6)
 * \cline:                                \cline.              (line   6)
+* \closein:                              \openin & \openout.  (line   6)
+* \closeout:                             \openin & \openout.  (line   6)
 * \closing:                              \closing.            (line   6)
 * \clubsuit:                             Math symbols.        (line 131)
 * \colon:                                Colon character & \colon.
@@ -16251,7 +16318,9 @@
 * \omega:                                Math symbols.        (line 485)
 * \ominus:                               Math symbols.        (line 488)
 * \onecolumn:                            \onecolumn.          (line   6)
+* \openin:                               \openin & \openout.  (line   6)
 * \opening:                              \opening.            (line   6)
+* \openout:                              \openin & \openout.  (line   6)
 * \oplus:                                Math symbols.        (line 491)
 * \OptionNotUsed:                        Class and package commands.
                                                               (line 200)
@@ -16735,7 +16804,7 @@
 * amsmath package, replacing eqnarray:   eqnarray.            (line   6)
 * amsthm package:                        theorem.             (line  28)
 * amsthm package <1>:                    \rule.               (line  18)
-* answers package:                       \write.              (line 113)
+* answers package:                       \write.              (line 107)
 * appendices:                            \appendix.           (line   6)
 * appendix:                              \appendix.           (line   6)
 * appendix package:                      \appendix.           (line  29)
@@ -16754,8 +16823,7 @@
 * Asymptote package:                     \line.               (line  36)
 * Asymptote package <1>:                 \strut.              (line  62)
 * Asymptote package <2>:                 \mbox & \makebox.    (line  73)
-* Asymptote package <3>:                 \write.              (line  13)
-* Asymptote package <4>:                 \write18.            (line  13)
+* Asymptote package <3>:                 \write18.            (line  13)
 * at clause, in font definitions:        \newfont.            (line  19)
 * at-sign:                               \@.                  (line   6)
 * author, for titlepage:                 \maketitle.          (line  43)
@@ -17132,6 +17200,8 @@
 * figure number, cross referencing:      \ref.                (line   6)
 * figures, footnotes in:                 minipage.            (line 107)
 * figures, inserting:                    figure.              (line   6)
+* file, closing:                         \openin & \openout.  (line   6)
+* file, opening:                         \openin & \openout.  (line   6)
 * file, root:                            Splitting the input. (line  10)
 * filecontents environment:              filecontents.        (line   6)
 * filecontents* environment:             filecontents.        (line   6)
@@ -17285,6 +17355,7 @@
 * inner paragraph mode:                  Modes.               (line  47)
 * input file:                            Splitting the input. (line   6)
 * input, on command line:                Command line input.  (line   6)
+* input/output:                          Input/output.        (line   6)
 * input/output, to terminal:             Input/output.        (line   6)
 * inserting figures:                     figure.              (line   6)
 * insertions of special characters:      Special insertions.  (line   6)
@@ -17503,6 +17574,7 @@
                                                               (line  78)
 * oneside option:                        Document class options.
                                                               (line  78)
+* open a file:                           \openin & \openout.  (line   6)
 * openany option:                        Document class options.
                                                               (line  78)
 * openbib option:                        Document class options.
@@ -17561,14 +17633,13 @@
                                                               (line  19)
 * package, amsthm:                       theorem.             (line  28)
 * package, amsthm <1>:                   \rule.               (line  18)
-* package, answers:                      \write.              (line 113)
+* package, answers:                      \write.              (line 107)
 * package, appendix:                     \appendix.           (line  29)
 * 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 <3>:                \write.              (line  13)
-* package, Asymptote <4>:                \write18.            (line  13)
+* package, Asymptote <3>:                \write18.            (line  13)
 * package, babel:                        \chapter.            (line  71)
 * package, babel <1>:                    thebibliography.     (line  53)
 * package, babel <2>:                    Accents.             (line   6)
@@ -18554,23 +18625,24 @@
 Node: \signature529945
 Node: \telephone531173
 Node: Input/output531538
-Node: \typein531834
-Node: \typeout533074
-Node: \write534124
-Node: \message539436
-Node: \wlog541163
-Node: \write18541666
-Node: Command line544381
-Node: Command line options546430
-Node: Command line input550007
-Node: Recovering from errors551870
-Node: Document templates553216
-Node: beamer template553661
-Node: article template554315
-Node: book template554742
-Node: Larger book template555223
-Node: tugboat template556709
-Node: Index559080
-Ref: Command Index559166
+Node: \openin & \openout532211
+Node: \typein534713
+Node: \typeout535980
+Node: \write537030
+Node: \message542072
+Node: \wlog543799
+Node: \write18544302
+Node: Command line546972
+Node: Command line options549021
+Node: Command line input552598
+Node: Recovering from errors554461
+Node: Document templates555807
+Node: beamer template556252
+Node: article template556906
+Node: book template557333
+Node: Larger book template557814
+Node: tugboat template559300
+Node: Index561671
+Ref: Command Index561757
 
 End Tag Table

Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e.texi	2018-10-21 21:39:31 UTC (rev 716)
@@ -18380,24 +18380,6 @@
 (@pxref{Graphics}).
 
 
- at c I think this is not a user-level command; it is used to keep from breaking
- at c the page between the closing and the signature
- at c @node \stopbreaks and \startbreaks
- at c @section @code{\stopbreaks} and @code{\startbreaks}
-
- at c @findex \startbreak
- at c @findex \stopbreaks
-
- at c @example 
- at c @code{\stopbreaks}
- at c text
- at c @code{\startbreaks}
- at c @end example
-
- at c The @code{\stopbreaks} inhibits page breaking.  The @code{\startbreaks} resumes
- at c normal page breaking.
- at c
- at c
 @node \telephone
 @section @code{\telephone}
 
@@ -18420,15 +18402,105 @@
 
 @cindex input/output, to terminal
 @cindex terminal input/output
+ at cindex input/output
 
+ at LaTeX{} uses the ability to write to a file and later read it back in
+to build document components such as a table of contents or index.  You
+can also read a file that other programs written, or write a file for
+others to read.  You can communicate with users through the terminal.
+And, you can issue instructions for the operating system.
+
 @menu
+* \openin & \openout::  Open a file.
 * \typein::             Read text from the terminal.
 * \typeout::            Write text to the terminal.
 * \write::              Write text to a file or terminal.
- at c *\wlog
 @end menu
 
 
+ at node \openin & \openout
+ at section @code{\openin} & @code{\openout}
+
+ at findex \openin
+ at findex \openout
+ at findex \closein
+ at findex \closeout
+ at cindex file, opening
+ at cindex file, closing
+ at cindex open a file
+
+Synopsis:
+
+ at example
+\openin at var{number}=@var{filename}
+ at end example
+
+or:
+
+ at example
+\openout at var{number}=@var{filename}
+ at end example
+
+Open a file for reading material, or for writing it.  The @var{number}
+must be between 0 and 15, as in @code{\openin3} (in Lua at LaTeX{}
+ at var{number} can be between 0 and 255).
+
+Here @TeX{} opens the file @file{presidents.tex} for reading.
+
+ at example
+\newread\presidentsfile
+\openin\presidentsfile=presidents
+\typeout@{presidentsfile is \the\presidentsfile@}
+\read\presidentsfile to\presidentline
+\typeout@{\presidentline@}
+ at end example
+
+ at noindent
+The @code{\newread} command allocates input stream numbers from 0
+to at tie{}15, (there is also a @code{\newwrite}).  Being able to work not
+with a number but with the more memorable @code{\presidentsfile} is just
+a convenience; the first line typed out is something like
+ at samp{presidentsfile is 1}.  The second line is like @samp{1 Washington,
+George}.
+
+Close files with @code{\closein at var{number}} and
+ at code{\closeout at var{number}}.
+
+How @LaTeX{} handles filenames varies among distributions, and even can
+vary among versions of a distribution.  If the file does not have an
+extension then @TeX{} will add a @file{.tex}.  This creates
+ at file{presidents.tex}, writes one line to it, and closes it.
+
+ at example
+\newwrite\presidentsfile
+\openout\presidentsfile=presidents
+\write\presidentsfile@{1 Washington, George@}
+\closeout\presidentsfile
+ at end example
+
+ at noindent
+But filenames with a period can cause trouble: if @TeX{} finds a
+ at var{filename} of @file{presidents.dat} it could look first for
+ at file{presidents.dat.tex} and later for @file{presidents.dat}, or it
+could do the opposite.  Your distribution's documentation should say
+more, and if you find something that works for you then you are good,
+but to ensure complete portability the best thing is to use file names
+containing only the twenty six ASCII letters (not case-sensitive), along
+with underscore and dash, and no dot or space.
+
+Ordinarily @TeX{} will not try to open the file until the next page
+shipout. To change this, use
+ at code{\immediate\openin at var{number}=@var{filename}}.
+
+For @code{openin}, if @TeX{} cannot find the file then it does not give
+an error.  It just considers that the stream is not open (test for this
+with @code{\ifeof}; one recourse is the command
+ at code{\InputIfFileExists}, @pxref{Class and package commands}).  If you
+try to use the same number twice, @LaTeX{} won't give you an error.  If
+you try to use a bad number then you get an error message like @samp{!
+Bad number (16).  <to be read again> = l.30 \openin16=test.jh}.
+
+
 @node \typein
 @section @code{\typein}
 
@@ -18550,14 +18622,6 @@
 opened by @code{\openout}.  For instance, @code{\write6} writes to text
 stream number at tie{}6.
 
- at PkgIndex{Asymptote}
- at LaTeX{} uses the ability to write to a file and later read it back in
-to build document components such as a Table of Contents or Index.  You
-can also output a file that other programs read, for instance by writing
-out an Asymptote graphics source file, having @LaTeX{} then run the
- at file{asymptote} program on that file (@pxref{\write18}), and finally
-bringing that graphic back into the document (@pxref{\includegraphics}).
-
 If this appears in @file{@var{basefile}.tex} then it opens
 @file{@var{basefile}.jh}, writes @samp{Hello World!} and a newline to
 it, and closes that file.
@@ -18581,14 +18645,14 @@
 Typically @var{number} is between 0 and at tie{}15 because typically
 @LaTeX{} authors follow the prior example and the number is allocated by
 the system.  If @var{number} is outside the range from 0 to 15 or if it
-is not associated with an open file then @LaTeX{} writes the string to
+is not associated with an open file then @LaTeX{} writes @var{string} to
 the log file.  If @var{number} is positive then in addition @LaTeX{}
-writes @var{string} to the terminal.  (But the numbers 16, 17, and 18
-are special; see below.) Thus, @code{test \write-1@{Hello World!@}} puts
- at samp{Hello World!} followed by a newline in the log file.  (This is
-what the @code{\wlog} command does; @pxref{\wlog}).  And
+writes @var{string} to the terminal. Thus, @code{test \write-1@{Hello
+World!@}} puts @samp{Hello World!} followed by a newline in the log
+file.  (This is what the @code{\wlog} command does; @pxref{\wlog}).  And
 @code{\write100@{Hello World!@}} puts the same in the log file but also
 puts @samp{Hello World!} followed by a newline in the terminal output.
+(But 16, 17, and 18 are special as @var{number}; see below.)
 
 In Lua at LaTeX{}, instead of 16 output streams there are 256
 (@pxref{@TeX{} engines}).
@@ -18612,15 +18676,16 @@
 @end example
 
 With the first, @LaTeX{} writes @var{string} to the file.  Any commands
-in @var{string} will be expanded (as in @code{\edef}, except that you
-should use @code{#} instead of @code{##}).  With the second,
- at var{string} is stored on the current list of things (as a @TeX{}
-``whatsit'') and kept until the page is shipped out.  On that list the
-commands are unexpanded until at the time of shipout.  The third,
+in @var{string} will be expanded (just as in @code{\edef} so that to
+prevent expansion you should use @code{\noexpand} or a @code{toks},
+except that you should use @code{#} instead of @code{##}).  With the
+second, @var{string} is stored on the current list of things (as a
+ at TeX{} ``whatsit'') and kept until the page is shipped out and likewise
+the commands are unexpanded until shipout.  The third,
 @code{\protected@@write}, is like the second except that you can use
- at code{\protect} on fragile commands. In this third case the extra first
-argument allows you to locally insert extra definitions to make more
-commands be safe or have special definition during the write.
+ at code{\protect} on fragile commands. The extra first argument allows you
+to locally insert extra definitions to make more commands be safe or
+have special definition during the write.
 
 Here @var{string} contains a control sequence.
 
@@ -18636,25 +18701,26 @@
 followed by a newline.
 
 The cases where @var{number} is 16, 17, or 18 are special.  Because of
- at code{\write at var{number}}'s behavior when @var{number} is outside the
-range from 0 to 15, there is some convention of writing to the log file
-and the terminal with @code{\write16}.  In the past @code{\write17} has
-sometimes been used in a similar way.  The @code{\write18} command is
-even more special; modern @TeX{} systems use it for issuing commands to
-the operating system (@pxref{\write18}).
+ at code{\write}'s behavior when @var{number} is outside the range from 0
+to 15 described above, in Plain at tie{}@TeX{} @code{\write16} and
+ at code{\write17} were sometimes used to write to the log file and the
+terminal.  Note that in @LaTeX{} the natural way to do that is with
+ at code{\typeout} (@pxref{\typeout}).  The @code{\write18} command is even
+more special; modern @TeX{} systems use it for giving commands to the
+operating system (@pxref{\write18}).
 
 Ordinarily @code{\write} outputs a single line.  Put in a newline with
 @code{^^J}.  Thus, this produces two lines in the log file.
 
 @example
-\wlog@{Parallel Lines have a lot in common.^^JBut they never meet.@}
+\wlog@{Parallel lines have a lot in common.^^JBut they never meet.@}
 @end example
 
-Writing arbitrary files has obvious security problems.  If you
-downloaded a @LaTeX{} file and compiling it overwrote your password file
-then you would be annoyed.  @TeX{} systems by default only allow you to
-open files for writing that are in the current directory or in a
-subdirectory.  This example
+The ability to Write files raises security issues.  If you compiled a
+downloaded @LaTeX{} file and it overwrote your password file then you
+would be annoyed.  @TeX{} systems by default only allow you to open
+files for writing that are in the current directory or in a
+subdirectory.  This
 
 @example
 \newwrite\jhfile
@@ -18666,15 +18732,15 @@
 I can't write on file `../test.jh'}.  Note that you can get such an
 error when trying to use commands such as @code{\include@{../filename@}}
 because @LaTeX{} will try to open @file{../filename.aux}.  The simplest
-solution is to put the included files in the same directory or
-subdirectories of the master file.
+solution is to put the included files in the same directory as the
+master file, or in subdirectories.
 
 @PkgIndex{answers}
-If you want that the material you write is output verbatim, without
-expanding the commands, for instance to write answers to exercises, then
-look at the @file{answers} package on CTAN.
+A common case where authors want to write a file not already provided by
+ at LaTeX{} is for answers to exercises, or some other situation where you
+want to write out verbatim, without expanding the commands.  CTAN has a
+number of packages for this; one is @file{answers}.
 
-
 @menu
 * \message::          Write part of a line to log file and terminal.
 * \wlog::             Write to the log file.
@@ -18797,19 +18863,21 @@
 @end example
 
 @noindent
-will run @file{Asymptote} on @file{figure1.asy}, so that the document
-can later read in the resulting graphic (@pxref{\includegraphics}).
+will run @file{Asymptote} on @file{pix/figure1.asy}, so that the
+document can later read in the resulting graphic
+(@pxref{\includegraphics}).  Like any @code{\write}, here @LaTeX{}
+expands macros in @var{shell_command} so that @code{\fignum} is replaced
+by @samp{1}.
 
 Another example is that you can automatically run Bib at TeX{} at the start
 of each @LaTeX{} run (@pxref{Using BibTeX}) by including
 @code{\immediate\write18@{bibtex8 \jobname@}} as the first line of the
-file.  Like any @code{\write}, here @LaTeX{} expands macros in
- at var{shell_command} so that @code{\jobname} gives the base name of the
-current file.
+file.  Note that @code{\jobname} gives the base name of the current
+file.
 
 You sometimes need to do a multi-step process to get the information
-that you want.  This will get a list of all PDF files in the current
-directory.
+that you want.  This will insert into the input a list of all PDF files
+in the current directory.
 
 @example
 \immediate\write18@{ls *.pdf > tmp.dat@}
@@ -18818,10 +18886,8 @@
 
 The standard behaviour of any @code{\write} is to wait until a page is
 being shipped out before expanding the macros or writing to the stream
-(@pxref{\write}). But sometimes you want it done now.  The command
- at code{\immediate\write18@{@var{shell_command}@}} will send
- at var{shell_command} to the operating system for execution now, rather
-than waiting until the next shipout.
+(@pxref{\write}). But sometimes you want it done now.  For this, use
+ at code{\immediate\write18@{@var{shell_command}@}}.
 
 There are obvious security issues with allowing system commands inside a
 @LaTeX{} file.  If you download a file off the net and it contains
@@ -18837,14 +18903,16 @@
 run MetaFont to generate missing fonts, even if you do not use the
 @code{shell-escape} or @code{enable-write18} option. By default this
 list of allowed commands is short and features only commands that are
-under the control of the distribution maintainers.
+under the control of the distribution maintainers (@pxref{Command line
+options}).
 
 Some packages need to run external system commands. For instance
 @file{sagetex} allows you to have the mathematics software system
 @i{Sage} do calculations or draw graphs and then incorporate that output
 in your document. For this you must compile with full @code{\write18}
-capability turned on (@pxref{Command line options}).
+capability turned on.
 
+
 @node Command line
 @chapter Command line
 

Modified: trunk/latex2e.txt
===================================================================
--- trunk/latex2e.txt	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e.txt	2018-10-21 21:39:31 UTC (rev 716)
@@ -298,12 +298,13 @@
   26.10 '\signature'
   26.11 '\telephone'
 27 Input/output
-  27.1 '\typein'
-  27.2 '\typeout'
-  27.3 '\write'
-    27.3.1 '\message'
-    27.3.2 '\wlog'
-    27.3.3 '\write18'
+  27.1 '\openin' & '\openout'
+  27.2 '\typein'
+  27.3 '\typeout'
+  27.4 '\write'
+    27.4.1 '\message'
+    27.4.2 '\wlog'
+    27.4.3 '\write18'
 28 Command line
   28.1 Command line options
   28.2 Command line input
@@ -13754,7 +13755,74 @@
 27 Input/output
 ***************
 
-27.1 '\typein'
+LaTeX uses the ability to write to a file and later read it back in to
+build document components such as a table of contents or index.  You can
+also read a file that other programs written, or write a file for others
+to read.  You can communicate with users through the terminal.  And, you
+can issue instructions for the operating system.
+
+27.1 '\openin' & '\openout'
+===========================
+
+Synopsis:
+
+     \openinNUMBER=FILENAME
+
+   or:
+
+     \openoutNUMBER=FILENAME
+
+   Open a file for reading material, or for writing it.  The NUMBER must
+be between 0 and 15, as in '\openin3' (in LuaLaTeX NUMBER can be between
+0 and 255).
+
+   Here TeX opens the file 'presidents.tex' for reading.
+
+     \newread\presidentsfile
+     \openin\presidentsfile=presidents
+     \typeout{presidentsfile is \the\presidentsfile}
+     \read\presidentsfile to\presidentline
+     \typeout{\presidentline}
+
+The '\newread' command allocates input stream numbers from 0 to 15,
+(there is also a '\newwrite').  Being able to work not with a number but
+with the more memorable '\presidentsfile' is just a convenience; the
+first line typed out is something like 'presidentsfile is 1'.  The
+second line is like '1 Washington, George'.
+
+   Close files with '\closeinNUMBER' and '\closeoutNUMBER'.
+
+   How LaTeX handles filenames varies among distributions, and even can
+vary among versions of a distribution.  If the file does not have an
+extension then TeX will add a '.tex'.  This creates 'presidents.tex',
+writes one line to it, and closes it.
+
+     \newwrite\presidentsfile
+     \openout\presidentsfile=presidents
+     \write\presidentsfile{1 Washington, George}
+     \closeout\presidentsfile
+
+But filenames with a period can cause trouble: if TeX finds a FILENAME
+of 'presidents.dat' it could look first for 'presidents.dat.tex' and
+later for 'presidents.dat', or it could do the opposite.  Your
+distribution's documentation should say more, and if you find something
+that works for you then you are good, but to ensure complete portability
+the best thing is to use file names containing only the twenty six ASCII
+letters (not case-sensitive), along with underscore and dash, and no dot
+or space.
+
+   Ordinarily TeX will not try to open the file until the next page
+shipout.  To change this, use '\immediate\openinNUMBER=FILENAME'.
+
+   For 'openin', if TeX cannot find the file then it does not give an
+error.  It just considers that the stream is not open (test for this
+with '\ifeof'; one recourse is the command '\InputIfFileExists', *note
+Class and package commands::).  If you try to use the same number twice,
+LaTeX won't give you an error.  If you try to use a bad number then you
+get an error message like '! Bad number (16). <to be read again> = l.30
+\openin16=test.jh'.
+
+27.2 '\typein'
 ==============
 
 Synopsis, one of:
@@ -13799,7 +13867,7 @@
 
 where the user has entered 'John Dee.'
 
-27.2 '\typeout'
+27.3 '\typeout'
 ===============
 
 Synopsis:
@@ -13832,7 +13900,7 @@
 
 produces on the command line 'The length is 5.0pt'.
 
-27.3 '\write'
+27.4 '\write'
 =============
 
 Synopsis:
@@ -13842,13 +13910,6 @@
    Write 'string' to the log file, to the terminal, or to a file opened
 by '\openout'.  For instance, '\write6' writes to text stream number 6.
 
-   LaTeX uses the ability to write to a file and later read it back in
-to build document components such as a Table of Contents or Index.  You
-can also output a file that other programs read, for instance by writing
-out an Asymptote graphics source file, having LaTeX then run the
-'asymptote' program on that file (*note \write18::), and finally
-bringing that graphic back into the document (*note \includegraphics::).
-
    If this appears in 'BASEFILE.tex' then it opens 'BASEFILE.jh', writes
 'Hello World!' and a newline to it, and closes that file.
 
@@ -13868,13 +13929,13 @@
    Typically NUMBER is between 0 and 15 because typically LaTeX authors
 follow the prior example and the number is allocated by the system.  If
 NUMBER is outside the range from 0 to 15 or if it is not associated with
-an open file then LaTeX writes the string to the log file.  If NUMBER is
-positive then in addition LaTeX writes STRING to the terminal.  (But the
-numbers 16, 17, and 18 are special; see below.)  Thus, 'test
-\write-1{Hello World!}' puts 'Hello World!' followed by a newline in the
-log file.  (This is what the '\wlog' command does; *note \wlog::).  And
-'\write100{Hello World!}' puts the same in the log file but also puts
-'Hello World!' followed by a newline in the terminal output.
+an open file then LaTeX writes STRING to the log file.  If NUMBER is
+positive then in addition LaTeX writes STRING to the terminal.  Thus,
+'test \write-1{Hello World!}' puts 'Hello World!' followed by a newline
+in the log file.  (This is what the '\wlog' command does; *note
+\wlog::).  And '\write100{Hello World!}' puts the same in the log file
+but also puts 'Hello World!' followed by a newline in the terminal
+output.  (But 16, 17, and 18 are special as NUMBER; see below.)
 
    In LuaLaTeX, instead of 16 output streams there are 256 (*note TeX
 engines::).
@@ -13894,14 +13955,15 @@
      \protected at write\@auxout{}{STRING}
 
    With the first, LaTeX writes STRING to the file.  Any commands in
-STRING will be expanded (as in '\edef', except that you should use '#'
+STRING will be expanded (just as in '\edef' so that to prevent expansion
+you should use '\noexpand' or a 'toks', except that you should use '#'
 instead of '##').  With the second, STRING is stored on the current list
-of things (as a TeX "whatsit") and kept until the page is shipped out.
-On that list the commands are unexpanded until at the time of shipout.
-The third, '\protected at write', is like the second except that you can
-use '\protect' on fragile commands.  In this third case the extra first
-argument allows you to locally insert extra definitions to make more
-commands be safe or have special definition during the write.
+of things (as a TeX "whatsit") and kept until the page is shipped out
+and likewise the commands are unexpanded until shipout.  The third,
+'\protected at write', is like the second except that you can use
+'\protect' on fragile commands.  The extra first argument allows you to
+locally insert extra definitions to make more commands be safe or have
+special definition during the write.
 
    Here STRING contains a control sequence.
 
@@ -13914,23 +13976,22 @@
 a newline.
 
    The cases where NUMBER is 16, 17, or 18 are special.  Because of
-'\writeNUMBER''s behavior when NUMBER is outside the range from 0 to 15,
-there is some convention of writing to the log file and the terminal
-with '\write16'.  In the past '\write17' has sometimes been used in a
-similar way.  The '\write18' command is even more special; modern TeX
-systems use it for issuing commands to the operating system (*note
-\write18::).
+'\write''s behavior when NUMBER is outside the range from 0 to 15
+described above, in Plain TeX '\write16' and '\write17' were sometimes
+used to write to the log file and the terminal.  Note that in LaTeX the
+natural way to do that is with '\typeout' (*note \typeout::).  The
+'\write18' command is even more special; modern TeX systems use it for
+giving commands to the operating system (*note \write18::).
 
    Ordinarily '\write' outputs a single line.  Put in a newline with
 '^^J'.  Thus, this produces two lines in the log file.
 
-     \wlog{Parallel Lines have a lot in common.^^JBut they never meet.}
+     \wlog{Parallel lines have a lot in common.^^JBut they never meet.}
 
-   Writing arbitrary files has obvious security problems.  If you
-downloaded a LaTeX file and compiling it overwrote your password file
-then you would be annoyed.  TeX systems by default only allow you to
-open files for writing that are in the current directory or in a
-subdirectory.  This example
+   The ability to Write files raises security issues.  If you compiled a
+downloaded LaTeX file and it overwrote your password file then you would
+be annoyed.  TeX systems by default only allow you to open files for
+writing that are in the current directory or in a subdirectory.  This
 
      \newwrite\jhfile
      \openout\jhfile=../test.jh
@@ -13939,14 +14000,15 @@
 can't write on file `../test.jh''.  Note that you can get such an error
 when trying to use commands such as '\include{../filename}' because
 LaTeX will try to open '../filename.aux'.  The simplest solution is to
-put the included files in the same directory or subdirectories of the
-master file.
+put the included files in the same directory as the master file, or in
+subdirectories.
 
-   If you want that the material you write is output verbatim, without
-expanding the commands, for instance to write answers to exercises, then
-look at the 'answers' package on CTAN.
+   A common case where authors want to write a file not already provided
+by LaTeX is for answers to exercises, or some other situation where you
+want to write out verbatim, without expanding the commands.  CTAN has a
+number of packages for this; one is 'answers'.
 
-27.3.1 '\message'
+27.4.1 '\message'
 -----------------
 
 Synopsis:
@@ -13990,7 +14052,7 @@
 path names of included files.  So producing finely-formatted lines in a
 way that is portable is hard.
 
-27.3.2 '\wlog'
+27.4.2 '\wlog'
 --------------
 
 Synopsis:
@@ -14008,7 +14070,7 @@
      \wlog{Helvetica and Times Roman walk into a bar.}
      \wlog{The barman says,^^JWe don't serve your type.}
 
-27.3.3 '\write18'
+27.4.3 '\write18'
 -----------------
 
 Synopsis:
@@ -14026,28 +14088,27 @@
      \immediate\write18{cd pix && asy figure\fignum}
      \includegraphics{pix\figure\fignum.pdf}
 
-will run 'Asymptote' on 'figure1.asy', so that the document can later
-read in the resulting graphic (*note \includegraphics::).
+will run 'Asymptote' on 'pix/figure1.asy', so that the document can
+later read in the resulting graphic (*note \includegraphics::).  Like
+any '\write', here LaTeX expands macros in SHELL_COMMAND so that
+'\fignum' is replaced by '1'.
 
    Another example is that you can automatically run BibTeX at the start
 of each LaTeX run (*note Using BibTeX::) by including
 '\immediate\write18{bibtex8 \jobname}' as the first line of the file.
-Like any '\write', here LaTeX expands macros in SHELL_COMMAND so that
-'\jobname' gives the base name of the current file.
+Note that '\jobname' gives the base name of the current file.
 
    You sometimes need to do a multi-step process to get the information
-that you want.  This will get a list of all PDF files in the current
-directory.
+that you want.  This will insert into the input a list of all PDF files
+in the current directory.
 
      \immediate\write18{ls *.pdf > tmp.dat}
      \input{tmp.dat}
 
    The standard behaviour of any '\write' is to wait until a page is
 being shipped out before expanding the macros or writing to the stream
-(*note \write::).  But sometimes you want it done now.  The command
-'\immediate\write18{SHELL_COMMAND}' will send SHELL_COMMAND to the
-operating system for execution now, rather than waiting until the next
-shipout.
+(*note \write::).  But sometimes you want it done now.  For this, use
+'\immediate\write18{SHELL_COMMAND}'.
 
    There are obvious security issues with allowing system commands
 inside a LaTeX file.  If you download a file off the net and it contains
@@ -14063,13 +14124,14 @@
 those that run MetaFont to generate missing fonts, even if you do not
 use the 'shell-escape' or 'enable-write18' option.  By default this list
 of allowed commands is short and features only commands that are under
-the control of the distribution maintainers.
+the control of the distribution maintainers (*note Command line
+options::).
 
    Some packages need to run external system commands.  For instance
 'sagetex' allows you to have the mathematics software system Sage do
 calculations or draw graphs and then incorporate that output in your
 document.  For this you must compile with full '\write18' capability
-turned on (*note Command line options::).
+turned on.
 
 28 Command line
 ***************
@@ -14501,2600 +14563,2613 @@
 
 * Menu:
 
-* &:                                     tabular.           (line  4951)
+* &:                                     tabular.           (line  4952)
 * * prompt:                              Recovering from errors.
-                                                            (line 14354)
+                                                            (line 14417)
 * *-form of environment commands:        \newenvironment & \renewenvironment.
-                                                            (line  6782)
-* *-form of sectioning commands:         Sectioning.        (line  1986)
+                                                            (line  6783)
+* *-form of sectioning commands:         Sectioning.        (line  1987)
 * *-form, defining new commands:         \newcommand & \renewcommand.
-                                                            (line  6424)
+                                                            (line  6425)
 * --disable-write18 command-line option: Command line options.
-                                                            (line 14256)
+                                                            (line 14319)
 * --enable-write18 command-line option:  Command line options.
-                                                            (line 14256)
+                                                            (line 14319)
 * --file-line-error command-line option: Command line options.
-                                                            (line 14283)
+                                                            (line 14346)
 * --halt-on-error command-line option:   Command line options.
-                                                            (line 14280)
+                                                            (line 14343)
 * --help command-line option:            Command line options.
-                                                            (line 14221)
+                                                            (line 14284)
 * --interaction command-line option:     Command line options.
-                                                            (line 14224)
+                                                            (line 14287)
 * --jobname command-line option:         Command line options.
-                                                            (line 14241)
+                                                            (line 14304)
 * --no-file-line-error command-line option: Command line options.
-                                                            (line 14283)
+                                                            (line 14346)
 * --no-shell-escape command-line option: Command line options.
-                                                            (line 14256)
+                                                            (line 14319)
 * --output-directory command-line option: Command line options.
-                                                            (line 14253)
+                                                            (line 14316)
 * --shell-escape command-line option:    Command line options.
-                                                            (line 14256)
+                                                            (line 14319)
 * --version command-line option:         Command line options.
-                                                            (line 14216)
-* .aux file:                             Output files.      (line   463)
-* .dvi file:                             Output files.      (line   440)
-* .glo file:                             Glossaries.        (line 13449)
-* .idx file:                             Indexes.           (line 13090)
-* .idx file <1>:                         makeindex.         (line 13241)
-* .ind file:                             makeindex.         (line 13241)
-* .isty file:                            makeindex.         (line 13253)
-* .lof file:                             Output files.      (line   473)
+                                                            (line 14279)
+* .aux file:                             Output files.      (line   464)
+* .dvi file:                             Output files.      (line   441)
+* .glo file:                             Glossaries.        (line 13450)
+* .idx file:                             Indexes.           (line 13091)
+* .idx file <1>:                         makeindex.         (line 13242)
+* .ind file:                             makeindex.         (line 13242)
+* .isty file:                            makeindex.         (line 13254)
+* .lof file:                             Output files.      (line   474)
 * .lof file <1>:                         Table of contents etc..
-                                                            (line 12856)
-* .log file:                             Output files.      (line   458)
-* .lot file:                             Output files.      (line   473)
+                                                            (line 12857)
+* .log file:                             Output files.      (line   459)
+* .lot file:                             Output files.      (line   474)
 * .lot file <1>:                         Table of contents etc..
-                                                            (line 12856)
-* .pdf file:                             Output files.      (line   450)
-* .tex, default extension:               Command line.      (line 14178)
-* .toc file:                             Output files.      (line   473)
+                                                            (line 12857)
+* .pdf file:                             Output files.      (line   451)
+* .tex, default extension:               Command line.      (line 14241)
+* .toc file:                             Output files.      (line   474)
 * .toc file <1>:                         Table of contents etc..
-                                                            (line 12856)
-* .xdv file:                             TeX engines.       (line   515)
+                                                            (line 12857)
+* .xdv file:                             TeX engines.       (line   516)
 * 10pt option:                           Document class options.
-                                                            (line   677)
+                                                            (line   678)
 * 11pt option:                           Document class options.
-                                                            (line   677)
+                                                            (line   678)
 * 12pt option:                           Document class options.
-                                                            (line   677)
+                                                            (line   678)
 * ::                                     Colon character & \colon.
-                                                            (line  9497)
+                                                            (line  9498)
 * : <1>:                                 Colon character & \colon.
-                                                            (line  9497)
+                                                            (line  9498)
 * [...] for optional arguments:          LaTeX command syntax.
-                                                            (line   534)
-* \ (backslash-space):                   \(SPACE).          (line 10214)
+                                                            (line   535)
+* \ (backslash-space):                   \(SPACE).          (line 10215)
 * \ character starting commands:         LaTeX command syntax.
-                                                            (line   534)
+                                                            (line   535)
 * \!:                                    Spacing in math mode.
-                                                            (line  9362)
-* \" (umlaut accent):                    Accents.           (line 12389)
+                                                            (line  9363)
+* \" (umlaut accent):                    Accents.           (line 12390)
 * \#:                                    Reserved characters.
-                                                            (line 12101)
+                                                            (line 12102)
 * \$:                                    Reserved characters.
-                                                            (line 12101)
+                                                            (line 12102)
 * \%:                                    Reserved characters.
-                                                            (line 12101)
+                                                            (line 12102)
 * \&:                                    Reserved characters.
-                                                            (line 12101)
-* \' (acute accent):                     Accents.           (line 12393)
-* \' (tabbing):                          tabbing.           (line  4797)
-* \*:                                    \*.                (line  9517)
-* \+:                                    tabbing.           (line  4789)
+                                                            (line 12102)
+* \' (acute accent):                     Accents.           (line 12394)
+* \' (tabbing):                          tabbing.           (line  4798)
+* \*:                                    \*.                (line  9518)
+* \+:                                    tabbing.           (line  4790)
 * \,:                                    Spacing in math mode.
-                                                            (line  9348)
-* \-:                                    tabbing.           (line  4793)
-* \- (hyphenation):                      \- (hyphenation).  (line  5819)
-* \. (dot-over accent):                  Accents.           (line 12396)
-* \/:                                    \/.                (line 10335)
+                                                            (line  9349)
+* \-:                                    tabbing.           (line  4794)
+* \- (hyphenation):                      \- (hyphenation).  (line  5820)
+* \. (dot-over accent):                  Accents.           (line 12397)
+* \/:                                    \/.                (line 10336)
 * \::                                    Spacing in math mode.
-                                                            (line  9344)
+                                                            (line  9345)
 * \;:                                    Spacing in math mode.
-                                                            (line  9339)
-* \<:                                    tabbing.           (line  4785)
-* \= (macron accent):                    Accents.           (line 12400)
-* \= (tabbing):                          tabbing.           (line  4779)
-* \>:                                    tabbing.           (line  4783)
+                                                            (line  9340)
+* \<:                                    tabbing.           (line  4786)
+* \= (macron accent):                    Accents.           (line 12401)
+* \= (tabbing):                          tabbing.           (line  4780)
+* \>:                                    tabbing.           (line  4784)
 * \> <1>:                                Spacing in math mode.
-                                                            (line  9344)
-* \> (tabbing):                          tabbing.           (line  4782)
-* \@:                                    \@.                (line 10138)
-* \@beginparpenalty:                     list.              (line  3879)
-* \@endparpenalty:                       list.              (line  3887)
-* \@fnsymbol:                            \footnote.         (line  6175)
-* \@ifstar:                              \@ifstar.          (line  6609)
-* \@itempenalty:                         list.              (line  3883)
-* \@startsection:                        \@startsection.    (line  2463)
-* \a (tabbing):                          tabbing.           (line  4812)
-* \a' (acute accent in tabbing):         tabbing.           (line  4813)
-* \a= (macron accent in tabbing):        tabbing.           (line  4813)
+                                                            (line  9345)
+* \> (tabbing):                          tabbing.           (line  4783)
+* \@:                                    \@.                (line 10139)
+* \@beginparpenalty:                     list.              (line  3880)
+* \@endparpenalty:                       list.              (line  3888)
+* \@fnsymbol:                            \footnote.         (line  6176)
+* \@ifstar:                              \@ifstar.          (line  6610)
+* \@itempenalty:                         list.              (line  3884)
+* \@startsection:                        \@startsection.    (line  2464)
+* \a (tabbing):                          tabbing.           (line  4813)
+* \a' (acute accent in tabbing):         tabbing.           (line  4814)
+* \a= (macron accent in tabbing):        tabbing.           (line  4814)
 * \aa (aa):                              Additional Latin letters.
-                                                            (line 12510)
+                                                            (line 12511)
 * \AA (AA):                              Additional Latin letters.
-                                                            (line 12510)
-* \accent:                               \accent.           (line 12460)
-* \acute:                                Math accents.      (line  9232)
-* \addcontentsline:                      \addcontentsline.  (line 12950)
-* \address:                              \address.          (line 13628)
-* \addtocontents{EXT}{TEXT}:             \addtocontents.    (line 13025)
-* \addtocounter:                         \addtocounter.     (line  7327)
-* \addtolength:                          \addtolength.      (line  7574)
-* \addvspace:                            \addvspace.        (line 10660)
+                                                            (line 12511)
+* \accent:                               \accent.           (line 12461)
+* \acute:                                Math accents.      (line  9233)
+* \addcontentsline:                      \addcontentsline.  (line 12951)
+* \address:                              \address.          (line 13629)
+* \addtocontents{EXT}{TEXT}:             \addtocontents.    (line 13026)
+* \addtocounter:                         \addtocounter.     (line  7328)
+* \addtolength:                          \addtolength.      (line  7575)
+* \addvspace:                            \addvspace.        (line 10661)
 * \ae (ae):                              Additional Latin letters.
-                                                            (line 12514)
+                                                            (line 12515)
 * \AE (AE):                              Additional Latin letters.
-                                                            (line 12514)
-* \aleph:                                Math symbols.      (line  8066)
-* \Alph example:                         enumerate.         (line  3238)
-* \alpha:                                Math symbols.      (line  8069)
+                                                            (line 12515)
+* \aleph:                                Math symbols.      (line  8067)
+* \Alph example:                         enumerate.         (line  3239)
+* \alpha:                                Math symbols.      (line  8070)
 * \alph{COUNTER}:                        \alph \Alph \arabic \roman \Roman \fnsymbol.
-                                                            (line  7202)
+                                                            (line  7203)
 * \Alph{COUNTER}:                        \alph \Alph \arabic \roman \Roman \fnsymbol.
-                                                            (line  7207)
-* \alsoname:                             \index.            (line 13176)
-* \amalg:                                Math symbols.      (line  8072)
-* \and for \author:                      \maketitle.        (line  9729)
-* \angle:                                Math symbols.      (line  8075)
-* \appendix:                             \appendix.         (line  2402)
-* \approx:                               Math symbols.      (line  8080)
+                                                            (line  7208)
+* \alsoname:                             \index.            (line 13177)
+* \amalg:                                Math symbols.      (line  8073)
+* \and for \author:                      \maketitle.        (line  9730)
+* \angle:                                Math symbols.      (line  8076)
+* \appendix:                             \appendix.         (line  2403)
+* \approx:                               Math symbols.      (line  8081)
 * \arabic{COUNTER}:                      \alph \Alph \arabic \roman \Roman \fnsymbol.
-                                                            (line  7212)
-* \arccos:                               Math functions.    (line  9115)
-* \arcsin:                               Math functions.    (line  9118)
-* \arctan:                               Math functions.    (line  9121)
-* \arg:                                  Math functions.    (line  9124)
-* \arraycolsep:                          array.             (line  2921)
-* \arrayrulewidth:                       tabular.           (line  5076)
-* \arraystretch:                         tabular.           (line  5082)
-* \ast:                                  Math symbols.      (line  8083)
-* \asymp:                                Math symbols.      (line  8092)
-* \AtBeginDocument:                      \AtBeginDocument.  (line  3151)
+                                                            (line  7213)
+* \arccos:                               Math functions.    (line  9116)
+* \arcsin:                               Math functions.    (line  9119)
+* \arctan:                               Math functions.    (line  9122)
+* \arg:                                  Math functions.    (line  9125)
+* \arraycolsep:                          array.             (line  2922)
+* \arrayrulewidth:                       tabular.           (line  5077)
+* \arraystretch:                         tabular.           (line  5083)
+* \ast:                                  Math symbols.      (line  8084)
+* \asymp:                                Math symbols.      (line  8093)
+* \AtBeginDocument:                      \AtBeginDocument.  (line  3152)
 * \AtBeginDvi:                           Class and package commands.
-                                                            (line   857)
-* \AtEndDocument:                        \AtEndDocument.    (line  3167)
+                                                            (line   858)
+* \AtEndDocument:                        \AtEndDocument.    (line  3168)
 * \AtEndOfClass:                         Class and package commands.
-                                                            (line   862)
+                                                            (line   863)
 * \AtEndOfPackage:                       Class and package commands.
-                                                            (line   862)
-* \author{NAME1 \and NAME2 \and ...}:    \maketitle.        (line  9728)
-* \a` (grave accent in tabbing):         tabbing.           (line  4813)
-* \b (bar-under accent):                 Accents.           (line 12415)
+                                                            (line   863)
+* \author{NAME1 \and NAME2 \and ...}:    \maketitle.        (line  9729)
+* \a` (grave accent in tabbing):         tabbing.           (line  4814)
+* \b (bar-under accent):                 Accents.           (line 12416)
 * \backmatter:                           \frontmatter & \mainmatter & \backmatter.
-                                                            (line  2435)
-* \backslash:                            Math symbols.      (line  8095)
-* \bar:                                  Math accents.      (line  9235)
+                                                            (line  2436)
+* \backslash:                            Math symbols.      (line  8096)
+* \bar:                                  Math accents.      (line  9236)
 * \baselineskip:                         Low-level font commands.
-                                                            (line  1475)
+                                                            (line  1476)
 * \baselinestretch:                      Low-level font commands.
-                                                            (line  1485)
-* \begin:                                Environments.      (line  2813)
-* \beta:                                 Math symbols.      (line  8099)
-* \bf:                                   Font styles.       (line  1273)
-* \bfseries:                             Font styles.       (line  1238)
-* \bibitem:                              \bibitem.          (line  5303)
-* \bibliography:                         Using BibTeX.      (line  5427)
-* \bibliographystyle:                    Using BibTeX.      (line  5427)
-* \bigcap:                               Math symbols.      (line  8102)
-* \bigcirc:                              Math symbols.      (line  8106)
-* \bigcup:                               Math symbols.      (line  8110)
-* \bigodot:                              Math symbols.      (line  8114)
-* \bigoplus:                             Math symbols.      (line  8117)
-* \bigotimes:                            Math symbols.      (line  8120)
+                                                            (line  1486)
+* \begin:                                Environments.      (line  2814)
+* \beta:                                 Math symbols.      (line  8100)
+* \bf:                                   Font styles.       (line  1274)
+* \bfseries:                             Font styles.       (line  1239)
+* \bibitem:                              \bibitem.          (line  5304)
+* \bibliography:                         Using BibTeX.      (line  5428)
+* \bibliographystyle:                    Using BibTeX.      (line  5428)
+* \bigcap:                               Math symbols.      (line  8103)
+* \bigcirc:                              Math symbols.      (line  8107)
+* \bigcup:                               Math symbols.      (line  8111)
+* \bigodot:                              Math symbols.      (line  8115)
+* \bigoplus:                             Math symbols.      (line  8118)
+* \bigotimes:                            Math symbols.      (line  8121)
 * \bigskip:                              \bigskip & \medskip & \smallskip.
-                                                            (line 10441)
+                                                            (line 10442)
 * \bigskipamount:                        \bigskip & \medskip & \smallskip.
-                                                            (line 10442)
-* \bigsqcup:                             Math symbols.      (line  8131)
-* \bigtriangledown:                      Math symbols.      (line  8123)
-* \bigtriangleup:                        Math symbols.      (line  8127)
-* \biguplus:                             Math symbols.      (line  8134)
-* \bigvee:                               Math symbols.      (line  8138)
-* \bigwedge:                             Math symbols.      (line  8141)
-* \bmod:                                 Math functions.    (line  9127)
+                                                            (line 10443)
+* \bigsqcup:                             Math symbols.      (line  8132)
+* \bigtriangledown:                      Math symbols.      (line  8124)
+* \bigtriangleup:                        Math symbols.      (line  8128)
+* \biguplus:                             Math symbols.      (line  8135)
+* \bigvee:                               Math symbols.      (line  8139)
+* \bigwedge:                             Math symbols.      (line  8142)
+* \bmod:                                 Math functions.    (line  9128)
 * \boldmath:                             \boldmath & \unboldmath.
-                                                            (line  9017)
+                                                            (line  9018)
 * \boldmath <1>:                         \boldmath & \unboldmath.
-                                                            (line  9025)
-* \bot:                                  Math symbols.      (line  8144)
-* \bottomfraction:                       Floats.            (line  1899)
-* \bottomfraction <1>:                   Floats.            (line  1900)
-* \bowtie:                               Math symbols.      (line  8149)
-* \Box:                                  Math symbols.      (line  8152)
-* \breve:                                Math accents.      (line  9238)
-* \bullet:                               Math symbols.      (line  8157)
-* \c (cedilla accent):                   Accents.           (line 12425)
-* \cal:                                  Font styles.       (line  1276)
-* \cap:                                  Math symbols.      (line  8160)
-* \capitalacute:                         Accents.           (line 12393)
-* \capitalbreve:                         Accents.           (line 12451)
-* \capitalcaron:                         Accents.           (line 12455)
-* \capitalcedilla:                       Accents.           (line 12425)
-* \capitalcircumflex:                    Accents.           (line 12404)
-* \capitaldieresis:                      Accents.           (line 12389)
-* \capitaldotaccent:                     Accents.           (line 12429)
-* \capitalgrave:                         Accents.           (line 12408)
-* \capitalhungarumlaut:                  Accents.           (line 12433)
-* \capitalmacron:                        Accents.           (line 12400)
-* \capitalnewtie:                        Accents.           (line 12447)
-* \capitalogonek:                        Accents.           (line 12437)
-* \capitalring:                          Accents.           (line 12441)
-* \capitaltie:                           Accents.           (line 12447)
-* \capitaltilde:                         Accents.           (line 12412)
-* \caption:                              figure.            (line  3364)
-* \caption <1>:                          table.             (line  4903)
-* \cc:                                   \cc.               (line 13654)
-* \cdot:                                 Math symbols.      (line  8165)
-* \cdots:                                Dots.              (line  9068)
-* \centering:                            \centering.        (line  3003)
-* \chapter:                              Sectioning.        (line  1961)
-* \chapter <1>:                          \chapter.          (line  2100)
-* \check:                                Math accents.      (line  9241)
+                                                            (line  9026)
+* \bot:                                  Math symbols.      (line  8145)
+* \bottomfraction:                       Floats.            (line  1900)
+* \bottomfraction <1>:                   Floats.            (line  1901)
+* \bowtie:                               Math symbols.      (line  8150)
+* \Box:                                  Math symbols.      (line  8153)
+* \breve:                                Math accents.      (line  9239)
+* \bullet:                               Math symbols.      (line  8158)
+* \c (cedilla accent):                   Accents.           (line 12426)
+* \cal:                                  Font styles.       (line  1277)
+* \cap:                                  Math symbols.      (line  8161)
+* \capitalacute:                         Accents.           (line 12394)
+* \capitalbreve:                         Accents.           (line 12452)
+* \capitalcaron:                         Accents.           (line 12456)
+* \capitalcedilla:                       Accents.           (line 12426)
+* \capitalcircumflex:                    Accents.           (line 12405)
+* \capitaldieresis:                      Accents.           (line 12390)
+* \capitaldotaccent:                     Accents.           (line 12430)
+* \capitalgrave:                         Accents.           (line 12409)
+* \capitalhungarumlaut:                  Accents.           (line 12434)
+* \capitalmacron:                        Accents.           (line 12401)
+* \capitalnewtie:                        Accents.           (line 12448)
+* \capitalogonek:                        Accents.           (line 12438)
+* \capitalring:                          Accents.           (line 12442)
+* \capitaltie:                           Accents.           (line 12448)
+* \capitaltilde:                         Accents.           (line 12413)
+* \caption:                              figure.            (line  3365)
+* \caption <1>:                          table.             (line  4904)
+* \cc:                                   \cc.               (line 13655)
+* \cdot:                                 Math symbols.      (line  8166)
+* \cdots:                                Dots.              (line  9069)
+* \centering:                            \centering.        (line  3004)
+* \chapter:                              Sectioning.        (line  1962)
+* \chapter <1>:                          \chapter.          (line  2101)
+* \check:                                Math accents.      (line  9242)
 * \CheckCommand:                         Class and package commands.
-                                                            (line   869)
+                                                            (line   870)
 * \CheckCommand*:                        Class and package commands.
-                                                            (line   869)
-* \chi:                                  Math symbols.      (line  8168)
-* \circ:                                 Math symbols.      (line  8171)
-* \circle:                               \circle.           (line  4450)
-* \cite:                                 \cite.             (line  5362)
+                                                            (line   870)
+* \chi:                                  Math symbols.      (line  8169)
+* \circ:                                 Math symbols.      (line  8172)
+* \circle:                               \circle.           (line  4451)
+* \cite:                                 \cite.             (line  5363)
 * \ClassError:                           Class and package commands.
-                                                            (line   889)
+                                                            (line   890)
 * \ClassInfo:                            Class and package commands.
-                                                            (line   889)
+                                                            (line   890)
 * \ClassInfoNoLine:                      Class and package commands.
-                                                            (line   889)
+                                                            (line   890)
 * \ClassWarning:                         Class and package commands.
-                                                            (line   889)
+                                                            (line   890)
 * \ClassWarningNoLine:                   Class and package commands.
-                                                            (line   889)
+                                                            (line   890)
 * \cleardoublepage:                      \clearpage & \cleardoublepage.
-                                                            (line  5998)
+                                                            (line  5999)
 * \clearpage:                            \clearpage & \cleardoublepage.
-                                                            (line  5998)
-* \cline:                                \cline.            (line  5210)
-* \closing:                              \closing.          (line 13670)
-* \clubsuit:                             Math symbols.      (line  8176)
+                                                            (line  5999)
+* \cline:                                \cline.            (line  5211)
+* \closein:                              \openin & \openout.
+                                                            (line 13856)
+* \closeout:                             \openin & \openout.
+                                                            (line 13856)
+* \closing:                              \closing.          (line 13671)
+* \clubsuit:                             Math symbols.      (line  8177)
 * \colon:                                Colon character & \colon.
-                                                            (line  9497)
-* \columnsep:                            \twocolumn.        (line  1553)
+                                                            (line  9498)
+* \columnsep:                            \twocolumn.        (line  1554)
 * \columnsep <1>:                        Page layout parameters.
-                                                            (line  1678)
+                                                            (line  1679)
 * \columnsep <2>:                        Page layout parameters.
-                                                            (line  1681)
-* \columnseprule:                        \twocolumn.        (line  1559)
+                                                            (line  1682)
+* \columnseprule:                        \twocolumn.        (line  1560)
 * \columnseprule <1>:                    Page layout parameters.
-                                                            (line  1679)
+                                                            (line  1680)
 * \columnseprule <2>:                    Page layout parameters.
+                                                            (line  1682)
+* \columnwidth:                          \twocolumn.        (line  1567)
+* \columnwidth <1>:                      Page layout parameters.
                                                             (line  1681)
-* \columnwidth:                          \twocolumn.        (line  1566)
-* \columnwidth <1>:                      Page layout parameters.
-                                                            (line  1680)
 * \columnwidth <2>:                      Page layout parameters.
-                                                            (line  1681)
-* \complement:                           Math symbols.      (line  8179)
-* \cong:                                 Math symbols.      (line  8185)
-* \contentsline:                         \addcontentsline.  (line 12954)
-* \coprod:                               Math symbols.      (line  8188)
-* \copyright:                            Text symbols.      (line 12188)
-* \cos:                                  Math functions.    (line  9130)
-* \cosh:                                 Math functions.    (line  9133)
-* \cot:                                  Math functions.    (line  9136)
-* \coth:                                 Math functions.    (line  9139)
-* \csc:                                  Math functions.    (line  9142)
-* \cup:                                  Math symbols.      (line  8191)
+                                                            (line  1682)
+* \complement:                           Math symbols.      (line  8180)
+* \cong:                                 Math symbols.      (line  8186)
+* \contentsline:                         \addcontentsline.  (line 12955)
+* \coprod:                               Math symbols.      (line  8189)
+* \copyright:                            Text symbols.      (line 12189)
+* \cos:                                  Math functions.    (line  9131)
+* \cosh:                                 Math functions.    (line  9134)
+* \cot:                                  Math functions.    (line  9137)
+* \coth:                                 Math functions.    (line  9140)
+* \csc:                                  Math functions.    (line  9143)
+* \cup:                                  Math symbols.      (line  8192)
 * \CurrentOption:                        Class and package commands.
-                                                            (line   908)
-* \d (dot-under accent):                 Accents.           (line 12429)
-* \dag:                                  Text symbols.      (line 12192)
-* \dagger:                               Math symbols.      (line  8196)
-* \dashbox:                              \dashbox.          (line  4656)
-* \dashv:                                Math symbols.      (line  8199)
-* \date{TEXT}:                           \maketitle.        (line  9736)
+                                                            (line   909)
+* \d (dot-under accent):                 Accents.           (line 12430)
+* \dag:                                  Text symbols.      (line 12193)
+* \dagger:                               Math symbols.      (line  8197)
+* \dashbox:                              \dashbox.          (line  4657)
+* \dashv:                                Math symbols.      (line  8200)
+* \date{TEXT}:                           \maketitle.        (line  9737)
 * \day:                                  \day & \month & \year.
-                                                            (line  7377)
-* \dblfloatpagefraction:                 \twocolumn.        (line  1599)
-* \dblfloatsep:                          \twocolumn.        (line  1605)
-* \dbltextfloatsep:                      \twocolumn.        (line  1612)
-* \dbltopfraction:                       \twocolumn.        (line  1578)
-* \dbltopnumber:                         \twocolumn.        (line  1617)
-* \ddag:                                 Text symbols.      (line 12195)
-* \ddagger:                              Math symbols.      (line  8203)
-* \ddot:                                 Math accents.      (line  9244)
-* \ddots:                                Dots.              (line  9072)
+                                                            (line  7378)
+* \dblfloatpagefraction:                 \twocolumn.        (line  1600)
+* \dblfloatsep:                          \twocolumn.        (line  1606)
+* \dbltextfloatsep:                      \twocolumn.        (line  1613)
+* \dbltopfraction:                       \twocolumn.        (line  1579)
+* \dbltopnumber:                         \twocolumn.        (line  1618)
+* \ddag:                                 Text symbols.      (line 12196)
+* \ddagger:                              Math symbols.      (line  8204)
+* \ddot:                                 Math accents.      (line  9245)
+* \ddots:                                Dots.              (line  9073)
 * \DeclareGraphicsExtensions:            \DeclareGraphicsExtensions.
-                                                            (line 11519)
+                                                            (line 11520)
 * \DeclareGraphicsRule:                  \DeclareGraphicsRule.
-                                                            (line 11559)
+                                                            (line 11560)
 * \DeclareOption:                        Class and package commands.
-                                                            (line   914)
+                                                            (line   915)
 * \DeclareOption*:                       Class and package commands.
-                                                            (line   914)
+                                                            (line   915)
 * \DeclareRobustCommand:                 Class and package commands.
-                                                            (line   944)
+                                                            (line   945)
 * \DeclareRobustCommand*:                Class and package commands.
-                                                            (line   944)
-* \deg:                                  Math functions.    (line  9145)
-* \Delta:                                Math symbols.      (line  8206)
-* \delta:                                Math symbols.      (line  8209)
-* \det:                                  Math functions.    (line  9148)
+                                                            (line   945)
+* \deg:                                  Math functions.    (line  9146)
+* \Delta:                                Math symbols.      (line  8207)
+* \delta:                                Math symbols.      (line  8210)
+* \det:                                  Math functions.    (line  9149)
 * \dh (d):                               Additional Latin letters.
-                                                            (line 12518)
+                                                            (line 12519)
 * \DH (D):                               Additional Latin letters.
-                                                            (line 12518)
-* \Diamond:                              Math symbols.      (line  8212)
-* \diamond:                              Math symbols.      (line  8216)
-* \diamondsuit:                          Math symbols.      (line  8220)
-* \dim:                                  Math functions.    (line  9151)
-* \displaystyle:                         Math formulas.     (line  7952)
-* \div:                                  Math symbols.      (line  8223)
+                                                            (line 12519)
+* \Diamond:                              Math symbols.      (line  8213)
+* \diamond:                              Math symbols.      (line  8217)
+* \diamondsuit:                          Math symbols.      (line  8221)
+* \dim:                                  Math functions.    (line  9152)
+* \displaystyle:                         Math formulas.     (line  7953)
+* \div:                                  Math symbols.      (line  8224)
 * \dj:                                   Additional Latin letters.
-                                                            (line 12524)
+                                                            (line 12525)
 * \DJ:                                   Additional Latin letters.
-                                                            (line 12524)
-* \documentclass:                        Document classes.  (line   635)
-* \dot:                                  Math accents.      (line  9247)
-* \doteq:                                Math symbols.      (line  8226)
+                                                            (line 12525)
+* \documentclass:                        Document classes.  (line   636)
+* \dot:                                  Math accents.      (line  9248)
+* \doteq:                                Math symbols.      (line  8227)
 * \dotfill:                              \hrulefill & \dotfill.
-                                                            (line 10370)
-* \dots:                                 Text symbols.      (line 12212)
-* \doublerulesep:                        tabular.           (line  5087)
-* \downarrow:                            Math symbols.      (line  8230)
-* \Downarrow:                            Math symbols.      (line  8234)
-* \ell:                                  Math symbols.      (line  8238)
-* \emph:                                 Font styles.       (line  1258)
-* \emptyset:                             Math symbols.      (line  8241)
-* \encl:                                 \encl.             (line 13683)
-* \end:                                  Environments.      (line  2813)
-* \endinput:                             \endinput.         (line 12670)
-* \enlargethispage:                      \enlargethispage.  (line  6072)
+                                                            (line 10371)
+* \dots:                                 Text symbols.      (line 12213)
+* \doublerulesep:                        tabular.           (line  5088)
+* \downarrow:                            Math symbols.      (line  8231)
+* \Downarrow:                            Math symbols.      (line  8235)
+* \ell:                                  Math symbols.      (line  8239)
+* \emph:                                 Font styles.       (line  1259)
+* \emptyset:                             Math symbols.      (line  8242)
+* \encl:                                 \encl.             (line 13684)
+* \end:                                  Environments.      (line  2814)
+* \endinput:                             \endinput.         (line 12671)
+* \enlargethispage:                      \enlargethispage.  (line  6073)
 * \enspace:                              \enspace & \quad & \qquad.
-                                                            (line  9943)
-* \enumi:                                enumerate.         (line  3224)
-* \enumii:                               enumerate.         (line  3224)
-* \enumiii:                              enumerate.         (line  3224)
-* \enumiv:                               enumerate.         (line  3224)
-* \epsilon:                              Math symbols.      (line  8245)
-* \equiv:                                Math symbols.      (line  8251)
-* \eta:                                  Math symbols.      (line  8254)
+                                                            (line  9944)
+* \enumi:                                enumerate.         (line  3225)
+* \enumii:                               enumerate.         (line  3225)
+* \enumiii:                              enumerate.         (line  3225)
+* \enumiv:                               enumerate.         (line  3225)
+* \epsilon:                              Math symbols.      (line  8246)
+* \equiv:                                Math symbols.      (line  8252)
+* \eta:                                  Math symbols.      (line  8255)
 * \evensidemargin:                       Document class options.
-                                                            (line   747)
+                                                            (line   748)
 * \evensidemargin <1>:                   Page layout parameters.
-                                                            (line  1739)
+                                                            (line  1740)
 * \evensidemargin <2>:                   Page layout parameters.
-                                                            (line  1740)
+                                                            (line  1741)
 * \ExecuteOptions:                       Class and package commands.
-                                                            (line  1020)
-* \exists:                               Math symbols.      (line  8257)
-* \exp:                                  Math functions.    (line  9154)
-* \extracolsep:                          tabular.           (line  5027)
-* \fbox:                                 \fbox & \framebox. (line 10805)
+                                                            (line  1021)
+* \exists:                               Math symbols.      (line  8258)
+* \exp:                                  Math functions.    (line  9155)
+* \extracolsep:                          tabular.           (line  5028)
+* \fbox:                                 \fbox & \framebox. (line 10806)
 * \fboxrule:                             \framebox (picture).
-                                                            (line  4633)
-* \fboxrule <1>:                         \fbox & \framebox. (line 10838)
-* \fboxrule <2>:                         \fbox & \framebox. (line 10837)
+                                                            (line  4634)
+* \fboxrule <1>:                         \fbox & \framebox. (line 10839)
+* \fboxrule <2>:                         \fbox & \framebox. (line 10838)
 * \fboxsep:                              \framebox (picture).
-                                                            (line  4633)
-* \fboxsep <1>:                          \fbox & \framebox. (line 10843)
-* \fboxsep <2>:                          \fbox & \framebox. (line 10842)
-* \fill:                                 \hfill.            (line 10030)
-* \flat:                                 Math symbols.      (line  8260)
-* \floatpagefraction:                    Floats.            (line  1903)
-* \floatpagefraction <1>:                Floats.            (line  1904)
-* \floatsep:                             Floats.            (line  1919)
-* \floatsep <1>:                         Floats.            (line  1920)
-* \flushbottom:                          \flushbottom.      (line  1646)
-* \fnsymbol, and footnotes:              \footnote.         (line  6175)
+                                                            (line  4634)
+* \fboxsep <1>:                          \fbox & \framebox. (line 10844)
+* \fboxsep <2>:                          \fbox & \framebox. (line 10843)
+* \fill:                                 \hfill.            (line 10031)
+* \flat:                                 Math symbols.      (line  8261)
+* \floatpagefraction:                    Floats.            (line  1904)
+* \floatpagefraction <1>:                Floats.            (line  1905)
+* \floatsep:                             Floats.            (line  1920)
+* \floatsep <1>:                         Floats.            (line  1921)
+* \flushbottom:                          \flushbottom.      (line  1647)
+* \fnsymbol, and footnotes:              \footnote.         (line  6176)
 * \fnsymbol{COUNTER}:                    \alph \Alph \arabic \roman \Roman \fnsymbol.
-                                                            (line  7225)
+                                                            (line  7226)
 * \fontencoding:                         Low-level font commands.
-                                                            (line  1385)
+                                                            (line  1386)
 * \fontfamily:                           Low-level font commands.
-                                                            (line  1395)
+                                                            (line  1396)
 * \fontseries:                           Low-level font commands.
-                                                            (line  1422)
+                                                            (line  1423)
 * \fontshape:                            Low-level font commands.
-                                                            (line  1462)
+                                                            (line  1463)
 * \fontsize:                             Low-level font commands.
-                                                            (line  1475)
-* \footnote:                             \footnote.         (line  6157)
-* \footnotemark:                         \footnotemark.     (line  6223)
-* \footnoterule:                         \footnote.         (line  6185)
-* \footnotesep:                          \footnote.         (line  6197)
-* \footnotesize:                         Font sizes.        (line  1350)
-* \footnotetext:                         \footnotetext.     (line  6279)
+                                                            (line  1476)
+* \footnote:                             \footnote.         (line  6158)
+* \footnotemark:                         \footnotemark.     (line  6224)
+* \footnoterule:                         \footnote.         (line  6186)
+* \footnotesep:                          \footnote.         (line  6198)
+* \footnotesize:                         Font sizes.        (line  1351)
+* \footnotetext:                         \footnotetext.     (line  6280)
 * \footskip:                             Page layout parameters.
-                                                            (line  1698)
+                                                            (line  1699)
 * \footskip <1>:                         Page layout parameters.
-                                                            (line  1699)
-* \forall:                               Math symbols.      (line  8263)
-* \frac:                                 \frac.             (line  9533)
-* \frame:                                \frame.            (line  4644)
+                                                            (line  1700)
+* \forall:                               Math symbols.      (line  8264)
+* \frac:                                 \frac.             (line  9534)
+* \frame:                                \frame.            (line  4645)
 * \framebox:                             \framebox (picture).
-                                                            (line  4608)
-* \framebox <1>:                         \fbox & \framebox. (line 10805)
-* \frenchspacing:                        \frenchspacing.    (line 10184)
+                                                            (line  4609)
+* \framebox <1>:                         \fbox & \framebox. (line 10806)
+* \frenchspacing:                        \frenchspacing.    (line 10185)
 * \frontmatter:                          \frontmatter & \mainmatter & \backmatter.
-                                                            (line  2435)
-* \frown:                                Math symbols.      (line  8266)
-* \fussy:                                \fussy & \sloppy.  (line  5877)
-* \Gamma:                                Math symbols.      (line  8269)
-* \gamma:                                Math symbols.      (line  8272)
-* \gcd:                                  Math functions.    (line  9157)
-* \ge:                                   Math symbols.      (line  8275)
-* \geq:                                  Math symbols.      (line  8279)
-* \gets:                                 Math symbols.      (line  8283)
-* \gg:                                   Math symbols.      (line  8286)
-* \gls:                                  \gls.              (line 13519)
-* \graphicspath:                         \graphicspath.     (line 11457)
-* \graphpaper:                           \graphpaper.       (line  4354)
-* \grave:                                Math accents.      (line  9250)
-* \guillemotleft (<<):                   Text symbols.      (line 12204)
-* \guillemotright (>>):                  Text symbols.      (line 12205)
-* \guilsinglleft (<):                    Text symbols.      (line 12206)
-* \guilsinglright (>):                   Text symbols.      (line 12207)
-* \H (Hungarian umlaut accent):          Accents.           (line 12433)
-* \hat:                                  Math accents.      (line  9253)
-* \hbar:                                 Math symbols.      (line  8290)
+                                                            (line  2436)
+* \frown:                                Math symbols.      (line  8267)
+* \fussy:                                \fussy & \sloppy.  (line  5878)
+* \Gamma:                                Math symbols.      (line  8270)
+* \gamma:                                Math symbols.      (line  8273)
+* \gcd:                                  Math functions.    (line  9158)
+* \ge:                                   Math symbols.      (line  8276)
+* \geq:                                  Math symbols.      (line  8280)
+* \gets:                                 Math symbols.      (line  8284)
+* \gg:                                   Math symbols.      (line  8287)
+* \gls:                                  \gls.              (line 13520)
+* \graphicspath:                         \graphicspath.     (line 11458)
+* \graphpaper:                           \graphpaper.       (line  4355)
+* \grave:                                Math accents.      (line  9251)
+* \guillemotleft (<<):                   Text symbols.      (line 12205)
+* \guillemotright (>>):                  Text symbols.      (line 12206)
+* \guilsinglleft (<):                    Text symbols.      (line 12207)
+* \guilsinglright (>):                   Text symbols.      (line 12208)
+* \H (Hungarian umlaut accent):          Accents.           (line 12434)
+* \hat:                                  Math accents.      (line  9254)
+* \hbar:                                 Math symbols.      (line  8291)
 * \headheight:                           Page layout parameters.
-                                                            (line  1686)
+                                                            (line  1687)
 * \headheight <1>:                       Page layout parameters.
-                                                            (line  1687)
+                                                            (line  1688)
 * \headsep:                              Page layout parameters.
-                                                            (line  1691)
+                                                            (line  1692)
 * \headsep <1>:                          Page layout parameters.
-                                                            (line  1692)
-* \heartsuit:                            Math symbols.      (line  8293)
-* \hfill:                                \hfill.            (line 10018)
-* \hline:                                \hline.            (line  5233)
-* \hom:                                  Math functions.    (line  9160)
-* \hookleftarrow:                        Math symbols.      (line  8296)
-* \hookrightarrow:                       Math symbols.      (line  8299)
+                                                            (line  1693)
+* \heartsuit:                            Math symbols.      (line  8294)
+* \hfill:                                \hfill.            (line 10019)
+* \hline:                                \hline.            (line  5234)
+* \hom:                                  Math functions.    (line  9161)
+* \hookleftarrow:                        Math symbols.      (line  8297)
+* \hookrightarrow:                       Math symbols.      (line  8300)
 * \hrulefill:                            \hrulefill & \dotfill.
-                                                            (line 10370)
+                                                            (line 10371)
 * \hsize:                                Page layout parameters.
-                                                            (line  1791)
+                                                            (line  1792)
 * \hsize <1>:                            Page layout parameters.
-                                                            (line  1791)
-* \hspace:                               \hspace.           (line  9971)
-* \hss:                                  \hss.              (line 10051)
-* \huge:                                 Font sizes.        (line  1350)
-* \Huge:                                 Font sizes.        (line  1350)
-* \hyphenation:                          \hyphenation.      (line  5918)
-* \i (dotless i):                        Accents.           (line 12383)
-* \iff:                                  Math symbols.      (line  8302)
+                                                            (line  1792)
+* \hspace:                               \hspace.           (line  9972)
+* \hss:                                  \hss.              (line 10052)
+* \huge:                                 Font sizes.        (line  1351)
+* \Huge:                                 Font sizes.        (line  1351)
+* \hyphenation:                          \hyphenation.      (line  5919)
+* \i (dotless i):                        Accents.           (line 12384)
+* \iff:                                  Math symbols.      (line  8303)
 * \IfFileExists:                         Class and package commands.
-                                                            (line   976)
+                                                            (line   977)
 * \ignorespaces:                         \ignorespaces & \ignorespacesafterend.
-                                                            (line  7091)
+                                                            (line  7092)
 * \ignorespacesafterend:                 \ignorespaces & \ignorespacesafterend.
-                                                            (line  7091)
+                                                            (line  7092)
 * \ij (ij):                              Additional Latin letters.
-                                                            (line 12530)
+                                                            (line 12531)
 * \IJ (IJ):                              Additional Latin letters.
-                                                            (line 12530)
-* \Im:                                   Math symbols.      (line  8306)
-* \imath:                                Math symbols.      (line  8309)
-* \in:                                   Math symbols.      (line  8313)
+                                                            (line 12531)
+* \Im:                                   Math symbols.      (line  8307)
+* \imath:                                Math symbols.      (line  8310)
+* \in:                                   Math symbols.      (line  8314)
 * \include:                              \include & \includeonly.
-                                                            (line 12701)
-* \includegraphics:                      \includegraphics.  (line 11638)
+                                                            (line 12702)
+* \includegraphics:                      \includegraphics.  (line 11639)
 * \includeonly:                          \include & \includeonly.
-                                                            (line 12701)
+                                                            (line 12702)
 * \indent:                               \indent & \noindent.
-                                                            (line  7772)
-* \index:                                Indexes.           (line 13090)
-* \index <1>:                            \index.            (line 13126)
-* \indexentry:                           \index.            (line 13226)
-* \indexspace:                           makeindex.         (line 13293)
-* \inf:                                  Math functions.    (line  9163)
-* \infty:                                Math symbols.      (line  8318)
-* \input:                                \input.            (line 12818)
+                                                            (line  7773)
+* \index:                                Indexes.           (line 13091)
+* \index <1>:                            \index.            (line 13127)
+* \indexentry:                           \index.            (line 13227)
+* \indexspace:                           makeindex.         (line 13294)
+* \inf:                                  Math functions.    (line  9164)
+* \infty:                                Math symbols.      (line  8319)
+* \input:                                \input.            (line 12819)
 * \InputIfFileExists:                    Class and package commands.
-                                                            (line   976)
-* \int:                                  Math symbols.      (line  8321)
-* \intextsep:                            Floats.            (line  1923)
-* \intextsep <1>:                        Floats.            (line  1924)
-* \iota:                                 Math symbols.      (line  8324)
-* \it:                                   Font styles.       (line  1279)
-* \item:                                 description.       (line  3070)
-* \item <1>:                             enumerate.         (line  3206)
-* \item <2>:                             itemize.           (line  3539)
-* \item <3>:                             itemize.           (line  3561)
-* \itemindent:                           list.              (line  3704)
-* \itemsep:                              list.              (line  3708)
-* \itshape:                              Font styles.       (line  1232)
-* \j (dotless j):                        Accents.           (line 12383)
-* \jmath:                                Math symbols.      (line  8331)
-* \Join:                                 Math symbols.      (line  8327)
-* \k (ogonek):                           Accents.           (line 12437)
-* \kappa:                                Math symbols.      (line  8335)
-* \ker:                                  Math functions.    (line  9166)
-* \kill:                                 tabbing.           (line  4817)
+                                                            (line   977)
+* \int:                                  Math symbols.      (line  8322)
+* \intextsep:                            Floats.            (line  1924)
+* \intextsep <1>:                        Floats.            (line  1925)
+* \iota:                                 Math symbols.      (line  8325)
+* \it:                                   Font styles.       (line  1280)
+* \item:                                 description.       (line  3071)
+* \item <1>:                             enumerate.         (line  3207)
+* \item <2>:                             itemize.           (line  3540)
+* \item <3>:                             itemize.           (line  3562)
+* \itemindent:                           list.              (line  3705)
+* \itemsep:                              list.              (line  3709)
+* \itshape:                              Font styles.       (line  1233)
+* \j (dotless j):                        Accents.           (line 12384)
+* \jmath:                                Math symbols.      (line  8332)
+* \Join:                                 Math symbols.      (line  8328)
+* \k (ogonek):                           Accents.           (line 12438)
+* \kappa:                                Math symbols.      (line  8336)
+* \ker:                                  Math functions.    (line  9167)
+* \kill:                                 tabbing.           (line  4818)
 * \l (/l):                               Additional Latin letters.
-                                                            (line 12534)
+                                                            (line 12535)
 * \L (/L):                               Additional Latin letters.
-                                                            (line 12534)
-* \label:                                \label.            (line  2702)
-* \labelenumi:                           enumerate.         (line  3233)
-* \labelenumii:                          enumerate.         (line  3233)
-* \labelenumiii:                         enumerate.         (line  3233)
-* \labelenumiv:                          enumerate.         (line  3233)
-* \labelitemi:                           itemize.           (line  3568)
-* \labelitemii:                          itemize.           (line  3568)
-* \labelitemiii:                         itemize.           (line  3568)
-* \labelitemiv:                          itemize.           (line  3568)
-* \labelsep:                             list.              (line  3720)
-* \labelwidth:                           list.              (line  3725)
-* \Lambda:                               Math symbols.      (line  8338)
-* \lambda:                               Math symbols.      (line  8341)
-* \land:                                 Math symbols.      (line  8344)
-* \langle:                               Math symbols.      (line  8349)
-* \large:                                Font sizes.        (line  1350)
-* \Large:                                Font sizes.        (line  1350)
-* \LARGE:                                Font sizes.        (line  1350)
-* \LaTeX:                                Text symbols.      (line 12198)
-* \LaTeXe:                               Text symbols.      (line 12201)
-* \lbrace:                               Math symbols.      (line  8354)
-* \lbrack:                               Math symbols.      (line  8358)
-* \lceil:                                Math symbols.      (line  8362)
-* \ldots:                                Dots.              (line  9076)
-* \ldots <1>:                            Text symbols.      (line 12211)
-* \le:                                   Math symbols.      (line  8366)
-* \leadsto:                              Math symbols.      (line  8370)
-* \left:                                 \left & \right.    (line  9545)
-* \Leftarrow:                            Math symbols.      (line  8377)
-* \leftarrow:                            Math symbols.      (line  8382)
-* \lefteqn:                              eqnarray.          (line  3290)
-* \leftharpoondown:                      Math symbols.      (line  8386)
-* \leftharpoonup:                        Math symbols.      (line  8389)
-* \leftmargin:                           itemize.           (line  3587)
-* \leftmargin <1>:                       list.              (line  3745)
-* \leftmargini:                          itemize.           (line  3587)
-* \leftmarginii:                         itemize.           (line  3587)
-* \leftmarginiii:                        itemize.           (line  3587)
-* \leftmarginiv:                         itemize.           (line  3587)
-* \leftmarginv:                          itemize.           (line  3587)
-* \leftmarginvi:                         itemize.           (line  3587)
-* \Leftrightarrow:                       Math symbols.      (line  8392)
-* \leftrightarrow:                       Math symbols.      (line  8397)
-* \leq:                                  Math symbols.      (line  8402)
-* \lfloor:                               Math symbols.      (line  8406)
-* \lg:                                   Math functions.    (line  9169)
-* \lhd:                                  Math symbols.      (line  8409)
-* \lim:                                  Math functions.    (line  9172)
-* \liminf:                               Math functions.    (line  9175)
-* \limsup:                               Math functions.    (line  9178)
-* \line:                                 \line.             (line  4378)
+                                                            (line 12535)
+* \label:                                \label.            (line  2703)
+* \labelenumi:                           enumerate.         (line  3234)
+* \labelenumii:                          enumerate.         (line  3234)
+* \labelenumiii:                         enumerate.         (line  3234)
+* \labelenumiv:                          enumerate.         (line  3234)
+* \labelitemi:                           itemize.           (line  3569)
+* \labelitemii:                          itemize.           (line  3569)
+* \labelitemiii:                         itemize.           (line  3569)
+* \labelitemiv:                          itemize.           (line  3569)
+* \labelsep:                             list.              (line  3721)
+* \labelwidth:                           list.              (line  3726)
+* \Lambda:                               Math symbols.      (line  8339)
+* \lambda:                               Math symbols.      (line  8342)
+* \land:                                 Math symbols.      (line  8345)
+* \langle:                               Math symbols.      (line  8350)
+* \large:                                Font sizes.        (line  1351)
+* \Large:                                Font sizes.        (line  1351)
+* \LARGE:                                Font sizes.        (line  1351)
+* \LaTeX:                                Text symbols.      (line 12199)
+* \LaTeXe:                               Text symbols.      (line 12202)
+* \lbrace:                               Math symbols.      (line  8355)
+* \lbrack:                               Math symbols.      (line  8359)
+* \lceil:                                Math symbols.      (line  8363)
+* \ldots:                                Dots.              (line  9077)
+* \ldots <1>:                            Text symbols.      (line 12212)
+* \le:                                   Math symbols.      (line  8367)
+* \leadsto:                              Math symbols.      (line  8371)
+* \left:                                 \left & \right.    (line  9546)
+* \Leftarrow:                            Math symbols.      (line  8378)
+* \leftarrow:                            Math symbols.      (line  8383)
+* \lefteqn:                              eqnarray.          (line  3291)
+* \leftharpoondown:                      Math symbols.      (line  8387)
+* \leftharpoonup:                        Math symbols.      (line  8390)
+* \leftmargin:                           itemize.           (line  3588)
+* \leftmargin <1>:                       list.              (line  3746)
+* \leftmargini:                          itemize.           (line  3588)
+* \leftmarginii:                         itemize.           (line  3588)
+* \leftmarginiii:                        itemize.           (line  3588)
+* \leftmarginiv:                         itemize.           (line  3588)
+* \leftmarginv:                          itemize.           (line  3588)
+* \leftmarginvi:                         itemize.           (line  3588)
+* \Leftrightarrow:                       Math symbols.      (line  8393)
+* \leftrightarrow:                       Math symbols.      (line  8398)
+* \leq:                                  Math symbols.      (line  8403)
+* \lfloor:                               Math symbols.      (line  8407)
+* \lg:                                   Math functions.    (line  9170)
+* \lhd:                                  Math symbols.      (line  8410)
+* \lim:                                  Math functions.    (line  9173)
+* \liminf:                               Math functions.    (line  9176)
+* \limsup:                               Math functions.    (line  9179)
+* \line:                                 \line.             (line  4379)
 * \linebreak:                            \linebreak & \nolinebreak.
-                                                            (line  5936)
+                                                            (line  5937)
 * \linespread:                           Low-level font commands.
-                                                            (line  1499)
-* \linethickness:                        \linethickness.    (line  4422)
+                                                            (line  1500)
+* \linethickness:                        \linethickness.    (line  4423)
 * \linewidth:                            Page layout parameters.
-                                                            (line  1705)
+                                                            (line  1706)
 * \linewidth <1>:                        Page layout parameters.
-                                                            (line  1706)
+                                                            (line  1707)
 * \listoffigures:                        Table of contents etc..
-                                                            (line 12856)
+                                                            (line 12857)
 * \listoftables:                         Table of contents etc..
-                                                            (line 12856)
-* \listparindent:                        list.              (line  3762)
-* \ll:                                   Math symbols.      (line  8417)
-* \ln:                                   Math functions.    (line  9181)
-* \lnot:                                 Math symbols.      (line  8421)
+                                                            (line 12857)
+* \listparindent:                        list.              (line  3763)
+* \ll:                                   Math symbols.      (line  8418)
+* \ln:                                   Math functions.    (line  9182)
+* \lnot:                                 Math symbols.      (line  8422)
 * \LoadClass:                            Class and package commands.
-                                                            (line   996)
+                                                            (line   997)
 * \LoadClassWithOptions:                 Class and package commands.
-                                                            (line   996)
-* \location:                             \location.         (line 13698)
-* \log:                                  Math functions.    (line  9184)
-* \longleftarrow:                        Math symbols.      (line  8424)
-* \longleftrightarrow:                   Math symbols.      (line  8429)
-* \longmapsto:                           Math symbols.      (line  8433)
-* \longrightarrow:                       Math symbols.      (line  8438)
-* \lor:                                  Math symbols.      (line  8443)
-* \lq:                                   Text symbols.      (line 12217)
+                                                            (line   997)
+* \location:                             \location.         (line 13699)
+* \log:                                  Math functions.    (line  9185)
+* \longleftarrow:                        Math symbols.      (line  8425)
+* \longleftrightarrow:                   Math symbols.      (line  8430)
+* \longmapsto:                           Math symbols.      (line  8434)
+* \longrightarrow:                       Math symbols.      (line  8439)
+* \lor:                                  Math symbols.      (line  8444)
+* \lq:                                   Text symbols.      (line 12218)
 * \mainmatter:                           \frontmatter & \mainmatter & \backmatter.
-                                                            (line  2435)
-* \makebox:                              \mbox & \makebox.  (line 10716)
+                                                            (line  2436)
+* \makebox:                              \mbox & \makebox.  (line 10717)
 * \makebox (for picture):                \makebox (picture).
-                                                            (line  4570)
-* \makeglossary:                         Glossaries.        (line 13412)
-* \makeglossary <1>:                     Glossaries.        (line 13449)
-* \makeindex:                            Indexes.           (line 13090)
-* \makelabel:                            list.              (line  3681)
-* \makelabels:                           \makelabels.       (line 13708)
-* \maketitle:                            \maketitle.        (line  9692)
-* \mapsto:                               Math symbols.      (line  8446)
-* \marginpar:                            Marginal notes.    (line  7848)
+                                                            (line  4571)
+* \makeglossary:                         Glossaries.        (line 13413)
+* \makeglossary <1>:                     Glossaries.        (line 13450)
+* \makeindex:                            Indexes.           (line 13091)
+* \makelabel:                            list.              (line  3682)
+* \makelabels:                           \makelabels.       (line 13709)
+* \maketitle:                            \maketitle.        (line  9693)
+* \mapsto:                               Math symbols.      (line  8447)
+* \marginpar:                            Marginal notes.    (line  7849)
 * \marginparpush:                        Page layout parameters.
-                                                            (line  1712)
+                                                            (line  1713)
 * \marginparpush <1>:                    Page layout parameters.
+                                                            (line  1716)
+* \marginparpush <2>:                    Marginal notes.    (line  7878)
+* \marginparsep:                         Marginal notes.    (line  7882)
+* \marginparwidth:                       Page layout parameters.
                                                             (line  1715)
-* \marginparpush <2>:                    Marginal notes.    (line  7877)
-* \marginparsep:                         Marginal notes.    (line  7881)
-* \marginparwidth:                       Page layout parameters.
-                                                            (line  1714)
 * \marginparwidth <1>:                   Page layout parameters.
-                                                            (line  1715)
-* \marginparwidth <2>:                   Marginal notes.    (line  7885)
+                                                            (line  1716)
+* \marginparwidth <2>:                   Marginal notes.    (line  7886)
 * \marginsep:                            Page layout parameters.
-                                                            (line  1713)
+                                                            (line  1714)
 * \marginsep <1>:                        Page layout parameters.
-                                                            (line  1715)
-* \markboth{LEFT-HEAD}{RIGHT-HEAD}:      \pagestyle.        (line  9890)
-* \markright{RIGHT}:                     \pagestyle.        (line  9899)
-* \mathbf:                               Font styles.       (line  1309)
-* \mathcal:                              Font styles.       (line  1325)
-* \mathdollar:                           Math symbols.      (line  8955)
-* \mathnormal:                           Font styles.       (line  1322)
-* \mathparagraph:                        Math symbols.      (line  8958)
-* \mathring:                             Math accents.      (line  9256)
-* \mathrm:                               Font styles.       (line  1306)
-* \mathsection:                          Math symbols.      (line  8961)
-* \mathsf:                               Font styles.       (line  1312)
-* \mathsterling:                         Math symbols.      (line  8964)
-* \mathtt:                               Font styles.       (line  1315)
-* \mathunderscore:                       Math symbols.      (line  8967)
-* \mathversion:                          Font styles.       (line  1327)
-* \max:                                  Math functions.    (line  9187)
-* \mbox:                                 \mbox & \makebox.  (line 10716)
-* \mdseries:                             Font styles.       (line  1235)
+                                                            (line  1716)
+* \markboth{LEFT-HEAD}{RIGHT-HEAD}:      \pagestyle.        (line  9891)
+* \markright{RIGHT}:                     \pagestyle.        (line  9900)
+* \mathbf:                               Font styles.       (line  1310)
+* \mathcal:                              Font styles.       (line  1326)
+* \mathdollar:                           Math symbols.      (line  8956)
+* \mathnormal:                           Font styles.       (line  1323)
+* \mathparagraph:                        Math symbols.      (line  8959)
+* \mathring:                             Math accents.      (line  9257)
+* \mathrm:                               Font styles.       (line  1307)
+* \mathsection:                          Math symbols.      (line  8962)
+* \mathsf:                               Font styles.       (line  1313)
+* \mathsterling:                         Math symbols.      (line  8965)
+* \mathtt:                               Font styles.       (line  1316)
+* \mathunderscore:                       Math symbols.      (line  8968)
+* \mathversion:                          Font styles.       (line  1328)
+* \max:                                  Math functions.    (line  9188)
+* \mbox:                                 \mbox & \makebox.  (line 10717)
+* \mdseries:                             Font styles.       (line  1236)
 * \medskip:                              \bigskip & \medskip & \smallskip.
-                                                            (line 10446)
+                                                            (line 10447)
 * \medskipamount:                        \bigskip & \medskip & \smallskip.
-                                                            (line 10447)
+                                                            (line 10448)
 * \medspace:                             Spacing in math mode.
-                                                            (line  9344)
-* \message:                              \message.          (line 14041)
-* \mho:                                  Math symbols.      (line  8450)
-* \mid:                                  Math symbols.      (line  8455)
-* \min:                                  Math functions.    (line  9190)
-* \models:                               Math symbols.      (line  8465)
+                                                            (line  9345)
+* \message:                              \message.          (line 14104)
+* \mho:                                  Math symbols.      (line  8451)
+* \mid:                                  Math symbols.      (line  8456)
+* \min:                                  Math functions.    (line  9191)
+* \models:                               Math symbols.      (line  8466)
 * \month:                                \day & \month & \year.
-                                                            (line  7377)
-* \mp:                                   Math symbols.      (line  8470)
-* \mu:                                   Math symbols.      (line  8473)
-* \multicolumn:                          \multicolumn.      (line  5102)
-* \multiput:                             \multiput.         (line  4306)
-* \nabla:                                Math symbols.      (line  8476)
-* \name:                                 \name.             (line 13765)
-* \natural:                              Math symbols.      (line  8479)
-* \ne:                                   Math symbols.      (line  8482)
-* \nearrow:                              Math symbols.      (line  8485)
+                                                            (line  7378)
+* \mp:                                   Math symbols.      (line  8471)
+* \mu:                                   Math symbols.      (line  8474)
+* \multicolumn:                          \multicolumn.      (line  5103)
+* \multiput:                             \multiput.         (line  4307)
+* \nabla:                                Math symbols.      (line  8477)
+* \name:                                 \name.             (line 13766)
+* \natural:                              Math symbols.      (line  8480)
+* \ne:                                   Math symbols.      (line  8483)
+* \nearrow:                              Math symbols.      (line  8486)
 * \NeedsTeXFormat:                       Class and package commands.
-                                                            (line  1030)
-* \neg:                                  Math symbols.      (line  8488)
+                                                            (line  1031)
+* \neg:                                  Math symbols.      (line  8489)
 * \negthinspace:                         Spacing in math mode.
-                                                            (line  9362)
+                                                            (line  9363)
 * \negthinspace <1>:                     \thinspace & \negthinspace.
-                                                            (line 10311)
-* \neq:                                  Math symbols.      (line  8492)
+                                                            (line 10312)
+* \neq:                                  Math symbols.      (line  8493)
 * \newcommand:                           \newcommand & \renewcommand.
-                                                            (line  6405)
-* \newcounter:                           \newcounter.       (line  6670)
+                                                            (line  6406)
+* \newcounter:                           \newcounter.       (line  6671)
 * \newenvironment:                       \newenvironment & \renewenvironment.
-                                                            (line  6761)
-* \newfont:                              \newfont.          (line  7007)
-* \newglossaryentry:                     \newglossaryentry. (line 13460)
-* \newlength:                            \newlength.        (line  6711)
-* \newline:                              \newline.          (line  5795)
-* \NEWLINE:                              \(SPACE).          (line 10214)
-* \newpage:                              \newpage.          (line  6039)
-* \newsavebox:                           \newsavebox.       (line  6733)
-* \newtheorem:                           \newtheorem.       (line  6895)
-* \newtie:                               Accents.           (line 12447)
+                                                            (line  6762)
+* \newfont:                              \newfont.          (line  7008)
+* \newglossaryentry:                     \newglossaryentry. (line 13461)
+* \newlength:                            \newlength.        (line  6712)
+* \newline:                              \newline.          (line  5796)
+* \NEWLINE:                              \(SPACE).          (line 10215)
+* \newpage:                              \newpage.          (line  6040)
+* \newsavebox:                           \newsavebox.       (line  6734)
+* \newtheorem:                           \newtheorem.       (line  6896)
+* \newtie:                               Accents.           (line 12448)
 * \ng:                                   Additional Latin letters.
-                                                            (line 12538)
+                                                            (line 12539)
 * \NG:                                   Additional Latin letters.
-                                                            (line 12538)
-* \ni:                                   Math symbols.      (line  8495)
-* \nocite:                               \nocite.           (line  5412)
-* \nocorr:                               Font styles.       (line  1220)
-* \nocorrlist:                           Font styles.       (line  1220)
-* \nofiles:                              \nofiles.          (line 13065)
+                                                            (line 12539)
+* \ni:                                   Math symbols.      (line  8496)
+* \nocite:                               \nocite.           (line  5413)
+* \nocorr:                               Font styles.       (line  1221)
+* \nocorrlist:                           Font styles.       (line  1221)
+* \nofiles:                              \nofiles.          (line 13066)
 * \noindent:                             \indent & \noindent.
-                                                            (line  7772)
+                                                            (line  7773)
 * \nolinebreak:                          \linebreak & \nolinebreak.
-                                                            (line  5936)
-* \nonfrenchspacing:                     \frenchspacing.    (line 10184)
-* \nonumber:                             eqnarray.          (line  3285)
+                                                            (line  5937)
+* \nonfrenchspacing:                     \frenchspacing.    (line 10185)
+* \nonumber:                             eqnarray.          (line  3286)
 * \nopagebreak:                          \pagebreak & \nopagebreak.
-                                                            (line  6097)
-* \normalfont:                           Font styles.       (line  1256)
-* \normalmarginpar:                      Marginal notes.    (line  7864)
-* \normalsfcodes:                        \normalsfcodes.    (line 10204)
-* \normalsize:                           Font sizes.        (line  1350)
-* \not:                                  Math symbols.      (line  8500)
-* \notin:                                Math symbols.      (line  8508)
-* \nu:                                   Math symbols.      (line  8512)
-* \nwarrow:                              Math symbols.      (line  8515)
+                                                            (line  6098)
+* \normalfont:                           Font styles.       (line  1257)
+* \normalmarginpar:                      Marginal notes.    (line  7865)
+* \normalsfcodes:                        \normalsfcodes.    (line 10205)
+* \normalsize:                           Font sizes.        (line  1351)
+* \not:                                  Math symbols.      (line  8501)
+* \notin:                                Math symbols.      (line  8509)
+* \nu:                                   Math symbols.      (line  8513)
+* \nwarrow:                              Math symbols.      (line  8516)
 * \o (/o):                               Additional Latin letters.
-                                                            (line 12542)
+                                                            (line 12543)
 * \O (/O):                               Additional Latin letters.
-                                                            (line 12542)
+                                                            (line 12543)
 * \obeycr:                               \obeycr & \restorecr.
-                                                            (line  5755)
+                                                            (line  5756)
 * \oddsidemargin:                        Document class options.
-                                                            (line   747)
+                                                            (line   748)
 * \oddsidemargin <1>:                    Page layout parameters.
-                                                            (line  1738)
+                                                            (line  1739)
 * \oddsidemargin <2>:                    Page layout parameters.
-                                                            (line  1740)
-* \odot:                                 Math symbols.      (line  8518)
+                                                            (line  1741)
+* \odot:                                 Math symbols.      (line  8519)
 * \oe (oe):                              Additional Latin letters.
-                                                            (line 12546)
+                                                            (line 12547)
 * \OE (OE):                              Additional Latin letters.
-                                                            (line 12546)
-* \oint:                                 Math symbols.      (line  8523)
-* \oldstylenums:                         Font styles.       (line  1331)
-* \Omega:                                Math symbols.      (line  8527)
-* \omega:                                Math symbols.      (line  8530)
-* \ominus:                               Math symbols.      (line  8533)
-* \onecolumn:                            \onecolumn.        (line  1527)
-* \opening:                              \opening.          (line 13775)
-* \oplus:                                Math symbols.      (line  8536)
+                                                            (line 12547)
+* \oint:                                 Math symbols.      (line  8524)
+* \oldstylenums:                         Font styles.       (line  1332)
+* \Omega:                                Math symbols.      (line  8528)
+* \omega:                                Math symbols.      (line  8531)
+* \ominus:                               Math symbols.      (line  8534)
+* \onecolumn:                            \onecolumn.        (line  1528)
+* \openin:                               \openin & \openout.
+                                                            (line 13856)
+* \opening:                              \opening.          (line 13776)
+* \openout:                              \openin & \openout.
+                                                            (line 13856)
+* \oplus:                                Math symbols.      (line  8537)
 * \OptionNotUsed:                        Class and package commands.
-                                                            (line  1048)
-* \oslash:                               Math symbols.      (line  8540)
-* \otimes:                               Math symbols.      (line  8543)
-* \oval:                                 \oval.             (line  4469)
+                                                            (line  1049)
+* \oslash:                               Math symbols.      (line  8541)
+* \otimes:                               Math symbols.      (line  8544)
+* \oval:                                 \oval.             (line  4470)
 * \overbrace{MATH}:                      Over- and Underlining.
-                                                            (line  9311)
+                                                            (line  9312)
 * \overline{TEXT}:                       Over- and Underlining.
-                                                            (line  9292)
-* \owns:                                 Math symbols.      (line  8548)
-* \P:                                    Text symbols.      (line 12220)
+                                                            (line  9293)
+* \owns:                                 Math symbols.      (line  8549)
+* \P:                                    Text symbols.      (line 12221)
 * \PackageError:                         Class and package commands.
-                                                            (line   889)
+                                                            (line   890)
 * \PackageInfo:                          Class and package commands.
-                                                            (line   889)
+                                                            (line   890)
 * \PackageInfoNoLine:                    Class and package commands.
-                                                            (line   889)
+                                                            (line   890)
 * \PackageWarning:                       Class and package commands.
-                                                            (line   889)
+                                                            (line   890)
 * \PackageWarningNoLine:                 Class and package commands.
-                                                            (line   889)
+                                                            (line   890)
 * \pagebreak:                            \pagebreak & \nopagebreak.
-                                                            (line  6097)
-* \pagenumbering:                        \pagenumbering.    (line  9763)
-* \pageref:                              \pageref.          (line  2760)
-* \pagestyle:                            \pagestyle.        (line  9821)
+                                                            (line  6098)
+* \pagenumbering:                        \pagenumbering.    (line  9764)
+* \pageref:                              \pageref.          (line  2761)
+* \pagestyle:                            \pagestyle.        (line  9822)
 * \paperheight:                          Page layout parameters.
-                                                            (line  1751)
+                                                            (line  1752)
 * \paperheight <1>:                      Page layout parameters.
-                                                            (line  1752)
+                                                            (line  1753)
 * \paperwidth:                           Page layout parameters.
-                                                            (line  1757)
+                                                            (line  1758)
 * \paperwidth <1>:                       Page layout parameters.
-                                                            (line  1758)
-* \par:                                  \par.              (line  7719)
-* \paragraph:                            Sectioning.        (line  1961)
+                                                            (line  1759)
+* \par:                                  \par.              (line  7720)
+* \paragraph:                            Sectioning.        (line  1962)
 * \paragraph <1>:                        \subsubsection & \paragraph & \subparagraph.
-                                                            (line  2335)
-* \parallel:                             Math symbols.      (line  8553)
-* \parbox:                               \parbox.           (line 10872)
-* \parindent:                            minipage.          (line  4100)
+                                                            (line  2336)
+* \parallel:                             Math symbols.      (line  8554)
+* \parbox:                               \parbox.           (line 10873)
+* \parindent:                            minipage.          (line  4101)
 * \parindent <1>:                        \indent & \noindent.
-                                                            (line  7772)
+                                                            (line  7773)
 * \parindent <2>:                        \parindent & \parskip.
-                                                            (line  7821)
-* \parsep:                               list.              (line  3768)
+                                                            (line  7822)
+* \parsep:                               list.              (line  3769)
 * \parskip:                              \parindent & \parskip.
-                                                            (line  7821)
-* \parskip example:                      itemize.           (line  3606)
-* \part:                                 Sectioning.        (line  1961)
-* \part <1>:                             \part.             (line  2046)
-* \partial:                              Math symbols.      (line  8556)
-* \partopsep:                            list.              (line  3777)
+                                                            (line  7822)
+* \parskip example:                      itemize.           (line  3607)
+* \part:                                 Sectioning.        (line  1962)
+* \part <1>:                             \part.             (line  2047)
+* \partial:                              Math symbols.      (line  8557)
+* \partopsep:                            list.              (line  3778)
 * \PassOptionsToClass:                   Class and package commands.
-                                                            (line  1054)
+                                                            (line  1055)
 * \PassOptionsToPackage:                 Class and package commands.
-                                                            (line  1054)
+                                                            (line  1055)
 * \pdfpageheight:                        Document class options.
-                                                            (line   703)
+                                                            (line   704)
 * \pdfpagewidth:                         Document class options.
-                                                            (line   703)
-* \perp:                                 Math symbols.      (line  8559)
-* \phi:                                  Math symbols.      (line  8564)
-* \Pi:                                   Math symbols.      (line  8568)
-* \pi:                                   Math symbols.      (line  8571)
-* \pm:                                   Math symbols.      (line  8575)
-* \pmod:                                 Math functions.    (line  9193)
-* \poptabs:                              tabbing.           (line  4823)
-* \poptabs <1>:                          tabbing.           (line  4824)
-* \pounds:                               Text symbols.      (line 12224)
-* \Pr:                                   Math functions.    (line  9196)
-* \prec:                                 Math symbols.      (line  8578)
-* \preceq:                               Math symbols.      (line  8581)
-* \prime:                                Math symbols.      (line  8586)
-* \printglossaries:                      Glossaries.        (line 13412)
-* \printglossaries <1>:                  Glossaries.        (line 13449)
-* \printindex:                           \printindex.       (line 13397)
-* \printindex <1>:                       \printindex.       (line 13401)
+                                                            (line   704)
+* \perp:                                 Math symbols.      (line  8560)
+* \phi:                                  Math symbols.      (line  8565)
+* \Pi:                                   Math symbols.      (line  8569)
+* \pi:                                   Math symbols.      (line  8572)
+* \pm:                                   Math symbols.      (line  8576)
+* \pmod:                                 Math functions.    (line  9194)
+* \poptabs:                              tabbing.           (line  4824)
+* \poptabs <1>:                          tabbing.           (line  4825)
+* \pounds:                               Text symbols.      (line 12225)
+* \Pr:                                   Math functions.    (line  9197)
+* \prec:                                 Math symbols.      (line  8579)
+* \preceq:                               Math symbols.      (line  8582)
+* \prime:                                Math symbols.      (line  8587)
+* \printglossaries:                      Glossaries.        (line 13413)
+* \printglossaries <1>:                  Glossaries.        (line 13450)
+* \printindex:                           \printindex.       (line 13398)
+* \printindex <1>:                       \printindex.       (line 13402)
 * \ProcessOptions:                       Class and package commands.
-                                                            (line  1091)
+                                                            (line  1092)
 * \ProcessOptions*:                      Class and package commands.
-                                                            (line  1091)
-* \prod:                                 Math symbols.      (line  8595)
-* \propto:                               Math symbols.      (line  8598)
-* \protect:                              \protect.          (line  7039)
-* \providecommand:                       \providecommand.   (line  6530)
+                                                            (line  1092)
+* \prod:                                 Math symbols.      (line  8596)
+* \propto:                               Math symbols.      (line  8599)
+* \protect:                              \protect.          (line  7040)
+* \providecommand:                       \providecommand.   (line  6531)
 * \ProvidesClass:                        Class and package commands.
-                                                            (line  1129)
+                                                            (line  1130)
 * \ProvidesFile:                         Class and package commands.
-                                                            (line  1162)
+                                                            (line  1163)
 * \ProvidesPackage:                      Class and package commands.
-                                                            (line  1129)
-* \ps:                                   \ps.               (line 13787)
-* \Psi:                                  Math symbols.      (line  8601)
-* \psi:                                  Math symbols.      (line  8604)
-* \pushtabs:                             tabbing.           (line  4826)
-* \put:                                  \put.              (line  4288)
-* \qbezier:                              \qbezier.          (line  4329)
+                                                            (line  1130)
+* \ps:                                   \ps.               (line 13788)
+* \Psi:                                  Math symbols.      (line  8602)
+* \psi:                                  Math symbols.      (line  8605)
+* \pushtabs:                             tabbing.           (line  4827)
+* \put:                                  \put.              (line  4289)
+* \qbezier:                              \qbezier.          (line  4330)
 * \qquad:                                Spacing in math mode.
-                                                            (line  9373)
+                                                            (line  9374)
 * \qquad <1>:                            \enspace & \quad & \qquad.
-                                                            (line  9943)
+                                                            (line  9944)
 * \quad:                                 Spacing in math mode.
-                                                            (line  9367)
+                                                            (line  9368)
 * \quad <1>:                             \enspace & \quad & \qquad.
-                                                            (line  9943)
-* \quotedblbase (,,):                    Text symbols.      (line 12228)
-* \quotesinglbase (,):                   Text symbols.      (line 12229)
-* \r (ring accent):                      Accents.           (line 12441)
-* \raggedbottom:                         \raggedbottom.     (line  1667)
-* \raggedleft:                           \raggedleft.       (line  3514)
-* \raggedright:                          \raggedright.      (line  3463)
-* \raisebox:                             \raisebox.         (line 10924)
-* \rangle:                               Math symbols.      (line  8607)
-* \rbrace:                               Math symbols.      (line  8612)
-* \rbrack:                               Math symbols.      (line  8616)
-* \rceil:                                Math symbols.      (line  8620)
-* \Re:                                   Math symbols.      (line  8623)
-* \ref:                                  \ref.              (line  2784)
-* \reflectbox:                           \scalebox.         (line 12028)
-* \refstepcounter:                       \refstepcounter.   (line  7343)
+                                                            (line  9944)
+* \quotedblbase (,,):                    Text symbols.      (line 12229)
+* \quotesinglbase (,):                   Text symbols.      (line 12230)
+* \r (ring accent):                      Accents.           (line 12442)
+* \raggedbottom:                         \raggedbottom.     (line  1668)
+* \raggedleft:                           \raggedleft.       (line  3515)
+* \raggedright:                          \raggedright.      (line  3464)
+* \raisebox:                             \raisebox.         (line 10925)
+* \rangle:                               Math symbols.      (line  8608)
+* \rbrace:                               Math symbols.      (line  8613)
+* \rbrack:                               Math symbols.      (line  8617)
+* \rceil:                                Math symbols.      (line  8621)
+* \Re:                                   Math symbols.      (line  8624)
+* \ref:                                  \ref.              (line  2785)
+* \reflectbox:                           \scalebox.         (line 12029)
+* \refstepcounter:                       \refstepcounter.   (line  7344)
 * \renewenvironment:                     \newenvironment & \renewenvironment.
-                                                            (line  6761)
+                                                            (line  6762)
 * \RequirePackage:                       Class and package commands.
-                                                            (line  1171)
+                                                            (line  1172)
 * \RequirePackageWithOptions:            Class and package commands.
-                                                            (line  1171)
-* \resizebox:                            \resizebox.        (line 12059)
+                                                            (line  1172)
+* \resizebox:                            \resizebox.        (line 12060)
 * \restorecr:                            \obeycr & \restorecr.
-                                                            (line  5755)
-* \restriction:                          Math symbols.      (line  8628)
-* \revemptyset:                          Math symbols.      (line  8633)
-* \reversemarginpar:                     Marginal notes.    (line  7864)
-* \rfloor:                               Math symbols.      (line  8638)
-* \rhd:                                  Math symbols.      (line  8642)
-* \rho:                                  Math symbols.      (line  8649)
-* \right:                                \left & \right.    (line  9545)
-* \Rightarrow:                           Math symbols.      (line  8653)
-* \rightarrow:                           Math symbols.      (line  8658)
-* \rightharpoondown:                     Math symbols.      (line  8662)
-* \rightharpoonup:                       Math symbols.      (line  8665)
-* \rightleftharpoons:                    Math symbols.      (line  8668)
-* \rightmargin:                          list.              (line  3792)
-* \rm:                                   Font styles.       (line  1282)
-* \rmfamily:                             Font styles.       (line  1229)
+                                                            (line  5756)
+* \restriction:                          Math symbols.      (line  8629)
+* \revemptyset:                          Math symbols.      (line  8634)
+* \reversemarginpar:                     Marginal notes.    (line  7865)
+* \rfloor:                               Math symbols.      (line  8639)
+* \rhd:                                  Math symbols.      (line  8643)
+* \rho:                                  Math symbols.      (line  8650)
+* \right:                                \left & \right.    (line  9546)
+* \Rightarrow:                           Math symbols.      (line  8654)
+* \rightarrow:                           Math symbols.      (line  8659)
+* \rightharpoondown:                     Math symbols.      (line  8663)
+* \rightharpoonup:                       Math symbols.      (line  8666)
+* \rightleftharpoons:                    Math symbols.      (line  8669)
+* \rightmargin:                          list.              (line  3793)
+* \rm:                                   Font styles.       (line  1283)
+* \rmfamily:                             Font styles.       (line  1230)
 * \roman{COUNTER}:                       \alph \Alph \arabic \roman \Roman \fnsymbol.
-                                                            (line  7215)
+                                                            (line  7216)
 * \Roman{COUNTER}:                       \alph \Alph \arabic \roman \Roman \fnsymbol.
-                                                            (line  7220)
-* \rotatebox:                            \rotatebox.        (line 11960)
-* \rq:                                   Text symbols.      (line 12232)
-* \rule:                                 \rule.             (line 12561)
-* \S:                                    Text symbols.      (line 12235)
-* \savebox:                              \sbox & \savebox.  (line 10970)
-* \sbox:                                 \sbox & \savebox.  (line 10970)
-* \sc:                                   Font styles.       (line  1285)
-* \scalebox:                             \scalebox.         (line 12028)
-* \scriptsize:                           Font sizes.        (line  1350)
-* \scshape:                              Font styles.       (line  1250)
-* \searrow:                              Math symbols.      (line  8671)
-* \sec:                                  Math functions.    (line  9199)
-* \section:                              Sectioning.        (line  1961)
-* \section <1>:                          \section.          (line  2193)
-* \seename:                              \index.            (line 13176)
+                                                            (line  7221)
+* \rotatebox:                            \rotatebox.        (line 11961)
+* \rq:                                   Text symbols.      (line 12233)
+* \rule:                                 \rule.             (line 12562)
+* \S:                                    Text symbols.      (line 12236)
+* \savebox:                              \sbox & \savebox.  (line 10971)
+* \sbox:                                 \sbox & \savebox.  (line 10971)
+* \sc:                                   Font styles.       (line  1286)
+* \scalebox:                             \scalebox.         (line 12029)
+* \scriptsize:                           Font sizes.        (line  1351)
+* \scshape:                              Font styles.       (line  1251)
+* \searrow:                              Math symbols.      (line  8672)
+* \sec:                                  Math functions.    (line  9200)
+* \section:                              Sectioning.        (line  1962)
+* \section <1>:                          \section.          (line  2194)
+* \seename:                              \index.            (line 13177)
 * \selectfont:                           Low-level font commands.
-                                                            (line  1505)
-* \setcounter:                           \setcounter.       (line  7309)
-* \setlength:                            \setlength.        (line  7546)
-* \setminus:                             Math symbols.      (line  8674)
-* \settodepth:                           \settodepth.       (line  7603)
-* \settoheight:                          \settoheight.      (line  7627)
-* \settowidth:                           \settowidth.       (line  7651)
-* \sf:                                   Font styles.       (line  1288)
-* \sffamily:                             Font styles.       (line  1247)
-* \sharp:                                Math symbols.      (line  8680)
-* \shortstack:                           \shortstack.       (line  4505)
-* \Sigma:                                Math symbols.      (line  8683)
-* \sigma:                                Math symbols.      (line  8686)
-* \signature:                            \signature.        (line 13804)
-* \sim:                                  Math symbols.      (line  8690)
-* \simeq:                                Math symbols.      (line  8693)
-* \sin:                                  Math functions.    (line  9202)
-* \sinh:                                 Math functions.    (line  9205)
-* \sl:                                   Font styles.       (line  1291)
-* \sloppy:                               \fussy & \sloppy.  (line  5877)
-* \slshape:                              Font styles.       (line  1244)
-* \small:                                Font sizes.        (line  1350)
-* \smallint:                             Math symbols.      (line  8696)
+                                                            (line  1506)
+* \setcounter:                           \setcounter.       (line  7310)
+* \setlength:                            \setlength.        (line  7547)
+* \setminus:                             Math symbols.      (line  8675)
+* \settodepth:                           \settodepth.       (line  7604)
+* \settoheight:                          \settoheight.      (line  7628)
+* \settowidth:                           \settowidth.       (line  7652)
+* \sf:                                   Font styles.       (line  1289)
+* \sffamily:                             Font styles.       (line  1248)
+* \sharp:                                Math symbols.      (line  8681)
+* \shortstack:                           \shortstack.       (line  4506)
+* \Sigma:                                Math symbols.      (line  8684)
+* \sigma:                                Math symbols.      (line  8687)
+* \signature:                            \signature.        (line 13805)
+* \sim:                                  Math symbols.      (line  8691)
+* \simeq:                                Math symbols.      (line  8694)
+* \sin:                                  Math functions.    (line  9203)
+* \sinh:                                 Math functions.    (line  9206)
+* \sl:                                   Font styles.       (line  1292)
+* \sloppy:                               \fussy & \sloppy.  (line  5878)
+* \slshape:                              Font styles.       (line  1245)
+* \small:                                Font sizes.        (line  1351)
+* \smallint:                             Math symbols.      (line  8697)
 * \smallskip:                            \bigskip & \medskip & \smallskip.
-                                                            (line 10451)
+                                                            (line 10452)
 * \smallskipamount:                      \bigskip & \medskip & \smallskip.
-                                                            (line 10452)
-* \smile:                                Math symbols.      (line  8700)
-* \SPACE:                                \(SPACE).          (line 10214)
-* \SPACE <1>:                            \(SPACE).          (line 10214)
-* \spacefactor:                          \spacefactor.      (line 10077)
-* \spadesuit:                            Math symbols.      (line  8703)
-* \sqcap:                                Math symbols.      (line  8706)
-* \sqcup:                                Math symbols.      (line  8710)
-* \sqrt:                                 \sqrt.             (line  9580)
-* \sqsubset:                             Math symbols.      (line  8714)
-* \sqsubseteq:                           Math symbols.      (line  8719)
-* \sqsupset:                             Math symbols.      (line  8724)
-* \sqsupseteq:                           Math symbols.      (line  8729)
+                                                            (line 10453)
+* \smile:                                Math symbols.      (line  8701)
+* \SPACE:                                \(SPACE).          (line 10215)
+* \SPACE <1>:                            \(SPACE).          (line 10215)
+* \spacefactor:                          \spacefactor.      (line 10078)
+* \spadesuit:                            Math symbols.      (line  8704)
+* \sqcap:                                Math symbols.      (line  8707)
+* \sqcup:                                Math symbols.      (line  8711)
+* \sqrt:                                 \sqrt.             (line  9581)
+* \sqsubset:                             Math symbols.      (line  8715)
+* \sqsubseteq:                           Math symbols.      (line  8720)
+* \sqsupset:                             Math symbols.      (line  8725)
+* \sqsupseteq:                           Math symbols.      (line  8730)
 * \ss (ss):                              Additional Latin letters.
-                                                            (line 12550)
+                                                            (line 12551)
 * \SS (SS):                              Additional Latin letters.
-                                                            (line 12550)
-* \stackrel:                             \stackrel.         (line  9596)
-* \star:                                 Math symbols.      (line  8734)
-* \stepcounter:                          \stepcounter.      (line  7361)
+                                                            (line 12551)
+* \stackrel:                             \stackrel.         (line  9597)
+* \star:                                 Math symbols.      (line  8735)
+* \stepcounter:                          \stepcounter.      (line  7362)
 * \stop:                                 Recovering from errors.
-                                                            (line 14354)
-* \strut:                                \strut.            (line 10495)
-* \subparagraph:                         Sectioning.        (line  1961)
+                                                            (line 14417)
+* \strut:                                \strut.            (line 10496)
+* \subparagraph:                         Sectioning.        (line  1962)
 * \subparagraph <1>:                     \subsubsection & \paragraph & \subparagraph.
-                                                            (line  2335)
-* \subsection:                           Sectioning.        (line  1961)
-* \subsection <1>:                       \subsection.       (line  2271)
-* \subset:                               Math symbols.      (line  8742)
-* \subseteq:                             Math symbols.      (line  8745)
+                                                            (line  2336)
+* \subsection:                           Sectioning.        (line  1962)
+* \subsection <1>:                       \subsection.       (line  2272)
+* \subset:                               Math symbols.      (line  8743)
+* \subseteq:                             Math symbols.      (line  8746)
 * \subsubsection:                        \subsubsection & \paragraph & \subparagraph.
-                                                            (line  2335)
-* \succ:                                 Math symbols.      (line  8748)
-* \succeq:                               Math symbols.      (line  8752)
-* \sum:                                  Math symbols.      (line  8757)
-* \sup:                                  Math functions.    (line  9208)
-* \suppressfloats:                       Floats.            (line  1892)
-* \supset:                               Math symbols.      (line  8761)
-* \supseteq:                             Math symbols.      (line  8764)
-* \surd:                                 Math symbols.      (line  8767)
-* \swarrow:                              Math symbols.      (line  8772)
+                                                            (line  2336)
+* \succ:                                 Math symbols.      (line  8749)
+* \succeq:                               Math symbols.      (line  8753)
+* \sum:                                  Math symbols.      (line  8758)
+* \sup:                                  Math functions.    (line  9209)
+* \suppressfloats:                       Floats.            (line  1893)
+* \supset:                               Math symbols.      (line  8762)
+* \supseteq:                             Math symbols.      (line  8765)
+* \surd:                                 Math symbols.      (line  8768)
+* \swarrow:                              Math symbols.      (line  8773)
 * \symbol:                               Symbols by font position.
-                                                            (line 12171)
-* \t (tie-after accent):                 Accents.           (line 12447)
-* \TAB:                                  \(SPACE).          (line 10214)
-* \tabbingsep:                           tabbing.           (line  4831)
-* \tabcolsep:                            tabular.           (line  5091)
+                                                            (line 12172)
+* \t (tie-after accent):                 Accents.           (line 12448)
+* \TAB:                                  \(SPACE).          (line 10215)
+* \tabbingsep:                           tabbing.           (line  4832)
+* \tabcolsep:                            tabular.           (line  5092)
 * \tableofcontents:                      Table of contents etc..
-                                                            (line 12856)
-* \tan:                                  Math functions.    (line  9211)
-* \tanh:                                 Math functions.    (line  9214)
-* \tau:                                  Math symbols.      (line  8775)
-* \telephone:                            \telephone.        (line 13834)
-* \TeX:                                  Text symbols.      (line 12239)
-* \textascendercompwordmark:             Text symbols.      (line 12277)
-* \textasciicircum:                      Text symbols.      (line 12242)
-* \textasciitilde:                       Text symbols.      (line 12245)
-* \textasteriskcentered:                 Text symbols.      (line 12248)
+                                                            (line 12857)
+* \tan:                                  Math functions.    (line  9212)
+* \tanh:                                 Math functions.    (line  9215)
+* \tau:                                  Math symbols.      (line  8776)
+* \telephone:                            \telephone.        (line 13835)
+* \TeX:                                  Text symbols.      (line 12240)
+* \textascendercompwordmark:             Text symbols.      (line 12278)
+* \textasciicircum:                      Text symbols.      (line 12243)
+* \textasciitilde:                       Text symbols.      (line 12246)
+* \textasteriskcentered:                 Text symbols.      (line 12249)
 * \textbackslash:                        Reserved characters.
-                                                            (line 12108)
-* \textbackslash <1>:                    Text symbols.      (line 12251)
-* \textbar:                              Text symbols.      (line 12254)
-* \textbardbl:                           Text symbols.      (line 12257)
-* \textbf:                               Font styles.       (line  1238)
-* \textbigcircle:                        Text symbols.      (line 12260)
-* \textbraceleft:                        Text symbols.      (line 12263)
-* \textbraceright:                       Text symbols.      (line 12266)
-* \textbullet:                           Text symbols.      (line 12269)
-* \textcapitalcompwordmark:              Text symbols.      (line 12276)
-* \textcircled{LETTER}:                  Text symbols.      (line 12272)
-* \textcompwordmark:                     Text symbols.      (line 12275)
-* \textcopyright:                        Text symbols.      (line 12189)
-* \textdagger:                           Text symbols.      (line 12284)
-* \textdaggerdbl:                        Text symbols.      (line 12287)
-* \textdollar (or \$):                   Text symbols.      (line 12290)
-* \textellipsis:                         Text symbols.      (line 12213)
-* \textemdash (or ---):                  Text symbols.      (line 12293)
-* \textendash (or --):                   Text symbols.      (line 12298)
-* \texteuro:                             Text symbols.      (line 12301)
-* \textexclamdown (or !`):               Text symbols.      (line 12307)
-* \textfloatsep:                         Floats.            (line  1928)
-* \textfloatsep <1>:                     Floats.            (line  1929)
-* \textfraction:                         Floats.            (line  1907)
-* \textfraction <1>:                     Floats.            (line  1908)
-* \textgreater:                          Text symbols.      (line 12310)
+                                                            (line 12109)
+* \textbackslash <1>:                    Text symbols.      (line 12252)
+* \textbar:                              Text symbols.      (line 12255)
+* \textbardbl:                           Text symbols.      (line 12258)
+* \textbf:                               Font styles.       (line  1239)
+* \textbigcircle:                        Text symbols.      (line 12261)
+* \textbraceleft:                        Text symbols.      (line 12264)
+* \textbraceright:                       Text symbols.      (line 12267)
+* \textbullet:                           Text symbols.      (line 12270)
+* \textcapitalcompwordmark:              Text symbols.      (line 12277)
+* \textcircled{LETTER}:                  Text symbols.      (line 12273)
+* \textcompwordmark:                     Text symbols.      (line 12276)
+* \textcopyright:                        Text symbols.      (line 12190)
+* \textdagger:                           Text symbols.      (line 12285)
+* \textdaggerdbl:                        Text symbols.      (line 12288)
+* \textdollar (or \$):                   Text symbols.      (line 12291)
+* \textellipsis:                         Text symbols.      (line 12214)
+* \textemdash (or ---):                  Text symbols.      (line 12294)
+* \textendash (or --):                   Text symbols.      (line 12299)
+* \texteuro:                             Text symbols.      (line 12302)
+* \textexclamdown (or !`):               Text symbols.      (line 12308)
+* \textfloatsep:                         Floats.            (line  1929)
+* \textfloatsep <1>:                     Floats.            (line  1930)
+* \textfraction:                         Floats.            (line  1908)
+* \textfraction <1>:                     Floats.            (line  1909)
+* \textgreater:                          Text symbols.      (line 12311)
 * \textheight:                           Page layout parameters.
-                                                            (line  1763)
+                                                            (line  1764)
 * \textheight <1>:                       Page layout parameters.
-                                                            (line  1764)
-* \textit:                               Font styles.       (line  1232)
-* \textleftarrow:                        Text symbols.      (line 12316)
-* \textless:                             Text symbols.      (line 12313)
-* \textmd:                               Font styles.       (line  1235)
-* \textnormal:                           Font styles.       (line  1256)
-* \textordfeminine:                      Text symbols.      (line 12319)
-* \textordmasculine:                     Text symbols.      (line 12320)
-* \textparagraph:                        Text symbols.      (line 12221)
-* \textperiodcentered:                   Text symbols.      (line 12323)
-* \textquestiondown (or ?`):             Text symbols.      (line 12326)
-* \textquotedblleft (or ``):             Text symbols.      (line 12329)
-* \textquotedblright (or ''):            Text symbols.      (line 12332)
-* \textquoteleft (or `):                 Text symbols.      (line 12335)
-* \textquoteright (or '):                Text symbols.      (line 12338)
-* \textquotesingle:                      Text symbols.      (line 12341)
-* \textquotestraightbase:                Text symbols.      (line 12344)
-* \textquotestraightdblbase:             Text symbols.      (line 12345)
-* \textregistered:                       Text symbols.      (line 12348)
-* \textrightarrow:                       Text symbols.      (line 12351)
-* \textrm:                               Font styles.       (line  1229)
-* \textsc:                               Font styles.       (line  1250)
-* \textsection:                          Text symbols.      (line 12236)
-* \textsf:                               Font styles.       (line  1247)
-* \textsl:                               Font styles.       (line  1244)
-* \textsterling:                         Text symbols.      (line 12225)
-* \textthreequartersemdash:              Text symbols.      (line 12354)
-* \texttrademark:                        Text symbols.      (line 12357)
-* \texttt:                               Font styles.       (line  1253)
-* \texttwelveudash:                      Text symbols.      (line 12360)
-* \textunderscore:                       Text symbols.      (line 12363)
-* \textup:                               Font styles.       (line  1241)
-* \textvisiblespace:                     Text symbols.      (line 12366)
+                                                            (line  1765)
+* \textit:                               Font styles.       (line  1233)
+* \textleftarrow:                        Text symbols.      (line 12317)
+* \textless:                             Text symbols.      (line 12314)
+* \textmd:                               Font styles.       (line  1236)
+* \textnormal:                           Font styles.       (line  1257)
+* \textordfeminine:                      Text symbols.      (line 12320)
+* \textordmasculine:                     Text symbols.      (line 12321)
+* \textparagraph:                        Text symbols.      (line 12222)
+* \textperiodcentered:                   Text symbols.      (line 12324)
+* \textquestiondown (or ?`):             Text symbols.      (line 12327)
+* \textquotedblleft (or ``):             Text symbols.      (line 12330)
+* \textquotedblright (or ''):            Text symbols.      (line 12333)
+* \textquoteleft (or `):                 Text symbols.      (line 12336)
+* \textquoteright (or '):                Text symbols.      (line 12339)
+* \textquotesingle:                      Text symbols.      (line 12342)
+* \textquotestraightbase:                Text symbols.      (line 12345)
+* \textquotestraightdblbase:             Text symbols.      (line 12346)
+* \textregistered:                       Text symbols.      (line 12349)
+* \textrightarrow:                       Text symbols.      (line 12352)
+* \textrm:                               Font styles.       (line  1230)
+* \textsc:                               Font styles.       (line  1251)
+* \textsection:                          Text symbols.      (line 12237)
+* \textsf:                               Font styles.       (line  1248)
+* \textsl:                               Font styles.       (line  1245)
+* \textsterling:                         Text symbols.      (line 12226)
+* \textthreequartersemdash:              Text symbols.      (line 12355)
+* \texttrademark:                        Text symbols.      (line 12358)
+* \texttt:                               Font styles.       (line  1254)
+* \texttwelveudash:                      Text symbols.      (line 12361)
+* \textunderscore:                       Text symbols.      (line 12364)
+* \textup:                               Font styles.       (line  1242)
+* \textvisiblespace:                     Text symbols.      (line 12367)
 * \textwidth:                            Page layout parameters.
-                                                            (line  1771)
+                                                            (line  1772)
 * \textwidth <1>:                        Page layout parameters.
-                                                            (line  1772)
+                                                            (line  1773)
 * \th (th):                              Additional Latin letters.
-                                                            (line 12554)
+                                                            (line 12555)
 * \TH (TH):                              Additional Latin letters.
-                                                            (line 12554)
-* \thanks{TEXT}:                         \maketitle.        (line  9742)
-* \theta:                                Math symbols.      (line  8778)
-* \thicklines:                           \thicklines.       (line  4442)
+                                                            (line 12555)
+* \thanks{TEXT}:                         \maketitle.        (line  9743)
+* \theta:                                Math symbols.      (line  8779)
+* \thicklines:                           \thicklines.       (line  4443)
 * \thickspace:                           Spacing in math mode.
-                                                            (line  9339)
-* \thinlines:                            \thinlines.        (line  4434)
+                                                            (line  9340)
+* \thinlines:                            \thinlines.        (line  4435)
 * \thinspace:                            Spacing in math mode.
-                                                            (line  9348)
+                                                            (line  9349)
 * \thinspace <1>:                        \thinspace & \negthinspace.
-                                                            (line 10311)
-* \thispagestyle:                        \thispagestyle.    (line  9905)
-* \tilde:                                Math accents.      (line  9259)
-* \times:                                Math symbols.      (line  8782)
-* \tiny:                                 Font sizes.        (line  1350)
-* \title{TEXT}:                          \maketitle.        (line  9749)
-* \to:                                   Math symbols.      (line  8786)
-* \today:                                \today.            (line 12596)
-* \top:                                  Math symbols.      (line  8790)
-* \topfraction:                          Floats.            (line  1912)
-* \topfraction <1>:                      Floats.            (line  1913)
+                                                            (line 10312)
+* \thispagestyle:                        \thispagestyle.    (line  9906)
+* \tilde:                                Math accents.      (line  9260)
+* \times:                                Math symbols.      (line  8783)
+* \tiny:                                 Font sizes.        (line  1351)
+* \title{TEXT}:                          \maketitle.        (line  9750)
+* \to:                                   Math symbols.      (line  8787)
+* \today:                                \today.            (line 12597)
+* \top:                                  Math symbols.      (line  8791)
+* \topfraction:                          Floats.            (line  1913)
+* \topfraction <1>:                      Floats.            (line  1914)
 * \topmargin:                            Page layout parameters.
-                                                            (line  1796)
-* \topsep:                               list.              (line  3797)
+                                                            (line  1797)
+* \topsep:                               list.              (line  3798)
 * \topskip:                              Page layout parameters.
-                                                            (line  1803)
+                                                            (line  1804)
 * \topskip <1>:                          Page layout parameters.
-                                                            (line  1804)
-* \triangle:                             Math symbols.      (line  8795)
-* \triangleleft:                         Math symbols.      (line  8798)
-* \triangleright:                        Math symbols.      (line  8804)
-* \tt:                                   Font styles.       (line  1294)
-* \ttfamily:                             Font styles.       (line  1253)
-* \twocolumn:                            \twocolumn.        (line  1539)
-* \typein:                               \typein.           (line 13849)
-* \typeout:                              \typeout.          (line 13894)
-* \u (breve accent):                     Accents.           (line 12451)
+                                                            (line  1805)
+* \triangle:                             Math symbols.      (line  8796)
+* \triangleleft:                         Math symbols.      (line  8799)
+* \triangleright:                        Math symbols.      (line  8805)
+* \tt:                                   Font styles.       (line  1295)
+* \ttfamily:                             Font styles.       (line  1254)
+* \twocolumn:                            \twocolumn.        (line  1540)
+* \typein:                               \typein.           (line 13917)
+* \typeout:                              \typeout.          (line 13962)
+* \u (breve accent):                     Accents.           (line 12452)
 * \unboldmath:                           \boldmath & \unboldmath.
-                                                            (line  9017)
+                                                            (line  9018)
 * \unboldmath <1>:                       \boldmath & \unboldmath.
-                                                            (line  9025)
-* \underbar:                             Accents.           (line 12417)
+                                                            (line  9026)
+* \underbar:                             Accents.           (line 12418)
 * \underbrace{MATH}:                     Over- and Underlining.
-                                                            (line  9297)
+                                                            (line  9298)
 * \underline{TEXT}:                      Over- and Underlining.
-                                                            (line  9280)
-* \unitlength:                           picture.           (line  4173)
-* \unlhd:                                Math symbols.      (line  8810)
-* \unrhd:                                Math symbols.      (line  8817)
-* \Uparrow:                              Math symbols.      (line  8824)
-* \uparrow:                              Math symbols.      (line  8828)
-* \Updownarrow:                          Math symbols.      (line  8832)
-* \updownarrow:                          Math symbols.      (line  8837)
-* \upharpoonright:                       Math symbols.      (line  8842)
-* \uplus:                                Math symbols.      (line  8847)
-* \upshape:                              Font styles.       (line  1241)
-* \Upsilon:                              Math symbols.      (line  8854)
-* \upsilon:                              Math symbols.      (line  8857)
-* \usebox:                               \usebox.           (line 11076)
-* \usecounter:                           \usecounter.       (line  7250)
+                                                            (line  9281)
+* \unitlength:                           picture.           (line  4174)
+* \unlhd:                                Math symbols.      (line  8811)
+* \unrhd:                                Math symbols.      (line  8818)
+* \Uparrow:                              Math symbols.      (line  8825)
+* \uparrow:                              Math symbols.      (line  8829)
+* \Updownarrow:                          Math symbols.      (line  8833)
+* \updownarrow:                          Math symbols.      (line  8838)
+* \upharpoonright:                       Math symbols.      (line  8843)
+* \uplus:                                Math symbols.      (line  8848)
+* \upshape:                              Font styles.       (line  1242)
+* \Upsilon:                              Math symbols.      (line  8855)
+* \upsilon:                              Math symbols.      (line  8858)
+* \usebox:                               \usebox.           (line 11077)
+* \usecounter:                           \usecounter.       (line  7251)
 * \usefont:                              Low-level font commands.
-                                                            (line  1513)
+                                                            (line  1514)
 * \usepackage:                           Additional packages.
-                                                            (line   768)
-* \v (breve accent):                     Accents.           (line 12455)
-* \value:                                \value.            (line  7276)
-* \vanothing:                            Math symbols.      (line  8865)
-* \varepsilon:                           Math symbols.      (line  8860)
-* \varphi:                               Math symbols.      (line  8870)
-* \varpi:                                Math symbols.      (line  8874)
-* \varrho:                               Math symbols.      (line  8878)
-* \varsigma:                             Math symbols.      (line  8882)
-* \vartheta:                             Math symbols.      (line  8886)
-* \vdash:                                Math symbols.      (line  8890)
-* \vdots:                                Dots.              (line  9085)
-* \vec:                                  Math accents.      (line  9262)
-* \vector:                               \vector.           (line  4547)
-* \vee:                                  Math symbols.      (line  8894)
-* \verb:                                 \verb.             (line  5593)
-* \Vert:                                 Math symbols.      (line  8899)
-* \vert:                                 Math symbols.      (line  8915)
-* \vfill:                                \vfill.            (line 10631)
-* \vline:                                \vline.            (line  5184)
-* \vspace:                               \vspace.           (line 10580)
-* \wedge:                                Math symbols.      (line  8933)
-* \widehat:                              Math accents.      (line  9265)
-* \widetilde:                            Math accents.      (line  9268)
-* \wlog:                                 \wlog.             (line 14085)
-* \wp:                                   Math symbols.      (line  8937)
-* \wr:                                   Math symbols.      (line  8940)
-* \write:                                \write.            (line 13927)
-* \write18:                              \write18.          (line 14103)
-* \Xi:                                   Math symbols.      (line  8943)
-* \xi:                                   Math symbols.      (line  8946)
+                                                            (line   769)
+* \v (breve accent):                     Accents.           (line 12456)
+* \value:                                \value.            (line  7277)
+* \vanothing:                            Math symbols.      (line  8866)
+* \varepsilon:                           Math symbols.      (line  8861)
+* \varphi:                               Math symbols.      (line  8871)
+* \varpi:                                Math symbols.      (line  8875)
+* \varrho:                               Math symbols.      (line  8879)
+* \varsigma:                             Math symbols.      (line  8883)
+* \vartheta:                             Math symbols.      (line  8887)
+* \vdash:                                Math symbols.      (line  8891)
+* \vdots:                                Dots.              (line  9086)
+* \vec:                                  Math accents.      (line  9263)
+* \vector:                               \vector.           (line  4548)
+* \vee:                                  Math symbols.      (line  8895)
+* \verb:                                 \verb.             (line  5594)
+* \Vert:                                 Math symbols.      (line  8900)
+* \vert:                                 Math symbols.      (line  8916)
+* \vfill:                                \vfill.            (line 10632)
+* \vline:                                \vline.            (line  5185)
+* \vspace:                               \vspace.           (line 10581)
+* \wedge:                                Math symbols.      (line  8934)
+* \widehat:                              Math accents.      (line  9266)
+* \widetilde:                            Math accents.      (line  9269)
+* \wlog:                                 \wlog.             (line 14148)
+* \wp:                                   Math symbols.      (line  8938)
+* \wr:                                   Math symbols.      (line  8941)
+* \write:                                \write.            (line 13995)
+* \write18:                              \write18.          (line 14166)
+* \Xi:                                   Math symbols.      (line  8944)
+* \xi:                                   Math symbols.      (line  8947)
 * \year:                                 \day & \month & \year.
-                                                            (line  7377)
-* \zeta:                                 Math symbols.      (line  8949)
-* \\ (for center):                       center.            (line  2965)
-* \\ (for eqnarray):                     eqnarray.          (line  3273)
-* \\ (for flushright):                   flushright.        (line  3502)
-* \\ (for \shortstack objects):          \shortstack.       (line  4531)
-* \\ (tabbing):                          tabbing.           (line  4776)
-* \\ for flushleft:                      flushleft.         (line  3443)
-* \\ for letters:                        Letters.           (line 13592)
-* \\ for tabular:                        tabular.           (line  4954)
-* \\ for verse:                          verse.             (line  5655)
-* \\ for \author:                        \maketitle.        (line  9729)
-* \\ for \title:                         \maketitle.        (line  9750)
-* \\ force line break:                   \\.                (line  5693)
-* \\* (for eqnarray):                    eqnarray.          (line  3281)
+                                                            (line  7378)
+* \zeta:                                 Math symbols.      (line  8950)
+* \\ (for center):                       center.            (line  2966)
+* \\ (for eqnarray):                     eqnarray.          (line  3274)
+* \\ (for flushright):                   flushright.        (line  3503)
+* \\ (for \shortstack objects):          \shortstack.       (line  4532)
+* \\ (tabbing):                          tabbing.           (line  4777)
+* \\ for flushleft:                      flushleft.         (line  3444)
+* \\ for letters:                        Letters.           (line 13593)
+* \\ for tabular:                        tabular.           (line  4955)
+* \\ for verse:                          verse.             (line  5656)
+* \\ for \author:                        \maketitle.        (line  9730)
+* \\ for \title:                         \maketitle.        (line  9751)
+* \\ force line break:                   \\.                (line  5694)
+* \\* (for eqnarray):                    eqnarray.          (line  3282)
 * \^:                                    Reserved characters.
-                                                            (line 12108)
-* \^ (circumflex accent):                Accents.           (line 12404)
+                                                            (line 12109)
+* \^ (circumflex accent):                Accents.           (line 12405)
 * \_:                                    Reserved characters.
-                                                            (line 12101)
-* \` (grave accent):                     Accents.           (line 12408)
-* \` (tabbing):                          tabbing.           (line  4803)
+                                                            (line 12102)
+* \` (grave accent):                     Accents.           (line 12409)
+* \` (tabbing):                          tabbing.           (line  4804)
 * \{:                                    Reserved characters.
-                                                            (line 12101)
-* \|:                                    Math symbols.      (line  8063)
+                                                            (line 12102)
+* \|:                                    Math symbols.      (line  8064)
 * \}:                                    Reserved characters.
-                                                            (line 12101)
+                                                            (line 12102)
 * \~:                                    Reserved characters.
-                                                            (line 12108)
-* \~ (tilde accent):                     Accents.           (line 12412)
+                                                            (line 12109)
+* \~ (tilde accent):                     Accents.           (line 12413)
 * ^:                                     Subscripts & superscripts.
-                                                            (line  7988)
+                                                            (line  7989)
 * _:                                     Subscripts & superscripts.
-                                                            (line  7988)
-* 'see' and 'see also' index entries:    \index.            (line 13176)
+                                                            (line  7989)
+* 'see' and 'see also' index entries:    \index.            (line 13177)
 * {...} for required arguments:          LaTeX command syntax.
-                                                            (line   534)
-* ~:                                     ~.                 (line 10255)
+                                                            (line   535)
+* ~:                                     ~.                 (line 10256)
 * a4paper option:                        Document class options.
-                                                            (line   682)
+                                                            (line   683)
 * a5paper option:                        Document class options.
-                                                            (line   682)
-* abstract environment:                  abstract.          (line  2830)
-* abstracts:                             abstract.          (line  2830)
-* accents:                               Accents.           (line 12372)
-* accents, mathematical:                 Math accents.      (line  9228)
+                                                            (line   683)
+* abstract environment:                  abstract.          (line  2831)
+* abstracts:                             abstract.          (line  2831)
+* accents:                               Accents.           (line 12373)
+* accents, mathematical:                 Math accents.      (line  9229)
 * accessing any character of a font:     Symbols by font position.
-                                                            (line 12171)
-* acronyms, list of:                     Glossaries.        (line 13412)
-* acute accent:                          Accents.           (line 12393)
-* acute accent, math:                    Math accents.      (line  9233)
+                                                            (line 12172)
+* acronyms, list of:                     Glossaries.        (line 13413)
+* acute accent:                          Accents.           (line 12394)
+* acute accent, math:                    Math accents.      (line  9234)
 * additional packages, loading:          Additional packages.
-                                                            (line   768)
+                                                            (line   769)
 * ae ligature:                           Additional Latin letters.
-                                                            (line 12514)
-* algorithm2e package:                   tabbing.           (line  4856)
-* align environment, from amsmath:       eqnarray.          (line  3250)
-* aligning equations:                    eqnarray.          (line  3250)
-* alignment via tabbing:                 tabbing.           (line  4716)
-* amsfonts package:                      Math formulas.     (line  7977)
-* amsmath package:                       array.             (line  2925)
-* amsmath package <1>:                   array.             (line  2936)
-* amsmath package <2>:                   displaymath.       (line  3117)
-* amsmath package <3>:                   equation.          (line  3320)
-* amsmath package <4>:                   theorem.           (line  5507)
-* amsmath package <5>:                   Math formulas.     (line  7977)
-* amsmath package <6>:                   Dots.              (line  9088)
-* amsmath package <7>:                   Math functions.    (line  9217)
+                                                            (line 12515)
+* algorithm2e package:                   tabbing.           (line  4857)
+* align environment, from amsmath:       eqnarray.          (line  3251)
+* aligning equations:                    eqnarray.          (line  3251)
+* alignment via tabbing:                 tabbing.           (line  4717)
+* amsfonts package:                      Math formulas.     (line  7978)
+* amsmath package:                       array.             (line  2926)
+* amsmath package <1>:                   array.             (line  2937)
+* amsmath package <2>:                   displaymath.       (line  3118)
+* amsmath package <3>:                   equation.          (line  3321)
+* amsmath package <4>:                   theorem.           (line  5508)
+* amsmath package <5>:                   Math formulas.     (line  7978)
+* amsmath package <6>:                   Dots.              (line  9089)
+* amsmath package <7>:                   Math functions.    (line  9218)
 * amsmath package <8>:                   \phantom & \vphantom & \hphantom.
-                                                            (line  9478)
+                                                            (line  9479)
 * amsmath package <9>:                   Colon character & \colon.
-                                                            (line  9506)
+                                                            (line  9507)
 * amsmath package <10>:                  Colon character & \colon.
-                                                            (line  9510)
-* amsmath package, replacing eqnarray:   eqnarray.          (line  3250)
-* amsthm package:                        theorem.           (line  5507)
-* amsthm package <1>:                    \rule.             (line 12573)
-* answers package:                       \write.            (line 14034)
-* appendices:                            \appendix.         (line  2402)
-* appendix:                              \appendix.         (line  2402)
-* appendix package:                      \appendix.         (line  2425)
+                                                            (line  9511)
+* amsmath package, replacing eqnarray:   eqnarray.          (line  3251)
+* amsthm package:                        theorem.           (line  5508)
+* amsthm package <1>:                    \rule.             (line 12574)
+* answers package:                       \write.            (line 14096)
+* appendices:                            \appendix.         (line  2403)
+* appendix:                              \appendix.         (line  2403)
+* appendix package:                      \appendix.         (line  2426)
 * aring:                                 Additional Latin letters.
-                                                            (line 12510)
-* array (package) package:               array.             (line  2947)
-* array environment:                     array.             (line  2876)
-* arrays, math:                          array.             (line  2876)
-* arrow, left, in text:                  Text symbols.      (line 12317)
-* arrow, right, in text:                 Text symbols.      (line 12352)
-* article class:                         Document classes.  (line   640)
-* ascender height:                       Text symbols.      (line 12278)
-* ASCII circumflex, in text:             Text symbols.      (line 12243)
-* ASCII tilde, in text:                  Text symbols.      (line 12246)
-* asterisk, centered, in text:           Text symbols.      (line 12249)
-* Asymptote package:                     \line.             (line  4408)
-* Asymptote package <1>:                 \strut.            (line 10551)
-* Asymptote package <2>:                 \mbox & \makebox.  (line 10783)
-* Asymptote package <3>:                 \write.            (line 13934)
-* Asymptote package <4>:                 \write18.          (line 14110)
-* at clause, in font definitions:        \newfont.          (line  7020)
-* at-sign:                               \@.                (line 10138)
-* author, for titlepage:                 \maketitle.        (line  9729)
-* auxiliary file:                        Output files.      (line   463)
+                                                            (line 12511)
+* array (package) package:               array.             (line  2948)
+* array environment:                     array.             (line  2877)
+* arrays, math:                          array.             (line  2877)
+* arrow, left, in text:                  Text symbols.      (line 12318)
+* arrow, right, in text:                 Text symbols.      (line 12353)
+* article class:                         Document classes.  (line   641)
+* ascender height:                       Text symbols.      (line 12279)
+* ASCII circumflex, in text:             Text symbols.      (line 12244)
+* ASCII tilde, in text:                  Text symbols.      (line 12247)
+* asterisk, centered, in text:           Text symbols.      (line 12250)
+* Asymptote package:                     \line.             (line  4409)
+* Asymptote package <1>:                 \strut.            (line 10552)
+* Asymptote package <2>:                 \mbox & \makebox.  (line 10784)
+* Asymptote package <3>:                 \write18.          (line 14173)
+* at clause, in font definitions:        \newfont.          (line  7021)
+* at-sign:                               \@.                (line 10139)
+* author, for titlepage:                 \maketitle.        (line  9730)
+* auxiliary file:                        Output files.      (line   464)
 * b5paper option:                        Document class options.
-                                                            (line   682)
-* babel package:                         \chapter.          (line  2165)
-* babel package <1>:                     thebibliography.   (line  5297)
-* babel package <2>:                     Accents.           (line 12372)
-* babel package <3>:                     \today.            (line 12603)
+                                                            (line   683)
+* babel package:                         \chapter.          (line  2166)
+* babel package <1>:                     thebibliography.   (line  5298)
+* babel package <2>:                     Accents.           (line 12373)
+* babel package <3>:                     \today.            (line 12604)
 * babel package <4>:                     Table of contents etc..
-                                                            (line 12930)
-* babel package <5>:                     \index.            (line 13176)
-* background, colored:                   Colored pages.     (line 11323)
-* backslash, in text:                    Text symbols.      (line 12252)
-* bar, double vertical, in text:         Text symbols.      (line 12258)
-* bar, vertical, in text:                Text symbols.      (line 12255)
-* bar-over accent:                       Accents.           (line 12400)
-* bar-over accent, math:                 Math accents.      (line  9236)
-* bar-under accent:                      Accents.           (line 12415)
-* basics of LaTeX:                       Overview.          (line   378)
-* beamer template and class:             beamer template.   (line 14381)
-* beginning of document hook:            \AtBeginDocument.  (line  3151)
+                                                            (line 12931)
+* babel package <5>:                     \index.            (line 13177)
+* background, colored:                   Colored pages.     (line 11324)
+* backslash, in text:                    Text symbols.      (line 12253)
+* bar, double vertical, in text:         Text symbols.      (line 12259)
+* bar, vertical, in text:                Text symbols.      (line 12256)
+* bar-over accent:                       Accents.           (line 12401)
+* bar-over accent, math:                 Math accents.      (line  9237)
+* bar-under accent:                      Accents.           (line 12416)
+* basics of LaTeX:                       Overview.          (line   379)
+* beamer template and class:             beamer template.   (line 14444)
+* beginning of document hook:            \AtBeginDocument.  (line  3152)
 * bibliography format, open:             Document class options.
-                                                            (line   730)
-* bibliography, creating (automatically): Using BibTeX.     (line  5427)
-* bibliography, creating (manually):     thebibliography.   (line  5250)
-* bibTeX, using:                         Using BibTeX.      (line  5427)
-* big circle symbols, in text:           Text symbols.      (line 12261)
-* Big point:                             Units of length.   (line  7510)
+                                                            (line   731)
+* bibliography, creating (automatically): Using BibTeX.     (line  5428)
+* bibliography, creating (manually):     thebibliography.   (line  5251)
+* bibTeX, using:                         Using BibTeX.      (line  5428)
+* big circle symbols, in text:           Text symbols.      (line 12262)
+* Big point:                             Units of length.   (line  7511)
 * bigfoot package:                       Footnotes of footnotes.
-                                                            (line  6384)
+                                                            (line  6385)
 * black boxes, omitting:                 Document class options.
-                                                            (line   716)
-* blackboard bold:                       Blackboard bold.   (line  8973)
+                                                            (line   717)
+* blackboard bold:                       Blackboard bold.   (line  8974)
 * bm package:                            \boldmath & \unboldmath.
-                                                            (line  9043)
-* bold font:                             Font styles.       (line  1274)
-* bold math:                             Font styles.       (line  1327)
-* bold typewriter, avoiding:             description.       (line  3075)
+                                                            (line  9044)
+* bold font:                             Font styles.       (line  1275)
+* bold math:                             Font styles.       (line  1328)
+* bold typewriter, avoiding:             description.       (line  3076)
 * boldface mathematics:                  \boldmath & \unboldmath.
-                                                            (line  9017)
-* book class:                            Document classes.  (line   640)
+                                                            (line  9018)
+* book class:                            Document classes.  (line   641)
 * book, back matter:                     \frontmatter & \mainmatter & \backmatter.
-                                                            (line  2435)
+                                                            (line  2436)
 * book, end matter:                      \frontmatter & \mainmatter & \backmatter.
-                                                            (line  2435)
+                                                            (line  2436)
 * book, front matter:                    \frontmatter & \mainmatter & \backmatter.
-                                                            (line  2435)
+                                                            (line  2436)
 * book, main matter:                     \frontmatter & \mainmatter & \backmatter.
-                                                            (line  2435)
-* bottomnumber:                          Floats.            (line  1935)
-* bottomnumber <1>:                      Floats.            (line  1936)
-* box:                                   \mbox & \makebox.  (line 10716)
-* box, allocating new:                   \newsavebox.       (line  6733)
-* box, colored:                          Colored boxes.     (line 11286)
-* box, save:                             \sbox & \savebox.  (line 10970)
-* box, use saved box:                    \usebox.           (line 11076)
-* boxes:                                 Boxes.             (line 10707)
-* bp:                                    Units of length.   (line  7510)
-* brace, left, in text:                  Text symbols.      (line 12264)
-* brace, right, in text:                 Text symbols.      (line 12267)
-* breaking lines:                        Line breaking.     (line  5676)
-* breaking pages:                        Page breaking.     (line  5967)
-* breaks, multiplication discretionary:  \*.                (line  9517)
-* breve accent:                          Accents.           (line 12451)
-* breve accent, math:                    Math accents.      (line  9239)
+                                                            (line  2436)
+* bottomnumber:                          Floats.            (line  1936)
+* bottomnumber <1>:                      Floats.            (line  1937)
+* box:                                   \mbox & \makebox.  (line 10717)
+* box, allocating new:                   \newsavebox.       (line  6734)
+* box, colored:                          Colored boxes.     (line 11287)
+* box, save:                             \sbox & \savebox.  (line 10971)
+* box, use saved box:                    \usebox.           (line 11077)
+* boxes:                                 Boxes.             (line 10708)
+* bp:                                    Units of length.   (line  7511)
+* brace, left, in text:                  Text symbols.      (line 12265)
+* brace, right, in text:                 Text symbols.      (line 12268)
+* breaking lines:                        Line breaking.     (line  5677)
+* breaking pages:                        Page breaking.     (line  5968)
+* breaks, multiplication discretionary:  \*.                (line  9518)
+* breve accent:                          Accents.           (line 12452)
+* breve accent, math:                    Math accents.      (line  9240)
 * bug reporting:                         About this document.
-                                                            (line   349)
-* bullet lists:                          itemize.           (line  3539)
-* bullet symbol:                         Math symbols.      (line  8158)
-* bullet, in text:                       Text symbols.      (line 12270)
-* bulleted lists:                        itemize.           (line  3539)
-* calligraphic fonts:                    Calligraphic.      (line  8999)
-* calligraphic letters for math:         Font styles.       (line  1277)
-* cap height:                            Text symbols.      (line 12278)
-* caron accent:                          Accents.           (line 12455)
+                                                            (line   350)
+* bullet lists:                          itemize.           (line  3540)
+* bullet symbol:                         Math symbols.      (line  8159)
+* bullet, in text:                       Text symbols.      (line 12271)
+* bulleted lists:                        itemize.           (line  3540)
+* calligraphic fonts:                    Calligraphic.      (line  9000)
+* calligraphic letters for math:         Font styles.       (line  1278)
+* cap height:                            Text symbols.      (line 12279)
+* caron accent:                          Accents.           (line 12456)
 * catcode:                               \makeatletter & \makeatother.
-                                                            (line  6571)
+                                                            (line  6572)
 * category code, character:              \makeatletter & \makeatother.
-                                                            (line  6571)
-* cc:                                    Units of length.   (line  7523)
-* cc list, in letters:                   \cc.               (line 13654)
-* cedilla accent:                        Accents.           (line 12425)
-* center environment:                    center.            (line  2955)
-* centered asterisk, in text:            Text symbols.      (line 12249)
+                                                            (line  6572)
+* cc:                                    Units of length.   (line  7524)
+* cc list, in letters:                   \cc.               (line 13655)
+* cedilla accent:                        Accents.           (line 12426)
+* center environment:                    center.            (line  2956)
+* centered asterisk, in text:            Text symbols.      (line 12250)
 * centered equations:                    Document class options.
-                                                            (line   720)
-* centered period, in text:              Text symbols.      (line 12324)
-* centering text, declaration for:       \centering.        (line  3003)
-* centering text, environment for:       center.            (line  2955)
-* Centimeter:                            Units of length.   (line  7514)
-* chapter:                               Sectioning.        (line  1961)
-* chapter <1>:                           \chapter.          (line  2100)
+                                                            (line   721)
+* centered period, in text:              Text symbols.      (line 12325)
+* centering text, declaration for:       \centering.        (line  3004)
+* centering text, environment for:       center.            (line  2956)
+* Centimeter:                            Units of length.   (line  7515)
+* chapter:                               Sectioning.        (line  1962)
+* chapter <1>:                           \chapter.          (line  2101)
 * character category code:               \makeatletter & \makeatother.
-                                                            (line  6571)
+                                                            (line  6572)
 * character, invisible:                  \phantom & \vphantom & \hphantom.
-                                                            (line  9440)
-* characters, accented:                  Accents.           (line 12372)
+                                                            (line  9441)
+* characters, accented:                  Accents.           (line 12373)
 * characters, case of:                   Upper and lower case.
-                                                            (line 12126)
+                                                            (line 12127)
 * characters, non-English:               Additional Latin letters.
-                                                            (line 12504)
+                                                            (line 12505)
 * characters, reserved:                  Reserved characters.
-                                                            (line 12094)
+                                                            (line 12095)
 * characters, special:                   Reserved characters.
-                                                            (line 12094)
-* check accent:                          Accents.           (line 12455)
-* check accent, math:                    Math accents.      (line  9242)
-* Cicero:                                Units of length.   (line  7523)
-* circle symbol, big, in text:           Text symbols.      (line 12261)
-* circled letter, in text:               Text symbols.      (line 12273)
-* circumflex accent:                     Accents.           (line 12404)
-* circumflex accent, math:               Math accents.      (line  9254)
-* circumflex, ASCII, in text:            Text symbols.      (line 12243)
-* citation key:                          \bibitem.          (line  5312)
+                                                            (line 12095)
+* check accent:                          Accents.           (line 12456)
+* check accent, math:                    Math accents.      (line  9243)
+* Cicero:                                Units of length.   (line  7524)
+* circle symbol, big, in text:           Text symbols.      (line 12262)
+* circled letter, in text:               Text symbols.      (line 12274)
+* circumflex accent:                     Accents.           (line 12405)
+* circumflex accent, math:               Math accents.      (line  9255)
+* circumflex, ASCII, in text:            Text symbols.      (line 12244)
+* citation key:                          \bibitem.          (line  5313)
 * class and package commands:            Class and package commands.
-                                                            (line   854)
+                                                            (line   855)
 * class and package difference:          Class and package construction.
-                                                            (line   793)
+                                                            (line   794)
 * class and package structure:           Class and package structure.
-                                                            (line   807)
+                                                            (line   808)
 * class file example:                    Class and package structure.
-                                                            (line   840)
+                                                            (line   841)
 * class file layout:                     Class and package structure.
-                                                            (line   807)
+                                                            (line   808)
 * class options:                         Document class options.
-                                                            (line   669)
+                                                            (line   670)
 * class options <1>:                     Class and package structure.
-                                                            (line   807)
+                                                            (line   808)
 * class options <2>:                     Class and package commands.
-                                                            (line   914)
-* classes of documents:                  Document classes.  (line   635)
-* cleveref package:                      Cross references.  (line  2694)
-* cleveref package <1>:                  \ref.              (line  2807)
-* cleveref package <2>:                  \footnotemark.     (line  6265)
+                                                            (line   915)
+* classes of documents:                  Document classes.  (line   636)
+* cleveref package:                      Cross references.  (line  2695)
+* cleveref package <1>:                  \ref.              (line  2808)
+* cleveref package <2>:                  \footnotemark.     (line  6266)
 * clock option to slides class:          Document class options.
-                                                            (line   762)
-* closing letters:                       \closing.          (line 13670)
-* closing quote:                         Text symbols.      (line 12233)
-* cm:                                    Units of length.   (line  7514)
-* code, typesetting:                     verbatim.          (line  5554)
+                                                            (line   763)
+* closing letters:                       \closing.          (line 13671)
+* closing quote:                         Text symbols.      (line 12234)
+* cm:                                    Units of length.   (line  7515)
+* code, typesetting:                     verbatim.          (line  5555)
 * colon character:                       Colon character & \colon.
-                                                            (line  9497)
-* color:                                 Color.             (line 11088)
-* color <1>:                             Define colors.     (line 11193)
-* color <2>:                             Colored text.      (line 11215)
-* color <3>:                             Colored boxes.     (line 11286)
-* color <4>:                             Colored pages.     (line 11323)
-* color models:                          Color models.      (line 11141)
+                                                            (line  9498)
+* color:                                 Color.             (line 11089)
+* color <1>:                             Define colors.     (line 11194)
+* color <2>:                             Colored text.      (line 11216)
+* color <3>:                             Colored boxes.     (line 11287)
+* color <4>:                             Colored pages.     (line 11324)
+* color models:                          Color models.      (line 11142)
 * color package commands:                Commands for color.
-                                                            (line 11188)
+                                                            (line 11189)
 * color package options:                 Color package options.
-                                                            (line 11103)
-* color, define:                         Define colors.     (line 11193)
-* colored boxes:                         Colored boxes.     (line 11286)
-* colored page:                          Colored pages.     (line 11323)
-* colored text:                          Colored text.      (line 11215)
-* command line:                          Command line.      (line 14166)
+                                                            (line 11104)
+* color, define:                         Define colors.     (line 11194)
+* colored boxes:                         Colored boxes.     (line 11287)
+* colored page:                          Colored pages.     (line 11324)
+* colored text:                          Colored text.      (line 11216)
+* command line:                          Command line.      (line 14229)
 * command syntax:                        LaTeX command syntax.
-                                                            (line   534)
+                                                            (line   535)
 * commands, class and package:           Class and package commands.
-                                                            (line   854)
+                                                            (line   855)
 * commands, defining new ones:           \newcommand & \renewcommand.
-                                                            (line  6405)
-* commands, defining new ones <1>:       \providecommand.   (line  6530)
+                                                            (line  6406)
+* commands, defining new ones <1>:       \providecommand.   (line  6531)
 * commands, document class:              Class and package construction.
-                                                            (line   784)
+                                                            (line   785)
 * commands, graphics package:            Commands for graphics.
-                                                            (line 11632)
+                                                            (line 11633)
 * commands, ignore spaces:               \ignorespaces & \ignorespacesafterend.
-                                                            (line  7091)
+                                                            (line  7092)
 * commands, redefining:                  \newcommand & \renewcommand.
-                                                            (line  6405)
-* commands, run from LaTeX:              \write18.          (line 14103)
-* commands, star-variants:               \@ifstar.          (line  6609)
-* composite word mark, in text:          Text symbols.      (line 12278)
-* computer programs, typesetting:        verbatim.          (line  5554)
+                                                            (line  6406)
+* commands, run from LaTeX:              \write18.          (line 14166)
+* commands, star-variants:               \@ifstar.          (line  6610)
+* composite word mark, in text:          Text symbols.      (line 12279)
+* computer programs, typesetting:        verbatim.          (line  5555)
 * configuration, graphics package:       Graphics package configuration.
-                                                            (line 11445)
-* contents file:                         Output files.      (line   473)
-* copyright symbol:                      Text symbols.      (line 12190)
-* counters, a list of:                   Counters.          (line  7166)
-* counters, defining new:                \newcounter.       (line  6670)
-* counters, getting value of:            \value.            (line  7276)
+                                                            (line 11446)
+* contents file:                         Output files.      (line   474)
+* copyright symbol:                      Text symbols.      (line 12191)
+* counters, a list of:                   Counters.          (line  7167)
+* counters, defining new:                \newcounter.       (line  6671)
+* counters, getting value of:            \value.            (line  7277)
 * counters, printing:                    \alph \Alph \arabic \roman \Roman \fnsymbol.
-                                                            (line  7194)
-* counters, setting:                     \setcounter.       (line  7309)
-* cprotect package:                      verbatim.          (line  5574)
-* cprotect package <1>:                  \verb.             (line  5632)
-* creating pictures:                     picture.           (line  4154)
-* creating tables:                       table.             (line  4865)
-* credit footnote:                       \maketitle.        (line  9743)
-* cross references:                      Cross references.  (line  2662)
-* cross references, resolving:           Output files.      (line   463)
-* cross referencing with page number:    \pageref.          (line  2760)
-* cross referencing, symbolic:           \ref.              (line  2784)
-* CTAN:                                  CTAN.              (line   609)
-* currency, dollar:                      Text symbols.      (line 12291)
-* currency, euro:                        Text symbols.      (line 12302)
-* dagger, double, in text:               Text symbols.      (line 12288)
-* dagger, in text:                       Text symbols.      (line 12193)
-* dagger, in text <1>:                   Text symbols.      (line 12285)
-* DANTE e.V.:                            CTAN.              (line   623)
-* date, for titlepage:                   \maketitle.        (line  9737)
-* date, today's:                         \today.            (line 12596)
-* datetime package:                      \today.            (line 12617)
-* dbltopnumber:                          Floats.            (line  1939)
-* dbltopnumber <1>:                      Floats.            (line  1940)
-* dcolumn package:                       array.             (line  2947)
-* dd:                                    Units of length.   (line  7520)
-* define color:                          Define colors.     (line 11193)
+                                                            (line  7195)
+* counters, setting:                     \setcounter.       (line  7310)
+* cprotect package:                      verbatim.          (line  5575)
+* cprotect package <1>:                  \verb.             (line  5633)
+* creating pictures:                     picture.           (line  4155)
+* creating tables:                       table.             (line  4866)
+* credit footnote:                       \maketitle.        (line  9744)
+* cross references:                      Cross references.  (line  2663)
+* cross references, resolving:           Output files.      (line   464)
+* cross referencing with page number:    \pageref.          (line  2761)
+* cross referencing, symbolic:           \ref.              (line  2785)
+* CTAN:                                  CTAN.              (line   610)
+* currency, dollar:                      Text symbols.      (line 12292)
+* currency, euro:                        Text symbols.      (line 12303)
+* dagger, double, in text:               Text symbols.      (line 12289)
+* dagger, in text:                       Text symbols.      (line 12194)
+* dagger, in text <1>:                   Text symbols.      (line 12286)
+* DANTE e.V.:                            CTAN.              (line   624)
+* date, for titlepage:                   \maketitle.        (line  9738)
+* date, today's:                         \today.            (line 12597)
+* datetime package:                      \today.            (line 12618)
+* dbltopnumber:                          Floats.            (line  1940)
+* dbltopnumber <1>:                      Floats.            (line  1941)
+* dcolumn package:                       array.             (line  2948)
+* dd:                                    Units of length.   (line  7521)
+* define color:                          Define colors.     (line 11194)
 * defining a new command:                \newcommand & \renewcommand.
-                                                            (line  6405)
-* defining a new command <1>:            \providecommand.   (line  6530)
+                                                            (line  6406)
+* defining a new command <1>:            \providecommand.   (line  6531)
 * defining new environments:             \newenvironment & \renewenvironment.
-                                                            (line  6761)
-* defining new fonts:                    \newfont.          (line  7007)
-* defining new theorems:                 \newtheorem.       (line  6895)
-* definitions:                           Definitions.       (line  6400)
-* delimiters, paired:                    \left & \right.    (line  9545)
-* delim_0:                               makeindex.         (line 13345)
-* delim_1:                               makeindex.         (line 13349)
-* delim_2:                               makeindex.         (line 13353)
-* delim_n:                               makeindex.         (line 13357)
-* delim_r:                               makeindex.         (line 13361)
-* description:                           \newglossaryentry. (line 13500)
-* description environment:               description.       (line  3045)
-* description lists, creating:           description.       (line  3045)
-* design size, in font definitions:      \newfont.          (line  7020)
-* Didot point:                           Units of length.   (line  7520)
-* dieresis accent:                       Accents.           (line 12389)
+                                                            (line  6762)
+* defining new fonts:                    \newfont.          (line  7008)
+* defining new theorems:                 \newtheorem.       (line  6896)
+* definitions:                           Definitions.       (line  6401)
+* delimiters, paired:                    \left & \right.    (line  9546)
+* delim_0:                               makeindex.         (line 13346)
+* delim_1:                               makeindex.         (line 13350)
+* delim_2:                               makeindex.         (line 13354)
+* delim_n:                               makeindex.         (line 13358)
+* delim_r:                               makeindex.         (line 13362)
+* description:                           \newglossaryentry. (line 13501)
+* description environment:               description.       (line  3046)
+* description lists, creating:           description.       (line  3046)
+* design size, in font definitions:      \newfont.          (line  7021)
+* Didot point:                           Units of length.   (line  7521)
+* dieresis accent:                       Accents.           (line 12390)
 * difference between class and package:  Class and package construction.
-                                                            (line   793)
-* discretionary breaks, multiplication:  \*.                (line  9517)
-* discretionary hyphenation:             \discretionary.    (line  5854)
-* display math mode:                     Modes.             (line  9629)
+                                                            (line   794)
+* discretionary breaks, multiplication:  \*.                (line  9518)
+* discretionary hyphenation:             \discretionary.    (line  5855)
+* display math mode:                     Modes.             (line  9630)
 * displaying quoted text with paragraph indentation: quotation & quote.
-                                                            (line  4686)
+                                                            (line  4687)
 * displaying quoted text without paragraph indentation: quotation & quote.
-                                                            (line  4686)
-* displaymath environment:               displaymath.       (line  3101)
-* displaymath environment <1>:           Math formulas.     (line  7897)
+                                                            (line  4687)
+* displaymath environment:               displaymath.       (line  3102)
+* displaymath environment <1>:           Math formulas.     (line  7898)
 * document class commands:               Class and package construction.
-                                                            (line   784)
+                                                            (line   785)
 * document class options:                Document class options.
-                                                            (line   669)
+                                                            (line   670)
 * document class, defined:               Starting and ending.
-                                                            (line   415)
-* document classes:                      Document classes.  (line   635)
-* document environment:                  document.          (line  3145)
+                                                            (line   416)
+* document classes:                      Document classes.  (line   636)
+* document environment:                  document.          (line  3146)
 * document templates:                    Document templates.
-                                                            (line 14374)
-* dollar sign:                           Text symbols.      (line 12291)
-* dot accent:                            Accents.           (line 12396)
-* dot over accent, math:                 Math accents.      (line  9248)
-* dot-over accent:                       Accents.           (line 12396)
-* dot-under accent:                      Accents.           (line 12429)
-* dotless i:                             Accents.           (line 12383)
-* dotless i, math:                       Math symbols.      (line  8310)
-* dotless j:                             Accents.           (line 12383)
-* dotless j, math:                       Math symbols.      (line  8332)
-* dots:                                  Dots.              (line  9057)
-* double angle quotation marks:          Text symbols.      (line 12208)
-* double dagger, in text:                Text symbols.      (line 12196)
-* double dagger, in text <1>:            Text symbols.      (line 12288)
-* double dot accent, math:               Math accents.      (line  9245)
-* double guillemets:                     Text symbols.      (line 12208)
-* double left quote:                     Text symbols.      (line 12330)
-* double low-9 quotation mark:           Text symbols.      (line 12230)
-* double quote, straight base:           Text symbols.      (line 12346)
-* double right quote:                    Text symbols.      (line 12333)
+                                                            (line 14437)
+* dollar sign:                           Text symbols.      (line 12292)
+* dot accent:                            Accents.           (line 12397)
+* dot over accent, math:                 Math accents.      (line  9249)
+* dot-over accent:                       Accents.           (line 12397)
+* dot-under accent:                      Accents.           (line 12430)
+* dotless i:                             Accents.           (line 12384)
+* dotless i, math:                       Math symbols.      (line  8311)
+* dotless j:                             Accents.           (line 12384)
+* dotless j, math:                       Math symbols.      (line  8333)
+* dots:                                  Dots.              (line  9058)
+* double angle quotation marks:          Text symbols.      (line 12209)
+* double dagger, in text:                Text symbols.      (line 12197)
+* double dagger, in text <1>:            Text symbols.      (line 12289)
+* double dot accent, math:               Math accents.      (line  9246)
+* double guillemets:                     Text symbols.      (line 12209)
+* double left quote:                     Text symbols.      (line 12331)
+* double low-9 quotation mark:           Text symbols.      (line 12231)
+* double quote, straight base:           Text symbols.      (line 12347)
+* double right quote:                    Text symbols.      (line 12334)
 * double spacing:                        Low-level font commands.
-                                                            (line  1492)
-* double vertical bar, in text:          Text symbols.      (line 12258)
-* doublestruck:                          Blackboard bold.   (line  8973)
+                                                            (line  1493)
+* double vertical bar, in text:          Text symbols.      (line 12259)
+* doublestruck:                          Blackboard bold.   (line  8974)
 * draft option:                          Document class options.
-                                                            (line   712)
-* dvipdfmx command:                      Output files.      (line   440)
-* dvips command:                         Output files.      (line   440)
-* dvitype command:                       Output files.      (line   440)
-* e-dash:                                Text symbols.      (line 12299)
-* e-TeX:                                 TeX engines.       (line   489)
-* ellipses:                              Dots.              (line  9057)
-* ellipsis:                              Text symbols.      (line 12214)
-* em:                                    Units of length.   (line  7528)
-* em <1>:                                Units of length.   (line  7528)
-* em-dash:                               Text symbols.      (line 12294)
-* em-dash, three-quarters:               Text symbols.      (line 12355)
-* em-dash, two-thirds:                   Text symbols.      (line 12361)
-* emphasis:                              Font styles.       (line  1258)
-* enclosure list:                        \encl.             (line 13683)
-* end of document hook:                  \AtEndDocument.    (line  3167)
+                                                            (line   713)
+* dvipdfmx command:                      Output files.      (line   441)
+* dvips command:                         Output files.      (line   441)
+* dvitype command:                       Output files.      (line   441)
+* e-dash:                                Text symbols.      (line 12300)
+* e-TeX:                                 TeX engines.       (line   490)
+* ellipses:                              Dots.              (line  9058)
+* ellipsis:                              Text symbols.      (line 12215)
+* em:                                    Units of length.   (line  7529)
+* em <1>:                                Units of length.   (line  7529)
+* em-dash:                               Text symbols.      (line 12295)
+* em-dash, three-quarters:               Text symbols.      (line 12356)
+* em-dash, two-thirds:                   Text symbols.      (line 12362)
+* emphasis:                              Font styles.       (line  1259)
+* enclosure list:                        \encl.             (line 13684)
+* end of document hook:                  \AtEndDocument.    (line  3168)
 * ending and starting:                   Starting and ending.
-                                                            (line   404)
-* engines, TeX:                          TeX engines.       (line   482)
-* enlarge current page:                  \enlargethispage.  (line  6072)
-* enumerate environment:                 enumerate.         (line  3183)
-* enumitem package:                      list.              (line  3891)
+                                                            (line   405)
+* engines, TeX:                          TeX engines.       (line   483)
+* enlarge current page:                  \enlargethispage.  (line  6073)
+* enumerate environment:                 enumerate.         (line  3184)
+* enumitem package:                      list.              (line  3892)
 * environment:                           Starting and ending.
-                                                            (line   423)
-* environment, abstract:                 abstract.          (line  2830)
-* environment, array:                    array.             (line  2876)
-* environment, center:                   center.            (line  2955)
-* environment, description:              description.       (line  3045)
-* environment, displaymath:              displaymath.       (line  3101)
-* environment, displaymath <1>:          Math formulas.     (line  7897)
-* environment, document:                 document.          (line  3145)
-* environment, enumerate:                enumerate.         (line  3183)
-* environment, eqnarray:                 eqnarray.          (line  3250)
-* environment, equation:                 equation.          (line  3306)
-* environment, equation <1>:             Math formulas.     (line  7897)
-* environment, figure:                   figure.            (line  3326)
-* environment, filecontents:             filecontents.      (line  3384)
-* environment, filecontents*:            filecontents.      (line  3384)
-* environment, flushleft:                flushleft.         (line  3435)
-* environment, flushright:               flushright.        (line  3496)
-* environment, itemize:                  itemize.           (line  3539)
-* environment, letter:                   letter.            (line  3622)
-* environment, list:                     list.              (line  3627)
-* environment, math:                     math.              (line  3991)
-* environment, math <1>:                 Math formulas.     (line  7897)
-* environment, minipage:                 minipage.          (line  4003)
-* environment, picture:                  picture.           (line  4154)
-* environment, quotation:                quotation & quote. (line  4686)
-* environment, quote:                    quotation & quote. (line  4686)
-* environment, tabbing:                  tabbing.           (line  4716)
-* environment, table:                    table.             (line  4865)
-* environment, tabular:                  tabular.           (line  4925)
-* environment, thebibliography:          thebibliography.   (line  5250)
-* environment, theorem:                  theorem.           (line  5485)
-* environment, theorem-like:             \newtheorem.       (line  6895)
-* environment, titlepage:                titlepage.         (line  5515)
-* environment, verbatim:                 verbatim.          (line  5554)
-* environment, verse:                    verse.             (line  5640)
-* environments:                          Environments.      (line  2813)
+                                                            (line   424)
+* environment, abstract:                 abstract.          (line  2831)
+* environment, array:                    array.             (line  2877)
+* environment, center:                   center.            (line  2956)
+* environment, description:              description.       (line  3046)
+* environment, displaymath:              displaymath.       (line  3102)
+* environment, displaymath <1>:          Math formulas.     (line  7898)
+* environment, document:                 document.          (line  3146)
+* environment, enumerate:                enumerate.         (line  3184)
+* environment, eqnarray:                 eqnarray.          (line  3251)
+* environment, equation:                 equation.          (line  3307)
+* environment, equation <1>:             Math formulas.     (line  7898)
+* environment, figure:                   figure.            (line  3327)
+* environment, filecontents:             filecontents.      (line  3385)
+* environment, filecontents*:            filecontents.      (line  3385)
+* environment, flushleft:                flushleft.         (line  3436)
+* environment, flushright:               flushright.        (line  3497)
+* environment, itemize:                  itemize.           (line  3540)
+* environment, letter:                   letter.            (line  3623)
+* environment, list:                     list.              (line  3628)
+* environment, math:                     math.              (line  3992)
+* environment, math <1>:                 Math formulas.     (line  7898)
+* environment, minipage:                 minipage.          (line  4004)
+* environment, picture:                  picture.           (line  4155)
+* environment, quotation:                quotation & quote. (line  4687)
+* environment, quote:                    quotation & quote. (line  4687)
+* environment, tabbing:                  tabbing.           (line  4717)
+* environment, table:                    table.             (line  4866)
+* environment, tabular:                  tabular.           (line  4926)
+* environment, thebibliography:          thebibliography.   (line  5251)
+* environment, theorem:                  theorem.           (line  5486)
+* environment, theorem-like:             \newtheorem.       (line  6896)
+* environment, titlepage:                titlepage.         (line  5516)
+* environment, verbatim:                 verbatim.          (line  5555)
+* environment, verse:                    verse.             (line  5641)
+* environments:                          Environments.      (line  2814)
 * environments, defining:                \newenvironment & \renewenvironment.
-                                                            (line  6761)
-* envlab package:                        \makelabels.       (line 13757)
+                                                            (line  6762)
+* envlab package:                        \makelabels.       (line 13758)
 * EPS files:                             Graphics package configuration.
-                                                            (line 11445)
-* EPS files <1>:                         \includegraphics.  (line 11638)
-* eqnarray environment:                  eqnarray.          (line  3250)
-* equation environment:                  equation.          (line  3306)
-* equation environment <1>:              Math formulas.     (line  7897)
-* equation number, cross referencing:    \ref.              (line  2784)
+                                                            (line 11446)
+* EPS files <1>:                         \includegraphics.  (line 11639)
+* eqnarray environment:                  eqnarray.          (line  3251)
+* equation environment:                  equation.          (line  3307)
+* equation environment <1>:              Math formulas.     (line  7898)
+* equation number, cross referencing:    \ref.              (line  2785)
 * equation numbers, left vs. right:      Document class options.
-                                                            (line   726)
-* equation numbers, omitting:            eqnarray.          (line  3285)
-* equations, aligning:                   eqnarray.          (line  3250)
-* equations, environment for:            equation.          (line  3306)
+                                                            (line   727)
+* equation numbers, omitting:            eqnarray.          (line  3286)
+* equations, aligning:                   eqnarray.          (line  3251)
+* equations, environment for:            equation.          (line  3307)
 * equations, flush left vs. centered:    Document class options.
-                                                            (line   720)
+                                                            (line   721)
 * es-zet German letter:                  Additional Latin letters.
-                                                            (line 12550)
-* etex command:                          TeX engines.       (line   489)
+                                                            (line 12551)
+* etex command:                          TeX engines.       (line   490)
 * eth, Icelandic letter:                 Additional Latin letters.
-                                                            (line 12518)
+                                                            (line 12519)
 * etoolbox package:                      Class and package commands.
-                                                            (line   958)
-* euro symbol:                           Text symbols.      (line 12302)
-* eurosym package:                       Text symbols.      (line 12302)
-* ex:                                    Units of length.   (line  7528)
-* ex <1>:                                Units of length.   (line  7528)
-* exclamation point, upside-down:        Text symbols.      (line 12308)
+                                                            (line   959)
+* euro symbol:                           Text symbols.      (line 12303)
+* eurosym package:                       Text symbols.      (line 12303)
+* ex:                                    Units of length.   (line  7529)
+* ex <1>:                                Units of length.   (line  7529)
+* exclamation point, upside-down:        Text symbols.      (line 12309)
 * executivepaper option:                 Document class options.
-                                                            (line   682)
+                                                            (line   683)
 * exponent:                              Subscripts & superscripts.
-                                                            (line  7988)
+                                                            (line  7989)
 * extended Latin:                        Additional Latin letters.
-                                                            (line 12504)
-* external commands:                     \write18.          (line 14103)
-* external files, writing:               filecontents.      (line  3384)
+                                                            (line 12505)
+* external commands:                     \write18.          (line 14166)
+* external files, writing:               filecontents.      (line  3385)
 * families, of fonts:                    Low-level font commands.
-                                                            (line  1395)
-* fancyhdr package:                      Page styles.       (line  9686)
-* fancyhdr package <1>:                  \pagestyle.        (line  9828)
-* fancyvrb package:                      tabbing.           (line  4856)
-* fancyvrb package <1>:                  verbatim.          (line  5585)
-* feminine ordinal symbol:               Text symbols.      (line 12321)
-* figure environment:                    figure.            (line  3326)
-* figure number, cross referencing:      \ref.              (line  2784)
-* figures, footnotes in:                 minipage.          (line  4104)
-* figures, inserting:                    figure.            (line  3326)
+                                                            (line  1396)
+* fancyhdr package:                      Page styles.       (line  9687)
+* fancyhdr package <1>:                  \pagestyle.        (line  9829)
+* fancyvrb package:                      tabbing.           (line  4857)
+* fancyvrb package <1>:                  verbatim.          (line  5586)
+* feminine ordinal symbol:               Text symbols.      (line 12322)
+* figure environment:                    figure.            (line  3327)
+* figure number, cross referencing:      \ref.              (line  2785)
+* figures, footnotes in:                 minipage.          (line  4105)
+* figures, inserting:                    figure.            (line  3327)
+* file, closing:                         \openin & \openout.
+                                                            (line 13856)
+* file, opening:                         \openin & \openout.
+                                                            (line 13856)
 * file, root:                            Splitting the input.
-                                                            (line 12631)
-* filecontents environment:              filecontents.      (line  3384)
-* filecontents* environment:             filecontents.      (line  3384)
+                                                            (line 12632)
+* filecontents environment:              filecontents.      (line  3385)
+* filecontents* environment:             filecontents.      (line  3385)
 * final option:                          Document class options.
-                                                            (line   712)
+                                                            (line   713)
 * first-latex-doc document:              About this document.
-                                                            (line   361)
-* fixed-width font:                      Font styles.       (line  1295)
-* flafter package:                       Floats.            (line  1887)
+                                                            (line   362)
+* fixed-width font:                      Font styles.       (line  1296)
+* flafter package:                       Floats.            (line  1888)
 * fleqn option:                          Document class options.
-                                                            (line   712)
-* float package:                         Floats.            (line  1857)
-* float page:                            Floats.            (line  1863)
+                                                            (line   713)
+* float package:                         Floats.            (line  1858)
+* float page:                            Floats.            (line  1864)
 * flush left equations:                  Document class options.
-                                                            (line   720)
+                                                            (line   721)
 * flushing floats and starting a page:   \clearpage & \cleardoublepage.
-                                                            (line  5998)
-* flushleft environment:                 flushleft.         (line  3435)
-* flushright environment:                flushright.        (line  3496)
+                                                            (line  5999)
+* flushleft environment:                 flushleft.         (line  3436)
+* flushright environment:                flushright.        (line  3497)
 * font catalogue:                        Low-level font commands.
-                                                            (line  1395)
+                                                            (line  1396)
 * font commands, low-level:              Low-level font commands.
-                                                            (line  1380)
+                                                            (line  1381)
 * font size:                             Low-level font commands.
-                                                            (line  1475)
-* font sizes:                            Font sizes.        (line  1345)
-* font styles:                           Font styles.       (line  1205)
+                                                            (line  1476)
+* font sizes:                            Font sizes.        (line  1346)
+* font styles:                           Font styles.       (line  1206)
 * font symbols, by number:               Symbols by font position.
-                                                            (line 12171)
-* fonts:                                 Fonts.             (line  1199)
-* fonts, new commands for:               \newfont.          (line  7007)
-* fonts, script:                         Calligraphic.      (line  8999)
-* footer style:                          \pagestyle.        (line  9821)
+                                                            (line 12172)
+* fonts:                                 Fonts.             (line  1200)
+* fonts, new commands for:               \newfont.          (line  7008)
+* fonts, script:                         Calligraphic.      (line  9000)
+* footer style:                          \pagestyle.        (line  9822)
 * footer, parameters for:                Page layout parameters.
-                                                            (line  1678)
-* footnote number, cross referencing:    \ref.              (line  2784)
-* footnote parameters:                   \footnote.         (line  6185)
+                                                            (line  1679)
+* footnote number, cross referencing:    \ref.              (line  2785)
+* footnote parameters:                   \footnote.         (line  6186)
 * footnote, in a table:                  Footnotes in a table.
-                                                            (line  6314)
+                                                            (line  6315)
 * footnote, in section headings:         Footnotes in section headings.
-                                                            (line  6295)
+                                                            (line  6296)
 * footnote, of a footnote:               Footnotes of footnotes.
-                                                            (line  6384)
-* footnotes in figures:                  minipage.          (line  4104)
-* footnotes, creating:                   Footnotes.         (line  6138)
-* Footnotes, in a minipage:              \footnote.         (line  6213)
-* footnotes, symbols instead of numbers: \footnote.         (line  6175)
-* formulas, environment for:             equation.          (line  3306)
-* formulas, math:                        Math formulas.     (line  7897)
-* forward reference:                     Cross references.  (line  2683)
-* forward references, resolving:         Output files.      (line   463)
-* fraction:                              \frac.             (line  9533)
-* fragile commands:                      \protect.          (line  7039)
-* frame rule width:                      \fbox & \framebox. (line 10838)
-* frame, line width:                     \fbox & \framebox. (line 10838)
-* frame, separation from contents:       \fbox & \framebox. (line 10843)
-* French quotation marks:                Text symbols.      (line 12208)
-* functions, math:                       Math functions.    (line  9112)
+                                                            (line  6385)
+* footnotes in figures:                  minipage.          (line  4105)
+* footnotes, creating:                   Footnotes.         (line  6139)
+* Footnotes, in a minipage:              \footnote.         (line  6214)
+* footnotes, symbols instead of numbers: \footnote.         (line  6176)
+* formulas, environment for:             equation.          (line  3307)
+* formulas, math:                        Math formulas.     (line  7898)
+* forward reference:                     Cross references.  (line  2684)
+* forward references, resolving:         Output files.      (line   464)
+* fraction:                              \frac.             (line  9534)
+* fragile commands:                      \protect.          (line  7040)
+* frame rule width:                      \fbox & \framebox. (line 10839)
+* frame, line width:                     \fbox & \framebox. (line 10839)
+* frame, separation from contents:       \fbox & \framebox. (line 10844)
+* French quotation marks:                Text symbols.      (line 12209)
+* functions, math:                       Math functions.    (line  9113)
 * geometry package:                      Document class options.
-                                                            (line   703)
+                                                            (line   704)
 * geometry package <1>:                  Document class options.
-                                                            (line   707)
+                                                            (line   708)
 * global options:                        Document class options.
-                                                            (line   669)
+                                                            (line   670)
 * global options <1>:                    Additional packages.
-                                                            (line   777)
-* glossaries:                            Glossaries.        (line 13412)
-* glossary:                              Glossaries.        (line 13412)
-* glossary, entries:                     \newglossaryentry. (line 13460)
-* glossary, entry reference:             \gls.              (line 13519)
-* glue register, plain TeX:              \newlength.        (line  6711)
-* graphics:                              Graphics.          (line 11344)
+                                                            (line   778)
+* glossaries:                            Glossaries.        (line 13413)
+* glossary:                              Glossaries.        (line 13413)
+* glossary, entries:                     \newglossaryentry. (line 13461)
+* glossary, entry reference:             \gls.              (line 13520)
+* glue register, plain TeX:              \newlength.        (line  6712)
+* graphics:                              Graphics.          (line 11345)
 * graphics <1>:                          Graphics package configuration.
-                                                            (line 11445)
-* graphics <2>:                          \includegraphics.  (line 11638)
-* graphics package:                      Graphics.          (line 11344)
+                                                            (line 11446)
+* graphics <2>:                          \includegraphics.  (line 11639)
+* graphics package:                      Graphics.          (line 11345)
 * graphics package <1>:                  Graphics package configuration.
-                                                            (line 11445)
-* graphics package <2>:                  \includegraphics.  (line 11638)
+                                                            (line 11446)
+* graphics package <2>:                  \includegraphics.  (line 11639)
 * graphics package commands:             Commands for graphics.
-                                                            (line 11632)
+                                                            (line 11633)
 * graphics package options:              Graphics package options.
-                                                            (line 11381)
-* graphics packages:                     \line.             (line  4408)
-* graphics, resizing:                    \scalebox.         (line 12028)
-* graphics, resizing <1>:                \resizebox.        (line 12059)
-* graphics, scaling:                     \scalebox.         (line 12028)
-* graphics, scaling <1>:                 \resizebox.        (line 12059)
-* grave accent:                          Accents.           (line 12408)
-* grave accent, math:                    Math accents.      (line  9251)
-* greater than symbol, in text:          Text symbols.      (line 12311)
-* greek letters:                         Math symbols.      (line  8051)
-* group, and environments:               Environments.      (line  2825)
-* group_skip:                            makeindex.         (line 13292)
-* ha'c<ek accent, math:                  Math accents.      (line  9242)
-* hacek accent:                          Accents.           (line 12455)
-* Halmos symbol:                         \rule.             (line 12568)
-* hat accent:                            Accents.           (line 12404)
-* hat accent, math:                      Math accents.      (line  9254)
-* header style:                          \pagestyle.        (line  9821)
+                                                            (line 11382)
+* graphics packages:                     \line.             (line  4409)
+* graphics, resizing:                    \scalebox.         (line 12029)
+* graphics, resizing <1>:                \resizebox.        (line 12060)
+* graphics, scaling:                     \scalebox.         (line 12029)
+* graphics, scaling <1>:                 \resizebox.        (line 12060)
+* grave accent:                          Accents.           (line 12409)
+* grave accent, math:                    Math accents.      (line  9252)
+* greater than symbol, in text:          Text symbols.      (line 12312)
+* greek letters:                         Math symbols.      (line  8052)
+* group, and environments:               Environments.      (line  2826)
+* group_skip:                            makeindex.         (line 13293)
+* ha'c<ek accent, math:                  Math accents.      (line  9243)
+* hacek accent:                          Accents.           (line 12456)
+* Halmos symbol:                         \rule.             (line 12569)
+* hat accent:                            Accents.           (line 12405)
+* hat accent, math:                      Math accents.      (line  9255)
+* header style:                          \pagestyle.        (line  9822)
 * header, parameters for:                Page layout parameters.
-                                                            (line  1678)
+                                                            (line  1679)
 * hello, world:                          Starting and ending.
-                                                            (line   404)
-* here, putting floats:                  Floats.            (line  1857)
+                                                            (line   405)
+* here, putting floats:                  Floats.            (line  1858)
 * home page for manual:                  About this document.
-                                                            (line   326)
-* horizontal space:                      \hss.              (line 10051)
-* horizontal space, stretchable:         \hss.              (line 10051)
+                                                            (line   327)
+* horizontal space:                      \hss.              (line 10052)
+* horizontal space, stretchable:         \hss.              (line 10052)
 * horizontal spacing:                    \phantom & \vphantom & \hphantom.
-                                                            (line  9440)
-* hungarian umlaut accent:               Accents.           (line 12433)
-* hyperref package:                      \footnotemark.     (line  6265)
-* hyperref package <1>:                  \footnotemark.     (line  6274)
-* hyperref package <2>:                  \pagenumbering.    (line  9802)
+                                                            (line  9441)
+* hungarian umlaut accent:               Accents.           (line 12434)
+* hyperref package:                      \footnotemark.     (line  6266)
+* hyperref package <1>:                  \footnotemark.     (line  6275)
+* hyperref package <2>:                  \pagenumbering.    (line  9803)
 * hyperref package <3>:                  Command line input.
-                                                            (line 14295)
-* hyphenation, defining:                 \hyphenation.      (line  5918)
-* hyphenation, discretionary:            \discretionary.    (line  5854)
-* hyphenation, forcing:                  \- (hyphenation).  (line  5819)
-* hyphenation, preventing:               \mbox & \makebox.  (line 10716)
+                                                            (line 14358)
+* hyphenation, defining:                 \hyphenation.      (line  5919)
+* hyphenation, discretionary:            \discretionary.    (line  5855)
+* hyphenation, forcing:                  \- (hyphenation).  (line  5820)
+* hyphenation, preventing:               \mbox & \makebox.  (line 10717)
 * Icelandic eth:                         Additional Latin letters.
-                                                            (line 12518)
+                                                            (line 12519)
 * Icelandic thorn:                       Additional Latin letters.
-                                                            (line 12554)
-* idx file:                              \index.            (line 13226)
+                                                            (line 12555)
+* idx file:                              \index.            (line 13227)
 * ij letter, Dutch:                      Additional Latin letters.
-                                                            (line 12530)
-* implementations of TeX:                TeX engines.       (line   482)
-* importing graphics:                    \includegraphics.  (line 11638)
-* in:                                    Units of length.   (line  7507)
-* in-line formulas:                      math.              (line  3991)
-* inch:                                  Units of length.   (line  7507)
-* including graphics:                    \includegraphics.  (line 11638)
+                                                            (line 12531)
+* implementations of TeX:                TeX engines.       (line   483)
+* importing graphics:                    \includegraphics.  (line 11639)
+* in:                                    Units of length.   (line  7508)
+* in-line formulas:                      math.              (line  3992)
+* inch:                                  Units of length.   (line  7508)
+* including graphics:                    \includegraphics.  (line 11639)
 * indent, forcing:                       \indent & \noindent.
-                                                            (line  7772)
-* indentation of paragraphs, in minipage: minipage.         (line  4100)
-* indentfirst package:                   \part.             (line  2090)
-* indentfirst package <1>:               \chapter.          (line  2152)
-* indentfirst package <2>:               \section.          (line  2247)
-* indentfirst package <3>:               \subsection.       (line  2313)
+                                                            (line  7773)
+* indentation of paragraphs, in minipage: minipage.         (line  4101)
+* indentfirst package:                   \part.             (line  2091)
+* indentfirst package <1>:               \chapter.          (line  2153)
+* indentfirst package <2>:               \section.          (line  2248)
+* indentfirst package <3>:               \subsection.       (line  2314)
 * indentfirst package <4>:               \subsubsection & \paragraph & \subparagraph.
-                                                            (line  2390)
+                                                            (line  2391)
 * indentfirst package <5>:               \indent & \noindent.
-                                                            (line  7814)
-* indent_length:                         makeindex.         (line 13373)
-* indent_space:                          makeindex.         (line 13369)
-* index entries, 'see' and 'see also':   \index.            (line 13176)
-* index entry:                           \index.            (line 13126)
-* index package:                         \index.            (line 13221)
-* index, page range:                     \index.            (line 13160)
-* index, printing:                       \printindex.       (line 13397)
-* index, processing:                     makeindex.         (line 13241)
-* index, style file:                     makeindex.         (line 13253)
-* indexes:                               Indexes.           (line 13090)
-* infinite horizontal stretch:           \hfill.            (line 10018)
-* infinite vertical stretch:             \vfill.            (line 10631)
-* inner paragraph mode:                  Modes.             (line  9647)
+                                                            (line  7815)
+* indent_length:                         makeindex.         (line 13374)
+* indent_space:                          makeindex.         (line 13370)
+* index entries, 'see' and 'see also':   \index.            (line 13177)
+* index entry:                           \index.            (line 13127)
+* index package:                         \index.            (line 13222)
+* index, page range:                     \index.            (line 13161)
+* index, printing:                       \printindex.       (line 13398)
+* index, processing:                     makeindex.         (line 13242)
+* index, style file:                     makeindex.         (line 13254)
+* indexes:                               Indexes.           (line 13091)
+* infinite horizontal stretch:           \hfill.            (line 10019)
+* infinite vertical stretch:             \vfill.            (line 10632)
+* inner paragraph mode:                  Modes.             (line  9648)
 * input file:                            Splitting the input.
-                                                            (line 12627)
+                                                            (line 12628)
 * input, on command line:                Command line input.
-                                                            (line 14291)
-* input/output, to terminal:             Input/output.      (line 13846)
-* inserting figures:                     figure.            (line  3326)
+                                                            (line 14354)
+* input/output:                          Input/output.      (line 13847)
+* input/output, to terminal:             Input/output.      (line 13847)
+* inserting figures:                     figure.            (line  3327)
 * insertions of special characters:      Special insertions.
-                                                            (line 12088)
-* internal vertical mode:                Modes.             (line  9638)
+                                                            (line 12089)
+* internal vertical mode:                Modes.             (line  9639)
 * invisible character:                   \phantom & \vphantom & \hphantom.
-                                                            (line  9440)
-* italic correction:                     \/.                (line 10335)
-* italic font:                           Font styles.       (line  1280)
-* itemize environment:                   itemize.           (line  3539)
-* item_0:                                makeindex.         (line 13316)
-* item_01:                               makeindex.         (line 13325)
-* item_1:                                makeindex.         (line 13319)
-* item_12:                               makeindex.         (line 13335)
-* item_2:                                makeindex.         (line 13322)
-* item_x1:                               makeindex.         (line 13329)
-* item_x2:                               makeindex.         (line 13339)
+                                                            (line  9441)
+* italic correction:                     \/.                (line 10336)
+* italic font:                           Font styles.       (line  1281)
+* itemize environment:                   itemize.           (line  3540)
+* item_0:                                makeindex.         (line 13317)
+* item_01:                               makeindex.         (line 13326)
+* item_1:                                makeindex.         (line 13320)
+* item_12:                               makeindex.         (line 13336)
+* item_2:                                makeindex.         (line 13323)
+* item_x1:                               makeindex.         (line 13330)
+* item_x2:                               makeindex.         (line 13340)
 * JPEG files:                            Graphics package configuration.
-                                                            (line 11445)
-* JPEG files <1>:                        \includegraphics.  (line 11638)
+                                                            (line 11446)
+* JPEG files <1>:                        \includegraphics.  (line 11639)
 * JPG files:                             Graphics package configuration.
-                                                            (line 11445)
-* JPG files <1>:                         \includegraphics.  (line 11638)
-* justification, ragged left:            \raggedleft.       (line  3514)
-* justification, ragged right:           \raggedright.      (line  3463)
-* Knuth, Donald E.:                      Overview.          (line   378)
-* label:                                 Cross references.  (line  2662)
-* labelled lists, creating:              description.       (line  3045)
-* Lamport TeX:                           Overview.          (line   396)
-* Lamport, Leslie:                       Overview.          (line   378)
+                                                            (line 11446)
+* JPG files <1>:                         \includegraphics.  (line 11639)
+* justification, ragged left:            \raggedleft.       (line  3515)
+* justification, ragged right:           \raggedright.      (line  3464)
+* Knuth, Donald E.:                      Overview.          (line   379)
+* label:                                 Cross references.  (line  2663)
+* labelled lists, creating:              description.       (line  3046)
+* Lamport TeX:                           Overview.          (line   397)
+* Lamport, Leslie:                       Overview.          (line   379)
 * landscape option:                      Document class options.
-                                                            (line   712)
+                                                            (line   713)
 * landscape orientation:                 Document class options.
-                                                            (line   723)
-* latex command:                         Output files.      (line   440)
-* LaTeX logo:                            Text symbols.      (line 12199)
-* LaTeX overview:                        Overview.          (line   378)
+                                                            (line   724)
+* latex command:                         Output files.      (line   441)
+* LaTeX logo:                            Text symbols.      (line 12200)
+* LaTeX overview:                        Overview.          (line   379)
 * LaTeX Project team:                    About this document.
-                                                            (line   345)
+                                                            (line   346)
 * LaTeX vs. LaTeX2e:                     About this document.
-                                                            (line   341)
+                                                            (line   342)
 * latex-doc-ptr document:                About this document.
-                                                            (line   358)
-* LaTeX2e logo:                          Text symbols.      (line 12202)
+                                                            (line   359)
+* LaTeX2e logo:                          Text symbols.      (line 12203)
 * <latexrefman at tug.org> email address:   About this document.
-                                                            (line   345)
+                                                            (line   346)
 * Latin letters, additional:             Additional Latin letters.
-                                                            (line 12504)
-* layout commands:                       Layout.            (line  1522)
+                                                            (line 12505)
+* layout commands:                       Layout.            (line  1523)
 * layout, page parameters for:           Page layout parameters.
-                                                            (line  1678)
-* left angle quotation marks:            Text symbols.      (line 12208)
-* left arrow, in text:                   Text symbols.      (line 12317)
-* left brace, in text:                   Text symbols.      (line 12264)
-* left quote:                            Text symbols.      (line 12218)
-* left quote, double:                    Text symbols.      (line 12330)
-* left quote, single:                    Text symbols.      (line 12336)
+                                                            (line  1679)
+* left angle quotation marks:            Text symbols.      (line 12209)
+* left arrow, in text:                   Text symbols.      (line 12318)
+* left brace, in text:                   Text symbols.      (line 12265)
+* left quote:                            Text symbols.      (line 12219)
+* left quote, double:                    Text symbols.      (line 12331)
+* left quote, single:                    Text symbols.      (line 12337)
 * left-hand equation numbers:            Document class options.
-                                                            (line   726)
-* left-justifying text:                  \raggedright.      (line  3463)
-* left-justifying text, environment for: flushleft.         (line  3435)
-* left-to-right mode:                    Modes.             (line  9616)
+                                                            (line   727)
+* left-justifying text:                  \raggedright.      (line  3464)
+* left-justifying text, environment for: flushleft.         (line  3436)
+* left-to-right mode:                    Modes.             (line  9617)
 * legalpaper option:                     Document class options.
-                                                            (line   682)
-* lengths, adding to:                    \addtolength.      (line  7574)
-* lengths, allocating new:               \newlength.        (line  6711)
-* lengths, defining and using:           Lengths.           (line  7396)
-* lengths, setting:                      \setlength.        (line  7546)
+                                                            (line   683)
+* lengths, adding to:                    \addtolength.      (line  7575)
+* lengths, allocating new:               \newlength.        (line  6712)
+* lengths, defining and using:           Lengths.           (line  7397)
+* lengths, setting:                      \setlength.        (line  7547)
 * leqno option:                          Document class options.
-                                                            (line   712)
-* less than symbol, in text:             Text symbols.      (line 12314)
-* lethead_flag:                          makeindex.         (line 13299)
-* lethead_prefix:                        makeindex.         (line 13308)
-* lethead_suffix:                        makeindex.         (line 13312)
-* letter class:                          Document classes.  (line   640)
-* letter environment:                    letter.            (line  3622)
+                                                            (line   713)
+* less than symbol, in text:             Text symbols.      (line 12315)
+* lethead_flag:                          makeindex.         (line 13300)
+* lethead_prefix:                        makeindex.         (line 13309)
+* lethead_suffix:                        makeindex.         (line 13313)
+* letter class:                          Document classes.  (line   641)
+* letter environment:                    letter.            (line  3623)
 * letterpaper option:                    Document class options.
-                                                            (line   682)
-* letters, accented:                     Accents.           (line 12372)
+                                                            (line   683)
+* letters, accented:                     Accents.           (line 12373)
 * letters, additional Latin:             Additional Latin letters.
-                                                            (line 12504)
-* letters, ending:                       \closing.          (line 13670)
-* letters, starting:                     \opening.          (line 13775)
-* letters, writing:                      Letters.           (line 13549)
-* line break, forcing:                   \\.                (line  5693)
-* line breaking:                         Line breaking.     (line  5676)
-* line breaks, changing:                 \fussy & \sloppy.  (line  5877)
+                                                            (line 12505)
+* letters, ending:                       \closing.          (line 13671)
+* letters, starting:                     \opening.          (line 13776)
+* letters, writing:                      Letters.           (line 13550)
+* line break, forcing:                   \\.                (line  5694)
+* line breaking:                         Line breaking.     (line  5677)
+* line breaks, changing:                 \fussy & \sloppy.  (line  5878)
 * line breaks, forcing:                  \linebreak & \nolinebreak.
-                                                            (line  5936)
-* line breaks, multiplication discretionary: \*.            (line  9517)
+                                                            (line  5937)
+* line breaks, multiplication discretionary: \*.            (line  9518)
 * line breaks, preventing:               \linebreak & \nolinebreak.
-                                                            (line  5936)
-* lines in tables:                       tabular.           (line  4925)
-* line_max:                              makeindex.         (line 13365)
-* lining numerals:                       Font styles.       (line  1331)
-* lining text up in tables:              tabular.           (line  4925)
-* lining text up using tab stops:        tabbing.           (line  4716)
-* list environment:                      list.              (line  3627)
-* list items, specifying counter:        \usecounter.       (line  7250)
-* list of figures file:                  Output files.      (line   473)
-* list of tables file:                   Output files.      (line   473)
-* listings package:                      tabbing.           (line  4856)
-* listings package <1>:                  verbatim.          (line  5579)
-* listings package <2>:                  \verb.             (line  5629)
-* lists of items:                        itemize.           (line  3539)
-* lists of items, generic:               list.              (line  3627)
-* lists of items, numbered:              enumerate.         (line  3183)
+                                                            (line  5937)
+* lines in tables:                       tabular.           (line  4926)
+* line_max:                              makeindex.         (line 13366)
+* lining numerals:                       Font styles.       (line  1332)
+* lining text up in tables:              tabular.           (line  4926)
+* lining text up using tab stops:        tabbing.           (line  4717)
+* list environment:                      list.              (line  3628)
+* list items, specifying counter:        \usecounter.       (line  7251)
+* list of figures file:                  Output files.      (line   474)
+* list of tables file:                   Output files.      (line   474)
+* listings package:                      tabbing.           (line  4857)
+* listings package <1>:                  verbatim.          (line  5580)
+* listings package <2>:                  \verb.             (line  5630)
+* lists of items:                        itemize.           (line  3540)
+* lists of items, generic:               list.              (line  3628)
+* lists of items, numbered:              enumerate.         (line  3184)
 * loading additional packages:           Additional packages.
-                                                            (line   768)
-* log file:                              Output files.      (line   458)
-* logo, LaTeX:                           Text symbols.      (line 12199)
-* logo, LaTeX2e:                         Text symbols.      (line 12202)
-* logo, TeX:                             Text symbols.      (line 12240)
+                                                            (line   769)
+* log file:                              Output files.      (line   459)
+* logo, LaTeX:                           Text symbols.      (line 12200)
+* logo, LaTeX2e:                         Text symbols.      (line 12203)
+* logo, TeX:                             Text symbols.      (line 12241)
 * long command:                          Class and package commands.
-                                                            (line   871)
-* low-9 quotation marks, single and double: Text symbols.   (line 12230)
+                                                            (line   872)
+* low-9 quotation marks, single and double: Text symbols.   (line 12231)
 * low-level font commands:               Low-level font commands.
-                                                            (line  1380)
+                                                            (line  1381)
 * lowercase:                             Upper and lower case.
-                                                            (line 12126)
-* LR box:                                picture.           (line  4251)
-* LR mode:                               Modes.             (line  9616)
-* lrbox:                                 lrbox.             (line 11048)
+                                                            (line 12127)
+* LR box:                                picture.           (line  4252)
+* LR mode:                               Modes.             (line  9617)
+* lrbox:                                 lrbox.             (line 11049)
 * lshort document:                       About this document.
-                                                            (line   369)
-* ltugboat class:                        tugboat template.  (line 14505)
-* lualatex command:                      TeX engines.       (line   506)
-* LuaTeX:                                TeX engines.       (line   506)
-* m-width:                               Units of length.   (line  7528)
-* macro package, LaTeX as:               Overview.          (line   383)
-* macron accent:                         Accents.           (line 12400)
-* macron accent, math:                   Math accents.      (line  9236)
+                                                            (line   370)
+* ltugboat class:                        tugboat template.  (line 14568)
+* lualatex command:                      TeX engines.       (line   507)
+* LuaTeX:                                TeX engines.       (line   507)
+* m-width:                               Units of length.   (line  7529)
+* macro package, LaTeX as:               Overview.          (line   384)
+* macron accent:                         Accents.           (line 12401)
+* macron accent, math:                   Math accents.      (line  9237)
 * macros2e package:                      \makeatletter & \makeatother.
-                                                            (line  6595)
-* Madsen, Lars:                          eqnarray.          (line  3250)
-* make a box:                            \mbox & \makebox.  (line 10716)
-* makeindex:                             makeindex.         (line 13241)
-* makeindex program:                     makeindex.         (line 13241)
-* makeindex, style file:                 makeindex.         (line 13253)
-* making a title page:                   titlepage.         (line  5515)
-* making paragraphs:                     Making paragraphs. (line  7675)
-* marginal notes:                        Marginal notes.    (line  7848)
-* masculine ordinal symbol:              Text symbols.      (line 12321)
-* matching brackets:                     \left & \right.    (line  9545)
-* matching parentheses:                  \left & \right.    (line  9545)
-* math accents:                          Math accents.      (line  9228)
-* math environment:                      math.              (line  3991)
-* math environment <1>:                  Math formulas.     (line  7897)
-* math formulas:                         Math formulas.     (line  7897)
-* math functions:                        Math functions.    (line  9112)
-* math miscellany:                       Math miscellany.   (line  9491)
-* math mode:                             Modes.             (line  9626)
-* math mode, entering:                   Math formulas.     (line  7897)
+                                                            (line  6596)
+* Madsen, Lars:                          eqnarray.          (line  3251)
+* make a box:                            \mbox & \makebox.  (line 10717)
+* makeindex:                             makeindex.         (line 13242)
+* makeindex program:                     makeindex.         (line 13242)
+* makeindex, style file:                 makeindex.         (line 13254)
+* making a title page:                   titlepage.         (line  5516)
+* making paragraphs:                     Making paragraphs. (line  7676)
+* marginal notes:                        Marginal notes.    (line  7849)
+* masculine ordinal symbol:              Text symbols.      (line 12322)
+* matching brackets:                     \left & \right.    (line  9546)
+* matching parentheses:                  \left & \right.    (line  9546)
+* math accents:                          Math accents.      (line  9229)
+* math environment:                      math.              (line  3992)
+* math environment <1>:                  Math formulas.     (line  7898)
+* math formulas:                         Math formulas.     (line  7898)
+* math functions:                        Math functions.    (line  9113)
+* math miscellany:                       Math miscellany.   (line  9492)
+* math mode:                             Modes.             (line  9627)
+* math mode, entering:                   Math formulas.     (line  7898)
 * math mode, spacing:                    Spacing in math mode.
-                                                            (line  9322)
+                                                            (line  9323)
 * math mode, spacing <1>:                \phantom & \vphantom & \hphantom.
-                                                            (line  9440)
-* math mode, vertical space:             \smash.            (line  9379)
-* math symbols:                          Math symbols.      (line  8051)
-* math, bold:                            Font styles.       (line  1327)
-* mathtools package:                     Math formulas.     (line  7977)
+                                                            (line  9441)
+* math mode, vertical space:             \smash.            (line  9380)
+* math symbols:                          Math symbols.      (line  8052)
+* math, bold:                            Font styles.       (line  1328)
+* mathtools package:                     Math formulas.     (line  7978)
 * mathtools package <1>:                 Over- and Underlining.
-                                                            (line  9316)
-* mathtools package <2>:                 \smash.            (line  9434)
+                                                            (line  9317)
+* mathtools package <2>:                 \smash.            (line  9435)
 * mathtools package <3>:                 \phantom & \vphantom & \hphantom.
-                                                            (line  9470)
-* MetaPost package:                      \line.             (line  4408)
+                                                            (line  9471)
+* MetaPost package:                      \line.             (line  4409)
 * mfirstuc package:                      Upper and lower case.
-                                                            (line 12165)
+                                                            (line 12166)
 * mhchem package:                        Subscripts & superscripts.
-                                                            (line  8044)
-* Millimeter:                            Units of length.   (line  7517)
-* minipage environment:                  minipage.          (line  4003)
-* minipage, creating a:                  minipage.          (line  4003)
-* minted package:                        tabbing.           (line  4856)
-* minted package <1>:                    verbatim.          (line  5579)
-* minted package <2>:                    \verb.             (line  5629)
-* mirrors of CTAN:                       CTAN.              (line   623)
-* mm:                                    Units of length.   (line  7517)
-* modes:                                 Modes.             (line  9606)
-* monospace font:                        Font styles.       (line  1295)
-* moving arguments:                      \protect.          (line  7052)
-* mpfootnote counter:                    \footnote.         (line  6213)
-* mu:                                    Units of length.   (line  7539)
-* mu, math unit:                         Units of length.   (line  7539)
-* multicolumn text:                      \twocolumn.        (line  1539)
-* multilingual support:                  Accents.           (line 12372)
-* multind package:                       Indexes.           (line 13116)
-* multiplication, discretionary:         \*.                (line  9517)
-* name:                                  \newglossaryentry. (line 13497)
-* NBSP:                                  ~.                 (line 10255)
+                                                            (line  8045)
+* Millimeter:                            Units of length.   (line  7518)
+* minipage environment:                  minipage.          (line  4004)
+* minipage, creating a:                  minipage.          (line  4004)
+* minted package:                        tabbing.           (line  4857)
+* minted package <1>:                    verbatim.          (line  5580)
+* minted package <2>:                    \verb.             (line  5630)
+* mirrors of CTAN:                       CTAN.              (line   624)
+* mm:                                    Units of length.   (line  7518)
+* modes:                                 Modes.             (line  9607)
+* monospace font:                        Font styles.       (line  1296)
+* moving arguments:                      \protect.          (line  7053)
+* mpfootnote counter:                    \footnote.         (line  6214)
+* mu:                                    Units of length.   (line  7540)
+* mu, math unit:                         Units of length.   (line  7540)
+* multicolumn text:                      \twocolumn.        (line  1540)
+* multilingual support:                  Accents.           (line 12373)
+* multind package:                       Indexes.           (line 13117)
+* multiplication, discretionary:         \*.                (line  9518)
+* name:                                  \newglossaryentry. (line 13498)
+* NBSP:                                  ~.                 (line 10256)
 * nested \include, not allowed:          \include & \includeonly.
-                                                            (line 12799)
+                                                            (line 12800)
 * new class commands:                    Class and package construction.
-                                                            (line   784)
+                                                            (line   785)
 * new command, check:                    Class and package commands.
-                                                            (line   869)
+                                                            (line   870)
 * new command, definition:               Class and package commands.
-                                                            (line   944)
+                                                            (line   945)
 * new commands, defining:                \newcommand & \renewcommand.
-                                                            (line  6405)
-* new commands, defining <1>:            \providecommand.   (line  6530)
+                                                            (line  6406)
+* new commands, defining <1>:            \providecommand.   (line  6531)
 * new line, output as input:             \obeycr & \restorecr.
-                                                            (line  5755)
-* new line, starting:                    \\.                (line  5693)
-* new line, starting (paragraph mode):   \newline.          (line  5795)
-* new page, starting:                    \newpage.          (line  6039)
+                                                            (line  5756)
+* new line, starting:                    \\.                (line  5694)
+* new line, starting (paragraph mode):   \newline.          (line  5796)
+* new page, starting:                    \newpage.          (line  6040)
 * non-English characters:                Additional Latin letters.
-                                                            (line 12504)
-* notes in the margin:                   Marginal notes.    (line  7848)
+                                                            (line 12505)
+* notes in the margin:                   Marginal notes.    (line  7849)
 * notitlepage option:                    Document class options.
-                                                            (line   712)
-* null delimiter:                        \left & \right.    (line  9545)
-* numbered items, specifying counter:    \usecounter.       (line  7250)
-* numerals, old-style:                   Font styles.       (line  1331)
-* oblique font:                          Font styles.       (line  1292)
+                                                            (line   713)
+* null delimiter:                        \left & \right.    (line  9546)
+* numbered items, specifying counter:    \usecounter.       (line  7251)
+* numerals, old-style:                   Font styles.       (line  1332)
+* oblique font:                          Font styles.       (line  1293)
 * oe ligature:                           Additional Latin letters.
-                                                            (line 12546)
-* ogonek:                                Accents.           (line 12437)
-* old-style numerals:                    Font styles.       (line  1331)
-* one-column output:                     \onecolumn.        (line  1527)
+                                                            (line 12547)
+* ogonek:                                Accents.           (line 12438)
+* old-style numerals:                    Font styles.       (line  1332)
+* one-column output:                     \onecolumn.        (line  1528)
 * onecolumn option:                      Document class options.
-                                                            (line   741)
+                                                            (line   742)
 * oneside option:                        Document class options.
-                                                            (line   741)
+                                                            (line   742)
+* open a file:                           \openin & \openout.
+                                                            (line 13856)
 * openany option:                        Document class options.
-                                                            (line   741)
+                                                            (line   742)
 * openbib option:                        Document class options.
-                                                            (line   712)
-* opening quote:                         Text symbols.      (line 12218)
+                                                            (line   713)
+* opening quote:                         Text symbols.      (line 12219)
 * openright option:                      Document class options.
-                                                            (line   741)
-* OpenType fonts:                        TeX engines.       (line   482)
+                                                            (line   742)
+* OpenType fonts:                        TeX engines.       (line   483)
 * options, class:                        Class and package commands.
-                                                            (line   914)
+                                                            (line   915)
 * options, color package:                Color package options.
-                                                            (line 11103)
+                                                            (line 11104)
 * options, command line:                 Command line options.
-                                                            (line 14208)
+                                                            (line 14271)
 * options, document class:               Document class options.
-                                                            (line   669)
+                                                            (line   670)
 * options, document class <1>:           Class and package structure.
-                                                            (line   807)
+                                                            (line   808)
 * options, global:                       Additional packages.
-                                                            (line   777)
+                                                            (line   778)
 * options, graphics package:             Graphics package options.
-                                                            (line 11381)
+                                                            (line 11382)
 * options, package:                      Class and package structure.
-                                                            (line   807)
+                                                            (line   808)
 * options, package <1>:                  Class and package commands.
-                                                            (line   914)
-* ordinals, feminine and masculine:      Text symbols.      (line 12321)
+                                                            (line   915)
+* ordinals, feminine and masculine:      Text symbols.      (line 12322)
 * oslash:                                Additional Latin letters.
-                                                            (line 12542)
-* outer paragraph mode:                  Modes.             (line  9647)
-* overbar accent:                        Accents.           (line 12400)
-* overdot accent, math:                  Math accents.      (line  9248)
+                                                            (line 12543)
+* outer paragraph mode:                  Modes.             (line  9648)
+* overbar accent:                        Accents.           (line 12401)
+* overdot accent, math:                  Math accents.      (line  9249)
 * overlining:                            Over- and Underlining.
-                                                            (line  9277)
-* overview of LaTeX:                     Overview.          (line   378)
+                                                            (line  9278)
+* overview of LaTeX:                     Overview.          (line   379)
 * package file layout:                   Class and package structure.
-                                                            (line   807)
+                                                            (line   808)
 * package options:                       Class and package structure.
-                                                            (line   807)
+                                                            (line   808)
 * package options <1>:                   Class and package commands.
-                                                            (line   914)
-* package, algorithm2e:                  tabbing.           (line  4856)
-* package, amsfonts:                     Math formulas.     (line  7977)
-* package, amsmath:                      array.             (line  2925)
-* package, amsmath <1>:                  array.             (line  2936)
-* package, amsmath <2>:                  displaymath.       (line  3117)
-* package, amsmath <3>:                  equation.          (line  3320)
-* package, amsmath <4>:                  theorem.           (line  5507)
-* package, amsmath <5>:                  Math formulas.     (line  7977)
-* package, amsmath <6>:                  Dots.              (line  9088)
-* package, amsmath <7>:                  Math functions.    (line  9217)
+                                                            (line   915)
+* package, algorithm2e:                  tabbing.           (line  4857)
+* package, amsfonts:                     Math formulas.     (line  7978)
+* package, amsmath:                      array.             (line  2926)
+* package, amsmath <1>:                  array.             (line  2937)
+* package, amsmath <2>:                  displaymath.       (line  3118)
+* package, amsmath <3>:                  equation.          (line  3321)
+* package, amsmath <4>:                  theorem.           (line  5508)
+* package, amsmath <5>:                  Math formulas.     (line  7978)
+* package, amsmath <6>:                  Dots.              (line  9089)
+* package, amsmath <7>:                  Math functions.    (line  9218)
 * package, amsmath <8>:                  \phantom & \vphantom & \hphantom.
-                                                            (line  9478)
+                                                            (line  9479)
 * package, amsmath <9>:                  Colon character & \colon.
-                                                            (line  9506)
+                                                            (line  9507)
 * package, amsmath <10>:                 Colon character & \colon.
-                                                            (line  9510)
-* package, amsthm:                       theorem.           (line  5507)
-* package, amsthm <1>:                   \rule.             (line 12573)
-* package, answers:                      \write.            (line 14034)
-* package, appendix:                     \appendix.         (line  2425)
-* package, array (package):              array.             (line  2947)
-* package, Asymptote:                    \line.             (line  4408)
-* package, Asymptote <1>:                \strut.            (line 10551)
-* package, Asymptote <2>:                \mbox & \makebox.  (line 10783)
-* package, Asymptote <3>:                \write.            (line 13934)
-* package, Asymptote <4>:                \write18.          (line 14110)
-* package, babel:                        \chapter.          (line  2165)
-* package, babel <1>:                    thebibliography.   (line  5297)
-* package, babel <2>:                    Accents.           (line 12372)
-* package, babel <3>:                    \today.            (line 12603)
+                                                            (line  9511)
+* package, amsthm:                       theorem.           (line  5508)
+* package, amsthm <1>:                   \rule.             (line 12574)
+* package, answers:                      \write.            (line 14096)
+* package, appendix:                     \appendix.         (line  2426)
+* package, array (package):              array.             (line  2948)
+* package, Asymptote:                    \line.             (line  4409)
+* package, Asymptote <1>:                \strut.            (line 10552)
+* package, Asymptote <2>:                \mbox & \makebox.  (line 10784)
+* package, Asymptote <3>:                \write18.          (line 14173)
+* package, babel:                        \chapter.          (line  2166)
+* package, babel <1>:                    thebibliography.   (line  5298)
+* package, babel <2>:                    Accents.           (line 12373)
+* package, babel <3>:                    \today.            (line 12604)
 * package, babel <4>:                    Table of contents etc..
-                                                            (line 12930)
-* package, babel <5>:                    \index.            (line 13176)
+                                                            (line 12931)
+* package, babel <5>:                    \index.            (line 13177)
 * package, bigfoot:                      Footnotes of footnotes.
-                                                            (line  6384)
+                                                            (line  6385)
 * package, bm:                           \boldmath & \unboldmath.
-                                                            (line  9043)
-* package, cleveref:                     Cross references.  (line  2694)
-* package, cleveref <1>:                 \ref.              (line  2807)
-* package, cleveref <2>:                 \footnotemark.     (line  6265)
-* package, cprotect:                     verbatim.          (line  5574)
-* package, cprotect <1>:                 \verb.             (line  5632)
-* package, datetime:                     \today.            (line 12617)
-* package, dcolumn:                      array.             (line  2947)
-* package, enumitem:                     list.              (line  3891)
-* package, envlab:                       \makelabels.       (line 13757)
+                                                            (line  9044)
+* package, cleveref:                     Cross references.  (line  2695)
+* package, cleveref <1>:                 \ref.              (line  2808)
+* package, cleveref <2>:                 \footnotemark.     (line  6266)
+* package, cprotect:                     verbatim.          (line  5575)
+* package, cprotect <1>:                 \verb.             (line  5633)
+* package, datetime:                     \today.            (line 12618)
+* package, dcolumn:                      array.             (line  2948)
+* package, enumitem:                     list.              (line  3892)
+* package, envlab:                       \makelabels.       (line 13758)
 * package, etoolbox:                     Class and package commands.
-                                                            (line   958)
-* package, eurosym:                      Text symbols.      (line 12302)
-* package, fancyhdr:                     Page styles.       (line  9686)
-* package, fancyhdr <1>:                 \pagestyle.        (line  9828)
-* package, fancyvrb:                     tabbing.           (line  4856)
-* package, fancyvrb <1>:                 verbatim.          (line  5585)
-* package, flafter:                      Floats.            (line  1887)
-* package, float:                        Floats.            (line  1857)
+                                                            (line   959)
+* package, eurosym:                      Text symbols.      (line 12303)
+* package, fancyhdr:                     Page styles.       (line  9687)
+* package, fancyhdr <1>:                 \pagestyle.        (line  9829)
+* package, fancyvrb:                     tabbing.           (line  4857)
+* package, fancyvrb <1>:                 verbatim.          (line  5586)
+* package, flafter:                      Floats.            (line  1888)
+* package, float:                        Floats.            (line  1858)
 * package, geometry:                     Document class options.
-                                                            (line   703)
+                                                            (line   704)
 * package, geometry <1>:                 Document class options.
-                                                            (line   707)
-* package, hyperref:                     \footnotemark.     (line  6265)
-* package, hyperref <1>:                 \footnotemark.     (line  6274)
-* package, hyperref <2>:                 \pagenumbering.    (line  9802)
+                                                            (line   708)
+* package, hyperref:                     \footnotemark.     (line  6266)
+* package, hyperref <1>:                 \footnotemark.     (line  6275)
+* package, hyperref <2>:                 \pagenumbering.    (line  9803)
 * package, hyperref <3>:                 Command line input.
-                                                            (line 14295)
-* package, indentfirst:                  \part.             (line  2090)
-* package, indentfirst <1>:              \chapter.          (line  2152)
-* package, indentfirst <2>:              \section.          (line  2247)
-* package, indentfirst <3>:              \subsection.       (line  2313)
+                                                            (line 14358)
+* package, indentfirst:                  \part.             (line  2091)
+* package, indentfirst <1>:              \chapter.          (line  2153)
+* package, indentfirst <2>:              \section.          (line  2248)
+* package, indentfirst <3>:              \subsection.       (line  2314)
 * package, indentfirst <4>:              \subsubsection & \paragraph & \subparagraph.
-                                                            (line  2390)
+                                                            (line  2391)
 * package, indentfirst <5>:              \indent & \noindent.
-                                                            (line  7814)
-* package, index:                        \index.            (line 13221)
-* package, listings:                     tabbing.           (line  4856)
-* package, listings <1>:                 verbatim.          (line  5579)
-* package, listings <2>:                 \verb.             (line  5629)
+                                                            (line  7815)
+* package, index:                        \index.            (line 13222)
+* package, listings:                     tabbing.           (line  4857)
+* package, listings <1>:                 verbatim.          (line  5580)
+* package, listings <2>:                 \verb.             (line  5630)
 * package, macros2e:                     \makeatletter & \makeatother.
-                                                            (line  6595)
-* package, mathtools:                    Math formulas.     (line  7977)
+                                                            (line  6596)
+* package, mathtools:                    Math formulas.     (line  7978)
 * package, mathtools <1>:                Over- and Underlining.
-                                                            (line  9316)
-* package, mathtools <2>:                \smash.            (line  9434)
+                                                            (line  9317)
+* package, mathtools <2>:                \smash.            (line  9435)
 * package, mathtools <3>:                \phantom & \vphantom & \hphantom.
-                                                            (line  9470)
-* package, MetaPost:                     \line.             (line  4408)
+                                                            (line  9471)
+* package, MetaPost:                     \line.             (line  4409)
 * package, mfirstuc:                     Upper and lower case.
-                                                            (line 12165)
+                                                            (line 12166)
 * package, mhchem:                       Subscripts & superscripts.
-                                                            (line  8044)
-* package, minted:                       tabbing.           (line  4856)
-* package, minted <1>:                   verbatim.          (line  5579)
-* package, minted <2>:                   \verb.             (line  5629)
-* package, multind:                      Indexes.           (line 13116)
-* package, pict2e:                       \line.             (line  4408)
-* package, polyglossia:                  Accents.           (line 12372)
-* package, polyglossia <1>:              \today.            (line 12603)
+                                                            (line  8045)
+* package, minted:                       tabbing.           (line  4857)
+* package, minted <1>:                   verbatim.          (line  5580)
+* package, minted <2>:                   \verb.             (line  5630)
+* package, multind:                      Indexes.           (line 13117)
+* package, pict2e:                       \line.             (line  4409)
+* package, polyglossia:                  Accents.           (line 12373)
+* package, polyglossia <1>:              \today.            (line 12604)
 * package, polyglossia <2>:              Table of contents etc..
-                                                            (line 12930)
-* package, polyglossia <3>:              \index.            (line 13176)
-* package, PSTricks:                     \line.             (line  4408)
+                                                            (line 12931)
+* package, polyglossia <3>:              \index.            (line 13177)
+* package, PSTricks:                     \line.             (line  4409)
 * package, sagetex:                      Command line options.
-                                                            (line 14264)
+                                                            (line 14327)
 * package, setspace:                     Low-level font commands.
-                                                            (line  1492)
-* package, showidx:                      Indexes.           (line 13116)
-* package, siunitx:                      ~.                 (line 10281)
-* package, symbols:                      Math symbols.      (line  8051)
+                                                            (line  1493)
+* package, showidx:                      Indexes.           (line 13117)
+* package, siunitx:                      ~.                 (line 10282)
+* package, symbols:                      Math symbols.      (line  8052)
 * package, textcase:                     Upper and lower case.
-                                                            (line 12162)
-* package, textcomp:                     Font styles.       (line  1331)
-* package, TikZ:                         \line.             (line  4408)
-* package, TikZ <1>:                     \strut.            (line 10551)
-* package, TikZ <2>:                     \mbox & \makebox.  (line 10782)
-* package, titlesec:                     Sectioning.        (line  2015)
-* package, titlesec <1>:                 \part.             (line  2094)
-* package, titlesec <2>:                 \chapter.          (line  2173)
-* package, titlesec <3>:                 \section.          (line  2251)
-* package, titlesec <4>:                 \subsection.       (line  2317)
+                                                            (line 12163)
+* package, textcomp:                     Font styles.       (line  1332)
+* package, TikZ:                         \line.             (line  4409)
+* package, TikZ <1>:                     \strut.            (line 10552)
+* package, TikZ <2>:                     \mbox & \makebox.  (line 10783)
+* package, titlesec:                     Sectioning.        (line  2016)
+* package, titlesec <1>:                 \part.             (line  2095)
+* package, titlesec <2>:                 \chapter.          (line  2174)
+* package, titlesec <3>:                 \section.          (line  2252)
+* package, titlesec <4>:                 \subsection.       (line  2318)
 * package, titlesec <5>:                 \subsubsection & \paragraph & \subparagraph.
-                                                            (line  2394)
+                                                            (line  2395)
 * package, tocbibbind:                   Table of contents etc..
-                                                            (line 12941)
+                                                            (line 12942)
 * package, tocloft:                      Table of contents etc..
-                                                            (line 12941)
+                                                            (line 12942)
 * package, ulem:                         Over- and Underlining.
-                                                            (line  9286)
-* package, url:                          \verb.             (line  5625)
-* package, verbatimbox:                  verbatim.          (line  5585)
+                                                            (line  9287)
+* package, url:                          \verb.             (line  5626)
+* package, verbatimbox:                  verbatim.          (line  5586)
 * packages, loading additional:          Additional packages.
-                                                            (line   768)
+                                                            (line   769)
 * page break, forcing:                   \pagebreak & \nopagebreak.
-                                                            (line  6097)
+                                                            (line  6098)
 * page break, preventing:                \pagebreak & \nopagebreak.
-                                                            (line  6097)
-* page breaking:                         Page breaking.     (line  5967)
+                                                            (line  6098)
+* page breaking:                         Page breaking.     (line  5968)
 * page layout parameters:                Page layout parameters.
-                                                            (line  1678)
-* page number, cross referencing:        \pageref.          (line  2760)
-* page numbering style:                  \pagenumbering.    (line  9763)
-* page style, this page:                 \thispagestyle.    (line  9905)
-* page styles:                           Page styles.       (line  9680)
-* page, colored:                         Colored pages.     (line 11323)
-* page_precedence:                       makeindex.         (line 13378)
-* paired delimiters:                     \left & \right.    (line  9545)
-* paragraph:                             Sectioning.        (line  1961)
+                                                            (line  1679)
+* page number, cross referencing:        \pageref.          (line  2761)
+* page numbering style:                  \pagenumbering.    (line  9764)
+* page style, this page:                 \thispagestyle.    (line  9906)
+* page styles:                           Page styles.       (line  9681)
+* page, colored:                         Colored pages.     (line 11324)
+* page_precedence:                       makeindex.         (line 13379)
+* paired delimiters:                     \left & \right.    (line  9546)
+* paragraph:                             Sectioning.        (line  1962)
 * paragraph <1>:                         \subsubsection & \paragraph & \subparagraph.
-                                                            (line  2335)
+                                                            (line  2336)
 * paragraph indentation:                 \parindent & \parskip.
-                                                            (line  7821)
-* paragraph indentation, in minipage:    minipage.          (line  4100)
-* paragraph indentations in quoted text: quotation & quote. (line  4686)
+                                                            (line  7822)
+* paragraph indentation, in minipage:    minipage.          (line  4101)
+* paragraph indentations in quoted text: quotation & quote. (line  4687)
 * paragraph indentations in quoted text, omitting: quotation & quote.
-                                                            (line  4686)
-* paragraph mode:                        Modes.             (line  9612)
-* paragraph mode <1>:                    \parbox.           (line 10872)
-* paragraph symbol:                      Text symbols.      (line 12222)
-* paragraph, ending:                     \par.              (line  7719)
-* paragraph, in a box:                   \parbox.           (line 10872)
-* paragraphs:                            Making paragraphs. (line  7675)
-* parameters, for footnotes:             \footnote.         (line  6185)
+                                                            (line  4687)
+* paragraph mode:                        Modes.             (line  9613)
+* paragraph mode <1>:                    \parbox.           (line 10873)
+* paragraph symbol:                      Text symbols.      (line 12223)
+* paragraph, ending:                     \par.              (line  7720)
+* paragraph, in a box:                   \parbox.           (line 10873)
+* paragraphs:                            Making paragraphs. (line  7676)
+* parameters, for footnotes:             \footnote.         (line  6186)
 * parameters, page layout:               Page layout parameters.
-                                                            (line  1678)
-* part:                                  Sectioning.        (line  1961)
-* part <1>:                              \part.             (line  2046)
-* pc:                                    Units of length.   (line  7504)
+                                                            (line  1679)
+* part:                                  Sectioning.        (line  1962)
+* part <1>:                              \part.             (line  2047)
+* pc:                                    Units of length.   (line  7505)
 * PDF graphic files:                     Graphics package configuration.
-                                                            (line 11445)
-* PDF graphic files <1>:                 \includegraphics.  (line 11638)
-* pdflatex command:                      Output files.      (line   450)
-* pdfTeX:                                Output files.      (line   450)
-* pdfTeX engine:                         TeX engines.       (line   489)
-* period, abbreviation-ending:           \@.                (line 10138)
-* period, centered, in text:             Text symbols.      (line 12324)
-* period, sentence-ending:               \@.                (line 10138)
-* period, spacing after:                 \@.                (line 10138)
-* pica:                                  Units of length.   (line  7504)
-* pict2e package:                        \line.             (line  4408)
-* pict2e package <1>:                    \line.             (line  4408)
-* picture environment:                   picture.           (line  4154)
-* pictures, creating:                    picture.           (line  4154)
-* pilcrow:                               Text symbols.      (line 12222)
-* placement of floats:                   Floats.            (line  1836)
-* plural:                                \newglossaryentry. (line 13505)
+                                                            (line 11446)
+* PDF graphic files <1>:                 \includegraphics.  (line 11639)
+* pdflatex command:                      Output files.      (line   451)
+* pdfTeX:                                Output files.      (line   451)
+* pdfTeX engine:                         TeX engines.       (line   490)
+* period, abbreviation-ending:           \@.                (line 10139)
+* period, centered, in text:             Text symbols.      (line 12325)
+* period, sentence-ending:               \@.                (line 10139)
+* period, spacing after:                 \@.                (line 10139)
+* pica:                                  Units of length.   (line  7505)
+* pict2e package:                        \line.             (line  4409)
+* pict2e package <1>:                    \line.             (line  4409)
+* picture environment:                   picture.           (line  4155)
+* pictures, creating:                    picture.           (line  4155)
+* pilcrow:                               Text symbols.      (line 12223)
+* placement of floats:                   Floats.            (line  1837)
+* plural:                                \newglossaryentry. (line 13506)
 * PNG files:                             Graphics package configuration.
-                                                            (line 11445)
-* PNG files <1>:                         \includegraphics.  (line 11638)
-* poetry, an environment for:            verse.             (line  5640)
-* Point:                                 Units of length.   (line  7500)
+                                                            (line 11446)
+* PNG files <1>:                         \includegraphics.  (line 11639)
+* poetry, an environment for:            verse.             (line  5641)
+* Point:                                 Units of length.   (line  7501)
 * polish l:                              Additional Latin letters.
-                                                            (line 12534)
-* polyglossia package:                   Accents.           (line 12372)
-* polyglossia package <1>:               \today.            (line 12603)
+                                                            (line 12535)
+* polyglossia package:                   Accents.           (line 12373)
+* polyglossia package <1>:               \today.            (line 12604)
 * polyglossia package <2>:               Table of contents etc..
-                                                            (line 12930)
-* polyglossia package <3>:               \index.            (line 13176)
+                                                            (line 12931)
+* polyglossia package <3>:               \index.            (line 13177)
 * portrait orientation:                  Document class options.
-                                                            (line   723)
-* position, in picture:                  picture.           (line  4225)
+                                                            (line   724)
+* position, in picture:                  picture.           (line  4226)
 * positional parameter:                  \newcommand & \renewcommand.
-                                                            (line  6451)
-* postamble:                             makeindex.         (line 13289)
-* postscript, in letters:                \ps.               (line 13787)
-* pounds symbol:                         Text symbols.      (line 12226)
-* preamble:                              makeindex.         (line 13285)
+                                                            (line  6452)
+* postamble:                             makeindex.         (line 13290)
+* postscript, in letters:                \ps.               (line 13788)
+* pounds symbol:                         Text symbols.      (line 12227)
+* preamble:                              makeindex.         (line 13286)
 * preamble, defined:                     Starting and ending.
-                                                            (line   420)
+                                                            (line   421)
 * prompt, *:                             Recovering from errors.
-                                                            (line 14354)
-* pronunciation:                         Overview.          (line   396)
-* PSTricks package:                      \line.             (line  4408)
-* pt:                                    Units of length.   (line  7500)
+                                                            (line 14417)
+* pronunciation:                         Overview.          (line   397)
+* PSTricks package:                      \line.             (line  4409)
+* pt:                                    Units of length.   (line  7501)
 * quad:                                  Spacing in math mode.
-                                                            (line  9367)
-* question mark, upside-down:            Text symbols.      (line 12327)
-* quotation environment:                 quotation & quote. (line  4686)
-* quotation marks, French:               Text symbols.      (line 12208)
-* quote environment:                     quotation & quote. (line  4686)
-* quote, single straight:                Text symbols.      (line 12342)
-* quote, straight base:                  Text symbols.      (line 12346)
+                                                            (line  9368)
+* question mark, upside-down:            Text symbols.      (line 12328)
+* quotation environment:                 quotation & quote. (line  4687)
+* quotation marks, French:               Text symbols.      (line 12209)
+* quote environment:                     quotation & quote. (line  4687)
+* quote, single straight:                Text symbols.      (line 12343)
+* quote, straight base:                  Text symbols.      (line 12347)
 * quoted text with paragraph indentation, displaying: quotation & quote.
-                                                            (line  4686)
+                                                            (line  4687)
 * quoted text without paragraph indentation, displaying: quotation & quote.
-                                                            (line  4686)
-* radical:                               \sqrt.             (line  9580)
-* ragged left text:                      \raggedleft.       (line  3514)
-* ragged left text, environment for:     flushright.        (line  3496)
-* ragged right text:                     \raggedright.      (line  3463)
-* ragged right text, environment for:    flushleft.         (line  3435)
+                                                            (line  4687)
+* radical:                               \sqrt.             (line  9581)
+* ragged left text:                      \raggedleft.       (line  3515)
+* ragged left text, environment for:     flushright.        (line  3497)
+* ragged right text:                     \raggedright.      (line  3464)
+* ragged right text, environment for:    flushleft.         (line  3436)
 * redefining environments:               \newenvironment & \renewenvironment.
-                                                            (line  6761)
-* reference, forward:                    Cross references.  (line  2683)
-* references, resolving forward:         Output files.      (line   463)
-* registered symbol:                     Text symbols.      (line 12349)
-* relation, text above:                  \stackrel.         (line  9596)
-* remarks in the margin:                 Marginal notes.    (line  7848)
-* report class:                          Document classes.  (line   640)
+                                                            (line  6762)
+* reference, forward:                    Cross references.  (line  2684)
+* references, resolving forward:         Output files.      (line   464)
+* registered symbol:                     Text symbols.      (line 12350)
+* relation, text above:                  \stackrel.         (line  9597)
+* remarks in the margin:                 Marginal notes.    (line  7849)
+* report class:                          Document classes.  (line   641)
 * reporting bugs:                        About this document.
-                                                            (line   349)
+                                                            (line   350)
 * reserved characters:                   Reserved characters.
-                                                            (line 12094)
-* resizing:                              \scalebox.         (line 12028)
-* resizing <1>:                          \resizebox.        (line 12059)
-* right angle quotation marks:           Text symbols.      (line 12208)
-* right arrow, in text:                  Text symbols.      (line 12352)
-* right brace, in text:                  Text symbols.      (line 12267)
-* right quote:                           Text symbols.      (line 12233)
-* right quote, double:                   Text symbols.      (line 12333)
-* right quote, single:                   Text symbols.      (line 12339)
+                                                            (line 12095)
+* resizing:                              \scalebox.         (line 12029)
+* resizing <1>:                          \resizebox.        (line 12060)
+* right angle quotation marks:           Text symbols.      (line 12209)
+* right arrow, in text:                  Text symbols.      (line 12353)
+* right brace, in text:                  Text symbols.      (line 12268)
+* right quote:                           Text symbols.      (line 12234)
+* right quote, double:                   Text symbols.      (line 12334)
+* right quote, single:                   Text symbols.      (line 12340)
 * right-hand equation numbers:           Document class options.
-                                                            (line   726)
-* right-justifying text:                 \raggedleft.       (line  3514)
-* right-justifying text, environment for: flushright.       (line  3496)
-* ring accent:                           Accents.           (line 12441)
-* ring accent, math:                     Math accents.      (line  9257)
-* robust commands:                       \protect.          (line  7039)
-* roman font:                            Font styles.       (line  1283)
+                                                            (line   727)
+* right-justifying text:                 \raggedleft.       (line  3515)
+* right-justifying text, environment for: flushright.       (line  3497)
+* ring accent:                           Accents.           (line 12442)
+* ring accent, math:                     Math accents.      (line  9258)
+* robust commands:                       \protect.          (line  7040)
+* roman font:                            Font styles.       (line  1284)
 * root file:                             Splitting the input.
-                                                            (line 12631)
-* roots:                                 \sqrt.             (line  9580)
-* rotating graphics:                     \rotatebox.        (line 11960)
-* rotating text:                         \rotatebox.        (line 11960)
-* rotation:                              \rotatebox.        (line 11960)
-* row, tabbing:                          tabbing.           (line  4756)
-* rubber lengths, defining new:          \newlength.        (line  6711)
+                                                            (line 12632)
+* roots:                                 \sqrt.             (line  9581)
+* rotating graphics:                     \rotatebox.        (line 11961)
+* rotating text:                         \rotatebox.        (line 11961)
+* rotation:                              \rotatebox.        (line 11961)
+* row, tabbing:                          tabbing.           (line  4757)
+* rubber lengths, defining new:          \newlength.        (line  6712)
 * running header and footer:             Page layout parameters.
-                                                            (line  1678)
-* running header and footer style:       \pagestyle.        (line  9821)
+                                                            (line  1679)
+* running header and footer style:       \pagestyle.        (line  9822)
 * sagetex package:                       Command line options.
-                                                            (line 14264)
-* sans serif font:                       Font styles.       (line  1289)
-* Scaled point:                          Units of length.   (line  7526)
-* scaling:                               \scalebox.         (line 12028)
-* scaling <1>:                           \resizebox.        (line 12059)
-* script fonts:                          Calligraphic.      (line  8999)
-* script letters for math:               Font styles.       (line  1277)
-* secnumdepth:                           Sectioning.        (line  2023)
-* secnumdepth counter:                   Sectioning.        (line  2024)
-* section:                               Sectioning.        (line  1961)
-* section <1>:                           \section.          (line  2193)
-* section number, cross referencing:     \ref.              (line  2784)
-* section numbers, printing:             Sectioning.        (line  2024)
-* section symbol:                        Text symbols.      (line 12237)
-* section, redefining:                   \@startsection.    (line  2463)
-* sectioning commands:                   Sectioning.        (line  1961)
-* sectioning, part:                      \part.             (line  2046)
+                                                            (line 14327)
+* sans serif font:                       Font styles.       (line  1290)
+* Scaled point:                          Units of length.   (line  7527)
+* scaling:                               \scalebox.         (line 12029)
+* scaling <1>:                           \resizebox.        (line 12060)
+* script fonts:                          Calligraphic.      (line  9000)
+* script letters for math:               Font styles.       (line  1278)
+* secnumdepth:                           Sectioning.        (line  2024)
+* secnumdepth counter:                   Sectioning.        (line  2025)
+* section:                               Sectioning.        (line  1962)
+* section <1>:                           \section.          (line  2194)
+* section number, cross referencing:     \ref.              (line  2785)
+* section numbers, printing:             Sectioning.        (line  2025)
+* section symbol:                        Text symbols.      (line 12238)
+* section, redefining:                   \@startsection.    (line  2464)
+* sectioning commands:                   Sectioning.        (line  1962)
+* sectioning, part:                      \part.             (line  2047)
 * series, of fonts:                      Low-level font commands.
-                                                            (line  1422)
+                                                            (line  1423)
 * setspace package:                      Low-level font commands.
-                                                            (line  1492)
-* setting counters:                      \setcounter.       (line  7309)
+                                                            (line  1493)
+* setting counters:                      \setcounter.       (line  7310)
 * shapes, of fonts:                      Low-level font commands.
-                                                            (line  1462)
+                                                            (line  1463)
 * sharp S letters:                       Additional Latin letters.
-                                                            (line 12550)
-* showidx package:                       Indexes.           (line 13116)
-* simulating typed text:                 verbatim.          (line  5554)
-* single angle quotation marks:          Text symbols.      (line 12208)
-* single guillemets:                     Text symbols.      (line 12208)
-* single left quote:                     Text symbols.      (line 12336)
-* single low-9 quotation mark:           Text symbols.      (line 12230)
-* single quote, straight:                Text symbols.      (line 12342)
-* single right quote:                    Text symbols.      (line 12339)
-* siunitx package:                       ~.                 (line 10281)
-* sizes of text:                         Font sizes.        (line  1345)
-* skip register, plain TeX:              \newlength.        (line  6711)
-* slanted font:                          Font styles.       (line  1292)
-* slides class:                          Document classes.  (line   640)
-* sloppypar:                             sloppypar.         (line  5890)
-* sloppypar environment:                 sloppypar.         (line  5890)
-* small caps font:                       Font styles.       (line  1286)
-* sort:                                  \newglossaryentry. (line 13509)
-* sp:                                    Units of length.   (line  7526)
-* space, hard:                           ~.                 (line 10255)
-* space, inserting horizontal:           \hss.              (line 10051)
-* space, inserting vertical:             \addvspace.        (line 10660)
+                                                            (line 12551)
+* showidx package:                       Indexes.           (line 13117)
+* simulating typed text:                 verbatim.          (line  5555)
+* single angle quotation marks:          Text symbols.      (line 12209)
+* single guillemets:                     Text symbols.      (line 12209)
+* single left quote:                     Text symbols.      (line 12337)
+* single low-9 quotation mark:           Text symbols.      (line 12231)
+* single quote, straight:                Text symbols.      (line 12343)
+* single right quote:                    Text symbols.      (line 12340)
+* siunitx package:                       ~.                 (line 10282)
+* sizes of text:                         Font sizes.        (line  1346)
+* skip register, plain TeX:              \newlength.        (line  6712)
+* slanted font:                          Font styles.       (line  1293)
+* slides class:                          Document classes.  (line   641)
+* sloppypar:                             sloppypar.         (line  5891)
+* sloppypar environment:                 sloppypar.         (line  5891)
+* small caps font:                       Font styles.       (line  1287)
+* sort:                                  \newglossaryentry. (line 13510)
+* sp:                                    Units of length.   (line  7527)
+* space, hard:                           ~.                 (line 10256)
+* space, inserting horizontal:           \hss.              (line 10052)
+* space, inserting vertical:             \addvspace.        (line 10661)
 * space, negative thin:                  \thinspace & \negthinspace.
-                                                            (line 10311)
+                                                            (line 10312)
 * space, thin:                           \thinspace & \negthinspace.
-                                                            (line 10311)
-* space, unbreakable:                    ~.                 (line 10255)
-* space, vertical:                       \vspace.           (line 10580)
-* spaces:                                Spaces.            (line  9933)
+                                                            (line 10312)
+* space, unbreakable:                    ~.                 (line 10256)
+* space, vertical:                       \vspace.           (line 10581)
+* spaces:                                Spaces.            (line  9934)
 * spaces, ignore around commands:        \ignorespaces & \ignorespacesafterend.
-                                                            (line  7091)
+                                                            (line  7092)
 * spacing within math mode:              Spacing in math mode.
-                                                            (line  9322)
-* spacing, inter-sentence:               \frenchspacing.    (line 10184)
-* spacing, inter-sentence <1>:           \normalsfcodes.    (line 10204)
+                                                            (line  9323)
+* spacing, inter-sentence:               \frenchspacing.    (line 10185)
+* spacing, inter-sentence <1>:           \normalsfcodes.    (line 10205)
 * spacing, math mode:                    \phantom & \vphantom & \hphantom.
-                                                            (line  9440)
-* Spanish ordinals, feminine and masculine: Text symbols.   (line 12321)
+                                                            (line  9441)
+* Spanish ordinals, feminine and masculine: Text symbols.   (line 12322)
 * special characters:                    Reserved characters.
-                                                            (line 12094)
+                                                            (line 12095)
 * special characters <1>:                Additional Latin letters.
-                                                            (line 12504)
+                                                            (line 12505)
 * special insertions:                    Special insertions.
-                                                            (line 12088)
-* specifier, float placement:            Floats.            (line  1836)
+                                                            (line 12089)
+* specifier, float placement:            Floats.            (line  1837)
 * splitting the input file:              Splitting the input.
-                                                            (line 12627)
-* square root:                           \sqrt.             (line  9580)
-* stack math:                            \stackrel.         (line  9596)
-* star-variants, commands:               \@ifstar.          (line  6609)
+                                                            (line 12628)
+* square root:                           \sqrt.             (line  9581)
+* stack math:                            \stackrel.         (line  9597)
+* star-variants, commands:               \@ifstar.          (line  6610)
 * starred form, defining new commands:   \newcommand & \renewcommand.
-                                                            (line  6424)
-* starting a new page:                   \newpage.          (line  6039)
+                                                            (line  6425)
+* starting a new page:                   \newpage.          (line  6040)
 * starting a new page and clearing floats: \clearpage & \cleardoublepage.
-                                                            (line  5998)
+                                                            (line  5999)
 * starting and ending:                   Starting and ending.
-                                                            (line   404)
+                                                            (line   405)
 * starting on a right-hand page:         \clearpage & \cleardoublepage.
-                                                            (line  5998)
-* sterling symbol:                       Text symbols.      (line 12226)
-* straight double quote, base:           Text symbols.      (line 12346)
-* straight quote, base:                  Text symbols.      (line 12346)
-* straight single quote:                 Text symbols.      (line 12342)
-* stretch, infinite horizontal:          \hfill.            (line 10018)
-* stretch, infinite vertical:            \vfill.            (line 10631)
-* stretch, omitting vertical:            \raggedbottom.     (line  1667)
-* strut:                                 \strut.            (line 10495)
-* styles of text:                        Font styles.       (line  1205)
-* styles, page:                          Page styles.       (line  9680)
-* subparagraph:                          Sectioning.        (line  1961)
+                                                            (line  5999)
+* sterling symbol:                       Text symbols.      (line 12227)
+* straight double quote, base:           Text symbols.      (line 12347)
+* straight quote, base:                  Text symbols.      (line 12347)
+* straight single quote:                 Text symbols.      (line 12343)
+* stretch, infinite horizontal:          \hfill.            (line 10019)
+* stretch, infinite vertical:            \vfill.            (line 10632)
+* stretch, omitting vertical:            \raggedbottom.     (line  1668)
+* strut:                                 \strut.            (line 10496)
+* styles of text:                        Font styles.       (line  1206)
+* styles, page:                          Page styles.       (line  9681)
+* subparagraph:                          Sectioning.        (line  1962)
 * subparagraph <1>:                      \subsubsection & \paragraph & \subparagraph.
-                                                            (line  2335)
+                                                            (line  2336)
 * subscript:                             Subscripts & superscripts.
-                                                            (line  7988)
-* subsection:                            Sectioning.        (line  1961)
-* subsection <1>:                        \subsection.       (line  2271)
+                                                            (line  7989)
+* subsection:                            Sectioning.        (line  1962)
+* subsection <1>:                        \subsection.       (line  2272)
 * subsubsection:                         \subsubsection & \paragraph & \subparagraph.
-                                                            (line  2335)
+                                                            (line  2336)
 * superscript:                           Subscripts & superscripts.
-                                                            (line  7988)
-* symbol:                                \newglossaryentry. (line 13513)
-* symbols package:                       Math symbols.      (line  8051)
+                                                            (line  7989)
+* symbol:                                \newglossaryentry. (line 13514)
+* symbols package:                       Math symbols.      (line  8052)
 * symbols, boldface:                     \boldmath & \unboldmath.
-                                                            (line  9017)
-* symbols, math:                         Math symbols.      (line  8051)
-* symbols, text:                         Text symbols.      (line 12183)
-* tab stops, using:                      tabbing.           (line  4716)
-* tabbing environment:                   tabbing.           (line  4716)
-* table environment:                     table.             (line  4865)
+                                                            (line  9018)
+* symbols, math:                         Math symbols.      (line  8052)
+* symbols, text:                         Text symbols.      (line 12184)
+* tab stops, using:                      tabbing.           (line  4717)
+* tabbing environment:                   tabbing.           (line  4717)
+* table environment:                     table.             (line  4866)
 * table of contents entry, manually adding: \addcontentsline.
-                                                            (line 12950)
-* table of contents file:                Output files.      (line   473)
+                                                            (line 12951)
+* table of contents file:                Output files.      (line   474)
 * table of contents, avoiding footnotes: Footnotes in section headings.
-                                                            (line  6295)
+                                                            (line  6296)
 * table of contents, creating:           Table of contents etc..
-                                                            (line 12856)
+                                                            (line 12857)
 * table of contents, sectioning numbers printed: Sectioning.
-                                                            (line  2035)
-* tables, creating:                      table.             (line  4865)
-* tabular environment:                   tabular.           (line  4925)
-* template, article:                     article template.  (line 14412)
-* template, beamer:                      beamer template.   (line 14381)
-* template, book:                        book template.     (line 14432)
+                                                            (line  2036)
+* tables, creating:                      table.             (line  4866)
+* tabular environment:                   tabular.           (line  4926)
+* template, article:                     article template.  (line 14475)
+* template, beamer:                      beamer template.   (line 14444)
+* template, book:                        book template.     (line 14495)
 * template, book <1>:                    Larger book template.
-                                                            (line 14455)
-* template, TUGboat:                     tugboat template.  (line 14505)
+                                                            (line 14518)
+* template, TUGboat:                     tugboat template.  (line 14568)
 * templates, document:                   Document templates.
-                                                            (line 14374)
-* terminal input/output:                 Input/output.      (line 13846)
-* TeX logo:                              Text symbols.      (line 12240)
-* text symbols:                          Text symbols.      (line 12183)
-* text, resizing:                        \scalebox.         (line 12028)
-* text, resizing <1>:                    \resizebox.        (line 12059)
-* text, scaling:                         \scalebox.         (line 12028)
-* text, scaling <1>:                     \resizebox.        (line 12059)
+                                                            (line 14437)
+* terminal input/output:                 Input/output.      (line 13847)
+* TeX logo:                              Text symbols.      (line 12241)
+* text symbols:                          Text symbols.      (line 12184)
+* text, resizing:                        \scalebox.         (line 12029)
+* text, resizing <1>:                    \resizebox.        (line 12060)
+* text, scaling:                         \scalebox.         (line 12029)
+* text, scaling <1>:                     \resizebox.        (line 12060)
 * textcase package:                      Upper and lower case.
-                                                            (line 12162)
-* textcomp package:                      Font styles.       (line  1331)
-* textcomp package <1>:                  Text symbols.      (line 12183)
-* thanks, for titlepage:                 \maketitle.        (line  9743)
-* thebibliography environment:           thebibliography.   (line  5250)
-* theorem environment:                   theorem.           (line  5485)
-* theorem-like environment:              \newtheorem.       (line  6895)
-* theorems, defining:                    \newtheorem.       (line  6895)
-* theorems, typesetting:                 theorem.           (line  5485)
+                                                            (line 12163)
+* textcomp package:                      Font styles.       (line  1332)
+* textcomp package <1>:                  Text symbols.      (line 12184)
+* thanks, for titlepage:                 \maketitle.        (line  9744)
+* thebibliography environment:           thebibliography.   (line  5251)
+* theorem environment:                   theorem.           (line  5486)
+* theorem-like environment:              \newtheorem.       (line  6896)
+* theorems, defining:                    \newtheorem.       (line  6896)
+* theorems, typesetting:                 theorem.           (line  5486)
 * thin space:                            Spacing in math mode.
-                                                            (line  9348)
+                                                            (line  9349)
 * thin space <1>:                        \thinspace & \negthinspace.
-                                                            (line 10311)
+                                                            (line 10312)
 * thin space, negative:                  Spacing in math mode.
-                                                            (line  9362)
+                                                            (line  9363)
 * thin space, negative <1>:              \thinspace & \negthinspace.
-                                                            (line 10311)
+                                                            (line 10312)
 * thorn, Icelandic letter:               Additional Latin letters.
-                                                            (line 12554)
-* three-quarters em-dash:                Text symbols.      (line 12355)
-* tie:                                   ~.                 (line 10255)
-* tie-after accent:                      Accents.           (line 12447)
-* TikZ package:                          \line.             (line  4408)
-* TikZ package <1>:                      \strut.            (line 10551)
-* TikZ package <2>:                      \mbox & \makebox.  (line 10782)
-* tilde accent:                          Accents.           (line 12412)
-* tilde accent, math:                    Math accents.      (line  9260)
-* tilde, ASCII, in text:                 Text symbols.      (line 12246)
+                                                            (line 12555)
+* three-quarters em-dash:                Text symbols.      (line 12356)
+* tie:                                   ~.                 (line 10256)
+* tie-after accent:                      Accents.           (line 12448)
+* TikZ package:                          \line.             (line  4409)
+* TikZ package <1>:                      \strut.            (line 10552)
+* TikZ package <2>:                      \mbox & \makebox.  (line 10783)
+* tilde accent:                          Accents.           (line 12413)
+* tilde accent, math:                    Math accents.      (line  9261)
+* tilde, ASCII, in text:                 Text symbols.      (line 12247)
 * title page, separate or run-in:        Document class options.
-                                                            (line   734)
-* title pages, creating:                 titlepage.         (line  5515)
-* title, for titlepage:                  \maketitle.        (line  9750)
-* titlepage environment:                 titlepage.         (line  5515)
+                                                            (line   735)
+* title pages, creating:                 titlepage.         (line  5516)
+* title, for titlepage:                  \maketitle.        (line  9751)
+* titlepage environment:                 titlepage.         (line  5516)
 * titlepage option:                      Document class options.
-                                                            (line   712)
-* titles, making:                        \maketitle.        (line  9692)
-* titlesec package:                      Sectioning.        (line  2015)
-* titlesec package <1>:                  \part.             (line  2094)
-* titlesec package <2>:                  \chapter.          (line  2173)
-* titlesec package <3>:                  \section.          (line  2251)
-* titlesec package <4>:                  \subsection.       (line  2317)
+                                                            (line   713)
+* titles, making:                        \maketitle.        (line  9693)
+* titlesec package:                      Sectioning.        (line  2016)
+* titlesec package <1>:                  \part.             (line  2095)
+* titlesec package <2>:                  \chapter.          (line  2174)
+* titlesec package <3>:                  \section.          (line  2252)
+* titlesec package <4>:                  \subsection.       (line  2318)
 * titlesec package <5>:                  \subsubsection & \paragraph & \subparagraph.
-                                                            (line  2394)
+                                                            (line  2395)
 * tocbibbind package:                    Table of contents etc..
-                                                            (line 12941)
-* tocdepth:                              Sectioning.        (line  2034)
-* tocdepth counter:                      Sectioning.        (line  2035)
+                                                            (line 12942)
+* tocdepth:                              Sectioning.        (line  2035)
+* tocdepth counter:                      Sectioning.        (line  2036)
 * tocloft package:                       Table of contents etc..
-                                                            (line 12941)
-* today's date:                          \today.            (line 12596)
-* tombstone:                             \rule.             (line 12568)
+                                                            (line 12942)
+* today's date:                          \today.            (line 12597)
+* tombstone:                             \rule.             (line 12569)
 * topmargin:                             Page layout parameters.
-                                                            (line  1797)
-* topnumber:                             Floats.            (line  1943)
-* topnumber <1>:                         Floats.            (line  1944)
-* totalnumber:                           Floats.            (line  1947)
-* totalnumber <1>:                       Floats.            (line  1948)
-* trademark symbol:                      Text symbols.      (line 12358)
-* transcript file:                       Output files.      (line   458)
-* TrueType fonts:                        TeX engines.       (line   482)
-* TUGboat template:                      tugboat template.  (line 14505)
-* two-column output:                     \twocolumn.        (line  1539)
-* two-thirds em-dash:                    Text symbols.      (line 12361)
+                                                            (line  1798)
+* topnumber:                             Floats.            (line  1944)
+* topnumber <1>:                         Floats.            (line  1945)
+* totalnumber:                           Floats.            (line  1948)
+* totalnumber <1>:                       Floats.            (line  1949)
+* trademark symbol:                      Text symbols.      (line 12359)
+* transcript file:                       Output files.      (line   459)
+* TrueType fonts:                        TeX engines.       (line   483)
+* TUGboat template:                      tugboat template.  (line 14568)
+* two-column output:                     \twocolumn.        (line  1540)
+* two-thirds em-dash:                    Text symbols.      (line 12362)
 * twocolumn option:                      Document class options.
-                                                            (line   741)
+                                                            (line   742)
 * twoside option:                        Document class options.
-                                                            (line   741)
-* type styles:                           Font styles.       (line  1205)
-* typed text, simulating:                verbatim.          (line  5554)
-* typeface sizes:                        Font sizes.        (line  1345)
-* typefaces:                             Fonts.             (line  1199)
-* typewriter font:                       Font styles.       (line  1295)
-* typewriter labels in lists:            description.       (line  3075)
+                                                            (line   742)
+* type styles:                           Font styles.       (line  1206)
+* typed text, simulating:                verbatim.          (line  5555)
+* typeface sizes:                        Font sizes.        (line  1346)
+* typefaces:                             Fonts.             (line  1200)
+* typewriter font:                       Font styles.       (line  1296)
+* typewriter labels in lists:            description.       (line  3076)
 * ulem package:                          Over- and Underlining.
-                                                            (line  9286)
-* umlaut accent:                         Accents.           (line 12389)
-* underbar:                              Accents.           (line 12417)
+                                                            (line  9287)
+* umlaut accent:                         Accents.           (line 12390)
+* underbar:                              Accents.           (line 12418)
 * underlining:                           Over- and Underlining.
-                                                            (line  9277)
-* underscore, in text:                   Text symbols.      (line 12364)
-* Unicode input, native:                 TeX engines.       (line   482)
-* units, of length:                      Units of length.   (line  7496)
+                                                            (line  9278)
+* underscore, in text:                   Text symbols.      (line 12365)
+* Unicode input, native:                 TeX engines.       (line   483)
+* units, of length:                      Units of length.   (line  7497)
 * unofficial nature of this manual:      About this document.
-                                                            (line   345)
-* unordered lists:                       itemize.           (line  3539)
+                                                            (line   346)
+* unordered lists:                       itemize.           (line  3540)
 * uppercase:                             Upper and lower case.
-                                                            (line 12126)
-* url package:                           \verb.             (line  5625)
-* using BibTeX:                          Using BibTeX.      (line  5427)
+                                                            (line 12127)
+* url package:                           \verb.             (line  5626)
+* using BibTeX:                          Using BibTeX.      (line  5428)
 * usrguide official documentation:       About this document.
-                                                            (line   364)
-* UTF-8:                                 TeX engines.       (line   482)
-* variables, a list of:                  Counters.          (line  7166)
-* vector symbol, math:                   Math accents.      (line  9263)
-* verbatim environment:                  verbatim.          (line  5554)
-* verbatim text:                         verbatim.          (line  5554)
-* verbatim text, inline:                 \verb.             (line  5593)
-* verbatimbox package:                   verbatim.          (line  5585)
-* verse environment:                     verse.             (line  5640)
-* vertical bar, double, in text:         Text symbols.      (line 12258)
-* vertical bar, in text:                 Text symbols.      (line 12255)
-* vertical mode:                         Modes.             (line  9634)
-* vertical space:                        \vspace.           (line 10580)
-* vertical space <1>:                    \addvspace.        (line 10660)
+                                                            (line   365)
+* UTF-8:                                 TeX engines.       (line   483)
+* variables, a list of:                  Counters.          (line  7167)
+* vector symbol, math:                   Math accents.      (line  9264)
+* verbatim environment:                  verbatim.          (line  5555)
+* verbatim text:                         verbatim.          (line  5555)
+* verbatim text, inline:                 \verb.             (line  5594)
+* verbatimbox package:                   verbatim.          (line  5586)
+* verse environment:                     verse.             (line  5641)
+* vertical bar, double, in text:         Text symbols.      (line 12259)
+* vertical bar, in text:                 Text symbols.      (line 12256)
+* vertical mode:                         Modes.             (line  9635)
+* vertical space:                        \vspace.           (line 10581)
+* vertical space <1>:                    \addvspace.        (line 10661)
 * vertical space before paragraphs:      \parindent & \parskip.
-                                                            (line  7821)
+                                                            (line  7822)
 * vertical spacing:                      \phantom & \vphantom & \hphantom.
-                                                            (line  9440)
-* vertical spacing, math mode:           \smash.            (line  9379)
-* visible space:                         \verb.             (line  5618)
-* visible space symbol, in text:         Text symbols.      (line 12367)
+                                                            (line  9441)
+* vertical spacing, math mode:           \smash.            (line  9380)
+* visible space:                         \verb.             (line  5619)
+* visible space symbol, in text:         Text symbols.      (line 12368)
 * weights, of fonts:                     Low-level font commands.
-                                                            (line  1432)
-* white space:                           Spaces.            (line  9933)
-* wide hat accent, math:                 Math accents.      (line  9266)
-* wide tilde accent, math:               Math accents.      (line  9269)
+                                                            (line  1433)
+* white space:                           Spaces.            (line  9934)
+* wide hat accent, math:                 Math accents.      (line  9267)
+* wide tilde accent, math:               Math accents.      (line  9270)
 * widths, of fonts:                      Low-level font commands.
-                                                            (line  1444)
-* writing external files:                filecontents.      (line  3384)
-* writing letters:                       Letters.           (line 13549)
-* x-height:                              Units of length.   (line  7528)
-* xdvi command:                          Output files.      (line   440)
-* xdvipdfmx:                             TeX engines.       (line   515)
-* xelatex command:                       TeX engines.       (line   515)
-* XeTeX:                                 TeX engines.       (line   515)
-* xindy:                                 makeindex.         (line 13388)
-* xindy program:                         makeindex.         (line 13388)
+                                                            (line  1445)
+* writing external files:                filecontents.      (line  3385)
+* writing letters:                       Letters.           (line 13550)
+* x-height:                              Units of length.   (line  7529)
+* xdvi command:                          Output files.      (line   441)
+* xdvipdfmx:                             TeX engines.       (line   516)
+* xelatex command:                       TeX engines.       (line   516)
+* XeTeX:                                 TeX engines.       (line   516)
+* xindy:                                 makeindex.         (line 13389)
+* xindy program:                         makeindex.         (line 13389)
 

Modified: trunk/latex2e.xml
===================================================================
--- trunk/latex2e.xml	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/latex2e.xml	2018-10-21 21:39:31 UTC (rev 716)
@@ -3,7 +3,7 @@
 <texinfo xml:lang="en">
 <filename file="latex2e.xml"></filename>
 <preamble>\input texinfo
-</preamble><!-- c $Id: latex2e.texi 714 2018-10-16 22:00:02Z jimhefferon $ -->
+</preamble><!-- c $Id: latex2e.texi 715 2018-10-21 11:02:51Z jimhefferon $ -->
 <!-- comment %**start of header (This is for running Texinfo on a region.) -->
 <setfilename file="latex2e.info" spaces=" ">latex2e.info</setfilename>
 <set name="UPDATED" line=" UPDATED October 2018">October 2018</set>
@@ -18737,24 +18737,6 @@
 (<pxref label="Graphics"><xrefnodename>Graphics</xrefnodename></pxref>).
 </para>
 
-<!-- c I think this is not a user-level command; it is used to keep from breaking -->
-<!-- c the page between the closing and the signature -->
-<!-- c @node \stopbreaks and \startbreaks -->
-<!-- c @section @code{\stopbreaks} and @code{\startbreaks} -->
-
-<!-- c @findex \startbreak -->
-<!-- c @findex \stopbreaks -->
-
-<!-- c @example  -->
-<!-- c @code{\stopbreaks} -->
-<!-- c text -->
-<!-- c @code{\startbreaks} -->
-<!-- c @end example -->
-
-<!-- c The @code{\stopbreaks} inhibits page breaking.  The @code{\startbreaks} resumes -->
-<!-- c normal page breaking. -->
-<!-- c -->
-<!-- c -->
 </section>
 <node name="_005ctelephone" spaces=" "><nodename>\telephone</nodename><nodeprev automatic="on">\signature</nodeprev><nodeup automatic="on">Letters</nodeup></node>
 <section spaces=" "><sectiontitle><code>\telephone</code></sectiontitle>
@@ -18780,19 +18762,110 @@
 
 <cindex index="cp" spaces=" "><indexterm index="cp" number="955">input/output, to terminal</indexterm></cindex>
 <cindex index="cp" spaces=" "><indexterm index="cp" number="956">terminal input/output</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="957">input/output</indexterm></cindex>
 
+<para>&latex; uses the ability to write to a file and later read it back in
+to build document components such as a table of contents or index.  You
+can also read a file that other programs written, or write a file for
+others to read.  You can communicate with users through the terminal.
+And, you can issue instructions for the operating system.
+</para>
 <menu endspaces=" ">
-<menuentry leadingtext="* "><menunode separator="::             ">\typein</menunode><menudescription><pre xml:space="preserve">Read text from the terminal.
+<menuentry leadingtext="* "><menunode separator="::  ">\openin & \openout</menunode><menudescription><pre xml:space="preserve">Open a file.
+</pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator="::             ">\typein</menunode><menudescription><pre xml:space="preserve">Read text from the terminal.
 </pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator="::            ">\typeout</menunode><menudescription><pre xml:space="preserve">Write text to the terminal.
 </pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator="::              ">\write</menunode><menudescription><pre xml:space="preserve">Write text to a file or terminal.
-<!-- c *\wlog -->
 </pre></menudescription></menuentry></menu>
 
 
-<node name="_005ctypein" spaces=" "><nodename>\typein</nodename><nodenext automatic="on">\typeout</nodenext><nodeup automatic="on">Input/output</nodeup></node>
+<node name="_005copenin-_0026-_005copenout" spaces=" "><nodename>\openin & \openout</nodename><nodenext automatic="on">\typein</nodenext><nodeup automatic="on">Input/output</nodeup></node>
+<section spaces=" "><sectiontitle><code>\openin</code> & <code>\openout</code></sectiontitle>
+
+<findex index="fn" spaces=" "><indexterm index="fn" number="1096" mergedindex="cp">\openin</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1097" mergedindex="cp">\openout</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1098" mergedindex="cp">\closein</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1099" mergedindex="cp">\closeout</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="958">file, opening</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="959">file, closing</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="960">open a file</indexterm></cindex>
+
+<para>Synopsis:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\openin<var>number</var>=<var>filename</var>
+</pre></example>
+
+<para>or:
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\openout<var>number</var>=<var>filename</var>
+</pre></example>
+
+<para>Open a file for reading material, or for writing it.  The <var>number</var>
+must be between 0 and 15, as in <code>\openin3</code> (in Lua&latex;
+<var>number</var> can be between 0 and 255).
+</para>
+<para>Here &tex; opens the file <file>presidents.tex</file> for reading.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newread\presidentsfile
+\openin\presidentsfile=presidents
+\typeout{presidentsfile is \the\presidentsfile}
+\read\presidentsfile to\presidentline
+\typeout{\presidentline}
+</pre></example>
+
+<noindent></noindent>
+<para>The <code>\newread</code> command allocates input stream numbers from 0
+to 15, (there is also a <code>\newwrite</code>).  Being able to work not
+with a number but with the more memorable <code>\presidentsfile</code> is just
+a convenience; the first line typed out is something like
+<samp>presidentsfile is 1</samp>.  The second line is like <samp>1 Washington,
+George</samp>.
+</para>
+<para>Close files with <code>\closein<var>number</var></code> and
+<code>\closeout<var>number</var></code>.
+</para>
+<para>How &latex; handles filenames varies among distributions, and even can
+vary among versions of a distribution.  If the file does not have an
+extension then &tex; will add a <file>.tex</file>.  This creates
+<file>presidents.tex</file>, writes one line to it, and closes it.
+</para>
+<example endspaces=" ">
+<pre xml:space="preserve">\newwrite\presidentsfile
+\openout\presidentsfile=presidents
+\write\presidentsfile{1 Washington, George}
+\closeout\presidentsfile
+</pre></example>
+
+<noindent></noindent>
+<para>But filenames with a period can cause trouble: if &tex; finds a
+<var>filename</var> of <file>presidents.dat</file> it could look first for
+<file>presidents.dat.tex</file> and later for <file>presidents.dat</file>, or it
+could do the opposite.  Your distribution&textrsquo;s documentation should say
+more, and if you find something that works for you then you are good,
+but to ensure complete portability the best thing is to use file names
+containing only the twenty six ASCII letters (not case-sensitive), along
+with underscore and dash, and no dot or space.
+</para>
+<para>Ordinarily &tex; will not try to open the file until the next page
+shipout. To change this, use
+<code>\immediate\openin<var>number</var>=<var>filename</var></code>.
+</para>
+<para>For <code>openin</code>, if &tex; cannot find the file then it does not give
+an error.  It just considers that the stream is not open (test for this
+with <code>\ifeof</code>; one recourse is the command
+<code>\InputIfFileExists</code>, <pxref label="Class-and-package-commands"><xrefnodename>Class and package commands</xrefnodename></pxref>).  If you
+try to use the same number twice, &latex; won&textrsquo;t give you an error.  If
+you try to use a bad number then you get an error message like <samp>!
+Bad number (16).  <to be read again> = l.30 \openin16=test.jh</samp>.
+</para>
+
+</section>
+<node name="_005ctypein" spaces=" "><nodename>\typein</nodename><nodenext automatic="on">\typeout</nodenext><nodeprev automatic="on">\openin & \openout</nodeprev><nodeup automatic="on">Input/output</nodeup></node>
 <section spaces=" "><sectiontitle><code>\typein</code></sectiontitle>
 
-<findex index="fn" spaces=" "><indexterm index="fn" number="1096" mergedindex="cp">\typein</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1100" mergedindex="cp">\typein</indexterm></findex>
 
 <para>Synopsis, one of:
 </para>
@@ -18855,7 +18928,7 @@
 <node name="_005ctypeout" spaces=" "><nodename>\typeout</nodename><nodenext automatic="on">\write</nodenext><nodeprev automatic="on">\typein</nodeprev><nodeup automatic="on">Input/output</nodeup></node>
 <section spaces=" "><sectiontitle><code>\typeout</code></sectiontitle>
 
-<findex index="fn" spaces=" "><indexterm index="fn" number="1097" mergedindex="cp">\typeout</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1101" mergedindex="cp">\typeout</indexterm></findex>
 
 <para>Synopsis:
 </para>
@@ -18900,7 +18973,7 @@
 <node name="_005cwrite" spaces=" "><nodename>\write</nodename><nodeprev automatic="on">\typeout</nodeprev><nodeup automatic="on">Input/output</nodeup></node>
 <section spaces=" "><sectiontitle><code>\write</code></sectiontitle>
 
-<findex index="fn" spaces=" "><indexterm index="fn" number="1098" mergedindex="cp">\write</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1102" mergedindex="cp">\write</indexterm></findex>
 
 <para>Synopsis:
 </para>
@@ -18912,16 +18985,6 @@
 opened by <code>\openout</code>.  For instance, <code>\write6</code> writes to text
 stream number 6.
 </para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="957"><r>package</r>, <code>Asymptote</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="958"><code>Asymptote</code> <r>package</r></indexterm></cindex>
-
-<para>&latex; uses the ability to write to a file and later read it back in
-to build document components such as a Table of Contents or Index.  You
-can also output a file that other programs read, for instance by writing
-out an Asymptote graphics source file, having &latex; then run the
-<file>asymptote</file> program on that file (<pxref label="_005cwrite18"><xrefnodename>\write18</xrefnodename></pxref>), and finally
-bringing that graphic back into the document (<pxref label="_005cincludegraphics"><xrefnodename>\includegraphics</xrefnodename></pxref>).
-</para>
 <para>If this appears in <file><var>basefile</var>.tex</file> then it opens
 <file><var>basefile</var>.jh</file>, writes <samp>Hello World!</samp> and a newline to
 it, and closes that file.
@@ -18945,14 +19008,14 @@
 <para>Typically <var>number</var> is between 0 and 15 because typically
 &latex; authors follow the prior example and the number is allocated by
 the system.  If <var>number</var> is outside the range from 0 to 15 or if it
-is not associated with an open file then &latex; writes the string to
+is not associated with an open file then &latex; writes <var>string</var> to
 the log file.  If <var>number</var> is positive then in addition &latex;
-writes <var>string</var> to the terminal.  (But the numbers 16, 17, and 18
-are special; see below.) Thus, <code>test \write-1{Hello World!}</code> puts
-<samp>Hello World!</samp> followed by a newline in the log file.  (This is
-what the <code>\wlog</code> command does; <pxref label="_005cwlog"><xrefnodename>\wlog</xrefnodename></pxref>).  And
+writes <var>string</var> to the terminal. Thus, <code>test \write-1{Hello
+World!}</code> puts <samp>Hello World!</samp> followed by a newline in the log
+file.  (This is what the <code>\wlog</code> command does; <pxref label="_005cwlog"><xrefnodename>\wlog</xrefnodename></pxref>).  And
 <code>\write100{Hello World!}</code> puts the same in the log file but also
 puts <samp>Hello World!</samp> followed by a newline in the terminal output.
+(But 16, 17, and 18 are special as <var>number</var>; see below.)
 </para>
 <para>In Lua&latex;, instead of 16 output streams there are 256
 (<pxref label="TeX-engines"><xrefnodename>&tex; engines</xrefnodename></pxref>).
@@ -18976,15 +19039,16 @@
 </pre></example>
 
 <para>With the first, &latex; writes <var>string</var> to the file.  Any commands
-in <var>string</var> will be expanded (as in <code>\edef</code>, except that you
-should use <code>#</code> instead of <code>##</code>).  With the second,
-<var>string</var> is stored on the current list of things (as a &tex;
-&textldquo;whatsit&textrdquo;) and kept until the page is shipped out.  On that list the
-commands are unexpanded until at the time of shipout.  The third,
+in <var>string</var> will be expanded (just as in <code>\edef</code> so that to
+prevent expansion you should use <code>\noexpand</code> or a <code>toks</code>,
+except that you should use <code>#</code> instead of <code>##</code>).  With the
+second, <var>string</var> is stored on the current list of things (as a
+&tex; &textldquo;whatsit&textrdquo;) and kept until the page is shipped out and likewise
+the commands are unexpanded until shipout.  The third,
 <code>\protected&arobase;write</code>, is like the second except that you can use
-<code>\protect</code> on fragile commands. In this third case the extra first
-argument allows you to locally insert extra definitions to make more
-commands be safe or have special definition during the write.
+<code>\protect</code> on fragile commands. The extra first argument allows you
+to locally insert extra definitions to make more commands be safe or
+have special definition during the write.
 </para>
 <para>Here <var>string</var> contains a control sequence.
 </para>
@@ -19000,25 +19064,26 @@
 followed by a newline.
 </para>
 <para>The cases where <var>number</var> is 16, 17, or 18 are special.  Because of
-<code>\write<var>number</var></code>&textrsquo;s behavior when <var>number</var> is outside the
-range from 0 to 15, there is some convention of writing to the log file
-and the terminal with <code>\write16</code>.  In the past <code>\write17</code> has
-sometimes been used in a similar way.  The <code>\write18</code> command is
-even more special; modern &tex; systems use it for issuing commands to
-the operating system (<pxref label="_005cwrite18"><xrefnodename>\write18</xrefnodename></pxref>).
+<code>\write</code>&textrsquo;s behavior when <var>number</var> is outside the range from 0
+to 15 described above, in Plain &tex; <code>\write16</code> and
+<code>\write17</code> were sometimes used to write to the log file and the
+terminal.  Note that in &latex; the natural way to do that is with
+<code>\typeout</code> (<pxref label="_005ctypeout"><xrefnodename>\typeout</xrefnodename></pxref>).  The <code>\write18</code> command is even
+more special; modern &tex; systems use it for giving commands to the
+operating system (<pxref label="_005cwrite18"><xrefnodename>\write18</xrefnodename></pxref>).
 </para>
 <para>Ordinarily <code>\write</code> outputs a single line.  Put in a newline with
 <code>^^J</code>.  Thus, this produces two lines in the log file.
 </para>
 <example endspaces=" ">
-<pre xml:space="preserve">\wlog{Parallel Lines have a lot in common.^^JBut they never meet.}
+<pre xml:space="preserve">\wlog{Parallel lines have a lot in common.^^JBut they never meet.}
 </pre></example>
 
-<para>Writing arbitrary files has obvious security problems.  If you
-downloaded a &latex; file and compiling it overwrote your password file
-then you would be annoyed.  &tex; systems by default only allow you to
-open files for writing that are in the current directory or in a
-subdirectory.  This example
+<para>The ability to Write files raises security issues.  If you compiled a
+downloaded &latex; file and it overwrote your password file then you
+would be annoyed.  &tex; systems by default only allow you to open
+files for writing that are in the current directory or in a
+subdirectory.  This
 </para>
 <example endspaces=" ">
 <pre xml:space="preserve">\newwrite\jhfile
@@ -19030,17 +19095,17 @@
 I can't write on file `../test.jh'</samp>.  Note that you can get such an
 error when trying to use commands such as <code>\include{../filename}</code>
 because &latex; will try to open <file>../filename.aux</file>.  The simplest
-solution is to put the included files in the same directory or
-subdirectories of the master file.
+solution is to put the included files in the same directory as the
+master file, or in subdirectories.
 </para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="959"><r>package</r>, <code>answers</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="960"><code>answers</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="961"><r>package</r>, <code>answers</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="962"><code>answers</code> <r>package</r></indexterm></cindex>
 
-<para>If you want that the material you write is output verbatim, without
-expanding the commands, for instance to write answers to exercises, then
-look at the <file>answers</file> package on CTAN.
+<para>A common case where authors want to write a file not already provided by
+&latex; is for answers to exercises, or some other situation where you
+want to write out verbatim, without expanding the commands.  CTAN has a
+number of packages for this; one is <file>answers</file>.
 </para>
-
 <menu endspaces=" ">
 <menuentry leadingtext="* "><menunode separator="::          ">\message</menunode><menudescription><pre xml:space="preserve">Write part of a line to log file and terminal.
 </pre></menudescription></menuentry><menuentry leadingtext="* "><menunode separator="::             ">\wlog</menunode><menudescription><pre xml:space="preserve">Write to the log file.
@@ -19051,7 +19116,7 @@
 <node name="_005cmessage" spaces=" "><nodename>\message</nodename><nodenext automatic="on">\wlog</nodenext><nodeup automatic="on">\write</nodeup></node>
 <subsection spaces=" "><sectiontitle><code>\message</code></sectiontitle>
 
-<findex index="fn" spaces=" "><indexterm index="fn" number="1099" mergedindex="cp">\message</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1103" mergedindex="cp">\message</indexterm></findex>
 
 <para>Synopsis:
 </para>
@@ -19110,7 +19175,7 @@
 <node name="_005cwlog" spaces=" "><nodename>\wlog</nodename><nodenext automatic="on">\write18</nodenext><nodeprev automatic="on">\message</nodeprev><nodeup automatic="on">\write</nodeup></node>
 <subsection spaces=" "><sectiontitle><code>\wlog</code></sectiontitle>
 
-<findex index="fn" spaces=" "><indexterm index="fn" number="1100" mergedindex="cp">\wlog</indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1104" mergedindex="cp">\wlog</indexterm></findex>
 
 <para>Synopsis:
 </para>
@@ -19138,9 +19203,9 @@
 <node name="_005cwrite18" spaces=" "><nodename>\write18</nodename><nodeprev automatic="on">\wlog</nodeprev><nodeup automatic="on">\write</nodeup></node>
 <subsection spaces=" "><sectiontitle><code>\write18</code></sectiontitle>
 
-<findex index="fn" spaces=" "><indexterm index="fn" number="1101" mergedindex="cp">\write18</indexterm></findex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="961">external commands</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="962">commands, run from LaTeX</indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1105" mergedindex="cp">\write18</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="963">external commands</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="964">commands, run from LaTeX</indexterm></cindex>
 <!-- c Derived from: Joseph Wright: https://tex.stackexchange.com/a/20446/121234 -->
 
 <para>Synopsis:
@@ -19153,8 +19218,8 @@
 runs the command and &latex;&textrsquo;s execution is blocked until that
 finishes.
 </para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="963"><r>package</r>, <code>Asymptote</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="964"><code>Asymptote</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="965"><r>package</r>, <code>Asymptote</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="966"><code>Asymptote</code> <r>package</r></indexterm></cindex>
 
 <para>This
 </para>
@@ -19167,19 +19232,21 @@
 </pre></example>
 
 <noindent></noindent>
-<para>will run <file>Asymptote</file> on <file>figure1.asy</file>, so that the document
-can later read in the resulting graphic (<pxref label="_005cincludegraphics"><xrefnodename>\includegraphics</xrefnodename></pxref>).
+<para>will run <file>Asymptote</file> on <file>pix/figure1.asy</file>, so that the
+document can later read in the resulting graphic
+(<pxref label="_005cincludegraphics"><xrefnodename>\includegraphics</xrefnodename></pxref>).  Like any <code>\write</code>, here &latex;
+expands macros in <var>shell_command</var> so that <code>\fignum</code> is replaced
+by <samp>1</samp>.
 </para>
 <para>Another example is that you can automatically run Bib&tex; at the start
 of each &latex; run (<pxref label="Using-BibTeX"><xrefnodename>Using BibTeX</xrefnodename></pxref>) by including
 <code>\immediate\write18{bibtex8 \jobname}</code> as the first line of the
-file.  Like any <code>\write</code>, here &latex; expands macros in
-<var>shell_command</var> so that <code>\jobname</code> gives the base name of the
-current file.
+file.  Note that <code>\jobname</code> gives the base name of the current
+file.
 </para>
 <para>You sometimes need to do a multi-step process to get the information
-that you want.  This will get a list of all PDF files in the current
-directory.
+that you want.  This will insert into the input a list of all PDF files
+in the current directory.
 </para>
 <example endspaces=" ">
 <pre xml:space="preserve">\immediate\write18{ls *.pdf > tmp.dat}
@@ -19188,10 +19255,8 @@
 
 <para>The standard behaviour of any <code>\write</code> is to wait until a page is
 being shipped out before expanding the macros or writing to the stream
-(<pxref label="_005cwrite"><xrefnodename>\write</xrefnodename></pxref>). But sometimes you want it done now.  The command
-<code>\immediate\write18{<var>shell_command</var>}</code> will send
-<var>shell_command</var> to the operating system for execution now, rather
-than waiting until the next shipout.
+(<pxref label="_005cwrite"><xrefnodename>\write</xrefnodename></pxref>). But sometimes you want it done now.  For this, use
+<code>\immediate\write18{<var>shell_command</var>}</code>.
 </para>
 <para>There are obvious security issues with allowing system commands inside a
 &latex; file.  If you download a file off the net and it contains
@@ -19207,21 +19272,23 @@
 run MetaFont to generate missing fonts, even if you do not use the
 <code>shell-escape</code> or <code>enable-write18</code> option. By default this
 list of allowed commands is short and features only commands that are
-under the control of the distribution maintainers.
+under the control of the distribution maintainers (<pxref label="Command-line-options"><xrefnodename>Command line
+options</xrefnodename></pxref>).
 </para>
 <para>Some packages need to run external system commands. For instance
 <file>sagetex</file> allows you to have the mathematics software system
 <i>Sage</i> do calculations or draw graphs and then incorporate that output
 in your document. For this you must compile with full <code>\write18</code>
-capability turned on (<pxref label="Command-line-options"><xrefnodename>Command line options</xrefnodename></pxref>).
+capability turned on.
 </para>
+
 </subsection>
 </section>
 </chapter>
 <node name="Command-line" spaces=" "><nodename>Command line</nodename><nodenext automatic="on">Document templates</nodenext><nodeprev automatic="on">Input/output</nodeprev><nodeup automatic="on">Top</nodeup></node>
 <chapter spaces=" "><sectiontitle>Command line</sectiontitle>
 
-<cindex index="cp" spaces=" "><indexterm index="cp" number="965">command line</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="967">command line</indexterm></cindex>
 
 <para>Synopsis (from a terminal command line):
 </para>
@@ -19241,7 +19308,7 @@
 </pre></example>
 
 <noindent></noindent>
-<para><findex index="fn" spaces=" "><indexterm index="fn" number="1102" mergedindex="cp">.tex, <r>default extension</r></indexterm></findex>
+<para><findex index="fn" spaces=" "><indexterm index="fn" number="1106" mergedindex="cp">.tex, <r>default extension</r></indexterm></findex>
 Note that <file>.tex</file> is the default file extension.
 </para>
 <para>pdf&tex; is a development of the original &tex; program, as are
@@ -19282,7 +19349,7 @@
 <node name="Command-line-options" spaces=" "><nodename>Command line options</nodename><nodenext automatic="on">Command line input</nodenext><nodeup automatic="on">Command line</nodeup></node>
 <section spaces=" "><sectiontitle>Command line options</sectiontitle>
 
-<cindex index="cp" spaces=" "><indexterm index="cp" number="966">options, command line</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="968">options, command line</indexterm></cindex>
 
 <para>These are the command-line options relevant to ordinary document
 authoring. For a full list, try running <samp>latex --help</samp> from the
@@ -19294,17 +19361,17 @@
 conventions interchangeably.
 </para>
 <table commandarg="code" spaces=" " endspaces=" ">
-<beforefirstitem><findex index="fn" spaces=" "><indexterm index="fn" number="1103" mergedindex="cp">--version <r>command-line option</r></indexterm></findex>
+<beforefirstitem><findex index="fn" spaces=" "><indexterm index="fn" number="1107" mergedindex="cp">--version <r>command-line option</r></indexterm></findex>
 </beforefirstitem><tableentry><tableterm><item spaces=" "><itemformat command="code">-version</itemformat></item>
 </tableterm><tableitem><para>Show the current version, like <samp>pdfTeX 3.14159265-2.6-1.40.16 (TeX
 Live 2015/Debian)</samp> along with a small amount of additional information,
 and exit.
 </para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1104" mergedindex="cp">--help <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1108" mergedindex="cp">--help <r>command-line option</r></indexterm></findex>
 </tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-help</itemformat></item>
 </tableterm><tableitem><para>Give a brief usage message that is useful as a prompt and exit.
 </para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1105" mergedindex="cp">--interaction <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1109" mergedindex="cp">--interaction <r>command-line option</r></indexterm></findex>
 </tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-interaction=<var>mode</var></itemformat></item>
 </tableterm><tableitem><para>&tex; compiles a document in one of four interaction modes:
 <code>batchmode</code>, <code>nonstopmode</code>, <code>scrollmode</code>,
@@ -19326,7 +19393,7 @@
 <noindent></noindent>
 <para>eliminates most terminal output.
 </para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1106" mergedindex="cp">--jobname <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1110" mergedindex="cp">--jobname <r>command-line option</r></indexterm></findex>
 </tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-jobname=<var>string</var></itemformat></item>
 </tableterm><tableitem><para>Set the value of &tex;&textrsquo;s <code>jobname</code> to the string.  The log file
 and output file will then be named <file><var>string</var>.log</file> and
@@ -19340,14 +19407,14 @@
 <code>jobname</code> option overrides that process and directly specifies the
 name.  <xref label="Command-line-input"><xrefnodename>Command line input</xrefnodename></xref> for an example of its use.
 </para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1107" mergedindex="cp">--output-directory <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1111" mergedindex="cp">--output-directory <r>command-line option</r></indexterm></findex>
 </tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-output-directory=<var>directory</var></itemformat></item>
 </tableterm><tableitem><para>Write files in the directory <var>directory</var>.  It must already exist.
 </para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1108" mergedindex="cp">--shell-escape <r>command-line option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1109" mergedindex="cp">--no-shell-escape <r>command-line option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1110" mergedindex="cp">--enable-write18 <r>command-line option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1111" mergedindex="cp">--disable-write18 <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1112" mergedindex="cp">--shell-escape <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1113" mergedindex="cp">--no-shell-escape <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1114" mergedindex="cp">--enable-write18 <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1115" mergedindex="cp">--disable-write18 <r>command-line option</r></indexterm></findex>
 </tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">--shell-escape</itemformat></item>
 <itemx spaces=" "><itemformat command="code">--no-shell-escape</itemformat></itemx>
 <itemx spaces=" "><itemformat command="code">--enable-write18</itemformat></itemx>
@@ -19356,8 +19423,8 @@
 (<pxref label="_005cwrite18"><xrefnodename>\write18</xrefnodename></pxref>).  The first two options are for with &tex; Live or
 Mac&tex; while the second two are for MiK&tex;.
 </para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="967"><r>package</r>, <code>sagetex</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="968"><code>sagetex</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="969"><r>package</r>, <code>sagetex</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="970"><code>sagetex</code> <r>package</r></indexterm></cindex>
 
 <para>Sometimes you want to run external system commands from inside a
 &latex; file. For instance the package <file>sagetex</file> allows you to
@@ -19375,12 +19442,12 @@
 your document you call <code>\write18{ls -l}</code>, then you do not get an
 error but the log file says <samp>runsystem(ls -l)...disabled</samp>.
 </para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1112" mergedindex="cp">--halt-on-error <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1116" mergedindex="cp">--halt-on-error <r>command-line option</r></indexterm></findex>
 </tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-halt-on-error</itemformat></item>
 </tableterm><tableitem><para>Stop processing at the first error.
 </para>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1113" mergedindex="cp">--file-line-error <r>command-line option</r></indexterm></findex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1114" mergedindex="cp">--no-file-line-error <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1117" mergedindex="cp">--file-line-error <r>command-line option</r></indexterm></findex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1118" mergedindex="cp">--no-file-line-error <r>command-line option</r></indexterm></findex>
 </tableitem></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-file-line-error</itemformat></item>
 </tableterm></tableentry><tableentry><tableterm><item spaces=" "><itemformat command="code">-no-file-line-error</itemformat></item>
 </tableterm><tableitem><para>Enable or disable <code><var>filename</var>:<var>lineno</var>:<var>error</var></code>-style
@@ -19392,15 +19459,15 @@
 <node name="Command-line-input" spaces=" "><nodename>Command line input</nodename><nodenext automatic="on">Recovering from errors</nodenext><nodeprev automatic="on">Command line options</nodeprev><nodeup automatic="on">Command line</nodeup></node>
 <section spaces=" "><sectiontitle>Command line input</sectiontitle>
 
-<cindex index="cp" spaces=" "><indexterm index="cp" number="969">input, on command line</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="971">input, on command line</indexterm></cindex>
 
 <para>As part of the command line invocation <code>pdflatex <var>options</var>
 <var>argument</var></code> you can specify arbitrary &latex; input by starting
 <var>argument</var> with a backslash. This allows you to do some special
 effects.
 </para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="970"><r>package</r>, <code>hyperref</code></indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="971"><code>hyperref</code> <r>package</r></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="972"><r>package</r>, <code>hyperref</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="973"><code>hyperref</code> <r>package</r></indexterm></cindex>
 
 <para>For example, this file (which uses the <file>hyperref</file> package for
 hyperlinks) can produce two kinds of output, one for paper and one for a
@@ -19482,9 +19549,9 @@
 typo.  You could instead enter <samp>?</samp> and <code><return></code> to see other
 options.
 </para>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="972"><samp>*</samp> prompt</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="973">prompt, <samp>*</samp></indexterm></cindex>
-<findex index="fn" spaces=" "><indexterm index="fn" number="1115" mergedindex="cp">\stop</indexterm></findex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="974"><samp>*</samp> prompt</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="975">prompt, <samp>*</samp></indexterm></cindex>
+<findex index="fn" spaces=" "><indexterm index="fn" number="1119" mergedindex="cp">\stop</indexterm></findex>
 <para>There are two other error scenarios.  The first is that you forgot to
 include the <code>\end{document}</code> or misspelled it.  In this case
 &latex; gives you a <samp>*</samp> prompt.  You can get back to the command
@@ -19511,8 +19578,8 @@
 <node name="Document-templates" spaces=" "><nodename>Document templates</nodename><nodenext automatic="on">Index</nodenext><nodeprev automatic="on">Command line</nodeprev><nodeup automatic="on">Top</nodeup></node>
 <appendix spaces=" "><sectiontitle>Document templates</sectiontitle>
 
-<cindex index="cp" spaces=" "><indexterm index="cp" number="974">document templates</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="975">templates, document</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="976">document templates</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="977">templates, document</indexterm></cindex>
 
 <para>Although not reference material, perhaps these document templates will
 be useful.  Additional template resources are listed at
@@ -19530,8 +19597,8 @@
 <node name="beamer-template" spaces=" "><nodename>beamer template</nodename><nodenext automatic="on">article template</nodenext><nodeup automatic="on">Document templates</nodeup></node>
 <section spaces=" "><sectiontitle><code>beamer</code> template</sectiontitle>
 
-<cindex index="cp" spaces=" "><indexterm index="cp" number="976"><code>beamer</code> template and class</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="977">template, <code>beamer</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="978"><code>beamer</code> template and class</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="979">template, <code>beamer</code></indexterm></cindex>
 
 <para>The <code>beamer</code> class creates presentation slides.  It has a vast
 array of features, but here is a basic template:
@@ -19568,7 +19635,7 @@
 <node name="article-template" spaces=" "><nodename>article template</nodename><nodenext automatic="on">book template</nodenext><nodeprev automatic="on">beamer template</nodeprev><nodeup automatic="on">Document templates</nodeup></node>
 <section spaces=" "><sectiontitle><code>article</code> template</sectiontitle>
 
-<cindex index="cp" spaces=" "><indexterm index="cp" number="978">template, <code>article</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="980">template, <code>article</code></indexterm></cindex>
 
 <verbatim xml:space="preserve">
 \documentclass{article}
@@ -19594,7 +19661,7 @@
 <node name="book-template" spaces=" "><nodename>book template</nodename><nodenext automatic="on">Larger book template</nodenext><nodeprev automatic="on">article template</nodeprev><nodeup automatic="on">Document templates</nodeup></node>
 <section spaces=" "><sectiontitle><code>book</code> template</sectiontitle>
 
-<cindex index="cp" spaces=" "><indexterm index="cp" number="979">template, <code>book</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="981">template, <code>book</code></indexterm></cindex>
 
 <para>This is a straightforward template for a book.  See <xref label="Larger-book-template"><xrefnodename>Larger book
 template</xrefnodename></xref> for a more elaborate one.
@@ -19623,7 +19690,7 @@
 <node name="Larger-book-template" spaces=" "><nodename>Larger book template</nodename><nodenext automatic="on">tugboat template</nodenext><nodeprev automatic="on">book template</nodeprev><nodeup automatic="on">Document templates</nodeup></node>
 <section spaces=" "><sectiontitle>Larger <code>book</code> template</sectiontitle>
 
-<cindex index="cp" spaces=" "><indexterm index="cp" number="980">template, <code>book</code></indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="982">template, <code>book</code></indexterm></cindex>
 
 <para>This is a more elaborate template for a book.  It has
 <code>\frontmatter</code>, <code>\mainmatter</code>, and <code>\backmatter</code> to
@@ -19680,9 +19747,9 @@
 <node name="tugboat-template" spaces=" "><nodename>tugboat template</nodename><nodeprev automatic="on">Larger book template</nodeprev><nodeup automatic="on">Document templates</nodeup></node>
 <section spaces=" "><sectiontitle><code>tugboat</code> template</sectiontitle>
 
-<cindex index="cp" spaces=" "><indexterm index="cp" number="981">template, TUGboat</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="982">TUGboat template</indexterm></cindex>
-<cindex index="cp" spaces=" "><indexterm index="cp" number="983"><code>ltugboat</code> class</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="983">template, TUGboat</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="984">TUGboat template</indexterm></cindex>
+<cindex index="cp" spaces=" "><indexterm index="cp" number="985"><code>ltugboat</code> class</indexterm></cindex>
 
 <para><cite>TUGboat</cite> is the journal of the &tex; Users Group,
 <url><urefurl>http://tug.org/TUGboat</urefurl></url>.

Modified: trunk/src/keeptrack.csv
===================================================================
--- trunk/src/keeptrack.csv	2018-10-21 11:02:51 UTC (rev 715)
+++ trunk/src/keeptrack.csv	2018-10-21 21:39:31 UTC (rev 716)
@@ -2996,7 +2996,7 @@
 \widowpenalties todo 
 \widowpenalty todo 
 \width done 
-\wlog todo 
+\wlog done 
 \wp done 
 \wr done 
 \wrong at fontshape notdoing 



More information about the latexrefman-commits mailing list