summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk')
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk492
1 files changed, 281 insertions, 211 deletions
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk
index 94aba2c18a0..10eb5b9ea47 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk
@@ -4,18 +4,18 @@
<!ENTITY latex "LaTeX">
]>
<book id="latex2e.dbk" lang="en">
-<title>&latex;2e reference manual (May 2013)</title>
+<title>&latex;2e reference manual (May 2014)</title>
<!-- %**end of header (This is for running Texinfo on a region.) -->
<!-- latex 2.09 commands should all be present now, -->
<!-- xx but latex2e stuff is missing. -->
<!-- -->
-<!-- xx mention \topnumber, \bottomnumber, \totalnumber -->
<!-- xx mention \nocorr, \textit and ic -->
<!-- xx give actual smallskip/etc. defaults -->
<!-- -->
<!-- xx merge http://ctan.org/tex-archive/info/latex-info/ (alt-latex-info) -->
<!-- xx merge permuted-index -->
+<!-- xx merge latex-manual from savannah -->
<!-- -->
<!-- xx The typeset source2e has an index with all kernel -->
<!-- xx commands, though some are internal and shouldn't be included. -->
@@ -25,7 +25,7 @@
<!-- xx packages - required, additional, useful; oberdiek; fonts -->
<bookinfo><legalnotice><para>This document is an unofficial reference manual for &latex;, a
-document preparation system, version of May 2013.
+document preparation system, version of May 2014.
</para>
<para>This manual was originally translated from <filename>LATEX.HLP</filename> v1.0a in
the VMS Help Library. The pre-translation version was written by
@@ -33,17 +33,18 @@ George&#160;D. Greenwade of Sam Houston State University. The
&latex;&#160;2.09 version was written by Stephen Gilmore. The
&latex;2e version was adapted from this by Torsten Martinsen. Karl
Berry made further updates and additions, and gratefully acknowledges
-using <citetitle>Hypertext Help with &latex;</citetitle>, by Sheldon Green, and the
+using <citetitle>Hypertext Help with &latex;</citetitle>, by Sheldon Green, and
<citetitle>&latex; Command Summary</citetitle> (for &latex; 2.09) by L.&#160;Botway
and C.&#160;Biemesderfer (published by the &tex; Users Group as
<citetitle>&tex;niques</citetitle> number 10), as reference material (no text was
directly copied).
</para>
-<para>Copyright &#169; 2007, 2008, 2009, 2010, 2011, 2012, 2013 Karl Berry.
+<para>Copyright 2007, 2008, 2009, 2010, 2011, 2012, 2013,
+2014 Karl Berry.
-Copyright &#169; 1988, 1994, 2007 Stephen Gilmore.
+Copyright 1988, 1994, 2007 Stephen Gilmore.
-Copyright &#169; 1994, 1995, 1996 Torsten Martinsen.
+Copyright 1994, 1995, 1996 Torsten Martinsen.
</para>
<para>Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
@@ -61,7 +62,7 @@ into another language, under the above conditions for modified versions.
<para>This document is an unofficial reference manual for &latex;, a
-document preparation system, version of May 2013.
+document preparation system, version of May 2014.
</para>
<para>This manual was originally translated from <filename>LATEX.HLP</filename> v1.0a in
the VMS Help Library. The pre-translation version was written by
@@ -69,17 +70,18 @@ George&#160;D. Greenwade of Sam Houston State University. The
&latex;&#160;2.09 version was written by Stephen Gilmore. The
&latex;2e version was adapted from this by Torsten Martinsen. Karl
Berry made further updates and additions, and gratefully acknowledges
-using <citetitle>Hypertext Help with &latex;</citetitle>, by Sheldon Green, and the
+using <citetitle>Hypertext Help with &latex;</citetitle>, by Sheldon Green, and
<citetitle>&latex; Command Summary</citetitle> (for &latex; 2.09) by L.&#160;Botway
and C.&#160;Biemesderfer (published by the &tex; Users Group as
<citetitle>&tex;niques</citetitle> number 10), as reference material (no text was
directly copied).
</para>
-<para>Copyright &#169; 2007, 2008, 2009, 2010, 2011, 2012, 2013 Karl Berry.
+<para>Copyright 2007, 2008, 2009, 2010, 2011, 2012, 2013,
+2014 Karl Berry.
-Copyright &#169; 1988, 1994, 2007 Stephen Gilmore.
+Copyright 1988, 1994, 2007 Stephen Gilmore.
-Copyright &#169; 1994, 1995, 1996 Torsten Martinsen.
+Copyright 1994, 1995, 1996 Torsten Martinsen.
</para>
<para>Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
@@ -100,7 +102,7 @@ into another language, under the above conditions for modified versions.
<title>&latex;2e</title>
<para>This document is an unofficial reference manual for &latex;, a
-document preparation system, version as of May 2013. It is
+document preparation system, version as of May 2014. It is
intended to cover &latex;2e, which has been the standard version of
&latex; for many years.
</para>
@@ -122,7 +124,7 @@ available from their web site.
</para>
<indexterm role="cp"><primary>bug reporting</primary></indexterm>
<indexterm role="cp"><primary>reporting bugs</primary></indexterm>
-<indexterm role="fn"><primary><email>latexrefman-discuss@gna.org</email> <lineannotation>email address</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary><email>latexrefman-discuss@gna.org</email> email address</primary></indexterm>
<para>The present document is completely unofficial and has not been
reviewed by the &latex; maintainers. Do not send bug reports or
anything else about this document to them. Instead, please send all
@@ -169,8 +171,8 @@ least three files as output:
<orderedlist numeration="arabic"><listitem><para>The main output file, which is one of:
</para>
<variablelist><varlistentry><term><literal>.dvi</literal>
-</term><listitem><indexterm role="fn"><primary>.dvi <lineannotation>file</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>latex <lineannotation>command</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>.dvi file</primary></indexterm>
+<indexterm role="fn"><primary>latex command</primary></indexterm>
<para>If invoked as <command>latex</command>, a &#8220;Device Independent&#8221; (<filename>.dvi</filename>)
file is produced. This contains commands that can be translated into
commands for virtually any output device. You can view such
@@ -179,21 +181,21 @@ commands for virtually any output device. You can view such
PostScript), or <command>dvipdfmx</command> (convert to PDF).
</para>
</listitem></varlistentry><varlistentry><term><literal>.pdf</literal>
-</term><listitem><indexterm role="fn"><primary>.pdf <lineannotation>file</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>.pdf file</primary></indexterm>
<indexterm role="cp"><primary>pdf&tex;</primary></indexterm>
-<indexterm role="fn"><primary>pdflatex <lineannotation>command</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>pdflatex command</primary></indexterm>
<para>If invoked as <command>pdflatex</command>, a &#8220;Portable Document Format&#8221;
(<filename>.pdf</filename>) file. Typically, this is a self-contained file, with
all fonts and images embedded. This can be very useful, but it does
make the output much larger than the <filename>.dvi</filename> produced from the
same document.
</para>
-<indexterm role="fn"><primary>lualatex <lineannotation>command</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>lualatex command</primary></indexterm>
<indexterm role="cp"><primary>Lua&tex;</primary></indexterm>
<para>If invoked as <command>lualatex</command>, a <filename>.pdf</filename> file is created using
the Lua&tex; engine (<ulink url="http://luatex.org">http://luatex.org</ulink>).
</para>
-<indexterm role="fn"><primary>xelatex <lineannotation>command</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>xelatex command</primary></indexterm>
<indexterm role="cp"><primary>Xe&tex;</primary></indexterm>
<para>If invoked as <command>xelatex</command>, a <filename>.pdf</filename> file is created using
the Xe&tex; engine (<ulink url="http://tug.org/xetex">http://tug.org/xetex</ulink>).
@@ -204,22 +206,22 @@ can produce HTML, XML, and other things.
</para>
</listitem><listitem><indexterm role="cp"><primary>transcript file</primary></indexterm>
<indexterm role="cp"><primary>log file</primary></indexterm>
-<indexterm role="fn"><primary>.log <lineannotation>file</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>.log file</primary></indexterm>
<para>The &#8220;transcript&#8221; or <filename>.log</filename> file that contains summary
information and diagnostic messages for any errors discovered in the
input file.
</para>
</listitem><listitem><indexterm role="cp"><primary>auxiliary file</primary></indexterm>
-<indexterm role="fn"><primary>.aux <lineannotation>file</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>.aux file</primary></indexterm>
<para>An &#8220;auxiliary&#8221; or <filename>.aux</filename> file. This is used by &latex; itself,
for things such as cross-references.
</para></listitem></orderedlist>
<para>An open-ended list of other files might be created. We won&#8217;t try to
list them all. Xxx components?
</para>
-<indexterm role="fn"><primary>\ <lineannotation>character starting commands</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>[...] <lineannotation>for optional arguments</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>{...} <lineannotation>for required arguments</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\ character starting commands</primary></indexterm>
+<indexterm role="fn"><primary>[...] for optional arguments</primary></indexterm>
+<indexterm role="fn"><primary>{...} for required arguments</primary></indexterm>
<para>In the &latex; input file, a command name starts with a <literal>\</literal>,
followed by either (a)&#160;a string of letters or (b)&#160;a single
non-letter. Arguments contained in square brackets, <literal>[]</literal>, are
@@ -270,11 +272,11 @@ and the <literal>\begin{document}</literal> commands (this area is called the
<para>The <literal>\documentclass</literal> command must be the first command in a
&latex; source file.
</para>
-<indexterm role="fn"><primary>article <lineannotation>class</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>report <lineannotation>class</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>book <lineannotation>class</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>letter <lineannotation>class</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>slides <lineannotation>class</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>article class</primary></indexterm>
+<indexterm role="fn"><primary>report class</primary></indexterm>
+<indexterm role="fn"><primary>book class</primary></indexterm>
+<indexterm role="fn"><primary>letter class</primary></indexterm>
+<indexterm role="fn"><primary>slides class</primary></indexterm>
<para>Built-in &latex; document <replaceable>class</replaceable> names are (many other document
classes are available as add-ons; see <link linkend="Overview">Overview</link>):
</para>
@@ -303,33 +305,33 @@ them with a comma:
</screen>
<para>Here is the list of the standard class options.
</para>
-<indexterm role="fn"><primary>10pt <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>11pt <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>12pt <lineannotation>option</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>10pt option</primary></indexterm>
+<indexterm role="fn"><primary>11pt option</primary></indexterm>
+<indexterm role="fn"><primary>12pt option</primary></indexterm>
<para>All of the standard classes except <literal>slides</literal> accept the following
options for selecting the typeface size (default is <literal>10pt</literal>):
</para>
<screen>10pt 11pt 12pt
</screen>
-<indexterm role="fn"><primary>a4paper <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>a5paper <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>b5paper <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>executivepaper <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>legalpaper <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>letterpaper <lineannotation>option</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>a4paper option</primary></indexterm>
+<indexterm role="fn"><primary>a5paper option</primary></indexterm>
+<indexterm role="fn"><primary>b5paper option</primary></indexterm>
+<indexterm role="fn"><primary>executivepaper option</primary></indexterm>
+<indexterm role="fn"><primary>legalpaper option</primary></indexterm>
+<indexterm role="fn"><primary>letterpaper option</primary></indexterm>
<para>All of the standard classes accept these options for selecting the paper
size (default is <literal>letterpaper</literal>):
</para>
<screen>a4paper a5paper b5paper executivepaper legalpaper letterpaper
</screen>
-<indexterm role="fn"><primary>draft <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>final <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>fleqn <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>landscape <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>leqno <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>openbib <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>titlepage <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>notitlepage <lineannotation>option</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>draft option</primary></indexterm>
+<indexterm role="fn"><primary>final option</primary></indexterm>
+<indexterm role="fn"><primary>fleqn option</primary></indexterm>
+<indexterm role="fn"><primary>landscape option</primary></indexterm>
+<indexterm role="fn"><primary>leqno option</primary></indexterm>
+<indexterm role="fn"><primary>openbib option</primary></indexterm>
+<indexterm role="fn"><primary>titlepage option</primary></indexterm>
+<indexterm role="fn"><primary>notitlepage option</primary></indexterm>
<para>Miscellaneous other options:
</para>
<variablelist><varlistentry><term><literal>draft, final</literal>
@@ -348,12 +350,12 @@ size (default is <literal>letterpaper</literal>):
</para></listitem></varlistentry></variablelist>
<para>These options are not available with the slides class:
</para>
-<indexterm role="fn"><primary>onecolumn <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>twocolumn <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>oneside <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>twoside <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>openright <lineannotation>option</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>openany <lineannotation>option</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>onecolumn option</primary></indexterm>
+<indexterm role="fn"><primary>twocolumn option</primary></indexterm>
+<indexterm role="fn"><primary>oneside option</primary></indexterm>
+<indexterm role="fn"><primary>twoside option</primary></indexterm>
+<indexterm role="fn"><primary>openright option</primary></indexterm>
+<indexterm role="fn"><primary>openany option</primary></indexterm>
<variablelist><varlistentry><term><literal>onecolumn</literal>
</term><term><literal>twocolumn</literal>
</term><listitem><para>Typeset in one or two columns; default is <literal>onecolumn</literal>.
@@ -401,8 +403,9 @@ by the selected document class are passed on to the packages loaded with
</sect1>
</chapter>
-<chapter label="5" id="Typefaces">
-<title>Typefaces</title>
+<chapter label="5" id="Fonts">
+<title>Fonts</title>
+<anchor id="Typefaces"/><!-- old name -->
<indexterm role="cp"><primary>typefaces</primary></indexterm>
<indexterm role="cp"><primary>fonts</primary></indexterm>
@@ -421,21 +424,22 @@ and a style. The &latex; commands for doing this are described here.
<para>The following type style commands are supported by &latex;.
</para>
-<para>This first group of commands is typically used like
-<literal>\textit{italic text}</literal>. The corresponding command in
-parenthesis is the &#8220;declaration form&#8221;, which takes no arguments. The
-scope of the declaration form lasts until the next type style command
-or the end of the current group.
+<para>This first group of commands is typically used with an argument, as in
+<literal>\textit{italic text}</literal>. In the table below, the corresponding
+command in parenthesis is the &#8220;declaration form&#8221;, which takes no
+arguments. The scope of the declaration form lasts until the next type
+style command or the end of the current group.
</para>
-<para>The declaration forms are cumulative; i.e., you can say either
-<literal>\sffamily\bfseries</literal> or <literal>\bfseries\sffamily</literal> to get bold
-sans serif.
+<para>These commands, in both the argument form and the declaration form,
+are cumulative; e.g.,, you can say either <literal>\sffamily\bfseries</literal> or
+<literal>\bfseries\sffamily</literal> to get bold sans serif.
</para>
<para>You can alternatively use an environment form of the declarations; for
instance, <literal>\begin{ttfamily}...\end{ttfamily}</literal>.
</para>
-<para>These commands automatically supply an italic correction if the
-</para><variablelist><varlistentry><term><literal>\textrm (\rmfamily)</literal>
+<para>These commands automatically supply an italic correction if needed.
+</para>
+<variablelist><varlistentry><term><literal>\textrm (\rmfamily)</literal>
</term><listitem><indexterm role="fn"><primary>\textrm</primary></indexterm>
<indexterm role="fn"><primary>\rmfamily</primary></indexterm>
<para>Roman.
@@ -520,6 +524,8 @@ instance, <literal>\begin{ttfamily}...\end{ttfamily}</literal>.
</para>
</listitem></varlistentry></variablelist>
<indexterm role="fn"><primary>\mathversion</primary></indexterm>
+<indexterm role="cp"><primary>math, bold</primary></indexterm>
+<indexterm role="cp"><primary>bold math</primary></indexterm>
<para>In addition, the command <literal>\mathversion{bold}</literal> can be used for
switching to bold letters and symbols in
formulas. <literal>\mathversion{normal}</literal> restores the default.
@@ -539,11 +545,11 @@ numerals also; sometimes the <literal>textcomp</literal> package must be loaded,
and sometimes package options are provided to make them the default.
FAQ entry: <ulink url="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=osf">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=osf</ulink>.
</para>
-<para>&latex; also provides these commands, which unconditionally switch to
-the given style, that is, are <emphasis>not</emphasis> cumulative. They are used
-differently than the above commands, too: <literal>{\<replaceable>cmd</replaceable> ...}</literal>
-instead of <literal>\<replaceable>cmd</replaceable>{...}</literal>. These are two very different
-things.
+<para>&latex; also provides the following commands, which unconditionally
+switch to the given style, that is, are <emphasis>not</emphasis> cumulative. Also,
+they are used differently than the above commands: <literal>{\<replaceable>cmd</replaceable>
+...}</literal> instead of <literal>\<replaceable>cmd</replaceable>{...}</literal>. These are two very
+different things.
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\bf</primary></indexterm><literal>\bf</literal>
</term><listitem><indexterm role="cp"><primary>bold font</primary></indexterm>
@@ -586,6 +592,14 @@ things.
<para>Typewriter (monospace, fixed-width).
</para>
</listitem></varlistentry></variablelist>
+<para>Some people consider the unconditional font-switching commands, such
+as <literal>\tt</literal>, obsolete and <emphasis>only</emphasis> the cumulative commands
+(<literal>\texttt</literal>) should be used. I (Karl) do not agree. There are
+perfectly reasonable situations when an unconditional font switch is
+precisely what you need to get the desired output; for one example,
+see <link linkend="description"><literal>description</literal></link>. Both sets of commands have
+their place.
+</para>
</sect1>
<sect1 label="5.2" id="Font-sizes">
@@ -956,7 +970,7 @@ command is something like
\appendix
\chapter{The First Appendix}
</screen>
-<indexterm role="fn"><primary>secnumdepth <lineannotation>counter</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>secnumdepth counter</primary></indexterm>
<indexterm role="cp"><primary>section numbers, printing</primary></indexterm>
<para>The <literal>secnumdepth</literal> counter controls printing of section numbers.
The setting
@@ -1068,7 +1082,7 @@ Each environment begins and ends in the same manner:
<sect1 label="9.1" id="abstract">
<title><literal>abstract</literal></title>
-<indexterm role="fn"><primary>abstract <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>abstract environment</primary></indexterm>
<indexterm role="cp"><primary>abstracts</primary></indexterm>
<para>Synopsis:
@@ -1082,7 +1096,7 @@ Each environment begins and ends in the same manner:
</sect1>
<sect1 label="9.2" id="array">
<title><literal>array</literal></title>
-<indexterm role="fn"><primary>array <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>array environment</primary></indexterm>
<indexterm role="cp"><primary>arrays, math</primary></indexterm>
<para>Synopsis:
@@ -1137,7 +1151,7 @@ namely <literal>\arrayrulewidth</literal> and <literal>\arraystretch</literal>.
<sect1 label="9.3" id="center">
<title><literal>center</literal></title>
-<indexterm role="fn"><primary>center <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>center environment</primary></indexterm>
<indexterm role="cp"><primary>centering text, environment for</primary></indexterm>
<para>Synopsis:
@@ -1187,7 +1201,7 @@ second line \\
<sect1 label="9.4" id="description">
<title><literal>description</literal></title>
-<indexterm role="fn"><primary>description <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>description environment</primary></indexterm>
<indexterm role="cp"><primary>labelled lists, creating</primary></indexterm>
<indexterm role="cp"><primary>description lists, creating</primary></indexterm>
@@ -1220,7 +1234,7 @@ plain typewriter}]</literal>.
<sect1 label="9.5" id="displaymath">
<title><literal>displaymath</literal></title>
-<indexterm role="fn"><primary>displaymath <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>displaymath environment</primary></indexterm>
<para>Synopsis:
</para>
@@ -1245,7 +1259,7 @@ equation number, use the <literal>equation</literal> environment (see <link link
<sect1 label="9.6" id="document">
<title><literal>document</literal></title>
-<indexterm role="fn"><primary>document <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>document environment</primary></indexterm>
<para>The <literal>document</literal> environment encloses the body of a document.
It is required in every &latex; document. See <link linkend="Starting-_0026-ending">Starting &amp; ending</link>.
@@ -1255,7 +1269,7 @@ It is required in every &latex; document. See <link linkend="Starting-_0026-end
<sect1 label="9.7" id="enumerate">
<title><literal>enumerate</literal></title>
-<indexterm role="fn"><primary>enumerate <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>enumerate environment</primary></indexterm>
<indexterm role="cp"><primary>lists of items, numbered</primary></indexterm>
<para>Synopsis:
@@ -1302,7 +1316,7 @@ use <literal>\renewcommand</literal> to change the labels (see <link linkend="_0
\renewcommand</link>). For instance, to have the first level use uppercase
letters:
</para>
-<indexterm role="fn"><primary>\Alph <lineannotation>example</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\Alph example</primary></indexterm>
<screen>\renewcommand{\labelenumi}{\Alph{enumi}}
</screen>
@@ -1311,12 +1325,12 @@ letters:
<sect1 label="9.8" id="eqnarray">
<title><literal>eqnarray</literal></title>
-<indexterm role="fn"><primary>eqnarray <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>eqnarray environment</primary></indexterm>
<indexterm role="cp"><primary>equations, aligning</primary></indexterm>
<indexterm role="cp"><primary>aligning equations</primary></indexterm>
-<indexterm role="cp"><primary>align <lineannotation>environment, from <literal>amsmath</literal></lineannotation></primary></indexterm>
-<indexterm role="cp"><primary>amsmath <lineannotation>package, replacing <literal>eqnarray</literal></lineannotation></primary></indexterm>
+<indexterm role="cp"><primary>align environment, from <literal>amsmath</literal></primary></indexterm>
+<indexterm role="cp"><primary>amsmath package, replacing <literal>eqnarray</literal></primary></indexterm>
<indexterm role="cp"><primary>Madsen, Lars</primary></indexterm>
<para>First, a caveat: the <literal>eqnarray</literal> environment has some infelicities
which cannot be overcome; the article &#8220;Avoid eqnarray!&#8221; by Lars
@@ -1327,7 +1341,7 @@ others) from the <literal>amsmath</literal> package.
</para>
<para>Nevertheless, here is a description of <literal>eqnarray</literal>:
</para>
-<screen>\begin{eqnarray} <lineannotation>(or <literal>eqnarray*</literal>)</lineannotation>
+<screen>\begin{eqnarray} (or <literal>eqnarray*</literal>)
<replaceable>formula1</replaceable> \\
<replaceable>formula2</replaceable> \\
...
@@ -1361,7 +1375,7 @@ zero width.
<sect1 label="9.9" id="equation">
<title><literal>equation</literal></title>
-<indexterm role="fn"><primary>equation <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>equation environment</primary></indexterm>
<indexterm role="cp"><primary>equations, environment for</primary></indexterm>
<indexterm role="cp"><primary>formulas, environment for</primary></indexterm>
@@ -1502,9 +1516,60 @@ default 2.
</para>
</sect1>
-<sect1 label="9.11" id="flushleft">
+<sect1 label="9.11" id="filecontents">
+<title><literal>filecontents</literal>: Create external files</title>
+<indexterm role="fn"><primary>filecontents</primary></indexterm>
+<indexterm role="cp"><primary>external files, creating</primary></indexterm>
+<indexterm role="cp"><primary>writing external files</primary></indexterm>
+
+<para>Synopsis:
+</para>
+<screen>\begin{filecontents}{<replaceable>filename</replaceable>}
+<replaceable>contents-of-file</replaceable>
+\end{filecontents}
+...
+\documentclass{<replaceable>my-document-class</replaceable>}
+</screen>
+<indexterm role="cp"><primary>initial command</primary></indexterm>
+<indexterm role="fn"><primary>\documentclass, commands before</primary></indexterm>
+<para>The <literal>filecontents</literal> environment is an <firstterm>initial command</firstterm>,
+meaning that it can be used only before the <literal>\documentclass</literal>
+command, as in the synopsis above.
+</para>
+<para>&latex; will create a file named <replaceable>filename</replaceable> with the content
+<replaceable>contents-of-file</replaceable> preceded by a header comment indicating how and
+when the file was generated. If the file already exists then nothing will
+happen.
+</para>
+<para>You can also use the <literal>filecontents</literal> package, which has the
+following advantages:
+</para>
+<itemizedlist><listitem><para>If the file already exists, then it will be overwritten.
+</para>
+</listitem><listitem><para>You can use the <literal>filecontents</literal> environment at any point after the
+declaration <literal>\usepackage{filecontents}</literal>, not just before
+<literal>\documentclass</literal>.
+</para>
+</listitem><listitem><para>The <literal>filecontents</literal> package also provides a <literal>filecontents*</literal>
+environment which is used in the same way as the <literal>filecontents</literal>
+environment except that it won&#8217;t insert any leading comment, so it is
+better suited to create files which aren&#8217;t in &latex; format.
+</para>
+</listitem></itemizedlist>
+<para>The <literal>filecontents</literal> environment only creates the file, and is
+unrelated to using the created file. So you need to use, for
+instance, <literal>\input</literal> or <literal>\usepackage</literal> or <literal>\bibliography</literal>
+or whatever is applicable, to use the created file.
+</para>
+<para>This environment is also useful to make a self-contained document, for
+example, for a bug report, or to keep a <filename>.bib</filename> file with the main
+document.
+</para>
+
+</sect1>
+<sect1 label="9.12" id="flushleft">
<title><literal>flushleft</literal></title>
-<indexterm role="fn"><primary>flushleft <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>flushleft environment</primary></indexterm>
<indexterm role="cp"><primary>left-justifying text, environment for</primary></indexterm>
<indexterm role="cp"><primary>ragged right text, environment for</primary></indexterm>
@@ -1514,14 +1579,14 @@ default 2.
...
\end{flushleft}
</screen>
-<indexterm role="fn"><primary>\\ <lineannotation>for <literal>flushleft</literal></lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\\ for <literal>flushleft</literal></primary></indexterm>
<para>The <literal>flushleft</literal> environment allows you to create a paragraph
consisting of lines that are flush to the left-hand margin and ragged
right Each line must be terminated with the string <literal>\\</literal>.
</para>
-<sect2 label="9.11.1" id="_005craggedright">
+<sect2 label="9.12.1" id="_005craggedright">
<title><literal>\raggedright</literal></title>
<indexterm role="fn"><primary>\raggedright</primary></indexterm>
<indexterm role="cp"><primary>ragged right text</primary></indexterm>
@@ -1541,9 +1606,9 @@ command that ends the paragraph unit.
</sect2>
</sect1>
-<sect1 label="9.12" id="flushright">
+<sect1 label="9.13" id="flushright">
<title><literal>flushright</literal></title>
-<indexterm role="fn"><primary>flushright <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>flushright environment</primary></indexterm>
<indexterm role="cp"><primary>ragged left text, environment for</primary></indexterm>
<indexterm role="cp"><primary>right-justifying text, environment for</primary></indexterm>
@@ -1560,7 +1625,7 @@ left. Each line must be terminated with the string <literal>\\</literal>.
</para>
-<sect2 label="9.12.1" id="_005craggedleft">
+<sect2 label="9.13.1" id="_005craggedleft">
<title><literal>\raggedleft</literal></title>
<indexterm role="fn"><primary>\raggedleft</primary></indexterm>
<indexterm role="cp"><primary>ragged left text</primary></indexterm>
@@ -1580,9 +1645,9 @@ command that ends the paragraph unit.
</sect2>
</sect1>
-<sect1 label="9.13" id="itemize">
+<sect1 label="9.14" id="itemize">
<title><literal>itemize</literal></title>
-<indexterm role="fn"><primary>itemize <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>itemize environment</primary></indexterm>
<indexterm role="fn"><primary>\item</primary></indexterm>
<indexterm role="cp"><primary>lists of items</primary></indexterm>
<indexterm role="cp"><primary>unordered lists</primary></indexterm>
@@ -1690,7 +1755,7 @@ documents, <literal>3pt plus1pt minus1pt</literal> for <literal>11pt</literal>,
plus2pt minus2pt</literal> for <literal>12pt</literal>.
</para>
</listitem></varlistentry></variablelist>
-<indexterm role="fn"><primary>\parskip <lineannotation>example</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\parskip example</primary></indexterm>
<para>Especially for lists with short items, it may be desirable to elide
space between items. Here is an example defining an <literal>itemize*</literal>
environment with no extra spacing between items, or between paragraphs
@@ -1706,7 +1771,7 @@ see <link linkend="_005cparskip">\parskip</link>):
</screen>
</sect1>
-<sect1 label="9.14" id="letter">
+<sect1 label="9.15" id="letter">
<title><literal>letter</literal> environment: writing letters</title>
<indexterm role="fn"><primary>letter</primary></indexterm>
@@ -1714,7 +1779,7 @@ see <link linkend="_005cparskip">\parskip</link>):
</para>
</sect1>
-<sect1 label="9.15" id="list">
+<sect1 label="9.16" id="list">
<title><literal>list</literal></title>
<indexterm role="fn"><primary>list</primary></indexterm>
<indexterm role="cp"><primary>lists of items, generic</primary></indexterm>
@@ -1743,10 +1808,10 @@ empty, i.e., <literal>{}</literal>, which leaves the default spacing.
</para>
</sect1>
-<sect1 label="9.16" id="math">
+<sect1 label="9.17" id="math">
<title><literal>math</literal></title>
-<indexterm role="fn"><primary>math <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>math environment</primary></indexterm>
<indexterm role="cp"><primary>in-line formulas</primary></indexterm>
<para>Synopsis:
@@ -1761,10 +1826,10 @@ See <link linkend="Math-formulas">Math formulas</link>.
</para>
</sect1>
-<sect1 label="9.17" id="minipage">
+<sect1 label="9.18" id="minipage">
<title><literal>minipage</literal></title>
-<indexterm role="fn"><primary>minipage <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>minipage environment</primary></indexterm>
<indexterm role="cp"><primary>minipage, creating a</primary></indexterm>
<screen>\begin{minipage}[<replaceable>position</replaceable>][<replaceable>height</replaceable>][<replaceable>inner-pos</replaceable>]{<replaceable>width</replaceable>}
@@ -1800,7 +1865,7 @@ footnotes; they may wind up at the bottom of the wrong minipage.
</para>
</sect1>
-<sect1 label="9.18" id="picture">
+<sect1 label="9.19" id="picture">
<title><literal>picture</literal></title>
<indexterm role="fn"><primary>picture</primary></indexterm>
@@ -1881,7 +1946,7 @@ be the lower left corner of the box.
</para>
-<sect2 label="9.18.1" id="_005ccircle">
+<sect2 label="9.19.1" id="_005ccircle">
<title><literal>\circle</literal></title>
<indexterm role="fn"><primary>\circle</primary></indexterm>
@@ -1895,7 +1960,7 @@ draws a solid circle.
</para>
</sect2>
-<sect2 label="9.18.2" id="_005cmakebox-_0028picture_0029">
+<sect2 label="9.19.2" id="_005cmakebox-_0028picture_0029">
<title><literal>\makebox</literal></title>
<indexterm role="fn"><primary>\makebox (picture)</primary></indexterm>
@@ -1925,7 +1990,7 @@ your text appears in. You may select up to two of the following:
</para>
</sect2>
-<sect2 label="9.18.3" id="_005cframebox-_0028picture_0029">
+<sect2 label="9.19.3" id="_005cframebox-_0028picture_0029">
<title><literal>\framebox</literal></title>
<indexterm role="fn"><primary>\framebox</primary></indexterm>
@@ -1945,7 +2010,7 @@ and the contents of the box.
</para>
</sect2>
-<sect2 label="9.18.4" id="_005cdashbox">
+<sect2 label="9.19.4" id="_005cdashbox">
<title><literal>\dashbox</literal></title>
<indexterm role="fn"><primary>\dashbox</primary></indexterm>
@@ -1964,7 +2029,7 @@ multiples of the <literal>dlen</literal>.
</para>
</sect2>
-<sect2 label="9.18.5" id="_005cframe">
+<sect2 label="9.19.5" id="_005cframe">
<title><literal>\frame</literal></title>
<indexterm role="fn"><primary>\frame</primary></indexterm>
@@ -1978,7 +2043,7 @@ space is put between the frame and the object.
</para>
</sect2>
-<sect2 label="9.18.6" id="_005cline">
+<sect2 label="9.19.6" id="_005cline">
<title><literal>\line</literal></title>
<indexterm role="fn"><primary>\line</primary></indexterm>
@@ -1996,7 +2061,7 @@ see the <literal>curve2e</literal> and many many other packages on CTAN.
</para>
</sect2>
-<sect2 label="9.18.7" id="_005clinethickness">
+<sect2 label="9.19.7" id="_005clinethickness">
<title><literal>\linethickness</literal></title>
<indexterm role="fn"><primary>\linethickness</primary></indexterm>
@@ -2009,7 +2074,7 @@ circles, or the quarter circles drawn by <literal>\oval</literal>.
</para>
</sect2>
-<sect2 label="9.18.8" id="_005cthicklines">
+<sect2 label="9.19.8" id="_005cthicklines">
<title><literal>\thicklines</literal></title>
<indexterm role="fn"><primary>\thicklines</primary></indexterm>
@@ -2019,7 +2084,7 @@ cf.&#160;<link linkend="_005clinethickness">\linethickness</link> and <link link
</para>
</sect2>
-<sect2 label="9.18.9" id="_005cthinlines">
+<sect2 label="9.19.9" id="_005cthinlines">
<title><literal>\thinlines</literal></title>
<indexterm role="fn"><primary>\thinlines</primary></indexterm>
@@ -2029,7 +2094,7 @@ cf.&#160;<link linkend="_005clinethickness">\linethickness</link> and <link link
</para>
</sect2>
-<sect2 label="9.18.10" id="_005cmultiput">
+<sect2 label="9.19.10" id="_005cmultiput">
<title><literal>\multiput</literal></title>
<indexterm role="fn"><primary>\multiput</primary></indexterm>
@@ -2043,7 +2108,7 @@ pattern across a picture. <replaceable>obj</replaceable> is first placed at pos
</para>
</sect2>
-<sect2 label="9.18.11" id="_005coval">
+<sect2 label="9.19.11" id="_005coval">
<title><literal>\oval</literal></title>
<indexterm role="fn"><primary>\oval</primary></indexterm>
@@ -2070,7 +2135,7 @@ boxes with rounded corners.
</para>
</sect2>
-<sect2 label="9.18.12" id="_005cput">
+<sect2 label="9.19.12" id="_005cput">
<title><literal>\put</literal></title>
<indexterm role="fn"><primary>\put</primary></indexterm>
@@ -2082,7 +2147,7 @@ argument at the given coordinates.
</para>
</sect2>
-<sect2 label="9.18.13" id="_005cshortstack">
+<sect2 label="9.19.13" id="_005cshortstack">
<title><literal>\shortstack</literal></title>
<indexterm role="fn"><primary>\shortstack</primary></indexterm>
@@ -2100,12 +2165,12 @@ positions are:
</para></listitem></varlistentry><varlistentry><term><literal>c</literal>
</term><listitem><para>Move the objects to the centre of the stack (default)
</para></listitem></varlistentry></variablelist>
-<indexterm role="fn"><primary>\\ <lineannotation>(for <literal>\shortstack</literal> objects)</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\\ (for <literal>\shortstack</literal> objects)</primary></indexterm>
<para>Objects are separated with <literal>\\</literal>.
</para>
</sect2>
-<sect2 label="9.18.14" id="_005cvector">
+<sect2 label="9.19.14" id="_005cvector">
<title><literal>\vector</literal></title>
<indexterm role="fn"><primary>\vector</primary></indexterm>
@@ -2120,7 +2185,7 @@ length and slope. The <inlineequation><mathphrase>x</mathphrase></inlineequatio
</sect2>
</sect1>
-<sect1 label="9.19" id="quotation">
+<sect1 label="9.20" id="quotation">
<title><literal>quotation</literal></title>
<indexterm role="fn"><primary>quotation</primary></indexterm>
@@ -2143,7 +2208,7 @@ normally.
</para>
</sect1>
-<sect1 label="9.20" id="quote">
+<sect1 label="9.21" id="quote">
<title><literal>quote</literal></title>
<indexterm role="fn"><primary>quote</primary></indexterm>
@@ -2165,10 +2230,10 @@ blank line between text produces a new paragraph.
</para>
</sect1>
-<sect1 label="9.21" id="tabbing">
+<sect1 label="9.22" id="tabbing">
<title><literal>tabbing</literal></title>
-<indexterm role="fn"><primary>tabbing <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>tabbing environment</primary></indexterm>
<indexterm role="cp"><primary>tab stops, using</primary></indexterm>
<indexterm role="cp"><primary>lining text up using tab stops</primary></indexterm>
<indexterm role="cp"><primary>alignment via tabbing</primary></indexterm>
@@ -2191,13 +2256,13 @@ environment.
</para>
<para>The following commands can be used inside a <literal>tabbing</literal> enviroment:
</para>
-<variablelist><varlistentry><term><indexterm role="fn"><primary>\\ <lineannotation>(tabbing)</lineannotation></primary></indexterm><literal>\\ <lineannotation>(tabbing)</lineannotation></literal>
+<variablelist><varlistentry><term><indexterm role="fn"><primary>\\ (tabbing)</primary></indexterm><literal>\\ (tabbing)</literal>
</term><listitem><para>End a line.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\= <lineannotation>(tabbing)</lineannotation></primary></indexterm><literal>\= <lineannotation>(tabbing)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\= (tabbing)</primary></indexterm><literal>\= (tabbing)</literal>
</term><listitem><para>Sets a tab stop at the current position.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\&gt; <lineannotation>(tabbing)</lineannotation></primary></indexterm><literal>\&gt; <lineannotation>(tabbing)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\&gt; (tabbing)</primary></indexterm><literal>\&gt; (tabbing)</literal>
</term><listitem><indexterm role="fn"><primary>\&gt;</primary></indexterm>
<para>Advances to the next tab stop.
</para>
@@ -2215,13 +2280,13 @@ necessary.
following commands one tab stop to the left, beginning tabbed line if
necessary.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\&#8217; <lineannotation>(tabbing)</lineannotation></primary></indexterm><literal>\' <lineannotation>(tabbing)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\&#8217; (tabbing)</primary></indexterm><literal>\' (tabbing)</literal>
</term><listitem><para>Moves everything that you have typed so far in the
current column, i.e. everything from the most recent <literal>\&gt;</literal>,
<literal>\&lt;</literal>, <literal>\'</literal>, <literal>\\</literal>, or <literal>\kill</literal> command, to the right
of the previous column, flush against the current column&#8217;s tab stop.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\&#8216; <lineannotation>(tabbing)</lineannotation></primary></indexterm><literal>\` <lineannotation>(tabbing)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\&#8216; (tabbing)</primary></indexterm><literal>\` (tabbing)</literal>
</term><listitem><para>Allows you to put text flush right against any tab stop, including tab
stop&#160;0. However, it can&#8217;t move text to the right of the last column
because there&#8217;s no tab stop there. The <literal>\`</literal> command moves all the
@@ -2230,10 +2295,10 @@ command that ends the line, to the right margin of the tabbing
environment. There must be no <literal>\&gt;</literal> or <literal>\'</literal> command between
the <literal>\`</literal> and the command that ends the line.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\a <lineannotation>(tabbing)</lineannotation></primary></indexterm><literal>\a <lineannotation>(tabbing)</lineannotation></literal>
-</term><listitem><indexterm role="fn"><primary>\a&#8217; <lineannotation>(acute accent in tabbing)</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>\a&#8216; <lineannotation>(grave accent in tabbing)</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>\a= <lineannotation>(macron accent in tabbing)</lineannotation></primary></indexterm>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\a (tabbing)</primary></indexterm><literal>\a (tabbing)</literal>
+</term><listitem><indexterm role="fn"><primary>\a&#8217; (acute accent in tabbing)</primary></indexterm>
+<indexterm role="fn"><primary>\a&#8216; (grave accent in tabbing)</primary></indexterm>
+<indexterm role="fn"><primary>\a= (macron accent in tabbing)</primary></indexterm>
<para>In a <literal>tabbing</literal> environment, the commands <literal>\=</literal>, <literal>\'</literal> and
<literal>\`</literal> do not produce accents as usual (see <link linkend="Accents">Accents</link>). Instead,
the commands <literal>\a=</literal>, <literal>\a'</literal> and <literal>\a`</literal> are used.
@@ -2270,7 +2335,7 @@ function \= fact(n : integer) : integer;\\
</screen>
</sect1>
-<sect1 label="9.22" id="table">
+<sect1 label="9.23" id="table">
<title><literal>table</literal></title>
<indexterm role="fn"><primary>table</primary></indexterm>
@@ -2303,9 +2368,9 @@ you wish. The <literal>\caption</literal> command allows you to title your tabl
</para>
</sect1>
-<sect1 label="9.23" id="tabular">
+<sect1 label="9.24" id="tabular">
<title><literal>tabular</literal></title>
-<indexterm role="fn"><primary>tabular <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>tabular environment</primary></indexterm>
<indexterm role="cp"><primary>lines in tables</primary></indexterm>
<indexterm role="cp"><primary>lining text up in tables</primary></indexterm>
@@ -2326,7 +2391,7 @@ column 1 entry &amp; column 2 entry ... &amp; column n entry \\
<para>These environments produce a box consisting of a sequence of rows of
items, aligned vertically in columns.
</para>
-<indexterm role="fn"><primary>\\ <lineannotation>for <literal>tabular</literal></lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\\ for <literal>tabular</literal></primary></indexterm>
<para><literal>\\</literal> must be used to specify the end of each row of the table,
except for the last, where it is optional&#8212;unless an <literal>\hline</literal>
command (to put a rule below the table) follows.
@@ -2426,7 +2491,7 @@ environment:
</para>
-<sect2 label="9.23.1" id="_005cmulticolumn">
+<sect2 label="9.24.1" id="_005cmulticolumn">
<title><literal>\multicolumn</literal></title>
<indexterm role="fn"><primary>\multicolumn</primary></indexterm>
@@ -2452,7 +2517,7 @@ for flushleft, <literal>r</literal> for flushright. The third mandatory argumen
</screen>
</sect2>
-<sect2 label="9.23.2" id="_005ccline">
+<sect2 label="9.24.2" id="_005ccline">
<title><literal>\cline</literal></title>
<indexterm role="fn"><primary>\cline</primary></indexterm>
@@ -2466,7 +2531,7 @@ which are specified in the mandatory argument.
</para>
</sect2>
-<sect2 label="9.23.3" id="_005chline">
+<sect2 label="9.24.3" id="_005chline">
<title><literal>\hline</literal></title>
<indexterm role="fn"><primary>\hline</primary></indexterm>
@@ -2477,7 +2542,7 @@ of a table.
</para>
</sect2>
-<sect2 label="9.23.4" id="_005cvline">
+<sect2 label="9.24.4" id="_005cvline">
<title><literal>\vline</literal></title>
<indexterm role="fn"><primary>\vline</primary></indexterm>
@@ -2489,7 +2554,7 @@ move the line to the edge of the column. It can also be used in an
</sect2>
</sect1>
-<sect1 label="9.24" id="thebibliography">
+<sect1 label="9.25" id="thebibliography">
<title><literal>thebibliography</literal></title>
<indexterm role="fn"><primary>thebibliography</primary></indexterm>
@@ -2520,7 +2585,7 @@ less than 10 references, <literal>99</literal> for ones with less than 100, etc.
</para>
-<sect2 label="9.24.1" id="_005cbibitem">
+<sect2 label="9.25.1" id="_005cbibitem">
<title><literal>\bibitem</literal></title>
<indexterm role="fn"><primary>\bibitem</primary></indexterm>
@@ -2543,7 +2608,7 @@ associated label.
</para>
</sect2>
-<sect2 label="9.24.2" id="_005ccite">
+<sect2 label="9.25.2" id="_005ccite">
<title><literal>\cite</literal></title>
<indexterm role="fn"><primary>\cite</primary></indexterm>
@@ -2563,7 +2628,7 @@ citation. For example, <literal>\cite[p.~314]{knuth}</literal> might produce
</para>
</sect2>
-<sect2 label="9.24.3" id="_005cnocite">
+<sect2 label="9.25.3" id="_005cnocite">
<title><literal>\nocite</literal></title>
<indexterm role="fn"><primary>\nocite</primary></indexterm>
@@ -2574,7 +2639,7 @@ which is a list of one or more citation keys, on the <filename>.aux</filename> f
</para>
</sect2>
-<sect2 label="9.24.4" id="Using-BibTeX">
+<sect2 label="9.25.4" id="Using-BibTeX">
<title>Using Bib&tex;</title>
<indexterm role="cp"><primary>using Bib&tex;</primary></indexterm>
@@ -2621,10 +2686,10 @@ Bib&tex; format. Only the entries referred to via <literal>\cite</literal> and
</sect2>
</sect1>
-<sect1 label="9.25" id="theorem">
+<sect1 label="9.26" id="theorem">
<title><literal>theorem</literal></title>
-<indexterm role="fn"><primary>theorem <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>theorem environment</primary></indexterm>
<indexterm role="cp"><primary>theorems, typesetting</primary></indexterm>
<para>Synopsis:
@@ -2640,10 +2705,10 @@ possibilities for <replaceable>n</replaceable> are described under <literal>\new
</para>
</sect1>
-<sect1 label="9.26" id="titlepage">
+<sect1 label="9.27" id="titlepage">
<title><literal>titlepage</literal></title>
-<indexterm role="fn"><primary>titlepage <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>titlepage environment</primary></indexterm>
<indexterm role="cp"><primary>making a title page</primary></indexterm>
<indexterm role="cp"><primary>title pages, creating</primary></indexterm>
@@ -2664,10 +2729,10 @@ produce a standard title page without a <literal>titlepage</literal> environment
</para>
</sect1>
-<sect1 label="9.27" id="verbatim">
+<sect1 label="9.28" id="verbatim">
<title><literal>verbatim</literal></title>
-<indexterm role="fn"><primary>verbatim <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>verbatim environment</primary></indexterm>
<indexterm role="cp"><primary>verbatim text</primary></indexterm>
<indexterm role="cp"><primary>simulating typed text</primary></indexterm>
<indexterm role="cp"><primary>typed text, simulating</primary></indexterm>
@@ -2689,7 +2754,7 @@ effect that they would on a typewriter.
<para>The <literal>verbatim</literal> uses a monospaced typewriter-like font (<literal>\tt</literal>).
</para>
-<sect2 label="9.27.1" id="_005cverb">
+<sect2 label="9.28.1" id="_005cverb">
<title><literal>\verb</literal></title>
<indexterm role="fn"><primary>\verb</primary></indexterm>
@@ -2713,10 +2778,10 @@ verbatim text. The delimiter must not appear in <replaceable>literal-text</repl
</sect2>
</sect1>
-<sect1 label="9.28" id="verse">
+<sect1 label="9.29" id="verse">
<title><literal>verse</literal></title>
-<indexterm role="fn"><primary>verse <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>verse environment</primary></indexterm>
<indexterm role="cp"><primary>poetry, an environment for</primary></indexterm>
<para>Synopsis:
@@ -2730,7 +2795,7 @@ verbatim text. The delimiter must not appear in <replaceable>literal-text</repl
<para>The <literal>verse</literal> environment is designed for poetry, though you may find
other uses for it.
</para>
-<indexterm role="fn"><primary>\\ <lineannotation>for <literal>verse</literal></lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\\ for <literal>verse</literal></primary></indexterm>
<para>The margins are indented on the left and the right, paragraphs are not
indented, and the text is not justified. Separate the lines of each
stanza with <literal>\\</literal>, and use one or more blank lines to separate the
@@ -2757,7 +2822,7 @@ some environments, you do the line breaking yourself with the
<sect1 label="10.1" id="_005c_005c">
<title><literal>\\</literal>[*][<replaceable>morespace</replaceable>]</title>
-<indexterm role="fn"><primary>\\ <lineannotation>force line break</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\\ force line break</primary></indexterm>
<indexterm role="cp"><primary>new line, starting</primary></indexterm>
<indexterm role="cp"><primary>line break, forcing</primary></indexterm>
@@ -2799,7 +2864,7 @@ mode.
</sect1>
<sect1 label="10.4" id="_005c_002d-_0028hyphenation_0029">
<title><literal>\-</literal> (discretionary hyphen)</title>
-<indexterm role="fn"><primary>\- <lineannotation>(hyphenation)</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\- (hyphenation)</primary></indexterm>
<indexterm role="cp"><primary>hyphenation, forcing</primary></indexterm>
<para>The <literal>\-</literal> command tells &latex; that it may hyphenate the word at
@@ -3047,7 +3112,7 @@ numbers, redefine <literal>\thefootnote</literal> like this:
</para>
<screen>\renewcommand{\thefootnote}{\fnsymbol{footnote}}
</screen>
-<indexterm role="fn"><primary>\fnsymbol<lineannotation>, and footnotes</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\fnsymbol, and footnotes</primary></indexterm>
<indexterm role="fn"><primary>\@fnsymbol</primary></indexterm>
<para>The <literal>\fnsymbol</literal> command produces a predefined series of symbols
(see <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</link>). If you want to
@@ -3362,8 +3427,8 @@ symbols (conventionally used for labeling footnotes). The value of
<replaceable>counter</replaceable> must be between&#160;1 and&#160;9, inclusive.
</para>
<para>The symbols mostly aren&#8217;t supported in Info, but here are the names:
-</para><literallayout>asterix(*) dagger ddagger section-sign paragraph-sign parallel
-double-asterix(**) double-dagger double-ddagger
+</para><literallayout>asterisk(*) dagger ddagger section-sign paragraph-sign parallel
+double-asterisk(**) double-dagger double-ddagger
</literallayout>
</listitem></varlistentry></variablelist>
@@ -3671,9 +3736,9 @@ notes from falling off the bottom of the page.
<indexterm role="cp"><primary>formulas, math</primary></indexterm>
<indexterm role="cp"><primary>math mode, entering</primary></indexterm>
-<indexterm role="fn"><primary>math <lineannotation>environment</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>displaymath <lineannotation>environment</lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>equation <lineannotation>environment</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>math environment</primary></indexterm>
+<indexterm role="fn"><primary>displaymath environment</primary></indexterm>
+<indexterm role="fn"><primary>equation environment</primary></indexterm>
<para>There are three environments that put &latex; in math mode:
</para>
<variablelist><varlistentry><term><literal>math</literal>
@@ -3693,14 +3758,14 @@ but the <literal>displaymath</literal> and <literal>equation</literal> environme
only in paragraph mode. The <literal>math</literal> and <literal>displaymath</literal>
environments are used so often that they have the following short forms:
</para>
-<screen>\(...\) <lineannotation>instead of</lineannotation> \begin{math}...\end{math}
-\[...\] <lineannotation>instead of</lineannotation> \begin{displaymath}...\end{displaymath}
+<screen>\(...\) instead of \begin{math}...\end{math}
+\[...\] instead of \begin{displaymath}...\end{displaymath}
</screen>
<indexterm role="fn"><primary>$</primary></indexterm>
<para>In fact, the <literal>math</literal> environment is so common that it has an even
shorter form:
</para>
-<screen>$ ... $ <lineannotation>instead of</lineannotation> \(...\)
+<screen>$ ... $ instead of \(...\)
</screen>
<indexterm role="fn"><primary>\boldmath</primary></indexterm>
<indexterm role="fn"><primary>\unboldmath</primary></indexterm>
@@ -4727,8 +4792,8 @@ is obtained from the following declarations:
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\author{<replaceable>name</replaceable> \and <replaceable>name2</replaceable>}</primary></indexterm><literal>\author{<replaceable>name</replaceable> \and <replaceable>name2</replaceable>}</literal>
</term><listitem><indexterm role="cp"><primary>author, for titlepage</primary></indexterm>
-<indexterm role="fn"><primary>\\ <lineannotation>for <literal>\author</literal></lineannotation></primary></indexterm>
-<indexterm role="fn"><primary>\and <lineannotation>for <literal>\author</literal></lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\\ for <literal>\author</literal></primary></indexterm>
+<indexterm role="fn"><primary>\and for <literal>\author</literal></primary></indexterm>
<para>The <literal>\author</literal> command declares the document author(s), where the
argument is a list of authors separated by <literal>\and</literal> commands. Use
<literal>\\</literal> to separate lines within a single author&#8217;s entry&#8212;for
@@ -4748,7 +4813,7 @@ usually used for credit acknowledgements.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\title{<replaceable>text</replaceable>}</primary></indexterm><literal>\title{<replaceable>text</replaceable>}</literal>
</term><listitem><indexterm role="cp"><primary>title, for titlepage</primary></indexterm>
-<indexterm role="fn"><primary>\\ <lineannotation>for <literal>\title</literal></lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\\ for <literal>\title</literal></primary></indexterm>
<para>The <literal>\title</literal> command declares <replaceable>text</replaceable> to be the title of the
document. Use <literal>\\</literal> to force a line break, as usual.
</para>
@@ -4768,13 +4833,17 @@ document. Use <literal>\\</literal> to force a line break, as usual.
</para>
<variablelist><varlistentry><term><literal>arabic</literal>
</term><listitem><para>arabic numerals
-</para></listitem></varlistentry><varlistentry><term><literal>roman</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><literal>roman</literal>
</term><listitem><para>lowercase Roman numerals
-</para></listitem></varlistentry><varlistentry><term><literal>Roman</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><literal>Roman</literal>
</term><listitem><para>uppercase Roman numerals
-</para></listitem></varlistentry><varlistentry><term><literal>alph</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><literal>alph</literal>
</term><listitem><para>lowercase letters
-</para></listitem></varlistentry><varlistentry><term><literal>Alph</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><literal>Alph</literal>
</term><listitem><para>uppercase letters
</para></listitem></varlistentry></variablelist>
@@ -4813,7 +4882,7 @@ goes in the headers.
<variablelist><varlistentry><term><indexterm role="fn"><primary>\markboth{<replaceable>left</replaceable>}{<replaceable>right</replaceable>}</primary></indexterm><literal>\markboth{<replaceable>left</replaceable>}{<replaceable>right</replaceable>}</literal>
</term><listitem><para>Sets both the left and the right heading. A &#8220;left-hand heading&#8221;
(<replaceable>left</replaceable>) is generated by the last <literal>\markboth</literal> command before
-the end of the page, while a &#8220;right-hand heading&#8221; (<replaceable>right</replaceable> is
+the end of the page, while a &#8220;right-hand heading&#8221; (<replaceable>right</replaceable>) is
generated by the first <literal>\markboth</literal> or <literal>\markright</literal> that
comes on the page if there is one, otherwise by the last one before
the page.
@@ -5242,7 +5311,7 @@ included in the normal output, it is saved in the box labeled
</para>
<screen>\usebox{<replaceable>\boxcmd</replaceable>}
</screen>
-<para><literal>\usebox</literal> producesthe box most recently saved in the bin
+<para><literal>\usebox</literal> produces the box most recently saved in the bin
<replaceable>\boxcmd</replaceable> by a <literal>\savebox</literal> command (see <link linkend="_005csavebox">\savebox</link>).
</para>
@@ -5309,7 +5378,7 @@ with <literal>&quot;</literal>, so the previous example could also be written as
<title>Text symbols</title>
<indexterm role="cp"><primary>text symbols</primary></indexterm>
-<indexterm role="fn"><primary>textcomp <lineannotation>package</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>textcomp package</primary></indexterm>
<para>&latex; provides commands to generate a number of non-letter symbols
in running text. Some of these, especially the more obscure ones, are
not available in OT1; you may need to load the <literal>textcomp</literal> package.
@@ -5333,10 +5402,10 @@ not available in OT1; you may need to load the <literal>textcomp</literal> packa
<indexterm role="cp"><primary>logo, &latex;</primary></indexterm>
<para>The &latex; logo.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\guillemotleft <lineannotation>(&#171;)</lineannotation></primary></indexterm><literal>\guillemotleft <lineannotation>(&#171;)</lineannotation></literal>
-</term><term><indexterm role="fn"><primary>\guillemotright <lineannotation>(&#187;)</lineannotation></primary></indexterm><literal>\guillemotright <lineannotation>(&#187;)</lineannotation></literal>
-</term><term><indexterm role="fn"><primary>\guilsinglleft <lineannotation>(&#8249;)</lineannotation></primary></indexterm><literal>\guilsinglleft <lineannotation>(&#8249;)</lineannotation></literal>
-</term><term><indexterm role="fn"><primary>\guilsinglright <lineannotation>(&#8250;)</lineannotation></primary></indexterm><literal>\guilsinglright <lineannotation>(&#8250;)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\guillemotleft (&#171;)</primary></indexterm><literal>\guillemotleft (&#171;)</literal>
+</term><term><indexterm role="fn"><primary>\guillemotright (&#187;)</primary></indexterm><literal>\guillemotright (&#187;)</literal>
+</term><term><indexterm role="fn"><primary>\guilsinglleft (&#8249;)</primary></indexterm><literal>\guilsinglleft (&#8249;)</literal>
+</term><term><indexterm role="fn"><primary>\guilsinglright (&#8250;)</primary></indexterm><literal>\guilsinglright (&#8250;)</literal>
</term><listitem><indexterm role="cp"><primary>double guillemets</primary></indexterm>
<indexterm role="cp"><primary>single guillemets</primary></indexterm>
<indexterm role="cp"><primary>left angle quotation marks</primary></indexterm>
@@ -5372,8 +5441,8 @@ and <literal>\dots</literal> also work in math mode.
<indexterm role="cp"><primary>sterling symbol</primary></indexterm>
<para>English pounds sterling: &#163;.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\quotedblbase <lineannotation>(&#8222;)</lineannotation></primary></indexterm><literal>\quotedblbase <lineannotation>(&#8222;)</lineannotation></literal>
-</term><term><indexterm role="fn"><primary>\quotesinglbase <lineannotation>(&#8218;)</lineannotation></primary></indexterm><literal>\quotesinglbase <lineannotation>(&#8218;)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\quotedblbase (&#8222;)</primary></indexterm><literal>\quotedblbase (&#8222;)</literal>
+</term><term><indexterm role="fn"><primary>\quotesinglbase (&#8218;)</primary></indexterm><literal>\quotesinglbase (&#8218;)</literal>
</term><listitem><indexterm role="cp"><primary>double low-9 quotation mark</primary></indexterm>
<indexterm role="cp"><primary>single low-9 quotation mark</primary></indexterm>
<indexterm role="cp"><primary>low-9 quotation marks, single and double</primary></indexterm>
@@ -5466,16 +5535,16 @@ has the ascender height.
<indexterm role="cp"><primary>double dagger, in text</primary></indexterm>
<para>Double dagger: <inlineequation><mathphrase>\ddag</mathphrase></inlineequation>.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textdollar <lineannotation>(or <literal>$</literal>)</lineannotation></primary></indexterm><literal>\textdollar <lineannotation>(or <literal>$</literal>)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textdollar (or <literal>$</literal>)</primary></indexterm><literal>\textdollar (or <literal>$</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>dollar sign</primary></indexterm>
<indexterm role="cp"><primary>currency, dollar</primary></indexterm>
<para>Dollar sign: $.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textemdash <lineannotation>(or <literal>---</literal>)</lineannotation></primary></indexterm><literal>\textemdash <lineannotation>(or <literal>---</literal>)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textemdash (or <literal>---</literal>)</primary></indexterm><literal>\textemdash (or <literal>---</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>em-dash</primary></indexterm>
<para>Em-dash: &#8212; (for punctuation).
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textendash <lineannotation>(or <literal>--</literal>)</lineannotation></primary></indexterm><literal>\textendash <lineannotation>(or <literal>--</literal>)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textendash (or <literal>--</literal>)</primary></indexterm><literal>\textendash (or <literal>--</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>e-dash</primary></indexterm>
<para>En-dash: &#8212; (for ranges).
</para>
@@ -5484,7 +5553,7 @@ has the ascender height.
<indexterm role="cp"><primary>currency, euro</primary></indexterm>
<para>The Euro symbol: &#8364;.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textexclamdown <lineannotation>(or <literal>!`</literal>)</lineannotation></primary></indexterm><literal>\textexclamdown <lineannotation>(or <literal>!`</literal>)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textexclamdown (or <literal>!`</literal>)</primary></indexterm><literal>\textexclamdown (or <literal>!`</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>exclamation point, upside-down</primary></indexterm>
<para>Upside down exclamation point: &#161;.
</para>
@@ -5514,26 +5583,26 @@ has the ascender height.
<indexterm role="cp"><primary>centered period, in text</primary></indexterm>
<para>Centered period: <inlineequation><mathphrase>\cdot</mathphrase></inlineequation>.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquestiondown <lineannotation>(or <literal>?`</literal>)</lineannotation></primary></indexterm><literal>\textquestiondown <lineannotation>(or <literal>?`</literal>)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquestiondown (or <literal>?`</literal>)</primary></indexterm><literal>\textquestiondown (or <literal>?`</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>questionation point, upside-down</primary></indexterm>
<para>Upside down questionation point: &#191;.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquotedblleft <lineannotation>(or <literal>``</literal>)</lineannotation></primary></indexterm><literal>\textquotedblleft <lineannotation>(or <literal>``</literal>)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquotedblleft (or <literal>``</literal>)</primary></indexterm><literal>\textquotedblleft (or <literal>``</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>left quote, double</primary></indexterm>
<indexterm role="cp"><primary>double left quote</primary></indexterm>
<para>Double left quote: &#8220;.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquotedblright <lineannotation>(or <literal>'</literal>)</lineannotation></primary></indexterm><literal>\textquotedblright <lineannotation>(or <literal>'</literal>)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquotedblright (or <literal>'</literal>)</primary></indexterm><literal>\textquotedblright (or <literal>'</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>right quote, double</primary></indexterm>
<indexterm role="cp"><primary>double right quote</primary></indexterm>
<para>Double right quote: &#8221;.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquoteleft <lineannotation>(or <literal>`</literal>)</lineannotation></primary></indexterm><literal>\textquoteleft <lineannotation>(or <literal>`</literal>)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquoteleft (or <literal>`</literal>)</primary></indexterm><literal>\textquoteleft (or <literal>`</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>left quote, single</primary></indexterm>
<indexterm role="cp"><primary>single left quote</primary></indexterm>
<para>Single left quote: &#8216;.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquoteright <lineannotation>(or <literal>'</literal>)</lineannotation></primary></indexterm><literal>\textquoteright <lineannotation>(or <literal>'</literal>)</lineannotation></literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textquoteright (or <literal>'</literal>)</primary></indexterm><literal>\textquoteright (or <literal>'</literal>)</literal>
</term><listitem><indexterm role="cp"><primary>right quote, single</primary></indexterm>
<indexterm role="cp"><primary>single right quote</primary></indexterm>
<para>Single right quote: &#8217;.
@@ -5597,7 +5666,7 @@ capital letters. These are not available with OT1.
</para>
<variablelist><varlistentry><term><literal>\&quot;</literal>
</term><term><literal>\capitaldieresis</literal>
-</term><listitem><indexterm role="fn"><primary>\&quot; <lineannotation>(umlaut accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\&quot; (umlaut accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitaldieresis</primary></indexterm>
<indexterm role="cp"><primary>umlaut accent</primary></indexterm>
<indexterm role="cp"><primary>dieresis accent</primary></indexterm>
@@ -5605,7 +5674,7 @@ capital letters. These are not available with OT1.
</para>
</listitem></varlistentry><varlistentry><term><literal>\'</literal>
</term><term><literal>\capitalacute</literal>
-</term><listitem><indexterm role="fn"><primary>\&#8217; <lineannotation>(acute accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\&#8217; (acute accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalacute</primary></indexterm>
<indexterm role="cp"><primary>acute accent</primary></indexterm>
<para>Produces an acute accent, as in &#243;. In the <literal>tabbing</literal>
@@ -5613,14 +5682,14 @@ environment, pushes current column to the right of the previous column
(see <link linkend="tabbing">tabbing</link>).
</para>
</listitem></varlistentry><varlistentry><term><literal>\.</literal>
-</term><listitem><indexterm role="fn"><primary>\. <lineannotation>(dot-over accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\. (dot-over accent)</primary></indexterm>
<indexterm role="cp"><primary>dot accent</primary></indexterm>
<indexterm role="cp"><primary>dot-over accent</primary></indexterm>
<para>Produces a dot accent over the following, as in &#559;.
</para>
</listitem></varlistentry><varlistentry><term><literal>\=</literal>
</term><term><literal>\capitalmacron</literal>
-</term><listitem><indexterm role="fn"><primary>\= <lineannotation>(macron accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\= (macron accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalmacron</primary></indexterm>
<indexterm role="cp"><primary>macron accent</primary></indexterm>
<indexterm role="cp"><primary>overbar accent</primary></indexterm>
@@ -5629,7 +5698,7 @@ environment, pushes current column to the right of the previous column
</para>
</listitem></varlistentry><varlistentry><term><literal>\^</literal>
</term><term><literal>\capitalcircumflex</literal>
-</term><listitem><indexterm role="fn"><primary>\^ <lineannotation>(circumflex accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\^ (circumflex accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalcircumflex</primary></indexterm>
<indexterm role="cp"><primary>circumflex accent</primary></indexterm>
<indexterm role="cp"><primary>hat accent</primary></indexterm>
@@ -5637,7 +5706,7 @@ environment, pushes current column to the right of the previous column
</para>
</listitem></varlistentry><varlistentry><term><literal>\`</literal>
</term><term><literal>\capitalgrave</literal>
-</term><listitem><indexterm role="fn"><primary>\&#8216; <lineannotation>(grave accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\&#8216; (grave accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalgrave</primary></indexterm>
<indexterm role="cp"><primary>grave accent</primary></indexterm>
<para>Produces a grave accent over the following, as in &#242;. In the
@@ -5646,50 +5715,50 @@ environment, pushes current column to the right of the previous column
</para>
</listitem></varlistentry><varlistentry><term><literal>\~</literal>
</term><term><literal>\capitaltilde</literal>
-</term><listitem><indexterm role="fn"><primary>\~ <lineannotation>(tilde accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\~ (tilde accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitaltilde</primary></indexterm>
<indexterm role="cp"><primary>tilde accent</primary></indexterm>
<para>Produces a tilde accent over the following, as in &#241;.
</para>
</listitem></varlistentry><varlistentry><term><literal>\b</literal>
-</term><listitem><indexterm role="fn"><primary>\b <lineannotation>(bar-under accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\b (bar-under accent)</primary></indexterm>
<indexterm role="cp"><primary>bar-under accent</primary></indexterm>
<para>Produces a bar accent under the following, as in o_.
</para>
</listitem></varlistentry><varlistentry><term><literal>\c</literal>
</term><term><literal>\capitalcedilla</literal>
-</term><listitem><indexterm role="fn"><primary>\c <lineannotation>(cedilla accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\c (cedilla accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalcedilla</primary></indexterm>
<indexterm role="cp"><primary>cedilla accent</primary></indexterm>
<para>Produces a cedilla accent under the following, as in &#231;.
</para>
</listitem></varlistentry><varlistentry><term><literal>\d</literal>
</term><term><literal>\capitaldotaccent</literal>
-</term><listitem><indexterm role="fn"><primary>\d <lineannotation>(dot-under accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\d (dot-under accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitaldotaccent</primary></indexterm>
<indexterm role="cp"><primary>dot-under accent</primary></indexterm>
<para>Produces a dot accent under the following, as in &#7885;.
</para>
</listitem></varlistentry><varlistentry><term><literal>\H</literal>
</term><term><literal>\capitalhungarumlaut</literal>
-</term><listitem><indexterm role="fn"><primary>\H <lineannotation>(Hungarian umlaut accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\H (Hungarian umlaut accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalhungarumlaut</primary></indexterm>
<indexterm role="cp"><primary>hungarian umlaut accent</primary></indexterm>
<para>Produces a long Hungarian umlaut accent over the following, as in &#337;.
</para>
</listitem></varlistentry><varlistentry><term><literal>\i</literal>
-</term><listitem><indexterm role="fn"><primary>\i <lineannotation>(dotless i)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\i (dotless i)</primary></indexterm>
<indexterm role="cp"><primary>dotless i</primary></indexterm>
<para>Produces a dotless i, as in &#8216;i&#8217;.
</para>
</listitem></varlistentry><varlistentry><term><literal>\j</literal>
-</term><listitem><indexterm role="fn"><primary>\j <lineannotation>(dotless j)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\j (dotless j)</primary></indexterm>
<indexterm role="cp"><primary>dotless j</primary></indexterm>
<para>Produces a dotless j, as in &#8216;j&#8217;.
</para>
</listitem></varlistentry><varlistentry><term><literal>\k</literal>
</term><term><literal>\capitalogonek</literal>
-</term><listitem><indexterm role="fn"><primary>\k <lineannotation>(ogonek)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\k (ogonek)</primary></indexterm>
<indexterm role="fn"><primary>\capitalogonek</primary></indexterm>
<indexterm role="cp"><primary>ogonek</primary></indexterm>
<para>Produces a letter with ogonek, as in &#8216;&#491;&#8217;. Not available in
@@ -5697,7 +5766,7 @@ the OT1 encoding.
</para>
</listitem></varlistentry><varlistentry><term><literal>\r</literal>
</term><term><literal>\capitalring</literal>
-</term><listitem><indexterm role="fn"><primary>\r <lineannotation>(ring accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\r (ring accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalring</primary></indexterm>
<indexterm role="cp"><primary>ring accent</primary></indexterm>
<para>Produces a ring accent, as in &#8216;o*&#8217;.
@@ -5706,7 +5775,7 @@ the OT1 encoding.
</term><term><literal>\capitaltie</literal>
</term><term><literal>\newtie</literal>
</term><term><literal>\capitalnewtie</literal>
-</term><listitem><indexterm role="fn"><primary>\t <lineannotation>(tie-after accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\t (tie-after accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitaltie</primary></indexterm>
<indexterm role="fn"><primary>\newtie</primary></indexterm>
<indexterm role="fn"><primary>\capitalnewtie</primary></indexterm>
@@ -5716,7 +5785,7 @@ the OT1 encoding.
</para>
</listitem></varlistentry><varlistentry><term><literal>\u</literal>
</term><term><literal>\capitalbreve</literal>
-</term><listitem><indexterm role="fn"><primary>\u <lineannotation>(breve accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\u (breve accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalbreve</primary></indexterm>
<indexterm role="cp"><primary>breve accent</primary></indexterm>
<para>Produces a breve accent, as in &#8216;&#335;&#8217;.
@@ -5731,7 +5800,7 @@ descenders. See also <literal>\underline</literal> in <link linkend="Math-misce
</para>
</listitem></varlistentry><varlistentry><term><literal>\v</literal>
</term><term><literal>\capitalcaron</literal>
-</term><listitem><indexterm role="fn"><primary>\v <lineannotation>(breve accent)</lineannotation></primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\v (breve accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalcaron</primary></indexterm>
<indexterm role="cp"><primary>hacek accent</primary></indexterm>
<indexterm role="cp"><primary>check accent</primary></indexterm>
@@ -5884,6 +5953,9 @@ several smaller ones. Regardless of how many separate files you use,
there is one that is the root file; it is the one whose name you type
when you run &latex;.
</para>
+<para>See <link linkend="filecontents">filecontents</link>, for an environment that allows bundling an
+external file to be created with the main document.
+</para>
<sect1 label="23.1" id="_005cinclude">
@@ -5944,7 +6016,6 @@ file at that point.
or &#8216;<literal>foo.bar.tex</literal>&#8217;). If that is not found, the original <replaceable>file</replaceable>
is tried (&#8216;<literal>foo</literal>&#8217; or &#8216;<literal>foo.bar</literal>&#8217;).
</para>
-
</sect1>
</chapter>
<chapter label="24" id="Front_002fback-matter">
@@ -5958,7 +6029,7 @@ is tried (&#8216;<literal>foo</literal>&#8217; or &#8216;<literal>foo.bar</liter
<indexterm role="cp"><primary>table of contents, creating</primary></indexterm>
<indexterm role="fn"><primary>\tableofcontents</primary></indexterm>
-<indexterm role="fn"><primary>.toc <lineannotation>file</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>.toc file</primary></indexterm>
<para>A table of contents is produced with the <literal>\tableofcontents</literal>
command. You put the command right where you want the table of
contents to go; &latex; does the rest for you. A previous run must
@@ -6152,7 +6223,7 @@ the letter follows. It is typed as ordinary &latex; input. Commands that
make no sense in a letter, like <literal>\chapter</literal>, do not work. The letter
closes with a <literal>\closing</literal> command.
</para>
-<indexterm role="fn"><primary>\\ <lineannotation>for letters</lineannotation></primary></indexterm>
+<indexterm role="fn"><primary>\\ for letters</primary></indexterm>
<para>After the <literal>closing</literal>, you can have additional material. The
<literal>\cc</literal> command produces the usual &#8220;cc: &#8230;&#8221;. There&#8217;s also a
similar <literal>\encl</literal> command for a list of enclosures. With both these
@@ -6473,8 +6544,7 @@ The end.
\usepackage{graphicx}
\usepackage{ifpdf}
\ifpdf
-\usepackage[breaklinks,colorlinks,linkcolor=black,citecolor=black,
- urlcolor=black]{hyperref}
+\usepackage[breaklinks,hidelinks]{hyperref}
\else
\usepackage{url}
\fi