diff options
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.dbk | 492 |
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 D. Greenwade of Sam Houston State University. The &latex; 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. Botway and C. 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 © 2007, 2008, 2009, 2010, 2011, 2012, 2013 Karl Berry. +<para>Copyright 2007, 2008, 2009, 2010, 2011, 2012, 2013, +2014 Karl Berry. -Copyright © 1988, 1994, 2007 Stephen Gilmore. +Copyright 1988, 1994, 2007 Stephen Gilmore. -Copyright © 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 D. Greenwade of Sam Houston State University. The &latex; 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. Botway and C. 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 © 2007, 2008, 2009, 2010, 2011, 2012, 2013 Karl Berry. +<para>Copyright 2007, 2008, 2009, 2010, 2011, 2012, 2013, +2014 Karl Berry. -Copyright © 1988, 1994, 2007 Stephen Gilmore. +Copyright 1988, 1994, 2007 Stephen Gilmore. -Copyright © 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 “Device Independent” (<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 “Portable Document Format” (<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 “transcript” 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 “auxiliary” 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’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) a string of letters or (b) 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 “declaration form”, 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 “declaration form”, 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 & 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 “Avoid eqnarray!” 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’t insert any leading comment, so it is +better suited to create files which aren’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. <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. <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>\> <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><indexterm role="fn"><primary>\></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>\’ <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>Moves everything that you have typed so far in the current column, i.e. everything from the most recent <literal>\></literal>, <literal>\<</literal>, <literal>\'</literal>, <literal>\\</literal>, or <literal>\kill</literal> command, to the right of the previous column, flush against the current column’s tab stop. </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>Allows you to put text flush right against any tab stop, including tab stop 0. However, it can’t move text to the right of the last column because there’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>\></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’ <lineannotation>(acute accent in tabbing)</lineannotation></primary></indexterm> -<indexterm role="fn"><primary>\a‘ <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’ (acute accent in tabbing)</primary></indexterm> +<indexterm role="fn"><primary>\a‘ (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 & column 2 entry ... & 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—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 1 and 9, inclusive. </para> <para>The symbols mostly aren’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’s entry—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 “left-hand heading” (<replaceable>left</replaceable>) is generated by the last <literal>\markboth</literal> command before -the end of the page, while a “right-hand heading” (<replaceable>right</replaceable> is +the end of the page, while a “right-hand heading” (<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>"</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>(«)</lineannotation></primary></indexterm><literal>\guillemotleft <lineannotation>(«)</lineannotation></literal> -</term><term><indexterm role="fn"><primary>\guillemotright <lineannotation>(»)</lineannotation></primary></indexterm><literal>\guillemotright <lineannotation>(»)</lineannotation></literal> -</term><term><indexterm role="fn"><primary>\guilsinglleft <lineannotation>(‹)</lineannotation></primary></indexterm><literal>\guilsinglleft <lineannotation>(‹)</lineannotation></literal> -</term><term><indexterm role="fn"><primary>\guilsinglright <lineannotation>(›)</lineannotation></primary></indexterm><literal>\guilsinglright <lineannotation>(›)</lineannotation></literal> +</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\guillemotleft («)</primary></indexterm><literal>\guillemotleft («)</literal> +</term><term><indexterm role="fn"><primary>\guillemotright (»)</primary></indexterm><literal>\guillemotright (»)</literal> +</term><term><indexterm role="fn"><primary>\guilsinglleft (‹)</primary></indexterm><literal>\guilsinglleft (‹)</literal> +</term><term><indexterm role="fn"><primary>\guilsinglright (›)</primary></indexterm><literal>\guilsinglright (›)</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: £. </para> -</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\quotedblbase <lineannotation>(„)</lineannotation></primary></indexterm><literal>\quotedblbase <lineannotation>(„)</lineannotation></literal> -</term><term><indexterm role="fn"><primary>\quotesinglbase <lineannotation>(‚)</lineannotation></primary></indexterm><literal>\quotesinglbase <lineannotation>(‚)</lineannotation></literal> +</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\quotedblbase („)</primary></indexterm><literal>\quotedblbase („)</literal> +</term><term><indexterm role="fn"><primary>\quotesinglbase (‚)</primary></indexterm><literal>\quotesinglbase (‚)</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: — (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: — (for ranges). </para> @@ -5484,7 +5553,7 @@ has the ascender height. <indexterm role="cp"><primary>currency, euro</primary></indexterm> <para>The Euro symbol: €. </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: ¡. </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: ¿. </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: “. </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: ”. </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: ‘. </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: ’. @@ -5597,7 +5666,7 @@ capital letters. These are not available with OT1. </para> <variablelist><varlistentry><term><literal>\"</literal> </term><term><literal>\capitaldieresis</literal> -</term><listitem><indexterm role="fn"><primary>\" <lineannotation>(umlaut accent)</lineannotation></primary></indexterm> +</term><listitem><indexterm role="fn"><primary>\" (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>\’ <lineannotation>(acute accent)</lineannotation></primary></indexterm> +</term><listitem><indexterm role="fn"><primary>\’ (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 ó. 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 ȯ. </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>\‘ <lineannotation>(grave accent)</lineannotation></primary></indexterm> +</term><listitem><indexterm role="fn"><primary>\‘ (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 ò. 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 ñ. </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 ç. </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 ọ. </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 ő. </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 ‘i’. </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 ‘j’. </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 ‘ǫ’. 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 ‘o*’. @@ -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 ‘ŏ’. @@ -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 ‘<literal>foo.bar.tex</literal>’). If that is not found, the original <replaceable>file</replaceable> is tried (‘<literal>foo</literal>’ or ‘<literal>foo.bar</literal>’). </para> - </sect1> </chapter> <chapter label="24" id="Front_002fback-matter"> @@ -5958,7 +6029,7 @@ is tried (‘<literal>foo</literal>’ or ‘<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 “cc: …”. There’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 |