diff options
| author | Karl Berry <karl@freefriends.org> | 2019-05-31 21:46:33 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2019-05-31 21:46:33 +0000 |
| commit | 891121c6ad3d6a58ad69198c9388cb7cfbc4345b (patch) | |
| tree | 15302de3d40f21a4f7fe19969058819e61b01f5c /Master/texmf-dist/doc | |
| parent | 6d89f134ee1ac49e8dace555969f8bfc1086109a (diff) | |
eplain (31may19)
git-svn-id: svn://tug.org/texlive/trunk@51280 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
| -rw-r--r-- | Master/texmf-dist/doc/eplain/ChangeLog | 24 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/eplain/NEWS | 6 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/eplain/eplain.html | 4629 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/eplain/eplain.pdf | bin | 747690 -> 734526 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/info/eplain.info | 635 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/man/man1/eplain.man1.pdf | bin | 18960 -> 18873 bytes |
6 files changed, 2621 insertions, 2673 deletions
diff --git a/Master/texmf-dist/doc/eplain/ChangeLog b/Master/texmf-dist/doc/eplain/ChangeLog index 421677ee23e..2f515d382f6 100644 --- a/Master/texmf-dist/doc/eplain/ChangeLog +++ b/Master/texmf-dist/doc/eplain/ChangeLog @@ -1,3 +1,27 @@ +2019-05-31 Karl Berry <karl@freefriends.org> + + * Version 3.9. + + * Makefile (browse_dir): use -y to zip to preserve top-level + symlink for CTAN. + + * btxmac.tex (\providecommand): forgot rename of \@continuenewcommand + to \@btxcontinuenewcommand, causing \@optionalusercs undefined error. + 0.99p. Also doc fixes. + https://tug.org/pipermail/tex-eplain/2019/000983.html + +2019-05-29 Karl Berry <karl@freefriends.org> + + * doc/eplain.texi: version 3.9, May 2019. + * doc/hlink.texi (Making PDF outlines): new section, + following https://tug.org/pipermail/tex-eplain/2016/000911.html. + * doc/*.texi: typos, https. + +2019-05-28 Karl Berry <karl@freefriends.org> + + * doc/hlink.texi (Introduction to hyperlinks): + option [dvipdfm] better for \enablehyperlinks example. + 2016-05-14 Karl Berry <karl@freefriends.org> * Version 3.8. diff --git a/Master/texmf-dist/doc/eplain/NEWS b/Master/texmf-dist/doc/eplain/NEWS index 247efdf4259..090c3eee8df 100644 --- a/Master/texmf-dist/doc/eplain/NEWS +++ b/Master/texmf-dist/doc/eplain/NEWS @@ -1,6 +1,10 @@ -$Id: NEWS 32 2016-05-14 15:28:35Z karl $ +$Id: NEWS 49 2019-05-31 16:20:41Z karl $ This file records noteworthy changes. This file is public domain. + 3.9 (31 May 2019) +* btxmac.tex missed one macro renaming, making \providecommand fail. +* PDF bookmark/outlines example in documentation, and url updates. + 3.8 (12 May 2016) * btxmac.tex internal macros renamed to avoid conflict with babel's plain.def. * Update ifpdf.sty. diff --git a/Master/texmf-dist/doc/eplain/eplain.html b/Master/texmf-dist/doc/eplain/eplain.html index aee1b2c0025..c3ae5f8d1a6 100644 --- a/Master/texmf-dist/doc/eplain/eplain.html +++ b/Master/texmf-dist/doc/eplain/eplain.html @@ -1,7 +1,7 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- This manual documents the Eplain macros, version 3.8, -May 2016. Eplain provides functionality for plain TeX that +<!-- This manual documents the Eplain macros, version 3.9, +May 2019. Eplain provides functionality for plain TeX that is intended to be useful regardless of how your document is actually formatted. @@ -12,16 +12,16 @@ macros; this chapter is under the GNU General Public License. Adam Lewenberg has made additions and corrections. Oleg Katsitadze wrote the section on LaTeX packages and the chapter on hyperlinks, and updates throughout. --> -<!-- Created by Texinfo 6.1dev+dev, http://www.gnu.org/software/texinfo/ --> +<!-- Created by GNU Texinfo 6.6, http://www.gnu.org/software/texinfo/ --> <head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>Eplain: Expanded Plain TeX</title> <meta name="description" content="Eplain: Expanded Plain TeX"> <meta name="keywords" content="Eplain: Expanded Plain TeX"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> -<meta name="Generator" content="texi2any"> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta name="Generator" content="makeinfo"> <link href="#Top" rel="start" title="Top"> <link href="#Macro-index" rel="index" title="Macro index"> <link href="#SEC_Contents" rel="contents" title="Table of Contents"> @@ -30,23 +30,14 @@ updates throughout. --> <!-- a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} -blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} -blockquote.smallquotation {font-size: smaller} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} div.lisp {margin-left: 3.2em} -div.smalldisplay {margin-left: 3.2em} -div.smallexample {margin-left: 3.2em} -div.smalllisp {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} pre.menu-comment {font-family: serif} pre.menu-preformatted {font-family: serif} -pre.smalldisplay {font-family: inherit; font-size: smaller} -pre.smallexample {font-size: smaller} -pre.smallformat {font-family: inherit; font-size: smaller} -pre.smalllisp {font-size: smaller} span.nolinebreak {white-space: nowrap} span.roman {font-family: initial; font-weight: normal} span.sansserif {font-family: sans-serif; font-weight: normal} @@ -67,213 +58,212 @@ ul.no-bullet {list-style: none} -<a name="SEC_Overview"></a> +<span id="SEC_Overview"></span> <h2 class="shortcontents-heading">Short Table of Contents</h2> <div class="shortcontents"> <ul class="no-bullet"> -<li><a name="stoc-Introduction-1" href="#toc-Introduction-1">1 Introduction</a></li> -<li><a name="stoc-Installation-1" href="#toc-Installation-1">2 Installation</a></li> -<li><a name="stoc-Invoking-Eplain-1" href="#toc-Invoking-Eplain-1">3 Invoking Eplain</a></li> -<li><a name="stoc-User-definitions-1" href="#toc-User-definitions-1">4 User definitions</a></li> -<li><a name="stoc-Hyperlinks-1" href="#toc-Hyperlinks-1">5 Hyperlinks</a></li> -<li><a name="stoc-Arrow-theoretic-diagrams-1" href="#toc-Arrow-theoretic-diagrams-1">6 Arrow theoretic diagrams</a></li> -<li><a name="stoc-Programming-definitions-1" href="#toc-Programming-definitions-1">7 Programming definitions</a></li> -<li><a name="stoc-Demo-files-1" href="#toc-Demo-files-1">8 Demo files</a></li> -<li><a name="stoc-Macro-index-1" href="#toc-Macro-index-1">Macro index</a></li> -<li><a name="stoc-Concept-index-1" href="#toc-Concept-index-1">Concept index</a></li> +<li><a id="stoc-Introduction-1" href="#toc-Introduction-1">1 Introduction</a></li> +<li><a id="stoc-Installation-1" href="#toc-Installation-1">2 Installation</a></li> +<li><a id="stoc-Invoking-Eplain-1" href="#toc-Invoking-Eplain-1">3 Invoking Eplain</a></li> +<li><a id="stoc-User-definitions-1" href="#toc-User-definitions-1">4 User definitions</a></li> +<li><a id="stoc-Hyperlinks-1" href="#toc-Hyperlinks-1">5 Hyperlinks</a></li> +<li><a id="stoc-Arrow-theoretic-diagrams-1" href="#toc-Arrow-theoretic-diagrams-1">6 Arrow theoretic diagrams</a></li> +<li><a id="stoc-Programming-definitions-1" href="#toc-Programming-definitions-1">7 Programming definitions</a></li> +<li><a id="stoc-Demo-files-1" href="#toc-Demo-files-1">8 Demo files</a></li> +<li><a id="stoc-Macro-index-1" href="#toc-Macro-index-1">Macro index</a></li> +<li><a id="stoc-Concept-index-1" href="#toc-Concept-index-1">Concept index</a></li> </ul> </div> -<a name="SEC_Contents"></a> +<span id="SEC_Contents"></span> <h2 class="contents-heading">Table of Contents</h2> <div class="contents"> <ul class="no-bullet"> - <li><a name="toc-Introduction-1" href="#Introduction">1 Introduction</a></li> - <li><a name="toc-Installation-1" href="#Installation">2 Installation</a></li> - <li><a name="toc-Invoking-Eplain-1" href="#Invoking-Eplain">3 Invoking Eplain</a></li> - <li><a name="toc-User-definitions-1" href="#User-definitions">4 User definitions</a> + <li><a id="toc-Introduction-1" href="#Introduction">1 Introduction</a></li> + <li><a id="toc-Installation-1" href="#Installation">2 Installation</a></li> + <li><a id="toc-Invoking-Eplain-1" href="#Invoking-Eplain">3 Invoking Eplain</a></li> + <li><a id="toc-User-definitions-1" href="#User-definitions">4 User definitions</a> <ul class="no-bullet"> - <li><a name="toc-Diagnostics-1" href="#Diagnostics">4.1 Diagnostics</a></li> - <li><a name="toc-Rules-1" href="#Rules">4.2 Rules</a></li> - <li><a name="toc-Citations-1" href="#Citations">4.3 Citations</a> + <li><a id="toc-Diagnostics-1" href="#Diagnostics">4.1 Diagnostics</a></li> + <li><a id="toc-Rules-1" href="#Rules">4.2 Rules</a></li> + <li><a id="toc-Citations-1" href="#Citations">4.3 Citations</a> <ul class="no-bullet"> - <li><a name="toc-Formatting-citations-1" href="#Formatting-citations">4.3.1 Formatting citations</a></li> - <li><a name="toc-Formatting-bibliographies-1" href="#Formatting-bibliographies">4.3.2 Formatting bibliographies</a></li> - <li><a name="toc-Commands-from-LaTeX-1" href="#Commands-from-LaTeX">4.3.3 Commands from LaTeX</a></li> + <li><a id="toc-Formatting-citations-1" href="#Formatting-citations">4.3.1 Formatting citations</a></li> + <li><a id="toc-Formatting-bibliographies-1" href="#Formatting-bibliographies">4.3.2 Formatting bibliographies</a></li> + <li><a id="toc-Commands-from-LaTeX-1" href="#Commands-from-LaTeX">4.3.3 Commands from LaTeX</a></li> </ul></li> - <li><a name="toc-Displays-1" href="#Displays">4.4 Displays</a> + <li><a id="toc-Displays-1" href="#Displays">4.4 Displays</a> <ul class="no-bullet"> - <li><a name="toc-Formatting-displays-1" href="#Formatting-displays">4.4.1 Formatting displays</a></li> + <li><a id="toc-Formatting-displays-1" href="#Formatting-displays">4.4.1 Formatting displays</a></li> </ul></li> - <li><a name="toc-Time-of-day-1" href="#Time-of-day">4.5 Time of day</a></li> - <li><a name="toc-Lists-1" href="#Lists">4.6 Lists</a> + <li><a id="toc-Time-of-day-1" href="#Time-of-day">4.5 Time of day</a></li> + <li><a id="toc-Lists-1" href="#Lists">4.6 Lists</a> <ul class="no-bullet"> - <li><a name="toc-Formatting-lists-1" href="#Formatting-lists">4.6.1 Formatting lists</a></li> + <li><a id="toc-Formatting-lists-1" href="#Formatting-lists">4.6.1 Formatting lists</a></li> </ul></li> - <li><a name="toc-Verbatim-listing-1" href="#Verbatim-listing">4.7 Verbatim listing</a></li> - <li><a name="toc-Contents-1" href="#Contents">4.8 Contents</a> + <li><a id="toc-Verbatim-listing-1" href="#Verbatim-listing">4.7 Verbatim listing</a></li> + <li><a id="toc-Contents-1" href="#Contents">4.8 Contents</a> <ul class="no-bullet"> - <li><a name="toc-Writing-the-_002etoc-file-1" href="#Writing-the-_002etoc-file">4.8.1 Writing the <tt>.toc</tt> file</a></li> - <li><a name="toc-Reading-the-_002etoc-file-1" href="#Reading-the-_002etoc-file">4.8.2 Reading the <tt>.toc</tt> file</a></li> - <li><a name="toc-Changing-the-_002etoc-file_0027s-root-name-1" href="#Changing-the-_002etoc-file_0027s-root-name">4.8.3 Changing the <tt>.toc</tt> file’s root name</a></li> - <li><a name="toc-Alternative-contents-files-1" href="#Alternative-contents-files">4.8.4 Alternative contents files</a></li> + <li><a id="toc-Writing-the-_002etoc-file-1" href="#Writing-the-_002etoc-file">4.8.1 Writing the <tt>.toc</tt> file</a></li> + <li><a id="toc-Reading-the-_002etoc-file-1" href="#Reading-the-_002etoc-file">4.8.2 Reading the <tt>.toc</tt> file</a></li> + <li><a id="toc-Changing-the-_002etoc-file_0027s-root-name-1" href="#Changing-the-_002etoc-file_0027s-root-name">4.8.3 Changing the <tt>.toc</tt> file’s root name</a></li> + <li><a id="toc-Alternative-contents-files-1" href="#Alternative-contents-files">4.8.4 Alternative contents files</a></li> </ul></li> - <li><a name="toc-Cross_002dreferences-1" href="#Cross_002dreferences">4.9 Cross-references</a> + <li><a id="toc-Cross_002dreferences-1" href="#Cross_002dreferences">4.9 Cross-references</a> <ul class="no-bullet"> - <li><a name="toc-Defining-generic-references-1" href="#Defining-generic-references">4.9.1 Defining generic references</a></li> - <li><a name="toc-Using-generic-references-1" href="#Using-generic-references">4.9.2 Using generic references</a></li> + <li><a id="toc-Defining-generic-references-1" href="#Defining-generic-references">4.9.1 Defining generic references</a></li> + <li><a id="toc-Using-generic-references-1" href="#Using-generic-references">4.9.2 Using generic references</a></li> </ul></li> - <li><a name="toc-Page-references-1" href="#Page-references">4.10 Page references</a></li> - <li><a name="toc-Equation-references-1" href="#Equation-references">4.11 Equation references</a> + <li><a id="toc-Page-references-1" href="#Page-references">4.10 Page references</a></li> + <li><a id="toc-Equation-references-1" href="#Equation-references">4.11 Equation references</a> <ul class="no-bullet"> - <li><a name="toc-Formatting-equation-references-1" href="#Formatting-equation-references">4.11.1 Formatting equation references</a></li> - <li><a name="toc-Subequation-references-1" href="#Subequation-references">4.11.2 Subequation references</a></li> + <li><a id="toc-Formatting-equation-references-1" href="#Formatting-equation-references">4.11.1 Formatting equation references</a></li> + <li><a id="toc-Subequation-references-1" href="#Subequation-references">4.11.2 Subequation references</a></li> </ul></li> - <li><a name="toc-Indexing-1" href="#Indexing">4.12 Indexing</a> + <li><a id="toc-Indexing-1" href="#Indexing">4.12 Indexing</a> <ul class="no-bullet"> - <li><a name="toc-Indexing-terms-1" href="#Indexing-terms">4.12.1 Indexing terms</a> + <li><a id="toc-Indexing-terms-1" href="#Indexing-terms">4.12.1 Indexing terms</a> <ul class="no-bullet"> - <li><a name="toc-Indexing-commands-1" href="#Indexing-commands">4.12.1.1 Indexing commands</a></li> - <li><a name="toc-Modifying-index-entries-1" href="#Modifying-index-entries">4.12.1.2 Modifying index entries</a></li> - <li><a name="toc-Index-entries-with-special-characters-1" href="#Index-entries-with-special-characters">4.12.1.3 Index entries with special characters</a></li> - <li><a name="toc-Proofing-index-terms-1" href="#Proofing-index-terms">4.12.1.4 Proofing index terms</a></li> + <li><a id="toc-Indexing-commands-1" href="#Indexing-commands">4.12.1.1 Indexing commands</a></li> + <li><a id="toc-Modifying-index-entries-1" href="#Modifying-index-entries">4.12.1.2 Modifying index entries</a></li> + <li><a id="toc-Index-entries-with-special-characters-1" href="#Index-entries-with-special-characters">4.12.1.3 Index entries with special characters</a></li> + <li><a id="toc-Proofing-index-terms-1" href="#Proofing-index-terms">4.12.1.4 Proofing index terms</a></li> </ul></li> - <li><a name="toc-Typesetting-an-index-1" href="#Typesetting-an-index">4.12.2 Typesetting an index</a></li> - <li><a name="toc-Customizing-indexing-1" href="#Customizing-indexing">4.12.3 Customizing indexing</a></li> + <li><a id="toc-Typesetting-an-index-1" href="#Typesetting-an-index">4.12.2 Typesetting an index</a></li> + <li><a id="toc-Customizing-indexing-1" href="#Customizing-indexing">4.12.3 Customizing indexing</a></li> </ul></li> - <li><a name="toc-Justification-1" href="#Justification">4.13 Justification</a></li> - <li><a name="toc-Tables-1" href="#Tables">4.14 Tables</a></li> - <li><a name="toc-Margins-1" href="#Margins">4.15 Margins</a></li> - <li><a name="toc-Multiple-columns-1" href="#Multiple-columns">4.16 Multiple columns</a></li> - <li><a name="toc-Footnotes-1" href="#Footnotes">4.17 Footnotes</a></li> - <li><a name="toc-Fractions-1" href="#Fractions">4.18 Fractions</a></li> - <li><a name="toc-Paths-1" href="#Paths">4.19 Paths</a></li> - <li><a name="toc-Logos-1" href="#Logos">4.20 Logos</a></li> - <li><a name="toc-Boxes-1" href="#Boxes">4.21 Boxes</a></li> - <li><a name="toc-Checking-for-PDF-output-1" href="#Checking-for-PDF-output">4.22 Checking for PDF output</a></li> - <li><a name="toc-Loading-LaTeX-packages-1" href="#Loading-LaTeX-packages">4.23 Loading LaTeX packages</a> + <li><a id="toc-Justification-1" href="#Justification">4.13 Justification</a></li> + <li><a id="toc-Tables-1" href="#Tables">4.14 Tables</a></li> + <li><a id="toc-Margins-1" href="#Margins">4.15 Margins</a></li> + <li><a id="toc-Multiple-columns-1" href="#Multiple-columns">4.16 Multiple columns</a></li> + <li><a id="toc-Footnotes-1" href="#Footnotes">4.17 Footnotes</a></li> + <li><a id="toc-Fractions-1" href="#Fractions">4.18 Fractions</a></li> + <li><a id="toc-Paths-1" href="#Paths">4.19 Paths</a></li> + <li><a id="toc-Logos-1" href="#Logos">4.20 Logos</a></li> + <li><a id="toc-Boxes-1" href="#Boxes">4.21 Boxes</a></li> + <li><a id="toc-Checking-for-PDF-output-1" href="#Checking-for-PDF-output">4.22 Checking for PDF output</a></li> + <li><a id="toc-Loading-LaTeX-packages-1" href="#Loading-LaTeX-packages">4.23 Loading LaTeX packages</a> <ul class="no-bullet"> - <li><a name="toc-The-_005cusepackage-command-1" href="#The-_005cusepackage-command">4.23.1 The <code>\usepackage</code> command</a></li> - <li><a name="toc-Environment-for-loading-packages-1" href="#Environment-for-loading-packages">4.23.2 Environment for loading packages</a></li> - <li><a name="toc-Packages-known-to-work-1" href="#Packages-known-to-work">4.23.3 Packages known to work</a></li> - <li><a name="toc-Packages-known-not-to-work-1" href="#Packages-known-not-to-work">4.23.4 Packages known not to work</a></li> + <li><a id="toc-The-_005cusepackage-command-1" href="#The-_005cusepackage-command">4.23.1 The <code>\usepackage</code> command</a></li> + <li><a id="toc-Environment-for-loading-packages-1" href="#Environment-for-loading-packages">4.23.2 Environment for loading packages</a></li> + <li><a id="toc-Packages-known-to-work-1" href="#Packages-known-to-work">4.23.3 Packages known to work</a></li> + <li><a id="toc-Packages-known-not-to-work-1" href="#Packages-known-not-to-work">4.23.4 Packages known not to work</a></li> </ul></li> </ul></li> - <li><a name="toc-Hyperlinks-1" href="#Hyperlinks">5 Hyperlinks</a> + <li><a id="toc-Hyperlinks-1" href="#Hyperlinks">5 Hyperlinks</a> <ul class="no-bullet"> - <li><a name="toc-Introduction-to-hyperlinks-1" href="#Introduction-to-hyperlinks">5.1 Introduction to hyperlinks</a></li> - <li><a name="toc-Explicit-hyperlinks-1" href="#Explicit-hyperlinks">5.2 Explicit hyperlinks</a></li> - <li><a name="toc-Implicit-hyperlinks-1" href="#Implicit-hyperlinks">5.3 Implicit hyperlinks</a> + <li><a id="toc-Introduction-to-hyperlinks-1" href="#Introduction-to-hyperlinks">5.1 Introduction to hyperlinks</a></li> + <li><a id="toc-Explicit-hyperlinks-1" href="#Explicit-hyperlinks">5.2 Explicit hyperlinks</a></li> + <li><a id="toc-Implicit-hyperlinks-1" href="#Implicit-hyperlinks">5.3 Implicit hyperlinks</a> <ul class="no-bullet"> - <li><a name="toc-General-hyperlinks_003a-hrefint_002c-hrefext" href="#General-hyperlinks">5.3.1 General hyperlinks: hrefint, hrefext</a></li> - <li><a name="toc-URL-hyperlinks_003a-url" href="#URL-hyperlinks">5.3.2 URL hyperlinks: url</a></li> - <li><a name="toc-Citation-hyperlinks_003a-cite_002c-bib" href="#Citation-hyperlinks">5.3.3 Citation hyperlinks: cite, bib</a></li> - <li><a name="toc-List-hyperlinks_003a-li" href="#List-hyperlinks">5.3.4 List hyperlinks: li</a></li> - <li><a name="toc-Cross_002dreference-hyperlinks_003a-definexref_002c-ref" href="#Cross_002dreference-hyperlinks">5.3.5 Cross-reference hyperlinks: definexref, ref</a></li> - <li><a name="toc-Page-reference-hyperlinks_003a-xrdef_002c-xref" href="#Page-reference-hyperlinks">5.3.6 Page reference hyperlinks: xrdef, xref</a></li> - <li><a name="toc-Equation-reference-hyperlinks_003a-eq" href="#Equation-reference-hyperlinks">5.3.7 Equation reference hyperlinks: eq</a></li> - <li><a name="toc-Index-hyperlinks_003a-idx" href="#Index-hyperlinks">5.3.8 Index hyperlinks: idx</a> + <li><a id="toc-General-hyperlinks_003a-hrefint_002c-hrefext" href="#General-hyperlinks">5.3.1 General hyperlinks: hrefint, hrefext</a></li> + <li><a id="toc-URL-hyperlinks_003a-url" href="#URL-hyperlinks">5.3.2 URL hyperlinks: url</a></li> + <li><a id="toc-Citation-hyperlinks_003a-cite_002c-bib" href="#Citation-hyperlinks">5.3.3 Citation hyperlinks: cite, bib</a></li> + <li><a id="toc-List-hyperlinks_003a-li" href="#List-hyperlinks">5.3.4 List hyperlinks: li</a></li> + <li><a id="toc-Cross_002dreference-hyperlinks_003a-definexref_002c-ref" href="#Cross_002dreference-hyperlinks">5.3.5 Cross-reference hyperlinks: definexref, ref</a></li> + <li><a id="toc-Page-reference-hyperlinks_003a-xrdef_002c-xref" href="#Page-reference-hyperlinks">5.3.6 Page reference hyperlinks: xrdef, xref</a></li> + <li><a id="toc-Equation-reference-hyperlinks_003a-eq" href="#Equation-reference-hyperlinks">5.3.7 Equation reference hyperlinks: eq</a></li> + <li><a id="toc-Index-hyperlinks_003a-idx" href="#Index-hyperlinks">5.3.8 Index hyperlinks: idx</a> <ul class="no-bullet"> - <li><a name="toc-Exact-destinations-for-index-terms-1" href="#Exact-destinations-for-index-terms">5.3.8.1 Exact destinations for index terms</a></li> - <li><a name="toc-Page-destinations-for-index-terms-1" href="#Page-destinations-for-index-terms">5.3.8.2 Page destinations for index terms</a></li> - <li><a name="toc-Choosing-destination-placement-1" href="#Choosing-destination-placement">5.3.8.3 Choosing destination placement</a></li> - <li><a name="toc-Index-page-list-and-page-range-parsers-1" href="#Index-page-list-and-page-range-parsers">5.3.8.4 Index page list and page range parsers</a></li> - <li><a name="toc-Hyperlinks-in-see-and-see-also-entries-1" href="#Hyperlinks-in-see-and-see-also-entries">5.3.8.5 Hyperlinks in see and see also entries</a></li> + <li><a id="toc-Exact-destinations-for-index-terms-1" href="#Exact-destinations-for-index-terms">5.3.8.1 Exact destinations for index terms</a></li> + <li><a id="toc-Page-destinations-for-index-terms-1" href="#Page-destinations-for-index-terms">5.3.8.2 Page destinations for index terms</a></li> + <li><a id="toc-Choosing-destination-placement-1" href="#Choosing-destination-placement">5.3.8.3 Choosing destination placement</a></li> + <li><a id="toc-Index-page-list-and-page-range-parsers-1" href="#Index-page-list-and-page-range-parsers">5.3.8.4 Index page list and page range parsers</a></li> + <li><a id="toc-Hyperlinks-in-see-and-see-also-entries-1" href="#Hyperlinks-in-see-and-see-also-entries">5.3.8.5 Hyperlinks in see and see also entries</a></li> </ul></li> - <li><a name="toc-Footnote-hyperlinks_003a-foot_002c-footback" href="#Footnote-hyperlinks">5.3.9 Footnote hyperlinks: foot, footback</a></li> - <li><a name="toc-Contents-hyperlinks-1" href="#Contents-hyperlinks">5.3.10 Contents hyperlinks</a></li> + <li><a id="toc-Footnote-hyperlinks_003a-foot_002c-footback" href="#Footnote-hyperlinks">5.3.9 Footnote hyperlinks: foot, footback</a></li> + <li><a id="toc-Contents-hyperlinks-1" href="#Contents-hyperlinks">5.3.10 Contents hyperlinks</a></li> </ul></li> - <li><a name="toc-Hyperlink-drivers-1" href="#Hyperlink-drivers">5.4 Hyperlink drivers</a> + <li><a id="toc-Hyperlink-drivers-1" href="#Hyperlink-drivers">5.4 Hyperlink drivers</a> <ul class="no-bullet"> - <li><a name="toc-Options-supported-by-all-drivers-1" href="#Options-supported-by-all-drivers">5.4.1 Options supported by all drivers</a></li> - <li><a name="toc-Hyperlink-driver-hypertex-1" href="#Hyperlink-driver-hypertex">5.4.2 Hyperlink driver <code>hypertex</code></a> + <li><a id="toc-Options-supported-by-all-drivers-1" href="#Options-supported-by-all-drivers">5.4.1 Options supported by all drivers</a></li> + <li><a id="toc-Hyperlink-driver-hypertex-1" href="#Hyperlink-driver-hypertex">5.4.2 Hyperlink driver <code>hypertex</code></a> <ul class="no-bullet"> - <li><a name="toc-Destination-types-for-hypertex-1" href="#Destination-types-for-hypertex">5.4.2.1 Destination types for <code>hypertex</code></a></li> - <li><a name="toc-Destination-options-for-hypertex-1" href="#Destination-options-for-hypertex">5.4.2.2 Destination options for <code>hypertex</code></a></li> - <li><a name="toc-Link-types-for-hypertex-1" href="#Link-types-for-hypertex">5.4.2.3 Link types for <code>hypertex</code></a></li> - <li><a name="toc-Link-options-for-hypertex-1" href="#Link-options-for-hypertex">5.4.2.4 Link options for <code>hypertex</code></a></li> + <li><a id="toc-Destination-types-for-hypertex-1" href="#Destination-types-for-hypertex">5.4.2.1 Destination types for <code>hypertex</code></a></li> + <li><a id="toc-Destination-options-for-hypertex-1" href="#Destination-options-for-hypertex">5.4.2.2 Destination options for <code>hypertex</code></a></li> + <li><a id="toc-Link-types-for-hypertex-1" href="#Link-types-for-hypertex">5.4.2.3 Link types for <code>hypertex</code></a></li> + <li><a id="toc-Link-options-for-hypertex-1" href="#Link-options-for-hypertex">5.4.2.4 Link options for <code>hypertex</code></a></li> </ul></li> - <li><a name="toc-Hyperlink-drivers-pdftex-and-dvipdfm-1" href="#Hyperlink-drivers-pdftex-and-dvipdfm">5.4.3 Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></a> + <li><a id="toc-Hyperlink-drivers-pdftex-and-dvipdfm-1" href="#Hyperlink-drivers-pdftex-and-dvipdfm">5.4.3 Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></a> <ul class="no-bullet"> - <li><a name="toc-Destination-types-for-pdftex-and-dvipdfm-1" href="#Destination-types-for-pdftex-and-dvipdfm">5.4.3.1 Destination types for <code>pdftex</code> and <code>dvipdfm</code></a></li> - <li><a name="toc-Destination-options-for-pdftex-and-dvipdfm-1" href="#Destination-options-for-pdftex-and-dvipdfm">5.4.3.2 Destination options for <code>pdftex</code> and <code>dvipdfm</code></a></li> - <li><a name="toc-Link-types-for-pdftex-and-dvipdfm-1" href="#Link-types-for-pdftex-and-dvipdfm">5.4.3.3 Link types for <code>pdftex</code> and <code>dvipdfm</code></a></li> - <li><a name="toc-Link-options-for-pdftex-and-dvipdfm-1" href="#Link-options-for-pdftex-and-dvipdfm">5.4.3.4 Link options for <code>pdftex</code> and <code>dvipdfm</code></a></li> + <li><a id="toc-Destination-types-for-pdftex-and-dvipdfm-1" href="#Destination-types-for-pdftex-and-dvipdfm">5.4.3.1 Destination types for <code>pdftex</code> and <code>dvipdfm</code></a></li> + <li><a id="toc-Destination-options-for-pdftex-and-dvipdfm-1" href="#Destination-options-for-pdftex-and-dvipdfm">5.4.3.2 Destination options for <code>pdftex</code> and <code>dvipdfm</code></a></li> + <li><a id="toc-Link-types-for-pdftex-and-dvipdfm-1" href="#Link-types-for-pdftex-and-dvipdfm">5.4.3.3 Link types for <code>pdftex</code> and <code>dvipdfm</code></a></li> + <li><a id="toc-Link-options-for-pdftex-and-dvipdfm-1" href="#Link-options-for-pdftex-and-dvipdfm">5.4.3.4 Link options for <code>pdftex</code> and <code>dvipdfm</code></a></li> </ul></li> - <li><a name="toc-Hyperlink-driver-nolinks-1" href="#Hyperlink-driver-nolinks">5.4.4 Hyperlink driver <code>nolinks</code></a></li> + <li><a id="toc-Hyperlink-driver-nolinks-1" href="#Hyperlink-driver-nolinks">5.4.4 Hyperlink driver <code>nolinks</code></a></li> </ul></li> - <li><a name="toc-Setting-hyperlink-types-and-options-1" href="#Setting-hyperlink-types-and-options">5.5 Setting hyperlink types and options</a> + <li><a id="toc-Setting-hyperlink-types-and-options-1" href="#Setting-hyperlink-types-and-options">5.5 Setting hyperlink types and options</a> <ul class="no-bullet"> - <li><a name="toc-Setting-default-types-and-options-1" href="#Setting-default-types-and-options">5.5.1 Setting default types and options</a></li> - <li><a name="toc-Setting-group-types-1" href="#Setting-group-types">5.5.2 Setting group types</a></li> - <li><a name="toc-Setting-group-options-1" href="#Setting-group-options">5.5.3 Setting group options</a></li> + <li><a id="toc-Setting-default-types-and-options-1" href="#Setting-default-types-and-options">5.5.1 Setting default types and options</a></li> + <li><a id="toc-Setting-group-types-1" href="#Setting-group-types">5.5.2 Setting group types</a></li> + <li><a id="toc-Setting-group-options-1" href="#Setting-group-options">5.5.3 Setting group options</a></li> </ul></li> - <li><a name="toc-Turning-hyperlinks-on_002foff-1" href="#Turning-hyperlinks-on_002foff">5.6 Turning hyperlinks on/off</a> + <li><a id="toc-Turning-hyperlinks-on_002foff-1" href="#Turning-hyperlinks-on_002foff">5.6 Turning hyperlinks on/off</a> <ul class="no-bullet"> - <li><a name="toc-Turning-low_002dlevel-commands-on_002foff-1" href="#Turning-low_002dlevel-commands-on_002foff">5.6.1 Turning low-level commands on/off</a></li> - <li><a name="toc-Turning-hyperlinks-on_002foff-for-a-group-1" href="#Turning-hyperlinks-on_002foff-for-a-group">5.6.2 Turning hyperlinks on/off for a group</a></li> + <li><a id="toc-Turning-low_002dlevel-commands-on_002foff-1" href="#Turning-low_002dlevel-commands-on_002foff">5.6.1 Turning low-level commands on/off</a></li> + <li><a id="toc-Turning-hyperlinks-on_002foff-for-a-group-1" href="#Turning-hyperlinks-on_002foff-for-a-group">5.6.2 Turning hyperlinks on/off for a group</a></li> </ul></li> + <li><a id="toc-Making-PDF-outlines-1" href="#Making-PDF-outlines">5.7 Making PDF outlines</a></li> </ul></li> - <li><a name="toc-Arrow-theoretic-diagrams-1" href="#Arrow-theoretic-diagrams">6 Arrow theoretic diagrams</a> + <li><a id="toc-Arrow-theoretic-diagrams-1" href="#Arrow-theoretic-diagrams">6 Arrow theoretic diagrams</a> <ul class="no-bullet"> - <li><a name="toc-Slanted-lines-and-vectors-1" href="#Slanted-lines-and-vectors">6.1 Slanted lines and vectors</a></li> - <li><a name="toc-Commutative-diagrams-1" href="#Commutative-diagrams">6.2 Commutative diagrams</a> + <li><a id="toc-Slanted-lines-and-vectors-1" href="#Slanted-lines-and-vectors">6.1 Slanted lines and vectors</a></li> + <li><a id="toc-Commutative-diagrams-1" href="#Commutative-diagrams">6.2 Commutative diagrams</a> <ul class="no-bullet"> - <li><a name="toc-Arrows-and-morphisms-1" href="#Arrows-and-morphisms">6.2.1 Arrows and morphisms</a></li> - <li><a name="toc-Construction-of-commutative-diagrams-1" href="#Construction-of-commutative-diagrams">6.2.2 Construction of commutative diagrams</a></li> - <li><a name="toc-Commutative-diagram-parameters-1" href="#Commutative-diagram-parameters">6.2.3 Commutative diagram parameters</a></li> + <li><a id="toc-Arrows-and-morphisms-1" href="#Arrows-and-morphisms">6.2.1 Arrows and morphisms</a></li> + <li><a id="toc-Construction-of-commutative-diagrams-1" href="#Construction-of-commutative-diagrams">6.2.2 Construction of commutative diagrams</a></li> + <li><a id="toc-Commutative-diagram-parameters-1" href="#Commutative-diagram-parameters">6.2.3 Commutative diagram parameters</a></li> </ul></li> </ul></li> - <li><a name="toc-Programming-definitions-1" href="#Programming-definitions">7 Programming definitions</a> + <li><a id="toc-Programming-definitions-1" href="#Programming-definitions">7 Programming definitions</a> <ul class="no-bullet"> - <li><a name="toc-Category-codes-1" href="#Category-codes">7.1 Category codes</a></li> - <li><a name="toc-Allocation-macros-1" href="#Allocation-macros">7.2 Allocation macros</a></li> - <li><a name="toc-Iteration-1" href="#Iteration">7.3 Iteration</a></li> - <li><a name="toc-Macro-arguments-1" href="#Macro-arguments">7.4 Macro arguments</a></li> - <li><a name="toc-Converting-to-characters-1" href="#Converting-to-characters">7.5 Converting to characters</a></li> - <li><a name="toc-Expansion-1" href="#Expansion">7.6 Expansion</a> + <li><a id="toc-Category-codes-1" href="#Category-codes">7.1 Category codes</a></li> + <li><a id="toc-Allocation-macros-1" href="#Allocation-macros">7.2 Allocation macros</a></li> + <li><a id="toc-Iteration-1" href="#Iteration">7.3 Iteration</a></li> + <li><a id="toc-Macro-arguments-1" href="#Macro-arguments">7.4 Macro arguments</a></li> + <li><a id="toc-Converting-to-characters-1" href="#Converting-to-characters">7.5 Converting to characters</a></li> + <li><a id="toc-Expansion-1" href="#Expansion">7.6 Expansion</a> <ul class="no-bullet"> - <li><a name="toc-_005ccsn-and-_005cece-1" href="#g_t_005ccsn-and-_005cece">7.6.1 <code>\csn</code> and <code>\ece</code></a></li> - <li><a name="toc-_005cedefappend-1" href="#g_t_005cedefappend">7.6.2 <code>\edefappend</code></a></li> - <li><a name="toc-Hooks-1" href="#Hooks">7.6.3 Hooks</a></li> - <li><a name="toc-Properties-1" href="#Properties">7.6.4 Properties</a></li> - <li><a name="toc-_005cexpandonce-1" href="#g_t_005cexpandonce">7.6.5 <code>\expandonce</code></a></li> - <li><a name="toc-_005cifundefined-1" href="#g_t_005cifundefined">7.6.6 <code>\ifundefined</code></a></li> - <li><a name="toc-_005cifempty-1" href="#g_t_005cifempty">7.6.7 <code>\ifempty</code></a></li> - <li><a name="toc-_005cifinteger-and-_005cisinteger-1" href="#g_t_005cifinteger-and-_005cisinteger">7.6.8 <code>\ifinteger</code> and <code>\isinteger</code></a></li> - <li><a name="toc-_005cfuturenonspacelet-1" href="#g_t_005cfuturenonspacelet">7.6.9 <code>\futurenonspacelet</code></a></li> + <li><a id="toc-_005ccsn-and-_005cece-1" href="#g_t_005ccsn-and-_005cece">7.6.1 <code>\csn</code> and <code>\ece</code></a></li> + <li><a id="toc-_005cedefappend-1" href="#g_t_005cedefappend">7.6.2 <code>\edefappend</code></a></li> + <li><a id="toc-Hooks-1" href="#Hooks">7.6.3 Hooks</a></li> + <li><a id="toc-Properties-1" href="#Properties">7.6.4 Properties</a></li> + <li><a id="toc-_005cexpandonce-1" href="#g_t_005cexpandonce">7.6.5 <code>\expandonce</code></a></li> + <li><a id="toc-_005cifundefined-1" href="#g_t_005cifundefined">7.6.6 <code>\ifundefined</code></a></li> + <li><a id="toc-_005cifempty-1" href="#g_t_005cifempty">7.6.7 <code>\ifempty</code></a></li> + <li><a id="toc-_005cifinteger-and-_005cisinteger-1" href="#g_t_005cifinteger-and-_005cisinteger">7.6.8 <code>\ifinteger</code> and <code>\isinteger</code></a></li> + <li><a id="toc-_005cfuturenonspacelet-1" href="#g_t_005cfuturenonspacelet">7.6.9 <code>\futurenonspacelet</code></a></li> </ul></li> - <li><a name="toc-Obeying-spaces-1" href="#Obeying-spaces">7.7 Obeying spaces</a></li> - <li><a name="toc-Writing-out-numbers-1" href="#Writing-out-numbers">7.8 Writing out numbers</a></li> - <li><a name="toc-Mode_002dspecific-penalties-1" href="#Mode_002dspecific-penalties">7.9 Mode-specific penalties</a></li> - <li><a name="toc-Auxiliary-files-1" href="#Auxiliary-files">7.10 Auxiliary files</a></li> - <li><a name="toc-User_002ddefined-environments-1" href="#User_002ddefined-environments">7.11 User-defined environments</a></li> - <li><a name="toc-Page-list-and-page-range-parsers-1" href="#Page-list-and-page-range-parsers">7.12 Page list and page range parsers</a></li> + <li><a id="toc-Obeying-spaces-1" href="#Obeying-spaces">7.7 Obeying spaces</a></li> + <li><a id="toc-Writing-out-numbers-1" href="#Writing-out-numbers">7.8 Writing out numbers</a></li> + <li><a id="toc-Mode_002dspecific-penalties-1" href="#Mode_002dspecific-penalties">7.9 Mode-specific penalties</a></li> + <li><a id="toc-Auxiliary-files-1" href="#Auxiliary-files">7.10 Auxiliary files</a></li> + <li><a id="toc-User_002ddefined-environments-1" href="#User_002ddefined-environments">7.11 User-defined environments</a></li> + <li><a id="toc-Page-list-and-page-range-parsers-1" href="#Page-list-and-page-range-parsers">7.12 Page list and page range parsers</a></li> </ul></li> - <li><a name="toc-Demo-files-1" href="#Demo-files">8 Demo files</a> + <li><a id="toc-Demo-files-1" href="#Demo-files">8 Demo files</a> <ul class="no-bullet"> - <li><a name="toc-Hyperlinks-_0028xhyper_002etex_0029-1" href="#Hyperlinks-_0028xhyper_002etex_0029">8.1 Hyperlinks (<code>xhyper.tex</code>)</a></li> - <li><a name="toc-Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029-1" href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029">8.2 Highlighting TeX comments in listings (<code>lscommnt.tex</code>)</a></li> + <li><a id="toc-Hyperlinks-_0028xhyper_002etex_0029-1" href="#Hyperlinks-_0028xhyper_002etex_0029">8.1 Hyperlinks (<code>xhyper.tex</code>)</a></li> + <li><a id="toc-Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029-1" href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029">8.2 Highlighting TeX comments in listings (<code>lscommnt.tex</code>)</a></li> </ul></li> - <li><a name="toc-Macro-index-1" href="#Macro-index">Macro index</a></li> - <li><a name="toc-Concept-index-1" href="#Concept-index">Concept index</a></li> + <li><a id="toc-Macro-index-1" href="#Macro-index">Macro index</a></li> + <li><a id="toc-Concept-index-1" href="#Concept-index">Concept index</a></li> </ul> </div> -<a name="Top"></a> -<div class="header"> +<span id="Top"></span><div class="header"> <p> Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml/" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Eplain"></a> -<h1 class="top">Eplain</h1> +<span id="Eplain"></span><h1 class="top">Eplain</h1> -<p>This manual documents the Eplain macros, version 3.8, -May 2016. Eplain provides functionality for plain TeX that +<p>This manual documents the Eplain macros, version 3.9, +May 2019. Eplain provides functionality for plain TeX that is intended to be useful regardless of how your document is actually formatted. </p> @@ -285,29 +275,28 @@ Lewenberg has made additions and corrections. Oleg Katsitadze wrote the section on LaTeX packages and the chapter on hyperlinks, and updates throughout. </p> - -<p>The Eplain home page is <a href="http://tug.org/eplain">http://tug.org/eplain</a>. +<p>The Eplain home page is <a href="https://tug.org/eplain">https://tug.org/eplain</a>. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Introduction" accesskey="1">Introduction</a>:</td><td> </td><td align="left" valign="top">Eplain’s purpose and philosophy. +<tr><td align="left" valign="top">• <a href="#Introduction" accesskey="1">Introduction</a></td><td> </td><td align="left" valign="top">Eplain’s purpose and philosophy. </td></tr> -<tr><td align="left" valign="top">• <a href="#Installation" accesskey="2">Installation</a>:</td><td> </td><td align="left" valign="top">Installing Eplain. +<tr><td align="left" valign="top">• <a href="#Installation" accesskey="2">Installation</a></td><td> </td><td align="left" valign="top">Installing Eplain. </td></tr> -<tr><td align="left" valign="top">• <a href="#Invoking-Eplain" accesskey="3">Invoking Eplain</a>:</td><td> </td><td align="left" valign="top">Using Eplain from a TeX file. +<tr><td align="left" valign="top">• <a href="#Invoking-Eplain" accesskey="3">Invoking Eplain</a></td><td> </td><td align="left" valign="top">Using Eplain from a TeX file. </td></tr> -<tr><td align="left" valign="top">• <a href="#User-definitions" accesskey="4">User definitions</a>:</td><td> </td><td align="left" valign="top">Macros to be used in a document. +<tr><td align="left" valign="top">• <a href="#User-definitions" accesskey="4">User definitions</a></td><td> </td><td align="left" valign="top">Macros to be used in a document. </td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlinks" accesskey="5">Hyperlinks</a>:</td><td> </td><td align="left" valign="top">Producing documents with hyperlinks. +<tr><td align="left" valign="top">• <a href="#Hyperlinks" accesskey="5">Hyperlinks</a></td><td> </td><td align="left" valign="top">Producing documents with hyperlinks. </td></tr> -<tr><td align="left" valign="top">• <a href="#Arrow-theoretic-diagrams" accesskey="6">Arrow theoretic diagrams</a>:</td><td> </td><td align="left" valign="top">Macros for commutative diagrams. +<tr><td align="left" valign="top">• <a href="#Arrow-theoretic-diagrams" accesskey="6">Arrow theoretic diagrams</a></td><td> </td><td align="left" valign="top">Macros for commutative diagrams. </td></tr> -<tr><td align="left" valign="top">• <a href="#Programming-definitions" accesskey="7">Programming definitions</a>:</td><td> </td><td align="left" valign="top">Macros to be used in writing other macros. +<tr><td align="left" valign="top">• <a href="#Programming-definitions" accesskey="7">Programming definitions</a></td><td> </td><td align="left" valign="top">Macros to be used in writing other macros. </td></tr> -<tr><td align="left" valign="top">• <a href="#Demo-files" accesskey="8">Demo files</a>:</td><td> </td><td align="left" valign="top">Sample documents demonstrating Eplain. +<tr><td align="left" valign="top">• <a href="#Demo-files" accesskey="8">Demo files</a></td><td> </td><td align="left" valign="top">Sample documents demonstrating Eplain. </td></tr> -<tr><td align="left" valign="top">• <a href="#Macro-index" accesskey="9">Macro index</a>:</td><td> </td><td align="left" valign="top">Entries for TeX and Eplain control sequences. +<tr><td align="left" valign="top">• <a href="#Macro-index" accesskey="9">Macro index</a></td><td> </td><td align="left" valign="top">Entries for TeX and Eplain control sequences. </td></tr> -<tr><td align="left" valign="top">• <a href="#Concept-index">Concept index</a>:</td><td> </td><td align="left" valign="top">General index. +<tr><td align="left" valign="top">• <a href="#Concept-index">Concept index</a></td><td> </td><td align="left" valign="top">General index. </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> @@ -315,336 +304,334 @@ updates throughout. User definitions -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Diagnostics">Diagnostics</a>:</td><td> </td><td align="left" valign="top">Tracing information. +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Diagnostics">Diagnostics</a></td><td> </td><td align="left" valign="top">Tracing information. </td></tr> -<tr><td align="left" valign="top">• <a href="#Rules">Rules</a>:</td><td> </td><td align="left" valign="top">Changing the default rule dimensions. +<tr><td align="left" valign="top">• <a href="#Rules">Rules</a></td><td> </td><td align="left" valign="top">Changing the default rule dimensions. </td></tr> -<tr><td align="left" valign="top">• <a href="#Citations">Citations</a>:</td><td> </td><td align="left" valign="top">Using BibTeX and Eplain to make bibliographies. +<tr><td align="left" valign="top">• <a href="#Citations">Citations</a></td><td> </td><td align="left" valign="top">Using BibTeX and Eplain to make bibliographies. </td></tr> -<tr><td align="left" valign="top">• <a href="#Displays">Displays</a>:</td><td> </td><td align="left" valign="top">Changing the formatting of math displays. +<tr><td align="left" valign="top">• <a href="#Displays">Displays</a></td><td> </td><td align="left" valign="top">Changing the formatting of math displays. </td></tr> -<tr><td align="left" valign="top">• <a href="#Time-of-day">Time of day</a>:</td><td> </td><td align="left" valign="top">Producing the time of day. +<tr><td align="left" valign="top">• <a href="#Time-of-day">Time of day</a></td><td> </td><td align="left" valign="top">Producing the time of day. </td></tr> -<tr><td align="left" valign="top">• <a href="#Lists">Lists</a>:</td><td> </td><td align="left" valign="top">Producing numbered and unordered lists. +<tr><td align="left" valign="top">• <a href="#Lists">Lists</a></td><td> </td><td align="left" valign="top">Producing numbered and unordered lists. </td></tr> -<tr><td align="left" valign="top">• <a href="#Verbatim-listing">Verbatim listing</a>:</td><td> </td><td align="left" valign="top">Producing text just as it appears. +<tr><td align="left" valign="top">• <a href="#Verbatim-listing">Verbatim listing</a></td><td> </td><td align="left" valign="top">Producing text just as it appears. </td></tr> -<tr><td align="left" valign="top">• <a href="#Contents">Contents</a>:</td><td> </td><td align="left" valign="top">Making a table of contents. +<tr><td align="left" valign="top">• <a href="#Contents">Contents</a></td><td> </td><td align="left" valign="top">Making a table of contents. </td></tr> -<tr><td align="left" valign="top">• <a href="#Cross_002dreferences">Cross-references</a>:</td><td> </td><td align="left" valign="top">Symbolically referring to pages or equations. +<tr><td align="left" valign="top">• <a href="#Cross_002dreferences">Cross-references</a></td><td> </td><td align="left" valign="top">Symbolically referring to pages or equations. </td></tr> -<tr><td align="left" valign="top">• <a href="#Page-references">Page references</a>:</td><td> </td><td align="left" valign="top">Symbolic references to page numbers. +<tr><td align="left" valign="top">• <a href="#Page-references">Page references</a></td><td> </td><td align="left" valign="top">Symbolic references to page numbers. </td></tr> -<tr><td align="left" valign="top">• <a href="#Equation-references">Equation references</a>:</td><td> </td><td align="left" valign="top">Symbolic references to equation numbers. +<tr><td align="left" valign="top">• <a href="#Equation-references">Equation references</a></td><td> </td><td align="left" valign="top">Symbolic references to equation numbers. </td></tr> -<tr><td align="left" valign="top">• <a href="#Indexing">Indexing</a>:</td><td> </td><td align="left" valign="top">Creating and typesetting indexes. +<tr><td align="left" valign="top">• <a href="#Indexing">Indexing</a></td><td> </td><td align="left" valign="top">Creating and typesetting indexes. </td></tr> -<tr><td align="left" valign="top">• <a href="#Justification">Justification</a>:</td><td> </td><td align="left" valign="top">Left- or right-justification, or centering. +<tr><td align="left" valign="top">• <a href="#Justification">Justification</a></td><td> </td><td align="left" valign="top">Left- or right-justification, or centering. </td></tr> -<tr><td align="left" valign="top">• <a href="#Tables">Tables</a>:</td><td> </td><td align="left" valign="top">Producing ordered tables. +<tr><td align="left" valign="top">• <a href="#Tables">Tables</a></td><td> </td><td align="left" valign="top">Producing ordered tables. </td></tr> -<tr><td align="left" valign="top">• <a href="#Margins">Margins</a>:</td><td> </td><td align="left" valign="top">Changing the margins directly. +<tr><td align="left" valign="top">• <a href="#Margins">Margins</a></td><td> </td><td align="left" valign="top">Changing the margins directly. </td></tr> -<tr><td align="left" valign="top">• <a href="#Multiple-columns">Multiple columns</a>:</td><td> </td><td align="left" valign="top">Getting output in two columns. +<tr><td align="left" valign="top">• <a href="#Multiple-columns">Multiple columns</a></td><td> </td><td align="left" valign="top">Getting output in two columns. </td></tr> -<tr><td align="left" valign="top">• <a href="#Footnotes">Footnotes</a>:</td><td> </td><td align="left" valign="top">Autonumbered footnotes; changing formatting. +<tr><td align="left" valign="top">• <a href="#Footnotes">Footnotes</a></td><td> </td><td align="left" valign="top">Autonumbered footnotes; changing formatting. </td></tr> -<tr><td align="left" valign="top">• <a href="#Fractions">Fractions</a>:</td><td> </td><td align="left" valign="top">A better way to produce fractions in text. +<tr><td align="left" valign="top">• <a href="#Fractions">Fractions</a></td><td> </td><td align="left" valign="top">A better way to produce fractions in text. </td></tr> -<tr><td align="left" valign="top">• <a href="#Paths">Paths</a>:</td><td> </td><td align="left" valign="top">Allowing line breaks in pathnames. +<tr><td align="left" valign="top">• <a href="#Paths">Paths</a></td><td> </td><td align="left" valign="top">Allowing line breaks in pathnames. </td></tr> -<tr><td align="left" valign="top">• <a href="#Logos">Logos</a>:</td><td> </td><td align="left" valign="top">Various logos. +<tr><td align="left" valign="top">• <a href="#Logos">Logos</a></td><td> </td><td align="left" valign="top">Various logos. </td></tr> -<tr><td align="left" valign="top">• <a href="#Boxes">Boxes</a>:</td><td> </td><td align="left" valign="top">Producing filled or open rectangles. +<tr><td align="left" valign="top">• <a href="#Boxes">Boxes</a></td><td> </td><td align="left" valign="top">Producing filled or open rectangles. </td></tr> -<tr><td align="left" valign="top">• <a href="#Checking-for-PDF-output">Checking for PDF output</a>:</td><td> </td><td align="left" valign="top">Checking for pdfTeX in PDF mode. +<tr><td align="left" valign="top">• <a href="#Checking-for-PDF-output">Checking for PDF output</a></td><td> </td><td align="left" valign="top">Checking for pdfTeX in PDF mode. </td></tr> -<tr><td align="left" valign="top">• <a href="#Loading-LaTeX-packages">Loading LaTeX packages</a>:</td><td> </td><td align="left" valign="top">Support for LaTeX packages under plain TeX. +<tr><td align="left" valign="top">• <a href="#Loading-LaTeX-packages">Loading LaTeX packages</a></td><td> </td><td align="left" valign="top">Support for LaTeX packages under plain TeX. </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Citations -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Formatting-citations">Formatting citations</a>:</td><td> </td><td align="left" valign="top">Changing the way citations are printed. +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Formatting-citations">Formatting citations</a></td><td> </td><td align="left" valign="top">Changing the way citations are printed. </td></tr> -<tr><td align="left" valign="top">• <a href="#Formatting-bibliographies">Formatting bibliographies</a>:</td><td> </td><td align="left" valign="top">Changing the way bibliographies are printed. +<tr><td align="left" valign="top">• <a href="#Formatting-bibliographies">Formatting bibliographies</a></td><td> </td><td align="left" valign="top">Changing the way bibliographies are printed. </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Displays -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Formatting-displays">Formatting displays</a>:</td><td> </td><td align="left" valign="top">General formatting of displays. +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Formatting-displays">Formatting displays</a></td><td> </td><td align="left" valign="top">General formatting of displays. </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Lists -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Formatting-lists">Formatting lists</a>:</td><td> </td><td align="left" valign="top">Changing how the lists look. +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Formatting-lists">Formatting lists</a></td><td> </td><td align="left" valign="top">Changing how the lists look. </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Contents -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Writing-the-_002etoc-file">Writing the .toc file</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Writing-the-_002etoc-file">Writing the .toc file</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Reading-the-_002etoc-file">Reading the .toc file</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Reading-the-_002etoc-file">Reading the .toc file</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Changing-the-_002etoc-file_0027s-root-name">Changing the .toc file's root name</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Changing-the-_002etoc-file_0027s-root-name">Changing the .toc file's root name</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Alternative-contents-files">Alternative contents files</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Alternative-contents-files">Alternative contents files</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Cross-references -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Defining-generic-references">Defining generic references</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Defining-generic-references">Defining generic references</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Using-generic-references">Using generic references</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Using-generic-references">Using generic references</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Equation references -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Formatting-equation-references">Formatting equation references</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Formatting-equation-references">Formatting equation references</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Subequation-references">Subequation references</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Subequation-references">Subequation references</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Indexing -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Indexing-terms">Indexing terms</a>:</td><td> </td><td align="left" valign="top">Specifying what to index. +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Indexing-terms">Indexing terms</a></td><td> </td><td align="left" valign="top">Specifying what to index. </td></tr> -<tr><td align="left" valign="top">• <a href="#Typesetting-an-index">Typesetting an index</a>:</td><td> </td><td align="left" valign="top">Printing the sorted output. +<tr><td align="left" valign="top">• <a href="#Typesetting-an-index">Typesetting an index</a></td><td> </td><td align="left" valign="top">Printing the sorted output. </td></tr> -<tr><td align="left" valign="top">• <a href="#Customizing-indexing">Customizing indexing</a>:</td><td> </td><td align="left" valign="top">Creating commands and specifying extra actions. +<tr><td align="left" valign="top">• <a href="#Customizing-indexing">Customizing indexing</a></td><td> </td><td align="left" valign="top">Creating commands and specifying extra actions. </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Indexing terms -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Indexing-commands">Indexing commands</a>:</td><td> </td><td align="left" valign="top">Making index entries. +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Indexing-commands">Indexing commands</a></td><td> </td><td align="left" valign="top">Making index entries. </td></tr> -<tr><td align="left" valign="top">• <a href="#Modifying-index-entries">Modifying index entries</a>:</td><td> </td><td align="left" valign="top">Ranges, see/see also, page number typesetting. +<tr><td align="left" valign="top">• <a href="#Modifying-index-entries">Modifying index entries</a></td><td> </td><td align="left" valign="top">Ranges, see/see also, page number typesetting. </td></tr> -<tr><td align="left" valign="top">• <a href="#Index-entries-with-special-characters">Index entries with special characters</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Index-entries-with-special-characters">Index entries with special characters</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Proofing-index-terms">Proofing index terms</a>:</td><td> </td><td align="left" valign="top">Noting index entries in the margins. +<tr><td align="left" valign="top">• <a href="#Proofing-index-terms">Proofing index terms</a></td><td> </td><td align="left" valign="top">Noting index entries in the margins. </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Loading LaTeX packages -</pre></th></tr><tr><td align="left" valign="top">• <a href="#The-_005cusepackage-command">The \usepackage command</a>:</td><td> </td><td align="left" valign="top">Command to load packages. +</pre></th></tr><tr><td align="left" valign="top">• <a href="#The-_005cusepackage-command">The \usepackage command</a></td><td> </td><td align="left" valign="top">Command to load packages. </td></tr> -<tr><td align="left" valign="top">• <a href="#Environment-for-loading-packages">Environment for loading packages</a>:</td><td> </td><td align="left" valign="top">Environment for the \usepackage commands. +<tr><td align="left" valign="top">• <a href="#Environment-for-loading-packages">Environment for loading packages</a></td><td> </td><td align="left" valign="top">Environment for the \usepackage commands. </td></tr> -<tr><td align="left" valign="top">• <a href="#Packages-known-to-work">Packages known to work</a>:</td><td> </td><td align="left" valign="top">Supported packages. +<tr><td align="left" valign="top">• <a href="#Packages-known-to-work">Packages known to work</a></td><td> </td><td align="left" valign="top">Supported packages. </td></tr> -<tr><td align="left" valign="top">• <a href="#Packages-known-not-to-work">Packages known not to work</a>:</td><td> </td><td align="left" valign="top">Packages known not to work with Eplain. +<tr><td align="left" valign="top">• <a href="#Packages-known-not-to-work">Packages known not to work</a></td><td> </td><td align="left" valign="top">Packages known not to work with Eplain. </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Hyperlinks -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Introduction-to-hyperlinks">Introduction to hyperlinks</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Introduction-to-hyperlinks">Introduction to hyperlinks</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Explicit-hyperlinks">Explicit hyperlinks</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Explicit-hyperlinks">Explicit hyperlinks</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Implicit-hyperlinks">Implicit hyperlinks</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Implicit-hyperlinks">Implicit hyperlinks</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-drivers">Hyperlink drivers</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Hyperlink-drivers">Hyperlink drivers</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Setting-hyperlink-types-and-options">Setting hyperlink types and options</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Setting-hyperlink-types-and-options">Setting hyperlink types and options</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Turning-hyperlinks-on_002foff">Turning hyperlinks on/off</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Turning-hyperlinks-on_002foff">Turning hyperlinks on/off</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Implicit hyperlinks -</pre></th></tr><tr><td align="left" valign="top">• <a href="#General-hyperlinks">General hyperlinks</a>:</td><td> </td><td align="left" valign="top">hrefint, hrefext +</pre></th></tr><tr><td align="left" valign="top">• <a href="#General-hyperlinks">General hyperlinks</a></td><td> </td><td align="left" valign="top">hrefint, hrefext </td></tr> -<tr><td align="left" valign="top">• <a href="#URL-hyperlinks">URL hyperlinks</a>:</td><td> </td><td align="left" valign="top">url +<tr><td align="left" valign="top">• <a href="#URL-hyperlinks">URL hyperlinks</a></td><td> </td><td align="left" valign="top">url </td></tr> -<tr><td align="left" valign="top">• <a href="#Citation-hyperlinks">Citation hyperlinks</a>:</td><td> </td><td align="left" valign="top">cite, bib +<tr><td align="left" valign="top">• <a href="#Citation-hyperlinks">Citation hyperlinks</a></td><td> </td><td align="left" valign="top">cite, bib </td></tr> -<tr><td align="left" valign="top">• <a href="#List-hyperlinks">List hyperlinks</a>:</td><td> </td><td align="left" valign="top">li +<tr><td align="left" valign="top">• <a href="#List-hyperlinks">List hyperlinks</a></td><td> </td><td align="left" valign="top">li </td></tr> -<tr><td align="left" valign="top">• <a href="#Cross_002dreference-hyperlinks">Cross-reference hyperlinks</a>:</td><td> </td><td align="left" valign="top">definexref, ref +<tr><td align="left" valign="top">• <a href="#Cross_002dreference-hyperlinks">Cross-reference hyperlinks</a></td><td> </td><td align="left" valign="top">definexref, ref </td></tr> -<tr><td align="left" valign="top">• <a href="#Page-reference-hyperlinks">Page reference hyperlinks</a>:</td><td> </td><td align="left" valign="top">xrdef, xref +<tr><td align="left" valign="top">• <a href="#Page-reference-hyperlinks">Page reference hyperlinks</a></td><td> </td><td align="left" valign="top">xrdef, xref </td></tr> -<tr><td align="left" valign="top">• <a href="#Equation-reference-hyperlinks">Equation reference hyperlinks</a>:</td><td> </td><td align="left" valign="top">eq +<tr><td align="left" valign="top">• <a href="#Equation-reference-hyperlinks">Equation reference hyperlinks</a></td><td> </td><td align="left" valign="top">eq </td></tr> -<tr><td align="left" valign="top">• <a href="#Index-hyperlinks">Index hyperlinks</a>:</td><td> </td><td align="left" valign="top">idx +<tr><td align="left" valign="top">• <a href="#Index-hyperlinks">Index hyperlinks</a></td><td> </td><td align="left" valign="top">idx </td></tr> -<tr><td align="left" valign="top">• <a href="#Footnote-hyperlinks">Footnote hyperlinks</a>:</td><td> </td><td align="left" valign="top">foot, footback +<tr><td align="left" valign="top">• <a href="#Footnote-hyperlinks">Footnote hyperlinks</a></td><td> </td><td align="left" valign="top">foot, footback </td></tr> -<tr><td align="left" valign="top">• <a href="#Contents-hyperlinks">Contents hyperlinks</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Contents-hyperlinks">Contents hyperlinks</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Index hyperlinks -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Exact-destinations-for-index-terms">Exact destinations for index terms</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Exact-destinations-for-index-terms">Exact destinations for index terms</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Page-destinations-for-index-terms">Page destinations for index terms</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Page-destinations-for-index-terms">Page destinations for index terms</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Choosing-destination-placement">Choosing destination placement</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Choosing-destination-placement">Choosing destination placement</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Index-page-list-and-page-range-parsers">Index page list and page range parsers</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Index-page-list-and-page-range-parsers">Index page list and page range parsers</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlinks-in-see-and-see-also-entries">Hyperlinks in see and see also entries</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Hyperlinks-in-see-and-see-also-entries">Hyperlinks in see and see also entries</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Hyperlink drivers -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Options-supported-by-all-drivers">Options supported by all drivers</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Options-supported-by-all-drivers">Options supported by all drivers</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-driver-hypertex">Hyperlink driver hypertex</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Hyperlink-driver-hypertex">Hyperlink driver hypertex</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-drivers-pdftex-and-dvipdfm">Hyperlink drivers pdftex and dvipdfm</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Hyperlink-drivers-pdftex-and-dvipdfm">Hyperlink drivers pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-driver-nolinks">Hyperlink driver nolinks</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Hyperlink-driver-nolinks">Hyperlink driver nolinks</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Hyperlink driver hypertex:: -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Destination-types-for-hypertex">Destination types for hypertex</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Destination-types-for-hypertex">Destination types for hypertex</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Destination-options-for-hypertex">Destination options for hypertex</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Destination-options-for-hypertex">Destination options for hypertex</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Link-types-for-hypertex">Link types for hypertex</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Link-types-for-hypertex">Link types for hypertex</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Link-options-for-hypertex">Link options for hypertex</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Link-options-for-hypertex">Link options for hypertex</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Hyperlink drivers pdftex and dvipdfm:: -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Destination-types-for-pdftex-and-dvipdfm">Destination types for pdftex and dvipdfm</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Destination-types-for-pdftex-and-dvipdfm">Destination types for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Destination-options-for-pdftex-and-dvipdfm">Destination options for pdftex and dvipdfm</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Destination-options-for-pdftex-and-dvipdfm">Destination options for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Setting hyperlink types and options -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Setting-default-types-and-options">Setting default types and options</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Setting-default-types-and-options">Setting default types and options</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Setting-group-types">Setting group types</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Setting-group-types">Setting group types</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Setting-group-options">Setting group options</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Setting-group-options">Setting group options</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Turning hyperlinks on/off -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Turning-low_002dlevel-commands-on_002foff">Turning low-level commands on/off</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Turning-low_002dlevel-commands-on_002foff">Turning low-level commands on/off</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Turning-hyperlinks-on_002foff-for-a-group">Turning hyperlinks on/off for a group</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Turning-hyperlinks-on_002foff-for-a-group">Turning hyperlinks on/off for a group</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Arrow theoretic diagrams -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Slanted-lines-and-vectors">Slanted lines and vectors</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Slanted-lines-and-vectors">Slanted lines and vectors</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Commutative-diagrams">Commutative diagrams</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Commutative-diagrams">Commutative diagrams</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Commutative diagrams -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Arrows-and-morphisms">Arrows and morphisms</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Arrows-and-morphisms">Arrows and morphisms</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Commutative-diagram-parameters">Commutative diagram parameters</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Commutative-diagram-parameters">Commutative diagram parameters</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Programming definitions -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Category-codes">Category codes</a>:</td><td> </td><td align="left" valign="top">Changing category codes. +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Category-codes">Category codes</a></td><td> </td><td align="left" valign="top">Changing category codes. </td></tr> -<tr><td align="left" valign="top">• <a href="#Allocation-macros">Allocation macros</a>:</td><td> </td><td align="left" valign="top">Non-outer versions of \newcount et al. +<tr><td align="left" valign="top">• <a href="#Allocation-macros">Allocation macros</a></td><td> </td><td align="left" valign="top">Non-outer versions of \newcount et al. </td></tr> -<tr><td align="left" valign="top">• <a href="#Iteration">Iteration</a>:</td><td> </td><td align="left" valign="top">Doing ‘for’ and ‘while’ loops in TeX. +<tr><td align="left" valign="top">• <a href="#Iteration">Iteration</a></td><td> </td><td align="left" valign="top">Doing ‘for’ and ‘while’ loops in TeX. </td></tr> -<tr><td align="left" valign="top">• <a href="#Macro-arguments">Macro arguments</a>:</td><td> </td><td align="left" valign="top">Reading and ignoring them. +<tr><td align="left" valign="top">• <a href="#Macro-arguments">Macro arguments</a></td><td> </td><td align="left" valign="top">Reading and ignoring them. </td></tr> -<tr><td align="left" valign="top">• <a href="#Converting-to-characters">Converting to characters</a>:</td><td> </td><td align="left" valign="top">Normalizing control sequences and spaces. +<tr><td align="left" valign="top">• <a href="#Converting-to-characters">Converting to characters</a></td><td> </td><td align="left" valign="top">Normalizing control sequences and spaces. </td></tr> -<tr><td align="left" valign="top">• <a href="#Expansion">Expansion</a>:</td><td> </td><td align="left" valign="top">Controlling expansion. +<tr><td align="left" valign="top">• <a href="#Expansion">Expansion</a></td><td> </td><td align="left" valign="top">Controlling expansion. </td></tr> -<tr><td align="left" valign="top">• <a href="#Obeying-spaces">Obeying spaces</a>:</td><td> </td><td align="left" valign="top">Making whitespace count anywhere. +<tr><td align="left" valign="top">• <a href="#Obeying-spaces">Obeying spaces</a></td><td> </td><td align="left" valign="top">Making whitespace count anywhere. </td></tr> -<tr><td align="left" valign="top">• <a href="#Writing-out-numbers">Writing out numbers</a>:</td><td> </td><td align="left" valign="top">Making ‘1’ into ‘one’. +<tr><td align="left" valign="top">• <a href="#Writing-out-numbers">Writing out numbers</a></td><td> </td><td align="left" valign="top">Making ‘1’ into ‘one’. </td></tr> -<tr><td align="left" valign="top">• <a href="#Mode_002dspecific-penalties">Mode-specific penalties</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Mode_002dspecific-penalties">Mode-specific penalties</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Auxiliary-files">Auxiliary files</a>:</td><td> </td><td align="left" valign="top">Testing for their existence. +<tr><td align="left" valign="top">• <a href="#Auxiliary-files">Auxiliary files</a></td><td> </td><td align="left" valign="top">Testing for their existence. </td></tr> -<tr><td align="left" valign="top">• <a href="#User_002ddefined-environments">User-defined environments</a>:</td><td> </td><td align="left" valign="top">User-defined environments. +<tr><td align="left" valign="top">• <a href="#User_002ddefined-environments">User-defined environments</a></td><td> </td><td align="left" valign="top">User-defined environments. </td></tr> -<tr><td align="left" valign="top">• <a href="#Page-list-and-page-range-parsers">Page list and page range parsers</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Page-list-and-page-range-parsers">Page list and page range parsers</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Expansion -</pre></th></tr><tr><td align="left" valign="top">• <a href="#g_t_005ccsn-and-_005cece">\csn and \ece</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#g_t_005ccsn-and-_005cece">\csn and \ece</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cedefappend">\edefappend</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#g_t_005cedefappend">\edefappend</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hooks">Hooks</a>:</td><td> </td><td align="left" valign="top">Manipulating and executing named actions. +<tr><td align="left" valign="top">• <a href="#Hooks">Hooks</a></td><td> </td><td align="left" valign="top">Manipulating and executing named actions. </td></tr> -<tr><td align="left" valign="top">• <a href="#Properties">Properties</a>:</td><td> </td><td align="left" valign="top">Associating information with a csname. +<tr><td align="left" valign="top">• <a href="#Properties">Properties</a></td><td> </td><td align="left" valign="top">Associating information with a csname. </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cexpandonce">\expandonce</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#g_t_005cexpandonce">\expandonce</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cifundefined">\ifundefined</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#g_t_005cifundefined">\ifundefined</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cifempty">\ifempty</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#g_t_005cifempty">\ifempty</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cifinteger-and-_005cisinteger">\ifinteger and \isinteger</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#g_t_005cifinteger-and-_005cisinteger">\ifinteger and \isinteger</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cfuturenonspacelet">\futurenonspacelet</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#g_t_005cfuturenonspacelet">\futurenonspacelet</a></td><td> </td><td align="left" valign="top"> </td></tr> <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> Demo files -</pre></th></tr><tr><td align="left" valign="top">• <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a>:</td><td> </td><td align="left" valign="top"> +</pre></th></tr><tr><td align="left" valign="top">• <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029">Highlighting TeX comments in listings (lscommnt.tex)</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029">Highlighting TeX comments in listings (lscommnt.tex)</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Introduction"></a> -<div class="header"> +<span id="Introduction"></span><div class="header"> <p> Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Introduction-1"></a> -<h2 class="chapter">1 Introduction</h2> +<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2> -<a name="index-Eplain_002c-purpose-of"></a> +<span id="index-Eplain_002c-purpose-of"></span> -<a name="index-xeplain_002etex"></a> +<span id="index-xeplain_002etex"></span> <p>The <em>Eplain</em> macro package expands on and extends the definitions in -plain TeX. Its home on the web is <a href="http://tug.org/eplain">http://tug.org/eplain</a>. +plain TeX. Its home on the web is <a href="https://tug.org/eplain">https://tug.org/eplain</a>. </p> <p>This manual describes the definitions that you, as either an author or a macro writer, might like to use. It doesn’t discuss the @@ -653,13 +640,13 @@ for that. </p> <p>Eplain is not intended to provide typesetting capabilities, as does LaTeX (originally written by Leslie Lamport) -<a name="index-LaTeX"></a> -<a name="index-Lamport_002c-Leslie"></a> +<span id="index-LaTeX"></span> +<span id="index-Lamport_002c-Leslie"></span> and Texinfo -<a name="index-Texinfo"></a> +<span id="index-Texinfo"></span> (Originally written by Richard Stallman). -<a name="index-Stallman_002c-Richard"></a> -<a name="index-rms"></a> +<span id="index-Stallman_002c-Richard"></span> +<span id="index-rms"></span> Instead, it provides definitions that are intended to be useful regardless of the high-level commands that you use when you actually prepare your manuscript. @@ -676,7 +663,7 @@ put in extra work to override the defaults. <p>On the other hand, almost everyone would like capabilities such as cross-referencing by labels, so that you don’t have to put actual page numbers in the manuscript. The author of Eplain -<a name="index-Berry_002c-Karl"></a> +<span id="index-Berry_002c-Karl"></span> is not aware of any generally available macro packages that (1) do not force their typographic style on an author, and yet (2) provide such capabilities. @@ -697,8 +684,8 @@ people writing other macros will be able to use them. <p>You can send bug reports or suggestions to <a href="mailto:tex-eplain@tug.org">tex-eplain@tug.org</a>. The current version number of Eplain is defined as the macro <code>\fmtversion</code> -<a name="index-version-number"></a> -<a name="index-fmtversion"></a> +<span id="index-version-number"></span> +<span id="index-fmtversion"></span> at the end of the source file <samp>eplain.tex</samp>. When corresponding, please refer to it. </p> @@ -712,28 +699,26 @@ a line <p>or visit <a href="http://lists.tug.org/tex-eplain">http://lists.tug.org/tex-eplain</a>. </p> -<a name="index-Walden_002c-David"></a> +<span id="index-Walden_002c-David"></span> <p>David Walden had reported his experience with Eplain as a new user. The article is available online at -<a href="http://tug.org/pracjourn/2005-4/walden">http://tug.org/pracjourn/2005-4/walden</a>. An introductory +<a href="https://tug.org/pracjourn/2005-4/walden">https://tug.org/pracjourn/2005-4/walden</a>. An introductory article (written for -<a name="index-TUGboat"></a> +<span id="index-TUGboat"></span> <i>TUGboat</i>) is also available online at -<a href="http://tug.org/eplain/misc/tb84katsi.pdf">http://tug.org/eplain/misc/tb84katsi.pdf</a>. +<a href="https://tug.org/eplain/misc/tb84katsi.pdf">https://tug.org/eplain/misc/tb84katsi.pdf</a>. </p> <hr> -<a name="Installation"></a> -<div class="header"> +<span id="Installation"></span><div class="header"> <p> Next: <a href="#Invoking-Eplain" accesskey="n" rel="next">Invoking Eplain</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Installation-1"></a> -<h2 class="chapter">2 Installation</h2> +<span id="Installation-1"></span><h2 class="chapter">2 Installation</h2> -<a name="index-Eplain_002c-installing"></a> -<a name="index-installation"></a> -<a name="index-Eplain_002c-upgrading"></a> -<a name="index-upgrading"></a> +<span id="index-Eplain_002c-installing"></span> +<span id="index-installation"></span> +<span id="index-Eplain_002c-upgrading"></span> +<span id="index-upgrading"></span> <p>Your TeX installation should already contain a version of Eplain (<samp>eplain.tex</samp>) in its main <samp>texmf</samp> tree (usually under <samp>/usr/share/texmf/tex/eplain/</samp> on Unix systems). To install a @@ -751,15 +736,15 @@ then should go under <samp>~/texmf/tex/eplain/</samp>. For more information about TeX directory structure, please see <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds</a>. </p> -<a name="index-TEXINPUTS"></a> +<span id="index-TEXINPUTS"></span> <p>If you prefer to install <samp>eplain.tex</samp> in a non-standard place, set an environment variable (<code>TEXINPUTS</code> for the Web2C port of TeX to Unix) to tell TeX how to find it. </p> <p>If you want, you can also create a format (<samp>.fmt</samp>) -<a name="index-_002efmt-file"></a> -<a name="index-format-file"></a> -<a name="index-eplain_002efmt"></a> +<span id="index-_002efmt-file"></span> +<span id="index-format-file"></span> +<span id="index-eplain_002efmt"></span> file for Eplain, which will eliminate the time spent reading the macro source file with <code>\input</code>. You do this by issuing a sequence of Unix commands something like this: @@ -774,13 +759,13 @@ This is TeX, ... ... <var>messages</var> ... </pre></div> -<a name="index-eplain_002eaux"></a> -<a name="index-undefined-labels_002c-warnings-about"></a> +<span id="index-eplain_002eaux"></span> +<span id="index-undefined-labels_002c-warnings-about"></span> <p>You must make sure that <samp>eplain.aux</samp> exists <em>before</em> you run <samp>initex</samp>; otherwise, warning messages about undefined labels will never be issued. </p> -<a name="index-TEXFORMATS"></a> +<span id="index-TEXFORMATS"></span> <p>You then have to install the resulting <samp>eplain.fmt</samp> in your local <samp>texmf</samp> tree or set an environment variable to tell TeX how to find it. For the Web2C port of TeX to Unix, format files are usually @@ -789,15 +774,13 @@ installed under <samp>/usr/local/share/texmf/web2c/</samp> or <code>TEXFORMATS</code>. </p> <hr> -<a name="Invoking-Eplain"></a> -<div class="header"> +<span id="Invoking-Eplain"></span><div class="header"> <p> Next: <a href="#User-definitions" accesskey="n" rel="next">User definitions</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Invoking-Eplain-1"></a> -<h2 class="chapter">3 Invoking Eplain</h2> +<span id="Invoking-Eplain-1"></span><h2 class="chapter">3 Invoking Eplain</h2> -<a name="index-Eplain_002c-invoking"></a> +<span id="index-Eplain_002c-invoking"></span> <p>The simplest way to use Eplain is simply to put: </p> <div class="example"> @@ -809,7 +792,7 @@ enough that reading it does not take an unbearably long time—at least on contemporary machines. </p> <p>In addition, if a format (<samp>.fmt</samp>) -<a name="index-_002efmt-file-1"></a> +<span id="index-_002efmt-file-1"></span> file has been created for Eplain (see the previous section), you can eliminate the time spent reading the macro source file. You do this by responding <code>&eplain</code> to TeX’s ‘<samp>**</samp>’ prompt. For @@ -830,7 +813,7 @@ won’t know if the Eplain format will be loaded already. If it is, then doing <code>\input eplain</code> will waste time; if it isn’t, then you must load it. To solve this, Eplain defines the control sequence <code>\eplain</code> -<a name="index-eplain"></a> +<span id="index-eplain"></span> to be the letter <code>t</code> (a convention borrowed from Lisp; it doesn’t actually matter what the definition is, only that the definition exists). Therefore, you can do the following: @@ -878,7 +861,7 @@ by Nelson Beebe. <p>The file <samp>eplain.tex</samp> is all of these files merged together, with comments removed. The original sources can be found in Eplain source zip archive in your TeX distribution, on <acronym>CTAN</acronym> -or on Eplain’s home page at <a href="http://tug.org/eplain">http://tug.org/eplain</a>. +or on Eplain’s home page at <a href="https://tug.org/eplain">https://tug.org/eplain</a>. </p> <p>All of these files except <samp>xeplain.tex</samp> can be input individually, if all you want are the definitions in that file. @@ -886,7 +869,7 @@ if all you want are the definitions in that file. <p>Also, since the bibliography macros are fairly extensive, you might not want to load them, to conserve TeX’s memory. Therefore, if the control sequence <code>\nobibtex</code> -<a name="index-nobibtex"></a> +<span id="index-nobibtex"></span> is defined, then the bibliography definitions are skipped. You must set <code>\nobibtex</code> before <samp>eplain.tex</samp> is read, naturally. For example, you could start your input file like this: @@ -899,19 +882,19 @@ example, you could start your input file like this: <p>By default, <code>\nobibtex</code> is undefined, and so the bibliography definitions <em>are</em> made. </p> -<a name="index-noarrow"></a> +<span id="index-noarrow"></span> <p>Likewise, define <code>\noarrow</code> if you don’t want to include the commutative diagram macros from <samp>arrow.tex</samp>, perhaps because you already have conflicting ones. </p> <p>If you don’t want to read or write an <samp>aux</samp> file at all, for any kind of cross-referencing, define <code>\noauxfile</code> -<a name="index-noauxfile"></a> +<span id="index-noauxfile"></span> before reading <samp>eplain.tex</samp>. This also turns off all warnings about undefined labels. </p> -<a name="index-amsppt_002esty"></a> -<a name="index-AMSTeX-conflicts"></a> +<span id="index-amsppt_002esty"></span> +<span id="index-AMSTeX-conflicts"></span> <p>Eplain conflicts with AMSTeX (to be precise, with <samp>amsppt.sty</samp>): the macros <code>\cite</code> and <code>\ref</code> are defined by both. </p> @@ -924,9 +907,9 @@ a warning on your terminal. If you want to use the AMSTeX To avoid the warning, do <code>\let\ref = \eplainref</code> after reading Eplain and before using <code>\ref</code>. </p> -<a name="index-texi2dvi"></a> -<a name="index-bibtex"></a> -<a name="index-makeindex"></a> +<span id="index-texi2dvi"></span> +<span id="index-bibtex"></span> +<span id="index-makeindex"></span> <p>Sometimes you may need to run TeX more then once on your <samp>.tex</samp> file in order to produce and typeset indexes, resolve undefined cross-references and/or citations. The shell script @@ -941,120 +924,116 @@ Bourne-compatible shell, the following command will do all the work: <pre class="example">prompt$ LATEX=tex texi2dvi file.tex </pre></div> -<a name="index-pdftex"></a> +<span id="index-pdftex"></span> <p>(Despite the name, <code>texi2dvi</code> can also produce <samp>.pdf</samp> files; just set ‘<samp>LATEX=pdftex</samp>’.) See the output from the command <code>texi2dvi --help</code> for invoking information and a full list of options. </p> <hr> -<a name="User-definitions"></a> -<div class="header"> +<span id="User-definitions"></span><div class="header"> <p> Next: <a href="#Hyperlinks" accesskey="n" rel="next">Hyperlinks</a>, Previous: <a href="#Invoking-Eplain" accesskey="p" rel="prev">Invoking Eplain</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="User-definitions-1"></a> -<h2 class="chapter">4 User definitions</h2> +<span id="User-definitions-1"></span><h2 class="chapter">4 User definitions</h2> <p>This chapter describes definitions that are meant to be used directly in a document. When appropriate, ways to change the default formatting are described in subsections. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Diagnostics" accesskey="1">Diagnostics</a>:</td><td> </td><td align="left" valign="top">Tracing information. +<tr><td align="left" valign="top">• <a href="#Diagnostics" accesskey="1">Diagnostics</a></td><td> </td><td align="left" valign="top">Tracing information. </td></tr> -<tr><td align="left" valign="top">• <a href="#Rules" accesskey="2">Rules</a>:</td><td> </td><td align="left" valign="top">Changing the default rule dimensions. +<tr><td align="left" valign="top">• <a href="#Rules" accesskey="2">Rules</a></td><td> </td><td align="left" valign="top">Changing the default rule dimensions. </td></tr> -<tr><td align="left" valign="top">• <a href="#Citations" accesskey="3">Citations</a>:</td><td> </td><td align="left" valign="top">Using BibTeX and Eplain to make bibliographies. +<tr><td align="left" valign="top">• <a href="#Citations" accesskey="3">Citations</a></td><td> </td><td align="left" valign="top">Using BibTeX and Eplain to make bibliographies. </td></tr> -<tr><td align="left" valign="top">• <a href="#Displays" accesskey="4">Displays</a>:</td><td> </td><td align="left" valign="top">Changing the formatting of math displays. +<tr><td align="left" valign="top">• <a href="#Displays" accesskey="4">Displays</a></td><td> </td><td align="left" valign="top">Changing the formatting of math displays. </td></tr> -<tr><td align="left" valign="top">• <a href="#Time-of-day" accesskey="5">Time of day</a>:</td><td> </td><td align="left" valign="top">Producing the time of day. +<tr><td align="left" valign="top">• <a href="#Time-of-day" accesskey="5">Time of day</a></td><td> </td><td align="left" valign="top">Producing the time of day. </td></tr> -<tr><td align="left" valign="top">• <a href="#Lists" accesskey="6">Lists</a>:</td><td> </td><td align="left" valign="top">Producing numbered and unordered lists. +<tr><td align="left" valign="top">• <a href="#Lists" accesskey="6">Lists</a></td><td> </td><td align="left" valign="top">Producing numbered and unordered lists. </td></tr> -<tr><td align="left" valign="top">• <a href="#Verbatim-listing" accesskey="7">Verbatim listing</a>:</td><td> </td><td align="left" valign="top">Producing text just as it appears. +<tr><td align="left" valign="top">• <a href="#Verbatim-listing" accesskey="7">Verbatim listing</a></td><td> </td><td align="left" valign="top">Producing text just as it appears. </td></tr> -<tr><td align="left" valign="top">• <a href="#Contents" accesskey="8">Contents</a>:</td><td> </td><td align="left" valign="top">Making a table of contents. +<tr><td align="left" valign="top">• <a href="#Contents" accesskey="8">Contents</a></td><td> </td><td align="left" valign="top">Making a table of contents. </td></tr> -<tr><td align="left" valign="top">• <a href="#Cross_002dreferences" accesskey="9">Cross-references</a>:</td><td> </td><td align="left" valign="top">Symbolic references to equations, figures, etc. +<tr><td align="left" valign="top">• <a href="#Cross_002dreferences" accesskey="9">Cross-references</a></td><td> </td><td align="left" valign="top">Symbolic references to equations, figures, etc. </td></tr> -<tr><td align="left" valign="top">• <a href="#Page-references">Page references</a>:</td><td> </td><td align="left" valign="top">Symbolic references to page numbers. +<tr><td align="left" valign="top">• <a href="#Page-references">Page references</a></td><td> </td><td align="left" valign="top">Symbolic references to page numbers. </td></tr> -<tr><td align="left" valign="top">• <a href="#Equation-references">Equation references</a>:</td><td> </td><td align="left" valign="top">Symbolic references to equation numbers. +<tr><td align="left" valign="top">• <a href="#Equation-references">Equation references</a></td><td> </td><td align="left" valign="top">Symbolic references to equation numbers. </td></tr> -<tr><td align="left" valign="top">• <a href="#Indexing">Indexing</a>:</td><td> </td><td align="left" valign="top">Creating and typesetting indexes. +<tr><td align="left" valign="top">• <a href="#Indexing">Indexing</a></td><td> </td><td align="left" valign="top">Creating and typesetting indexes. </td></tr> -<tr><td align="left" valign="top">• <a href="#Justification">Justification</a>:</td><td> </td><td align="left" valign="top">Ragged left, ragged right, centered. +<tr><td align="left" valign="top">• <a href="#Justification">Justification</a></td><td> </td><td align="left" valign="top">Ragged left, ragged right, centered. </td></tr> -<tr><td align="left" valign="top">• <a href="#Tables">Tables</a>:</td><td> </td><td align="left" valign="top">Producing ordered tables. +<tr><td align="left" valign="top">• <a href="#Tables">Tables</a></td><td> </td><td align="left" valign="top">Producing ordered tables. </td></tr> -<tr><td align="left" valign="top">• <a href="#Margins">Margins</a>:</td><td> </td><td align="left" valign="top">Changing the margins directly. +<tr><td align="left" valign="top">• <a href="#Margins">Margins</a></td><td> </td><td align="left" valign="top">Changing the margins directly. </td></tr> -<tr><td align="left" valign="top">• <a href="#Multiple-columns">Multiple columns</a>:</td><td> </td><td align="left" valign="top">Getting output in two columns. +<tr><td align="left" valign="top">• <a href="#Multiple-columns">Multiple columns</a></td><td> </td><td align="left" valign="top">Getting output in two columns. </td></tr> -<tr><td align="left" valign="top">• <a href="#Footnotes">Footnotes</a>:</td><td> </td><td align="left" valign="top">Autonumbered footnotes; changing formatting. +<tr><td align="left" valign="top">• <a href="#Footnotes">Footnotes</a></td><td> </td><td align="left" valign="top">Autonumbered footnotes; changing formatting. </td></tr> -<tr><td align="left" valign="top">• <a href="#Fractions">Fractions</a>:</td><td> </td><td align="left" valign="top">A better way to produce fractions in text. +<tr><td align="left" valign="top">• <a href="#Fractions">Fractions</a></td><td> </td><td align="left" valign="top">A better way to produce fractions in text. </td></tr> -<tr><td align="left" valign="top">• <a href="#Paths">Paths</a>:</td><td> </td><td align="left" valign="top">Allowing line breaks in pathnames. +<tr><td align="left" valign="top">• <a href="#Paths">Paths</a></td><td> </td><td align="left" valign="top">Allowing line breaks in pathnames. </td></tr> -<tr><td align="left" valign="top">• <a href="#Logos">Logos</a>:</td><td> </td><td align="left" valign="top">Various logos. +<tr><td align="left" valign="top">• <a href="#Logos">Logos</a></td><td> </td><td align="left" valign="top">Various logos. </td></tr> -<tr><td align="left" valign="top">• <a href="#Boxes">Boxes</a>:</td><td> </td><td align="left" valign="top">Producing filled or open rectangles. +<tr><td align="left" valign="top">• <a href="#Boxes">Boxes</a></td><td> </td><td align="left" valign="top">Producing filled or open rectangles. </td></tr> -<tr><td align="left" valign="top">• <a href="#Checking-for-PDF-output">Checking for PDF output</a>:</td><td> </td><td align="left" valign="top">Checking for pdfTeX in PDF mode. +<tr><td align="left" valign="top">• <a href="#Checking-for-PDF-output">Checking for PDF output</a></td><td> </td><td align="left" valign="top">Checking for pdfTeX in PDF mode. </td></tr> -<tr><td align="left" valign="top">• <a href="#Loading-LaTeX-packages">Loading LaTeX packages</a>:</td><td> </td><td align="left" valign="top">Support for LaTeX packages under plain TeX. +<tr><td align="left" valign="top">• <a href="#Loading-LaTeX-packages">Loading LaTeX packages</a></td><td> </td><td align="left" valign="top">Support for LaTeX packages under plain TeX. </td></tr> </table> <hr> -<a name="Diagnostics"></a> -<div class="header"> +<span id="Diagnostics"></span><div class="header"> <p> Next: <a href="#Rules" accesskey="n" rel="next">Rules</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Diagnostics-1"></a> -<h3 class="section">4.1 Diagnostics</h3> +<span id="Diagnostics-1"></span><h3 class="section">4.1 Diagnostics</h3> -<a name="index-diagnostics"></a> -<a name="index-tracing"></a> +<span id="index-diagnostics"></span> +<span id="index-tracing"></span> <p>Plain TeX provides the <code>\tracingall</code> command, to turn on the maximum amount of tracing possible in TeX. The (usually voluminous) output from <code>\tracingall</code> goes both on the terminal and into the transcript file. -<a name="index-tracingall"></a> +<span id="index-tracingall"></span> It is sometimes easier to have the output go only to the transcript file, so you can peruse it at your leisure and not obscure other output to the terminal. So, Eplain provides the command <code>\loggingall</code>. -<a name="index-loggingall"></a> +<span id="index-loggingall"></span> (For some reason, this command is available in Metafont, but not in TeX.) </p> <p>It is also sometimes useful to see the complete contents of boxes. <code>\tracingboxes</code> does this. (It doesn’t affect whether or not the contents -<a name="index-tracingboxes"></a> +<span id="index-tracingboxes"></span> are shown on the terminal.) </p> <p>You can turn off all tracing with <code>\tracingoff</code>. -<a name="index-tracingoff"></a> +<span id="index-tracingoff"></span> </p> <p>You can also turn logging on and off globally, so you don’t have to worry about whether or not you’re inside a group at the time of command. These variants are named <code>\gloggingall</code> -<a name="index-gloggingall"></a> +<span id="index-gloggingall"></span> and <code>\gtracingall</code>. -<a name="index-gtracingall"></a> +<span id="index-gtracingall"></span> </p> <p>Finally, if you write your own help messages (see <code>\newhelp</code> -<a name="index-help-messages"></a> -<a name="index-error-messages"></a> +<span id="index-help-messages"></span> +<span id="index-error-messages"></span> in <cite>The TeXbook</cite>), you want a convenient way to break lines in them. This is what TeX’s <code>\newlinechar</code> parameter is for; -<a name="index-newlinechar"></a> +<span id="index-newlinechar"></span> however, plain TeX doesn’t set <code>\newlinechar</code>. Therefore, Eplain defines it to be the character <code>^^J</code>. </p> @@ -1068,24 +1047,22 @@ Eplain defines it to be the character <code>^^J</code>. <hr> -<a name="Rules"></a> -<div class="header"> +<span id="Rules"></span><div class="header"> <p> Next: <a href="#Citations" accesskey="n" rel="next">Citations</a>, Previous: <a href="#Diagnostics" accesskey="p" rel="prev">Diagnostics</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Rules-1"></a> -<h3 class="section">4.2 Rules</h3> +<span id="Rules-1"></span><h3 class="section">4.2 Rules</h3> <p>The default dimensions of rules are defined in chapter 21 of the <cite>The TeXbook</cite>. To sum up what is given there, the “thickness” of rules is -<a name="index-rule-thickness"></a> +<span id="index-rule-thickness"></span> 0.4pt by default. Eplain defines three parameters that let you change this dimension: <code>\hruledefaultheight</code>, <code>\hruledefaultdepth</code>, -<a name="index-hruledefaultheight"></a> -<a name="index-hruledefaultdepth"></a> +<span id="index-hruledefaultheight"></span> +<span id="index-hruledefaultdepth"></span> and <code>\vruledefaultwidth</code>. By default, they are defined as -<a name="index-vruledefaultwidth"></a> +<span id="index-vruledefaultwidth"></span> <cite>The TeXbook</cite> describes. </p> <p>But it would be wrong to redefine <code>\hrule</code> and <code>\vrule</code>. For @@ -1094,30 +1071,28 @@ being used; for another, rules are used quite heavily, and the performance impact of making it a macro can be noticeable. Therefore, to take advantage of the default rule parameters, you must use <code>\ehrule</code> -<a name="index-ehrule"></a> +<span id="index-ehrule"></span> and <code>\evrule</code>. -<a name="index-evrule"></a> +<span id="index-evrule"></span> </p> <hr> -<a name="Citations"></a> -<div class="header"> +<span id="Citations"></span><div class="header"> <p> Next: <a href="#Displays" accesskey="n" rel="next">Displays</a>, Previous: <a href="#Rules" accesskey="p" rel="prev">Rules</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Citations-1"></a> -<h3 class="section">4.3 Citations</h3> +<span id="Citations-1"></span><h3 class="section">4.3 Citations</h3> -<a name="index-citations"></a> -<a name="index-bibliographies"></a> +<span id="index-citations"></span> +<span id="index-bibliographies"></span> <p>Bibliographies are part of almost every technical document. To handle them conveniently, you need two things: a program to do the tedious formatting, and a way to cite references by labels, rather than by numbers. The BibTeX program, written by Oren Patashnik, takes care -<a name="index-BibTeX"></a> -<a name="index-Patashnik_002c-Oren"></a> +<span id="index-BibTeX"></span> +<span id="index-Patashnik_002c-Oren"></span> of the first item; the citation commands in LaTeX, written to be used -<a name="index-LaTeX-1"></a> +<span id="index-LaTeX-1"></span> with BibTeX, take care of the second. Therefore, Eplain adopts the use of BibTeX, and virtually the same interface as LaTeX. @@ -1126,14 +1101,14 @@ LaTeX. document, and commands saying where the bibliography data is. When you run TeX, these commands produce output on the file with the same root name as your document (by default) and the extension <samp>.aux</samp>. -<a name="index-_002eaux-file"></a> -<a name="index-jobname"></a> +<span id="index-_002eaux-file"></span> +<span id="index-jobname"></span> BibTeX reads this file. You should put the bibliography data in a file or files with the extension <samp>.bib</samp>. BibTeX writes out a file with the same root -<a name="index-_002ebib-file"></a> +<span id="index-_002ebib-file"></span> name as your document and extension <samp>.bbl</samp>. Eplain reads this file -<a name="index-_002ebbl-file"></a> +<span id="index-_002ebbl-file"></span> the next time you run your document through TeX. (It takes multiple passes to get everything straight, because usually after seeing your bibliography typeset, you want to make changes in the <samp>.bib</samp> @@ -1145,7 +1120,7 @@ given below. is a collection of papers—you can tell Eplain to use a different root name for the <samp>.bbl</samp> file by defining the control sequence <code>\bblfilebasename</code>. -<a name="index-bblfilebasename"></a> +<span id="index-bblfilebasename"></span> The default definition is simply <code>\jobname</code>. </p> <p>On the other hand, if your document’s bibliography is very simple, you @@ -1159,7 +1134,7 @@ for information on how to write your <tt>.bib</tt> files. Both the BibTeX and the Eplain distributions contain several examples, also. </p> <p>The <code>\cite</code> -<a name="index-cite"></a> +<span id="index-cite"></span> command produces a citation in the text of your document. The exact printed form the citation will take is under your control (see <a href="#Formatting-citations">Formatting citations</a>). <code>\cite</code> takes one @@ -1167,7 +1142,7 @@ required argument, a comma-separated list of cross-reference labels (see <a href="#Cross_002dreferences">Cross-references</a>, for exactly what characters are allowed in such labels). Warning: spaces in this list are taken as part of the following label name, which is probably not what you expect. -<a name="index-citations_002c-undefined"></a> +<span id="index-citations_002c-undefined"></span> The <code>\cite</code> command also produces a command in the <tt>.aux</tt> file that tells BibTeX to retrieve the given reference(s) from the <tt>.bib</tt> file. <code>\cite</code> also takes one optional argument, @@ -1178,12 +1153,12 @@ simply typeset after the citations. (See the example below.) bibliography entries (see <a href="#Citation-hyperlinks">Citation hyperlinks</a>). </p> <p>Another command, <code>\nocite</code>, -<a name="index-nocite"></a> +<span id="index-nocite"></span> puts the given reference(s) into the bibliography, but produces nothing in the text. </p> <p>The <code>\bibliography</code> -<a name="index-bibliography"></a> +<span id="index-bibliography"></span> command is next. It serves two purposes: producing the typeset bibliography, and telling BibTeX the root names of the <tt>.bib</tt> files. Therefore, the argument to <code>\bibliography</code> is a comma @@ -1193,10 +1168,10 @@ spaces in this list are significant. <p>You tell BibTeX the particular style in which you want your bibliography typeset with one more command: <code>\bibliographystyle</code>. -<a name="index-bibliographystyle"></a> +<span id="index-bibliographystyle"></span> The argument to this is a single filename <var>style</var>, which tells BibTeX to look for a file <var>style</var><tt>.bst</tt>. -<a name="index-_002ebst-files"></a> +<span id="index-_002ebst-files"></span> See the document <cite>Designing BibTeX styles</cite> (whose text is in the <samp>btxhak.tex</samp>) for information on how to write your own styles. </p> @@ -1205,7 +1180,7 @@ your job starts. </p> <p>If you don’t want to see the messages about undefined citations, you can say <code>\xrefwarningfalse</code> before making any citations. -<a name="index-xrefwarningfalse"></a> +<span id="index-xrefwarningfalse"></span> Eplain automatically does this if the <tt>.aux</tt> file does not exist. You can restore the default by saying <code>\xrefwarningtrue</code>. </p> @@ -1220,10 +1195,10 @@ Two citations to Knuthian works: \bibliographystyle{plain} % Number the references. \end % End of the document. </pre></div> -<a name="index-Knuth_002c-Donald-Ervin"></a> -<a name="index-Graham_002c-Ronald-L_002e"></a> -<a name="index-numbered-references"></a> -<a name="index-references_002c-numbered"></a> +<span id="index-Knuth_002c-Donald-Ervin"></span> +<span id="index-Graham_002c-Ronald-L_002e"></span> +<span id="index-numbered-references"></span> +<span id="index-references_002c-numbered"></span> <p>If we suppose that this file was named <samp>citex.tex</samp> and that the bibliography data is in <samp>knuth.bib</samp> (as the above @@ -1237,7 +1212,7 @@ $ tex citex <i>(read citex.bbl, still have undefined citations)</i> $ tex citex <i>(one more time, to resolve the references)</i> </pre></div> -<a name="index-texi2dvi-1"></a> +<span id="index-texi2dvi-1"></span> <p>The <code>texi2dvi</code> program can help you automate this process (see <a href="#Invoking-Eplain">Invoking Eplain</a>). </p> @@ -1269,56 +1244,54 @@ Massachusetts, 1974. bibliography databases, and the bibliography styles that are available. (If you want your references printed with names, as in [Knu74], instead of numbered, the bibliography style is <code>alpha</code>.) -<a name="index-alphanumeric-references"></a> -<a name="index-references_002c-alphanumeric"></a> +<span id="index-alphanumeric-references"></span> +<span id="index-references_002c-alphanumeric"></span> </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Formatting-citations" accesskey="1">Formatting citations</a>:</td><td> </td><td align="left" valign="top">Changing the way citations are printed. +<tr><td align="left" valign="top">• <a href="#Formatting-citations" accesskey="1">Formatting citations</a></td><td> </td><td align="left" valign="top">Changing the way citations are printed. </td></tr> -<tr><td align="left" valign="top">• <a href="#Formatting-bibliographies" accesskey="2">Formatting bibliographies</a>:</td><td> </td><td align="left" valign="top">Changing the way bibliographies are printed. +<tr><td align="left" valign="top">• <a href="#Formatting-bibliographies" accesskey="2">Formatting bibliographies</a></td><td> </td><td align="left" valign="top">Changing the way bibliographies are printed. </td></tr> -<tr><td align="left" valign="top">• <a href="#Commands-from-LaTeX" accesskey="3">Commands from LaTeX</a>:</td><td> </td><td align="left" valign="top">LaTeX commands defined by <samp>btxmac</samp>. +<tr><td align="left" valign="top">• <a href="#Commands-from-LaTeX" accesskey="3">Commands from LaTeX</a></td><td> </td><td align="left" valign="top">LaTeX commands defined by <samp>btxmac</samp>. </td></tr> </table> <hr> -<a name="Formatting-citations"></a> -<div class="header"> +<span id="Formatting-citations"></span><div class="header"> <p> Next: <a href="#Formatting-bibliographies" accesskey="n" rel="next">Formatting bibliographies</a>, Up: <a href="#Citations" accesskey="u" rel="up">Citations</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Formatting-citations-1"></a> -<h4 class="subsection">4.3.1 Formatting citations</h4> +<span id="Formatting-citations-1"></span><h4 class="subsection">4.3.1 Formatting citations</h4> -<a name="index-citations_002c-formatting"></a> +<span id="index-citations_002c-formatting"></span> <p>You may wish to change Eplain’s formatting of citations; i.e., the result of your <code>\cite</code> commands. By default, the citation labels are printed one after another, separated by commas and enclosed in brackets, using the main text font. Some formats require other styles, -such as superscripted labels. You can accomodate such formats by +such as superscripted labels. You can accommodate such formats by redefining the following macros. </p> <dl compact="compact"> <dt><code>\printcitestart</code></dt> <dt><code>\printcitefinish</code></dt> -<dd><a name="index-printcitestart"></a> -<a name="index-printcitefinish"></a> -<p>Eplain expands these macros at the begining and end of the list of +<dd><span id="index-printcitestart"></span> +<span id="index-printcitefinish"></span> +<p>Eplain expands these macros at the beginning and end of the list of citations for each <code>\cite</code> command. By default, they produce a ‘<samp>[</samp>’ and ‘<samp>]</samp>’, respectively. </p> </dd> <dt><code>\printbetweencitations</code></dt> -<dd><a name="index-printbetweencitations"></a> +<dd><span id="index-printbetweencitations"></span> <p>If a <code>\cite</code> command has multiple citations, as in <code>\cite{acp,texbook}</code>, Eplain expands this macro in between each pair of citations. By default, it produces a comma followed by a space. </p> </dd> <dt><code>\printcitenote</code></dt> -<dd><a name="index-printcitenote"></a> +<dd><span id="index-printcitenote"></span> <p>This macro takes one argument, which is the optional note to the <code>\cite</code> command. If the <code>\cite</code> command had no note, this macro isn’t used. Otherwise, it should print the note. By default, the @@ -1339,15 +1312,13 @@ superscripted labels, with the optional notes in parentheses. <hr> -<a name="Formatting-bibliographies"></a> -<div class="header"> +<span id="Formatting-bibliographies"></span><div class="header"> <p> Next: <a href="#Commands-from-LaTeX" accesskey="n" rel="next">Commands from LaTeX</a>, Previous: <a href="#Formatting-citations" accesskey="p" rel="prev">Formatting citations</a>, Up: <a href="#Citations" accesskey="u" rel="up">Citations</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Formatting-bibliographies-1"></a> -<h4 class="subsection">4.3.2 Formatting bibliographies</h4> +<span id="Formatting-bibliographies-1"></span><h4 class="subsection">4.3.2 Formatting bibliographies</h4> -<a name="index-bibliography_002c-formatting-the"></a> +<span id="index-bibliography_002c-formatting-the"></span> <p>You may wish to change Eplain’s formatting of the bibliography, especially with respect to the fonts that are used. Therefore, Eplain @@ -1355,7 +1326,7 @@ provides the following control sequences: </p> <dl compact="compact"> <dt><code>\biblabelwidth</code></dt> -<dd><a name="index-biblabelwidth"></a> +<dd><span id="index-biblabelwidth"></span> <p>This control sequence represents a <code>\dimen</code> register, and its value is the width of the widest label in the bibliography. Although it is unlikely you will ever want to redefine it, you might want @@ -1363,7 +1334,7 @@ to use it if you redefine <code>\biblabelprint</code>, below. </p> </dd> <dt><code>\biblabelprint</code></dt> -<dd><a name="index-biblabelprint"></a> +<dd><span id="index-biblabelprint"></span> <p>This macro takes one argument, the label to print. By default, the label is put in a box of width <code>\biblabelwidth</code>, and is followed by an enspace. When you want to change the spacing around the labels, this @@ -1371,7 +1342,7 @@ is the right macro to redefine. </p> </dd> <dt><code>\biblabelcontents</code></dt> -<dd><a name="index-biblabelcontents"></a> +<dd><span id="index-biblabelcontents"></span> <p>This macro also takes one argument, the label to print. By default, the label is printed using the font <code>\bblrm</code> (below), and enclosed in brackets. When you want to change the appearance of the label, but not @@ -1380,8 +1351,8 @@ the spacing around it, this is the right macro to redefine. </dd> <dt><code>\biblabelprecontents</code></dt> <dt><code>\biblabelpostcontents</code></dt> -<dd><a name="index-biblabelprecontents"></a> -<a name="index-biblabelpostcontents"></a> +<dd><span id="index-biblabelprecontents"></span> +<span id="index-biblabelpostcontents"></span> <p>Macros expanded before and after <code>\biblabelcontents</code>, respectively. For example, to get left-justified numeric labels (they are right-justified by default): @@ -1393,30 +1364,30 @@ are right-justified by default): </dd> <dt><code>\bblrm</code></dt> -<dd><a name="index-bblrm"></a> -<a name="index-bibliography-fonts"></a> +<dd><span id="index-bblrm"></span> +<span id="index-bibliography-fonts"></span> <p>The default font used for printing the bibliography. </p> </dd> <dt><code>\bblem</code></dt> -<dd><a name="index-bblem"></a> +<dd><span id="index-bblem"></span> <p>The font used for printing the titles and other “emphasized” material. </p> </dd> <dt><code>\bblemph</code></dt> -<dd><a name="index-bblemph"></a> -<a name="index-italic-correction"></a> +<dd><span id="index-bblemph"></span> +<span id="index-italic-correction"></span> <p>Typesets its argument using <code>\bblem</code>, then inserts an italic correction. </p> </dd> <dt><code>\bblsc</code></dt> -<dd><a name="index-bblsc"></a> +<dd><span id="index-bblsc"></span> <p>In some styles, authors’ names are printed in a caps-and-small-caps font. In those cases, this font is used. </p> </dd> <dt><code>\bblnewblock</code></dt> -<dd><a name="index-bblnewblock"></a> +<dd><span id="index-bblnewblock"></span> <p>This is invoked between each of the parts of a bibliography entry. The default is to leave some extra space between the parts; you could redefine it to start each part on a new line (for example). A part is @@ -1426,7 +1397,7 @@ concerned) term ‘block’ for this.) </p> </dd> <dt><code>\biblabelextraspace</code></dt> -<dd><a name="index-biblabelextraspace"></a> +<dd><span id="index-biblabelextraspace"></span> <p>Bibliography entries are typeset with a hanging indentation of <code>\biblabelwidth</code> plus this. The default is <code>.5em</code>, where the em width is taken from the <code>\bblrm</code> font. If you want to change @@ -1434,8 +1405,8 @@ this, you should do it inside <code>\bblhook</code>. </p> </dd> <dt><code>\bblhook</code></dt> -<dd><a name="index-bblhook"></a> -<a name="index-bibliography-items_002c-extra-space-between"></a> +<dd><span id="index-bblhook"></span> +<span id="index-bibliography-items_002c-extra-space-between"></span> <p>This is expanded before reading the <tt>.bbl</tt> file. By default, it does nothing. You could, for example, define it to set the bibliography fonts, or produce the heading for the references. Two @@ -1453,15 +1424,13 @@ file that BibTeX produces to do anything you wish. </p> <hr> -<a name="Commands-from-LaTeX"></a> -<div class="header"> +<span id="Commands-from-LaTeX"></span><div class="header"> <p> Previous: <a href="#Formatting-bibliographies" accesskey="p" rel="prev">Formatting bibliographies</a>, Up: <a href="#Citations" accesskey="u" rel="up">Citations</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Commands-from-LaTeX-1"></a> -<h4 class="subsection">4.3.3 Commands from LaTeX</h4> +<span id="Commands-from-LaTeX-1"></span><h4 class="subsection">4.3.3 Commands from LaTeX</h4> -<a name="index-LaTeX-commands_002c-in-btxmac_002etex"></a> +<span id="index-LaTeX-commands_002c-in-btxmac_002etex"></span> <p>Because of the historical connection between BibTeX and LaTeX, in practice many bibliography styles and bibliographies use LaTeX commmands that are not part of bibliography handling, per se. @@ -1475,10 +1444,10 @@ packages</a>) will not be overwritten. Here is the list: <dt><code>\newcommand</code></dt> <dt><code>\renewcommand</code></dt> <dt><code>\providecommand</code></dt> -<dd><a name="index-newcommand"></a> -<a name="index-renewcommand"></a> -<a name="index-providecommand"></a> -<a name="index-_002a_002dform-of-LaTeX-commands"></a> +<dd><span id="index-newcommand"></span> +<span id="index-renewcommand"></span> +<span id="index-providecommand"></span> +<span id="index-_002a_002dform-of-LaTeX-commands"></span> <p>Defining new commands in various ways. The Eplain versions do not support the *-form of these; use <samp>miniltx</samp> for that. </p> @@ -1487,20 +1456,20 @@ support the *-form of these; use <samp>miniltx</samp> for that. <dt><code>\emph</code></dt> <dt><code>\sc</code></dt> <dt><code>\textbf</code></dt> -<dd><a name="index-em"></a> -<a name="index-emph"></a> -<a name="index-sc"></a> -<a name="index-textbf"></a> +<dd><span id="index-em"></span> +<span id="index-emph"></span> +<span id="index-sc"></span> +<span id="index-textbf"></span> <p>Selecting fonts. </p> </dd> <dt><code>\mbox</code></dt> -<dd><a name="index-mbox"></a> +<dd><span id="index-mbox"></span> <p>A horizontal box. </p> </dd> <dt><code>\newblock</code></dt> -<dd><a name="index-newblock"></a> +<dd><span id="index-newblock"></span> <p>Starts elements of a bibliography entry. </p></dd> </dl> @@ -1509,54 +1478,52 @@ support the *-form of these; use <samp>miniltx</samp> for that. </p> <hr> -<a name="Displays"></a> -<div class="header"> +<span id="Displays"></span><div class="header"> <p> Next: <a href="#Time-of-day" accesskey="n" rel="next">Time of day</a>, Previous: <a href="#Citations" accesskey="p" rel="prev">Citations</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Displays-1"></a> -<h3 class="section">4.4 Displays</h3> +<span id="Displays-1"></span><h3 class="section">4.4 Displays</h3> -<a name="index-displays_002c-left_002djustifying"></a> -<a name="index-mathematics-displays_002c-formatting"></a> -<a name="index-left_002djustification-of-displays"></a> -<a name="index-equation-numbers_002c-left_002dalignment"></a> -<a name="index-left_002dalignment-of-equation-numbers"></a> +<span id="index-displays_002c-left_002djustifying"></span> +<span id="index-mathematics-displays_002c-formatting"></span> +<span id="index-left_002djustification-of-displays"></span> +<span id="index-equation-numbers_002c-left_002dalignment"></span> +<span id="index-left_002dalignment-of-equation-numbers"></span> <p>By default, TeX centers displayed material. (Displayed material is just whatever you put between <code>$$</code>’s—it’s not necessarily mathematics.) Many layouts would be better served if the displayed material was left-justified. Therefore, Eplain provides the command <code>\leftdisplays</code>, -<a name="index-leftdisplays"></a> +<span id="index-leftdisplays"></span> which indents displayed material by <code>\parindent</code> plus <code>\leftskip</code>, plus <code>\leftdisplayindent</code>. -<a name="index-leftdisplayindent"></a> +<span id="index-leftdisplayindent"></span> </p> <p>You can go back to centering displays with <code>\centereddisplays</code>. -<a name="index-centereddisplays"></a> +<span id="index-centereddisplays"></span> (It is usually poor typography to have both centered and left-justified displays in a single publication, though.) </p> <p><code>\leftdisplays</code> also changes the plain TeX commands that deal with alignments inside math displays, <code>\displaylines</code>, -<a name="index-displaylines"></a> +<span id="index-displaylines"></span> <code>\eqalignno</code>, -<a name="index-eqalignno"></a> +<span id="index-eqalignno"></span> and <code>\leqalignno</code>, -<a name="index-leqalignno"></a> +<span id="index-leqalignno"></span> to produce left-justified text. You can still override this formatting by inserting <code>\hfill</code> glue, as explained in <cite>The TeXbook</cite>. </p> -<a name="index-lefteqnumbers"></a> -<a name="index-righteqnumbers"></a> -<a name="index-eqnum"></a> -<a name="index-eqalignnum"></a> -<a name="index-eqno"></a> -<a name="index-leqno"></a> -<a name="index-eqalignno-1"></a> -<a name="index-leqalignno-1"></a> +<span id="index-lefteqnumbers"></span> +<span id="index-righteqnumbers"></span> +<span id="index-eqnum"></span> +<span id="index-eqalignnum"></span> +<span id="index-eqno"></span> +<span id="index-leqno"></span> +<span id="index-eqalignno-1"></span> +<span id="index-leqalignno-1"></span> <p>Eplain defines <code>\eqnum</code> and <code>\eqalignnum</code> which can be set up to produce either left-aligned or right-aligned equation numbers. <code>\lefteqnumbers</code> (<code>\righteqnumbers</code>) will define @@ -1566,24 +1533,22 @@ up to produce either left-aligned or right-aligned equation numbers. (right-aligned equation numbers). </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Formatting-displays" accesskey="1">Formatting displays</a>:</td><td> </td><td align="left" valign="top">General formatting of displays. +<tr><td align="left" valign="top">• <a href="#Formatting-displays" accesskey="1">Formatting displays</a></td><td> </td><td align="left" valign="top">General formatting of displays. </td></tr> </table> <hr> -<a name="Formatting-displays"></a> -<div class="header"> +<span id="Formatting-displays"></span><div class="header"> <p> Up: <a href="#Displays" accesskey="u" rel="up">Displays</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Formatting-displays-1"></a> -<h4 class="subsection">4.4.1 Formatting displays</h4> +<span id="Formatting-displays-1"></span><h4 class="subsection">4.4.1 Formatting displays</h4> <p>If you want some other kind of formatting, you can write a definition of your own, analogous to <code>\leftdisplays</code>. You need only make sure that <code>\leftdisplaysetup</code> -<a name="index-leftdisplaysetup"></a> +<span id="index-leftdisplaysetup"></span> is called at the beginning of every display (presumably by invoking it in TeX’s <code>\everydisplay</code> parameter). </p> @@ -1591,60 +1556,56 @@ in TeX’s <code>\everydisplay</code> parameter). before calling <code>\leftdisplaysetup</code>, so that any changes you have made to it won’t be lost. That old token list as available as the value of the token register <code>\previouseverydisplay</code>. -<a name="index-previouseverydisplay"></a> +<span id="index-previouseverydisplay"></span> </p> <hr> -<a name="Time-of-day"></a> -<div class="header"> +<span id="Time-of-day"></span><div class="header"> <p> Next: <a href="#Lists" accesskey="n" rel="next">Lists</a>, Previous: <a href="#Displays" accesskey="p" rel="prev">Displays</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Time-of-day-1"></a> -<h3 class="section">4.5 Time of day</h3> +<span id="Time-of-day-1"></span><h3 class="section">4.5 Time of day</h3> -<a name="index-time-of-day"></a> -<a name="index-date"></a> +<span id="index-time-of-day"></span> +<span id="index-date"></span> <p>TeX provides the day, month, and year as numeric quantities (unless your TeX implementation is woefully deficient). Eplain provides some control sequences to make them a little more friendly to humans. </p> <p><code>\monthname</code> -<a name="index-monthname"></a> +<span id="index-monthname"></span> produces the name of the current month, abbreviated to three letters. </p> <p><code>\fullmonthname</code> -<a name="index-fullmonthname"></a> +<span id="index-fullmonthname"></span> produces the name of the current month, unabbreviated (in English). </p> <p><code>\timestring</code> -<a name="index-timestring"></a> +<span id="index-timestring"></span> produces the current time, as in ‘1:14 p.m.’ </p> <p><code>\timestamp</code> -<a name="index-timestamp"></a> +<span id="index-timestamp"></span> produces the current date and time, as in ‘23 Apr 64 1:14 p.m.’. (Except the spacing is slightly different.) </p> <p><code>\today</code> -<a name="index-today"></a> +<span id="index-today"></span> produces the current date, as in ‘23 April 1964’. </p> <hr> -<a name="Lists"></a> -<div class="header"> +<span id="Lists"></span><div class="header"> <p> Next: <a href="#Verbatim-listing" accesskey="n" rel="next">Verbatim listing</a>, Previous: <a href="#Time-of-day" accesskey="p" rel="prev">Time of day</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Lists-1"></a> -<h3 class="section">4.6 Lists</h3> +<span id="Lists-1"></span><h3 class="section">4.6 Lists</h3> -<a name="index-lists"></a> -<a name="index-numbered-lists"></a> -<a name="index-ordered-list"></a> -<a name="index-unordered-lists"></a> +<span id="index-lists"></span> +<span id="index-numbered-lists"></span> +<span id="index-ordered-list"></span> +<span id="index-unordered-lists"></span> <p>Many documents require lists of items, either numbered or simply enumerated. Plain TeX defines one macro to help with creating lists, @@ -1654,10 +1615,10 @@ Eplain provides two pairs of commands: <dl compact="compact"> <dt><code>\numberedlist … \endnumberedlist</code></dt> <dt><code>\orderedlist … \endorderedlist</code></dt> -<dd><a name="index-numberedlist"></a> -<a name="index-endnumberedlist"></a> -<a name="index-orderedlist"></a> -<a name="index-endorderedlist"></a> +<dd><span id="index-numberedlist"></span> +<span id="index-endnumberedlist"></span> +<span id="index-orderedlist"></span> +<span id="index-endorderedlist"></span> <p>These commands (they are synonyms) produce a list with the items numbered sequentially, starting from one. A nested <code>\numberedlist</code> labels the items with lowercase letters, starting with ‘a’. Another @@ -1666,8 +1627,8 @@ more deeply nested numbered lists label items with ‘<samp>*</samp>’. </p> </dd> <dt><code>\unorderedlist … \endunorderedlist</code></dt> -<dd><a name="index-unorderedlist"></a> -<a name="index-endunorderedlist"></a> +<dd><span id="index-unorderedlist"></span> +<span id="index-endunorderedlist"></span> <p>This produces a list with the items labelled with small black boxes (“square bullets”). A nested <code>\unorderedlist</code> labels items with em-dashes. Doubly (and deeper) nested unordered lists label items with @@ -1679,7 +1640,7 @@ em-dashes. Doubly (and deeper) nested unordered lists label items with <p>The two kinds of lists can be nested within each other, as well. </p> <p>In both kinds of lists, you begin an item with <code>\li</code>. -<a name="index-li"></a> +<span id="index-li"></span> An item may continue for several paragraphs. Each item starts a paragraph. </p> @@ -1692,7 +1653,7 @@ with <code>\xrefn</code>. See <a href="#Cross_002dreferences">Cross-references< <code>\xrefn</code> pointing to the relevant list item (see <a href="#List-hyperlinks">List hyperlinks</a>). </p> <p>You can also say <code>\listcompact</code> -<a name="index-listcompact"></a> +<span id="index-listcompact"></span> right after <code>\numberedlist</code> or <code>\unorderedlist</code>. The items in the list will then not have any extra space between them (see <a href="#Formatting-lists">Formatting lists</a>). You might want to do this if the items in @@ -1710,41 +1671,39 @@ The second paragraph of the second item. </pre></div> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Formatting-lists" accesskey="1">Formatting lists</a>:</td><td> </td><td align="left" valign="top">Changing how the lists look. +<tr><td align="left" valign="top">• <a href="#Formatting-lists" accesskey="1">Formatting lists</a></td><td> </td><td align="left" valign="top">Changing how the lists look. </td></tr> </table> <hr> -<a name="Formatting-lists"></a> -<div class="header"> +<span id="Formatting-lists"></span><div class="header"> <p> Up: <a href="#Lists" accesskey="u" rel="up">Lists</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Formatting-lists-1"></a> -<h4 class="subsection">4.6.1 Formatting lists</h4> +<span id="Formatting-lists-1"></span><h4 class="subsection">4.6.1 Formatting lists</h4> -<a name="index-lists_002c-formatting"></a> +<span id="index-lists_002c-formatting"></span> <p>Several registers define the spacing associated with lists. It is likely that their default values won’t suit your particular layout. </p> <dl compact="compact"> <dt><code>\abovelistskipamount, \belowlistskipamount</code></dt> -<dd><a name="index-abovelistskipamount"></a> -<a name="index-belowlistskipamount"></a> +<dd><span id="index-abovelistskipamount"></span> +<span id="index-belowlistskipamount"></span> <p>The vertical glue inserted before and after every list, respectively. </p> </dd> <dt><code>\interitemskipamount</code></dt> -<dd><a name="index-interitemskipamount"></a> +<dd><span id="index-interitemskipamount"></span> <p>The vertical glue inserted before each item except the first. <code>\listcompact</code> resets this to zero, as mentioned above. </p> </dd> <dt><code>\listleftindent, \listrightindent</code></dt> -<dd><a name="index-listleftindent"></a> -<a name="index-listrightindent"></a> +<dd><span id="index-listleftindent"></span> +<span id="index-listrightindent"></span> <p><code>\listrightindent</code> is the amount of space by which the list is indented on the right; i.e., it is added to <code>\rightskip</code>. <code>\listleftindent</code> is the amount of space, <em>relative to</em> @@ -1759,38 +1718,38 @@ to zero. <p>The three vertical glues are inserted by macros, and preceded by penalties: <code>\abovelistskip</code> -<a name="index-abovelistskip"></a> +<span id="index-abovelistskip"></span> does <code>\vpenalty\abovelistpenalty</code> -<a name="index-abovelistpenalty"></a> +<span id="index-abovelistpenalty"></span> and then <code>\vskip\abovelistskip</code>. <code>\belowlistskip</code> -<a name="index-belowlistskip"></a> +<span id="index-belowlistskip"></span> and <code>\interitemskip</code> -<a name="index-interitemskip"></a> +<span id="index-interitemskip"></span> are analogous. </p> <p>In addition, the macro <code>\listmarkerspace</code> -<a name="index-listmarkerspace"></a> +<span id="index-listmarkerspace"></span> is called to separate the item label from the item text. This is set to <code>\enspace</code> by default. </p> <p>If you want to change the labels on the items, you can redefine these macros: <code>\numberedmarker</code> -<a name="index-numberedmarker"></a> +<span id="index-numberedmarker"></span> or <code>\unorderedmarker</code>. -<a name="index-unorderedmarker"></a> +<span id="index-unorderedmarker"></span> The following registers might be useful if you do: </p> <dl compact="compact"> <dt><code>\numberedlistdepth, \unorderedlistdepth</code></dt> -<dd><a name="index-numberedlistdepth"></a> -<a name="index-unorderedlistdepth"></a> +<dd><span id="index-numberedlistdepth"></span> +<span id="index-unorderedlistdepth"></span> <p>These keep track of the depth of nesting of the two kinds of lists. </p> </dd> <dt><code>\itemnumber, \itemletter</code></dt> -<dd><a name="index-itemnumber"></a> -<a name="index-itemletter"></a> +<dd><span id="index-itemnumber"></span> +<span id="index-itemletter"></span> <p>These keep track of the number of items that have been seen in the current numbered list. They are both integer registers. The difference is that <code>\itemnumber</code> starts at one, and <code>\itemletter</code> starts at 97, @@ -1801,73 +1760,71 @@ i.e., lowercase ‘a’. <p>You can also redefine the control sequences that are used internally, if you want to do something radically different: <code>\beginlist</code> -<a name="index-beginlist"></a> +<span id="index-beginlist"></span> is invoked to begin both kinds of lists; <code>\printitem</code> -<a name="index-printitem"></a> +<span id="index-printitem"></span> is invoked to print the label (and space following the label) for each item; and <code>\endlist</code> -<a name="index-endlist"></a> +<span id="index-endlist"></span> is invoked to end both kinds of lists. -<a name="index-item-labels_002c-changing"></a> -<a name="index-labels-on-items_002c-changing"></a> +<span id="index-item-labels_002c-changing"></span> +<span id="index-labels-on-items_002c-changing"></span> </p> <hr> -<a name="Verbatim-listing"></a> -<div class="header"> +<span id="Verbatim-listing"></span><div class="header"> <p> Next: <a href="#Contents" accesskey="n" rel="next">Contents</a>, Previous: <a href="#Lists" accesskey="p" rel="prev">Lists</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Verbatim-listing-1"></a> -<h3 class="section">4.7 Verbatim listing</h3> +<span id="Verbatim-listing-1"></span><h3 class="section">4.7 Verbatim listing</h3> -<a name="index-verbatim-listing"></a> -<a name="index-listing-files"></a> -<a name="index-files_002c-verbatim-listing-of"></a> +<span id="index-verbatim-listing"></span> +<span id="index-listing-files"></span> +<span id="index-files_002c-verbatim-listing-of"></span> <p>It is sometimes useful to include a file verbatim in your document; for example, part of a computer program. The <code>\listing</code> -<a name="index-listing"></a> +<span id="index-listing"></span> command is given one argument, a filename, and produces the contents of that file in your document. <code>\listing</code> expands <code>\listingfont</code> to set the current font. The default value of <code>\listingfont</code> -<a name="index-listingfont"></a> +<span id="index-listingfont"></span> is <code>\tt</code>. </p> <p>You can take arbitrary actions before reading the file by defining the macro <code>\setuplistinghook</code>. -<a name="index-setuplistinghook"></a> +<span id="index-setuplistinghook"></span> This is expanded just before the file is input. </p> <p>If you want to have line numbers on the output, you can say <code>\let\setuplistinghook = \linenumberedlisting</code>. -<a name="index-linenumberedlisting"></a> +<span id="index-linenumberedlisting"></span> The line numbers are stored in the count register <code>\lineno</code> while the file is being read. You can redefine the macro <code>\printlistinglineno</code> -<a name="index-printlistinglineno"></a> +<span id="index-printlistinglineno"></span> to change how they are printed. </p> <p>Normally, the <code>\listing</code> command will add a final empty line at the end of the output, even if the file does not end in a newline. To suppress this final line, you can say <code>\let\setuplistinghook = \nolastlinelisting</code>. -<a name="index-nolastlinelisting"></a> +<span id="index-nolastlinelisting"></span> This also works with line numbers (say <code>\def\setuplistinghook{\linenumberedlisting \nolastlinelisting}</code>), but only if <code>\printlistinglineno</code> -<a name="index-printlistinglineno-1"></a> +<span id="index-printlistinglineno-1"></span> consists exclusively of boxes at the top level (i.e., any <code>\kern</code>s or glue should be wrapped up in a box). </p> -<a name="index-form-feed-character_002c-and-verbatim-listing"></a> -<a name="index-CTRL_002dL_002c-and-verbatim-listing"></a> +<span id="index-form-feed-character_002c-and-verbatim-listing"></span> +<span id="index-CTRL_002dL_002c-and-verbatim-listing"></span> <p>You can use the form feed control character (<acronym>ASCII</acronym> code 12, typed as <kbd>CTRL-L</kbd>) in the file to force a page break in the output. </p> <p>You can produce in-line verbatim text in your document with <code>\verbatim</code>. -<a name="index-verbatim"></a> +<span id="index-verbatim"></span> End the text with <code>|endverbatim</code>. If you need a ‘<samp>|</samp>’ in the text, double it. If the first character of the verbatim text is a space, use <code>| </code>. (<code>| </code> will work elsewhere in the argument, too, but @@ -1883,8 +1840,8 @@ isn’t necessary.) </p> <p>Line breaks and spaces in the verbatim text are preserved. </p> -<a name="index-verbatimescapechar"></a> -<a name="index-escape-character_002c-changing-verbatim"></a> +<span id="index-verbatimescapechar"></span> +<span id="index-escape-character_002c-changing-verbatim"></span> <p>You can change the verbatim escape character from the default ‘<samp>|</samp>’ with <code>\verbatimescapechar <var>char</var></code>; for example, this changes it to ‘<samp>@</samp>’. @@ -1898,10 +1855,10 @@ others, depending on the catcode of the character. The argument to <code>\verbatimescapechar</code> is used as <code>\catcode `<var>char</var></code>, so the exact rules follow that for <code>\catcode</code>. </p> -<a name="index-special-characters"></a> -<a name="index-characters_002c-special"></a> -<a name="index-uncatcodespecials"></a> -<a name="index-dospecials"></a> +<span id="index-special-characters"></span> +<span id="index-characters_002c-special"></span> +<span id="index-uncatcodespecials"></span> +<span id="index-dospecials"></span> <p>To reset the category code of all special characters to 12 (“other”), <code>\verbatim</code> uses <code>\uncatcodespecials</code> (see <a href="#Category-codes">Category codes</a>). If you make additional characters @@ -1930,57 +1887,53 @@ help you (see <a href="#Category-codes">Category codes</a>). </p> <hr> -<a name="Contents"></a> -<div class="header"> +<span id="Contents"></span><div class="header"> <p> Next: <a href="#Cross_002dreferences" accesskey="n" rel="next">Cross-references</a>, Previous: <a href="#Verbatim-listing" accesskey="p" rel="prev">Verbatim listing</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Contents-1"></a> -<h3 class="section">4.8 Contents</h3> +<span id="Contents-1"></span><h3 class="section">4.8 Contents</h3> -<a name="index-table-of-contents"></a> -<a name="index-contents"></a> +<span id="index-table-of-contents"></span> +<span id="index-contents"></span> <p>Producing a table of contents that is both useful and aesthetic is one of the most difficult design problems in any work. Naturally, Eplain does not pretend to solve the design problem. Collecting the raw data for a table of contents, however, is much the same across documents. Eplain uses an auxiliary file with extension <samp>.toc</samp> -<a name="index-_002etoc-file"></a> +<span id="index-_002etoc-file"></span> (and the same root name as your document) to save the information. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Writing-the-_002etoc-file" accesskey="1">Writing the .toc file</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Writing-the-_002etoc-file" accesskey="1">Writing the .toc file</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Reading-the-_002etoc-file" accesskey="2">Reading the .toc file</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Reading-the-_002etoc-file" accesskey="2">Reading the .toc file</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="3">Changing the .toc file's root name</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="3">Changing the .toc file's root name</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Alternative-contents-files" accesskey="4">Alternative contents files</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Alternative-contents-files" accesskey="4">Alternative contents files</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Writing-the-_002etoc-file"></a> -<div class="header"> +<span id="Writing-the-_002etoc-file"></span><div class="header"> <p> Next: <a href="#Reading-the-_002etoc-file" accesskey="n" rel="next">Reading the .toc file</a>, Up: <a href="#Contents" accesskey="u" rel="up">Contents</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Writing-the-_002etoc-file-1"></a> -<h4 class="subsection">4.8.1 Writing the <tt>.toc</tt> file</h4> +<span id="Writing-the-_002etoc-file-1"></span><h4 class="subsection">4.8.1 Writing the <tt>.toc</tt> file</h4> <p>To write an entry for the table of contents, you say <code>\writetocentry{<var>part</var>}{<var>text</var>}</code>, -<a name="index-writetocentry"></a> +<span id="index-writetocentry"></span> where <var>part</var> is the type of part this entry is, e.g., ‘<samp>chapter</samp>’, and <var>text</var> is the text of the title. <code>\writetocentry</code> puts an entry into the <tt>.toc</tt> file that looks -<a name="index-toc_2026entry"></a> +<span id="index-toc_2026entry"></span> like <code>\toc<var>part</var>entry{<var>text</var>}{<var>page number</var>}</code> (unless <var>part</var> is an integer, see below). The <var>text</var> is written unexpanded. </p> -<a name="index-writenumberedtocentry"></a> +<span id="index-writenumberedtocentry"></span> <p>A related command, <code>\writenumberedtocentry</code>, takes one additional argument, the first token of which is expanded at the point of the <code>\writenumberedtocentry</code>, but the rest of the argument is not @@ -2008,7 +1961,7 @@ above writes the following to the <tt>.toc</tt> file: \tocsectionentry{A section title}{9} </pre></div> -<a name="index-writenumberedtocline"></a> +<span id="index-writenumberedtocline"></span> <p>A variation on <code>\writenumberedtocentry</code> is <code>\writenumberedtocline</code>, differing only in the order of the parameters it takes and writes for the <code>\toc<var>part</var>entry</code> @@ -2028,17 +1981,17 @@ control sequences. To continue the previous example: <code>\toc<var>part</var>entry</code> macros to typeset the text of the entry without actually reading it as an argument. This is required for entries which need to change character catcodes, e.g., to produce -<a name="index-table-of-contents_002c-and-verbatim-text"></a> -<a name="index-contents_002c-and-verbatim-text"></a> -<a name="index-verbatim-text_002c-in-table-of-contents"></a> -<a name="index-special-characters_002c-in-table-of-contents"></a> +<span id="index-table-of-contents_002c-and-verbatim-text"></span> +<span id="index-contents_002c-and-verbatim-text"></span> +<span id="index-verbatim-text_002c-in-table-of-contents"></span> +<span id="index-special-characters_002c-in-table-of-contents"></span> verbatim text (see <a href="#Verbatim-listing">Verbatim listing</a>). </p> <p>Each of <code>\writetocentry</code>, <code>\writenumberedtocentry</code> and <code>\writenumberedtocline</code> processes a numeric <var>part</var> argument specially. If you pass <var>part</var> expanding to an integer, these macros write into the <tt>.toc</tt> file an entry that starts with -<a name="index-toc_2026entry-1"></a> +<span id="index-toc_2026entry-1"></span> <code>\tocentry{<var>part</var>}</code>. Thus, you can define a single <code>\tocentry</code> macro which formats all entries for a table of contents. To continue the previous examples: @@ -2059,15 +2012,13 @@ contents. To continue the previous examples: <hr> -<a name="Reading-the-_002etoc-file"></a> -<div class="header"> +<span id="Reading-the-_002etoc-file"></span><div class="header"> <p> Next: <a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="n" rel="next">Changing the .toc file's root name</a>, Previous: <a href="#Writing-the-_002etoc-file" accesskey="p" rel="prev">Writing the .toc file</a>, Up: <a href="#Contents" accesskey="u" rel="up">Contents</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Reading-the-_002etoc-file-1"></a> -<h4 class="subsection">4.8.2 Reading the <tt>.toc</tt> file</h4> +<span id="Reading-the-_002etoc-file-1"></span><h4 class="subsection">4.8.2 Reading the <tt>.toc</tt> file</h4> -<a name="index-readtocfile"></a> +<span id="index-readtocfile"></span> <p>You read the <tt>.toc</tt> file with the command <code>\readtocfile</code>. Naturally, whatever <code>\toc… entry</code> commands that were written to the file must be defined when <code>\readtocfile</code> is invoked. Eplain @@ -2084,7 +2035,7 @@ called <em>before</em> the first call to a <code>\writetoc…</code> macro. <code>\readtocfile</code> does not itself delete the information from the <tt>.toc</tt> file, so that you can call it several times, e.g., to create both a short -<a name="index-table-of-contents_002c-short"></a> +<span id="index-table-of-contents_002c-short"></span> and normal table of contents. (To produce this in particular, define <code>\tocsectionentry</code> to produce nothing while you are reading <tt>.toc</tt> file for a short table of contents (see <a href="#Macro-arguments">Macro arguments</a>).) @@ -2092,28 +2043,26 @@ and normal table of contents. (To produce this in particular, define <p>On the other hand, if you don’t want to rewrite the <tt>.toc</tt> file at all, perhaps because you are only running TeX on part of your manuscript, you can set <code>\rewritetocfilefalse</code>. -<a name="index-ifrewritetocfile"></a> -<a name="index-rewritetocfile-_0028conditional_0029"></a> +<span id="index-ifrewritetocfile"></span> +<span id="index-rewritetocfile-_0028conditional_0029"></span> </p> <hr> -<a name="Changing-the-_002etoc-file_0027s-root-name"></a> -<div class="header"> +<span id="Changing-the-_002etoc-file_0027s-root-name"></span><div class="header"> <p> Next: <a href="#Alternative-contents-files" accesskey="n" rel="next">Alternative contents files</a>, Previous: <a href="#Reading-the-_002etoc-file" accesskey="p" rel="prev">Reading the .toc file</a>, Up: <a href="#Contents" accesskey="u" rel="up">Contents</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Changing-the-_002etoc-file_0027s-root-name-1"></a> -<h4 class="subsection">4.8.3 Changing the <tt>.toc</tt> file’s root name</h4> +<span id="Changing-the-_002etoc-file_0027s-root-name-1"></span><h4 class="subsection">4.8.3 Changing the <tt>.toc</tt> file’s root name</h4> <p>By default, the <samp>.toc</samp> file has the root <code>\jobname</code>. If your document has more than one contents—for example, if it is a collection of papers, some of which have their own contents—you can tell Eplain to use a different root name by defining the control sequence <code>\tocfilebasename</code>. -<a name="index-tocfilebasename"></a> +<span id="index-tocfilebasename"></span> </p> -<a name="index-writing-several-toc-files"></a> -<a name="index-toc-files_002c-writing-several"></a> +<span id="index-writing-several-toc-files"></span> +<span id="index-toc-files_002c-writing-several"></span> <p>Note that <code>\writetocentry</code>, <code>\writenumberedtocentry</code> and <code>\writenumberedtocline</code> will open the contents file for writing only at the first call, using the @@ -2126,17 +2075,15 @@ files from a single TeX job, use <code>\definecontentsfile</code> </p> <hr> -<a name="Alternative-contents-files"></a> -<div class="header"> +<span id="Alternative-contents-files"></span><div class="header"> <p> Previous: <a href="#Changing-the-_002etoc-file_0027s-root-name" accesskey="p" rel="prev">Changing the .toc file's root name</a>, Up: <a href="#Contents" accesskey="u" rel="up">Contents</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Alternative-contents-files-1"></a> -<h4 class="subsection">4.8.4 Alternative contents files</h4> +<span id="Alternative-contents-files-1"></span><h4 class="subsection">4.8.4 Alternative contents files</h4> -<a name="index-list-of-figures"></a> -<a name="index-list-of-tables"></a> -<a name="index-definecontentsfile"></a> +<span id="index-list-of-figures"></span> +<span id="index-list-of-tables"></span> +<span id="index-definecontentsfile"></span> <p>In addition to the usual table of contents, you may want to have a list of figures, list of tables, or other such contents-like list. You can do this with <code>\definecontentsfile{<var>abbrev</var>}</code>. All of the @@ -2152,22 +2099,20 @@ the control sequence names. <hr> -<a name="Cross_002dreferences"></a> -<div class="header"> +<span id="Cross_002dreferences"></span><div class="header"> <p> Next: <a href="#Page-references" accesskey="n" rel="next">Page references</a>, Previous: <a href="#Contents" accesskey="p" rel="prev">Contents</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Cross_002dreferences-1"></a> -<h3 class="section">4.9 Cross-references</h3> +<span id="Cross_002dreferences-1"></span><h3 class="section">4.9 Cross-references</h3> -<a name="index-cross_002dreferences"></a> +<span id="index-cross_002dreferences"></span> <p>It is often useful to refer the reader to other parts of your document; but putting literal page, section, equation, or whatever numbers in the text is certainly a bad thing. </p> <p>Eplain therefore provides commands for symbolic cross-references. It uses an auxiliary file with extension <tt>.aux</tt> -<a name="index-_002eaux-file-1"></a> +<span id="index-_002eaux-file-1"></span> (and the same root name as your document) to keep track of the information. Therefore, it takes two passes to get the cross-references right—one to write them out, and one to read them in. Eplain @@ -2177,7 +2122,7 @@ reading it, Eplain reopens it for writing. <p>You can control whether or not Eplain warns you about undefined labels. See <a href="#Citations">Citations</a>. </p> -<a name="index-labels_002c-characters-valid-in"></a> +<span id="index-labels_002c-characters-valid-in"></span> <p>Labels in Eplain’s cross-reference commands can use characters of category code eleven (letter), twelve (other), ten (space), three (math shift), four (alignment tab), seven (superscript), or eight (subscript). @@ -2191,27 +2136,25 @@ and list items. See <a href="#Citations">Citations</a>, and <a href="#Lists">Li (see <a href="#Cross_002dreference-hyperlinks">Cross-reference hyperlinks</a>). </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Defining-generic-references" accesskey="1">Defining generic references</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Defining-generic-references" accesskey="1">Defining generic references</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Using-generic-references" accesskey="2">Using generic references</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Using-generic-references" accesskey="2">Using generic references</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Defining-generic-references"></a> -<div class="header"> +<span id="Defining-generic-references"></span><div class="header"> <p> Next: <a href="#Using-generic-references" accesskey="n" rel="next">Using generic references</a>, Up: <a href="#Cross_002dreferences" accesskey="u" rel="up">Cross-references</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Defining-generic-references-1"></a> -<h4 class="subsection">4.9.1 Defining generic references</h4> +<span id="Defining-generic-references-1"></span><h4 class="subsection">4.9.1 Defining generic references</h4> -<a name="index-defining-general-references"></a> -<a name="index-references_002c-defining-general"></a> -<a name="index-cross_002dreferences_002c-defining-general"></a> +<span id="index-defining-general-references"></span> +<span id="index-references_002c-defining-general"></span> +<span id="index-cross_002dreferences_002c-defining-general"></span> -<a name="index-definexref"></a> +<span id="index-definexref"></span> <p>Eplain provides the command <code>\definexref</code> for general cross-references. It takes three arguments: the name of the label (see section above for valid label names), the value of the label (which can @@ -2234,36 +2177,34 @@ commands. See the next section. </p> <hr> -<a name="Using-generic-references"></a> -<div class="header"> +<span id="Using-generic-references"></span><div class="header"> <p> Previous: <a href="#Defining-generic-references" accesskey="p" rel="prev">Defining generic references</a>, Up: <a href="#Cross_002dreferences" accesskey="u" rel="up">Cross-references</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Using-generic-references-1"></a> -<h4 class="subsection">4.9.2 Using generic references</h4> +<span id="Using-generic-references-1"></span><h4 class="subsection">4.9.2 Using generic references</h4> -<a name="index-defining-general-references-1"></a> -<a name="index-references_002c-defining-general-1"></a> -<a name="index-cross_002dreferences_002c-defining-general-1"></a> +<span id="index-defining-general-references-1"></span> +<span id="index-references_002c-defining-general-1"></span> +<span id="index-cross_002dreferences_002c-defining-general-1"></span> <p>To retrieve the value of the label defined via <code>\definexref</code> (see the previous section), Eplain provides the following macros: </p> <dl compact="compact"> <dd> -<a name="index-refn"></a> +<span id="index-refn"></span> </dd> <dt><code>\refn{<var>label</var>}</code></dt> -<dd><a name="index-xrefn"></a> +<dd><span id="index-xrefn"></span> </dd> <dt><code>\xrefn{<var>label</var>}</code></dt> <dd><p><code>\refn</code> and <code>\xrefn</code> (they are synonyms) produce the bare definition of <var>label</var>. If <var>label</var> isn’t defined, issue a warning, and produce <var>label</var> itself instead, in typewriter. (The warning isn’t given if <code>\xrefwarningfalse</code>.) -<a name="index-xrefwarning-conditional"></a> +<span id="index-xrefwarning-conditional"></span> </p> -<a name="index-ref"></a> +<span id="index-ref"></span> </dd> <dt><code>\ref{<var>label</var>}</code></dt> <dd><p>Given the class <var>c</var> for <var>label</var> (see the description of @@ -2271,7 +2212,7 @@ warning isn’t given if <code>\xrefwarningfalse</code>.) <code>\<var>c</var> word</code> (if it’s defined) followed by a tie. Then call <code>\refn</code> on <var>label</var>. (Example below.) </p> -<a name="index-refs"></a> +<span id="index-refs"></span> </dd> <dt><code>\refs{<var>label</var>}</code></dt> <dd><p>Like <code>\ref</code>, but append the letter ‘<samp>s</samp>’ to the @@ -2297,31 +2238,29 @@ See \refs{sec-intro} and \refn{sec-next} … </p> <hr> -<a name="Page-references"></a> -<div class="header"> +<span id="Page-references"></span><div class="header"> <p> Next: <a href="#Equation-references" accesskey="n" rel="next">Equation references</a>, Previous: <a href="#Cross_002dreferences" accesskey="p" rel="prev">Cross-references</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Page-references-1"></a> -<h3 class="section">4.10 Page references</h3> +<span id="Page-references-1"></span><h3 class="section">4.10 Page references</h3> <p>Eplain provides two commands for handling references to page numbers, one for definition and one for use. </p> <dl compact="compact"> <dt><code>\xrdef{<var>label</var>}</code></dt> -<dd><a name="index-xrdef"></a> +<dd><span id="index-xrdef"></span> <p>Define <var>label</var> to be the current page number. This produces no printed output, and ignores following spaces. </p> </dd> <dt><code>\xref{<var>label</var>}</code></dt> -<dd><a name="index-xref"></a> +<dd><span id="index-xref"></span> <p>Produce the text ‘p. <var>pageno</var>’, which is the usual form for cross-references. The <var>pageno</var> is actually <var>label</var>’s definition; if <var>label</var> isn’t defined, the text of the label itself is printed. The ‘p. ’ prefix is defined by <code>\xrefpageword</code>. -<a name="index-xrefpageword"></a> +<span id="index-xrefpageword"></span> Its default definition is <code>p.\thinspace</code>. </p> </dd> @@ -2331,20 +2270,18 @@ Its default definition is <code>p.\thinspace</code>. </p> <hr> -<a name="Equation-references"></a> -<div class="header"> +<span id="Equation-references"></span><div class="header"> <p> Next: <a href="#Indexing" accesskey="n" rel="next">Indexing</a>, Previous: <a href="#Page-references" accesskey="p" rel="prev">Page references</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Equation-references-1"></a> -<h3 class="section">4.11 Equation references</h3> +<span id="Equation-references-1"></span><h3 class="section">4.11 Equation references</h3> -<a name="index-equations_002c-references-to"></a> -<a name="index-equations_002c-numbering"></a> +<span id="index-equations_002c-references-to"></span> +<span id="index-equations_002c-numbering"></span> <p>Instead of referring to pages, it’s most useful if equation labels refer to equation numbers. Therefore, Eplain reserves a <code>\count</code> register, <code>\eqnumber</code>, -<a name="index-eqnumber"></a> +<span id="index-eqnumber"></span> for the current equation number, and increments it at each numbered equation. </p> @@ -2352,8 +2289,8 @@ numbered equation. </p> <dl compact="compact"> <dt><code>\eqdef{<var>label</var>}</code></dt> -<dd><a name="index-eqdef"></a> -<a name="index-eqnum-1"></a> +<dd><span id="index-eqdef"></span> +<span id="index-eqnum-1"></span> <p>This defines <var>label</var> to be the current value of <code>\eqnumber</code>, and, if the current context is not inner, then produces a <code>\eqnum</code> command (see <a href="#Displays">Displays</a>). (The condition makes it possible to use @@ -2361,29 +2298,29 @@ command (see <a href="#Displays">Displays</a>). (The condition makes it possibl <code>\eqalignno</code> construction, for example.) The text of the equation number is produced using <code>\eqprint</code>. See <a href="#Formatting-equation-references">Formatting equation references</a>. </p> -<a name="index-empty-equation-labels"></a> -<a name="index-labels_002c-empty-equation"></a> -<a name="index-equations_002c-giving-numbers-to-all"></a> +<span id="index-empty-equation-labels"></span> +<span id="index-labels_002c-empty-equation"></span> +<span id="index-equations_002c-giving-numbers-to-all"></span> <p>If <var>label</var> is empty, you still get an equation number (although naturally you can’t reliably refer to it). This is useful if you want to put numbers on all equations in your document, and you don’t want to think up unique labels. </p> -<a name="index-empty-equation-labels_002c-referring-to"></a> -<a name="index-labels_002c-empty-equation_002c-referring-to"></a> -<p>To refer to the last equation with the empty label, you just use the -empty label in one of the equation reference macros (see below). This -can be handy when you want to refer to an equation shortly after its +<span id="index-empty-equation-labels_002c-referring-to"></span> +<span id="index-labels_002c-empty-equation_002c-referring-to"></span> +<p>To refer to the last equation with the empty label, you use the empty +label in one of the equation reference macros (see below). This can +be handy when you want to refer to an equation shortly after its definition, say, in the sentence following the displayed equation, and do not intend to refer to the equation later. But use this trick with -extreme caution: if later you change the text and insert another -empty definition between the original definition and the reference, -the reference will start to refer to the new empty-labeled equation. +extreme caution: if later you change the text and insert another empty +definition between the original definition and the reference, the +reference will start to refer to the new empty-labeled equation. </p> </dd> <dt><code>\eqdefn{<var>label</var>}</code></dt> -<dd><a name="index-eqdefn"></a> -<a name="index-eqnum-2"></a> +<dd><span id="index-eqdefn"></span> +<span id="index-eqnum-2"></span> <p>This is like <code>\eqdef</code>, except it always omits the <code>\eqnum</code> command. It can therefore be used in places where <code>\eqdef</code> can’t; for example, in a non-displayed equation. The text of the equation @@ -2393,21 +2330,21 @@ print that label. </p> </dd> <dt><code>\eqref{<var>label</var>}</code></dt> -<dd><a name="index-eqref"></a> +<dd><span id="index-eqref"></span> <p>This produces a formatted reference to <var>label</var>. If <var>label</var> is undefined (perhaps because it is a forward reference), it just produces the text of the label itself. Otherwise, it calls <code>\eqprint</code>. </p> </dd> <dt><code>\eqrefn{<var>label</var>}</code></dt> -<dd><a name="index-eqrefn"></a> +<dd><span id="index-eqrefn"></span> <p>This produces the cross-reference text for <var>label</var>. That is, it is like <code>\eqref</code>, except it doesn’t call <code>\eqprint</code>. </p> </dd> </dl> -<a name="index-equation-labels_002c-characters-valid-in"></a> +<span id="index-equation-labels_002c-characters-valid-in"></span> <p>Equation labels can contain the same characters that are valid in general cross-references. </p> @@ -2416,23 +2353,21 @@ general cross-references. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Formatting-equation-references" accesskey="1">Formatting equation references</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Formatting-equation-references" accesskey="1">Formatting equation references</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Subequation-references" accesskey="2">Subequation references</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Subequation-references" accesskey="2">Subequation references</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Formatting-equation-references"></a> -<div class="header"> +<span id="Formatting-equation-references"></span><div class="header"> <p> Next: <a href="#Subequation-references" accesskey="n" rel="next">Subequation references</a>, Up: <a href="#Equation-references" accesskey="u" rel="up">Equation references</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Formatting-equation-references-1"></a> -<h4 class="subsection">4.11.1 Formatting equation references</h4> +<span id="Formatting-equation-references-1"></span><h4 class="subsection">4.11.1 Formatting equation references</h4> -<a name="index-equation-numbers_002c-formatting-of"></a> +<span id="index-equation-numbers_002c-formatting-of"></span> <p>Both defining an equation label and referring to it should usually produce output. This output is produced with the <code>\eqprint</code> macro, which takes one argument, the equation number being defined or referred @@ -2440,7 +2375,7 @@ to. By default, this just produces ‘<samp>(<var>number</var>)</samp>&rsqu <var>number</var> is the equation number. To produce the equation number in a different font, or with different surrounding symbols, or whatever, you can redefine <code>\eqprint</code>. -<a name="index-eqprint"></a> +<span id="index-eqprint"></span> For example, the following definition would print all equation numbers in italics. (The extra braces define a group, to keep the font change from affecting surrounding text.) @@ -2453,7 +2388,7 @@ from affecting surrounding text.) to add more structure to the equation number; for example, you might want to include the chapter number, to get equation numbers like ‘(1.2)’. To achieve this, you redefine <code>\eqconstruct</code>. -<a name="index-eqconstruct"></a> +<span id="index-eqconstruct"></span> For example: </p> <div class="example"> @@ -2540,30 +2475,28 @@ therefore we first put the argument in a box, thus causing </p> <hr> -<a name="Subequation-references"></a> -<div class="header"> +<span id="Subequation-references"></span><div class="header"> <p> Previous: <a href="#Formatting-equation-references" accesskey="p" rel="prev">Formatting equation references</a>, Up: <a href="#Equation-references" accesskey="u" rel="up">Equation references</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Subequation-references-1"></a> -<h4 class="subsection">4.11.2 Subequation references</h4> +<span id="Subequation-references-1"></span><h4 class="subsection">4.11.2 Subequation references</h4> -<a name="index-equations_002c-groups-of"></a> -<a name="index-subequations_002c-referring-to"></a> +<span id="index-equations_002c-groups-of"></span> +<span id="index-subequations_002c-referring-to"></span> <p>Eplain also provides for one level of substructure for equations. That is, you might want to define a related group of equations with numbers like ‘2.1’ and ‘2.2’, and then be able to refer to the group as a whole: “… in the system of equations (2)…”. </p> <p>The commands to do this are <code>\eqsubdef</code> and -<a name="index-eqsubdef"></a> +<span id="index-eqsubdef"></span> <code>\eqsubdefn</code>. -<a name="index-eqsubdefn"></a> +<span id="index-eqsubdefn"></span> They take one <var>label</var> argument like their counterparts above, and generally behave in the same way. The difference is in how they construct the equation number: instead of using just <code>\eqnumber</code>, they also use another counter, <code>\subeqnumber</code>. -<a name="index-subeqnumber"></a> +<span id="index-subeqnumber"></span> This counter is advanced by one at every <code>\eqsubdef</code> or <code>\eqsubdefn</code>, and reset to zero at every <code>\eqdef</code> or <code>\eqdefn</code>. @@ -2573,7 +2506,7 @@ equations. </p> <p>To put the two together to construct the text that the label will produce, they use a macro <code>\eqsubreftext</code>. -<a name="index-eqsubreftext"></a> +<span id="index-eqsubreftext"></span> This macros takes two arguments, the “main” equation number (which, because the equation label can be defined as arbitrary text, as described in the previous section, might be anything at all) and the @@ -2603,16 +2536,14 @@ instead of using the scratch count register <code>\count255</code>, because </p> <hr> -<a name="Indexing"></a> -<div class="header"> +<span id="Indexing"></span><div class="header"> <p> Next: <a href="#Justification" accesskey="n" rel="next">Justification</a>, Previous: <a href="#Equation-references" accesskey="p" rel="prev">Equation references</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Indexing-1"></a> -<h3 class="section">4.12 Indexing</h3> +<span id="Indexing-1"></span><h3 class="section">4.12 Indexing</h3> -<a name="index-indexing"></a> -<a name="index-sorting-an-index"></a> +<span id="index-indexing"></span> +<span id="index-sorting-an-index"></span> <p>Eplain provides support for generating raw material for an index, and for typesetting a sorted index. A separate program must do the actual @@ -2622,24 +2553,22 @@ for sorting. <p>Eplain can create hypertext links pointing from the index to the index terms (see <a href="#Index-hyperlinks">Index hyperlinks</a>). </p> -<a name="index-URL-for-MakeIndex"></a> -<a name="index-makeindex-1"></a> +<span id="index-makeindex-1"></span> <p>Eplain’s indexing commands were designed to work with the program -MakeIndex, available from CTAN hosts in -<samp>tex-archive/indexing/makeindex</samp>; MakeIndex is also commonly -included in prepackaged TeX distributions. It is beyond the scope of -this manual to explain how to run MakeIndex, and all of its many -options. See <a href="http://www.ctan.org/tex-archive/indexing/makeindex">http://www.ctan.org/tex-archive/indexing/makeindex</a>. +MakeIndex (<a href="https://ctan.org/pkg/makeindex">https://ctan.org/pkg/makeindex</a>); MakeIndex is also +commonly included in prepackaged TeX distributions. It is beyond +the scope of this manual to explain how to run MakeIndex, and all of +its many options. </p> <p>The basic strategy for indexing works like this: </p> <ol> -<li> <a name="index-_002eidx-files"></a> +<li> <span id="index-_002eidx-files"></span> For a document <samp>foo.tex</samp>, Eplain’s indexing commands (e.g., <code>\idx</code>; see the section ‘Indexing terms’ below) write the raw index material to <samp>foo.idx</samp>. -</li><li> <a name="index-_002eind-files"></a> +</li><li> <span id="index-_002eind-files"></span> MakeIndex reads <samp>foo.idx</samp>, collects and sorts the index, and writes the result to <samp>foo.ind</samp>. @@ -2648,13 +2577,13 @@ TeX. See the section ‘Typesetting an index’ below. </li></ol> -<a name="index-texi2dvi-2"></a> +<span id="index-texi2dvi-2"></span> <p>The <code>texi2dvi</code> program can help you automate this process (see <a href="#Invoking-Eplain">Invoking Eplain</a>). </p> -<a name="index-multiple-indexes"></a> -<a name="index-indexes_002c-multiple"></a> -<a name="index-defineindex"></a> +<span id="index-multiple-indexes"></span> +<span id="index-indexes_002c-multiple"></span> +<span id="index-defineindex"></span> <p>If your document needs more than one index, each must have its own file. Therefore, Eplain provides the command <code>\defineindex</code>, which takes an argument that is a single letter, which replaces ‘<samp>i</samp>’ in @@ -2679,9 +2608,9 @@ you’ll need to run MakeIndex like this: <pre class="example">$ makeindex book.jdx -o book.jnd </pre></div> -<a name="index-indexes_002c-disabling"></a> -<a name="index-disabling-indexes"></a> -<a name="index-ifidx"></a> +<span id="index-indexes_002c-disabling"></span> +<span id="index-disabling-indexes"></span> +<span id="index-ifidx"></span> <p>For each index defined with <code>\defineindex{<var>n</var>}</code>, Eplain provides a switch <code>\if<var>n</var>dx</code> which controls whether indexing commands write index entries to the corresponding index file. However, @@ -2698,26 +2627,24 @@ compilations of a manuscript, e.g., to avoid the overhead of index file input/output. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Indexing-terms" accesskey="1">Indexing terms</a>:</td><td> </td><td align="left" valign="top">Specifying what to index. +<tr><td align="left" valign="top">• <a href="#Indexing-terms" accesskey="1">Indexing terms</a></td><td> </td><td align="left" valign="top">Specifying what to index. </td></tr> -<tr><td align="left" valign="top">• <a href="#Typesetting-an-index" accesskey="2">Typesetting an index</a>:</td><td> </td><td align="left" valign="top">Printing the sorted output. +<tr><td align="left" valign="top">• <a href="#Typesetting-an-index" accesskey="2">Typesetting an index</a></td><td> </td><td align="left" valign="top">Printing the sorted output. </td></tr> -<tr><td align="left" valign="top">• <a href="#Customizing-indexing" accesskey="3">Customizing indexing</a>:</td><td> </td><td align="left" valign="top">Creating commands and specifying extra actions. +<tr><td align="left" valign="top">• <a href="#Customizing-indexing" accesskey="3">Customizing indexing</a></td><td> </td><td align="left" valign="top">Creating commands and specifying extra actions. </td></tr> </table> <hr> -<a name="Indexing-terms"></a> -<div class="header"> +<span id="Indexing-terms"></span><div class="header"> <p> Next: <a href="#Typesetting-an-index" accesskey="n" rel="next">Typesetting an index</a>, Up: <a href="#Indexing" accesskey="u" rel="up">Indexing</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Indexing-terms-1"></a> -<h4 class="subsection">4.12.1 Indexing terms</h4> +<span id="Indexing-terms-1"></span><h4 class="subsection">4.12.1 Indexing terms</h4> -<a name="index-indexing-terms"></a> -<a name="index-silent-indexing"></a> +<span id="index-indexing-terms"></span> +<span id="index-silent-indexing"></span> <p>Indexing commands in Eplain come in pairs: one command that only writes the index entry to the ‘<samp>.idx</samp>’ file (see above section), and @@ -2727,7 +2654,7 @@ with ‘<samp>s</samp>’ (for “silent”). In either case, th above. Eplain defines the index ‘<samp>i</samp>’ itself, so that’s what we’ll use in the names below. </p> -<a name="index-subterm-in-indexing"></a> +<span id="index-subterm-in-indexing"></span> <p>The silent form of the commands take a subterm as a trailing optional argument. For example, <code>\sidx{truth}[definition of]</code> on page 75 makes an index entry that will eventually be typeset (by default) as @@ -2737,38 +2664,36 @@ makes an index entry that will eventually be typeset (by default) as definition of, 75 </pre></div> -<a name="index-trailing-spaces-and-indexing-commands"></a> -<a name="index-spaces_002c-trailing-and-indexing-commands"></a> -<a name="index-indexing-and-trailing-spaces"></a> +<span id="index-trailing-spaces-and-indexing-commands"></span> +<span id="index-spaces_002c-trailing-and-indexing-commands"></span> +<span id="index-indexing-and-trailing-spaces"></span> <p>Also, the silent commands ignore trailing spaces. The non-silent ones do not. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Indexing-commands" accesskey="1">Indexing commands</a>:</td><td> </td><td align="left" valign="top">Making index entries. +<tr><td align="left" valign="top">• <a href="#Indexing-commands" accesskey="1">Indexing commands</a></td><td> </td><td align="left" valign="top">Making index entries. </td></tr> -<tr><td align="left" valign="top">• <a href="#Modifying-index-entries" accesskey="2">Modifying index entries</a>:</td><td> </td><td align="left" valign="top">Ranges, see/see also, page number typesetting. +<tr><td align="left" valign="top">• <a href="#Modifying-index-entries" accesskey="2">Modifying index entries</a></td><td> </td><td align="left" valign="top">Ranges, see/see also, page number typesetting. </td></tr> -<tr><td align="left" valign="top">• <a href="#Index-entries-with-special-characters" accesskey="3">Index entries with special characters</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Index-entries-with-special-characters" accesskey="3">Index entries with special characters</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Proofing-index-terms" accesskey="4">Proofing index terms</a>:</td><td> </td><td align="left" valign="top">Noting index entries in the margins. +<tr><td align="left" valign="top">• <a href="#Proofing-index-terms" accesskey="4">Proofing index terms</a></td><td> </td><td align="left" valign="top">Noting index entries in the margins. </td></tr> </table> <hr> -<a name="Indexing-commands"></a> -<div class="header"> +<span id="Indexing-commands"></span><div class="header"> <p> Next: <a href="#Modifying-index-entries" accesskey="n" rel="next">Modifying index entries</a>, Up: <a href="#Indexing-terms" accesskey="u" rel="up">Indexing terms</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Indexing-commands-1"></a> -<h4 class="subsubsection">4.12.1.1 Indexing commands</h4> +<span id="Indexing-commands-1"></span><h4 class="subsubsection">4.12.1.1 Indexing commands</h4> -<a name="index-indexing-commands"></a> +<span id="index-indexing-commands"></span> <p>Here are the commands. </p> <ul> -<li> <a name="index-sidx"></a> -<a name="index-idx"></a> +<li> <span id="index-sidx"></span> +<span id="index-idx"></span> <code>\sidx{<var>term</var>}[<var>subterm</var>]</code> makes an index entry for <var>term</var>, optionally with subterm <var>subterm</var>. <code>\idx{<var>term</var>}</code> also produces <var>term</var> as output. Example: @@ -2783,9 +2708,9 @@ specified in <var>subterm</var>, using the <code>\idxsubentryseparator</code> character to separate them. This character is by default ‘<samp>!</samp>’. </p> -</li><li> <a name="index-sidxname"></a> -<a name="index-idxnameseparator"></a> -<a name="index-idxname"></a> +</li><li> <span id="index-sidxname"></span> +<span id="index-idxnameseparator"></span> +<span id="index-idxname"></span> <code>\sidxname{<var>First M.</var>}{<var>von Last</var>}[<var>subterm</var>]</code> makes an index entry for ‘<samp><var>von Last</var>, <var>First M.</var></samp>’. You can change the @@ -2800,8 +2725,8 @@ and <code>\sidx</code>.) Example: almost as many names. </pre></div> -</li><li> <a name="index-sidxmarked"></a> -<a name="index-idxmarked"></a> +</li><li> <span id="index-sidxmarked"></span> +<span id="index-idxmarked"></span> <code>\sidxmarked\<var>cs</var>{<var>term</var>}[<var>subterm</var>]</code> makes an index entry for <code><var>term</var>[<var>subterm</var>]</code>, but <var>term</var> will be put in the index as <code>\<var>cs</var>{term}</code>, but still sorted as just @@ -2816,8 +2741,8 @@ Peter Drucker's \idxmarked\article{The Polanyis} is a remarkable essay about a remarkable family. </pre></div> -</li><li> <a name="index-idxsubmarked"></a> -<a name="index-sidxsubmarked"></a> +</li><li> <span id="index-idxsubmarked"></span> +<span id="index-sidxsubmarked"></span> <code>\sidxsubmarked{<var>term</var>}\<var>cs</var>{subterm}</code> makes an index entry for <var>term</var>, <var>subterm</var> as usual, but also puts <var>subterm</var> in the index as <code>\<var>cs</var>{term}</code>. @@ -2833,8 +2758,8 @@ The \idxsubmarked{Anderson}\title{Carmen} is a strange twist. </li></ul> -<a name="index-index-entry-general-sorting"></a> -<a name="index-sorting-of-index-entries"></a> +<span id="index-index-entry-general-sorting"></span> +<span id="index-sorting-of-index-entries"></span> <p>The commands above rely on MakeIndex’s feature for separating sorting of an index entry’s from its typesetting. You can use this directly by specifying an index entry as <code><var>sort</var>@<var>typeset</var></code>. For @@ -2846,12 +2771,11 @@ example: <p>will sort as <code>Ap-weight</code>, but print with the proper math. The <code>@</code> here is MakeIndex’s default character for this purpose. -See <a href="http://www.ctan.org/tex-archive/indexing/makeindex">http://www.ctan.org/tex-archive/indexing/makeindex</a>. To make an index -entry with an <code>@</code> in it, you have to escape it with a backslash; -Eplain provides no macros for doing this. +To make an index entry with an <code>@</code> in it, you have to escape it +with a backslash; Eplain provides no macros for doing this. </p> -<a name="index-afterindexterm-hook"></a> -<a name="index-whatsits-made-by-index-entries"></a> +<span id="index-afterindexterm-hook"></span> +<span id="index-whatsits-made-by-index-entries"></span> <p>After any index command, Eplain runs <code>\hookaction{afterindexterm}</code>. Because the index commands always add a whatsit item to the current list, you may wish to preserve a @@ -2865,16 +2789,14 @@ could do: <hr> -<a name="Modifying-index-entries"></a> -<div class="header"> +<span id="Modifying-index-entries"></span><div class="header"> <p> Next: <a href="#Index-entries-with-special-characters" accesskey="n" rel="next">Index entries with special characters</a>, Previous: <a href="#Indexing-commands" accesskey="p" rel="prev">Indexing commands</a>, Up: <a href="#Indexing-terms" accesskey="u" rel="up">Indexing terms</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Modifying-index-entries-1"></a> -<h4 class="subsubsection">4.12.1.2 Modifying index entries</h4> +<span id="Modifying-index-entries-1"></span><h4 class="subsubsection">4.12.1.2 Modifying index entries</h4> -<a name="index-modifying-index-entries_0027-page-numbers"></a> -<a name="index-index-entries_0027-page-numbers_002c-modifying"></a> +<span id="index-modifying-index-entries_0027-page-numbers"></span> +<span id="index-index-entries_0027-page-numbers_002c-modifying"></span> <p>All the index commands described in the previous section take an initial optional argument before the index term, which modify the index entry’s @@ -2893,10 +2815,10 @@ is independent of these. <dl compact="compact"> <dt><code>begin</code></dt> <dt><code>end</code></dt> -<dd><a name="index-begin-for-index-entries"></a> -<a name="index-end-for-index-entries"></a> -<a name="index-index-entries-and-ranges"></a> -<a name="index-ranges-and-index-entry"></a> +<dd><span id="index-begin-for-index-entries"></span> +<span id="index-end-for-index-entries"></span> +<span id="index-index-entries-and-ranges"></span> +<span id="index-ranges-and-index-entry"></span> <p>These mark an index entry as the beginning or end of a range. The index entries must match exactly for MakeIndex to recognize them. Example: @@ -2916,10 +2838,10 @@ Example: </dd> <dt><code>see</code></dt> -<dd><a name="index-see-for-index-entries"></a> -<a name="index-see_002c-and-index-entries"></a> -<a name="index-cross_002dreferencing-index-entries"></a> -<a name="index-index-entries_002c-and-cross_002dreferencing"></a> +<dd><span id="index-see-for-index-entries"></span> +<span id="index-see_002c-and-index-entries"></span> +<span id="index-cross_002dreferencing-index-entries"></span> +<span id="index-index-entries_002c-and-cross_002dreferencing"></span> <p>This marks an index entry as pointing to another; the real index term is an additional (non-optional) argument to the command. Thus you can anticipate a term readers may wish to look up, yet which you have @@ -2938,7 +2860,7 @@ decided not to index. Example: </dd> <dt><code>seealso</code></dt> -<dd><a name="index-seealso-for-index-entries"></a> +<dd><span id="index-seealso-for-index-entries"></span> <p>Similar to <code>see</code> (the previous item), but also allows for normal index entries of the referencing term. The normal index entries have to be created separately—<code>seealso</code> does <em>not</em> contribute a @@ -2957,7 +2879,7 @@ entry for the term: elements of, 75, 97, 114, <i>see also</i> dichotomies </pre></div> -<p>(Aside for the academically curious: The archetypally critical book I +<p>(Aside for the academically curious: The archetypal critical book I took these dichotomous examples from is Laurence Berman’s <cite>The Musical Image</cite>, which I happened to co-design and typeset.) </p> @@ -2985,16 +2907,14 @@ it is up to you to define the control sequences you want to use. Example: <hr> -<a name="Index-entries-with-special-characters"></a> -<div class="header"> +<span id="Index-entries-with-special-characters"></span><div class="header"> <p> Next: <a href="#Proofing-index-terms" accesskey="n" rel="next">Proofing index terms</a>, Previous: <a href="#Modifying-index-entries" accesskey="p" rel="prev">Modifying index entries</a>, Up: <a href="#Indexing-terms" accesskey="u" rel="up">Indexing terms</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Index-entries-with-special-characters-1"></a> -<h4 class="subsubsection">4.12.1.3 Index entries with special characters</h4> +<span id="Index-entries-with-special-characters-1"></span><h4 class="subsubsection">4.12.1.3 Index entries with special characters</h4> -<a name="index-special-characters_002c-in-index-entries"></a> -<a name="index-index-entries-with-special-characters"></a> +<span id="index-special-characters_002c-in-index-entries"></span> +<span id="index-index-entries-with-special-characters"></span> <p>Indexing terms with special characters can become quite cumbersome because you have to keep both TeX and MakeIndex happy at the same @@ -3036,9 +2956,9 @@ writes the <samp>.ind</samp> file. This is what makes the non-silent commands less powerful and more troublesome when dealing with special characters. </p> -<a name="index-index-entries_002c-with-verbatim-text"></a> -<a name="index-index_002c-and-verbatim-text"></a> -<a name="index-verbatim-text_002c-in-index"></a> +<span id="index-index-entries_002c-with-verbatim-text"></span> +<span id="index-index_002c-and-verbatim-text"></span> +<span id="index-verbatim-text_002c-in-index"></span> <p>Here’s an example showing that terms for the silent commands can contain almost any character: </p> @@ -3066,8 +2986,8 @@ treated as spaces; <acronym>ASCII</acronym> return is treated as end-of-line (this means, among other things, that long terms can be broken across several lines). </p> -<a name="index-braces_002c-inside-index-entries"></a> -<a name="index-index-entries-containing-braces"></a> +<span id="index-braces_002c-inside-index-entries"></span> +<span id="index-index-entries-containing-braces"></span> <p>You have to be careful with the begin- and end-group characters (‘<samp>{</samp>’ and ‘<samp>}</samp>’ by default). If they are matched, you don’t have to do anything special. For example: @@ -3081,9 +3001,9 @@ have to do anything special. For example: hand. The first one is TeX—you have to instruct TeX to use something else as begin- and/or end-group characters. Eplain provides an easy way to do this: just define -<a name="index-idxargopen"></a> +<span id="index-idxargopen"></span> <code>\idxargopen</code> and/or -<a name="index-idxargclose"></a> +<span id="index-idxargclose"></span> <code>\idxargclose</code> to the begin- and end-group characters you are going to use with indexing macros, and use braces inside index terms without any restrictions. Here’s an example: @@ -3098,8 +3018,8 @@ without any restrictions. Here’s an example: problem—braces are MakeIndex’s grouping characters as well (by default), so we have escaped unmatched braces with ‘<samp>"</samp>’. </p> -<a name="index-brackets_002c-inside-index-entries"></a> -<a name="index-index-entries-containing-brackets"></a> +<span id="index-brackets_002c-inside-index-entries"></span> +<span id="index-index-entries-containing-brackets"></span> <p>And the final note: if you need a subentry containing brackets (‘<samp>[</samp>’ and ‘<samp>]</samp>’), avoid the optional argument of <code>\sidx</code> and friends, and use instead MakeIndex’s subentry separator to create @@ -3111,17 +3031,15 @@ the subentry with the brackets in it: <hr> -<a name="Proofing-index-terms"></a> -<div class="header"> +<span id="Proofing-index-terms"></span><div class="header"> <p> Previous: <a href="#Index-entries-with-special-characters" accesskey="p" rel="prev">Index entries with special characters</a>, Up: <a href="#Indexing-terms" accesskey="u" rel="up">Indexing terms</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Proofing-index-terms-1"></a> -<h4 class="subsubsection">4.12.1.4 Proofing index terms</h4> +<span id="Proofing-index-terms-1"></span><h4 class="subsubsection">4.12.1.4 Proofing index terms</h4> -<a name="index-proofing-index-terms"></a> -<a name="index-index-entries_002c-proofing"></a> -<a name="index-margins_002c-index-terms-in"></a> +<span id="index-proofing-index-terms"></span> +<span id="index-index-entries_002c-proofing"></span> +<span id="index-margins_002c-index-terms-in"></span> <p>As you are reading through a manuscript, it is helpful to see what terms have been indexed, so you can add others, catch miscellaneous errors, @@ -3129,12 +3047,12 @@ etc. (Speaking from bitter experience, I can say it is extremely error-prone to leave all indexing to the end of the writing, since it involves adding many TeX commands to the source files.) </p> -<a name="index-ifindexproofing"></a> -<a name="index-indexproofingtrue"></a> -<a name="index-indexproofingfalse"></a> -<a name="index-indexproofterm"></a> -<a name="index-indexprooffont"></a> -<a name="index-cmtt8"></a> +<span id="index-ifindexproofing"></span> +<span id="index-indexproofingtrue"></span> +<span id="index-indexproofingfalse"></span> +<span id="index-indexproofterm"></span> +<span id="index-indexprooffont"></span> +<span id="index-cmtt8"></span> <p>So Eplain puts index terms in the margin of each page, if you set <code>\indexproofingtrue</code>. It is <code>false</code> by default. The terms are typeset by the macro <code>\indexproofterm</code>, which takes a single @@ -3144,11 +3062,11 @@ argument, the term to be typeset. Eplain’s definition of <code>cmtt8</code>. With this definition long terms run off the page, but since this is just for proofreading anyway, it seems acceptable. </p> -<a name="index-pageno"></a> -<a name="index-insidemargin"></a> -<a name="index-hoffset"></a> -<a name="index-outsidemargin"></a> -<a name="index-indexsetmargins"></a> +<span id="index-pageno"></span> +<span id="index-insidemargin"></span> +<span id="index-hoffset"></span> +<span id="index-outsidemargin"></span> +<span id="index-indexsetmargins"></span> <p>On the other hand, we certainly don’t want the index term to run into the text of the page, so Eplain uses the right-hand side of the page rather than the left-hand page (assuming a language read left to right @@ -3156,10 +3074,10 @@ here). So <code>\ifodd\pageno</code>, Eplain kerns by <code>\outsidemargin</code otherwise by <code>\insidemargin</code>. If those macros are undefined, <code>\indexsetmargins</code> defines them to be one inch plus <code>\hoffset</code>. </p> -<a name="index-_0040indexproof-insertion-class"></a> -<a name="index-indexproofunbox"></a> -<a name="index-makeheadline"></a> -<a name="index-output-routine-and-index-proofing"></a> +<span id="index-_0040indexproof-insertion-class"></span> +<span id="index-indexproofunbox"></span> +<span id="index-makeheadline"></span> +<span id="index-output-routine-and-index-proofing"></span> <p>To get the proofing index entries on the proper page, Eplain defines a new insertion class <code>\@indexproof</code>. To unbox any index proofing material, Eplain redefines <code>\makeheadline</code> to call @@ -3170,25 +3088,23 @@ the appropriate time. </p> <hr> -<a name="Typesetting-an-index"></a> -<div class="header"> +<span id="Typesetting-an-index"></span><div class="header"> <p> Next: <a href="#Customizing-indexing" accesskey="n" rel="next">Customizing indexing</a>, Previous: <a href="#Indexing-terms" accesskey="p" rel="prev">Indexing terms</a>, Up: <a href="#Indexing" accesskey="u" rel="up">Indexing</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Typesetting-an-index-1"></a> -<h4 class="subsection">4.12.2 Typesetting an index</h4> +<span id="Typesetting-an-index-1"></span><h4 class="subsection">4.12.2 Typesetting an index</h4> -<a name="index-typesetting-an-index"></a> -<a name="index-index-typesetting"></a> -<a name="index-readindexfile"></a> +<span id="index-typesetting-an-index"></span> +<span id="index-index-typesetting"></span> +<span id="index-readindexfile"></span> <p>The command <code>\readindexfile{i}</code> reads and typesets the <samp>.ind</samp> file that MakeIndex outputs (from the <samp>.idx</samp> file which the indexing commands in the previous sections write). Eplain defines a number of commands that support the default MakeIndex output. </p> -<a name="index-indexfilebasename"></a> -<a name="index-jobname-1"></a> +<span id="index-indexfilebasename"></span> +<span id="index-jobname-1"></span> <p>More precisely, <code>\readindexfile</code> reads <code>\indexfilebasename.<var>index-letter</var>nd</code>, where the <var>index-letter</var> is the argument. <code>\indexfilebasename</code> is @@ -3196,8 +3112,8 @@ number of commands that support the default MakeIndex output. different parts of a book, you may wish to change it, just as with bibliographies (see <a href="#Citations">Citations</a>). </p> -<a name="index-begin_007btheindex_007d"></a> -<a name="index-end_007btheindex_007d"></a> +<span id="index-begin_007btheindex_007d"></span> +<span id="index-end_007btheindex_007d"></span> <p>MakeIndex was designed to work with LaTeX; therefore, by default the <samp>.ind</samp> file starts with <code>\begin{theindex}</code> and ends with <code>\end{theindex}</code>. If no <code>\begin</code> has been defined, Eplain @@ -3205,17 +3121,17 @@ defines one to ignore its argument and set up for typesetting the index (see below), and also defines a <code>\end</code> to ignore its argument. (In a group, naturally, since there is a primitive <code>\end</code>). </p> -<a name="index-parindent-in-indexes"></a> -<a name="index-index-fonts"></a> -<a name="index-indexfonts"></a> -<a name="index-double-columns-in-indexes"></a> +<span id="index-parindent-in-indexes"></span> +<span id="index-index-fonts"></span> +<span id="index-indexfonts"></span> +<span id="index-double-columns-in-indexes"></span> <p>Eplain calls <code>\indexfonts</code>, sets <code>\parindent = 0pt</code>, and does <code>\doublecolumns</code> (see <a href="#Multiple-columns">Multiple columns</a>) at the <code>\begin{theindex}</code>. <code>\indexfonts</code> does nothing by default; it’s just there for you to override. (Indexes are usually typeset in smaller type than the main text.) </p> -<a name="index-beginindex-hook"></a> +<span id="index-beginindex-hook"></span> <p>It ends the setup with <code>\hookrun{beginindex}</code>, so you can override anything you like in that hook (see <a href="#Hooks">Hooks</a>). For example: </p> @@ -3223,14 +3139,14 @@ override anything you like in that hook (see <a href="#Hooks">Hooks</a>). For ex <pre class="example">\hookaction{beginindex}{\triplecolumns} </pre></div> -<a name="index-item-in-indexes"></a> -<a name="index-subitem-in-indexes"></a> -<a name="index-subsubitem-in-indexes"></a> -<a name="index-index-entry-formatting"></a> -<a name="index-formatting-index-entries"></a> -<a name="index-space-above-index-entries"></a> -<a name="index-continued-index-entries"></a> -<a name="index-index-entry-continuations"></a> +<span id="index-item-in-indexes"></span> +<span id="index-subitem-in-indexes"></span> +<span id="index-subsubitem-in-indexes"></span> +<span id="index-index-entry-formatting"></span> +<span id="index-formatting-index-entries"></span> +<span id="index-space-above-index-entries"></span> +<span id="index-continued-index-entries"></span> +<span id="index-index-entry-continuations"></span> <p>MakeIndex turns each main index entry into an <code>\item</code>, subentries into <code>\subitem</code>, and subsubentries into <code>\subsubitem</code>. By default, the first line of main entries are not indented, and subentries @@ -3242,16 +3158,16 @@ index entries. </p> <p>All levels do the following: </p> -<a name="index-hangindent-for-index-entries"></a> -<a name="index-raggedright-for-index-entries"></a> -<a name="index-hyphenpenalty-for-index-entries"></a> +<span id="index-hangindent-for-index-entries"></span> +<span id="index-raggedright-for-index-entries"></span> +<span id="index-hyphenpenalty-for-index-entries"></span> <div class="example"> <pre class="example">\hangindent = 1em \raggedright \hyphenpenalty = 10000 </pre></div> -<a name="index-indexitem-hook"></a> +<span id="index-indexitem-hook"></span> <p>Each entry ends with <code>\hookrun{indexitem}</code>, so you can change any of this. For example, to increase the allowable rag: </p> @@ -3259,27 +3175,25 @@ of this. For example, to increase the allowable rag: <pre class="example">\hookaction{indexitem}{\advance\rightskip by 2em} </pre></div> -<a name="index-indexspace"></a> -<a name="index-index-groupings"></a> +<span id="index-indexspace"></span> +<span id="index-index-groupings"></span> <p>Finally, MakeIndex outputs <code>\indexspace</code> between each group of entries in the <samp>.ind</samp> file. Eplain makes this equivalent to <code>\bigbreak</code>. </p> <hr> -<a name="Customizing-indexing"></a> -<div class="header"> +<span id="Customizing-indexing"></span><div class="header"> <p> Previous: <a href="#Typesetting-an-index" accesskey="p" rel="prev">Typesetting an index</a>, Up: <a href="#Indexing" accesskey="u" rel="up">Indexing</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Customizing-indexing-1"></a> -<h4 class="subsection">4.12.3 Customizing indexing</h4> +<span id="Customizing-indexing-1"></span><h4 class="subsection">4.12.3 Customizing indexing</h4> -<a name="index-customizing-indexing"></a> +<span id="index-customizing-indexing"></span> -<a name="index-afterindexterm"></a> -<a name="index-commas-after-index-terms"></a> -<a name="index-after-index-terms"></a> +<span id="index-afterindexterm"></span> +<span id="index-commas-after-index-terms"></span> +<span id="index-after-index-terms"></span> <p>By default, MakeIndex outputs ‘<samp>, </samp>’ after each term in the index. To change this, you can add the following to your MakeIndex style (<samp>.ist</samp>) file: @@ -3297,22 +3211,22 @@ delim_2 "\\afterindexterm " </p> <dl compact="compact"> <dt><code>\idxrangebeginword</code></dt> -<dd><a name="index-idxrangebeginword"></a> +<dd><span id="index-idxrangebeginword"></span> <p>‘begin’ </p> </dd> <dt><code>\idxrangeendword</code></dt> -<dd><a name="index-idxrangeendword"></a> +<dd><span id="index-idxrangeendword"></span> <p>‘end’ </p> </dd> <dt><code>\idxseecmdword</code></dt> -<dd><a name="index-idxseecmdword"></a> +<dd><span id="index-idxseecmdword"></span> <p>‘see’ </p> </dd> <dt><code>\idxseealsocmdword</code></dt> -<dd><a name="index-idxseealsocmdword"></a> +<dd><span id="index-idxseealsocmdword"></span> <p>‘seealso’ </p> </dd> @@ -3323,22 +3237,22 @@ delim_2 "\\afterindexterm " </p> <dl compact="compact"> <dt><code>\idxsubentryseparator</code></dt> -<dd><a name="index-idxsubentryseparator"></a> +<dd><span id="index-idxsubentryseparator"></span> <p>‘<samp>!</samp>’ </p> </dd> <dt><code>\idxencapoperator</code></dt> -<dd><a name="index-idxencapoperator"></a> +<dd><span id="index-idxencapoperator"></span> <p>‘<samp>|</samp>’ </p> </dd> <dt><code>\idxbeginrangemark</code></dt> -<dd><a name="index-idxbeginrangemark"></a> +<dd><span id="index-idxbeginrangemark"></span> <p>‘<samp>(</samp>’ </p> </dd> <dt><code>\idxendrangemark</code></dt> -<dd><a name="index-idxendrangemark"></a> +<dd><span id="index-idxendrangemark"></span> <p>‘<samp>)</samp>’ </p> </dd> @@ -3347,17 +3261,17 @@ delim_2 "\\afterindexterm " <p>There is no macro for the <code>actual</code> (‘<samp>@</samp>’ by default) character, because it’s impossible to make it expand properly. </p> -<a name="index-idxpagenum"></a> -<a name="index-see-also-index-entries-and-sorting"></a> +<span id="index-idxpagenum"></span> +<span id="index-see-also-index-entries-and-sorting"></span> <p>You can change the (imaginary) page number that “see also” entries sort as by redefining <code>\idxmaxpagenum</code>. This is 99999 by default, which is one digit too many for old versions of MakeIndex. </p> -<a name="index-indexseeword"></a> -<a name="index-indexseealsowords"></a> -<a name="index-seevariant"></a> -<a name="index-indexsee"></a> -<a name="index-indexseealso"></a> +<span id="index-indexseeword"></span> +<span id="index-indexseealsowords"></span> +<span id="index-seevariant"></span> +<span id="index-indexsee"></span> +<span id="index-indexseealso"></span> <p>The words output by Eplain for “see” and “see also” index entries are defined by <code>\indexseeword</code> and <code>\indexseealsowords</code> respectively. You can change the typeface used for these words by @@ -3368,18 +3282,18 @@ entirely different. If you do redefine them, make them take two parameters, the term being referenced and the <code>\idxmaxpagenum</code> (the latter should normally be ignored). See the example below. </p> -<a name="index-see-for-index-entries-1"></a> -<a name="index-see_002c-and-index-entries-1"></a> -<a name="index-cross_002dreferencing-index-entries-1"></a> -<a name="index-index-entries_002c-and-cross_002dreferencing-1"></a> -<a name="index-commas-in-cross_002dreferencing-index-entries"></a> +<span id="index-see-for-index-entries-1"></span> +<span id="index-see_002c-and-index-entries-1"></span> +<span id="index-cross_002dreferencing-index-entries-1"></span> +<span id="index-index-entries_002c-and-cross_002dreferencing-1"></span> +<span id="index-commas-in-cross_002dreferencing-index-entries"></span> <p>Unfortunately, it is impossible to reliably control the commas produced by MakeIndex in front of “see …” entries in the <samp>.ind</samp> file, either at MakeIndex level or at Eplain level. However, the -<a name="index-sed"></a> +<span id="index-sed"></span> <code>sed</code> script contained in <code>trimsee</code> -<a name="index-trimsee"></a> +<span id="index-trimsee"></span> distributed with Eplain in the <samp>util</samp> directory can be used to filter out these commas from the output of MakeIndex. For example, suppose you want the following style for your “see …” entries: @@ -3447,24 +3361,22 @@ output to the standard output. </p> <hr> -<a name="Justification"></a> -<div class="header"> +<span id="Justification"></span><div class="header"> <p> Next: <a href="#Tables" accesskey="n" rel="next">Tables</a>, Previous: <a href="#Indexing" accesskey="p" rel="prev">Indexing</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Justification-1"></a> -<h3 class="section">4.13 Justification</h3> +<span id="Justification-1"></span><h3 class="section">4.13 Justification</h3> -<a name="index-centering"></a> -<a name="index-left_002djustification"></a> -<a name="index-right_002djustification"></a> -<a name="index-justification"></a> +<span id="index-centering"></span> +<span id="index-left_002djustification"></span> +<span id="index-right_002djustification"></span> +<span id="index-justification"></span> <p>Eplain defines three commands to conveniently justify multiple lines of text: <code>\flushright</code>, <code>\flushleft</code>, and <code>\center</code>. -<a name="index-flushright"></a> -<a name="index-flushleft"></a> -<a name="index-center"></a> +<span id="index-flushright"></span> +<span id="index-flushleft"></span> +<span id="index-center"></span> </p> <p>They all work in the same way; let’s take <code>\center</code> as the example. To start centering lines, you say <code>\center</code> inside a @@ -3482,7 +3394,7 @@ until the end of the paragraph). </p> <p>The space between paragraphs is by default one blank line’s worth. You can adjust this space by assigning to <code>\blanklineskipamount</code>; -<a name="index-blanklineskipamount-in-justified-text"></a> +<span id="index-blanklineskipamount-in-justified-text"></span> this (vertical) glue is inserted after each blank line. </p> <p>Here is an example: @@ -3509,12 +3421,13 @@ a title macro might be defined: \def\endtitle{\endgroup} </pre></div> -<a name="index-_005craggedleft"></a> -<a name="index-_005craggedright"></a> -<a name="index-_005cleftskip"></a> -<a name="index-_005craggedleftskip"></a> -<a name="index-_005cspaceskip_002c-reset-by-_005cragged_002e_002e_002e"></a> -<a name="index-_005cxspaceskip_002c-reset-by-_005cragged_002e_002e_002e"></a> +<span id="index-raggedleft"></span> +<span id="index-raggedright"></span> +<span id="index-leftskip"></span> +<span id="index-raggedleftskip"></span> +<span id="index-spaceskip_002c-reset-by-_005cragged_002e_002e_002e"></span> +<span id="index-xspaceskip_002c-reset-by-_005cragged_002e_002e_002e"></span> +<span id="index-parfillskip_002c-reset-by-_005cragged_002e_002e_002e"></span> <p>In addition, Eplain defines <code>\raggedleft</code>, analogous to plain TeX’s <code>\raggedright</code>. This macro is also typically used inside a group, but unlike the environments above, TeX does normal @@ -3550,18 +3463,16 @@ be necessary. <hr> -<a name="Tables"></a> -<div class="header"> +<span id="Tables"></span><div class="header"> <p> Next: <a href="#Margins" accesskey="n" rel="next">Margins</a>, Previous: <a href="#Justification" accesskey="p" rel="prev">Justification</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Tables-1"></a> -<h3 class="section">4.14 Tables</h3> +<span id="Tables-1"></span><h3 class="section">4.14 Tables</h3> -<a name="index-tables"></a> -<a name="index-alignments"></a> +<span id="index-tables"></span> +<span id="index-alignments"></span> <p>Eplain provides a single command, <code>\makecolumns</code>, -<a name="index-makecolumns"></a> +<span id="index-makecolumns"></span> to make generating one particular kind of table easier. More ambitious LaTeX styles and macro packages tackle more difficult applications. The <code>autorows</code> feature of the Memoir package @@ -3588,7 +3499,7 @@ to these parameters, probably inside a group. <p>You can also control the penalty at a page break before the <code>\makecolumns</code> by setting the parameter <code>\abovecolumnspenalty</code>. -<a name="index-abovecolumnspenalty"></a> +<span id="index-abovecolumnspenalty"></span> Usually, the table is preceded by some explanatory text. You wouldn’t want a page break to occur after the text and before the table, so Eplain sets it to <code>10000</code>. But if the table produced by @@ -3622,15 +3533,13 @@ Text after the table. </p> <hr> -<a name="Margins"></a> -<div class="header"> +<span id="Margins"></span><div class="header"> <p> Next: <a href="#Multiple-columns" accesskey="n" rel="next">Multiple columns</a>, Previous: <a href="#Tables" accesskey="p" rel="prev">Tables</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Margins-1"></a> -<h3 class="section">4.15 Margins</h3> +<span id="Margins-1"></span><h3 class="section">4.15 Margins</h3> -<a name="index-margins_002c-changing"></a> +<span id="index-margins_002c-changing"></span> <p>TeX’s primitives describe the type area in terms of an offset from the upper left corner, and the width and height of the type. Some people prefer to think in terms of the <em>margins</em> at the top, bottom, @@ -3643,10 +3552,10 @@ provides commands to directly assign and increment the margins. <dt><code>\bottommargin = <var>dimen</var></code></dt> <dt><code>\leftmargin = <var>dimen</var></code></dt> <dt><code>\rightmargin = <var>dimen</var></code></dt> -<dd><a name="index-topmargin"></a> -<a name="index-bottommargin"></a> -<a name="index-leftmargin"></a> -<a name="index-rightmargin"></a> +<dd><span id="index-topmargin"></span> +<span id="index-bottommargin"></span> +<span id="index-leftmargin"></span> +<span id="index-rightmargin"></span> <p>These commands set the specified margin to the <var>dimen</var> given. The <code>=</code> and the spaces around it are optional. The control sequences here are not TeX registers, despite appearances; @@ -3658,10 +3567,10 @@ expect. <dt><code>\advancebottommargin by <var>dimen</var></code></dt> <dt><code>\advanceleftmargin by <var>dimen</var></code></dt> <dt><code>\advancerightmargin by <var>dimen</var></code></dt> -<dd><a name="index-advancetopmargin"></a> -<a name="index-advancebottommargin"></a> -<a name="index-advanceleftmargin"></a> -<a name="index-advancerightmargin"></a> +<dd><span id="index-advancetopmargin"></span> +<span id="index-advancebottommargin"></span> +<span id="index-advanceleftmargin"></span> +<span id="index-advancerightmargin"></span> <p>These commands change the specified margin by the <var>dimen</var> given. </p></dd> </dl> @@ -3671,7 +3580,7 @@ Eplain always changes the type area in response, not the other margins. For example, when TeX starts, the left and right margins are both one inch. If you then say <code>\leftmargin = 2in</code>, the right margin will remain at one inch, and the width of the lines (i.e., <code>\hsize</code>) -<a name="index-hsize"></a> +<span id="index-hsize"></span> will decrease by one inch. </p> <p>When you use any of these commands, Eplain computes the old value of @@ -3683,12 +3592,12 @@ page. It defines two new parameters for this: </p> <dl compact="compact"> <dt><code>\paperheight</code></dt> -<dd><a name="index-paperheight"></a> +<dd><span id="index-paperheight"></span> <p>The height of the output page; default is 11truein. </p> </dd> <dt><code>\paperwidth</code></dt> -<dd><a name="index-paperwidth"></a> +<dd><span id="index-paperwidth"></span> <p>The width of the output page; default is 8.5truein. </p></dd> </dl> @@ -3703,39 +3612,37 @@ reassign to these parameters, as in <hr> -<a name="Multiple-columns"></a> -<div class="header"> +<span id="Multiple-columns"></span><div class="header"> <p> Next: <a href="#Footnotes" accesskey="n" rel="next">Footnotes</a>, Previous: <a href="#Margins" accesskey="p" rel="prev">Margins</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Multiple-columns-1"></a> -<h3 class="section">4.16 Multiple columns</h3> +<span id="Multiple-columns-1"></span><h3 class="section">4.16 Multiple columns</h3> -<a name="index-double-column-output"></a> -<a name="index-triple-column-output"></a> -<a name="index-quadruple-column-output"></a> -<a name="index-multiple-column-output"></a> +<span id="index-double-column-output"></span> +<span id="index-triple-column-output"></span> +<span id="index-quadruple-column-output"></span> +<span id="index-multiple-column-output"></span> <p>Eplain provides for double, triple, and quadruple column output: say <code>\doublecolumns</code>, -<a name="index-doublecolumns"></a> +<span id="index-doublecolumns"></span> <code>\triplecolumns</code>, -<a name="index-triplecolumns"></a> +<span id="index-triplecolumns"></span> or <code>\quadcolumns</code>, -<a name="index-quadcolumns"></a> +<span id="index-quadcolumns"></span> and from that point on, the manuscript will be set in columns. To go back to one column, say <code>\singlecolumn</code>. -<a name="index-singlecolumn"></a> +<span id="index-singlecolumn"></span> </p> -<a name="index-column-balancing-with-_005csinglecolumn"></a> -<a name="index-balancing-of-columns-with-_005csinglecolumn"></a> +<span id="index-column-balancing-with-_005csinglecolumn"></span> +<span id="index-balancing-of-columns-with-_005csinglecolumn"></span> <p>You may need to invoke <code>\singlecolumn</code> to balance the columns on the last page of output. </p> -<a name="index-columnfill"></a> -<a name="index-column-eject"></a> -<a name="index-eject-in-multicolumns"></a> -<a name="index-pagetotal"></a> +<span id="index-columnfill"></span> +<span id="index-column-eject"></span> +<span id="index-eject-in-multicolumns"></span> +<span id="index-pagetotal"></span> <p>To do a “column eject”, i.e., move to the top of the next column, do <code>\columnfill</code>. This does not actually force an eject, however: it merely inserts an unbreakable space of (essentially) size @@ -3746,10 +3653,10 @@ columns). In most circumstances, a column break will be forced after this space (during the column splitting operation when the whole page is output). Bugs are easily possible, unfortunately. </p> -<a name="index-gutter"></a> +<span id="index-gutter"></span> <p>The columns are separated by the value of the dimen parameter <code>\gutter</code>. Default value is two picas. -<a name="index-gutterbox"></a> +<span id="index-gutterbox"></span> If you want to add vertical material between the columns, use <code>\gutterbox</code>. For example, to put a vertical line between columns, define @@ -3765,15 +3672,15 @@ contains the height of the column. </p> <p>All the <code>\…columns</code> macros insert the value of the glue parameter <code>\abovecolumnskip</code> -<a name="index-abovecolumnskip"></a> +<span id="index-abovecolumnskip"></span> before the multicolumn text, and the value of the glue parameter <code>\belowcolumnskip</code> -<a name="index-belowcolumnskip"></a> +<span id="index-belowcolumnskip"></span> after it. The default value for both of these parameters is <code>\bigskipamount</code>, i.e., one linespace in plain TeX. </p> <p>The macros take into account only the insertion classes -<a name="index-insertion-classes"></a> +<span id="index-insertion-classes"></span> defined by plain TeX; namely, footnotes and <code>\topinsert</code>s. If you have additional insertion classes, you will need to change the implementation. @@ -3783,18 +3690,16 @@ provision for column-width insertions. </p> <hr> -<a name="Footnotes"></a> -<div class="header"> +<span id="Footnotes"></span><div class="header"> <p> Next: <a href="#Fractions" accesskey="n" rel="next">Fractions</a>, Previous: <a href="#Multiple-columns" accesskey="p" rel="prev">Multiple columns</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Footnotes-1"></a> -<h3 class="section">4.17 Footnotes</h3> +<span id="Footnotes-1"></span><h3 class="section">4.17 Footnotes</h3> -<a name="index-footnotes_002c-numbered"></a> +<span id="index-footnotes_002c-numbered"></span> <p>The most common reference mark for footnotes is a raised number, incremented on each footnote. The <code>\numberedfootnote</code> -<a name="index-numberedfootnote"></a> +<span id="index-numberedfootnote"></span> macro provides this. It takes one argument, the footnote text. </p> <p>If your document uses only numbered footnotes, you could make typing @@ -3817,12 +3722,12 @@ could say <code>\footnotenumber=0</code>. an en space (it uses the <code>\textindent</code> macro). In Eplain, you can change this space by setting the dimension register <code>\footnotemarkseparation</code>. -<a name="index-footnotemarkseparation"></a> +<span id="index-footnotemarkseparation"></span> The default is still an en. </p> <p>You can produce a space between footenotes by setting the glue register <code>\interfootnoteskip</code>. -<a name="index-interfootnoteskip"></a> +<span id="index-interfootnoteskip"></span> The default is zero. </p> <p><code>\parskip</code> is also set to zero by default before the beginning of @@ -3830,7 +3735,7 @@ each footnote (but not for the text of the footnote). </p> <p>You can also control footnote formatting in a more general way: Eplain expands the token register <code>\everyfootnote</code> -<a name="index-everyfootnote"></a> +<span id="index-everyfootnote"></span> before a footnote is typeset, but after the default values for all the parameters have been established. For example, if you want your footnotes to be printed in seven-point type, indented by one inch, you @@ -3843,12 +3748,12 @@ could say: <p>By default, an <code>\hrule</code> is typeset above each group of footnotes on a page. You can control the dimensions of this rule by setting the dimension registers <code>\footnoterulewidth</code> -<a name="index-footnoterulewidth"></a> +<span id="index-footnoterulewidth"></span> and <code>\footnoteruleheight</code>. -<a name="index-footnoteruleheight"></a> +<span id="index-footnoteruleheight"></span> The space between the rule and the first footnote on the page is determined by the dimension register <code>\belowfootnoterulespace</code>. -<a name="index-belowfootnoterulespace"></a> +<span id="index-belowfootnoterulespace"></span> If you don’t want any rule at all, set <code>\footenoteruleheight=0pt</code>, and, most likely, <code>\belowfootnoterulespace=0pt</code>. The defaults for these parameters typeset the rule in the same way as plain TeX: the @@ -3863,17 +3768,15 @@ by the glue register <code>\skip\footins</code>. The default is a plain TeX <hr> -<a name="Fractions"></a> -<div class="header"> +<span id="Fractions"></span><div class="header"> <p> Next: <a href="#Paths" accesskey="n" rel="next">Paths</a>, Previous: <a href="#Footnotes" accesskey="p" rel="prev">Footnotes</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Fractions-1"></a> -<h3 class="section">4.18 Fractions</h3> +<span id="Fractions-1"></span><h3 class="section">4.18 Fractions</h3> -<a name="index-fractions"></a> +<span id="index-fractions"></span> <p>Exercise 11.6 of <cite>The TeXbook</cite> describes a macro <code>\frac</code> -<a name="index-frac"></a> +<span id="index-frac"></span> for setting fractions, but <code>\frac</code> never made it into plain TeX. So Eplain includes it. </p> @@ -3890,17 +3793,15 @@ delimited macro arguments.) </p> <hr> -<a name="Paths"></a> -<div class="header"> +<span id="Paths"></span><div class="header"> <p> Next: <a href="#Logos" accesskey="n" rel="next">Logos</a>, Previous: <a href="#Fractions" accesskey="p" rel="prev">Fractions</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Paths-1"></a> -<h3 class="section">4.19 Paths</h3> +<span id="Paths-1"></span><h3 class="section">4.19 Paths</h3> -<a name="index-pathnames_002c-breaking"></a> -<a name="index-filenames_002c-breaking"></a> -<a name="index-electronic-mail-addresses_002c-breaking"></a> +<span id="index-pathnames_002c-breaking"></span> +<span id="index-filenames_002c-breaking"></span> +<span id="index-electronic-mail-addresses_002c-breaking"></span> <p>When you typeset long pathnames, electronic mail addresses, or other such “computer” names, you would like TeX to break lines at @@ -3910,10 +3811,10 @@ break the email address <code>letters@alpha.gnu.ai.mit.edu</code> at the ‘<samp>@</samp>’ or a ‘<samp>.</samp>’, rather than at the hyphenation points in ‘<samp>letters</samp>’ and ‘<samp>alpha</samp>’. </p> -<a name="index-path"></a> +<span id="index-path"></span> <p>If you use the <code>\path</code> macro to typeset the names, TeX will find these good breakpoints. The argument to <code>\path</code> is delimited by -any character other other than ‘<samp>\</samp>’ which does not appear in the +any character other than ‘<samp>\</samp>’ which does not appear in the name itself. ‘<samp>|</samp>’ is often a good choice, as in: </p> @@ -3921,7 +3822,7 @@ name itself. <pre class="example">\path|letters@alpha.gnu.ai.mit.edu| </pre></div> -<a name="index-discretionaries"></a> +<span id="index-discretionaries"></span> <p>You can control the exact set of characters at which breakpoints will be allowed by calling <code>\discretionaries</code>. This takes the same sort of delimited argument; any character in the argument will henceforth be a valid @@ -3932,102 +3833,99 @@ punctuation characters: <pre class="example">\discretionaries |~!@$%^&*()_+`-=#{}[]:";'<>,.?\/| </pre></div> -<a name="index-specialpathdelimiters-_0028conditional_0029"></a> +<span id="index-specialpathdelimiters-_0028conditional_0029"></span> <p>If for some reason you absolutely must use <code>\</code> as the delimiter character for <code>\path</code>, you can set <code>\specialpathdelimiterstrue</code>. (Other delimiter characters can still be used.) TeX then processes the <code>\path</code> argument about four times more slowly. </p> -<a name="index-URL-for-path_002esty"></a> +<span id="index-URL-for-path_002esty"></span> <p>The <code>\path</code> macro comes from <samp>path.sty</samp>, written by Nelson -Beebe and Philip Taylor and available at -<a href="http://www.ctan.org/tex-archive/macros/latex/contrib/misc/path.sty">http://www.ctan.org/tex-archive/macros/latex/contrib/misc/path.sty</a>. +Beebe and Philip Taylor, and available at +<a href="https://ctan.org/pkg/path">https://ctan.org/pkg/path</a>. </p> <hr> -<a name="Logos"></a> -<div class="header"> +<span id="Logos"></span><div class="header"> <p> Next: <a href="#Boxes" accesskey="n" rel="next">Boxes</a>, Previous: <a href="#Paths" accesskey="p" rel="prev">Paths</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Logos-1"></a> -<h3 class="section">4.20 Logos</h3> +<span id="Logos-1"></span><h3 class="section">4.20 Logos</h3> -<a name="index-logos"></a> -<a name="index-names_002c-of-TeX-variants"></a> +<span id="index-logos"></span> +<span id="index-names_002c-of-TeX-variants"></span> <p>Eplain redefines the <code>\TeX</code> -<a name="index-TeX"></a> +<span id="index-TeX"></span> macro of plain TeX to end with <code>\null</code>, so that the proper spacing is produced when <code>\TeX</code> is used at the end of a sentence. The other …TeX macros listed here do this, also. </p> <p>Eplain defines <code>\AMSLaTeX</code>, -<a name="index-AMSLaTeX"></a> -<a name="index-AMSLaTeX-1"></a> +<span id="index-AMSLaTeX"></span> +<span id="index-AMSLaTeX-1"></span> <code>\AMSTeX</code>, -<a name="index-AMSTeX"></a> -<a name="index-AMSTeX-1"></a> +<span id="index-AMSTeX"></span> +<span id="index-AMSTeX-1"></span> <code>\BibTeX</code> -<a name="index-BibTeX-1"></a> -<a name="index-BibTeX-2"></a> +<span id="index-BibTeX-1"></span> +<span id="index-BibTeX-2"></span> <code>\eTeX</code>, -<a name="index-eTeX"></a> -<a name="index-eTeX-1"></a> +<span id="index-eTeX"></span> +<span id="index-eTeX-1"></span> <code>\ExTeX</code>, -<a name="index-ExTeX"></a> -<a name="index-ExTeX-1"></a> +<span id="index-ExTeX"></span> +<span id="index-ExTeX-1"></span> <code>\LAMSTeX</code>, -<a name="index-LAMSTeX"></a> -<a name="index-LAMSTeX-1"></a> +<span id="index-LAMSTeX"></span> +<span id="index-LAMSTeX-1"></span> <code>\LaTeX</code>, -<a name="index-LaTeX-2"></a> -<a name="index-LaTeX-4"></a> +<span id="index-LaTeX-2"></span> +<span id="index-LaTeX-4"></span> <code>\MF</code>, -<a name="index-Metafont"></a> -<a name="index-MF"></a> +<span id="index-Metafont"></span> +<span id="index-MF"></span> <code>\SLiTeX</code>, -<a name="index-SLiTeX"></a> -<a name="index-SLiTeX-1"></a> +<span id="index-SLiTeX"></span> +<span id="index-SLiTeX-1"></span> <code>\XeLaTeX</code>, -<a name="index-XeLaTeX"></a> -<a name="index-XeLaTeX-1"></a> +<span id="index-XeLaTeX"></span> +<span id="index-XeLaTeX-1"></span> and <code>\XeTeX</code> -<a name="index-XeTeX"></a> -<a name="index-XeTeX-1"></a> +<span id="index-XeTeX"></span> +<span id="index-XeTeX-1"></span> to produce their respective logos. (Sorry, the logos are not shown here.) Some spelling variants of these are also supported. </p> -<a name="index-URL-for-texnames_002esty"></a> +<span id="index-texnames_002esty"></span> <p>Most of these macros come from <samp>texnames.sty</samp>, compiled by Nelson Beebe and available at -<a href="http://www.ctan.org/tex-archive/info/biblio/texnames.sty">http://www.ctan.org/tex-archive/info/biblio/texnames.sty</a>. +<a href="http://mirror.ctan.org/tex-archive/info/biblio/texnames.sty">http://mirror.ctan.org/tex-archive/info/biblio/texnames.sty</a> +(part of the <code>biblio</code> package, <a href="https://ctan.org/pkg/biblio">https://ctan.org/pkg/biblio</a>). </p> <hr> -<a name="Boxes"></a> -<div class="header"> +<span id="Boxes"></span><div class="header"> <p> Next: <a href="#Checking-for-PDF-output" accesskey="n" rel="next">Checking for PDF output</a>, Previous: <a href="#Logos" accesskey="p" rel="prev">Logos</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Boxes-1"></a> -<h3 class="section">4.21 Boxes</h3> +<span id="Boxes-1"></span><h3 class="section">4.21 Boxes</h3> -<a name="index-black-boxes"></a> -<a name="index-rectangles"></a> +<span id="index-black-boxes"></span> +<span id="index-rectangles"></span> <p>The solid rectangle that Eplain uses as a marker in unordered lists (see <a href="#Lists">Lists</a>) is available by itself: just say <code>\blackbox</code>. -<a name="index-blackbox"></a> +<span id="index-blackbox"></span> </p> <p>You can create black boxes of arbitrary size with <code>\hrule</code> or <code>\vrule</code>. </p> -<a name="index-open-boxes"></a> -<a name="index-boxes_002c-open"></a> +<span id="index-open-boxes"></span> +<span id="index-boxes_002c-open"></span> <p>You can also get unfilled rectangles with <code>\makeblankbox</code>. -<a name="index-makeblankbox"></a> +<span id="index-makeblankbox"></span> This takes two explicit arguments: the height and depth of the rules that define the top and bottom of the rectangle. (The two arguments are added to get the width of the left and right borders, so that the @@ -4047,10 +3945,10 @@ putting next to numbers in, e.g., a table of contents. </pre></div> <p>Finally, you can put a box around arbitrary text with <code>\boxit</code>. -<a name="index-boxit"></a> +<span id="index-boxit"></span> This takes one argument, which must itself be a (TeX) box, and puts a printed box around it, separated by <code>\boxitspace</code> -<a name="index-boxitspace"></a> +<span id="index-boxitspace"></span> white space (3 points by default) on all four sides. For example: </p> <div class="example"> @@ -4068,25 +3966,23 @@ easily adjust the thicknesses of the box rules. See <a href="#Rules">Rules</a>. </p> <hr> -<a name="Checking-for-PDF-output"></a> -<div class="header"> +<span id="Checking-for-PDF-output"></span><div class="header"> <p> Next: <a href="#Loading-LaTeX-packages" accesskey="n" rel="next">Loading LaTeX packages</a>, Previous: <a href="#Boxes" accesskey="p" rel="prev">Boxes</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Checking-for-PDF-output-1"></a> -<h3 class="section">4.22 Checking for PDF output</h3> +<span id="Checking-for-PDF-output-1"></span><h3 class="section">4.22 Checking for PDF output</h3> -<a name="index-URL-for-pdfTeX"></a> -<a name="index-PDF-output"></a> -<a name="index-pdftex-1"></a> -<a name="index-_002epdf-files"></a> -<p>pdfTeX is a TeX variant that can output both <samp>.dvi</samp> and +<span id="index-URL-for-pdfTeX"></span> +<span id="index-PDF-output"></span> +<span id="index-pdftex-1"></span> +<span id="index-_002epdf-files"></span> +<p>pdfTeX is an extended TeX that can output both <samp>.dvi</samp> and <samp>.pdf</samp> (Adobe’s Portable Document Format) files (see -<a href="http://www.ctan.org/tex-archive/systems/pdftex">http://www.ctan.org/tex-archive/systems/pdftex</a>). You might -sometimes want to know whether the target format is <samp>.pdf</samp> or -<samp>.dvi</samp>. The <code>\ifpdf</code> -<a name="index-ifpdf"></a> -switch can be used to detect pdfTeX in <acronym>PDF</acronym> mode: +<a href="https://ctan.org/pkg/pdftex">https://ctan.org/pkg/pdftex</a>). You might sometimes want to know +whether the target format is <samp>.pdf</samp> or <samp>.dvi</samp>. The +<code>\ifpdf</code> +<span id="index-ifpdf"></span> +switch can be used to detect pdfTeX in PDF mode: </p> <div class="example"> <pre class="example">\ifpdf @@ -4099,31 +3995,29 @@ switch can be used to detect pdfTeX in <acronym>PDF</acronym> mode: <p>Keep in mind that <code>\ifpdf</code> is set based on the value of the <code>\pdfoutput</code> -<a name="index-pdfoutput"></a> +<span id="index-pdfoutput"></span> primitive of pdfTeX at the time Eplain is loaded. If you change the value of <code>\pdfoutput</code> after you load Eplain, <code>\ifpdf</code> will not reflect the change. </p> -<a name="index-URL-for-ifpdf_002esty"></a> -<a name="index-Oberdiek_002c-Heiko"></a> +<span id="index-ifpdf_002esty"></span> +<span id="index-Oberdiek_002c-Heiko"></span> <p>Eplain defines <code>\ifpdf</code> by incorporating Heiko Oberdiek’s <samp>ifpdf.sty</samp>, which is available at -<a href="http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/ifpdf.sty">http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/ifpdf.sty</a>. +<a href="https://ctan.org/pkg/ifpdf">https://ctan.org/pkg/ifpdf</a>. </p> <hr> -<a name="Loading-LaTeX-packages"></a> -<div class="header"> +<span id="Loading-LaTeX-packages"></span><div class="header"> <p> Previous: <a href="#Checking-for-PDF-output" accesskey="p" rel="prev">Checking for PDF output</a>, Up: <a href="#User-definitions" accesskey="u" rel="up">User definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Loading-LaTeX-packages-1"></a> -<h3 class="section">4.23 Loading LaTeX packages</h3> +<span id="Loading-LaTeX-packages-1"></span><h3 class="section">4.23 Loading LaTeX packages</h3> -<a name="index-LaTeX-packages"></a> -<a name="index-packages_002c-LaTeX"></a> -<a name="index-_002esty-files"></a> -<a name="index-_002ecls-files"></a> +<span id="index-LaTeX-packages"></span> +<span id="index-packages_002c-LaTeX"></span> +<span id="index-_002esty-files"></span> +<span id="index-_002ecls-files"></span> <p>Eplain provides a limited support for loading LaTeX packages (<samp>.sty</samp> files—not <samp>.cls</samp>). This will mostly work for @@ -4133,41 +4027,36 @@ packages which are known to work are listed below (see <a href="#Packages-known- the list, please report it to the Eplain mailing list (see <a href="#Introduction">Introduction</a>). </p> -<a name="index-graphics-collection_002c-LaTeX"></a> -<a name="index-LaTeX-graphics-collection"></a> -<a name="index-miniltx_002etex"></a> -<a name="index-Carlisle_002c-David"></a> -<a name="index-Rahtz_002c-Sebastian"></a> +<span id="index-graphics-collection_002c-LaTeX"></span> +<span id="index-LaTeX-graphics-collection"></span> +<span id="index-miniltx_002etex"></span> +<span id="index-Carlisle_002c-David"></span> +<span id="index-Rahtz_002c-Sebastian"></span> <p>To set up a pseudo-LaTeX environment for the packages, Eplain uses -<samp>miniltx.tex</samp> -(<a href="http://www.ctan.org/tex-archive/macros/plain/graphics/miniltx.tex">http://www.ctan.org/tex-archive/macros/plain/graphics/miniltx.tex</a>) -from the LaTeX graphics collection, written by David Carlisle and -Sebastian Rahtz (the collection is available at -<a href="http://www.ctan.org/tex-archive/macros/latex/required/graphics">http://www.ctan.org/tex-archive/macros/latex/required/graphics</a>). -Eplain extends <samp>miniltx.tex</samp> to provide some additional features, -e.g., support for package options. +<samp>miniltx.tex</samp> (<a href="https://ctan.org/pkg/miniltx">https://ctan.org/pkg/miniltx</a>) from the +LaTeX graphics collection, written by David Carlisle and Sebastian +Rahtz. Eplain extends <samp>miniltx.tex</samp> to provide (primarily) +support for package options. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#The-_005cusepackage-command" accesskey="1">The \usepackage command</a>:</td><td> </td><td align="left" valign="top">Command to load packages. +<tr><td align="left" valign="top">• <a href="#The-_005cusepackage-command" accesskey="1">The \usepackage command</a></td><td> </td><td align="left" valign="top">Command to load packages. </td></tr> -<tr><td align="left" valign="top">• <a href="#Environment-for-loading-packages" accesskey="2">Environment for loading packages</a>:</td><td> </td><td align="left" valign="top">Environment for the \usepackage commands. +<tr><td align="left" valign="top">• <a href="#Environment-for-loading-packages" accesskey="2">Environment for loading packages</a></td><td> </td><td align="left" valign="top">Environment for the \usepackage commands. </td></tr> -<tr><td align="left" valign="top">• <a href="#Packages-known-to-work" accesskey="3">Packages known to work</a>:</td><td> </td><td align="left" valign="top">Packages supported with Eplain. +<tr><td align="left" valign="top">• <a href="#Packages-known-to-work" accesskey="3">Packages known to work</a></td><td> </td><td align="left" valign="top">Packages supported with Eplain. </td></tr> -<tr><td align="left" valign="top">• <a href="#Packages-known-not-to-work" accesskey="4">Packages known not to work</a>:</td><td> </td><td align="left" valign="top">Packages known not to work with Eplain. +<tr><td align="left" valign="top">• <a href="#Packages-known-not-to-work" accesskey="4">Packages known not to work</a></td><td> </td><td align="left" valign="top">Packages known not to work with Eplain. </td></tr> </table> <hr> -<a name="The-_005cusepackage-command"></a> -<div class="header"> +<span id="The-_005cusepackage-command"></span><div class="header"> <p> Next: <a href="#Environment-for-loading-packages" accesskey="n" rel="next">Environment for loading packages</a>, Up: <a href="#Loading-LaTeX-packages" accesskey="u" rel="up">Loading LaTeX packages</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="The-_005cusepackage-command-1"></a> -<h4 class="subsection">4.23.1 The <code>\usepackage</code> command</h4> +<span id="The-_005cusepackage-command-1"></span><h4 class="subsection">4.23.1 The <code>\usepackage</code> command</h4> -<a name="index-usepackage"></a> +<span id="index-usepackage"></span> <p><code>\usepackage</code> loads a LaTeX package. Its syntax is similar to that of LaTeX’s <code>\usepackage</code> command: </p> @@ -4197,18 +4086,16 @@ packages are dated 2005/08/29 or newer. </p> <hr> -<a name="Environment-for-loading-packages"></a> -<div class="header"> +<span id="Environment-for-loading-packages"></span><div class="header"> <p> Next: <a href="#Packages-known-to-work" accesskey="n" rel="next">Packages known to work</a>, Previous: <a href="#The-_005cusepackage-command" accesskey="p" rel="prev">The \usepackage command</a>, Up: <a href="#Loading-LaTeX-packages" accesskey="u" rel="up">Loading LaTeX packages</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Environment-for-loading-packages-1"></a> -<h4 class="subsection">4.23.2 Environment for loading packages</h4> +<span id="Environment-for-loading-packages-1"></span><h4 class="subsection">4.23.2 Environment for loading packages</h4> -<a name="index-loading-packages_002c-environment-for"></a> +<span id="index-loading-packages_002c-environment-for"></span> -<a name="index-beginpackages"></a> -<a name="index-endpackages"></a> +<span id="index-beginpackages"></span> +<span id="index-endpackages"></span> <p>Some packages request that certain commands are executed after all packages have been loaded. In LaTeX, this means that the commands are executed at the beginning of the document, after the so-called @@ -4229,10 +4116,10 @@ commands at the end of the <code>\beginpackages...\endpackages</code> block. <p>For the same reason, it is advisable to specify only one such block per document, just like there is only one preamble in LaTeX. </p> -<a name="index-input"></a> -<a name="index-eplaininput"></a> -<a name="index-LaTeX-packages_002c-restoring-_005cinput"></a> -<a name="index-restoring-_005cinput_002c-LaTeX-packages"></a> +<span id="index-input"></span> +<span id="index-eplaininput"></span> +<span id="index-LaTeX-packages_002c-restoring-_005cinput"></span> +<span id="index-restoring-_005cinput_002c-LaTeX-packages"></span> <p>Both the <samp>miniltx.tex</samp> file used by Eplain and some LaTeX packages redefine TeX’s primitive <code>\input</code> to be a macro. Under plain TeX, users probably expect the primitive @@ -4246,20 +4133,20 @@ package you’ve loaded directly) have redefined it before calling package-provided <code>\input</code>, Eplain saves it as <code>\packageinput</code>. </p> -<a name="index-resetatcatcode"></a> -<a name="index-catcode-of-_0040"></a> +<span id="index-resetatcatcode"></span> +<span id="index-catcode-of-_0040"></span> <p>Along the same lines, Eplain restores the catcode of ‘<samp>@</samp>’ at <code>\endpackages</code> to whatever it was before (using <code>\resetatcatcode</code>, as defined by <samp>miniltx.tex</samp>). This is needed because <samp>miniltx.tex</samp>, read by <code>\beginpackages</code>, does not restore the catcode of ‘<samp>@</samp>’, but leaves it as 11 (letter). </p> -<a name="index-hanging-on-_005cinput"></a> -<a name="index-error-on-_005cinput"></a> +<span id="index-hanging-on-_005cinput"></span> +<span id="index-error-on-_005cinput"></span> <p>Sometimes you may encounter packages which make conflicting redefinitions of <code>\input</code>. Common symptoms are TeX spewing incomprehensible error messages or hanging in a loop at a call to -<code>\input</code>. This sometimes cna be cured by restoring <code>\input</code> +<code>\input</code>. This sometimes can be cured by restoring <code>\input</code> to <code>\eplaininput</code> before loading each package. For example: </p> <div class="example"> @@ -4272,16 +4159,14 @@ to <code>\eplaininput</code> before loading each package. For example: <hr> -<a name="Packages-known-to-work"></a> -<div class="header"> +<span id="Packages-known-to-work"></span><div class="header"> <p> Next: <a href="#Packages-known-not-to-work" accesskey="n" rel="next">Packages known not to work</a>, Previous: <a href="#Environment-for-loading-packages" accesskey="p" rel="prev">Environment for loading packages</a>, Up: <a href="#Loading-LaTeX-packages" accesskey="u" rel="up">Loading LaTeX packages</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Packages-known-to-work-1"></a> -<h4 class="subsection">4.23.3 Packages known to work</h4> +<span id="Packages-known-to-work-1"></span><h4 class="subsection">4.23.3 Packages known to work</h4> -<a name="index-LaTeX-packages-1"></a> -<a name="index-packages_002c-LaTeX-1"></a> +<span id="index-LaTeX-packages-1"></span> +<span id="index-packages_002c-LaTeX-1"></span> <p>The following table lists packages that had been tested and are known to work with Eplain, and locations where you can find manuals for these packages. Some of the short descriptions of the packages were @@ -4289,12 +4174,12 @@ taken from the documentation for those packages. </p> <dl compact="compact"> <dt>autopict (‘<samp>2001/06/04 v1.1j Picture mode autoload file</samp>’)</dt> -<dd><a name="index-autopict_002esty"></a> -<p><a href="http://tug.org/eplain/misc/ltpictur.pdf">http://tug.org/eplain/misc/ltpictur.pdf</a> +<dd><span id="index-autopict_002esty"></span> +<p><a href="https://tug.org/eplain/misc/ltpictur.pdf">https://tug.org/eplain/misc/ltpictur.pdf</a> </p> -<a name="index-picture-mode"></a> -<a name="index-begin_007bpicture_007d"></a> -<a name="index-end_007bpicture_007d"></a> +<span id="index-picture-mode"></span> +<span id="index-begin_007bpicture_007d"></span> +<span id="index-end_007bpicture_007d"></span> <p>This is the LaTeX “picture mode”, started by <code>\begin{picture}</code> and ended by <code>\end{picture}</code> (in LaTeX, this package is not explicitly loaded since it is part of @@ -4303,32 +4188,32 @@ inside your document without resorting to any external tools. </p> </dd> <dt>color (‘<samp>1999/02/16 v1.0i Standard LaTeX Color (DPC)</samp>’)</dt> -<dd><a name="index-color_002esty"></a> +<dd><span id="index-color_002esty"></span> </dd> <dt>graphics (‘<samp>2001/07/07 v1.0n Standard LaTeX Graphics (DPC,SPQR)</samp>’)</dt> -<dd><a name="index-graphics_002esty"></a> +<dd><span id="index-graphics_002esty"></span> </dd> <dt>graphicx (‘<samp>1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)</samp>’)</dt> -<dd><a name="index-graphicx_002esty"></a> -<p><a href="http://www.ctan.org/pkg/graphics">http://www.ctan.org/pkg/graphics</a> -</p> -<a name="index-graphics-collection_002c-LaTeX-1"></a> -<a name="index-LaTeX-graphics-collection-1"></a> -<a name="index-color"></a> -<a name="index-rotation"></a> -<a name="index-scaling"></a> +<dd><span id="index-graphicx_002esty"></span> +<p><a href="https://ctan.org/pkg/graphics">https://ctan.org/pkg/graphics</a> +</p> +<span id="index-graphics-collection_002c-LaTeX-1"></span> +<span id="index-LaTeX-graphics-collection-1"></span> +<span id="index-color"></span> +<span id="index-rotation"></span> +<span id="index-scaling"></span> <p>These packages are from the LaTeX graphics collection. (The independent <samp>xcolor</samp> package does not work with Eplain.) They provide commands for changing text/page colors, text rotation and scaling, and much more. </p> -<a name="index-color_002c-problems-with-pdfTeX"></a> -<a name="index-graphics_002c-problems-with-pdfTeX"></a> -<a name="index-pdfTeX_002c-problems-using-color-and-graphics"></a> -<a name="index-pdfTeX_002c-problems-with-supp_002dmis_002etex"></a> -<a name="index-ConTeXt"></a> -<a name="index-supp_002dmis_002etex_002c-problems-with-pdfTeX"></a> -<a name="index-supp_002dpdf_002etex"></a> +<span id="index-color_002c-problems-with-pdfTeX"></span> +<span id="index-graphics_002c-problems-with-pdfTeX"></span> +<span id="index-pdfTeX_002c-problems-using-color-and-graphics"></span> +<span id="index-pdfTeX_002c-problems-with-supp_002dmis_002etex"></span> +<span id="index-ConTeXt"></span> +<span id="index-supp_002dmis_002etex_002c-problems-with-pdfTeX"></span> +<span id="index-supp_002dpdf_002etex"></span> <p><strong>Warning 1:</strong> If you encounter problems loading one of these packages under pdfTeX (when pdfTeX reads <samp>supp-mis.tex</samp>), the cause may be an outdated @@ -4337,7 +4222,7 @@ TeX) installed on your system. The problem was fixed in <samp>supp-mis.tex</samp> version 2004.10.26. You can obtain up-to-date versions of <samp>supp-mis.tex</samp> and the accompanying <samp>supp-pdf.tex</samp> from -<a href="http://www.ctan.org/tex-archive/macros/pdftex/graphics">http://www.ctan.org/tex-archive/macros/pdftex/graphics</a>. +<a href="http://mirror.ctan.org/tex-archive/macros/pdftex/graphics">http://mirror.ctan.org/tex-archive/macros/pdftex/graphics</a>. To convince TeX to use the new files, you have the following options: </p> @@ -4348,7 +4233,7 @@ options: </li><li> install the new <samp>supp-mis.tex</samp> and <samp>supp-pdf.tex</samp> files in the relevant subdirectory of your local <samp>texmf</samp> tree (for info on -TeX directory structure see +TeX directory structure see <a href="https://tug.org/tds/">https://tug.org/tds/</a> and <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds</a>); </li><li> upgrade your ConTeXt installation. @@ -4367,7 +4252,7 @@ the system <samp>texmf</samp> tree.<br> <strong>End of warning 1.</strong> pdfTeX, the cause may be an outdated pdfTeX color and graphics driver <samp>pdftex.def</samp>. The problem was fixed in <samp>pdftex.def</samp> version 0.03p. You can obtain an up-to-date version from -<a href="http://www.ctan.org/pkg/pdftex-def">http://www.ctan.org/pkg/pdftex-def</a>.<br> +<a href="http://ctan.org/pkg/pdftex-def">http://ctan.org/pkg/pdftex-def</a>.<br> <strong>End of warning 2.</strong> </p> <p>The <code>\fcolorbox</code> macro provided by the <code>color</code> package @@ -4388,44 +4273,44 @@ Jarausch: \makeatother </pre></div> -<a name="index-omitting-typesetting-of-graphics"></a> -<a name="index-graphics_002c-omitting-typesetting-of"></a> +<span id="index-omitting-typesetting-of-graphics"></span> +<span id="index-graphics_002c-omitting-typesetting-of"></span> <p>The <samp>graphics</samp>/<samp>graphicx</samp> packages have the option -<a name="index-draft_002c-option-for-graphics_002esty"></a> +<span id="index-draft_002c-option-for-graphics_002esty"></span> <code>draft</code> which instructs <code>\includegraphics</code> not to include the graphics but instead typeset a box with the dimensions of the graphics and the name of the graphics file in typewriter type at the center of the box. These packages expect the LaTeX-provided command -<a name="index-ttfamily"></a> +<span id="index-ttfamily"></span> <code>\ttfamily</code> to switch to typewriter type. This command is not defined by <samp>miniltx.tex</samp>, therefore Eplain defines it and makes it equivalent to plain TeX’s -<a name="index-tt"></a> +<span id="index-tt"></span> <code>\tt</code>. </p> <p>See <a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a>, for the demonstration of text rotation and graphics inclusion using the <samp>graphicx</samp> package, and using the <samp>color</samp> package to colorize hypertext links. </p> -<a name="index-Hoppner_002c-Klaus"></a> +<span id="index-Hoppner_002c-Klaus"></span> <p>Klaus Höppner has written a nice introduction to the LaTeX graphics packages and different graphics formats. You can download it from </p><div class="display"> -<pre class="display"><a href="http://www.tug.org/pracjourn/2005-3/hoeppner">http://www.tug.org/pracjourn/2005-3/hoeppner</a> +<pre class="display"><a href="https://tug.org/pracjourn/2005-3/hoeppner">https://tug.org/pracjourn/2005-3/hoeppner</a> </pre></div> </dd> <dt>epstopdf (‘<samp>2009/07/16 v2.2 Conversion with epstopdf on the fly (HO)</samp>’)</dt> -<dd><a name="index-epstopdf_002esty"></a> -<p><a href="http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek">http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek</a> -</p> -<a name="index-Encapsulated-PostScript"></a> -<a name="index-EPS"></a> -<a name="index-_002eeps-files"></a> -<a name="index-Portable-Document-Format"></a> -<a name="index-PDF"></a> -<a name="index-_002epdf-files-1"></a> -<a name="index-epstopdf"></a> +<dd><span id="index-epstopdf_002esty"></span> +<p><a href="https://ctan.org/pkg/epstopdf-pkg">https://ctan.org/pkg/epstopdf-pkg</a> +</p> +<span id="index-Encapsulated-PostScript"></span> +<span id="index-EPS"></span> +<span id="index-_002eeps-files"></span> +<span id="index-Portable-Document-Format"></span> +<span id="index-PDF"></span> +<span id="index-_002epdf-files-1"></span> +<span id="index-epstopdf"></span> <p>This package does on-the-fly conversion of Encapsulated PostScript (<acronym>EPS</acronym>) graphics into Portable Document Format (<acronym>PDF</acronym>) graphics for inclusion with the <code>\includegraphics</code> command from @@ -4434,12 +4319,12 @@ to explicitly call the <samp>epstopdf</samp> script. </p> </dd> <dt>psfrag (‘<samp>1998/04/11 v3.04 PSfrag (MCG)</samp>’)</dt> -<dd><a name="index-psfrag_002esty"></a> -<p><a href="http://www.ctan.org/tex-archive/macros/latex/contrib/psfrag/pfgguide.pdf">http://www.ctan.org/tex-archive/macros/latex/contrib/psfrag/pfgguide.pdf</a> +<dd><span id="index-psfrag_002esty"></span> +<p><a href="https://ctan.org/pkg/psfrag">https://ctan.org/pkg/psfrag</a> </p> -<a name="index-Encapsulated-PostScript-1"></a> -<a name="index-EPS-1"></a> -<a name="index-_002eeps-files-1"></a> +<span id="index-Encapsulated-PostScript-1"></span> +<span id="index-EPS-1"></span> +<span id="index-_002eeps-files-1"></span> <p>PSfrag allows the user to precisely overlay Encapsulated PostScript (<acronym>EPS</acronym>) files with arbitrary (La)TeX constructions. In order to accomplish this, the user places a simple text “tag” in the graphics @@ -4450,15 +4335,15 @@ the figure, and replace it with a properly sized, aligned, and rotated </p> </dd> <dt>soul (‘<samp>2003/11/17 v2.4 letterspacing/underlining (mf)</samp>’)</dt> -<dd><a name="index-soul_002esty"></a> -<p><a href="http://www.ctan.org/tex-archive/macros/latex/contrib/soul">http://www.ctan.org/tex-archive/macros/latex/contrib/soul</a> -</p> -<a name="index-letterspacing"></a> -<a name="index-spacing-out"></a> -<a name="index-underlining"></a> -<a name="index-striking-out"></a> -<a name="index-overstriking"></a> -<a name="index-highlighting"></a> +<dd><span id="index-soul_002esty"></span> +<p><a href="https://ctan.org/pkg/soul">https://ctan.org/pkg/soul</a> +</p> +<span id="index-letterspacing"></span> +<span id="index-spacing-out"></span> +<span id="index-underlining"></span> +<span id="index-striking-out"></span> +<span id="index-overstriking"></span> +<span id="index-highlighting"></span> <p>This package provides hyphenatable letterspacing (spacing out), underlining, and some derivatives. The package is optimized for LaTeX, but works with plain TeX—you don’t actually need to @@ -4468,12 +4353,12 @@ soul.sty</code>. If you intend to use the highlighting macros of </p> </dd> <dt>url (‘<samp>2005/06/27 ver 3.2 Verb mode for urls, etc.</samp>’)</dt> -<dd><a name="index-url_002esty"></a> -<p><a href="http://www.ctan.org/tex-archive/macros/latex/contrib/misc/url.sty">http://www.ctan.org/tex-archive/macros/latex/contrib/misc/url.sty</a> +<dd><span id="index-url_002esty"></span> +<p><a href="https://ctan.org/pkg/url">https://ctan.org/pkg/url</a> </p> -<a name="index-pathnames_002c-breaking-1"></a> -<a name="index-filenames_002c-breaking-1"></a> -<a name="index-electronic-mail-addresses_002c-breaking-1"></a> +<span id="index-pathnames_002c-breaking-1"></span> +<span id="index-filenames_002c-breaking-1"></span> +<span id="index-electronic-mail-addresses_002c-breaking-1"></span> <p>This package provides a form of <code>\verbatim</code> that allows line breaks at certain characters or combinations of characters, accepts reconfiguration, and can usually be used in the argument to @@ -4490,22 +4375,20 @@ have problems in plain TeX. <hr> -<a name="Packages-known-not-to-work"></a> -<div class="header"> +<span id="Packages-known-not-to-work"></span><div class="header"> <p> Previous: <a href="#Packages-known-to-work" accesskey="p" rel="prev">Packages known to work</a>, Up: <a href="#Loading-LaTeX-packages" accesskey="u" rel="up">Loading LaTeX packages</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Packages-known-not-to-work-1"></a> -<h4 class="subsection">4.23.4 Packages known not to work</h4> +<span id="Packages-known-not-to-work-1"></span><h4 class="subsection">4.23.4 Packages known not to work</h4> -<a name="index-LaTeX-packages-2"></a> -<a name="index-packages_002c-LaTeX-2"></a> +<span id="index-LaTeX-packages-2"></span> +<span id="index-packages_002c-LaTeX-2"></span> <p>The following packages are known not to work with Eplain: </p> <dl compact="compact"> <dt>hyperref</dt> -<dd><a name="index-hyperref_002esty"></a> -<p><a href="http://www.ctan.org/pkg/hyperref">http://www.ctan.org/pkg/hyperref</a> +<dd><span id="index-hyperref_002esty"></span> +<p><a href="https://ctan.org/pkg/hyperref">https://ctan.org/pkg/hyperref</a> </p> <p>This package depends heavily on LaTeX, so that it is essentially unusable outside of LaTeX. Eplain provides its own macros for @@ -4513,32 +4396,30 @@ creating hyperlinks; see <a href="#Hyperlinks">Hyperlinks</a>. </p> </dd> <dt>microtype (‘<samp>2013/05/23 v2.51 Micro-typographical refinements (RS)</samp>’)</dt> -<dd><a name="index-microtype_002esty"></a> -<p><a href="http://www.ctan.org/pkg/microtype">http://www.ctan.org/pkg/microtype</a> +<dd><span id="index-microtype_002esty"></span> +<p><a href="https://ctan.org/pkg/microtype">https://ctan.org/pkg/microtype</a> </p> </dd> <dt>pict2e (‘<samp>2005/07/15 v0.2r Improved picture commands (HjG,RN)</samp>’)</dt> -<dd><a name="index-pict2e_002esty"></a> -<p><a href="http://www.ctan.org/pkg/pict2e">http://www.ctan.org/pkg/pict2e</a> +<dd><span id="index-pict2e_002esty"></span> +<p><a href="https://ctan.org/pkg/pict2e">https://ctan.org/pkg/pict2e</a> </p> </dd> <dt>xcolor (‘<samp>2005/06/06 v2.03 LaTeX color extensions (UK)</samp>’)</dt> -<dd><a name="index-xcolor_002esty"></a> -<p><a href="http://www.ctan.org/pkg/xcolor">http://www.ctan.org/pkg/xcolor</a> +<dd><span id="index-xcolor_002esty"></span> +<p><a href="https://ctan.org/pkg/xcolor">https://ctan.org/pkg/xcolor</a> </p></dd> </dl> <hr> -<a name="Hyperlinks"></a> -<div class="header"> +<span id="Hyperlinks"></span><div class="header"> <p> Next: <a href="#Arrow-theoretic-diagrams" accesskey="n" rel="next">Arrow theoretic diagrams</a>, Previous: <a href="#User-definitions" accesskey="p" rel="prev">User definitions</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Hyperlinks-1"></a> -<h2 class="chapter">5 Hyperlinks</h2> +<span id="Hyperlinks-1"></span><h2 class="chapter">5 Hyperlinks</h2> -<a name="index-links_002c-hypertext"></a> -<a name="index-hypertext-links"></a> +<span id="index-links_002c-hypertext"></span> +<span id="index-hypertext-links"></span> <p>This chapter describes the support which Eplain provides for hypertext links (<em>hyperlinks</em> for short). Hyperlinks can be created implicitly by the cross-reference, indexing and other macros in @@ -4546,44 +4427,44 @@ Eplain. Macros for constructing explicit hyperlinks are also provided. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Introduction-to-hyperlinks" accesskey="1">Introduction to hyperlinks</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Introduction-to-hyperlinks" accesskey="1">Introduction to hyperlinks</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Explicit-hyperlinks" accesskey="2">Explicit hyperlinks</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Explicit-hyperlinks" accesskey="2">Explicit hyperlinks</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Implicit-hyperlinks" accesskey="3">Implicit hyperlinks</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Implicit-hyperlinks" accesskey="3">Implicit hyperlinks</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-drivers" accesskey="4">Hyperlink drivers</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Hyperlink-drivers" accesskey="4">Hyperlink drivers</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Setting-hyperlink-types-and-options" accesskey="5">Setting hyperlink types and options</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Setting-hyperlink-types-and-options" accesskey="5">Setting hyperlink types and options</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Turning-hyperlinks-on_002foff" accesskey="6">Turning hyperlinks on/off</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Turning-hyperlinks-on_002foff" accesskey="6">Turning hyperlinks on/off</a></td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Making-PDF-outlines" accesskey="7">Making PDF outlines</a></td><td> </td><td align="left" valign="top">Also known as bookmarks. </td></tr> </table> <hr> -<a name="Introduction-to-hyperlinks"></a> -<div class="header"> +<span id="Introduction-to-hyperlinks"></span><div class="header"> <p> Next: <a href="#Explicit-hyperlinks" accesskey="n" rel="next">Explicit hyperlinks</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Introduction-to-hyperlinks-1"></a> -<h3 class="section">5.1 Introduction to hyperlinks</h3> +<span id="Introduction-to-hyperlinks-1"></span><h3 class="section">5.1 Introduction to hyperlinks</h3> -<a name="index-hyperlink-drivers"></a> -<a name="index-drivers_002c-hyperlink"></a> +<span id="index-hyperlink-drivers"></span> +<span id="index-drivers_002c-hyperlink"></span> <p>The original TeX engine has no built-in support for hyperlinks (a.k.a. hypertext links). Many of the present-day file formats with hyperlinking capabilities did not even exist at the time TeX was written. However, TeX’s -<a name="index-special"></a> +<span id="index-special"></span> <code>\special</code> primitive can be used to instruct TeX to write special directives into its <samp>.dvi</samp> output file. These directives are not interpreted by TeX in any way; they are intended for programs which process the <samp>.dvi</samp> files produced by TeX, be it printing or converting to other formats, such as -<a name="index-_002eps-files"></a> -<a name="index-_002epdf-files-2"></a> +<span id="index-_002eps-files"></span> +<span id="index-_002epdf-files-2"></span> <samp>.ps</samp> or <samp>.pdf</samp>. </p> <p>Another approach is to extend the original TeX engine with the @@ -4608,9 +4489,9 @@ provides three drivers: <code>hypertex</code> (implementation of the HyperTeX standard, see <a href="http://arxiv.org/hypertex">http://arxiv.org/hypertex</a>), and <code>pdftex</code> and <code>dvipdfm</code> (named after the programs which process the hyperlink commands, -<a name="index-pdftex-2"></a> +<span id="index-pdftex-2"></span> pdfTeX and -<a name="index-dvipdfm"></a> +<span id="index-dvipdfm"></span> dvipdfm). Therefore, Eplain can only produce HyperTeX commands and hyperlink commands for one of these two programs—except that the extended <code>dvipdfmx</code> program can be used as well as the original @@ -4618,7 +4499,7 @@ extended <code>dvipdfmx</code> program can be used as well as the original </p> <p>To tell Eplain which <samp>.dvi</samp> processor or extended TeX engine you are using, use the command -<a name="index-enablehyperlinks"></a> +<span id="index-enablehyperlinks"></span> <code>\enablehyperlinks</code>. </p> <p>For example: @@ -4632,13 +4513,13 @@ driver to use, as follows: if it detects pdfTeX in <acronym>PDF</acronym> mode, it loads the <code>pdftex</code> driver. If it does not detect pdfTeX in <acronym>PDF</acronym> mode, the <code>hypertex</code> driver is loaded. The detection is based on the -<a name="index-ifpdf-1"></a> +<span id="index-ifpdf-1"></span> <code>\ifpdf</code> switch (see <a href="#Checking-for-PDF-output">Checking for PDF output</a>). </p> <p>If necessary, you can explicitly specify the driver name: </p> <div class="example"> -<pre class="example">\enablehyperlinks[pdftex] +<pre class="example">\enablehyperlinks[dvipdfm] </pre></div> <p>will start producing hyperlinks under the assumption that @@ -4651,8 +4532,7 @@ For another, you may be using a program other than pdfTeX or <code>dvipdfm</code>, which does not understand their hyperlink commands or the HyperTeX commands. </p> -<a name="Concepts-and-Terminology"></a> -<h4 class="subheading">Concepts and Terminology</h4> +<span id="Concepts-and-Terminology"></span><h4 class="subheading">Concepts and Terminology</h4> <p>In general, hyperlinks work as follows. You mark some place in your document as a hyperlink destination, associating a <em>hyperlink @@ -4672,9 +4552,9 @@ destinations jointly, in which case we will use the term <em>destinations</em> in cases when we need to refer specifically to links or destinations. </p> -<a name="index-link-type"></a> -<a name="index-destination-type"></a> -<a name="index-type_002c-link-and-destination"></a> +<span id="index-link-type"></span> +<span id="index-destination-type"></span> +<span id="index-type_002c-link-and-destination"></span> <p>Hyperlink drivers provide several kinds of links and destinations. We will refer to them as <em>link types</em> and <em>destination types</em>. </p> @@ -4694,9 +4574,9 @@ also create a link pointing to another local document (by using the ‘<samp>filename</samp>’ link type) or to a <acronym>URL</acronym> (by using the ‘<samp>url</samp>’ link type). </p> -<a name="index-link-options"></a> -<a name="index-destination-options"></a> -<a name="index-options_002c-link-and-destination"></a> +<span id="index-link-options"></span> +<span id="index-destination-options"></span> +<span id="index-options_002c-link-and-destination"></span> <p>In addition, each hyperlink driver supports a number of destination and link <em>options</em>. By setting these options you can customize hyperlink parameters (e.g., the thickness of the border drawn around a @@ -4708,17 +4588,15 @@ options supported by the drivers. See <a href="#Setting-hyperlink-types-and-opt </p> <hr> -<a name="Explicit-hyperlinks"></a> -<div class="header"> +<span id="Explicit-hyperlinks"></span><div class="header"> <p> Next: <a href="#Implicit-hyperlinks" accesskey="n" rel="next">Implicit hyperlinks</a>, Previous: <a href="#Introduction-to-hyperlinks" accesskey="p" rel="prev">Introduction to hyperlinks</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Explicit-hyperlinks-1"></a> -<h3 class="section">5.2 Explicit hyperlinks</h3> +<span id="Explicit-hyperlinks-1"></span><h3 class="section">5.2 Explicit hyperlinks</h3> -<a name="index-explicit-hyperlinks"></a> -<a name="index-hyperlinks_002c-explicit"></a> -<a name="index-hldest"></a> +<span id="index-explicit-hyperlinks"></span> +<span id="index-hyperlinks_002c-explicit"></span> +<span id="index-hldest"></span> <p>Explicit hyperlinks are created by you, in the source of your document. The simplest command is <code>\hldest</code>, which marks the current position in your document as a destination: @@ -4742,8 +4620,8 @@ destination. For example, with the <code>pdftex</code> driver, the command position”), sets the magnification ratio for this destination to be 200%, and associates the label <code>index</code> with the destination. </p> -<a name="index-hlstart"></a> -<a name="index-hlend"></a> +<span id="index-hlstart"></span> +<span id="index-hlend"></span> <p>Another command, <code>\hlstart</code>, paired with <code>\hlend</code>, turns all intervening material into a link: </p> @@ -4787,26 +4665,24 @@ explicit hyperlinks. </p> <hr> -<a name="Implicit-hyperlinks"></a> -<div class="header"> +<span id="Implicit-hyperlinks"></span><div class="header"> <p> Next: <a href="#Hyperlink-drivers" accesskey="n" rel="next">Hyperlink drivers</a>, Previous: <a href="#Explicit-hyperlinks" accesskey="p" rel="prev">Explicit hyperlinks</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Implicit-hyperlinks-1"></a> -<h3 class="section">5.3 Implicit hyperlinks</h3> +<span id="Implicit-hyperlinks-1"></span><h3 class="section">5.3 Implicit hyperlinks</h3> -<a name="index-implicit-hyperlinks"></a> -<a name="index-hyperlinks_002c-implicit"></a> +<span id="index-implicit-hyperlinks"></span> +<span id="index-hyperlinks_002c-implicit"></span> <p><em>Implicit hyperlinks</em> are hyperlinks created implicitly by various Eplain macros, such as the macros for citations, cross-references, indexing, etc. </p> -<a name="index-link-group"></a> -<a name="index-linkgroup"></a> -<a name="index-group_002c-link"></a> -<a name="index-destination-group"></a> -<a name="index-destgroup"></a> -<a name="index-group_002c-destination"></a> +<span id="index-link-group"></span> +<span id="index-linkgroup"></span> +<span id="index-group_002c-link"></span> +<span id="index-destination-group"></span> +<span id="index-destgroup"></span> +<span id="index-group_002c-destination"></span> <p>All such macros are divided into <em>link groups</em> and <em>destination groups</em> (or <em>linkgroups</em> and <em>destgroups</em> for short) so that parameters can be set individually for each group. For @@ -4839,39 +4715,37 @@ implicit hyperlinks. and the hyperlink support provided. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#General-hyperlinks" accesskey="1">General hyperlinks</a>:</td><td> </td><td align="left" valign="top">hrefint, hrefext +<tr><td align="left" valign="top">• <a href="#General-hyperlinks" accesskey="1">General hyperlinks</a></td><td> </td><td align="left" valign="top">hrefint, hrefext </td></tr> -<tr><td align="left" valign="top">• <a href="#URL-hyperlinks" accesskey="2">URL hyperlinks</a>:</td><td> </td><td align="left" valign="top">url +<tr><td align="left" valign="top">• <a href="#URL-hyperlinks" accesskey="2">URL hyperlinks</a></td><td> </td><td align="left" valign="top">url </td></tr> -<tr><td align="left" valign="top">• <a href="#Citation-hyperlinks" accesskey="3">Citation hyperlinks</a>:</td><td> </td><td align="left" valign="top">cite, bib +<tr><td align="left" valign="top">• <a href="#Citation-hyperlinks" accesskey="3">Citation hyperlinks</a></td><td> </td><td align="left" valign="top">cite, bib </td></tr> -<tr><td align="left" valign="top">• <a href="#List-hyperlinks" accesskey="4">List hyperlinks</a>:</td><td> </td><td align="left" valign="top">li +<tr><td align="left" valign="top">• <a href="#List-hyperlinks" accesskey="4">List hyperlinks</a></td><td> </td><td align="left" valign="top">li </td></tr> -<tr><td align="left" valign="top">• <a href="#Cross_002dreference-hyperlinks" accesskey="5">Cross-reference hyperlinks</a>:</td><td> </td><td align="left" valign="top">definexref, ref +<tr><td align="left" valign="top">• <a href="#Cross_002dreference-hyperlinks" accesskey="5">Cross-reference hyperlinks</a></td><td> </td><td align="left" valign="top">definexref, ref </td></tr> -<tr><td align="left" valign="top">• <a href="#Page-reference-hyperlinks" accesskey="6">Page reference hyperlinks</a>:</td><td> </td><td align="left" valign="top">xrdef, xref +<tr><td align="left" valign="top">• <a href="#Page-reference-hyperlinks" accesskey="6">Page reference hyperlinks</a></td><td> </td><td align="left" valign="top">xrdef, xref </td></tr> -<tr><td align="left" valign="top">• <a href="#Equation-reference-hyperlinks" accesskey="7">Equation reference hyperlinks</a>:</td><td> </td><td align="left" valign="top">eq +<tr><td align="left" valign="top">• <a href="#Equation-reference-hyperlinks" accesskey="7">Equation reference hyperlinks</a></td><td> </td><td align="left" valign="top">eq </td></tr> -<tr><td align="left" valign="top">• <a href="#Index-hyperlinks" accesskey="8">Index hyperlinks</a>:</td><td> </td><td align="left" valign="top">idx +<tr><td align="left" valign="top">• <a href="#Index-hyperlinks" accesskey="8">Index hyperlinks</a></td><td> </td><td align="left" valign="top">idx </td></tr> -<tr><td align="left" valign="top">• <a href="#Footnote-hyperlinks" accesskey="9">Footnote hyperlinks</a>:</td><td> </td><td align="left" valign="top">foot, footback +<tr><td align="left" valign="top">• <a href="#Footnote-hyperlinks" accesskey="9">Footnote hyperlinks</a></td><td> </td><td align="left" valign="top">foot, footback </td></tr> -<tr><td align="left" valign="top">• <a href="#Contents-hyperlinks">Contents hyperlinks</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Contents-hyperlinks">Contents hyperlinks</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="General-hyperlinks"></a> -<div class="header"> +<span id="General-hyperlinks"></span><div class="header"> <p> Next: <a href="#URL-hyperlinks" accesskey="n" rel="next">URL hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="General-hyperlinks_003a-hrefint_002c-hrefext"></a> -<h4 class="subsection">5.3.1 General hyperlinks: hrefint, hrefext</h4> +<span id="General-hyperlinks_003a-hrefint_002c-hrefext"></span><h4 class="subsection">5.3.1 General hyperlinks: hrefint, hrefext</h4> -<a name="index-href"></a> +<span id="index-href"></span> <p><code>\href{<var>url</var>}{<var>text</var>}</code> typesets <var>text</var> as a link to <var>url</var>. It basically does what the explicit hyperlink macros do (see <a href="#Explicit-hyperlinks">Explicit hyperlinks</a>), but is more convenient (at the expense @@ -4880,8 +4754,8 @@ of flexibility). <p>If <var>url</var> starts with ‘<samp>#</samp>’, the rest of <var>url</var> is assumed to be a local hyperlink destination name (destination within the same document). Parameters for these links can be set by customizing the -<a name="index-group-_0060hrefint_0027"></a> -<a name="index-linkgroup-_0060hrefint_0027"></a> +<span id="index-group-_0060hrefint_0027"></span> +<span id="index-linkgroup-_0060hrefint_0027"></span> ‘hrefint’ linkgroup. For example: </p> <div class="example"> @@ -4891,18 +4765,18 @@ document). Parameters for these links can be set by customizing the <p>will make ‘Introduction’ into an internal link, which might have been created, e.g., with <code>\xrdef{intro}</code>. </p> -<a name="index-URL-hyperlink"></a> -<a name="index-hyperlinks_002c-URL"></a> +<span id="index-URL-hyperlink"></span> +<span id="index-hyperlinks_002c-URL"></span> <p>If <var>url</var> does not start with ‘<samp>#</samp>’, it is assumed to be a <acronym>URL</acronym> link. Parameters for these links can be set by customizing the -<a name="index-group-_0060hrefext_0027"></a> -<a name="index-linkgroup-_0060hrefext_0027"></a> +<span id="index-group-_0060hrefext_0027"></span> +<span id="index-linkgroup-_0060hrefext_0027"></span> ‘hrefext’ linkgroup. The special characters (such as ‘<samp>#</samp>’ and ‘<samp>~</samp>’) in the <acronym>URL</acronym> don’t need to be escaped. For example: </p> <div class="example"> -<pre class="example">\href{http://tug.org/eplain/doc/eplain.html#Hyperlinks}{Hyperlinks +<pre class="example">\href{https://tug.org/eplain/doc/eplain.html#Hyperlinks}{Hyperlinks in Eplain} \href{mailto:tex-eplain@tug.org}{Eplain mailing list} </pre></div> @@ -4919,29 +4793,27 @@ catcodes. For example: </pre></div> <p><code>\href</code> does not currently handle other link types, such as -<a name="index-file_003a-links"></a> +<span id="index-file_003a-links"></span> ‘<samp>file:</samp>’ and -<a name="index-run_003a-links"></a> +<span id="index-run_003a-links"></span> ‘<samp>run:</samp>’ links. </p> <hr> -<a name="URL-hyperlinks"></a> -<div class="header"> +<span id="URL-hyperlinks"></span><div class="header"> <p> Next: <a href="#Citation-hyperlinks" accesskey="n" rel="next">Citation hyperlinks</a>, Previous: <a href="#General-hyperlinks" accesskey="p" rel="prev">General hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="URL-hyperlinks_003a-url"></a> -<h4 class="subsection">5.3.2 URL hyperlinks: url</h4> +<span id="URL-hyperlinks_003a-url"></span><h4 class="subsection">5.3.2 URL hyperlinks: url</h4> -<a name="index-URL-hyperlink-1"></a> -<a name="index-hyperlinks_002c-URL-1"></a> -<a name="index-group-_0060url_0027"></a> -<a name="index-linkgroup-_0060url_0027"></a> +<span id="index-URL-hyperlink-1"></span> +<span id="index-hyperlinks_002c-URL-1"></span> +<span id="index-group-_0060url_0027"></span> +<span id="index-linkgroup-_0060url_0027"></span> <p>The ‘url’ linkgroup covers the -<a name="index-url-_0028hyperlinks_0029"></a> +<span id="index-url-_0028hyperlinks_0029"></span> <code>\url</code> command from the LaTeX package -<a name="index-url_002esty-1"></a> +<span id="index-url_002esty-1"></span> <samp>url</samp> (see <a href="#Packages-known-to-work">Packages known to work</a>), as well as any new <code>\url</code>-like commands you define. The type for this linkgroup is set to ‘<samp>url</samp>’ by the drivers which support this link type. @@ -4953,14 +4825,14 @@ a <acronym>URL</acronym>, e.g., a path, for which you do not want a link to be created; in that case, you can disable the ‘url’ linkgroup with the command <code>\hloff[url]</code> (see <a href="#Turning-hyperlinks-on_002foff-for-a-group">Turning hyperlinks on/off for a group</a>). </p> -<a name="index-boxed-links_002c-avoiding"></a> -<a name="index-avoiding-boxed-links"></a> -<a name="index-color_002c-hyperlinks"></a> -<a name="index-colored-links"></a> -<a name="index-hyperlink-color"></a> +<span id="index-boxed-links_002c-avoiding"></span> +<span id="index-avoiding-boxed-links"></span> +<span id="index-color_002c-hyperlinks"></span> +<span id="index-colored-links"></span> +<span id="index-hyperlink-color"></span> <p>By default, <acronym>URL</acronym> (and other types of) links are boxed, so that they are visually marked even if you do not load the LaTeX -<a name="index-color_002esty-1"></a> +<span id="index-color_002esty-1"></span> ‘color’ package (see <a href="#Loading-LaTeX-packages">Loading LaTeX packages</a>) and therefore link text is not colored. You can see the effect by compiling the following code snippet (be sure to get a modern <samp>url.sty</samp>, older versions do not @@ -5010,29 +4882,27 @@ apply to <acronym>URL</acronym> links only, say <code>\hlopts[url]{bwidth=0}</co </p> <hr> -<a name="Citation-hyperlinks"></a> -<div class="header"> +<span id="Citation-hyperlinks"></span><div class="header"> <p> Next: <a href="#List-hyperlinks" accesskey="n" rel="next">List hyperlinks</a>, Previous: <a href="#URL-hyperlinks" accesskey="p" rel="prev">URL hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Citation-hyperlinks_003a-cite_002c-bib"></a> -<h4 class="subsection">5.3.3 Citation hyperlinks: cite, bib</h4> +<span id="Citation-hyperlinks_003a-cite_002c-bib"></span><h4 class="subsection">5.3.3 Citation hyperlinks: cite, bib</h4> -<a name="index-citations_002c-hyperlinks"></a> -<a name="index-hyperlinks_002c-citations"></a> -<a name="index-group-_0060cite_0027"></a> -<a name="index-linkgroup-_0060cite_0027"></a> -<a name="index-cite-_0028hyperlinks_0029"></a> +<span id="index-citations_002c-hyperlinks"></span> +<span id="index-hyperlinks_002c-citations"></span> +<span id="index-group-_0060cite_0027"></span> +<span id="index-linkgroup-_0060cite_0027"></span> +<span id="index-cite-_0028hyperlinks_0029"></span> <p>The ‘cite’ linkgroup includes only the <code>\cite</code> command (see <a href="#Citations">Citations</a>). <code>\cite</code> turns each of the references in the list into a link pointing to the respective bibliography entry produced by the <code>\bibliography</code> command. </p> -<a name="index-bibliography_002c-hyperlinks"></a> -<a name="index-hyperlinks_002c-bibliography"></a> -<a name="index-group-_0060bib_0027"></a> -<a name="index-destgroup-_0060bib_0027"></a> -<a name="index-bibliography-_0028hyperlinks_0029"></a> +<span id="index-bibliography_002c-hyperlinks"></span> +<span id="index-hyperlinks_002c-bibliography"></span> +<span id="index-group-_0060bib_0027"></span> +<span id="index-destgroup-_0060bib_0027"></span> +<span id="index-bibliography-_0028hyperlinks_0029"></span> <p>The ‘bib’ destgroup includes the macros related to the <code>\bibliography</code> command (see <a href="#Citations">Citations</a>). <code>\bibliography</code> inputs a <samp>.bbl</samp> file, which contains a list of bibliography @@ -5042,19 +4912,17 @@ entries. For each of the entries, a destination is defined. </p> <hr> -<a name="List-hyperlinks"></a> -<div class="header"> +<span id="List-hyperlinks"></span><div class="header"> <p> Next: <a href="#Cross_002dreference-hyperlinks" accesskey="n" rel="next">Cross-reference hyperlinks</a>, Previous: <a href="#Citation-hyperlinks" accesskey="p" rel="prev">Citation hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="List-hyperlinks_003a-li"></a> -<h4 class="subsection">5.3.4 List hyperlinks: li</h4> +<span id="List-hyperlinks_003a-li"></span><h4 class="subsection">5.3.4 List hyperlinks: li</h4> -<a name="index-lists_002c-hyperlinks"></a> -<a name="index-hyperlinks_002c-lists"></a> -<a name="index-li-_0028hyperlinks_0029"></a> -<a name="index-group-_0060li_0027"></a> -<a name="index-destgroup-_0060li_0027"></a> +<span id="index-lists_002c-hyperlinks"></span> +<span id="index-hyperlinks_002c-lists"></span> +<span id="index-li-_0028hyperlinks_0029"></span> +<span id="index-group-_0060li_0027"></span> +<span id="index-destgroup-_0060li_0027"></span> <p>The ‘li’ destgroup consists of the <code>\li</code> command (see <a href="#Lists">Lists</a>), which defines a destination if you supply the optional argument (cross-reference label). This label is also used as the hyperlink @@ -5062,78 +4930,74 @@ label. </p> <hr> -<a name="Cross_002dreference-hyperlinks"></a> -<div class="header"> +<span id="Cross_002dreference-hyperlinks"></span><div class="header"> <p> Next: <a href="#Page-reference-hyperlinks" accesskey="n" rel="next">Page reference hyperlinks</a>, Previous: <a href="#List-hyperlinks" accesskey="p" rel="prev">List hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Cross_002dreference-hyperlinks_003a-definexref_002c-ref"></a> -<h4 class="subsection">5.3.5 Cross-reference hyperlinks: definexref, ref</h4> +<span id="Cross_002dreference-hyperlinks_003a-definexref_002c-ref"></span><h4 class="subsection">5.3.5 Cross-reference hyperlinks: definexref, ref</h4> -<a name="index-definexref-_0028hyperlinks_0029"></a> -<a name="index-cross_002dreferences_002c-hyperlinks"></a> -<a name="index-hyperlinks_002c-cross_002dreferences"></a> -<a name="index-group-_0060definexref_0027"></a> -<a name="index-destgroup-_0060definexref_0027"></a> +<span id="index-definexref-_0028hyperlinks_0029"></span> +<span id="index-cross_002dreferences_002c-hyperlinks"></span> +<span id="index-hyperlinks_002c-cross_002dreferences"></span> +<span id="index-group-_0060definexref_0027"></span> +<span id="index-destgroup-_0060definexref_0027"></span> <p>The ‘definexref’ destgroup is for the <code>\definexref</code> command (see <a href="#Defining-generic-references">Defining generic references</a>). <code>\definexref</code> defines a destination using the cross-reference label (the first argument) as the hyperlink label. </p> -<a name="index-group-_0060ref_0027"></a> -<a name="index-linkgroup-_0060ref_0027"></a> +<span id="index-group-_0060ref_0027"></span> +<span id="index-linkgroup-_0060ref_0027"></span> <p>The ‘ref’ linkgroup includes <code>\refn</code> and <code>\xrefn</code> (they are synonyms), <code>\ref</code>, and <code>\refs</code> (see <a href="#Using-generic-references">Using generic references</a>). </p> -<a name="index-refn-_0028hyperlinks_0029"></a> -<a name="index-xrefn-_0028hyperlinks_0029"></a> +<span id="index-refn-_0028hyperlinks_0029"></span> +<span id="index-xrefn-_0028hyperlinks_0029"></span> <p><code>\refn</code> turns the cross-reference it produces into a link, using the cross-reference label as the hyperlink label. If an optional argument is present, it is tied by -<a name="index-reftie"></a> +<span id="index-reftie"></span> <code>\reftie</code> to the reference and become part of the link. </p> -<a name="index-ref-_0028hyperlinks_0029"></a> +<span id="index-ref-_0028hyperlinks_0029"></span> <p><code>\ref</code> works similarly to <code>\refn</code>. It takes an optional argument, which is treated the same way as the optional argument to <code>\refn</code>. In addition, <code>\ref</code> can produce a “class word”. Both the optional argument and the class word become part of the link, when present. The cross-reference is tied by -<a name="index-reftie-1"></a> +<span id="index-reftie-1"></span> <code>\reftie</code> to the preceding word. The optional argument is separated from the class word by -<a name="index-refspace"></a> +<span id="index-refspace"></span> <code>\refspace</code>. </p> -<a name="index-refs-_0028hyperlinks_0029"></a> +<span id="index-refs-_0028hyperlinks_0029"></span> <p>Unlike <code>\ref</code>, <code>\refs</code> does not take an optional argument and does not make the class word part of the link, which is appropriate for its intended use. </p> <hr> -<a name="Page-reference-hyperlinks"></a> -<div class="header"> +<span id="Page-reference-hyperlinks"></span><div class="header"> <p> Next: <a href="#Equation-reference-hyperlinks" accesskey="n" rel="next">Equation reference hyperlinks</a>, Previous: <a href="#Cross_002dreference-hyperlinks" accesskey="p" rel="prev">Cross-reference hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Page-reference-hyperlinks_003a-xrdef_002c-xref"></a> -<h4 class="subsection">5.3.6 Page reference hyperlinks: xrdef, xref</h4> +<span id="Page-reference-hyperlinks_003a-xrdef_002c-xref"></span><h4 class="subsection">5.3.6 Page reference hyperlinks: xrdef, xref</h4> -<a name="index-xrdef-_0028hyperlinks_0029"></a> -<a name="index-page-reference-hyperlink"></a> -<a name="index-hyperlinks_002c-page-references"></a> -<a name="index-group-_0060xrdef_0027"></a> -<a name="index-destgroup-_0060xrdef_0027"></a> +<span id="index-xrdef-_0028hyperlinks_0029"></span> +<span id="index-page-reference-hyperlink"></span> +<span id="index-hyperlinks_002c-page-references"></span> +<span id="index-group-_0060xrdef_0027"></span> +<span id="index-destgroup-_0060xrdef_0027"></span> <p>The ‘xrdef’ destgroup is for <code>\xrdef</code> (see <a href="#Page-references">Page references</a>). <code>\xrdef</code> defines a destination using cross-reference label as the hyperlink label. </p> -<a name="index-xref-_0028hyperlinks_0029"></a> -<a name="index-refspace-1"></a> -<a name="index-xrefpageword-1"></a> -<a name="index-group-_0060xref_0027"></a> -<a name="index-linkgroup-_0060xref_0027"></a> +<span id="index-xref-_0028hyperlinks_0029"></span> +<span id="index-refspace-1"></span> +<span id="index-xrefpageword-1"></span> +<span id="index-group-_0060xref_0027"></span> +<span id="index-linkgroup-_0060xref_0027"></span> <p>The ‘xref’ linkgroup includes the <code>\xref</code> command (see <a href="#Page-references">Page references</a>). <code>\xref</code> turns its optional argument (followed by <code>\refspace</code>), <code>\xrefpageword</code> and the cross-reference (page number) into a link, using the cross-reference label as the hyperlink @@ -5141,22 +5005,20 @@ label. </p> <hr> -<a name="Equation-reference-hyperlinks"></a> -<div class="header"> +<span id="Equation-reference-hyperlinks"></span><div class="header"> <p> Next: <a href="#Index-hyperlinks" accesskey="n" rel="next">Index hyperlinks</a>, Previous: <a href="#Page-reference-hyperlinks" accesskey="p" rel="prev">Page reference hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Equation-reference-hyperlinks_003a-eq"></a> -<h4 class="subsection">5.3.7 Equation reference hyperlinks: eq</h4> - -<a name="index-eqdef-_0028hyperlinks_0029"></a> -<a name="index-eqdefn-_0028hyperlinks_0029"></a> -<a name="index-eqsubdef-_0028hyperlinks_0029"></a> -<a name="index-eqsubdefn-_0028hyperlinks_0029"></a> -<a name="index-equations_002c-hyperlinks"></a> -<a name="index-hyperlinks_002c-equations"></a> -<a name="index-group-_0060eq_0027"></a> -<a name="index-destgroup-_0060eq_0027"></a> +<span id="Equation-reference-hyperlinks_003a-eq"></span><h4 class="subsection">5.3.7 Equation reference hyperlinks: eq</h4> + +<span id="index-eqdef-_0028hyperlinks_0029"></span> +<span id="index-eqdefn-_0028hyperlinks_0029"></span> +<span id="index-eqsubdef-_0028hyperlinks_0029"></span> +<span id="index-eqsubdefn-_0028hyperlinks_0029"></span> +<span id="index-equations_002c-hyperlinks"></span> +<span id="index-hyperlinks_002c-equations"></span> +<span id="index-group-_0060eq_0027"></span> +<span id="index-destgroup-_0060eq_0027"></span> <p>All commands that define equation labels are part of the ‘eq’ destgroup. These are <code>\eqdef</code>, <code>\eqdefn</code>, <code>\eqsubdef</code> and <code>\eqsubdefn</code> (see <a href="#Equation-references">Equation references</a>). All these commands use @@ -5165,19 +5027,19 @@ label is empty, they make up a (hopefully) unique hyperlink label for the destination. This label will be used for the link when you refer to this empty-labeled equation with one of the equation reference macros. </p> -<a name="index-phantomeqlabel"></a> -<a name="index-phantomeqnumber"></a> +<span id="index-phantomeqlabel"></span> +<span id="index-phantomeqnumber"></span> <p>The command <code>\phantomeqlabel</code> is called to generate hyperlink labels for the empty-labeled equations. By default, it produces the labels in the format ‘<samp>PHEQ<var>number</var></samp>’, where <var>number</var> comes from the count register <code>\phantomeqnumber</code>; this count register is incremented at every empty-labeled equation definition. </p> -<a name="index-eqref-1"></a> -<a name="index-eqrefn-1"></a> -<a name="index-reftie-2"></a> -<a name="index-group-_0060eq_0027-1"></a> -<a name="index-linkgroup-_0060eq_0027"></a> +<span id="index-eqref-1"></span> +<span id="index-eqrefn-1"></span> +<span id="index-reftie-2"></span> +<span id="index-group-_0060eq_0027-1"></span> +<span id="index-linkgroup-_0060eq_0027"></span> <p>The commands <code>\eqref</code> and <code>\eqrefn</code> (see <a href="#Equation-references">Equation references</a>) form the ‘eq’ linkgroup. These commands take an optional argument, which, when present, is tied with <code>\reftie</code> to the equation reference and becomes part of the link. The equation label is @@ -5186,34 +5048,32 @@ label generated for the last empty-labeled equation. </p> <hr> -<a name="Index-hyperlinks"></a> -<div class="header"> +<span id="Index-hyperlinks"></span><div class="header"> <p> Next: <a href="#Footnote-hyperlinks" accesskey="n" rel="next">Footnote hyperlinks</a>, Previous: <a href="#Equation-reference-hyperlinks" accesskey="p" rel="prev">Equation reference hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Index-hyperlinks_003a-idx"></a> -<h4 class="subsection">5.3.8 Index hyperlinks: idx</h4> - -<a name="index-idx-_0028hyperlinks_0029"></a> -<a name="index-idxname-_0028hyperlinks_0029"></a> -<a name="index-idxmarked-_0028hyperlinks_0029"></a> -<a name="index-idxsubmarked-_0028hyperlinks_0029"></a> -<a name="index-index-hyperlink"></a> -<a name="index-hyperlinks_002c-index"></a> -<a name="index-group-_0060idx_0027"></a> -<a name="index-linkgroup-_0060idx_0027"></a> -<a name="index-destgroup-_0060idx_0027"></a> +<span id="Index-hyperlinks_003a-idx"></span><h4 class="subsection">5.3.8 Index hyperlinks: idx</h4> + +<span id="index-idx-_0028hyperlinks_0029"></span> +<span id="index-idxname-_0028hyperlinks_0029"></span> +<span id="index-idxmarked-_0028hyperlinks_0029"></span> +<span id="index-idxsubmarked-_0028hyperlinks_0029"></span> +<span id="index-index-hyperlink"></span> +<span id="index-hyperlinks_002c-index"></span> +<span id="index-group-_0060idx_0027"></span> +<span id="index-linkgroup-_0060idx_0027"></span> +<span id="index-destgroup-_0060idx_0027"></span> <p>All indexing commands (<code>\idx</code>, <code>\idxname</code>, <code>\idxmarked</code>, <code>\idxsubmarked</code> and their silent equivalents, see <a href="#Indexing-commands">Indexing commands</a>) form the ‘idx’ destgroup. The ‘idx’ linkgroup consists of the macros which are used to typeset the index when you say -<a name="index-readindexfile-_0028hyperlinks_0029"></a> +<span id="index-readindexfile-_0028hyperlinks_0029"></span> <code>\readindexfile{<var>index-letter</var>}</code> (see <a href="#Typesetting-an-index">Typesetting an index</a>). </p> -<a name="index-makeindex-2"></a> +<span id="index-makeindex-2"></span> <p>To create the links in index entries, Eplain uses MakeIndex’s “encapsulation” feature. When you use an indexing macro to mark an index term, Eplain writes out a line to the -<a name="index-_002eidx-files-1"></a> +<span id="index-_002eidx-files-1"></span> <samp>.idx</samp> file of the following general form: </p> <div class="example"> @@ -5228,7 +5088,7 @@ and <var>pageno</var> is the page number on which the term appeared. When processing the <samp>.idx</samp> file, MakeIndex makes the page number an argument to the page markup command (“encapsulates” the page number), so the page number in the -<a name="index-_002eind-files-1"></a> +<span id="index-_002eind-files-1"></span> <samp>.ind</samp> file appears as <code>\<var>cs</var>{<var>pageno</var>}</code>. Eplain internally replaces the <var>cs</var> command name with its own command, which, in addition to calling the original <code>\<var>cs</var></code> @@ -5238,27 +5098,25 @@ encapsulator, turns the page number into a link. locations of index terms in the text. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Exact-destinations-for-index-terms" accesskey="1">Exact destinations for index terms</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Exact-destinations-for-index-terms" accesskey="1">Exact destinations for index terms</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Page-destinations-for-index-terms" accesskey="2">Page destinations for index terms</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Page-destinations-for-index-terms" accesskey="2">Page destinations for index terms</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Choosing-destination-placement" accesskey="3">Choosing destination placement</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Choosing-destination-placement" accesskey="3">Choosing destination placement</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Index-page-list-and-page-range-parsers" accesskey="4">Index page list and page range parsers</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Index-page-list-and-page-range-parsers" accesskey="4">Index page list and page range parsers</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlinks-in-see-and-see-also-entries" accesskey="5">Hyperlinks in see and see also entries</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Hyperlinks-in-see-and-see-also-entries" accesskey="5">Hyperlinks in see and see also entries</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Exact-destinations-for-index-terms"></a> -<div class="header"> +<span id="Exact-destinations-for-index-terms"></span><div class="header"> <p> Next: <a href="#Page-destinations-for-index-terms" accesskey="n" rel="next">Page destinations for index terms</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Exact-destinations-for-index-terms-1"></a> -<h4 class="subsubsection">5.3.8.1 Exact destinations for index terms</h4> +<span id="Exact-destinations-for-index-terms-1"></span><h4 class="subsubsection">5.3.8.1 Exact destinations for index terms</h4> <p>In this approach, each command that marks an index term defines a unique destination and passes its label on to the <samp>.idx</samp> file as part of @@ -5269,7 +5127,7 @@ writes to the <samp>.idx</samp> file becomes <pre class="example">\indexentry{<var>entry</var>|hlidx{<var>label</var>}{<var>cs</var>}}{<var>pageno}</var> </pre></div> -<a name="index-hlidx"></a> +<span id="index-hlidx"></span> <p>where <code>\hlidx</code> is the command that is defined by Eplain to take three arguments: a hyperlink label (<var>label</var>), a name of page number encapsulator (<var>cs</var>) and a page number (<var>pageno</var>). @@ -5285,26 +5143,26 @@ will now appear as <var>label</var> destination. </p> <p>The hyperlink labels for the index terms are generated by the -<a name="index-hlidxlabel"></a> +<span id="index-hlidxlabel"></span> <code>\hlidxlabel</code> command, by default in the format ‘<samp>IDX<var>number</var></samp>’, where <var>number</var> is the value of the count register -<a name="index-hlidxlabelnumber"></a> +<span id="index-hlidxlabelnumber"></span> <code>\hlidxlabelnumber</code>. This count register is incremented at each index term. </p> -<a name="index-exact-index-hyperlinks"></a> -<a name="index-index_002c-exact-hyperlinks"></a> -<a name="index-hyperlinks_002c-index_002c-exact"></a> +<span id="index-exact-index-hyperlinks"></span> +<span id="index-index_002c-exact-hyperlinks"></span> +<span id="index-hyperlinks_002c-index_002c-exact"></span> <p>The advantage of this approach, as compared to the second approach described below, is that links in the index point to exact locations of the indexed terms on the page. The disadvantage of this approach is that MakeIndex will regard <em>all</em> index entries as distinct, because each one contains a (unique) hyperlink label. This disadvantage can be partially overcome by the script -<a name="index-idxuniq"></a> -<a name="index-filtering-index-entries-with-hyperlinks"></a> -<a name="index-hyperlinks_002c-filtering-index-entries"></a> +<span id="index-idxuniq"></span> +<span id="index-filtering-index-entries-with-hyperlinks"></span> +<span id="index-hyperlinks_002c-filtering-index-entries"></span> <samp>idxuniq</samp> distributed with Eplain in the <samp>util</samp> directory. This script filters out <code>\indexentry</code> lines differing only in the hyperlink label but identical otherwise. You should process the @@ -5323,13 +5181,11 @@ definition; <samp>idxuniq</samp> will not filter out the second entry). </p> <hr> -<a name="Page-destinations-for-index-terms"></a> -<div class="header"> +<span id="Page-destinations-for-index-terms"></span><div class="header"> <p> Next: <a href="#Choosing-destination-placement" accesskey="n" rel="next">Choosing destination placement</a>, Previous: <a href="#Exact-destinations-for-index-terms" accesskey="p" rel="prev">Exact destinations for index terms</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Page-destinations-for-index-terms-1"></a> -<h4 class="subsubsection">5.3.8.2 Page destinations for index terms</h4> +<span id="Page-destinations-for-index-terms-1"></span><h4 class="subsubsection">5.3.8.2 Page destinations for index terms</h4> <p>In the second approach, Eplain does not write out any destination labels for the index terms. Instead, Eplain writes out a wrapper for page @@ -5337,7 +5193,7 @@ number encapsulator which can parse the page number and generate a link pointing to the <em>page</em> on which the term appeared. On top of each page containing an index term, Eplain defines a destination with label produced by -<a name="index-hlidxpagelabel"></a> +<span id="index-hlidxpagelabel"></span> <code>\hlidxpagelabel</code>. The <code>\hlidxpagelabel</code> command takes a single argument (page number <var>number</var>) and by default produces the label in the format ‘<samp>IDXPG<var>number</var></samp>’. @@ -5349,7 +5205,7 @@ the <code>.idx</code> file looks like this: <pre class="example">\indexentry{<var>entry</var>|hlidxpage{<var>cs</var>}}{<var>pageno}</var> </pre></div> -<a name="index-hlidxpage"></a> +<span id="index-hlidxpage"></span> <p>where <code>\hlidxpage</code> is the command that is defined by Eplain to take two arguments: a name of page number encapsulator (<var>cs</var>) and a page number (<var>pageno</var>). In the <samp>.ind</samp> file that @@ -5364,10 +5220,10 @@ intact. The drawback is that links in the index do not point to exact locations of indexed terms on a page, but to the top of a page on which the term appears. </p> -<a name="index-index_002c-parsing-page-numbers"></a> -<a name="index-page-range_002c-parsing"></a> -<a name="index-page-list_002c-parsing"></a> -<a name="index-parsing-page-numbers"></a> +<span id="index-index_002c-parsing-page-numbers"></span> +<span id="index-page-range_002c-parsing"></span> +<span id="index-page-list_002c-parsing"></span> +<span id="index-parsing-page-numbers"></span> <p>Another disadvantage is that this approach depends on the page range and page list separators which MakeIndex was configured to output. <code>\hlidxpage</code> must be able to parse the first page number in a page @@ -5396,29 +5252,27 @@ with the commands </p> <hr> -<a name="Choosing-destination-placement"></a> -<div class="header"> +<span id="Choosing-destination-placement"></span><div class="header"> <p> Next: <a href="#Index-page-list-and-page-range-parsers" accesskey="n" rel="next">Index page list and page range parsers</a>, Previous: <a href="#Page-destinations-for-index-terms" accesskey="p" rel="prev">Page destinations for index terms</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Choosing-destination-placement-1"></a> -<h4 class="subsubsection">5.3.8.3 Choosing destination placement</h4> +<span id="Choosing-destination-placement-1"></span><h4 class="subsubsection">5.3.8.3 Choosing destination placement</h4> -<a name="index-index_002c-placement-of-destinations"></a> -<a name="index-index_002c-destination-placement"></a> -<a name="index-index_002c-selecting-destination-placement"></a> -<a name="index-index_002c-choosing-destination-placement"></a> -<a name="index-hyperlinks_002c-index-destination-placement"></a> +<span id="index-index_002c-placement-of-destinations"></span> +<span id="index-index_002c-destination-placement"></span> +<span id="index-index_002c-selecting-destination-placement"></span> +<span id="index-index_002c-choosing-destination-placement"></span> +<span id="index-hyperlinks_002c-index-destination-placement"></span> <p>The approach that Eplain should use for the index terms can be selected in the -<a name="index-enablehyperlinks-1"></a> +<span id="index-enablehyperlinks-1"></span> <code>\enablehyperlinks</code> command. The optional argument it accepts is a comma-separated list of options. The -<a name="index-idxexact"></a> +<span id="index-idxexact"></span> <code>idxexact</code> option selects the first approach, -<a name="index-idxpage"></a> +<span id="index-idxpage"></span> <code>idxpage</code> the second, and -<a name="index-idxnone"></a> +<span id="index-idxnone"></span> <code>idxnone</code> disables hyperlink support for the index terms altogether, in case you want to stop Eplain from writing its link wrappers into the <samp>.idx</samp> file. The default is <code>idxpage</code>. @@ -5433,13 +5287,11 @@ wrappers into the <samp>.idx</samp> file. The default is <code>idxpage</code>. </p> <hr> -<a name="Index-page-list-and-page-range-parsers"></a> -<div class="header"> +<span id="Index-page-list-and-page-range-parsers"></span><div class="header"> <p> Next: <a href="#Hyperlinks-in-see-and-see-also-entries" accesskey="n" rel="next">Hyperlinks in see and see also entries</a>, Previous: <a href="#Choosing-destination-placement" accesskey="p" rel="prev">Choosing destination placement</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Index-page-list-and-page-range-parsers-1"></a> -<h4 class="subsubsection">5.3.8.4 Index page list and page range parsers</h4> +<span id="Index-page-list-and-page-range-parsers-1"></span><h4 class="subsubsection">5.3.8.4 Index page list and page range parsers</h4> <p>The macros that Eplain uses to parse page lists and page ranges, <code>\idxparselist</code> and <code>\idxparserange</code>, can sometimes be useful @@ -5448,24 +5300,22 @@ usage. </p> <hr> -<a name="Hyperlinks-in-see-and-see-also-entries"></a> -<div class="header"> +<span id="Hyperlinks-in-see-and-see-also-entries"></span><div class="header"> <p> Previous: <a href="#Index-page-list-and-page-range-parsers" accesskey="p" rel="prev">Index page list and page range parsers</a>, Up: <a href="#Index-hyperlinks" accesskey="u" rel="up">Index hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Hyperlinks-in-see-and-see-also-entries-1"></a> -<h4 class="subsubsection">5.3.8.5 Hyperlinks in see and see also entries</h4> +<span id="Hyperlinks-in-see-and-see-also-entries-1"></span><h4 class="subsubsection">5.3.8.5 Hyperlinks in see and see also entries</h4> -<a name="index-hyperlinks_002c-see-and-see-also-index-entries"></a> -<a name="index-index_002c-hyperlinks-in-see-and-see-also-entries"></a> -<a name="index-see-also-index-entries-and-hyperlinks"></a> -<a name="index-see_002c-and-index-entries_002c-hyperlinks"></a> +<span id="index-hyperlinks_002c-see-and-see-also-index-entries"></span> +<span id="index-index_002c-hyperlinks-in-see-and-see-also-entries"></span> +<span id="index-see-also-index-entries-and-hyperlinks"></span> +<span id="index-see_002c-and-index-entries_002c-hyperlinks"></span> <p>There is no automatic support for hyperlinks with “see” and “see also” index entries, as there is not enough information to trace the parameters of -<a name="index-indexsee-1"></a> +<span id="index-indexsee-1"></span> <code>\indexsee</code> and -<a name="index-indexseealso-1"></a> +<span id="index-indexseealso-1"></span> <code>\indexseealso</code> to corresponding index entries. But if desired, this can be implemented with <code>\hldest</code> and <code>\hlstart</code> (see <a href="#Explicit-hyperlinks">Explicit hyperlinks</a>); for example: @@ -5480,39 +5330,37 @@ this can be implemented with <code>\hldest</code> and <code>\hlstart</code> <hr> -<a name="Footnote-hyperlinks"></a> -<div class="header"> +<span id="Footnote-hyperlinks"></span><div class="header"> <p> Next: <a href="#Contents-hyperlinks" accesskey="n" rel="next">Contents hyperlinks</a>, Previous: <a href="#Index-hyperlinks" accesskey="p" rel="prev">Index hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Footnote-hyperlinks_003a-foot_002c-footback"></a> -<h4 class="subsection">5.3.9 Footnote hyperlinks: foot, footback</h4> - -<a name="index-footnotes_002c-hyperlinks"></a> -<a name="index-hyperlinks_002c-footnotes"></a> -<a name="index-group-_0060foot_0027"></a> -<a name="index-group-_0060footback_0027"></a> -<a name="index-linkgroup-_0060foot_0027"></a> -<a name="index-linkgroup-_0060footback_0027"></a> -<a name="index-destgroup-_0060foot_0027"></a> -<a name="index-destgroup-_0060footback_0027"></a> +<span id="Footnote-hyperlinks_003a-foot_002c-footback"></span><h4 class="subsection">5.3.9 Footnote hyperlinks: foot, footback</h4> + +<span id="index-footnotes_002c-hyperlinks"></span> +<span id="index-hyperlinks_002c-footnotes"></span> +<span id="index-group-_0060foot_0027"></span> +<span id="index-group-_0060footback_0027"></span> +<span id="index-linkgroup-_0060foot_0027"></span> +<span id="index-linkgroup-_0060footback_0027"></span> +<span id="index-destgroup-_0060foot_0027"></span> +<span id="index-destgroup-_0060footback_0027"></span> <p>The ‘foot’ link and destination groups include the -<a name="index-numberedfootnote-_0028hyperlinks_0029"></a> +<span id="index-numberedfootnote-_0028hyperlinks_0029"></span> <code>\numberedfootnote</code> and -<a name="index-footnote-_0028hyperlinks_0029"></a> +<span id="index-footnote-_0028hyperlinks_0029"></span> <code>\footnote</code> macros (see <a href="#Footnotes">Footnotes</a>). The ‘footback’ groups include the same macros, but control parameters for links and destinations created inside the footnote to point back to the footnote mark within the text body. </p> <p>The macros use hyperlink labels generated by -<a name="index-hlfootlabel"></a> +<span id="index-hlfootlabel"></span> <code>\hlfootlabel</code> and -<a name="index-hlfootbacklabel"></a> +<span id="index-hlfootbacklabel"></span> <code>\hlfootbacklabel</code>. The default formats for the labels are ‘<samp>FOOT<var>number</var></samp>’ and ‘<samp>FOOTB<var>number</var></samp>’, respectively, where <var>number</var> is the value of the count register -<a name="index-hlfootlabelnumber"></a> +<span id="index-hlfootlabelnumber"></span> <code>\hlfootlabelnumber</code>. This register is incremented at every footnote. </p> @@ -5529,17 +5377,15 @@ hyperlinks (see <a href="#Turning-hyperlinks-on_002foff-for-a-group">Turning hyp <hr> -<a name="Contents-hyperlinks"></a> -<div class="header"> +<span id="Contents-hyperlinks"></span><div class="header"> <p> Previous: <a href="#Footnote-hyperlinks" accesskey="p" rel="prev">Footnote hyperlinks</a>, Up: <a href="#Implicit-hyperlinks" accesskey="u" rel="up">Implicit hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Contents-hyperlinks-1"></a> -<h4 class="subsection">5.3.10 Contents hyperlinks</h4> +<span id="Contents-hyperlinks-1"></span><h4 class="subsection">5.3.10 Contents hyperlinks</h4> -<a name="index-table-of-contents_002c-hyperlinks"></a> -<a name="index-contents_002c-hyperlinks"></a> -<a name="index-hyperlinks_002c-table-of-contents"></a> +<span id="index-table-of-contents_002c-hyperlinks"></span> +<span id="index-contents_002c-hyperlinks"></span> +<span id="index-hyperlinks_002c-table-of-contents"></span> <p>There is currently no special support for hyperlinks in the table of contents (see <a href="#Contents">Contents</a>), but implementing them with the <code>\hldest</code> and <code>\hlstart … \hlend</code> commands @@ -5547,13 +5393,11 @@ contents (see <a href="#Contents">Contents</a>), but implementing them with the </p> <hr> -<a name="Hyperlink-drivers"></a> -<div class="header"> +<span id="Hyperlink-drivers"></span><div class="header"> <p> Next: <a href="#Setting-hyperlink-types-and-options" accesskey="n" rel="next">Setting hyperlink types and options</a>, Previous: <a href="#Implicit-hyperlinks" accesskey="p" rel="prev">Implicit hyperlinks</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Hyperlink-drivers-1"></a> -<h3 class="section">5.4 Hyperlink drivers</h3> +<span id="Hyperlink-drivers-1"></span><h3 class="section">5.4 Hyperlink drivers</h3> <p>This section describes the hyperlink drivers: the types of hyperlinks they support, and the options they accept. During the first reading, @@ -5563,49 +5407,46 @@ you may only want to skim through this section. Reference Manual Version 1.3</cite>, March 11, 1999. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Options-supported-by-all-drivers" accesskey="1">Options supported by all drivers</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Options-supported-by-all-drivers" accesskey="1">Options supported by all drivers</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-driver-hypertex" accesskey="2">Hyperlink driver hypertex</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Hyperlink-driver-hypertex" accesskey="2">Hyperlink driver hypertex</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="3">Hyperlink drivers pdftex and dvipdfm</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="3">Hyperlink drivers pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hyperlink-driver-nolinks" accesskey="4">Hyperlink driver nolinks</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Hyperlink-driver-nolinks" accesskey="4">Hyperlink driver nolinks</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Options-supported-by-all-drivers"></a> -<div class="header"> +<span id="Options-supported-by-all-drivers"></span><div class="header"> <p> Next: <a href="#Hyperlink-driver-hypertex" accesskey="n" rel="next">Hyperlink driver hypertex</a>, Up: <a href="#Hyperlink-drivers" accesskey="u" rel="up">Hyperlink drivers</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Options-supported-by-all-drivers-1"></a> -<h4 class="subsection">5.4.1 Options supported by all drivers</h4> +<span id="Options-supported-by-all-drivers-1"></span><h4 class="subsection">5.4.1 Options supported by all drivers</h4> -<a name="index-hyperlink-options_002c-common"></a> +<span id="index-hyperlink-options_002c-common"></span> <p>This subsection describes the destination and link options which are supported by all hyperlink drivers. </p> -<a name="Destination-options-supported-by-all-drivers"></a> -<h4 class="subsubheading">Destination options supported by all drivers</h4> +<span id="Destination-options-supported-by-all-drivers"></span><h4 class="subsubheading">Destination options supported by all drivers</h4> -<a name="index-destination-options_002c-common"></a> -<a name="index-options_002c-destination_002c-common"></a> +<span id="index-destination-options_002c-common"></span> +<span id="index-options_002c-destination_002c-common"></span> <dl compact="compact"> <dt><code>raise</code></dt> -<dd><a name="index-raise-_0028hyperlink-option_0029"></a> -<a name="index-raising-hyperlink-destinations"></a> -<a name="index-hyperlink-destination_002c-raising"></a> -<a name="index-destinations_002c-raising"></a> +<dd><span id="index-raise-_0028hyperlink-option_0029"></span> +<span id="index-raising-hyperlink-destinations"></span> +<span id="index-hyperlink-destination_002c-raising"></span> +<span id="index-destinations_002c-raising"></span> <p>Specifies how much to raise destinations above the baseline. When set to zero or empty, destinations are placed at the baseline. </p> <p>It is usually convenient to set this option to some variable parameter, so that the height to which destinations are raised is automatically adjusted according to the current context. For example, setting it to -<a name="index-normalbaselineskip"></a> +<span id="index-normalbaselineskip"></span> <code>\normalbaselineskip</code> (or some fraction of it, like <code>1.7\normalbaselineskip</code>) makes the setting appropriate for different point sizes, in case your document uses more than one. @@ -5614,11 +5455,11 @@ different point sizes, in case your document uses more than one. destgroups do not define this option, so they fall back on the default, except for the ‘eq’ destgroup, for which this option is set to <code>1.7\normalbaselineskip</code>, -<a name="index-mathematics-displays_002c-hyperlinks"></a> -<a name="index-displayed-math-and-hyperlinks"></a> -<a name="index-large-operators-and-hyperlinks"></a> -<a name="index-hyperlinks_002c-large-operators"></a> -<a name="index-destinations_002c-large-operators"></a> +<span id="index-mathematics-displays_002c-hyperlinks"></span> +<span id="index-displayed-math-and-hyperlinks"></span> +<span id="index-large-operators-and-hyperlinks"></span> +<span id="index-hyperlinks_002c-large-operators"></span> +<span id="index-destinations_002c-large-operators"></span> to accommodate the usual cases of large operators in displayed math. </p> <p>Example: <code>\hldestopts[eq]{raise=2.5\normalbaselineskip}</code> @@ -5626,19 +5467,18 @@ to accommodate the usual cases of large operators in displayed math. </dl> -<a name="Link-options-supported-by-all-drivers"></a> -<h4 class="subsubheading">Link options supported by all drivers</h4> -<a name="index-link-options_002c-common"></a> -<a name="index-options_002c-link_002c-common"></a> +<span id="Link-options-supported-by-all-drivers"></span><h4 class="subsubheading">Link options supported by all drivers</h4> +<span id="index-link-options_002c-common"></span> +<span id="index-options_002c-link_002c-common"></span> <dl compact="compact"> <dt><code>colormodel</code></dt> <dt><code>color</code></dt> -<dd><a name="index-colormodel-_0028hyperlink-option_0029"></a> -<a name="index-color-_0028hyperlink-option_0029"></a> -<a name="index-color_002c-hyperlinks-1"></a> -<a name="index-colored-links-1"></a> -<a name="index-hyperlink-color-1"></a> +<dd><span id="index-colormodel-_0028hyperlink-option_0029"></span> +<span id="index-color-_0028hyperlink-option_0029"></span> +<span id="index-color_002c-hyperlinks-1"></span> +<span id="index-colored-links-1"></span> +<span id="index-hyperlink-color-1"></span> <p>These two options define the color to be used for rendering the link text. The colors are used only when a <code>\color</code> command is defined, e.g., by loading the LaTeX ‘color’ package (see <a href="#Packages-known-to-work">Packages known to work</a>). The <code>\color</code> command is called as @@ -5671,18 +5511,16 @@ an empty <var>colormodel</var> (see examples below). <hr> -<a name="Hyperlink-driver-hypertex"></a> -<div class="header"> +<span id="Hyperlink-driver-hypertex"></span><div class="header"> <p> Next: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="n" rel="next">Hyperlink drivers pdftex and dvipdfm</a>, Previous: <a href="#Options-supported-by-all-drivers" accesskey="p" rel="prev">Options supported by all drivers</a>, Up: <a href="#Hyperlink-drivers" accesskey="u" rel="up">Hyperlink drivers</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Hyperlink-driver-hypertex-1"></a> -<h4 class="subsection">5.4.2 Hyperlink driver <code>hypertex</code></h4> +<span id="Hyperlink-driver-hypertex-1"></span><h4 class="subsection">5.4.2 Hyperlink driver <code>hypertex</code></h4> -<a name="index-hypertex-_0028hyperlink-driver_0029"></a> -<a name="index-hypertex_002c-hyperlink-driver"></a> -<a name="index-driver-hypertex"></a> -<a name="index-hyperlink-driver-hypertex"></a> +<span id="index-hypertex-_0028hyperlink-driver_0029"></span> +<span id="index-hypertex_002c-hyperlink-driver"></span> +<span id="index-driver-hypertex"></span> +<span id="index-hyperlink-driver-hypertex"></span> <p>HyperTeX is a standard for inclusion of hyperlink information in TeX (and LaTeX) documents (see <a href="http://arxiv.org/hypertex">http://arxiv.org/hypertex</a>). This standard defines a set of hyperlink tags implemented as @@ -5690,16 +5528,16 @@ This standard defines a set of hyperlink tags implemented as major advantage of such standard is that a single <samp>.dvi</samp> file containing HyperTeX commands can be viewed by any HyperTeX-enabled viewer (e.g., any more or less modern version of -<a name="index-xdvi"></a> +<span id="index-xdvi"></span> <code>xdvi</code>) or converted to other file formats (e.g., <acronym>PDF</acronym>) by any HyperTeX-enabled <acronym>DVI</acronym> converter (e.g., -<a name="index-dvipdfm-1"></a> +<span id="index-dvipdfm-1"></span> <code>dvipdfmx</code> or -<a name="index-dvips"></a> +<span id="index-dvips"></span> <code>dvips</code> with -<a name="index-Ghostscript"></a> +<span id="index-Ghostscript"></span> Ghostscript’s -<a name="index-ps2pdf"></a> +<span id="index-ps2pdf"></span> <code>ps2pdf</code> script). </p> <p>The downside to the standard is that it is by design “the common @@ -5715,21 +5553,21 @@ please see </p> <div class="display"> <pre class="display"><a href="http://arxiv.org/hypertex">http://arxiv.org/hypertex</a> -<a href="http://www.tug.org/tex-archive/support/hypertex/hypertex">http://www.tug.org/tex-archive/support/hypertex/hypertex</a> +<a href="http://mirror.ctan.org/tex-archive/support/hypertex/hypertex">http://mirror.ctan.org/tex-archive/support/hypertex/hypertex</a> </pre></div> <p>For convenience, we list a few HyperTeX-enabled converters: </p> <dl compact="compact"> -<dd><a name="index-dvips-1"></a> +<dd><span id="index-dvips-1"></span> </dd> <dt><code>dvips</code></dt> <dd><p>Note that you need to pass the <samp>-z</samp> option to <code>dvips</code> to tell it to preserve the information about the hyperlinks. To generate a <samp>.pdf</samp> file with hyperlinks, you can use the -<a name="index-ps2pdf-1"></a> +<span id="index-ps2pdf-1"></span> <samp>ps2pdf</samp> script of -<a name="index-Ghostscript-1"></a> +<span id="index-Ghostscript-1"></span> Ghostscript. For example, if <samp>foo.tex</samp> is a TeX file using HyperTeX commands, then </p> @@ -5744,7 +5582,7 @@ prompt$ ps2pdf foo.ps </dd> <dt><code>dvipdfm</code></dt> <dt><code>dvipdfmx</code></dt> -<dd><a name="index-dvipdfm-2"></a> +<dd><span id="index-dvipdfm-2"></span> <p>No special command line arguments are required, these programs automatically detect the HyperTeX commands. </p> @@ -5764,48 +5602,46 @@ external local files, and produce a <acronym>URL</acronym> link instead of a file link. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Destination-types-for-hypertex" accesskey="1">Destination types for hypertex</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Destination-types-for-hypertex" accesskey="1">Destination types for hypertex</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Destination-options-for-hypertex" accesskey="2">Destination options for hypertex</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Destination-options-for-hypertex" accesskey="2">Destination options for hypertex</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Link-types-for-hypertex" accesskey="3">Link types for hypertex</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Link-types-for-hypertex" accesskey="3">Link types for hypertex</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Link-options-for-hypertex" accesskey="4">Link options for hypertex</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Link-options-for-hypertex" accesskey="4">Link options for hypertex</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Destination-types-for-hypertex"></a> -<div class="header"> +<span id="Destination-types-for-hypertex"></span><div class="header"> <p> Next: <a href="#Destination-options-for-hypertex" accesskey="n" rel="next">Destination options for hypertex</a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver hypertex</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Destination-types-for-hypertex-1"></a> -<h4 class="subsubsection">5.4.2.1 Destination types for <code>hypertex</code></h4> +<span id="Destination-types-for-hypertex-1"></span><h4 class="subsubsection">5.4.2.1 Destination types for <code>hypertex</code></h4> -<a name="index-destination-types_002c-hypertex"></a> -<a name="index-types_002c-destination_002c-hypertex"></a> -<a name="index-hypertex_002c-destination-types"></a> +<span id="index-destination-types_002c-hypertex"></span> +<span id="index-types_002c-destination_002c-hypertex"></span> +<span id="index-hypertex_002c-destination-types"></span> <dl compact="compact"> <dt><code>xyz</code></dt> -<dd><a name="index-xyz-_0028destination-type_0029"></a> +<dd><span id="index-xyz-_0028destination-type_0029"></span> <p>“Current position”. This is the default type. </p> <p>Example: <code>\hldest{xyz}{}{dest123}</code> </p> </dd> <dt><code>raw</code></dt> -<dd><a name="index-raw-_0028destination-type_0029"></a> +<dd><span id="index-raw-_0028destination-type_0029"></span> <p>The destination specification (in the form of a HyperTeX <code>\special</code>) is taken from the command sequence <code>\<var>cs</var></code>, where <var>cs</var> is the value of the -<a name="index-cmd-_0028destination-option_0029"></a> +<span id="index-cmd-_0028destination-option_0029"></span> <code>cmd</code> option. In the definition of <code>\<var>cs</var></code>, use -<a name="index-_0040hllabel"></a> +<span id="index-_0040hllabel"></span> <code>\@hllabel</code> to refer to the hyperlink label. This option is intended to be used with destgroups (see <a href="#Setting-hyperlink-types-and-options">Setting hyperlink types and options</a>), as it does not make sense in a direct call to -<a name="index-hldest-1"></a> +<span id="index-hldest-1"></span> <code>\hldest</code>—you can just call the raw command. </p> <p>Example: @@ -5824,20 +5660,18 @@ intended to be used with destgroups (see <a href="#Setting-hyperlink-types-and-o <hr> -<a name="Destination-options-for-hypertex"></a> -<div class="header"> +<span id="Destination-options-for-hypertex"></span><div class="header"> <p> Next: <a href="#Link-types-for-hypertex" accesskey="n" rel="next">Link types for hypertex</a>, Previous: <a href="#Destination-types-for-hypertex" accesskey="p" rel="prev">Destination types for hypertex</a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver hypertex</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Destination-options-for-hypertex-1"></a> -<h4 class="subsubsection">5.4.2.2 Destination options for <code>hypertex</code></h4> +<span id="Destination-options-for-hypertex-1"></span><h4 class="subsubsection">5.4.2.2 Destination options for <code>hypertex</code></h4> -<a name="index-destination-options_002c-hypertex"></a> -<a name="index-options_002c-destination_002c-hypertex"></a> -<a name="index-hypertex_002c-destination-options"></a> +<span id="index-destination-options_002c-hypertex"></span> +<span id="index-options_002c-destination_002c-hypertex"></span> +<span id="index-hypertex_002c-destination-options"></span> <dl compact="compact"> <dt><code>cmd</code></dt> -<dd><a name="index-cmd-_0028destination-option_0029-1"></a> +<dd><span id="index-cmd-_0028destination-option_0029-1"></span> <p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a HyperTeX <code>\special</code> for the <code>raw</code> destination. </p> @@ -5848,23 +5682,21 @@ destination, for an example. <hr> -<a name="Link-types-for-hypertex"></a> -<div class="header"> +<span id="Link-types-for-hypertex"></span><div class="header"> <p> Next: <a href="#Link-options-for-hypertex" accesskey="n" rel="next">Link options for hypertex</a>, Previous: <a href="#Destination-options-for-hypertex" accesskey="p" rel="prev">Destination options for hypertex</a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver hypertex</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Link-types-for-hypertex-1"></a> -<h4 class="subsubsection">5.4.2.3 Link types for <code>hypertex</code></h4> +<span id="Link-types-for-hypertex-1"></span><h4 class="subsubsection">5.4.2.3 Link types for <code>hypertex</code></h4> -<a name="index-link-types_002c-hypertex"></a> -<a name="index-types_002c-link_002c-hypertex"></a> -<a name="index-hypertex_002c-link-types"></a> +<span id="index-link-types_002c-hypertex"></span> +<span id="index-types_002c-link_002c-hypertex"></span> +<span id="index-hypertex_002c-link-types"></span> <dl compact="compact"> <dt><code>name</code></dt> -<dd><a name="index-name-_0028hyperlink-type_0029"></a> -<a name="index-named-destination"></a> -<a name="index-destinations_002c-named"></a> -<a name="index-hyperlink-destination_002c-named"></a> +<dd><span id="index-name-_0028hyperlink-type_0029"></span> +<span id="index-named-destination"></span> +<span id="index-destinations_002c-named"></span> +<span id="index-hyperlink-destination_002c-named"></span> <p>Go to a “named destination”. The label is the destination name. All destinations in HyperTeX are named destinations. This is the default type. @@ -5873,30 +5705,30 @@ type. </p> </dd> <dt><code>url</code></dt> -<dd><a name="index-url-_0028hyperlink-type_0029"></a> -<a name="index-URL-hyperlink-2"></a> -<a name="index-destinations_002c-URL"></a> -<a name="index-hyperlinks_002c-URL-2"></a> +<dd><span id="index-url-_0028hyperlink-type_0029"></span> +<span id="index-URL-hyperlink-2"></span> +<span id="index-destinations_002c-URL"></span> +<span id="index-hyperlinks_002c-URL-2"></span> <p>Go to a <acronym>URL</acronym>. The label is the <acronym>URL</acronym>. </p> <p>Example: </p> <div class="example"> -<pre class="example"><code>\hlstart{url}{}{http://tug.org/eplain/}Eplain home\hlend</code> +<pre class="example"><code>\hlstart{url}{}{https://tug.org/eplain/}Eplain home\hlend</code> </pre></div> </dd> <dt><code>filename</code></dt> -<dd><a name="index-filename-_0028hyperlink-type_0029"></a> -<a name="index-file_002c-hyperlink-to"></a> -<a name="index-destinations_002c-in-another-file"></a> -<a name="index-hyperlinks_002c-to-another-file"></a> +<dd><span id="index-filename-_0028hyperlink-type_0029"></span> +<span id="index-file_002c-hyperlink-to"></span> +<span id="index-destinations_002c-in-another-file"></span> +<span id="index-hyperlinks_002c-to-another-file"></span> <p>Go to a named destination in another file. The label is the destination name. The file name is specified by the -<a name="index-file-_0028hyperlink-option_0029"></a> +<span id="index-file-_0028hyperlink-option_0029"></span> <code>file</code> option. The file name extension can be specified separately by the -<a name="index-ext-_0028hyperlink-option_0029"></a> +<span id="index-ext-_0028hyperlink-option_0029"></span> <code>ext</code> option. The idea is to set the <code>ext</code> option globally at the beginning of the document to avoid hard-coding the extension together with the file name within each link—HyperTeX is not @@ -5913,19 +5745,19 @@ restricted to any single output format, it can be <acronym>DVI</acronym>, </dd> <dt><code>raw</code></dt> -<dd><a name="index-raw-_0028hyperlink-type_0029"></a> +<dd><span id="index-raw-_0028hyperlink-type_0029"></span> <p>The link specification (in the form of a HyperTeX <code>\special</code>) is taken from the command sequence <code>\<var>cs</var></code>, where <var>cs</var> is the value of the -<a name="index-cmd-_0028hyperlink-option_0029"></a> +<span id="index-cmd-_0028hyperlink-option_0029"></span> <code>cmd</code> option. In the definition of <code>\<var>cs</var></code>, use -<a name="index-_0040hllabel-1"></a> +<span id="index-_0040hllabel-1"></span> <code>\@hllabel</code> to refer to the hyperlink label. Use the predefined command -<a name="index-hlhash"></a> +<span id="index-hlhash"></span> <code>\hlhash</code> to insert the <code>#</code> characters. This option is intended to be used with linkgroups (see <a href="#Setting-hyperlink-types-and-options">Setting hyperlink types and options</a>), as it does not make sense in a direct call to -<a name="index-hlstart-1"></a> +<span id="index-hlstart-1"></span> <code>\hlstart</code>—you can just call the raw command. </p> <p>Example: @@ -5943,20 +5775,18 @@ intended to be used with linkgroups (see <a href="#Setting-hyperlink-types-and-o <hr> -<a name="Link-options-for-hypertex"></a> -<div class="header"> +<span id="Link-options-for-hypertex"></span><div class="header"> <p> Previous: <a href="#Link-types-for-hypertex" accesskey="p" rel="prev">Link types for hypertex</a>, Up: <a href="#Hyperlink-driver-hypertex" accesskey="u" rel="up">Hyperlink driver hypertex</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Link-options-for-hypertex-1"></a> -<h4 class="subsubsection">5.4.2.4 Link options for <code>hypertex</code></h4> +<span id="Link-options-for-hypertex-1"></span><h4 class="subsubsection">5.4.2.4 Link options for <code>hypertex</code></h4> -<a name="index-link-options_002c-hypertex"></a> -<a name="index-options_002c-link_002c-hypertex"></a> -<a name="index-hypertex_002c-link-options"></a> +<span id="index-link-options_002c-hypertex"></span> +<span id="index-options_002c-link_002c-hypertex"></span> +<span id="index-hypertex_002c-link-options"></span> <dl compact="compact"> <dt><code>cmd</code></dt> -<dd><a name="index-cmd-_0028hyperlink-option_0029-1"></a> +<dd><span id="index-cmd-_0028hyperlink-option_0029-1"></span> <p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a HyperTeX <code>\special</code> for the <code>raw</code> link. </p> @@ -5965,7 +5795,7 @@ for an example. </p> </dd> <dt><code>file</code></dt> -<dd><a name="index-file-_0028hyperlink-option_0029-1"></a> +<dd><span id="index-file-_0028hyperlink-option_0029-1"></span> <p>File name for the <code>filename</code> link type. See also the <code>ext</code> option. </p> @@ -5974,7 +5804,7 @@ link, for an example. </p> </dd> <dt><code>ext</code></dt> -<dd><a name="index-ext-_0028hyperlink-option_0029-1"></a> +<dd><span id="index-ext-_0028hyperlink-option_0029-1"></span> <p>File name extension for the <code>filename</code> link type. The idea is to set the <code>ext</code> option globally at the beginning of the document to avoid hard-coding the extension together with the file name within each @@ -5988,67 +5818,63 @@ link, for an example. <hr> -<a name="Hyperlink-drivers-pdftex-and-dvipdfm"></a> -<div class="header"> +<span id="Hyperlink-drivers-pdftex-and-dvipdfm"></span><div class="header"> <p> Next: <a href="#Hyperlink-driver-nolinks" accesskey="n" rel="next">Hyperlink driver nolinks</a>, Previous: <a href="#Hyperlink-driver-hypertex" accesskey="p" rel="prev">Hyperlink driver hypertex</a>, Up: <a href="#Hyperlink-drivers" accesskey="u" rel="up">Hyperlink drivers</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Hyperlink-drivers-pdftex-and-dvipdfm-1"></a> -<h4 class="subsection">5.4.3 Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></h4> - -<a name="index-pdftex-_0028hyperlink-driver_0029"></a> -<a name="index-dvipdfm-_0028hyperlink-driver_0029"></a> -<a name="index-pdftex_002c-hyperlink-driver"></a> -<a name="index-dvipdfm_002c-hyperlink-driver"></a> -<a name="index-driver-pdftex"></a> -<a name="index-driver-dvipdfm"></a> -<a name="index-hyperlink-driver-pdftex"></a> -<a name="index-hyperlink-driver-dvipdfm"></a> +<span id="Hyperlink-drivers-pdftex-and-dvipdfm-1"></span><h4 class="subsection">5.4.3 Hyperlink drivers <code>pdftex</code> and <code>dvipdfm</code></h4> + +<span id="index-pdftex-_0028hyperlink-driver_0029"></span> +<span id="index-dvipdfm-_0028hyperlink-driver_0029"></span> +<span id="index-pdftex_002c-hyperlink-driver"></span> +<span id="index-dvipdfm_002c-hyperlink-driver"></span> +<span id="index-driver-pdftex"></span> +<span id="index-driver-dvipdfm"></span> +<span id="index-hyperlink-driver-pdftex"></span> +<span id="index-hyperlink-driver-dvipdfm"></span> <p>This subsection describes link and destination types and options supported by the <code>pdftex</code> and <code>dvipdfm</code> drivers. Many of the hyperlink types and options are common to both drivers, so we describe them together. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Destination-types-for-pdftex-and-dvipdfm" accesskey="1">Destination types for pdftex and dvipdfm</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Destination-types-for-pdftex-and-dvipdfm" accesskey="1">Destination types for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="2">Destination options for pdftex and dvipdfm</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="2">Destination options for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="3">Link types for pdftex and dvipdfm</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="3">Link types for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Link-options-for-pdftex-and-dvipdfm" accesskey="4">Link options for pdftex and dvipdfm</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Link-options-for-pdftex-and-dvipdfm" accesskey="4">Link options for pdftex and dvipdfm</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Destination-types-for-pdftex-and-dvipdfm"></a> -<div class="header"> +<span id="Destination-types-for-pdftex-and-dvipdfm"></span><div class="header"> <p> Next: <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Destination options for pdftex and dvipdfm</a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers pdftex and dvipdfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Destination-types-for-pdftex-and-dvipdfm-1"></a> -<h4 class="subsubsection">5.4.3.1 Destination types for <code>pdftex</code> and <code>dvipdfm</code></h4> - -<a name="index-destination-types_002c-pdftex"></a> -<a name="index-destination-types_002c-dvipdfm"></a> -<a name="index-types_002c-destination_002c-pdftex"></a> -<a name="index-types_002c-destination_002c-dvipdfm"></a> -<a name="index-pdftex_002c-destination-types"></a> -<a name="index-dvipdfm_002c-destination-types"></a> +<span id="Destination-types-for-pdftex-and-dvipdfm-1"></span><h4 class="subsubsection">5.4.3.1 Destination types for <code>pdftex</code> and <code>dvipdfm</code></h4> + +<span id="index-destination-types_002c-pdftex"></span> +<span id="index-destination-types_002c-dvipdfm"></span> +<span id="index-types_002c-destination_002c-pdftex"></span> +<span id="index-types_002c-destination_002c-dvipdfm"></span> +<span id="index-pdftex_002c-destination-types"></span> +<span id="index-dvipdfm_002c-destination-types"></span> <dl compact="compact"> <dt><code>xyz</code></dt> -<dd><a name="index-xyz-_0028destination-type_0029-1"></a> +<dd><span id="index-xyz-_0028destination-type_0029-1"></span> <p>“Current position”. The option -<a name="index-zoom-_0028destination-option_0029"></a> +<span id="index-zoom-_0028destination-option_0029"></span> <code>zoom</code> specifies magnification to use (zero or empty means leave magnification unchanged, which is the default). This is the default type. </p> <p>For <code>dvipdfm</code>: the options -<a name="index-left-_0028destination-option_0029"></a> +<span id="index-left-_0028destination-option_0029"></span> <code>left</code> and -<a name="index-top-_0028destination-option_0029"></a> +<span id="index-top-_0028destination-option_0029"></span> <code>top</code> specify position coordinates to use (empty options mean current position coordinate, which is the default). </p> @@ -6056,18 +5882,18 @@ current position coordinate, which is the default). </p> </dd> <dt><code>fit</code></dt> -<dd><a name="index-fit-_0028destination-type_0029"></a> +<dd><span id="index-fit-_0028destination-type_0029"></span> <p>Fit the page to the window. </p> <p>Example: <code>\hldest{fit}{}{dest123}</code> </p> </dd> <dt><code>fith</code></dt> -<dd><a name="index-fith-_0028destination-type_0029"></a> +<dd><span id="index-fith-_0028destination-type_0029"></span> <p>Fit the width of the page to the window. </p> <p>For <code>dvipdfm</code>: the -<a name="index-top-_0028destination-option_0029-1"></a> +<span id="index-top-_0028destination-option_0029-1"></span> <code>top</code> option specifies vertical position (default is empty, meaning current position). </p> @@ -6075,11 +5901,11 @@ current position). </p> </dd> <dt><code>fitv</code></dt> -<dd><a name="index-fitv-_0028destination-type_0029"></a> +<dd><span id="index-fitv-_0028destination-type_0029"></span> <p>Fit the height of the page to the window. </p> <p>For <code>dvipdfm</code>: The option -<a name="index-left-_0028destination-option_0029-1"></a> +<span id="index-left-_0028destination-option_0029-1"></span> <code>left</code> specifies horizontal position (default is empty, meaning current position). </p> @@ -6087,18 +5913,18 @@ current position). </p> </dd> <dt><code>fitb</code></dt> -<dd><a name="index-fitb-_0028destination-type_0029"></a> +<dd><span id="index-fitb-_0028destination-type_0029"></span> <p>Fit the page’s bounding box to the window. </p> <p>Example: <code>\hldest{fitb}{}{dest123}</code> </p> </dd> <dt><code>fitbh</code></dt> -<dd><a name="index-fitbh-_0028destination-type_0029"></a> +<dd><span id="index-fitbh-_0028destination-type_0029"></span> <p>Fit the width of the page’s bounding box to the window. </p> <p>For <code>dvipdfm</code>: the option -<a name="index-top-_0028destination-option_0029-2"></a> +<span id="index-top-_0028destination-option_0029-2"></span> <code>top</code> specifies vertical position (default is empty, meaning current position). </p> @@ -6106,11 +5932,11 @@ current position). </p> </dd> <dt><code>fitbv</code></dt> -<dd><a name="index-fitbv-_0028destination-type_0029"></a> +<dd><span id="index-fitbv-_0028destination-type_0029"></span> <p>Fit the height of the page’s bounding box to the window. </p> <p>For <code>dvipdfm</code>: the option -<a name="index-left-_0028destination-option_0029-2"></a> +<span id="index-left-_0028destination-option_0029-2"></span> <code>left</code> specifies horizontal position (default is empty, meaning current position). </p> @@ -6118,27 +5944,27 @@ current position). </p> </dd> <dt><code>fitr</code></dt> -<dd><a name="index-fitr-_0028destination-type_0029"></a> +<dd><span id="index-fitr-_0028destination-type_0029"></span> <p>For <code>pdftex</code>: fit the rectangle specified by the options -<a name="index-width-_0028destination-option_0029"></a> +<span id="index-width-_0028destination-option_0029"></span> <code>width</code>, -<a name="index-height-_0028destination-option_0029"></a> +<span id="index-height-_0028destination-option_0029"></span> <code>height</code> and -<a name="index-depth-_0028destination-option_0029"></a> +<span id="index-depth-_0028destination-option_0029"></span> <code>depth</code> (as a TeX rule specification) in the window. For dimensions set to empty, the corresponding value of the parent box is used (these are the defaults). </p> <p>For <code>dvipdfm</code>: fit the rectangle specified by the options -<a name="index-left-_0028destination-option_0029-3"></a> +<span id="index-left-_0028destination-option_0029-3"></span> <code>left</code>, -<a name="index-bottom-_0028destination-option_0029"></a> +<span id="index-bottom-_0028destination-option_0029"></span> <code>bottom</code>, -<a name="index-right-_0028destination-option_0029"></a> +<span id="index-right-_0028destination-option_0029"></span> <code>right</code> and -<a name="index-top-_0028destination-option_0029-3"></a> +<span id="index-top-_0028destination-option_0029-3"></span> <code>top</code> (in -<a name="index-PostScript-point"></a> +<span id="index-PostScript-point"></span> PostScript points, 72 points per inch) in the window. For dimensions set to empty, current position coordinate is substituted (these are the defaults). @@ -6159,16 +5985,16 @@ dimensions set to empty, current position coordinate is substituted </dd> <dt><code>raw</code></dt> -<dd><a name="index-raw-_0028destination-type_0029-1"></a> +<dd><span id="index-raw-_0028destination-type_0029-1"></span> <p>The destination specification (in the form of a pdfTeX command or a dvipdfm <code>\special</code>) is taken from the command sequence <code>\<var>cs</var></code>, where <var>cs</var> is the value of the -<a name="index-cmd-_0028destination-option_0029-2"></a> +<span id="index-cmd-_0028destination-option_0029-2"></span> <code>cmd</code> option. In the definition of <code>\<var>cs</var></code>, use -<a name="index-_0040hllabel-2"></a> +<span id="index-_0040hllabel-2"></span> <code>\@hllabel</code> to refer to the hyperlink label. This option is intended to be used with destgroups (see <a href="#Setting-hyperlink-types-and-options">Setting hyperlink types and options</a>), as it does not make sense in a direct call to -<a name="index-hldest-2"></a> +<span id="index-hldest-2"></span> <code>\hldest</code>—you can just call the raw command. </p> <p>Example for <code>pdftex</code>: @@ -6196,32 +6022,29 @@ intended to be used with destgroups (see <a href="#Setting-hyperlink-types-and-o <hr> -<a name="Destination-options-for-pdftex-and-dvipdfm"></a> -<div class="header"> +<span id="Destination-options-for-pdftex-and-dvipdfm"></span><div class="header"> <p> Next: <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Link types for pdftex and dvipdfm</a>, Previous: <a href="#Destination-types-for-pdftex-and-dvipdfm" accesskey="p" rel="prev">Destination types for pdftex and dvipdfm</a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers pdftex and dvipdfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Destination-options-for-pdftex-and-dvipdfm-1"></a> -<h4 class="subsubsection">5.4.3.2 Destination options for <code>pdftex</code> and <code>dvipdfm</code></h4> - -<a name="index-destination-options_002c-pdftex"></a> -<a name="index-destination-options_002c-dvipdfm"></a> -<a name="index-options_002c-destination_002c-pdftex"></a> -<a name="index-options_002c-destination_002c-dvipdfm"></a> -<a name="index-pdftex_002c-destination-options"></a> -<a name="index-dvipdfm_002c-destination-options"></a> +<span id="Destination-options-for-pdftex-and-dvipdfm-1"></span><h4 class="subsubsection">5.4.3.2 Destination options for <code>pdftex</code> and <code>dvipdfm</code></h4> + +<span id="index-destination-options_002c-pdftex"></span> +<span id="index-destination-options_002c-dvipdfm"></span> +<span id="index-options_002c-destination_002c-pdftex"></span> +<span id="index-options_002c-destination_002c-dvipdfm"></span> +<span id="index-pdftex_002c-destination-options"></span> +<span id="index-dvipdfm_002c-destination-options"></span> <p>With respect to the destination options, the <code>pdftex</code> and <code>dvipdfm</code> differ in the way the fit rectangle is specified (relative coordinates for <code>pdftex</code>, absolute coordinates for <code>dvipdfm</code>). </p> -<a name="Common-destination-options"></a> -<h4 class="subsubheading">Common destination options</h4> +<span id="Common-destination-options"></span><h4 class="subsubheading">Common destination options</h4> <dl compact="compact"> <dt><code>cmd</code></dt> -<dd><a name="index-cmd-_0028destination-option_0029-3"></a> +<dd><span id="index-cmd-_0028destination-option_0029-3"></span> <p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a pdfTeX command or a dvipdfm <code>\special</code> for the <code>raw</code> destination. @@ -6231,11 +6054,11 @@ destination. </p> </dd> <dt><code>zoom</code></dt> -<dd><a name="index-zoom-_0028destination-option_0029-1"></a> -<a name="index-destinations_002c-magnification"></a> -<a name="index-hyperlink-destination_002c-magnification"></a> -<a name="index-magnification_002c-hyperlink-destination"></a> -<a name="index-zooming_002c-hyperlink-destination"></a> +<dd><span id="index-zoom-_0028destination-option_0029-1"></span> +<span id="index-destinations_002c-magnification"></span> +<span id="index-hyperlink-destination_002c-magnification"></span> +<span id="index-magnification_002c-hyperlink-destination"></span> +<span id="index-zooming_002c-hyperlink-destination"></span> <p>Magnification ratio times 1000 (like TeX’s scale factor). Zero or empty means leave magnification unchanged, which is the default. @@ -6245,8 +6068,7 @@ default. </dl> -<a name="pdftex_002dspecific-destination-options"></a> -<h4 class="subsubheading"><code>pdftex</code>-specific destination options</h4> +<span id="pdftex_002dspecific-destination-options"></span><h4 class="subsubheading"><code>pdftex</code>-specific destination options</h4> <p>The dimension options below must be specified as a TeX rule specification. When set to empty, the corresponding value @@ -6255,26 +6077,26 @@ options). </p> <dl compact="compact"> <dt><code>depth</code></dt> -<dd><a name="index-depth-_0028destination-option_0029-1"></a> -<a name="index-destinations_002c-dimensions"></a> -<a name="index-hyperlink-destination_002c-dimensions"></a> -<a name="index-dimensions_002c-hyperlink-destination"></a> +<dd><span id="index-depth-_0028destination-option_0029-1"></span> +<span id="index-destinations_002c-dimensions"></span> +<span id="index-hyperlink-destination_002c-dimensions"></span> +<span id="index-dimensions_002c-hyperlink-destination"></span> <p>Depth of the fit rectangle for the <code>fitr</code> destination. </p> </dd> <dt><code>height</code></dt> -<dd><a name="index-height-_0028destination-option_0029-1"></a> -<a name="index-destinations_002c-dimensions-1"></a> -<a name="index-hyperlink-destination_002c-dimensions-1"></a> -<a name="index-dimensions_002c-hyperlink-destination-1"></a> +<dd><span id="index-height-_0028destination-option_0029-1"></span> +<span id="index-destinations_002c-dimensions-1"></span> +<span id="index-hyperlink-destination_002c-dimensions-1"></span> +<span id="index-dimensions_002c-hyperlink-destination-1"></span> <p>Height of the fit rectangle for the <code>fitr</code> destination. </p> </dd> <dt><code>width</code></dt> -<dd><a name="index-width-_0028destination-option_0029-1"></a> -<a name="index-destinations_002c-dimensions-2"></a> -<a name="index-hyperlink-destination_002c-dimensions-2"></a> -<a name="index-dimensions_002c-hyperlink-destination-2"></a> +<dd><span id="index-width-_0028destination-option_0029-1"></span> +<span id="index-destinations_002c-dimensions-2"></span> +<span id="index-hyperlink-destination_002c-dimensions-2"></span> +<span id="index-dimensions_002c-hyperlink-destination-2"></span> <p>Width of the fit rectangle for the <code>fitr</code> destination. </p> <p>Example: @@ -6287,48 +6109,47 @@ options). </dl> -<a name="dvipdfm_002dspecific-destination-options"></a> -<h4 class="subsubheading"><code>dvipdfm</code>-specific destination options</h4> +<span id="dvipdfm_002dspecific-destination-options"></span><h4 class="subsubheading"><code>dvipdfm</code>-specific destination options</h4> <p>The dimension options below must be specified in -<a name="index-PostScript-point-1"></a> +<span id="index-PostScript-point-1"></span> PostScript points (72 points per inch), as a number without the ‘<samp>bp</samp>’ unit name. When set to empty, the current position coordinate is used (this is the default for all dimension options). </p> <dl compact="compact"> <dt><code>bottom</code></dt> -<dd><a name="index-bottom-_0028destination-option_0029-1"></a> -<a name="index-destinations_002c-dimensions-3"></a> -<a name="index-hyperlink-destination_002c-dimensions-3"></a> -<a name="index-dimensions_002c-hyperlink-destination-3"></a> +<dd><span id="index-bottom-_0028destination-option_0029-1"></span> +<span id="index-destinations_002c-dimensions-3"></span> +<span id="index-hyperlink-destination_002c-dimensions-3"></span> +<span id="index-dimensions_002c-hyperlink-destination-3"></span> <p>Bottom position coordinate of a box specification for the various destination types. </p> </dd> <dt><code>left</code></dt> -<dd><a name="index-left-_0028destination-option_0029-4"></a> -<a name="index-destinations_002c-dimensions-4"></a> -<a name="index-hyperlink-destination_002c-dimensions-4"></a> -<a name="index-dimensions_002c-hyperlink-destination-4"></a> +<dd><span id="index-left-_0028destination-option_0029-4"></span> +<span id="index-destinations_002c-dimensions-4"></span> +<span id="index-hyperlink-destination_002c-dimensions-4"></span> +<span id="index-dimensions_002c-hyperlink-destination-4"></span> <p>Left position coordinate of a box specification for the various destination types. </p> </dd> <dt><code>right</code></dt> -<dd><a name="index-right-_0028destination-option_0029-1"></a> -<a name="index-destinations_002c-dimensions-5"></a> -<a name="index-hyperlink-destination_002c-dimensions-5"></a> -<a name="index-dimensions_002c-hyperlink-destination-5"></a> +<dd><span id="index-right-_0028destination-option_0029-1"></span> +<span id="index-destinations_002c-dimensions-5"></span> +<span id="index-hyperlink-destination_002c-dimensions-5"></span> +<span id="index-dimensions_002c-hyperlink-destination-5"></span> <p>Right position coordinate of a box specification for the various destination types. </p> </dd> <dt><code>top</code></dt> -<dd><a name="index-top-_0028destination-option_0029-4"></a> -<a name="index-destinations_002c-dimensions-6"></a> -<a name="index-hyperlink-destination_002c-dimensions-6"></a> -<a name="index-dimensions_002c-hyperlink-destination-6"></a> +<dd><span id="index-top-_0028destination-option_0029-4"></span> +<span id="index-destinations_002c-dimensions-6"></span> +<span id="index-hyperlink-destination_002c-dimensions-6"></span> +<span id="index-dimensions_002c-hyperlink-destination-6"></span> <p>Top position coordinate of a box specification for the various destination types. </p> @@ -6343,20 +6164,18 @@ destination types. <hr> -<a name="Link-types-for-pdftex-and-dvipdfm"></a> -<div class="header"> +<span id="Link-types-for-pdftex-and-dvipdfm"></span><div class="header"> <p> Next: <a href="#Link-options-for-pdftex-and-dvipdfm" accesskey="n" rel="next">Link options for pdftex and dvipdfm</a>, Previous: <a href="#Destination-options-for-pdftex-and-dvipdfm" accesskey="p" rel="prev">Destination options for pdftex and dvipdfm</a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers pdftex and dvipdfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Link-types-for-pdftex-and-dvipdfm-1"></a> -<h4 class="subsubsection">5.4.3.3 Link types for <code>pdftex</code> and <code>dvipdfm</code></h4> - -<a name="index-link-types_002c-pdftex"></a> -<a name="index-link-types_002c-dvipdfm"></a> -<a name="index-types_002c-link_002c-pdftex"></a> -<a name="index-types_002c-link_002c-dvipdfm"></a> -<a name="index-pdftex_002c-link-types"></a> -<a name="index-dvipdfm_002c-link-types"></a> +<span id="Link-types-for-pdftex-and-dvipdfm-1"></span><h4 class="subsubsection">5.4.3.3 Link types for <code>pdftex</code> and <code>dvipdfm</code></h4> + +<span id="index-link-types_002c-pdftex"></span> +<span id="index-link-types_002c-dvipdfm"></span> +<span id="index-types_002c-link_002c-pdftex"></span> +<span id="index-types_002c-link_002c-dvipdfm"></span> +<span id="index-pdftex_002c-link-types"></span> +<span id="index-dvipdfm_002c-link-types"></span> <p>Link types are the same for the <code>pdftex</code> and <code>dvipdfm</code> drivers, except that the <code>pdftex</code> driver provides one additional link type <code>num</code> (link to a numbered destination). dvipdfm does not @@ -6366,15 +6185,14 @@ named destinations; to define a numbered destination, you have to use low-level pdfTeX commands. </p> -<a name="Common-link-types"></a> -<h4 class="subsubheading">Common link types</h4> +<span id="Common-link-types"></span><h4 class="subsubheading">Common link types</h4> <dl compact="compact"> <dt><code>name</code></dt> -<dd><a name="index-name-_0028hyperlink-type_0029-1"></a> -<a name="index-named-destination-1"></a> -<a name="index-destinations_002c-named-1"></a> -<a name="index-hyperlink-destination_002c-named-1"></a> +<dd><span id="index-name-_0028hyperlink-type_0029-1"></span> +<span id="index-named-destination-1"></span> +<span id="index-destinations_002c-named-1"></span> +<span id="index-hyperlink-destination_002c-named-1"></span> <p>Go to a “named destination”. The label is the destination name. All destinations created with <code>\hldest</code> are named destinations (see <a href="#Explicit-hyperlinks">Explicit hyperlinks</a>). This is the default type. @@ -6383,23 +6201,23 @@ All destinations created with <code>\hldest</code> are named destinations </p> </dd> <dt><code>url</code></dt> -<dd><a name="index-url-_0028hyperlink-type_0029-1"></a> -<a name="index-URL-hyperlink-3"></a> -<a name="index-destinations_002c-URL-1"></a> -<a name="index-hyperlinks_002c-URL-3"></a> +<dd><span id="index-url-_0028hyperlink-type_0029-1"></span> +<span id="index-URL-hyperlink-3"></span> +<span id="index-destinations_002c-URL-1"></span> +<span id="index-hyperlinks_002c-URL-3"></span> <p>Go to a <acronym>URL</acronym>. The label is the <acronym>URL</acronym>. </p> -<p>Example: <code>\hlstart{url}{}{http://tug.org/eplain/}Eplain home\hlend</code> +<p>Example: <code>\hlstart{url}{}{https://tug.org/eplain/}Eplain home\hlend</code> </p> </dd> <dt><code>page</code></dt> -<dd><a name="index-page-_0028hyperlink-type_0029"></a> -<a name="index-page-destination"></a> -<a name="index-destinations_002c-page"></a> -<a name="index-hyperlink-destination_002c-page"></a> +<dd><span id="index-page-_0028hyperlink-type_0029"></span> +<span id="index-page-destination"></span> +<span id="index-destinations_002c-page"></span> +<span id="index-hyperlink-destination_002c-page"></span> <p>Go to a page. The label is the page number (counting from 1). Page fitting is specified by the -<a name="index-pagefit-_0028hyperlink-option_0029"></a> +<span id="index-pagefit-_0028hyperlink-option_0029"></span> <code>pagefit</code> option. </p> <p>Example: @@ -6411,17 +6229,17 @@ Page fitting is specified by the </dd> <dt><code>filename</code></dt> -<dd><a name="index-filename-_0028hyperlink-type_0029-1"></a> -<a name="index-file_002c-hyperlink-to-1"></a> -<a name="index-destinations_002c-in-another-file-1"></a> -<a name="index-hyperlinks_002c-to-another-file-1"></a> +<dd><span id="index-filename-_0028hyperlink-type_0029-1"></span> +<span id="index-file_002c-hyperlink-to-1"></span> +<span id="index-destinations_002c-in-another-file-1"></span> +<span id="index-hyperlinks_002c-to-another-file-1"></span> <p>Go to a named destination in another file. The label is the destination name. The file name is specified by the -<a name="index-file-_0028hyperlink-option_0029-2"></a> +<span id="index-file-_0028hyperlink-option_0029-2"></span> <code>file</code> option. Page fitting is specified by the -<a name="index-pagefit-_0028hyperlink-option_0029-1"></a> +<span id="index-pagefit-_0028hyperlink-option_0029-1"></span> <code>pagefit</code> option. The -<a name="index-newwin-_0028hyperlink-option_0029"></a> +<span id="index-newwin-_0028hyperlink-option_0029"></span> <code>newwin</code> option specifies whether the destination document is opened in the same window or in a new window. </p> @@ -6434,17 +6252,17 @@ opened in the same window or in a new window. </dd> <dt><code>filepage</code></dt> -<dd><a name="index-filepage-_0028hyperlink-type_0029"></a> -<a name="index-file_002c-hyperlink-to-2"></a> -<a name="index-destinations_002c-in-another-file-2"></a> -<a name="index-hyperlinks_002c-to-another-file-2"></a> +<dd><span id="index-filepage-_0028hyperlink-type_0029"></span> +<span id="index-file_002c-hyperlink-to-2"></span> +<span id="index-destinations_002c-in-another-file-2"></span> +<span id="index-hyperlinks_002c-to-another-file-2"></span> <p>Go to a page in another file. The label is the page number (counting from 1). The file name is specified by the -<a name="index-file-_0028hyperlink-option_0029-3"></a> +<span id="index-file-_0028hyperlink-option_0029-3"></span> <code>file</code> option. Page fitting is specified by the -<a name="index-pagefit-_0028hyperlink-option_0029-2"></a> +<span id="index-pagefit-_0028hyperlink-option_0029-2"></span> <code>pagefit</code> option. The -<a name="index-newwin-_0028hyperlink-option_0029-1"></a> +<span id="index-newwin-_0028hyperlink-option_0029-1"></span> <code>newwin</code> option specifies whether the destination document is opened in the same window or in a new window. </p> @@ -6458,16 +6276,16 @@ opened in the same window or in a new window. </dd> <dt><code>raw</code></dt> -<dd><a name="index-raw-_0028hyperlink-type_0029-1"></a> +<dd><span id="index-raw-_0028hyperlink-type_0029-1"></span> <p>The link specification (in the form of a pdfTeX command or a dvipdfm <code>\special</code> primitive) is taken from the command sequence <code>\<var>cs</var></code>, where <var>cs</var> is the value of the -<a name="index-cmd-_0028hyperlink-option_0029-2"></a> +<span id="index-cmd-_0028hyperlink-option_0029-2"></span> <code>cmd</code> option. In the definition of <code>\<var>cs</var></code>, use -<a name="index-_0040hllabel-3"></a> +<span id="index-_0040hllabel-3"></span> <code>\@hllabel</code> to refer to the hyperlink label. This option is intended to be used with linkgroups (see <a href="#Setting-hyperlink-types-and-options">Setting hyperlink types and options</a>), as it does not make sense in a direct call to -<a name="index-hlstart-2"></a> +<span id="index-hlstart-2"></span> <code>\hlstart</code>—you can just call the raw command. </p> <p>Example for <code>pdftex</code>: @@ -6491,15 +6309,14 @@ intended to be used with linkgroups (see <a href="#Setting-hyperlink-types-and-o </dd> </dl> -<a name="pdftex_002dspecific-link-types"></a> -<h4 class="subsubheading"><code>pdftex</code>-specific link types</h4> +<span id="pdftex_002dspecific-link-types"></span><h4 class="subsubheading"><code>pdftex</code>-specific link types</h4> <dl compact="compact"> <dt><code>num</code></dt> -<dd><a name="index-num-_0028hyperlink-type_0029"></a> -<a name="index-numbered-destination"></a> -<a name="index-destinations_002c-numbered"></a> -<a name="index-hyperlink-destination_002c-numbered"></a> +<dd><span id="index-num-_0028hyperlink-type_0029"></span> +<span id="index-numbered-destination"></span> +<span id="index-destinations_002c-numbered"></span> +<span id="index-hyperlink-destination_002c-numbered"></span> <p>Go to a “numbered destination”. The label is the destination number. </p> @@ -6509,34 +6326,31 @@ number. <hr> -<a name="Link-options-for-pdftex-and-dvipdfm"></a> -<div class="header"> +<span id="Link-options-for-pdftex-and-dvipdfm"></span><div class="header"> <p> Previous: <a href="#Link-types-for-pdftex-and-dvipdfm" accesskey="p" rel="prev">Link types for pdftex and dvipdfm</a>, Up: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="u" rel="up">Hyperlink drivers pdftex and dvipdfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Link-options-for-pdftex-and-dvipdfm-1"></a> -<h4 class="subsubsection">5.4.3.4 Link options for <code>pdftex</code> and <code>dvipdfm</code></h4> - -<a name="index-link-options_002c-pdftex"></a> -<a name="index-link-options_002c-dvipdfm"></a> -<a name="index-options_002c-link_002c-pdftex"></a> -<a name="index-options_002c-link_002c-dvipdfm"></a> -<a name="index-pdftex_002c-link-options"></a> -<a name="index-dvipdfm_002c-link-options"></a> +<span id="Link-options-for-pdftex-and-dvipdfm-1"></span><h4 class="subsubsection">5.4.3.4 Link options for <code>pdftex</code> and <code>dvipdfm</code></h4> + +<span id="index-link-options_002c-pdftex"></span> +<span id="index-link-options_002c-dvipdfm"></span> +<span id="index-options_002c-link_002c-pdftex"></span> +<span id="index-options_002c-link_002c-dvipdfm"></span> +<span id="index-pdftex_002c-link-options"></span> +<span id="index-dvipdfm_002c-link-options"></span> <p>Link options are mostly the same for the <code>pdftex</code> and <code>dvipdfm</code> drivers. The <code>pdftex</code> driver has additional options to specify link dimensions. </p> -<a name="Common-link-options"></a> -<h4 class="subsubheading">Common link options</h4> +<span id="Common-link-options"></span><h4 class="subsubheading">Common link options</h4> <dl compact="compact"> <dt><code>bcolor</code></dt> -<dd><a name="index-bcolor-_0028hyperlink-option_0029"></a> -<a name="index-hyperlink-border-color"></a> -<a name="index-border-color_002c-hyperlink"></a> -<a name="index-color_002c-hyperlink-border"></a> +<dd><span id="index-bcolor-_0028hyperlink-option_0029"></span> +<span id="index-hyperlink-border-color"></span> +<span id="index-border-color_002c-hyperlink"></span> +<span id="index-color_002c-hyperlink-border"></span> <p>Border color. An array of three numbers in the range 0 to 1, representing a color in DeviceRGB. </p> @@ -6544,10 +6358,10 @@ representing a color in DeviceRGB. </p> </dd> <dt><code>bdash</code></dt> -<dd><a name="index-bdash-_0028hyperlink-option_0029"></a> -<a name="index-dashed-hyperlink-border"></a> -<a name="index-hyperlinks_002c-border-style"></a> -<a name="index-border-style_002c-hyperlink"></a> +<dd><span id="index-bdash-_0028hyperlink-option_0029"></span> +<span id="index-dashed-hyperlink-border"></span> +<span id="index-hyperlinks_002c-border-style"></span> +<span id="index-border-style_002c-hyperlink"></span> <p>Array of numbers representing on and off stroke lengths for drawing dashes. </p> @@ -6555,15 +6369,15 @@ dashes. </p> </dd> <dt><code>bstyle</code></dt> -<dd><a name="index-bstyle-_0028hyperlink-option_0029"></a> -<a name="index-solid-hyperlink-border"></a> -<a name="index-dashed-hyperlink-border-1"></a> -<a name="index-beveled-hyperlink-border"></a> -<a name="index-inset-hyperlink-border"></a> -<a name="index-underline-hyperlink-border"></a> -<a name="index-hyperlinks_002c-border-style-1"></a> -<a name="index-style_002c-hyperlink-border"></a> -<a name="index-border-style_002c-hyperlink-1"></a> +<dd><span id="index-bstyle-_0028hyperlink-option_0029"></span> +<span id="index-solid-hyperlink-border"></span> +<span id="index-dashed-hyperlink-border-1"></span> +<span id="index-beveled-hyperlink-border"></span> +<span id="index-inset-hyperlink-border"></span> +<span id="index-underline-hyperlink-border"></span> +<span id="index-hyperlinks_002c-border-style-1"></span> +<span id="index-style_002c-hyperlink-border"></span> +<span id="index-border-style_002c-hyperlink-1"></span> <p>Link border style: </p> <dl compact="compact"> @@ -6574,7 +6388,7 @@ dashes. <dt><code>D</code></dt> <dd><p>The border is drawn with a dashed line (the dash pattern is specified by the -<a name="index-bdash-_0028hyperlink-option_0029-1"></a> +<span id="index-bdash-_0028hyperlink-option_0029-1"></span> <code>bdash</code> option). </p> </dd> @@ -6597,19 +6411,19 @@ by the </p> </dd> <dt><code>bwidth</code></dt> -<dd><a name="index-bwidth-_0028hyperlink-option_0029"></a> -<a name="index-width_002c-hyperlink-border"></a> -<a name="index-hyperlinks_002c-border-width"></a> -<a name="index-border-width_002c-hyperlink"></a> +<dd><span id="index-bwidth-_0028hyperlink-option_0029"></span> +<span id="index-width_002c-hyperlink-border"></span> +<span id="index-hyperlinks_002c-border-width"></span> +<span id="index-border-width_002c-hyperlink"></span> <p>Border width in -<a name="index-PostScript-point-2"></a> +<span id="index-PostScript-point-2"></span> PostScript points (72 points per inch). The default is 1. </p> <p>Example: <code>\hlstart{name}{bwidth=2}{dest123}Link\hlend</code> </p> </dd> <dt><code>cmd</code></dt> -<dd><a name="index-cmd-_0028hyperlink-option_0029-3"></a> +<dd><span id="index-cmd-_0028hyperlink-option_0029-3"></span> <p>Name of the macro (without the leading ‘<samp>\</samp>’) containing a pdfTeX command or a dvipdfm <code>\special</code> for the <code>raw</code> link. </p> @@ -6618,7 +6432,7 @@ pdfTeX command or a dvipdfm <code>\special</code> for the <code>raw</code> link. </p> </dd> <dt><code>file</code></dt> -<dd><a name="index-file-_0028hyperlink-option_0029-4"></a> +<dd><span id="index-file-_0028hyperlink-option_0029-4"></span> <p>File name for the <code>filename</code> and <code>filepage</code> link types. </p> <p>See <a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a>, the descriptions of the @@ -6626,9 +6440,9 @@ pdfTeX command or a dvipdfm <code>\special</code> for the <code>raw</code> link. </p> </dd> <dt><code>hlight</code></dt> -<dd><a name="index-hlight-_0028hyperlink-option_0029"></a> -<a name="index-hyperlinks_002c-highlight-mode"></a> -<a name="index-highlight-modes_002c-hyperlink"></a> +<dd><span id="index-hlight-_0028hyperlink-option_0029"></span> +<span id="index-hyperlinks_002c-highlight-mode"></span> +<span id="index-highlight-modes_002c-hyperlink"></span> <p>Link border highlight modes: </p> <dl compact="compact"> @@ -6656,9 +6470,9 @@ the page. </p> </dd> <dt><code>newwin</code></dt> -<dd><a name="index-newwin-_0028hyperlink-option_0029-2"></a> -<a name="index-hyperlinks_002c-opening-in-a-new-window"></a> -<a name="index-new-window_002c-opening-hyperlink-in"></a> +<dd><span id="index-newwin-_0028hyperlink-option_0029-2"></span> +<span id="index-hyperlinks_002c-opening-in-a-new-window"></span> +<span id="index-new-window_002c-opening-hyperlink-in"></span> <p>For the <code>filename</code> and <code>filepage</code> links, specifies whether the destination document is opened in the same window or in a new window. The settings are: </p> @@ -6681,7 +6495,7 @@ opened in the same window or in a new window. The settings are: </p> </dd> <dt><code>pagefit</code></dt> -<dd><a name="index-pagefit-_0028hyperlink-option_0029-3"></a> +<dd><span id="index-pagefit-_0028hyperlink-option_0029-3"></span> <p>For the <code>page</code> and <code>filepage links</code>, specifies how the page must be fitted to the window. <code>pagefit</code> specification is written to the <acronym>PDF</acronym> file as is, so it must conform to the @@ -6693,8 +6507,7 @@ to the <acronym>PDF</acronym> file as is, so it must conform to the </dl> -<a name="pdftex_002dspecific-link-options"></a> -<h4 class="subsubheading"><code>pdftex</code>-specific link options</h4> +<span id="pdftex_002dspecific-link-options"></span><h4 class="subsubheading"><code>pdftex</code>-specific link options</h4> <p>The dimension options below must be specified as a TeX rule specification. When set to empty, the corresponding value @@ -6703,23 +6516,23 @@ options). </p> <dl compact="compact"> <dt><code>depth</code></dt> -<dd><a name="index-depth-_0028hyperlink-option_0029"></a> -<a name="index-hyperlink-dimensions"></a> -<a name="index-dimensions_002c-hyperlink"></a> +<dd><span id="index-depth-_0028hyperlink-option_0029"></span> +<span id="index-hyperlink-dimensions"></span> +<span id="index-dimensions_002c-hyperlink"></span> <p>Depth of the link. </p> </dd> <dt><code>height</code></dt> -<dd><a name="index-height-_0028hyperlink-option_0029"></a> -<a name="index-hyperlink-dimensions-1"></a> -<a name="index-dimensions_002c-hyperlink-1"></a> +<dd><span id="index-height-_0028hyperlink-option_0029"></span> +<span id="index-hyperlink-dimensions-1"></span> +<span id="index-dimensions_002c-hyperlink-1"></span> <p>Height of the link. </p> </dd> <dt><code>width</code></dt> -<dd><a name="index-width-_0028hyperlink-option_0029"></a> -<a name="index-hyperlink-dimensions-2"></a> -<a name="index-dimensions_002c-hyperlink-2"></a> +<dd><span id="index-width-_0028hyperlink-option_0029"></span> +<span id="index-hyperlink-dimensions-2"></span> +<span id="index-dimensions_002c-hyperlink-2"></span> <p>Width of the link. </p> <p>Example: @@ -6733,34 +6546,32 @@ options). <hr> -<a name="Hyperlink-driver-nolinks"></a> -<div class="header"> +<span id="Hyperlink-driver-nolinks"></span><div class="header"> <p> Previous: <a href="#Hyperlink-drivers-pdftex-and-dvipdfm" accesskey="p" rel="prev">Hyperlink drivers pdftex and dvipdfm</a>, Up: <a href="#Hyperlink-drivers" accesskey="u" rel="up">Hyperlink drivers</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Hyperlink-driver-nolinks-1"></a> -<h4 class="subsection">5.4.4 Hyperlink driver <code>nolinks</code></h4> - -<a name="index-nolinks-_0028hyperlink-driver_0029"></a> -<a name="index-nolinks_002c-hyperlink-driver"></a> -<a name="index-driver-nolinks"></a> -<a name="index-hyperlink-driver-nolinks"></a> -<a name="index-omitting-hyperlinks"></a> -<a name="index-disabling-hyperlinks"></a> -<a name="index-hyperlinks_002c-disabling"></a> -<a name="index-destinations_002c-disabling"></a> -<a name="index-spacing_002c-preserving-with-hyperlinks"></a> -<a name="index-hyperlinks_002c-preserving-spacing"></a> -<a name="index-page_002dbreaking_002c-preserving-with-hyperlinks"></a> -<a name="index-hyperlinks_002c-preserving-page_002dbreaking"></a> +<span id="Hyperlink-driver-nolinks-1"></span><h4 class="subsection">5.4.4 Hyperlink driver <code>nolinks</code></h4> + +<span id="index-nolinks-_0028hyperlink-driver_0029"></span> +<span id="index-nolinks_002c-hyperlink-driver"></span> +<span id="index-driver-nolinks"></span> +<span id="index-hyperlink-driver-nolinks"></span> +<span id="index-omitting-hyperlinks"></span> +<span id="index-disabling-hyperlinks"></span> +<span id="index-hyperlinks_002c-disabling"></span> +<span id="index-destinations_002c-disabling"></span> +<span id="index-spacing_002c-preserving-with-hyperlinks"></span> +<span id="index-hyperlinks_002c-preserving-spacing"></span> +<span id="index-page_002dbreaking_002c-preserving-with-hyperlinks"></span> +<span id="index-hyperlinks_002c-preserving-page_002dbreaking"></span> <p>Select this driver to suppress all hyperlinks in your document. </p> <p>Selecting this driver is quite different from not selecting any driver at all, or from selecting some driver and then turning hyperlinks off for the entire document with -<a name="index-hloff"></a> +<span id="index-hloff"></span> <code>\hloff</code> and -<a name="index-hldestoff"></a> +<span id="index-hldestoff"></span> <code>\hldestoff</code> (see <a href="#Turning-hyperlinks-on_002foff">Turning hyperlinks on/off</a>). </p> <p>The purpose of <code>\hldestoff</code> and <code>\hloff</code> is to mark (parts) of @@ -6776,7 +6587,7 @@ same as what you were getting with hyperlinks enabled. <p>The reason for this is that hyperlinks are produced by the <code>\special</code> primitives or low-level hyperlink commands. Each such command is placed inside a -<a name="index-whatsits-made-by-hyperlinks"></a> +<span id="index-whatsits-made-by-hyperlinks"></span> <em>whatsit</em> (an internal TeX object), which may introduce legitimate breakpoints at places where none would exist without the whatsits. The macros <code>\hldestoff</code> and <code>\hloff</code> disable the @@ -6787,9 +6598,9 @@ hyperlink macros. Instead, it defines them to merely write to the log file (what gets written is unimportant). This also produces whatsits, thus imitating the whatsits from the hyperlink commands. (This trick was borrowed from the -<a name="index-color_002esty-2"></a> -<a name="index-graphics-collection_002c-LaTeX-2"></a> -<a name="index-LaTeX-graphics-collection-2"></a> +<span id="index-color_002esty-2"></span> +<span id="index-graphics-collection_002c-LaTeX-2"></span> +<span id="index-LaTeX-graphics-collection-2"></span> LaTeX ‘color’ package.) </p> <p>Another reason for using <code>nolinks</code> is that in horizontal mode @@ -6804,7 +6615,7 @@ defining <code>\hldest</code> to produce the empty boxes. document both with and without hyperlinks, here is the recommended way to enable the hyperlinks under pdfTeX: </p> -<a name="index-enablehyperlinks-2"></a> +<span id="index-enablehyperlinks-2"></span> <div class="example"> <pre class="example">\ifpdf \enablehyperlinks @@ -6815,41 +6626,39 @@ to enable the hyperlinks under pdfTeX: <hr> -<a name="Setting-hyperlink-types-and-options"></a> -<div class="header"> +<span id="Setting-hyperlink-types-and-options"></span><div class="header"> <p> Next: <a href="#Turning-hyperlinks-on_002foff" accesskey="n" rel="next">Turning hyperlinks on/off</a>, Previous: <a href="#Hyperlink-drivers" accesskey="p" rel="prev">Hyperlink drivers</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Setting-hyperlink-types-and-options-1"></a> -<h3 class="section">5.5 Setting hyperlink types and options</h3> - -<a name="index-default-hyperlink-type"></a> -<a name="index-default-hyperlink-options"></a> -<a name="index-hyperlinks_002c-default-type"></a> -<a name="index-hyperlinks_002c-default-options"></a> -<a name="index-destinations_002c-default-type"></a> -<a name="index-destinations_002c-default-options"></a> +<span id="Setting-hyperlink-types-and-options-1"></span><h3 class="section">5.5 Setting hyperlink types and options</h3> + +<span id="index-default-hyperlink-type"></span> +<span id="index-default-hyperlink-options"></span> +<span id="index-hyperlinks_002c-default-type"></span> +<span id="index-hyperlinks_002c-default-options"></span> +<span id="index-destinations_002c-default-type"></span> +<span id="index-destinations_002c-default-options"></span> <p>You can define default types for links and destinations, which will be used when you do not specify a type in -<a name="index-hlstart-3"></a> +<span id="index-hlstart-3"></span> <code>\hlstart</code> or -<a name="index-hldest-3"></a> +<span id="index-hldest-3"></span> <code>\hldest</code>. Similarly, you can define default values for the options; the default value for an option is used when you do not set the option in the argument to <code>\hlstart</code> or <code>\hldest</code>. </p> -<a name="index-group-type_002c-hyperlink"></a> -<a name="index-group-options_002c-hyperlink"></a> -<a name="index-hyperlinks_002c-group-type"></a> -<a name="index-hyperlinks_002c-group-options"></a> -<a name="index-link_002c-group-type"></a> -<a name="index-link_002c-group-options"></a> -<a name="index-linkgroup-type"></a> -<a name="index-linkgroup-options"></a> -<a name="index-destinations_002c-group-type"></a> -<a name="index-destinations_002c-group-options"></a> -<a name="index-destgroup-type"></a> -<a name="index-destgroup-options"></a> +<span id="index-group-type_002c-hyperlink"></span> +<span id="index-group-options_002c-hyperlink"></span> +<span id="index-hyperlinks_002c-group-type"></span> +<span id="index-hyperlinks_002c-group-options"></span> +<span id="index-link_002c-group-type"></span> +<span id="index-link_002c-group-options"></span> +<span id="index-linkgroup-type"></span> +<span id="index-linkgroup-options"></span> +<span id="index-destinations_002c-group-type"></span> +<span id="index-destinations_002c-group-options"></span> +<span id="index-destgroup-type"></span> +<span id="index-destgroup-options"></span> <p>The parameters for implicit links and destinations can be customized by setting the “group” types and options. When not set, the defaults are used. @@ -6860,26 +6669,24 @@ you want to set an option temporarily, you can do so inside a previous settings are restored. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Setting-default-types-and-options" accesskey="1">Setting default types and options</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Setting-default-types-and-options" accesskey="1">Setting default types and options</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Setting-group-types" accesskey="2">Setting group types</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Setting-group-types" accesskey="2">Setting group types</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Setting-group-options" accesskey="3">Setting group options</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Setting-group-options" accesskey="3">Setting group options</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Setting-default-types-and-options"></a> -<div class="header"> +<span id="Setting-default-types-and-options"></span><div class="header"> <p> Next: <a href="#Setting-group-types" accesskey="n" rel="next">Setting group types</a>, Up: <a href="#Setting-hyperlink-types-and-options" accesskey="u" rel="up">Setting hyperlink types and options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Setting-default-types-and-options-1"></a> -<h4 class="subsection">5.5.1 Setting default types and options</h4> +<span id="Setting-default-types-and-options-1"></span><h4 class="subsection">5.5.1 Setting default types and options</h4> -<a name="index-hltype"></a> -<a name="index-hldesttype"></a> +<span id="index-hltype"></span> +<span id="index-hldesttype"></span> <p>The default types for links and destinations can be set with the following commands: </p> @@ -6892,8 +6699,8 @@ following commands: link/destination types supported by the selected hyperlink driver (see <a href="#Hyperlink-drivers">Hyperlink drivers</a>). </p> -<a name="index-hlopts"></a> -<a name="index-hldestopts"></a> +<span id="index-hlopts"></span> +<span id="index-hldestopts"></span> <p>Default values for the options can be set with the following commands: </p> <div class="example"> @@ -6905,15 +6712,15 @@ link/destination types supported by the selected hyperlink driver assignments in the format ‘<samp><var>option</var>=<var>value</var></samp>’. Again, what options are allowed depends on the selected hyperlink driver. </p> -<a name="index-boxed-links_002c-avoiding-1"></a> -<a name="index-avoiding-boxed-links-1"></a> -<a name="index-color_002c-hyperlinks-2"></a> -<a name="index-colored-links-2"></a> -<a name="index-hyperlink-color-2"></a> +<span id="index-boxed-links_002c-avoiding-1"></span> +<span id="index-avoiding-boxed-links-1"></span> +<span id="index-color_002c-hyperlinks-2"></span> +<span id="index-colored-links-2"></span> +<span id="index-hyperlink-color-2"></span> <p>Many people regard the default boxed links as not aesthetic and intruding on page layout. The reason why boxed links are the default is that the links are not colored until you load the LaTeX -<a name="index-color_002esty-3"></a> +<span id="index-color_002esty-3"></span> ‘color’ package (see <a href="#Loading-LaTeX-packages">Loading LaTeX packages</a>) or use other means to define the <code>\color</code> command; therefore, not producing any kind of link border may result in the links not being marked in any way. @@ -6928,22 +6735,20 @@ option <code>bwidth</code>; see <a href="#Hyperlink-drivers">Hyperlink drivers</ <hr> -<a name="Setting-group-types"></a> -<div class="header"> +<span id="Setting-group-types"></span><div class="header"> <p> Next: <a href="#Setting-group-options" accesskey="n" rel="next">Setting group options</a>, Previous: <a href="#Setting-default-types-and-options" accesskey="p" rel="prev">Setting default types and options</a>, Up: <a href="#Setting-hyperlink-types-and-options" accesskey="u" rel="up">Setting hyperlink types and options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Setting-group-types-1"></a> -<h4 class="subsection">5.5.2 Setting group types</h4> - -<a name="index-hltype-1"></a> -<a name="index-hldesttype-1"></a> -<a name="index-group-type_002c-hyperlink-1"></a> -<a name="index-hyperlinks_002c-group-type-1"></a> -<a name="index-link_002c-group-type-1"></a> -<a name="index-linkgroup-type-1"></a> -<a name="index-destinations_002c-group-type-1"></a> -<a name="index-destgroup-type-1"></a> +<span id="Setting-group-types-1"></span><h4 class="subsection">5.5.2 Setting group types</h4> + +<span id="index-hltype-1"></span> +<span id="index-hldesttype-1"></span> +<span id="index-group-type_002c-hyperlink-1"></span> +<span id="index-hyperlinks_002c-group-type-1"></span> +<span id="index-link_002c-group-type-1"></span> +<span id="index-linkgroup-type-1"></span> +<span id="index-destinations_002c-group-type-1"></span> +<span id="index-destgroup-type-1"></span> <p>When called with an optional argument, as in </p> <div class="example"> @@ -6958,13 +6763,13 @@ with an empty type (this is the initial setting for all groups, except that the type for the ‘url’ linkgroup is set to ‘<samp>url</samp>’ by the drivers which support this link type). </p> -<a name="index-group-_0060_0027-_0028empty_0029"></a> -<a name="index-default-hyperlink-type-1"></a> -<a name="index-default-hyperlink-options-1"></a> -<a name="index-hyperlinks_002c-default-type-1"></a> -<a name="index-hyperlinks_002c-default-options-1"></a> -<a name="index-destinations_002c-default-type-1"></a> -<a name="index-destinations_002c-default-options-1"></a> +<span id="index-group-_0060_0027-_0028empty_0029"></span> +<span id="index-default-hyperlink-type-1"></span> +<span id="index-default-hyperlink-options-1"></span> +<span id="index-hyperlinks_002c-default-type-1"></span> +<span id="index-hyperlinks_002c-default-options-1"></span> +<span id="index-destinations_002c-default-type-1"></span> +<span id="index-destinations_002c-default-options-1"></span> <p>There are two special “groups” which can be used inside the <var>groups</var> list. An empty group sets the default type. This allows to set the default type and group types in one command, for example: @@ -6976,9 +6781,9 @@ to set the default type and group types in one command, for example: <p>sets the link type for the ‘eq’ linkgroup and the default link type to <var>type</var>. </p> -<a name="index-group-_0060_002a_0027"></a> -<a name="index-groups_002c-specifying-all"></a> -<a name="index-all-groups_002c-specifying"></a> +<span id="index-group-_0060_002a_0027"></span> +<span id="index-groups_002c-specifying-all"></span> +<span id="index-all-groups_002c-specifying"></span> <p>Another special group is a star (‘<samp>*</samp>’) group, which signifies all defined groups. For example, the command </p> @@ -6991,27 +6796,25 @@ as well as the default destination type. </p> <hr> -<a name="Setting-group-options"></a> -<div class="header"> +<span id="Setting-group-options"></span><div class="header"> <p> Previous: <a href="#Setting-group-types" accesskey="p" rel="prev">Setting group types</a>, Up: <a href="#Setting-hyperlink-types-and-options" accesskey="u" rel="up">Setting hyperlink types and options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Setting-group-options-1"></a> -<h4 class="subsection">5.5.3 Setting group options</h4> - -<a name="index-group-options_002c-hyperlink-1"></a> -<a name="index-hyperlinks_002c-group-options-1"></a> -<a name="index-link_002c-group-options-1"></a> -<a name="index-linkgroup-options-1"></a> -<a name="index-destinations_002c-group-options-1"></a> -<a name="index-destgroup-options-1"></a> +<span id="Setting-group-options-1"></span><h4 class="subsection">5.5.3 Setting group options</h4> + +<span id="index-group-options_002c-hyperlink-1"></span> +<span id="index-hyperlinks_002c-group-options-1"></span> +<span id="index-link_002c-group-options-1"></span> +<span id="index-linkgroup-options-1"></span> +<span id="index-destinations_002c-group-options-1"></span> +<span id="index-destgroup-options-1"></span> <p>Option values for each group are stored as a list of option assignments. This list does not have to contain every supported option. Values for options missing from this list are taken from the default option values. </p> -<a name="index-hlopts-1"></a> -<a name="index-hldestopts-1"></a> +<span id="index-hlopts-1"></span> +<span id="index-hldestopts-1"></span> <p>To manipulate the list of option values for the groups, you use the <code>\hlopts</code> and <code>\hldestopts</code> commands with an optional argument: @@ -7028,9 +6831,9 @@ argument: two special “groups”, the empty group and the star (‘<samp>*</samp>’) group, have the same meaning as for <code>\hltype</code> and <code>\hldesttype</code>. -<a name="index-group_002c-preserving-option-list"></a> -<a name="index-hyperlink-group_002c-preserving-option-list"></a> -<a name="index-option-list_002c-preserving-for-group"></a> +<span id="index-group_002c-preserving-option-list"></span> +<span id="index-hyperlink-group_002c-preserving-option-list"></span> +<span id="index-option-list_002c-preserving-for-group"></span> When used without the exclamation mark, <code>\hlopts</code> and <code>\hldestopts</code> preserve the current list of options for the groups, and only update the options listed in <var>options</var>. If you add the @@ -7043,17 +6846,17 @@ beginning of your document. On the other hand, when you want to adjust some option(s) and leave others intact, you should use the macros without the ‘<samp>!</samp>’. </p> -<a name="index-raise-_0028hyperlink-option_0029-1"></a> -<a name="index-mathematics-displays_002c-hyperlinks-1"></a> -<a name="index-displayed-math-and-hyperlinks-1"></a> -<a name="index-large-operators-and-hyperlinks-1"></a> -<a name="index-hyperlinks_002c-large-operators-1"></a> -<a name="index-destinations_002c-large-operators-1"></a> -<a name="index-raising-hyperlink-destinations-1"></a> +<span id="index-raise-_0028hyperlink-option_0029-1"></span> +<span id="index-mathematics-displays_002c-hyperlinks-1"></span> +<span id="index-displayed-math-and-hyperlinks-1"></span> +<span id="index-large-operators-and-hyperlinks-1"></span> +<span id="index-hyperlinks_002c-large-operators-1"></span> +<span id="index-destinations_002c-large-operators-1"></span> +<span id="index-raising-hyperlink-destinations-1"></span> <p>For example, with displayed mathematical formulas, you often need to adjust the ‘<samp>raise</samp>’ option for the -<a name="index-group-_0060eq_0027-2"></a> -<a name="index-linkgroup-_0060eq_0027-1"></a> +<span id="index-group-_0060eq_0027-2"></span> +<span id="index-linkgroup-_0060eq_0027-1"></span> ‘eq’ destgroup, because the formulas often contain large parentheses and brackets. But when doing so, you want to leave the other settings unchanged. To achieve this, call <code>\hldestopts</code> without the @@ -7070,9 +6873,9 @@ formula inside a (TeX) group (<code>\begingroup…\endgroup</code>), so you do not need to isolate the setting of the ‘<samp>raise</samp>’ option—it will be restored after the closing ‘<samp>$$</samp>’. </p> -<a name="index-option-list_002c-group"></a> -<a name="index-group-option-list"></a> -<a name="index-hyperlinks_002c-group-option-list"></a> +<span id="index-option-list_002c-group"></span> +<span id="index-group-option-list"></span> +<span id="index-hyperlinks_002c-group-option-list"></span> <p>Initially, Eplain sets the option lists for almost all groups to empty, so that the groups fall back on the default values for all options. The one exception to this rule is the ‘eq’ destgroup, whose initial option @@ -7087,18 +6890,16 @@ appear in displayed math. </p> <hr> -<a name="Turning-hyperlinks-on_002foff"></a> -<div class="header"> +<span id="Turning-hyperlinks-on_002foff"></span><div class="header"> <p> -Previous: <a href="#Setting-hyperlink-types-and-options" accesskey="p" rel="prev">Setting hyperlink types and options</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Making-PDF-outlines" accesskey="n" rel="next">Making PDF outlines</a>, Previous: <a href="#Setting-hyperlink-types-and-options" accesskey="p" rel="prev">Setting hyperlink types and options</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Turning-hyperlinks-on_002foff-1"></a> -<h3 class="section">5.6 Turning hyperlinks on/off</h3> +<span id="Turning-hyperlinks-on_002foff-1"></span><h3 class="section">5.6 Turning hyperlinks on/off</h3> -<a name="index-omitting-hyperlinks-1"></a> -<a name="index-disabling-hyperlinks-1"></a> -<a name="index-hyperlinks_002c-disabling-1"></a> -<a name="index-destinations_002c-disabling-1"></a> +<span id="index-omitting-hyperlinks-1"></span> +<span id="index-disabling-hyperlinks-1"></span> +<span id="index-hyperlinks_002c-disabling-1"></span> +<span id="index-destinations_002c-disabling-1"></span> <p>Links and/or destinations can be turned on or off globally by disabling the low-level commands, or for each group individually. </p> @@ -7108,26 +6909,24 @@ inside a <code>\begingroup…\endgroup</code> block; when the group ends, t previous settings are restored. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Turning-low_002dlevel-commands-on_002foff" accesskey="1">Turning low-level commands on/off</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Turning-low_002dlevel-commands-on_002foff" accesskey="1">Turning low-level commands on/off</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Turning-hyperlinks-on_002foff-for-a-group" accesskey="2">Turning hyperlinks on/off for a group</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Turning-hyperlinks-on_002foff-for-a-group" accesskey="2">Turning hyperlinks on/off for a group</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Turning-low_002dlevel-commands-on_002foff"></a> -<div class="header"> +<span id="Turning-low_002dlevel-commands-on_002foff"></span><div class="header"> <p> Next: <a href="#Turning-hyperlinks-on_002foff-for-a-group" accesskey="n" rel="next">Turning hyperlinks on/off for a group</a>, Up: <a href="#Turning-hyperlinks-on_002foff" accesskey="u" rel="up">Turning hyperlinks on/off</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Turning-low_002dlevel-commands-on_002foff-1"></a> -<h4 class="subsection">5.6.1 Turning low-level commands on/off</h4> +<span id="Turning-low_002dlevel-commands-on_002foff-1"></span><h4 class="subsection">5.6.1 Turning low-level commands on/off</h4> -<a name="index-hldeston"></a> -<a name="index-hldestoff-1"></a> -<a name="index-hlon"></a> -<a name="index-hloff-1"></a> +<span id="index-hldeston"></span> +<span id="index-hldestoff-1"></span> +<span id="index-hlon"></span> +<span id="index-hloff-1"></span> <p>The low-level commands <code>\hlstart</code>, <code>\hlend</code> and <code>\hldest</code> can be turned on/off with the following commands: </p> @@ -7143,16 +6942,14 @@ these commands to disable hyperlinks for the entire document. </p> <hr> -<a name="Turning-hyperlinks-on_002foff-for-a-group"></a> -<div class="header"> +<span id="Turning-hyperlinks-on_002foff-for-a-group"></span><div class="header"> <p> Previous: <a href="#Turning-low_002dlevel-commands-on_002foff" accesskey="p" rel="prev">Turning low-level commands on/off</a>, Up: <a href="#Turning-hyperlinks-on_002foff" accesskey="u" rel="up">Turning hyperlinks on/off</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Turning-hyperlinks-on_002foff-for-a-group-1"></a> -<h4 class="subsection">5.6.2 Turning hyperlinks on/off for a group</h4> +<span id="Turning-hyperlinks-on_002foff-for-a-group-1"></span><h4 class="subsection">5.6.2 Turning hyperlinks on/off for a group</h4> -<a name="index-group_002c-disabling-hyperlinks"></a> -<a name="index-hyperlink-group_002c-disabling-hyperlinks"></a> +<span id="index-group_002c-disabling-hyperlinks"></span> +<span id="index-hyperlink-group_002c-disabling-hyperlinks"></span> <p>If you want to disable links/destinations produced by certain groups, you can give a list of the groups as an optional argument to these commands: @@ -7183,53 +6980,148 @@ assume that all links are on; after the following sequence of commands: <p>all links are on except for the ‘eq’ linkgroup. </p> +<hr> +<span id="Making-PDF-outlines"></span><div class="header"> +<p> +Previous: <a href="#Turning-hyperlinks-on_002foff" accesskey="p" rel="prev">Turning hyperlinks on/off</a>, Up: <a href="#Hyperlinks" accesskey="u" rel="up">Hyperlinks</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> +</div> +<span id="Making-PDF-outlines-1"></span><h3 class="section">5.7 Making PDF outlines</h3> + +<span id="index-outlines_002c-making-PDF"></span> +<span id="index-bookmarks_002c-making-PDF"></span> +<span id="index-PDF-outlines-_0028a_002ek_002ea_002e-bookmarks_0029"></span> + +<p>PDF outlines (a.k.a. bookmarks) are more or less a table of contents +that PDF viewers can display alongside the main document. Eplain’s +hyperlink features can be used to create them; there isn’t any special +support for them. A continuing example interspersed with commentary +follows. +</p> +<p>First we must enable hyperlinks. +</p><div class="example"> +<pre class="example">\input eplain +\enablehyperlinks %[dvipdfm] doesn't work +</pre></div> + +<span id="index-ifpdf-2"></span> +<span id="index-pdftex_002c-making-PDF-outlines-for"></span> +<span id="index-dvips_002c-making-PDF-outlines-for"></span> +<p>We will separate the code to support <code>pdftex</code> from <code>dvips</code> +with the <code>\ifpdf</code> conditional (provided by Eplain). +</p> +<span id="index-pdfoutline-_0028pdftex-primitive_0029"></span> +<p>For <code>pdftex</code>, we can use the <code>\pdfoutline</code> primitive. The +keyword "count" is followed by the number of subentries in this entry. +If negative, the bookmark is closed (that is, subentries are hidden). +</p> +<div class="example"> +<pre class="example">\ifpdf + \pdfoutline goto name {sec1} count -1 {Mysec-pdf}% + \pdfoutline goto name {sec1.1} {Mysubsec-pdf}% +</pre></div> + +<span id="index-special-ps_003a-for-dvips"></span> +<p>For <code>dvips</code>, we use TeX’s <code>\special</code> command to emit a +<code>ps:</code> special using the PDF <code>pdfmark</code> operator. The +<code>ps:</code> prefix tells <code>dvips</code> that the following is literal +PostScript. +</p> +<span id="index-pdfmark-_0028PDF-language-primitive_0029"></span> +<p><code>[ ... pdfmark</code> (there is no closing ‘<samp>]</samp>’) is a extension to +the PostScript language for specifying various PDF-related things. It +is recognized by Ghostscript, Distiller, et al. Adobe publishes a +reference manual for it: +<a href="https://adobe.com/content/dam/Adobe/en/devnet/acrobat/pdfs/pdfmark_reference.pdf">https://adobe.com/content/dam/Adobe/en/devnet/acrobat/pdfs/pdfmark_reference.pdf</a>. +</p> +<span id="index-DOCVIEW-pdfmark"></span> +<p>The <code>/DOCVIEW</code> pdfmark used here says the outline panel should be used. +</p> +<div class="example"> +<pre class="example">\else % not pdf output + \special{ps:[/PageMode /UseOutlines /DOCVIEW pdfmark} + % + % The individual outline entries, using a different syntax + % than pdftex, but the same information. + \special{ps:[/Count -1 /Dest (sec1) cvn /Title (Mysec-dvi) + /OUT pdfmark} + \special{ps:[/Count -0 /Dest (sec1.1) cvn /Title (Mysubsec-dvi) + /OUT pdfmark} +\fi +</pre></div> + +<p>The ‘<samp>-pdf</samp>’ and ‘<samp>-dvi</samp>’ suffixes in the strings above in the +outline entries are just to make it clear which branch is being +executed, for purposes of this example. Ordinarily the entries would +be the same in both branches. +</p> +<p>Also, the strings above are literal PostScript constants, again for +this example. Usually they would come from control sequences, e.g., +as the table of contents is read. +</p> +<span id="index-pdfescapestring-pdfTeX-primitive"></span> +<p>It is necessary to "pdf-escape" such arbitrary strings, else +backslashes, parentheses, etc., would not come out right. pdfTeX’s +<code>\pdfescapestring</code> primitive is an easy way to do this, e.g., +<code>\xdef#1{\pdfescapestring{#1}}</code>. +</p> +<p>Here is the document text, constructing three pages with the section +and subsection given above in the outlines. +</p> +<div class="example"> +<pre class="example">First page.\vfil\eject + +\hldest{}{}{sec1}% +1. Mysec on second page.\vfil\eject + +\hldest{}{}{sec1.1}% +1.1. Mysubsec on third page. + +\end +</pre></div> + <hr> -<a name="Arrow-theoretic-diagrams"></a> -<div class="header"> +<span id="Arrow-theoretic-diagrams"></span><div class="header"> <p> Next: <a href="#Programming-definitions" accesskey="n" rel="next">Programming definitions</a>, Previous: <a href="#Hyperlinks" accesskey="p" rel="prev">Hyperlinks</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Arrow-theoretic-diagrams-1"></a> -<h2 class="chapter">6 Arrow theoretic diagrams</h2> +<span id="Arrow-theoretic-diagrams-1"></span><h2 class="chapter">6 Arrow theoretic diagrams</h2> <p>This chapter describes definitions for producing commutative diagrams. </p> <p>Steven Smith wrote this documentation (and the macros). </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Slanted-lines-and-vectors" accesskey="1">Slanted lines and vectors</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Slanted-lines-and-vectors" accesskey="1">Slanted lines and vectors</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Commutative-diagrams" accesskey="2">Commutative diagrams</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Commutative-diagrams" accesskey="2">Commutative diagrams</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Slanted-lines-and-vectors"></a> -<div class="header"> +<span id="Slanted-lines-and-vectors"></span><div class="header"> <p> Next: <a href="#Commutative-diagrams" accesskey="n" rel="next">Commutative diagrams</a>, Up: <a href="#Arrow-theoretic-diagrams" accesskey="u" rel="up">Arrow theoretic diagrams</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Slanted-lines-and-vectors-1"></a> -<h3 class="section">6.1 Slanted lines and vectors</h3> +<span id="Slanted-lines-and-vectors-1"></span><h3 class="section">6.1 Slanted lines and vectors</h3> <p>The macros <code>\drawline</code> -<a name="index-drawline"></a> +<span id="index-drawline"></span> and <code>\drawvector</code> -<a name="index-drawvector"></a> +<span id="index-drawvector"></span> provide the capability found in LaTeX’s -<a name="index-LaTeX-3"></a> -<a name="index-picture-mode-1"></a> +<span id="index-LaTeX-3"></span> +<span id="index-picture-mode-1"></span> picture mode to draw slanted lines and vectors of certain directions. Both of these macros take three arguments: two integer arguments to specify the direction of the line or vector, and one argument to specify its length. For example, ‘<samp>\drawvector(-4,1){60pt}</samp>’ produces the vector -<a name="index-lines"></a> -<a name="index-vectors"></a> +<span id="index-lines"></span> +<span id="index-vectors"></span> which lies in the 2d quadrant, has a slope of minus 1/4, and a width of 60 pt. </p> @@ -7261,15 +7153,13 @@ dotted vectors of various directions. </p> <hr> -<a name="Commutative-diagrams"></a> -<div class="header"> +<span id="Commutative-diagrams"></span><div class="header"> <p> Previous: <a href="#Slanted-lines-and-vectors" accesskey="p" rel="prev">Slanted lines and vectors</a>, Up: <a href="#Arrow-theoretic-diagrams" accesskey="u" rel="up">Arrow theoretic diagrams</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Commutative-diagrams-1"></a> -<h3 class="section">6.2 Commutative diagrams</h3> +<span id="Commutative-diagrams-1"></span><h3 class="section">6.2 Commutative diagrams</h3> -<a name="index-commutative-diagrams"></a> +<span id="index-commutative-diagrams"></span> <p>The primitive commands <code>\drawline</code> and <code>\drawvector</code> can be used to typeset arrow theoretic diagrams. This section describes (1) @@ -7278,95 +7168,93 @@ facilitate the construction of commutative diagrams. All macros described in this section must be used in math mode. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Arrows-and-morphisms" accesskey="1">Arrows and morphisms</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Arrows-and-morphisms" accesskey="1">Arrows and morphisms</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Construction-of-commutative-diagrams" accesskey="2">Construction of commutative diagrams</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Construction-of-commutative-diagrams" accesskey="2">Construction of commutative diagrams</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Commutative-diagram-parameters" accesskey="3">Commutative diagram parameters</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Commutative-diagram-parameters" accesskey="3">Commutative diagram parameters</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Arrows-and-morphisms"></a> -<div class="header"> +<span id="Arrows-and-morphisms"></span><div class="header"> <p> Next: <a href="#Construction-of-commutative-diagrams" accesskey="n" rel="next">Construction of commutative diagrams</a>, Up: <a href="#Commutative-diagrams" accesskey="u" rel="up">Commutative diagrams</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Arrows-and-morphisms-1"></a> -<h4 class="subsection">6.2.1 Arrows and morphisms</h4> -<a name="index-arrows"></a> -<a name="index-morphisms"></a> +<span id="Arrows-and-morphisms-1"></span><h4 class="subsection">6.2.1 Arrows and morphisms</h4> +<span id="index-arrows"></span> +<span id="index-morphisms"></span> <p>The macros <code>\mapright</code> and <code>\mapleft</code> produce right and left -<a name="index-mapright"></a> -<a name="index-mapleft"></a> +<span id="index-mapright"></span> +<span id="index-mapleft"></span> pointing arrows, respectively. Use superscript (<code>^</code>) to place a morphism above the arrow, e.g., ‘<samp>\mapright^\alpha</samp>’; use subscript (<code>_</code>) to place a morphism below the arrow, e.g., ‘<samp>\mapright_{\tilde l}</samp>’. Superscripts and subscripts may be used -simulataneously, e.g., ‘<samp>\mapright^\pi_{\rm epimor.}</samp>’. +simultaneously, e.g., ‘<samp>\mapright^\pi_{\rm epimor.}</samp>’. </p> <p>Similarly, the macros <code>\mapup</code> and <code>\mapdown</code> produce up and -<a name="index-mapup"></a> -<a name="index-mapdown"></a> +<span id="index-mapup"></span> +<span id="index-mapdown"></span> down pointing arrows, respectively. Use <code>\rt</code> -<a name="index-rt"></a> +<span id="index-rt"></span> to place a morphism to the right of the arrow, e.g., ‘<samp>\mapup\rt{\rm id}</samp>’; use <code>\lft</code> -<a name="index-lft"></a> +<span id="index-lft"></span> to place a morphism to the left of the arrow, e.g., ‘<samp>\mapup\lft\omega</samp>’. <code>\lft</code> and <code>\rt</code> may be used simultaneously, e.g., ‘<samp>\mapdown\lft\pi\rt{\rm monomor.}</samp>’. </p> <p>Slanted arrows are produced by the macro <code>\arrow</code>, which takes -<a name="index-arrow"></a> +<span id="index-arrow"></span> a direction argument (e.g., ‘<samp>\arrow(3,-4)</samp>’). Use <code>\rt</code> and <code>\lft</code> to place morphisms to the right and left, respectively, of the arrow. A slanted line (no arrowhead) is produced with the macro <code>\sline</code>, -<a name="index-sline"></a> +<span id="index-sline"></span> whose syntax is identical to that of <code>\arrow</code>. </p> <p>The length of these macros is predefined by the default TeX dimensions <code>\harrowlength</code>, -<a name="index-harrowlength"></a> +<span id="index-harrowlength"></span> for horizontal arrows (or lines), <code>\varrowlength</code>, -<a name="index-varrowlength"></a> +<span id="index-varrowlength"></span> for vertical arrows (or lines), and <code>\sarrowlength</code>, -<a name="index-sarrowlength"></a> +<span id="index-sarrowlength"></span> for slanted arrows (or lines). To change any of these dimensions, say, e.g., ‘<samp>\harrowlength=40pt</samp>’. As with all other TeX dimensions, the change may be as global or as local as you like. Furthermore, the placement of morphisms on the arrows is controlled by the dimensions <code>\hmorphposn</code>, -<a name="index-hmorphposn"></a> +<span id="index-hmorphposn"></span> <code>\vmorphposn</code>, -<a name="index-vmorphposn"></a> +<span id="index-vmorphposn"></span> and <code>\morphdist</code>. -<a name="index-morphdist"></a> +<span id="index-morphdist"></span> The first two dimensions control the horizontal and vertical position of the morphism from its default position; the latter dimension controls the distance of the morphism from the arrow. If you have more than one morphism per arrow (i.e., a <code>^</code>/<code>_</code> or <code>\lft</code>/<code>\rt</code> construction), use the parameters <code>\hmorphposnup</code>, -<a name="index-hmorphposnup"></a> +<span id="index-hmorphposnup"></span> <code>\hmorphposndn</code>, -<a name="index-hmorphposndn"></a> +<span id="index-hmorphposndn"></span> <code>\vmorphposnup</code>, -<a name="index-vmorphposnup"></a> +<span id="index-vmorphposnup"></span> <code>\vmorphposndn</code>, -<a name="index-vmorphposndn"></a> +<span id="index-vmorphposndn"></span> <code>\hmorphposnrt</code>, -<a name="index-hmorphposnrt"></a> +<span id="index-hmorphposnrt"></span> <code>\hmorphposnlft</code>, -<a name="index-hmorphposnlft"></a> +<span id="index-hmorphposnlft"></span> <code>\vmorphposnrt</code>, -<a name="index-vmorphposnrt"></a> +<span id="index-vmorphposnrt"></span> and <code>\vmorphposnlft</code>. -<a name="index-vmorphposnlft"></a> +<span id="index-vmorphposnlft"></span> The default values of all these dimensions are provided in the section on parameters that follows below. </p> @@ -7376,44 +7264,44 @@ the same syntax as <code>\mapright</code>: </p> <dl compact="compact"> <dt><code>\mapright</code></dt> -<dd><a name="index-mapright-1"></a> +<dd><span id="index-mapright-1"></span> <p><code>$X\mapright Y$</code> = (a right arrow). </p> </dd> <dt><code>\mapleft</code></dt> -<dd><a name="index-mapleft-1"></a> +<dd><span id="index-mapleft-1"></span> <p><code>$X\mapleft Y$</code> </p> </dd> <dt><code>\hline</code></dt> -<dd><a name="index-hline"></a> +<dd><span id="index-hline"></span> <p><code>$X\hline Y$</code> </p> </dd> <dt><code>\bimapright</code></dt> -<dd><a name="index-bimapright"></a> +<dd><span id="index-bimapright"></span> <p><code>$X\bimapright Y$</code> </p> </dd> <dt><code>\bimapleft</code></dt> -<dd><a name="index-bimapleft"></a> +<dd><span id="index-bimapleft"></span> <p><code>$X\bimapleft Y$</code> </p> </dd> <dt><code>\adjmapright</code></dt> -<dd><a name="index-adjmapright"></a> +<dd><span id="index-adjmapright"></span> <p><code>$X\adjmapright Y$</code> </p> </dd> <dt><code>\adjmapleft</code></dt> -<dd><a name="index-adjmapleft"></a> +<dd><span id="index-adjmapleft"></span> <p><code>$X\adjmapleft Y$</code> </p> </dd> <dt><code>\bihline</code></dt> -<dd><a name="index-bihline"></a> +<dd><span id="index-bihline"></span> <p><code>$X\bihline Y$</code> </p></dd> </dl> @@ -7424,43 +7312,43 @@ the same syntax as <code>\mapdown</code>: </p> <dl compact="compact"> <dt><code>\mapdown</code></dt> -<dd><a name="index-mapdown-1"></a> +<dd><span id="index-mapdown-1"></span> <p>(a down arrow) </p> </dd> <dt><code>\mapup</code></dt> -<dd><a name="index-mapup-1"></a> +<dd><span id="index-mapup-1"></span> <p>(an up arrow) </p> </dd> <dt><code>\vline</code></dt> -<dd><a name="index-vline"></a> +<dd><span id="index-vline"></span> <p>(vertical line) </p> </dd> <dt><code>\bimapdown</code></dt> -<dd><a name="index-bimapdown"></a> +<dd><span id="index-bimapdown"></span> <p>(two down arrows) </p> </dd> <dt><code>\bimapup</code></dt> -<dd><a name="index-bimapup"></a> +<dd><span id="index-bimapup"></span> <p>(two up arrows) </p> </dd> <dt><code>\adjmapdown</code></dt> -<dd><a name="index-adjmapdown"></a> +<dd><span id="index-adjmapdown"></span> <p>(two adjoint arrows; down then up) </p> </dd> <dt><code>\adjmapup</code></dt> -<dd><a name="index-adjmapup"></a> +<dd><span id="index-adjmapup"></span> <p>(two adjoint arrows; up then down) </p> </dd> <dt><code>\bivline</code></dt> -<dd><a name="index-bivline"></a> +<dd><span id="index-bivline"></span> <p>(two vertical lines) </p></dd> </dl> @@ -7471,27 +7359,27 @@ the same syntax as <code>\arrow</code>: </p> <dl compact="compact"> <dt><code>\arrow</code></dt> -<dd><a name="index-arrow-1"></a> +<dd><span id="index-arrow-1"></span> <p>(a slanted arrow) </p> </dd> <dt><code>\sline</code></dt> -<dd><a name="index-sline-1"></a> +<dd><span id="index-sline-1"></span> <p>(a slanted line) </p> </dd> <dt><code>\biarrow</code></dt> -<dd><a name="index-biarrow"></a> +<dd><span id="index-biarrow"></span> <p>(two straight arrows) </p> </dd> <dt><code>\adjarrow</code></dt> -<dd><a name="index-adjarrow"></a> +<dd><span id="index-adjarrow"></span> <p>(two adjoint arrows) </p> </dd> <dt><code>\bisline</code></dt> -<dd><a name="index-bisline"></a> +<dd><span id="index-bisline"></span> <p>(two straight lines) </p> </dd> @@ -7499,7 +7387,7 @@ the same syntax as <code>\arrow</code>: <p>The width between double arrows is controlled by the parameter <code>\channelwidth</code>. -<a name="index-channelwidth"></a> +<span id="index-channelwidth"></span> The parameters <code>\hchannel</code> and <code>\vchannel</code>, if nonzero, override <code>\channelwidth</code> by controlling the horizontal and vertical shifting from the first arrow to the second. @@ -7508,37 +7396,35 @@ shifting from the first arrow to the second. epimorphisms from monomorphisms. Many texts, such as Lang’s book <cite>Algebra</cite>, use as a tasteful alternative the symbol ‘inc’ (in roman) next to an arrow to denote inclusion. -<a name="index-Lang_002c-Serge"></a> +<span id="index-Lang_002c-Serge"></span> </p> <p>Future enhancements will include a mechanism to draw curved arrows found in, e.g., the Snake Lemma, by employing a version of the <code>\path</code> macros of Appendix D of <cite>The TeXbook</cite>. -<a name="index-Snake-Lemma"></a> +<span id="index-Snake-Lemma"></span> </p> <hr> -<a name="Construction-of-commutative-diagrams"></a> -<div class="header"> +<span id="Construction-of-commutative-diagrams"></span><div class="header"> <p> Next: <a href="#Commutative-diagram-parameters" accesskey="n" rel="next">Commutative diagram parameters</a>, Previous: <a href="#Arrows-and-morphisms" accesskey="p" rel="prev">Arrows and morphisms</a>, Up: <a href="#Commutative-diagrams" accesskey="u" rel="up">Commutative diagrams</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Construction-of-commutative-diagrams-1"></a> -<h4 class="subsection">6.2.2 Construction of commutative diagrams</h4> +<span id="Construction-of-commutative-diagrams-1"></span><h4 class="subsection">6.2.2 Construction of commutative diagrams</h4> <p>There are two approaches to the construction of commutative diagrams described here. The first approach, and the simplest, treats commutative diagrams like fancy matrices, as Knuth does in Exercise 18.46 of <cite>The TeXbook</cite>. This case is covered by the macro <code>\commdiag</code>, -<a name="index-commdiag"></a> +<span id="index-commdiag"></span> which is an altered version of the Plain TeX macro <code>\matrix</code>. -<a name="index-matrix"></a> +<span id="index-matrix"></span> An example suffices to demonstrate this macro. The following commutative diagram (illustrating the covering homotopy property; Bott and Tu, <cite>Differential Forms in Algebraic Topology</cite>) -<a name="index-Bott_002c-Raoul"></a> -<a name="index-Tu_002c-Loring-W_002e"></a> -<a name="index-covering-homotopy-property"></a> +<span id="index-Bott_002c-Raoul"></span> +<span id="index-Tu_002c-Loring-W_002e"></span> +<span id="index-covering-homotopy-property"></span> is produced with the code </p> <div class="example"> @@ -7550,8 +7436,8 @@ Y\times I&\mapright^{\bar f_t}&X}$$ The following commutative diagram (illustrating the universal mapping property; Warner, <cite>Foundations of Differentiable Manifolds and Lie Groups</cite>) -<a name="index-Warner_002c-Frank-W_002e"></a> -<a name="index-universal-mapping-property"></a> +<span id="index-Warner_002c-Frank-W_002e"></span> +<span id="index-universal-mapping-property"></span> is produced with the code </p> <div class="example"> @@ -7564,13 +7450,13 @@ V\times W&\mapright^l&U\cr}$$ of the triangle in the center column, as shown in the example (illustrating all constant minimal realizations of a linear system; Brockett, <cite>Finite Dimensional Linear Systems</cite>) -<a name="index-Brockett_002c-Roger-W_002e"></a> -<a name="index-minimal-realizations"></a> -<a name="index-linear-systems-theory"></a> +<span id="index-Brockett_002c-Roger-W_002e"></span> +<span id="index-minimal-realizations"></span> +<span id="index-linear-systems-theory"></span> which is produced with the code </p> -<div class="smallexample"> -<pre class="smallexample">$$\sarrowlength=.42\harrowlength +<div class="example"> +<pre class="example">$$\sarrowlength=.42\harrowlength \commdiag{&R^m\cr &\arrow(-1,-1)\lft{\bf B}\quad \arrow(1,-1)\rt{\bf G}\cr R^n&\mapright^{\bf P}&R^n\cr \mapdown\lft{e^{{\bf A}t}}&&\mapdown\rt{e^{{\bf F}t}}\cr @@ -7587,15 +7473,15 @@ chosen to blend with each other. In the first example, the default settings for the arrow lengths are used, but a direction for the arrow must be chosen. The ratio of the default horizontal and vertical arrow lengths is approximately the golden mean -<a name="index-golden-mean"></a> -<a name="index-golden-mean-1"></a> +<span id="index-golden-mean"></span> +<span id="index-golden-mean-1"></span> the arrow direction closest to this mean is <code>(3,2)</code>. In the second example, a slope of is desired and the default horizontal arrow length is 60 pt; therefore, choose a vertical arrow length of 20 pt. You may affect the interline glue settings of <code>\commdiag</code> by redefining the macro <code>\commdiagbaselines</code>. -<a name="index-commdiagbaselines"></a> +<span id="index-commdiagbaselines"></span> (cf. Exercise 18.46 of <cite>The TeXbook</cite> and the section on parameters below.) </p> @@ -7613,16 +7499,16 @@ approach, borrowed from Francis Borceux’s <cite>Diagram</cite> macros for LaTeX, treats the commutative diagram like a grid of identically shaped boxes. To compose the commutative diagram, first draw an equally spaced grid, e.g., -<a name="index-grid"></a> -<a name="index-Borceux_002c-Francis"></a> -<a name="index-Diagram_002c-macros-for-LaTeX"></a> +<span id="index-grid"></span> +<span id="index-Borceux_002c-Francis"></span> +<span id="index-Diagram_002c-macros-for-LaTeX"></span> on a piece of scratch paper. Then draw each element (vertices and arrows) of the commutative diagram on this grid, centered at each grid point. Finally, use the macro <code>\gridcommdiag</code> -<a name="index-gridcommdiag"></a> +<span id="index-gridcommdiag"></span> to implement your design as a TeX alignment. For example, the cubic diagram -<a name="index-cube"></a> +<span id="index-cube"></span> that appears in Francis Borceux’s documentation can be implemented on a 7 by 7 grid, and is achieved with the code </p> @@ -7641,8 +7527,8 @@ E&&\mapright_k&&G\cr}$$ </pre></div> <p>The dimensions <code>\hgrid</code> and <code>\vgrid</code> -<a name="index-hgrid"></a> -<a name="index-vgrid"></a> +<span id="index-hgrid"></span> +<span id="index-vgrid"></span> control the horizontal and vertical spacing of the grid used by <code>\gridcommdiag</code>. The default setting for both of these dimensions is 15 pt. Note that in the example of the cube the arrow lengths must @@ -7657,9 +7543,9 @@ of the morphisms are adjusted by setting <code>\hmorphposn</code> and <p>One is not restricted to a square grid. For example, the proof of Zassenhaus’s Butterfly Lemma can be illustrated by the diagram (appearing in Lang’s book <cite>Algebra</cite>) -<a name="index-Zassenhaus_002c-Hans"></a> -<a name="index-Lang_002c-Serge-1"></a> -<a name="index-Butterfly-Lemma"></a> +<span id="index-Zassenhaus_002c-Hans"></span> +<span id="index-Lang_002c-Serge-1"></span> +<span id="index-Butterfly-Lemma"></span> This diagram may be implemented on a 9 by 12 grid with an aspect ratio of 1/2, and is set with the code </p> @@ -7690,13 +7576,11 @@ Many diagrams may be typeset with the predefined macros that appear here; however, ingenuity is often required to handle special cases. </p> <hr> -<a name="Commutative-diagram-parameters"></a> -<div class="header"> +<span id="Commutative-diagram-parameters"></span><div class="header"> <p> Previous: <a href="#Construction-of-commutative-diagrams" accesskey="p" rel="prev">Construction of commutative diagrams</a>, Up: <a href="#Commutative-diagrams" accesskey="u" rel="up">Commutative diagrams</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Commutative-diagram-parameters-1"></a> -<h4 class="subsection">6.2.3 Commutative diagram parameters</h4> +<span id="Commutative-diagram-parameters-1"></span><h4 class="subsection">6.2.3 Commutative diagram parameters</h4> <p>The following is a list describing the parameters used in the commutative diagram macros. These dimensions may be changed globally or @@ -7704,71 +7588,71 @@ locally. </p> <dl compact="compact"> <dt><code>\harrowlength</code></dt> -<dd><a name="index-harrowlength-1"></a> +<dd><span id="index-harrowlength-1"></span> <p>(Default: 60 pt) The length of right or left arrows. </p> </dd> <dt><code>\varrowlength</code></dt> -<dd><a name="index-varrowlength-1"></a> +<dd><span id="index-varrowlength-1"></span> <p>(Default: 0.618<code>\harrowlength</code>) The length of up or down arrows. </p> </dd> <dt><code>\sarrowlength</code></dt> -<dd><a name="index-sarrowlength-1"></a> +<dd><span id="index-sarrowlength-1"></span> <p>(Default: 60 pt) The horizontal length of slanted arrows. </p> </dd> <dt><code>\hmorphposn</code></dt> -<dd><a name="index-hmorphposn-1"></a> +<dd><span id="index-hmorphposn-1"></span> <p>(Default: 0 pt) The horizontal position of the morphism with respect to its default position. There are also the dimensions <code>\hmorphposnup</code>, -<a name="index-hmorphposnup-1"></a> +<span id="index-hmorphposnup-1"></span> <code>\hmorphposndn</code>, -<a name="index-hmorphposndn-1"></a> +<span id="index-hmorphposndn-1"></span> <code>\hmorphposnrt</code>, -<a name="index-hmorphposnrt-1"></a> +<span id="index-hmorphposnrt-1"></span> and <code>\hmorphposnlft</code> -<a name="index-hmorphposnlft-1"></a> +<span id="index-hmorphposnlft-1"></span> for <code>^</code>/<code>_</code> or <code>\lft</code>/<code>\rt</code> constructions. </p> </dd> <dt><code>\vmorphposn</code></dt> -<dd><a name="index-vmorphposn-1"></a> +<dd><span id="index-vmorphposn-1"></span> <p>(Default: 0 pt) The vertical position of the morphism with respect to its default position. There are also the dimensions <code>\vmorphposnup</code>, -<a name="index-vmorphposnup-1"></a> +<span id="index-vmorphposnup-1"></span> <code>\vmorphposndn</code>, -<a name="index-vmorphposndn-1"></a> +<span id="index-vmorphposndn-1"></span> <code>\vmorphposnrt</code>, -<a name="index-vmorphposnrt-1"></a> +<span id="index-vmorphposnrt-1"></span> and <code>\vmorphposnlft</code> -<a name="index-vmorphposnlft-1"></a> +<span id="index-vmorphposnlft-1"></span> for <code>^</code>/<code>_</code> or <code>\lft</code>/<code>\rt</code> constructions. </p> </dd> <dt><code>\morphdist</code></dt> -<dd><a name="index-morphdist-1"></a> +<dd><span id="index-morphdist-1"></span> <p>(Default: 4 pt) The distance of morphisms from slanted lines or arrows. </p> </dd> <dt><code>\channelwidth</code></dt> -<dd><a name="index-channelwidth-1"></a> +<dd><span id="index-channelwidth-1"></span> <p>(Default: 3 pt) The distance between double lines or arrows. </p> </dd> <dt><code>\hchannel, \vchannel</code></dt> -<dd><a name="index-hchannel"></a> -<a name="index-vchannel"></a> +<dd><span id="index-hchannel"></span> +<span id="index-vchannel"></span> <p>(Defaults: 0 pt) Overrides <code>\channelwidth</code>. The horizontal and vertical shifts between double lines or arrows. </p> </dd> <dt><code>\commdiagbaselines</code></dt> -<dd><a name="index-commdiagbaselines-1"></a> +<dd><span id="index-commdiagbaselines-1"></span> <p>(Default: <code>\baselineskip=15pt \lineskip=3pt \lineskiplimit=3pt </code>) @@ -7776,13 +7660,13 @@ The parameters used by <code>\commdiag</code> for setting interline glue. </p> </dd> <dt><code>\hgrid</code></dt> -<dd><a name="index-hgrid-1"></a> +<dd><span id="index-hgrid-1"></span> <p>(Default: 15 pt) The horizontal spacing of the grid used by <code>\gridcommdiag</code>. </p> </dd> <dt><code>\vgrid</code></dt> -<dd><a name="index-vgrid-1"></a> +<dd><span id="index-vgrid-1"></span> <p>(Default: 15 pt) The vertical spacing of the grid used by <code>\gridcommdiag</code>. </p> @@ -7791,91 +7675,87 @@ The parameters used by <code>\commdiag</code> for setting interline glue. <hr> -<a name="Programming-definitions"></a> -<div class="header"> +<span id="Programming-definitions"></span><div class="header"> <p> Next: <a href="#Demo-files" accesskey="n" rel="next">Demo files</a>, Previous: <a href="#Arrow-theoretic-diagrams" accesskey="p" rel="prev">Arrow theoretic diagrams</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Programming-definitions-1"></a> -<h2 class="chapter">7 Programming definitions</h2> +<span id="Programming-definitions-1"></span><h2 class="chapter">7 Programming definitions</h2> <p>The definitions in this section are only likely to be useful when you are writing nontrivial macros, not when writing a document. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Category-codes" accesskey="1">Category codes</a>:</td><td> </td><td align="left" valign="top">Changing category codes. +<tr><td align="left" valign="top">• <a href="#Category-codes" accesskey="1">Category codes</a></td><td> </td><td align="left" valign="top">Changing category codes. </td></tr> -<tr><td align="left" valign="top">• <a href="#Allocation-macros" accesskey="2">Allocation macros</a>:</td><td> </td><td align="left" valign="top">Non-outer versions of \newcount et al. +<tr><td align="left" valign="top">• <a href="#Allocation-macros" accesskey="2">Allocation macros</a></td><td> </td><td align="left" valign="top">Non-outer versions of \newcount et al. </td></tr> -<tr><td align="left" valign="top">• <a href="#Iteration" accesskey="3">Iteration</a>:</td><td> </td><td align="left" valign="top">Doing ‘for’ and ‘while’ loops in TeX. +<tr><td align="left" valign="top">• <a href="#Iteration" accesskey="3">Iteration</a></td><td> </td><td align="left" valign="top">Doing ‘for’ and ‘while’ loops in TeX. </td></tr> -<tr><td align="left" valign="top">• <a href="#Macro-arguments" accesskey="4">Macro arguments</a>:</td><td> </td><td align="left" valign="top">Reading and ignoring them. +<tr><td align="left" valign="top">• <a href="#Macro-arguments" accesskey="4">Macro arguments</a></td><td> </td><td align="left" valign="top">Reading and ignoring them. </td></tr> -<tr><td align="left" valign="top">• <a href="#Converting-to-characters" accesskey="5">Converting to characters</a>:</td><td> </td><td align="left" valign="top">Normalizing control sequences and spaces. +<tr><td align="left" valign="top">• <a href="#Converting-to-characters" accesskey="5">Converting to characters</a></td><td> </td><td align="left" valign="top">Normalizing control sequences and spaces. </td></tr> -<tr><td align="left" valign="top">• <a href="#Expansion" accesskey="6">Expansion</a>:</td><td> </td><td align="left" valign="top">Controlling expansion. +<tr><td align="left" valign="top">• <a href="#Expansion" accesskey="6">Expansion</a></td><td> </td><td align="left" valign="top">Controlling expansion. </td></tr> -<tr><td align="left" valign="top">• <a href="#Obeying-spaces" accesskey="7">Obeying spaces</a>:</td><td> </td><td align="left" valign="top">Making whitespace count anywhere. +<tr><td align="left" valign="top">• <a href="#Obeying-spaces" accesskey="7">Obeying spaces</a></td><td> </td><td align="left" valign="top">Making whitespace count anywhere. </td></tr> -<tr><td align="left" valign="top">• <a href="#Writing-out-numbers" accesskey="8">Writing out numbers</a>:</td><td> </td><td align="left" valign="top">Making ‘1’ into ‘one’. +<tr><td align="left" valign="top">• <a href="#Writing-out-numbers" accesskey="8">Writing out numbers</a></td><td> </td><td align="left" valign="top">Making ‘1’ into ‘one’. </td></tr> -<tr><td align="left" valign="top">• <a href="#Mode_002dspecific-penalties" accesskey="9">Mode-specific penalties</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Mode_002dspecific-penalties" accesskey="9">Mode-specific penalties</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Auxiliary-files">Auxiliary files</a>:</td><td> </td><td align="left" valign="top">Testing for their existence. +<tr><td align="left" valign="top">• <a href="#Auxiliary-files">Auxiliary files</a></td><td> </td><td align="left" valign="top">Testing for their existence. </td></tr> -<tr><td align="left" valign="top">• <a href="#User_002ddefined-environments">User-defined environments</a>:</td><td> </td><td align="left" valign="top">User-defined environments. +<tr><td align="left" valign="top">• <a href="#User_002ddefined-environments">User-defined environments</a></td><td> </td><td align="left" valign="top">User-defined environments. </td></tr> -<tr><td align="left" valign="top">• <a href="#Page-list-and-page-range-parsers">Page list and page range parsers</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Page-list-and-page-range-parsers">Page list and page range parsers</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Category-codes"></a> -<div class="header"> +<span id="Category-codes"></span><div class="header"> <p> Next: <a href="#Allocation-macros" accesskey="n" rel="next">Allocation macros</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Category-codes-1"></a> -<h3 class="section">7.1 Category codes</h3> +<span id="Category-codes-1"></span><h3 class="section">7.1 Category codes</h3> -<a name="index-category-codes"></a> +<span id="index-category-codes"></span> <p>Plain TeX defines <code>\active</code> (as the number 13) for use in changing category codes. Although the author of <cite>The TeXbook</cite> -<a name="index-Knuth_002c-Donald-Ervin-1"></a> +<span id="index-Knuth_002c-Donald-Ervin-1"></span> has “intentionally kept the category codes numeric”, two other categories are commonly used: letters (category code 11) and others (12). Therefore, Eplain defines <code>\letter</code> and <code>\other</code>. -<a name="index-letter"></a> -<a name="index-other"></a> +<span id="index-letter"></span> +<span id="index-other"></span> </p> <p>Sometimes it is cleaner to make a character active without actually -<a name="index-active-characters"></a> +<span id="index-active-characters"></span> writing a <code>\catcode</code> command. The <code>\makeactive</code> command takes -<a name="index-catcode"></a> -<a name="index-makeactive"></a> +<span id="index-catcode"></span> +<span id="index-makeactive"></span> a character as an argument to make active (and ignores following spaces). For example, here are two commands which both make <kbd>\</kbd> active: -<a name="index-backslash-character"></a> +<span id="index-backslash-character"></span> </p> <div class="example"> <pre class="example">\makeactive\\ \makeactive92 </pre></div> -<a name="index-user_002dinaccessible-macros"></a> -<a name="index-inaccessible-macros"></a> +<span id="index-user_002dinaccessible-macros"></span> +<span id="index-inaccessible-macros"></span> <p>Sometimes you might want to temporarily change the category code of the ‘@’ character to <code>\letter</code>, so that you can use or define macros which are normally inaccessible to the user. For such situations, Eplain provides the <code>\makeatletter</code> -<a name="index-makeatletter"></a> +<span id="index-makeatletter"></span> command. It sets the category code of ‘@’ to <code>\letter</code> (11) and defines <code>\resetatcatcode</code> -<a name="index-resetatcatcode-1"></a> +<span id="index-resetatcatcode-1"></span> to restore the category code to whatever it was before the call to <code>\makeatletter</code>. For example: </p> @@ -7887,7 +7767,7 @@ to restore the category code to whatever it was before the call to </pre></div> <p>There is also <code>\makeatother</code> -<a name="index-makeatother"></a> +<span id="index-makeatother"></span> which works similarly but sets the category code of ‘@’ to <code>\other</code> (12). </p> @@ -7895,12 +7775,12 @@ which works similarly but sets the category code of ‘@’ to to do so inside a group where you temporarily make the character active, and then give it a global definition (cf. the definition of <code>\obeyspaces</code> in <cite>The TeXbook</cite>). -<a name="index-definitions_002c-global"></a> +<span id="index-definitions_002c-global"></span> This is inconvenient if you are writing a long macro, or if the character already has a global definition you do not wish to transcend. Eplain provides <code>\letreturn</code>, which defines the usual end-of-line -<a name="index-letreturn"></a> -<a name="index-return-character"></a> +<span id="index-letreturn"></span> +<span id="index-return-character"></span> character to be the argument. For example: </p> <div class="example"> @@ -7913,45 +7793,43 @@ there <code>\myreturn</code> to be expanded. </p> <p><cite>The TeXbook</cite> describes <code>\uncatcodespecials</code>, -<a name="index-uncatcodespecials-1"></a> +<span id="index-uncatcodespecials-1"></span> which makes all characters which are normally “special” into “other” characters, but the definition never made it into plain TeX. Eplain therefore defines it. For notes on the usage, see <a href="#Verbatim-listing">Verbatim listing</a>. </p> <p>Finally, <code>\percentchar</code> -<a name="index-percentchar"></a> +<span id="index-percentchar"></span> expands into a literal ‘%’ character. This is useful when you <code>\write</code> TeX output to a file, and want to avoid spurious spaces. For example, Eplain writes a <code>\percentchar</code> after the definition of cross-references. The macros <code>\lbracechar</code> -<a name="index-lbracechar"></a> +<span id="index-lbracechar"></span> and <code>\rbracechar</code> -<a name="index-rbracechar"></a> +<span id="index-rbracechar"></span> expand similarly. </p> <hr> -<a name="Allocation-macros"></a> -<div class="header"> +<span id="Allocation-macros"></span><div class="header"> <p> Next: <a href="#Iteration" accesskey="n" rel="next">Iteration</a>, Previous: <a href="#Category-codes" accesskey="p" rel="prev">Category codes</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Allocation-macros-1"></a> -<h3 class="section">7.2 Allocation macros</h3> +<span id="Allocation-macros-1"></span><h3 class="section">7.2 Allocation macros</h3> -<a name="index-allocation-macros"></a> -<a name="index-register-allocation"></a> +<span id="index-allocation-macros"></span> +<span id="index-register-allocation"></span> <p>Plain TeX provides macros that allocate registers of each primitive type in TeX, to prevent different sets of macros from using the same register for two different things. The macros are all named starting with ‘<samp>new</samp>’, -<a name="index-new_2026"></a> +<span id="index-new_2026"></span> e.g., <code>\newcount</code> allocates a new “count” (integer) register. Such allocations are usually needed only at the top level of some macro definition file; therefore, plain TeX makes the allocation registers <code>\outer</code>, -<a name="index-outer"></a> +<span id="index-outer"></span> to help find errors. (The error this helps to find is a missing right brace in some macro definition.) </p> @@ -7963,34 +7841,34 @@ or in conditional text that is being skipped). Therefore, Eplain defines “inner” versions of all the allocation macros, named with the prefix ‘<samp>inner</samp>’: <code>\innernewbox</code>, -<a name="index-innernewbox"></a> +<span id="index-innernewbox"></span> <code>\innernewcount</code>, -<a name="index-innernewcount"></a> +<span id="index-innernewcount"></span> <code>\innernewdimen</code>, -<a name="index-innernewdimen"></a> +<span id="index-innernewdimen"></span> <code>\innernewfam</code>, -<a name="index-innernewfam"></a> +<span id="index-innernewfam"></span> <code>\innernewhelp</code>, -<a name="index-innernewhelp"></a> +<span id="index-innernewhelp"></span> <code>\innernewif</code>, -<a name="index-innernewif"></a> +<span id="index-innernewif"></span> <code>\innernewinsert</code>, -<a name="index-innernewinsert"></a> +<span id="index-innernewinsert"></span> <code>\innernewlanguage</code>, -<a name="index-innernewlanguage"></a> +<span id="index-innernewlanguage"></span> <code>\innernewread</code>,<br> -<a name="index-innernewread"></a> +<span id="index-innernewread"></span> <code>\innernewskip</code>, -<a name="index-innernewskip"></a> +<span id="index-innernewskip"></span> <code>\innernewtoks</code>, -<a name="index-innernewtoks"></a> +<span id="index-innernewtoks"></span> <code>\innernewwrite</code>. -<a name="index-innernewwrite"></a> +<span id="index-innernewwrite"></span> </p> <p>You can also define non-outer versions of other macros in the same way that Eplain defines the above. The basic macro is called <code>\innerdef</code>: -<a name="index-innerdef"></a> +<span id="index-innerdef"></span> </p> <div class="example"> <pre class="example">\innerdef <var>\innername</var> {<var>outername</var>} @@ -8006,7 +7884,7 @@ since it’s outer!) <p>If the outer control sequence is named <var>\cs</var>, and you want to define <code>inner<var>cs</var></code> as the inner one, you can use <code>\innerinnerdef</code>, -<a name="index-innerinnerdef"></a> +<span id="index-innerinnerdef"></span> which is just an abbreviation for a call to <code>\innerdef</code>. For example, these two calls are equivalent: </p> @@ -8017,23 +7895,21 @@ example, these two calls are equivalent: <hr> -<a name="Iteration"></a> -<div class="header"> +<span id="Iteration"></span><div class="header"> <p> Next: <a href="#Macro-arguments" accesskey="n" rel="next">Macro arguments</a>, Previous: <a href="#Allocation-macros" accesskey="p" rel="prev">Allocation macros</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Iteration-1"></a> -<h3 class="section">7.3 Iteration</h3> +<span id="Iteration-1"></span><h3 class="section">7.3 Iteration</h3> -<a name="index-iteration"></a> -<a name="index-loops"></a> -<a name="index-for-loops"></a> -<a name="index-while-loops"></a> -<a name="index-do_2026while-loops"></a> +<span id="index-iteration"></span> +<span id="index-loops"></span> +<span id="index-for-loops"></span> +<span id="index-while-loops"></span> +<span id="index-do_2026while-loops"></span> <p>You can iterate through a comma-separated list of items with <code>\for</code>. -<a name="index-for"></a> +<span id="index-for"></span> Here is an example: </p> <div class="example"> @@ -8046,7 +7922,7 @@ Here is an example: before or after the commas in the list, or after the <code>:=</code>, are <em>not</em> ignored. To strip leading spaces off the items, use <code>\For</code>: -<a name="index-For"></a> +<span id="index-For"></span> </p> <div class="example"> <pre class="example">\For\name:= @@ -8079,10 +7955,10 @@ token after <code>:=</code> which is space, not <code>\namelist</code>. </p> <p>Eplain provides another kind of loops, which is an extension of plain TeX’s -<a name="index-loop"></a> +<span id="index-loop"></span> <code>\loop</code>. If you say: </p> -<a name="index-repeat"></a> +<span id="index-repeat"></span> <div class="example"> <pre class="example">\loop <var>loop-text</var> @@ -8108,34 +7984,32 @@ the optional else clause: <p>Here, <var>loop-text</var> will be repeated as long as <var>condition</var> is <em>not</em> satisfied. This extension is from -<a name="index-Eijkhout_002c-Victor"></a> +<span id="index-Eijkhout_002c-Victor"></span> Victor Eijkhout’s -<a name="index-TeX-by-Topic"></a> +<span id="index-TeX-by-Topic"></span> <i>TeX by Topic</i> (page 104). </p> <hr> -<a name="Macro-arguments"></a> -<div class="header"> +<span id="Macro-arguments"></span><div class="header"> <p> Next: <a href="#Converting-to-characters" accesskey="n" rel="next">Converting to characters</a>, Previous: <a href="#Iteration" accesskey="p" rel="prev">Iteration</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Macro-arguments-1"></a> -<h3 class="section">7.4 Macro arguments</h3> +<span id="Macro-arguments-1"></span><h3 class="section">7.4 Macro arguments</h3> -<a name="index-arguments_002c-ignoring"></a> -<a name="index-ignoring-arguments"></a> -<a name="index-gobbling-arguments"></a> +<span id="index-arguments_002c-ignoring"></span> +<span id="index-ignoring-arguments"></span> +<span id="index-gobbling-arguments"></span> <p>It is occasionally useful to redefine a macro that takes arguments to do nothing. Eplain defines <code>\gobble</code>, -<a name="index-gobble"></a> +<span id="index-gobble"></span> <code>\gobbletwo</code>, -<a name="index-gobbletwo"></a> +<span id="index-gobbletwo"></span> and <code>\gobblethree</code> to swallow one, two, and three arguments, respectively. </p> <p>For example, if you want to produce a “short” table of -<a name="index-table-of-contents_002c-short-1"></a> +<span id="index-table-of-contents_002c-short-1"></span> contents—one that includes only chapters, say—the easiest thing to do is read the entire <code>.toc</code> file (see <a href="#Contents">Contents</a>), and just ignore the commands that produce section or subsection entries. To be @@ -8152,14 +8026,14 @@ specific: subsections in your document.) </p> <p>In addition, Eplain defines <code>\eattoken</code> -<a name="index-eattoken"></a> +<span id="index-eattoken"></span> to swallow the single following token, using <code>\let</code>. Thus, <code>\gobble</code> followed by ‘<samp>{…}</samp>’ ignores the entire brace-enclosed text. <code>\eattoken</code> followed by the same ignores only the opening left brace. </p> <p>Eplain defines a macro <code>\identity</code> -<a name="index-identity"></a> +<span id="index-identity"></span> which takes one argument and expands to that argument. This may be useful if you want to provide a function for the user to redefine, but don’t need to do anything by default. (For example, the default @@ -8171,7 +8045,7 @@ that is the syntax Eplain recognizes. Eplain ignores space tokens before and after optional arguments, via <code>\futurenonspacelet</code>. </p> <p>You test for an optional argument by using <code>\@getoptionalarg</code>. -<a name="index-_0040getoptionalarg"></a> +<span id="index-_0040getoptionalarg"></span> It takes one argument, a control sequence to expand after reading the argument, if present. If an optional argument is present, the control sequence <code>\@optionalarg</code> expands to it; otherwise, @@ -8227,17 +8101,15 @@ end of the first for the end of the second. </p> <hr> -<a name="Converting-to-characters"></a> -<div class="header"> +<span id="Converting-to-characters"></span><div class="header"> <p> Next: <a href="#Expansion" accesskey="n" rel="next">Expansion</a>, Previous: <a href="#Macro-arguments" accesskey="p" rel="prev">Macro arguments</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Converting-to-characters-1"></a> -<h3 class="section">7.5 Converting to characters</h3> +<span id="Converting-to-characters-1"></span><h3 class="section">7.5 Converting to characters</h3> -<a name="index-characters_002c-converting-to"></a> +<span id="index-characters_002c-converting-to"></span> <p>Eplain defines <code>\xrlabel</code> -<a name="index-xrlabel"></a> +<span id="index-xrlabel"></span> to produce control sequence names for cross-reference labels, et al. This macro expands to its argument with an ‘<samp>_</samp>’ appended. (It does this because the usual use of <code>\xrlabel</code> is to generate a control @@ -8257,7 +8129,7 @@ Labels can therefore include any characters except for ‘<samp>\</samp>&rsq ‘<samp>{</samp>’, ‘<samp>}</samp>’, and ‘<samp>#</samp>’, all of which are used in macro definitions themselves. </p> -<a name="index-sanitize"></a> +<span id="index-sanitize"></span> <p><code>\sanitize</code> takes a control sequence as an argument and converts the expansion of the control sequence into a list of character tokens. This is the behavior you want when writing information like chapter @@ -8278,53 +8150,49 @@ has given. <hr> -<a name="Expansion"></a> -<div class="header"> +<span id="Expansion"></span><div class="header"> <p> Next: <a href="#Obeying-spaces" accesskey="n" rel="next">Obeying spaces</a>, Previous: <a href="#Converting-to-characters" accesskey="p" rel="prev">Converting to characters</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Expansion-1"></a> -<h3 class="section">7.6 Expansion</h3> +<span id="Expansion-1"></span><h3 class="section">7.6 Expansion</h3> <p>This section describes some miscellanous macros for expansion, etc. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#g_t_005ccsn-and-_005cece" accesskey="1">\csn and \ece</a>:</td><td> </td><td align="left" valign="top">Abbreviations for \csname expansions. +<tr><td align="left" valign="top">• <a href="#g_t_005ccsn-and-_005cece" accesskey="1">\csn and \ece</a></td><td> </td><td align="left" valign="top">Abbreviations for \csname expansions. </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cedefappend" accesskey="2">\edefappend</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#g_t_005cedefappend" accesskey="2">\edefappend</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hooks" accesskey="3">Hooks</a>:</td><td> </td><td align="left" valign="top">Manipulating and executing named actions. +<tr><td align="left" valign="top">• <a href="#Hooks" accesskey="3">Hooks</a></td><td> </td><td align="left" valign="top">Manipulating and executing named actions. </td></tr> -<tr><td align="left" valign="top">• <a href="#Properties" accesskey="4">Properties</a>:</td><td> </td><td align="left" valign="top">Associating information with a csname. +<tr><td align="left" valign="top">• <a href="#Properties" accesskey="4">Properties</a></td><td> </td><td align="left" valign="top">Associating information with a csname. </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cexpandonce" accesskey="5">\expandonce</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#g_t_005cexpandonce" accesskey="5">\expandonce</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cifundefined" accesskey="6">\ifundefined</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#g_t_005cifundefined" accesskey="6">\ifundefined</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cifempty" accesskey="7">\ifempty</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#g_t_005cifempty" accesskey="7">\ifempty</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="8">\ifinteger and \isinteger</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="8">\ifinteger and \isinteger</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cfuturenonspacelet" accesskey="9">\futurenonspacelet</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#g_t_005cfuturenonspacelet" accesskey="9">\futurenonspacelet</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="g_t_005ccsn-and-_005cece"></a> -<div class="header"> +<span id="g_t_005ccsn-and-_005cece"></span><div class="header"> <p> Next: <a href="#g_t_005cedefappend" accesskey="n" rel="next">\edefappend</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="g_t_005ccsn-and-_005cece-1"></a> -<h4 class="subsection">7.6.1 <code>\csn</code> and <code>\ece</code></h4> +<span id="g_t_005ccsn-and-_005cece-1"></span><h4 class="subsection">7.6.1 <code>\csn</code> and <code>\ece</code></h4> -<a name="index-csn"></a> +<span id="index-csn"></span> <p><code>\csn</code>{<var>name</var>} simply abbreviates <code>\csname</code> <var>name</var> <code>\endcsname</code>, thus saving some typing. The extra level of expansion does take some time, though, so I don’t recommend it for an inner loop. </p> -<a name="index-ece"></a> +<span id="index-ece"></span> <p><code>\ece</code>{<var>token</var>}{<var>name</var>} abbreviates </p> <div class="example"> @@ -8343,15 +8211,13 @@ does take some time, though, so I don’t recommend it for an inner loop. </p> <hr> -<a name="g_t_005cedefappend"></a> -<div class="header"> +<span id="g_t_005cedefappend"></span><div class="header"> <p> Next: <a href="#Hooks" accesskey="n" rel="next">Hooks</a>, Previous: <a href="#g_t_005ccsn-and-_005cece" accesskey="p" rel="prev">\csn and \ece</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="g_t_005cedefappend-1"></a> -<h4 class="subsection">7.6.2 <code>\edefappend</code></h4> +<span id="g_t_005cedefappend-1"></span><h4 class="subsection">7.6.2 <code>\edefappend</code></h4> -<a name="index-edefappend"></a> +<span id="index-edefappend"></span> <p><code>\edefappend</code> is a way of adding on to an existing definition. It takes two arguments: the first is the control sequence name, the second the new tokens to append to the definition. The second argument is @@ -8369,15 +8235,13 @@ fully expanded (in the <code>\edef</code> that redefines the control sequence). </p> <hr> -<a name="Hooks"></a> -<div class="header"> +<span id="Hooks"></span><div class="header"> <p> Next: <a href="#Properties" accesskey="n" rel="next">Properties</a>, Previous: <a href="#g_t_005cedefappend" accesskey="p" rel="prev">\edefappend</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Hooks-1"></a> -<h4 class="subsection">7.6.3 Hooks</h4> +<span id="Hooks-1"></span><h4 class="subsection">7.6.3 Hooks</h4> -<a name="index-hooks"></a> +<span id="index-hooks"></span> <p>A <em>hook</em> is simply a name for a group of actions which is executed in certain places—presumably when it is most useful to allow customization or modification. TeX already provides many builtin @@ -8389,20 +8253,20 @@ take two arguments: the name of the hook and the new actions. </p> <dl compact="compact"> <dd> -<a name="index-hookaction"></a> +<span id="index-hookaction"></span> </dd> <dt><code>hookaction <var>name</var> <var>actions</var></code></dt> -<dd><a name="index-hookappend"></a> +<dd><span id="index-hookappend"></span> </dd> <dt><code>hookappend <var>name</var> <var>actions</var></code></dt> -<dd><a name="index-hookprepend"></a> +<dd><span id="index-hookprepend"></span> </dd> <dt><code>hookprepend <var>name</var> <var>actions</var></code></dt> <dd><p>Each of these adds <var>actions</var> to the hook <var>name</var>. (Any previously-defined actions are retained.) <var>name</var> is not a control sequence, but rather the characters of the name. </p> -<a name="index-hookactiononce"></a> +<span id="index-hookactiononce"></span> </dd> <dt><code>hookactiononce <var>name</var> <code>\<var>cs</var></code></code></dt> <dd><p><code>\hookactiononce</code> adds <var>cs</var> to <var>name</var>, like the macros @@ -8424,7 +8288,7 @@ variable itself, so TeX’s usual grouping rules apply. </p></dd> </dl> -<a name="index-hookrun"></a> +<span id="index-hookrun"></span> <p>The companion macro to defining hook actions is <code>\hookrun</code>, for running them. This takes a single argument, the name of the hook. If no actions for the hook are defined, no error ensues. @@ -8445,16 +8309,14 @@ other actions (as long as the other actions use <code>\hookprepend</code> and <hr> -<a name="Properties"></a> -<div class="header"> +<span id="Properties"></span><div class="header"> <p> Next: <a href="#g_t_005cexpandonce" accesskey="n" rel="next">\expandonce</a>, Previous: <a href="#Hooks" accesskey="p" rel="prev">Hooks</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Properties-1"></a> -<h4 class="subsection">7.6.4 Properties</h4> +<span id="Properties-1"></span><h4 class="subsection">7.6.4 Properties</h4> -<a name="index-properties"></a> -<a name="index-atom"></a> +<span id="index-properties"></span> +<span id="index-atom"></span> <p>A <em>property</em> is a name/value pair associated with another symbol, traditionally called an <em>atom</em>. Both atom and property names are control sequence names. @@ -8464,14 +8326,14 @@ control sequence names. </p> <dl compact="compact"> <dd> -<a name="index-setproperty"></a> +<span id="index-setproperty"></span> </dd> <dt><code>\setproperty <var>atom</var> <var>propname</var> <var>value</var></code></dt> <dd><p><code>\setproperty</code> defines the property <var>property</var> on the atom <var>atom</var> to be <var>value</var>. <var>atom</var> and <var>propname</var> can be anything acceptable to <code>\csname</code>. <var>value</var> can be anything. </p> -<a name="index-getproperty"></a> +<span id="index-getproperty"></span> </dd> <dt><code>\getproperty <var>atom</var> <var>propname</var></code></dt> <dd><p><code>\getproperty</code> expands to the value stored for <var>propname</var> on @@ -8495,16 +8357,14 @@ conceptual. <hr> -<a name="g_t_005cexpandonce"></a> -<div class="header"> +<span id="g_t_005cexpandonce"></span><div class="header"> <p> Next: <a href="#g_t_005cifundefined" accesskey="n" rel="next">\ifundefined</a>, Previous: <a href="#Properties" accesskey="p" rel="prev">Properties</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="g_t_005cexpandonce-1"></a> -<h4 class="subsection">7.6.5 <code>\expandonce</code></h4> +<span id="g_t_005cexpandonce-1"></span><h4 class="subsection">7.6.5 <code>\expandonce</code></h4> -<a name="index-expansion_002c-one_002dlevel"></a> -<a name="index-expandonce"></a> +<span id="index-expansion_002c-one_002dlevel"></span> +<span id="index-expandonce"></span> <p><code>\expandonce</code> is defined as <code>\expandafter\noexpand</code>. Thus, <code>\expandonce <var>token</var></code> expands <var>token</var> once, instead of to TeX primitives. This is most useful in an <code>\edef</code>. @@ -8520,21 +8380,19 @@ TeX primitives. This is most useful in an <code>\edef</code>. <hr> -<a name="g_t_005cifundefined"></a> -<div class="header"> +<span id="g_t_005cifundefined"></span><div class="header"> <p> Next: <a href="#g_t_005cifempty" accesskey="n" rel="next">\ifempty</a>, Previous: <a href="#g_t_005cexpandonce" accesskey="p" rel="prev">\expandonce</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="g_t_005cifundefined-1"></a> -<h4 class="subsection">7.6.6 <code>\ifundefined</code></h4> +<span id="g_t_005cifundefined-1"></span><h4 class="subsection">7.6.6 <code>\ifundefined</code></h4> -<a name="index-ifundefined"></a> +<span id="index-ifundefined"></span> <p><code>\ifundefined{<var>cs</var>} <var>t</var> \else <var>f</var> \fi</code> expands the <var>t</var> text if the control sequence <code>\<var>cs</var></code> is undefined or has been <code>\let</code> to <code>\relax</code>, and the <var>f</var> text otherwise. </p> -<a name="index-skipping-tokens"></a> -<a name="index-undefined-control-sequence_002c-checking-for"></a> +<span id="index-skipping-tokens"></span> +<span id="index-undefined-control-sequence_002c-checking-for"></span> <p>Since <code>\ifundefined</code> is not a primitive conditional, it cannot be used in places where TeX might skip tokens “at high speed”, e.g., within another conditional—TeX can’t match up the <code>\if</code>’s and @@ -8544,17 +8402,15 @@ within another conditional—TeX can’t match up the <code>\if</code>&r </p> <hr> -<a name="g_t_005cifempty"></a> -<div class="header"> +<span id="g_t_005cifempty"></span><div class="header"> <p> Next: <a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="n" rel="next">\ifinteger and \isinteger</a>, Previous: <a href="#g_t_005cifundefined" accesskey="p" rel="prev">\ifundefined</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="g_t_005cifempty-1"></a> -<h4 class="subsection">7.6.7 <code>\ifempty</code></h4> +<span id="g_t_005cifempty-1"></span><h4 class="subsection">7.6.7 <code>\ifempty</code></h4> -<a name="index-ifempty"></a> -<a name="index-empty-string_002c-checking-for"></a> -<a name="index-empty-argument_002c-checking-for"></a> +<span id="index-ifempty"></span> +<span id="index-empty-string_002c-checking-for"></span> +<span id="index-empty-argument_002c-checking-for"></span> <p><code>\ifempty{<var>arg</var>} <var>t</var> \else <var>f</var> \fi</code> expands the <var>t</var> text if <var>arg</var> is the empty string, and the <var>f</var> text otherwise. This macro is useful when you need to test for empty @@ -8564,7 +8420,7 @@ arguments to your macros, for example: <pre class="example">\def\foo#1{\ifempty{#1} <var>t</var> \else <var>f</var> \fi} </pre></div> -<a name="index-skipping-tokens-1"></a> +<span id="index-skipping-tokens-1"></span> <p>Since <code>\ifempty</code> is not a primitive conditional, it cannot be used in places where TeX might skip tokens “at high speed”, e.g., within another conditional—TeX can’t match up the <code>\if</code>’s and @@ -8581,20 +8437,18 @@ within another conditional—TeX can’t match up the <code>\if</code>&r </p> <hr> -<a name="g_t_005cifinteger-and-_005cisinteger"></a> -<div class="header"> +<span id="g_t_005cifinteger-and-_005cisinteger"></span><div class="header"> <p> Next: <a href="#g_t_005cfuturenonspacelet" accesskey="n" rel="next">\futurenonspacelet</a>, Previous: <a href="#g_t_005cifempty" accesskey="p" rel="prev">\ifempty</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="g_t_005cifinteger-and-_005cisinteger-1"></a> -<h4 class="subsection">7.6.8 <code>\ifinteger</code> and <code>\isinteger</code></h4> - -<a name="index-ifinteger"></a> -<a name="index-integers_002c-detecting"></a> -<a name="index-numbers_002c-detecting"></a> -<a name="index-detecting-numbers"></a> -<a name="index-identifying-numbers"></a> -<a name="index-recognizing-numbers"></a> +<span id="g_t_005cifinteger-and-_005cisinteger-1"></span><h4 class="subsection">7.6.8 <code>\ifinteger</code> and <code>\isinteger</code></h4> + +<span id="index-ifinteger"></span> +<span id="index-integers_002c-detecting"></span> +<span id="index-numbers_002c-detecting"></span> +<span id="index-detecting-numbers"></span> +<span id="index-identifying-numbers"></span> +<span id="index-recognizing-numbers"></span> <p><code>\ifinteger{<var>arg</var>} <var>t</var> \else <var>f</var> \fi</code> expands the <var>t</var> text if <var>arg</var> is an integer, and the <var>f</var> text otherwise. This macro can detect positive and negative integers. @@ -8603,7 +8457,7 @@ otherwise. This macro can detect positive and negative integers. used in places where TeX might skip tokens “at high speed”, e.g., within another conditional—TeX can’t match up the <code>\if</code>’s and <code>\fi</code>’s. For such situations Eplain provides -<a name="index-isinteger"></a> +<span id="index-isinteger"></span> <code>\isinteger</code>, which can be used as follows: </p> <div class="example"> @@ -8621,23 +8475,21 @@ following code <p>will expand to ‘<samp>ab_integer</samp>’ (and thus would not even compile outside math mode). </p> -<a name="index-TeX-Frequently-Asked-Question"></a> -<p>These macros come from TeX Frequently Asked Question +<span id="index-TeX-Frequently-Asked-Questions"></span> +<p>These macros come from the TeX Frequently Asked Questions (<a href="http://www.tex.ac.uk/cgi-bin/texfaq2html">http://www.tex.ac.uk/cgi-bin/texfaq2html</a>). </p> <hr> -<a name="g_t_005cfuturenonspacelet"></a> -<div class="header"> +<span id="g_t_005cfuturenonspacelet"></span><div class="header"> <p> Previous: <a href="#g_t_005cifinteger-and-_005cisinteger" accesskey="p" rel="prev">\ifinteger and \isinteger</a>, Up: <a href="#Expansion" accesskey="u" rel="up">Expansion</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="g_t_005cfuturenonspacelet-1"></a> -<h4 class="subsection">7.6.9 <code>\futurenonspacelet</code></h4> +<span id="g_t_005cfuturenonspacelet-1"></span><h4 class="subsection">7.6.9 <code>\futurenonspacelet</code></h4> -<a name="index-lookahead-without-spaces"></a> -<a name="index-spaces_002c-ignoring"></a> -<a name="index-futurenonspacelet"></a> +<span id="index-lookahead-without-spaces"></span> +<span id="index-spaces_002c-ignoring"></span> +<span id="index-futurenonspacelet"></span> <p>The <code>\futurelet</code> primitive allows you to look at the next token from the input. Sometimes, though, you want to look ahead while ignoring any spaces. This is what <code>\futurenonspacelet</code> does. It @@ -8652,18 +8504,16 @@ first, and then expands the second. For example: <hr> -<a name="Obeying-spaces"></a> -<div class="header"> +<span id="Obeying-spaces"></span><div class="header"> <p> Next: <a href="#Writing-out-numbers" accesskey="n" rel="next">Writing out numbers</a>, Previous: <a href="#Expansion" accesskey="p" rel="prev">Expansion</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Obeying-spaces-1"></a> -<h3 class="section">7.7 Obeying spaces</h3> +<span id="Obeying-spaces-1"></span><h3 class="section">7.7 Obeying spaces</h3> -<a name="index-whitespace"></a> -<a name="index-spaces_002c-obeying"></a> -<a name="index-newlines_002c-obeying"></a> -<a name="index-obeywhitespace"></a> +<span id="index-whitespace"></span> +<span id="index-spaces_002c-obeying"></span> +<span id="index-newlines_002c-obeying"></span> +<span id="index-obeywhitespace"></span> <p><code>\obeywhitespace</code> makes both end-of-lines and space characters in the input be respected in the output. Unlike plain TeX’s @@ -8677,7 +8527,7 @@ what <code>\ </code> produces. <p>Ordinarily, a blank line in the input produces as much blank vertical space as a line of text would occupy. You can adjust this by assigning to the parameter <code>\blanklineskipamount</code>: -<a name="index-blanklineskipamount-in-obeyed-text"></a> +<span id="index-blanklineskipamount-in-obeyed-text"></span> if you set this negative, the space produced by a blank line will be smaller; if positive, larger. </p> @@ -8685,40 +8535,36 @@ smaller; if positive, larger. at the beginning of a line, they will disappear. (If you are trying to make TeX do the “right thing” with tabs, don’t. Use a utility program like <i>expand</i> instead.) -<a name="index-tabs"></a> +<span id="index-tabs"></span> </p> <hr> -<a name="Writing-out-numbers"></a> -<div class="header"> +<span id="Writing-out-numbers"></span><div class="header"> <p> Next: <a href="#Mode_002dspecific-penalties" accesskey="n" rel="next">Mode-specific penalties</a>, Previous: <a href="#Obeying-spaces" accesskey="p" rel="prev">Obeying spaces</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Writing-out-numbers-1"></a> -<h3 class="section">7.8 Writing out numbers</h3> +<span id="Writing-out-numbers-1"></span><h3 class="section">7.8 Writing out numbers</h3> -<a name="index-numbers_002c-written-form-of"></a> +<span id="index-numbers_002c-written-form-of"></span> <p><code>\numbername</code> -<a name="index-numbername"></a> +<span id="index-numbername"></span> produces the written-out form of its argument, i.e., ‘zero’ through ‘ten’ for the numbers 0–10, and numerals for all others. </p> <hr> -<a name="Mode_002dspecific-penalties"></a> -<div class="header"> +<span id="Mode_002dspecific-penalties"></span><div class="header"> <p> Next: <a href="#Auxiliary-files" accesskey="n" rel="next">Auxiliary files</a>, Previous: <a href="#Writing-out-numbers" accesskey="p" rel="prev">Writing out numbers</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Mode_002dspecific-penalties-1"></a> -<h3 class="section">7.9 Mode-specific penalties</h3> +<span id="Mode_002dspecific-penalties-1"></span><h3 class="section">7.9 Mode-specific penalties</h3> <p>TeX’s built-in <code>\penalty</code> command simply appends to the current list, no matter what kind of list it is. You might intend a particular penalty to always be a “vertical” penalty, however, i.e., appended to a vertical list. Therefore, Eplain provides <code>\vpenalty</code> -<a name="index-vpenalty"></a> +<span id="index-vpenalty"></span> and <code>\hpenalty</code> which first leave the other mode and then do <code>\penalty</code>. </p> @@ -8729,24 +8575,22 @@ math mode.) </p> <hr> -<a name="Auxiliary-files"></a> -<div class="header"> +<span id="Auxiliary-files"></span><div class="header"> <p> Next: <a href="#User_002ddefined-environments" accesskey="n" rel="next">User-defined environments</a>, Previous: <a href="#Mode_002dspecific-penalties" accesskey="p" rel="prev">Mode-specific penalties</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Auxiliary-files-1"></a> -<h3 class="section">7.10 Auxiliary files</h3> +<span id="Auxiliary-files-1"></span><h3 class="section">7.10 Auxiliary files</h3> -<a name="index-axuiliary-files_002c-existence-of"></a> +<span id="index-auxiliary-files_002c-existence-of"></span> <p>It is common to write some information out to a file to be used on a subsequent run. But when it is time to read the file again, you only want to do so if the file actually exists. <code>\testfileexistence</code> -<a name="index-testfileexistence"></a> +<span id="index-testfileexistence"></span> is given an argument which is appended to <code>\jobname</code>, -<a name="index-jobname-2"></a> +<span id="index-jobname-2"></span> and sets the conditional <code>\iffileexists</code> -<a name="index-iffileexists"></a> -<a name="index-fileexists-_0028conditional_0029"></a> +<span id="index-iffileexists"></span> +<span id="index-fileexists-_0028conditional_0029"></span> appropriately. For example: </p> <div class="example"> @@ -8770,15 +8614,13 @@ name. For example, if you want to test for the file <hr> -<a name="User_002ddefined-environments"></a> -<div class="header"> +<span id="User_002ddefined-environments"></span><div class="header"> <p> Next: <a href="#Page-list-and-page-range-parsers" accesskey="n" rel="next">Page list and page range parsers</a>, Previous: <a href="#Auxiliary-files" accesskey="p" rel="prev">Auxiliary files</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="User_002ddefined-environments-1"></a> -<h3 class="section">7.11 User-defined environments</h3> +<span id="User_002ddefined-environments-1"></span><h3 class="section">7.11 User-defined environments</h3> -<a name="index-environments_002c-user_002ddefined"></a> +<span id="index-environments_002c-user_002ddefined"></span> <p>Plain TeX does not provide “named” block structures, only the anonymous <code>\begingroup</code> and <code>\endgroup</code> pair. The disadvantage of this is that when there are several such groups and one is mismatched, it can @@ -8816,18 +8658,16 @@ environment that should not be nested. </p> <hr> -<a name="Page-list-and-page-range-parsers"></a> -<div class="header"> +<span id="Page-list-and-page-range-parsers"></span><div class="header"> <p> Previous: <a href="#User_002ddefined-environments" accesskey="p" rel="prev">User-defined environments</a>, Up: <a href="#Programming-definitions" accesskey="u" rel="up">Programming definitions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Page-list-and-page-range-parsers-1"></a> -<h3 class="section">7.12 Page list and page range parsers</h3> +<span id="Page-list-and-page-range-parsers-1"></span><h3 class="section">7.12 Page list and page range parsers</h3> -<a name="index-idxparselist"></a> -<a name="index-idxparserange"></a> -<a name="index-idxpagei"></a> -<a name="index-idxpageii"></a> +<span id="index-idxparselist"></span> +<span id="index-idxparserange"></span> +<span id="index-idxpagei"></span> +<span id="index-idxpageii"></span> <p>The macros which Eplain uses to parse the page lists and ranges in the index, <code>\idxparselist</code> and <code>\idxparserange</code> (see <a href="#Page-destinations-for-index-terms">Page destinations for index terms</a>), are sometimes useful when defining page number encapsulators. They take one argument, text to parse. When a @@ -8836,8 +8676,8 @@ page list (range) is not present, they set <code>\idxpagei</code> to be <code>\idxpagei</code> and <code>\idxpageii</code> to the first and the second page numbers, respectively. </p> -<a name="index-setidxpagelistdelimiter"></a> -<a name="index-setidxpagerangedelimiter"></a> +<span id="index-setidxpagelistdelimiter"></span> +<span id="index-setidxpagerangedelimiter"></span> <p>Eplain’s defaults for the page list and page range delimiters are the same as those in MakeIndex, a comma followed by a space (‘<samp>, </samp>’) and two dashes (‘<samp>--</samp>’), respectively. If you customize MakeIndex to use @@ -8851,19 +8691,19 @@ with the commands <p>These commands save the <var>list-delim</var> and <var>page-delim</var> delimiters in -<a name="index-idxpagelistdelimiter"></a> -<a name="index-idxpagerangedelimiter"></a> +<span id="index-idxpagelistdelimiter"></span> +<span id="index-idxpagerangedelimiter"></span> <code>\idxpagelistdelimiter</code> and <code>\idxpagerangedelimiter</code>, respectively. </p> -<a name="index-underlining-page-numbers-in-index"></a> -<a name="index-index_002c-underlining-page-numbers"></a> -<a name="index-ituline"></a> +<span id="index-underlining-page-numbers-in-index"></span> +<span id="index-index_002c-underlining-page-numbers"></span> +<span id="index-ituline"></span> <p>For example, you may want to define a page number markup command which italicizes and properly underlines page ranges by underlining only the page numbers and not the delimiter: </p> -<a name="index-idxpagerangedelimiter-1"></a> +<span id="index-idxpagerangedelimiter-1"></span> <div class="example"> <pre class="example">\def\ituline#1{% {\it @@ -8886,83 +8726,79 @@ need to design a macro which also takes care of the lists, you can extend <code>\ituline</code> with an additional call to <code>\idxparselist</code>. </p> <hr> -<a name="Demo-files"></a> -<div class="header"> +<span id="Demo-files"></span><div class="header"> <p> Next: <a href="#Macro-index" accesskey="n" rel="next">Macro index</a>, Previous: <a href="#Programming-definitions" accesskey="p" rel="prev">Programming definitions</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Demo-files-1"></a> -<h2 class="chapter">8 Demo files</h2> +<span id="Demo-files-1"></span><h2 class="chapter">8 Demo files</h2> -<a name="index-demo-files"></a> +<span id="index-demo-files"></span> <p>This chapter contains listings of source files, along with the output they produce (where appropriate), which illustrate various aspects of Eplain. The files can be found in the <code>demo</code> subdirectory of Eplain distribution. These demos, both the sources and the compiled PDF -and PS files, are also available from <a href="http://tug.org/eplain/demo">http://tug.org/eplain/demo</a>. +and PS files, are also available from <a href="https://tug.org/eplain/demo">https://tug.org/eplain/demo</a>. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Hyperlinks-_0028xhyper_002etex_0029" accesskey="1">Hyperlinks (xhyper.tex)</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Hyperlinks-_0028xhyper_002etex_0029" accesskey="1">Hyperlinks (xhyper.tex)</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029" accesskey="2">Highlighting TeX comments in listings (lscommnt.tex)</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029" accesskey="2">Highlighting TeX comments in listings (lscommnt.tex)</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Hyperlinks-_0028xhyper_002etex_0029"></a> -<div class="header"> +<span id="Hyperlinks-_0028xhyper_002etex_0029"></span><div class="header"> <p> Next: <a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029" accesskey="n" rel="next">Highlighting TeX comments in listings (lscommnt.tex)</a>, Up: <a href="#Demo-files" accesskey="u" rel="up">Demo files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Hyperlinks-_0028xhyper_002etex_0029-1"></a> -<h3 class="section">8.1 Hyperlinks (<code>xhyper.tex</code>)</h3> +<span id="Hyperlinks-_0028xhyper_002etex_0029-1"></span><h3 class="section">8.1 Hyperlinks (<code>xhyper.tex</code>)</h3> <img src="xhyper.jpg" alt="xhyper"> -<a name="index-xhyper_002etex"></a> - -<a name="index-hyperlinks_002c-demo"></a> -<a name="index-explicit-hyperlinks_002c-demo"></a> -<a name="index-hyperlinks_002c-explicit_002c-demo"></a> -<a name="index-implicit-hyperlinks_002c-demo"></a> -<a name="index-hyperlinks_002c-implicit_002c-demo"></a> - -<a name="index-hlstart-4"></a> -<a name="index-hlend-1"></a> - -<a name="index-group-options_002c-hyperlink_002c-demo"></a> -<a name="index-hyperlinks_002c-group-options_002c-demo"></a> -<a name="index-link_002c-group-options_002c-demo"></a> -<a name="index-linkgroup-options_002c-demo"></a> -<a name="index-destinations_002c-group-options_002c-demo"></a> -<a name="index-destgroup-options_002c-demo"></a> - -<a name="index-group-type_002c-hyperlink_002c-demo"></a> -<a name="index-destinations_002c-group-type_002c-demo"></a> -<a name="index-destgroup-type_002c-demo"></a> - -<a name="index-hlopts-2"></a> -<a name="index-hldesttype-2"></a> -<a name="index-hldestopts-2"></a> - -<a name="index-cross_002dreferences_002c-demo"></a> -<a name="index-definexref-1"></a> -<a name="index-ref-1"></a> - -<a name="index-graphics-collection_002c-LaTeX_002c-demo"></a> -<a name="index-LaTeX-graphics-collection_002c-demo"></a> -<a name="index-color_002c-demo"></a> -<a name="index-rotation_002c-demo"></a> -<a name="index-scaling_002c-demo"></a> -<a name="index-color_002esty-4"></a> -<a name="index-graphicx_002esty-1"></a> -<a name="index-url_002esty-2"></a> - -<a name="index-includegraphics"></a> -<a name="index-rotatebox"></a> -<a name="index-definecolor"></a> -<a name="index-url"></a> +<span id="index-xhyper_002etex"></span> + +<span id="index-hyperlinks_002c-demo"></span> +<span id="index-explicit-hyperlinks_002c-demo"></span> +<span id="index-hyperlinks_002c-explicit_002c-demo"></span> +<span id="index-implicit-hyperlinks_002c-demo"></span> +<span id="index-hyperlinks_002c-implicit_002c-demo"></span> + +<span id="index-hlstart-4"></span> +<span id="index-hlend-1"></span> + +<span id="index-group-options_002c-hyperlink_002c-demo"></span> +<span id="index-hyperlinks_002c-group-options_002c-demo"></span> +<span id="index-link_002c-group-options_002c-demo"></span> +<span id="index-linkgroup-options_002c-demo"></span> +<span id="index-destinations_002c-group-options_002c-demo"></span> +<span id="index-destgroup-options_002c-demo"></span> + +<span id="index-group-type_002c-hyperlink_002c-demo"></span> +<span id="index-destinations_002c-group-type_002c-demo"></span> +<span id="index-destgroup-type_002c-demo"></span> + +<span id="index-hlopts-2"></span> +<span id="index-hldesttype-2"></span> +<span id="index-hldestopts-2"></span> + +<span id="index-cross_002dreferences_002c-demo"></span> +<span id="index-definexref-1"></span> +<span id="index-ref-1"></span> + +<span id="index-graphics-collection_002c-LaTeX_002c-demo"></span> +<span id="index-LaTeX-graphics-collection_002c-demo"></span> +<span id="index-color_002c-demo"></span> +<span id="index-rotation_002c-demo"></span> +<span id="index-scaling_002c-demo"></span> +<span id="index-color_002esty-4"></span> +<span id="index-graphicx_002esty-1"></span> +<span id="index-url_002esty-2"></span> + +<span id="index-includegraphics"></span> +<span id="index-rotatebox"></span> +<span id="index-definecolor"></span> +<span id="index-url"></span> <pre class="verbatim">% (This file is public domain.) % % This file demonstrates the following features of Eplain: @@ -9156,30 +8992,28 @@ Take me to </pre> <hr> -<a name="Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029"></a> -<div class="header"> +<span id="Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029"></span><div class="header"> <p> Previous: <a href="#Hyperlinks-_0028xhyper_002etex_0029" accesskey="p" rel="prev">Hyperlinks (xhyper.tex)</a>, Up: <a href="#Demo-files" accesskey="u" rel="up">Demo files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029-1"></a> -<h3 class="section">8.2 Highlighting TeX comments in listings (<code>lscommnt.tex</code>)</h3> +<span id="Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029-1"></span><h3 class="section">8.2 Highlighting TeX comments in listings (<code>lscommnt.tex</code>)</h3> <img src="lscommnt.jpg" alt="lscommnt"> -<a name="index-lscommnt_002etex"></a> +<span id="index-lscommnt_002etex"></span> -<a name="index-verbatim-listing_002c-demo"></a> -<a name="index-listing-files_002c-demo"></a> -<a name="index-files_002c-verbatim-listing-of_002c-demo"></a> -<a name="index-comments_002c-highlighting-in-listings"></a> -<a name="index-highlighting_002c-in-listings"></a> +<span id="index-verbatim-listing_002c-demo"></span> +<span id="index-listing-files_002c-demo"></span> +<span id="index-files_002c-verbatim-listing-of_002c-demo"></span> +<span id="index-comments_002c-highlighting-in-listings"></span> +<span id="index-highlighting_002c-in-listings"></span> -<a name="index-listing-1"></a> -<a name="index-setuplistinghook-1"></a> -<a name="index-linenumberedlisting-1"></a> -<a name="index-nolastlinelisting-1"></a> -<a name="index-hlightcommentslisting"></a> +<span id="index-listing-1"></span> +<span id="index-setuplistinghook-1"></span> +<span id="index-linenumberedlisting-1"></span> +<span id="index-nolastlinelisting-1"></span> +<span id="index-hlightcommentslisting"></span> <pre class="verbatim">% (This file is public domain.) % Demonstrate how Eplain can be used to include a TeX source file % verbatim, typesetting comments in colored italic typewriter type. @@ -9229,18 +9063,14 @@ Previous: <a href="#Hyperlinks-_0028xhyper_002etex_0029" accesskey="p" rel="prev \bye </pre> <hr> -<a name="Macro-index"></a> -<div class="header"> +<span id="Macro-index"></span><div class="header"> <p> Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previous: <a href="#Demo-files" accesskey="p" rel="prev">Demo files</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Macro-index-1"></a> -<h2 class="unnumbered">Macro index</h2> +<span id="Macro-index-1"></span><h2 class="unnumbered">Macro index</h2> <table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Macro-index_fn_symbol-1"><b>@</b></a> -<a class="summary-letter" href="#Macro-index_fn_symbol-2"><b>\</b></a> - <br> <a class="summary-letter" href="#Macro-index_fn_letter-A"><b>A</b></a> @@ -9294,7 +9124,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <table class="index-fn" border="0"> <tr><td></td><th align="left">Index Entry</th><td> </td><th align="left"> Section</th></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_symbol-1">@</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_symbol-1">@</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-_0040getoptionalarg"><code>@getoptionalarg</code></a>:</td><td> </td><td valign="top"><a href="#Macro-arguments">Macro arguments</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_0040hllabel"><code>@hllabel</code></a>:</td><td> </td><td valign="top"><a href="#Destination-types-for-hypertex">Destination types for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_0040hllabel-1"><code>@hllabel</code></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> @@ -9302,15 +9132,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-_0040hllabel-3"><code>@hllabel</code></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_0040indexproof-insertion-class"><code>@indexproof <span class="roman">insertion class</span></code></a>:</td><td> </td><td valign="top"><a href="#Proofing-index-terms">Proofing index terms</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_symbol-2">\</a></th><td></td><td></td></tr> -<tr><td></td><td valign="top"><a href="#index-_005cleftskip"><code>\leftskip</code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-_005craggedleft"><code>\raggedleft</code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-_005craggedleftskip"><code>\raggedleftskip</code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-_005craggedright"><code>\raggedright</code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-_005cspaceskip_002c-reset-by-_005cragged_002e_002e_002e"><code>\spaceskip<span class="roman">, reset by <code>\ragged...</code></span></code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-_005cxspaceskip_002c-reset-by-_005cragged_002e_002e_002e"><code>\xspaceskip<span class="roman">, reset by <code>\ragged...</code></span></code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> -<tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-A">A</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-A">A</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-abovecolumnskip"><code>abovecolumnskip</code></a>:</td><td> </td><td valign="top"><a href="#Multiple-columns">Multiple columns</a></td></tr> <tr><td></td><td valign="top"><a href="#index-abovecolumnspenalty"><code>abovecolumnspenalty</code></a>:</td><td> </td><td valign="top"><a href="#Tables">Tables</a></td></tr> <tr><td></td><td valign="top"><a href="#index-abovelistpenalty"><code>abovelistpenalty</code></a>:</td><td> </td><td valign="top"><a href="#Formatting-lists">Formatting lists</a></td></tr> @@ -9332,7 +9154,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-arrow"><code>arrow</code></a>:</td><td> </td><td valign="top"><a href="#Arrows-and-morphisms">Arrows and morphisms</a></td></tr> <tr><td></td><td valign="top"><a href="#index-arrow-1"><code>arrow</code></a>:</td><td> </td><td valign="top"><a href="#Arrows-and-morphisms">Arrows and morphisms</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-B">B</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-B">B</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-bblem"><code>bblem</code></a>:</td><td> </td><td valign="top"><a href="#Formatting-bibliographies">Formatting bibliographies</a></td></tr> <tr><td></td><td valign="top"><a href="#index-bblemph"><code>bblemph</code></a>:</td><td> </td><td valign="top"><a href="#Formatting-bibliographies">Formatting bibliographies</a></td></tr> <tr><td></td><td valign="top"><a href="#index-bblfilebasename"><code>bblfilebasename</code></a>:</td><td> </td><td valign="top"><a href="#Citations">Citations</a></td></tr> @@ -9382,7 +9204,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-bstyle-_0028hyperlink-option_0029"><code>bstyle <span class="roman">(hyperlink option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-bwidth-_0028hyperlink-option_0029"><code>bwidth <span class="roman">(hyperlink option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-C">C</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-C">C</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-catcode"><code>catcode</code></a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-center"><code>center</code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> <tr><td></td><td valign="top"><a href="#index-centereddisplays"><code>centereddisplays</code></a>:</td><td> </td><td valign="top"><a href="#Displays">Displays</a></td></tr> @@ -9406,7 +9228,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-commdiagbaselines-1"><code>commdiagbaselines</code></a>:</td><td> </td><td valign="top"><a href="#Commutative-diagram-parameters">Commutative diagram parameters</a></td></tr> <tr><td></td><td valign="top"><a href="#index-csn"><code>csn</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ccsn-and-_005cece">\csn and \ece</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-D">D</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-D">D</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-definecolor"><code>definecolor</code></a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td></tr> <tr><td></td><td valign="top"><a href="#index-definecontentsfile"><code>definecontentsfile</code></a>:</td><td> </td><td valign="top"><a href="#Alternative-contents-files">Alternative contents files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-defineindex"><code>defineindex</code></a>:</td><td> </td><td valign="top"><a href="#Indexing">Indexing</a></td></tr> @@ -9418,13 +9240,14 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-depth-_0028hyperlink-option_0029"><code>depth <span class="roman">(hyperlink option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-discretionaries"><code>discretionaries</code></a>:</td><td> </td><td valign="top"><a href="#Paths">Paths</a></td></tr> <tr><td></td><td valign="top"><a href="#index-displaylines"><code>displaylines</code></a>:</td><td> </td><td valign="top"><a href="#Displays">Displays</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-DOCVIEW-pdfmark"><code>DOCVIEW <span class="roman">pdfmark</span></code></a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> <tr><td></td><td valign="top"><a href="#index-dospecials"><code>dospecials</code></a>:</td><td> </td><td valign="top"><a href="#Verbatim-listing">Verbatim listing</a></td></tr> <tr><td></td><td valign="top"><a href="#index-doublecolumns"><code>doublecolumns</code></a>:</td><td> </td><td valign="top"><a href="#Multiple-columns">Multiple columns</a></td></tr> <tr><td></td><td valign="top"><a href="#index-drawline"><code>drawline</code></a>:</td><td> </td><td valign="top"><a href="#Slanted-lines-and-vectors">Slanted lines and vectors</a></td></tr> <tr><td></td><td valign="top"><a href="#index-drawvector"><code>drawvector</code></a>:</td><td> </td><td valign="top"><a href="#Slanted-lines-and-vectors">Slanted lines and vectors</a></td></tr> <tr><td></td><td valign="top"><a href="#index-dvipdfm-_0028hyperlink-driver_0029"><code>dvipdfm <span class="roman">(hyperlink driver)</span></code></a>:</td><td> </td><td valign="top"><a href="#Hyperlink-drivers-pdftex-and-dvipdfm">Hyperlink drivers pdftex and dvipdfm</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-E">E</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-E">E</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-eattoken"><code>eattoken</code></a>:</td><td> </td><td valign="top"><a href="#Macro-arguments">Macro arguments</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ece"><code>ece</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ccsn-and-_005cece">\csn and \ece</a></td></tr> <tr><td></td><td valign="top"><a href="#index-edefappend"><code>edefappend</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cedefappend">\edefappend</a></td></tr> @@ -9475,7 +9298,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-ext-_0028hyperlink-option_0029-1"><code>ext <span class="roman">(hyperlink option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-options-for-hypertex">Link options for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ExTeX-1"><code>ExTeX</code></a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-F">F</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-F">F</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-file-_0028hyperlink-option_0029"><code>file <span class="roman">(hyperlink option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-file-_0028hyperlink-option_0029-1"><code>file <span class="roman">(hyperlink option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-options-for-hypertex">Link options for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-file-_0028hyperlink-option_0029-2"><code>file <span class="roman">(hyperlink option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> @@ -9505,7 +9328,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-fullmonthname"><code>fullmonthname</code></a>:</td><td> </td><td valign="top"><a href="#Time-of-day">Time of day</a></td></tr> <tr><td></td><td valign="top"><a href="#index-futurenonspacelet"><code>futurenonspacelet</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfuturenonspacelet">\futurenonspacelet</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-G">G</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-G">G</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-getproperty"><code>getproperty</code></a>:</td><td> </td><td valign="top"><a href="#Properties">Properties</a></td></tr> <tr><td></td><td valign="top"><a href="#index-gloggingall"><code>gloggingall</code></a>:</td><td> </td><td valign="top"><a href="#Diagnostics">Diagnostics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-gobble"><code>gobble</code></a>:</td><td> </td><td valign="top"><a href="#Macro-arguments">Macro arguments</a></td></tr> @@ -9515,7 +9338,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-gutter"><code>gutter</code></a>:</td><td> </td><td valign="top"><a href="#Multiple-columns">Multiple columns</a></td></tr> <tr><td></td><td valign="top"><a href="#index-gutterbox"><code>gutterbox</code></a>:</td><td> </td><td valign="top"><a href="#Multiple-columns">Multiple columns</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-H">H</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-H">H</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-hangindent-for-index-entries"><code>hangindent <span class="roman">for index entries</span></code></a>:</td><td> </td><td valign="top"><a href="#Typesetting-an-index">Typesetting an index</a></td></tr> <tr><td></td><td valign="top"><a href="#index-harrowlength"><code>harrowlength</code></a>:</td><td> </td><td valign="top"><a href="#Arrows-and-morphisms">Arrows and morphisms</a></td></tr> <tr><td></td><td valign="top"><a href="#index-harrowlength-1"><code>harrowlength</code></a>:</td><td> </td><td valign="top"><a href="#Commutative-diagram-parameters">Commutative diagram parameters</a></td></tr> @@ -9588,7 +9411,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-hypertex-_0028hyperlink-driver_0029"><code>hypertex <span class="roman">(hyperlink driver)</span></code></a>:</td><td> </td><td valign="top"><a href="#Hyperlink-driver-hypertex">Hyperlink driver hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hyphenpenalty-for-index-entries"><code>hyphenpenalty <span class="roman">for index entries</span></code></a>:</td><td> </td><td valign="top"><a href="#Typesetting-an-index">Typesetting an index</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-I">I</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-I">I</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-identity"><code>identity</code></a>:</td><td> </td><td valign="top"><a href="#Macro-arguments">Macro arguments</a></td></tr> <tr><td></td><td valign="top"><a href="#index-idx"><code>idx</code></a>:</td><td> </td><td valign="top"><a href="#Indexing-commands">Indexing commands</a></td></tr> <tr><td></td><td valign="top"><a href="#index-idx-_0028hyperlinks_0029"><code>idx <span class="roman">(hyperlinks)</span></code></a>:</td><td> </td><td valign="top"><a href="#Index-hyperlinks">Index hyperlinks</a></td></tr> @@ -9627,6 +9450,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-ifinteger"><code>ifinteger</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cifinteger-and-_005cisinteger">\ifinteger and \isinteger</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ifpdf"><code>ifpdf</code></a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ifpdf-1"><code>ifpdf</code></a>:</td><td> </td><td valign="top"><a href="#Introduction-to-hyperlinks">Introduction to hyperlinks</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-ifpdf-2"><code>ifpdf</code></a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ifrewritetocfile"><code>ifrewritetocfile</code></a>:</td><td> </td><td valign="top"><a href="#Reading-the-_002etoc-file">Reading the .toc file</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ifundefined"><code>ifundefined</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cifundefined">\ifundefined</a></td></tr> <tr><td></td><td valign="top"><a href="#index-includegraphics"><code>includegraphics</code></a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td></tr> @@ -9671,12 +9495,12 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-itemnumber"><code>itemnumber</code></a>:</td><td> </td><td valign="top"><a href="#Formatting-lists">Formatting lists</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ituline"><code>ituline</code></a>:</td><td> </td><td valign="top"><a href="#Page-list-and-page-range-parsers">Page list and page range parsers</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-J">J</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-J">J</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-jobname"><code>jobname</code></a>:</td><td> </td><td valign="top"><a href="#Citations">Citations</a></td></tr> <tr><td></td><td valign="top"><a href="#index-jobname-1"><code>jobname</code></a>:</td><td> </td><td valign="top"><a href="#Typesetting-an-index">Typesetting an index</a></td></tr> <tr><td></td><td valign="top"><a href="#index-jobname-2"><code>jobname</code></a>:</td><td> </td><td valign="top"><a href="#Auxiliary-files">Auxiliary files</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-L">L</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-L">L</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-LAMSTeX-1"><code>LAMSTeX</code></a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> <tr><td></td><td valign="top"><a href="#index-LaTeX-4"><code>LaTeX</code></a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> <tr><td></td><td valign="top"><a href="#index-lbracechar"><code>lbracechar</code></a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> @@ -9690,6 +9514,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-leftdisplaysetup"><code>leftdisplaysetup</code></a>:</td><td> </td><td valign="top"><a href="#Formatting-displays">Formatting displays</a></td></tr> <tr><td></td><td valign="top"><a href="#index-lefteqnumbers"><code>lefteqnumbers</code></a>:</td><td> </td><td valign="top"><a href="#Displays">Displays</a></td></tr> <tr><td></td><td valign="top"><a href="#index-leftmargin"><code>leftmargin</code></a>:</td><td> </td><td valign="top"><a href="#Margins">Margins</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-leftskip"><code>leftskip</code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> <tr><td></td><td valign="top"><a href="#index-leqalignno"><code>leqalignno</code></a>:</td><td> </td><td valign="top"><a href="#Displays">Displays</a></td></tr> <tr><td></td><td valign="top"><a href="#index-leqalignno-1"><code>leqalignno</code></a>:</td><td> </td><td valign="top"><a href="#Displays">Displays</a></td></tr> <tr><td></td><td valign="top"><a href="#index-leqno"><code>leqno</code></a>:</td><td> </td><td valign="top"><a href="#Displays">Displays</a></td></tr> @@ -9710,7 +9535,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-loggingall"><code>loggingall</code></a>:</td><td> </td><td valign="top"><a href="#Diagnostics">Diagnostics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-loop"><code>loop</code></a>:</td><td> </td><td valign="top"><a href="#Iteration">Iteration</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-M">M</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-M">M</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-makeactive"><code>makeactive</code></a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-makeatletter"><code>makeatletter</code></a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-makeatother"><code>makeatother</code></a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> @@ -9732,7 +9557,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-morphdist"><code>morphdist</code></a>:</td><td> </td><td valign="top"><a href="#Arrows-and-morphisms">Arrows and morphisms</a></td></tr> <tr><td></td><td valign="top"><a href="#index-morphdist-1"><code>morphdist</code></a>:</td><td> </td><td valign="top"><a href="#Commutative-diagram-parameters">Commutative diagram parameters</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-N">N</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-N">N</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-name-_0028hyperlink-type_0029"><code>name <span class="roman">(hyperlink type)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-name-_0028hyperlink-type_0029-1"><code>name <span class="roman">(hyperlink type)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-new_2026"><code>new…</code></a>:</td><td> </td><td valign="top"><a href="#Allocation-macros">Allocation macros</a></td></tr> @@ -9757,14 +9582,14 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-numberedmarker"><code>numberedmarker</code></a>:</td><td> </td><td valign="top"><a href="#Formatting-lists">Formatting lists</a></td></tr> <tr><td></td><td valign="top"><a href="#index-numbername"><code>numbername</code></a>:</td><td> </td><td valign="top"><a href="#Writing-out-numbers">Writing out numbers</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-O">O</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-O">O</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-obeywhitespace"><code>obeywhitespace</code></a>:</td><td> </td><td valign="top"><a href="#Obeying-spaces">Obeying spaces</a></td></tr> <tr><td></td><td valign="top"><a href="#index-orderedlist"><code>orderedlist</code></a>:</td><td> </td><td valign="top"><a href="#Lists">Lists</a></td></tr> <tr><td></td><td valign="top"><a href="#index-other"><code>other</code></a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-outer"><code>outer</code></a>:</td><td> </td><td valign="top"><a href="#Allocation-macros">Allocation macros</a></td></tr> <tr><td></td><td valign="top"><a href="#index-outsidemargin"><code>outsidemargin</code></a>:</td><td> </td><td valign="top"><a href="#Proofing-index-terms">Proofing index terms</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-P">P</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-P">P</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-page-_0028hyperlink-type_0029"><code>page <span class="roman">(hyperlink type)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pagefit-_0028hyperlink-option_0029"><code>pagefit <span class="roman">(hyperlink option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pagefit-_0028hyperlink-option_0029-1"><code>pagefit <span class="roman">(hyperlink option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> @@ -9774,8 +9599,12 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-pagetotal"><code>pagetotal</code></a>:</td><td> </td><td valign="top"><a href="#Multiple-columns">Multiple columns</a></td></tr> <tr><td></td><td valign="top"><a href="#index-paperheight"><code>paperheight</code></a>:</td><td> </td><td valign="top"><a href="#Margins">Margins</a></td></tr> <tr><td></td><td valign="top"><a href="#index-paperwidth"><code>paperwidth</code></a>:</td><td> </td><td valign="top"><a href="#Margins">Margins</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-parfillskip_002c-reset-by-_005cragged_002e_002e_002e"><code>parfillskip<span class="roman">, reset by <code>\ragged...</code></span></code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> <tr><td></td><td valign="top"><a href="#index-parindent-in-indexes"><code>parindent <span class="roman">in indexes</span></code></a>:</td><td> </td><td valign="top"><a href="#Typesetting-an-index">Typesetting an index</a></td></tr> <tr><td></td><td valign="top"><a href="#index-path"><code>path</code></a>:</td><td> </td><td valign="top"><a href="#Paths">Paths</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-pdfescapestring-pdfTeX-primitive"><code>pdfescapestring <span class="roman">pdfTeX primitive</span></code></a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-pdfmark-_0028PDF-language-primitive_0029"><code>pdfmark <span class="roman">(PDF language primitive)</span></code></a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-pdfoutline-_0028pdftex-primitive_0029"><code>pdfoutline <span class="roman">(<code>pdftex</code> primitive)</span></code></a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdfoutput"><code>pdfoutput</code></a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdftex-_0028hyperlink-driver_0029"><code>pdftex <span class="roman">(hyperlink driver)</span></code></a>:</td><td> </td><td valign="top"><a href="#Hyperlink-drivers-pdftex-and-dvipdfm">Hyperlink drivers pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-percentchar"><code>percentchar</code></a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> @@ -9791,10 +9620,13 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-printlistinglineno-1"><code>printlistinglineno</code></a>:</td><td> </td><td valign="top"><a href="#Verbatim-listing">Verbatim listing</a></td></tr> <tr><td></td><td valign="top"><a href="#index-providecommand"><code>providecommand</code></a>:</td><td> </td><td valign="top"><a href="#Commands-from-LaTeX">Commands from LaTeX</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-Q">Q</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-Q">Q</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-quadcolumns"><code>quadcolumns</code></a>:</td><td> </td><td valign="top"><a href="#Multiple-columns">Multiple columns</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-R">R</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-R">R</th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-raggedleft"><code>raggedleft</code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-raggedleftskip"><code>raggedleftskip</code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-raggedright"><code>raggedright</code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> <tr><td></td><td valign="top"><a href="#index-raggedright-for-index-entries"><code>raggedright <span class="roman">for index entries</span></code></a>:</td><td> </td><td valign="top"><a href="#Typesetting-an-index">Typesetting an index</a></td></tr> <tr><td></td><td valign="top"><a href="#index-raise-_0028hyperlink-option_0029"><code>raise <span class="roman">(hyperlink option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Options-supported-by-all-drivers">Options supported by all drivers</a></td></tr> <tr><td></td><td valign="top"><a href="#index-raise-_0028hyperlink-option_0029-1"><code>raise <span class="roman">(hyperlink option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Setting-group-options">Setting group options</a></td></tr> @@ -9830,7 +9662,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-rotatebox"><code>rotatebox</code></a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td></tr> <tr><td></td><td valign="top"><a href="#index-rt"><code>rt</code></a>:</td><td> </td><td valign="top"><a href="#Arrows-and-morphisms">Arrows and morphisms</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-S">S</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-S">S</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-sanitize"><code>sanitize</code></a>:</td><td> </td><td valign="top"><a href="#Converting-to-characters">Converting to characters</a></td></tr> <tr><td></td><td valign="top"><a href="#index-sarrowlength"><code>sarrowlength</code></a>:</td><td> </td><td valign="top"><a href="#Arrows-and-morphisms">Arrows and morphisms</a></td></tr> <tr><td></td><td valign="top"><a href="#index-sarrowlength-1"><code>sarrowlength</code></a>:</td><td> </td><td valign="top"><a href="#Commutative-diagram-parameters">Commutative diagram parameters</a></td></tr> @@ -9852,13 +9684,15 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-sline"><code>sline</code></a>:</td><td> </td><td valign="top"><a href="#Arrows-and-morphisms">Arrows and morphisms</a></td></tr> <tr><td></td><td valign="top"><a href="#index-sline-1"><code>sline</code></a>:</td><td> </td><td valign="top"><a href="#Arrows-and-morphisms">Arrows and morphisms</a></td></tr> <tr><td></td><td valign="top"><a href="#index-SLiTeX-1"><code>SLiTeX</code></a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-spaceskip_002c-reset-by-_005cragged_002e_002e_002e"><code>spaceskip<span class="roman">, reset by <code>\ragged...</code></span></code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> <tr><td></td><td valign="top"><a href="#index-special"><code>special</code></a>:</td><td> </td><td valign="top"><a href="#Introduction-to-hyperlinks">Introduction to hyperlinks</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-special-ps_003a-for-dvips"><code>special ps: <span class="roman">for <code>dvips</code></span></code></a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> <tr><td></td><td valign="top"><a href="#index-specialpathdelimiters-_0028conditional_0029"><code>specialpathdelimiters <span class="roman">(conditional)</span></code></a>:</td><td> </td><td valign="top"><a href="#Paths">Paths</a></td></tr> <tr><td></td><td valign="top"><a href="#index-subeqnumber"><code>subeqnumber</code></a>:</td><td> </td><td valign="top"><a href="#Subequation-references">Subequation references</a></td></tr> <tr><td></td><td valign="top"><a href="#index-subitem-in-indexes"><code>subitem <span class="roman">in indexes</span></code></a>:</td><td> </td><td valign="top"><a href="#Typesetting-an-index">Typesetting an index</a></td></tr> <tr><td></td><td valign="top"><a href="#index-subsubitem-in-indexes"><code>subsubitem <span class="roman">in indexes</span></code></a>:</td><td> </td><td valign="top"><a href="#Typesetting-an-index">Typesetting an index</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-T">T</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-T">T</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-testfileexistence"><code>testfileexistence</code></a>:</td><td> </td><td valign="top"><a href="#Auxiliary-files">Auxiliary files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TeX"><code>TeX</code></a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> <tr><td></td><td valign="top"><a href="#index-textbf"><code>textbf</code></a>:</td><td> </td><td valign="top"><a href="#Commands-from-LaTeX">Commands from LaTeX</a></td></tr> @@ -9881,7 +9715,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-tt"><code>tt</code></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ttfamily"><code>ttfamily</code></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-U">U</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-U">U</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-uncatcodespecials"><code>uncatcodespecials</code></a>:</td><td> </td><td valign="top"><a href="#Verbatim-listing">Verbatim listing</a></td></tr> <tr><td></td><td valign="top"><a href="#index-uncatcodespecials-1"><code>uncatcodespecials</code></a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-unorderedlist"><code>unorderedlist</code></a>:</td><td> </td><td valign="top"><a href="#Lists">Lists</a></td></tr> @@ -9893,7 +9727,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-url-_0028hyperlinks_0029"><code>url <span class="roman">(hyperlinks)</span></code></a>:</td><td> </td><td valign="top"><a href="#URL-hyperlinks">URL hyperlinks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-usepackage"><code>usepackage</code></a>:</td><td> </td><td valign="top"><a href="#The-_005cusepackage-command">The \usepackage command</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-V">V</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-V">V</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-varrowlength"><code>varrowlength</code></a>:</td><td> </td><td valign="top"><a href="#Arrows-and-morphisms">Arrows and morphisms</a></td></tr> <tr><td></td><td valign="top"><a href="#index-varrowlength-1"><code>varrowlength</code></a>:</td><td> </td><td valign="top"><a href="#Commutative-diagram-parameters">Commutative diagram parameters</a></td></tr> <tr><td></td><td valign="top"><a href="#index-vchannel"><code>vchannel</code></a>:</td><td> </td><td valign="top"><a href="#Commutative-diagram-parameters">Commutative diagram parameters</a></td></tr> @@ -9915,7 +9749,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-vpenalty"><code>vpenalty</code></a>:</td><td> </td><td valign="top"><a href="#Mode_002dspecific-penalties">Mode-specific penalties</a></td></tr> <tr><td></td><td valign="top"><a href="#index-vruledefaultwidth"><code>vruledefaultwidth</code></a>:</td><td> </td><td valign="top"><a href="#Rules">Rules</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-W">W</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-W">W</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-width-_0028destination-option_0029"><code>width <span class="roman">(destination option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Destination-types-for-pdftex-and-dvipdfm">Destination types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-width-_0028destination-option_0029-1"><code>width <span class="roman">(destination option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Destination-options-for-pdftex-and-dvipdfm">Destination options for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-width-_0028hyperlink-option_0029"><code>width <span class="roman">(hyperlink option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> @@ -9923,7 +9757,7 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-writenumberedtocline"><code>writenumberedtocline</code></a>:</td><td> </td><td valign="top"><a href="#Writing-the-_002etoc-file">Writing the .toc file</a></td></tr> <tr><td></td><td valign="top"><a href="#index-writetocentry"><code>writetocentry</code></a>:</td><td> </td><td valign="top"><a href="#Writing-the-_002etoc-file">Writing the .toc file</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-X">X</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-X">X</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-XeLaTeX-1"><code>XeLaTeX</code></a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> <tr><td></td><td valign="top"><a href="#index-XeTeX-1"><code>XeTeX</code></a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> <tr><td></td><td valign="top"><a href="#index-xrdef"><code>xrdef</code></a>:</td><td> </td><td valign="top"><a href="#Page-references">Page references</a></td></tr> @@ -9937,18 +9771,17 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ <tr><td></td><td valign="top"><a href="#index-xrefwarning-conditional"><code>xrefwarning <span class="roman">conditional</span></code></a>:</td><td> </td><td valign="top"><a href="#Using-generic-references">Using generic references</a></td></tr> <tr><td></td><td valign="top"><a href="#index-xrefwarningfalse"><code>xrefwarningfalse</code></a>:</td><td> </td><td valign="top"><a href="#Citations">Citations</a></td></tr> <tr><td></td><td valign="top"><a href="#index-xrlabel"><code>xrlabel</code></a>:</td><td> </td><td valign="top"><a href="#Converting-to-characters">Converting to characters</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-xspaceskip_002c-reset-by-_005cragged_002e_002e_002e"><code>xspaceskip<span class="roman">, reset by <code>\ragged...</code></span></code></a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> <tr><td></td><td valign="top"><a href="#index-xyz-_0028destination-type_0029"><code>xyz <span class="roman">(destination type)</span></code></a>:</td><td> </td><td valign="top"><a href="#Destination-types-for-hypertex">Destination types for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-xyz-_0028destination-type_0029-1"><code>xyz <span class="roman">(destination type)</span></code></a>:</td><td> </td><td valign="top"><a href="#Destination-types-for-pdftex-and-dvipdfm">Destination types for pdftex and dvipdfm</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Macro-index_fn_letter-Z">Z</a></th><td></td><td></td></tr> +<tr><th id="Macro-index_fn_letter-Z">Z</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-zoom-_0028destination-option_0029"><code>zoom <span class="roman">(destination option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Destination-types-for-pdftex-and-dvipdfm">Destination types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-zoom-_0028destination-option_0029-1"><code>zoom <span class="roman">(destination option)</span></code></a>:</td><td> </td><td valign="top"><a href="#Destination-options-for-pdftex-and-dvipdfm">Destination options for pdftex and dvipdfm</a></td></tr> <tr><td colspan="4"> <hr></td></tr> </table> <table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Macro-index_fn_symbol-1"><b>@</b></a> -<a class="summary-letter" href="#Macro-index_fn_symbol-2"><b>\</b></a> - <br> <a class="summary-letter" href="#Macro-index_fn_letter-A"><b>A</b></a> @@ -10001,13 +9834,11 @@ Next: <a href="#Concept-index" accesskey="n" rel="next">Concept index</a>, Previ </td></tr></table> <hr> -<a name="Concept-index"></a> -<div class="header"> +<span id="Concept-index"></span><div class="header"> <p> Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Macro-index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Concept-index-1"></a> -<h2 class="unnumbered">Concept index</h2> +<span id="Concept-index-1"></span><h2 class="unnumbered">Concept index</h2> <table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Concept-index_cp_symbol-1"><b>*</b></a> @@ -10068,10 +9899,10 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <table class="index-cp" border="0"> <tr><td></td><th align="left">Index Entry</th><td> </td><th align="left"> Section</th></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_symbol-1">*</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_symbol-1">*</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-_002a_002dform-of-LaTeX-commands">*-form of LaTeX commands</a>:</td><td> </td><td valign="top"><a href="#Commands-from-LaTeX">Commands from LaTeX</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_symbol-2">.</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_symbol-2">.</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-_002eaux-file"><code>.aux <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Citations">Citations</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002eaux-file-1"><code>.aux <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Cross_002dreferences">Cross-references</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002ebbl-file"><code>.bbl <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Citations">Citations</a></td></tr> @@ -10093,7 +9924,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-_002esty-files"><code>.sty <span class="roman">files</span></code></a>:</td><td> </td><td valign="top"><a href="#Loading-LaTeX-packages">Loading LaTeX packages</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002etoc-file"><code>.toc <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Contents">Contents</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-A">A</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-A">A</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-active-characters">active characters</a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-after-index-terms">after index terms</a>:</td><td> </td><td valign="top"><a href="#Customizing-indexing">Customizing indexing</a></td></tr> <tr><td></td><td valign="top"><a href="#index-alignments">alignments</a>:</td><td> </td><td valign="top"><a href="#Tables">Tables</a></td></tr> @@ -10108,11 +9939,11 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-arrows">arrows</a>:</td><td> </td><td valign="top"><a href="#Arrows-and-morphisms">Arrows and morphisms</a></td></tr> <tr><td></td><td valign="top"><a href="#index-atom">atom</a>:</td><td> </td><td valign="top"><a href="#Properties">Properties</a></td></tr> <tr><td></td><td valign="top"><a href="#index-autopict_002esty"><code>autopict.sty</code></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-auxiliary-files_002c-existence-of">auxiliary files, existence of</a>:</td><td> </td><td valign="top"><a href="#Auxiliary-files">Auxiliary files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-avoiding-boxed-links">avoiding boxed links</a>:</td><td> </td><td valign="top"><a href="#URL-hyperlinks">URL hyperlinks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-avoiding-boxed-links-1">avoiding boxed links</a>:</td><td> </td><td valign="top"><a href="#Setting-default-types-and-options">Setting default types and options</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-axuiliary-files_002c-existence-of">axuiliary files, existence of</a>:</td><td> </td><td valign="top"><a href="#Auxiliary-files">Auxiliary files</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-B">B</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-B">B</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-backslash-character">backslash character</a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-balancing-of-columns-with-_005csinglecolumn">balancing of columns with <code>\singlecolumn</code></a>:</td><td> </td><td valign="top"><a href="#Multiple-columns">Multiple columns</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Berry_002c-Karl">Berry, Karl</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> @@ -10126,6 +9957,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-BibTeX">BibTeX</a>:</td><td> </td><td valign="top"><a href="#Citations">Citations</a></td></tr> <tr><td></td><td valign="top"><a href="#index-BibTeX-1">BibTeX</a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> <tr><td></td><td valign="top"><a href="#index-black-boxes">black boxes</a>:</td><td> </td><td valign="top"><a href="#Boxes">Boxes</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-bookmarks_002c-making-PDF">bookmarks, making PDF</a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Borceux_002c-Francis">Borceux, Francis</a>:</td><td> </td><td valign="top"><a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a></td></tr> <tr><td></td><td valign="top"><a href="#index-border-color_002c-hyperlink">border color, hyperlink</a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-border-style_002c-hyperlink">border style, hyperlink</a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> @@ -10140,7 +9972,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-Brockett_002c-Roger-W_002e">Brockett, Roger W.</a>:</td><td> </td><td valign="top"><a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Butterfly-Lemma">Butterfly Lemma</a>:</td><td> </td><td valign="top"><a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-C">C</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-C">C</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-Carlisle_002c-David">Carlisle, David</a>:</td><td> </td><td valign="top"><a href="#Loading-LaTeX-packages">Loading LaTeX packages</a></td></tr> <tr><td></td><td valign="top"><a href="#index-catcode-of-_0040">catcode of ‘<samp>@</samp>’</a>:</td><td> </td><td valign="top"><a href="#Environment-for-loading-packages">Environment for loading packages</a></td></tr> <tr><td></td><td valign="top"><a href="#index-category-codes">category codes</a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> @@ -10190,7 +10022,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-cube">cube</a>:</td><td> </td><td valign="top"><a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a></td></tr> <tr><td></td><td valign="top"><a href="#index-customizing-indexing">customizing indexing</a>:</td><td> </td><td valign="top"><a href="#Customizing-indexing">Customizing indexing</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-D">D</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-D">D</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-dashed-hyperlink-border">dashed hyperlink border</a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-dashed-hyperlink-border-1">dashed hyperlink border</a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-date">date</a>:</td><td> </td><td valign="top"><a href="#Time-of-day">Time of day</a></td></tr> @@ -10297,8 +10129,9 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-dvipdfm_002c-link-types"><code>dvipdfm</code>, link types</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-dvips"><code>dvips</code></a>:</td><td> </td><td valign="top"><a href="#Hyperlink-driver-hypertex">Hyperlink driver hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-dvips-1"><code>dvips</code></a>:</td><td> </td><td valign="top"><a href="#Hyperlink-driver-hypertex">Hyperlink driver hypertex</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-dvips_002c-making-PDF-outlines-for"><code>dvips</code>, making PDF outlines for</a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-E">E</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-E">E</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-Eijkhout_002c-Victor">Eijkhout, Victor</a>:</td><td> </td><td valign="top"><a href="#Iteration">Iteration</a></td></tr> <tr><td></td><td valign="top"><a href="#index-eject-in-multicolumns">eject in multicolumns</a>:</td><td> </td><td valign="top"><a href="#Multiple-columns">Multiple columns</a></td></tr> <tr><td></td><td valign="top"><a href="#index-electronic-mail-addresses_002c-breaking">electronic mail addresses, breaking</a>:</td><td> </td><td valign="top"><a href="#Paths">Paths</a></td></tr> @@ -10338,7 +10171,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-explicit-hyperlinks_002c-demo">explicit hyperlinks, demo</a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ExTeX">ExTeX</a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-F">F</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-F">F</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-file_002c-hyperlink-to">file, hyperlink to</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-file_002c-hyperlink-to-1">file, hyperlink to</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-file_002c-hyperlink-to-2">file, hyperlink to</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> @@ -10356,7 +10189,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-formatting-index-entries">formatting index entries</a>:</td><td> </td><td valign="top"><a href="#Typesetting-an-index">Typesetting an index</a></td></tr> <tr><td></td><td valign="top"><a href="#index-fractions">fractions</a>:</td><td> </td><td valign="top"><a href="#Fractions">Fractions</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-G">G</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-G">G</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-Ghostscript"><code><span class="roman">Ghostscript</span></code></a>:</td><td> </td><td valign="top"><a href="#Hyperlink-driver-hypertex">Hyperlink driver hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Ghostscript-1"><code><span class="roman">Ghostscript</span></code></a>:</td><td> </td><td valign="top"><a href="#Hyperlink-driver-hypertex">Hyperlink driver hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-gobbling-arguments">gobbling arguments</a>:</td><td> </td><td valign="top"><a href="#Macro-arguments">Macro arguments</a></td></tr> @@ -10404,7 +10237,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-group_002c-preserving-option-list">group, preserving option list</a>:</td><td> </td><td valign="top"><a href="#Setting-group-options">Setting group options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-groups_002c-specifying-all">groups, specifying all</a>:</td><td> </td><td valign="top"><a href="#Setting-group-types">Setting group types</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-H">H</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-H">H</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-hanging-on-_005cinput">hanging on <code>\input</code></a>:</td><td> </td><td valign="top"><a href="#Environment-for-loading-packages">Environment for loading packages</a></td></tr> <tr><td></td><td valign="top"><a href="#index-help-messages">help messages</a>:</td><td> </td><td valign="top"><a href="#Diagnostics">Diagnostics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-highlight-modes_002c-hyperlink">highlight modes, hyperlink</a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> @@ -10494,9 +10327,10 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-hypertex_002c-link-types"><code>hypertex</code>, link types</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hypertext-links">hypertext links</a>:</td><td> </td><td valign="top"><a href="#Hyperlinks">Hyperlinks</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-I">I</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-I">I</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-identifying-numbers">identifying numbers</a>:</td><td> </td><td valign="top"><a href="#g_t_005cifinteger-and-_005cisinteger">\ifinteger and \isinteger</a></td></tr> <tr><td></td><td valign="top"><a href="#index-idxuniq"><code>idxuniq</code></a>:</td><td> </td><td valign="top"><a href="#Exact-destinations-for-index-terms">Exact destinations for index terms</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-ifpdf_002esty"><code>ifpdf.sty</code></a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ignoring-arguments">ignoring arguments</a>:</td><td> </td><td valign="top"><a href="#Macro-arguments">Macro arguments</a></td></tr> <tr><td></td><td valign="top"><a href="#index-implicit-hyperlinks">implicit hyperlinks</a>:</td><td> </td><td valign="top"><a href="#Implicit-hyperlinks">Implicit hyperlinks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-implicit-hyperlinks_002c-demo">implicit hyperlinks, demo</a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td></tr> @@ -10540,14 +10374,14 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-item-labels_002c-changing">item labels, changing</a>:</td><td> </td><td valign="top"><a href="#Formatting-lists">Formatting lists</a></td></tr> <tr><td></td><td valign="top"><a href="#index-iteration">iteration</a>:</td><td> </td><td valign="top"><a href="#Iteration">Iteration</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-J">J</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-J">J</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-justification">justification</a>:</td><td> </td><td valign="top"><a href="#Justification">Justification</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-K">K</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-K">K</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-Knuth_002c-Donald-Ervin">Knuth, Donald Ervin</a>:</td><td> </td><td valign="top"><a href="#Citations">Citations</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Knuth_002c-Donald-Ervin-1">Knuth, Donald Ervin</a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-L">L</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-L">L</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-labels-on-items_002c-changing">labels on items, changing</a>:</td><td> </td><td valign="top"><a href="#Formatting-lists">Formatting lists</a></td></tr> <tr><td></td><td valign="top"><a href="#index-labels_002c-characters-valid-in">labels, characters valid in</a>:</td><td> </td><td valign="top"><a href="#Cross_002dreferences">Cross-references</a></td></tr> <tr><td></td><td valign="top"><a href="#index-labels_002c-empty-equation">labels, empty equation</a>:</td><td> </td><td valign="top"><a href="#Equation-references">Equation references</a></td></tr> @@ -10623,7 +10457,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-loops">loops</a>:</td><td> </td><td valign="top"><a href="#Iteration">Iteration</a></td></tr> <tr><td></td><td valign="top"><a href="#index-lscommnt_002etex"><code>lscommnt.tex</code></a>:</td><td> </td><td valign="top"><a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029">Highlighting TeX comments in listings (lscommnt.tex)</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-M">M</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-M">M</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-magnification_002c-hyperlink-destination">magnification, hyperlink destination</a>:</td><td> </td><td valign="top"><a href="#Destination-options-for-pdftex-and-dvipdfm">Destination options for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-makeindex"><code>makeindex</code></a>:</td><td> </td><td valign="top"><a href="#Invoking-Eplain">Invoking Eplain</a></td></tr> <tr><td></td><td valign="top"><a href="#index-makeindex-1"><code>makeindex</code></a>:</td><td> </td><td valign="top"><a href="#Indexing">Indexing</a></td></tr> @@ -10642,7 +10476,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-multiple-column-output">multiple column output</a>:</td><td> </td><td valign="top"><a href="#Multiple-columns">Multiple columns</a></td></tr> <tr><td></td><td valign="top"><a href="#index-multiple-indexes">multiple indexes</a>:</td><td> </td><td valign="top"><a href="#Indexing">Indexing</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-N">N</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-N">N</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-named-destination">named destination</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-named-destination-1">named destination</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-names_002c-of-TeX-variants">names, of TeX variants</a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> @@ -10656,7 +10490,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-numbers_002c-detecting">numbers, detecting</a>:</td><td> </td><td valign="top"><a href="#g_t_005cifinteger-and-_005cisinteger">\ifinteger and \isinteger</a></td></tr> <tr><td></td><td valign="top"><a href="#index-numbers_002c-written-form-of">numbers, written form of</a>:</td><td> </td><td valign="top"><a href="#Writing-out-numbers">Writing out numbers</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-O">O</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-O">O</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-Oberdiek_002c-Heiko">Oberdiek, Heiko</a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> <tr><td></td><td valign="top"><a href="#index-omitting-hyperlinks">omitting hyperlinks</a>:</td><td> </td><td valign="top"><a href="#Hyperlink-driver-nolinks">Hyperlink driver nolinks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-omitting-hyperlinks-1">omitting hyperlinks</a>:</td><td> </td><td valign="top"><a href="#Turning-hyperlinks-on_002foff">Turning hyperlinks on/off</a></td></tr> @@ -10674,10 +10508,11 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-options_002c-link_002c-hypertex">options, link, <code>hypertex</code></a>:</td><td> </td><td valign="top"><a href="#Link-options-for-hypertex">Link options for hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-options_002c-link_002c-pdftex">options, link, <code>pdftex</code></a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ordered-list">ordered list</a>:</td><td> </td><td valign="top"><a href="#Lists">Lists</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-outlines_002c-making-PDF">outlines, making PDF</a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> <tr><td></td><td valign="top"><a href="#index-output-routine-and-index-proofing">output routine and index proofing</a>:</td><td> </td><td valign="top"><a href="#Proofing-index-terms">Proofing index terms</a></td></tr> <tr><td></td><td valign="top"><a href="#index-overstriking">overstriking</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-P">P</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-P">P</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-packages_002c-LaTeX">packages, LaTeX</a>:</td><td> </td><td valign="top"><a href="#Loading-LaTeX-packages">Loading LaTeX packages</a></td></tr> <tr><td></td><td valign="top"><a href="#index-packages_002c-LaTeX-1">packages, LaTeX</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-packages_002c-LaTeX-2">packages, LaTeX</a>:</td><td> </td><td valign="top"><a href="#Packages-known-not-to-work">Packages known not to work</a></td></tr> @@ -10691,6 +10526,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-pathnames_002c-breaking">pathnames, breaking</a>:</td><td> </td><td valign="top"><a href="#Paths">Paths</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pathnames_002c-breaking-1">pathnames, breaking</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-PDF"><acronym>PDF</acronym></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-PDF-outlines-_0028a_002ek_002ea_002e-bookmarks_0029">PDF outlines (a.k.a. bookmarks)</a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> <tr><td></td><td valign="top"><a href="#index-PDF-output"><acronym>PDF</acronym> output</a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdftex"><code>pdftex</code></a>:</td><td> </td><td valign="top"><a href="#Invoking-Eplain">Invoking Eplain</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdftex-1"><code>pdftex</code></a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> @@ -10700,6 +10536,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-pdftex_002c-hyperlink-driver"><code>pdftex</code>, hyperlink driver</a>:</td><td> </td><td valign="top"><a href="#Hyperlink-drivers-pdftex-and-dvipdfm">Hyperlink drivers pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdftex_002c-link-options"><code>pdftex</code>, link options</a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdftex_002c-link-types"><code>pdftex</code>, link types</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-pdftex_002c-making-PDF-outlines-for"><code>pdftex</code>, making PDF outlines for</a>:</td><td> </td><td valign="top"><a href="#Making-PDF-outlines">Making PDF outlines</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdfTeX_002c-problems-using-color-and-graphics">pdfTeX, problems using color and graphics</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pdfTeX_002c-problems-with-supp_002dmis_002etex">pdfTeX, problems with <samp>supp-mis.tex</samp></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pict2e_002esty"><code>pict2e.sty</code></a>:</td><td> </td><td valign="top"><a href="#Packages-known-not-to-work">Packages known not to work</a></td></tr> @@ -10715,10 +10552,10 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-ps2pdf-1"><code>ps2pdf</code></a>:</td><td> </td><td valign="top"><a href="#Hyperlink-driver-hypertex">Hyperlink driver hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-psfrag_002esty"><code>psfrag.sty</code></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-Q">Q</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-Q">Q</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-quadruple-column-output">quadruple column output</a>:</td><td> </td><td valign="top"><a href="#Multiple-columns">Multiple columns</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-R">R</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-R">R</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-Rahtz_002c-Sebastian">Rahtz, Sebastian</a>:</td><td> </td><td valign="top"><a href="#Loading-LaTeX-packages">Loading LaTeX packages</a></td></tr> <tr><td></td><td valign="top"><a href="#index-raising-hyperlink-destinations">raising hyperlink destinations</a>:</td><td> </td><td valign="top"><a href="#Options-supported-by-all-drivers">Options supported by all drivers</a></td></tr> <tr><td></td><td valign="top"><a href="#index-raising-hyperlink-destinations-1">raising hyperlink destinations</a>:</td><td> </td><td valign="top"><a href="#Setting-group-options">Setting group options</a></td></tr> @@ -10739,7 +10576,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-rule-thickness">rule thickness</a>:</td><td> </td><td valign="top"><a href="#Rules">Rules</a></td></tr> <tr><td></td><td valign="top"><a href="#index-run_003a-links">‘<samp>run:</samp>’ links</a>:</td><td> </td><td valign="top"><a href="#General-hyperlinks">General hyperlinks</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-S">S</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-S">S</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-scaling">scaling</a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-scaling_002c-demo">scaling, demo</a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td></tr> <tr><td></td><td valign="top"><a href="#index-sed"><code>sed</code></a>:</td><td> </td><td valign="top"><a href="#Customizing-indexing">Customizing indexing</a></td></tr> @@ -10774,7 +10611,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-supp_002dmis_002etex_002c-problems-with-pdfTeX"><code>supp-mis.tex<span class="roman">, problems with pdfTeX</span></code></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-supp_002dpdf_002etex"><code>supp-pdf.tex</code></a>:</td><td> </td><td valign="top"><a href="#Packages-known-to-work">Packages known to work</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-T">T</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-T">T</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-table-of-contents">table of contents</a>:</td><td> </td><td valign="top"><a href="#Contents">Contents</a></td></tr> <tr><td></td><td valign="top"><a href="#index-table-of-contents_002c-and-verbatim-text">table of contents, and verbatim text</a>:</td><td> </td><td valign="top"><a href="#Writing-the-_002etoc-file">Writing the .toc file</a></td></tr> <tr><td></td><td valign="top"><a href="#index-table-of-contents_002c-hyperlinks">table of contents, hyperlinks</a>:</td><td> </td><td valign="top"><a href="#Contents-hyperlinks">Contents hyperlinks</a></td></tr> @@ -10783,13 +10620,14 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-tables">tables</a>:</td><td> </td><td valign="top"><a href="#Tables">Tables</a></td></tr> <tr><td></td><td valign="top"><a href="#index-tabs">tabs</a>:</td><td> </td><td valign="top"><a href="#Obeying-spaces">Obeying spaces</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TeX-by-Topic"><i>TeX by Topic</i></a>:</td><td> </td><td valign="top"><a href="#Iteration">Iteration</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-TeX-Frequently-Asked-Question">TeX Frequently Asked Question</a>:</td><td> </td><td valign="top"><a href="#g_t_005cifinteger-and-_005cisinteger">\ifinteger and \isinteger</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-TeX-Frequently-Asked-Questions">TeX Frequently Asked Questions</a>:</td><td> </td><td valign="top"><a href="#g_t_005cifinteger-and-_005cisinteger">\ifinteger and \isinteger</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TEXFORMATS"><code>TEXFORMATS</code></a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-texi2dvi"><code>texi2dvi</code></a>:</td><td> </td><td valign="top"><a href="#Invoking-Eplain">Invoking Eplain</a></td></tr> <tr><td></td><td valign="top"><a href="#index-texi2dvi-1"><code>texi2dvi</code></a>:</td><td> </td><td valign="top"><a href="#Citations">Citations</a></td></tr> <tr><td></td><td valign="top"><a href="#index-texi2dvi-2"><code>texi2dvi</code></a>:</td><td> </td><td valign="top"><a href="#Indexing">Indexing</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Texinfo">Texinfo</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TEXINPUTS"><code>TEXINPUTS</code></a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-texnames_002esty"><code>texnames.sty</code></a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> <tr><td></td><td valign="top"><a href="#index-time-of-day">time of day</a>:</td><td> </td><td valign="top"><a href="#Time-of-day">Time of day</a></td></tr> <tr><td></td><td valign="top"><a href="#index-toc-files_002c-writing-several"><code>toc</code> files, writing several</a>:</td><td> </td><td valign="top"><a href="#Changing-the-_002etoc-file_0027s-root-name">Changing the .toc file's root name</a></td></tr> <tr><td></td><td valign="top"><a href="#index-tracing">tracing</a>:</td><td> </td><td valign="top"><a href="#Diagnostics">Diagnostics</a></td></tr> @@ -10807,7 +10645,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-types_002c-link_002c-pdftex">types, link, <code>pdftex</code></a>:</td><td> </td><td valign="top"><a href="#Link-types-for-pdftex-and-dvipdfm">Link types for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-typesetting-an-index">typesetting an index</a>:</td><td> </td><td valign="top"><a href="#Typesetting-an-index">Typesetting an index</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-U">U</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-U">U</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-undefined-control-sequence_002c-checking-for">undefined control sequence, checking for</a>:</td><td> </td><td valign="top"><a href="#g_t_005cifundefined">\ifundefined</a></td></tr> <tr><td></td><td valign="top"><a href="#index-undefined-labels_002c-warnings-about">undefined labels, warnings about</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-underline-hyperlink-border">underline hyperlink border</a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> @@ -10816,11 +10654,8 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-universal-mapping-property">universal mapping property</a>:</td><td> </td><td valign="top"><a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a></td></tr> <tr><td></td><td valign="top"><a href="#index-unordered-lists">unordered lists</a>:</td><td> </td><td valign="top"><a href="#Lists">Lists</a></td></tr> <tr><td></td><td valign="top"><a href="#index-upgrading">upgrading</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-URL-for-ifpdf_002esty"><acronym>URL</acronym> for <samp>ifpdf.sty</samp></a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-URL-for-MakeIndex"><acronym>URL</acronym> for MakeIndex</a>:</td><td> </td><td valign="top"><a href="#Indexing">Indexing</a></td></tr> <tr><td></td><td valign="top"><a href="#index-URL-for-path_002esty"><acronym>URL</acronym> for <samp>path.sty</samp></a>:</td><td> </td><td valign="top"><a href="#Paths">Paths</a></td></tr> <tr><td></td><td valign="top"><a href="#index-URL-for-pdfTeX"><acronym>URL</acronym> for pdfTeX</a>:</td><td> </td><td valign="top"><a href="#Checking-for-PDF-output">Checking for PDF output</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-URL-for-texnames_002esty"><acronym>URL</acronym> for <samp>texnames.sty</samp></a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> <tr><td></td><td valign="top"><a href="#index-URL-hyperlink"><acronym>URL</acronym> hyperlink</a>:</td><td> </td><td valign="top"><a href="#General-hyperlinks">General hyperlinks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-URL-hyperlink-1"><acronym>URL</acronym> hyperlink</a>:</td><td> </td><td valign="top"><a href="#URL-hyperlinks">URL hyperlinks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-URL-hyperlink-2"><acronym>URL</acronym> hyperlink</a>:</td><td> </td><td valign="top"><a href="#Link-types-for-hypertex">Link types for hypertex</a></td></tr> @@ -10830,7 +10665,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-url_002esty-2"><code>url.sty</code></a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td></tr> <tr><td></td><td valign="top"><a href="#index-user_002dinaccessible-macros">user-inaccessible macros</a>:</td><td> </td><td valign="top"><a href="#Category-codes">Category codes</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-V">V</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-V">V</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-vectors">vectors</a>:</td><td> </td><td valign="top"><a href="#Slanted-lines-and-vectors">Slanted lines and vectors</a></td></tr> <tr><td></td><td valign="top"><a href="#index-verbatim-listing">verbatim listing</a>:</td><td> </td><td valign="top"><a href="#Verbatim-listing">Verbatim listing</a></td></tr> <tr><td></td><td valign="top"><a href="#index-verbatim-listing_002c-demo">verbatim listing, demo</a>:</td><td> </td><td valign="top"><a href="#Highlighting-TeX-comments-in-listings-_0028lscommnt_002etex_0029">Highlighting TeX comments in listings (lscommnt.tex)</a></td></tr> @@ -10838,7 +10673,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-verbatim-text_002c-in-table-of-contents">verbatim text, in table of contents</a>:</td><td> </td><td valign="top"><a href="#Writing-the-_002etoc-file">Writing the .toc file</a></td></tr> <tr><td></td><td valign="top"><a href="#index-version-number">version number</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-W">W</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-W">W</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-Walden_002c-David">Walden, David</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Warner_002c-Frank-W_002e">Warner, Frank W.</a>:</td><td> </td><td valign="top"><a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a></td></tr> <tr><td></td><td valign="top"><a href="#index-whatsits-made-by-hyperlinks">whatsits made by hyperlinks</a>:</td><td> </td><td valign="top"><a href="#Hyperlink-driver-nolinks">Hyperlink driver nolinks</a></td></tr> @@ -10848,7 +10683,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-width_002c-hyperlink-border">width, hyperlink border</a>:</td><td> </td><td valign="top"><a href="#Link-options-for-pdftex-and-dvipdfm">Link options for pdftex and dvipdfm</a></td></tr> <tr><td></td><td valign="top"><a href="#index-writing-several-toc-files">writing several <code>toc</code> files</a>:</td><td> </td><td valign="top"><a href="#Changing-the-_002etoc-file_0027s-root-name">Changing the .toc file's root name</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-X">X</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-X">X</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-xcolor_002esty"><code>xcolor.sty</code></a>:</td><td> </td><td valign="top"><a href="#Packages-known-not-to-work">Packages known not to work</a></td></tr> <tr><td></td><td valign="top"><a href="#index-xdvi"><code>xdvi</code></a>:</td><td> </td><td valign="top"><a href="#Hyperlink-driver-hypertex">Hyperlink driver hypertex</a></td></tr> <tr><td></td><td valign="top"><a href="#index-XeLaTeX">XeLaTeX</a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> @@ -10856,7 +10691,7 @@ Previous: <a href="#Macro-index" accesskey="p" rel="prev">Macro index</a>, Up: < <tr><td></td><td valign="top"><a href="#index-XeTeX">XeTeX</a>:</td><td> </td><td valign="top"><a href="#Logos">Logos</a></td></tr> <tr><td></td><td valign="top"><a href="#index-xhyper_002etex"><code>xhyper.tex</code></a>:</td><td> </td><td valign="top"><a href="#Hyperlinks-_0028xhyper_002etex_0029">Hyperlinks (xhyper.tex)</a></td></tr> <tr><td colspan="4"> <hr></td></tr> -<tr><th><a name="Concept-index_cp_letter-Z">Z</a></th><td></td><td></td></tr> +<tr><th id="Concept-index_cp_letter-Z">Z</th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-Zassenhaus_002c-Hans">Zassenhaus, Hans</a>:</td><td> </td><td valign="top"><a href="#Construction-of-commutative-diagrams">Construction of commutative diagrams</a></td></tr> <tr><td></td><td valign="top"><a href="#index-zooming_002c-hyperlink-destination">zooming, hyperlink destination</a>:</td><td> </td><td valign="top"><a href="#Destination-options-for-pdftex-and-dvipdfm">Destination options for pdftex and dvipdfm</a></td></tr> <tr><td colspan="4"> <hr></td></tr> diff --git a/Master/texmf-dist/doc/eplain/eplain.pdf b/Master/texmf-dist/doc/eplain/eplain.pdf Binary files differindex 304abee7d53..3db8a2d4c54 100644 --- a/Master/texmf-dist/doc/eplain/eplain.pdf +++ b/Master/texmf-dist/doc/eplain/eplain.pdf diff --git a/Master/texmf-dist/doc/info/eplain.info b/Master/texmf-dist/doc/info/eplain.info index 592f22678d2..3f85c1675d0 100644 --- a/Master/texmf-dist/doc/info/eplain.info +++ b/Master/texmf-dist/doc/info/eplain.info @@ -1,7 +1,6 @@ -This is eplain.info, produced by texi2any version 6.1dev+dev from -eplain.texi. +This is eplain.info, produced by makeinfo version 6.6 from eplain.texi. -This manual documents the Eplain macros, version 3.8, May 2016. Eplain +This manual documents the Eplain macros, version 3.9, May 2019. Eplain provides functionality for plain TeX that is intended to be useful regardless of how your document is actually formatted. @@ -22,7 +21,7 @@ File: eplain.info, Node: Top, Next: Introduction, Up: (dir) Eplain ****** -This manual documents the Eplain macros, version 3.8, May 2016. Eplain +This manual documents the Eplain macros, version 3.9, May 2019. Eplain provides functionality for plain TeX that is intended to be useful regardless of how your document is actually formatted. @@ -33,7 +32,7 @@ this chapter is under the GNU General Public License. Adam Lewenberg has made additions and corrections. Oleg Katsitadze wrote the section on LaTeX packages and the chapter on hyperlinks, and updates throughout. - The Eplain home page is <http://tug.org/eplain>. + The Eplain home page is <https://tug.org/eplain>. * Menu: @@ -98,13 +97,13 @@ Contents Cross-references -* Defining generic references:: -* Using generic references:: +* Defining generic references:: +* Using generic references:: Equation references -* Formatting equation references:: -* Subequation references:: +* Formatting equation references:: +* Subequation references:: Indexing @@ -190,14 +189,14 @@ Turning hyperlinks on/off Arrow theoretic diagrams -* Slanted lines and vectors:: -* Commutative diagrams:: +* Slanted lines and vectors:: +* Commutative diagrams:: Commutative diagrams -* Arrows and morphisms:: -* Construction of commutative diagrams:: -* Commutative diagram parameters:: +* Arrows and morphisms:: +* Construction of commutative diagrams:: +* Commutative diagram parameters:: Programming definitions @@ -216,15 +215,15 @@ Programming definitions Expansion -* \csn and \ece:: -* \edefappend:: +* \csn and \ece:: +* \edefappend:: * Hooks:: Manipulating and executing named actions. * Properties:: Associating information with a csname. -* \expandonce:: -* \ifundefined:: +* \expandonce:: +* \ifundefined:: * \ifempty:: * \ifinteger and \isinteger:: -* \futurenonspacelet:: +* \futurenonspacelet:: Demo files @@ -238,7 +237,7 @@ File: eplain.info, Node: Introduction, Next: Installation, Prev: Top, Up: To ************** The "Eplain" macro package expands on and extends the definitions in -plain TeX. Its home on the web is <http://tug.org/eplain>. +plain TeX. Its home on the web is <https://tug.org/eplain>. This manual describes the definitions that you, as either an author or a macro writer, might like to use. It doesn't discuss the @@ -293,9 +292,9 @@ or visit <http://lists.tug.org/tex-eplain>. David Walden had reported his experience with Eplain as a new user. The article is available online at -<http://tug.org/pracjourn/2005-4/walden>. An introductory article +<https://tug.org/pracjourn/2005-4/walden>. An introductory article (written for TUGboat) is also available online at -<http://tug.org/eplain/misc/tb84katsi.pdf>. +<https://tug.org/eplain/misc/tb84katsi.pdf>. File: eplain.info, Node: Installation, Next: Invoking Eplain, Prev: Introduction, Up: Top @@ -412,7 +411,7 @@ where '\undefined' must never acquire a definition. The file 'eplain.tex' is all of these files merged together, with comments removed. The original sources can be found in Eplain source zip archive in your TeX distribution, on CTAN or on Eplain's home page -at <http://tug.org/eplain>. +at <https://tug.org/eplain>. All of these files except 'xeplain.tex' can be input individually, if all you want are the definitions in that file. @@ -703,12 +702,12 @@ You may wish to change Eplain's formatting of citations; i.e., the result of your '\cite' commands. By default, the citation labels are printed one after another, separated by commas and enclosed in brackets, using the main text font. Some formats require other styles, such as -superscripted labels. You can accomodate such formats by redefining the +superscripted labels. You can accommodate such formats by redefining the following macros. '\printcitestart' '\printcitefinish' - Eplain expands these macros at the begining and end of the list of + Eplain expands these macros at the beginning and end of the list of citations for each '\cite' command. By default, they produce a '[' and ']', respectively. @@ -1293,8 +1292,8 @@ Cross-reference hyperlinks::). * Menu: -* Defining generic references:: -* Using generic references:: +* Defining generic references:: +* Using generic references:: File: eplain.info, Node: Defining generic references, Next: Using generic references, Up: Cross-references @@ -1408,15 +1407,15 @@ them: want to put numbers on all equations in your document, and you don't want to think up unique labels. - To refer to the last equation with the empty label, you just use - the empty label in one of the equation reference macros (see - below). This can be handy when you want to refer to an equation - shortly after its definition, say, in the sentence following the - displayed equation, and do not intend to refer to the equation - later. But use this trick with extreme caution: if later you change - the text and insert another empty definition between the original - definition and the reference, the reference will start to refer to - the new empty-labeled equation. + To refer to the last equation with the empty label, you use the + empty label in one of the equation reference macros (see below). + This can be handy when you want to refer to an equation shortly + after its definition, say, in the sentence following the displayed + equation, and do not intend to refer to the equation later. But use + this trick with extreme caution: if later you change the text and + insert another empty definition between the original definition and + the reference, the reference will start to refer to the new + empty-labeled equation. '\eqdefn{LABEL}' This is like '\eqdef', except it always omits the '\eqnum' command. @@ -1443,8 +1442,8 @@ Equation reference hyperlinks::). * Menu: -* Formatting equation references:: -* Subequation references:: +* Formatting equation references:: +* Subequation references:: File: eplain.info, Node: Formatting equation references, Next: Subequation references, Up: Equation references @@ -1602,11 +1601,10 @@ sorting. index terms (*note Index hyperlinks::). Eplain's indexing commands were designed to work with the program -MakeIndex, available from CTAN hosts in -'tex-archive/indexing/makeindex'; MakeIndex is also commonly included in -prepackaged TeX distributions. It is beyond the scope of this manual to -explain how to run MakeIndex, and all of its many options. See -<http://www.ctan.org/tex-archive/indexing/makeindex>. +MakeIndex (<https://ctan.org/pkg/makeindex>); MakeIndex is also commonly +included in prepackaged TeX distributions. It is beyond the scope of +this manual to explain how to run MakeIndex, and all of its many +options. The basic strategy for indexing works like this: @@ -1748,8 +1746,7 @@ specifying an index entry as 'SORT@TYPESET'. For example: \sidx{Ap-weight@$A_\pi$-weight} will sort as 'Ap-weight', but print with the proper math. The '@' here -is MakeIndex's default character for this purpose. See -<http://www.ctan.org/tex-archive/indexing/makeindex>. To make an index +is MakeIndex's default character for this purpose. To make an index entry with an '@' in it, you have to escape it with a backslash; Eplain provides no macros for doing this. @@ -1824,8 +1821,8 @@ independent of these. archetypal criticism, elements of, 75, 97, 114, see also dichotomies - (Aside for the academically curious: The archetypally critical book - I took these dichotomous examples from is Laurence Berman's 'The + (Aside for the academically curious: The archetypal critical book I + took these dichotomous examples from is Laurence Berman's 'The Musical Image', which I happened to co-design and typeset.) 'pagemarkup=CS' @@ -2468,8 +2465,8 @@ than at the hyphenation points in 'letters' and 'alpha'. If you use the '\path' macro to typeset the names, TeX will find these good breakpoints. The argument to '\path' is delimited by any -character other other than '\' which does not appear in the name itself. -'|' is often a good choice, as in: +character other than '\' which does not appear in the name itself. '|' +is often a good choice, as in: \path|letters@alpha.gnu.ai.mit.edu| @@ -2487,8 +2484,7 @@ delimiter characters can still be used.) TeX then processes the '\path' argument about four times more slowly. The '\path' macro comes from 'path.sty', written by Nelson Beebe and -Philip Taylor and available at -<http://www.ctan.org/tex-archive/macros/latex/contrib/misc/path.sty>. +Philip Taylor, and available at <https://ctan.org/pkg/path>. File: eplain.info, Node: Logos, Next: Boxes, Prev: Paths, Up: User definitions @@ -2507,7 +2503,8 @@ Some spelling variants of these are also supported. Most of these macros come from 'texnames.sty', compiled by Nelson Beebe and available at -<http://www.ctan.org/tex-archive/info/biblio/texnames.sty>. +<http://mirror.ctan.org/tex-archive/info/biblio/texnames.sty> (part of +the 'biblio' package, <https://ctan.org/pkg/biblio>). File: eplain.info, Node: Boxes, Next: Checking for PDF output, Prev: Logos, Up: User definitions @@ -2559,11 +2556,11 @@ File: eplain.info, Node: Checking for PDF output, Next: Loading LaTeX packages 4.22 Checking for PDF output ============================ -pdfTeX is a TeX variant that can output both '.dvi' and '.pdf' (Adobe's -Portable Document Format) files (see -<http://www.ctan.org/tex-archive/systems/pdftex>). You might sometimes -want to know whether the target format is '.pdf' or '.dvi'. The '\ifpdf' -switch can be used to detect pdfTeX in PDF mode: +pdfTeX is an extended TeX that can output both '.dvi' and '.pdf' +(Adobe's Portable Document Format) files (see +<https://ctan.org/pkg/pdftex>). You might sometimes want to know whether +the target format is '.pdf' or '.dvi'. The '\ifpdf' switch can be used +to detect pdfTeX in PDF mode: \ifpdf This text is produced when pdfTeX is in PDF mode. @@ -2578,8 +2575,7 @@ change the value of '\pdfoutput' after you load Eplain, '\ifpdf' will not reflect the change. Eplain defines '\ifpdf' by incorporating Heiko Oberdiek's -'ifpdf.sty', which is available at -<http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/ifpdf.sty>. +'ifpdf.sty', which is available at <https://ctan.org/pkg/ifpdf>. File: eplain.info, Node: Loading LaTeX packages, Prev: Checking for PDF output, Up: User definitions @@ -2596,13 +2592,10 @@ working package which is not in the list, please report it to the Eplain mailing list (*note Introduction::). To set up a pseudo-LaTeX environment for the packages, Eplain uses -'miniltx.tex' -(<http://www.ctan.org/tex-archive/macros/plain/graphics/miniltx.tex>) -from the LaTeX graphics collection, written by David Carlisle and -Sebastian Rahtz (the collection is available at -<http://www.ctan.org/tex-archive/macros/latex/required/graphics>). -Eplain extends 'miniltx.tex' to provide some additional features, e.g., -support for package options. +'miniltx.tex' (<https://ctan.org/pkg/miniltx>) from the LaTeX graphics +collection, written by David Carlisle and Sebastian Rahtz. Eplain +extends 'miniltx.tex' to provide (primarily) support for package +options. * Menu: @@ -2683,7 +2676,7 @@ defined by 'miniltx.tex'). This is needed because 'miniltx.tex', read by Sometimes you may encounter packages which make conflicting redefinitions of '\input'. Common symptoms are TeX spewing incomprehensible error messages or hanging in a loop at a call to -'\input'. This sometimes cna be cured by restoring '\input' to +'\input'. This sometimes can be cured by restoring '\input' to '\eplaininput' before loading each package. For example: \beginpackages @@ -2704,7 +2697,7 @@ packages. Some of the short descriptions of the packages were taken from the documentation for those packages. autopict ('2001/06/04 v1.1j Picture mode autoload file') - <http://tug.org/eplain/misc/ltpictur.pdf> + <https://tug.org/eplain/misc/ltpictur.pdf> This is the LaTeX "picture mode", started by '\begin{picture}' and ended by '\end{picture}' (in LaTeX, this package is not explicitly @@ -2715,7 +2708,7 @@ autopict ('2001/06/04 v1.1j Picture mode autoload file') color ('1999/02/16 v1.0i Standard LaTeX Color (DPC)') graphics ('2001/07/07 v1.0n Standard LaTeX Graphics (DPC,SPQR)') graphicx ('1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)') - <http://www.ctan.org/pkg/graphics> + <https://ctan.org/pkg/graphics> These packages are from the LaTeX graphics collection. (The independent 'xcolor' package does not work with Eplain.) They @@ -2728,7 +2721,7 @@ graphicx ('1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)') system for TeX) installed on your system. The problem was fixed in 'supp-mis.tex' version 2004.10.26. You can obtain up-to-date versions of 'supp-mis.tex' and the accompanying 'supp-pdf.tex' from - <http://www.ctan.org/tex-archive/macros/pdftex/graphics>. To + <http://mirror.ctan.org/tex-archive/macros/pdftex/graphics>. To convince TeX to use the new files, you have the following options: 1. put the new files in the same directory with your document; @@ -2738,7 +2731,7 @@ graphicx ('1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)') 3. install the new 'supp-mis.tex' and 'supp-pdf.tex' files in the relevant subdirectory of your local 'texmf' tree (for info on - TeX directory structure see + TeX directory structure see <https://tug.org/tds/> and <http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds>); 4. upgrade your ConTeXt installation. @@ -2755,7 +2748,7 @@ graphicx ('1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)') command from the 'color.sty' package under pdfTeX, the cause may be an outdated pdfTeX color and graphics driver 'pdftex.def'. The problem was fixed in 'pdftex.def' version 0.03p. You can obtain an - up-to-date version from <http://www.ctan.org/pkg/pdftex-def>. + up-to-date version from <http://ctan.org/pkg/pdftex-def>. *End of warning 2.* The '\fcolorbox' macro provided by the 'color' package requires the @@ -2789,10 +2782,10 @@ graphicx ('1999/02/16 v1.0f Enhanced LaTeX Graphics (DPC,SPQR)') Klaus Ho"ppner has written a nice introduction to the LaTeX graphics packages and different graphics formats. You can download it from - <http://www.tug.org/pracjourn/2005-3/hoeppner> + <https://tug.org/pracjourn/2005-3/hoeppner> epstopdf ('2009/07/16 v2.2 Conversion with epstopdf on the fly (HO)') - <http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek> + <https://ctan.org/pkg/epstopdf-pkg> This package does on-the-fly conversion of Encapsulated PostScript (EPS) graphics into Portable Document Format (PDF) graphics for @@ -2801,7 +2794,7 @@ epstopdf ('2009/07/16 v2.2 Conversion with epstopdf on the fly (HO)') explicitly call the 'epstopdf' script. psfrag ('1998/04/11 v3.04 PSfrag (MCG)') - <http://www.ctan.org/tex-archive/macros/latex/contrib/psfrag/pfgguide.pdf> + <https://ctan.org/pkg/psfrag> PSfrag allows the user to precisely overlay Encapsulated PostScript (EPS) files with arbitrary (La)TeX constructions. In order to @@ -2812,7 +2805,7 @@ psfrag ('1998/04/11 v3.04 PSfrag (MCG)') rotated (La)TeX equation. soul ('2003/11/17 v2.4 letterspacing/underlining (mf)') - <http://www.ctan.org/tex-archive/macros/latex/contrib/soul> + <https://ctan.org/pkg/soul> This package provides hyphenatable letterspacing (spacing out), underlining, and some derivatives. The package is optimized for @@ -2822,7 +2815,7 @@ soul ('2003/11/17 v2.4 letterspacing/underlining (mf)') load the 'color' package. url ('2005/06/27 ver 3.2 Verb mode for urls, etc.') - <http://www.ctan.org/tex-archive/macros/latex/contrib/misc/url.sty> + <https://ctan.org/pkg/url> This package provides a form of '\verbatim' that allows line breaks at certain characters or combinations of characters, accepts @@ -2845,20 +2838,20 @@ File: eplain.info, Node: Packages known not to work, Prev: Packages known to w The following packages are known not to work with Eplain: hyperref - <http://www.ctan.org/pkg/hyperref> + <https://ctan.org/pkg/hyperref> This package depends heavily on LaTeX, so that it is essentially unusable outside of LaTeX. Eplain provides its own macros for creating hyperlinks; *note Hyperlinks::. microtype ('2013/05/23 v2.51 Micro-typographical refinements (RS)') - <http://www.ctan.org/pkg/microtype> + <https://ctan.org/pkg/microtype> pict2e ('2005/07/15 v0.2r Improved picture commands (HjG,RN)') - <http://www.ctan.org/pkg/pict2e> + <https://ctan.org/pkg/pict2e> xcolor ('2005/06/06 v2.03 LaTeX color extensions (UK)') - <http://www.ctan.org/pkg/xcolor> + <https://ctan.org/pkg/xcolor> File: eplain.info, Node: Hyperlinks, Next: Arrow theoretic diagrams, Prev: User definitions, Up: Top @@ -2879,6 +2872,7 @@ constructing explicit hyperlinks are also provided. * Hyperlink drivers:: * Setting hyperlink types and options:: * Turning hyperlinks on/off:: +* Making PDF outlines:: Also known as bookmarks. File: eplain.info, Node: Introduction to hyperlinks, Next: Explicit hyperlinks, Up: Hyperlinks @@ -2936,7 +2930,7 @@ for PDF output::). If necessary, you can explicitly specify the driver name: - \enablehyperlinks[pdftex] + \enablehyperlinks[dvipdfm] will start producing hyperlinks under the assumption that you are using pdfTeX. @@ -3129,7 +3123,7 @@ Parameters for these links can be set by customizing the 'hrefext' linkgroup. The special characters (such as '#' and '~') in the URL don't need to be escaped. For example: - \href{http://tug.org/eplain/doc/eplain.html#Hyperlinks}{Hyperlinks + \href{https://tug.org/eplain/doc/eplain.html#Hyperlinks}{Hyperlinks in Eplain} \href{mailto:tex-eplain@tug.org}{Eplain mailing list} @@ -3648,7 +3642,7 @@ Hyperlink drivers pdftex and dvipdfm::). please see <http://arxiv.org/hypertex> - <http://www.tug.org/tex-archive/support/hypertex/hypertex> + <http://mirror.ctan.org/tex-archive/support/hypertex/hypertex> For convenience, we list a few HyperTeX-enabled converters: @@ -3748,7 +3742,7 @@ File: eplain.info, Node: Link types for hypertex, Next: Link options for hyper Example: - \hlstart{url}{}{http://tug.org/eplain/}Eplain home\hlend + \hlstart{url}{}{https://tug.org/eplain/}Eplain home\hlend 'filename' Go to a named destination in another file. The label is the @@ -4040,7 +4034,8 @@ Common link types 'url' Go to a URL. The label is the URL. - Example: '\hlstart{url}{}{http://tug.org/eplain/}Eplain home\hlend' + Example: '\hlstart{url}{}{https://tug.org/eplain/}Eplain + home\hlend' 'page' Go to a page. The label is the page number (counting from 1). Page @@ -4455,7 +4450,7 @@ This setting usually accommodates the large operators, which often appear in displayed math. -File: eplain.info, Node: Turning hyperlinks on/off, Prev: Setting hyperlink types and options, Up: Hyperlinks +File: eplain.info, Node: Turning hyperlinks on/off, Next: Making PDF outlines, Prev: Setting hyperlink types and options, Up: Hyperlinks 5.6 Turning hyperlinks on/off ============================= @@ -4523,6 +4518,84 @@ assume that all links are on; after the following sequence of commands: all links are on except for the 'eq' linkgroup. +File: eplain.info, Node: Making PDF outlines, Prev: Turning hyperlinks on/off, Up: Hyperlinks + +5.7 Making PDF outlines +======================= + +PDF outlines (a.k.a. bookmarks) are more or less a table of contents +that PDF viewers can display alongside the main document. Eplain's +hyperlink features can be used to create them; there isn't any special +support for them. A continuing example interspersed with commentary +follows. + + First we must enable hyperlinks. + \input eplain + \enablehyperlinks %[dvipdfm] doesn't work + + We will separate the code to support 'pdftex' from 'dvips' with the +'\ifpdf' conditional (provided by Eplain). + + For 'pdftex', we can use the '\pdfoutline' primitive. The keyword +"count" is followed by the number of subentries in this entry. If +negative, the bookmark is closed (that is, subentries are hidden). + + \ifpdf + \pdfoutline goto name {sec1} count -1 {Mysec-pdf}% + \pdfoutline goto name {sec1.1} {Mysubsec-pdf}% + + For 'dvips', we use TeX's '\special' command to emit a 'ps:' special +using the PDF 'pdfmark' operator. The 'ps:' prefix tells 'dvips' that +the following is literal PostScript. + + '[ ... pdfmark' (there is no closing ']') is a extension to the +PostScript language for specifying various PDF-related things. It is +recognized by Ghostscript, Distiller, et al. Adobe publishes a reference +manual for it: +<https://adobe.com/content/dam/Adobe/en/devnet/acrobat/pdfs/pdfmark_reference.pdf>. + + The '/DOCVIEW' pdfmark used here says the outline panel should be +used. + + \else % not pdf output + \special{ps:[/PageMode /UseOutlines /DOCVIEW pdfmark} + % + % The individual outline entries, using a different syntax + % than pdftex, but the same information. + \special{ps:[/Count -1 /Dest (sec1) cvn /Title (Mysec-dvi) + /OUT pdfmark} + \special{ps:[/Count -0 /Dest (sec1.1) cvn /Title (Mysubsec-dvi) + /OUT pdfmark} + \fi + + The '-pdf' and '-dvi' suffixes in the strings above in the outline +entries are just to make it clear which branch is being executed, for +purposes of this example. Ordinarily the entries would be the same in +both branches. + + Also, the strings above are literal PostScript constants, again for +this example. Usually they would come from control sequences, e.g., as +the table of contents is read. + + It is necessary to "pdf-escape" such arbitrary strings, else +backslashes, parentheses, etc., would not come out right. pdfTeX's +'\pdfescapestring' primitive is an easy way to do this, e.g., +'\xdef#1{\pdfescapestring{#1}}'. + + Here is the document text, constructing three pages with the section +and subsection given above in the outlines. + + First page.\vfil\eject + + \hldest{}{}{sec1}% + 1. Mysec on second page.\vfil\eject + + \hldest{}{}{sec1.1}% + 1.1. Mysubsec on third page. + + \end + + File: eplain.info, Node: Arrow theoretic diagrams, Next: Programming definitions, Prev: Hyperlinks, Up: Top 6 Arrow theoretic diagrams @@ -4534,8 +4607,8 @@ This chapter describes definitions for producing commutative diagrams. * Menu: -* Slanted lines and vectors:: -* Commutative diagrams:: +* Slanted lines and vectors:: +* Commutative diagrams:: File: eplain.info, Node: Slanted lines and vectors, Next: Commutative diagrams, Up: Arrow theoretic diagrams @@ -4594,9 +4667,9 @@ described in this section must be used in math mode. * Menu: -* Arrows and morphisms:: -* Construction of commutative diagrams:: -* Commutative diagram parameters:: +* Arrows and morphisms:: +* Construction of commutative diagrams:: +* Commutative diagram parameters:: File: eplain.info, Node: Arrows and morphisms, Next: Construction of commutative diagrams, Up: Commutative diagrams @@ -4608,7 +4681,7 @@ The macros '\mapright' and '\mapleft' produce right and left pointing arrows, respectively. Use superscript ('^') to place a morphism above the arrow, e.g., '\mapright^\alpha'; use subscript ('_') to place a morphism below the arrow, e.g., '\mapright_{\tilde l}'. Superscripts and -subscripts may be used simulataneously, e.g., '\mapright^\pi_{\rm +subscripts may be used simultaneously, e.g., '\mapright^\pi_{\rm epimor.}'. Similarly, the macros '\mapup' and '\mapdown' produce up and down @@ -4956,7 +5029,7 @@ are writing nontrivial macros, not when writing a document. * Expansion:: Controlling expansion. * Obeying spaces:: Making whitespace count anywhere. * Writing out numbers:: Making '1' into 'one'. -* Mode-specific penalties:: +* Mode-specific penalties:: * Auxiliary files:: Testing for their existence. * User-defined environments:: User-defined environments. * Page list and page range parsers:: @@ -5268,14 +5341,14 @@ This section describes some miscellanous macros for expansion, etc. * Menu: * \csn and \ece:: Abbreviations for \csname expansions. -* \edefappend:: +* \edefappend:: * Hooks:: Manipulating and executing named actions. * Properties:: Associating information with a csname. -* \expandonce:: -* \ifundefined:: +* \expandonce:: +* \ifundefined:: * \ifempty:: * \ifinteger and \isinteger:: -* \futurenonspacelet:: +* \futurenonspacelet:: File: eplain.info, Node: \csn and \ece, Next: \edefappend, Up: Expansion @@ -5483,7 +5556,7 @@ they are not bullet-proof. For example, the following code will expand to 'ab_integer' (and thus would not even compile outside math mode). - These macros come from TeX Frequently Asked Question + These macros come from the TeX Frequently Asked Questions (<http://www.tex.ac.uk/cgi-bin/texfaq2html>). @@ -5674,7 +5747,7 @@ This chapter contains listings of source files, along with the output they produce (where appropriate), which illustrate various aspects of Eplain. The files can be found in the 'demo' subdirectory of Eplain distribution. These demos, both the sources and the compiled PDF and PS -files, are also available from <http://tug.org/eplain/demo>. +files, are also available from <https://tug.org/eplain/demo>. * Menu: @@ -5953,15 +6026,9 @@ Macro index * @hllabel <2>: Destination types for pdftex and dvipdfm. (line 84) * @hllabel <3>: Link types for pdftex and dvipdfm. - (line 67) + (line 68) * @indexproof insertion class: Proofing index terms. (line 28) -* \leftskip: Justification. (line 45) -* \raggedleft: Justification. (line 45) -* \raggedleftskip: Justification. (line 45) -* \raggedright: Justification. (line 45) -* \spaceskip, reset by \ragged...: Justification. (line 45) -* \xspaceskip, reset by \ragged...: Justification. (line 45) * abovecolumnskip: Multiple columns. (line 33) * abovecolumnspenalty: Tables. (line 30) * abovelistpenalty: Formatting lists. (line 29) @@ -5983,7 +6050,7 @@ Macro index * advancetopmargin: Margins. (line 26) * afterindexterm: Customizing indexing. (line 6) -* afterindexterm hook: Indexing commands. (line 62) +* afterindexterm hook: Indexing commands. (line 61) * AMSLaTeX: Logos. (line 10) * AMSTeX: Logos. (line 10) * arrow: Arrows and morphisms. @@ -6092,7 +6159,7 @@ Macro index * cmd (hyperlink option) <1>: Link options for hypertex. (line 7) * cmd (hyperlink option) <2>: Link types for pdftex and dvipdfm. - (line 66) + (line 67) * cmd (hyperlink option) <3>: Link options for pdftex and dvipdfm. (line 56) * color (hyperlink option): Options supported by all drivers. @@ -6111,7 +6178,7 @@ Macro index (line 7) * definecontentsfile: Alternative contents files. (line 6) -* defineindex: Indexing. (line 36) +* defineindex: Indexing. (line 35) * definexref: Defining generic references. (line 6) * definexref <1>: Hyperlinks (xhyper.tex). @@ -6126,6 +6193,7 @@ Macro index (line 122) * discretionaries: Paths. (line 20) * displaylines: Displays. (line 18) +* DOCVIEW pdfmark: Making PDF outlines. (line 37) * dospecials: Verbatim listing. (line 57) * doublecolumns: Multiple columns. (line 7) * drawline: Slanted lines and vectors. @@ -6209,18 +6277,18 @@ Macro index * file (hyperlink option) <1>: Link options for hypertex. (line 14) * file (hyperlink option) <2>: Link types for pdftex and dvipdfm. - (line 40) + (line 41) * file (hyperlink option) <3>: Link types for pdftex and dvipdfm. - (line 52) + (line 53) * file (hyperlink option) <4>: Link options for pdftex and dvipdfm. (line 63) * fileexists (conditional): Auxiliary files. (line 10) * filename (hyperlink type): Link types for hypertex. (line 21) * filename (hyperlink type) <1>: Link types for pdftex and dvipdfm. - (line 39) + (line 40) * filepage (hyperlink type): Link types for pdftex and dvipdfm. - (line 51) + (line 52) * fit (destination type): Destination types for pdftex and dvipdfm. (line 18) * fitb (destination type): Destination types for pdftex and dvipdfm. @@ -6338,7 +6406,7 @@ Macro index * hlstart <1>: Link types for hypertex. (line 43) * hlstart <2>: Link types for pdftex and dvipdfm. - (line 70) + (line 71) * hlstart <3>: Setting hyperlink types and options. (line 7) * hlstart <4>: Hyperlinks (xhyper.tex). @@ -6435,15 +6503,16 @@ Macro index * idxsubmarked (hyperlinks): Index hyperlinks. (line 6) * ifempty: \ifempty. (line 6) * iffileexists: Auxiliary files. (line 10) -* ifidx: Indexing. (line 54) +* ifidx: Indexing. (line 53) * ifindexproofing: Proofing index terms. (line 12) * ifinteger: \ifinteger and \isinteger. (line 6) * ifpdf: Checking for PDF output. - (line 10) + (line 9) * ifpdf <1>: Introduction to hyperlinks. (line 51) +* ifpdf <2>: Making PDF outlines. (line 16) * ifrewritetocfile: Reading the .toc file. (line 26) * ifundefined: \ifundefined. (line 6) @@ -6532,6 +6601,7 @@ Macro index * leftdisplaysetup: Formatting displays. (line 8) * lefteqnumbers: Displays. (line 23) * leftmargin: Margins. (line 17) +* leftskip: Justification. (line 45) * leqalignno: Displays. (line 19) * leqalignno <1>: Displays. (line 23) * leqno: Displays. (line 23) @@ -6594,9 +6664,9 @@ Macro index * newblock: Commands from LaTeX. (line 31) * newcommand: Commands from LaTeX. (line 18) * newwin (hyperlink option): Link types for pdftex and dvipdfm. - (line 41) + (line 42) * newwin (hyperlink option) <1>: Link types for pdftex and dvipdfm. - (line 53) + (line 54) * newwin (hyperlink option) <2>: Link options for pdftex and dvipdfm. (line 90) * noarrow: Invoking Eplain. (line 84) @@ -6611,7 +6681,7 @@ Macro index * normalbaselineskip: Options supported by all drivers. (line 19) * num (hyperlink type): Link types for pdftex and dvipdfm. - (line 91) + (line 92) * numberedfootnote: Footnotes. (line 7) * numberedfootnote (hyperlinks): Footnote hyperlinks. (line 6) * numberedlist: Lists. (line 13) @@ -6625,13 +6695,13 @@ Macro index * outsidemargin: Proofing index terms. (line 21) * page (hyperlink type): Link types for pdftex and dvipdfm. - (line 30) -* pagefit (hyperlink option): Link types for pdftex and dvipdfm. (line 31) +* pagefit (hyperlink option): Link types for pdftex and dvipdfm. + (line 32) * pagefit (hyperlink option) <1>: Link types for pdftex and dvipdfm. - (line 41) + (line 42) * pagefit (hyperlink option) <2>: Link types for pdftex and dvipdfm. - (line 53) + (line 54) * pagefit (hyperlink option) <3>: Link options for pdftex and dvipdfm. (line 107) * pageno: Proofing index terms. @@ -6639,9 +6709,13 @@ Macro index * pagetotal: Multiple columns. (line 14) * paperheight: Margins. (line 43) * paperwidth: Margins. (line 46) +* parfillskip, reset by \ragged...: Justification. (line 45) * parindent in indexes: Typesetting an index. (line 24) * path: Paths. (line 13) +* pdfescapestring pdfTeX primitive: Making PDF outlines. (line 60) +* pdfmark (PDF language primitive): Making PDF outlines. (line 31) +* pdfoutline (pdftex primitive): Making PDF outlines. (line 19) * pdfoutput: Checking for PDF output. (line 20) * pdftex (hyperlink driver): Hyperlink drivers pdftex and dvipdfm. @@ -6665,6 +6739,9 @@ Macro index * printlistinglineno <1>: Verbatim listing. (line 27) * providecommand: Commands from LaTeX. (line 18) * quadcolumns: Multiple columns. (line 7) +* raggedleft: Justification. (line 45) +* raggedleftskip: Justification. (line 45) +* raggedright: Justification. (line 45) * raggedright for index entries: Typesetting an index. (line 45) * raise (hyperlink option): Options supported by all drivers. @@ -6678,7 +6755,7 @@ Macro index * raw (hyperlink type): Link types for hypertex. (line 37) * raw (hyperlink type) <1>: Link types for pdftex and dvipdfm. - (line 64) + (line 65) * rbracechar: Category codes. (line 58) * readindexfile: Typesetting an index. (line 6) @@ -6759,8 +6836,10 @@ Macro index * sline <1>: Arrows and morphisms. (line 107) * SLiTeX: Logos. (line 11) +* spaceskip, reset by \ragged...: Justification. (line 45) * special: Introduction to hyperlinks. (line 9) +* special ps: for dvips: Making PDF outlines. (line 27) * specialpathdelimiters (conditional): Paths. (line 28) * subeqnumber: Subequation references. (line 15) @@ -6882,6 +6961,7 @@ Macro index * xrefwarningfalse: Citations. (line 78) * xrlabel: Converting to characters. (line 6) +* xspaceskip, reset by \ragged...: Justification. (line 45) * xyz (destination type): Destination types for hypertex. (line 7) * xyz (destination type) <1>: Destination types for pdftex and dvipdfm. @@ -6914,9 +6994,9 @@ Concept index (line 113) * .fmt file: Installation. (line 27) * .fmt file <1>: Invoking Eplain. (line 14) -* .idx files: Indexing. (line 23) +* .idx files: Indexing. (line 22) * .idx files <1>: Index hyperlinks. (line 14) -* .ind files: Indexing. (line 27) +* .ind files: Indexing. (line 26) * .ind files <1>: Index hyperlinks. (line 25) * .pdf files: Checking for PDF output. (line 6) @@ -6946,10 +7026,10 @@ Concept index * atom: Properties. (line 6) * autopict.sty: Packages known to work. (line 12) +* auxiliary files, existence of: Auxiliary files. (line 6) * avoiding boxed links: URL hyperlinks. (line 17) * avoiding boxed links <1>: Setting default types and options. (line 25) -* axuiliary files, existence of: Auxiliary files. (line 6) * backslash character: Category codes. (line 15) * balancing of columns with \singlecolumn: Multiple columns. (line 11) * Berry, Karl: Introduction. (line 31) @@ -6967,6 +7047,7 @@ Concept index * BibTeX: Citations. (line 9) * BibTeX <1>: Logos. (line 10) * black boxes: Boxes. (line 6) +* bookmarks, making PDF: Making PDF outlines. (line 6) * Borceux, Francis: Construction of commutative diagrams. (line 79) * border color, hyperlink: Link options for pdftex and dvipdfm. @@ -7169,9 +7250,9 @@ Concept index * destinations, in another file: Link types for hypertex. (line 21) * destinations, in another file <1>: Link types for pdftex and dvipdfm. - (line 39) + (line 40) * destinations, in another file <2>: Link types for pdftex and dvipdfm. - (line 51) + (line 52) * destinations, large operators: Options supported by all drivers. (line 27) * destinations, large operators <1>: Setting group options. @@ -7183,9 +7264,9 @@ Concept index * destinations, named <1>: Link types for pdftex and dvipdfm. (line 18) * destinations, numbered: Link types for pdftex and dvipdfm. - (line 91) + (line 92) * destinations, page: Link types for pdftex and dvipdfm. - (line 30) + (line 31) * destinations, raising: Options supported by all drivers. (line 13) * destinations, URL: Link types for hypertex. @@ -7221,7 +7302,7 @@ Concept index (line 6) * disabling hyperlinks <1>: Turning hyperlinks on/off. (line 6) -* disabling indexes: Indexing. (line 54) +* disabling indexes: Indexing. (line 53) * displayed math and hyperlinks: Options supported by all drivers. (line 27) * displayed math and hyperlinks <1>: Setting group options. @@ -7263,6 +7344,7 @@ Concept index (line 13) * dvips <1>: Hyperlink driver hypertex. (line 32) +* dvips, making PDF outlines for: Making PDF outlines. (line 16) * Eijkhout, Victor: Iteration. (line 61) * eject in multicolumns: Multiple columns. (line 14) * electronic mail addresses, breaking: Paths. (line 6) @@ -7318,9 +7400,9 @@ Concept index * file, hyperlink to: Link types for hypertex. (line 21) * file, hyperlink to <1>: Link types for pdftex and dvipdfm. - (line 39) + (line 40) * file, hyperlink to <2>: Link types for pdftex and dvipdfm. - (line 51) + (line 52) * file: links: General hyperlinks. (line 37) * filenames, breaking: Paths. (line 6) * filenames, breaking <1>: Packages known to work. @@ -7454,9 +7536,9 @@ Concept index * hyperlink destination, named <1>: Link types for pdftex and dvipdfm. (line 18) * hyperlink destination, numbered: Link types for pdftex and dvipdfm. - (line 91) + (line 92) * hyperlink destination, page: Link types for pdftex and dvipdfm. - (line 30) + (line 31) * hyperlink destination, raising: Options supported by all drivers. (line 13) * hyperlink dimensions: Link options for pdftex and dvipdfm. @@ -7551,9 +7633,9 @@ Concept index * hyperlinks, to another file: Link types for hypertex. (line 21) * hyperlinks, to another file <1>: Link types for pdftex and dvipdfm. - (line 39) + (line 40) * hyperlinks, to another file <2>: Link types for pdftex and dvipdfm. - (line 51) + (line 52) * hyperlinks, URL: General hyperlinks. (line 20) * hyperlinks, URL <1>: URL hyperlinks. (line 6) * hyperlinks, URL <2>: Link types for hypertex. @@ -7577,6 +7659,8 @@ Concept index (line 6) * idxuniq: Exact destinations for index terms. (line 33) +* ifpdf.sty: Checking for PDF output. + (line 24) * ignoring arguments: Macro arguments. (line 6) * implicit hyperlinks: Implicit hyperlinks. (line 6) * implicit hyperlinks, demo: Hyperlinks (xhyper.tex). @@ -7630,8 +7714,8 @@ Concept index (line 6) * index, underlining page numbers: Page list and page range parsers. (line 26) -* indexes, disabling: Indexing. (line 54) -* indexes, multiple: Indexing. (line 36) +* indexes, disabling: Indexing. (line 53) +* indexes, multiple: Indexing. (line 35) * indexing: Indexing. (line 6) * indexing and trailing spaces: Indexing terms. (line 20) * indexing commands: Indexing commands. (line 6) @@ -7790,7 +7874,7 @@ Concept index * morphisms: Arrows and morphisms. (line 6) * multiple column output: Multiple columns. (line 6) -* multiple indexes: Indexing. (line 36) +* multiple indexes: Indexing. (line 35) * named destination: Link types for hypertex. (line 7) * named destination <1>: Link types for pdftex and dvipdfm. @@ -7803,7 +7887,7 @@ Concept index * nolinks, hyperlink driver: Hyperlink driver nolinks. (line 6) * numbered destination: Link types for pdftex and dvipdfm. - (line 91) + (line 92) * numbered lists: Lists. (line 6) * numbered references: Citations. (line 91) * numbers, detecting: \ifinteger and \isinteger. @@ -7841,6 +7925,7 @@ Concept index * options, link, pdftex: Link options for pdftex and dvipdfm. (line 6) * ordered list: Lists. (line 6) +* outlines, making PDF: Making PDF outlines. (line 6) * output routine and index proofing: Proofing index terms. (line 28) * overstriking: Packages known to work. @@ -7852,7 +7937,7 @@ Concept index * packages, LaTeX <2>: Packages known not to work. (line 6) * page destination: Link types for pdftex and dvipdfm. - (line 30) + (line 31) * page list, parsing: Page destinations for index terms. (line 32) * page range, parsing: Page destinations for index terms. @@ -7869,6 +7954,7 @@ Concept index (line 134) * PDF: Packages known to work. (line 104) +* PDF outlines (a.k.a. bookmarks): Making PDF outlines. (line 6) * PDF output: Checking for PDF output. (line 6) * pdftex: Invoking Eplain. (line 114) @@ -7886,6 +7972,7 @@ Concept index (line 6) * pdftex, link types: Link types for pdftex and dvipdfm. (line 6) +* pdftex, making PDF outlines for: Making PDF outlines. (line 16) * pdfTeX, problems using color and graphics: Packages known to work. (line 30) * pdfTeX, problems with supp-mis.tex: Packages known to work. @@ -8007,14 +8094,15 @@ Concept index * tables: Tables. (line 6) * tabs: Obeying spaces. (line 22) * TeX by Topic: Iteration. (line 61) -* TeX Frequently Asked Question: \ifinteger and \isinteger. +* TeX Frequently Asked Questions: \ifinteger and \isinteger. (line 26) * TEXFORMATS: Installation. (line 43) * texi2dvi: Invoking Eplain. (line 103) * texi2dvi <1>: Citations. (line 102) -* texi2dvi <2>: Indexing. (line 33) +* texi2dvi <2>: Indexing. (line 32) * Texinfo: Introduction. (line 15) * TEXINPUTS: Installation. (line 23) +* texnames.sty: Logos. (line 15) * time of day: Time of day. (line 6) * toc files, writing several: Changing the .toc file's root name. (line 12) @@ -8054,13 +8142,9 @@ Concept index (line 25) * unordered lists: Lists. (line 6) * upgrading: Installation. (line 6) -* URL for ifpdf.sty: Checking for PDF output. - (line 24) -* URL for MakeIndex: Indexing. (line 14) * URL for path.sty: Paths. (line 33) * URL for pdfTeX: Checking for PDF output. (line 6) -* URL for texnames.sty: Logos. (line 15) * URL hyperlink: General hyperlinks. (line 20) * URL hyperlink <1>: URL hyperlinks. (line 6) * URL hyperlink <2>: Link types for hypertex. @@ -8088,7 +8172,7 @@ Concept index (line 25) * whatsits made by hyperlinks: Hyperlink driver nolinks. (line 25) -* whatsits made by index entries: Indexing commands. (line 62) +* whatsits made by index entries: Indexing commands. (line 61) * while loops: Iteration. (line 6) * whitespace: Obeying spaces. (line 6) * width, hyperlink border: Link options for pdftex and dvipdfm. @@ -8112,129 +8196,130 @@ Concept index Tag Table: -Node: Top803 -Node: Introduction8244 -Node: Installation11282 -Node: Invoking Eplain13334 -Node: User definitions17931 -Node: Diagnostics19758 -Node: Rules21323 -Node: Citations22154 -Node: Formatting citations28582 -Node: Formatting bibliographies30119 -Node: Commands from LaTeX33355 -Node: Displays34329 -Node: Formatting displays35716 -Node: Time of day36349 -Node: Lists37108 -Node: Formatting lists39248 -Node: Verbatim listing41531 -Node: Contents44751 -Node: Writing the .toc file45420 -Node: Reading the .toc file48282 -Node: Changing the .toc file's root name49685 -Node: Alternative contents files50701 -Node: Cross-references51265 -Node: Defining generic references52751 -Node: Using generic references53627 -Node: Page references54911 -Node: Equation references55730 -Node: Formatting equation references58495 -Node: Subequation references62845 -Node: Indexing64761 -Node: Indexing terms67869 -Node: Indexing commands68981 -Node: Modifying index entries72000 -Node: Index entries with special characters74970 -Node: Proofing index terms79212 -Node: Typesetting an index81025 -Node: Customizing indexing83491 -Node: Justification87187 -Node: Tables90282 -Node: Margins92773 -Node: Multiple columns94926 -Node: Footnotes96963 -Node: Fractions99538 -Node: Paths100321 -Node: Logos101923 -Node: Boxes102653 -Node: Checking for PDF output104439 -Node: Loading LaTeX packages105527 -Node: The \usepackage command106884 -Node: Environment for loading packages107970 -Node: Packages known to work110310 -Node: Packages known not to work117202 -Node: Hyperlinks117987 -Node: Introduction to hyperlinks118568 -Node: Explicit hyperlinks124104 -Node: Implicit hyperlinks126389 -Node: General hyperlinks128210 -Node: URL hyperlinks129732 -Node: Citation hyperlinks131832 -Node: List hyperlinks132559 -Node: Cross-reference hyperlinks132950 -Node: Page reference hyperlinks134321 -Node: Equation reference hyperlinks134982 -Node: Index hyperlinks136372 -Node: Exact destinations for index terms138130 -Node: Page destinations for index terms140297 -Node: Choosing destination placement142915 -Node: Index page list and page range parsers143704 -Node: Hyperlinks in see and see also entries144256 -Node: Footnote hyperlinks145054 -Node: Contents hyperlinks146248 -Node: Hyperlink drivers146631 -Node: Options supported by all drivers147265 -Node: Hyperlink driver hypertex150061 -Node: Destination types for hypertex153005 -Node: Destination options for hypertex154039 -Node: Link types for hypertex154521 -Node: Link options for hypertex156528 -Node: Hyperlink drivers pdftex and dvipdfm157550 -Node: Destination types for pdftex and dvipdfm158195 -Node: Destination options for pdftex and dvipdfm161674 -Node: Link types for pdftex and dvipdfm164125 -Node: Link options for pdftex and dvipdfm167639 -Node: Hyperlink driver nolinks171277 -Node: Setting hyperlink types and options173680 -Node: Setting default types and options174681 -Node: Setting group types176107 -Node: Setting group options177296 -Node: Turning hyperlinks on/off179777 -Node: Turning low-level commands on/off180415 -Node: Turning hyperlinks on/off for a group180928 -Node: Arrow theoretic diagrams182081 -Node: Slanted lines and vectors182459 -Node: Commutative diagrams184533 -Node: Arrows and morphisms185142 -Node: Construction of commutative diagrams189598 -Node: Commutative diagram parameters196763 -Node: Programming definitions198579 -Node: Category codes199585 -Node: Allocation macros202230 -Node: Iteration204365 -Node: Macro arguments206017 -Node: Converting to characters209392 -Node: Expansion210777 -Node: \csn and \ece211400 -Node: \edefappend211965 -Node: Hooks212512 -Node: Properties214686 -Node: \expandonce215765 -Node: \ifundefined216213 -Node: \ifempty216777 -Node: \ifinteger and \isinteger217519 -Node: \futurenonspacelet218554 -Node: Obeying spaces219155 -Node: Writing out numbers220179 -Node: Mode-specific penalties220502 -Node: Auxiliary files221231 -Node: User-defined environments222150 -Node: Page list and page range parsers223363 -Node: Demo files225495 -Node: Hyperlinks (xhyper.tex)226061 -Node: Highlighting TeX comments in listings (lscommnt.tex)234410 -Node: Macro index236866 -Node: Concept index305216 +Node: Top796 +Node: Introduction8126 +Node: Installation11167 +Node: Invoking Eplain13219 +Node: User definitions17817 +Node: Diagnostics19644 +Node: Rules21209 +Node: Citations22040 +Node: Formatting citations28468 +Node: Formatting bibliographies30007 +Node: Commands from LaTeX33243 +Node: Displays34217 +Node: Formatting displays35604 +Node: Time of day36237 +Node: Lists36996 +Node: Formatting lists39136 +Node: Verbatim listing41419 +Node: Contents44639 +Node: Writing the .toc file45308 +Node: Reading the .toc file48170 +Node: Changing the .toc file's root name49573 +Node: Alternative contents files50589 +Node: Cross-references51153 +Node: Defining generic references52633 +Node: Using generic references53509 +Node: Page references54793 +Node: Equation references55612 +Node: Formatting equation references58364 +Node: Subequation references62714 +Node: Indexing64630 +Node: Indexing terms67652 +Node: Indexing commands68764 +Node: Modifying index entries71725 +Node: Index entries with special characters74693 +Node: Proofing index terms78935 +Node: Typesetting an index80748 +Node: Customizing indexing83214 +Node: Justification86910 +Node: Tables90005 +Node: Margins92496 +Node: Multiple columns94649 +Node: Footnotes96686 +Node: Fractions99261 +Node: Paths100044 +Node: Logos101600 +Node: Boxes102395 +Node: Checking for PDF output104181 +Node: Loading LaTeX packages105207 +Node: The \usepackage command106409 +Node: Environment for loading packages107495 +Node: Packages known to work109835 +Node: Packages known not to work116602 +Node: Hyperlinks117375 +Node: Introduction to hyperlinks118024 +Node: Explicit hyperlinks123561 +Node: Implicit hyperlinks125846 +Node: General hyperlinks127667 +Node: URL hyperlinks129190 +Node: Citation hyperlinks131290 +Node: List hyperlinks132017 +Node: Cross-reference hyperlinks132408 +Node: Page reference hyperlinks133779 +Node: Equation reference hyperlinks134440 +Node: Index hyperlinks135830 +Node: Exact destinations for index terms137588 +Node: Page destinations for index terms139755 +Node: Choosing destination placement142373 +Node: Index page list and page range parsers143162 +Node: Hyperlinks in see and see also entries143714 +Node: Footnote hyperlinks144512 +Node: Contents hyperlinks145706 +Node: Hyperlink drivers146089 +Node: Options supported by all drivers146723 +Node: Hyperlink driver hypertex149519 +Node: Destination types for hypertex152467 +Node: Destination options for hypertex153501 +Node: Link types for hypertex153983 +Node: Link options for hypertex155991 +Node: Hyperlink drivers pdftex and dvipdfm157013 +Node: Destination types for pdftex and dvipdfm157658 +Node: Destination options for pdftex and dvipdfm161137 +Node: Link types for pdftex and dvipdfm163588 +Node: Link options for pdftex and dvipdfm167108 +Node: Hyperlink driver nolinks170746 +Node: Setting hyperlink types and options173149 +Node: Setting default types and options174150 +Node: Setting group types175576 +Node: Setting group options176765 +Node: Turning hyperlinks on/off179246 +Node: Turning low-level commands on/off179912 +Node: Turning hyperlinks on/off for a group180425 +Node: Making PDF outlines181578 +Node: Arrow theoretic diagrams184463 +Node: Slanted lines and vectors184830 +Node: Commutative diagrams186904 +Node: Arrows and morphisms187501 +Node: Construction of commutative diagrams191956 +Node: Commutative diagram parameters199121 +Node: Programming definitions200937 +Node: Category codes201938 +Node: Allocation macros204583 +Node: Iteration206718 +Node: Macro arguments208370 +Node: Converting to characters211745 +Node: Expansion213130 +Node: \csn and \ece213693 +Node: \edefappend214258 +Node: Hooks214805 +Node: Properties216979 +Node: \expandonce218058 +Node: \ifundefined218506 +Node: \ifempty219070 +Node: \ifinteger and \isinteger219812 +Node: \futurenonspacelet220852 +Node: Obeying spaces221453 +Node: Writing out numbers222477 +Node: Mode-specific penalties222800 +Node: Auxiliary files223529 +Node: User-defined environments224448 +Node: Page list and page range parsers225661 +Node: Demo files227793 +Node: Hyperlinks (xhyper.tex)228360 +Node: Highlighting TeX comments in listings (lscommnt.tex)236709 +Node: Macro index239165 +Node: Concept index308026 End Tag Table diff --git a/Master/texmf-dist/doc/man/man1/eplain.man1.pdf b/Master/texmf-dist/doc/man/man1/eplain.man1.pdf Binary files differindex c05eb69a095..3e51a8b814f 100644 --- a/Master/texmf-dist/doc/man/man1/eplain.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/eplain.man1.pdf |